Constructeur Intl.ListFormat()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

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

js
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 page Intl.

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 de style 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.

js
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

Voir aussi