CKTIS / JavaScript
Intl.PluralRules — výběr gramatické kategorie čísla
Intl.PluralRules vybírá gramatickou kategorii čísla podle pravidel daného jazyka. Metoda select vrací název kategorie, nikoli ohýbané slovo nebo celé sdělení.
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
const rules = new Intl.PluralRules(locales, options);
rules.select(value);Intl.PluralRules je součástí internacionalizačního standardu ECMA-402, nikoli DOM. Metoda instance PluralRules.select, formálně Intl.PluralRules.prototype.select(value), vrací kategorii: zero, one, two, few, many nebo other. Dostupné kategorie závisejí na jazyce; jejich názvy neoznačují jednoduché testy rovnosti.
Výchozí volba type: "cardinal" se týká počtu. type: "ordinal" se týká pořadí v posloupnosti. API slova nepřekládá ani neskloňuje: aplikace přiřazuje kategoriím text a měla by nabídnout záložní variantu other. Volby pro číslice a zaokrouhlování mohou změnit vybranou kategorii.
Příklad výslovně vybírá en a pravidla pro základní číslovky, takže nezávisí na výchozím jazyce prostředí. Očekávaný výstup předpokládá dostupnost anglických jazykových dat. Specifikace není tabulka kompatibility prohlížečů: ověřte cílová prostředí a dostupnost jazyka pomocí Intl.PluralRules.supportedLocalesOf(["en"]). Dostupnost API v Node 24 nedokazuje jeho podporu v prohlížečích.
Příklady
const rules = new Intl.PluralRules("en", { type: "cardinal" });
const forms = { one: "file", other: "files" };
for (const count of [0, 1, 2]) {
const category = rules.select(count);
console.log(`${count} ${forms[category] ?? forms.other}`);
}Výsledek
0 files 1 file 2 files
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.