Numnote
Français (Luxembourg)

Le calculateur Numnote sur votre site

Un calculateur gratuit à placer sur n’importe quelle page web. Il calcule la formule que votre site lui transmet, la vôtre ou une formule copiée depuis une page de formule de numnote.com. Il n’exige ni inscription ni clé et n’envoie aucune requête à un tiers.

Démarrage rapide

Votre propre formule demande trois étapes ; le code copié depuis une page de formule est encore plus court, car il tient en un seul extrait.

  1. Chargez le script d’intégration une seule fois par page, avant votre propre code.

    HTML
    <script src="https://numnote.com/embed/v1.js"></script>
  2. Placez dans votre HTML un élément conteneur, à l’endroit où le calculateur doit apparaître.

    HTML
    <div id="calculator"></div>
  3. Appelez la fonction Numnote.embed avec la définition (la description de la formule) : le cadre apparaît dans le conteneur et règle lui-même sa hauteur.

    JavaScript
    Numnote.embed("#calculator", {
        "v": 1,
        "formula": "(morning + evening) / 2",
        "fields": {
          "morning": {
            "name": "Matin",
            "unit": "km",
            "value": "12.5"
          },
          "evening": {
            "name": "Soir",
            "unit": "km",
            "value": "9"
          }
        },
        "result": {
          "name": "Moyenne",
          "unit": "km"
        }
      }, {
      region: "fr-lu"
    });

Vous ne voulez pas écrire la calculatrice à la main ? Composez-la dans le constructeur.

Code d’une page de formule

Chaque page de formule du site propose son code sous le libellé « Intégrer sur votre site », en deux variantes. Collé dans votre HTML, il affiche le calculateur avec ses champs et son résultat à l’endroit où vous l’avez collé. Une fois copié, le code vous appartient : les corrections apportées ensuite à la formule sur numnote.com ne l’atteignent pas.

Le code de la première formule de ce site :

Script

La variante script est à préférer : elle transmet le résultat à votre propre code, sa hauteur s’adapte à la définition et elle signale quand la définition est refusée. Elle ne peut pas servir là où le site n’autorise pas les scripts.

HTML
<div id="numnote-percent_of"></div>
<script src="https://numnote.com/embed/v1.js"></script>
<script>
  Numnote.embed("#numnote-percent_of", {
    "v": 1,
    "formula": "p0 * p1",
    "fields": {
      "p0": {
        "name": "nombre",
        "value": "260"
      },
      "p1": {
        "name": "pourcentage",
        "value": "15",
        "percent": true
      }
    },
    "result": {
      "name": "pourcentage de"
    }
  }, { region: "fr-lu" });
</script>
<p><a href="https://numnote.com/fr-lu/calc/pourcentage-de/">Calculateur de pourcentage d’un nombre · Numnote</a></p>

Lien

La variante iframe est un cadre unique dont l’adresse contient la définition, pour les sites qui n’autorisent qu’un iframe. Elle ne décale rien sur la page, mais elle ne transmet à votre code ni le résultat ni l’avis de refus, et sa hauteur est fixée d’avance : dans une colonne plus étroite, le cadre défile en lui-même.

HTML
<iframe src="https://numnote.com/fr-lu/embed/custom/#%7B%22v%22:1,%22formula%22:%22p0%20*%20p1%22,%22fields%22:%7B%22p0%22:%7B%22name%22:%22nombre%22,%22value%22:%22260%22%7D,%22p1%22:%7B%22name%22:%22pourcentage%22,%22value%22:%2215%22,%22percent%22:true%7D%7D,%22result%22:%7B%22name%22:%22pourcentage%20de%22%7D%7D" title="pourcentage de" width="100%" height="348" style="border:0" loading="lazy"></iframe>
<p><a href="https://numnote.com/fr-lu/calc/pourcentage-de/">Calculateur de pourcentage d’un nombre · Numnote</a></p>

Chaque variante se termine par un lien visible vers la page de la formule. Ce lien se trouve hors du cadre, sur votre propre page ; gardez-le, car c’est ainsi que les lecteurs et les moteurs de recherche trouvent la formule.

En intégrant le calculateur sur votre site, vous acceptez les conditions d’intégration.

Attributs du lien

AttributValeurRôle
srchttps://numnote.com/fr-lu/embed/custom/#<form>L’adresse du cadre : la définition vient après le signe #, et la région indiquée dans l’adresse fixe la langue et le format des nombres.
titletexteLe nom de la formule, lu par les lecteurs d’écran ; vous pouvez le laisser tel quel ou le traduire.
width100%Le cadre occupe toute la largeur de son conteneur ; limitez la largeur avec le conteneur, pas avec le cadre.
height348La hauteur est fixée d’après le nombre de champs : c’est la place que prend le contenu dans une colonne de 320 px. Dans une colonne plus étroite, le cadre défile en lui-même.
loadinglazyLe cadre ne se charge que lorsque le visiteur fait défiler la page jusqu’à lui.

Votre propre formule

Chargez le script d’intégration et transmettez-lui la définition : la formule, ses champs et le nom du résultat. Le cadre dessine les champs, recalcule pendant que le visiteur saisit des nombres et répond à votre page.

Installation

Le script d’intégration tient en un seul fichier, sans dépendance. Il crée le cadre, envoie la définition une fois le cadre chargé, règle la hauteur du cadre et appelle vos fonctions. Chargez-le depuis numnote.com plutôt que de le copier : vous recevez ainsi les corrections.

HTML
<script src="https://numnote.com/embed/v1.js"></script>

L’appel

Le conteneur peut être un sélecteur CSS ou l’élément lui-même. La définition est décrite dans la section « Définition », les paramètres dans la « Référence de l’API ».

HTML
<div id="calculator"></div>
<script src="https://numnote.com/embed/v1.js"></script>
<script>
  Numnote.embed("#calculator", {
      "v": 1,
      "formula": "(morning + evening) / 2",
      "fields": {
        "morning": {
          "name": "Matin",
          "unit": "km",
          "value": "12.5"
        },
        "evening": {
          "name": "Soir",
          "unit": "km",
          "value": "9"
        }
      },
      "result": {
        "name": "Moyenne",
        "unit": "km"
      }
    }, {
    region: "fr-lu",
    onResult: function (answer) { console.log(answer.text); },
    onError: function (code, detail) { console.log(code, detail.at); }
  });
</script>

En direct Voici le cadre que crée le code ci-dessus : il fonctionne sur cette page même, vous pouvez donc modifier un nombre et voir le résultat se recalculer.

Le cadre affiche toujours la ligne « powered by Numnote », sauf sur un site bloqué, et la version 1 n’a aucune clé qui la retire. Il ne répond qu’à la page qui a envoyé la définition, et il écrit vos noms et vos unités en texte brut, jamais en balisage.

En intégrant le calculateur sur votre site, vous acceptez les conditions d’intégration.

Référence de l’API

Numnote.embed(target, form, options)

Crée le cadre dans le conteneur, envoie la définition et renvoie un objet qui permet de mettre à jour ou de retirer le cadre.

ParamètreTypeRôle
targettexte | ElementUn sélecteur CSS ou un élément dans lequel le cadre est placé. Sans élément, le script lève une TypeError.
formobjetUne définition de version 1, décrite plus bas.
optionsobjet, facultatifRéglages facultatifs : region, onResult, onError.

L’objet options

ParamètreTypeRôle
regiontexte, facultatifLa région du cadre : la langue de ses propres mots et le format des nombres. C’est la clé d’une région pour laquelle cette page existe, par exemple uk-ua, en-us, en-gb ; une langue seule (uk, en) mène à sa région principale. Sans ce réglage, le script utilise en-us ; avec la clé d’une région qui n’existe pas, le cadre reste vide.
onResultfonction, facultativeAppelée avec l’objet résultat à chaque calcul : après le chargement et après chaque modification d’un nombre.
onErrorfonction, facultativeAppelée avec un code d’erreur et l’objet message quand la définition est refusée ou que le calcul échoue.

Valeur renvoyée

MembreTypeRôle
frameHTMLIFrameElementL’élément iframe, pour lui donner votre propre classe ou un style.
update(form)fonctionEnvoie une nouvelle définition dans le même cadre : les champs sont redessinés et la hauteur est de nouveau réglée.
destroy()fonctionRetire le cadre et supprime l’écouteur de messages.

L’objet résultat de onResult

MembreTypeRôle
typetexteToujours la chaîne « result ».
nametexteLe nom du résultat, tel que vous l’avez donné dans la définition.
figuretexteLe nombre mis en forme pour la région, tel que le visiteur le voit.
unittexteL’unité du résultat ou une chaîne vide.
texttexteLe nombre suivi de son unité, en une seule chaîne.

L’appel de onError

ParamètreTypeRôle
codetexteUn code du tableau des erreurs, par exemple UNKNOWN_SLOT.
detailobjetLe message du cadre : type « error », code et at, où at désigne l’endroit : l’identifiant d’un champ, « formula », « fields », « result.unit ».

Messages du cadre

Le script d’intégration n’est qu’une commodité. Le cadre fonctionne avec n’importe quelle page grâce à postMessage : la page envoie la définition, et le cadre répond par trois sortes de messages.

MessageFormatRôle
form, envoyé par vous{ v: 1, formula, fields, result }Votre page envoie une définition de version 1 au cadre une fois celui-ci chargé. Origine cible : numnote.com.
result{ type: "result", name, figure, unit, text }Le résultat est calculé ; ses champs sont décrits dans l’objet résultat ci-dessus.
height{ type: "height", height }La hauteur du contenu, en pixels. Appliquez-la au cadre pour éviter la barre de défilement.
error{ type: "error", code, at }La définition a été refusée ou le calcul a échoué : le message contient code et at.

Le cadre ne répond qu’à la fenêtre qui a envoyé la définition, et seulement à son origine. Un message sans aucune des clés v, formula, fields et result est tenu pour étranger et ne reçoit aucune réponse.

Définition

La définition est un objet JSON unique, de version 1. Vous écrivez les noms et les unités avec vos propres mots : le cadre les affiche en texte brut et ne les traduit jamais.

CléTypeRôle
vnombreToujours 1. Le cadre refuse toute autre valeur.
formulatexteLe calcul, écrit avec les identifiants des champs, les opérations et les fonctions décrites plus bas.
fieldsobjetLa liste des champs, dans l’ordre où ils sont dessinés. Chaque clé est l’identifiant du champ, le nom que la formule emploie pour lui (lettres latines, chiffres et tirets bas, jamais un chiffre en premier) ; la formule doit utiliser tous les champs.
fields.<id>.nametexteLe libellé que le visiteur de votre site voit au-dessus du champ.
fields.<id>.unittexte, facultatifL’unité du champ, écrite comme un radical de la liste des unités ; tout autre texte n’est affiché que comme légende à côté du champ et ne convertit rien.
fields.<id>.valuetexte, facultatifLa valeur que le champ affiche à l’ouverture, toujours écrite avec un point décimal, quelle que soit la langue.
fields.<id>.percenttrue ou false, facultatifÀ mettre sur true quand le champ contient un pourcentage : le visiteur saisit 20 pour 20 %, et chaque emploi du champ dans la formule le lit comme un pourcentage. Après une addition ou une soustraction, c’est donc une part de la partie de gauche. Le champ affiche le signe % à la place de l’unité.
resultobjetLe résultat que le cadre affiche sous les champs.
result.nametexteLe libellé affiché pour le résultat.
result.unittexte, facultatifL’unité du résultat ; ce doit être celle que donne la formule, sinon la définition est refusée.
result.percenttrue ou false, facultatifÀ mettre sur true quand la formule donne son résultat en pourcentage : un résultat de 25 s’affiche sous la forme 25 %.
keytexte, facultatifCette clé est réservée pour plus tard ; la version 1 du cadre l’ignore.

Définition minimale

La définition minimale comprend un seul champ sans unité et un résultat sans unité ; tout le reste est facultatif.

JSON
{
  "v": 1,
  "formula": "price + 20 %",
  "fields": {
    "price": {
      "name": "Prix"
    }
  },
  "result": {
    "name": "Taxe comprise"
  }
}

Définition complète

La définition complète montre toutes les clés que connaît la version 1 : des unités, des valeurs de départ, un champ en pourcentage et un résultat en pourcentage.

JSON
{
  "v": 1,
  "formula": "(after - before) / before * 100",
  "fields": {
    "before": {
      "name": "Avant",
      "unit": "kg",
      "value": "80"
    },
    "after": {
      "name": "Après",
      "unit": "kg",
      "value": "76"
    }
  },
  "result": {
    "name": "Variation",
    "percent": true
  },
  "key": ""
}

Exemples

Chaque exemple s’exécute sur cette page avec le même script d’intégration que vous utiliserez sur la vôtre ; le code à côté de chaque cadre est complet, vous pouvez donc le copier et remplacer les mots par les vôtres.

Pourcentage : carrelage avec une marge de chutes

Le champ des chutes porte percent: true ; après l’addition, il se lit comme une part de la surface, donc 10 signifie la surface plus 10 % de celle-ci. Le résultat est divisé par la surface d’un paquet et reste un nombre sans unité.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "(w * l + spare) / pack",
    "fields": {
      "w": {
        "name": "Largeur de la pièce",
        "unit": "m",
        "value": "3.2"
      },
      "l": {
        "name": "Longueur de la pièce",
        "unit": "m",
        "value": "4.5"
      },
      "spare": {
        "name": "Marge de coupe supplémentaire",
        "percent": true,
        "value": "10"
      },
      "pack": {
        "name": "Surface couverte par un paquet",
        "unit": "m²",
        "value": "1.44"
      }
    },
    "result": {
      "name": "Paquets"
    }
  }, {
  region: "fr-lu"
});

Fonction : la diagonale d’un rectangle

Une fonction s’écrit avec ses arguments entre parenthèses. Les champs n’ont pas d’unité, car la version 1 ne sait pas prendre la racine d’une unité.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "sqrt(a ^ 2 + b ^ 2)",
    "fields": {
      "a": {
        "name": "Côté a du rectangle",
        "value": "3"
      },
      "b": {
        "name": "Côté b du rectangle",
        "value": "4"
      }
    },
    "result": {
      "name": "Diagonale du rectangle"
    }
  }, {
  region: "fr-lu"
});

Résultat en pourcentage : la part des dépenses

result.percent: true affiche le résultat avec le signe %. La formule donne son résultat en pourcentage, donc la multiplication par 100 est écrite dans la formule elle-même.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "part / total * 100",
    "fields": {
      "part": {
        "name": "Dépenses d’alimentation",
        "value": "250"
      },
      "total": {
        "name": "Ensemble des dépenses",
        "value": "1000"
      }
    },
    "result": {
      "name": "Part",
      "percent": true
    }
  }, {
  region: "fr-lu"
});

Région : langue et format des nombres

La même définition dans deux régions. La région fixe les séparateurs des nombres et les mots propres au cadre, tandis que vos libellés restent tels que vous les avez écrits.

JavaScript
Numnote.embed("#calculator-a", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Distance parcourue",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Jours",
        "value": "4"
      }
    },
    "result": {
      "name": "Par jour",
      "unit": "km"
    }
  }, {
  region: "fr-lu"
});
Numnote.embed("#calculator-b", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Distance parcourue",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Jours",
        "value": "4"
      }
    },
    "result": {
      "name": "Par jour",
      "unit": "km"
    }
  }, {
  region: "uk-ua"
});

region: "fr-lu"

region: "uk-ua"

update() et destroy()

Le script renvoie un objet. update envoie une autre définition dans le même cadre ; destroy retire le cadre de la page. Appuyez sur un bouton ci-dessous.

JavaScript
var calc = Numnote.embed("#calculator", formA, { region: "fr-lu" });
calc.update(formB);   // Trois champs
calc.destroy();       // Retirer

Erreurs : votre propre message à la place d’un cadre vide

Une définition refusée ne dessine rien, le cadre reste donc vide. onError reçoit le code d’erreur et son emplacement, ce qui permet à votre page d’informer le visiteur ou de masquer le conteneur. Dans cet exemple, la formule nomme un champ que la définition n’a pas.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "area / coverage",
    "fields": {
      "area": {
        "name": "Surface",
        "unit": "m²",
        "value": "40"
      }
    },
    "result": {
      "name": "Peinture"
    }
  }, {
  region: "fr-lu",
  onError: function (code, detail) {
    document.getElementById("calculator").hidden = true;
    message.textContent = "Le calculateur n’a pas pu se charger :" + " " + code + " (" + detail.at + ")";
  }
});

Sans le script : dialoguer avec le cadre par postMessage

Quand le script d’intégration ne convient pas, par exemple dans un framework qui a son propre cycle de vie, dialoguez vous-même avec le cadre. C’est le même cadre et les mêmes messages.

HTML
<iframe id="calculator" src="https://numnote.com/fr-lu/embed/custom/" style="border:0;width:100%"></iframe>
<script>
  var frame = document.getElementById("calculator");
  var origin = "https://numnote.com";
  frame.addEventListener("load", function () {
    frame.contentWindow.postMessage({
      "v": 1,
      "formula": "a + b",
      "fields": {
        "a": {
          "name": "Premier",
          "value": "1"
        },
        "b": {
          "name": "Deuxième",
          "value": "2"
        }
      },
      "result": {
        "name": "Somme"
      }
    }, origin);
  });
  window.addEventListener("message", function (e) {
    if (e.origin !== origin || e.source !== frame.contentWindow) return;
    if (e.data.type === "height") frame.style.height = e.data.height + "px";
    if (e.data.type === "result") console.log(e.data.text);
    if (e.data.type === "error") console.warn(e.data.code, e.data.at);
  });
</script>

Formule

Le navigateur lit la formule. Il accepte les nombres avec un point, les identifiants de champs, les parenthèses et les opérations usuelles.

Après une addition ou une soustraction, un pourcentage désigne une part de la partie de gauche, comme dans l’application Numnote elle-même. Un produit s’écrit toujours avec son signe : le cadre refuse 2a.

Une unité ne s’écrit jamais dans la formule, car elle appartient au champ.

Opérations

NotationRôleExemple
12.5Un nombre. Dans une formule, le séparateur décimal est toujours un point.price * 1.2
a_1Un identifiant de champ : lettres latines, chiffres, tirets bas ; il ne commence pas par un chiffre.width * height
+ -Addition et soustraction.a + b - c
* /Multiplication et division. Un produit s’écrit toujours avec son signe.2 * a / b
modReste d’une division (modulo).n mod 7
^Puissance.a ^ 2
!Factorielle.n!
%Pourcentage : après + ou −, une part de la partie de gauche ; ailleurs, un centième.price + 20 %
( )Les parenthèses fixent l’ordre des opérations.(a + b) / 2
f(x, y)Une fonction, avec ses arguments séparés par des virgules.root(x, 3)

Fonctions

Une fonction s’écrit avec ses arguments entre parenthèses, séparés par des virgules. La liste ci-dessous est générée à partir du registre des fonctions de Numnote :

  • sin (un argument)
  • cos (un argument)
  • tg, tan (un argument)
  • ctg, cot (un argument)
  • arcsin, asin (un argument)
  • arccos, acos (un argument)
  • arctg, arctan, atan (un argument)
  • arcctg, arccot, acot (un argument)
  • sh, sinh (un argument)
  • ch, cosh (un argument)
  • th, tanh (un argument)
  • cth, coth (un argument)
  • arsh, arsinh, asinh (un argument)
  • arch, arcosh, acosh (un argument)
  • arth, artanh, atanh (un argument)
  • arcth, arcoth, acoth (un argument)
  • ln (un argument)
  • sqrt (un argument)
  • abs (un argument)
  • ceil (un argument)
  • floor (un argument)
  • round (un argument)
  • log (un ou deux arguments)
  • root (deux arguments)

Numnote connaît aussi ces fonctions, mais le cadre ne sait pas encore les exécuter ; une formule qui en appelle une est refusée avec le code d’erreur UNSUPPORTED_FUNCTION :

Unités

L’unité d’un champ ou du résultat s’écrit dans la définition comme un radical d’unité de la liste ci-dessous, générée à partir du registre des unités de Numnote. Un texte absent de la liste n’est affiché que comme légende et ne convertit rien.

  • m
  • cm
  • mm
  • km
  • in
  • ft
  • yd
  • mi
  • m²
  • cm²
  • mm²
  • km²
  • a
  • ha
  • ft²
  • yd²
  • ac
  • m³
  • L
  • mL
  • cm³
  • dm³
  • USgal
  • kg
  • g
  • t
  • lb
  • oz
  • s
  • min
  • h
  • d
  • mo
  • wk
  • yr
  • J
  • Wh
  • kWh
  • MWh
  • cal
  • kcal
  • W
  • kW
  • Pa
  • bar
  • atm
  • mmHg
  • psi
  • N
  • V
  • A
  • Ohm
  • Hz
  • K
  • °C
  • °F
  • rad
  • °
  • mol
  • pc
  • pk
  • ARS
  • AUD
  • BRL
  • CAD
  • CHF
  • CLP
  • CNY
  • COP
  • CZK
  • DKK
  • EUR
  • GBP
  • HKD
  • HUF
  • IDR
  • ILS
  • INR
  • ISK
  • JPY
  • KRW
  • MXN
  • MYR
  • NOK
  • NZD
  • PHP
  • PLN
  • RON
  • SEK
  • SGD
  • THB
  • TRY
  • UAH
  • USD
  • ZAR

Quand l’unité d’un champ a d’autres unités de la même grandeur, le visiteur choisit celle qu’il veut directement dans le champ : le nombre reste et le résultat est recalculé. Une légende absente de la liste des unités reste du texte simple, sans choix. Quand des champs portent des unités différentes d’une même grandeur (des centimètres et des mètres), le cadre les convertit lui-même et la formule ne voit qu’une seule grandeur.

Règle de la version 1 : une unité ne peut rencontrer que la même unité ou un nombre simple. Le cadre refuse une somme d’unités différentes, un produit de deux unités, ainsi que la puissance ou la racine d’une unité, avec le code d’erreur UNITS_DO_NOT_MEET.

Ce qui est acceptéRôle
km + kmune unité et la même unité (m plus m)
km * 2une unité et un nombre (m fois 2)
km / kmun quotient de deux unités identiques, qui donne un nombre simple sans unité
km + 10 %un pourcentage d’une valeur avec unité, qui garde cette même unité
Ce qui est refuséRôle
km + kgune somme d’unités différentes (m plus kg)
m * mun produit de deux unités (m fois m)
sqrt(m)la puissance d’une unité ou la racine d’une unité
km / hun quotient d’unités différentes (m divisé par s)

Limites

  • Une définition compte au plus 8 champs.
  • Une formule compte au plus 500 caractères.

Une définition qui dépasse les limites est refusée et rien n’est dessiné. Le cadre prend toute la largeur de son conteneur, et sa hauteur suit son contenu.

Erreurs

Le cadre signale une erreur sous la forme d’un objet de type « error » avec un code et une clé at qui indique où elle a été trouvée (l’identifiant d’un champ, « formula », « fields », « result.name », etc.). Le script d’intégration transmet le code au rappel onError.

Définition illisible ou invalide

CodeRôle
NOT_JSONLe message envoyé par la page hôte n’est pas du JSON.
NOT_AN_OBJECTLe message, un champ ou le résultat n’est pas un objet JSON.
VERSIONLa clé de version est absente ou sa valeur n’est pas 1.
MISSINGUne clé obligatoire de la définition est absente.
WRONG_TYPEUne valeur a un mauvais type JSON.
UNKNOWN_KEYLa définition contient une clé que la version 1 ne connaît pas.
TOO_LONGLa formule dépasse le nombre de caractères autorisé.
TOO_MANY_FIELDSLa définition déclare plus de champs que le maximum autorisé.
BAD_SLOT_IDL’identifiant d’un champ ne respecte pas la règle des identifiants, ou c’est le mot mod ou un nom de fonction.
EMPTY_NAMEUn nom est une chaîne vide.
BAD_VALUELa valeur de départ d’un champ n’est pas un nombre décimal écrit avec un point (comme 12.5).
UNUSED_FIELDUn champ est déclaré dans la définition, mais la formule ne l’utilise pas.
EMPTY_FORMULALa formule est vide.
BAD_CHARACTERLa formule contient un caractère qui n’est admis nulle part dans une formule.
UNEXPECTEDUn caractère est placé là où la syntaxe ne l’admet pas (deux opérateurs de suite, par exemple).
UNCLOSEDUne parenthèse est ouverte, mais jamais fermée.
TOO_DEEPLa formule est trop imbriquée.
UNKNOWN_SLOTLa formule cite un champ que le formulaire ne déclare pas.
UNKNOWN_FUNCTIONLa formule appelle une fonction qui n’existe pas.
UNSUPPORTED_FUNCTIONCette fonction existe dans Numnote, mais le cadre ne sait pas encore l’exécuter.
WRONG_ARGUMENTSUne fonction est appelée avec trop ou pas assez d’arguments.
UNIT_IN_FORMULAUne unité est écrite dans la formule. Donnez-la plutôt au champ.
UNITS_DO_NOT_MEETLes unités de l’opération ne peuvent pas se combiner. Voir la section sur les unités.
RESULT_UNITLa formule donne une autre unité que celle déclarée pour le résultat.
BLOCKEDLe site ou la page qui contient le cadre figure sur la liste de blocage, ou une page de la chaîne de cadres masque son adresse. Le cadre ne calcule pas et affiche, à la place de la mention « powered by Numnote », une ligne qui signale le blocage.

Erreurs de calcul

CodeRôle
UNKNOWN_UNITUne valeur a été saisie dans une unité que son champ n’accepte pas.
DIVISION_BY_ZERODivision par zéro.
ROOT_OF_NEGATIVERacine d’indice pair (racine carrée, etc.) d’un nombre négatif.
ROOT_DEGREE_INVALIDL’indice de la racine n’est pas un entier naturel (1, 2, 3…).
LOG_BASE_INVALIDLa base du logarithme est négative, nulle ou égale à 1.
LOG_ARGUMENT_NOT_POSITIVEL’argument du logarithme est nul ou négatif.
OVERFLOWLe résultat est trop grand pour être représenté.
TAN_UNDEFINEDLa tangente n’est pas définie pour cet angle.
COT_UNDEFINEDLa cotangente n’est pas définie pour cet angle (par exemple 0 degré).
ASIN_OUT_OF_DOMAINL’argument de l’arcsinus est hors de son domaine (de −1 à 1).
ACOS_OUT_OF_DOMAINL’argument de l’arccosinus est hors de son domaine (de −1 à 1).
COTH_OUT_OF_DOMAINImpossible de calculer la cotangente hyperbolique : son argument est nul.
ACOSH_OUT_OF_DOMAINImpossible de calculer le cosinus hyperbolique réciproque : l’argument est inférieur à 1.
ATANH_OUT_OF_DOMAINImpossible de calculer la tangente hyperbolique réciproque : l’argument doit être strictement compris entre −1 et 1.
ACOTH_OUT_OF_DOMAINImpossible de calculer la cotangente hyperbolique réciproque : la valeur absolue de l’argument doit être supérieure à 1.
FACTORIAL_DOMAINUne factorielle demande un entier naturel.
NOT_A_NUMBERUn champ contient du texte qui n’est pas un nombre.
BAD_PROGRAMLa formule n’a pas pu être exécutée à cause d’une erreur interne de Numnote. Écrivez à Numnote pour la signaler.

Sécurité et confidentialité

  • Le cadre répond uniquement à la fenêtre qui a envoyé le formulaire, et seulement à l’origine de cette fenêtre (schéma, hôte et port) : une autre page ne peut pas lire les réponses.
  • Vos noms et vos unités deviennent des nœuds de texte, jamais du balisage : une balise HTML dans un nom s’affiche comme du texte brut.
  • Le cadre et le script d’aide se chargent uniquement depuis numnote.com : aucun script tiers, aucun cookie, aucun traceur. Les nombres que le visiteur saisit ne quittent jamais son navigateur.
  • Le cadre affiche toujours la mention « powered by Numnote » et un lien vers les pages légales : c’est sa condition d’utilisation. Sur un site bloqué, il ne calcule pas et affiche à la place de cette mention une ligne qui l’indique.

Versions

  • Le formulaire porte la clé v avec la valeur 1. Toute version ultérieure du cadre lit un formulaire de version 1 de la même façon : un calculateur intégré continue donc de fonctionner.
  • Les listes de fonctions et d’unités s’allongent sans changer de version : une fonction pas encore prise en charge le sera un jour, et les formulaires qui l’attendent se mettront alors à calculer.
  • La clé nommée key est réservée à une version future : la version 1 l’ignore, et un formulaire qui la contient est donc accepté.

Une question ou une anomalie à signaler ? Écrivez à support@numnote.com.