Backported pallets-eco#409

CHANGES.rst

@@ -41,6 +41,7 @@ Unreleased
 -   Added a parameter to :class:`~fields.SelectField` to skip choice validation
     (`#434`_, `#493`_)
 -   Choices which name and data are the same do not need to use tuples. (`#526`_)
+-   Added more documentation on HTML5 fields (`#326`_,  `#409`_)
 
 .. _#238: https://github.com/wtforms/wtforms/issues/238
 .. _#239: https://github.com/wtforms/wtforms/issues/239
@@ -49,10 +50,12 @@ Unreleased
 .. _#288: https://github.com/wtforms/wtforms/pull/288
 .. _#289: https://github.com/wtforms/wtforms/issues/289
 .. _#298: https://github.com/wtforms/wtforms/issues/298
+.. _#326: https://github.com/wtforms/wtforms/issues/326
 .. _#343: https://github.com/wtforms/wtforms/pull/343
 .. _#389: https://github.com/wtforms/wtforms/pull/389
 .. _#395: https://github.com/wtforms/wtforms/pull/395
 .. _#407: https://github.com/wtforms/wtforms/pull/407
+.. _#409: https://github.com/wtforms/wtforms/pull/409
 .. _#410: https://github.com/wtforms/wtforms/pull/410
 .. _#434: https://github.com/wtforms/wtforms/issues/434
 .. _#451: https://github.com/wtforms/wtforms/pull/451

docs/fields.rst

@@ -555,3 +555,39 @@ Additional Helper Classes
     .. attribute:: text
 
         The original label text passed to the field's constructor.
+
+
+HTML5 Fields
+------------
+
+.. module:: wtforms.fields.html5
+
+In addition to basic HTML fields, WTForms also supplies fields for the HTML5
+standard. These fields can be accessed under the :mod:`wtforms.fields.html5` namespace.
+In reality, these fields are just convenience fields that extend basic fields
+and implement HTML5 specific widgets. These widgets are located in the :mod:`wtforms.widgets.html5`
+namespace and can be overridden or modified just like any other widget.
+
+.. autoclass:: SearchField(default field arguments)
+
+.. autoclass:: TelField(default field arguments)
+
+.. autoclass:: URLField(default field arguments)
+
+.. autoclass:: EmailField(default field arguments)
+
+.. autoclass:: DateTimeField(default field arguments,  format='%Y-%m-%d %H:%M:%S')
+
+.. autoclass:: DateField(default field arguments, format='%Y-%m-%d')
+
+.. autoclass:: TimeField(default field arguments, format='%H:%M')
+
+.. autoclass:: DateTimeLocalField(default field arguments, format='%Y-%m-%d %H:%M:%S')
+
+.. autoclass:: IntegerField(default field arguments)
+
+.. autoclass:: DecimalField(default field arguments)
+
+.. autoclass:: IntegerRangeField(default field arguments)
+
+.. autoclass:: DecimalRangeField(default field arguments)