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