mirror of
https://github.com/django/django.git
synced 2025-08-04 19:08:28 +00:00
Fixed #30573 -- Rephrased documentation to avoid words that minimise the involved difficulty.
This patch does not remove all occurrences of the words in question. Rather, I went through all of the occurrences of the words listed below, and judged if they a) suggested the reader had some kind of knowledge/experience, and b) if they added anything of value (including tone of voice, etc). I left most of the words alone. I looked at the following words: - simply/simple - easy/easier/easiest - obvious - just - merely - straightforward - ridiculous Thanks to Carlton Gibson for guidance on how to approach this issue, and to Tim Bell for providing the idea. But the enormous lion's share of thanks go to Adam Johnson for his patient and helpful review.
This commit is contained in:
parent
addabc492b
commit
4a954cfd11
149 changed files with 1101 additions and 1157 deletions
|
@ -25,7 +25,7 @@ A :class:`Form` instance is either **bound** to a set of data, or **unbound**.
|
|||
|
||||
.. class:: Form
|
||||
|
||||
To create an unbound :class:`Form` instance, simply instantiate the class::
|
||||
To create an unbound :class:`Form` instance, instantiate the class::
|
||||
|
||||
>>> f = ContactForm()
|
||||
|
||||
|
@ -158,8 +158,9 @@ By default, ``as_json()`` does not escape its output. If you are using it for
|
|||
something like AJAX requests to a form view where the client interprets the
|
||||
response and inserts errors into the page, you'll want to be sure to escape the
|
||||
results on the client-side to avoid the possibility of a cross-site scripting
|
||||
attack. It's trivial to do so using a JavaScript library like jQuery - simply
|
||||
use ``$(el).text(errorText)`` rather than ``.html()``.
|
||||
attack. You can do this in JavaScript with ``element.textContent = errorText``
|
||||
or with jQuery's ``$(el).text(errorText)`` (rather than its ``.html()``
|
||||
function).
|
||||
|
||||
If for some reason you don't want to use client-side escaping, you can also
|
||||
set ``escape_html=True`` and error messages will be escaped so you can use them
|
||||
|
@ -185,7 +186,7 @@ should be added. If its value is ``None`` the error will be treated as
|
|||
a non-field error as returned by :meth:`Form.non_field_errors()
|
||||
<django.forms.Form.non_field_errors>`.
|
||||
|
||||
The ``error`` argument can be a simple string, or preferably an instance of
|
||||
The ``error`` argument can be a string, or preferably an instance of
|
||||
``ValidationError``. See :ref:`raising-validation-error` for best practices
|
||||
when defining form errors.
|
||||
|
||||
|
@ -434,7 +435,7 @@ Outputting forms as HTML
|
|||
========================
|
||||
|
||||
The second task of a ``Form`` object is to render itself as HTML. To do so,
|
||||
simply ``print`` it::
|
||||
``print`` it::
|
||||
|
||||
>>> f = ContactForm()
|
||||
>>> print(f)
|
||||
|
@ -563,7 +564,7 @@ errors. For example, you might want to present required form rows in bold and
|
|||
highlight errors in red.
|
||||
|
||||
The :class:`Form` class has a couple of hooks you can use to add ``class``
|
||||
attributes to required rows or to rows with errors: simply set the
|
||||
attributes to required rows or to rows with errors: set the
|
||||
:attr:`Form.error_css_class` and/or :attr:`Form.required_css_class`
|
||||
attributes::
|
||||
|
||||
|
@ -634,7 +635,7 @@ tags nor ``id`` attributes::
|
|||
<p>Cc myself: <input type="checkbox" name="cc_myself"></p>
|
||||
|
||||
If ``auto_id`` is set to ``True``, then the form output *will* include
|
||||
``<label>`` tags and will simply use the field name as its ``id`` for each form
|
||||
``<label>`` tags and will use the field name as its ``id`` for each form
|
||||
field::
|
||||
|
||||
>>> f = ContactForm(auto_id=True)
|
||||
|
@ -750,7 +751,7 @@ In the ``as_p()``, ``as_ul()`` and ``as_table()`` shortcuts, the fields are
|
|||
displayed in the order in which you define them in your form class. For
|
||||
example, in the ``ContactForm`` example, the fields are defined in the order
|
||||
``subject``, ``message``, ``sender``, ``cc_myself``. To reorder the HTML
|
||||
output, just change the order in which those fields are listed in the class.
|
||||
output, change the order in which those fields are listed in the class.
|
||||
|
||||
There are several other ways to customize the order:
|
||||
|
||||
|
@ -833,7 +834,7 @@ pass that in at construction time::
|
|||
More granular output
|
||||
====================
|
||||
|
||||
The ``as_p()``, ``as_ul()``, and ``as_table()`` methods are simply shortcuts --
|
||||
The ``as_p()``, ``as_ul()``, and ``as_table()`` methods are shortcuts --
|
||||
they're not the only way a form object can be displayed.
|
||||
|
||||
.. class:: BoundField
|
||||
|
@ -1121,8 +1122,8 @@ form data)::
|
|||
# Bound form with an image field, data from the request
|
||||
>>> f = ContactFormWithMugshot(request.POST, request.FILES)
|
||||
|
||||
Constructing an unbound form is the same as always -- just omit both
|
||||
form data *and* file data::
|
||||
Constructing an unbound form is the same as always -- omit both form data *and*
|
||||
file data::
|
||||
|
||||
# Unbound form with an image field
|
||||
>>> f = ContactFormWithMugshot()
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue