?
本文檔使用 PHP中文網(wǎng)手冊 發(fā)布
有時顯示數(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ù)排序。