©
本文檔使用 php中文網手册 發布
有时显示数据会根据一个或多个属性进行排序。如果你正在使用 数据提供者 和 数据小部件 中之一,排序 可以为你自动处理。否则,你应该创建一个 yii\data\Sort 实例,配置好后 将其应用到查询中。也可以传递给视图,可以在视图中通过某些属性创建链接来排序。
如下是一个典型的使用范例,
function actionIndex(){
$sort = new Sort([
'attributes' => [
'age',
'name' => [
'asc' => ['first_name' => SORT_ASC, 'last_name' => SORT_ASC],
'desc' => ['first_name' => SORT_DESC, 'last_name' => SORT_DESC],
'default' => SORT_DESC,
'label' => 'Name',
],
],
]);
$models = Article::find()
->where(['status' => 1])
->orderBy($sort->orders)
->all();
return $this->render('index', [
'models' => $models,
'sort' => $sort,
]);
}
在视图中:
// 显示指向排序动作的链接echo $sort->link('name') . ' | ' . $sort->link('age');
foreach ($models as $model) {
// 在这里显示 $model
}
以上,我们声明了支持了两个属性的排序:name
和 age
。 我们通过排序信息来查询以便于查询结果通过 Sort 对象 排序后更加准确有序。在视图中,我们通过相应的属性 展示了链接到页的两个超链接和数据排序。