diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst index adb6f8d1b24..fc529e3a7d9 100644 --- a/reference/forms/types/checkbox.rst +++ b/reference/forms/types/checkbox.rst @@ -14,7 +14,8 @@ if the box is unchecked, the value will be set to false. | Options | - `value`_ | +-------------+------------------------------------------------------------------------+ | Inherited | - `data`_ | -| options | - `required`_ | +| options | - `empty_data`_ | +| | - `required`_ | | | - `label`_ | | | - `label_attr`_ | | | - `read_only`_ | @@ -60,6 +61,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/data.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst index b6c014784b5..9c72ed2fe98 100644 --- a/reference/forms/types/collection.rst +++ b/reference/forms/types/collection.rst @@ -21,8 +21,8 @@ forms, which is useful when creating forms that expose one-to-many relationships | | - `prototype_name`_ | +-------------+-----------------------------------------------------------------------------+ | Inherited | - `label`_ | -| | - `label_attr`_ | -| options | - `error_bubbling`_ | +| options | - `label_attr`_ | +| | - `error_bubbling`_ | | | - `error_mapping`_ | | | - `by_reference`_ | | | - `empty_data`_ | diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst index ceb1f8385d8..e8bb61ae572 100644 --- a/reference/forms/types/country.rst +++ b/reference/forms/types/country.rst @@ -31,6 +31,7 @@ you should just use the ``choice`` type directly. | | - `empty_value`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | +| | - `empty_data`_ | | | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -74,6 +75,8 @@ These options inherit from the :doc:`choice ` typ These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst index b92d1a3e4d5..b91b55f5a48 100644 --- a/reference/forms/types/currency.rst +++ b/reference/forms/types/currency.rst @@ -24,6 +24,7 @@ should just use the ``choice`` type directly. | | - `preferred_choices`_ | | | - `empty_value`_ | | | - `error_bubbling`_ | +| | - `empty_data`_ | | | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -64,6 +65,8 @@ These options inherit from the :doc:`choice` type These options inherit from the :doc:`form` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst index 1ba1ec68d95..33908563a9a 100644 --- a/reference/forms/types/email.rst +++ b/reference/forms/types/email.rst @@ -11,7 +11,8 @@ The ``email`` field is a text field that is rendered using the HTML5 | Rendered as | ``input`` ``email`` field (a text box) | +-------------+---------------------------------------------------------------------+ | Inherited | - `max_length`_ | -| options | - `required`_ | +| options | - `empty_data`_ | +| | - `required`_ | | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | @@ -34,6 +35,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/max_length.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst index bcedc2775c0..15255213749 100644 --- a/reference/forms/types/entity.rst +++ b/reference/forms/types/entity.rst @@ -26,6 +26,7 @@ objects from the database. | options | - `expanded`_ | | | - `preferred_choices`_ | | | - `empty_value`_ | +| | - `empty_data`_ | | | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -196,6 +197,8 @@ These options inherit from the :doc:`choice ` typ These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst index 19abd57d0ae..863ef0bb609 100644 --- a/reference/forms/types/file.rst +++ b/reference/forms/types/file.rst @@ -9,8 +9,9 @@ The ``file`` type represents a file input in your form. +-------------+---------------------------------------------------------------------+ | Rendered as | ``input`` ``file`` field | +-------------+---------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | +| Inherited | - `empty_data`_ | +| options | - `required`_ | +| | - `label`_ | | | - `label_attr`_ | | | - `read_only`_ | | | - `disabled`_ | @@ -82,6 +83,8 @@ Inherited options These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst index 4a99b6e55d8..963d7903c87 100644 --- a/reference/forms/types/form.rst +++ b/reference/forms/types/form.rst @@ -15,6 +15,8 @@ on all fields. .. include:: /reference/forms/types/options/data_class.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst index cda5cb276ca..a92ae6697df 100644 --- a/reference/forms/types/integer.rst +++ b/reference/forms/types/integer.rst @@ -19,8 +19,9 @@ integers. By default, all non-integer values (e.g. 6.78) will round down (e.g. 6 | | - `precision`_ | | | - `grouping`_ | +-------------+-----------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | +| Inherited | - `empty_data`_ | +| options | - `required`_ | +| | - `label`_ | | | - `label_attr`_ | | | - `data`_ | | | - `read_only`_ | @@ -69,6 +70,8 @@ Inherited options These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst index 8205045e6e4..1b8e78b2db4 100644 --- a/reference/forms/types/language.rst +++ b/reference/forms/types/language.rst @@ -32,6 +32,7 @@ you should just use the ``choice`` type directly. | | - `empty_value`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | +| | - `empty_data`_ | | | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -75,6 +76,8 @@ These options inherit from the :doc:`choice ` typ These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst index 4d5dd32d621..c5626f71b95 100644 --- a/reference/forms/types/locale.rst +++ b/reference/forms/types/locale.rst @@ -34,6 +34,7 @@ you should just use the ``choice`` type directly. | | - `empty_value`_ | | | - `error_bubbling`_ | | | - `error_mapping`_ | +| | - `empty_data`_ | | | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -77,6 +78,8 @@ These options inherit from the :doc:`choice ` typ These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst index 5e143c93570..3a136b1ca22 100644 --- a/reference/forms/types/money.rst +++ b/reference/forms/types/money.rst @@ -19,8 +19,9 @@ how the input and output of the data is handled. | | - `precision`_ | | | - `grouping`_ | +-------------+---------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | +| Inherited | - `empty_data`_ | +| options | - `required`_ | +| | - `label`_ | | | - `label_attr`_ | | | - `data`_ | | | - `read_only`_ | @@ -87,6 +88,8 @@ Inherited Options These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst index 1becc320c7f..8152a65c913 100644 --- a/reference/forms/types/number.rst +++ b/reference/forms/types/number.rst @@ -15,8 +15,9 @@ you want to use for your number. | | - `precision`_ | | | - `grouping`_ | +-------------+----------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | +| Inherited | - `empty_data`_ | +| options | - `required`_ | +| | - `label`_ | | | - `label_attr`_ | | | - `data`_ | | | - `read_only`_ | @@ -77,6 +78,8 @@ Inherited Options These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst index 7cdbf2f3970..12ed8b17d77 100644 --- a/reference/forms/types/password.rst +++ b/reference/forms/types/password.rst @@ -12,7 +12,8 @@ The ``password`` field renders an input password text box. | Options | - `always_empty`_ | +-------------+------------------------------------------------------------------------+ | Inherited | - `max_length`_ | -| options | - `required`_ | +| options | - `empty_data`_ | +| | - `required`_ | | | - `label`_ | | | - `label_attr`_ | | | - `trim`_ | @@ -51,6 +52,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/max_length.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst index 2abe9fba4e9..dbde292cc35 100644 --- a/reference/forms/types/percent.rst +++ b/reference/forms/types/percent.rst @@ -18,8 +18,9 @@ This field adds a percentage sign "``%``" after the input box. | Options | - `type`_ | | | - `precision`_ | +-------------+-----------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | +| Inherited | - `empty_data`_ | +| options | - `required`_ | +| | - `label`_ | | | - `label_attr`_ | | | - `data`_ | | | - `read_only`_ | @@ -71,6 +72,8 @@ Inherited Options These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst index 9478a8816ee..6d29555f3fa 100644 --- a/reference/forms/types/radio.rst +++ b/reference/forms/types/radio.rst @@ -18,7 +18,8 @@ If you want to have a Boolean field, use :doc:`checkbox ` type: .. include:: /reference/forms/types/options/data.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst index d06b072d7a2..9ff7b9d8393 100644 --- a/reference/forms/types/search.rst +++ b/reference/forms/types/search.rst @@ -13,7 +13,8 @@ Read about the input search field at `DiveIntoHTML5.info`_ | Rendered as | ``input search`` field | +-------------+----------------------------------------------------------------------+ | Inherited | - `max_length`_ | -| options | - `required`_ | +| options | - `empty_data`_ | +| | - `required`_ | | | - `label`_ | | | - `label_attr`_ | | | - `trim`_ | @@ -35,6 +36,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/max_length.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst index d63d403f53e..675b1f800ae 100644 --- a/reference/forms/types/text.rst +++ b/reference/forms/types/text.rst @@ -10,7 +10,8 @@ The text field represents the most basic input text field. | Rendered as | ``input`` ``text`` field | +-------------+--------------------------------------------------------------------+ | Inherited | - `max_length`_ | -| options | - `required`_ | +| options | - `empty_data`_ | +| | - `required`_ | | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | @@ -34,6 +35,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/max_length.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst index 0602dd2b6ec..de0787c920e 100644 --- a/reference/forms/types/textarea.rst +++ b/reference/forms/types/textarea.rst @@ -10,6 +10,7 @@ Renders a ``textarea`` HTML element. | Rendered as | ``textarea`` tag | +-------------+------------------------------------------------------------------------+ | Inherited | - `max_length`_ | +| options | - `empty_data`_ | | options | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -33,6 +34,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/max_length.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst index 04f3006c5a9..ef4769e1cff 100644 --- a/reference/forms/types/timezone.rst +++ b/reference/forms/types/timezone.rst @@ -25,6 +25,7 @@ you should just use the ``choice`` type directly. | options | - `expanded`_ | | | - `preferred_choices`_ | | | - `empty_value`_ | +| | - `empty_data`_ | | | - `required`_ | | | - `label`_ | | | - `label_attr`_ | @@ -66,6 +67,8 @@ These options inherit from the :doc:`choice ` typ These options inherit from the :doc:`form ` type: +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst index b915793057c..44a68d68218 100644 --- a/reference/forms/types/url.rst +++ b/reference/forms/types/url.rst @@ -14,7 +14,8 @@ have a protocol. | Options | - `default_protocol`_ | +-------------+-------------------------------------------------------------------+ | Inherited | - `max_length`_ | -| options | - `required`_ | +| options | - `empty_data`_ | +| | - `required`_ | | | - `label`_ | | | - `label_attr`_ | | | - `data`_ | @@ -49,6 +50,8 @@ These options inherit from the :doc:`form ` type: .. include:: /reference/forms/types/options/max_length.rst.inc +.. include:: /reference/forms/types/options/empty_data.rst.inc + .. include:: /reference/forms/types/options/required.rst.inc .. include:: /reference/forms/types/options/label.rst.inc