first commit

vendor/yiisoft/yii2-bootstrap5/docs/guide-de/helper-html.md

@@ -0,0 +1,30 @@
+HTML helper
+===========
+
+Bootstrap führt viele konsistente HTML Strukturen ein, welche es erlauben, verschiedene visuelle Effekte einfach zu verwenden.
+Ausschliesslich die komplexesten von ihnen sind mittels Widgets in dieser Erweiterung umgesetzt worden. Der Rest kann manuell
+mittels HTML zusammengestellt werden.
+Einige spezielle Bootstrap Markups sind implementiert im [[\yii\bootstrap5\Html]]-Helper.
+Die [[\yii\bootstrap5\Html]]-Klasse ist eine Erweiterung der regulären [[\yii\helpers\Html]]-Klasse mit Anpassungen zur 
+Verwendung mit Bootstrap. Sie bietet verschiedene nützliche Methoden wie z.B.
+
+- `staticControl()` - erlaubt das erstellen von "[statischen Feldern](https://getbootstrap.com/docs/5.1/forms/form-control/#readonly-plain-text)"
+
+Die [[\yii\bootstrap5\Html]]-Klasse erbt von der [[\yii\helpers\Html]]-Klasse und ersetzt diese dadurch vollumfänglich.
+Sie benötigen folglich **nicht** beide in Ihren Views.
+Beispiel:
+
+```php
+<?php
+use yii\bootstrap5\Button;
+use yii\bootstrap5\Html;
+?>
+<?= Button::widget([
+    'label' => Html::tag('i', ['class' => 'fas fa-check']) . Html::encode('Save & apply'),
+    'encodeLabel' => false,
+    'options' => ['class' => 'btn-primary'],
+]); ?>
+```
+
+> Vorsicht: Verwechseln Sie [[\yii\bootstrap5\Html]] und [[\yii\helpers\Html]] Klassen nicht und bedenken Sie jeweils 
+  welche Sie in Ihren Views verwenden.