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

1. clone repository git clone git://github.com/adamcupial/django-html5-forms.git, put it somewhere in your python path
2. add 'html5forms' to INSTALLED_APPS (not required)
3. 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