CKTIS / JavaScript
Intl.ListFormat — oblikovanje seznamov glede na jezikovne nastavitve
Intl.ListFormat povezuje besedilne elemente seznama z ločili in vezniki, primernimi za jezikovne nastavitve. format() vrne besedilo, medtem ko formatToParts() loči izvirne elemente od dodanega povezovalnega besedila.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new Intl.ListFormat(locales?, options?).format(list)Intl.ListFormat je API za internacionalizacijo, določen s standardom ECMA-402, in ne API DOM. Oblikovalnik ustvarite z new Intl.ListFormat(locales, options). Argument locales izbere prednostne jezikovne nastavitve; če ga izpustite, se uporabi privzeta jezikovna nastavitev okolja.
Možnost type sprejema "conjunction" (povezovanje v slogu »in«, privzeto), "disjunction" (alternative v slogu »ali«) ali "unit" (seznam enot). Možnost style sprejema "long" (privzeto), "short" ali "narrow". Oblikovalnik ne prevaja elementov in ne oblikuje samih števil ali enot.
format(list) sprejme iterabilen objekt, ki vsebuje samo nize; element drugega tipa povzroči TypeError. Prazen seznam ustvari "". formatToParts(list) vrne objekte s poljema type in value: "element" označuje vhodni element, "literal" pa dodano povezovalno besedilo. Tako lahko poudarite elemente, ne da bi razčlenjevali ločila.
Natančno povezovalno besedilo je odvisno od jezikovnih podatkov v implementaciji; ne predpostavljajte, da je enako v vseh okoljih. Preverite, ali je Intl.ListFormat na voljo v ciljnem okolju — njegova prisotnost v Node ne dokazuje podpore v brskalnikih. Primer preverja ohranitev elementov in ponovno sestavljanje rezultata, ne pa določenega ločila.
Primeri
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));Rezultat
["Ada","Lin","Sam"] true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.