Yii2框架之ListView小部件的使用方法

　　ListView是yii框架中类似GridView，也是用于展示多条数据的小部件，相比GridView，ListView可以更加灵活地设置数据展示的格式。

　　下面以我自己做的一个使用ListView来展示数据的例子，来简单讲解一下ListView小部件的使用。

　　首先需要在控制器中new一个数据提供器，传给视图，示例代码如下：

　　 public function actionIndex() { $dataProvider = new ActiveDataProvider([ query => Diary::find()->orderBy(day), pagination => [//分页 pagesize => 4 ] ]); return $this->render(index, [ dataProvider => $dataProvider ]); }

　　接下来就是在视图文件中使用ListView来展示数据了，示例代码如下：

　　 <?= ListView::widget([ dataProvider => $dataProvider,//数据提供器 itemView => _diary,//指定item视图（该视图文件与当前视图在同一个目录下) viewParams => [//传参数给每一个item moodCfg => Mood::getAll() ], layout => {items}<div class=col-lg-12 sum-pager>{summary}{pager}</div>,//整个ListView布局 itemOptions => [//针对渲染的单个item tag => div, class => col-lg-3 ], /* options => [//针对整个ListView tag => div, class => col-lg-3 ], */ pager => [ //options => [class => hidden],//关闭分页（默认开启） /* 分页按钮设置 */ maxButtonCount => 5,//最多显示几个分页按钮 firstPageLabel => 首页, prevPageLabel => 上一页, nextPageLabel => 下一页, lastPageLabel => 尾页 ] ]);?>

　　这里说明一下，由于ListView和GridView继承于同一个父类BaseListView，所以有很多设置参数是一样的，可以通过参考GridView的参数设置来设置ListView。

　　最后就是在ListView的itemView参数指定的视图文件中来编写每一条数据的展示格式了，示例代码如下：

　　 <div class=item> <h4 style=font-weight:bold><?= Html::encode($model->title ? $model->title : （无题）) ?></h4> <p style=font-size:13px> <span style=color:orangered><?= date(Y.m.d, $model->day) ?></span><br> <span style=color:#999>心情：<?= $moodCfg[$model->mood] ?></span>//这里访问ListView的viewParams参数传过来的参数$moodCfg </p> <div style=margin:15px 0> <?php echo HtmlPurifier::process(mb_substr($model->content, 0, 25).......); ?> </div> <p class=info> 添加：<?= date(Y-m-d H:i:s, $model->created_at) ?><br> 最后修改：<?= date(Y-m-d H:i:s, $model->updated_at) ?> </p> <div style=text-align:right> <?= Html::a(<span class=glyphicon glyphicon-eye-open></span>, [view, id => $model->id], [title => 查看]) ?> <?= Html::a(<span class=glyphicon glyphicon-pencil></span>, [upcreate, id => $model->id], [title => 修改]) ?> <?= Html::a(<span class=glyphicon glyphicon-trash></span>, [delete, id => $model->id], [ title => 删除, data => [ confirm => 您确定真的要删除 .date(Y年m月d日, $model->day). 的日记吗？, method => post, ] ]) ?> </div> </div>

　　最后的最后，效果图展示时间（略丑，勿怪）：

　　以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。