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

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 the CLinkPager widget before it is 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 a value of 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 main.php application configuration file as follows:
    return array(
      …
      'components'=>array(
        'widgetFactory'=>array(
          'widgets'=>array(
            'CLinkPager'=>array(
              'pageSize'=>15,
            ),
            …
          ),
        ),
        …
      ),
    );
  2. Now, the default value for pageSize of CLinkPager will be 15, so if we omit this parameter for all the CLinkPager classes of the application 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 set the default overall style in an external file, but can still override this through inline styles for individual widgets.

See also

  • The Configuring components recipe
主站蜘蛛池模板: 白玉县| 南木林县| 汨罗市| 邯郸市| 宽城| 大关县| 莱州市| 福建省| 依兰县| 陵水| 遂平县| 扎兰屯市| 新河县| 长葛市| 临江市| 乌鲁木齐市| 河北省| 龙川县| 专栏| 廉江市| 邵武市| 眉山市| 库车县| 安阳县| 白玉县| 尼木县| 崇文区| 柳州市| 柏乡县| 科尔| 涞源县| 民丰县| 融水| 黔西县| 金沙县| 巴塘县| 仁化县| 张北县| 温泉县| 台中市| 凤翔县|