forms.select()
Génère un champ select avec options, optgroups et personnalisation.
Signature
{{ forms.select(label, name, options, selected, selectOptions) }}
Paramètres
label
- Type :
string - Description : Le label affiché au-dessus du select
- Exemple :
'Pays'
name (Requis)
- Type :
string - Description : Le nom du champ (attribut
name) - Exemple :
'country'
options (Requis)
- Type :
array - Description : Les options du select
- Format : Tableau associatif
clé => libelléou tableau de tableaux pour les optgroups
selected
- Type :
string|array - Description : La ou les valeurs sélectionnées
- Défaut :
null - Exemple :
'fr'ou['fr', 'be']pour un select multiple
selectOptions
- Type :
array - Description : Options de personnalisation
Options disponibles
| Option | Type | Description | Défaut |
|---|---|---|---|
class | string | Classe CSS du conteneur | "" |
select_class | string | Classe CSS du select | "" |
multiple | bool | Select multiple | false |
required | bool | Rend le champ obligatoire | false |
placeholder | string | Option de placeholder (désactivée) | - |
help_text | string | Texte d'aide sous le select | "" |
Exemples
Select simple
{{ forms.select('Pays', 'country', { 'fr': 'France', 'be': 'Belgique', 'ch': 'Suisse', 'lu': 'Luxembourg' }, 'fr', {}) }}
Rendu HTML :
<div class="input-group"> <label for="country">Pays</label> <select id="country" name="country"> <option value="fr" selected>France</option> <option value="be">Belgique</option> <option value="ch">Suisse</option> <option value="lu">Luxembourg</option> </select> </div>
Select avec placeholder
{{ forms.select('Civilité', 'civility', { 'mr': 'Monsieur', 'mme': 'Madame', 'mx': 'Autre' }, '', { placeholder: 'Choisissez une civilité' }) }}
Select multiple
{{ forms.select('Langues parlées', 'languages', { 'fr': 'Français', 'en': 'Anglais', 'de': 'Allemand', 'es': 'Espagnol' }, ['fr', 'en'], { multiple: true }) }}
Select avec optgroups
{{ forms.select('Région', 'region', { 'ile-de-france': { '75': 'Paris', '92': 'Hauts-de-Seine', '93': 'Seine-Saint-Denis' }, 'nouvelle-aquitaine': { '33': 'Gironde', '64': 'Pyrénées-Atlantiques' } }, '75', {}) }}
Rendu HTML :
<select id="region" name="region"> <optgroup label="ile-de-france"> <option value="75" selected>Paris</option> <option value="92">Hauts-de-Seine</option> <option value="93">Seine-Saint-Denis</option> </optgroup> <optgroup label="nouvelle-aquitaine"> <option value="33">Gironde</option> <option value="64">Pyrénées-Atlantiques</option> </optgroup> </select>
Select requis avec texte d'aide
{{ forms.select('Département', 'department', { '01': 'Ain', '02': 'Aisne', '03': 'Allier' }, '', { required: true, help_text: 'Sélectionnez votre département de résidence', placeholder: 'Choisissez un département' }) }}
Select avec classes personnalisées
{{ forms.select('Catégorie', 'category', categories, currentCategory, { class: 'custom-select-container', select_class: 'custom-select' }) }}
Cas d'usage
Formulaire d'inscription
{% import "@elementum/macros/forms.html.twig" as forms %} <form method="post"> {{ forms.csrf_nonce() }} {{ forms.select('Civilité', 'civility', { 'mr': 'Monsieur', 'mme': 'Madame', 'mx': 'Autre' }, '', { placeholder: 'Choisissez une civilité', required: true }) }} {{ forms.select('Pays', 'country', { 'fr': 'France', 'be': 'Belgique', 'ch': 'Suisse' }, 'fr', {}) }} {{ forms.submit("S'inscrire") }} </form>
Filtre de recherche
{% import "@elementum/macros/forms.html.twig" as forms %} <form method="get" action="/search"> {{ forms.select('Catégorie', 'category', categories, request.category, { placeholder: 'Toutes les catégories' }) }} {{ forms.select('Prix', 'price_range', { '0-100': '0€ - 100€', '100-500': '100€ - 500€', '500+': '500€ et +' }, request.price_range, { placeholder: 'Tous les prix' }) }} <button type="submit">Filtrer</button> </form>
Sélection de rôles multiples
{% import "@elementum/macros/forms.html.twig" as forms %} {{ forms.select('Rôles', 'roles[]', { 'admin': 'Administrateur', 'editor': 'Éditeur', 'author': 'Auteur', 'contributor': 'Contributeur' }, user.roles, { multiple: true, help_text: 'Maintenez Ctrl pour sélectionner plusieurs rôles' }) }}