'NavBar Test']); * echo Nav::widget([ * 'items' => [ * ['label' => 'Home', 'url' => ['/site/index']], * ['label' => 'About', 'url' => ['/site/about']], * ], * 'options' => ['class' => 'navbar-nav'], * ]); * NavBar::end(); * ``` * * @property-write array $containerOptions * * @see https://getbootstrap.com/docs/5.0/components/navbar/ * @author Antonio Ramirez * @author Alexander Kochetov */ class NavBar extends Widget { /** * @var array the HTML attributes for the widget container tag. The following special options are recognized: * * - tag: string, defaults to "nav", the name of the container tag. * * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. */ public array $options = []; /** * @var array the HTML attributes for the container tag. The following special options are recognized: * * - tag: string, defaults to "div", the name of the container tag. * * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. */ public array $collapseOptions = []; /** * @var string|bool the text of the brand or false if it's not used. Note that this is not HTML-encoded. * @see https://getbootstrap.com/docs/5.0/components/navbar/ */ public $brandLabel = false; /** * @var string|bool src of the brand image or false if it's not used. Note that this param will override `$this->brandLabel` param. * @see https://getbootstrap.com/docs/5.0/components/navbar/ * @since 2.0.8 */ public $brandImage = false; /** * @var array|string|bool $url the URL for the brand's hyperlink tag. This parameter will be processed by [[\yii\helpers\Url::to()]] * and will be used for the "href" attribute of the brand link. Default value is false that means * [[\yii\web\Application::homeUrl]] will be used. * You may set it to `null` if you want to have no link at all. */ public $brandUrl = false; /** * @var array the HTML attributes of the brand link. * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. */ public array $brandOptions = []; /** * @var string text to show for screen readers for the button to toggle the navbar. */ public string $screenReaderToggleText = 'Toggle navigation'; /** * @var string the toggle button content. Defaults to bootstrap 5 default `` */ public string $togglerContent = ''; /** * @var array the HTML attributes of the navbar toggler button. * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. */ public array $togglerOptions = []; /** * @var bool whether the navbar content should be included in an inner div container which by default * adds left and right padding. Set this to false for a 100% width navbar. */ public bool $renderInnerContainer = true; /** * @var array the HTML attributes of the inner container. * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered. */ public array $innerContainerOptions = []; /** * {@inheritdoc} */ public array $clientOptions = []; /** * {@inheritDoc} */ public function init() { parent::init(); if (!isset($this->options['class']) || empty($this->options['class'])) { Html::addCssClass($this->options, [ 'widget' => 'navbar', 'toggle' => 'navbar-expand-lg', 'navbar-light', 'bg-light' ]); } else { Html::addCssClass($this->options, ['widget' => 'navbar']); } $navOptions = $this->options; $navTag = ArrayHelper::remove($navOptions, 'tag', 'nav'); $brand = ''; if (!isset($this->innerContainerOptions['class'])) { Html::addCssClass($this->innerContainerOptions, ['panel' => 'container']); } if (!isset($this->collapseOptions['id'])) { $this->collapseOptions['id'] = "{$this->options['id']}-collapse"; } if ($this->brandImage !== false) { $this->brandLabel = Html::img($this->brandImage); } if ($this->brandLabel !== false) { Html::addCssClass($this->brandOptions, ['widget' => 'navbar-brand']); if ($this->brandUrl === null) { $brand = Html::tag('span', $this->brandLabel, $this->brandOptions); } else { $brand = Html::a( $this->brandLabel, $this->brandUrl === false ? Yii::$app->homeUrl : $this->brandUrl, $this->brandOptions ); } } Html::addCssClass($this->collapseOptions, ['collapse' => 'collapse', 'widget' => 'navbar-collapse']); $collapseOptions = $this->collapseOptions; $collapseTag = ArrayHelper::remove($collapseOptions, 'tag', 'div'); echo Html::beginTag($navTag, $navOptions) . "\n"; if ($this->renderInnerContainer) { echo Html::beginTag('div', $this->innerContainerOptions) . "\n"; } echo $brand . "\n"; echo $this->renderToggleButton() . "\n"; echo Html::beginTag($collapseTag, $collapseOptions) . "\n"; } /** * Renders the widget. */ public function run() { $tag = ArrayHelper::remove($this->collapseOptions, 'tag', 'div'); echo Html::endTag($tag) . "\n"; if ($this->renderInnerContainer) { echo Html::endTag('div') . "\n"; } $tag = ArrayHelper::remove($this->options, 'tag', 'nav'); echo Html::endTag($tag); BootstrapPluginAsset::register($this->getView()); } /** * Container options setter for backwards compatibility * @param array $collapseOptions * @deprecated */ public function setContainerOptions(array $collapseOptions) { $this->collapseOptions = $collapseOptions; } /** * Renders collapsible toggle button. * @return string the rendering toggle button. */ protected function renderToggleButton(): string { $options = $this->togglerOptions; Html::addCssClass($options, ['widget' => 'navbar-toggler']); return Html::button( $this->togglerContent, ArrayHelper::merge($options, [ 'type' => 'button', 'data' => [ 'bs-toggle' => 'collapse', 'bs-target' => '#' . $this->collapseOptions['id'], ], 'aria' => [ 'controls' => $this->collapseOptions['id'], 'expanded' => 'false', 'label' => $this->screenReaderToggleText, ] ]) ); } }