Constructeur Intl.ListFormat()
Baseline
Large disponibilité
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.
Le constructeur Intl.ListFormat() crée des objets Intl.ListFormat.
Exemple interactif
const vehicles = ["Motorcycle", "Bus", "Car"];
const formatter = new Intl.ListFormat("en", {
style: "long",
type: "conjunction",
});
console.log(formatter.format(vehicles));
// Résultat attendu : "Motorcycle, Bus, and Car"
const formatter2 = new Intl.ListFormat("de", {
style: "short",
type: "disjunction",
});
console.log(formatter2.format(vehicles));
// Résultat attendu : "Motorcycle, Bus oder Car"
const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });
console.log(formatter3.format(vehicles));
// Résultat attendu : "Motorcycle Bus Car"
Syntaxe
new Intl.ListFormat()
new Intl.ListFormat(locales)
new Intl.ListFormat(locales, options)
Paramètres
localesFacultatif-
A string with a BCP 47 language tag or an
Intl.Localeinstance, or an array of such locale identifiers. The runtime's default locale is used whenundefinedis passed or when none of the specified locale identifiers is supported. For the general form and interpretation of thelocalesargument, see the parameter description on theIntlmain page. optionsFacultatif-
Un objet contenant les propriétés suivantes, dans l'ordre dans lequel elles sont récupérées (toutes sont optionnelles) :
localeMatcher-
L'algorithme de correspondance de la locale à utiliser. Les valeurs possibles sont
"lookup"et"best fit"; la valeur par défaut est"best fit". Pour plus d'informations sur cette option, voir Identification et négociation de la locale. type-
Indique le type de regroupement. Les valeurs possibles sont :
"conjunction"(par défaut)-
Pour un regroupement des éléments de la liste basé sur « et » : « A, B et C »
"disjunction"-
Pour un regroupement des éléments de la liste basé sur « ou » : « A, B ou C »
"unit"-
Pour regrouper les éléments de la liste comme une unité composée (ni basé sur « et » ni sur « ou ») : « A, B, C »
style-
Le style de regroupement (par exemple, si les séparateurs de liste et les conjonctions sont inclus). Les valeurs possibles sont :
"long"(par défaut)-
Le format de liste typique. Par exemple : « A, B et C »
"short"-
L'espacement, la longueur ou la présence d'une conjonction, et les séparateurs peuvent changer. En général, il est aussi souhaitable que les éléments d'entrée soient abrégés. Par exemple : « A, B, & C »
"narrow"-
Lorsque c'est possible, le format de la liste est encore plus abrégé, de sorte que le résultat soit aussi court que possible. Par exemple : « A, B, C »
Exceptions
RangeError-
Levée si
localesouoptionscontiennent des valeurs non valides.
Exemples
Utiliser la méthode format()
L'exemple suivant illustre comment créer un formateur de liste basé sur la langue anglaise.
const liste = ["Motorcycle", "Bus", "Car"];
console.log(
new Intl.ListFormat("en-GB", { type: "conjunction" }).format(liste),
);
// Motorcycle, Bus and Car
console.log(
new Intl.ListFormat("en-GB", { type: "disjunction" }).format(liste),
);
// Motorcycle, Bus or Car
Virgule d'Oxford
La virgule d'Oxford est une virgule placée juste avant la conjonction de coordination (généralement « et » ou « ou ») dans une liste de trois termes ou plus. De façon controversée, la locale en-US utilise la virgule d'Oxford, tandis que la locale en-GB ne l'utilise pas.
const list = ["Motorcycle", "Bus", "Car"];
console.log(new Intl.ListFormat("en-GB", { type: "conjunction" }).format(list));
// Motorcycle, Bus and Car
console.log(new Intl.ListFormat("en-US", { type: "conjunction" }).format(list));
// Motorcycle, Bus, and Car
Formatage d'unités
Utilisez style: "unit" pour formater les éléments de la liste comme une unité composée. En fait, Intl.DurationFormat utilise le formatage de liste de type unité en interne pour formater les durées.
const marathon = [
[42, "kilometer"],
[195, "meter"],
];
console.log(
new Intl.ListFormat("en-US", { type: "unit" }).format(
marathon.map((component) =>
component[0].toLocaleString("en-US", {
style: "unit",
unit: component[1],
unitDisplay: "long",
}),
),
),
);
// 42 kilometers, 195 meters
Style court et style étroit
Les styles "short" et "narrow" sont utiles pour des représentations compactes des listes.
const list = ["Motorcycle", "Bus", "Car"];
console.log(new Intl.ListFormat("en-US", { style: "short" }).format(list));
// Motorcycle, Bus, & Car
console.log(new Intl.ListFormat("en-US", { style: "narrow" }).format(list));
// Motorcycle, Bus, Car
console.log(new Intl.ListFormat("en-GB", { style: "short" }).format(list));
// Motorcycle, Bus and Car
console.log(new Intl.ListFormat("en-GB", { style: "narrow" }).format(list));
// Motorcycle, Bus, Car
Les éléments d'entrée ne sont pas transformés, mais il est souvent souhaitable de les abréger également.
const marathon = [
[42, "kilometer"],
[195, "meter"],
];
function formatDistance(locale, distance, style) {
return new Intl.ListFormat(locale, { type: "unit", style }).format(
marathon.map((component) =>
component[0].toLocaleString(locale, {
style: "unit",
unit: component[1],
unitDisplay: style,
}),
),
);
}
console.log(formatDistance("en-US", marathon, "long"));
// 42 kilometers, 195 meters
console.log(formatDistance("en-US", marathon, "short"));
// 42 km, 195 m
console.log(formatDistance("en-US", marathon, "narrow"));
// 42km 195m
Sélection de la conjonction
Le mot de conjonction utilisé peut dépendre des valeurs de chaîne de caractères des éléments de la liste. Par exemple, en espagnol, la conjonction est "y" pour la plupart des mots, mais "e" pour les mots commençant par la voyelle "i".
const words = ["fuerte", "indomable"];
const formatter = new Intl.ListFormat("es-ES", { type: "conjunction" });
console.log(formatter.format(words));
// fuerte e indomable
console.log(formatter.format(words.toReversed()));
// indomable y fuerte
L'algorithme utilisé pour déterminer la conjonction n'est pas parfait (par exemple, il ne peut pas toujours déterminer la prononciation d'un mot à partir de son orthographe), mais il devrait fonctionner dans la plupart des cas.
Spécifications
| Spécification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl-listformat-constructor |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.ListFormat - L'objet
Intl