Spec-Zone.ru › Yii 2.0

Класс 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 или null когда $afterItem не является замыканием

renderBeforeItem() защищённый метод (доступен с версии 2.0.11)

Вызывает замыкание $beforeItem, возвращает результат выполнения.

Если $beforeItem не является замыканием, null будет возвращено.

См. также $beforeItem.

защищённый строка|null renderBeforeItem ( $model, $key, $index )
$model mixed

Модель данных, подлежащая рендерингу

$key mixed

Значение ключа, связанное с моделью данных

$index целое число

Нулевой индекс модели данных в массиве моделей, возвращаемом $dataProvider.

return строка|null

Результат вызова $beforeItem или 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API