Custom renderer for django form fields
Project description
Good forms for Django
GoodForms — rails-like renderer for your form fields. Provide fully control of filed styles and attributes. It’s not replacement for django.forms.
Installation
Run pip install django-goodforms and add goodforms to INSTALLED_APPS. That’s all.
Usage
The view:
from django.shortcuts import render from django import forms class LoginForm(forms.Form): username = forms.CharField() password = forms.PasswordField() def sign_up(request): from = MyForm(initial={'username': 'johnsmith'}) return render(request, 'index.html', {'form': form})
The template:
{% load form_fields %} {% form name="login" class="login-form" %} {% textfield form.username class="login-form_input" %} {% textfield form.password class="login-form_input" %} {% submit_button "Login" %} {% endform %}
Controls
Form tag
Form tag automatically inject csrf-token.
Fields use name attribute as prefix for id and for in labels.
{% form name="myform" %} <!-- Form content --> {% endform %}
Textfield and Textarea
{% textfield form.title **kwargs %} {% textarea form.description **kwargs %}
Select
{% select form.country values="ru:Russia,de:Germany" %}
You can use any dict, iterable collection or queryset as values list:
{% select form.county values=any_iterable_object value_key="code" label_key="title" %}
Tips
You can use any of field without a form class:
{% input "username" required=True %} {% select "city" values="1:New York, 2:London" %}
Settigns
GOODFORMS_XHTML — Enable or disable XHTML syntax (default: False)
GOODFORMS_AUTO_ID — Automatically generate id and for attributes for fields and labels (default: True)
GOODFORMS_ID_PREFIX — Prefix for auto-generated id and for attributes. For forms without name attribute (default: field)
License
Licensed under the MIT license.
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
File details
Details for the file django-goodforms-0.2.1.tar.gz
.
File metadata
- Download URL: django-goodforms-0.2.1.tar.gz
- Upload date:
- Size: 5.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
d857de312ef118014161e147ca2abc67ba6c1bb36d203eff9c86f8472d7c479d
|
|
MD5 |
29da989abec9771a3e9b46f82702a7c9
|
|
BLAKE2b-256 |
bf7a250f7d63eae65dd77e931f9a8a4299398013b971801b61179d2d904bb699
|