Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Intl.ListFormat
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.
L'objetIntl.ListFormat permet de formater des listes de façon différente selon la locale utilisée.
Exemple interactif
const vehicles = ["Motorcycle", "Bus", "Car"];const formatter = new Intl.ListFormat("en", { style: "long", type: "conjunction",});console.log(formatter.format(vehicles));// Expected output: "Motorcycle, Bus, and Car"const formatter2 = new Intl.ListFormat("de", { style: "short", type: "disjunction",});console.log(formatter2.format(vehicles));// Expected output: "Motorcycle, Bus oder Car"const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });console.log(formatter3.format(vehicles));// Expected output: "Motorcycle Bus Car"Constructeur
Intl.ListFormat()Crée un nouvel objet
Intl.ListFormat.
Méthodes statiques
Intl.ListFormat.supportedLocalesOf()Renvoie un tableau qui contient les locales, parmi celles fournies en arguments, qui sont prises en charge sans avoir à recourir à la locale par défaut de l'environnement d'exécution.
Méthodes des instances
Intl.ListFormat.prototype.format()Renvoie une chaîne de caractères, formatée selon la locale, qui représente les éléments de la liste.
Intl.ListFormat.prototype.formatToParts()Renvoie un tableau d'objets qui sont chacun des fragments pouvant être utilisés pour formater la liste de valeurs en tenant compte de la locale.
Exemples
Utiliserformat()
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 Carconsole.log( new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format( list, ),);// > Motorcycle, Bus or Carconsole.log( new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),);// > Motorcycle Bus CarUtiliserformatToParts()
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": "Bus" },// { "type": "literal", "value": ", and " },// { "type": "element", "value": "Car" } ];Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # listformat-objects |