Django Forms Bootstrap

Simple Twitter Bootstrap filter for Django forms. Extracted from the bootstrap theme for Pinax.

Quick Start

Include "django-forms-bootstrap" in your requirements file and "django_forms_bootstrap" in your INSTALLED APPS.

Make sure your template loader finders includes app directories.

To style forms, add the following to the top of your template

{% load bootstrap_tags %}

and include your form using something like the following markup:

<form>
    <legend>My Form</legend>
    {% csrf_token %}
    {{ form|as_bootstrap }}
    <div class="form-actions">
      <a href="#back" class="btn">Go back</a>
      <button type="submit" class="btn btn-primary">Save changes</button>
    </div>
</form>

Specifying form layouts

Bootstrap includes styles for four types of forms. To change the display of your form, add one of the following class attributes to your form tag:

Name	Class	Description
Vertical (default)	.form-vertical	Stacked, left-aligned labels over controls
Horizontal	.form-horizontal	Float left, right-aligned labels on same line as controls
Inline	.form-inline	Left-aligned label and inline-block controls for compact style
Search	.form-search	Extra-rounded text input for a typical search aesthetic

License & Attribution

Django Forms Bootstrap is released under the MIT license. It does not include any styles or scripts from the Twitter Bootstrap project.