CKTIS / JavaScript
Intl.PluralRules.prototype.select(): izbira množinske kategorije
`select(value)` vrne slovnično kategorijo ene vrednosti glede na jezikovno nastavitev in možnosti primerka. Rezultat uporabite za izbiro prevoda, ne za oblikovanje števila.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
rules.select(value)Intl.PluralRules.prototype.select je metoda primerka. Ustvarite rules z new Intl.PluralRules(locales, options) in pokličite rules.select(value). Metoda vrne enega od nizov "zero", "one", "two", "few", "many" ali "other". Razpoložljive kategorije so odvisne od dejansko uporabljene jezikovne nastavitve in vrste pravil; "one" ni splošen preizkus za value === 1. Kategorijo uporabite kot ključ za izbiro prevedene različice sporočila: metoda ne prevaja besedila in ne oblikuje števila.
Privzeta vrsta "cardinal" velja za glavne števnike (»koliko?«), "ordinal" pa za vrstilne števnike (»kateri po vrsti?«). Zaokroževanje in možnosti, kot je minimumFractionDigits, lahko spremenijo kategorijo, saj so pravila lahko odvisna od vidnih decimalnih mest. select razvrsti eno vrednost, selectRange pa cel razpon. Z rules.resolvedOptions().locale preverite dejansko uporabljeno jezikovno nastavitev, ki se lahko razlikuje od zahtevane.
Prejemnik (this) mora biti inicializiran primerek Intl.PluralRules. Klic na samem prototipu ali klic ločene funkcije brez vezave na primerek sproži TypeError. Tako v izdaji ECMA-402 iz leta 2024 kot v trenutnem osnutku metoda select uporablja operacijo ToNumber: številski nizi se pretvorijo v vrednosti tipa Number ("2" postane 2), vrednosti BigInt in Symbol pa sprožijo TypeError. Izpuščeni argument postane NaN; NaN in obe neskončnosti vrnejo "other". Vrnjena kategorija zato ne potrjuje veljavnosti vhoda.
Primeri
{
const cardinal = new Intl.PluralRules('en-US');
const ordinal = new Intl.PluralRules('en-US', { type: 'ordinal' });
const withFraction = new Intl.PluralRules('en-US', { minimumFractionDigits: 1 });
console.log(cardinal.select(1));
console.log(cardinal.select(2));
console.log(ordinal.select(2));
console.log(withFraction.select(1));
}Rezultat
one other two other
Po pravilih ameriške angleščine `2` kot glavni števnik vrne `other`, kot vrstilni pa `two`. Če zahtevate eno decimalno mesto, se `1` razvrsti kot `1.0` in vrne `other` namesto `one`.
Povezane lekcije
- JavaScript · Lekcija 24 · Napredna · Različica: 4
Viri
- ECMAScript® 2024 Internationalization API Specification — Intl.PluralRules.prototype.select
- ECMAScript® 2024 Internationalization API Specification — ResolvePlural
- ECMAScript® 2024 Language Specification — ToNumber
- ECMA-402 living draft — Intl.PluralRules.prototype.select
- MDN — Intl.PluralRules.prototype.select()
- MDN — Intl.PluralRules() constructor