Fonctions de formulaires de modèles¶
La référence de l’API des formulaires de modèles. Pour du contenu d’initiation au sujet des formulaires de modèles, consultez le guide thématique Création de formulaires à partir de modèles.
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]¶ Renvoie une classe
ModelFormpour le modèle donné. Le paramètre facultatifformpermet d’indiquer une classe de base pour la construction duModelForm.fieldsest une liste facultative de noms de champs. Quand elle est présente, seuls les champs de cette liste seront inclus dans le formulaire renvoyé.excludeest une liste facultative de noms de champs. Quand elle est présente, les champs de cette liste sont exclus du formulaire renvoyé, même s’ils figurent dans le paramètrefields.formfield_callbackest un objet exécutable acceptant un champ de modèle et renvoyant un champ de formulaire.widgetsest un dictionnaire faisant correspondre des noms de champs de modèle à des composants de formulaires.localized_fieldsest une liste de noms de champs devant être régionalisés.labelsest un dictionnaire faisant correspondre des noms de champs de modèle à des étiquettes.help_textsest un dictionnaire faisant correspondre des noms de champs de modèle à des textes d’aide.error_messagesest un dictionnaire faisant correspondre des noms de champs de modèle à des dictionnaires de messages d’erreur.field_classesest un dictionnaire faisant correspondre des noms de champs de modèle à une classe de champ de formulaire.Voir Fonction de fabrique de ModelForm pour des exemples d’utilisation.
Vous devez définir explicitement la liste des champs, soit par les paramètres nommés
fieldsouexclude, soit par les attributs de même nom de la classe interne de formulaireMeta. Voir Sélection des champs à utiliser pour plus d’informations. En omettant toute définition de champs à utiliser, cela aboutira à une exceptionImproperlyConfigured.
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)[source]¶ Renvoie une classe
FormSetpour la classe de modèle donnée.Les paramètres
model,form,fields,exclude,formfield_callback,widgets,localized_fields,labels,help_texts,error_messagesetfield_classessont tous transmis àmodelform_factory().Les paramètres
formset,extra,max_num,can_order,can_deleteetvalidate_maxsont transmis àformset_factory(). Voir Jeux de formulaires pour plus de détails.Voir Formulaires groupés de modèles pour des exemples d’utilisation.
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)[source]¶ Renvoie un
InlineFormSeten utilisantmodelformset_factory()avec les valeurs par défautformset=BaseInlineFormSet,can_delete=Trueetextra=3.Si le modèle possède plus d’une clé étrangère
ForeignKeyversparent_model, vous devez renseigner le paramètrefk_name.Voir Sous-formulaires groupés pour des exemples d’utilisation.