Класс yii\widgets\ListView
| Наследование | yii\widgets\ListView » yii\widgets\BaseListView » yii\base\Widget » yii\base\Component » yii\base\Object |
|---|---|
| Реализует | yii\base\Configurable, yii\base\ViewContextInterface |
| Доступно с версии | 2.0 |
| Исходный код | https://github.com/yiisoft/yii2/blob/master/framework/widgets/ListView.php |
Виджет ListView используется для отображения данных из поставщика данных. Каждая модель данных отображается с помощью указанного представления.
Для получения более подробной информации и инструкций по использованию ListView см. статью руководства по виджетам данных.
Публичные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $afterItem | Closure | Анонимная функция, вызываемая один раз ПОСЛЕ рендеринга каждой модели данных. | yii\widgets\ListView |
| $autoIdPrefix | строка | Префикс для автоматически сгенерированных идентификаторов виджета. | yii\base\Widget |
| $beforeItem | Closure | Анонимная функция, вызываемая один раз ПЕРЕД рендерингом каждой модели данных. | yii\widgets\ListView |
| $behaviors | yii\base\Behavior[] | Список присоединенных к этому компоненту поведений. | yii\base\Component |
| $counter | целое число | Счетчик, используемый для генерации $id для виджетов. | yii\base\Widget |
| $dataProvider | yii\data\DataProviderInterface | Поставщик данных для представления. | yii\widgets\BaseListView |
| $emptyText | строка|false | Контент HTML, отображаемый, когда $dataProvider не содержит данных. | yii\widgets\BaseListView |
| $emptyTextOptions | массив | Атрибуты HTML для emptyText представления списка. | yii\widgets\BaseListView |
| $id | строка | Идентификатор виджета. | yii\base\Widget |
| $itemOptions | массив|Closure | Атрибуты HTML для контейнера результата рендеринга каждой модели данных. | yii\widgets\ListView |
| $itemView | строка|вызываемый | Имя представления для рендеринга каждого элемента данных или обратный вызов (например, анонимная функция) для рендеринга каждого элемента данных. | yii\widgets\ListView |
| $layout | строка | Макет, определяющий, как разные части представления списка должны быть организованы. | yii\widgets\BaseListView |
| $options | массив | Атрибуты HTML для тега контейнера представления списка. | yii\widgets\ListView |
| $pager | массив | Конфигурация виджета пагинации. | yii\widgets\BaseListView |
| $separator | строка | Код HTML, который должен отображаться между любыми двумя последовательными элементами. | yii\widgets\ListView |
| $showOnEmpty | логический | Определяет, нужно ли показывать пустое представление списка, если $dataProvider возвращает данные. | yii\widgets\BaseListView |
| $sorter | массив | Конфигурация виджета сортировки. | yii\widgets\BaseListView |
| $stack | yii\base\Widget[] | Виджеты, которые в настоящее время отображаются (не завершены). | yii\base\Widget |
| $summary | строка | Контент HTML, отображаемый в качестве сводки представления списка. | yii\widgets\BaseListView |
| $summaryOptions | массив | Атрибуты HTML для сводки представления списка. | yii\widgets\BaseListView |
| $view | yii\web\View | Объект представления, который можно использовать для рендеринга представлений или файлов представлений. | yii\base\Widget |
| $viewParams | массив | Дополнительные параметры, которые нужно передать $itemView при его рендеринге. | yii\widgets\ListView |
| $viewPath | строка | Путь к представлению, который можно добавить в качестве префикса к имени относительного представления. | yii\base\ViewContextInterface |
Публичные методы
| Метод | Описание | Определено в |
|---|---|---|
| __call() | Вызывает метод, который не является методом класса. | yii\base\Object |
| __clone() | Этот метод вызывается после создания объекта путём клонирования существующего. | yii\base\Component |
| __construct() | Конструктор. | yii\base\Object |
| __get() | Возвращает значение свойства объекта. | yii\base\Object |
| __isset() | Проверяет, установлено ли свойство, т.е. определено и не равно null. | yii\base\Object |
| __set() | Устанавливает значение свойства объекта. | yii\base\Object |
| __unset() | Устанавливает свойство объекта в значение null. | yii\base\Object |
| afterRun() | Этот метод вызывается сразу после выполнения виджета. | yii\base\Widget |
| attachBehavior() | Присоединяет поведение к данному компоненту. | yii\base\Component |
| attachBehaviors() | Присоединяет список поведений к компоненту. | yii\base\Component |
| beforeRun() | Этот метод вызывается сразу перед выполнением виджета. | yii\base\Widget |
| begin() | Начинает работу виджета. | yii\base\Widget |
| behaviors() | Возвращает список поведений, которые должен иметь этот компонент. | yii\base\Component |
| canGetProperty() | Возвращает значение, указывающее, можно ли считать свойство. | yii\base\Object |
| canSetProperty() | Возвращает значение, указывающее, можно ли установить свойство. | yii\base\Object |
| className() | Возвращает полное квалифицированное имя этого класса. | yii\base\Object |
| detachBehavior() | Отсоединяет поведение от компонента. | yii\base\Component |
| detachBehaviors() | Отсоединяет все поведения от компонента. | yii\base\Component |
| end() | Завершает работу виджета. | yii\base\Widget |
| ensureBehaviors() | Убеждается, что поведения, объявленные в behaviors(), присоединены к этому компоненту. | yii\base\Component |
| getBehavior() | Возвращает объект поведения с заданным именем. | yii\base\Component |
| getBehaviors() | Возвращает все присоединённые к этому компоненту поведения. | yii\base\Component |
| getId() | Возвращает ID виджета. | yii\base\Widget |
| getView() | Возвращает объект представления, который можно использовать для рендеринга представлений или файлов представлений. | yii\base\Widget |
| getViewPath() | yii\base\ViewContextInterface | |
| hasEventHandlers() | Возвращает значение, указывающее, есть ли обработчик, присоединённый к событию с заданным именем. | yii\base\Component |
| hasMethod() | Возвращает значение, указывающее, определён ли метод. | yii\base\Object |
| hasProperty() | Возвращает значение, указывающее, определено ли свойство. | yii\base\Object |
| init() | Инициализирует представление. | yii\widgets\BaseListView |
| off() | Отсоединяет существующий обработчик событий от этого компонента. | yii\base\Component |
| on() | Присоединяет обработчик событий к событию. | yii\base\Component |
| render() | Рендерит представление. | yii\base\Widget |
| renderEmpty() | Рендерит HTML-контент, указывающий, что в списке нет данных. | yii\widgets\BaseListView |
| renderFile() | Рендерит файл представления. | yii\base\Widget |
| renderItem() | Рендерит отдельной модели данных. | yii\widgets\ListView |
| renderItems() | Рендерит всех моделей данных. | yii\widgets\ListView |
| renderPager() | Рендерит страницу. | yii\widgets\BaseListView |
| renderSection() | Рендерит секции с заданным именем. | yii\widgets\BaseListView |
| renderSorter() | Рендерит сортировщик. | yii\widgets\BaseListView |
| renderSummary() | Рендерит текст сводки. | yii\widgets\BaseListView |
| run() | Выполняет виджет. | yii\widgets\BaseListView |
| setId() | Устанавливает ID виджета. | yii\base\Widget |
| setView() | Устанавливает объект представления, который будет использоваться этим виджетом. | yii\base\Widget |
| trigger() | Вызывает событие. | yii\base\Component |
| widget() | Создаёт экземпляр виджета и выполняет его. | yii\base\Widget |
Защищённые методы
| Метод | Описание | Определено в |
|---|---|---|
| renderAfterItem() | Вызывает замыкание $afterItem, возвращает результат выполнения. | yii\widgets\ListView |
| renderBeforeItem() | Вызывает замыкание $beforeItem, возвращает результат выполнения. | yii\widgets\ListView |
События
| Событие | Тип | Описание | Определено в |
|---|---|---|---|
| EVENT_AFTER_RUN | yii\base\WidgetEvent | Событие, генерируемое сразу после выполнения виджета. (доступно начиная с версии 2.0.11) | yii\base\Widget |
| EVENT_BEFORE_RUN | yii\base\WidgetEvent | Событие, генерируемое сразу перед выполнением виджета. (доступно начиная с версии 2.0.11) | yii\base\Widget |
| EVENT_INIT | yii\base\Event | Событие, которое срабатывает при инициализации виджета через init(). (доступно начиная с версии 2.0.11) | yii\base\Widget |
Подробное описание свойств
$afterItem общественное свойство (доступно с версии 2.0.11)
Анонимная функция, вызываемая один раз ПОСЛЕ рендеринга каждой модели данных.
Она должна иметь ту же сигнатуру, что и $beforeItem.
Результат работы функции будет рендериться непосредственно. Примечание: если функция возвращает null, ничего не будет рендериться после элемента.
См. также renderAfterItem().
public Closure $afterItem = null
$beforeItem общественное свойство (доступно с версии 2.0.11)
Анонимная функция, вызываемая один раз ДО рендеринга каждой модели данных. Она должна иметь следующую сигнатуру:
function ($model, $key, $index, $widget)
-
$model: текущая модель данных, подлежащая рендерингу -
$key: значение ключа, связанного с текущей моделью данных -
$index: нулевой индекс модели данных в массиве моделей, возвращаемом $dataProvider -
$widget: объект ListView
Результат работы функции будет рендериться непосредственно. Примечание: если функция возвращает null, ничего не будет рендериться перед элементом.
См. также renderBeforeItem().
public Closure $beforeItem = null
$itemOptions общественное свойство
Атрибуты HTML для контейнера результата рендеринга каждой модели данных. Это может быть либо массив, определяющий общие атрибуты HTML для рендеринга каждого элемента, либо анонимная функция, возвращающая массив атрибутов HTML. Анонимная функция будет вызываться один раз для каждой модели данных, возвращаемой $dataProvider. Элемент "tag" определяет имя тега контейнерного элемента и по умолчанию равен "div". Если "tag" равен false, контейнерный элемент не будет рендериться.
Если это свойство задано как анонимная функция, она должна иметь следующую сигнатуру:
function ($model, $key, $index, $widget)
См. также yii\helpers\Html::renderTagAttributes() для получения подробной информации о том, как рендерятся атрибуты.
public array|Closure $itemOptions = []
$itemView общественное свойство
Имя представления для рендеринга каждого элемента данных или обратный вызов (например, анонимная функция) для рендеринга каждого элемента данных. Если указано имя представления, в представлении будут доступны следующие переменные:
-
$model: mixed, модель данных -
$key: mixed, значение ключа, связанное с элементом данных -
$index: integer, нулевой индекс элемента данных в массиве элементов, возвращаемом $dataProvider. -
$widget: ListView, экземпляр этого виджета
Обратите внимание, что имя представления преобразуется в файл представления текущим контекстом объекта $view.
Если это свойство задано как обратный вызов, оно должно иметь следующую сигнатуру:
function ($model, $key, $index, $widget)
public string|callable $itemView = null
$options общественное свойство
Атрибуты HTML для тега контейнера списка представлений. Элемент "tag" определяет имя тега контейнерного элемента и по умолчанию равен "div".
См. также yii\helpers\Html::renderTagAttributes() для получения подробной информации о том, как рендерятся атрибуты.
public array $options = ['class' => 'list-view']
$separator общественное свойство
Код HTML, отображаемый между любыми двумя последовательными элементами.
public string $separator = "\n"
$viewParams общественное свойство
Дополнительные параметры, которые будут переданы в $itemView при его рендеринге. Это свойство используется только тогда, когда $itemView является строкой, представляющей имя представления.
public array $viewParams = []
Подробное описание методов
renderAfterItem() защищённый метод (доступен с версии 2.0.11)
Вызывает замыкание $afterItem, возвращает результат выполнения.
Если $afterItem не является замыканием, null будет возвращено.
См. также $afterItem.
| защищённый строка|null renderAfterItem ( $model, $key, $index ) | ||
|---|---|---|
| $model | mixed |
Модель данных, подлежащая рендерингу |
| $key | mixed |
Значение ключа, связанное с моделью данных |
| $index | целое число |
Нулевой индекс модели данных в массиве моделей, возвращаемом $dataProvider. |
| return | строка|null |
Результат вызова $afterItem или |
renderBeforeItem() защищённый метод (доступен с версии 2.0.11)
Вызывает замыкание $beforeItem, возвращает результат выполнения.
Если $beforeItem не является замыканием, null будет возвращено.
См. также $beforeItem.
| защищённый строка|null renderBeforeItem ( $model, $key, $index ) | ||
|---|---|---|
| $model | mixed |
Модель данных, подлежащая рендерингу |
| $key | mixed |
Значение ключа, связанное с моделью данных |
| $index | целое число |
Нулевой индекс модели данных в массиве моделей, возвращаемом $dataProvider. |
| return | строка|null |
Результат вызова $beforeItem или |
renderItem() публичный метод
Рендерит отдельную модель данных.
| публичный строка renderItem ( $model, $key, $index ) | ||
|---|---|---|
| $model | mixed |
Модель данных, подлежащая рендерингу |
| $key | mixed |
Значение ключа, связанное с моделью данных |
| $index | целое число |
Нулевой индекс модели данных в массиве моделей, возвращаемом $dataProvider. |
| return | строка |
Результат рендеринга |
renderItems() публичный метод
Рендерит всех моделей данных.
| публичный строка renderItems ( ) | ||
|---|---|---|
| return | строка |
Результат рендеринга |
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-widgets-listview.html