Aller au contenu principal
Version: Next

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​

OptionTypeDescriptionDéfaut
classstringClasse CSS du conteneur""
select_classstringClasse CSS du select""
multipleboolSelect multiplefalse
requiredboolRend le champ obligatoirefalse
placeholderstringOption de placeholder (désactivée)-
help_textstringTexte 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'
}) }}

Voir aussi​