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>

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

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