DefaultChoiceListFactory
class DefaultChoiceListFactory implements ChoiceListFactoryInterface
Стандартная реализация {@link ChoiceListFactoryInterface}.
Методы
| ChoiceListInterface | createListFromChoices(array|Traversable $choices, null|callable $value = null) Создаёт список выборов для заданных выборов. | |
| ChoiceListInterface | createListFromFlippedChoices(array|Traversable $choices, null|callable $value = null, $triggerDeprecationNotice = true) deprecated Создаёт список выборов для заданных выборов. | |
| 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 createListFromFlippedChoices(array|Traversable $choices, null|callable $value = null, $triggerDeprecationNotice = true) deprecated
deprecated
Создаёт список выборов для заданных выборов.
Выборы должны быть переданы в ключах массива выборов. Поскольку массив выборов будет перевернут, элементы массива должны быть строками или целыми числами.
По желанию, можно передать вызываемый объект для генерации значений выборов. Вызываемый объект получает выбор в качестве первого и ключ массива как второй аргумент.
Параметры
| array|Traversable | $choices | Выборы |
| null|callable | $value | Вызываемый объект, генерирующий значения выборов |
| $triggerDeprecationNotice |
Возвращаемое значение
| 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/2.8/Symfony/Component/Form/ChoiceList/Factory/DefaultChoiceListFactory.html
