Numnote
Suomi (Suomi)

Numnote-laskuri omalla sivustollasi

Maksuton laskuri, jonka voit lisätä mille tahansa verkkosivulle. Se laskee kaavan, jonka sivustosi sille antaa: joko oman kaavasi tai numnote.com-sivuston kaavasivulta kopioimasi. Rekisteröitymistä ei tarvita, avainta ei tarvita, eikä laskuri tee pyyntöjä kolmansille osapuolille.

Pikaopas

Oman kaavan laskuri valmistuu kolmessa vaiheessa. Kaavasivulta kopioitu koodi on vielä lyhyempi, koska se on yksi koodinpätkä.

  1. Lataa apuskripti kerran sivua kohti, ennen omaa koodiasi.

    HTML
    <script src="https://numnote.com/embed/v1.js"></script>
  2. Lisää HTML-koodiin säiliöelementti kohtaan, johon laskurin on määrä tulla.

    HTML
    <div id="calculator"></div>
  3. Kutsu funktiota Numnote.embed ja anna sille lomake eli kaavan kuvaus. Kehys ilmestyy säiliöön ja asettaa korkeutensa itse.

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

Etkö halua kirjoittaa laskimen lomaketta käsin? Kokoa laskin rakentimessa.

Kaavasivun koodi

Jokaisella laskurisivulla on otsikon ”Upota laskuri sivullesi” alla koodi kahtena vaihtoehtona. Kun liität toisen niistä sivusi HTML-koodiin, laskuri kenttineen ja tuloksineen ilmestyy kohtaan, johon liitit sen. Kopioitu koodi on siitä lähtien sinun: kun kaavaa korjataan numnote.com-sivustolla, korjaus ei päädy siihen.

Tämän sivuston ensimmäisen kaavan koodi:

Skripti

Skriptivaihtoehto on ensisijainen: se välittää tuloksen omalle koodillesi, sen korkeus mukautuu lomakkeeseen ja se ilmoittaa, jos lomake hylätään. Sitä ei voi käyttää, jos sivusto ei salli skriptejä.

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": "luku",
        "value": "1000"
      },
      "p1": {
        "name": "prosenttia",
        "value": "15",
        "percent": true
      }
    },
    "result": {
      "name": "prosentti luvusta"
    }
  }, { region: "fi-fi" });
</script>
<p><a href="https://numnote.com/fi-fi/calc/prosentti-luvusta/">Prosentti luvusta -laskuri · Numnote</a></p>

Linkki

Linkkivaihtoehto on yksi iframe-kehys, jonka osoitteessa lomake kulkee mukana. Se on sivustoille, jotka sallivat vain iframen. Se ei siirrä mitään sivullasi, mutta se ei välitä koodillesi tulosta eikä hylkäysilmoitusta. Sen korkeus on määrätty etukäteen, joten kapeammassa palstassa sisältöä vieritetään kehyksen sisällä.

HTML
<iframe src="https://numnote.com/fi-fi/embed/custom/#%7B%22v%22:1,%22formula%22:%22p0%20*%20p1%22,%22fields%22:%7B%22p0%22:%7B%22name%22:%22luku%22,%22value%22:%221000%22%7D,%22p1%22:%7B%22name%22:%22prosenttia%22,%22value%22:%2215%22,%22percent%22:true%7D%7D,%22result%22:%7B%22name%22:%22prosentti%20luvusta%22%7D%7D" title="prosentti luvusta" width="100%" height="348" style="border:0" loading="lazy"></iframe>
<p><a href="https://numnote.com/fi-fi/calc/prosentti-luvusta/">Prosentti luvusta -laskuri · Numnote</a></p>

Kumpikin vaihtoehto päättyy näkyvään linkkiin kaavasivulle. Linkki on kehyksen ulkopuolella, omalla sivullasi. Pidä se siinä, sillä sen kautta lukijat ja hakukoneet löytävät kaavan.

Upottamalla laskurin sivustollesi hyväksyt upottamista koskevat ehdot.

Linkkivaihtoehdon attribuutit

AttribuuttiArvoMerkitys
srchttps://numnote.com/fi-fi/embed/custom/#<form>Kehyksen osoite: lomake tulee #-merkin jälkeen. Osoitteen alue määrää kielen ja lukujen muodon.
titletekstiKaavan nimi, jonka ruudunlukijat lukevat ääneen. Voit jättää sen sellaisekseen tai kääntää sen.
width100%Kehys täyttää säiliönsä koko leveyden. Rajaa leveyttä säiliöllä, älä kehyksellä.
height348Korkeus kirjoitetaan kenttien määrän mukaan: se on sisällön viemä korkeus, kun palsta on 320 px leveä. Kapeammassa palstassa kehyksen sisältö vierii kehyksen sisällä.
loadinglazyKehys latautuu vasta, kun kävijä vierittää sivun sen kohdalle.

Oma kaava

Lataa apuskripti ja anna sille lomake: kaava, sen kentät ja tuloksen nimi. Kehys piirtää kentät, laskee tuloksen uudelleen kävijän kirjoittaessa lukuja ja vastaa sivullesi.

Asennus

Apuskripti on yksi tiedosto, jolla ei ole riippuvuuksia. Se luo kehyksen, lähettää lomakkeen, kun kehys on latautunut, asettaa kehyksen korkeuden ja kutsuu koodisi käsittelijöitä. Lataa se numnote.com-sivustolta äläkä kopioi sitä, niin saat korjaukset.

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

Kutsu

Säiliö voi olla CSS-valitsin tai itse elementti. Lomake kuvataan osiossa ”Lomake”, parametrit osiossa ”API-kuvaus”.

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

Toiminnassa Tämä on kehys, jonka yllä oleva koodi luo. Se toimii suoraan tällä sivulla: muuta lukua, niin tulos päivittyy.

Kehys näyttää aina rivin ”powered by Numnote”, paitsi estetyllä sivustolla, eikä versiossa 1 ole avainta, joka poistaisi sen. Kehys vastaa vain sivulle, joka lähetti lomakkeen, ja näyttää antamasi nimet ja yksiköt pelkkänä tekstinä, ei koskaan merkintäkielenä.

Upottamalla laskurin sivustollesi hyväksyt upottamista koskevat ehdot.

API-kuvaus

Numnote.embed(target, form, options)

Luo kehyksen säiliöön, lähettää lomakkeen ja palauttaa olion, jolla kehystä päivitetään tai poistetaan.

ParametriTyyppiMerkitys
targetteksti | ElementCSS-valitsin tai elementti, johon kehys sijoitetaan. Ilman elementtiä apuskripti heittää TypeError-virheen.
formolioVersion 1 lomake, kuvattu alempana.
optionsolio, valinnainenValinnaiset asetukset: region, onResult, onError.

options-jäsenet

ParametriTyyppiMerkitys
regionteksti, valinnainenKehyksen alue: sen omien sanojen kieli ja lukujen muoto. Arvo on tämän sivun tukeman alueen avain, esimerkiksi uk-ua, en-us tai en-gb; pelkkä kieli (uk, en) johtaa sen pääalueeseen. Ilman asetusta apuskripti käyttää arvoa en-us; jos avainta vastaavaa aluetta ei tueta, kehys jää tyhjäksi.
onResultfunktio, valinnainenKutsutaan tulosoliolla aina, kun tulos on laskettu: latauksen jälkeen ja aina, kun jokin luku muuttuu.
onErrorfunktio, valinnainenKutsutaan virhekoodilla ja viestioliolla, kun lomake hylätään tai laskeminen ei onnistu.

Palautusarvo

JäsenTyyppiMerkitys
frameHTMLIFrameElementiframe-elementti, jos haluat antaa sille luokan tai tyylin.
update(form)funktioLähettää uuden lomakkeen samaan kehykseen: kentät piirretään uudelleen ja korkeus asetetaan uudelleen.
destroy()funktioPoistaa kehyksen ja viestikuuntelijan.

onResult-kutsun tulosolio

JäsenTyyppiMerkitys
typetekstiAina merkkijono ”result”.
nametekstiTuloksen nimi sellaisena kuin se on lomakkeessasi.
figuretekstiAlueen mukaan muotoiltu luku sellaisena kuin kävijä sen näkee.
unittekstiTuloksen yksikkö tai tyhjä merkkijono.
texttekstiLuku ja sen yksikkö yhtenä merkkijonona.

onError-kutsun saamat tiedot

ParametriTyyppiMerkitys
codetekstiVirhetaulukon koodi, esimerkiksi UNKNOWN_SLOT.
detailolioKehyksen viesti: type ”error”, code ja at, jossa at nimeää paikan: kentän tunnuksen, ”formula”, ”fields” tai ”result.unit”.

Kehyksen viestit

Apuskripti on pelkkä apuväline. Kehys toimii minkä tahansa sivun kanssa postMessage-kutsun kautta: sivu lähettää lomakkeen, ja kehys vastaa kolmenlaisilla viesteillä.

ViestiMuotoMerkitys
form, sivultasi kehykselle{ v: 1, formula, fields, result }Sivusi lähettää version 1 lomakkeen kehykseen, kun kehys on latautunut. Kohdealkuperä: numnote.com.
result{ type: "result", name, figure, unit, text }Tulos on laskettu; sen kentät on kuvattu yllä tulosolion kohdalla.
height{ type: "height", height }Sisällön korkeus pikseleinä. Aseta se kehykselle, niin vierityspalkkia ei tule.
error{ type: "error", code, at }Lomake hylättiin tai laskeminen ei onnistunut: viestissä ovat code ja at.

Kehys vastaa vain ikkunalle, joka lähetti lomakkeen, ja vain sen alkuperään. Viesti, jossa ei ole yhtäkään avaimista v, formula, fields ja result, katsotaan vieraaksi, eikä siihen vastata.

Lomake

Lomake on yksi JSON-olio, versio 1. Nimet ja yksiköt kirjoitat omin sanoin: kehys näyttää ne pelkkänä tekstinä eikä koskaan käännä niitä.

AvainTyyppiMerkitys
vlukuAina 1. Kehys hylkää minkä tahansa muun arvon.
formulatekstiLaskettava kaava, kirjoitettuna kenttien tunnuksilla sekä alla kuvatuilla operaatioilla ja funktioilla.
fieldsolioKenttien luettelo. Kentät tulevat siinä järjestyksessä, jossa ne piirretään; jokainen avain on kentän tunnus eli nimi, jolla kaava viittaa kenttään (latinalaiset kirjaimet, numerot ja alaviivat, ei koskaan numerolla alkava). Kaavassa on käytettävä jokaista kenttää.
fields.<id>.nametekstiOtsikko, jonka kävijä näkee kentän yläpuolella.
fields.<id>.unitteksti, valinnainenKentän yksikkö, kirjoitettuna yksikköluettelon tunnuksena; mikä tahansa muu teksti näytetään vain otsikkona kentän vieressä eikä muunna mitään.
fields.<id>.valueteksti, valinnainenArvo, jolla kenttä avautuu (alkuarvo), aina kirjoitettuna pisteellä desimaalierottimena kielestä riippumatta.
fields.<id>.percenttrue tai false, valinnainenAseta arvoon true, kun kenttä sisältää prosentin: kävijä kirjoittaa 20 tarkoittaen 20 %, ja kaava lukee kentän joka kohdassa prosenttina, joten yhteen- tai vähennyslaskun jälkeen se on osuus vasemmanpuoleisesta osasta. Kenttä näyttää %-merkin yksikön paikalla.
resultolioTulos, jonka kehys näyttää kenttien alla.
result.nametekstiTuloksen otsikko.
result.unitteksti, valinnainenTuloksen yksikkö; sen on oltava sama yksikkö, jonka kaava tuottaa, muuten lomake hylätään.
result.percenttrue tai false, valinnainenAseta arvoon true, kun kaava antaa prosenttiluvun: tulos 25 näytetään muodossa 25 %.
keyteksti, valinnainenAvain on varattu tulevaa käyttöä varten; version 1 kehys ohittaa sen.

Pienin lomake

Pienin lomake on yksi kenttä ilman yksikköä ja tulos ilman yksikköä; kaikki muu on valinnaista.

JSON
{
  "v": 1,
  "formula": "price + 20 %",
  "fields": {
    "price": {
      "name": "Hinta"
    }
  },
  "result": {
    "name": "Hinta veroineen"
  }
}

Täysi lomake

Täysi lomake näyttää kaikki avaimet, jotka versio 1 tuntee: yksiköt, alkuarvot, prosenttikentän ja prosenttituloksen.

JSON
{
  "v": 1,
  "formula": "(after - before) / before * 100",
  "fields": {
    "before": {
      "name": "Ennen",
      "unit": "kg",
      "value": "80"
    },
    "after": {
      "name": "Jälkeen",
      "unit": "kg",
      "value": "76"
    }
  },
  "result": {
    "name": "Muutos",
    "percent": true
  },
  "key": ""
}

Esimerkit

Jokainen esimerkki toimii tällä sivulla samalla apuskriptillä, jota käytät omalla sivullasi. Kehyksen vieressä oleva koodi on täydellinen, joten voit kopioida sen ja korvata sanat omillasi.

Prosentti: laatat ja hukkavara

Hukkavaralla on percent: true; yhteenlaskun jälkeen se luetaan osuutena pinta-alasta, joten 10 tarkoittaa pinta-alaa ja sen lisäksi 10 prosenttia siitä. Tulos jaetaan yhden pakkauksen pinta-alalla, ja se jää luvuksi ilman yksikköä.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "(w * l + spare) / pack",
    "fields": {
      "w": {
        "name": "Huoneen leveys",
        "unit": "m",
        "value": "3.2"
      },
      "l": {
        "name": "Huoneen pituus",
        "unit": "m",
        "value": "4.5"
      },
      "spare": {
        "name": "Leikkuuvara",
        "percent": true,
        "value": "10"
      },
      "pack": {
        "name": "Pakkauksen pinta-ala",
        "unit": "m²",
        "value": "1.44"
      }
    },
    "result": {
      "name": "Pakkaukset"
    }
  }, {
  region: "fi-fi"
});

Funktio: suorakulmion lävistäjä

Funktion argumentit kirjoitetaan sulkeisiin. Kentillä ei ole yksiköitä, koska versio 1 ei osaa ottaa yksikön neliöjuurta.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "sqrt(a ^ 2 + b ^ 2)",
    "fields": {
      "a": {
        "name": "Suorakulmion sivu a",
        "value": "3"
      },
      "b": {
        "name": "Suorakulmion sivu b",
        "value": "4"
      }
    },
    "result": {
      "name": "Suorakulmion lävistäjä"
    }
  }, {
  region: "fi-fi"
});

Prosenttitulos: osuus menoista

result.percent: true näyttää tuloksen %-merkillä. Kaava antaa prosenttiluvun, joten kertominen sadalla kirjoitetaan itse kaavaan.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "part / total * 100",
    "fields": {
      "part": {
        "name": "Ruokamenot",
        "value": "250"
      },
      "total": {
        "name": "Kaikki menot",
        "value": "1000"
      }
    },
    "result": {
      "name": "Osuus",
      "percent": true
    }
  }, {
  region: "fi-fi"
});

Alue: kehyksen kieli ja lukujen muoto

Sama lomake kahdella alueella. Alue määrää lukujen erottimet ja kehyksen omat apusanat, mutta omat otsikkosi pysyvät sellaisina kuin ne kirjoitit.

JavaScript
Numnote.embed("#calculator-a", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Matka",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Päivät",
        "value": "4"
      }
    },
    "result": {
      "name": "Päivässä",
      "unit": "km"
    }
  }, {
  region: "fi-fi"
});
Numnote.embed("#calculator-b", {
    "v": 1,
    "formula": "distance / days",
    "fields": {
      "distance": {
        "name": "Matka",
        "unit": "km",
        "value": "1234.5"
      },
      "days": {
        "name": "Päivät",
        "value": "4"
      }
    },
    "result": {
      "name": "Päivässä",
      "unit": "km"
    }
  }, {
  region: "uk-ua"
});

region: "fi-fi"

region: "uk-ua"

update() ja destroy()

Apuskripti palauttaa olion. update lähettää samaan kehykseen toisen lomakkeen, destroy poistaa kehyksen sivulta. Kokeile alla olevia painikkeita.

JavaScript
var calc = Numnote.embed("#calculator", formA, { region: "fi-fi" });
calc.update(formB);   // Kolme kenttää
calc.destroy();       // Poista

Virheet: oma viestisi tyhjän kehyksen sijaan

Hylätty lomake ei piirrä mitään, joten kehys jää tyhjäksi. onError saa virhekoodin ja sen paikan, joten sivusi voi kertoa kävijälle, mitä tapahtui, tai piilottaa säiliön. Tässä esimerkissä kaava viittaa kenttään, jota lomakkeessa ei ole.

JavaScript
Numnote.embed("#calculator", {
    "v": 1,
    "formula": "area / coverage",
    "fields": {
      "area": {
        "name": "Seinän ala",
        "unit": "m²",
        "value": "40"
      }
    },
    "result": {
      "name": "Maalia"
    }
  }, {
  region: "fi-fi",
  onError: function (code, detail) {
    document.getElementById("calculator").hidden = true;
    message.textContent = "Laskuria ei voitu ladata:" + " " + code + " (" + detail.at + ")";
  }
});

Ilman apuskriptiä: suoraan kehykselle postMessage-kutsulla

Jos apuskripti ei sovi, esimerkiksi sovelluskehyksessä, jolla on oma elinkaarensa, lähetä viestit kehykselle itse. Kehys ja viestit ovat samat.

HTML
<iframe id="calculator" src="https://numnote.com/fi-fi/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": "Ensimmäinen",
          "value": "1"
        },
        "b": {
          "name": "Toinen",
          "value": "2"
        }
      },
      "result": {
        "name": "Summa"
      }
    }, 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>

Kaava

Selain lukee kaavan. Se hyväksyy pisteellä kirjoitetut luvut, kenttien tunnisteet, sulut ja yleiset laskutoimitukset.

Yhteen- tai vähennyslaskun jälkeen prosentti tarkoittaa osuutta vasemmanpuoleisesta osasta, kuten itse Numnote-sovelluksessa. Kertomerkki kirjoitetaan aina näkyviin: kehys hylkää muodon 2a.

Yksikköä ei koskaan kirjoiteta kaavaan, koska se kuuluu kenttään.

Laskutoimitukset

KirjoitusasuMerkitysEsimerkki
12.5Luku. Kaavassa desimaalierotin on aina piste.price * 1.2
a_1Kentän tunniste: latinalaisia kirjaimia, numeroita ja alaviivoja; se ei voi alkaa numerolla.width * height
+ -Yhteen- ja vähennyslasku.a + b - c
* /Kerto- ja jakolasku. Kertomerkki kirjoitetaan aina näkyviin.2 * a / b
modJakojäännös (modulo).n mod 7
^Potenssi.a ^ 2
!Kertoma.n!
%Prosentti: merkin + tai − jälkeen osuus vasemmanpuoleisesta osasta, muuten sadasosa.price + 20 %
( )Sulut määräävät järjestyksen.(a + b) / 2
f(x, y)Funktio, jonka argumentit erotetaan pilkuilla.root(x, 3)

Funktiot

Funktio kirjoitetaan niin, että sen argumentit ovat sulkeissa pilkuilla erotettuina. Seuraavat funktiot haetaan Numnote-sovelluksen funktiorekisteristä:

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

Numnote tuntee myös seuraavat funktiot, mutta kehys ei vielä osaa ajaa niitä. Kaava, joka kutsuu jotakin niistä, hylätään virhekoodilla UNSUPPORTED_FUNCTION:

Yksiköt

Kentän tai tuloksen yksikkö annetaan lomakkeessa jonakin alla olevan luettelon yksikkökoodeista. Luettelo haetaan Numnote-sovelluksen yksikkörekisteristä. Teksti, jota luettelossa ei ole, näytetään vain otsikkona, eikä sillä muunneta mitään.

  • 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

Kun kentän yksiköllä on saman suureen muita yksiköitä, sivuston kävijä valitsee tarvitsemansa yksikön suoraan kentästä: luku säilyy ja vastaus lasketaan uudelleen. Otsikko, jota ei löydy yksiköistä, jää tavalliseksi tekstiksi ilman valintaa. Jos kentillä on saman suureen eri yksiköitä, esimerkiksi senttimetrejä ja metrejä, kehys muuntaa ne itse, ja kaava näkee yhden suureen.

Version 1 sääntö: yksikkö voi kohdata vain saman yksikön tai tavallisen luvun. Kehys hylkää eri yksiköiden summan, kahden yksikön tulon sekä yksikön potenssin tai juuren virhekoodilla UNITS_DO_NOT_MEET.

Hyväksytyt yhdistelmätMerkitys
km + kmyksikkö ja sama yksikkö (metri + metri)
km * 2yksikkö ja luku (metri kertaa 2)
km / kmkahden samanlaisen yksikön osamäärä, tuloksena luku ilman yksikköä
km + 10 %prosentti arvosta, jolla on yksikkö, tuloksena sama yksikkö
Hylätyt yhdistelmätMerkitys
km + kgeri yksiköiden summa (metri + kilogramma)
m * mkahden yksikön tulo (metri kertaa metri)
sqrt(m)yksikön potenssi tai juuri
km / heri yksiköiden osamäärä (metri jaettuna sekunnilla)

Rajat

  • Lomakkeessa on enintään 8 kenttää.
  • Kaavassa on enintään 500 merkkiä.

Rajat ylittävä lomake hylätään, eikä mitään piirretä. Kehys täyttää säiliönsä koko leveyden, ja sen korkeus mukautuu sisältöön.

Virheet

Kehys ilmoittaa virheestä oliona, jonka type on ”error” ja jossa on koodi sekä avain at, joka kertoo virheen paikan (kentän tunniste, ”formula”, ”fields”, ”result.name” ja niin edelleen). Apuskripti välittää koodin onError-takaisinkutsulle.

Virheet lomakkeessa

KoodiMerkitys
NOT_JSONIsäntäsivun lähettämä viesti ei ole kelvollista JSON-muotoa.
NOT_AN_OBJECTViesti, kenttä tai tulos ei ole JSON-olio.
VERSIONVersioavain puuttuu tai sen arvo ei ole 1.
MISSINGLomakkeesta puuttuu pakollinen avain.
WRONG_TYPEArvon JSON-tyyppi on väärä, esim. teksti luvun tilalla.
UNKNOWN_KEYLomakkeessa on avain, jota versio 1 ei tunne.
TOO_LONGKaava on pidempi kuin merkkiraja sallii.
TOO_MANY_FIELDSLomakkeessa on enemmän kenttiä kuin sallitaan.
BAD_SLOT_IDKentän tunniste ei noudata tunnisteiden sääntöä tai se on sana mod tai funktion nimi.
EMPTY_NAMENimi on tyhjä merkkijono.
BAD_VALUEKentän valmiiksi annettu arvo ei ole pisteellä kirjoitettu desimaaliluku (esimerkiksi 12.5).
UNUSED_FIELDKenttä on ilmoitettu lomakkeessa, mutta kaava ei käytä sitä.
EMPTY_FORMULAKaava on tyhjä merkkijono.
BAD_CHARACTERKaava sisältää merkin, jota ei sallita missään kaavassa.
UNEXPECTEDMerkki on paikassa, jossa kaavan syntaksi ei salli sitä, esimerkiksi + ja × peräkkäin.
UNCLOSEDSulku avataan, mutta sitä ei suljeta.
TOO_DEEPKaavassa on liian monta sisäkkäistä tasoa (sulkuja tai kutsuja).
UNKNOWN_SLOTKaava viittaa kenttään, jota lomake ei ilmoita.
UNKNOWN_FUNCTIONKaava kutsuu funktiota, jota ei tunneta.
UNSUPPORTED_FUNCTIONNumnote tuntee funktion, mutta kehys ei vielä osaa ajaa sitä.
WRONG_ARGUMENTSFunktiota kutsutaan väärällä määrällä argumentteja.
UNIT_IN_FORMULAKaavan merkkijonoon on kirjoitettu yksikkö. Anna yksikkö sen sijaan kentälle.
UNITS_DO_NOT_MEETLaskutoimituksen yksiköitä ei voi yhdistää (sääntö on kohdassa ”Yksiköt”).
RESULT_UNITKaava tuottaa eri yksikön kuin tulokselle ilmoitettu yksikkö.
BLOCKEDKehyksen sisältävä sivusto tai sivu on estolistalla, tai kehysketjun jokin sivu piilottaa osoitteensa. Kehys ei silloin laske, vaan näyttää rivin estosta ”powered by Numnote” -rivin tilalla.

Virheet laskettaessa

KoodiMerkitys
UNKNOWN_UNITArvo annettiin yksikössä, jota sen kenttä ei hyväksy.
DIVISION_BY_ZEROJakajana on nolla.
ROOT_OF_NEGATIVENegatiivisen luvun parillinen juuri (esimerkiksi neliöjuuri).
ROOT_DEGREE_INVALIDJuuren asteluku ei ole luonnollinen luku (1, 2, 3, …).
LOG_BASE_INVALIDLogaritmin kantaluku ei kelpaa: se ei ole positiivinen tai se on 1.
LOG_ARGUMENT_NOT_POSITIVELogaritmin argumentti on nolla tai negatiivinen.
OVERFLOWTulos on liian suuri esitettäväksi.
TAN_UNDEFINEDTangenttia ei ole määritelty tässä kulmassa (esim. 90 asteessa).
COT_UNDEFINEDKotangenttia ei ole määritelty tässä kulmassa (esimerkiksi 0 asteessa).
ASIN_OUT_OF_DOMAINArkussinin argumentti on määrittelyalueen ulkopuolella (sallittu väli on [−1, 1]).
ACOS_OUT_OF_DOMAINArkuskosinin argumentti on määrittelyalueen ulkopuolella (sallittu väli on [−1, 1]).
COTH_OUT_OF_DOMAINHyperbolista kotangenttia ei voi laskea, koska argumentti on nolla.
ACOSH_OUT_OF_DOMAINKäänteistä hyperbolista kosinia (areakosinia) ei voi laskea, koska argumentti on pienempi kuin 1.
ATANH_OUT_OF_DOMAINKäänteistä hyperbolista tangenttia (areatangenttia) ei voi laskea, koska argumentti ei ole lukujen −1 ja 1 välissä.
ACOTH_OUT_OF_DOMAINKäänteistä hyperbolista kotangenttia (areakotangenttia) ei voi laskea, koska argumentin itseisarvo ei ole suurempi kuin 1.
FACTORIAL_DOMAINKertoma lasketaan vain kokonaisluvusta, joka ei ole negatiivinen.
NOT_A_NUMBERKentässä on tekstiä, jota ei voi lukea luvuksi.
BAD_PROGRAMKaavaa ei voitu ajaa Numnote-palvelun sisäisen vian vuoksi. Ilmoita asiasta Numnote-tuelle.

Tietoturva ja tietosuoja

  • Kehys vastaa vain ikkunalle, joka lähetti lomakkeen, ja vain kyseisen ikkunan alkuperään (skeema, isäntä ja portti). Toinen sivu ei voi lukea vastauksia.
  • Antamasi nimet ja yksiköt muuttuvat tekstisolmuiksi, eivät koskaan HTML-koodiksi. Nimessä oleva HTML-tagi näytetään tavallisena tekstinä.
  • Kehys ja apuskripti ladataan vain osoitteesta numnote.com. Ei kolmannen osapuolen skriptejä, ei evästeitä eikä jäljittimiä, ja kävijän syöttämät luvut eivät poistu hänen selaimestaan.
  • Kehys näyttää aina rivin ”powered by Numnote” ja linkin oikeudellisiin sivuihin; se on sen käyttöehto. Estetyllä sivustolla kehys ei laske, vaan näyttää rivin estosta tämän rivin tilalla.

Versiot

  • Lomakkeeseen kuuluu avain v arvolla 1 (v: 1). Kehyksen jokainen myöhempi versio lukee version 1 lomakkeen samalla tavalla, joten upotettu laskuri ei koskaan lakkaa toimimasta.
  • Funktiot ja yksiköt lisääntyvät ilman versionvaihtoa: funktio, jota kehys ei vielä osaa ajaa, alkaa joskus toimia, ja sitä odottavat lomakkeet alkavat laskea.
  • Avain key on varattu tulevalle versiolle. Versio 1 ohittaa sen, joten lomake, jossa se on, hyväksytään.

Kysymykset ja virheilmoitukset: support@numnote.com