排序（Sorting）

排序

有時顯示數(shù)據(jù)會根據(jù)一個或多個屬性進行排序。如果你正在使用?數(shù)據(jù)提供者?和?數(shù)據(jù)小部件?中之一，排序 可以為你自動處理。否則，你應(yīng)該創(chuàng)建一個 yii\data\Sort 實例，配置好后 將其應(yīng)用到查詢中。也可以傳遞給視圖，可以在視圖中通過某些屬性創(chuàng)建鏈接來排序。

如下是一個典型的使用范例，

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。 我們通過排序信息來查詢以便于查詢結(jié)果通過 Sort 對象 排序后更加準確有序。在視圖中，我們通過相應(yīng)的屬性 展示了鏈接到頁的兩個超鏈接和數(shù)據(jù)排序。

yii\data\Sort 類將獲得自動傳遞的請求參數(shù) 并相應(yīng)地調(diào)整排序選項。 你可以通過配置 yii\data\Sort::$params 屬性來調(diào)整參數(shù)。