Η αριθμομηχανή Numnote στον ιστότοπό σας
Μια δωρεάν αριθμομηχανή που μπορείτε να βάλετε σε οποιαδήποτε ιστοσελίδα. Υπολογίζει τον τύπο που της στέλνει ο ιστότοπός σας, δικό σας ή αντιγραμμένο από τη σελίδα ενός τύπου στο numnote.com. Δεν χρειάζεται εγγραφή ούτε κλειδί και δεν στέλνει αιτήματα σε τρίτους.
Γρήγορη εκκίνηση
Ο δικός σας τύπος θέλει τρία βήματα. Ο κώδικας από τη σελίδα ενός τύπου είναι ακόμη πιο σύντομος, επειδή είναι ένα μόνο απόσπασμα.
Φορτώστε το βοηθητικό script μία φορά ανά σελίδα, πριν από τον δικό σας κώδικα.
HTML <script src="https://numnote.com/embed/v1.js"></script>Βάλτε στο HTML ένα δοχείο, εκεί όπου θέλετε να φανεί η αριθμομηχανή.
HTML <div id="calculator"></div>Καλέστε τη συνάρτηση Numnote.embed με τη φόρμα, δηλαδή την περιγραφή του τύπου. Το πλαίσιο μπαίνει μέσα στο δοχείο και προσαρμόζει μόνο του το ύψος του.
JavaScript Numnote.embed("#calculator", { "v": 1, "formula": "(morning + evening) / 2", "fields": { "morning": { "name": "Πρωί", "unit": "km", "value": "12.5" }, "evening": { "name": "Βράδυ", "unit": "km", "value": "9" } }, "result": { "name": "Μέσος όρος", "unit": "km" } }, { region: "el-cy" });
Δεν θέλετε να γράψετε μόνοι σας τη φόρμα της αριθμομηχανής; Συνθέστε την στον δημιουργό.
Κώδικας από τη σελίδα ενός τύπου
Κάθε σελίδα τύπου του ιστότοπου έχει τον κώδικά της κάτω από την ένδειξη «Ενσωμάτωση στον ιστότοπό σας», σε δύο παραλλαγές. Αν βάλετε μία από αυτές στο HTML σας, η αριθμομηχανή με τα πεδία και το αποτέλεσμά της φαίνεται εκεί όπου την τοποθετήσατε. Από τη στιγμή που θα αντιγράψετε τον κώδικα, είναι δικός σας: οι μεταγενέστερες διορθώσεις του τύπου στο numnote.com δεν θα φτάσουν σε αυτόν.
Ο κώδικας του πρώτου τύπου αυτού του ιστότοπου:
Με script
Η παραλλαγή με script είναι η πρώτη επιλογή: περνά το αποτέλεσμα στον δικό σας κώδικα, προσαρμόζει το ύψος της στη φόρμα και σας ειδοποιεί όταν η φόρμα απορρίπτεται. Δεν ταιριάζει σε ιστότοπο που δεν επιτρέπει scripts.
<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": "αριθμός",
"value": "780"
},
"p1": {
"name": "ποσοστό",
"value": "16",
"percent": true
}
},
"result": {
"name": "ποσοστό του αριθμού"
}
}, { region: "el-cy" });
</script>
<p><a href="https://numnote.com/el-cy/calc/pososto-tou-arithmou/">Ποσοστό αριθμού · Numnote</a></p>Σύνδεσμος
Η παραλλαγή με iframe: ένα μόνο πλαίσιο με τη φόρμα μέσα στη διεύθυνσή του, για ιστότοπους που επιτρέπουν μόνο iframe. Δεν μετακινεί τίποτα στη σελίδα, αλλά δεν περνά ούτε το αποτέλεσμα ούτε ειδοποίηση απόρριψης στον κώδικά σας και το ύψος της είναι σταθερό από πριν, οπότε σε στενότερη στήλη το περιεχόμενο κυλίεται μέσα στο πλαίσιο.
<iframe src="https://numnote.com/el-cy/embed/custom/#%7B%22v%22:1,%22formula%22:%22p0%20*%20p1%22,%22fields%22:%7B%22p0%22:%7B%22name%22:%22αριθμός%22,%22value%22:%22780%22%7D,%22p1%22:%7B%22name%22:%22ποσοστό%22,%22value%22:%2216%22,%22percent%22:true%7D%7D,%22result%22:%7B%22name%22:%22ποσοστό%20του%20αριθμού%22%7D%7D" title="ποσοστό του αριθμού" width="100%" height="348" style="border:0" loading="lazy"></iframe>
<p><a href="https://numnote.com/el-cy/calc/pososto-tou-arithmou/">Ποσοστό αριθμού · Numnote</a></p>Κάθε παραλλαγή τελειώνει με ορατό σύνδεσμο προς τη σελίδα του τύπου. Ο σύνδεσμος βρίσκεται έξω από το πλαίσιο, στη δική σας σελίδα: αφήστε τον εκεί, γιατί έτσι οι αναγνώστες και οι μηχανές αναζήτησης βρίσκουν τον τύπο.
Ενσωματώνοντας την αριθμομηχανή στον ιστότοπό σας, αποδέχεστε τους όρους ενσωμάτωσης.
Χαρακτηριστικά του συνδέσμου
| Χαρακτηριστικό | Τιμή | Περιγραφή |
|---|---|---|
src | https://numnote.com/el-cy/embed/custom/#<form> | Η διεύθυνση του πλαισίου: η φόρμα μπαίνει μετά το σύμβολο #, ενώ η περιοχή στη διεύθυνση ορίζει τη γλώσσα και τη μορφή των αριθμών. |
title | κείμενο | Το όνομα του τύπου για τους αναγνώστες οθόνης. Μπορείτε να το αφήσετε ή να το γράψετε στη γλώσσα σας. |
width | 100% | Το πλαίσιο καταλαμβάνει όλο το πλάτος του δοχείου του. Περιορίστε το πλάτος από το δοχείο, όχι από το πλαίσιο. |
height | 348 | Το ύψος ορίζεται από τον αριθμό των πεδίων: είναι όσο χρειάζεται το περιεχόμενο σε στήλη 320 px. Σε στενότερη στήλη το περιεχόμενο κυλίεται μέσα στο πλαίσιο. |
loading | lazy | Το πλαίσιο φορτώνεται μόνο όταν ο επισκέπτης κυλήσει μέχρι αυτό. |
Ο δικός σας τύπος
Φορτώστε το βοηθητικό script και δώστε του τη φόρμα: τον τύπο, τα πεδία του και το όνομα του αποτελέσματος. Το πλαίσιο σχεδιάζει τα πεδία, υπολογίζει ξανά καθώς ο επισκέπτης πληκτρολογεί αριθμούς και επικοινωνεί με τη σελίδα σας.
Εγκατάσταση
Το βοηθητικό script είναι ένα αρχείο χωρίς εξαρτήσεις. Δημιουργεί το πλαίσιο, στέλνει τη φόρμα μόλις φορτωθεί το πλαίσιο, ορίζει το ύψος του και καλεί τις συναρτήσεις σας. Φορτώστε το από το numnote.com αντί να το αντιγράψετε, ώστε να παίρνετε τις διορθώσεις.
<script src="https://numnote.com/embed/v1.js"></script>Η κλήση
Το δοχείο μπορεί να είναι επιλογέας CSS ή το ίδιο το στοιχείο. Η φόρμα περιγράφεται στην ενότητα «Φόρμα» και οι παράμετροι στην «Αναφορά API».
<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": "Πρωί",
"unit": "km",
"value": "12.5"
},
"evening": {
"name": "Βράδυ",
"unit": "km",
"value": "9"
}
},
"result": {
"name": "Μέσος όρος",
"unit": "km"
}
}, {
region: "el-cy",
onResult: function (answer) { console.log(answer.text); },
onError: function (code, detail) { console.log(code, detail.at); }
});
</script>Δοκιμή Αυτό είναι το πλαίσιο που δημιουργεί ο παραπάνω κώδικας. Δουλεύει εδώ: αλλάξτε έναν αριθμό και δείτε το αποτέλεσμα να αλλάζει.
Το πλαίσιο δείχνει πάντα την ένδειξη «powered by Numnote», εκτός από έναν αποκλεισμένο ιστότοπο, και η έκδοση 1 δεν έχει κλειδί που να την αφαιρεί. Ανταποκρίνεται μόνο στη σελίδα που έστειλε τη φόρμα και γράφει τα ονόματα και τις μονάδες σας ως απλό κείμενο, ποτέ ως κώδικα HTML.
Ενσωματώνοντας την αριθμομηχανή στον ιστότοπό σας, αποδέχεστε τους όρους ενσωμάτωσης.
Αναφορά API
Numnote.embed(target, form, options)
Η Numnote.embed δημιουργεί το πλαίσιο μέσα στο δοχείο, στέλνει τη φόρμα και επιστρέφει ένα αντικείμενο για την ενημέρωση ή την αφαίρεσή του.
| Παράμετρος | Είδος | Περιγραφή |
|---|---|---|
target | κείμενο | Element | Επιλογέας CSS ή στοιχείο στο οποίο τοποθετείται το πλαίσιο. Χωρίς στοιχείο το βοηθητικό script προκαλεί TypeError. |
form | αντικείμενο | Μια φόρμα έκδοσης 1, όπως περιγράφεται παρακάτω. |
options | αντικείμενο (προαιρετικό) | Προαιρετικές επιλογές: region, onResult, onError. |
Παράμετροι options
| Παράμετρος | Είδος | Περιγραφή |
|---|---|---|
region | κείμενο, προαιρετικό | Η περιοχή του πλαισίου: η γλώσσα των δικών του λέξεων και η μορφή των αριθμών. Είναι το κλειδί μιας περιοχής για την οποία υπάρχει η σελίδα, π.χ. uk-ua, en-us, en-gb. Μια γλώσσα μόνη της (uk, en) οδηγεί στην κύρια περιοχή της. Χωρίς την επιλογή το βοηθητικό script παίρνει en-us. Αν το κλειδί δεν αντιστοιχεί σε υπαρκτή περιοχή, το πλαίσιο μένει κενό. |
onResult | συνάρτηση επανάκλησης (προαιρετική) | Καλείται με το αντικείμενο του αποτελέσματος κάθε φορά που υπολογίζεται το αποτέλεσμα: μετά τη φόρτωση και μετά από κάθε αλλαγή αριθμού. |
onError | συνάρτηση επανάκλησης (προαιρετική) | Καλείται με έναν κωδικό σφάλματος και το αντικείμενο του μηνύματος όταν η φόρμα απορρίπτεται ή ο τύπος δεν μπορεί να δώσει αποτέλεσμα. |
Τιμή επιστροφής
| Μέλος | Είδος | Περιγραφή |
|---|---|---|
frame | HTMLIFrameElement | Το στοιχείο iframe, αν χρειαστεί να του δώσετε κλάση ή στυλ. |
update(form) | συνάρτηση επανάκλησης | Στέλνει μια νέα φόρμα στο ίδιο πλαίσιο: τα πεδία σχεδιάζονται ξανά και το ύψος ορίζεται από την αρχή. |
destroy() | συνάρτηση επανάκλησης | Αφαιρεί το πλαίσιο και τον ακροατή μηνυμάτων. |
Το αντικείμενο αποτελέσματος του onResult
| Μέλος | Είδος | Περιγραφή |
|---|---|---|
type | κείμενο | Πάντα το κείμενο «result». |
name | κείμενο | Το όνομα του αποτελέσματος, όπως το δώσατε στη φόρμα. |
figure | κείμενο | Ο αριθμός γραμμένος σύμφωνα με την περιοχή, όπως τον βλέπει ο επισκέπτης. |
unit | κείμενο | Η μονάδα του αποτελέσματος ή κενό κείμενο. |
text | κείμενο | Ο αριθμός μαζί με τη μονάδα του, ως ένα κείμενο. |
Η κλήση του onError
| Παράμετρος | Είδος | Περιγραφή |
|---|---|---|
code | κείμενο | Ένας κωδικός από τον πίνακα σφαλμάτων, για παράδειγμα UNKNOWN_SLOT. |
detail | αντικείμενο | Το μήνυμα του πλαισίου: type «error», code και at, όπου το at δείχνει το σημείο: το αναγνωριστικό ενός πεδίου, «formula», «fields», «result.unit». |
Μηνύματα του πλαισίου
Το βοηθητικό script είναι μόνο μια διευκόλυνση. Το πλαίσιο δουλεύει με οποιαδήποτε σελίδα μέσω postMessage: η σελίδα στέλνει τη φόρμα και το πλαίσιο ανταποκρίνεται με τρία είδη μηνυμάτων.
| Μήνυμα | Μορφή | Περιγραφή |
|---|---|---|
| form (από εσάς προς το πλαίσιο) | { v: 1, formula, fields, result } | Η σελίδα σας στέλνει στο πλαίσιο μια φόρμα έκδοσης 1 μόλις φορτωθεί το πλαίσιο. Προορισμός (targetOrigin): numnote.com. |
| result | { type: "result", name, figure, unit, text } | Το αποτέλεσμα υπολογίστηκε. Τα πεδία του περιγράφονται στο αντικείμενο αποτελέσματος παραπάνω. |
| height | { type: "height", height } | Το ύψος του περιεχομένου σε pixel. Ορίστε το στο πλαίσιο, ώστε να μην υπάρχει ράβδος κύλισης. |
| error | { type: "error", code, at } | Η φόρμα απορρίφθηκε ή ο τύπος δεν έδωσε αποτέλεσμα: το μήνυμα φέρει τα code και at. |
Το πλαίσιο ανταποκρίνεται μόνο στο παράθυρο που έστειλε τη φόρμα και μόνο στην προέλευσή του (origin). Ένα μήνυμα που δεν έχει κανένα από τα κλειδιά v, formula, fields και result θεωρείται ξένο και μένει χωρίς ανταπόκριση.
Φόρμα
Η φόρμα είναι ένα αντικείμενο JSON, έκδοσης 1. Τα ονόματα και τις μονάδες τα γράφετε με δικά σας λόγια: το πλαίσιο τα δείχνει ως απλό κείμενο και δεν τα μεταφράζει ποτέ.
| Κλειδί | Είδος | Περιγραφή |
|---|---|---|
v | αριθμός | Πάντα 1. Το πλαίσιο απορρίπτει κάθε άλλη τιμή. |
formula | κείμενο | Ο τύπος, γραμμένος με τα αναγνωριστικά των πεδίων και με τα σύμβολα και τις συναρτήσεις που περιγράφονται παρακάτω. |
fields | αντικείμενο | Η λίστα των πεδίων, με τη σειρά που θα σχεδιαστούν. Κάθε κλειδί της είναι το αναγνωριστικό ενός πεδίου, δηλαδή το όνομα με το οποίο το αναφέρει ο τύπος (λατινικά γράμματα, ψηφία και κάτω παύλες, ποτέ ψηφίο πρώτο). Ο τύπος πρέπει να περιλαμβάνει κάθε πεδίο. |
fields.<id>.name | κείμενο | Η λεζάντα που βλέπει ο επισκέπτης του ιστότοπου πάνω από το πεδίο. |
fields.<id>.unit | κείμενο, προαιρετικό | Η μονάδα του πεδίου, γραμμένη ως το κλειδί της από τη λίστα μονάδων. Κάθε άλλο κείμενο δείχνεται μόνο ως λεζάντα δίπλα στο πεδίο και δεν μετατρέπει τίποτα. |
fields.<id>.value | κείμενο, προαιρετικό | Η τιμή με την οποία ανοίγει το πεδίο (η αρχική του τιμή), γραμμένη πάντα με τελεία για υποδιαστολή, όποια κι αν είναι η γλώσσα. |
fields.<id>.percent | true ή false, προαιρετικό | Ορίστε true όταν το πεδίο περιέχει ποσοστό: ο επισκέπτης πληκτρολογεί 20 για 20%, και κάθε χρήση του πεδίου στον τύπο το διαβάζει ως ποσοστό, οπότε μετά από το + ή το − είναι μέρος του αριστερού όρου. Το πεδίο δείχνει το σύμβολο % εκεί όπου θα ήταν η μονάδα. |
result | αντικείμενο | Το αποτέλεσμα που δείχνει το πλαίσιο, κάτω από τα πεδία. |
result.name | κείμενο | Η λεζάντα του αποτελέσματος. |
result.unit | κείμενο, προαιρετικό | Η μονάδα του αποτελέσματος. Πρέπει να είναι αυτή που δίνει ο τύπος, αλλιώς η φόρμα απορρίπτεται. |
result.percent | true ή false, προαιρετικό | Ορίστε true όταν ο τύπος δίνει αριθμό ποσοστού: ένα αποτέλεσμα 25 δείχνεται ως 25%. |
key | κείμενο, προαιρετικό | Το κλειδί είναι δεσμευμένο για το μέλλον. Η έκδοση 1 το αγνοεί. |
Ελάχιστη φόρμα
Η ελάχιστη φόρμα είναι ένα πεδίο χωρίς μονάδα και ένα αποτέλεσμα χωρίς μονάδα. Όλα τα υπόλοιπα είναι προαιρετικά.
{
"v": 1,
"formula": "price + 20 %",
"fields": {
"price": {
"name": "Τιμή"
}
},
"result": {
"name": "Με ΦΠΑ"
}
}Πλήρης φόρμα
Η πλήρης φόρμα δείχνει κάθε κλειδί που γνωρίζει η έκδοση 1: μονάδες, αρχικές τιμές, ένα πεδίο ποσοστού και ένα αποτέλεσμα ποσοστού.
{
"v": 1,
"formula": "(after - before) / before * 100",
"fields": {
"before": {
"name": "Πριν",
"unit": "kg",
"value": "80"
},
"after": {
"name": "Μετά",
"unit": "kg",
"value": "76"
}
},
"result": {
"name": "Μεταβολή",
"percent": true
},
"key": ""
}Παραδείγματα
Κάθε παράδειγμα τρέχει σε αυτή τη σελίδα με το ίδιο βοηθητικό script που θα φορτώσετε στη δική σας. Ο κώδικας δίπλα σε κάθε πλαίσιο είναι πλήρης, οπότε μπορείτε να τον αντιγράψετε και να αντικαταστήσετε τις λέξεις με τις δικές σας.
Ποσοστό: πλακάκια με περιθώριο κοπής
Το πεδίο του περιθωρίου έχει percent: true. Μετά το + διαβάζεται ως μέρος του εμβαδού, οπότε το 10 σημαίνει το εμβαδόν συν το 10% του. Το αποτέλεσμα διαιρείται με το εμβαδόν μιας συσκευασίας και μένει αριθμός χωρίς μονάδα.
Numnote.embed("#calculator", {
"v": 1,
"formula": "(w * l + spare) / pack",
"fields": {
"w": {
"name": "Πλάτος δωματίου",
"unit": "m",
"value": "3.2"
},
"l": {
"name": "Μήκος δωματίου",
"unit": "m",
"value": "4.5"
},
"spare": {
"name": "Περιθώριο κοπής",
"percent": true,
"value": "10"
},
"pack": {
"name": "Εμβαδόν μιας συσκευασίας",
"unit": "m²",
"value": "1.44"
}
},
"result": {
"name": "Συσκευασίες"
}
}, {
region: "el-cy"
});Συνάρτηση: διαγώνιος ορθογωνίου
Μια συνάρτηση γράφεται με τις παραμέτρους της σε παρενθέσεις. Τα πεδία δεν έχουν μονάδες, επειδή η έκδοση 1 δεν μπορεί να πάρει τη ρίζα μιας μονάδας.
Numnote.embed("#calculator", {
"v": 1,
"formula": "sqrt(a ^ 2 + b ^ 2)",
"fields": {
"a": {
"name": "Πλευρά a",
"value": "3"
},
"b": {
"name": "Πλευρά b",
"value": "4"
}
},
"result": {
"name": "Διαγώνιος"
}
}, {
region: "el-cy"
});Αποτέλεσμα σε ποσοστό: μερίδιο των εξόδων
Το result.percent: true δείχνει το αποτέλεσμα με το σύμβολο %. Ο τύπος δίνει αριθμό ποσοστού, οπότε ο πολλαπλασιασμός επί 100 γράφεται μέσα στον ίδιο τον τύπο.
Numnote.embed("#calculator", {
"v": 1,
"formula": "part / total * 100",
"fields": {
"part": {
"name": "Έξοδα για φαγητό",
"value": "250"
},
"total": {
"name": "Όλα τα έξοδα",
"value": "1000"
}
},
"result": {
"name": "Μερίδιο",
"percent": true
}
}, {
region: "el-cy"
});Περιοχή: η γλώσσα και η μορφή των αριθμών του πλαισίου
Η ίδια φόρμα σε δύο περιοχές. Η περιοχή ορίζει τα διαχωριστικά των αριθμών και τις λέξεις του ίδιου του πλαισίου, ενώ οι λεζάντες που γράψατε μένουν όπως τις γράψατε.
Numnote.embed("#calculator-a", {
"v": 1,
"formula": "distance / days",
"fields": {
"distance": {
"name": "Απόσταση",
"unit": "km",
"value": "1234.5"
},
"days": {
"name": "Ημέρες",
"value": "4"
}
},
"result": {
"name": "Ανά ημέρα",
"unit": "km"
}
}, {
region: "el-cy"
});
Numnote.embed("#calculator-b", {
"v": 1,
"formula": "distance / days",
"fields": {
"distance": {
"name": "Απόσταση",
"unit": "km",
"value": "1234.5"
},
"days": {
"name": "Ημέρες",
"value": "4"
}
},
"result": {
"name": "Ανά ημέρα",
"unit": "km"
}
}, {
region: "uk-ua"
});region: "el-cy"
region: "uk-ua"
update() και destroy()
Το βοηθητικό script επιστρέφει ένα αντικείμενο. Το update στέλνει μια άλλη φόρμα στο ίδιο πλαίσιο, ενώ το destroy αφαιρεί το πλαίσιο από τη σελίδα. Πατήστε ένα από τα κουμπιά παρακάτω.
var calc = Numnote.embed("#calculator", formA, { region: "el-cy" });
calc.update(formB); // Τρία πεδία
calc.destroy(); // ΑφαίρεσηΣφάλματα: ένα δικό σας μήνυμα αντί για κενό πλαίσιο
Μια φόρμα που απορρίπτεται δεν σχεδιάζει τίποτα, οπότε το πλαίσιο μένει κενό. Το onError παίρνει τον κωδικό σφάλματος και το σημείο του, ώστε η σελίδα σας να πει στον επισκέπτη τι συνέβη ή να κρύψει το δοχείο. Σε αυτό το παράδειγμα ο τύπος αναφέρεται σε πεδίο που η φόρμα δεν έχει.
Numnote.embed("#calculator", {
"v": 1,
"formula": "area / coverage",
"fields": {
"area": {
"name": "Εμβαδόν τοίχου",
"unit": "m²",
"value": "40"
}
},
"result": {
"name": "Μπογιά"
}
}, {
region: "el-cy",
onError: function (code, detail) {
document.getElementById("calculator").hidden = true;
message.textContent = "Η αριθμομηχανή δεν φορτώθηκε:" + " " + code + " (" + detail.at + ")";
}
});Χωρίς το βοηθητικό script: απευθείας μέσω postMessage
Όταν το βοηθητικό script δεν ταιριάζει, για παράδειγμα σε framework με δικό του κύκλο ζωής, επικοινωνήστε εσείς με το πλαίσιο. Είναι το ίδιο πλαίσιο και τα ίδια μηνύματα.
<iframe id="calculator" src="https://numnote.com/el-cy/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": "Πρώτο",
"value": "1"
},
"b": {
"name": "Δεύτερο",
"value": "2"
}
},
"result": {
"name": "Άθροισμα"
}
}, 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>Τύπος
Ο τύπος διαβάζεται από το πρόγραμμα περιήγησης. Δέχεται αριθμούς με τελεία, αναγνωριστικά πεδίων, παρενθέσεις και τα συνηθισμένα σύμβολα πράξεων.
Μετά από το + ή το −, το ποσοστό σημαίνει μέρος του αριστερού όρου, όπως και στην ίδια την εφαρμογή Numnote. Ένα γινόμενο γράφεται πάντα με το σύμβολό του: το πλαίσιο απορρίπτει το 2a.
Μια μονάδα δεν γράφεται ποτέ στον τύπο, επειδή ανήκει στο πεδίο.
Πράξεις
| Γραφή | Περιγραφή | Παράδειγμα |
|---|---|---|
12.5 | Ένας αριθμός. Στον τύπο το δεκαδικό διαχωριστικό είναι πάντα η τελεία. | price * 1.2 |
a_1 | Αναγνωριστικό πεδίου: λατινικά γράμματα, ψηφία και κάτω παύλες. Δεν ξεκινά με ψηφίο. | width * height |
+ - | Πρόσθεση και αφαίρεση. | a + b - c |
* / | Πολλαπλασιασμός και διαίρεση. Το γινόμενο γράφεται πάντα με το σύμβολό του. | 2 * a / b |
mod | Υπόλοιπο διαίρεσης (modulo). | n mod 7 |
^ | Ύψωση σε δύναμη. | a ^ 2 |
! | Παραγοντικό. | n! |
% | Ποσοστό: μετά από το + ή το − είναι μέρος του αριστερού όρου, διαφορετικά το 1/100 του αριθμού. | price + 20 % |
( ) | Οι παρενθέσεις ορίζουν την προτεραιότητα. | (a + b) / 2 |
f(x, y) | Συνάρτηση με τις παραμέτρους της χωρισμένες με κόμματα. | root(x, 3) |
Συναρτήσεις
Μια συνάρτηση γράφεται με τις παραμέτρους της σε παρενθέσεις, χωρισμένες με κόμματα. Η παρακάτω λίστα δημιουργείται από το μητρώο συναρτήσεων του Numnote:
sin(μία παράμετρος)cos(μία παράμετρος)tg,tan(μία παράμετρος)ctg,cot(μία παράμετρος)arcsin,asin(μία παράμετρος)arccos,acos(μία παράμετρος)arctg,arctan,atan(μία παράμετρος)arcctg,arccot,acot(μία παράμετρος)sh,sinh(μία παράμετρος)ch,cosh(μία παράμετρος)th,tanh(μία παράμετρος)cth,coth(μία παράμετρος)arsh,arsinh,asinh(μία παράμετρος)arch,arcosh,acosh(μία παράμετρος)arth,artanh,atanh(μία παράμετρος)arcth,arcoth,acoth(μία παράμετρος)ln(μία παράμετρος)sqrt(μία παράμετρος)abs(μία παράμετρος)ceil(μία παράμετρος)floor(μία παράμετρος)round(μία παράμετρος)log(μία ή δύο παράμετροι)root(δύο παράμετροι)
Το ίδιο το Numnote γνωρίζει τις παρακάτω συναρτήσεις, αλλά το πλαίσιο δεν μπορεί ακόμη να τις εκτελέσει. Ένας τύπος που καλεί κάποια από αυτές απορρίπτεται με τον κωδικό σφάλματος UNSUPPORTED_FUNCTION:
Μονάδες
Η μονάδα ενός πεδίου ή του αποτελέσματος γράφεται στη φόρμα ως κλειδί μονάδας από την παρακάτω λίστα. Η λίστα δημιουργείται από το μητρώο μονάδων του Numnote. Ένα κείμενο που δεν υπάρχει στη λίστα δείχνεται μόνο ως λεζάντα και δεν μετατρέπει τίποτα.
mcmmmkminftydmim²cm²mm²km²ahaft²yd²acm³LmLcm³dm³USgalkggtlbozsminhdmowkyrJWhkWhMWhcalkcalWkWPabaratmmmHgpsiNVAOhmHzK°C°Frad°molpcpkARSAUDBRLCADCHFCLPCNYCOPCZKDKKEURGBPHKDHUFIDRILSINRISKJPYKRWMXNMYRNOKNZDPHPPLNRONSEKSGDTHBTRYUAHUSDZAR
Όταν η μονάδα ενός πεδίου έχει και άλλες μονάδες του ίδιου μεγέθους, ο επισκέπτης του ιστότοπου επιλέγει αυτή που χρειάζεται μέσα στο ίδιο το πεδίο: ο αριθμός μένει και το αποτέλεσμα υπολογίζεται ξανά. Μια λεζάντα που δεν υπάρχει στη λίστα μονάδων μένει απλό κείμενο, χωρίς επιλογή. Όταν τα πεδία έχουν διαφορετικές μονάδες του ίδιου μεγέθους (εκατοστά και μέτρα), το πλαίσιο τις μετατρέπει μόνο του και ο τύπος βλέπει ένα μέγεθος.
Ο κανόνας της έκδοσης 1: μια μονάδα συνδυάζεται μόνο με την ίδια μονάδα ή με έναν αριθμό χωρίς μονάδα. Το πλαίσιο απορρίπτει άθροισμα διαφορετικών μονάδων, γινόμενο δύο μονάδων, και δύναμη ή ρίζα μονάδας, με τον κωδικό σφάλματος UNITS_DO_NOT_MEET.
| Επιτρέπονται | Περιγραφή |
|---|---|
km + km | μια μονάδα με την ίδια μονάδα |
km * 2 | μονάδα με απλό αριθμό (μέτρα επί 2) |
km / km | πηλίκο δύο ίδιων μονάδων, που δίνει αριθμό χωρίς μονάδα |
km + 10 % | ποσοστό μιας τιμής με μονάδα, που κρατά την ίδια μονάδα |
| Απορρίπτονται | Περιγραφή |
|---|---|
km + kg | άθροισμα διαφορετικών μονάδων (μέτρα συν κιλά) |
m * m | γινόμενο δύο μονάδων (μέτρα επί μέτρα) |
sqrt(m) | ύψωση μονάδας σε δύναμη ή ρίζα μονάδας |
km / h | πηλίκο διαφορετικών μονάδων (μέτρα διά ώρα) |
Όρια
- Μια φόρμα μπορεί να δηλώνει το πολύ 8 πεδία.
- Ένας τύπος μπορεί να έχει το πολύ 500 χαρακτήρες.
Μια φόρμα που ξεπερνά τα όρια απορρίπτεται και δεν σχεδιάζεται τίποτα. Το πλαίσιο καταλαμβάνει όλο το πλάτος του δοχείου του και το ύψος του ακολουθεί το περιεχόμενο.
Σφάλματα
Το πλαίσιο αναφέρει ένα σφάλμα ως αντικείμενο με type «error», έναν κωδικό code και ένα πεδίο at που δείχνει πού βρέθηκε (αναγνωριστικό πεδίου, «formula», «fields», «result.name» κ.ο.κ.). Το βοηθητικό script περνά τον κωδικό στη συνάρτηση onError.
Σφάλματα της φόρμας
| Κωδικός | Περιγραφή |
|---|---|
NOT_JSON | Το μήνυμα της σελίδας δεν είναι σωστό JSON. |
NOT_AN_OBJECT | Το μήνυμα, ένα πεδίο ή το αποτέλεσμα δεν είναι αντικείμενο JSON. |
VERSION | Το κλειδί έκδοσης λείπει ή η τιμή του δεν είναι 1. |
MISSING | Λείπει ένα απαραίτητο κλειδί της φόρμας. |
WRONG_TYPE | Μια τιμή έχει λάθος είδος. |
UNKNOWN_KEY | Η φόρμα περιέχει κλειδί που η έκδοση 1 δεν γνωρίζει. |
TOO_LONG | Ο τύπος είναι μακρύτερος από το όριο χαρακτήρων. |
TOO_MANY_FIELDS | Η φόρμα δηλώνει περισσότερα πεδία από όσα επιτρέπονται. |
BAD_SLOT_ID | Το αναγνωριστικό ενός πεδίου δεν ακολουθεί τον κανόνα των αναγνωριστικών ή είναι η λέξη mod ή το όνομα μιας συνάρτησης. |
EMPTY_NAME | Ένα όνομα είναι κενό κείμενο. |
BAD_VALUE | Η αρχική τιμή ενός πεδίου δεν είναι δεκαδικός αριθμός γραμμένος με τελεία (όπως 12.5). |
UNUSED_FIELD | Ένα πεδίο δηλώνεται στη φόρμα, αλλά ο τύπος δεν το περιλαμβάνει. |
EMPTY_FORMULA | Ο τύπος είναι κενός. |
BAD_CHARACTER | Ο τύπος περιέχει χαρακτήρα που δεν επιτρέπεται πουθενά σε έναν τύπο. |
UNEXPECTED | Ένας χαρακτήρας βρίσκεται εκεί όπου η σύνταξη δεν τον επιτρέπει, π.χ. δύο «+» μαζί. |
UNCLOSED | Μια παρένθεση ανοίγει και δεν κλείνει. |
TOO_DEEP | Ο τύπος έχει πάρα πολλά επίπεδα το ένα μέσα στο άλλο. |
UNKNOWN_SLOT | Ο τύπος αναφέρει πεδίο που η φόρμα δεν δηλώνει. |
UNKNOWN_FUNCTION | Ο τύπος καλεί συνάρτηση που δεν υπάρχει. |
UNSUPPORTED_FUNCTION | Η συνάρτηση υπάρχει στο Numnote, αλλά το πλαίσιο δεν μπορεί ακόμη να την εκτελέσει. |
WRONG_ARGUMENTS | Στη συνάρτηση δόθηκε λάθος πλήθος τιμών. |
UNIT_IN_FORMULA | Στον τύπο γράφτηκε μονάδα. Δώστε τη μονάδα στο πεδίο αντί για τον τύπο. |
UNITS_DO_NOT_MEET | Οι μονάδες μιας πράξης δεν συνδυάζονται (δείτε τον κανόνα των μονάδων). |
RESULT_UNIT | Ο τύπος δίνει διαφορετική μονάδα από αυτήν που δηλώθηκε για το αποτέλεσμα. |
BLOCKED | Ο ιστότοπος ή η σελίδα που φιλοξενεί το πλαίσιο βρίσκεται στη λίστα αποκλεισμού, ή μια σελίδα της αλυσίδας των πλαισίων κρύβει τη διεύθυνσή της. Το πλαίσιο τότε δεν υπολογίζει και δείχνει ένα μήνυμα για τον αποκλεισμό αντί για την ένδειξη «powered by Numnote». |
Σφάλματα εκτέλεσης
| Κωδικός | Περιγραφή |
|---|---|
UNKNOWN_UNIT | Η τιμή δόθηκε σε μονάδα που το πεδίο της δεν δέχεται. |
DIVISION_BY_ZERO | Γίνεται διαίρεση με το μηδέν. |
ROOT_OF_NEGATIVE | Άρτια ρίζα (όπως η τετραγωνική) αρνητικού αριθμού. |
ROOT_DEGREE_INVALID | Ο δείκτης της ρίζας δεν είναι θετικός ακέραιος (1, 2, 3…). |
LOG_BASE_INVALID | Η βάση του λογαρίθμου δεν επιτρέπεται (μη θετική ή ίση με 1). |
LOG_ARGUMENT_NOT_POSITIVE | Ο λογάριθμος εφαρμόζεται σε μηδέν ή αρνητική τιμή. |
OVERFLOW | Το αποτέλεσμα είναι πολύ μεγάλο για να αποτυπωθεί. |
TAN_UNDEFINED | Η εφαπτομένη δεν ορίζεται σε αυτή τη γωνία (π.χ. 90 μοίρες). |
COT_UNDEFINED | Η συνεφαπτομένη δεν ορίζεται σε αυτή τη γωνία (π.χ. 0 μοίρες). |
ASIN_OUT_OF_DOMAIN | Το τόξο ημιτόνου δέχεται μόνο τιμές από −1 έως 1. |
ACOS_OUT_OF_DOMAIN | Το τόξο συνημιτόνου δέχεται μόνο τιμές από −1 έως 1. |
COTH_OUT_OF_DOMAIN | Η υπερβολική συνεφαπτομένη δεν ορίζεται για μηδέν. |
ACOSH_OUT_OF_DOMAIN | Το αντίστροφο υπερβολικό συνημίτονο δεν ορίζεται για τιμές μικρότερες του 1. |
ATANH_OUT_OF_DOMAIN | Η αντίστροφη υπερβολική εφαπτομένη ορίζεται μόνο για τιμές αυστηρά μεταξύ −1 και 1. |
ACOTH_OUT_OF_DOMAIN | Η αντίστροφη υπερβολική συνεφαπτομένη ορίζεται μόνο για τιμές με απόλυτη τιμή μεγαλύτερη του 1. |
FACTORIAL_DOMAIN | Το παραγοντικό ορίζεται μόνο για μη αρνητικούς ακέραιους. |
NOT_A_NUMBER | Ένα πεδίο περιέχει κείμενο που δεν διαβάζεται ως αριθμός. |
BAD_PROGRAM | Ο τύπος δεν μπόρεσε να εκτελεστεί λόγω εσωτερικού προβλήματος στο Numnote. Γράψτε μας για να το εξετάσουμε. |
Ασφάλεια και απόρρητο
- Το πλαίσιο στέλνει τα αποτελέσματα μόνο στο παράθυρο που έστειλε τη φόρμα, και μόνο στην προέλευση (origin) αυτού του παραθύρου. Καμία άλλη σελίδα δεν μπορεί να τα διαβάσει.
- Τα ονόματα και οι μονάδες που δίνετε γίνονται κόμβοι κειμένου, όχι κώδικας. Οι ετικέτες HTML σε ένα όνομα εμφανίζονται ως απλό κείμενο.
- Το πλαίσιο και το βοηθητικό σενάριο (script) φορτώνονται μόνο από το numnote.com. Δεν υπάρχουν σενάρια τρίτων, cookies ή ιχνηλάτες, και οι αριθμοί που πληκτρολογεί ο επισκέπτης δεν φεύγουν ποτέ από το πρόγραμμα περιήγησής του.
- Το πλαίσιο δείχνει πάντα την ένδειξη «powered by Numnote» και έναν σύνδεσμο προς τις νομικές σελίδες: αυτή είναι η προϋπόθεση χρήσης του. Σε αποκλεισμένο ιστότοπο το πλαίσιο δεν υπολογίζει και δείχνει ένα μήνυμα για αυτό αντί για την ένδειξη.
Εκδόσεις
- Η φόρμα φέρει το κλειδί v με τιμή 1 (v: 1). Κάθε μεταγενέστερη έκδοση του πλαισίου διαβάζει μια φόρμα έκδοσης 1 με τον ίδιο τρόπο, οπότε ένας ενσωματωμένος υπολογιστής δεν σταματά ποτέ να δουλεύει.
- Οι λίστες συναρτήσεων και μονάδων μεγαλώνουν χωρίς αλλαγή έκδοσης: μια συνάρτηση που δεν υποστηρίζεται ακόμη θα λειτουργήσει κάποτε, και οι φόρμες που την περιμένουν θα αρχίσουν να υπολογίζουν.
- Το κλειδί με όνομα key είναι δεσμευμένο για μελλοντική έκδοση. Η έκδοση 1 το αγνοεί, οπότε μια φόρμα που το περιέχει γίνεται δεκτή.
Για ερώτηση ή αναφορά προβλήματος γράψτε στο support@numnote.com.