integready/yii2-pagesize-widget

用于在 GridView 中启用动态页面大小选择的 Widget

安装: 930

依赖: 0

建议: 0

安全: 0

星标: 0

关注者: 2

分支: 18

公开问题: 0

类型:yii2-extension

v2.0.3 2017-02-25 11:55 UTC

This package is auto-updated.

Last update: 2024-08-29 04:47:27 UTC


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:是否对标签文本进行编码

许可证

MIT