@@ -12,26 +12,26 @@ objects from the database.
1212+-------------+------------------------------------------------------------------+
1313| Rendered as | can be various tags (see :ref: `forms-reference-choice-tags `) |
1414+-------------+------------------------------------------------------------------+
15- | Options | - `class `_ |
16- | | - `choice_label `_ |
17- | | - `query_builder `_ |
15+ | Options | - `choice_label `_ |
16+ | | - `class `_ |
1817| | - `em `_ |
18+ | | - `query_builder `_ |
1919+-------------+------------------------------------------------------------------+
2020| Overridden | - `choices `_ |
2121| options | - `data_class `_ |
2222+-------------+------------------------------------------------------------------+
2323| Inherited | from the :doc: `ChoiceType </reference/forms/types/choice >`: |
2424| options | |
25- | | - `choice_value `_ |
26- | | - `choice_name `_ |
2725| | - `choice_attr `_ |
28- | | - `placeholder `_ |
26+ | | - `choice_name `_ |
2927| | - `choice_translation_domain `_ |
30- | | - `translation_domain `_ |
28+ | | - `choice_value `_ |
3129| | - `expanded `_ |
30+ | | - `group_by `_ |
3231| | - `multiple `_ |
32+ | | - `placeholder `_ |
3333| | - `preferred_choices `_ |
34- | | - `group_by `_ |
34+ | | - `translation_domain `_ |
3535| | |
3636| | from the :doc: `FormType </reference/forms/types/form >`: |
3737| | |
@@ -118,15 +118,6 @@ then you can supply the ``choices`` option directly::
118118Field Options
119119-------------
120120
121- class
122- ~~~~~
123-
124- **type **: ``string `` **required **
125-
126- The class of your entity (e.g. ``AppBundle:Category ``). This can be
127- a fully-qualified class name (e.g. ``AppBundle\Entity\Category ``)
128- or the short alias name (as shown prior).
129-
130121choice_label
131122~~~~~~~~~~~~
132123
@@ -180,16 +171,14 @@ more detais, see the main :ref:`choice_label <reference-form-choice-label>` docu
180171 'choice_label' => 'translations[en].name',
181172 ));
182173
183- query_builder
184- ~~~~~~~~~~~~~
174+ class
175+ ~~~~~
185176
186- **type **: ``Doctrine\ORM\QueryBuilder `` or a Closure
177+ **type **: ``string `` ** required **
187178
188- If specified, this is used to query the subset of options (and their
189- order) that should be used for the field. The value of this option can
190- either be a ``QueryBuilder `` object or a Closure. If using a Closure,
191- it should take a single argument, which is the ``EntityRepository `` of
192- the entity and return an instance of ``QueryBuilder ``.
179+ The class of your entity (e.g. ``AppBundle:Category ``). This can be
180+ a fully-qualified class name (e.g. ``AppBundle\Entity\Category ``)
181+ or the short alias name (as shown prior).
193182
194183em
195184~~
199188If specified, this entity manager will be used to load the choices
200189instead of the ``default `` entity manager.
201190
191+ query_builder
192+ ~~~~~~~~~~~~~
193+
194+ **type **: ``Doctrine\ORM\QueryBuilder `` or a Closure
195+
196+ If specified, this is used to query the subset of options (and their
197+ order) that should be used for the field. The value of this option can
198+ either be a ``QueryBuilder `` object or a Closure. If using a Closure,
199+ it should take a single argument, which is the ``EntityRepository `` of
200+ the entity and return an instance of ``QueryBuilder ``.
201+
202202Overridden Options
203203------------------
204204
@@ -224,20 +224,18 @@ Inherited Options
224224
225225These options inherit from the :doc: `ChoiceType </reference/forms/types/choice >`:
226226
227- .. include :: /reference/forms/types/options/choice_value.rst.inc
228-
229- .. include :: /reference/forms/types/options/choice_name.rst.inc
230-
231227.. include :: /reference/forms/types/options/choice_attr.rst.inc
232228
233- .. include :: /reference/forms/types/options/placeholder .rst.inc
229+ .. include :: /reference/forms/types/options/choice_name .rst.inc
234230
235231.. include :: /reference/forms/types/options/choice_translation_domain.rst.inc
236232
237- .. include :: /reference/forms/types/options/choice_type_translation_domain .rst.inc
233+ .. include :: /reference/forms/types/options/choice_value .rst.inc
238234
239235.. include :: /reference/forms/types/options/expanded.rst.inc
240236
237+ .. include :: /reference/forms/types/options/group_by.rst.inc
238+
241239.. include :: /reference/forms/types/options/multiple.rst.inc
242240
243241.. note ::
@@ -248,7 +246,7 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
248246 is a complete example in the cookbook article
249247 :doc: `/cookbook/form/form_collections `.
250248
251- .. include :: /reference/forms/types/options/group_by .rst.inc
249+ .. include :: /reference/forms/types/options/placeholder .rst.inc
252250
253251.. include :: /reference/forms/types/options/preferred_choices.rst.inc
254252
@@ -257,7 +255,10 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
257255 This option expects an array of entity objects (that's actually the same as with
258256 the ``ChoiceType `` field, whichs requires an array of the preferred "values").
259257
260- These options inherit from the :doc: `FormType </reference/forms/types/form >`:
258+ .. include :: /reference/forms/types/options/choice_type_translation_domain.rst.inc
259+
260+ These options inherit from the :doc: `form </reference/forms/types/form >`
261+ type:
261262
262263.. include :: /reference/forms/types/options/data.rst.inc
263264
0 commit comments