diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst index de5654c2504..193c5fd63ec 100644 --- a/reference/forms/types/country.rst +++ b/reference/forms/types/country.rst @@ -63,7 +63,21 @@ the option manually, but then you should just use the ``ChoiceType`` directly. Field Options ------------- -.. include:: /reference/forms/types/options/alpha3.rst.inc +alpha3 +~~~~~~ + +**type**: ``boolean`` **default**: ``false`` + +.. versionadded:: 4.4 + + The ``alpha3`` option was introduced in Symfony 4.4. + +If this option is ``true``, the choice values use the `ISO 3166-1 alpha-3`_ +three-letter codes (e.g. New Zealand = ``NZL``) instead of the default +`ISO 3166-1 alpha-2`_ two-letter codes (e.g. New Zealand = ``NZ``). + +.. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 +.. _`ISO 3166-1 alpha-3`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3 .. include:: /reference/forms/types/options/choice_translation_locale.rst.inc diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst index f9a60498089..ba1fc429998 100644 --- a/reference/forms/types/language.rst +++ b/reference/forms/types/language.rst @@ -65,7 +65,21 @@ manually, but then you should just use the ``ChoiceType`` directly. Field Options ------------- -.. include:: /reference/forms/types/options/alpha3.rst.inc +alpha3 +~~~~~~ + +**type**: ``boolean`` **default**: ``false`` + +.. versionadded:: 4.4 + + The ``alpha3`` option was introduced in Symfony 4.4. + +If this option is ``true``, the choice values use the `ISO 639-2 alpha-3`_ +three-letter codes (e.g. French = ``fra``) instead of the default +`ISO 639-1 alpha-2`_ two-letter codes (e.g. French = ``fr``). + +.. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1 +.. _`ISO 639-2 alpha-3`: https://en.wikipedia.org/wiki/ISO_639-2 .. include:: /reference/forms/types/options/choice_translation_locale.rst.inc diff --git a/reference/forms/types/options/alpha3.rst.inc b/reference/forms/types/options/alpha3.rst.inc deleted file mode 100644 index 04984216b24..00000000000 --- a/reference/forms/types/options/alpha3.rst.inc +++ /dev/null @@ -1,15 +0,0 @@ -alpha3 -~~~~~~ - -**type**: ``boolean`` **default**: ``false`` - -.. versionadded:: 4.4 - - The ``alpha3`` option was introduced in Symfony 4.4. - -If this option is ``true``, the choice values use the `ISO 3166-1 alpha-3`_ -three-letter codes (e.g. New Zealand = ``NZL``) instead of the default -`ISO 3166-1 alpha-2`_ two-letter codes (e.g. New Zealand = ``NZ``). - -.. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 -.. _`ISO 3166-1 alpha-3`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3