Aller au contenu principal
Version: Next

forms.input()

Génère un champ input HTML avec label, classes et options de personnalisation.

Signature​

{{ forms.input(label, name, value, type, options) }}

Paramètres​

label​

  • Type : string
  • Description : Le label affiché au-dessus du champ
  • Exemple : 'Nom complet'

name (Requis)​

  • Type : string
  • Description : Le nom du champ (attribut name)
  • Exemple : 'username'

value​

  • Type : string
  • Description : La valeur pré-remplie du champ
  • Défaut : ""
  • Exemple : 'Jean Dupont'

type​

  • Type : string
  • Description : Le type d'input HTML
  • Défaut : "text"
  • Valeurs possibles : text, email, password, number, tel, url, date, etc.
  • Exemple : 'email'

options​

  • Type : array
  • Description : Options de personnalisation

Options disponibles​

OptionTypeDescriptionDéfaut
classstringClasse CSS du conteneur""
input_classstringClasse CSS de l'input""
placeholderstringTexte de remplacement-
requiredboolRend le champ obligatoirefalse
checkedboolCoche l'input (pour type="checkbox")false
attributesarrayAttributs HTML personnalisés[]
help_textstringTexte d'aide sous le champ""

Exemples​

Input texte simple​

{{ forms.input('Nom', 'name', '', {}) }}

Rendu HTML :

<div class="input-group">
    <label for="name">Nom</label>
    <input type="text" id="name" name="name" value="" class="form-control" />
</div>

Input email avec placeholder​

{{ forms.input('Email', 'email', '', 'email', {
    placeholder: 'votre@email.com'
}) }}

Input avec texte d'aide​

{{ forms.input('Mot de passe', 'password', '', 'password', {
    help_text: 'Minimum 8 caractères',
    required: true
}) }}

Input avec attributs personnalisés​

{{ forms.input('Téléphone', 'phone', '', 'tel', {
    attributes: {
        'data-mask': '(00) 00-00-00-00',
        'autocomplete': 'tel'
    }
}) }}

Input avec valeur par défaut​

{{ forms.input('Ville', 'city', user.city, {
    placeholder: 'Votre ville'
}) }}

Input requis avec classes personnalisées​

{{ forms.input('Nom', 'lastname', '', {
    class: 'custom-container',
    input_class: 'custom-input',
    required: true
}) }}

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('Sujet', 'subject', '', { required: true }) }}

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

Formulaire d'édition de profil​

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

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

    {{ forms.input('Prénom', 'firstname', user.firstname, { required: true }) }}
    {{ forms.input('Nom', 'lastname', user.lastname, { required: true }) }}
    {{ forms.input('Site web', 'website', user.website, 'url') }}
    {{ forms.input('Bio', 'bio', user.bio, 'text', {
        help_text: 'Quelques mots sur vous'
    }) }}

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

Voir aussi​