Yii 的修行之路 - View 视图渲染

摘要：简述模块是中的架构的板块，主要负责数据的展示，渲染模板文件，展示数据内容。此外在一个视图中还可以引入多个视图文件，也是通过方法实现。布局文件的数据默认以显示，也可以用数据块的形式渲染到视图上。必须要确认生成一次，才会正式生成新首页。

View模块是Yii中的MVC架构的V板块，主要负责数据的展示，渲染模板文件，展示数据内容。

MVC在Yii里面有一个Views文件夹，里面存放的是项目的视图文件，负责展示数据内容。

首先这里是一个简单的控制器操作方法实现一个视图的渲染展示，调用renderPartial（）来渲染视图文件，第一个是视图文件名，存在在views目录下的以控制器命名的文件夹下，文件名字与操作方法相对应；第二个则是渲染视图的数据，必须是一个数组。

这是一个视图脚本php，里面是展示一些控制器传来的数据，还可以调用一些插件完成一些功能，比如数据过滤等等。

利用布局文件处理视图，首先在views目录下的layout文件夹下创建一个布局文件，名字自拟。

然后可以利用render（）的方法把布局文件渲染显示出来，而index视图的内容数据默认以$content的形式嵌入到布局文件，然后显示出来，当然，在render方法的第二个参数是一个数组，可以利用这个数组把数据渲染到视图上，然后展示出来。

此外在一个视图中还可以引入多个视图文件，也是通过render方法实现。

布局文件的数据默认以$content显示，也可以用数据块的形式渲染到视图上。

在Html上作 if else 的判断：

status == 1): ?>
    已启用

    已禁用

在Html上显示一些特殊按钮：

     $dataProvider,
        "filterModel" => $searchModel,
        "columns" => [

            [
                "class" => "yiigridActionColumn",
                "buttons" => [
                    "layoutContent" => function ($url, $model){
                        /**
                         * @var $model Service
                         */
                        return Html::a("查看服务单信息", Url::to(["jlerp-service-order/view", "id" => $model->id]), [
                            "class" => "btn btn-success btn-xs", "target" => "__blank"
                        ]);
                    }
                ],
                "template" => "{layoutContent}",
                "options" => [
                    "style" => "width:100px"
                ],
            ]

        ],
    ]); ?>

一些在Html上常用的摁钮实现

    

        
        预览首页效果
    

    

    

        
注意
        
每次修改完首页配置后，先预览查看效果，没问题后才确认生成。
        
可以根据输入的配置版本号预览查看相应的布局效果。
        
必须要确认生成一次，才会正式生成新首页。
    

    

        
预览方法
        
输入版本号，点击预览首页效果，进入预览效果页，然后：
        
如果是火狐浏览器，按Ctrl+Shift+M进入响应式设计图模式。
        
如果是谷歌浏览器，按F12，再按Ctrl+Shift+M。
    
    

    

         "btn btn-success"]) ?>
         "btn btn-danger", "data-confirm" => "确认布局生效？"]) ?>
    

介绍一些 GridView 常见的使用案例：

下拉搜索

日期格式化并实现日期可搜索

根据参数进行是否显示

链接可点击跳转

显示图片

html渲染

自定义按钮

设定宽度等样式

自定义字段

自定义行样式

增加按钮调用js操作

利用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;
}

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

 $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}");
}

是否显示某列

举一个简单的案例：
条件：有一个 get 型参数type
需求：仅且 type 的值等于1的时候，列 name 才显示，否则该列不显示。

代码实现如下：

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

链接可点击跳转

这个跟 html 渲染的效果十分类似，这里要说的是列的属性值 format,具体都有哪些格式可查看文件 yiii18nFormatter.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",
],

自定义按钮
往往列表页我们不想要删除按钮，想在增加一个比如获取xxx按钮，怎么实现？这里需要设置ActionColumn类，修改配置项template并在buttons项增加template里增加的get-xxx即可

[
    "class" => "yiigridActionColumn",
    "template" => "{get-xxx} {view} {update}",
    "header" => "操作",
    "buttons" => [
        "get-xxx" => function ($url, $model, $key) { 
        return Html::a("获取xxx", $url, ["title" => "获取xxx"] ); 
        },
    ],
],

设定宽度

举个简单的例子，我们的 title 列，太长了，能不能给我先定下这一列的宽度？
答案：能。
请看示例：

[
    "attribute" => "title",
    "value" => "title",
    "headerOptions" => ["width" => "100"],
],

只需要指定配置项headerOptions即可。

自定义字段

什么是自定义？这里我们是指在表格里增加一列且数据库中不存在对应的列。

假如我们新增一列 订单消费金额money且该表不存在该字段：

[
    "attribute" => "消费金额",
    "value" => function ($model) {
        // 这里可以根据该表的其他字段进行关联获取
    }
],

自定义行

有小伙伴说了，gii生成的这个gridview表格呀，行跟行的颜色不明显，看着难受，我们来看看怎么定义行样式：

 $dataProvider,
    "rowOptions" => function($model, $key, $index, $grid) {
        return ["class" => $index % 2 ==0 ? "label-red" : "label-green"];
    },
    // ......
]); ?>

前面的操作我们都是依据列column的，这里因为是对行的控制，所以我们配置rowOptions要稍微注意一下。此外，自定义的label-red和label-green需要有对应的样式实现，这里我们看一下页面的实际效果

增加按钮调用js操作

那边产品经理走过来了，小王呀，你这个修改状态的功能很频繁，每次都要先点进详情页才能修改，能不能我在列表页面上鼠标那么一点就成功修改了呢？

其实就是一个异步请求操作了当前行的状态嘛，我们来看看gridview里面是怎么实现的。

[
    "class" => "yiigridActionColumn",
    "header" => "操作",
    "template" => "{view} {update} {update-status}",
    "buttons" => [
        "update-status" => function ($url, $model, $key) {
            return Html::a("更新状态", "javascript:;",["onclick"=>"update_status(this, ".$model->id.");"]);
            },
    ],
],

还没完，我们还需要在页面写js实现方法 update_status。

文本框:textInput();
密码框:passwordInput();
单选框:radio(),radioList();
复选框:checkbox(),checkboxList();
下拉框:dropDownList();
隐藏域:hiddenInput();
文本域:textarea(["rows"=>3]);
文件上传:fileInput();
提交按钮:submitButton();
重置按钮:resetButtun();

 ["test/post"],"method"=>"post","id"="uploadform", ]); ?>
// 文本输入框
field($model,"username")->textInput(["maxlength"=>20])?>

// 密码输入框
field($model,"password")->passwordInput(["maxlength"=>20])?>

// 单选框
field($model,"sex")->radioList(["1"=>"男","0"=>"女"])?>

// 下拉选择框
field($model,"edu")->dropDownList(["1"=>"大学","2"=>"高中"], ["prompt"=>"请选择","style"=>"width:120px"])?>

// 文件上传框
field($model,"file")->fileInput()?>

// 复选框
field($model,"hobby")->checkboxList(["0"=>"篮球","1"=>"足球","2"=>"羽毛球","3"=>"乒乓球"])?>

// 文本输入框
field($model,"info")->textarea(["rows"=>3])?>field($model,"userid")->hiddenInput(["value"=>3])?>


"btn btn-primary","name"=>"submit-button"])?>
"btn btn-primary","name"=>"submit-button"])?>