KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.ListFormat — lijsten op basis van de taalinstelling opmaken

Intl.ListFormat combineert tekstelementen in een lijst met scheidingstekens en voegwoorden die passen bij de taalinstelling. format() geeft tekst terug, terwijl formatToParts() de oorspronkelijke elementen scheidt van de toegevoegde verbindende tekst.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Intl.ListFormat(locales?, options?).format(list)

Intl.ListFormat is een internationalisatie-API die is gedefinieerd door ECMA-402, geen DOM-API. Maak een formatter met new Intl.ListFormat(locales, options). Het argument locales selecteert voorkeurstaalinstellingen; als je het weglaat, wordt de standaardtaalinstelling van de omgeving gebruikt.

De optie type accepteert "conjunction" (een verbinding in de stijl van ‘en’, de standaard), "disjunction" (alternatieven in de stijl van ‘of’) of "unit" (een lijst met eenheden). De optie style accepteert "long" (de standaard), "short" of "narrow". De formatter vertaalt de elementen niet en maakt de getallen of eenheden zelf niet op.

format(list) accepteert een itereerbaar object dat alleen tekenreeksen bevat; een element van een ander type veroorzaakt een TypeError. Een lege lijst levert "" op. formatToParts(list) geeft objecten terug met de velden type en value: "element" duidt een invoerelement aan en "literal" de toegevoegde verbindende tekst. Zo kun je elementen markeren zonder de interpunctie te ontleden.

De precieze verbindende tekst hangt af van de taalgegevens van de implementatie; ga er niet van uit dat die in alle omgevingen hetzelfde is. Controleer of Intl.ListFormat beschikbaar is in de doelomgeving — aanwezigheid in Node bewijst geen browserondersteuning. Het voorbeeld controleert of elementen behouden blijven en het resultaat opnieuw kan worden samengesteld, niet of er een bepaalde scheidingstekst wordt gebruikt.

Voorbeelden

const formatter = new Intl.ListFormat("en", {
  type: "conjunction",
  style: "long"
});
const items = ["Ada", "Lin", "Sam"];
const parts = formatter.formatToParts(items);
console.log(JSON.stringify(parts.filter(p => p.type === "element").map(p => p.value)));
console.log(parts.map(p => p.value).join("") === formatter.format(items));

Resultaat

["Ada","Lin","Sam"]
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen