django-formrenderingtools’s documentation

django-formrenderingtools is an application for the Django framework. It provides tools for the template designer to customize forms.

Rather than using {{ form.as_p }}, set up and reuse templates to render form elements.

Currently, this application provides a “form_layouts” template tag library which itself provides the following template tags:

• form: renders a full form, i.e. non field errors, all fields, field errors, labels and help texts
• form_errors: renders global form errors, i.e. non field errors
• field_list: renders a set of fields in a form, with corresponding field errors, labels and help texts
• field: renders a field, with field errors, label and help text
• field_errors: renders errors related to a field
• label: renders a field’s label
• help_text: renders a field’s help text

The goal of this application is to provide a pack of template tags which helps you render each element of a form: full form, list of fields, non field errors (global errors), field errors (specific errors), field, label, help text...

Every form element has a corresponding template tag, which uses templates to generate the output. Template designers no longer rely on developers to customize the form output.

This application uses a template-naming system that lets you reuse generic templates or use specific ones, depending on your needs. You can reuse built-in templates, override them or create your own templates.

Links

HTML documentation

Browse the HTML documentation online.

RestructuredText documentation

Read the RestructuredText documentation in the docs/ folder in the source code.

Source code repository

Follow the project on BitBucket.

Pypi

The project is known as django-templateaddons in the Python package index.

Contents

• Overview
  • The problem: rendering forms with Django is boring
  • A solution: the “form_layouts” template tag library
• Installation
  • Requirements
  • Get the code
  • Update settings
• Tutorial
  • Prerequisites
  • Python code: create a form
  • Template code
  • To be continued...
• Reference
  • Template tags
  • Settings
  • Template names and directory structure
  • Cascading style sheets
• Examples
  • {% form %} example
• License
• Authors
• Changes
  • v0.1, 2010-06-03 – Initial release

Credits and license

This application is published under the BSD license. See License and Authors for details.