array( * array( * 'label' => 'Home', * 'url' => '/', * 'linkOptions' => array(...), * 'active' => true, * ), * array( * 'label' => 'Dropdown', * 'items' => array( * array( * 'label' => 'DropdownA', * 'url' => '#', * ), * array( * 'label' => 'DropdownB', * 'url' => '#', * ), * ), * ), * ), * )); * ``` * * @see http://twitter.github.io/bootstrap/components.html#nav * @author Antonio Ramirez * @since 2.0 */ class Nav extends Widget { /** * @var array list of items in the nav widget. Each array element represents a single * menu item with the following structure: * * - label: string, required, the nav item label. * - url: optional, the item's URL. Defaults to "#". * - linkOptions: array, optional, the HTML attributes of the item's link. * - options: array, optional, the HTML attributes of the item container (LI). * - active: boolean, optional, whether the item should be on active state or not. * - dropdown: array|string, optional, the configuration array for creating a [[Dropdown]] widget, * or a string representing the dropdown menu. Note that Bootstrap does not support sub-dropdown menus. */ public $items = array(); /** * @var boolean whether the nav items labels should be HTML-encoded. */ public $encodeLabels = true; /** * Initializes the widget. */ public function init() { parent::init(); $this->addCssClass($this->options, 'nav'); } /** * Renders the widget. */ public function run() { echo $this->renderItems(); $this->getView()->registerAssetBundle('yii/bootstrap'); } /** * Renders widget items. */ public function renderItems() { $items = array(); foreach ($this->items as $item) { $items[] = $this->renderItem($item); } return Html::tag('ul', implode("\n", $items), $this->options); } /** * Renders a widget's item. * @param mixed $item the item to render. * @return string the rendering result. * @throws InvalidConfigException */ public function renderItem($item) { if (is_string($item)) { return $item; } if (!isset($item['label'])) { throw new InvalidConfigException("The 'label' option is required."); } $label = $this->encodeLabels ? Html::encode($item['label']) : $item['label']; $options = ArrayHelper::getValue($item, 'options', array()); $dropdown = ArrayHelper::getValue($item, 'dropdown'); $url = Html::url(ArrayHelper::getValue($item, 'url', '#')); $linkOptions = ArrayHelper::getValue($item, 'linkOptions', array()); if(ArrayHelper::getValue($item, 'active')) { $this->addCssClass($options, 'active'); } if ($dropdown !== null) { $linkOptions['data-toggle'] = 'dropdown'; $this->addCssClass($options, 'dropdown'); $this->addCssClass($urlOptions, 'dropdown-toggle'); $label .= ' ' . Html::tag('b', '', array('class' => 'caret')); if (is_array($dropdown)) { $dropdown['clientOptions'] = false; $dropdown = Dropdown::widget($dropdown); } } return Html::tag('li', Html::a($label, $url, $linkOptions) . $dropdown, $options); } }