Author: Adam Cupiał
Contributors: Andrei Antoukh, Ben Lopatin, Marcin Kozioł, Berry Philips, Sebastian Vetter
Description
Formfields in django are not suited for HTML5, hence this app
Installation
clone repository git clone git://github.com/adamcupial/django-html5-forms.git, put it somewhere in your python path
add 'html5forms' to INSTALLED_APPS (not required)
use appropriate form fields in your forms (since the widgets requires some additional attributes passed from forms, you should use fields)
Fields
All fields
Attributes
all the core attributes from django field
placeholder :text, which displays on the field when it is empty and unfocused
autofocus (true/false), automaticaly set focus to element on page load
Html5CharField
widget: Html5TextInput
Typical CharField, most common field in the internet, allows datalist choices, which is great autocomplete feature
all the attr of django CharField
datalist: list or tuple, of words for autocompletion (sng like autocomplete in firefox or chrome)
Html5PasswordField
widget: Html5PasswordInput
Typical PasswordField, does not allow datalist choices
all the attr of django CharField/PasswordField
Html5SearchField
widget: Html5SearchInput
New field in HTML5 - the same as CharField only different input type, should be used in search fields, allows datalists
all the attr of django CharField/PasswordField
Html5EmailField
widget: Html5EmailInput
Html5UrlField
Html5IntegerField
widget: Html5NumberInput
Attributes:
required = [True/False]
min_value
max_value
Html5BooleanField
widget: Html5CheckboxInput
Html5RangeField
widget: Html5RangeInput
Attributes:
same as Html5IntegerField
step
Html5ChoiceField
widget: Html5Select
Attributes:
same as forms.ChoiceField
Html5TelField
widget: Html5TelInput
New field in HTML5 - provides defaults for minimum and maximum length that
should accept most phone numbers.
Attributes:
same as Html5CharField