Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

merge.

git-svn-id: http://yii.googlecode.com/svn/trunk@3602 c7f931c7-7552-0410-b027-2fb3d89d9100
  • Loading branch information...
commit e25cb069ba07bf272a82ee5153b3af338f989e0d 1 parent d5a6d33
@qiangxue qiangxue authored
Showing with 1,387 additions and 1,393 deletions.
  1. +1,255 −1,256 CHANGELOG
  2. +132 −137 framework/zii/widgets/CBreadcrumbs.php
View
2,511 CHANGELOG
1,255 additions, 1,256 deletions not shown
View
269 framework/zii/widgets/CBreadcrumbs.php
@@ -1,138 +1,133 @@
-<?php
-/**
- * CBreadcrumbs class file.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @link http://www.yiiframework.com/
- * @copyright Copyright &copy; 2008-2011 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-/**
- * CBreadcrumbs displays a list of links indicating the position of the current page in the whole website.
- *
- * For example, breadcrumbs like "Home > Sample Post > Edit" means the user is viewing an edit page
- * for the "Sample Post". He can click on "Sample Post" to view that page, or he can click on "Home"
- * to return to the homepage.
- *
- * To use CBreadcrumbs, one usually needs to configure its {@link links} property, which specifies
- * the links to be displayed. For example,
- *
- * <pre>
- * $this->widget('zii.widgets.CBreadcrumbs', array(
- * 'links'=>array(
- * 'Sample post'=>array('post/view', 'id'=>12),
- * 'Edit',
- * ),
- * ));
- * </pre>
- *
- * Because breadcrumbs usually appears in nearly every page of a website, the widget is better to be placed
- * in a layout view. One can define a property "breadcrumbs" in the base controller class and assign it to the widget
- * in the layout, like the following:
- *
- * <pre>
- * $this->widget('zii.widgets.CBreadcrumbs', array(
- * 'links'=>$this->breadcrumbs,
- * ));
- * </pre>
- *
- * Then, in each view script, one only needs to assign the "breadcrumbs" property as needed.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @version $Id$
- * @package zii.widgets
- * @since 1.1
- */
-class CBreadcrumbs extends CWidget
-{
- /**
- * @var string the tag name for the breadcrumbs container tag. Defaults to 'div'.
- */
- public $tagName='div';
- /**
- * @var array the HTML attributes for the breadcrumbs container tag.
- */
- public $htmlOptions=array('class'=>'breadcrumbs');
- /**
- * @var boolean whether to HTML encode the link labels. Defaults to true.
- */
- public $encodeLabel=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.
- *
- * <pre>
- * array(
- * 'Sample post'=>array('post/view', 'id'=>12),
- * 'Edit',
- * )
- * </pre>
- */
- public $links=array();
- /**
- * @var string String, specifies how each active item is rendered. Defaults to
- * "<a href="{url}">{label}</a>", 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 $activeTemplate='<a href="{url}">{label}</a>';
- /**
- * @var string String, specifies how each inactive item is rendered. Defaults to
- * "<span>{label}</span>", 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 $inactiveTemplate='<span>{label}</span>';
- /**
- * @var string the separator between links in the breadcrumbs. Defaults to ' &raquo; '.
- */
- public $separator=' &raquo; ';
-
- /**
- * Renders the content of the portlet.
- */
- public function run()
- {
- if(empty($this->links))
- return;
-
- echo CHtml::openTag($this->tagName,$this->htmlOptions)."\n";
- $links=array();
- if($this->homeLink===null)
- $links[]=CHtml::link(Yii::t('zii','Home'),Yii::app()->homeUrl);
- else if($this->homeLink!==false)
- $links[]=$this->homeLink;
- foreach($this->links as $label=>$url)
- {
- $link='';
- if(is_string($label) || is_array($url))
- {
- $link=str_replace('{url}', CHtml::normalizeUrl($url), $this->activeTemplate);
- $link=str_replace('{label}', $this->encodeLabel ? CHtml::encode($label) : $label, $link);
- }
- else
- {
- $link=str_replace('{url}', CHtml::normalizeUrl($url), $this->inactiveTemplate);
- $link=str_replace('{label}', $this->encodeLabel ? CHtml::encode($url) : $url, $link);
- }
- $links[]=$link;
- }
- echo implode($this->separator,$links);
- echo CHtml::closeTag($this->tagName);
- }
+<?php
+/**
+ * CBreadcrumbs class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CBreadcrumbs displays a list of links indicating the position of the current page in the whole website.
+ *
+ * For example, breadcrumbs like "Home > Sample Post > Edit" means the user is viewing an edit page
+ * for the "Sample Post". He can click on "Sample Post" to view that page, or he can click on "Home"
+ * to return to the homepage.
+ *
+ * To use CBreadcrumbs, one usually needs to configure its {@link links} property, which specifies
+ * the links to be displayed. For example,
+ *
+ * <pre>
+ * $this->widget('zii.widgets.CBreadcrumbs', array(
+ * 'links'=>array(
+ * 'Sample post'=>array('post/view', 'id'=>12),
+ * 'Edit',
+ * ),
+ * ));
+ * </pre>
+ *
+ * Because breadcrumbs usually appears in nearly every page of a website, the widget is better to be placed
+ * in a layout view. One can define a property "breadcrumbs" in the base controller class and assign it to the widget
+ * in the layout, like the following:
+ *
+ * <pre>
+ * $this->widget('zii.widgets.CBreadcrumbs', array(
+ * 'links'=>$this->breadcrumbs,
+ * ));
+ * </pre>
+ *
+ * Then, in each view script, one only needs to assign the "breadcrumbs" property as needed.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id$
+ * @package zii.widgets
+ * @since 1.1
+ */
+class CBreadcrumbs extends CWidget
+{
+ /**
+ * @var string the tag name for the breadcrumbs container tag. Defaults to 'div'.
+ */
+ public $tagName='div';
+ /**
+ * @var array the HTML attributes for the breadcrumbs container tag.
+ */
+ public $htmlOptions=array('class'=>'breadcrumbs');
+ /**
+ * @var boolean whether to HTML encode the link labels. Defaults to true.
+ */
+ public $encodeLabel=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.
+ *
+ * <pre>
+ * array(
+ * 'Sample post'=>array('post/view', 'id'=>12),
+ * 'Edit',
+ * )
+ * </pre>
+ */
+ public $links=array();
+ /**
+ * @var string String, specifies how each active item is rendered. Defaults to
+ * "<a href="{url}">{label}</a>", 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 $activeLinkTemplate='<a href="{url}">{label}</a>';
+ /**
+ * @var string String, specifies how each inactive item is rendered. Defaults to
+ * "<span>{label}</span>", where "{label}" will be replaced by the corresponding item label.
+ * Note that inactive template does not have "{url}" parameter.
+ * @since 1.1.11
+ */
+ public $inactiveLinkTemplate='<span>{label}</span>';
+ /**
+ * @var string the separator between links in the breadcrumbs. Defaults to ' &raquo; '.
+ */
+ public $separator=' &raquo; ';
+
+ /**
+ * Renders the content of the portlet.
+ */
+ public function run()
+ {
+ if(empty($this->links))
+ return;
+
+ echo CHtml::openTag($this->tagName,$this->htmlOptions)."\n";
+ $links=array();
+ if($this->homeLink===null)
+ $links[]=CHtml::link(Yii::t('zii','Home'),Yii::app()->homeUrl);
+ else if($this->homeLink!==false)
+ $links[]=$this->homeLink;
+ foreach($this->links as $label=>$url)
+ {
+ if(is_string($label) || is_array($url))
+ $links[]=strtr($this->activeLinkTemplate,array(
+ '{url}'=>CHtml::normalizeUrl($url),
+ '{label}'=>$this->encodeLabel ? CHtml::encode($label) : $label,
+ ));
+ else
+ $links[]=str_replace('{label}',$this->encodeLabel ? CHtml::encode($url) : $url,$this->inactiveLinkTemplate);
+ }
+ echo implode($this->separator,$links);
+ echo CHtml::closeTag($this->tagName);
+ }
}
Please sign in to comment.
Something went wrong with that request. Please try again.