Ticket #8272: forms.txt.diff

File forms.txt.diff, 2.2 KB (added by jbowman, 7 years ago)

Forms documentation update for new functionality.

Line 
1622a623,637
2> fieldset attribute for fields
3> ~~~~~~~~~~~~~~~~~~~~
4> New in the development version, you can add a fieldset attribute to fields that
5> can be used by templates to group fields. In the form below, the template
6> form.fields will have "fieldset" attributes you can group by, and also
7> use for legends within html fields.
8>
9>     class ContactForm(forms.Form):
10>         subject = forms.CharField(max_length=100, fieldset="Required")
11>         message = forms.CharField(fieldset="Required")
12>         sender = forms.EmailField(fieldset="Required")
13>         cc_myself = forms.BooleanField(required=False)
14>
15>
16>
17723a739,783
18> New in the development version, you can also use passed fieldset attributes to
19> layout the form fields in html fieldsets, using the attribute value as the legend.
20>
21>     <form method="post" action="">
22>     <dl>
23> {% regroup form by fieldset as fields_list %}
24> {% for fields in fields_list %}
25>     <fieldset>
26>     <legend>{{ fields.grouper|upper }}</legend>
27>         {% for field in fields.list %}
28>             <dt>{{ field.label_tag }}</dt>
29>             <dd>{{ field }}</dd>
30>             {% if field.help_text %}<dd>{{ field.help_text }}</dd>{% endif %}
31>             {% if field.errors %}<dd class="myerrors">{{ field.errors }}</dd>{% endif %}
32>         {% endfor %}
33>     {% endfor %}
34>     </dl>
35>     <input type="submit" />
36>     </form>
37>
38>
39> This will output the following HTML.
40>
41>     <fieldset>
42>     <legend>REQUIRED</legend>
43>     
44>         <label for="id_subject">Subject</label> <input id="id_subject" type="text" name="subject" maxlength="100" />
45>     
46>         <label for="id_message">Message</label> <input type="text" name="message" id="id_message" />
47>     
48>         <label for="id_sender">Sender</label> <input type="text" name="sender" id="id_sender" />
49>
50>     
51>     </fieldset>
52>
53>     <fieldset>
54>     <legend></legend>
55>     
56>         <label for="id_cc_myself">Cc myself</label> <input type="checkbox" name="cc_myself" id="id_cc_myself" />
57>     
58>     </fieldset>
59>
60>   <input type="submit" value="Submit" />
61>
62>
632156c2216
64< a formset out of an ``ArticleForm`` you would do::
65---
66> a formset of out of an ``ArticleForm`` you would do::
Back to Top