agorum.composite.form.element.number

Dieses Element stellt ein Zahlen-Eingabefeld dar.

agorum.composite.form.element.number erbt alle grundlegenden Eigenschaften von element.

Beispiel

 

---

Skript zur Oberfläche

let aguila = require('common/aguila');

let form = aguila.create({
  width: 500,
  height: 300,
  type: 'agorum.composite.form.basic',

  elements: [
    {
      type: 'agorum.composite.form.element.number',
      name: 'numberField1',
      label: 'Nummer 1',
      calculator: true,
      value: 123.456,
      precision: 2
    },
    {
      type: 'agorum.composite.form.element.number',
      name: 'numberField2',
      label: 'Nummer 2',
      value: 123,
      integer: true
    },
    {
      type: 'agorum.composite.form.element.number',
      name: 'numberField3',
      label: 'Nummer 3',
      value: 1234567.891,
      format: ',000.00',
      readOnly: true
    }
  ]
});

form;

Parameter

---

Alle Parameter in element gelten. Zusätzlich gelten die folgenden Parameter.

calculator

Erzeugt einen Taschenrechner im gewählten Element.

Sie können den Taschenrechner über die Tastatur und über die Maus verwenden.

Parameter	Beschreibung
true	Aktiviert den Taschenrechner.
false (Standard)	Deaktiviert den Taschenrechner.

precision

Definiert die Anzahl der Nachkommastellen zwischen 0 und 100, die ein Benutzer eingeben kann und die erscheinen.

• Möglich sind Zahlen zwischen 0 und 100 (Standard: 2).
• Sie können diesen Parameter nachträglich ändern.

Beispiel

form.down('numberField1').precision = 3;

format

Definiert das Anzeigeformat der Zahl und überschreibt im Anzeigemodus die Definition von precision.

• Der Parameter gilt nicht für den Bearbeitungsmodus.
• In der Definition ist ein Komma das Tausendertrennzeichen und der Punkt das Dezimaltrennzeichen.
• Sie können diesen Parameter nachträglich ändern.

Beispiel

form.down('numberField1').format = ',000.00';

Die Sprache für das Format wählen

Das System verwendet im Standard die Sprache des Benutzers für die Formatierung. Sie können diese Sprachen überschreiben, indem Sie die Sprache vor das Format voranstellen und mit | trennen:

form.down('numberField1').format = 'en|,000.00';

Weitere Beispiele

• 0 = keine Nachkommastellen
• 0.00 = 2 Nachkommastellen
• 0.0000 = 4 Nachkommastellen
• ,000 = zeigt Tausendertrennzeichen und keine Nachkommastellen
• ,000.00 = zeigt Tausendertrennzeichen und 2 Nachkommastellen
• 0.#### = Maximal 4 Nachkommastellen, Nullen rechts werden weggelassen
• ,000.00 € = Schreibt die Zahl und nach der Zahl noch €
  etwa 25.132,40 €.

integer

Parameter	Beschreibung
true	Die Zahl ist eine Ganzzahl.
false (Standard)	Das System verwendet Dezimalzahlen (im Standard mit zwei Nachkommastellen, sofern nicht anders definiert).

Beispiel

form.down('numberField1').integer = true;

Sie können diesen Parameter nachträglich ändern.

increment

Definiert die Schrittzahl, die das System hoch- oder runterzählt, wenn ein Benutzer beim Eingabefeld auf die Pfeile klickt oder die Pfeiltasten verwendet (Standard: 1).

• Sie können beliebige dezimale Werte definieren, auch negative (kehrt die Richtung um).
• Sie können diesen Parameter nachträglich ändern.

Beispiel

form.down('numberField1').increment = 0.5;

Events

---

Alle Events in element gelten. Zusätzlich gelten die folgenden Events.

precisionChanged

Löst aus, wenn sich der Parameter precision ändert.

Das System übergibt als Parameter den neuen Wert von precision.

integerChanged

Löst aus, wenn sich der Parameter integer ändert.

Das System übergibt als Parameter den neuen Wert von integer.

formatChanged

Löst aus, wenn sich der Parameter format ändert. 

Das System übergibt als Parameter den neuen Wert von format.

incrementChanged

Löst aus, wenn sich der Parameter increment ändert.

Das System übergibt als Parameter den neuen Wert von increment.

Den Taschenrechner verwenden

---

Der Taschenrechner (über den Parameter calculator steuerbar) erscheint rechts neben dem entsprechenden Label / Eingabefeld in Form des Symbols .

Eingabemöglichkeiten

Geben Sie in das Feld daneben (hier: Nummer 1) eine Zahl ein und klicken Sie auf das Symbol, übernimmt das System die Zahl direkt in den Taschenrechner:

Addieren Sie etwa zur 55 die Zahl 10 hinzu und klicken auf Übernehmen, setzt das System das Ergebnis automatisch in das Feld daneben:

Bearbeitungsmöglichkeiten

Im Taschenrechner existieren neben den angezeigten Zahlen und Zeichen folgende Bearbeitungsmöglichkeiten in Form von Symbolen.

Symbol	Beschreibung	Beispiel
	Löscht die angezeigte Ziffer.	Aus 55 wird 5.
	Löscht alle bereits getätigten Eingaben.	–
	Erzeugt ein Eingabefeld für Ziffern /Zeichen. Die Ziffern / Zeichen können Sie entweder direkt eingeben oder kopierte Zahlen und Zeichen einfügen, um so eine direkte Berechnung durchzuführen. Klicken Sie auf Übernehmen, damit das System das Ergebnis automatisch ausrechnet und es in das Feld setzt.	–

Bedienung per Tastatur

Abgebildetes Zeichen im Taschenrechner	Taste auf Tastatur
%	%
C	c
<	Backspace
/	/ (Ziffernblock)
1	1
2	2
3	3
4	4
5	5
6	6
7	7
8	8
9	9
0	0
+/-	p
,	. oder ,
=	= oder Enter Enter schließt den Taschenrechner und übernimmt den Wert.
ESC	ESC Schließt den Editor, ohne den Wert zu übernehmen.
	e Aktiviert das Eingabefeld für Ziffern und Zeichen. Enter schließt das Feld wieder und übernimmt die Ziffern / Zeichen, ohne den Taschenrechner zu schließen.

Beispiele für Rechenoperatoren

Das System führt jeden Rechenoperator sofort auf die Eingabe aus (keine Punkt- vor Strichrechnung).

Eingabe in Taschenrechner	Beschreibung	Ergebnis
16 +19%	Zählt 19 % zu 16 hinzu.	19.04
300 * 19%	Rechnet 19 % von 300.	57
200 - 19%	Zieht 19 % von 200 ab.	162
119 / 1.19	Rechnet 119 Brutto in Netto (Brutto -> Netto - MwSt-Satz = 19 %).	100
100 - 200*2	Rechnet 100–200 und nimmt dann *2.	-200
200 / 10%	200 / (10 % -> 0,1) = 200/0.1 = 2000	2000
123/0	Teilt 123 durch 0.	Bei Klick auf = erscheint eine Fehlermeldung. Bei Klick auf Enter übernimmt das System den Wert 0 in das Eingabefeld.