- Yii Application Development Cookbook(Second Edition)
- Alexander Makarov
- 304字
- 2021-11-12 16:36:11
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.
- Let's use it to set
pageSize
application-wide. We will need to edit themain.php
application configuration file as follows:return array( … 'components'=>array( 'widgetFactory'=>array( 'widgets'=>array( 'CLinkPager'=>array( 'pageSize'=>15, ), … ), ), … ), );
- Now, the default value for
pageSize
ofCLinkPager
will be15
, so if we omit this parameter for all theCLinkPager
classes of the application then it will be15
, application-wide. - 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
- 面向物聯網的CC2530與傳感器應用開發
- Building E-commerce Sites with VirtueMart Cookbook
- 從區塊鏈到Web3:構建未來互聯網生態
- 5G承載網網絡規劃與組網設計
- 物聯網之魂:物聯網協議與物聯網操作系統
- Hands-On Chatbots and Conversational UI Development
- 重新定義Spring Cloud實戰
- WordPress 5 Complete
- Metasploit Penetration Testing Cookbook
- 物聯網技術與應用
- 網絡安全應急響應技術實戰
- 6G:面向2030年的移動通信
- 物聯網工程概論
- Getting Started with nopCommerce
- 物聯網工程導論(第3版)