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

localeCompare, méthode (String) (JavaScript)

Détermine si deux chaînes sont équivalentes dans les paramètres régionaux.


stringVar.localeCompare(stringExp[, locales][, options]) 

stringVar

Requis. Première chaîne à comparer.

stringExp

Requis. Deuxième chaîne à comparer.

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. Ce paramètre doit être conforme aux normes BCP 47. Consultez la section relative à l'objet Intl.Collator pour plus de détails.

options

Optionnel. Un objet qui contient une ou plusieurs propriétés qui spécifient des options de comparaison. consultez Intl.Collator object pour plus de détails.

Pour les chaînes de comparaison, vous pouvez spécifier des objets String ou des littéraux de chaîne.

À partir d'Internet Explorer 11, localeCompare utilise l'objet Intl.Collator en interne pour effectuer des comparaisons, ce qui ajoute la prise en charge des paramètres locales et options. Pour plus d'informations sur ces paramètres, consultez Intl.Collator et Intl.Collator.compare.

Remarque importante Important

Les paramètres locales et options ne sont pas pris en charge dans tous les modes de document et toutes les versions de navigateur. Pour plus d'informations, consultez la section Configuration requise.

La méthode localeCompare effectue une comparaison de chaînes sensible aux paramètres locaux de stringVar et stringExp et retourne l'un des résultats suivants, en fonction de l'ordre de tri des paramètres régionaux par défaut du système :

  • -1 si stringVar est placé avant dans l'ordre de tri stringExp.

  • +1 si stringVar est trié après stringExp.

  • 0 (zéro) si les deux chaînes sont équivalentes.

Le code suivant montre comment utiliser localeCompare :

var str1 = "def";
var str2 = "abc"

document.write(str1.localeCompare(str2) + "<br/>");

// Output: 1
var str3 = "ghi";

document.write(str1.localeCompare(str3)+ "<br/>");

// Output: -1
var str4 = "def";

document.write(str1.localeCompare(str4));

// Output: 0

Le code suivant montre comment utiliser localeCompare avec les paramètres régionaux allemands (Allemagne).

var str1 = "a";
var str2 = "b";

document.write(str1.localeCompare(str2, "de-DE"));

// Output
// - 1

L'exemple suivant montre comment utiliser localeCompare avec les paramètres régionaux allemands (Allemagne) et une extension spécifique aux paramètres régionaux qui spécifie l'ordre de tri pour les annuaires téléphoniques allemands. Cet exemple illustre les différences spécifiques aux paramètres régionaux.

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

document.write(arr[0].localeCompare(arr[1], "de-DE-u-co-phonebk"));  // Returns 1
document.write (arr[0].localeCompare(arr[2], "de-DE-u-co-phonebk"));  // Returns -1
document.write (arr[0].localeCompare(arr[3], "de-DE-u-co-phonebk"));  // Returns 1

document.write (arr[0].localeCompare(arr[1], "de-DE"));  // Returns -1
document.write (arr[0].localeCompare(arr[2], "de-DE"));  // Returns -1
document.write (arr[0].localeCompare(arr[3], "de-DE"));  // Returns 1

Pris en charge dans les modes de document suivants : Quirks, Internet Explorer 6 (mode standard), Internet Explorer 7 (mode standard), Internet Explorer 8 (mode standard), Internet Explorer 9 (mode standard), Internet Explorer 10 (mode standard), Internet Explorer 11 (mode standard). Également pris en charge dans les applications Store (Windows 8 et Windows Phone 8.1). Consultez Informations de version.

Paramètres locales et options :

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

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

Ajouts de la communauté

Afficher:
© 2014 Microsoft