globalization.numberToString

Renvoie un nombre mis en forme comme une chaîne selon les préférences de l'utilisateur du client.

navigator.globalization.numberToString(number, successCallback, errorCallback, options);

Description

Retourne la chaîne mise en forme de nombre à la successCallback avec un properties objet comme paramètre. Cet objet doit avoir une value propriété avec une String valeur.

S'il y a une erreur de mise en forme le nombre, puis le errorCallback s'exécute avec un [GlobalizationError](GlobalizationError/globalizationerror.html) objet comme paramètre. Code attendu de l'erreur est[GlobalizationError](GlobalizationError/globalizationerror.html).FORMATTING\_ERROR.

Le options paramètre est facultatif, et ses valeurs par défaut sont :

{type: « decimal »}

Le options.type peut être « decimal », « % » ou « monnaie ».

Plates-formes prises en charge

  • Android
  • BlackBerry WebWorks (OS 5.0 et plus)
  • iOS
  • Windows Phone 8

Petit exemple

Lorsque le navigateur est configuré pour la en\_US locale, cela permet d'afficher une boîte de dialogue contextuelle avec un texte semblable à number: 3.142 :

navigator.globalization.numberToString(
    3.1415926,
    function (number) {alert('number: ' + number.value + '\n');},
    function () {alert('Error getting number\n');},
    {type:'decimal'}
);

Exemple complet

<!DOCTYPE HTML>
<html>
  <head>
    <title>numberToString Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkNumber() {
      navigator.globalization.numberToString(
        3.1415926,
        function (number) {alert('number: ' + number.value + '\n');},
        function () {alert('Error getting number\n');},
        {type:'decimal'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkNumber()">Click for number</button>
  </body>
</html>