Constructeur Intl.ListFormat()
Le constructeur Intl.ListFormat()
permet de créer des objets Intl.ListFormat
pour le formatage de listes adapté à la locale et aux options fournies.
Exemple interactif
Syntaxe
new Intl.ListFormat()
new Intl.ListFormat(locales)
new Intl.ListFormat(locales, options)
Paramètres
locales
Facultatif-
Une chaîne de caractères représentant une balise de langue BCP 47 ou un tableau de telles balises. Pour la forme générale et l'interprétation de cet argument, voir la page
Intl
. options
Facultatif-
Un objet avec une ou plusieurs des propriétés suivantes :
localeMatcher
-
- : L'algorithme de correspondance des locales à utiliser. Les valeurs possibles sont "
lookup
" et "best fit
" ; la valeur par défaut est "best fit
". Pour plus d'information, voir la pageIntl
. type
-
Le format de sortie produit. Les valeurs possibles sont "
conjunction
" qui indique une liste additive (par exemple "A, B, et C
"), c'est la valeur par défaut, ou "disjunction
" qui indique une liste d'options distinctes (par exemple, "A, B, ou C
"), ou "unit
" qui indique une liste de valeurs avec des unités (par exemple, "5 kg, 12 L
"). style
-
La longueur du message formaté. Les valeurs possibles sont "
long
", la valeur par défaut (par exemple "A, B, et C
") ; "short
" (par exemple "A, B, C
"), ou "narrow
" (par exemple, "A B C
"). Lorsque la valeur destyle
est "short
" ou "narrow
", seule la valeur "unit
" est autorisée pour l'option "type".
Exemples
Utilisation de format()
L'exemple suivant illustre comment créer un formateur de liste basé sur la langue française.
const list = ['Moto', 'Bus', 'Car'];
console.log(new Intl.ListFormat('fr', { style: 'long', type: 'conjunction' }).format(list));
// > Moto, Bus et Car
console.log(new Intl.ListFormat('fr', { style: 'short', type: 'disjunction' }).format(list));
// > Moto, Bus ou Car
console.log(new Intl.ListFormat('fr', { style: 'narrow', type: 'unit' }).format(list));
// > Moto Bus Car
Spécifications
Specification |
---|
ECMAScript Internationalization API Specification # sec-intl-listformat-constructor |
Compatibilité des navigateurs
BCD tables only load in the browser