Spec-Zone.ru › CakePHP 3.2

Класс MultiCheckboxWidget

Класс виджета для генерации нескольких флажков.

Cake\View\Widget\MultiCheckboxWidget реализует Cake\View\Widget\WidgetInterface использует Cake\View\Helper\IdGeneratorTrait
Пространство имён: Cake\View\Widget
Расположение: View/Widget/MultiCheckboxWidget.php

Краткое описание свойств

  • $_label protected
    Cake\View\Widget\LabelWidget
    Экземпляр виджета метки.
  • $_templates protected
    Cake\View\StringTemplate
    Экземпляр шаблона для использования.

Унаследованные свойства

  • _idPrefix, _idSuffixes

Краткое описание методов

  • __construct() public
    Отображение виджета множественных флажков.
  • _isDisabled() protected
    Вспомогательный метод для определения отключенных опций.
  • _isSelected() protected
    Вспомогательный метод для определения выбранных опций.
  • _renderInput() protected
    Отображение одного флажка и обертки.
  • _renderInputs() protected
    Отображение входов флажков.
  • render() public
    Отображение виджета множественных флажков.
  • secureFields() public

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

Подробное описание методов

__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|null $disabled )

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

Параметры

string $key
Ключ для проверки.
array|null $disabled
Значения, которые нужно отключить.

Возвращает

boolean

_isSelected()source protected

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

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

Параметры

string $key
Ключ для проверки.
array|string|null $selected
Выбранные значения.

Возвращает

boolean

_renderInput()source protected

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

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

Параметры

array $checkbox
Массив, содержащий пары ключ/значение опций флажка
Cake\View\Form\ContextInterface $context
Объект контекста.

Возвращает

string

_renderInputs()source protected

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

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

Параметры

array $data
Массив данных, определяющих флажки.
Cake\View\Form\ContextInterface $context
Текущий контекст формы.

Возвращает

array
Массив отображенных входов.

render()source public

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

Отображение виджета множественных флажков.

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

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

Формат опций

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

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

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

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

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

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

Параметры

array $data
Данные для генерации набора флажков.
Cake\View\Form\ContextInterface $context
Текущий контекст формы.

Возвращает

string

Реализация

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

secureFields()source public

secureFields( array $data )

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

Параметры

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

Возвращает

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

Реализация

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

Используемые методы из Cake\View\Helper\IdGeneratorTrait

_clearIds()source protected

_clearIds( )

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

_domId()source protected

_domId( string $value )

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

Параметры

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

Возвращает

string
Сгенерированный идентификатор.

_id()source protected

_id( string $name , string $val )

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

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

Параметры

string $name
Имя атрибута ID.
string $val
Значение атрибута ID.

Возвращает

string
Сгенерированный идентификатор.

Подробное описание свойств

$_labelsource

protected Cake\View\Widget\LabelWidget

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

$_templatessource

protected Cake\View\StringTemplate

Экземпляр шаблона для использования.

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.2/class-Cake.View.Widget.MultiCheckboxWidget.html

Spec-Zone.ru

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