Numnote
Ελληνικά (Κύπρος)

Η αριθμομηχανή Numnote στον ιστότοπό σας

Μια δωρεάν αριθμομηχανή που μπορείτε να βάλετε σε οποιαδήποτε ιστοσελίδα. Υπολογίζει τον τύπο που της στέλνει ο ιστότοπός σας, δικό σας ή αντιγραμμένο από τη σελίδα ενός τύπου στο numnote.com. Δεν χρειάζεται εγγραφή ούτε κλειδί και δεν στέλνει αιτήματα σε τρίτους.

Γρήγορη εκκίνηση

Ο δικός σας τύπος θέλει τρία βήματα. Ο κώδικας από τη σελίδα ενός τύπου είναι ακόμη πιο σύντομος, επειδή είναι ένα μόνο απόσπασμα.

  1. Φορτώστε το βοηθητικό script μία φορά ανά σελίδα, πριν από τον δικό σας κώδικα.

    HTML
    <script src="https://numnote.com/embed/v1.js"></script>
  2. Βάλτε στο HTML ένα δοχείο, εκεί όπου θέλετε να φανεί η αριθμομηχανή.

    HTML
    <div id="calculator"></div>
  3. Καλέστε τη συνάρτηση 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.

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": "αριθμός",
        "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. Δεν μετακινεί τίποτα στη σελίδα, αλλά δεν περνά ούτε το αποτέλεσμα ούτε ειδοποίηση απόρριψης στον κώδικά σας και το ύψος της είναι σταθερό από πριν, οπότε σε στενότερη στήλη το περιεχόμενο κυλίεται μέσα στο πλαίσιο.

HTML
<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>

Κάθε παραλλαγή τελειώνει με ορατό σύνδεσμο προς τη σελίδα του τύπου. Ο σύνδεσμος βρίσκεται έξω από το πλαίσιο, στη δική σας σελίδα: αφήστε τον εκεί, γιατί έτσι οι αναγνώστες και οι μηχανές αναζήτησης βρίσκουν τον τύπο.

Ενσωματώνοντας την αριθμομηχανή στον ιστότοπό σας, αποδέχεστε τους όρους ενσωμάτωσης.

Χαρακτηριστικά του συνδέσμου

ΧαρακτηριστικόΤιμήΠεριγραφή
srchttps://numnote.com/el-cy/embed/custom/#<form>Η διεύθυνση του πλαισίου: η φόρμα μπαίνει μετά το σύμβολο #, ενώ η περιοχή στη διεύθυνση ορίζει τη γλώσσα και τη μορφή των αριθμών.
titleκείμενοΤο όνομα του τύπου για τους αναγνώστες οθόνης. Μπορείτε να το αφήσετε ή να το γράψετε στη γλώσσα σας.
width100%Το πλαίσιο καταλαμβάνει όλο το πλάτος του δοχείου του. Περιορίστε το πλάτος από το δοχείο, όχι από το πλαίσιο.
height348Το ύψος ορίζεται από τον αριθμό των πεδίων: είναι όσο χρειάζεται το περιεχόμενο σε στήλη 320 px. Σε στενότερη στήλη το περιεχόμενο κυλίεται μέσα στο πλαίσιο.
loadinglazyΤο πλαίσιο φορτώνεται μόνο όταν ο επισκέπτης κυλήσει μέχρι αυτό.

Ο δικός σας τύπος

Φορτώστε το βοηθητικό script και δώστε του τη φόρμα: τον τύπο, τα πεδία του και το όνομα του αποτελέσματος. Το πλαίσιο σχεδιάζει τα πεδία, υπολογίζει ξανά καθώς ο επισκέπτης πληκτρολογεί αριθμούς και επικοινωνεί με τη σελίδα σας.

Εγκατάσταση

Το βοηθητικό script είναι ένα αρχείο χωρίς εξαρτήσεις. Δημιουργεί το πλαίσιο, στέλνει τη φόρμα μόλις φορτωθεί το πλαίσιο, ορίζει το ύψος του και καλεί τις συναρτήσεις σας. Φορτώστε το από το numnote.com αντί να το αντιγράψετε, ώστε να παίρνετε τις διορθώσεις.

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

Η κλήση

Το δοχείο μπορεί να είναι επιλογέας CSS ή το ίδιο το στοιχείο. Η φόρμα περιγράφεται στην ενότητα «Φόρμα» και οι παράμετροι στην «Αναφορά 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": "Πρωί",
          "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συνάρτηση επανάκλησης (προαιρετική)Καλείται με έναν κωδικό σφάλματος και το αντικείμενο του μηνύματος όταν η φόρμα απορρίπτεται ή ο τύπος δεν μπορεί να δώσει αποτέλεσμα.

Τιμή επιστροφής

ΜέλοςΕίδοςΠεριγραφή
frameHTMLIFrameElementΤο στοιχείο 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>.percenttrue ή false, προαιρετικόΟρίστε true όταν το πεδίο περιέχει ποσοστό: ο επισκέπτης πληκτρολογεί 20 για 20%, και κάθε χρήση του πεδίου στον τύπο το διαβάζει ως ποσοστό, οπότε μετά από το + ή το − είναι μέρος του αριστερού όρου. Το πεδίο δείχνει το σύμβολο % εκεί όπου θα ήταν η μονάδα.
resultαντικείμενοΤο αποτέλεσμα που δείχνει το πλαίσιο, κάτω από τα πεδία.
result.nameκείμενοΗ λεζάντα του αποτελέσματος.
result.unitκείμενο, προαιρετικόΗ μονάδα του αποτελέσματος. Πρέπει να είναι αυτή που δίνει ο τύπος, αλλιώς η φόρμα απορρίπτεται.
result.percenttrue ή false, προαιρετικόΟρίστε true όταν ο τύπος δίνει αριθμό ποσοστού: ένα αποτέλεσμα 25 δείχνεται ως 25%.
keyκείμενο, προαιρετικόΤο κλειδί είναι δεσμευμένο για το μέλλον. Η έκδοση 1 το αγνοεί.

Ελάχιστη φόρμα

Η ελάχιστη φόρμα είναι ένα πεδίο χωρίς μονάδα και ένα αποτέλεσμα χωρίς μονάδα. Όλα τα υπόλοιπα είναι προαιρετικά.

JSON
{
  "v": 1,
  "formula": "price + 20 %",
  "fields": {
    "price": {
      "name": "Τιμή"
    }
  },
  "result": {
    "name": "Με ΦΠΑ"
  }
}

Πλήρης φόρμα

Η πλήρης φόρμα δείχνει κάθε κλειδί που γνωρίζει η έκδοση 1: μονάδες, αρχικές τιμές, ένα πεδίο ποσοστού και ένα αποτέλεσμα ποσοστού.

JSON
{
  "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% του. Το αποτέλεσμα διαιρείται με το εμβαδόν μιας συσκευασίας και μένει αριθμός χωρίς μονάδα.

JavaScript
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 δεν μπορεί να πάρει τη ρίζα μιας μονάδας.

JavaScript
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 γράφεται μέσα στον ίδιο τον τύπο.

JavaScript
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"
});

Περιοχή: η γλώσσα και η μορφή των αριθμών του πλαισίου

Η ίδια φόρμα σε δύο περιοχές. Η περιοχή ορίζει τα διαχωριστικά των αριθμών και τις λέξεις του ίδιου του πλαισίου, ενώ οι λεζάντες που γράψατε μένουν όπως τις γράψατε.

JavaScript
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 αφαιρεί το πλαίσιο από τη σελίδα. Πατήστε ένα από τα κουμπιά παρακάτω.

JavaScript
var calc = Numnote.embed("#calculator", formA, { region: "el-cy" });
calc.update(formB);   // Τρία πεδία
calc.destroy();       // Αφαίρεση

Σφάλματα: ένα δικό σας μήνυμα αντί για κενό πλαίσιο

Μια φόρμα που απορρίπτεται δεν σχεδιάζει τίποτα, οπότε το πλαίσιο μένει κενό. Το onError παίρνει τον κωδικό σφάλματος και το σημείο του, ώστε η σελίδα σας να πει στον επισκέπτη τι συνέβη ή να κρύψει το δοχείο. Σε αυτό το παράδειγμα ο τύπος αναφέρεται σε πεδίο που η φόρμα δεν έχει.

JavaScript
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 με δικό του κύκλο ζωής, επικοινωνήστε εσείς με το πλαίσιο. Είναι το ίδιο πλαίσιο και τα ίδια μηνύματα.

HTML
<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. Ένα κείμενο που δεν υπάρχει στη λίστα δείχνεται μόνο ως λεζάντα και δεν μετατρέπει τίποτα.

  • 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

Όταν η μονάδα ενός πεδίου έχει και άλλες μονάδες του ίδιου μεγέθους, ο επισκέπτης του ιστότοπου επιλέγει αυτή που χρειάζεται μέσα στο ίδιο το πεδίο: ο αριθμός μένει και το αποτέλεσμα υπολογίζεται ξανά. Μια λεζάντα που δεν υπάρχει στη λίστα μονάδων μένει απλό κείμενο, χωρίς επιλογή. Όταν τα πεδία έχουν διαφορετικές μονάδες του ίδιου μεγέθους (εκατοστά και μέτρα), το πλαίσιο τις μετατρέπει μόνο του και ο τύπος βλέπει ένα μέγεθος.

Ο κανόνας της έκδοσης 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.