Skip to content

Commit

Permalink
feature #6282 [Form] fix choice_label values (HeahDude)
Browse files Browse the repository at this point in the history
This PR was merged into the 2.7 branch.

Discussion
----------

[Form] fix `choice_label` values

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | kind of
| Applies to    | 2.7+
| Fixed tickets | n/a

This PR is a complement of symfony/symfony#17798, which allows handling `false` as `choice_label` value in `ChoiceType` and its inheritance.

Not sure about the phrasing but this is the idea, suggestions are welcome !

Commits
-------

73f1935 [Form] fix `choice_label` values
  • Loading branch information
weaverryan committed Mar 6, 2016
2 parents 0e56ff9 + 73f1935 commit 9d00f0b
Showing 1 changed file with 5 additions and 1 deletion.
6 changes: 5 additions & 1 deletion reference/forms/types/options/choice_label.rst.inc
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ choice_label
.. versionadded:: 2.7
The ``choice_label`` option was introduced in Symfony 2.7.

**type**: ``callable`` or ``string`` **default**: ``null``
**type**: ``string``, ``bool``, ``callable`` or ``PropertyPath`` **default**: ``null``

Normally, the array key of each item in the ``choices`` option is used as the
text that's shown to the user. The ``choice_label`` option allows you to take
Expand Down Expand Up @@ -48,3 +48,7 @@ If your choice values are objects, then ``choice_label`` can also be a
'choices_as_values' => true,
'choice_label' => 'displayName',
));

If set to ``false``, all the tag labels will be discarded for radio or checkbox
inputs. You can also return ``false`` from the callable to discard only the label
of the processed tag.

0 comments on commit 9d00f0b

Please sign in to comment.