Yii2的相关学习记录，Gridview小部件使用及kartik-v/yii2-grid扩展（五）

Yii2的相关学习记录，Gridview小部件使用及kartik-v/yii2-grid扩展（五） - 漫游云巅

php中文网

发布： 2016-05-20 11:54:10

原创

877人浏览过

现在记录下gridview的相关内容，也是强迫症犯了，yii2自带的gridview虽然不错，但是过滤栏如果一些字段用不着，不会自动合并成一行，当然也可以过滤栏不用，而是在最上方自己写一些需要检索的数据，但是这样很麻烦，还要自己去规划样式，写检索什么的。正好在搜索将检索栏和标题合并时，看到了kartik-v/yii2-grid可以实现这些功能，而且还自带导出excel、csv等数据，所以也顺便试了下它的功能，调出了自己喜欢的样式。在用kartik-v的gridview之前我们还是要了解yii2自带的gridview的功能的，大体常用的一些方法如下：

1、Yii默认有四种样式的列，分别为Data column（默认）、Action column（操作）、Checkbox column（可选中）、Serial column（带序列号）

2、标题名字会根据Model中的attributeLabels()方法,来自动替换成对应的中文。当然也可以通过‘label’来自己定义，而‘attribute’则是指定根据哪个字段排序。其它的像是'visible'来隐藏显示，'header'显示头部内容，'headerOptions'来定义css或style样式等等。

<span style="color: #000000;">[
    </span>'label'=&gt;'你想要的名称',
    'attribute'=&gt;'id',<span style="color: #008000;">//</span><span style="color: #008000;">可以排序的字段</span>
<span style="color: #000000;">]
</span>

登录后复制

3、自定义显示页数和排序字段，如果用到了searchModel，则需要在searchModel的search方法中定义，否则，需要在Controller中定义：

<span style="color: #800080;">$dataProvider</span> = <span style="color: #0000ff;">new</span><span style="color: #000000;"> ActiveDataProvider([
    </span>'query' =&gt; <span style="color: #800080;">$query</span>,
    'pagination' =&gt;<span style="color: #000000;"> [
        </span>'pageSize' =&gt; 15,<span style="color: #008000;">//</span><span style="color: #008000;">如果不定义，默认为20</span>
    ],
    'sort' =&gt; ['attributes' =&gt; ['id']],<span style="color: #008000;">//</span><span style="color: #008000;">如果定义，则只能按照id来排序，否则所有字段都可以</span>
]);

登录后复制

4、下拉菜单检索，好比根据下拉菜单检索用户状态，则需要先在model中定义相关的方法，然后在Gridview中再做处理：

<span style="color: #008000;">//</span><span style="color: #008000;">Model中，定义一个静态方法</span>
<span style="color: #0000ff;">const</span> STATUS_DELETED = 0<span style="color: #000000;">;
</span><span style="color: #0000ff;">const</span> STATUS_ACTIVE = 10<span style="color: #000000;">;
</span><span style="color: #0000ff;">public</span> <span style="color: #0000ff;">static</span> <span style="color: #0000ff;">function</span> getZhStatus(<span style="color: #800080;">$status</span>=<span style="color: #0000ff;">false</span><span style="color: #000000;">){
    </span><span style="color: #800080;">$status_array</span>=<span style="color: #000000;"> [
        </span>''=&gt;'请选择',<span style="color: #000000;">
        self</span>::STATUS_DELETED=&gt;'禁止',<span style="color: #000000;">
        self</span>::STATUS_ACTIVE=&gt;'正常'<span style="color: #000000;">
    ];
    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$status</span>==<span style="color: #0000ff;">false</span>?<span style="color: #800080;">$status_array</span>:ArrayHelper::getValue(<span style="color: #800080;">$status_array</span>,<span style="color: #800080;">$status</span>,'未知'<span style="color: #000000;">);
} 
</span><span style="color: #008000;">//</span><span style="color: #008000;">Gridview中</span>
<span style="color: #000000;">[ 
    </span>'attribute' =&gt; 'status',
    'filter'=&gt;Html::activeDropDownList(<span style="color: #800080;">$searchModel</span>,'status',User::getZhStatus(),['class' =&gt; 'form-control ']),
    'value'=&gt;<span style="color: #0000ff;">function</span>(<span style="color: #800080;">$data</span><span style="color: #000000;">){
        </span><span style="color: #0000ff;">return</span> User::getZhStatus(<span style="color: #800080;">$data</span>-&gt;<span style="color: #000000;">status);
    }</span>,<span style="color: #000000;">
]</span>,

登录后复制

5、格式化时间，有好几种方法：

方法一：类似上面的定义回调函数

<span style="color: #000000;">[
    </span>'attribute'=&gt;'created_at',
    'value'=&gt;<span style="color: #0000ff;">function</span>(<span style="color: #800080;">$data</span><span style="color: #000000;">){
        </span><span style="color: #0000ff;">return</span> <span style="color: #008080;">date</span>('Y-m-d',<span style="color: #800080;">$data</span>-&gt;<span style="color: #000000;">created_at);   
   }</span>,<span style="color: #000000;">
]</span>

登录后复制

方法二：用Gridview自带的format配置

<span style="color: #000000;">[
    </span>'attribute'=&gt;'created_at',
    'format'=&gt;['date','php:Y-m-d'],
    'value'=&gt;'created_at',<span style="color: #000000;">
]</span>,

登录后复制

方法三：首先在config中配置好你的时间格式，否则会是英文格式的，然后再在Gridview中处理。

<span style="color: #008000;">//</span><span style="color: #008000;">在common/config/main.php中定义自己的时间、金钱等的格式</span>
'components' =&gt;<span style="color: #000000;"> [
    </span>'formatter' =&gt;<span style="color: #000000;"> [
        </span>'dateFormat' =&gt; 'yyyy-MM-dd',
        'datetimeFormat' =&gt; 'yyyy-MM-dd HH:mm:ss',
        'decimalSeparator' =&gt; ',',
        'thousandSeparator' =&gt; ' ',
        'currencyCode' =&gt; 'CNY',<span style="color: #000000;">
    ]</span>,<span style="color: #000000;">
]</span>,

登录后复制

这里用到了快速写的一种方式：“attribute:format:label”（属性：格式：标签）这种格式，详情点击这里的api文档。所以我们这样就可以了：(如果定义了上方，则方法二可以直接'format'=>'date'即可以正确显示)

'created_at:date',

登录后复制

6、显示超链接或图片，都是用的回调函数的方法，这里以超链接为例，注意format需要为'raw’，不对结果做任何格式化处理，具体的格式化方面可以点这里看看。

<span style="color: #000000;">[ 
    </span>'attribute'=&gt;'id',
    'value'=&gt;<span style="color: #0000ff;">function</span>(<span style="color: #800080;">$model</span>, <span style="color: #800080;">$key</span>, <span style="color: #800080;">$index</span>, <span style="color: #800080;">$column</span><span style="color: #000000;">){
        </span><span style="color: #0000ff;">return</span> Html::a(<span style="color: #800080;">$model</span>-&gt;id,['user/view','id'=&gt;<span style="color: #800080;">$model</span>-&gt;id],['class' =&gt; 'profile-link','target'=&gt;'_blank'<span style="color: #000000;">]);
    }</span>,
    'format' =&gt; 'raw',<span style="color: #000000;">
]</span>,

登录后复制

7、关联表单显示，这个地方直接看指南吧，点这里看，总之就是如果管理表单设置好后，直接用类似order.name这种就可以直接显示使用，如果想要检索排序，则需要在searchModel的rulers规则方法和attributes属性方法中将此字段写入，在search方法中添加andFilterWhere的检索，以及用$query->joinWith关联字段，$dataProvider->sort->attributes[]添加排序等。

8、自定义Action Column按钮，

<span style="color: #000000;">[
    </span>'class' =&gt; 'yii\grid\ActionColumn',
    'header'=&gt;'操作',
    'headerOptions'=&gt;['width'=&gt;'120'],
    'template' =&gt; '{view} {update} {delete} {forbid} ',
    'buttons'=&gt;<span style="color: #000000;">[
        </span>'forbid'=&gt;<span style="color: #0000ff;">function</span>(<span style="color: #800080;">$url</span>,<span style="color: #800080;">$model</span><span style="color: #000000;">){
            </span><span style="color: #0000ff;">return</span> Html::<span style="color: #000000;">a('<i class="glyphicon glyphicon-remove-circle"></i>',['user/forbid','id'=&gt;$model-&gt;id]);     
        }
    ]</span>,<span style="color: #000000;">
]</span>

登录后复制

以上是Yii2自带的Gridview的用法。再说下kartik-v/yii2-grid，官方文档及demo讲的比较全了，它比原生的多了几个列的形式，例如Editable Column(可编辑)、Radio Column(单选框)等，还多了一些其它功能，例如滚动时可以固定标题栏方便查看、可以总计、导出svn，excel等格式。这里稍微说下：

一开始安装完成后可能会报错pdf错误，因为这些关联的还没有安装，可以按照提示安装也可以先配置'export'=>false来取消导出功能，下面导出时会详细配置。

1、整体结构如下图： Yii2的相关学习记录，Gridview小部件使用及kartik-v/yii2-grid扩展（五） - 漫游云巅