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
| Option | Type | Description | Défaut |
|---|---|---|---|
class | string | Classe CSS du conteneur | "" |
input_class | string | Classe CSS de l'input | "" |
placeholder | string | Texte de remplacement | - |
required | bool | Rend le champ obligatoire | false |
checked | bool | Coche l'input (pour type="checkbox") | false |
attributes | array | Attributs HTML personnalisés | [] |
help_text | string | Texte 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>