django-formfieldset is a simple Django app that provides a mix-in class for admin-like fieldset rendering.
- Fieldset functionality similar to
ModelAdmin - Shorthand rendering functions with fieldsets both for whole forms and for individual fieldsets
- render as
P - render as
TABLE - render as
UL
- render as
- Template strings are class attributes
- Overrides nothing in
django.forms.Form
- Add
"django-formfieldset"directory to your Python path. - Add
"formfieldset"to yourINSTALLED_APPStuple found in your settings file. (optional - to be able to run tests)
There is an example project in the example/ directory. To run
automated tests for django-formfieldset run the following command
in example/ directory:
python example/manage.py test formfieldset
To run the example project:
python example/manage.py runserver
Then you can visit http://localhost:8000/ to view the example.
Example project also serves as detailed documentation for formfieldset.
Code examples will be highlighted if you have pygments installed.
- Create your form with
FieldsetMixin. - Add a
fieldsetsattribute to your form. See admin docs for detailed explanation. - Render your form with fieldset enabled methods:
- You can use
iter_fieldsets()for custom form rendering. It will yieldFieldsetobjects.Fieldsets act as iterators for widgets in them. - You can use
as_fieldset_table(),as_fieldset_ul()andas_fieldset_p()methods that act like built-inas_*method except fieldset support.
- You can use