Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

Intl.Collator, objet (JavaScript)

Fournit des comparaisons de chaînes spécifiques aux paramètres régionaux.

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

collatorObj

Requis. Nom de variable à attribuer à l'objet Collator.

locales

Optionnel. Tableau de chaînes de paramètres régionaux qui contiennent une ou plusieurs balises de langue ou de paramètres régionaux. Si vous incluez plusieurs chaînes de paramètres régionaux, répertoriez-les dans l'ordre de priorité décroissant afin que la première entrée soit la valeur par défaut. Si vous omettez ce paramètre, les paramètres régionaux par défaut du runtime JavaScript sont utilisés. Pour plus d'informations, consultez la section Notes.

options

Optionnel. Objet qui contient une ou plusieurs propriétés qui spécifient les options de comparaison. Pour plus d'informations, consultez la section Notes.

Le paramètre locales doit respecter les balises de langue ou de paramètres régionaux BCP 47 telles que « en-US » et « zh-Hans-CN ». La balise peut inclure la langue, la région, le pays et la variante. Pour une liste des langues, consultez le registre de sous-balises de langage IANA. Pour obtenir des exemples de balises de langue, consultez Annexe A de BCP 47. Pour Collator, vous pouvez inclure l'extension -u à la chaîne de paramètres régionaux pour spécifier une ou plusieurs des extensions Unicode suivantes :

  • -co pour spécifier les classements variants (spécifiques aux paramètres régionaux) : "language-region-u-co-value".

  • -kn pour spécifier une comparaison numérique : "language-region-u-kn-true|false".

  • –kf pour spécifier s'il s'agit d'un tri par majuscules ou minuscules en premier : "language-region-u-kf-upper|lower|false"). Cette extension n'est actuellement pas prise en charge.

Pour spécifier une comparaison numérique, vous pouvez définir l'extension –kn dans la chaîne de paramètres régionaux ou utiliser la propriété numeric du paramètre options. Si vous utilisez la propriété numeric, la valeur –kn ne s'appliquera pas.

Le paramètre options peut inclure les propriétés suivantes :

  • localeMatcher . Spécifie l'algorithme de correspondance aux paramètres régionaux à utiliser. Les valeurs possibles sont « lookup » et « best fit ». La valeur par défaut est "best fit".

  • usage . Spécifie si l'objectif de la comparaison est le tri ou la recherche. Les valeurs possibles sont « sort » et « search ». La valeur par défaut est "sort".

  • sensitivity . Spécifie le critère de sensibilité de l'assembleur. Les valeurs possibles sont « base », « accent », « case » et « variant ». La valeur par défaut est undefined.

  • ignorePunctuation . Spécifie si la ponctuation est ignorée dans la comparaison. Les seules valeurs valides sont 'true' et 'false'. La valeur par défaut est false.

  • numeric . Spécifie si le tri numérique est utilisé. Les seules valeurs valides sont 'true' et 'false'. La valeur par défaut est false.

  • caseFirst . Non pris en charge actuellement.

Le tableau suivant répertorie les propriétés de l'objet Collator.

Propriété

Description

compare

Retourne une fonction qui compare deux chaînes à l'aide de l'ordre de tri de l'assembleur.

Constructeur

Spécifie la fonction qui crée un objet assembleur.

prototype

Retourne une référence au prototype d'un assembleur.

Le tableau suivant répertorie les méthodes de l'objet Collator.

Méthode

Description

resolvedOptions

Retourne un objet contenant des propriétés et des valeurs de l'assembleur.

L'exemple suivant crée un objet Collator et effectue une comparaison.

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

L'exemple suivant utilise des objets Collator pour trier un tableau. Cet exemple illustre les différences spécifiques aux paramètres régionaux.

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
}

L'exemple suivant utilise un objet Collator pour rechercher une chaîne et spécifie les options de comparaison.

// 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
}

Pris en charge dans le mode de document Internet Explorer 11 (mode normes). Également pris en charge dans les applications du Store (Windows 8.1 et Windows Phone 8.1). Voir Informations de version.

Non pris en charge dans les modes de document suivants : Quirks, Internet Explorer 6 (mode normes), Internet Explorer 7 (mode normes), Internet Explorer 8 (mode normes), Internet Explorer 9 (mode normes), Internet Explorer 10 (mode normes). Non pris en charge dans Windows 8.

Ajouts de la communauté

Afficher:
© 2014 Microsoft