diff --git a/reference/forms/twig_reference.rst b/reference/forms/twig_reference.rst index 3f45d66c0b8..0b2d1a23f55 100644 --- a/reference/forms/twig_reference.rst +++ b/reference/forms/twig_reference.rst @@ -344,6 +344,7 @@ object: | ``value`` | The value that will be used when rendering (commonly the ``value`` HTML attribute). | +------------------------+-------------------------------------------------------------------------------------+ | ``read_only`` | If ``true``, ``readonly="readonly"`` is added to the field. | +| | (deprecated as of 2.5, to be removed in 3.0, use ``attr["readonly"]`` instead) | +------------------------+-------------------------------------------------------------------------------------+ | ``disabled`` | If ``true``, ``disabled="disabled"`` is added to the field. | +------------------------+-------------------------------------------------------------------------------------+ diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst index 38c773ed3ac..a1f8db816d5 100644 --- a/reference/forms/types/birthday.rst +++ b/reference/forms/types/birthday.rst @@ -33,7 +33,7 @@ option defaults to 120 years ago to the current year. | | - `data`_ | | | - `invalid_message`_ | | | - `invalid_message_parameters`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | | | - `inherit_data`_ | diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst index 69c4fee5199..077e11f09f8 100644 --- a/reference/forms/types/checkbox.rst +++ b/reference/forms/types/checkbox.rst @@ -20,7 +20,7 @@ if the box is unchecked, the value will be set to false. | options | - `required`_ | | | - `label`_ | | | - `label_attr`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst index f7e298ec0aa..fd83660bb28 100644 --- a/reference/forms/types/choice.rst +++ b/reference/forms/types/choice.rst @@ -28,7 +28,7 @@ option. | options | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_mapping`_ | | | - `mapped`_ | diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst index 700e4adb6c6..6e45317e412 100644 --- a/reference/forms/types/country.rst +++ b/reference/forms/types/country.rst @@ -36,7 +36,7 @@ you should just use the ``choice`` type directly. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | +-------------+-----------------------------------------------------------------------+ diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst index ba7597bf564..582aad88cac 100644 --- a/reference/forms/types/currency.rst +++ b/reference/forms/types/currency.rst @@ -29,7 +29,7 @@ should just use the ``choice`` type directly. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | +-------------+------------------------------------------------------------------------+ diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst index d7b60bf9230..b1c8486bc80 100644 --- a/reference/forms/types/date.rst +++ b/reference/forms/types/date.rst @@ -35,7 +35,7 @@ day, and year) or three select boxes (see the `widget`_ option). | Inherited | - `data`_ | | options | - `invalid_message`_ | | | - `invalid_message_parameters`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | | | - `inherit_data`_ | diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst index 111bf1220d3..b0807687966 100644 --- a/reference/forms/types/datetime.rst +++ b/reference/forms/types/datetime.rst @@ -36,7 +36,7 @@ data can be a ``DateTime`` object, a string, a timestamp or an array. | Inherited | - `data`_ | | options | - `invalid_message`_ | | | - `invalid_message_parameters`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | | | - `inherit_data`_ | diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst index e03177a47e1..60e48e9ad4f 100644 --- a/reference/forms/types/email.rst +++ b/reference/forms/types/email.rst @@ -17,7 +17,7 @@ The ``email`` field is a text field that is rendered using the HTML5 | | - `label_attr`_ | | | - `data`_ | | | - `trim`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst index e68cf6718d6..83fcadd91f6 100644 --- a/reference/forms/types/entity.rst +++ b/reference/forms/types/entity.rst @@ -31,7 +31,7 @@ objects from the database. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst index 18f0683be0a..ff8cd60fd0c 100644 --- a/reference/forms/types/file.rst +++ b/reference/forms/types/file.rst @@ -15,7 +15,7 @@ The ``file`` type represents a file input in your form. | options | - `required`_ | | | - `label`_ | | | - `label_attr`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst index a16918e2ed1..a11c9be0ce8 100644 --- a/reference/forms/types/form.rst +++ b/reference/forms/types/form.rst @@ -16,7 +16,7 @@ on all types for which ``form`` is the parent type. | | - `label_attr`_ | | | - `constraints`_ | | | - `cascade_validation`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `trim`_ | | | - `mapped`_ | | | - `property_path`_ | diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst index 4eda2ff3136..06c92a7d9ba 100644 --- a/reference/forms/types/integer.rst +++ b/reference/forms/types/integer.rst @@ -24,7 +24,7 @@ integers. By default, all non-integer values (e.g. 6.78) will round down (e.g. 6 | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst index 1b8e78b2db4..67ceb366153 100644 --- a/reference/forms/types/language.rst +++ b/reference/forms/types/language.rst @@ -37,7 +37,7 @@ you should just use the ``choice`` type directly. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | +-------------+------------------------------------------------------------------------+ diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst index 56b588662aa..953ee7a359d 100644 --- a/reference/forms/types/locale.rst +++ b/reference/forms/types/locale.rst @@ -39,7 +39,7 @@ you should just use the ``choice`` type directly. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `mapped`_ | +-------------+------------------------------------------------------------------------+ diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst index 0f6f07248bb..e718544ce55 100644 --- a/reference/forms/types/money.rst +++ b/reference/forms/types/money.rst @@ -24,7 +24,7 @@ how the input and output of the data is handled. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst index 4858a5de097..8b1a1cac41c 100644 --- a/reference/forms/types/number.rst +++ b/reference/forms/types/number.rst @@ -20,7 +20,7 @@ you want to use for your number. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/options/read_only.rst.inc b/reference/forms/types/options/read_only.rst.inc index d1c2101591c..66b5796ad61 100644 --- a/reference/forms/types/options/read_only.rst.inc +++ b/reference/forms/types/options/read_only.rst.inc @@ -1,3 +1,8 @@ +.. caution:: + + The ``read_only`` option has been deprecated and will be removed in 3.0. + Instead, use the ``attr`` option by setting it to an array with a ``readonly`` key. + read_only ~~~~~~~~~ diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst index fa9df3f3b12..8d977d26f71 100644 --- a/reference/forms/types/password.rst +++ b/reference/forms/types/password.rst @@ -17,7 +17,7 @@ The ``password`` field renders an input password text box. | | - `label`_ | | | - `label_attr`_ | | | - `trim`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst index c1c2b673ac0..d3c1be91ae3 100644 --- a/reference/forms/types/percent.rst +++ b/reference/forms/types/percent.rst @@ -23,7 +23,7 @@ This field adds a percentage sign "``%``" after the input box. | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | -| | - `read_only`_ | +| | - `read_only`_ (deprecated as of 2.5) | | | - `disabled`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst index 946899170cb..0cc07977b84 100644 --- a/reference/forms/types/radio.rst +++ b/reference/forms/types/radio.rst @@ -21,7 +21,7 @@ If you want to have a Boolean field, use :doc:`checkbox