モデルフォーム関数
モデルフォームAPIリファレンス。 モデルフォームの紹介資料については、モデルからのフォームの作成トピックガイドを参照してください。
modelform_factory
- modelform_factory(model, form=ModelForm, fields=None, exclude=None, formfield_callback=None, widgets=None, localized_fields=None, labels=None, help_texts=None, error_messages=None, field_classes=None)
指定された
model
の ModelForm クラスを返します。 オプションで、form
引数を渡して、ModelForm
を作成するための開始点として使用できます。fields
は、フィールド名のオプションのリストです。 指定されている場合、指定されたフィールドのみが返されるフィールドに含まれます。exclude
は、フィールド名のオプションのリストです。 指定されている場合、名前付きフィールドは、fields
引数にリストされている場合でも、返されるフィールドから除外されます。formfield_callback
は、モデルフィールドを受け取り、フォームフィールドを返す呼び出し可能オブジェクトです。widgets
は、ウィジェットにマップされたモデルフィールド名の辞書です。localized_fields
は、ローカライズする必要があるフィールドの名前のリストです。labels
は、ラベルにマップされたモデルフィールド名の辞書です。help_texts
は、ヘルプテキストにマップされたモデルフィールド名の辞書です。error_messages
は、エラーメッセージの辞書にマップされたモデルフィールド名の辞書です。field_classes
は、フォームフィールドクラスにマップされたモデルフィールド名の辞書です。使用例については、 ModelFormファクトリ関数を参照してください。
フィールドのリストは、キーワード引数
fields
またはexclude
、またはフォームの内部Meta
クラスの対応する属性を介して明示的に指定する必要があります。 詳細については、使用するフィールドの選択を参照してください。 使用するフィールドの定義を省略すると、 ImpproperlyConfigured 例外が発生します。
modelformset_factory
- modelformset_factory(model, form=ModelForm, formfield_callback=None, formset=BaseModelFormSet, extra=1, can_delete=False, can_order=False, max_num=None, fields=None, exclude=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None)
指定された
model
クラスのFormSet
クラスを返します。引数
model
、form
、fields
、exclude
、formfield_callback
、widgets
、localized_fields
、labels
、help_texts
、error_messages
、およびfield_classes
はすべて modelform_factory()に渡されます。引数
formset
、extra
、max_num
、can_order
、can_delete
、validate_max
は formset_factoryに渡されます()。 詳細については、 formsets を参照してください。使用例については、モデルフォームセットを参照してください。
inlineformset_factory
- inlineformset_factory(parent_model, model, form=ModelForm, formset=BaseInlineFormSet, fk_name=None, fields=None, exclude=None, extra=3, can_order=False, can_delete=True, max_num=None, formfield_callback=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None)
modelformset_factory()を使用して
InlineFormSet
を返します。デフォルトは、formset=
BaseInlineFormSet 、can_delete=True
、およびextra=3
です。モデルに ForeignKey から
parent_model
への複数の ForeignKey がある場合は、fk_name
を指定する必要があります。使用例については、インラインフォームセットを参照してください。