forms.submit()
Génère un bouton de soumission de formulaire.
Signature
{{ forms.submit(label, options) }}
Paramètres
label (Requis)
- Type :
string - Description : Le texte affiché sur le bouton
- Exemple :
'Envoyer'
options
- Type :
array - Description : Options de personnalisation
Options disponibles
| Option | Type | Description | Défaut |
|---|---|---|---|
class | string | Classe CSS du bouton | "" |
Exemples
Bouton simple
{{ forms.submit('Envoyer', {}) }}
Rendu HTML :
<button type="submit" class="button">Envoyer</button>
Bouton avec classe personnalisée
{{ forms.submit('Sauvegarder', { class: 'button-primary' }) }}
Bouton avec icône
{{ forms.submit('<i class="ri-send-plane-line"></i> Envoyer', {}) }}
Cas d'usage
Formulaire de contact
{% import "@elementum/macros/forms.html.twig" as forms %} <form method="post" action="/contact"> {{ forms.csrf_nonce() }} {{ forms.input('Nom', 'name', '', { required: true }) }} {{ forms.input('Email', 'email', '', 'email', { required: true }) }} {{ forms.input('Message', 'message', '', 'text', { required: true }) }} {{ forms.submit('Envoyer le message') }} </form>
Formulaire d'édition avec annulation
{% import "@elementum/macros/forms.html.twig" as forms %} <form method="post"> {{ forms.csrf_nonce() }} {{ forms.input('Titre', 'title', post.title, { required: true }) }} {{ forms.input('Contenu', 'content', post.content, 'text') }} <div class="form-actions"> {{ forms.submit('Enregistrer', { class: 'button-primary' }) }} <a href="{{ post.editLink }}" class="button">Annuler</a> </div> </form>
Boutons multiples
{% import "@elementum/macros/forms.html.twig" as forms %} <form method="post"> {{ forms.csrf_nonce() }} {# Champs du formulaire #} {{ forms.input('Nom', 'name', '', { required: true }) }} <div class="form-actions"> {{ forms.submit('Enregistrer et continuer', { class: 'button-primary' }) }} {{ forms.submit('Enregistrer et quitter', {}) }} </div> </form>
Astuces
Bouton avec attribut data
{{ forms.submit('Confirmer', { class: 'button-confirm', attributes: { 'data-confirm': 'Êtes-vous sûr de vouloir continuer ?', 'data-loading': 'Traitement en cours...' } }) }}
info
Note : La macro submit() ne supporte pas nativement les attributs personnalisés. Pour cela, utilisez un bouton HTML standard :
<button type="submit" class="button" data-confirm="Êtes-vous sûr ?">Confirmer</button>
Bouton désactivé conditionnellement
<button type="submit" class="button" {{ not canSubmit ? 'disabled' : '' }}> Envoyer </button>
Bouton avec spinner de chargement
<button type="submit" class="button button-primary" data-loading> <span class="spinner"></span> <span class="label">Envoi en cours...</span> </button>
Structure HTML
La macro génère la structure suivante :
<button type="submit" class="button [class]">[label]</button>
Bonnes pratiques
- Utiliser des labels clairs : Préférer "Enregistrer les modifications" à "OK"
- Indiquer l'action principale : Utiliser une classe distinctive (
button-primary) pour le bouton principal - Gérer les états de chargement : Prévoir un feedback visuel pendant la soumission
- Accessibilité : S'assurer que le label est suffisamment descriptif
Variantes de boutons
Selon le contexte, vous pouvez adapter le style :
{# Bouton primaire #} {{ forms.submit('Créer', { class: 'button-primary' }) }} {# Bouton secondaire #} {{ forms.submit('Annuler', { class: 'button-secondary' }) }} {# Bouton danger #} {{ forms.submit('Supprimer', { class: 'button-danger' }) }} {# Bouton outline #} {{ forms.submit('Retour', { class: 'button-outline' }) }}