.. _widgets:

=========================================
:mod:`formular.widgets` - (X)HTML Widgets
=========================================
These are the (X)HTML widgets used to represents fields as UI-Elements which
can be used in templates to be rendered to (X)HTML.

.. currentmodule:: formular.widgets

.. autoclass:: Renderable
   :members:

.. autoclass:: Widget
   :members:

.. autoclass:: TextInput
   :members: as_li, render

.. autoclass:: Textarea
   :members:

.. autoclass:: PasswordInput
   :members: as_li, render

.. autoclass:: Checkbox
   :members: as_li, render

.. autoclass:: SubmitInput
   :members:

.. autoclass:: RadioButtonGroup
   :members: as_ol, as_ul, subwidget, render

.. autoclass:: RadioButton
   :members: checked, as_li, render

.. autoclass:: CheckboxGroup
   :members: as_ol, as_ul, subwidget, render

.. autoclass:: GroupCheckbox
   :members: checked, as_li, render

.. autoclass:: MappingWidget
   :members:
   :exclude-members: builder

.. autoclass:: MultipleWidget
   :members: as_ol, as_ul, iter_subwidgets, render

.. autoclass:: FormWidget
   :members:

.. autoclass:: ValidationErrorWidget
   :members:

   .. method:: as_ol(**attrs)

      Renders the validation error as an ordered list.

   .. method:: as_ul(**attrs)

      Renders the validation error as an unordered list.

.. autoclass:: ReCAPTCHAWidget
   :members: