minor #17469 [Form] Add a placeholder_attr option to ChoiceType (…

…elementaire)

This PR was merged into the 6.3 branch.

Discussion
----------

[Form] Add a `placeholder_attr` option to `ChoiceType`

PR symfony/symfony#48343

Commits
-------

8fcd394 Add a placeholder_attr option to ChoiceType

reference/forms/types/choice.rst

@@ -196,6 +196,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 Overridden Options
@@ -295,6 +297,8 @@ Field Variables
 | placeholder                | ``mixed``    | The empty value if not already in the list, otherwise             |
 |                            |              | ``null``.                                                         |
 +----------------------------+--------------+-------------------------------------------------------------------+
+| placeholder_attr           | ``array``    | The value of the `placeholder_attr`_ option.                      |
++----------------------------+--------------+-------------------------------------------------------------------+
 | choice_translation_domain  | ``mixed``    | ``boolean``, ``null`` or ``string`` to determine if the value     |
 |                            |              | should be translated.                                             |
 +----------------------------+--------------+-------------------------------------------------------------------+

reference/forms/types/country.rst

@@ -78,6 +78,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc

reference/forms/types/currency.rst

@@ -59,6 +59,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc

reference/forms/types/entity.rst

@@ -253,6 +253,8 @@ Doctrine's Array Collection.
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 ``preferred_choices``
 ~~~~~~~~~~~~~~~~~~~~~
 

reference/forms/types/enum.rst

@@ -142,6 +142,8 @@ If you return ``null``, the option won't be grouped.
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc

reference/forms/types/language.rst

@@ -95,6 +95,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc

reference/forms/types/locale.rst

@@ -72,6 +72,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc

reference/forms/types/options/placeholder_attr.rst.inc

@@ -0,0 +1,21 @@
+``placeholder_attr``
+~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+Use this to add additional HTML attributes to the placeholder choice::
+
+    use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
+    // ...
+
+    $builder->add('fruits', ChoiceType::class, [
+        // ...
+        'placeholder' => '...',
+        'placeholder_attr' => [
+            ['title' => 'Choose an option'],
+        ],
+    ]);
+
+.. versionadded:: 6.3
+
+    The ``placeholder_attr`` option was introduced in Symfony 6.3.

reference/forms/types/timezone.rst

@@ -89,6 +89,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc