From b52c73008a9d67e9ddbb841872dc15cdd3d6ee01 Mon Sep 17 00:00:00 2001 From: Preston Timmons Date: Tue, 27 Dec 2016 17:00:56 -0500 Subject: Fixed #15667 -- Added template-based widget rendering. Thanks Carl Meyer and Tim Graham for contributing to the patch. --- docs/ref/forms/api.txt | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'docs/ref/forms/api.txt') diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt index 194c390484..c74cfaed48 100644 --- a/docs/ref/forms/api.txt +++ b/docs/ref/forms/api.txt @@ -720,6 +720,29 @@ When set to ``True`` (the default), required form fields will have the ``use_required_attribute=False`` to avoid incorrect browser validation when adding and deleting forms from a formset. +Configuring the rendering of a form's widgets +--------------------------------------------- + +.. attribute:: Form.default_renderer + +.. versionadded:: 1.11 + +Specifies the :doc:`renderer ` to use for the form. Defaults to +``None`` which means to use the default renderer specified by the +:setting:`FORM_RENDERER` setting. + +You can set this as a class attribute when declaring your form or use the +``renderer`` argument to ``Form.__init__()``. For example:: + + from django import forms + + class MyForm(forms.Form): + default_renderer = MyRenderer() + +or:: + + form = MyForm(renderer=MyRenderer()) + Notes on field ordering ----------------------- -- cgit v1.3