Numnote
Italiano (Italia)

La calcolatrice Numnote sul proprio sito

Una calcolatrice gratuita da inserire in qualsiasi pagina web: calcola la formula che il sito le passa, propria o copiata da una pagina di formula di numnote.com. Non richiede registrazione né chiave e non fa richieste a terzi.

Avvio rapido

Per una formula propria bastano tre passaggi; il codice copiato da una pagina di formula è ancora più breve, perché è un unico frammento.

  1. Caricare una sola volta per pagina lo script di supporto, prima del proprio codice.

    HTML
    <script src="https://numnote.com/embed/v1.js"></script>
  2. Inserire nell’HTML un elemento contenitore, nel punto in cui deve comparire la calcolatrice.

    HTML
    <div id="calculator"></div>
  3. Chiamare la funzione Numnote.embed con il modulo, cioè la descrizione della formula: il frame compare nel contenitore e imposta da sé la propria altezza.

    JavaScript
    Numnote.embed("#calculator", {
        "v": 1,
        "formula": "(morning + evening) / 2",
        "fields": {
          "morning": {
            "name": "Mattina",
            "unit": "km",
            "value": "12.5"
          },
          "evening": {
            "name": "Sera",
            "unit": "km",
            "value": "9"
          }
        },
        "result": {
          "name": "Media",
          "unit": "km"
        }
      }, {
      region: "it-it"
    });

Per non scrivere il codice a mano, il calcolatore si può comporre nel generatore.

Codice da una pagina di formula

Ogni pagina di formula del sito offre il proprio codice sotto la dicitura «Incorpora nel sito», in due varianti. Se ne incolla una nell’HTML della pagina e la calcolatrice, con i suoi campi e il risultato, compare in quel punto. Una volta copiato, il codice appartiene a chi lo usa: le correzioni successive della formula su numnote.com non lo raggiungono.

Il codice della prima formula di questo sito:

Script

La variante con script è la prima scelta: passa il risultato al proprio codice, la sua altezza si adatta al modulo e segnala quando il modulo viene rifiutato. Non si può usare dove il sito non consente gli script.

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": "numero",
        "value": "270"
      },
      "p1": {
        "name": "percentuale",
        "value": "13",
        "percent": true
      }
    },
    "result": {
      "name": "percentuale di"
    }
  }, { region: "it-it" });
</script>
<p><a href="https://numnote.com/it-it/calc/percentuale-di/">Calcolatore della percentuale di un numero · Numnote</a></p>

Collegamento

La variante con iframe è un unico frame con il modulo nell’indirizzo, per i siti che consentono solo un iframe. Non sposta nulla nella pagina, ma non passa al proprio codice né il risultato né l’avviso di rifiuto, e la sua altezza è fissata in anticipo: in una colonna più stretta il frame scorre al suo interno.

HTML
<iframe src="https://numnote.com/it-it/embed/custom/#%7B%22v%22:1,%22formula%22:%22p0%20*%20p1%22,%22fields%22:%7B%22p0%22:%7B%22name%22:%22numero%22,%22value%22:%22270%22%7D,%22p1%22:%7B%22name%22:%22percentuale%22,%22value%22:%2213%22,%22percent%22:true%7D%7D,%22result%22:%7B%22name%22:%22percentuale%20di%22%7D%7D" title="percentuale di" width="100%" height="348" style="border:0" loading="lazy"></iframe>
<p><a href="https://numnote.com/it-it/calc/percentuale-di/">Calcolatore della percentuale di un numero · Numnote</a></p>

Ogni variante termina con un link visibile alla pagina della formula. Il link sta fuori dal frame, nella pagina del sito: conviene lasciarlo lì, perché è così che lettori e motori di ricerca trovano la formula.

Incorporando il calcolatore nel proprio sito, si accettano le condizioni di incorporamento.

Attributi del collegamento

AttributoValoreSignificato
srchttps://numnote.com/it-it/embed/custom/#<form>L’indirizzo del frame: il modulo segue il simbolo #; la regione nell’indirizzo determina la lingua e il formato dei numeri.
titletestoIl nome della formula, letto dagli screen reader; si può lasciare così o tradurre.
width100%Il frame occupa tutta la larghezza del contenitore; la larghezza si limita con il contenitore, non con il frame.
height348L’altezza è calcolata in base al numero di campi: è lo spazio che il contenuto occupa in una colonna di 320 px. In una colonna più stretta il frame scorre al suo interno.
loadinglazyIl frame si carica solo quando il visitatore scorre fino a raggiungerlo.

Una formula propria

Caricare lo script di supporto e passargli il modulo: la formula, i suoi campi e il nome del risultato. Il frame disegna i campi, ricalcola mentre il visitatore digita i numeri e risponde alla pagina del sito.

Installazione

Lo script di supporto è un unico file, senza dipendenze. Crea il frame, invia il modulo a caricamento avvenuto, imposta l’altezza del frame e richiama le funzioni del proprio codice. Conviene caricarlo da numnote.com anziché copiarlo, così si ricevono le correzioni.

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

Chiamata

Il contenitore può essere un selettore CSS o l’elemento stesso. Il modulo è descritto nella sezione «Modulo», i parametri nel «Riferimento 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": "Mattina",
          "unit": "km",
          "value": "12.5"
        },
        "evening": {
          "name": "Sera",
          "unit": "km",
          "value": "9"
        }
      },
      "result": {
        "name": "Media",
        "unit": "km"
      }
    }, {
    region: "it-it",
    onResult: function (answer) { console.log(answer.text); },
    onError: function (code, detail) { console.log(code, detail.at); }
  });
</script>

Dimostrazione Questo è il frame creato dal codice qui sopra: funziona direttamente in questa pagina, quindi si può cambiare un numero e vedere il ricalcolo.

Il frame mostra sempre la riga «powered by Numnote», tranne su un sito bloccato, e nella versione 1 non esiste alcuna chiave che la tolga. Risponde solo alla pagina che ha inviato il modulo e scrive nomi e unità del sito come semplice testo, mai come markup.

Incorporando il calcolatore nel proprio sito, si accettano le condizioni di incorporamento.

Riferimento API

Numnote.embed(target, form, options)

Crea il frame nel contenitore, invia il modulo e restituisce un oggetto per aggiornarlo o rimuoverlo.

ParametroTipoSignificato
targettesto | ElementUn selettore CSS o un elemento in cui collocare il frame. Senza un elemento lo script di supporto genera un TypeError.
formoggettoUn modulo della versione 1, descritto più avanti.
optionsoggetto, facoltativoImpostazioni facoltative: region, onResult, onError.

Parametri di options

ParametroTipoSignificato
regiontesto, facoltativoLa regione del frame: la lingua delle sue parole e il formato dei numeri. È la chiave di una regione per cui questa pagina esiste, per esempio uk-ua, en-us, en-gb; una lingua sola (uk, en) porta alla sua regione principale. Senza questa opzione lo script usa en-us; con la chiave di una regione inesistente il frame resta vuoto.
onResultfunzione, facoltativaRichiamata con l’oggetto risposta a ogni calcolo del risultato: dopo il caricamento e dopo ogni modifica di un numero.
onErrorfunzione, facoltativaRichiamata con un codice di errore e l’oggetto messaggio quando il modulo viene rifiutato o il calcolo non riesce.

Valore restituito

ProprietàTipoSignificato
frameHTMLIFrameElementL’elemento iframe, utile per assegnargli una classe o uno stile.
update(form)funzioneInvia un nuovo modulo nello stesso frame; i campi vengono ridisegnati e l’altezza è impostata di nuovo.
destroy()funzioneRimuove il frame e il listener dei messaggi.

L’oggetto risposta di onResult

ProprietàTipoSignificato
typetestoSempre la stringa «result».
nametestoIl nome del risultato, come indicato nel modulo.
figuretestoIl numero formattato per la regione, come lo vede il visitatore.
unittestoL’unità del risultato, oppure una stringa vuota.
texttestoIl numero insieme alla sua unità, in un’unica stringa.

La chiamata onError

ParametroTipoSignificato
codetestoUn codice della tabella degli errori, per esempio UNKNOWN_SLOT.
detailoggettoIl messaggio del frame: type «error», code e at, dove at indica il punto: l’identificatore di un campo, «formula», «fields», «result.unit».

Messaggi del frame

Lo script di supporto è solo una comodità. Il frame funziona con qualsiasi pagina tramite postMessage: la pagina invia il modulo, il frame risponde con tre tipi di messaggi.

MessaggioStrutturaSignificato
form (dalla pagina al frame){ v: 1, formula, fields, result }La pagina del sito invia nel frame un modulo della versione 1 a caricamento avvenuto. Origine di destinazione: numnote.com.
result{ type: "result", name, figure, unit, text }Il risultato è stato calcolato; i suoi campi sono descritti nell’oggetto risposta qui sopra.
height{ type: "height", height }L’altezza del contenuto in pixel. Impostarla sul frame per evitare la barra di scorrimento.
error{ type: "error", code, at }Il modulo è stato rifiutato o il calcolo non è riuscito: contiene code e at.

Il frame risponde solo alla finestra che ha inviato il modulo e solo alla sua origine. Un messaggio privo di tutte le chiavi v, formula, fields e result è considerato estraneo e non riceve risposta.

Modulo

Il modulo è un unico oggetto JSON, versione 1. Nomi e unità si scrivono con parole proprie: il frame li mostra come semplice testo e non li traduce mai.

ChiaveTipoSignificato
vnumeroSempre 1. Il frame rifiuta qualsiasi altro valore.
formulatestoIl calcolo, scritto con gli identificatori dei campi e con le operazioni e le funzioni descritte più avanti.
fieldsoggettoL’elenco dei campi, nell’ordine in cui vengono disegnati. Ogni chiave è l’identificatore del campo, cioè il nome con cui la formula lo richiama (lettere latine, cifre e trattini bassi, mai una cifra all’inizio). La formula deve usare tutti i campi.
fields.<id>.nametestoLa dicitura che il visitatore del sito vede sopra il campo.
fields.<id>.unittesto, facoltativoL’unità del campo, scritta come radice dall’elenco delle unità; qualsiasi altro testo è mostrato solo come dicitura accanto al campo e non converte nulla.
fields.<id>.valuetesto, facoltativoIl valore con cui il campo si apre (il valore iniziale), scritto sempre con il punto come separatore decimale, in qualsiasi lingua.
fields.<id>.percenttrue o false, facoltativoImpostare true quando il campo contiene una percentuale: il visitatore digita 20 per il 20%, e ogni uso del campo nella formula lo legge come percentuale, quindi dopo un’addizione o una sottrazione è una quota della parte a sinistra. Il campo mostra il segno % al posto dell’unità.
resultoggettoIl risultato che il frame mostra sotto i campi.
result.nametestoLa dicitura mostrata per il risultato.
result.unittesto, facoltativoL’unità del risultato; deve essere la stessa unità che dà la formula, altrimenti il modulo viene rifiutato.
result.percenttrue o false, facoltativoImpostare true quando la formula dà una percentuale: un risultato di 25 è mostrato come 25%.
keytesto, facoltativoQuesta chiave è riservata al futuro; la versione 1 del frame la ignora.

Modulo minimo

Il modulo minimo ha un solo campo senza unità e un risultato senza unità; tutto il resto è facoltativo.

JSON
{
  "v": 1,
  "formula": "price + 20 %",
  "fields": {
    "price": {
      "name": "Prezzo"
    }
  },
  "result": {
    "name": "Con IVA"
  }
}

Modulo completo

Il modulo completo mostra tutte le chiavi che la versione 1 conosce: unità, valori iniziali, un campo percentuale e un risultato percentuale.

JSON
{
  "v": 1,
  "formula": "(after - before) / before * 100",
  "fields": {
    "before": {
      "name": "Prima",
      "unit": "kg",
      "value": "80"
    },
    "after": {
      "name": "Dopo",
      "unit": "kg",
      "value": "76"
    }
  },
  "result": {
    "name": "Variazione",
    "percent": true
  },
  "key": ""
}

Esempi

Ogni esempio gira in questa pagina con lo stesso script di supporto che si userà nella propria pagina; il codice accanto a ogni frame è completo, quindi si può copiare e sostituire le parole con le proprie.

Percentuale: piastrelle con margine di scarto

Il campo dello scarto ha percent: true; dopo l’addizione è letto come quota dell’area, quindi 10 significa l’area più il 10% di essa. Il risultato è diviso per l’area di una confezione e resta un numero senza unità.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "(w * l + spare) / pack",
    "fields": {
      "w": {
        "name": "Larghezza della stanza",
        "unit": "m",
        "value": "3.2"
      },
      "l": {
        "name": "Lunghezza della stanza",
        "unit": "m",
        "value": "4.5"
      },
      "spare": {
        "name": "Margine per i tagli",
        "percent": true,
        "value": "10"
      },
      "pack": {
        "name": "Area coperta da una confezione",
        "unit": "m²",
        "value": "1.44"
      }
    },
    "result": {
      "name": "Confezioni"
    }
  }, {
  region: "it-it"
});

Funzione: la diagonale di un rettangolo

Una funzione si scrive con i suoi argomenti tra parentesi. I campi non hanno unità perché la versione 1 non può estrarre la radice di un’unità.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "sqrt(a ^ 2 + b ^ 2)",
    "fields": {
      "a": {
        "name": "Lato a",
        "value": "3"
      },
      "b": {
        "name": "Lato b",
        "value": "4"
      }
    },
    "result": {
      "name": "Diagonale"
    }
  }, {
  region: "it-it"
});

Risultato percentuale: la quota delle spese

result.percent: true mostra il risultato con il segno %. La formula dà una percentuale, quindi la moltiplicazione per 100 è scritta nella formula stessa.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "part / total * 100",
    "fields": {
      "part": {
        "name": "Spesa per il cibo",
        "value": "250"
      },
      "total": {
        "name": "Spesa totale",
        "value": "1000"
      }
    },
    "result": {
      "name": "Quota",
      "percent": true
    }
  }, {
  region: "it-it"
});

Regione: la lingua e il formato dei numeri del frame

Lo stesso modulo in due regioni. La regione determina i separatori dei numeri e le parole di servizio del frame, mentre i nomi scritti nel modulo restano invariati.

JavaScript
Numnote.embed("#calculator-a", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Distanza percorsa",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Giorni",
        "value": "4"
      }
    },
    "result": {
      "name": "Al giorno",
      "unit": "km"
    }
  }, {
  region: "it-it"
});
Numnote.embed("#calculator-b", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Distanza percorsa",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Giorni",
        "value": "4"
      }
    },
    "result": {
      "name": "Al giorno",
      "unit": "km"
    }
  }, {
  region: "uk-ua"
});

region: "it-it"

region: "uk-ua"

update() e destroy()

Lo script di supporto restituisce un oggetto. update invia un altro modulo nello stesso frame; destroy toglie il frame dalla pagina. Premere uno dei pulsanti qui sotto.

JavaScript
var calc = Numnote.embed("#calculator", formA, { region: "it-it" });
calc.update(formB);   // 3 campi
calc.destroy();       // Rimuovi

Errori: un messaggio proprio al posto di un frame vuoto

Un modulo rifiutato non disegna nulla, quindi il frame resta vuoto. onError riceve il codice dell’errore e il suo punto, così la pagina del sito può dire al visitatore che cosa è successo oppure nascondere il contenitore. In questo esempio la formula richiama un campo che il modulo non ha.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "area / coverage",
    "fields": {
      "area": {
        "name": "Superficie",
        "unit": "m²",
        "value": "40"
      }
    },
    "result": {
      "name": "Vernice"
    }
  }, {
  region: "it-it",
  onError: function (code, detail) {
    document.getElementById("calculator").hidden = true;
    message.textContent = "Impossibile caricare la calcolatrice:" + " " + code + " (" + detail.at + ")";
  }
});

Senza lo script di supporto: postMessage direttamente

Quando lo script di supporto non è adatto, per esempio in un framework con un ciclo di vita proprio, si dialoga con il frame direttamente. Il frame è lo stesso e i messaggi sono gli stessi.

HTML
<iframe id="calculator" src="https://numnote.com/it-it/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": "Primo campo",
          "value": "1"
        },
        "b": {
          "name": "Secondo campo",
          "value": "2"
        }
      },
      "result": {
        "name": "Somma"
      }
    }, 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>

Formula

Il browser legge la formula. Accetta numeri con il punto, identificatori di campo, parentesi e le consuete operazioni.

Dopo un’addizione o una sottrazione, una percentuale è una quota della parte a sinistra, come nell’app Numnote. Un prodotto si scrive sempre con il suo segno: il frame rifiuta 2a.

Nella formula non si scrive mai un’unità, perché appartiene al campo.

Operazioni

NotazioneSignificatoEsempio
12.5Un numero. In una formula il separatore decimale è sempre il punto.price * 1.2
a_1Un identificatore di campo: lettere latine, cifre, trattini bassi; non inizia con una cifra.width * height
+ -Addizione e sottrazione.a + b - c
* /Moltiplicazione e divisione. Un prodotto si scrive sempre con il suo segno.2 * a / b
modResto della divisione.n mod 7
^Potenza.a ^ 2
!Fattoriale.n!
%Percentuale: dopo + o − è una quota della parte a sinistra, altrimenti un centesimo.price + 20 %
( )Le parentesi fissano l’ordine delle operazioni.(a + b) / 2
f(x, y)Una funzione con gli argomenti separati da virgole.root(x, 3)

Funzioni

Una funzione si scrive con gli argomenti tra parentesi, separati da virgole. L’elenco qui sotto è generato dal registro delle funzioni di Numnote:

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

Funzioni che Numnote conosce ma che il frame non esegue ancora; una formula che ne richiama una viene rifiutata con il codice di errore UNSUPPORTED_FUNCTION:

Unità

L’unità di un campo o del risultato si scrive nel modulo come radice di unità dell’elenco qui sotto; l’elenco è generato dal registro delle unità di Numnote. Un testo che non è nell’elenco è mostrato solo come dicitura e non converte nulla.

  • 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

Quando l’unità di un campo ha altre unità della stessa grandezza, il visitatore sceglie quella che gli serve direttamente nel campo: il numero resta e il risultato viene ricalcolato. Una dicitura che non è nell’elenco delle unità resta semplice testo, senza scelta. Quando i campi hanno unità diverse della stessa grandezza (centimetri e metri), il frame le converte da sé e la formula vede una sola grandezza.

Nella versione 1 un’unità si combina solo con la stessa unità o con un numero semplice. Il frame rifiuta una somma di unità diverse, un prodotto di due unità e la potenza o la radice di un’unità con il codice di errore UNITS_DO_NOT_MEET.

Il frame accettaSignificato
km + kmun’unità con la stessa unità
km * 2un’unità con un numero semplice
km / kmun quoziente di due unità uguali, che dà un numero senza unità
km + 10 %una percentuale di un valore con unità, che mantiene la stessa unità
Il frame rifiutaSignificato
km + kguna somma di unità diverse
m * mun prodotto di due unità
sqrt(m)la potenza o la radice di un’unità
km / hun quoziente di unità diverse

Limiti

  • Numero massimo di campi in un modulo: 8.
  • Lunghezza massima di una formula, in caratteri: 500.

Un modulo oltre i limiti viene rifiutato e non si disegna nulla. Il frame occupa tutta la larghezza del contenitore e la sua altezza segue il contenuto.

Errori

Il frame segnala un errore come oggetto di tipo «error», con un code e la chiave at, che indica dove è stato trovato (l’identificatore di un campo, «formula», «fields», «result.name» e così via). Lo script di supporto passa il code a onError.

Modulo illeggibile o rifiutato

CodiceSignificato
NOT_JSONIl messaggio della pagina non è un JSON valido.
NOT_AN_OBJECTIl messaggio, un campo o il risultato non è un oggetto JSON.
VERSIONLa chiave della versione manca o il suo valore non è 1.
MISSINGManca una chiave obbligatoria del modulo.
WRONG_TYPEUn valore ha il tipo JSON sbagliato.
UNKNOWN_KEYIl modulo contiene una chiave che la versione 1 non conosce.
TOO_LONGLa formula supera il limite di caratteri.
TOO_MANY_FIELDSIl modulo dichiara più campi del consentito.
BAD_SLOT_IDL’identificatore di un campo non rispetta la regola degli identificatori, oppure è la parola mod o il nome di una funzione.
EMPTY_NAMEUn nome è una stringa vuota.
BAD_VALUEIl valore iniziale di un campo non è un numero decimale scritto con il punto (come 12.5).
UNUSED_FIELDUn campo è dichiarato nel modulo, ma la formula non lo usa.
EMPTY_FORMULALa formula è vuota.
BAD_CHARACTERLa formula contiene un carattere che non è ammesso in nessun punto di una formula.
UNEXPECTEDUn carattere si trova dove la sintassi della formula non lo consente, ad esempio due operatori di seguito.
UNCLOSEDUna parentesi è aperta ma non viene mai chiusa.
TOO_DEEPTroppe parentesi o chiamate annidate l’una dentro l’altra.
UNKNOWN_SLOTLa formula cita un campo che il form non dichiara.
UNKNOWN_FUNCTIONLa formula chiama una funzione che non esiste.
UNSUPPORTED_FUNCTIONLa funzione esiste in Numnote, ma il frame non la esegue ancora.
WRONG_ARGUMENTSUna funzione è chiamata con un numero di argomenti sbagliato.
UNIT_IN_FORMULANella formula è scritta un’unità. Assegnare l’unità al campo, non alla formula.
UNITS_DO_NOT_MEETLe unità di un’operazione non si possono combinare.
RESULT_UNITLa formula dà un’unità diversa da quella dichiarata per il risultato.
BLOCKEDIl sito o la pagina che contiene il frame è nell’elenco dei siti bloccati, oppure una pagina della catena di frame nasconde il proprio indirizzo. Il frame allora non calcola e, al posto della riga «powered by Numnote», mostra una riga che segnala il blocco.

Errori durante il calcolo

CodiceSignificato
UNKNOWN_UNITUn valore è stato inserito in un’unità che il suo campo non accetta.
DIVISION_BY_ZEROSi divide per zero.
ROOT_OF_NEGATIVERadice di indice pari (quadrata e simili) di un numero negativo.
ROOT_DEGREE_INVALIDL’indice della radice non è un numero naturale (1, 2, 3…).
LOG_BASE_INVALIDLa base del logaritmo non è ammessa (non positiva, oppure uguale a 1).
LOG_ARGUMENT_NOT_POSITIVEL’argomento del logaritmo è zero o negativo.
OVERFLOWIl risultato è troppo grande per essere rappresentato.
TAN_UNDEFINEDLa tangente non è definita per quell’angolo (ad esempio 90 gradi).
COT_UNDEFINEDLa cotangente non è definita per quell’angolo (ad esempio 0 gradi).
ASIN_OUT_OF_DOMAINL’argomento dell’arcoseno è fuori dal suo dominio (da −1 a 1).
ACOS_OUT_OF_DOMAINL’argomento dell’arcocoseno è fuori dal suo dominio (da −1 a 1).
COTH_OUT_OF_DOMAINLa cotangente iperbolica non è definita per argomento uguale a zero.
ACOSH_OUT_OF_DOMAINIl coseno iperbolico inverso (settore coseno iperbolico) non è definito per argomenti minori di 1.
ATANH_OUT_OF_DOMAINLa tangente iperbolica inversa (settore tangente iperbolica) non è definita per argomenti non compresi tra −1 e 1, estremi esclusi.
ACOTH_OUT_OF_DOMAINLa cotangente iperbolica inversa (settore cotangente iperbolica) non è definita per argomenti il cui valore assoluto non supera 1.
FACTORIAL_DOMAINIl fattoriale richiede un numero intero non negativo.
NOT_A_NUMBERUn campo contiene un testo che non si legge come numero.
BAD_PROGRAMNon è stato possibile eseguire la formula per un errore di Numnote. Scrivere a Numnote per segnalarlo.

Sicurezza e privacy

  • Il frame risponde solo alla finestra che ha inviato il form, e solo all’origine di quella finestra: un’altra pagina non può leggere i risultati.
  • I nomi e le unità forniti diventano nodi di testo, mai markup: un tag HTML in un nome viene mostrato come testo semplice.
  • Il frame e lo script di supporto si caricano solo da numnote.com: nessuno script di terze parti, nessun cookie, nessun tracker. I numeri inseriti dal visitatore non lasciano mai il suo browser.
  • Il frame mostra sempre la riga «powered by Numnote» e un collegamento alle pagine legali: è la sua condizione d’uso. Su un sito bloccato il frame non calcola e, al posto di quella riga, ne mostra una che segnala il blocco.

Versioni

  • Il form ha la chiave v: 1. Ogni versione successiva del frame legge un form di versione 1 allo stesso modo, quindi un calcolatore incorporato non smette mai di funzionare.
  • Gli elenchi di funzioni e di unità crescono senza cambiare versione: una funzione tra quelle non ancora supportate un giorno funzionerà, e i calcolatori che la attendevano inizieranno a dare il risultato.
  • La chiave chiamata key è riservata a una versione futura: la versione 1 la ignora, quindi un form che la contiene viene accettato.

Per una domanda o la segnalazione di un errore, scrivere a support@numnote.com.