CMenu

$this->widget('zii.widgets.CMenu', array(
    'items'=>array(
        // Important: you need to specify url as 'controller/action',
        // not just as 'controller' even if default acion is used.
        array('label'=>'Home', 'url'=>array('site/index')),
        // 'Products' menu item will be selected no matter which tag parameter value is since it's not specified.
        array('label'=>'Products', 'url'=>array('product/index'), 'items'=>array(
            array('label'=>'New Arrivals', 'url'=>array('product/new', 'tag'=>'new')),
            array('label'=>'Most Popular', 'url'=>array('product/index', 'tag'=>'popular')),
        )),
        array('label'=>'Login', 'url'=>array('site/login'), 'visible'=>Yii::app()->user->isGuest),
    ),
));

属性详细

whether to automatically activate items according to whether their route setting matches the currently requested route. Defaults to true.

whether to activate parent menu items when one of the corresponding child menu items is active. The activated parent menu items will also have its CSS classes appended with activeCssClass. Defaults to false.

the CSS class to be appended to the active menu item. Defaults to 'active'. If empty, the CSS class of menu items will not be changed.

whether the labels for menu items should be HTML-encoded. Defaults to true.

the CSS class that will be assigned to the first item in the main menu or each submenu. Defaults to null, meaning no such CSS class will be assigned.

whether to hide empty menu items. An empty menu item is one whose 'url' option is not set and which doesn't contain visible child menu items. Defaults to true.

HTML attributes for the menu's root container tag

the CSS class that will be assigned to every item. Defaults to null, meaning no such CSS class will be assigned.

the template used to render an individual menu item. In this template, the token "{menu}" will be replaced with the corresponding menu link or text. If this property is not set, each menu will be rendered without any decoration. This property will be overridden by the 'template' option set in individual menu items via {@items}.

list of menu items. Each menu item is specified as an array of name-value pairs. Possible option names include the following:

• label: string, optional, specifies the menu item label. When encodeLabel is true, the label will be HTML-encoded. If the label is not specified, it defaults to an empty string.
• url: string or array, optional, specifies the URL of the menu item. It is passed to CHtml::normalizeUrl to generate a valid URL. If this is not set, the menu item will be rendered as a span text.
• visible: boolean, optional, whether this menu item is visible. Defaults to true. This can be used to control the visibility of menu items based on user permissions.
• items: array, optional, specifies the sub-menu items. Its format is the same as the parent items.
• active: boolean, optional, whether this menu item is in active state (currently selected). If a menu item is active and activeClass is not empty, its CSS class will be appended with activeClass. If this option is not set, the menu item will be set active automatically when the current request is triggered by url. Note that the GET parameters not specified in the 'url' option will be ignored.
• template: string, optional, the template used to render this menu item. When this option is set, it will override the global setting itemTemplate. Please see itemTemplate for more details. This option has been available since version 1.1.1.
• linkOptions: array, optional, additional HTML attributes to be rendered for the link or span tag of the menu item.
• itemOptions: array, optional, additional HTML attributes to be rendered for the container tag of the menu item.
• submenuOptions: array, optional, additional HTML attributes to be rendered for the container of the submenu if this menu item has one. When this option is set, the submenuHtmlOptions property will be ignored for this particular submenu. This option has been available since version 1.1.6.

the CSS class that will be assigned to the last item in the main menu or each submenu. Defaults to null, meaning no such CSS class will be assigned.

the HTML element name that will be used to wrap the label of all menu links. For example, if this property is set as 'span', a menu item may be rendered as <li><a href="url"><span>label</span></a></li> This is useful when implementing menu items using the sliding window technique. Defaults to null, meaning no wrapper tag will be generated.

HTML attributes for the submenu's container tag.

方法详细

public function init()
{
    $this->htmlOptions['id']=$this->getId();
    $route=$this->getController()->getRoute();
    $this->items=$this->normalizeItems($this->items,$route,$hasActiveChild);
}

Initializes the menu widget. This method mainly normalizes the items property. If this method is overridden, make sure the parent implementation is invoked.

protected function isItemActive($item,$route)
{
    if(isset($item['url']) && is_array($item['url']) && !strcasecmp(trim($item['url'][0],'/'),$route))
    {
        if(count($item['url'])>1)
        {
            foreach(array_splice($item['url'],1) as $name=>$value)
            {
                if(!isset($_GET[$name]) || $_GET[$name]!=$value)
                    return false;
            }
        }
        return true;
    }
    return false;
}

Checks whether a menu item is active. This is done by checking if the currently requested URL is generated by the 'url' option of the menu item. Note that the GET parameters not specified in the 'url' option will be ignored.

protected function normalizeItems($items,$route,&$active)
{
    foreach($items as $i=>$item)
    {
        if(isset($item['visible']) && !$item['visible'])
        {
            unset($items[$i]);
            continue;
        }
        if(!isset($item['label']))
            $item['label']='';
        if($this->encodeLabel)
            $items[$i]['label']=CHtml::encode($item['label']);
        $hasActiveChild=false;
        if(isset($item['items']))
        {
            $items[$i]['items']=$this->normalizeItems($item['items'],$route,$hasActiveChild);
            if(empty($items[$i]['items']) && $this->hideEmptyItems)
            {
                unset($items[$i]['items']);
                if(!isset($item['url']))
                {
                    unset($items[$i]);
                    continue;
                }
            }
        }
        if(!isset($item['active']))
        {
            if($this->activateParents && $hasActiveChild || $this->activateItems && $this->isItemActive($item,$route))
                $active=$items[$i]['active']=true;
            else
                $items[$i]['active']=false;
        }
        else if($item['active'])
            $active=true;
    }
    return array_values($items);
}

Normalizes the items property so that the 'active' state is properly identified for every menu item.

protected function renderMenu($items)
{
    if(count($items))
    {
        echo CHtml::openTag('ul',$this->htmlOptions)."\n";
        $this->renderMenuRecursive($items);
        echo CHtml::closeTag('ul');
    }
}

Renders the menu items.

protected function renderMenuItem($item)
{
    if(isset($item['url']))
    {
        $label=$this->linkLabelWrapper===null ? $item['label'] : '<'.$this->linkLabelWrapper.'>'.$item['label'].'</'.$this->linkLabelWrapper.'>';
        return CHtml::link($label,$item['url'],isset($item['linkOptions']) ? $item['linkOptions'] : array());
    }
    else
        return CHtml::tag('span',isset($item['linkOptions']) ? $item['linkOptions'] : array(), $item['label']);
}

Renders the content of a menu item. Note that the container and the sub-menus are not rendered here.

protected function renderMenuRecursive($items)
{
    $count=0;
    $n=count($items);
    foreach($items as $item)
    {
        $count++;
        $options=isset($item['itemOptions']) ? $item['itemOptions'] : array();
        $class=array();
        if($item['active'] && $this->activeCssClass!='')
            $class[]=$this->activeCssClass;
        if($count===1 && $this->firstItemCssClass!==null)
            $class[]=$this->firstItemCssClass;
        if($count===$n && $this->lastItemCssClass!==null)
            $class[]=$this->lastItemCssClass;
        if($this->itemCssClass!==null)
            $class[]=$this->itemCssClass;
        if($class!==array())
        {
            if(empty($options['class']))
                $options['class']=implode(' ',$class);
            else
                $options['class'].=' '.implode(' ',$class);
        }

        echo CHtml::openTag('li', $options);

        $menu=$this->renderMenuItem($item);
        if(isset($this->itemTemplate) || isset($item['template']))
        {
            $template=isset($item['template']) ? $item['template'] : $this->itemTemplate;
            echo strtr($template,array('{menu}'=>$menu));
        }
        else
            echo $menu;

        if(isset($item['items']) && count($item['items']))
        {
            echo "\n".CHtml::openTag('ul',isset($item['submenuOptions']) ? $item['submenuOptions'] : $this->submenuHtmlOptions)."\n";
            $this->renderMenuRecursive($item['items']);
            echo CHtml::closeTag('ul')."\n";
        }

        echo CHtml::closeTag('li')."\n";
    }
}

Recursively renders the menu items.

public function run()
{
    $this->renderMenu($this->items);
}

Calls renderMenu to render the menu.