Les classes mixins suivantes sont utilisées pour construire les vues d’édition de Django :
\nFormMixinLien vers cette rubrique#Une classe mixin fournissant des outils pour la création et l’affichage de formulaires.
\nClasses mixins
\n\nMéthodes et attributs
\nUn dictionnaire contenant les données initiales du formulaire.
\nLa classe de formulaire dont il faut créer une instance.
\nL’URL vers laquelle rediriger la réponse lorsque le formulaire est traité avec succès.
\nLe préfixe prefix du formulaire généré.
Récupère les données initiales pour le formulaire. Par défaut, cette méthode renvoie une copie de initial.
Récupère la classe de formulaire dont il faut créer une instance. Par défaut, form_class.
Crée une instance de form_class en utilisant get_form_kwargs(). Si form_class n’est pas fourni, c’est get_form_class() qui sera utilisée.
Construit les paramètres nommés requis pour créer une instance de formulaire.
\nLe paramètre initial est défini à get_initial(). Si la requête est de type POST ou PUT, les données de la requête (request.POST et request.FILES) seront également fournies.
Détermine le préfixe prefix du formulaire généré. Renvoie prefix par défaut.
Détermine l’URL vers laquelle rediriger lorsque le formulaire est validé avec succès. Renvoie success_url par défaut.
Redirige vers get_success_url().
Produit la réponse, en plaçant le formulaire non valide dans le contexte.
\nAppelle get_form() et ajoute le résultat aux données de contexte sous le nom form.
ModelFormMixinLien vers cette rubrique#Une classe mixin de formulaire qui fonctionne avec les ModelForms, plutôt qu’avec des formulaires autonomes.
Comme il s’agit d’une sous-classe de SingleObjectMixin, les instances de cette classe mixin ont accès aux attributs model et queryset décrivant le type d’objet que le formulaire ModelForm manipule.
Si vous définissez à la fois les attributs fields et form_class, une exception ImproperlyConfigured est générée.
Classes mixins
\n\nMéthodes et attributs
\nUne classe de modèle. Peut être fournie explicitement, sinon elle sera déterminée en examinant self.object ou queryset.
Une liste de noms de champs. Cet attribut est interprété de la même manière que l’attribut Meta.fields de la classe ModelForm.
Il s’agit d’un attribut obligatoire si vous générez automatiquement la classe de formulaire (par ex. en utilisant model). En l’absence de cet attribut, une exception ImproperlyConfigured est générée.
L’URL vers laquelle rediriger la réponse lorsque le formulaire est traité avec succès.
\nsuccess_url peut contenir des chaînes de format de type dictionnaire, qui seront substituées en utilisant les attributs de champs de l’objet. Par exemple, vous pourriez utiliser success_url="/polls/{slug}/" pour rediriger vers une URL composée à partir du champ slug d’un modèle.
Récupère la classe de formulaire dont il faudra créer une instance. Si form_class est définie, c’est cette classe qui sera utilisée. Sinon, une instance de formulaire ModelForm sera créée en se basant sur le modèle associé au contenu de queryset ou de model, en fonction de l’attribut qui est défini.
Ajoute l’instance actuelle (self.object) au contenu standard de get_form_kwargs().
Détermine l’URL vers laquelle rediriger lorsque le formulaire est validé avec succès. Renvoie django.views.generic.edit.ModelFormMixin.success_url s’il est défini ; sinon, essaie d’employer la valeur get_absolute_url() de l’objet.
Enregistre l’instance de formulaire, définit l’objet en cours de la vue et redirige vers get_success_url().
Produit la réponse, en plaçant le formulaire non valide dans le contexte.
\nProcessFormViewLien vers cette rubrique#Une classe mixin qui fournit la gestion de flux habituelle des requêtes HTTP GET et POST.
\n\nÉtend
\n\nMéthodes et attributs
\nProduit une réponse en utilisant le contexte créé avec get_context_data().
Construit un formulaire, vérifie la validité du formulaire et le traite en conséquence.
\nL’action PUT est également gérée, mais ne fait que transmettre tous les paramètres à post().
DeletionMixinLien vers cette rubrique#Permet la gestion de l’action http DELETE.
Méthodes et attributs
\nL’URL vers laquelle rediriger lorsque l’objet concerné a été supprimé avec succès.
\nsuccess_url peut contenir des chaînes de format de type dictionnaire, qui seront substituées en utilisant les attributs de champs de l’objet. Par exemple, vous pourriez utiliser success_url="/parent/{parent_id}/" pour rediriger vers une URL composée à partir du champ parent_id d’un modèle.
Récupère l’objet cible et appelle sa méthode delete(), puis redirige vers l’URL de succès.
Renvoie l’URL vers laquelle rediriger lorsque l’objet concerné a été supprimé avec succès. Renvoie success_url par défaut.