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
| Macro | Description |
|---|---|
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 :
| Option | Type | Description |
|---|---|---|
class | string | Classe CSS du conteneur |
input_class / select_class | string | Classe CSS du champ |
help_text | string | Texte d'aide affiché sous le champ |
required | bool | Rend le champ obligatoire |
attributes | array | Attributs HTML personnalisés |