Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori