dsfr_label_with_hint
Génère un <label> au DSFR avec texte d'aide optionnel.
Usage basique
<%= f.dsfr_label_with_hint :name %>
<label class="fr-label" for="usage-basique_name">Nom complet</label>
Options disponibles
| Option | Type | Description |
|---|---|---|
label: | String | Texte personnalisé pour le label |
label_text: | String | Alias delabel: (prioritaire) |
hint: | String | Texte d'aide affiché sous le label |
required: | Boolean | Affiche une astérisque rouge |
value: | String | Valeur pour l'attributfor (radio/checkbox) |
class: | String | Classes CSS additionnelles |
Avec label personnalisé
<%= f.dsfr_label_with_hint :name, label: "Votre nom complet" %>
<label class="fr-label" for="label-personnalise_name">Votre nom complet</label>
Avec texte d'aide
<%= f.dsfr_label_with_hint :name, hint: "Tel qu'il apparaît sur votre pièce d'identité" %>
<label class="fr-label" for="hint_name">Nom complet<span class="fr-hint-text">Tel qu'il apparaît sur votre pièce d'identité</span></label>
Avec indicateur obligatoire
<%= f.dsfr_label_with_hint :name, required: true %>
<label class="fr-label" for="obligatoire_name">Nom complet</label>
Combinaison complète
<%= f.dsfr_label_with_hint :name, label: "Nom complet", hint: "Prénom et nom de famille", required: true %>
<label class="fr-label" for="combinaison_name">Nom complet<span class="fr-hint-text">Prénom et nom de famille</span></label>
Pour radio/checkbox (avec value)
L'optionvalue: permet de générer un label associé à une valeur spécifique (utile pour les radio buttons et checkboxes).
<%= f.dsfr_label_with_hint :pronoun, label_text: "Elle", hint: "Elle était présente", value: "elle" %>
<label class="fr-label" for="value_pronoun_elle">Elle<span class="fr-hint-text">Elle était présente</span></label>