【下载文档:  Yii2框架之ListView小部件的使用方法.txt 】

---

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来展示数据了，示例代码如下：
'dataProvider' => $dataProvider,//数据提供器
'itemView' => '_diary',//指定item视图（该视图文件与当前视图在同一个目录下)
'viewParams' => [//传参数给每一个item
'moodCfg' => Mood::getAll()
],
'layout' => '{items}',//整个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'参数指定的视图文件中来编写每一条数据的展示格式了，示例代码如下：

最后的最后，效果图展示时间（略丑，勿怪）：
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持中文源码网。