Modellform Funktioner¶
API-referens för modellformulär. För introduktionsmaterial om modellformulär, se Skapa formulär från modeller ämnesguide.
modellform_fabrik
¶
- 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]¶
Returnerar en
ModelForm
-klass för den angivnamodellen
. Du kan valfritt skicka ettform
-argument som ska användas som utgångspunkt för att konstrueraModelForm
.fields
är en valfri lista med fältnamn. Om den anges kommer endast de namngivna fälten att ingå i de returnerade fälten.exclude
är en valfri lista med fältnamn. Om den anges kommer de angivna fälten att uteslutas från de returnerade fälten, även om de finns listade i argumentetfields
.formfield_callback
är en callable som tar ett modellfält och returnerar ett formulärfält.widgets
är en ordbok med namn på modellfält som mappas till en widget.localized_fields
är en lista med namn på fält som ska lokaliseras.labels
är en ordbok med namn på modellfält som mappas till en etikett.help_texts
är en ordbok med namn på modellfält som mappats till en hjälptext.error_messages
är en ordbok med namn på modellfält som mappas till en ordbok med felmeddelanden.field_classes
är en ordbok med namn på modellfält som mappas till en formulärfältklass.Se ModelForm fabriksfunktion för exempel på användning.
Du måste ange listan med fält explicit, antingen via nyckelordsargumenten
fields
ellerexclude
, eller motsvarande attribut på formulärets inreMeta
-klass. Se Välja de fält som ska användas för mer information. Om du utelämnar någon definition av de fält som ska användas kommer det att resultera i ettImproperlyConfigured
undantag.
modellformset_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]¶
Returnerar en
FormSet
-klass för den angivnamodel
-klassen.Argumenten
model
,form
,fields
,exclude
,formfield_callback
,widgets
,localized_fields
,labels
,help_texts
,error_messages
ochfield_classes
skickas alla tillmodelform_factory()
.Argumenten
formset
,extra
,can_delete
,can_order
,max_num
,validate_max
,min_num
,validate_min
,absolute_max
,can_delete_extra
ochrenderer
skickas tillformset_factory()
. Se formsets för mer information.Argumentet
edit_only
gör det möjligt att :ref:``förhindra att nya objekt skapas <model-formsets-edit-only>`.Se Modellformsatser för exempel på användning.
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]¶
Returnerar ett
InlineFormSet
med hjälp avmodelformset_factory()
med standardvärdenaformset=
BaseInlineFormSet
,can_delete=True
ochextra=3
.Om din modell har mer än en
ForeignKey
tillparent_model
, måste du ange ettfk_name
.Se Inline-formulär för exempel på användning.