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: