Simple Twitter Bootstrap filter and templates for use with Django forms extracted from the Pinax Bootstrap theme.
Python
Switch branches/tags
Nothing to show
Pull request Compare This branch is 43 commits behind pinax:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
django_forms_bootstrap
MANIFEST.in
README.rst
setup.py

README.rst

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.