ChoiceListFactoryInterface

ChoiceListInterface createListFromChoices(iterable $choices, callable|null $value = null)

Создаёт список выбора для заданных вариантов.

Варианты должны быть переданы в значения массива вариантов.

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

Параметры

iterable	$choices	Варианты
callable|null	$value	Лямбда-функция, генерирующая значения выбора

Возвращаемое значение

ChoiceListInterface

Список выбора

ChoiceListInterface createListFromLoader(ChoiceLoaderInterface $loader, callable|null $value = null)

Создаёт список выбора, который загружается с помощью заданного загрузчика.

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

Параметры

ChoiceLoaderInterface	$loader	Загрузчик выбора
callable|null	$value	Лямбда-функция, генерирующая значения выбора

Возвращаемое значение

ChoiceListInterface

Список выбора

ChoiceListView createView(ChoiceListInterface $list, array|callable|null $preferredChoices = null, callable|null $label = null, callable|null $index = null, callable|null $groupBy = null, array|callable|null $attr = null)

Создаёт представление для заданного списка выбора.

Для всех необязательных аргументов можно передать лямбда-функции. Лямбда-функции получают в качестве аргументов выбор и ключ массива.

• Лямбда-функция для метки и имени должна возвращать сгенерированное имя метки/выбора.
• Лямбда-функция для предпочтительных вариантов должна возвращать true или false, в зависимости от того, должен ли выбор быть предпочтительным.
• Лямбда-функция для группировки должна возвращать имя группы или null, если выбор не должен быть сгруппирован.
• Лямбда-функция для атрибутов должна возвращать массив HTML-атрибутов, которые будут вставлены в тег выбора.

Если лямбда-функция не передана, метки будут сгенерированы из ключей выбора. Индексы представлений будут генерироваться по умолчанию с использованием инкрементирующего целого числа.

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

Атрибуты могут быть переданы как многомерный массив. Ключи должны соответствовать ключам выборов. Значения должны быть массивами HTML-атрибутов, которые должны быть добавлены к соответствующему выбору.

Параметры

ChoiceListInterface	$list	Список выбора
array|callable|null	$preferredChoices	Предпочтительные варианты
callable|null	$label	Лямбда-функция, генерирующая метки выбора
callable|null	$index	Лямбда-функция, генерирующая индексы представления
callable|null	$groupBy	Лямбда-функция, генерирующая имена групп
array|callable|null	$attr	Лямбда-функция, генерирующая HTML-атрибуты

Возвращаемое значение

ChoiceListView

Представление списка выбора