官术网_书友最值得收藏!

Configuring widget defaults

In Yii, code pieces commonly used in views are placed into widgets. For example, a widget can render a tag cloud or provide a custom form input type. Core widgets are highly configurable and are used in views as follows:

<?$this->widget('CLinkPager', array(
'pages' => $pages,
'pageSize' => 15,
))?>

In the preceding code, we are using $this->widget that calls a CLinkPager widget with an array of parameters to display a pagination. pages and pageSize are both assigned to the corresponding public properties of CLinkPager before it is being rendered.

Note that we have changed the count of items per page to 15 in our example. If we want our pagination to display 15 items per page on all pages of our application, then we will need to provide a pageSize parameter with value 15 for all CLinkPager widget calls. Is there a better way? Definitely, yes.

How to do it…

A Yii web application provides a bunch of components. One of them is a widget factory that since Yii 1.1.3 can be used to set widget defaults.

  1. Let's use it to set pageSize application-wide. We will need to edit the application configuration file main.php as follows:
    return array(
      …
      'components'=>array(
        'widgetFactory'=>array(
          'widgets'=>array(
            'CLinkPager'=>array(
              'pageSize'=>15,
            ),
            …
          ),
        ),
        …
      ),
    );
  2. Now, the default value for CLinkPager's pageSize will be 15, so if we omit this parameter for all the application CLinkPagers then it will be 15, application-wide.
  3. Moreover, we still can override the pageSize value for a specific widget:
    <?$this->widget('CLinkPager', array(
    'pages' => $pages,
    'pageSize' => 5,
    ))?>

This works much like the CSS cascade. You are setting the default overall style in an external file, but are still able to override this through inline styles for individual widgets.

See also

  • The recipe named Configuring components in this chapter
主站蜘蛛池模板: 林西县| 营山县| 元阳县| 博客| 闸北区| 五常市| 三亚市| 海伦市| 沙湾县| 陆良县| 金乡县| 葫芦岛市| 临潭县| 弥勒县| 白山市| 陕西省| 伊川县| 积石山| 武平县| 商南县| 林州市| 长丰县| 重庆市| 西乌珠穆沁旗| 高平市| 曲阜市| 柳江县| 苍溪县| 仲巴县| 达拉特旗| 六盘水市| 静乐县| 富裕县| 陈巴尔虎旗| 安阳市| 连城县| 海南省| 民乐县| 新津县| 安宁市| 合山市|