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' => 'yii\grid\ActionColumn', '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' => '确认布局生效?']) ?>
GirdView的使用
介绍一些 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 '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' => 'yii\grid\ActionColumn', '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' => 'yii\grid\ActionColumn', '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。
常见的 Form 表单视图元素
文本框: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'])?>
关键字:php, yii
版权声明
本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处。如若内容有涉嫌抄袭侵权/违法违规/事实不符,请点击 举报 进行投诉反馈!