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.

Credits and license

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

Table Of Contents

Next topic

Overview

This Page