From 85b698449f8d79ebd086c0d6fae58964ed765c55 Mon Sep 17 00:00:00 2001 From: Tobias Kunze Date: Sat, 27 Apr 2019 17:49:14 +0200 Subject: [PATCH] [2.2.x] Fixed #30395 -- Doc'd a limitation of ModelForm.Meta.widgets. Backport of a309821c973cf3bcfe817bb71163fcccc461cec1 from master --- docs/topics/forms/modelforms.txt | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index fe2e231a36d..4073bc6e276 100644 --- a/docs/topics/forms/modelforms.txt +++ b/docs/topics/forms/modelforms.txt @@ -522,7 +522,9 @@ For example, if you want the ``CharField`` for the ``name`` attribute of } The ``widgets`` dictionary accepts either widget instances (e.g., -``Textarea(...)``) or classes (e.g., ``Textarea``). +``Textarea(...)``) or classes (e.g., ``Textarea``). Note that the ``widgets`` +dictionary is ignored for a model field with a non-empty ``choices`` attribute. +In this case, you must override the form field to use a different widget. Similarly, you can specify the ``labels``, ``help_texts`` and ``error_messages`` attributes of the inner ``Meta`` class if you want to further customize a field.