Класс MultiCheckboxWidget

__construct()source public

__construct( Cake\View\StringTemplate $templates , Cake\View\Widget\LabelWidget $label )

Отображение виджета множественного выбора.

Этот класс использует следующие шаблоны:

• checkbox Отображает элементы управления флажком. Принимает переменные name, value и attrs.
• checkboxWrapper Отображает содержащий div/элемент для флажка и его метки. Принимает переменные input, и label.
• multicheckboxWrapper Отображает обертку вокруг сгруппированных элементов.
• multicheckboxTitle Отображает элемент заголовка для сгруппированных элементов.

Параметры

Cake\View\StringTemplate $templates

Список шаблонов.

Cake\View\Widget\LabelWidget $label

Экземпляр виджета метки.

_isDisabled()source protected

_isDisabled( string $key , array|boolean|null $disabled )

Вспомогательный метод для определения, какие опции отключены.

Параметры

строка $key

Ключ для проверки.

массив|логическое|null $disabled

Значения, которые нужно отключить.

Возвращает

boolean

_isSelected()source protected

_isSelected( string $key , array|string|null $selected )

Вспомогательный метод для определения, какие опции выбраны.

Параметры

строка $key

Ключ для проверки.

массив|строка|null $selected

Выбранные значения.

Возвращает

boolean

_renderInput()source protected

_renderInput( array $checkbox , Cake\View\Form\ContextInterface $context )

Отображение одного флажка и обертки.

Параметры

массив $checkbox

Массив, содержащий пары ключ/значение опций флажка

Cake\View\Form\ContextInterface $context

Объект контекста.

Возвращает

строка

_renderInputs()source protected

_renderInputs( array $data , Cake\View\Form\ContextInterface $context )

Отображение полей флажков.

Параметры

массив $data

Массив данных, определяющий флажки.

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

Возвращает

массив
Массив отображённых элементов.

render()source public

render( array $data , Cake\View\Form\ContextInterface $context )

Отображение виджета множественного выбора.

Данные поддерживают следующие опции.

• name Атрибут имени элементов, которые нужно создать. [] будет добавлен к имени.
• options Массив опций для создания флажков.
• val Строка/целое число или массив значений, которые должны быть отмечены. Также может быть сложным набором опций.
• disabled Логическое значение или массив флажков, которые нужно отключить.
• escape Установите в false, чтобы отключить экранирование HTML.
• options Ассоциативный массив значение=>метки для генерации опций.
• idPrefix Префикс для генерируемых атрибутов ID.

Формат опций

Опция options может принимать различные форматы данных в зависимости от сложности генерируемого HTML.

Вы можете генерировать простые опции, используя базовый ассоциативный массив:

'options' => ['elk' => 'Elk', 'beaver' => 'Beaver']

Если вам нужно определить дополнительные атрибуты для элементов опции, вы можете использовать сложную форму опций:

'options' => [
  ['value' => 'elk', 'text' => 'Elk', 'data-foo' => 'bar'],
]

В этой форме обязательно должны быть определены ключи value и text. Если какой-либо из них не задан, опции не будут сгенерированы корректно.

Параметры

массив $data

Данные для генерации набора флажков.

Cake\View\Form\ContextInterface $context

Текущий контекст формы.

Возвращает

строка

Реализация

Cake\View\Widget\WidgetInterface::render()

secureFields()source public

secureFields( array $data )

Возвращает список полей, которые необходимо защитить для этого виджета. Поля имеют вид Model[field][suffix]

Параметры

массив $data

Данные для отображения.

Возвращает

массив
Массив полей для защиты.

Реализация

Cake\View\Widget\WidgetInterface::secureFields()

_clearIds()source protected

_clearIds( )

Очистить сохранённые суффиксы ID.

_domId()source protected

_domId( string $value )

Сгенерировать ID, подходящий для использования в атрибуте ID.

Параметры

строка $value

Значение для преобразования в ID.

Возвращает

строка
Сгенерированный id.

_id()source protected

_id( string $name , string $val )

Сгенерировать атрибут ID для элемента.

Обеспечивает, что идентификаторы для заданного набора полей уникальны.

Параметры

строка $name

Имя атрибута ID.

строка $val

Значение атрибута ID.

Возвращает

строка
Сгенерированный id.