abei1982 2017-02-08 16:02:17 2056次浏览 10条回复 16 11 0

增删改查,数据库操作的四大法宝中最常用的就是查了,一条记录、几条记录、一大堆记录。对于yii2而言,尤其后台,GridView是最常用且好用的数据列表部件,今天就说一说。

yii\grid\GridView;

GridView将结果集显示为表格(table),我们从一个项目开始开始。
一天客户老郑(郑讯)来到这里,说要我做一个页面,将所有的会员分页显示在列表里,每页10条数据,并且能按照表头排序。
好吧~

我查询了数据库的user表

id username password create_time sex province city
1 abei dWRvDOMGjvGQZMGlxFR2xfhsfGpzu8Rx 1479876598 1 北京 北京
2 郑讯 dWRvDOMGjvGQZMGlxFR2xfhsfGpzu8Rx 1479876698 0 黑龙江 哈尔滨
11 马化腾 dWRvDOMGjvGQZMGlxFR2xfhsfGpzu8Rx 1479877598 1 黑龙江 齐齐哈尔
19 马云 dWRvDOMGjvGQZMGlxFR2xfhsfGpzu8Rx 1479886598 1 黑龙江 嫩江

然后我决定使用GridView来显示这些数据,这样分页、排序都直接搞定了,我知道需要两步

第一步是在控制器UserController.php里获得结果集

    public function actionIndex(){
        $query = User::find();
        
        $dataProvider = new ActiveDataProvider([
            'query'=>$query,
            'pagination'=>[
                'pagesize'=>10
            ]
        ]);
        
        return $this->render('index',[
            'dataProvider'=>$dataProvider
        ]);
    }

第二部渲染视图
index.php

    use yii\grid\GridView;
    
    <?= GridView::widget([
        'dataProvider' => $dataProvider,
        'columns' => [
            'id',
            'username',
            'create_time',
            'sex',
            'province',
            'city'
        ]
    ]);?>

完活了,聪明的GridView会搞定一切,我只需要将$dataProvider传递给ta,并且告诉他都要显示User模型(user表)的那些属性,放到columns数组中即可。
就这样,表格出来了,且每个表都都能排序,客户的需求达到了。

gridview-1.png

30分钟后我拿给郑讯看,见他默默无语,说了几句话。

  • 表头改成编号、用户名、生成时间等,不要英文。
  • 会员生成时间我看不懂,改成年月日十分秒吧
  • 性别改成男or女
  • 省市两列合并,像province-city这样

恩,客户是上帝,改改吧~,主要是我知道:"这个其实很简单,GridView都能轻松搞定"

对于表头的显示,GridView是根据User模型的attributeLabels函数来决定的,现在就改
User.php

   /**
     * @inheritdoc
     */
    public function attributeLabels()
    {
        return [
            'id' => 'ID',
            'create_time' => 'Create Time',
            'username'=>'Username',
            'password'=>'Password',
            'sex'=>'Sex',            
        ];
    }

现在就改,60秒过去了

   /**
     * @inheritdoc
     */
    public function attributeLabels()
    {
        return [
            'id' => '编号',
            'create_time' => '生成时间',
            'username'=>'用户名',
            'password'=>'Password',
            'sex'=>'性别',            
        ];
    }

但是,我发现省市怎么没有,哦,想起来了,province和city是我后来添加到数据表的,并没有更新User模型,那我直接加上就可以了。
最终版

   /**
     * @inheritdoc
     */
    public function attributeLabels()
    {
        return [
            'id' => '编号',
            'create_time' => '生成时间',
            'username'=>'用户名',
            'password'=>'Password',
            'sex'=>'性别',     
            'province'=>'省',
            'city'=>'市'
        ];
    }

搞定,在运行程序,"表头改成编号、用户名、生成时间等,不要英文"这个问题搞定了。
gridview-2.png

继续把,现在要处理"会员生成时间我看不懂,改成年月日十分秒吧"这个问题,它也很简单,因为我知道除了向GridView的 columns传递每个属性名字外,我们还能传递一个自定义的数组,格式化数据、逻辑处理,啥都能干出来,相当禽兽。
开始改视图index.php,我只花了10秒钟

index.php

    use yii\grid\GridView;
    
    <?= GridView::widget([
        'dataProvider' => $dataProvider,
        'columns' => [
            'id',
            'username',
            [
                'attribute'=>'create_time',
                'format'=>['date', 'php:Y-m-d H:i:s']
            ],
            'sex',
            'province',
            'city'
        ]
    ]);?>

'attribute'=>'create_time'

attribute要填写,代表你在操作那个属性,且在这里排序也是根据他来的。
format是代表对create_time进行什么样的格式化,默认\yii\i18n\Formatter 来对其处理。

刷新浏览器
gridview-3.png

又一个山头给我们攻克了。

这里要提一下,[]的功能很强大,上面的实现也可以根据以下代码来实现
index.php

    use yii\grid\GridView;
    
    <?= GridView::widget([
        'dataProvider' => $dataProvider,
        'columns' => [
            'id',
            'username',
            [
                'attribute'=>'create_time',
                'value'=>function($data){
                    return date('Y-m-d H:i:s',$data->create_time);
                }
            ],
            'sex',
            'province',
            'city'
        ]
    ]);?>

"性别改成男女",不多言,直接代码

index.php

    use yii\grid\GridView;
    
    <?= GridView::widget([
        'dataProvider' => $dataProvider,
        'columns' => [
            'id',
            'username',
            [
                'attribute'=>'create_time',
                'format'=>['date', 'php:Y-m-d H:i:s']
            ],
            [
                'attribute'=>'sex',
                'value'=>function($data){
                    return $data->sex == 1 ? '男' : '女';
                }
            ],
            'province',
            'city'
        ]
    ]);?>

刷新浏览器

gridview-4.png

value是一个很好的属性,当你不知道有没有提供内置命令的时候,都可以使用value去用自己的思路实现需求。

还有最后一个,"省市两列合并,像province-city这样",胜利就在前方,我想你已经有了思路。
只需要改一点

   [
        'attribute'=>'province',
        'value'=>function($data){
            return $data->province."-".$data->city;
        }
   ]

是的,你的思路是对的。但是发现一个问题,表头显示"省",ta应该显示"省市"才对,不要紧,我们热烈欢迎label属性出场。

   [
        'label'=>'省市',
        'attribute'=>'province',
        'value'=>function($data){
            return $data->province."-".$data->city;
        }
   ]

最后我看了下。
gridview-5.png

不错不错,喝杯茶,一会去给客户看。

10分钟后,我郁闷的回来了,知道这回客户提了那些乱七八糟的需求么?且听下回分解《GridView - 睡衣篇》

原文链接:http://www.maomaonv.com/question-view.html?id=9
Github地址:https://github.com/abei2017/small-yii2

GridView yii2
觉得很赞
您需要登录后才可以回复。登录 | 立即注册
在线
274