skip to navigation
skip to content

django-formrenderingtools 0.2.1

Template-based rendering of Django forms (excluding widgets).

Downloads ↓ | Package 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 Django's form elements.

For the impatient, use the bundled demo project to discover and try the application (see docs/demo.txt for details).

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.

Credits and license

This application is published under the BSD license. See docs/LICENSE.txt for details.

 
File Type Py Version Uploaded on Size # downloads
django-formrenderingtools-0.2.1.tar.gz (md5) Source 2011-05-22 189KB 332