mirror of https://github.com/django/django.git
[2.0.x] Fixed #28761 -- Documented how an inline formset's prefix works.
Backport of 56e590cc0b
from master
This commit is contained in:
parent
8f2e3857ce
commit
e5acbbe18e
1
AUTHORS
1
AUTHORS
|
@ -362,6 +362,7 @@ answer newbie questions, and generally made Django that much better:
|
|||
Jason Yan <tailofthesun@gmail.com>
|
||||
Javier Mansilla <javimansilla@gmail.com>
|
||||
Jay Parlar <parlar@gmail.com>
|
||||
Jay Welborn <jesse.welborn@gmail.com>
|
||||
Jay Wineinger <jay.wineinger@gmail.com>
|
||||
J. Clifford Dyer <jcd@sdf.lonestar.org>
|
||||
jcrasta@gmail.com
|
||||
|
|
|
@ -578,6 +578,32 @@ argument - the index of the form in the formset. The index is ``None`` for the
|
|||
... kwargs['custom_kwarg'] = index
|
||||
... return kwargs
|
||||
|
||||
.. _formset-prefix:
|
||||
|
||||
Customizing a formset's prefix
|
||||
==============================
|
||||
|
||||
In the rendered HTML, formsets include a prefix on each field's name. By
|
||||
default, the prefix is ``'form'``, but it can be customized using the formset's
|
||||
``prefix`` argument.
|
||||
|
||||
For example, in the default case, you might see:
|
||||
|
||||
.. code-block:: html
|
||||
|
||||
<label for="id_form-0-title">Title:</label>
|
||||
<input type="text" name="form-0-title" id="id_form-0-title" />
|
||||
|
||||
But with ``ArticleFormset(prefix='article')`` that becomes:
|
||||
|
||||
.. code-block:: html
|
||||
|
||||
<label for="id_article-0-title">Title:</label>
|
||||
<input type="text" name="article-0-title" id="id_article-0-title" />
|
||||
|
||||
This is useful if you want to :ref:`use more than one formset in a view
|
||||
<multiple-formsets-in-view>`.
|
||||
|
||||
Using a formset in views and templates
|
||||
======================================
|
||||
|
||||
|
@ -653,6 +679,8 @@ If you manually render fields in the template, you can render
|
|||
Similarly, if the formset has the ability to order (``can_order=True``), it is
|
||||
possible to render it with ``{{ form.ORDER }}``.
|
||||
|
||||
.. _multiple-formsets-in-view:
|
||||
|
||||
Using more than one formset in a view
|
||||
-------------------------------------
|
||||
|
||||
|
@ -686,3 +714,6 @@ a look at how this might be accomplished::
|
|||
You would then render the formsets as normal. It is important to point out
|
||||
that you need to pass ``prefix`` on both the POST and non-POST cases so that
|
||||
it is rendered and processed correctly.
|
||||
|
||||
Each formset's :ref:`prefix <formset-prefix>` replaces the default ``form``
|
||||
prefix that's added to each field's ``name`` and ``id`` HTML attributes.
|
||||
|
|
|
@ -1143,6 +1143,10 @@ a particular author, you could do this::
|
|||
>>> author = Author.objects.get(name='Mike Royko')
|
||||
>>> formset = BookFormSet(instance=author)
|
||||
|
||||
``BookFormSet``'s :ref:`prefix <formset-prefix>` is ``'book_set'``
|
||||
(``<model name>_set`` ). If ``Book``'s ``ForeignKey`` to ``Author`` has a
|
||||
:attr:`~django.db.models.ForeignKey.related_name`, that's used instead.
|
||||
|
||||
.. note::
|
||||
|
||||
:func:`~django.forms.models.inlineformset_factory` uses
|
||||
|
|
Loading…
Reference in New Issue