PropertyAccessDecorator
PropertyAccessDecorator
class PropertyAccessDecorator implements ChoiceListFactoryInterface
Adds property path support to a choice list factory.
Pass the decorated factory to the constructor:
php
$decorator = new PropertyAccessDecorator($factory);
You can now pass property paths for generating choice values, labels, view indices, HTML attributes and for determining the preferred choices and the choice groups:
php
// extract values from the $value property
$list = $createListFromChoices($objects, 'value');
Methods
__construct(ChoiceListFactoryInterface $decoratedFactory, PropertyAccessorInterface $propertyAccessor = null) Decorates the given factory. | ||
ChoiceListFactoryInterface | getDecoratedFactory() Returns the decorated factory. | |
ChoiceListInterface | createListFromChoices(array|Traversable $choices, null|callable $value = null) Creates a choice list for the given choices. | |
ChoiceListInterface | createListFromLoader(ChoiceLoaderInterface $loader, null|callable $value = null) Creates a choice list that is loaded with the given loader. | |
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) Creates a view for the given choice list. |
Details
__construct(ChoiceListFactoryInterface $decoratedFactory, PropertyAccessorInterface $propertyAccessor = null)
Decorates the given factory.
Parameters
ChoiceListFactoryInterface | $decoratedFactory | The decorated factory |
PropertyAccessorInterface | $propertyAccessor | The used property accessor |
ChoiceListFactoryInterface getDecoratedFactory()
Returns the decorated factory.
Return Value
ChoiceListFactoryInterface | The decorated factory |
ChoiceListInterface createListFromChoices(array|Traversable $choices, null|callable $value = null)
Creates a choice list for the given choices.
The choices should be passed in the values of the choices array.
Optionally, a callable can be passed for generating the choice values. The callable receives the choice as first and the array key as the second argument.
Parameters
array|Traversable | $choices | The choices |
null|callable | $value | The callable generating the choice values |
Return Value
ChoiceListInterface | The choice list |
ChoiceListInterface createListFromLoader(ChoiceLoaderInterface $loader, null|callable $value = null)
Creates a choice list that is loaded with the given loader.
Optionally, a callable can be passed for generating the choice values. The callable receives the choice as first and the array key as the second argument.
Parameters
ChoiceLoaderInterface | $loader | The choice loader |
null|callable | $value | The callable generating the choice values |
Return Value
ChoiceListInterface | The choice list |
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)
Creates a view for the given choice list.
Callables may be passed for all optional arguments. The callables receive the choice as first and the array key as the second argument.
- The callable for the label and the name should return the generated label/choice name.
- The callable for the preferred choices should return true or false, depending on whether the choice should be preferred or not.
- The callable for the grouping should return the group name or null if a choice should not be grouped.
- The callable for the attributes should return an array of HTML attributes that will be inserted in the tag of the choice.
If no callable is passed, the labels will be generated from the choice keys. The view indices will be generated using an incrementing integer by default.
The preferred choices can also be passed as array. Each choice that is contained in that array will be marked as preferred.
The attributes can be passed as multi-dimensional array. The keys should match the keys of the choices. The values should be arrays of HTML attributes that should be added to the respective choice.
Parameters
ChoiceListInterface | $list | The choice list |
null|array|callable | $preferredChoices | The preferred choices |
null|callable | $label | The callable generating the choice labels |
null|callable | $index | The callable generating the view indices |
null|callable | $groupBy | The callable generating the group names |
null|array|callable | $attr | The callable generating the HTML attributes |
Return Value
ChoiceListView | The choice list view |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.3/Symfony/Component/Form/ChoiceList/Factory/PropertyAccessDecorator.html