Numnote
Polski (Polska)

Kalkulator Numnote na stronie internetowej

Darmowy kalkulator do osadzenia na dowolnej stronie. Liczy wzór, który przekaże mu strona: własny albo skopiowany ze strony wzoru. Bez rejestracji, bez klucza, bez zapytań do zewnętrznych usług.

Szybki start

Trzy kroki dla własnego wzoru. Krócej jest skopiować kod ze strony wzoru: to jeden fragment.

  1. Wczytać skrypt pomocniczy. Raz na stronę, przed własnym kodem.

    HTML
    <script src="https://numnote.com/embed/v1.js"></script>
  2. Umieścić kontener tam, gdzie ma się pojawić kalkulator.

    HTML
    <div id="calculator"></div>
  3. Wywołać Numnote.embed z formularzem. Ramka pojawi się w kontenerze i sama ustawi swoją wysokość.

    JavaScript
    Numnote.embed("#calculator", {
        "v": 1,
        "formula": "(morning + evening) / 2",
        "fields": {
          "morning": {
            "name": "Rano",
            "unit": "km",
            "value": "12.5"
          },
          "evening": {
            "name": "Wieczorem",
            "unit": "km",
            "value": "9"
          }
        },
        "result": {
          "name": "Średnia",
          "unit": "km"
        }
      }, {
      region: "pl-pl"
    });

Bez ręcznego pisania kodu? Kalkulator można ułożyć w kreatorze.

Kod ze strony wzoru

Każda strona wzoru ma swój kod pod napisem „Osadź na stronie”, w dwóch wariantach. Po wklejeniu jednego z nich do kodu HTML strony kalkulator z polami i wynikiem pojawi się w wybranym miejscu. Skopiowany kod od tej chwili należy do strony: poprawka wzoru na numnote.com do niego nie trafi.

Kod pierwszego wzoru z tej witryny:

Skrypt

Pierwszy wybór. Przekazuje wynik kodowi strony, dopasowuje wysokość ramki do formularza i zgłasza, gdy formularz zostanie odrzucony. Nie można go użyć tam, gdzie witryna nie dopuszcza skryptów.

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": "liczba",
        "value": "540"
      },
      "p1": {
        "name": "procent",
        "value": "18",
        "percent": true
      }
    },
    "result": {
      "name": "procent z"
    }
  }, { region: "pl-pl" });
</script>
<p><a href="https://numnote.com/pl-pl/calc/procent-z/">Kalkulator procentu z liczby · Numnote</a></p>

Odnośnik

Jedna ramka z formularzem w adresie, dla witryny, która dopuszcza tylko iframe. Niczego nie przesuwa na stronie. Nie przekazuje kodowi strony ani wyniku, ani odrzucenia, a jej wysokość jest ustalona z góry, więc w węższej kolumnie zawartość ramki się przewija.

HTML
<iframe src="https://numnote.com/pl-pl/embed/custom/#%7B%22v%22:1,%22formula%22:%22p0%20*%20p1%22,%22fields%22:%7B%22p0%22:%7B%22name%22:%22liczba%22,%22value%22:%22540%22%7D,%22p1%22:%7B%22name%22:%22procent%22,%22value%22:%2218%22,%22percent%22:true%7D%7D,%22result%22:%7B%22name%22:%22procent%20z%22%7D%7D" title="procent z" width="100%" height="348" style="border:0" loading="lazy"></iframe>
<p><a href="https://numnote.com/pl-pl/calc/procent-z/">Kalkulator procentu z liczby · Numnote</a></p>

Każdy wariant kończy się widocznym odnośnikiem do strony wzoru. Znajduje się poza ramką, bezpośrednio na stronie: należy go tam zostawić, bo dzięki niemu czytelnicy i wyszukiwarki znajdują wzór.

Osadzając kalkulator, akceptuje się warunki osadzania.

Atrybuty odnośnika

AtrybutWartośćZnaczenie
srchttps://numnote.com/pl-pl/embed/custom/#<form>Adres ramki: formularz następuje po znaku #. Region w nim ustala język i format liczb.
titletekstNazwa wzoru dla czytników ekranu. Można ją zostawić albo przetłumaczyć.
width100%Ramka zajmuje całą szerokość kontenera. Szerokość należy ograniczać kontenerem, nie ramką.
height348Ustalana według liczby pól: wysokość, jakiej zawartość potrzebuje w kolumnie o szerokości 320 px. W węższej kolumnie zawartość ramki się przewija.
loadinglazyRamka wczytuje się, gdy czytelnik przewinie stronę do niej.

Własny wzór

Po wczytaniu skryptu pomocniczego należy przekazać mu formularz: wzór, jego pola i nazwę wyniku. Ramka rysuje pola, oblicza na bieżąco, gdy odwiedzający wpisuje liczby, i odpowiada stronie.

Instalacja

Skrypt pomocniczy to jeden plik bez zależności. Tworzy ramkę, wysyła formularz po jej wczytaniu, ustawia wysokość ramki i wywołuje funkcje strony. Najlepiej wczytywać go z numnote.com, zamiast kopiować: wtedy poprawki docierają do strony.

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

Wywołanie

Kontenerem może być selektor CSS albo sam element. Formularz opisano w części „Formularz”, opcje w części „Dokumentacja 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": "Rano",
          "unit": "km",
          "value": "12.5"
        },
        "evening": {
          "name": "Wieczorem",
          "unit": "km",
          "value": "9"
        }
      },
      "result": {
        "name": "Średnia",
        "unit": "km"
      }
    }, {
    region: "pl-pl",
    onResult: function (answer) { console.log(answer.text); },
    onError: function (code, detail) { console.log(code, detail.at); }
  });
</script>

Na żywo Ramka utworzona przez powyższy kod. Działa na tej stronie: można zmienić liczbę.

Ramka zawsze pokazuje napis „powered by Numnote”, z wyjątkiem zablokowanej witryny, a wersja 1 nie ma klucza, który go usuwa. Odpowiada tylko stronie, która wysłała formularz, a nazwy i jednostki zapisuje jako zwykły tekst, nigdy jako znaczniki.

Osadzając kalkulator, akceptuje się warunki osadzania.

Dokumentacja API

Numnote.embed(target, form, options)

Tworzy ramkę w kontenerze, wysyła formularz i zwraca uchwyt do jej aktualizacji lub usunięcia.

ParametrTypZnaczenie
targettekst | ElementSelektor CSS albo element, do którego trafi ramka. Bez elementu skrypt pomocniczy zgłasza TypeError.
formobiektFormularz wersji 1, opisany niżej.
optionsobiekt, opcjonalnyUstawienia opcjonalne: region, onResult, onError.

Obiekt options

ParametrTypZnaczenie
regiontekst, opcjonalnieRegion ramki: język jej własnych słów i format liczb. To klucz regionu, dla którego istnieje ta strona, na przykład uk-ua, en-us, en-gb; sam język (uk, en) prowadzi do swojego regionu domyślnego. Bez tej opcji skrypt pomocniczy przyjmuje en-us; przy kluczu nieistniejącego regionu ramka pozostaje pusta.
onResultfunkcja, opcjonalnaWywoływana z obiektem odpowiedzi po każdym obliczeniu wyniku: po wczytaniu i po każdej zmianie liczby.
onErrorfunkcja, opcjonalnaWywoływana z kodem błędu i obiektem wiadomości, gdy formularz zostanie odrzucony albo obliczenie się nie uda.

Zwracana wartość

SkładowaTypZnaczenie
frameHTMLIFrameElementElement iframe, gdy potrzebna jest własna klasa lub styl.
update(form)funkcjaWysyła nowy formularz do tej samej ramki. Pola są rysowane od nowa, a wysokość ustawiana ponownie.
destroy()funkcjaUsuwa ramkę i nasłuch wiadomości.

Obiekt odpowiedzi onResult

SkładowaTypZnaczenie
typetekstZawsze „result”.
nametekstNazwa wyniku z formularza.
figuretekstLiczba w formacie regionu, tak jak widzi ją odwiedzający.
unittekstJednostka wyniku albo pusty ciąg.
texttekstLiczba i jednostka w jednym ciągu.

Wywołanie onError

ParametrTypZnaczenie
codetekstKod z tabeli błędów, na przykład UNKNOWN_SLOT.
detailobiektWiadomość ramki: typ „error”, code oraz at, gdzie at wskazuje miejsce: identyfikator pola, „formula”, „fields”, „result.unit”.

Wiadomości ramki

Skrypt pomocniczy jest tylko ułatwieniem. Ramka współpracuje z każdą stroną przez postMessage: strona wysyła formularz, a ramka odpowiada wiadomościami trzech rodzajów.

WiadomośćPostaćZnaczenie
formularz, od strony osadzającej{ v: 1, formula, fields, result }Strona wysyła formularz wersji 1 do ramki po jej wczytaniu. Origin docelowy: numnote.com.
result{ type: "result", name, figure, unit, text }Obliczono wynik. Jego pola opisuje obiekt odpowiedzi wyżej.
height{ type: "height", height }Wysokość zawartości w pikselach. Należy ustawić ją jako wysokość ramki, aby nie pojawił się pasek przewijania.
error{ type: "error", code, at }Formularz został odrzucony albo obliczenie się nie udało: code i at.

Ramka odpowiada tylko oknu, które wysłało formularz, i kieruje odpowiedź tylko na jego origin. Wiadomość bez żadnego z kluczy v, formula, fields i result pochodzi z innego skryptu i pozostaje bez odpowiedzi.

Formularz

Formularz to jeden obiekt JSON wersji 1. Nazwy i jednostki zapisuje się własnymi słowami: ramka pokazuje je jako zwykły tekst i nigdy ich nie tłumaczy.

PoleTypZnaczenie
vliczbaZawsze 1. Każda inna wartość jest odrzucana.
formulatekstDziałanie zapisane za pomocą identyfikatorów pól, operacji i funkcji opisanych niżej.
fieldsobiektPola w kolejności rysowania. Każdy klucz to identyfikator pola, czyli nazwa, pod którą pole występuje we wzorze: litery łacińskie, cyfry i podkreślniki, przy czym pierwszy znak nie może być cyfrą. Każde pole musi być użyte we wzorze.
fields.<id>.nametekstEtykieta, którą odwiedzający widzi nad polem.
fields.<id>.unittekst, opcjonalnieJednostka pola, zapisana jako rdzeń z listy jednostek. Każdy inny tekst jest pokazywany jako etykieta i niczego nie przelicza.
fields.<id>.valuetekst, opcjonalnieWartość początkowa pola, zapisana z kropką jako separatorem dziesiętnym.
fields.<id>.percenttrue lub false, opcjonalnietrue, jeśli pole jest procentem: odwiedzający wpisuje 20, co oznacza 20 %, a każde użycie pola we wzorze odczytuje je jako procent, więc po dodawaniu lub odejmowaniu jest to część lewej strony. W miejscu jednostki pole pokazuje znak %.
resultobiektWynik, który ramka pokazuje pod polami.
result.nametekstEtykieta wyniku.
result.unittekst, opcjonalnieJednostka wyniku. Musi zgadzać się z jednostką, którą daje wzór.
result.percenttrue lub false, opcjonalnietrue, jeśli wzór podaje wynik w procentach: wynik 25 jest pokazywany jako 25 %.
keytekst, opcjonalnieZarezerwowany na przyszłość. Wersja 1 go pomija.

Minimalny formularz

Jedno pole bez jednostki i wynik bez jednostki. Wszystko inne jest opcjonalne.

JSON
{
  "v": 1,
  "formula": "price + 20 %",
  "fields": {
    "price": {
      "name": "Cena"
    }
  },
  "result": {
    "name": "Z podatkiem"
  }
}

Pełny formularz

Każdy klucz znany wersji 1: jednostki, wartości początkowe, pole procentowe i wynik procentowy.

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

Przykłady

Każdy przykład działa na tej stronie z tym samym skryptem pomocniczym, który można wczytać na własnej stronie. Kod obok ramki jest kompletny: można go skopiować i wpisać własne słowa.

Procent: płytki z zapasem

Pole zapasu ma percent: true. Po dodaniu odczytuje się je jako część powierzchni, więc 10 oznacza powierzchnię plus 10 % tej powierzchni. Wynik jest dzielony przez powierzchnię płytek w opakowaniu i pozostaje zwykłą liczbą.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "(w * l + spare) / pack",
    "fields": {
      "w": {
        "name": "Szerokość pokoju",
        "unit": "m",
        "value": "3.2"
      },
      "l": {
        "name": "Długość pokoju",
        "unit": "m",
        "value": "4.5"
      },
      "spare": {
        "name": "Zapas na docinanie",
        "percent": true,
        "value": "10"
      },
      "pack": {
        "name": "Powierzchnia w opakowaniu",
        "unit": "m²",
        "value": "1.44"
      }
    },
    "result": {
      "name": "Opakowania"
    }
  }, {
  region: "pl-pl"
});

Funkcja: przekątna prostokąta

Funkcję zapisuje się z argumentami w nawiasach. Pola nie mają jednostek, ponieważ wersja 1 nie potrafi obliczyć pierwiastka z jednostki.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "sqrt(a ^ 2 + b ^ 2)",
    "fields": {
      "a": {
        "name": "Bok a",
        "value": "3"
      },
      "b": {
        "name": "Bok b",
        "value": "4"
      }
    },
    "result": {
      "name": "Przekątna"
    }
  }, {
  region: "pl-pl"
});

Wynik procentowy: udział w wydatkach

result.percent: true pokazuje wynik ze znakiem %. Wzór podaje wynik w procentach, więc mnożenie przez 100 jest w samym wzorze.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "part / total * 100",
    "fields": {
      "part": {
        "name": "Wydane na jedzenie",
        "value": "250"
      },
      "total": {
        "name": "Wszystkie wydatki",
        "value": "1000"
      }
    },
    "result": {
      "name": "Udział",
      "percent": true
    }
  }, {
  region: "pl-pl"
});

Region: język i format liczb

Ten sam formularz w dwóch regionach. Region ustala separatory liczb i własne słowa ramki, a nazwy pozostają takie, jak je zapisano.

JavaScript
Numnote.embed("#calculator-a", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Odległość",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Dni",
        "value": "4"
      }
    },
    "result": {
      "name": "Na dzień",
      "unit": "km"
    }
  }, {
  region: "pl-pl"
});
Numnote.embed("#calculator-b", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Odległość",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Dni",
        "value": "4"
      }
    },
    "result": {
      "name": "Na dzień",
      "unit": "km"
    }
  }, {
  region: "uk-ua"
});

region: "pl-pl"

region: "uk-ua"

update() i destroy()

Funkcja pomocnicza zwraca obiekt. update wysyła kolejny formularz do tej samej ramki, a destroy usuwa ramkę ze strony. Można wypróbować przyciski poniżej.

JavaScript
var calc = Numnote.embed("#calculator", formA, { region: "pl-pl" });
calc.update(formB);   // Trzy pola
calc.destroy();       // Usuń

Błędy: własny komunikat zamiast pustej ramki

Odrzucony formularz niczego nie rysuje: ramka zostaje pusta. onError dostaje kod i miejsce, więc strona może poinformować odwiedzającego, co się stało, albo ukryć kontener. Tu wzór wskazuje pole, którego formularz nie deklaruje.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "area / coverage",
    "fields": {
      "area": {
        "name": "Powierzchnia",
        "unit": "m²",
        "value": "40"
      }
    },
    "result": {
      "name": "Farba"
    }
  }, {
  region: "pl-pl",
  onError: function (code, detail) {
    document.getElementById("calculator").hidden = true;
    message.textContent = "Nie udało się wczytać kalkulatora:" + " " + code + " (" + detail.at + ")";
  }
});

Bez pomocnika: bezpośrednio przez postMessage

Gdy pomocnik się nie sprawdza, na przykład we frameworku z własnym cyklem życia, z ramką można porozumiewać się bezpośrednio. Ta sama ramka, te same komunikaty.

HTML
<iframe id="calculator" src="https://numnote.com/pl-pl/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": "Pierwsze",
          "value": "1"
        },
        "b": {
          "name": "Drugie",
          "value": "2"
        }
      },
      "result": {
        "name": "Suma"
      }
    }, 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>

Wzór

Przeglądarka odczytuje wzór. Przyjmuje liczby z kropką, identyfikatory pól, nawiasy i zwykłe działania.

Po dodawaniu lub odejmowaniu procent oznacza część lewej strony, tak jak w samym Numnote. Iloczyn zawsze zapisuje się ze znakiem: 2a zostanie odrzucone.

Jednostki nigdy nie zapisuje się we wzorze, bo należy ona do pola.

Działania

ZapisZnaczeniePrzykład
12.5Liczba. Separatorem dziesiętnym we wzorze jest zawsze kropka.price * 1.2
a_1Identyfikator pola: łacińskie litery, cyfry i podkreślenia; nie zaczyna się od cyfry.width * height
+ -Dodawanie i odejmowanie.a + b - c
* /Mnożenie i dzielenie. Iloczyn zawsze zapisuje się ze znakiem.2 * a / b
modReszta z dzielenia.n mod 7
^Potęga.a ^ 2
!Silnia.n!
%Procent: po + lub − część lewej strony, w pozostałych przypadkach setna część.price + 20 %
( )Nawiasy ustalają kolejność.(a + b) / 2
f(x, y)Funkcja z argumentami oddzielonymi przecinkami.root(x, 3)

Funkcje

Funkcję zapisuje się z argumentami w nawiasach, oddzielonymi przecinkami. Lista jest generowana z rejestru funkcji Numnote:

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

Numnote zna też te nazwy, ale są one jeszcze nieobsługiwane przez ramkę, więc wzór z nimi zostaje odrzucony z kodem UNSUPPORTED_FUNCTION:

Jednostki

Jednostkę pola lub wyniku zapisuje się jako rdzeń z tej listy. Lista jest generowana z rejestru jednostek Numnote. Tekst spoza listy jest pokazywany jako napis i niczego nie przelicza.

  • 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

Gdy jednostka pola ma inne jednostki tej samej wielkości, odwiedzający wybiera jedną w samym polu: liczba zostaje, a wynik jest przeliczany ponownie. Napis spoza listy pozostaje tekstem, bez wyboru. Gdy pola mają różne jednostki jednej wielkości, na przykład centymetry i metry, ramka przelicza je sama, a wzór widzi jedną wielkość.

W wersji 1 jednostka łączy się tylko sama ze sobą albo ze zwykłą liczbą. Suma różnych jednostek, iloczyn dwóch jednostek oraz potęga lub pierwiastek z jednostki są odrzucane z kodem UNITS_DO_NOT_MEET.

PrzyjmowaneZnaczenie
km + kmjednostka z tą samą jednostką
km * 2jednostka ze zwykłą liczbą
km / kmiloraz tych samych jednostek, zwykła liczba
km + 10 %procent z jednostki, ta sama jednostka
OdrzucaneZnaczenie
km + kgsuma różnych jednostek
m * miloczyn dwóch jednostek
sqrt(m)potęga lub pierwiastek z jednostki
km / hiloraz różnych jednostek

Limity

  • Formularz ma najwyżej 8 pól.
  • Wzór ma najwyżej 500 znaków.

Formularz przekraczający limity jest odrzucany i nic nie jest rysowane. Ramka zajmuje całą szerokość kontenera, a jej wysokość zależy od zawartości.

Błędy

Ramka zgłasza błąd jako obiekt typu „error” z kodem i kluczem at, który wskazuje, gdzie błąd znaleziono: identyfikator pola, „formula”, „fields”, „result.name” i tak dalej. Pomocnik przekazuje kod do onError.

Formularz, którego nie udało się odczytać

KodZnaczenie
NOT_JSONKomunikat nie jest poprawnym JSON-em.
NOT_AN_OBJECTKomunikat, pole lub wynik nie jest obiektem.
VERSIONBrakuje wersji albo wersja jest inna niż 1.
MISSINGBrakuje wymaganego klucza.
WRONG_TYPEWartość ma zły typ.
UNKNOWN_KEYFormularz zawiera klucz, którego wersja 1 nie zna.
TOO_LONGWzór jest dłuższy niż limit.
TOO_MANY_FIELDSFormularz ma więcej pól, niż wolno.
BAD_SLOT_IDIdentyfikator pola nie spełnia reguły dla identyfikatorów albo jest słowem mod lub nazwą funkcji.
EMPTY_NAMENazwa jest pusta.
BAD_VALUEWartość pola nie jest liczbą dziesiętną zapisaną z kropką.
UNUSED_FIELDPole jest zadeklarowane, ale wzór nigdy go nie używa.
EMPTY_FORMULAWzór jest pusty.
BAD_CHARACTERWzór zawiera znak, który nie jest dozwolony.
UNEXPECTEDZnak stoi tam, gdzie wzór go nie dopuszcza.
UNCLOSEDNawias nie jest zamknięty.
TOO_DEEPWzór ma zbyt głębokie zagnieżdżenie.
UNKNOWN_SLOTWzór wskazuje pole, którego formularz nie deklaruje.
UNKNOWN_FUNCTIONWzór wywołuje funkcję, która nie istnieje.
UNSUPPORTED_FUNCTIONFunkcja istnieje w Numnote, ale ramka jeszcze jej nie obsługuje.
WRONG_ARGUMENTSFunkcja dostała za mało lub za dużo argumentów.
UNIT_IN_FORMULAWe wzorze zapisano jednostkę. Należy ją podać w polu.
UNITS_DO_NOT_MEETJednostek działania nie można połączyć.
RESULT_UNITWzór daje jednostkę inną niż zadeklarowana dla wyniku.
BLOCKEDWitryna lub strona z ramką jest na liście blokad albo któraś strona w łańcuchu ukrywa swój adres. Ramka nie oblicza i zamiast napisu „powered by Numnote” pokazuje informację o blokadzie.

Obliczanie, którego nie udało się wykonać

KodZnaczenie
UNKNOWN_UNITWpisano wartość w jednostce, której pole nie przyjmuje.
DIVISION_BY_ZERODzielenie przez zero.
ROOT_OF_NEGATIVEPierwiastek parzystego stopnia z liczby ujemnej.
ROOT_DEGREE_INVALIDStopień pierwiastka nie jest dodatnią liczbą całkowitą.
LOG_BASE_INVALIDPodstawa logarytmu jest niedozwolona.
LOG_ARGUMENT_NOT_POSITIVEArgument logarytmu nie jest dodatni.
OVERFLOWWynik jest zbyt duży, aby go zapisać.
TAN_UNDEFINEDTangens nie jest tam określony.
COT_UNDEFINEDCotangens nie jest tam określony.
ASIN_OUT_OF_DOMAINArgument funkcji arcus sinus leży poza jej dziedziną.
ACOS_OUT_OF_DOMAINArgument funkcji arcus cosinus leży poza jej dziedziną.
COTH_OUT_OF_DOMAINNie można obliczyć cotangensa hiperbolicznego, bo argument jest równy zero.
ACOSH_OUT_OF_DOMAINNie można obliczyć area kosinusa hiperbolicznego, bo argument jest mniejszy od 1.
ATANH_OUT_OF_DOMAINNie można obliczyć area tangensa hiperbolicznego: argument musi być większy od −1 i mniejszy od 1.
ACOTH_OUT_OF_DOMAINNie można obliczyć area kotangensa hiperbolicznego: moduł argumentu musi być większy od 1.
FACTORIAL_DOMAINSilnia wymaga nieujemnej liczby całkowitej.
NOT_A_NUMBERPole zawiera tekst, który nie jest liczbą.
BAD_PROGRAMNie udało się wykonać wzoru. Błąd leży po naszej stronie, więc można do nas napisać.

Bezpieczeństwo i prywatność

  • Ramka odpowiada tylko oknu, które wysłało formularz, i tylko pod origin tego okna (schemat, host i port). Inna strona nie może odczytać odpowiedzi.
  • Nazwy i jednostki zawsze stają się węzłami tekstowymi, a nie znacznikami. Znaczniki HTML w nazwie są pokazywane jako tekst.
  • Ramka i pomocnik ładują się wyłącznie z numnote.com. Nie ma zewnętrznych skryptów, plików cookie ani narzędzi śledzących. Wpisane liczby nigdy nie opuszczają przeglądarki odwiedzającego.
  • Ramka zawsze pokazuje napis „powered by Numnote” oraz odnośnik do stron prawnych, co jest warunkiem jej używania. Na zablokowanej stronie ramka nie liczy i zamiast tego napisu pokazuje informację o blokadzie.

Wersje

  • Formularz ma klucz v: 1. Każda późniejsza wersja ramki odczytuje formularz w wersji 1 tak samo, więc osadzony kalkulator się nie psuje.
  • Listy funkcji i jednostek rosną bez zmiany wersji: funkcja z listy „jeszcze nieobsługiwane” kiedyś zadziała, a formularze, które na nią czekały, zaczną obliczać.
  • Klucz o nazwie key jest zarezerwowany dla późniejszej wersji. Wersja 1 go pomija, więc formularz z nim jest przyjmowany.

Pytania lub błędy: support@numnote.com.