{"title":"Model Form Functions","version":"3.2","locale":"pt-br","docname":"ref/forms/models","url":"/pt-br/3.2/ref/forms/models/","canonical":"https://djangodocs.dev/pt-br/3.2/ref/forms/models/","summary":"Model Form API reference. For introductory material about model forms, see the Creating forms from models topic guide.","html":"<h1>Model Form Functions<a class=\"heading-anchor\" href=\"#model-form-functions\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Model Form API reference. For introductory material about model forms, see the\n<a class=\"reference internal\" href=\"/pt-br/3.2/topics/forms/modelforms/\"><span class=\"doc\">Creating forms from models</span></a> topic guide.</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 para este cabeçalho</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 para esta definição</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Returns a <a class=\"reference internal\" href=\"/pt-br/3.2/topics/forms/modelforms/#django.forms.ModelForm\" title=\"django.forms.ModelForm\"><code class=\"xref py py-class docutils literal notranslate\">ModelForm</code></a> class for the given <code class=\"docutils literal notranslate\">model</code>.\nYou can optionally pass a <code class=\"docutils literal notranslate\">form</code> argument to use as a starting point for\nconstructing the <code class=\"docutils literal notranslate\">ModelForm</code>.</p>\n<p><code class=\"docutils literal notranslate\">fields</code> is an optional list of field names. If provided, only the named\nfields will be included in the returned fields.</p>\n<p><code class=\"docutils literal notranslate\">exclude</code> is an optional list of field names. If provided, the named\nfields will be excluded from the returned fields, even if they are listed\nin the <code class=\"docutils literal notranslate\">fields</code> argument.</p>\n<p><code class=\"docutils literal notranslate\">formfield_callback</code> is a callable that takes a model field and returns\na form field.</p>\n<p><code class=\"docutils literal notranslate\">widgets</code> is a dictionary of model field names mapped to a widget.</p>\n<p><code class=\"docutils literal notranslate\">localized_fields</code> is a list of names of fields which should be localized.</p>\n<p><code class=\"docutils literal notranslate\">labels</code> is a dictionary of model field names mapped to a label.</p>\n<p><code class=\"docutils literal notranslate\">help_texts</code> is a dictionary of model field names mapped to a help text.</p>\n<p><code class=\"docutils literal notranslate\">error_messages</code> is a dictionary of model field names mapped to a\ndictionary of error messages.</p>\n<p><code class=\"docutils literal notranslate\">field_classes</code> is a dictionary of model field names mapped to a form\nfield class.</p>\n<p>See <a class=\"reference internal\" href=\"/pt-br/3.2/topics/forms/modelforms/#modelforms-factory\"><span class=\"std std-ref\">ModelForm factory function</span></a> for example usage.</p>\n<p>You must provide the list of fields explicitly, either via keyword arguments\n<code class=\"docutils literal notranslate\">fields</code> or <code class=\"docutils literal notranslate\">exclude</code>, or the corresponding attributes on the form’s\ninner <code class=\"docutils literal notranslate\">Meta</code> class. See <a class=\"reference internal\" href=\"/pt-br/3.2/topics/forms/modelforms/#modelforms-selecting-fields\"><span class=\"std std-ref\">Selecting the fields to use</span></a> for more\ninformation. Omitting any definition of the fields to use will result in\nan <a class=\"reference internal\" href=\"/pt-br/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> exception.</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 para este cabeçalho</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 para esta definição</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Returns a <code class=\"docutils literal notranslate\">FormSet</code> class for the given <code class=\"docutils literal notranslate\">model</code> class.</p>\n<p>Arguments <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>,\n<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>,\n<code class=\"docutils literal notranslate\">help_texts</code>, <code class=\"docutils literal notranslate\">error_messages</code>, and <code class=\"docutils literal notranslate\">field_classes</code> are all passed\nthrough to <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=\"/pt-br/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=\"/pt-br/3.2/topics/forms/formsets/\"><span class=\"doc\">formsets</span></a> for details.</p>\n<p>Veja <a class=\"reference internal\" href=\"/pt-br/3.2/topics/forms/modelforms/#model-formsets\"><span class=\"std std-ref\">Model formsets</span></a> para um exemplo de uso.</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>The <code class=\"docutils literal notranslate\">absolute_max</code> and <code class=\"docutils literal notranslate\">can_delete_extra</code> arguments were added.</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 para este cabeçalho</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 para esta definição</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Returns an <code class=\"docutils literal notranslate\">InlineFormSet</code> using <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> with\ndefaults of <code class=\"docutils literal notranslate\">formset=</code><a class=\"reference internal\" href=\"/pt-br/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>,\n<code class=\"docutils literal notranslate\">can_delete=True</code>, and <code class=\"docutils literal notranslate\">extra=3</code>.</p>\n<p>If your model has more than one <a class=\"reference internal\" href=\"/pt-br/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> to\nthe <code class=\"docutils literal notranslate\">parent_model</code>, you must specify a <code class=\"docutils literal notranslate\">fk_name</code>.</p>\n<p>Vjea <a class=\"reference internal\" href=\"/pt-br/3.2/topics/forms/modelforms/#inline-formsets\"><span class=\"std std-ref\">Inline formsets</span></a> para exemplo de uso.</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>The <code class=\"docutils literal notranslate\">absolute_max</code> and <code class=\"docutils literal notranslate\">can_delete_extra</code> arguments were added.</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":"Referência da API","url":"/pt-br/3.2/ref/"},{"docname":"ref/forms/index","title":"Formulários","url":"/pt-br/3.2/ref/forms/"}],"prev":{"docname":"ref/forms/fields","title":"Form fields","url":"/pt-br/3.2/ref/forms/fields/"},"next":{"docname":"ref/forms/formsets","title":"Formset Functions","url":"/pt-br/3.2/ref/forms/formsets/"},"formats":{"html":"/pt-br/3.2/ref/forms/models/","markdown":"/pt-br/3.2/ref/forms/models.md","json":"/pt-br/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/pt-br/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","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}