Skip to content

Simple yet powerful Django app for rendering forms in templates

Notifications You must be signed in to change notification settings

humphrey/django_formrenderer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Django Form Renderer

Provides template filters that allow you to give you power to render forms however you want.

HTML 5 input types are automatically used for field types that are appropriate.

If a field is required, the [required="required"] is automatically added to the element.

More info at: https://github.com/humphrey/django_formrenderer

Installation

pip install django_formrenderer

Examples

Simple HTML5 Example

{% load renderform %}
<form>
    <legend>Your details</legend>
    {{ form|renderform:"formrenderer/default.html, name, email, phone" }}

    <legend>Extra info</legend>
    {{ form|renderform:"formrenderer/default.html, dealer, comments" }}
</form>

Or use HTML 4 (but why would you?)

{{ form|renderform_html4:"formrenderer/default.html, name, email, phone" }}

Add a class name to a field

Append the field name with the class name. Eg. my_field.class_name

{{ form|renderform:"formrenderer/default.html, name.class_name" }}

Add an attribute

Append the field name with the attribute. Eg. my_field[key=value]

{{ form|renderform:"formrenderer/default.html, comments[rows=3]" }}
{{ form|renderform:"formrenderer/default.html, comments[rows=3,disabled=disabled]" }}

Add class names and attributes

Append the field name with the class name. Eg. my_field[key=value]

{{ form|renderform:"formrenderer/default.html, comments.my_class[rows=3]" }}

Complicated Example

{% load renderform %}
<form>
    {{ form|renderform:"formrenderer/bootstrap_horizontal.html, name.input-block-level, email.input-block-level" }}
    <hr/>
    {{ form|renderform:"formrenderer/bootstrap_horizontal.html, phone, dealer[class=myClass]" }}
    <hr/>
    {{ form|renderform:"formrenderer/bootstrap_horizontal.html, comments.input-block-level[rows=3]" }}
</form>

About

Simple yet powerful Django app for rendering forms in templates

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages