Bootstrap 2 compatible templates for the deform form library
Project description
deform_bootstrap provides Bootstrap compatible templates for the deform form library.
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. Some widgets include markup with <ul> and <li> elements that don’t work very well with Bootstrap. Contributions the in form of markup changes and style corrections are most welcome.
deform_bootstrap currently passes around 95% of the deformdemo tests. (The remaining five percent are probably related to a setup issue with the the tests.)
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
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.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.