DefaultChoiceListFactory
class DefaultChoiceListFactory implements ChoiceListFactoryInterface
Стандартная реализация {@link ChoiceListFactoryInterface}.
Методы
| ChoiceListInterface | createListFromChoices(array|Traversable $choices, null|callable $value = null) Создаёт список выбора для заданных вариантов. | |
| ChoiceListInterface | createListFromLoader(ChoiceLoaderInterface $loader, null|callable $value = null) Создаёт список выбора, загружаемый с помощью заданного загрузчика. | |
| 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) Создаёт представление для данного списка выбора. |
Подробности
ChoiceListInterface createListFromChoices(array|Traversable $choices, null|callable $value = null)
Создаёт список выбора для заданных вариантов.
Варианты должны быть переданы в значения массива вариантов.
Можно дополнительно передать вызываемую функцию для генерации значений вариантов. Вызываемая функция получает выбор в качестве первого аргумента и ключ массива как второй.
Параметры
| array|Traversable | $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 | Представление списка выбора |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Form/ChoiceList/Factory/DefaultChoiceListFactory.html
