yiisoft /
yii-bootstrap4
| 1 | <?php |
||
| 2 | |||
| 3 | declare(strict_types=1); |
||
| 4 | |||
| 5 | namespace Yiisoft\Yii\Bootstrap4; |
||
| 6 | |||
| 7 | use Yiisoft\Arrays\ArrayHelper; |
||
| 8 | use Yiisoft\Factory\Exceptions\InvalidConfigException; |
||
| 9 | use Yiisoft\Html\Html; |
||
| 10 | |||
| 11 | use function implode; |
||
| 12 | use function is_array; |
||
| 13 | |||
| 14 | /** |
||
| 15 | * ButtonGroup renders a button group bootstrap component. |
||
| 16 | * |
||
| 17 | * For example, |
||
| 18 | * |
||
| 19 | * ```php |
||
| 20 | * // a button group with items configuration |
||
| 21 | * echo ButtonGroup::widget() |
||
| 22 | * ->buttons([ |
||
| 23 | * ['label' => 'A'], |
||
| 24 | * ['label' => 'B'], |
||
| 25 | * ['label' => 'C', 'visible' => false], |
||
| 26 | * ]); |
||
| 27 | * |
||
| 28 | * // button group with an item as a string |
||
| 29 | * echo ButtonGroup::widget() |
||
| 30 | * ->buttons([ |
||
| 31 | * Button::widget() |
||
| 32 | * ->label('A'), |
||
| 33 | * ['label' => 'B'], |
||
| 34 | * ]); |
||
| 35 | * ``` |
||
| 36 | * |
||
| 37 | * Pressing on the button should be handled via JavaScript. See the following for details: |
||
| 38 | */ |
||
| 39 | class ButtonGroup extends Widget |
||
| 40 | { |
||
| 41 | private array $buttons = []; |
||
| 42 | private bool $encodeLabels = true; |
||
| 43 | private array $options = []; |
||
| 44 | |||
| 45 | 3 | protected function run(): string |
|
| 46 | { |
||
| 47 | 3 | if (!isset($this->options['id'])) { |
|
| 48 | 3 | $this->options['id'] = "{$this->getId()}-button-group"; |
|
| 49 | } |
||
| 50 | |||
| 51 | 3 | Html::addCssClass($this->options, ['widget' => 'btn-group']); |
|
| 52 | |||
| 53 | 3 | if (!isset($this->options['role'])) { |
|
| 54 | 3 | $this->options['role'] = 'group'; |
|
| 55 | } |
||
| 56 | |||
| 57 | 3 | return Html::tag('div', $this->renderButtons(), $this->options); |
|
| 58 | } |
||
| 59 | |||
| 60 | /** |
||
| 61 | * Generates the buttons that compound the group as specified on {@see buttons}. |
||
| 62 | * |
||
| 63 | * @throws InvalidConfigException |
||
| 64 | * |
||
| 65 | * @return string the rendering result. |
||
| 66 | */ |
||
| 67 | 3 | protected function renderButtons(): string |
|
| 68 | { |
||
| 69 | 3 | $buttons = []; |
|
| 70 | |||
| 71 | 3 | foreach ($this->buttons as $button) { |
|
| 72 | 3 | if (is_array($button)) { |
|
| 73 | 3 | $visible = ArrayHelper::remove($button, 'visible', true); |
|
| 74 | |||
| 75 | 3 | if ($visible === false) { |
|
| 76 | 1 | continue; |
|
| 77 | } |
||
| 78 | |||
| 79 | 3 | if (!isset($button['encodeLabel'])) { |
|
| 80 | 3 | $button['encodeLabel'] = $this->encodeLabels; |
|
| 81 | } |
||
| 82 | |||
| 83 | 3 | if (!isset($button['options']['type'])) { |
|
| 84 | 3 | ArrayHelper::setValueByPath($button, 'options.type', 'button'); |
|
| 85 | } |
||
| 86 | |||
| 87 | 3 | $buttons[] = Button::widget() |
|
| 88 | 3 | ->encodeLabels($button['encodeLabel']) |
|
|
0 ignored issues
–
show
Bug
introduced
by
Loading history...
|
|||
| 89 | 3 | ->label($button['label']) |
|
| 90 | 3 | ->options($button['options']) |
|
| 91 | 3 | ->render(); |
|
| 92 | } else { |
||
| 93 | 1 | $buttons[] = $button; |
|
| 94 | } |
||
| 95 | } |
||
| 96 | |||
| 97 | 3 | return implode("\n", $buttons); |
|
| 98 | } |
||
| 99 | |||
| 100 | /** |
||
| 101 | * List of buttons. Each array element represents a single button which can be specified as a string or an array of |
||
| 102 | * the following structure: |
||
| 103 | * |
||
| 104 | * - label: string, required, the button label. |
||
| 105 | * - options: array, optional, the HTML attributes of the button. |
||
| 106 | * - visible: bool, optional, whether this button is visible. Defaults to true. |
||
| 107 | * |
||
| 108 | * @param array $value |
||
| 109 | * |
||
| 110 | * @return $this |
||
| 111 | */ |
||
| 112 | 3 | public function buttons(array $value): self |
|
| 113 | { |
||
| 114 | 3 | $this->buttons = $value; |
|
| 115 | |||
| 116 | 3 | return $this; |
|
| 117 | } |
||
| 118 | |||
| 119 | /** |
||
| 120 | * Whether to HTML-encode the button labels. |
||
| 121 | * |
||
| 122 | * @param bool $value |
||
| 123 | * |
||
| 124 | * @return $this |
||
| 125 | */ |
||
| 126 | public function encodeLabels(bool $value): self |
||
| 127 | { |
||
| 128 | $this->encodeLabels = $value; |
||
| 129 | |||
| 130 | return $this; |
||
| 131 | } |
||
| 132 | |||
| 133 | /** |
||
| 134 | * The HTML attributes for the widget container tag. The following special options are recognized. |
||
| 135 | * |
||
| 136 | * {@see \Yiisoft\Html\Html::renderTagAttributes()} for details on how attributes are being rendered. |
||
| 137 | * |
||
| 138 | * @param array $value |
||
| 139 | * |
||
| 140 | * @return $this |
||
| 141 | */ |
||
| 142 | 2 | public function options(array $value): self |
|
| 143 | { |
||
| 144 | 2 | $this->options = $value; |
|
| 145 | |||
| 146 | 2 | return $this; |
|
| 147 | } |
||
| 148 | } |
||
| 149 |