test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[1.7.x] Fixed #22786 -- Documented value_from_datadict caveat 

Thanks blueyed for the report and Tim Graham for the review.
Backport of 909015a51b from master.
This commit is contained in:
Claude Paroz 2014-08-29 10:22:59 +02:00
parent f201cfae12
commit 022fdb2ac4
1 changed files with 6 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/ref/forms/widgets.txt
View File

@ -217,7 +217,12 @@ foundation for custom widgets.
.. method:: value_from_datadict(data, files, name)
Given a dictionary of data and this widget's name, returns the value
of this widget. Returns ``None`` if a value wasn't provided.
of this widget. ``files`` may contain data coming from
:attr:`request.FILES <django.http.HttpRequest.FILES>`. Returns ``None``
if a value wasn't provided. Note also that ``value_from_datadict`` may
be called more than once during handling of form data, so if you
customize it and add expensive processing, you should implement some
caching mechanism yourself.
.. class:: MultiWidget(widgets, attrs=None)