zertex/yii2-gridview-pagesize-widget

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

1.0.2 2017-12-18 17:17 UTC

This package is not auto-updated.

Last update: 2024-09-29 05:01:41 UTC


README

GridPageSize 扩展,用于 Yii2

允许在GridView页面上显示显示记录的数量,并更改它

安装

建议通过 composer 安装。

在控制台中运行

composer require --prefer-dist zertex/yii2-gridview-pagesize-widget "*"

也可以在 composer.jsonrequired 部分添加一行

"zertex/yii2-gridview-pagesize-widget": "*"

使用方法

将小部件插入到视图中的GridView上方或下方

<?php echo \zertex\gridpagesize\GridPageSize::widget(); ?>

并将 filterSelector 参数在GridView中设置为示例中的设置。

<?= GridView::widget([
     'dataProvider' => $dataProvider,
     'filterModel' => $searchModel,
     'filterSelector' => 'select[name="per-page"]',
     'columns' => [
         ...
     ],
 ]); ?>

回调函数

<?php echo \zertex\gridpagesize\GridPageSize::widget([
    'callback' => function($pageSize = 0) {
        ...
        echo $pageSize;
        ...
    }
]); ?>

配置

以下参数可用于配置小部件。

  • label: 文本
  • defaultPageSize: 默认每页记录数
  • pageSizeParam: 包含每页记录数值的GET请求参数
  • sizes: 显示在列表选择中的数字数组
  • template: 小部件元素显示模板。默认为 '{label} {list}'
  • options: <select> 元素的HTML属性
  • labelOptions: <label> 元素的HTML属性
  • encodeLabel: 编码文本
  • callback: 在更改每页记录数时调用的函数