Model Form の API リファレンスです。モデルフォームについての入門的な内容については、モデルからフォームを作成する を参照してください。
modelform_factory¶与えられた model に対して ModelForm を返します。必要に応じて form 引数を渡すことで、ModelForm を構築する開始地点として使うことができます。
fields は、フィールド名の省略可能なリストです。提供された場合、指定されたフィールドだけが、返されるフィールドの中に含まれるようになります。
exclude は、フィールド名の省略可能なリストです。提供された場合、fields 引数の中に指定されていたとしても、指定されたフィールドが返されるフィールドから除かれます。
formfield_callback は、モデルフィールドを取ってフォームフィールドを返す callable です。
widgets は、ウィジェットにマッピングされたモデルフィールド名のディクショナリです。
localized_fields は、ローカライズされるべきフィールドの名前のリストです。
labels は、ラベルにマッピングされたモデルフィールド名のディクショナリです。
help_texts は、ヘルプテキストにマッピングされたモデルフィールド名のディクショナリです。
error_messages は、エラーメッセージにマッピングされたモデルフィールド名のディクショナリです。
field_classes は、フォームフィールドクラスにマッピングされたモデルフィールド名のディクショナリです。
使用例は ModelForm factory 関数 を参照してください。
フィールドのリストは、キーワード引数 fields や exclude、もしくはフォームの内部の Meta クラスで対応する属性を使って、明示的に提供する必要があります。詳しくは 使うフィールドを選択する を参照してください。使うフィールドの定義を省略すると、ImproperlyConfigured 例外を引き起こします。
modelformset_factory¶与えられた model クラスに対して、FormSet クラスを返します。
引数 model、form、fields、exclude、formfield_callback、widgets、localized_fields、labels、help_texts、error_messages、field_classes は、すべて modelform_factory() を通して引き渡されます。
引数 formset, extra, can_delete, can_order, max_num, validate_max, min_num, validate_min, absolute_max, can_delete_extra, および renderer は formset_factory() にそのまま渡されます。詳細については フォームセット を参照してください。
edit_only 引数は 新しいオブジェクトの作成を防ぐ のに使用できます。
使用例は モデルのフォームセット を参照してください。
inlineformset_factory¶formset=BaseInlineFormSet、can_delete=True、extra=3 をデフォルトとする、 modelformset_factory() を使った InlineFormSet を返します。
モデルが parent_model に複数の ForeignKey を持つ場合, fk_name を指定する必要があります。
使用例は インラインフォームセット を参照してください。
7月 02, 2025