模型窗体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 .
见 内联窗体集 例如用法。
5月 28, 2025