Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
La propriété d'accesseur variants des instances de Intl.Locale retourne les variantes associées à cette locale, sous forme d'une chaîne de caractères d'identifiants séparés par des tirets (-) dans l'ordre spécifié à l'origine.
Les variantes font partie de l'identifiant principal de la langue. Elles sélectionnent des variantes d'une langue que le triple (langue, région, script) ne peut pas différencier. En général, elles représentent la même langue à différentes époques ou avec différentes orthographes. Par exemple, l'allemand a les variantes d'orthographe 1901 et 1996, qui s'écrivent de-1901 et de-1996 ; la variante « Early Modern English (1500-1700) » s'écrit en-emodeng. Le sous-balise peut contenir plusieurs identifiants séparés par des tirets (-). Ces identifiants sont techniquement non ordonnés, bien qu'en pratique, ils aient souvent une hiérarchie sémantique — par exemple, le dialecte résian du slovène s'écrit sl-rozaj, et le dialecte San Giorgio/Bila du résian s'écrit sl-rozaj-biske.
La valeur de la propriété variants est définie au moment de la construction, soit par la partie de l'identifiant de la locale après region, soit par l'option variants du constructeur Intl.Locale(). Cette dernière prend le pas si les deux sont présentes ; et si aucune n'est présente, la propriété a pour valeur undefined.
Le mutateur d'accesseur de variants est undefined. Vous ne pouvez pas modifier cette propriété directement.
Comme pour les autres sous-balises de locale, les variantes peuvent être ajoutées à l'objet Intl.Locale soit par la chaîne de caractères de locale, soit par un objet de configuration passé en argument au constructeur.
Les variantes, si elles sont présentes, sont les dernières parties d'une chaîne de caractères d'identifiant de langue Unicode valide, et peuvent être ajoutées à la chaîne de caractères d'identifiant de locale initiale qui est passée au constructeur Intl.Locale(). Notez que les variantes ne sont pas une partie obligatoire d'un identifiant de locale.
Le constructeur Intl.Locale() accepte un objet de configuration optionnel en argument. Définissez la propriété variants de l'objet de configuration avec les variantes souhaitées, puis passez-le au constructeur.
| ECMAScript® 2027 Internationalization API Specification # sec-Intl.Locale.prototype.variants |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 26 avr. 2026 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.