Render Django forms as described using the twitter bootstrap HTML layout
Project description
Render Django forms using the HTML described by the Bootstrap 3.
Demo
A basic demo is availaible on this sandbox
Install
From PyPI:
pip install django-twitterbootstrap-form
From Source:
python setup.py install
About Bootstrap 2
You can install the 0.2 version of this lib if you still work with old versions of Bootstrap
From PyPI:
pip install django-twitterbootstrap-form==0.2
From Source:
git checkout 0.2 python setup.py install
Requirements
Django>=1.4
django-widget-tweaks==1.3
Configuring
Add geelweb.django.twitter_bootstrap_form to INSTALLED_APPS in your settings
Load the tags adding {% load twitter_bootstrap %} in templates
Template filters
twitter_bootstrap
This tag takes 4 optional parameters
layout: Default: “default”. Existing layouts are, default, search, inline, horizontal
size: Default: “sm”. The column sizes. xs, sm, md, lg.
labelcols: Default: 2. Number of columns used for labels
fieldcols: Default: 12 - labelcols. NUmber of columns used for fields.
Example:
{{ form|twitter_bootstrap }}
Advanced usage:
{{ form|twitter_bootstrap:"horizontal,md,3,3" }}
More examples
Default form:
<form role="form">
{{ default_form|twitter_bootstrap }}
<button type="submit" class="btn btn-default">Submit</button>
</form>
Search form / Navbar form:
<form role="search" class="navbar-form">
{{ search_form|twitter_bootstrap:"search" }}
<button type="submit" class="btn btn-default">Search</button>
</form>
Inline form:
<form role="form" class="form-inline">
{{ inline_form|twitter_bootstrap:"inline" }}
<button type="submit" class="btn btn-default">Sign in</button>
</form>
Horizontal form:
<form role="form" class="form-horizontal">
{{ horizontal_form|twitter_bootstrap:"horizontal" }}
<div class="form-group">
<div class="col-sm-offset-2 col-sm-10">
<button type="submit" class="btn btn-default">Sign in</button>
</div>
</div>
</form>
Settings
BOOTSTRAP_REQUIRED_SUFFIX
Default: ‘ *’
Required field label suffix.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-twitterbootstrap-form-0.3.1.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 89fd56cf7a119095d2cca17a760e7d8b6a595dd58e35badfae0a42f536949ddd |
|
| MD5 | a5f7010f9a412950fe7717372fcbbb50 |
|
| BLAKE2b-256 | 4a576fdc5d582363330adb31f7478fa1d70d8f6e83c92ce63c9fe6309925a476 |
