Intl.ListFormat

L'objet Intl.ListFormat est un constructeur d'objets qui permettent de formater des listes de façon différente selon la langue utilisée.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

Syntax

new Intl.ListFormat([locales[, options]]) 

Paramètres

localesFacultatif

Paramètre optionnel. Une chaine de caractères avec un identifiant de langue BCP 47, ou un tableau de ce type de chaine de caractères. Pour le format général et l'interprétation de l'argument locales, voir la page Intl.

optionsFacultatif

Paramètre optionnel. Un objet avec certaines ou toutes les propriétés suivantes :

localeMatcher

L'algorithme de correspondance à utiliser pour la locale. Les valeurs possibles sont "lookup" et "best fit" ; le défaut est "best fit". Pour des informations sur cette option, voir la page Intl.

type

Le format de sortie pour le message. Les valeurs possibles sont :

• "conjunction" : qui concaténera les éléments de la liste avec des et. Cela produira par exemple, en anglais : A, B, and C
• "disjunction" : qui concaténera les éléments de la liste avec des ou. Cela produira par exemple, en anglais : A, B, or C
• "unit" : qui permet de gérer des listes de valeurs avec des unités. Cela produira par exemple 5 livres, 12 onces

style

Le niveau de concision/longueur du message obtenu. Les valeurs possibles sont :

• "long" : par exemple A, B, and C
• "narrow" : cette valeur permet uniquement d'utiliser le type unit et affichera un message concis
• "short" : par exemple A, B, C

Description

Propriétés

Intl.ListFormat.prototype

Cette propriété permet d'ajouter des propriétés à l'ensemble des objets de ce type.

Méthodes

Intl.ListFormat.supportedLocalesOf()

Cette méthode renvoie un tableau des locales prises en charge par le moteur pour le formatage des heures sans qu'il y ait besoin d'utiliser la locale de l'environnement d'exécution.

Exemples

Utiliser format()

Dans l'exemple qui suit, on voit comment créer un formateur de liste pour l'anglais.

const list = ['Motorcycle', 'Bus', 'Car'];

 console.log(new Intl.ListFormat('en-GB', { style: 'long', type: 'conjunction' }).format(list));
// > Motorcycle, Bus and Car

 console.log(new Intl.ListFormat('en-GB', { style: 'short', type: 'disjunction' }).format(list));
// > Motorcycle, Bus or Car

 console.log(new Intl.ListFormat('en-GB', { style: 'narrow', type: 'unit' }).format(list));
// > Motorcycle Bus Car

Utiliser formatToParts()

Dans l'exemple qui suit, on voit comment créer un formateur de liste, renvoyant les fragments, pour l'anglais

const list = ['Motorcycle', 'Bus', 'Car'];
console.log(new Intl.ListFormat('en-GB', { style: 'long', type: 'conjunction' }).formatToParts(list));
 
// > [ { "type": "element", "value": "Motorcycle" }, 
       { "type": "literal", "value": ", " },
       { "type": "element", "value": "Truck" },
       { "type": "literal", "value": ", and " },
       { "type": "element", "value": "Car" } ];

Spécifications