summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorClaude Paroz <claude@2xlibre.net>2015-07-07 21:06:57 +0200
committerClaude Paroz <claude@2xlibre.net>2015-07-16 19:36:56 +0200
commit1ef4aeab403f7fb74c0b9b11fde854fd03afc40c (patch)
treeb3852ad0aefffcf4fd29aacc19e1ca9529d9cdb9 /docs/ref
parent1fed8dd715cc734f51c162d4362d34d357925bc4 (diff)
Fixed #25078 -- Added support for disabled form fields
Thanks Keryn Knight and Tim Graham for the reviews.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/forms/fields.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index c4a40021d0..776ef873ad 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -299,6 +299,17 @@ as the rendered output.
See the :ref:`format localization <format-localization>` documentation for
more information.
+``disabled``
+~~~~~~~~~~~~
+
+.. attribute:: Field.disabled
+
+.. versionadded:: 1.9
+
+The ``disabled`` boolean argument, when set to ``True``, disables a form field
+using the ``disabled`` HTML attribute so that it won't be editable by users.
+Even if a user tampers with the field's value submitted to the server, it will
+be ignored in favor of the value from the form's initial data.
Checking if the field data has changed
--------------------------------------