|
|
@ -53,179 +53,180 @@ use yii\helpers\Html; |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
class Tabs extends Widget |
|
|
|
class Tabs extends Widget |
|
|
|
{ |
|
|
|
{ |
|
|
|
/** |
|
|
|
/** |
|
|
|
* @var array list of tabs in the tabs widget. Each array element represents a single |
|
|
|
* @var array list of tabs in the tabs widget. Each array element represents a single |
|
|
|
* tab with the following structure: |
|
|
|
* tab with the following structure: |
|
|
|
* |
|
|
|
* |
|
|
|
* - label: string, required, the tab header label. |
|
|
|
* - label: string, required, the tab header label. |
|
|
|
* - headerOptions: array, optional, the HTML attributes of the tab header. |
|
|
|
* - headerOptions: array, optional, the HTML attributes of the tab header. |
|
|
|
* - linkOptions: array, optional, the HTML attributes of the tab header link tags. |
|
|
|
* - linkOptions: array, optional, the HTML attributes of the tab header link tags. |
|
|
|
* - content: array, required if `items` is not set. The content (HTML) of the tab pane. |
|
|
|
* - content: array, required if `items` is not set. The content (HTML) of the tab pane. |
|
|
|
* - options: array, optional, the HTML attributes of the tab pane container. |
|
|
|
* - options: array, optional, the HTML attributes of the tab pane container. |
|
|
|
* - active: boolean, optional, whether the item tab header and pane should be visible or not. |
|
|
|
* - active: boolean, optional, whether the item tab header and pane should be visible or not. |
|
|
|
* - items: array, optional, if not set then `content` will be required. The `items` specify a dropdown items |
|
|
|
* - items: array, optional, if not set then `content` will be required. The `items` specify a dropdown items |
|
|
|
* configuration array. Each item can hold two extra keys, besides the above ones: |
|
|
|
* configuration array. Each item can hold two extra keys, besides the above ones: |
|
|
|
* * active: boolean, optional, whether the item tab header and pane should be visible or not. |
|
|
|
* * active: boolean, optional, whether the item tab header and pane should be visible or not. |
|
|
|
* * content: string, required if `items` is not set. The content (HTML) of the tab pane. |
|
|
|
* * content: string, required if `items` is not set. The content (HTML) of the tab pane. |
|
|
|
* * contentOptions: optional, array, the HTML attributes of the tab content container. |
|
|
|
* * contentOptions: optional, array, the HTML attributes of the tab content container. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public $items = []; |
|
|
|
public $items = []; |
|
|
|
/** |
|
|
|
/** |
|
|
|
* @var array list of HTML attributes for the item container tags. This will be overwritten |
|
|
|
* @var array list of HTML attributes for the item container tags. This will be overwritten |
|
|
|
* by the "options" set in individual [[items]]. The following special options are recognized: |
|
|
|
* by the "options" set in individual [[items]]. The following special options are recognized: |
|
|
|
* |
|
|
|
* |
|
|
|
* - tag: string, defaults to "div", the tag name of the item container tags. |
|
|
|
* - tag: string, defaults to "div", the tag name of the item container tags. |
|
|
|
* |
|
|
|
* |
|
|
|
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
|
|
|
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public $itemOptions = []; |
|
|
|
public $itemOptions = []; |
|
|
|
/** |
|
|
|
/** |
|
|
|
* @var array list of HTML attributes for the header container tags. This will be overwritten |
|
|
|
* @var array list of HTML attributes for the header container tags. This will be overwritten |
|
|
|
* by the "headerOptions" set in individual [[items]]. |
|
|
|
* by the "headerOptions" set in individual [[items]]. |
|
|
|
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
|
|
|
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public $headerOptions = []; |
|
|
|
public $headerOptions = []; |
|
|
|
/** |
|
|
|
/** |
|
|
|
* @var array list of HTML attributes for the tab header link tags. This will be overwritten |
|
|
|
* @var array list of HTML attributes for the tab header link tags. This will be overwritten |
|
|
|
* by the "linkOptions" set in individual [[items]]. |
|
|
|
* by the "linkOptions" set in individual [[items]]. |
|
|
|
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
|
|
|
* @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public $linkOptions = []; |
|
|
|
public $linkOptions = []; |
|
|
|
/** |
|
|
|
/** |
|
|
|
* @var boolean whether the labels for header items should be HTML-encoded. |
|
|
|
* @var boolean whether the labels for header items should be HTML-encoded. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public $encodeLabels = true; |
|
|
|
public $encodeLabels = true; |
|
|
|
/** |
|
|
|
/** |
|
|
|
* @var string specifies the Bootstrap tab styling. |
|
|
|
* @var string specifies the Bootstrap tab styling. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public $navType = 'nav-tabs'; |
|
|
|
public $navType = 'nav-tabs'; |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
/** |
|
|
|
* Initializes the widget. |
|
|
|
* Initializes the widget. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public function init() |
|
|
|
public function init() |
|
|
|
{ |
|
|
|
{ |
|
|
|
parent::init(); |
|
|
|
parent::init(); |
|
|
|
Html::addCssClass($this->options, 'nav ' . $this->navType); |
|
|
|
Html::addCssClass($this->options, 'nav ' . $this->navType); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
/** |
|
|
|
* Renders the widget. |
|
|
|
* Renders the widget. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
public function run() |
|
|
|
public function run() |
|
|
|
{ |
|
|
|
{ |
|
|
|
echo $this->renderItems(); |
|
|
|
echo $this->renderItems(); |
|
|
|
$this->registerPlugin('tab'); |
|
|
|
$this->registerPlugin('tab'); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
/** |
|
|
|
* Renders tab items as specified on [[items]]. |
|
|
|
* Renders tab items as specified on [[items]]. |
|
|
|
* @return string the rendering result. |
|
|
|
* @return string the rendering result. |
|
|
|
* @throws InvalidConfigException. |
|
|
|
* @throws InvalidConfigException. |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
protected function renderItems() |
|
|
|
protected function renderItems() |
|
|
|
{ |
|
|
|
{ |
|
|
|
$headers = []; |
|
|
|
$headers = []; |
|
|
|
$panes = []; |
|
|
|
$panes = []; |
|
|
|
|
|
|
|
|
|
|
|
if (!$this->hasActiveTab() && !empty($this->items)) { |
|
|
|
if (!$this->hasActiveTab() && !empty($this->items)) { |
|
|
|
$this->items[0]['active'] = true; |
|
|
|
$this->items[0]['active'] = true; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
foreach ($this->items as $n => $item) { |
|
|
|
foreach ($this->items as $n => $item) { |
|
|
|
if (!isset($item['label'])) { |
|
|
|
if (!isset($item['label'])) { |
|
|
|
throw new InvalidConfigException("The 'label' option is required."); |
|
|
|
throw new InvalidConfigException("The 'label' option is required."); |
|
|
|
} |
|
|
|
} |
|
|
|
$label = $this->encodeLabels ? Html::encode($item['label']) : $item['label']; |
|
|
|
$label = $this->encodeLabels ? Html::encode($item['label']) : $item['label']; |
|
|
|
$headerOptions = array_merge($this->headerOptions, ArrayHelper::getValue($item, 'headerOptions', [])); |
|
|
|
$headerOptions = array_merge($this->headerOptions, ArrayHelper::getValue($item, 'headerOptions', [])); |
|
|
|
$linkOptions = array_merge($this->linkOptions, ArrayHelper::getValue($item, 'linkOptions', [])); |
|
|
|
$linkOptions = array_merge($this->linkOptions, ArrayHelper::getValue($item, 'linkOptions', [])); |
|
|
|
|
|
|
|
|
|
|
|
if (isset($item['items'])) { |
|
|
|
if (isset($item['items'])) { |
|
|
|
$label .= ' <b class="caret"></b>'; |
|
|
|
$label .= ' <b class="caret"></b>'; |
|
|
|
Html::addCssClass($headerOptions, 'dropdown'); |
|
|
|
Html::addCssClass($headerOptions, 'dropdown'); |
|
|
|
|
|
|
|
|
|
|
|
if ($this->renderDropdown($item['items'], $panes)) { |
|
|
|
if ($this->renderDropdown($item['items'], $panes)) { |
|
|
|
Html::addCssClass($headerOptions, 'active'); |
|
|
|
Html::addCssClass($headerOptions, 'active'); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
Html::addCssClass($linkOptions, 'dropdown-toggle'); |
|
|
|
Html::addCssClass($linkOptions, 'dropdown-toggle'); |
|
|
|
$linkOptions['data-toggle'] = 'dropdown'; |
|
|
|
$linkOptions['data-toggle'] = 'dropdown'; |
|
|
|
$header = Html::a($label, "#", $linkOptions) . "\n" |
|
|
|
$header = Html::a($label, "#", $linkOptions) . "\n" |
|
|
|
. Dropdown::widget(['items' => $item['items'], 'clientOptions' => false, 'view' => $this->getView()]); |
|
|
|
. Dropdown::widget(['items' => $item['items'], 'clientOptions' => false, 'view' => $this->getView()]); |
|
|
|
} elseif (isset($item['content'])) { |
|
|
|
} elseif (isset($item['content'])) { |
|
|
|
$options = array_merge($this->itemOptions, ArrayHelper::getValue($item, 'options', [])); |
|
|
|
$options = array_merge($this->itemOptions, ArrayHelper::getValue($item, 'options', [])); |
|
|
|
$options['id'] = ArrayHelper::getValue($options, 'id', $this->options['id'] . '-tab' . $n); |
|
|
|
$options['id'] = ArrayHelper::getValue($options, 'id', $this->options['id'] . '-tab' . $n); |
|
|
|
|
|
|
|
|
|
|
|
Html::addCssClass($options, 'tab-pane'); |
|
|
|
Html::addCssClass($options, 'tab-pane'); |
|
|
|
if (ArrayHelper::remove($item, 'active')) { |
|
|
|
if (ArrayHelper::remove($item, 'active')) { |
|
|
|
Html::addCssClass($options, 'active'); |
|
|
|
Html::addCssClass($options, 'active'); |
|
|
|
Html::addCssClass($headerOptions, 'active'); |
|
|
|
Html::addCssClass($headerOptions, 'active'); |
|
|
|
} |
|
|
|
} |
|
|
|
$linkOptions['data-toggle'] = 'tab'; |
|
|
|
$linkOptions['data-toggle'] = 'tab'; |
|
|
|
$header = Html::a($label, '#' . $options['id'], $linkOptions); |
|
|
|
$header = Html::a($label, '#' . $options['id'], $linkOptions); |
|
|
|
$panes[] = Html::tag('div', $item['content'], $options); |
|
|
|
$panes[] = Html::tag('div', $item['content'], $options); |
|
|
|
} else { |
|
|
|
} else { |
|
|
|
throw new InvalidConfigException("Either the 'content' or 'items' option must be set."); |
|
|
|
throw new InvalidConfigException("Either the 'content' or 'items' option must be set."); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
$headers[] = Html::tag('li', $header, $headerOptions); |
|
|
|
$headers[] = Html::tag('li', $header, $headerOptions); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
return Html::tag('ul', implode("\n", $headers), $this->options) . "\n" |
|
|
|
return Html::tag('ul', implode("\n", $headers), $this->options) . "\n" |
|
|
|
. Html::tag('div', implode("\n", $panes), ['class' => 'tab-content']); |
|
|
|
. Html::tag('div', implode("\n", $panes), ['class' => 'tab-content']); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
/** |
|
|
|
* @return boolean if there's active tab defined |
|
|
|
* @return boolean if there's active tab defined |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
protected function hasActiveTab() |
|
|
|
protected function hasActiveTab() |
|
|
|
{ |
|
|
|
{ |
|
|
|
foreach ($this->items as $item) { |
|
|
|
foreach ($this->items as $item) { |
|
|
|
if (isset($item['active']) && $item['active']===true) { |
|
|
|
if (isset($item['active']) && $item['active']===true) { |
|
|
|
return true; |
|
|
|
return true; |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
return false; |
|
|
|
return false; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
/** |
|
|
|
* Normalizes dropdown item options by removing tab specific keys `content` and `contentOptions`, and also |
|
|
|
* Normalizes dropdown item options by removing tab specific keys `content` and `contentOptions`, and also |
|
|
|
* configure `panes` accordingly. |
|
|
|
* configure `panes` accordingly. |
|
|
|
* @param array $items the dropdown items configuration. |
|
|
|
* @param array $items the dropdown items configuration. |
|
|
|
* @param array $panes the panes reference array. |
|
|
|
* @param array $panes the panes reference array. |
|
|
|
* @return boolean whether any of the dropdown items is `active` or not. |
|
|
|
* @return boolean whether any of the dropdown items is `active` or not. |
|
|
|
* @throws InvalidConfigException |
|
|
|
* @throws InvalidConfigException |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
protected function renderDropdown(&$items, &$panes) |
|
|
|
protected function renderDropdown(&$items, &$panes) |
|
|
|
{ |
|
|
|
{ |
|
|
|
$itemActive = false; |
|
|
|
$itemActive = false; |
|
|
|
|
|
|
|
|
|
|
|
foreach ($items as $n => &$item) { |
|
|
|
foreach ($items as $n => &$item) { |
|
|
|
if (is_string($item)) { |
|
|
|
if (is_string($item)) { |
|
|
|
continue; |
|
|
|
continue; |
|
|
|
} |
|
|
|
} |
|
|
|
if (!isset($item['content'])) { |
|
|
|
if (!isset($item['content'])) { |
|
|
|
throw new InvalidConfigException("The 'content' option is required."); |
|
|
|
throw new InvalidConfigException("The 'content' option is required."); |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
$content = ArrayHelper::remove($item, 'content'); |
|
|
|
$content = ArrayHelper::remove($item, 'content'); |
|
|
|
$options = ArrayHelper::remove($item, 'contentOptions', []); |
|
|
|
$options = ArrayHelper::remove($item, 'contentOptions', []); |
|
|
|
Html::addCssClass($options, 'tab-pane'); |
|
|
|
Html::addCssClass($options, 'tab-pane'); |
|
|
|
if (ArrayHelper::remove($item, 'active')) { |
|
|
|
if (ArrayHelper::remove($item, 'active')) { |
|
|
|
Html::addCssClass($options, 'active'); |
|
|
|
Html::addCssClass($options, 'active'); |
|
|
|
Html::addCssClass($item['options'], 'active'); |
|
|
|
Html::addCssClass($item['options'], 'active'); |
|
|
|
$itemActive = true; |
|
|
|
$itemActive = true; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
|
|
|
|
$options['id'] = ArrayHelper::getValue($options, 'id', $this->options['id'] . '-dd-tab' . $n); |
|
|
|
$options['id'] = ArrayHelper::getValue($options, 'id', $this->options['id'] . '-dd-tab' . $n); |
|
|
|
$item['url'] = '#' . $options['id']; |
|
|
|
$item['url'] = '#' . $options['id']; |
|
|
|
$item['linkOptions']['data-toggle'] = 'tab'; |
|
|
|
$item['linkOptions']['data-toggle'] = 'tab'; |
|
|
|
|
|
|
|
|
|
|
|
$panes[] = Html::tag('div', $content, $options); |
|
|
|
$panes[] = Html::tag('div', $content, $options); |
|
|
|
|
|
|
|
|
|
|
|
unset($item); |
|
|
|
unset($item); |
|
|
|
} |
|
|
|
} |
|
|
|
return $itemActive; |
|
|
|
|
|
|
|
} |
|
|
|
return $itemActive; |
|
|
|
|
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|