array( * array('label' => 'Sample Post', 'url' => array('post/edit', 'id' => 1)), * 'Edit', * ), * )); * ~~~ * * Because breadcrumbs usually appears in nearly every page of a website, you may consider placing it in a layout view. * You can use a view parameter (e.g. `$this->params['breadcrumbs']`) to configure the links in different * views. In the layout view, you assign this view parameter to the [[links]] property like the following: * * ~~~ * // $this is the view object currently being used * echo Breadcrumbs::widget(array( * 'links' => isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : array(), * )); * ~~~ * * @author Qiang Xue * @since 2.0 */ class Breadcrumbs extends Widget { /** * @var string the name of the breadcrumb container tag. */ public $tag = 'ul'; /** * @var array the HTML attributes for the breadcrumb container tag. */ public $options = array('class' => 'breadcrumb'); /** * @var boolean whether to HTML-encode the link labels. */ public $encodeLabels = true; /** * @var string the first hyperlink in the breadcrumbs (called home link). * If this property is not set, it will default to a link pointing to [[\yii\web\Application::homeUrl]] * with the label 'Home'. If this property is false, the home link will not be rendered. */ public $homeLink; /** * @var array list of links to appear in the breadcrumbs. If this property is empty, * the widget will not render anything. Each array element represents a single link in the breadcrumbs * with the following structure: * * ~~~ * array( * 'label' => 'label of the link', // required * 'url' => 'url of the link', // optional, will be processed by Html::url() * ) * ~~~ * * If a link is active, you only need to specify its "label", and instead of writing `array('label' => $label)`, * you should simply use `$label`. */ public $links = array(); /** * @var string the template used to render each inactive item in the breadcrumbs. The token `{link}` * will be replaced with the actual HTML link for each inactive item. */ public $itemTemplate = "

{link} /

\n"; /** * @var string the template used to render each active item in the breadcrumbs. The token `{link}` * will be replaced with the actual HTML link for each active item. */ public $activeItemTemplate = "

{link}

\n"; /** * Renders the widget. */ public function run() { if (empty($this->links)) { return; } $links = array(); if ($this->homeLink === null) { $links[] = $this->renderItem(array( 'label' => Yii::t('yii', 'Home'), 'url' => Yii::$app->homeUrl, ), $this->itemTemplate); } elseif ($this->homeLink !== false) { $links[] = $this->renderItem($this->homeLink, $this->itemTemplate); } foreach ($this->links as $link) { if (!is_array($link)) { $link = array('label' => $link); } $links[] = $this->renderItem($link, isset($link['url']) ? $this->itemTemplate : $this->activeItemTemplate); } echo Html::tag($this->tag, implode('', $links), $this->options); } /** * Renders a single breadcrumb item. * @param array $link the link to be rendered. It must contain the "label" element. The "url" element is optional. * @param string $template the template to be used to rendered the link. The token "{link}" will be replaced by the link. * @return string the rendering result * @throws InvalidConfigException if `$link` does not have "label" element. */ protected function renderItem($link, $template) { if (isset($link['label'])) { $label = $this->encodeLabels ? Html::encode($link['label']) : $link['label']; } else { throw new InvalidConfigException('The "label" element is required for each link.'); } if (isset($link['url'])) { return strtr($template, array('{link}' => Html::a($label, $link['url']))); } else { return strtr($template, array('{link}' => $label)); } } }