Bootstrap 2 compatible templates for the deform form library
Project description
deform_bootstrap provides Bootstrap compatible templates for the deform form library.
Currently, it only overrides a handful of templates to make deform forms look OK with bootstrap. Eventually, this package might grow to contain widgets for Bootstrap.
How to use it
In your Paste Deploy configuration file (e.g. development.ini) add deform_bootstrap to the list of pyramid_includes, or add a this line if a pyramid.includes setting does not exist:
[app:main] ... pyramid.includes = deform_bootstrap
This will put the templates in deform_bootstrap/templates into the deform search path.
Work in progress
Work still needs to be done on individual widget templates. Contributions the in form of markup changes and style corrections are most welcome.
deform_bootstrap passes 100% of the deformdemo tests. Please do run the Selenium tests before submitting a patch.
If you want to quickly try out deform_bootstrap and see how it looks in practice you can run these commands, assuming that you have a virtualenv set up in your deform_bootstrap directory:
$ git clone https://github.com/Pylons/deformdemo.git $ cd deformdemo $ ../bin/python setup.py develop $ cd .. $ bin/pserve demo.ini
You should now be able to access the demo site at http://0.0.0.0:8521
Running Selenium tests
Follow the instructions in deformdemo to install Selenium. Then install deform_bootstrap in your virtualenv and from within the deform_bootstrap package run this command:
$ bin/python deform_bootstrap/demo/test.py
API
input_prepend / input_append
Bootstrap has a nice feature to prepend/append text to input[type=text] form elements (see http://twitter.github.com/bootstrap/base-css.html#forms). To use it with deform_bootstrap you can simply pass input_prepend or input_append as keyword arguments to the widget constructor in your colander.Schema subclass:
class PersonSchema(colander.Schema): weight = colander.SchemaNode( colander.Integer(), title=u"Weight", widget=deform.widget.TextInputWidget( input_append="kg", css_class="span1", ))
CHANGES
0.1a5 - 2012-02-09
All deformdemo Selenium tests passing.
Add sequence templates.
0.1a4 - 2012-02-09
In includeme, prepend deform search path instead of resetting the whole renderer.
0.1a3 - 2012-02-03
Changes to support Bootstrap 2.0.
Added support for Bootstrap’s feature to prepend/append text to input[type=text] via input_prepend/input_append keyword arguments to deform.Widget constructor.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.