Classes mixins d’éditionLien vers cette rubrique#

Une classe mixin fournissant des outils pour la création et l’affichage de formulaires.

Classes mixins

• django.views.generic.base.ContextMixin

Méthodes et attributs

initialLien vers cette définition#

Un dictionnaire contenant les données initiales du formulaire.

form_classLien vers cette définition#

La classe de formulaire dont il faut créer une instance.

success_urlLien vers cette définition#

L’URL vers laquelle rediriger la réponse lorsque le formulaire est traité avec succès.

prefixLien vers cette définition#

Le préfixe prefix du formulaire généré.

get_initial()Lien vers cette définition#

Récupère les données initiales pour le formulaire. Par défaut, cette méthode renvoie une copie de initial.

get_form_class()Lien vers cette définition#

Récupère la classe de formulaire dont il faut créer une instance. Par défaut, form_class.

get_form(form_class=None)Lien vers cette définition#

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.

get_form_kwargs()Lien vers cette définition#

Construit les paramètres nommés requis pour créer une instance de formulaire.

Le 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.

get_prefix()Lien vers cette définition#

Détermine le préfixe prefix du formulaire généré. Renvoie prefix par défaut.

get_success_url()Lien vers cette définition#

Détermine l’URL vers laquelle rediriger lorsque le formulaire est validé avec succès. Renvoie success_url par défaut.

form_valid(form)Lien vers cette définition#

Redirige vers get_success_url().

form_invalid(form)Lien vers cette définition#

Produit la réponse, en plaçant le formulaire non valide dans le contexte.

get_context_data(**kwargs)Lien vers cette définition#

Appelle get_form() et ajoute le résultat aux données de contexte sous le nom form.

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

• django.views.generic.edit.FormMixin

• django.views.generic.detail.SingleObjectMixin

Méthodes et attributs

modelLien vers cette définition#

Une classe de modèle. Peut être fournie explicitement, sinon elle sera déterminée en examinant self.object ou queryset.

fieldsLien vers cette définition#

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.

success_urlLien vers cette définition#

L’URL vers laquelle rediriger la réponse lorsque le formulaire est traité avec succès.

success_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.

get_form_class()Lien vers cette définition#

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.

get_form_kwargs()Lien vers cette définition#

Ajoute l’instance actuelle (self.object) au contenu standard de get_form_kwargs().

get_success_url()Lien vers cette définition#

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.

form_valid(form)Lien vers cette définition#

Enregistre l’instance de formulaire, définit l’objet en cours de la vue et redirige vers get_success_url().

form_invalid(form)Lien vers cette définition#

Produit la réponse, en plaçant le formulaire non valide dans le contexte.

Une classe mixin qui fournit la gestion de flux habituelle des requêtes HTTP GET et POST.

Étend

• django.views.generic.base.View

Méthodes et attributs

get(request, *args, **kwargs)Lien vers cette définition#

Produit une réponse en utilisant le contexte créé avec get_context_data().

post(request, *args, **kwargs)Lien vers cette définition#

Construit un formulaire, vérifie la validité du formulaire et le traite en conséquence.

put(*args, **kwargs)Lien vers cette définition#

L’action PUT est également gérée, mais ne fait que transmettre tous les paramètres à post().

Permet la gestion de l’action HTTP DELETE.

Méthodes et attributs

success_urlLien vers cette définition#

L’URL vers laquelle rediriger lorsque l’objet concerné a été supprimé avec succès.

success_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.

delete(request, *args, **kwargs)Lien vers cette définition#

Récupère l’objet cible et appelle sa méthode delete(), puis redirige vers l’URL de succès.

get_success_url()Lien vers cette définition#

Renvoie l’URL vers laquelle rediriger lorsque l’objet concerné a été supprimé avec succès. Renvoie success_url par défaut.