CKTIS / JavaScript
Intl.PluralRules — selezione di una categoria grammaticale
Intl.PluralRules seleziona una categoria grammaticale del numero in base alle regole specifiche della lingua. Il metodo select restituisce il nome di una categoria, non una parola flessa né un messaggio completo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const rules = new Intl.PluralRules(locales, options);
rules.select(value);Intl.PluralRules fa parte dello standard di internazionalizzazione ECMA-402, non del DOM. Il metodo di istanza PluralRules.select, formalmente Intl.PluralRules.prototype.select(value), restituisce una categoria: zero, one, two, few, many oppure other. Le categorie disponibili dipendono dalla lingua; questi nomi non corrispondono a semplici verifiche di uguaglianza.
L’opzione predefinita type: "cardinal" riguarda le quantità. type: "ordinal" riguarda le posizioni in una sequenza. L’API non traduce né declina le parole: l’applicazione associa del testo alle categorie e dovrebbe prevedere un’alternativa other. Le opzioni relative alle cifre e all’arrotondamento possono modificare la categoria selezionata.
L’esempio seleziona esplicitamente en e le regole cardinali, invece di dipendere dalla lingua predefinita dell’ambiente. L’output previsto presuppone che siano disponibili i dati linguistici inglesi. La specifica non è una tabella di compatibilità dei browser: verifica gli ambienti di destinazione e la disponibilità della lingua con Intl.PluralRules.supportedLocalesOf(["en"]). La disponibilità dell’API in Node 24 non dimostra che sia supportata nei browser.
Esempi
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}`);
}Risultato
0 files 1 file 2 files
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.