Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A reusable django app for customising form rendering from your template.

Project description

# 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

```HTML+Django/Jinja
{% 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?)

```HTML+Django/Jinja
{{ 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`

```HTML+Django/Jinja
{{ form|renderform:"formrenderer/default.html, name.class_name" }}
```

### Add an attribute

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

```HTML+Django/Jinja
{{ 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]`

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

### Complicated Example

```HTML+Django/Jinja
{% 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>
```

Project details


Release history Release notifications

This version

2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django_formrenderer, version 2.0
Filename, size File type Python version Upload date Hashes
Filename, size django_formrenderer-2.0.tar.gz (3.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page