ChoiceListFactoryInterface

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

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

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

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

Параметры

iterable	$choices	Варианты
null|callable	$value	Вызов, генерирующий значения выбора

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

ChoiceListInterface

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

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

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

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

Параметры

ChoiceLoaderInterface	$loader	Загрузчик выбора
null|callable	$value	Вызов, генерирующий значения выбора

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

ChoiceListInterface

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

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

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

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

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

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

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

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

Параметры

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

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

ChoiceListView

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