CKTIS / JavaScript
Intl.PluralRules.prototype.select(): scegliere una categoria di plurale
`select(value)` restituisce la categoria grammaticale di un valore in base alla lingua e alle opzioni dell’istanza. Il risultato serve a scegliere un messaggio tradotto, non a formattare un numero.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
rules.select(value)Intl.PluralRules.prototype.select è un metodo di istanza. Crea rules con new Intl.PluralRules(locales, options), poi chiama rules.select(value). Il risultato è una delle stringhe "zero", "one", "two", "few", "many" o "other". Le categorie disponibili dipendono dalle impostazioni locali effettive e dal tipo di regola; "one" non equivale sempre a value === 1. Usa la categoria come chiave per scegliere una variante tradotta: il metodo non traduce il testo né formatta il numero.
Il tipo predefinito "cardinal" indica la quantità («quanti?»); "ordinal" indica la posizione («in quale posizione?»). L’arrotondamento e opzioni come minimumFractionDigits possono cambiare la categoria, perché le regole possono dipendere dalle cifre decimali visibili. select classifica un singolo valore; selectRange classifica un intero intervallo. Controlla rules.resolvedOptions().locale per sapere quali impostazioni locali sono state usate: possono differire da quelle richieste.
Il ricevitore (this) deve essere un’istanza inizializzata di Intl.PluralRules. Chiamare il metodo sul prototipo stesso o come funzione separata e non associata all’istanza genera TypeError. Sia nell’edizione 2024 di ECMA-402 sia nella bozza attuale, select usa ToNumber: le stringhe numeriche vengono convertite in valori di tipo Number ("2" diventa 2), mentre BigInt e Symbol generano TypeError. Un argomento omesso diventa NaN; NaN ed entrambi gli infiniti restituiscono "other". Il fatto che venga restituita una categoria non convalida quindi l’input.
Esempi
{
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));
}Risultato
one other two other
Con le regole dell’inglese statunitense, `2` dà `other` come cardinale e `two` come ordinale. Richiedere una cifra decimale fa classificare `1` come `1.0`, che restituisce `other` anziché `one`.
Lezioni correlate
- JavaScript · Lezione 24 · Avanzato · Versione: 4
Fonti
- 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