CKTIS / JavaScript
Intl.ListFormat — oblikovanje popisa prema lokalnim postavkama
Intl.ListFormat povezuje tekstne elemente popisa pomoću razdjelnika i veznika prilagođenih lokalnim postavkama. format() vraća tekst, a formatToParts() odvaja izvorne elemente od dodanog poveznog teksta.
Verzija: 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 API je za internacionalizaciju definiran standardom ECMA-402, a ne API DOM-a. Izradite oblikovatelj pomoću new Intl.ListFormat(locales, options). Argument locales odabire željene lokalne postavke; ako ga izostavite, upotrebljavaju se zadane lokalne postavke okruženja.
Opcija type prihvaća "conjunction" (povezivanje u stilu „i”, zadano), "disjunction" (alternative u stilu „ili”) ili "unit" (popis jedinica). Opcija style prihvaća "long" (zadano), "short" ili "narrow". Oblikovatelj ne prevodi elemente niti oblikuje same brojeve ili jedinice.
format(list) prihvaća iterabilni objekt koji sadrži samo nizove znakova; element drugog tipa uzrokuje TypeError. Prazan popis daje "". formatToParts(list) vraća objekte s poljima type i value: "element" označava ulazni element, a "literal" umetnuti povezni tekst. Tako možete istaknuti elemente bez raščlanjivanja interpunkcije.
Točan povezni tekst ovisi o lokalnim podacima implementacije; nemojte pretpostaviti da je jednak u svim okruženjima. Provjerite je li Intl.ListFormat dostupan u ciljnom okruženju — njegova prisutnost u Nodeu ne dokazuje podršku u preglednicima. Primjer provjerava očuvanje elemenata i ponovno sastavljanje rezultata, a ne određeni razdjelnik.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.