integready / yii2-pagesize-widget
用于在 GridView 中启用动态页面大小选择的 Widget
v2.0.3
2017-02-25 11:55 UTC
Requires
- yiisoft/yii2: *
Requires (Dev)
README
PageSize widget 是一个扩展,用于扩展 Yii2 GridView,允许更改 GridView 中的页面大小。
安装
通过 composer 安装此扩展是首选方式。
运行以下命令之一:
php composer.phar require --prefer-dist integready/yii2-pagesize-widget "*"
或
"integready/yii2-pagesize-widget": "*"
将以下内容添加到您的 composer.json
文件的 require 部分。
使用方法
要使用此 Widget 与 GridView,请将此 Widget 添加到 GridView 所在的视图中
<?php echo \integready\pagesize\PageSize::widget(); ?>
并将 GridView 的 filterSelector
属性设置如下示例所示。
<?= GridView::widget([ 'dataProvider' => $dataProvider, 'filterModel' => $searchModel, 'filterSelector' => 'select[name="per-page"]', 'columns' => [ ... ], ]); ?>
请注意,这里的 per-page
是用于 PageSize Widget 的 pageSizeParam
设置的字符串。
配置
以下属性可用于自定义 Widget。
label
:标签的文本defaultPageSize
:如果没有选择页面大小,则使用此值pageSizeParam
:用于网格视图分页 Widget 的页面大小参数名称sizes
:用作页面大小的键值数组。键和值都应该是整数template
:用于渲染元素的模板字符串。默认为'{list} {label}'
options
:<select>
元素的 HTML 属性labelOptions
:<label>
元素的 HTML 属性encodeLabel
:是否对标签文本进行编码