Spec-Zone.ru › CakePHP 4.2

Класс RadioWidget

Класс виджета ввода для генерации набора радиокнопок.

Этот класс обычно используется внутри Cake\View\Helper\FormHelper, но может использоваться для генерации независимых радиокнопок.

Пространство имен: Cake\View\Widget

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

  • $_idPrefix protected
    string|null

    Префикс для атрибута id.

  • $_idSuffixes protected
    string[]

    Список суффиксов id, используемых в текущем рендеринге.

  • $_label protected
    Cake\View\Widget\LabelWidget

    Экземпляр Label.

  • $_templates protected
    Cake\View\StringTemplate

    Экземпляр StringTemplate.

  • $defaults protected
    array

    Значения по умолчанию.

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

  • __construct() public

    Конструктор

  • _clearIds() protected

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

  • _domId() protected

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

  • _id() protected

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

  • _idSuffix() protected

    Сгенерировать суффикс ID.

  • _isDisabled() protected

    Определение атрибута disabled.

  • _renderInput() protected

    Отображает один элемент ввода радиокнопки и метку.

  • _renderLabel() protected

    Отображает элемент метки для данной радиокнопки.

  • mergeDefaults() protected

    Объединить значения по умолчанию с предоставленными данными.

  • render() public

    Отобразить набор радиокнопок.

  • secureFields() public

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

  • setMaxLength() protected

    Установить значение для атрибута "maxlength", если применимо.

  • setRequired() protected

    Установить значение для атрибута "required", если применимо.

  • setStep() protected

    Установить значение для атрибута "step", если применимо.

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

__construct() public 

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

Конструктор

Этот класс использует несколько шаблонов:

  • radio Используется для генерации входных данных для радиокнопки. Можно использовать следующие переменные name, value, attrs.
  • radioWrapper Используется для генерации контейнера для радиокнопки + элемента ввода. Можно использовать переменные input и label.

Параметры

Cake\View\StringTemplate $templates

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

Cake\View\Widget\LabelWidget $label

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

_clearIds() protected 

_clearIds(): void

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

Возвращает

void

_domId() protected 

_domId(string $value): string

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

Параметры

string $value

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

Возвращает

string

_id() protected 

_id(string $name, string $val): string

Генерирует атрибут ID для элемента.

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

Параметры

string $name

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

string $val

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

Возвращает

string

_idSuffix() protected 

_idSuffix(string $val): string

Генерирует суффикс ID.

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

Параметры

string $val

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

Возвращает

string

_isDisabled() protected 

_isDisabled(array $radio, array|true|null $disabled): bool

Обнаружение атрибута disabled.

Параметры

array $radio

Информация о радиокнопке.

array|true|null $disabled

Значения disabled.

Возвращает

bool

_renderInput() protected 

_renderInput(string|int $val, string|array $text, array $data, Cake\View\Form\ContextInterface $context): string

Отображает одну радиокнопку и метку.

Параметры

string|int $val

Значение радиокнопки.

string|array $text

Текст метки или тип радиокнопки.

array $data

Дополнительные параметры для генерации ввода.

Cake\View\Form\ContextInterface $context

Контекст формы

Возвращает

string

_renderLabel() protected 

_renderLabel(array $radio, array|string|false $label, string $input, Cake\View\Form\ContextInterface $context, bool $escape): string|false

Отображает элемент метки для данной радиокнопки.

В будущем это может быть переработано в отдельный виджет, так как другим типам ввода (множественным чекбоксам) также понадобятся сгенерированные метки.

Параметры

array $radio

Свойства ввода.

array|string|false $label

Свойства метки.

string $input

Виджет ввода.

Cake\View\Form\ContextInterface $context

Контекст формы.

bool $escape

Необходимо ли экранировать метку HTML.

Возвращает

string|false

mergeDefaults() protected 

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

Объединяет значения по умолчанию с предоставленными данными.

Параметры

array $data

Массив данных

Cake\View\Form\ContextInterface $context

Экземпляр контекста.

Возвращает

array

render() public 

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

Отображение набора радиокнопок.

Данные поддерживают следующие ключи:

  • name - Установка имени ввода.
  • options - Массив вариантов. Подробнее см. ниже.
  • disabled - Либо true, либо массив входов для отключения. Когда true, элемент выбора будет отключен.
  • val - Строка варианта, который нужно отметить как выбранный.
  • label - Либо false для отключения генерации метки, либо массив атрибутов для всех меток.
  • required - Установить в true, чтобы добавить атрибут required ко всем сгенерированным радиокнопкам.
  • idPrefix Префикс для сгенерированных атрибутов ID.

Параметры

array $data

Данные для создания радиокнопок.

Cake\View\Form\ContextInterface $context

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

Возвращает

string

secureFields() public 

secureFields(array $data): string[]

Возвращает список полей, которые нужно защитить для этого виджета.

Параметры

array $data

Возвращает

string[]

setMaxLength() protected 

setMaxLength(array $data, Cake\View\Form\ContextInterface $context, string $fieldName): array

Устанавливает значение атрибута "maxlength", если применимо.

Параметры

array $data

Массив данных

Cake\View\Form\ContextInterface $context

Экземпляр контекста.

string $fieldName

Имя поля.

Возвращает

array

setRequired() protected 

setRequired(array $data, Cake\View\Form\ContextInterface $context, string $fieldName): array

Устанавливает значение атрибута "required", если применимо.

Параметры

array $data

Массив данных

Cake\View\Form\ContextInterface $context

Экземпляр контекста.

string $fieldName

Имя поля.

Возвращает

array

setStep() protected 

setStep(array $data, Cake\View\Form\ContextInterface $context, string $fieldName): array

Устанавливает значение атрибута "step", если применимо.

Параметры

array $data

Массив данных

Cake\View\Form\ContextInterface $context

Экземпляр контекста.

string $fieldName

Имя поля.

Возвращает

array

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

$_idPrefix protected

Префикс для атрибута id.

Тип

string|null

$_idSuffixes protected

Список суффиксов id, используемых в текущем отображении.

Тип

string[]

$_label protected

Экземпляр метки.

Тип

Cake\View\Widget\LabelWidget

$_templates protected

Экземпляр StringTemplate.

Тип

Cake\View\StringTemplate

$defaults protected

Значения по умолчанию.

Тип

array

© 2005–present 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.
https://api.cakephp.org/4.2/class-Cake.View.Widget.RadioWidget.html

Spec-Zone.ru

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