Numnote
Deutsch (Belgien)

Der Numnote-Rechner auf Ihrer Website

Ein kostenloser Rechner für jede Webseite. Er berechnet die Formel, die Ihre Seite ihm übergibt, ob Ihre eigene oder eine von einer Formelseite auf numnote.com kopierte. Er braucht keine Anmeldung und keinen Schlüssel und stellt keine Anfragen an Dritte.

Schnellstart

Mit Ihrer eigenen Formel sind es drei Schritte. Der Code von einer Formelseite ist noch kürzer: ein einziger Codeblock.

  1. Laden Sie das Hilfsskript einmal pro Seite, vor Ihrem eigenen Code.

    HTML
    <script src="https://numnote.com/embed/v1.js"></script>
  2. Setzen Sie im HTML ein Container-Element an die Stelle, an der der Rechner erscheinen soll.

    HTML
    <div id="calculator"></div>
  3. Rufen Sie die Funktion Numnote.embed mit der Definition auf. Der Rahmen erscheint im Container und stellt seine Höhe selbst ein.

    JavaScript
    Numnote.embed("#calculator", {
        "v": 1,
        "formula": "(morning + evening) / 2",
        "fields": {
          "morning": {
            "name": "Morgens",
            "unit": "km",
            "value": "12.5"
          },
          "evening": {
            "name": "Abends",
            "unit": "km",
            "value": "9"
          }
        },
        "result": {
          "name": "Mittelwert",
          "unit": "km"
        }
      }, {
      region: "de-be"
    });

Sie möchten den Rechner nicht von Hand schreiben? Stellen Sie ihn im Konfigurator zusammen.

Code von einer Formelseite

Jede Formelseite dieser Website bietet ihren Code unter „Auf Ihrer Website einbetten“ in zwei Varianten an. Fügen Sie eine davon in Ihr HTML ein, erscheint der Rechner mit seinen Feldern und dem Ergebnis an dieser Stelle. Der kopierte Code gehört danach Ihnen: Spätere Korrekturen der Formel auf numnote.com erreichen ihn nicht.

Der Code der ersten Formel dieser Website:

Skript

Die Skript-Variante ist die erste Wahl: Sie gibt das Ergebnis an Ihren eigenen Code weiter, ihre Höhe passt sich der Definition an, und sie meldet, wenn die Definition abgelehnt wird. Wo die Website keine Skripte erlaubt, lässt sie sich nicht verwenden.

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": "Zahl",
        "value": "600"
      },
      "p1": {
        "name": "Prozent",
        "value": "7",
        "percent": true
      }
    },
    "result": {
      "name": "Prozent von"
    }
  }, { region: "de-be" });
</script>
<p><a href="https://numnote.com/de-be/calc/prozent-von/">Prozent von einer Zahl berechnen · Numnote</a></p>

Link

Die iframe-Variante ist ein einzelner Rahmen, dessen Adresse die Definition enthält, für Websites, die nur einen iframe zulassen. Sie verschiebt nichts auf der Seite, gibt aber weder das Ergebnis noch eine Ablehnung an Ihren Code weiter. Ihre Höhe steht im Voraus fest, daher wird in einer schmaleren Spalte innerhalb des Rahmens gescrollt.

HTML
<iframe src="https://numnote.com/de-be/embed/custom/#%7B%22v%22:1,%22formula%22:%22p0%20*%20p1%22,%22fields%22:%7B%22p0%22:%7B%22name%22:%22Zahl%22,%22value%22:%22600%22%7D,%22p1%22:%7B%22name%22:%22Prozent%22,%22value%22:%227%22,%22percent%22:true%7D%7D,%22result%22:%7B%22name%22:%22Prozent%20von%22%7D%7D" title="Prozent von" width="100%" height="348" style="border:0" loading="lazy"></iframe>
<p><a href="https://numnote.com/de-be/calc/prozent-von/">Prozent von einer Zahl berechnen · Numnote</a></p>

Jede Variante endet mit einem sichtbaren Link zur Formelseite. Er steht außerhalb des Rahmens, auf Ihrer eigenen Seite. Lassen Sie ihn dort stehen, denn so finden Leser und Suchmaschinen die Formel.

Mit dem Einbetten des Rechners akzeptieren Sie die Bedingungen für das Einbetten.

Attribute des Links

AttributWertBedeutung
srchttps://numnote.com/de-be/embed/custom/#<form>Die Adresse des Rahmens. Die Definition steht hinter dem Zeichen #. Die Region in der Adresse bestimmt die Sprache und das Zahlenformat.
titleTextDer Name der Formel, den Screenreader vorlesen. Sie können ihn so lassen oder übersetzen.
width100%Der Rahmen füllt die ganze Breite seines Containers. Begrenzen Sie die Breite mit dem Container, nicht mit dem Rahmen.
height348Die Höhe richtet sich nach der Anzahl der Felder: Sie entspricht dem Platz, den der Inhalt in einer Spalte von 320 px braucht. In einer schmaleren Spalte wird innerhalb des Rahmens gescrollt.
loadinglazyDer Rahmen wird erst geladen, wenn der Besucher bis zu ihm hinunterscrollt.

Ihre eigene Formel

Laden Sie das Hilfsskript und übergeben Sie ihm die Definition: die Formel, ihre Felder und den Namen des Ergebnisses. Der Rahmen zeichnet die Felder, rechnet neu, während der Besucher Zahlen eingibt, und antwortet Ihrer Seite.

Einbinden

Das Hilfsskript ist eine einzelne Datei ohne Abhängigkeiten. Es erstellt den Rahmen, sendet die Definition, sobald der Rahmen geladen ist, stellt die Höhe des Rahmens ein und ruft Ihre Funktionen auf. Laden Sie es von numnote.com, statt es zu kopieren: So erhalten Sie die Korrekturen.

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

Aufruf

Der Container kann ein CSS-Selektor oder das Element selbst sein. Die Definition ist im Abschnitt „Definition“ beschrieben, die Parameter in der „API-Referenz“.

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": "Morgens",
          "unit": "km",
          "value": "12.5"
        },
        "evening": {
          "name": "Abends",
          "unit": "km",
          "value": "9"
        }
      },
      "result": {
        "name": "Mittelwert",
        "unit": "km"
      }
    }, {
    region: "de-be",
    onResult: function (answer) { console.log(answer.text); },
    onError: function (code, detail) { console.log(code, detail.at); }
  });
</script>

Ausprobieren Das ist der Rahmen, den der Code oben erstellt. Er funktioniert direkt auf dieser Seite: Ändern Sie eine Zahl und sehen Sie, wie neu gerechnet wird.

Der Rahmen zeigt immer die Zeile „powered by Numnote“, außer auf einer gesperrten Website, und in Version 1 gibt es keinen Schlüssel, der sie entfernt. Er antwortet nur der Seite, die die Definition gesendet hat, und schreibt Ihre Namen und Einheiten als reinen Text, nie als Markup.

Mit dem Einbetten des Rechners akzeptieren Sie die Bedingungen für das Einbetten.

API-Referenz

Numnote.embed(target, form, options)

Numnote.embed erstellt den Rahmen im Container, sendet die Definition und gibt ein Objekt zurück, mit dem sich der Rahmen aktualisieren oder entfernen lässt.

ParameterTypBedeutung
targetText | ElementEin CSS-Selektor oder ein Element, in das der Rahmen gesetzt wird. Ohne Element löst das Hilfsskript einen TypeError aus.
formObjektEine Definition der Version 1, siehe unten.
optionsObjekt, optionalOptionale Einstellungen: region, onResult, onError.

Parameter von options

ParameterTypBedeutung
regionText, optionalDie Region des Rahmens: die Sprache seiner eigenen Wörter und das Zahlenformat. Angegeben wird der Schlüssel einer Region, für die es diese Seite gibt, zum Beispiel uk-ua, en-us oder en-gb. Eine Sprache allein (uk, en) führt zu ihrer Hauptregion. Ohne die Option verwendet das Hilfsskript en-us; mit dem Schlüssel einer Region, die es nicht gibt, bleibt der Rahmen leer.
onResultCallback-Funktion, optionalWird mit dem Antwortobjekt aufgerufen, sooft das Ergebnis berechnet wird: nach dem Laden und nach jeder Änderung einer Zahl.
onErrorCallback-Funktion, optionalWird mit einem Fehlercode und dem Nachrichtenobjekt aufgerufen, wenn die Definition abgelehnt wird oder die Berechnung scheitert.

Rückgabewert

EigenschaftTypBedeutung
frameHTMLIFrameElementDas iframe-Element, falls Sie ihm eine Klasse oder einen Stil geben möchten.
update(form)Callback-FunktionSendet eine neue Definition in denselben Rahmen. Die Felder werden neu gezeichnet und die Höhe wird erneut eingestellt.
destroy()Callback-FunktionEntfernt den Rahmen und den Listener für Nachrichten.

Das Antwortobjekt von onResult

EigenschaftTypBedeutung
typeTextImmer die Zeichenfolge „result“.
nameTextDer Name des Ergebnisses, wie er in Ihrer Definition steht.
figureTextDie Zahl, formatiert für die Region, so wie der Besucher sie sieht.
unitTextDie Einheit des Ergebnisses oder eine leere Zeichenfolge.
textTextDie Zahl zusammen mit ihrer Einheit als eine Zeichenfolge.

Der Aufruf von onError

ParameterTypBedeutung
codeTextEin Code aus der Fehlertabelle, zum Beispiel UNKNOWN_SLOT.
detailObjektDie Nachricht des Rahmens: type „error“, code und at. at nennt die Stelle: die Kennung eines Feldes, „formula“, „fields“ oder „result.unit“.

Nachrichten des Rahmens

Das Hilfsskript ist nur eine Erleichterung. Der Rahmen arbeitet über postMessage mit jeder Seite zusammen: Die Seite sendet die Definition, der Rahmen antwortet mit drei Arten von Nachrichten.

NachrichtAufbauBedeutung
form (von Ihnen an den Rahmen){ v: 1, formula, fields, result }Ihre Seite sendet eine Definition der Version 1 in den Rahmen, sobald dieser geladen ist. Zielursprung: numnote.com.
result{ type: "result", name, figure, unit, text }Das Ergebnis ist berechnet. Seine Felder sind oben beim Antwortobjekt beschrieben.
height{ type: "height", height }Die Höhe des Inhalts in Pixeln. Stellen Sie sie am Rahmen ein, damit keine Scrollleiste erscheint.
error{ type: "error", code, at }Die Definition wurde abgelehnt oder die Berechnung ist gescheitert. Die Nachricht enthält code und at.

Der Rahmen antwortet nur dem Fenster, das die Definition gesendet hat, und nur dessen Ursprung. Eine Nachricht, die keinen der Schlüssel v, formula, fields und result enthält, gilt als fremd und bleibt ohne Antwort.

Definition

Die Definition ist ein einziges JSON-Objekt der Version 1. Namen und Einheiten schreiben Sie in Ihren eigenen Worten: Der Rahmen zeigt sie als reinen Text und übersetzt sie nie.

SchlüsselTypBedeutung
vZahlImmer 1. Jeden anderen Wert lehnt der Rahmen ab.
formulaTextDie Formel, geschrieben mit den Kennungen der Felder und den unten beschriebenen Operationen und Funktionen.
fieldsObjektDie Liste der Felder, in der Reihenfolge, in der sie gezeichnet werden. Jeder Schlüssel ist die Kennung des Feldes, der Name, unter dem die Formel dieses Feld verwendet (lateinische Buchstaben, Ziffern und Unterstriche, nie eine Ziffer am Anfang). Die Formel muss jedes Feld verwenden.
fields.<id>.nameTextDie Beschriftung, die der Besucher Ihrer Website über dem Feld sieht.
fields.<id>.unitText, optionalDie Einheit des Feldes, geschrieben als Stamm aus der Liste der Einheiten. Jeder andere Text erscheint nur als Beschriftung neben dem Feld und rechnet nichts um.
fields.<id>.valueText, optionalDer Startwert des Feldes, immer mit einem Punkt als Dezimaltrennzeichen geschrieben.
fields.<id>.percenttrue oder false, optionalSetzen Sie true, wenn das Feld einen Prozentwert enthält: Der Besucher gibt 20 für 20 % ein, und jede Verwendung des Feldes in der Formel liest es als Prozent. Nach einer Addition oder Subtraktion ist es daher ein Anteil des linken Teils. Das Feld zeigt dort, wo sonst eine Einheit steht, das Zeichen %.
resultObjektDas Ergebnis, das der Rahmen unter den Feldern zeigt.
result.nameTextDie Beschriftung des Ergebnisses.
result.unitText, optionalDie Einheit des Ergebnisses. Sie muss dieselbe sein, die die Formel liefert, sonst wird die Definition abgelehnt.
result.percenttrue oder false, optionalSetzen Sie true, wenn die Formel eine Zahl in Prozent liefert: Ein Ergebnis von 25 wird als 25 % angezeigt.
keyText, optionalDieser Schlüssel ist für die Zukunft reserviert. Version 1 des Rahmens ignoriert ihn.

Minimale Definition

Die minimale Definition besteht aus einem Feld ohne Einheit und einem Ergebnis ohne Einheit. Alles andere ist optional.

JSON
{
  "v": 1,
  "formula": "price + 20 %",
  "fields": {
    "price": {
      "name": "Preis"
    }
  },
  "result": {
    "name": "Mit Steuer"
  }
}

Vollständige Definition

Die vollständige Definition zeigt jeden Schlüssel, den Version 1 kennt: Einheiten, Startwerte, ein Prozentfeld und ein Ergebnis in Prozent.

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

Beispiele

Jedes Beispiel läuft auf dieser Seite mit demselben Hilfsskript, das Sie auf Ihrer eigenen Seite verwenden. Der Code neben jedem Rahmen ist vollständig: Kopieren Sie ihn und ersetzen Sie die Wörter durch Ihre eigenen.

Prozent: Fliesen mit Verschnitt

Das Feld für den Verschnitt hat percent: true. Nach der Addition wird es als Anteil der Fläche gelesen, 10 bedeutet also die Fläche plus 10 % davon. Das Ergebnis wird durch die Fläche einer Packung geteilt und bleibt eine Zahl ohne Einheit.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "(w * l + spare) / pack",
    "fields": {
      "w": {
        "name": "Breite des Raums",
        "unit": "m",
        "value": "3.2"
      },
      "l": {
        "name": "Länge des Raums",
        "unit": "m",
        "value": "4.5"
      },
      "spare": {
        "name": "Verschnitt",
        "percent": true,
        "value": "10"
      },
      "pack": {
        "name": "Fläche je Packung",
        "unit": "m²",
        "value": "1.44"
      }
    },
    "result": {
      "name": "Packungen"
    }
  }, {
  region: "de-be"
});

Funktion: Diagonale eines Rechtecks

Eine Funktion wird mit ihren Argumenten in Klammern geschrieben. Die Felder haben keine Einheiten, weil Version 1 aus einer Einheit keine Wurzel ziehen kann.

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

Prozent als Ergebnis: Anteil an den Ausgaben

result.percent: true zeigt das Ergebnis mit dem Zeichen %. Die Formel liefert eine Zahl in Prozent, deshalb steht die Multiplikation mit 100 in der Formel selbst.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "part / total * 100",
    "fields": {
      "part": {
        "name": "Ausgaben für Lebensmittel",
        "value": "250"
      },
      "total": {
        "name": "Alle Ausgaben",
        "value": "1000"
      }
    },
    "result": {
      "name": "Anteil",
      "percent": true
    }
  }, {
  region: "de-be"
});

Region: Sprache und Zahlenformat des Rahmens

Dieselbe Definition in zwei Regionen. Die Region bestimmt die Trennzeichen der Zahlen und die eigenen Wörter des Rahmens. Ihre Beschriftungen bleiben, wie Sie sie geschrieben haben.

JavaScript
Numnote.embed("#calculator-a", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Strecke",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Tage",
        "value": "4"
      }
    },
    "result": {
      "name": "Pro Tag",
      "unit": "km"
    }
  }, {
  region: "de-be"
});
Numnote.embed("#calculator-b", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Strecke",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Tage",
        "value": "4"
      }
    },
    "result": {
      "name": "Pro Tag",
      "unit": "km"
    }
  }, {
  region: "uk-ua"
});

region: "de-be"

region: "uk-ua"

update() und destroy()

Der Helfer gibt ein Objekt zurück. Mit update senden Sie ein anderes Formular in denselben Rahmen, mit destroy entfernen Sie den Rahmen von der Seite. Probieren Sie es mit den Schaltflächen unten aus.

JavaScript
var calc = Numnote.embed("#calculator", formA, { region: "de-be" });
calc.update(formB);   // Drei Felder
calc.destroy();       // Entfernen

Fehler: Ihre Meldung statt eines leeren Rahmens

Ein abgelehntes Formular zeichnet nichts, der Rahmen bleibt also leer. onError erhält den Fehlercode und die Fundstelle, sodass Ihre Seite dem Besucher mitteilen kann, was passiert ist, oder den Container ausblenden kann. In diesem Beispiel nennt die Formel ein Feld, das im Formular fehlt.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "area / coverage",
    "fields": {
      "area": {
        "name": "Fläche",
        "unit": "m²",
        "value": "40"
      }
    },
    "result": {
      "name": "Farbe"
    }
  }, {
  region: "de-be",
  onError: function (code, detail) {
    document.getElementById("calculator").hidden = true;
    message.textContent = "Der Rechner ließ sich nicht laden:" + " " + code + " (" + detail.at + ")";
  }
});

Ohne den Helfer: direkt über postMessage

Passt der Helfer nicht, etwa in einem Framework mit eigenem Lebenszyklus, sprechen Sie selbst mit dem Rahmen. Es ist derselbe Rahmen mit denselben Nachrichten.

HTML
<iframe id="calculator" src="https://numnote.com/de-be/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": "Erstes Feld",
          "value": "1"
        },
        "b": {
          "name": "Zweites Feld",
          "value": "2"
        }
      },
      "result": {
        "name": "Summe"
      }
    }, 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>

Formel

Der Browser liest die Formel. Sie darf Zahlen mit Punkt, Feldbezeichner, Klammern und die üblichen Rechenoperationen enthalten.

Nach einer Addition oder Subtraktion steht Prozent für einen Anteil des linken Teils, genau wie in der Numnote-App. Ein Produkt wird immer mit seinem Zeichen geschrieben: Der Rahmen lehnt 2a ab.

Eine Einheit steht nie in der Formel, denn sie gehört zum Feld.

Operationen

SchreibweiseBedeutungBeispiel
12.5Eine Zahl. In einer Formel ist das Dezimaltrennzeichen immer ein Punkt.price * 1.2
a_1Ein Feldbezeichner: lateinische Buchstaben, Ziffern und Unterstriche; er beginnt nicht mit einer Ziffer.width * height
+ -Addition und Subtraktion.a + b - c
* /Multiplikation und Division. Ein Produkt wird immer mit seinem Zeichen geschrieben.2 * a / b
modRest einer Division (Modulo).n mod 7
^Potenz.a ^ 2
!Fakultät.n!
%Prozent: nach + oder − ein Anteil des linken Teils, sonst ein Hundertstel.price + 20 %
( )Klammern legen die Reihenfolge fest.(a + b) / 2
f(x, y)Eine Funktion, deren Argumente durch Kommas getrennt sind.root(x, 3)

Funktionen

Eine Funktion wird mit ihren Argumenten in Klammern geschrieben, getrennt durch Kommas. Die Liste unten wird aus dem Funktionsverzeichnis von Numnote erzeugt:

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

Numnote kennt diese Funktionen, der Rahmen kann sie aber noch nicht ausführen. Eine Formel, die eine davon aufruft, wird mit dem Fehlercode UNSUPPORTED_FUNCTION abgelehnt:

Einheiten

Die Einheit eines Feldes oder des Ergebnisses steht im Formular als Kennung aus der Liste unten. Die Liste wird aus dem Einheitenverzeichnis von Numnote erzeugt. Ein Text, der nicht in der Liste steht, erscheint nur als Beschriftung und rechnet nichts um.

  • 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

Hat die Einheit eines Feldes weitere Einheiten derselben Größe, wählt der Besucher der Seite die gewünschte direkt im Feld. Die Zahl bleibt, das Ergebnis wird neu berechnet. Eine Beschriftung, die nicht in der Einheitenliste steht, bleibt einfacher Text ohne Auswahl. Tragen Felder verschiedene Einheiten derselben Größe (Zentimeter und Meter), rechnet der Rahmen sie selbst um, und die Formel sieht nur eine Größe.

In Version 1 darf eine Einheit nur auf dieselbe Einheit oder auf eine reine Zahl treffen. Der Rahmen lehnt die Summe verschiedener Einheiten, das Produkt zweier Einheiten sowie die Potenz oder Wurzel einer Einheit mit dem Fehlercode UNITS_DO_NOT_MEET ab.

AngenommenBedeutung
km + kmgleiche Einheiten, etwa Meter plus Meter
km * 2eine Einheit mit einer reinen Zahl, etwa Meter mal 2
km / kmQuotient zweier gleicher Einheiten: eine reine Zahl ohne Einheit
km + 10 %Prozent von einem Wert mit Einheit: Die Einheit bleibt erhalten.
AbgelehntBedeutung
km + kgSumme verschiedener Einheiten
m * mProdukt zweier Einheiten, etwa Meter mal Meter
sqrt(m)Potenz oder Wurzel einer Einheit
km / hQuotient verschiedener Einheiten

Grenzen

  • Ein Formular hat höchstens 8 Felder.
  • Eine Formel hat höchstens 500 Zeichen.

Ein Formular, das die Grenzen überschreitet, wird abgelehnt, und es wird nichts gezeichnet. Der Rahmen nimmt die volle Breite seines Containers ein, seine Höhe folgt dem Inhalt.

Fehler

Der Rahmen meldet einen Fehler als Objekt vom Typ „error“ mit einem Code und dem Schlüssel at, der angibt, wo er gefunden wurde (eine Feld-ID, „formula“, „fields“, „result.name“ und so weiter). Das Helferskript gibt den Code an den Callback onError weiter.

Fehler im Formular

FehlercodeBedeutung
NOT_JSONDie Nachricht der Host-Seite ist kein gültiges JSON.
NOT_AN_OBJECTDie Nachricht, ein Feld oder das Ergebnis ist kein JSON-Objekt.
VERSIONDer Schlüssel v fehlt, oder sein Wert ist nicht 1.
MISSINGEin erforderlicher Schlüssel des Formulars fehlt.
WRONG_TYPEFalscher JSON-Typ eines Werts, etwa Text statt Zahl.
UNKNOWN_KEYDas Formular enthält einen Schlüssel, den Version 1 nicht kennt.
TOO_LONGDie Formel ist länger als die erlaubte Zeichenzahl.
TOO_MANY_FIELDSDas Formular deklariert mehr Felder als erlaubt.
BAD_SLOT_IDEin Feldbezeichner hält die Regel für Bezeichner nicht ein, oder er ist mod oder der Name einer Funktion.
EMPTY_NAMEEin Name ist leer.
BAD_VALUEDer voreingestellte Wert eines Feldes ist keine Dezimalzahl mit Punkt, etwa 12.5.
UNUSED_FIELDEin Feld ist im Formular deklariert, kommt in der Formel aber nicht vor.
EMPTY_FORMULADie Formel ist eine leere Zeichenkette.
BAD_CHARACTERDie Formel enthält ein Zeichen, das in einer Formel nirgends erlaubt ist.
UNEXPECTEDEin Zeichen steht, wo die Syntax es nicht zulässt, etwa zwei Operatoren hintereinander.
UNCLOSEDEine Klammer wird geöffnet, aber nie geschlossen.
TOO_DEEPDie Formel ist zu tief verschachtelt (Klammern oder Aufrufe).
UNKNOWN_SLOTDie Formel nennt ein Feld, das das Formular nicht deklariert.
UNKNOWN_FUNCTIONDie Formel ruft eine Funktion auf, die es nicht gibt.
UNSUPPORTED_FUNCTIONDie Funktion gibt es in Numnote, der Rahmen führt sie aber noch nicht aus.
WRONG_ARGUMENTSEine Funktion wird mit der falschen Anzahl von Argumenten aufgerufen.
UNIT_IN_FORMULAIn der Formel steht eine Einheit. Weisen Sie sie stattdessen dem Feld zu.
UNITS_DO_NOT_MEETDie Einheiten lassen sich nicht kombinieren (Regel im Abschnitt Einheiten).
RESULT_UNITDie Formel liefert eine andere Einheit als die für das Ergebnis deklarierte.
BLOCKEDDie Website oder Seite, die den Rahmen enthält, steht auf der Sperrliste, oder eine Seite in der Kette der Rahmen verbirgt ihre Adresse. Der Rahmen rechnet dann nicht und zeigt statt der Zeile „powered by Numnote“ einen Hinweis zur Sperre.

Fehler beim Rechnen

FehlercodeBedeutung
UNKNOWN_UNITEin Wert wurde in einer Einheit eingegeben, die sein Feld nicht akzeptiert.
DIVISION_BY_ZEROEs wird durch null geteilt.
ROOT_OF_NEGATIVEGerade Wurzel (etwa Quadratwurzel) aus einer negativen Zahl.
ROOT_DEGREE_INVALIDDer Grad einer Wurzel ist keine natürliche Zahl (1, 2, 3 …).
LOG_BASE_INVALIDDie Basis eines Logarithmus ist nicht zulässig (nicht positiv oder 1).
LOG_ARGUMENT_NOT_POSITIVEDas Argument eines Logarithmus ist null oder negativ.
OVERFLOWDas Ergebnis ist zu groß, um dargestellt zu werden.
TAN_UNDEFINEDDer Tangens ist für diesen Winkel nicht definiert (etwa 90 Grad).
COT_UNDEFINEDDer Kotangens ist für diesen Winkel nicht definiert (etwa 0 Grad).
ASIN_OUT_OF_DOMAINDas Argument des Arkussinus liegt außerhalb seines Definitionsbereichs (von −1 bis 1).
ACOS_OUT_OF_DOMAINDas Argument des Arkuskosinus liegt außerhalb seines Definitionsbereichs (von −1 bis 1).
COTH_OUT_OF_DOMAINDer Kotangens hyperbolicus lässt sich nicht berechnen: Das Argument ist null.
ACOSH_OUT_OF_DOMAINDer Areakosinus hyperbolicus lässt sich nicht berechnen: Das Argument ist kleiner als 1.
ATANH_OUT_OF_DOMAINDer Areatangens hyperbolicus lässt sich nicht berechnen: Das Argument muss zwischen −1 und 1 liegen.
ACOTH_OUT_OF_DOMAINDer Areakotangens hyperbolicus lässt sich nicht berechnen: Der Betrag des Arguments muss größer als 1 sein.
FACTORIAL_DOMAINEine Fakultät braucht eine ganze Zahl, die nicht negativ ist.
NOT_A_NUMBEREin Feld enthält Text, der sich nicht als Zahl lesen lässt.
BAD_PROGRAMDie Formel ließ sich wegen eines internen Fehlers bei Numnote nicht ausführen. Schreiben Sie an den Support.

Sicherheit und Datenschutz

  • Der Rahmen antwortet nur dem Fenster, das das Formular gesendet hat, und nur an dessen Origin (Schema, Host und Port). Eine andere Seite kann die Antworten nicht lesen.
  • Ihre Namen und Einheiten werden als Textknoten eingefügt, nie als Markup. HTML-Tags in einem Namen erscheinen als einfacher Text.
  • Der Rahmen und das Helferskript werden nur von numnote.com geladen. Es gibt keine Skripte von Dritten, keine Cookies und keine Tracker. Die Zahlen, die der Besucher eingibt, verlassen seinen Browser nie.
  • Der Rahmen zeigt immer die Zeile „powered by Numnote“ und einen Link zu den rechtlichen Seiten. Das ist seine Nutzungsbedingung. Auf einer gesperrten Website rechnet der Rahmen nicht und zeigt statt der Zeile einen Hinweis darauf.

Versionen

  • Das Formular trägt den Schlüssel v mit dem Wert 1 (v: 1). Jede spätere Version des Rahmens liest ein Formular der Version 1 genauso, sodass ein eingebetteter Rechner weiter funktioniert.
  • Die Listen der Funktionen und Einheiten wachsen ohne Versionswechsel. Eine Funktion, die der Rahmen noch nicht ausführen kann, wird eines Tages funktionieren, und Formulare, die darauf warten, beginnen zu rechnen.
  • Der Schlüssel key ist für eine künftige Version reserviert. Version 1 ignoriert ihn, ein Formular mit diesem Schlüssel wird also angenommen.

Fragen und Fehlermeldungen schicken Sie an support@numnote.com.