排序(Sorting)

最后更新于:2022-04-01 04:00:21

# 排序 有时显示数据会根据一个或多个属性进行排序。如果你正在使用 [数据提供者](http://www.yiichina.com/doc/guide/2.0/output-data-providers) 和 [数据小部件](http://www.yiichina.com/doc/guide/2.0/output-data-widgets) 中之一,排序 可以为你自动处理。否则,你应该创建一个 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 对象 排序后更加准确有序。在视图中,我们通过相应的属性 展示了链接到页的两个超链接和数据排序。 yii\data\Sort 类将获得自动传递的请求参数 并相应地调整排序选项。 你可以通过配置 yii\data\Sort::$params 属性来调整参数。
';