Formulaires – Documentation

Initialisation des formulaires

Les formulaires sont construits en se basant sur la classe VillageBaseForm, par exemple :

# votre_app/forms.py

from village.forms import VillageBaseForm


class ExampleForm(VillageBaseForm):
    # basic fields
    user_name = forms.CharField(label="Nom d’utilisateur", max_length=100)

    user_email = forms.EmailField(
        label="Adresse électronique",
        help_text="Format attendu : prenom.nom@domaine.fr",
        required=False,
    )

Il est possible de multi-classer :

class AuthorCreateForm(ModelForm, VillageBaseForm):

Classes CSS

Le formulaire ajoute la ou les classes appropriées (village-input, village-select, etc.) en fonction du type de champ, mais uniquement si une classe n’a pas déjà été ajoutée.

Si c’est le cas, il faut soit forcer manuellement les classes à utiliser :

    password = forms.CharField(
        label="Mot de passe", widget=forms.PasswordInput(
            "autocomplete": "current-password",
            "required": True,
            "class": "village-input my-custom-class"
        )
    )

soit les ajouter dans la méthode init du formulaire (en faisant attention à laisser une espace au début) :

class AuthorCreateForm(ModelForm, VillageBaseForm):

# [...]

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.fields["password"].widget.attrs["class"] += " my custom class"