diff options
| author | Stephen Finucane <stephenfinucane@hotmail.com> | 2018-09-11 13:14:53 -0600 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2018-09-11 15:14:53 -0400 |
| commit | 25f4302349db71d73a15ff8f3872956fc21a0f84 (patch) | |
| tree | 2efa4007bcf74f8f3491d7f1cace9ebfe2e1b587 /docs | |
| parent | 32fbccab406b680bc0a0a8d39a9b95c3a08bbc5a (diff) | |
Emphasized that TemplatesSetting must be used to override widget templates.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/howto/overriding-templates.txt | 5 | ||||
| -rw-r--r-- | docs/ref/forms/renderers.txt | 8 |
2 files changed, 10 insertions, 3 deletions
diff --git a/docs/howto/overriding-templates.txt b/docs/howto/overriding-templates.txt index f46dd1d85f..e7c65dd354 100644 --- a/docs/howto/overriding-templates.txt +++ b/docs/howto/overriding-templates.txt @@ -12,6 +12,11 @@ the default Django template loader will try to load the template from the project-level directory first. In other words, :setting:`DIRS <TEMPLATES-DIRS>` is searched before :setting:`APP_DIRS <TEMPLATES-APP_DIRS>`. +.. seealso:: + + Read :ref:`overriding-built-in-widget-templates` if you're looking to + do that. + Overriding from the project's templates directory ================================================= diff --git a/docs/ref/forms/renderers.txt b/docs/ref/forms/renderers.txt index 71f0661f94..58caa08c32 100644 --- a/docs/ref/forms/renderers.txt +++ b/docs/ref/forms/renderers.txt @@ -114,6 +114,8 @@ Some widgets add further information to the context. For instance, all widgets that subclass ``Input`` defines ``widget['type']`` and :class:`.MultiWidget` defines ``widget['subwidgets']`` for looping purposes. +.. _overriding-built-in-widget-templates: + Overriding built-in widget templates ==================================== @@ -123,6 +125,6 @@ Each widget has a ``template_name`` attribute with a value such as ``input.html`` by defining ``django/forms/widgets/input.html``, for example. See :ref:`built-in widgets` for the name of each widget's template. -If you use the :class:`TemplatesSetting` renderer, overriding widget templates -works the same as overriding any other template in your project. You can't -override built-in widget templates using the other built-in renderers. +To override widget templates, you must use the :class:`TemplatesSetting` +renderer. Then overriding widget templates works :doc:`the same as +</howto/overriding-templates>` overriding any other template in your project. |
