Small tweak to docs/newforms.txt
git-svn-id: http://code.djangoproject.com/svn/django/trunk@4171 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
b6a7afd4bd
commit
9a02d668c1
|
@ -3,10 +3,8 @@ The newforms library
|
||||||
====================
|
====================
|
||||||
|
|
||||||
``django.newforms`` is a new replacement for ``django.forms``, the old Django
|
``django.newforms`` is a new replacement for ``django.forms``, the old Django
|
||||||
form/manipulator/validation framework. This functionality is new in the Django
|
form/manipulator/validation framework. This document explains how to use this
|
||||||
development version -- i.e., it's not available in the Django 0.95 release.
|
new form library.
|
||||||
|
|
||||||
This document explains how to use this new form library.
|
|
||||||
|
|
||||||
Migration plan
|
Migration plan
|
||||||
==============
|
==============
|
||||||
|
@ -25,7 +23,7 @@ release, our plan is to do the following:
|
||||||
* Move the current ``django.newforms`` to ``django.forms``.
|
* Move the current ``django.newforms`` to ``django.forms``.
|
||||||
|
|
||||||
* We will remove ``django.oldforms`` in the release *after* the next Django
|
* We will remove ``django.oldforms`` in the release *after* the next Django
|
||||||
release -- i.e., the release that comes after the release in which we're
|
release -- the release that comes after the release in which we're
|
||||||
creating ``django.oldforms``.
|
creating ``django.oldforms``.
|
||||||
|
|
||||||
With this in mind, we recommend you use the following import statement when
|
With this in mind, we recommend you use the following import statement when
|
||||||
|
@ -55,9 +53,12 @@ want to perform server-side validation for an HTML form.
|
||||||
The library deals with these concepts:
|
The library deals with these concepts:
|
||||||
|
|
||||||
* **Widget** -- A class that corresponds to an HTML form widget, e.g.
|
* **Widget** -- A class that corresponds to an HTML form widget, e.g.
|
||||||
``<input type="text">`` or ``<textarea>``.
|
``<input type="text">`` or ``<textarea>``. This handles rendering of the
|
||||||
|
widget as HTML.
|
||||||
|
|
||||||
* **Field** -- A class that is responsible for doing validation, e.g.
|
* **Field** -- A class that is responsible for doing validation, e.g.
|
||||||
an ``EmailField`` that makes sure its data is a valid e-mail address.
|
an ``EmailField`` that makes sure its data is a valid e-mail address.
|
||||||
|
|
||||||
* **Form** -- A collection of fields that knows how to validate itself and
|
* **Form** -- A collection of fields that knows how to validate itself and
|
||||||
display itself as HTML.
|
display itself as HTML.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue