Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Intl.ListFormat — formátovanie zoznamov podľa miestneho nastavenia

Intl.ListFormat spája textové prvky zoznamu pomocou oddeľovačov a spojok zodpovedajúcich miestnemu nastaveniu. format() vracia text, zatiaľ čo formatToParts() oddeľuje pôvodné prvky od vloženého spojovacieho textu.

Verzia: 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 je internacionalizačné API definované štandardom ECMA-402, nie API DOM. Formátovač vytvoríte pomocou new Intl.ListFormat(locales, options). Argument locales vyberá uprednostňované miestne nastavenia; ak ho vynecháte, použije sa predvolené miestne nastavenie prostredia.

Možnosť type prijíma hodnoty "conjunction" (spojenie v štýle „a“, predvolená hodnota), "disjunction" (alternatívy v štýle „alebo“) alebo "unit" (zoznam jednotiek). Možnosť style prijíma "long" (predvolená hodnota), "short" alebo "narrow". Formátovač neprekladá prvky ani neformátuje samotné čísla či jednotky.

format(list) prijíma iterovateľný objekt obsahujúci iba reťazce; prvok iného typu spôsobí TypeError. Prázdny zoznam vráti "". formatToParts(list) vracia objekty s poľami type a value: "element" označuje vstupný prvok a "literal" vložený spojovací text. Vďaka tomu môžete zvýrazniť prvky bez analyzovania interpunkcie.

Presný spojovací text závisí od miestnych údajov implementácie; nepredpokladajte, že bude vo všetkých prostrediach rovnaký. Overte dostupnosť Intl.ListFormat v cieľovom prostredí — jeho prítomnosť v Node nedokazuje podporu v prehliadačoch. Príklad overuje zachovanie prvkov a opätovné zostavenie výsledku, nie konkrétny oddeľovač.

Príklady

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));

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje