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.
Project details
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 |