模型表单函数 — Django 文档
模型表单函数
模型表单 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 factory function 示例用法。
您必须通过关键字参数
fields
或exclude
或表单内部Meta
类上的相应属性明确提供字段列表。 有关详细信息,请参阅 选择要使用的字段 。 省略要使用的字段的任何定义将导致 ImproperlyConfigured 异常。
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
、can_delete
、can_order
、max_num
、validate_max
、min_num
、和validate_min
被传递到 formset_factory()。 有关详细信息,请参阅 表单集 。有关示例用法,请参阅 模型表单集 。
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
.X1如果您的型号有多个 ForeignKey 到
parent_model
,则必须指定一个fk_name
。请参阅 内联表单集 以获取示例用法。