CKTIS / JavaScript
Intl.ListFormat — formátování seznamů podle místního nastavení
Intl.ListFormat spojuje textové prvky seznamu pomocí oddělovačů a spojek odpovídajících místnímu nastavení. format() vrací text, zatímco formatToParts() odděluje původní prvky od vloženého spojovacího textu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Intl.ListFormat(locales?, options?).format(list)Intl.ListFormat je internacionalizační API definované standardem ECMA-402, nikoli API DOM. Formátovač vytvoříte pomocí new Intl.ListFormat(locales, options). Argument locales vybírá upřednostňovaná místní nastavení; pokud ho vynecháte, použije se výchozí místní nastavení prostředí.
Možnost type přijímá hodnoty "conjunction" (spojení ve stylu „a“, výchozí hodnota), "disjunction" (alternativy ve stylu „nebo“) nebo "unit" (seznam jednotek). Možnost style přijímá "long" (výchozí hodnota), "short" nebo "narrow". Formátovač nepřekládá prvky ani neformátuje samotná čísla či jednotky.
format(list) přijímá iterovatelný objekt obsahující pouze řetězce; prvek jiného typu způsobí TypeError. Prázdný seznam vrátí "". formatToParts(list) vrací objekty s poli type a value: "element" označuje vstupní prvek a "literal" vložený spojovací text. Díky tomu můžete zvýraznit prvky, aniž byste analyzovali interpunkci.
Přesný spojovací text závisí na místních datech implementace; nepředpokládejte, že bude ve všech prostředích stejný. Ověřte dostupnost Intl.ListFormat v cílovém prostředí — jeho přítomnost v Node nedokazuje podporu v prohlížečích. Příklad ověřuje zachování prvků a opětovné sestavení výsledku, nikoli konkrétní oddělovač.
Pří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ýsledek
["Ada","Lin","Sam"] true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.