{"title":"モデルフォーム関数","version":"4.0","locale":"ja","docname":"ref/forms/models","url":"/ja/4.0/ref/forms/models/","canonical":"https://djangodocs.dev/ja/4.0/ref/forms/models/","summary":"Model Form の API リファレンスです。モデルフォームについての導入用の資料は、モデルからフォームを作成するを参照してください。","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>Model Form の API リファレンスです。モデルフォームについての導入用の資料は、<a class=\"reference internal\" href=\"/ja/4.0/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=\"/ja/4.0/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> は、モデルフィールドを取ってフォームフィールドを返す callable です。</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=\"/ja/4.0/topics/forms/modelforms/#modelforms-factory\"><span class=\"std std-ref\">ModelForm factory 関数</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=\"/ja/4.0/topics/forms/modelforms/#modelforms-selecting-fields\"><span class=\"std std-ref\">使うフィールドを選択する</span></a> を参照してください。使うフィールドの定義を省略すると、<a class=\"reference internal\" href=\"/ja/4.0/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>, <em class=\"sig-param\">renderer<span class=\"o\">=</span><span class=\"default_value\">None</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>, <code class=\"docutils literal notranslate\">can_delete_extra</code>, and <code class=\"docutils literal notranslate\">renderer</code> are passed\nthrough to <a class=\"reference internal\" href=\"/ja/4.0/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\n<a class=\"reference internal\" href=\"/ja/4.0/topics/forms/formsets/\"><span class=\"doc\">formsets</span></a> for details.</p>\n<p>使用例は <a class=\"reference internal\" href=\"/ja/4.0/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>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<aside class=\"version-note version-changed\" data-version=\"4.0\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 4.0</p><p>The <code class=\"docutils literal notranslate\">renderer</code> argument was 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 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>, <em class=\"sig-param\">renderer<span class=\"o\">=</span><span class=\"default_value\">None</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><code class=\"docutils literal notranslate\">formset=</code><a class=\"reference internal\" href=\"/ja/4.0/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> をデフォルトとする、 <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> を返します。</p>\n<p>モデルが <code class=\"docutils literal notranslate\">parent_model</code> に複数の <a class=\"reference internal\" href=\"/ja/4.0/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\">fk_name</code> を指定する必要があります。</p>\n<p>使用例は <a class=\"reference internal\" href=\"/ja/4.0/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>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<aside class=\"version-note version-changed\" data-version=\"4.0\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 4.0</p><p>The <code class=\"docutils literal notranslate\">renderer</code> argument was 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":"API Reference","url":"/ja/4.0/ref/"},{"docname":"ref/forms/index","title":"フォーム","url":"/ja/4.0/ref/forms/"}],"prev":{"docname":"ref/forms/fields","title":"Form fields","url":"/ja/4.0/ref/forms/fields/"},"next":{"docname":"ref/forms/formsets","title":"Formset Functions","url":"/ja/4.0/ref/forms/formsets/"},"formats":{"html":"/ja/4.0/ref/forms/models/","markdown":"/ja/4.0/ref/forms/models.md","json":"/ja/4.0/ref/forms/models.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/ref/forms/models.txt","official":"https://docs.djangoproject.com/ja/4.0/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"]}