模型表单函数¶
模型表单 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)[source]¶
为给定的
model返回一个ModelForm类。您可以选择传递一个form参数作为构建ModelForm的起点。fields是一个可选的字段名称列表。如果提供，则仅返回指定的字段包含在返回的字段中。exclude是一个可选的字段名称列表。如果提供，则即使在fields参数中列出，也会从返回的字段中排除指定的字段。formfield_callback是一个可调用对象，它接受一个模型字段并返回一个表单字段。widgets是一个模型字段名称映射到小部件的字典。localized_fields是要本地化的字段名称列表。labels是一个模型字段名称映射到标签的字典。help_texts是一个模型字段名称映射到帮助文本的字典。error_messages是一个模型字段名称映射到错误消息字典的字典。field_classes是一个模型字段名称映射到表单字段类的字典。有关示例用法，请参阅ModelForm 工厂函数。
您必须通过关键字参数
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, absolute_max=None, can_delete_extra=True, renderer=None, edit_only=False)[source]¶
为给定的
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¶
- 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, absolute_max=None, can_delete_extra=True, renderer=None, edit_only=False)[source]¶
使用
modelformset_factory()并设置默认值为formset=BaseInlineFormSet、can_delete=True和extra=3，返回一个InlineFormSet。如果您的模型有多个指向
parent_model的ForeignKey，则必须指定fk_name。有关示例用法，请参见 内联表单集。
