|
- <?php
- /**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
- namespace yii\bootstrap;
-
- use yii\helpers\Html;
-
- /**
- * ButtonGroup renders a button group bootstrap component.
- *
- * For example,
- *
- * ```php
- * // a button group with items configuration
- * echo ButtonGroup::widget([
- * 'buttons' => [
- * ['label' => 'A'],
- * ['label' => 'B'],
- * ]
- * ]);
- *
- * // button group with an item as a string
- * echo ButtonGroup::widget([
- * 'buttons' => [
- * Button::widget(['label' => 'A']),
- * ['label' => 'B'],
- * ]
- * ]);
- * ```
- * @see http://getbootstrap.com/javascript/#buttons
- * @see http://getbootstrap.com/components/#btn-groups
- * @author Antonio Ramirez <amigo.cobos@gmail.com>
- * @since 2.0
- */
- class ButtonGroup extends Widget
- {
- /**
- * @var array list of buttons. Each array element represents a single button
- * which can be specified as a string or an array of the following structure:
- *
- * - label: string, required, the button label.
- * - options: array, optional, the HTML attributes of the button.
- */
- public $buttons = [];
- /**
- * @var boolean whether to HTML-encode the button labels.
- */
- public $encodeLabels = true;
-
-
- /**
- * Initializes the widget.
- * If you override this method, make sure you call the parent implementation first.
- */
- public function init()
- {
- parent::init();
- Html::addCssClass($this->options, 'btn-group');
- }
-
- /**
- * Renders the widget.
- */
- public function run()
- {
- BootstrapAsset::register($this->getView());
- return Html::tag('div', $this->renderButtons(), $this->options);
- }
-
- /**
- * Generates the buttons that compound the group as specified on [[buttons]].
- * @return string the rendering result.
- */
- protected function renderButtons()
- {
- $buttons = [];
- foreach ($this->buttons as $button) {
- if (is_array($button)) {
- $button['view'] = $this->getView();
- if (!isset($button['encodeLabel'])) {
- $button['encodeLabel'] = $this->encodeLabels;
- }
- $buttons[] = Button::widget($button);
- } else {
- $buttons[] = $button;
- }
- }
-
- return implode("\n", $buttons);
- }
- }
|