Django Framework : Travailler avec des formulaires

À propos de ce document

Ce document fournit une introduction aux fonctions Django de gestion de formulaire. Pour plus de détails sur des domaines plus spécifiques de l’API Formulaires, voir The Forms API, Form fields, et Form and field validation.

django.forms est la biliothèque Django de gestion de formulaires.

Bien qu’il soit possible de traiter la soumission des formulaires en n’utilisant que la classe HttpRequest de Django, utiliser la bibliothèque de formulaires permet la prise en charge de nombre d’opérations relatives aux formulaires. En l’utilisant, vous pouvez:

1. Afficher un formulaire HTML avec des widgets générés automatiquement.
2. Vérifier les données envoyées, grâce à un ensemble de règles de validation.
3. Ré-afficher une formulaire en cas d’erreurs de validation.
4. Convertir les données du formulaire envoyé en types de données Python pertinentes.

Aperçu¶

La bibliothèque couvre ces concepts:

Widget

Une classe qui correspond à un widget de formulaire HTML, par exemple, <input type="text"> ou <textarea>. Gère le rendu du widget en HTML.

Field

Une classe responsable de la validation. Par exemple, un EmailField s’assure qu’on indique bien une adresse e-mail valide.

Form

Une collection de champs qui savent se valider eux-mêmes et s’afficher sous forme HTML.

Form Media

Les ressources CSS et JavaScript requises pour produire le formulaire.

La bibliothèque est découplée des autres composants Django, comme la couche de base de données, les vues et les templates. Elle n’est liée qu’aux paramètres Django, à quelques fonctions d’assistance django.utils et aux hooks d’internationalisation de Django (mais vous n’êtes pas obligé d’utiliser les fonctionnalités d’internationalisation pour utiliser cette bibliothèque).

---

La traduction complète en français se trouve sur DjangoSpirit.org.