Django application to add 'django-crispy-forms' layout objects for Foundation
Project description
Introduction
This is a Django application to add django-crispy-forms layout objects for Foundation.
Actually this is only to use specific templates and changing some CSS class names.
This app does not embed a Foundation release, you will have to install it yourself.
Links
Download his PyPi package;
Clone it on his Github repository;
Requires
django-crispy-forms >= 1.1.2;
Installation
Just register the app in your project settings like this :
INSTALLED_APPS = (
...
'crispy_forms',
'crispy_forms_foundation',
...
)
Usage
Import crispy-forms-foundation then you can use the layout object in your forms :
from crispy_forms_foundation.layout import Layout, Fieldset, Field, SplitDateTimeField, RowFluid, Column, Div, ButtonHolder, Submit, HTML
class YourForm(forms.ModelForm):
"""
*Page* form
"""
def __init__(self, *args, **kwargs):
self.helper = FormHelper()
self.helper.form_action = '.'
self.helper.layout = Layout(
Fieldset(
ugettext('Content'),
'title',
'content',
),
Fieldset(
ugettext('Display settings'),
RowFluid(
Column('template', css_class='six'),
Column('order', css_class='three'),
Column('visible', css_class='three'),
),
),
Fieldset(
ugettext('Publish settings'),
'parent',
RowFluid(
Column(SplitDateTimeField('published'), css_class='six'),
Column('slug', css_class='six'),
),
),
ButtonHolder(
Submit('submit_and_continue', ugettext('Save and continue')),
Submit('submit', ugettext('Save')),
),
)
super(YourForm, self).__init__(*args, **kwargs)
The embedded templates are in crispy_forms_foundation/templates/foundation.
Layout items
For now there is only three layout items dedicated to Foundation (Row, RowFluid, Column), other embedded items are cloned from the uni_form layout items from django-crispy-forms.
Row
Act as a div container row, it will embed his items in a div like this :
<div class"row">Your stuff</div>
RowFluid
It has a same behaviour than Row but add a CSS class “row-fluid” that you can use to have top level row that take all the container width. You have to put the CSS for this class to your CSS stylesheet. It will embed his items in a div like this :
<div class"row row-fluid">Your stuff</div>
The CSS to add should be something like this :
.row-fluid { width: 100%; max-width: 100%; min-width: 100%; }
Column
This is the column from the Foundation Grid, all columns should be contained in a Row or a RowFluid and you will have to define the column type in the css_class attribute.
With a css_class attribute defined to twelve, it will embed his items in a div like this :
<div class"columns twelve">Your stuff</div>
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.
Source Distribution
Hashes for crispy-forms-foundation-0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 098aea6e883914bfc7da87f1178fbb4aed126ca3b69113e334caf3cc666bca3a |
|
MD5 | 7488a9687a9df34e462f6a96540ce911 |
|
BLAKE2b-256 | aef1599b274a52d306ade27ecab2bd7212f2c6134644fbb57d28c2e07c1fdf49 |