You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
58 lines
2.9 KiB
58 lines
2.9 KiB
10 years ago
|
Сортировка
|
||
|
=======
|
||
|
|
||
|
Иногда выводимые данные требуется отсортировать в соответствии с одним или несколькими атрибутами.
|
||
|
Если вы используете [источник данных](output-data-providers.md) с одним из [виджетов данных](output-data-widgets.md),
|
||
|
сортировка будет применена автоматически. В противном случае вам должны создать экземпляр [[yii\data\Sort]],
|
||
|
настроить его и применить к запросу. Он также может быть передан в представление, где будет использован
|
||
|
для создания ссылок на сортировку по определенным атрибутам.
|
||
|
|
||
|
Ниже приведен типичный пример использование сортировки,
|
||
|
|
||
|
```php
|
||
|
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,
|
||
|
]);
|
||
|
}
|
||
|
```
|
||
|
|
||
|
В представлении:
|
||
|
|
||
|
```php
|
||
|
// Отображение ссылок на различные действия сортировок
|
||
|
echo $sort->link('name') . ' | ' . $sort->link('age');
|
||
|
|
||
|
foreach ($models as $model) {
|
||
|
// здесь отображаем модель $model
|
||
|
}
|
||
|
```
|
||
|
|
||
|
В примере выше, мы объявляем два атрибута, которые поддерживают сортировку: `name` and `age`.
|
||
|
Мы передаем информацию о сортировке в запрос статьи, поэтому результаты запроса будут отсортированы
|
||
|
согласно сортировке, установленной в объекте Sort. В представлении, мы отображаем две ссылки,
|
||
|
которые ведут на страницы с данными, отсортированными по соответствующим аттрибутам.
|
||
|
|
||
|
Класс [[yii\data\Sort|Sort]] будет автоматически принимать параметры, переданные с запросом
|
||
|
и в соответствии с ними настраивать параметры сортировки. Вы можете регулировать список принимаемых
|
||
|
параметров через настройку свойства [[yii\data\Sort::$params|$params]].
|