diff --git a/framework/widgets/Breadcrumbs.php b/framework/widgets/Breadcrumbs.php new file mode 100644 index 0000000..f60908f --- /dev/null +++ b/framework/widgets/Breadcrumbs.php @@ -0,0 +1,100 @@ + + * @since 2.0 + */ +class Breadcrumbs extends Widget +{ + /** + * @var array the HTML attributes for the breadcrumb container tag. The "tag" element is + * specially handled which specifies the tag name of the container element. If not set, it will default to "ul". + */ + public $options = array('tag' => 'ul', 'class' => 'breadcrumb'); + /** + * @var boolean whether to HTML encode the link labels. Defaults to true. + */ + public $encodeLabels = true; + /** + * @var string the first hyperlink in the breadcrumbs (called home link). + * If this property is not set, it defaults to a link pointing to {@link CWebApplication::homeUrl} with label 'Home'. + * If this property is false, the home link will not be rendered. + */ + public $homeLink; + /** + * @var array list of hyperlinks to appear in the breadcrumbs. If this property is empty, + * the widget will not render anything. Each key-value pair in the array + * will be used to generate a hyperlink by calling CHtml::link(key, value). For this reason, the key + * refers to the label of the link while the value can be a string or an array (used to + * create a URL). For more details, please refer to {@link CHtml::link}. + * If an element's key is an integer, it means the element will be rendered as a label only (meaning the current page). + * + * The following example will generate breadcrumbs as "Home > Sample post > Edit", where "Home" points to the homepage, + * "Sample post" points to the "index.php?r=post/view&id=12" page, and "Edit" is a label. Note that the "Home" link + * is specified via {@link homeLink} separately. + * + *
+	 * array(
+	 *     'Sample post'=>array('post/view', 'id'=>12),
+	 *     'Edit',
+	 * )
+	 * 
+ */ + public $links = array(); + /** + * @var string String, specifies how each active item is rendered. Defaults to + * "{label}", where "{label}" will be replaced by the corresponding item + * label while "{url}" will be replaced by the URL of the item. + * @since 1.1.11 + */ + public $itemTemplate = "
  • {link} /
  • \n"; + /** + * @var string String, specifies how each inactive item is rendered. Defaults to + * "{label}", where "{label}" will be replaced by the corresponding item label. + * Note that inactive template does not have "{url}" parameter. + * @since 1.1.11 + */ + public $activeItemTemplate = "
  • {link}
  • \n"; + /** + * @var string the separator between links in the breadcrumbs. Defaults to ' » '. + */ + public $separator = ' » '; + + /** + * Renders the content of the portlet. + */ + public function run() + { + if (!empty($this->links)) { + return; + } + $links = array(); + if ($this->homeLink === null) { + $links[] = Html::a(Html::encode('yii|Home'), Yii::$app->homeUrl); + } elseif ($this->homeLink !== false) { + $links[] = $this->homeLink; + } + foreach ($this->links as $link) { + if (strpos($link, 'itemTemplate, array('{link}' => $link)); + } else { + $links[] = strtr($this->activeItemTemplate, array('{link}' => $link)); + } + } + $tagName = isset($this->options['tag']) ? $this->options['tag'] : 'ul'; + unset($this->options['tag']); + echo Html::tag($tagName, implode('', $this->links), $this->options); + } +} \ No newline at end of file