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 angivna modellen. Du kan valfritt skicka ett form-argument som ska användas som utgångspunkt för att konstruera ModelForm.

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 argumentet fields.

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 eller exclude, eller motsvarande attribut på formulärets inre Meta-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 ett ImproperlyConfigured 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 angivna model-klassen.

Argumenten model, form, fields, exclude, formfield_callback, widgets, localized_fields, labels, help_texts, error_messages och field_classes skickas alla till modelform_factory().

Argumenten formset, extra, can_delete, can_order, max_num, validate_max, min_num, validate_min, absolute_max, can_delete_extra och renderer skickas till formset_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 av modelformset_factory() med standardvärdena formset=BaseInlineFormSet, can_delete=True och extra=3.

Om din modell har mer än en ForeignKey till parent_model, måste du ange ett fk_name.

Se Inline-formulär för exempel på användning.