排序（Sorting）

排序

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

如下是一個(gè)典型的使用范例，

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,
    ]);
}

在視圖中：

// 顯示指向排序動(dòng)作的鏈接
echo $sort->link('name') . ' | ' . $sort->link('age');

foreach ($models as $model) {
    // 在這里顯示 $model
}

以上，我們聲明了支持了兩個(gè)屬性的排序：name?和?age。 我們通過(guò)排序信息來(lái)查詢(xún)以便于查詢(xún)結(jié)果通過(guò) Sort 對(duì)象 排序后更加準(zhǔn)確有序。在視圖中，我們通過(guò)相應(yīng)的屬性 展示了鏈接到頁(yè)的兩個(gè)超鏈接和數(shù)據(jù)排序。

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