Yii widgets

La mayoría de los componentes de bootstrap están encapsulados dentro de Yii widgets lo que permite una sintaxis más robusta y poder integrarse con las características del framework. Todos los widgets pertenecen al namespace \yii\bootstrap5:

• [[yii\bootstrap5\Accordion|Accordion]]
• [[yii\bootstrap5\ActiveField|ActiveField]]
• [[yii\bootstrap5\ActiveForm|ActiveForm]]
• [[yii\bootstrap5\Alert|Alert]]
• [[yii\bootstrap5\Breadcrumbs|Breadcrumbs]]
• [[yii\bootstrap5\Button|Button]]
• [[yii\bootstrap5\ButtonDropdown|ButtonDropdown]]
• [[yii\bootstrap5\ButtonGroup|ButtonGroup]]
• [[yii\bootstrap5\ButtonToolbar|ButtonToolbar]]
• [[yii\bootstrap5\Carousel|Carousel]]
• [[yii\bootstrap5\Dropdown|Dropdown]]
• [[yii\bootstrap5\LinkPager|LinkPager]]
• [[yii\bootstrap5\Modal|Modal]]
• [[yii\bootstrap5\Nav|Nav]]
• [[yii\bootstrap5\NavBar|NavBar]]
• [[yii\bootstrap5\Offcanvas|Offcanvas]]
• [[yii\bootstrap5\Popover|Popover]]
• [[yii\bootstrap5\Progress|Progress]]
• [[yii\bootstrap5\Tabs|Tabs]]
• [[yii\bootstrap5\Toast|Toast]]
• [[yii\bootstrap5\ToggleButtonGroup|ToggleButtonGroup]]

Personalización de las clases css para los widget

Los widgets permiten una rápida composición del HTML para los componentes de bootstrap que requieren las clases CSS de bootstrap. Las clases por defecto para un componente en particular serán añadidas automáticamente por los widgets, y las clases opcionales que quieres personalizar son frecuentemente soportadas a través de las propiedades de los widgets.

Por ejemplo, puedas usar [[yii\bootstrap5\Button::options]] para personalizar la apariencia de un botón. La clase 'btn' que se requiere para un botón será añadida automáticamente, por lo que no necesitas preocuparte por ello. Todo lo que necesitas es especificar una clase de botón en particular:

echo Button::widget([
    'label' => 'Action',
    'options' => ['class' => 'btn-primary'], // produce la clase "btn btn-primary"
]);

Sin embargo, a veces puede que tengas que remplazar las clases por defecto por las alternativas. Por ejemplo, el widget [[yii\bootstrap5\ButtonGroup]] utiliza por defecto la clase 'btn-group' para el contenido del div, pero necesitas usar 'btn-group-vertical' en lugar de alinear los botones verticalmente. El uso directo de la opción 'class' simplemente añade 'btn-group-vertical' a 'btn-group, el cual producirá un resultado incorrecto. Con el fin de sobrescribir las clases por defecto de un widget, necesitas especificar la opción 'class' como un array que contiene la definición de la clase personalizada bajo la clave 'widget':

echo ButtonGroup::widget([
    'options' => [
        'class' => ['widget' => 'btn-group-vertical'] // remplaza 'btn-group' con 'btn-group-vertical'
    ],
    'buttons' => [
        ['label' => 'A'],
        ['label' => 'B'],
    ]
]);