yii2 GridView常见操作 [ 2.0 版本 ]

作者：白狼 出处：http://www.manks.top/article/yii2_gridview本文版权归作者，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
收集了网络上GridView出现的大部分问题做一个总结，希望有一个能帮助到你。原文带图片参考。
如果下面有没说到的GridView常见问题，下方留言，我会进行补充。

• 1. 下拉搜索
• 1. 日期格式化并实现日期可搜索
• 1. 根据参数进行是否显示
• 1. 链接可点击跳转
• 1. 显示图片
• 1. html渲染
• 1. 自定义按钮
• 1. 设定宽度等样式
• 1. 自定义字段
• 1. 自定义行样式
• 1. 增加按钮调用js操作
• 1. 利用gridview实现批量删除

下拉搜索，我们先来看看预期的效果图

具体怎么实现喃？考虑到一张数据表要下拉效果的字段可能有很多个，我们先在其model中实现一个方法方便后续操作

public static function dropDown ($column, $value = null) {
    $dropDownList = [
        'is_delete'=> [
            '0'=>'显示',
            '1'=>'删除',
        ],
        'is_hot'=> [
            '0'=>'否',
            '1'=>'是',
        ],
        //有新的字段要实现下拉规则，可像上面这样进行添加
        // ......
    ];
    //根据具体值显示对应的值
    if ($value !== null) 
        return array_key_exists($column, $dropDownList) ? $dropDownList[$column][$value] : false;
    //返回关联数组，用户下拉的filter实现
    else
        return array_key_exists($column, $dropDownList) ? $dropDownList[$column] : false;
}

然后我们上代码看看具体怎么实现的下拉搜索

<?= GridView::widget([
    'dataProvider' => $dataProvider,
    'columns' => [
        // ......
        [
            'attribute' => 'is_hot',
            'value' => function ($model) {
                return Article::dropDown('is_hot', $model->is_hot);
            },
            'filter' => Article::dropDown('is_hot'),
        ],
        [
            'attribute' => 'is_delete',
            'value' => function ($model) {
                return Article::dropDown('is_delete', $model->is_delete);
            },
            'filter' => Article::dropDown('is_delete'),
        ],
        // ......
    ],
]); ?>

像这样，我们就简单地实现了两个下拉效果，要实现筛选功能，在你的dataProvider自定添加该字段的搜索条件即可

日期格式化，我们先来看看效果图

这个我们分情况讨论
1、如果你的数据库字段created_at存的时间格式是date或者datetime，那很简单，gridview中直接输出该字段created_at即可，如上图中右侧所示
2、如果数据库存入的时间戳类型，如上图中左侧所示，则需要像下面这样进行输出

[
    'attribute' => 'created_at',
    'value' => function ($model) {
        return date('Y-m-d H:i:s', $model->created_at);
    },
],
[
    'attribute' => 'created_at',
    'format' => ['date', 'Y-m-d H:i:s'],
],

以上展示了两种方式进行格式输出，都可以。但是，如果想要实现搜索的机制，如果你的数据库存入的是datetime型，很方便，dataProvider不用做修改，
代码如下

$query->andFilterWhere([
    // ......
    'created_at' => $this->created_at,
    // ......
]);

如果你的数据库存入的是时间戳，
第一步，修改对应规则如下图所示
第二步，修改dataProvider可参考如下代码

//我们搜索输入框中输入的格式一般是 2016-01-01 而非时间戳
//输出2016-01-01无非是想搜索这一天的数据，因此代码如下
if ($this->created_at) {
    $createdAt = strtotime($this->created_at);
    $createdAtEnd = $createdAt + 24*3600;
    $query->andWhere("created_at >= {$createdAt} AND created_at <= {$createdAtEnd}");
}

这里做个小总结，建议使用datetime类型，个人觉得存时间戳甚是麻烦，如果你有好的建议，下方留言我们共同交流。

是否显示某列案例

我们举一个简单的案例
条件：有一个get形参数type
需求：仅且type的值等于1的时候，列name才显示，否则该列不显示
代码实现如下：

[
    'attribute' => 'name',
    'value' => $model->name,
    'visible' => intval(Yii::$app->request->get('type')) == 1,
],

实现方式也是很简单滴。

链接可点击跳转案例

这个跟接下来我们要说的html渲染的效果十分类似，这里要说的是列的属性值 format,具体都有哪些格式可查看文件 yii\i18n\Formatter.php，各种format都可以解决

[
    'attribute' => 'order_id',
    'value' => function ($model) {
        return Html::a($model->order_id, "/order?id={$model->order_id}", ['target' => '_blank']);
    },
    'format' => 'raw',
],

显示图片案例

同上，这里只需要指定format格式为image即可，format第二个参数可设定图片大小，可参考下面的代码

[
    'label' => '头像',
    'format' => [
    'image', 
    [
    'width'=>'84',
    'height'=>'84'
    ]
    ],
    'value' => function ($model) { 
    return $model->image; 
    }
],

html渲染案例

什么意思喃，举个例子，我们有一个字段，标记为title，但是这个title不一样，ta含有html标签，我们不想在页面上展示

title123

这种形式，我们想要title123以p标签的形式展示，代码可参考如下，只需要指定format为raw形式即可

[
    'attribute' => 'title',
    'value' => function ($model) { 
    return Html::encode($model->title); 
    },
    'format' => 'raw',
],

自定义按钮案例

继续阅读