Aller au contenu principal
Version: Next

Macros de formulaire

Elementum fournit un ensemble de macros Twig pour faciliter la création de formulaires. Ces macros sont disponibles dans le fichier @elementum/macros/forms.html.twig.

Importer les macros​

Avant d'utiliser les macros, importez-les dans vos templates Twig :

{% import "@elementum/macros/forms.html.twig" as forms %}

Macros disponibles​

MacroDescription
forms.input()Champ input texte
forms.select()Champ select avec options
forms.checkbox()Case à cocher
forms.submit()Bouton de soumission
forms.csrf_nonce()Champ nonce WordPress
forms.media()Sélecteur de médias WordPress

Exemple complet​

{% import "@elementum/macros/forms.html.twig" as forms %}

<form method="post">
    {{ forms.csrf_nonce() }}

    {{ forms.input('Nom', 'name', '', { required: true }) }}

    {{ forms.input('Email', 'email', '', { type: 'email', required: true }) }}

    {{ forms.select('Pays', 'country', {
        'fr': 'France',
        'be': 'Belgique',
        'ch': 'Suisse'
    }, 'fr', {}) }}

    {{ forms.checkbox("J'accepte les CGU", 'cgu', false, {}) }}

    {{ forms.submit('Envoyer') }}
</form>

Options communes​

La plupart des macros acceptent un tableau d'options en dernier paramètre. Voici les options les plus courantes :

OptionTypeDescription
classstringClasse CSS du conteneur
input_class / select_classstringClasse CSS du champ
help_textstringTexte d'aide affiché sous le champ
requiredboolRend le champ obligatoire
attributesarrayAttributs HTML personnalisés

Voir aussi​