Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri