CKTIS / JavaScript
Intl.PluralRules.prototype.select(): wybór kategorii liczby mnogiej
Metoda `select(value)` zwraca kategorię gramatyczną jednej wartości na podstawie ustawień językowych i opcji instancji. Wynik służy do wyboru tłumaczenia, a nie do formatowania liczby.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
rules.select(value)Intl.PluralRules.prototype.select to metoda instancji. Utwórz rules za pomocą new Intl.PluralRules(locales, options) i wywołaj rules.select(value). Wynik to jeden z napisów: "zero", "one", "two", "few", "many" lub "other". Dostępne kategorie zależą od wybranych ustawień językowych i typu reguł; "one" nie jest uniwersalnym testem value === 1. Użyj kategorii jako klucza do wariantu tłumaczenia: metoda nie tłumaczy tekstu ani nie formatuje liczby.
Typ "cardinal" jest domyślny i dotyczy liczebników głównych (ile?). Typ "ordinal" dotyczy liczebników porządkowych (który z kolei?). Zaokrąglanie i opcje cyfr, takie jak minimumFractionDigits, mogą zmienić kategorię, ponieważ reguły mogą uwzględniać widoczne cyfry po separatorze dziesiętnym. select klasyfikuje jedną wartość, a selectRange — cały zakres. Sprawdź faktycznie wybrane ustawienia językowe w rules.resolvedOptions().locale; środowisko może użyć innych niż żądane.
this musi być zainicjalizowaną instancją Intl.PluralRules. Wywołanie metody na samym prototypie lub wywołanie jej jako odłączonej funkcji bez powiązania z instancją kończy się TypeError. Zarówno w wydaniu ECMA-402 z 2024 r., jak i w aktualnym projekcie tej specyfikacji metoda select stosuje ToNumber: napisy liczbowe są konwertowane na wartości typu Number (np. "2" staje się 2), a wartości typu BigInt lub Symbol powodują TypeError. Pominięty argument staje się NaN; NaN i obie nieskończoności dają "other". Nie traktuj więc wyniku jako potwierdzenia poprawności danych wejściowych.
Przykłady
{
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));
}Wynik
one other two other
Przy regułach angielskiego amerykańskiego wartość `2` daje `other` dla liczebnika głównego, a `two` dla porządkowego. Wymuszenie jednej cyfry po separatorze sprawia, że liczba `1` jest klasyfikowana jak `1.0`, więc daje `other` zamiast `one`.
Powiązane lekcje
- JavaScript · Lekcja 24 · Zaawansowany · Wersja: 4
Źródła
- 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