Informazioni
L'argomento richiesto è visualizzato di seguito, ma non è incluso in questa libreria.

Oggetto Intl.Collator (JavaScript)

Fornisce confronti di stringhe specifici delle impostazioni locali.

collatorObj = new Intl.Collator([locales][, options])

collatorObj

Necessario. Il nome della variabile a cui assegnare l'oggetto Collator.

locales

Opzionale. Una matrice di stringhe delle impostazioni locali che contengono uno o più linguaggi o tag per le impostazioni locali. Se si include più di una stringa delle impostazioni locali, elencarle in ordine decrescente di priorità in modo che la prima voce siano le impostazioni locali desiderate. Se si omette questo parametro, le impostazioni locali predefinite del runtime JavaScript vengono utilizzate. Per ulteriori informazioni vedere la sezione Osservazioni.

options

Opzionale. Oggetto che contiene una o più proprietà che specificano opzioni di confronto. Per ulteriori informazioni, vedere la sezione relativa alle note.

Il parametro locales deve rispettare il linguaggio BCP 47 o i tag per le impostazioni locali come "en-US" e "zh-Hans-cn". Il tag può includere il linguaggio, l'area, il paese e il variant. Per un elenco delle lingue, vedere la pagina relativa al registro dei sottotag delle lingue IANA. Per esempi di tag di lingua, vedere l'Appendice A di BCP 47. Per Collator, è possibile includere l'estensione -u nella stringa delle impostazioni locali per specificare almeno una delle estensioni Unicode seguenti:

  • - co per specificare le regole di confronto variant (specifiche delle impostazioni locali): "language-region- u-co-value".

  • -kn per specificare un confronto numerico: "language-region-u-kn-true|false".

  • –kf per specificare se ordinare innanzitutto i caratteri maiuscoli o minuscoli: "language-region-u-kf-upper|lower|false"). Questa estensione non è attualmente supportata.

Per specificare un confronto numerico, è possibile impostare: l'estensione del kn nella stringa delle impostazioni locali oppure utilizzare la proprietà numeric nel parametro options. Se si utilizza la proprietà numeric, il valore –kn non verrà applicato.

Il parametro options può includere le seguenti proprietà:

  • localeMatcher . Specifica l'algoritmo di corrispondenza delle impostazioni locali da utilizzare. I valori possibili sono "lookup" e "best fit". Il valore predefinito è "più appropriato".

  • usage . Specifica se l'obiettivo di confronto viene ordinato o cercato. I valori possibili sono "sort" e "search". Il valore predefinito è "ordinamento".

  • sensitivity . Specifica la sensibilità dell'utilità di confronto. I valori possibili sono "base", "accent", "case" e "variant". Il valore predefinito è undefined.

  • ignorePunctuation . Specifica se la punteggiatura viene ignorata nel confronto. I valori possibili sono "true" e "false". Il valore predefinito è false.

  • numeric . Specifica se l'ordinamento numerico viene utilizzato. I valori possibili sono "true" e "false". Il valore predefinito è false.

  • caseFirst . Attualmente non supportato.

Nella tabella seguente sono elencate le proprietà dell'oggetto Collator.

Proprietà

Descrizione

compare

Restituisce una funzione che confronta due stringhe utilizzando l'ordinamento dell'utilità di confronto.

Costruttore

Specifica la funzione che crea un'utilità di confronto

prototipo

Restituisce un riferimento al prototipo per un'utilità di confronto.

Nella tabella seguente sono elencati i metodi dell'oggetto Collator:

Metodo

Descrizione

resolvedOptions

Restituisce un oggetto che contiene le proprietà e i valori dell'utilità di confronto.

Nell'esempio seguente viene creato un oggetto Collator e viene eseguito un confronto.

var co = new Intl.Collator(["de-DE"]);
co.compare("a", "b"); // Returns -1

Il seguente esempio utilizza oggetti Collator per ordinare una matrice. Questo esempio mostra le differenze specifiche delle impostazioni locali.

var co1 = new Intl.Collator(["de-DE-u-co-phonebk"]);
var co2 = new Intl.Collator(["de-DE"]);
var co3 = new Intl.Collator(["en-US"]);

var arr = ["ä", "ad", "af", "a"];

if (console && console.log) {
    console.log(arr.sort(co1.compare));  // Returns a,ad,ä,af
    console.log(arr.sort(co2.compare));  // Returns a,ä,ad,af
    console.log(arr.sort(co3.compare));  // Returns a,ä,ad,af
}

Nell'esempio seguente viene utilizzato un oggetto Collator per trovare una stringa e specificare le opzioni di confronto.

// String to search
var arr = ["ä", "ad", "af", "a"];
// String searched for
var s = "af";

var co = new Intl.Collator("de-DE", { usage: "search" });
var matches = arr.filter(function (i) {
    return co.compare(i, s) === 0;
});

if (console && console.log) {
    console.log(matches);  // Returns af
}

Supportato nella modalità documento degli standard di Internet Explorer 11. Supportato anche nelle app di Windows Store (Windows 8,1 e Windows Phone 8.1). Vedere Informazioni sulla versione.

Non supportato nelle modalità documento seguenti: Quirks, standard di Internet Explorer 6, standard di Internet Explorer 7, standard di Internet Explorer 8, standard di Internet Explorer 9, standard di Internet Explorer 10. Non supportato in Windows 8.

Aggiunte alla community

Mostra:
© 2015 Microsoft