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ä.
Lataa apuskripti kerran sivua kohti, ennen omaa koodiasi.
HTML <script src="https://numnote.com/embed/v1.js"></script>Lisää HTML-koodiin säiliöelementti kohtaan, johon laskurin on määrä tulla.
HTML <div id="calculator"></div>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ä.
<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ä.
<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
| Attribuutti | Arvo | Merkitys |
|---|---|---|
src | https://numnote.com/fi-fi/embed/custom/#<form> | Kehyksen osoite: lomake tulee #-merkin jälkeen. Osoitteen alue määrää kielen ja lukujen muodon. |
title | teksti | Kaavan nimi, jonka ruudunlukijat lukevat ääneen. Voit jättää sen sellaisekseen tai kääntää sen. |
width | 100% | Kehys täyttää säiliönsä koko leveyden. Rajaa leveyttä säiliöllä, älä kehyksellä. |
height | 348 | Korkeus 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ä. |
loading | lazy | Kehys 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.
<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”.
<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.
| Parametri | Tyyppi | Merkitys |
|---|---|---|
target | teksti | Element | CSS-valitsin tai elementti, johon kehys sijoitetaan. Ilman elementtiä apuskripti heittää TypeError-virheen. |
form | olio | Version 1 lomake, kuvattu alempana. |
options | olio, valinnainen | Valinnaiset asetukset: region, onResult, onError. |
options-jäsenet
| Parametri | Tyyppi | Merkitys |
|---|---|---|
region | teksti, valinnainen | Kehyksen 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. |
onResult | funktio, valinnainen | Kutsutaan tulosoliolla aina, kun tulos on laskettu: latauksen jälkeen ja aina, kun jokin luku muuttuu. |
onError | funktio, valinnainen | Kutsutaan virhekoodilla ja viestioliolla, kun lomake hylätään tai laskeminen ei onnistu. |
Palautusarvo
| Jäsen | Tyyppi | Merkitys |
|---|---|---|
frame | HTMLIFrameElement | iframe-elementti, jos haluat antaa sille luokan tai tyylin. |
update(form) | funktio | Lähettää uuden lomakkeen samaan kehykseen: kentät piirretään uudelleen ja korkeus asetetaan uudelleen. |
destroy() | funktio | Poistaa kehyksen ja viestikuuntelijan. |
onResult-kutsun tulosolio
| Jäsen | Tyyppi | Merkitys |
|---|---|---|
type | teksti | Aina merkkijono ”result”. |
name | teksti | Tuloksen nimi sellaisena kuin se on lomakkeessasi. |
figure | teksti | Alueen mukaan muotoiltu luku sellaisena kuin kävijä sen näkee. |
unit | teksti | Tuloksen yksikkö tai tyhjä merkkijono. |
text | teksti | Luku ja sen yksikkö yhtenä merkkijonona. |
onError-kutsun saamat tiedot
| Parametri | Tyyppi | Merkitys |
|---|---|---|
code | teksti | Virhetaulukon koodi, esimerkiksi UNKNOWN_SLOT. |
detail | olio | Kehyksen 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ä.
| Viesti | Muoto | Merkitys |
|---|---|---|
| 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ä.
| Avain | Tyyppi | Merkitys |
|---|---|---|
v | luku | Aina 1. Kehys hylkää minkä tahansa muun arvon. |
formula | teksti | Laskettava kaava, kirjoitettuna kenttien tunnuksilla sekä alla kuvatuilla operaatioilla ja funktioilla. |
fields | olio | Kenttien 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>.name | teksti | Otsikko, jonka kävijä näkee kentän yläpuolella. |
fields.<id>.unit | teksti, valinnainen | Kentän yksikkö, kirjoitettuna yksikköluettelon tunnuksena; mikä tahansa muu teksti näytetään vain otsikkona kentän vieressä eikä muunna mitään. |
fields.<id>.value | teksti, valinnainen | Arvo, jolla kenttä avautuu (alkuarvo), aina kirjoitettuna pisteellä desimaalierottimena kielestä riippumatta. |
fields.<id>.percent | true tai false, valinnainen | Aseta 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. |
result | olio | Tulos, jonka kehys näyttää kenttien alla. |
result.name | teksti | Tuloksen otsikko. |
result.unit | teksti, valinnainen | Tuloksen yksikkö; sen on oltava sama yksikkö, jonka kaava tuottaa, muuten lomake hylätään. |
result.percent | true tai false, valinnainen | Aseta arvoon true, kun kaava antaa prosenttiluvun: tulos 25 näytetään muodossa 25 %. |
key | teksti, valinnainen | Avain 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.
{
"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.
{
"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öä.
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.
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.
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.
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.
var calc = Numnote.embed("#calculator", formA, { region: "fi-fi" });
calc.update(formB); // Kolme kenttää
calc.destroy(); // PoistaVirheet: 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.
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.
<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
| Kirjoitusasu | Merkitys | Esimerkki |
|---|---|---|
12.5 | Luku. Kaavassa desimaalierotin on aina piste. | price * 1.2 |
a_1 | Kentä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 |
mod | Jakojää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.
mcmmmkminftydmim²cm²mm²km²ahaft²yd²acm³LmLcm³dm³USgalkggtlbozsminhdmowkyrJWhkWhMWhcalkcalWkWPabaratmmmHgpsiNVAOhmHzK°C°Frad°molpcpkARSAUDBRLCADCHFCLPCNYCOPCZKDKKEURGBPHKDHUFIDRILSINRISKJPYKRWMXNMYRNOKNZDPHPPLNRONSEKSGDTHBTRYUAHUSDZAR
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ät | Merkitys |
|---|---|
km + km | yksikkö ja sama yksikkö (metri + metri) |
km * 2 | yksikkö ja luku (metri kertaa 2) |
km / km | kahden samanlaisen yksikön osamäärä, tuloksena luku ilman yksikköä |
km + 10 % | prosentti arvosta, jolla on yksikkö, tuloksena sama yksikkö |
| Hylätyt yhdistelmät | Merkitys |
|---|---|
km + kg | eri yksiköiden summa (metri + kilogramma) |
m * m | kahden yksikön tulo (metri kertaa metri) |
sqrt(m) | yksikön potenssi tai juuri |
km / h | eri 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
| Koodi | Merkitys |
|---|---|
NOT_JSON | Isäntäsivun lähettämä viesti ei ole kelvollista JSON-muotoa. |
NOT_AN_OBJECT | Viesti, kenttä tai tulos ei ole JSON-olio. |
VERSION | Versioavain puuttuu tai sen arvo ei ole 1. |
MISSING | Lomakkeesta puuttuu pakollinen avain. |
WRONG_TYPE | Arvon JSON-tyyppi on väärä, esim. teksti luvun tilalla. |
UNKNOWN_KEY | Lomakkeessa on avain, jota versio 1 ei tunne. |
TOO_LONG | Kaava on pidempi kuin merkkiraja sallii. |
TOO_MANY_FIELDS | Lomakkeessa on enemmän kenttiä kuin sallitaan. |
BAD_SLOT_ID | Kentän tunniste ei noudata tunnisteiden sääntöä tai se on sana mod tai funktion nimi. |
EMPTY_NAME | Nimi on tyhjä merkkijono. |
BAD_VALUE | Kentän valmiiksi annettu arvo ei ole pisteellä kirjoitettu desimaaliluku (esimerkiksi 12.5). |
UNUSED_FIELD | Kenttä on ilmoitettu lomakkeessa, mutta kaava ei käytä sitä. |
EMPTY_FORMULA | Kaava on tyhjä merkkijono. |
BAD_CHARACTER | Kaava sisältää merkin, jota ei sallita missään kaavassa. |
UNEXPECTED | Merkki on paikassa, jossa kaavan syntaksi ei salli sitä, esimerkiksi + ja × peräkkäin. |
UNCLOSED | Sulku avataan, mutta sitä ei suljeta. |
TOO_DEEP | Kaavassa on liian monta sisäkkäistä tasoa (sulkuja tai kutsuja). |
UNKNOWN_SLOT | Kaava viittaa kenttään, jota lomake ei ilmoita. |
UNKNOWN_FUNCTION | Kaava kutsuu funktiota, jota ei tunneta. |
UNSUPPORTED_FUNCTION | Numnote tuntee funktion, mutta kehys ei vielä osaa ajaa sitä. |
WRONG_ARGUMENTS | Funktiota kutsutaan väärällä määrällä argumentteja. |
UNIT_IN_FORMULA | Kaavan merkkijonoon on kirjoitettu yksikkö. Anna yksikkö sen sijaan kentälle. |
UNITS_DO_NOT_MEET | Laskutoimituksen yksiköitä ei voi yhdistää (sääntö on kohdassa ”Yksiköt”). |
RESULT_UNIT | Kaava tuottaa eri yksikön kuin tulokselle ilmoitettu yksikkö. |
BLOCKED | Kehyksen 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
| Koodi | Merkitys |
|---|---|
UNKNOWN_UNIT | Arvo annettiin yksikössä, jota sen kenttä ei hyväksy. |
DIVISION_BY_ZERO | Jakajana on nolla. |
ROOT_OF_NEGATIVE | Negatiivisen luvun parillinen juuri (esimerkiksi neliöjuuri). |
ROOT_DEGREE_INVALID | Juuren asteluku ei ole luonnollinen luku (1, 2, 3, …). |
LOG_BASE_INVALID | Logaritmin kantaluku ei kelpaa: se ei ole positiivinen tai se on 1. |
LOG_ARGUMENT_NOT_POSITIVE | Logaritmin argumentti on nolla tai negatiivinen. |
OVERFLOW | Tulos on liian suuri esitettäväksi. |
TAN_UNDEFINED | Tangenttia ei ole määritelty tässä kulmassa (esim. 90 asteessa). |
COT_UNDEFINED | Kotangenttia ei ole määritelty tässä kulmassa (esimerkiksi 0 asteessa). |
ASIN_OUT_OF_DOMAIN | Arkussinin argumentti on määrittelyalueen ulkopuolella (sallittu väli on [−1, 1]). |
ACOS_OUT_OF_DOMAIN | Arkuskosinin argumentti on määrittelyalueen ulkopuolella (sallittu väli on [−1, 1]). |
COTH_OUT_OF_DOMAIN | Hyperbolista kotangenttia ei voi laskea, koska argumentti on nolla. |
ACOSH_OUT_OF_DOMAIN | Käänteistä hyperbolista kosinia (areakosinia) ei voi laskea, koska argumentti on pienempi kuin 1. |
ATANH_OUT_OF_DOMAIN | Käänteistä hyperbolista tangenttia (areatangenttia) ei voi laskea, koska argumentti ei ole lukujen −1 ja 1 välissä. |
ACOTH_OUT_OF_DOMAIN | Käänteistä hyperbolista kotangenttia (areakotangenttia) ei voi laskea, koska argumentin itseisarvo ei ole suurempi kuin 1. |
FACTORIAL_DOMAIN | Kertoma lasketaan vain kokonaisluvusta, joka ei ole negatiivinen. |
NOT_A_NUMBER | Kentässä on tekstiä, jota ei voi lukea luvuksi. |
BAD_PROGRAM | Kaavaa 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