mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-04 06:37:55 +08:00
100 lines
2.6 KiB
PHP
100 lines
2.6 KiB
PHP
<?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\ArrayHelper;
|
|
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()
|
|
{
|
|
echo Html::tag('div', $this->renderButtons(), $this->options);
|
|
BootstrapAsset::register($this->getView());
|
|
}
|
|
|
|
/**
|
|
* 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)) {
|
|
$label = ArrayHelper::getValue($button, 'label');
|
|
$options = ArrayHelper::getValue($button, 'options');
|
|
$buttons[] = Button::widget([
|
|
'label' => $label,
|
|
'options' => $options,
|
|
'encodeLabel' => $this->encodeLabels,
|
|
'view' => $this->getView()
|
|
]);
|
|
} else {
|
|
$buttons[] = $button;
|
|
}
|
|
}
|
|
|
|
return implode("\n", $buttons);
|
|
}
|
|
}
|