Виджеты данных

Виджеты данных выводят записи из базы без ручной вёрстки таблиц. GridView рисует таблицу с сортировкой и страницами, ListView — список в вашей разметке, DetailView — поля одной записи. Первые два получают данные от поставщика ActiveDataProvider из урока о постраничном выводе.

GridView

Действие передаёт в шаблон поставщик данных:

// controllers/PostController.php
public function actionIndex(): string
{
    $dataProvider = new ActiveDataProvider([
        'query' => Post::find(),
        'pagination' => ['pageSize' => 20],
    ]);
 
    return $this->render('index', ['dataProvider' => $dataProvider]);
}

В шаблоне views/post/index.php вызывают виджет:

<?php
// views/post/index.php
 
use yii\grid\GridView;
?>
 
<?= GridView::widget([
    'dataProvider' => $dataProvider,
    'columns' => ['id', 'title', 'status'],
]) ?>

На странице /posts появится таблица из трёх столбцов. Заголовки взяты из attributeLabels(), щелчок по ним сортирует строки, под таблицей — ссылки на страницы.

Настройка столбцов

<?= GridView::widget([
    'dataProvider' => $dataProvider,
    'columns' => [
        ['class' => 'yii\grid\SerialColumn'],
        'title',
        'created_at:datetime',
        [
            'attribute' => 'status',
            'value' => fn ($post) => $post->status ? 'Опубликована' : 'Черновик',
        ],
        ['class' => 'yii\grid\ActionColumn'],
    ],
]) ?>

Кнопки ActionColumn ведут на действия view, update и delete того же контроллера.

ListView

ListView выводит каждую запись через отдельный шаблон — так делают ленту статей:

<?php
// views/post/index.php
 
use yii\widgets\ListView;
?>
 
<?= ListView::widget([
    'dataProvider' => $dataProvider,
    'itemView' => '_card',
]) ?>

Файл views/post/_card.php получает запись в переменной $model. Замените в нём $post['title'] на $model->title — и на странице появятся карточки статей со ссылками на страницы под ними.

DetailView

DetailView показывает одну запись таблицей «название — значение». В views/post/view.php:

<?php
// views/post/view.php
 
use yii\widgets\DetailView;
?>
 
<?= DetailView::widget([
    'model' => $post,
    'attributes' => ['id', 'title', 'body:ntext', 'created_at:datetime'],
]) ?>

Страница /posts/1 покажет четыре строки с полями статьи. Формат ntext сохраняет переносы строк в тексте.

Частая ошибка

Ячейки и поля по умолчанию экранируются — разметка HTML выводится как текст. Формат raw или html отключает это: 'body:raw'. Не применяйте его к данным от посетителей — вместе с разметкой на страницу попадут и чужие скрипты.