Aller au contenu principal
Version: Next

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​

OptionTypeDescriptionDéfaut
classstringClasse 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​

  1. Utiliser des labels clairs : Préférer "Enregistrer les modifications" à "OK"
  2. Indiquer l'action principale : Utiliser une classe distinctive (button-primary) pour le bouton principal
  3. Gérer les états de chargement : Prévoir un feedback visuel pendant la soumission
  4. 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' }) }}

Voir aussi​