diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst index edeb9225e24..49d9d121f01 100644 --- a/reference/forms/types/country.rst +++ b/reference/forms/types/country.rst @@ -60,6 +60,12 @@ choices The country type defaults the ``choices`` option to the whole list of countries. The locale is used to translate the countries names. +.. caution:: + + If you want to override the built-in choices of the country type, you + will also have to set the ``choice_loader`` option to ``null``. Not doing + so is deprecated since Symfony 3.3. + Inherited Options ----------------- diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst index 6bdedd99d1c..2dc15904105 100644 --- a/reference/forms/types/currency.rst +++ b/reference/forms/types/currency.rst @@ -51,6 +51,12 @@ choices The choices option defaults to all currencies. +.. caution:: + + If you want to override the built-in choices of the currency type, you + will also have to set the ``choice_loader`` option to ``null``. Not doing + so is deprecated since Symfony 3.3. + Inherited Options ----------------- diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst index cdd5e461ed4..b5482d9cdeb 100644 --- a/reference/forms/types/language.rst +++ b/reference/forms/types/language.rst @@ -61,6 +61,12 @@ choices The choices option defaults to all languages. The default locale is used to translate the languages names. +.. caution:: + + If you want to override the built-in choices of the language type, you + will also have to set the ``choice_loader`` option to ``null``. Not doing + so is deprecated since Symfony 3.3. + Inherited Options ----------------- diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst index 5a54d179ceb..ca9c02e55f7 100644 --- a/reference/forms/types/locale.rst +++ b/reference/forms/types/locale.rst @@ -63,6 +63,12 @@ choices The choices option defaults to all locales. It uses the default locale to specify the language. +.. caution:: + + If you want to override the built-in choices of the locale type, you + will also have to set the ``choice_loader`` option to ``null``. Not doing + so is deprecated since Symfony 3.3. + Inherited Options ----------------- diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst index e46aa9f4fe3..b3fbfb2ff29 100644 --- a/reference/forms/types/timezone.rst +++ b/reference/forms/types/timezone.rst @@ -56,6 +56,12 @@ choices The Timezone type defaults the choices to all timezones returned by :phpmethod:`DateTimeZone::listIdentifiers`, broken down by continent. +.. caution:: + + If you want to override the built-in choices of the timezone type, you + will also have to set the ``choice_loader`` option to ``null``. Not doing + so is deprecated since Symfony 3.3. + Inherited Options -----------------