CKTIS / JavaScript
Intl.PluralRules.prototype.select(): odabir kategorije množine
`select(value)` vraća gramatičku kategoriju jedne vrijednosti prema jezičnoj postavci i opcijama instance. Rezultat služi za odabir prijevoda, a ne za oblikovanje broja.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
rules.select(value)Intl.PluralRules.prototype.select metoda je instance. Stvorite rules pomoću new Intl.PluralRules(locales, options) pa pozovite rules.select(value). Metoda vraća jedan od nizova "zero", "one", "two", "few", "many" ili "other". Dostupne kategorije ovise o stvarno upotrijebljenoj jezičnoj postavci i vrsti pravila; "one" nije univerzalna provjera izraza value === 1. Kategoriju upotrijebite kao ključ za odabir prevedene inačice poruke: metoda ne prevodi tekst niti oblikuje broj.
Zadana vrsta "cardinal" odnosi se na glavne brojeve („koliko?”), a "ordinal" na redne brojeve („koji po redu?”). Zaokruživanje i opcije kao što je minimumFractionDigits mogu promijeniti kategoriju jer pravila mogu ovisiti o vidljivim decimalnim znamenkama. select razvrstava jednu vrijednost, a selectRange cijeli raspon. Provjerite rules.resolvedOptions().locale da biste doznali koja je jezična postavka stvarno upotrijebljena; može se razlikovati od zatražene.
Primatelj (this) mora biti inicijalizirana instanca Intl.PluralRules. Poziv na samom prototipu ili poziv izdvojene funkcije koja nije vezana uz instancu izaziva TypeError. I u izdanju ECMA-402 iz 2024. i u aktualnom nacrtu metoda select primjenjuje ToNumber: brojčani nizovi pretvaraju se u vrijednosti tipa Number ("2" postaje 2), dok BigInt i Symbol izazivaju TypeError. Izostavljeni argument postaje NaN; NaN i obje beskonačnosti vraćaju "other". Vraćena kategorija stoga ne potvrđuje valjanost ulazne vrijednosti.
Primjeri
{
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
Prema pravilima američkog engleskog, `2` kao glavni broj daje `other`, a kao redni `two`. Ako zahtijevate jednu decimalnu znamenku, `1` se razvrstava kao `1.0` pa vraća `other` umjesto `one`.
Povezane lekcije
- JavaScript · Lekcija 24 · Napredno · Verzija: 4
Izvori
- 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