Add choice_translation_parameters option

VincentLanglet · VincentLanglet · commit b1fd71a1b2c7 · 2020-05-18T11:54:13.000+02:00
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
@@ -18,6 +18,7 @@ To use this field, you must specify *either* ``choices`` or ``choice_loader`` op
 |             | - `choice_label`_                                                            |
 |             | - `choice_loader`_                                                           |
 |             | - `choice_name`_                                                             |
+|             | - `choice_translation_parameters`_                                           |
 |             | - `choice_translation_domain`_                                               |
 |             | - `choice_value`_                                                            |
 |             | - `expanded`_                                                                |
@@ -225,6 +226,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_name.rst.inc
 
+.. include:: /reference/forms/types/options/choice_translation_parameters.rst.inc
+
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
 
 .. include:: /reference/forms/types/options/choice_value.rst.inc
diff --git a/reference/forms/types/options/choice_translation_parameters.rst.inc b/reference/forms/types/options/choice_translation_parameters.rst.inc
@@ -0,0 +1,32 @@
+choice_translation_parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+The choice values are translated before displaying it, so it can contain
+:ref:`translation placeholders <component-translation-placeholders>`.
+This option defines the values used to replace those placeholders.
+
+Given this translation message:
+
+.. code-block:: yaml
+
+    # translations/messages.en.yaml
+    form.order.yes: 'I confirm my order to the company %company%'
+    form.order.no: 'I cancel my order to the company %company%'
+
+You can specify the placeholder values as follows::
+
+    $builder->add('id', null, [
+        'choice' => [
+            'form.order.yes' => true,
+            'form.order.no' => false,
+        ],
+        'choice_translation_parameters' => [
+            '%company%' => 'ACME Inc.',
+        ],
+    ]);
+
+The ``choice_translation_parameters`` option of children fields is merged with
+the same option of their parents, so children can reuse and/or override any of
+the parent placeholders.
