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.
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>Placez dans votre HTML un élément conteneur, à l’endroit où le calculateur doit apparaître.
HTML <div id="calculator"></div>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.
<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.
<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
| Attribut | Valeur | Rôle |
|---|---|---|
src | https://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. |
title | texte | Le nom de la formule, lu par les lecteurs d’écran ; vous pouvez le laisser tel quel ou le traduire. |
width | 100% | Le cadre occupe toute la largeur de son conteneur ; limitez la largeur avec le conteneur, pas avec le cadre. |
height | 348 | La 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. |
loading | lazy | Le 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.
<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 ».
<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ètre | Type | Rôle |
|---|---|---|
target | texte | Element | Un sélecteur CSS ou un élément dans lequel le cadre est placé. Sans élément, le script lève une TypeError. |
form | objet | Une définition de version 1, décrite plus bas. |
options | objet, facultatif | Réglages facultatifs : region, onResult, onError. |
L’objet options
| Paramètre | Type | Rôle |
|---|---|---|
region | texte, facultatif | La 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. |
onResult | fonction, facultative | Appelée avec l’objet résultat à chaque calcul : après le chargement et après chaque modification d’un nombre. |
onError | fonction, facultative | Appelé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
| Membre | Type | Rôle |
|---|---|---|
frame | HTMLIFrameElement | L’élément iframe, pour lui donner votre propre classe ou un style. |
update(form) | fonction | Envoie une nouvelle définition dans le même cadre : les champs sont redessinés et la hauteur est de nouveau réglée. |
destroy() | fonction | Retire le cadre et supprime l’écouteur de messages. |
L’objet résultat de onResult
| Membre | Type | Rôle |
|---|---|---|
type | texte | Toujours la chaîne « result ». |
name | texte | Le nom du résultat, tel que vous l’avez donné dans la définition. |
figure | texte | Le nombre mis en forme pour la région, tel que le visiteur le voit. |
unit | texte | L’unité du résultat ou une chaîne vide. |
text | texte | Le nombre suivi de son unité, en une seule chaîne. |
L’appel de onError
| Paramètre | Type | Rôle |
|---|---|---|
code | texte | Un code du tableau des erreurs, par exemple UNKNOWN_SLOT. |
detail | objet | Le 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.
| Message | Format | Rô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é | Type | Rôle |
|---|---|---|
v | nombre | Toujours 1. Le cadre refuse toute autre valeur. |
formula | texte | Le calcul, écrit avec les identifiants des champs, les opérations et les fonctions décrites plus bas. |
fields | objet | La 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>.name | texte | Le libellé que le visiteur de votre site voit au-dessus du champ. |
fields.<id>.unit | texte, facultatif | L’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>.value | texte, facultatif | La valeur que le champ affiche à l’ouverture, toujours écrite avec un point décimal, quelle que soit la langue. |
fields.<id>.percent | true 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é. |
result | objet | Le résultat que le cadre affiche sous les champs. |
result.name | texte | Le libellé affiché pour le résultat. |
result.unit | texte, facultatif | L’unité du résultat ; ce doit être celle que donne la formule, sinon la définition est refusée. |
result.percent | true 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 %. |
key | texte, facultatif | Cette 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.
{
"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.
{
"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é.
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é.
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.
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.
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.
var calc = Numnote.embed("#calculator", formA, { region: "fr-lu" });
calc.update(formB); // Trois champs
calc.destroy(); // RetirerErreurs : 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.
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.
<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
| Notation | Rôle | Exemple |
|---|---|---|
12.5 | Un nombre. Dans une formule, le séparateur décimal est toujours un point. | price * 1.2 |
a_1 | Un 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 |
mod | Reste 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.
mcmmmkminftydmim²cm²mm²km²ahaft²yd²acm³LmLcm³dm³USgalkggtlbozsminhdmowkyrJWhkWhMWhcalkcalWkWPabaratmmmHgpsiNVAOhmHzK°C°Frad°molpcpkARSAUDBRLCADCHFCLPCNYCOPCZKDKKEURGBPHKDHUFIDRILSINRISKJPYKRWMXNMYRNOKNZDPHPPLNRONSEKSGDTHBTRYUAHUSDZAR
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 + km | une unité et la même unité (m plus m) |
km * 2 | une unité et un nombre (m fois 2) |
km / km | un 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 + kg | une somme d’unités différentes (m plus kg) |
m * m | un produit de deux unités (m fois m) |
sqrt(m) | la puissance d’une unité ou la racine d’une unité |
km / h | un 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
| Code | Rôle |
|---|---|
NOT_JSON | Le message envoyé par la page hôte n’est pas du JSON. |
NOT_AN_OBJECT | Le message, un champ ou le résultat n’est pas un objet JSON. |
VERSION | La clé de version est absente ou sa valeur n’est pas 1. |
MISSING | Une clé obligatoire de la définition est absente. |
WRONG_TYPE | Une valeur a un mauvais type JSON. |
UNKNOWN_KEY | La définition contient une clé que la version 1 ne connaît pas. |
TOO_LONG | La formule dépasse le nombre de caractères autorisé. |
TOO_MANY_FIELDS | La définition déclare plus de champs que le maximum autorisé. |
BAD_SLOT_ID | L’identifiant d’un champ ne respecte pas la règle des identifiants, ou c’est le mot mod ou un nom de fonction. |
EMPTY_NAME | Un nom est une chaîne vide. |
BAD_VALUE | La valeur de départ d’un champ n’est pas un nombre décimal écrit avec un point (comme 12.5). |
UNUSED_FIELD | Un champ est déclaré dans la définition, mais la formule ne l’utilise pas. |
EMPTY_FORMULA | La formule est vide. |
BAD_CHARACTER | La formule contient un caractère qui n’est admis nulle part dans une formule. |
UNEXPECTED | Un caractère est placé là où la syntaxe ne l’admet pas (deux opérateurs de suite, par exemple). |
UNCLOSED | Une parenthèse est ouverte, mais jamais fermée. |
TOO_DEEP | La formule est trop imbriquée. |
UNKNOWN_SLOT | La formule cite un champ que le formulaire ne déclare pas. |
UNKNOWN_FUNCTION | La formule appelle une fonction qui n’existe pas. |
UNSUPPORTED_FUNCTION | Cette fonction existe dans Numnote, mais le cadre ne sait pas encore l’exécuter. |
WRONG_ARGUMENTS | Une fonction est appelée avec trop ou pas assez d’arguments. |
UNIT_IN_FORMULA | Une unité est écrite dans la formule. Donnez-la plutôt au champ. |
UNITS_DO_NOT_MEET | Les unités de l’opération ne peuvent pas se combiner. Voir la section sur les unités. |
RESULT_UNIT | La formule donne une autre unité que celle déclarée pour le résultat. |
BLOCKED | Le 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
| Code | Rôle |
|---|---|
UNKNOWN_UNIT | Une valeur a été saisie dans une unité que son champ n’accepte pas. |
DIVISION_BY_ZERO | Division par zéro. |
ROOT_OF_NEGATIVE | Racine d’indice pair (racine carrée, etc.) d’un nombre négatif. |
ROOT_DEGREE_INVALID | L’indice de la racine n’est pas un entier naturel (1, 2, 3…). |
LOG_BASE_INVALID | La base du logarithme est négative, nulle ou égale à 1. |
LOG_ARGUMENT_NOT_POSITIVE | L’argument du logarithme est nul ou négatif. |
OVERFLOW | Le résultat est trop grand pour être représenté. |
TAN_UNDEFINED | La tangente n’est pas définie pour cet angle. |
COT_UNDEFINED | La cotangente n’est pas définie pour cet angle (par exemple 0 degré). |
ASIN_OUT_OF_DOMAIN | L’argument de l’arcsinus est hors de son domaine (de −1 à 1). |
ACOS_OUT_OF_DOMAIN | L’argument de l’arccosinus est hors de son domaine (de −1 à 1). |
COTH_OUT_OF_DOMAIN | Impossible de calculer la cotangente hyperbolique : son argument est nul. |
ACOSH_OUT_OF_DOMAIN | Impossible de calculer le cosinus hyperbolique réciproque : l’argument est inférieur à 1. |
ATANH_OUT_OF_DOMAIN | Impossible de calculer la tangente hyperbolique réciproque : l’argument doit être strictement compris entre −1 et 1. |
ACOTH_OUT_OF_DOMAIN | Impossible de calculer la cotangente hyperbolique réciproque : la valeur absolue de l’argument doit être supérieure à 1. |
FACTORIAL_DOMAIN | Une factorielle demande un entier naturel. |
NOT_A_NUMBER | Un champ contient du texte qui n’est pas un nombre. |
BAD_PROGRAM | La 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.