模型窗体API引用。有关模型表单的介绍性材料,请参见 从模型创建表单 主题指南。
modelform_factory
¶返回A ModelForm
给定的类 model
. 您可以选择通过 form
用作构造 ModelForm
.
fields
是字段名称的可选列表。如果提供,则返回的字段中只包含命名字段。
exclude
是字段名称的可选列表。如果提供,则命名字段将从返回的字段中排除,即使它们列在 fields
参数。
formfield_callback
是接受模型字段并返回窗体字段的可调用项。
widgets
是映射到小部件的模型字段名称的字典。
localized_fields
是应本地化的字段名称列表。
labels
是映射到标签的模型字段名称的字典。
help_texts
是映射到帮助文本的模型字段名称字典。
error_messages
是映射到错误消息字典的模型字段名称字典。
field_classes
是映射到窗体字段类的模型字段名称的字典。
见 ModelForm工厂函数 例如用法。
必须通过关键字参数显式提供字段列表 fields
或 exclude
或窗体内部的相应属性 Meta
类。见 选择要使用的字段 更多信息。省略任何要使用的字段定义将导致 ImproperlyConfigured
例外。
modelformset_factory
¶返回A FormSet
给定的类 model
类。
参数 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()
。看见 formsets 了解更多细节。
这个 edit_only
论据允许 preventing new objects creation 。
见 模型窗体集 例如用法。
inlineformset_factory
¶返回一个 InlineFormSet
使用 modelformset_factory()
默认值为 formset=
:类:~django.forms.models.baseinlineformset, can_delete=True
和 extra=3
.
如果您的模型有多个 ForeignKey
到 parent_model
,必须指定 fk_name
.
见 内联窗体集 例如用法。
7月 22, 2024