From 38d60c394166367b9ec0782093784a0d4c2947ab Mon Sep 17 00:00:00 2001 From: Timo Graham Date: Sun, 26 Dec 2010 21:50:16 +0000 Subject: [PATCH] Fixed #13949 - Note that readonly fields can't be modified via custom clean methods. thanks alk for the suggestion and elbarto and Gabriel Hurley whose language I used in the final patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15060 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/topics/forms/index.txt | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/topics/forms/index.txt b/docs/topics/forms/index.txt index cfcfcf3701..ab35cc9d8b 100644 --- a/docs/topics/forms/index.txt +++ b/docs/topics/forms/index.txt @@ -139,7 +139,11 @@ While you could access ``request.POST`` directly at this point, it is better to access ``form.cleaned_data``. This data has not only been validated but will also be converted in to the relevant Python types for you. In the above example, ``cc_myself`` will be a boolean value. Likewise, fields such as ``IntegerField`` -and ``FloatField`` convert values to a Python int and float respectively. +and ``FloatField`` convert values to a Python int and float respectively. Note +that read-only fields are not available in ``form.cleaned_data`` (and setting +a value in a custom ``clean()`` method won't have any effect) because these +fields are displayed as text rather than as input elements, and thus are not +posted back to the server. Extending the above example, here's how the form data could be processed: @@ -390,5 +394,5 @@ This covers the basics, but forms can do a whole lot more: .. seealso:: :doc:`The Forms Reference ` - Covers the full API reference, including form fields, form widgets, + Covers the full API reference, including form fields, form widgets, and form and field validation.