Class yii\bootstrap4\ActiveField

A Bootstrap 4 enhanced version of \yii\widgets\ActiveField.

This class adds some useful features to \yii\widgets\ActiveField to render all sorts of Bootstrap 4 form fields in different form layouts:

• $inputTemplate is an optional template to render complex inputs, for example input groups
• $horizontalCssClasses defines the CSS grid classes to add to label, wrapper, error and hint in horizontal forms
• inline()/inline() is used to render inline checkboxList() and radioList()
• $enableError can be set to false to disable to the error
• $enableLabel can be set to false to disable to the label
• label() can be used with a bool argument to enable/disable the label

There are also some new placeholders that you can use in the \yii\bootstrap4\template configuration:

• {beginLabel}: the opening label tag
• {labelTitle}: the label title for use with {beginLabel}/{endLabel}
• {endLabel}: the closing label tag
• {beginWrapper}: the opening wrapper tag
• {endWrapper}: the closing wrapper tag

The wrapper tag is only used for some layouts and form elements.

Note that some elements use slightly different defaults for \yii\bootstrap4\template and other options. You may want to override those predefined templates for checkboxes, radio buttons, checkboxLists and radioLists in the \yii\widgets\ActiveForm::fieldConfig of the \yii\widgets\ActiveForm:

• $checkTemplate the default template for checkboxes and radios
• $checkEnclosedTemplate the template for checkboxes and radios enclosed by label

Example:

use yii\bootstrap4\ActiveForm;

$form = ActiveForm::begin(['layout' => 'horizontal']);

// Form field without label
echo $form->field($model, 'demo', [
    'inputOptions' => [
        'placeholder' => $model->getAttributeLabel('demo'),
    ],
])->label(false);

// Inline radio list
echo $form->field($model, 'demo')->inline()->radioList($items);

// Control sizing in horizontal mode
echo $form->field($model, 'demo', [
    'horizontalCssClasses' => [
        'wrapper' => 'col-sm-2',
    ]
]);

// With 'default' layout you would use 'template' to size a specific field:
echo $form->field($model, 'demo', [
    'template' => '{label} <div class="row"><div class="col-sm-4">{input}{error}{hint}</div></div>'
]);

// Input group
echo $form->field($model, 'demo', [
    'inputTemplate' => '<div class="input-group"><span class="input-group-addon">@</span>{input}</div>',
]);

ActiveForm::end();

See also:

• yii\bootstrap4\ActiveForm
• http://getbootstrap.com/css/#forms