{"title":"模型表单函数","version":"3.2","locale":"zh-hans","docname":"ref/forms/models","url":"/zh-hans/3.2/ref/forms/models/","canonical":"https://djangodocs.dev/zh-hans/3.2/ref/forms/models/","summary":"模型表单 API 参考。关于模型表单的介绍材料，请参见从模型创建表单主题指南。为给定的 model 返回一个 ModelForm 类。","html":"<h1>模型表单函数<a class=\"heading-anchor\" href=\"#model-form-functions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>模型表单 API 参考。关于模型表单的介绍材料，请参见 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/\"><span class=\"doc\">从模型创建表单</span></a> 主题指南。</p>\n<section id=\"modelform-factory\">\n<span id=\"module-django.forms.models\"></span><h2><code class=\"docutils literal notranslate\">modelform_factory</code><a class=\"heading-anchor\" href=\"#modelform-factory\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py function\">\n<dt class=\"sig sig-object py\" id=\"django.forms.models.modelform_factory\">\n<span class=\"sig-name descname\">modelform_factory</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">model</em>, <em class=\"sig-param\">form<span class=\"o\">=</span><span class=\"default_value\">ModelForm</span></em>, <em class=\"sig-param\">fields<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">exclude<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">formfield_callback<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">widgets<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">localized_fields<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">labels<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">help_texts<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">error_messages<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">field_classes<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.forms.models.modelform_factory\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>为给定的 <code class=\"docutils literal notranslate\">model</code> 返回一个 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/#django.forms.ModelForm\" title=\"django.forms.ModelForm\"><code class=\"xref py py-class docutils literal notranslate\">ModelForm</code></a> 类。你可以选择性地传递一个 <code class=\"docutils literal notranslate\">form</code> 参数作为构建 <code class=\"docutils literal notranslate\">ModelForm</code> 的起点。</p>\n<p><code class=\"docutils literal notranslate\">fields</code> 是一个可选的字段名列表。如果提供，返回的字段中只包括命名的字段。</p>\n<p><code class=\"docutils literal notranslate\">exclude</code> 是一个可选的字段名列表。如果提供了这个列表，指定的字段将被排除在返回的字段之外，即使这些字段被列在 <code class=\"docutils literal notranslate\">fields</code> 参数中。</p>\n<p><code class=\"docutils literal notranslate\">formfield_callback</code> 是一个可调用的函数，它接收一个模型字段并返回一个表单字段。</p>\n<p><code class=\"docutils literal notranslate\">widgets</code> 是一个映射到部件的模型字段名的字典。</p>\n<p><code class=\"docutils literal notranslate\">localized_fields</code> 是一个应本地化的字段名称列表。</p>\n<p><code class=\"docutils literal notranslate\">labels</code> 是一个映射到标签的模型字段名的字典。</p>\n<p><code class=\"docutils literal notranslate\">help_texts</code> 是一个映射到帮助文本的模型字段名的字典。</p>\n<p><code class=\"docutils literal notranslate\">error_messages</code> 是一个模型字段名的字典，映射到错误信息的字典。</p>\n<p><code class=\"docutils literal notranslate\">field_classes</code> 是映射到表单字段类的模型字段名的字典。</p>\n<p>见 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/#modelforms-factory\"><span class=\"std std-ref\">ModelForm的工厂函数</span></a> 的用法示例。</p>\n<p>你必须通过关键字参数 <code class=\"docutils literal notranslate\">fields</code> 或 <code class=\"docutils literal notranslate\">exclude</code> 或表单内部 <code class=\"docutils literal notranslate\">Meta</code> 类的相应属性，明确地提供字段列表。更多信息参见 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/#modelforms-selecting-fields\"><span class=\"std std-ref\">选择要使用的字段</span></a>。忽略任何要使用的字段定义将引发 <a class=\"reference internal\" href=\"/zh-hans/3.2/ref/exceptions/#django.core.exceptions.ImproperlyConfigured\" title=\"django.core.exceptions.ImproperlyConfigured\"><code class=\"xref py py-exc docutils literal notranslate\">ImproperlyConfigured</code></a> 异常。</p>\n</dd></dl>\n\n</section>\n<section id=\"modelformset-factory\">\n<h2><code class=\"docutils literal notranslate\">modelformset_factory</code><a class=\"heading-anchor\" href=\"#modelformset-factory\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py function\">\n<dt class=\"sig sig-object py\" id=\"django.forms.models.modelformset_factory\">\n<span class=\"sig-name descname\">modelformset_factory</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">model</em>, <em class=\"sig-param\">form<span class=\"o\">=</span><span class=\"default_value\">ModelForm</span></em>, <em class=\"sig-param\">formfield_callback<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">formset<span class=\"o\">=</span><span class=\"default_value\">BaseModelFormSet</span></em>, <em class=\"sig-param\">extra<span class=\"o\">=</span><span class=\"default_value\">1</span></em>, <em class=\"sig-param\">can_delete<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">can_order<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">max_num<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">fields<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">exclude<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">widgets<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">validate_max<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">localized_fields<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">labels<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">help_texts<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">error_messages<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">min_num<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">validate_min<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">field_classes<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">absolute_max<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">can_delete_extra<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.forms.models.modelformset_factory\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回给定 <code class=\"docutils literal notranslate\">model</code> 类的 <code class=\"docutils literal notranslate\">FormSet</code> 类。</p>\n<p>参数 <code class=\"docutils literal notranslate\">model</code>、<code class=\"docutils literal notranslate\">form</code>、<code class=\"docutils literal notranslate\">fields</code>、<code class=\"docutils literal notranslate\">exclude</code>、<code class=\"docutils literal notranslate\">formfield_callback</code>、<code class=\"docutils literal notranslate\">widgets</code>、<code class=\"docutils literal notranslate\">localized_fields</code>、<code class=\"docutils literal notranslate\">labels</code>、<code class=\"docutils literal notranslate\">help_texts</code>、<code class=\"docutils literal notranslate\">error_messages</code>、<code class=\"docutils literal notranslate\">field_classes</code> 都传给 <a class=\"reference internal\" href=\"#django.forms.models.modelform_factory\" title=\"django.forms.models.modelform_factory\"><code class=\"xref py py-func docutils literal notranslate\">modelform_factory()</code></a>。</p>\n<p>Arguments <code class=\"docutils literal notranslate\">formset</code>, <code class=\"docutils literal notranslate\">extra</code>, <code class=\"docutils literal notranslate\">can_delete</code>, <code class=\"docutils literal notranslate\">can_order</code>,\n<code class=\"docutils literal notranslate\">max_num</code>, <code class=\"docutils literal notranslate\">validate_max</code>, <code class=\"docutils literal notranslate\">min_num</code>, <code class=\"docutils literal notranslate\">validate_min</code>,\n<code class=\"docutils literal notranslate\">absolute_max</code>, and <code class=\"docutils literal notranslate\">can_delete_extra</code> are passed through to\n<a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/formsets/#django.forms.formsets.formset_factory\" title=\"django.forms.formsets.formset_factory\"><code class=\"xref py py-func docutils literal notranslate\">formset_factory()</code></a>. See <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/formsets/\"><span class=\"doc\">formsets</span></a> for details.</p>\n<p>见 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/#model-formsets\"><span class=\"std std-ref\">模型表单集</span></a> 的用法示例。</p>\n<aside class=\"version-note version-changed\" data-version=\"3.2\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 3.2</p><p>增加了 <code class=\"docutils literal notranslate\">absolute_max</code> 和 <code class=\"docutils literal notranslate\">can_delete_extra</code> 参数。</p>\n</aside>\n</dd></dl>\n\n</section>\n<section id=\"inlineformset-factory\">\n<h2><code class=\"docutils literal notranslate\">inlineformset_factory</code><a class=\"heading-anchor\" href=\"#inlineformset-factory\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py function\">\n<dt class=\"sig sig-object py\" id=\"django.forms.models.inlineformset_factory\">\n<span class=\"sig-name descname\">inlineformset_factory</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">parent_model</em>, <em class=\"sig-param\">model</em>, <em class=\"sig-param\">form<span class=\"o\">=</span><span class=\"default_value\">ModelForm</span></em>, <em class=\"sig-param\">formset<span class=\"o\">=</span><span class=\"default_value\">BaseInlineFormSet</span></em>, <em class=\"sig-param\">fk_name<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">fields<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">exclude<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">extra<span class=\"o\">=</span><span class=\"default_value\">3</span></em>, <em class=\"sig-param\">can_order<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">can_delete<span class=\"o\">=</span><span class=\"default_value\">True</span></em>, <em class=\"sig-param\">max_num<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">formfield_callback<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">widgets<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">validate_max<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">localized_fields<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">labels<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">help_texts<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">error_messages<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">min_num<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">validate_min<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">field_classes<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">absolute_max<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">can_delete_extra<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.forms.models.inlineformset_factory\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>使用 <a class=\"reference internal\" href=\"#django.forms.models.modelformset_factory\" title=\"django.forms.models.modelformset_factory\"><code class=\"xref py py-func docutils literal notranslate\">modelformset_factory()</code></a> 返回一个 <code class=\"docutils literal notranslate\">InlineFormSet</code>，默认值为 <code class=\"docutils literal notranslate\">formset=</code><a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/#django.forms.models.BaseInlineFormSet\" title=\"django.forms.models.BaseInlineFormSet\"><code class=\"xref py py-class docutils literal notranslate\">BaseInlineFormSet</code></a>、<code class=\"docutils literal notranslate\">can_delete=True</code> 和 <code class=\"docutils literal notranslate\">extra=3</code>。</p>\n<p>如果你的模型有多个 <a class=\"reference internal\" href=\"/zh-hans/3.2/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 到 <code class=\"docutils literal notranslate\">parent_model</code>，你必须指定一个 <code class=\"docutils literal notranslate\">fk_name</code>。</p>\n<p>参见 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/modelforms/#inline-formsets\"><span class=\"std std-ref\">内联表单集</span></a> 的用法示例。</p>\n<aside class=\"version-note version-changed\" data-version=\"3.2\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 3.2</p><p>增加了 <code class=\"docutils literal notranslate\">absolute_max</code> 和 <code class=\"docutils literal notranslate\">can_delete_extra</code> 参数。</p>\n</aside>\n</dd></dl>\n\n</section>","rootId":"model-form-functions","toc":[{"title":"modelform_factory","anchor":"modelform-factory","children":[]},{"title":"modelformset_factory","anchor":"modelformset-factory","children":[]},{"title":"inlineformset_factory","anchor":"inlineformset-factory","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/3.2/ref/"},{"docname":"ref/forms/index","title":"表单","url":"/zh-hans/3.2/ref/forms/"}],"prev":{"docname":"ref/forms/fields","title":"表单字段","url":"/zh-hans/3.2/ref/forms/fields/"},"next":{"docname":"ref/forms/formsets","title":"表单集函数","url":"/zh-hans/3.2/ref/forms/formsets/"},"formats":{"html":"/zh-hans/3.2/ref/forms/models/","markdown":"/zh-hans/3.2/ref/forms/models.md","json":"/zh-hans/3.2/ref/forms/models.json"},"source":"https://github.com/django/django/blob/stable/3.2.x/docs/ref/forms/models.txt","official":"https://docs.djangoproject.com/zh-hans/3.2/ref/forms/models/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}