output-sorting.md 2.94 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
Сортировка
=======

Иногда выводимые данные требуется отсортировать в соответствии с одним или несколькими атрибутами. 
Если вы используете [источник данных](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]].