formcycle 8.3.6 - JavaScript für Formulare
    Bereite Suchindex vor...

    Schnittstelle InitOptions

    Einstellungen, die bei der Initialisierung von autoNumeric übergeben werden können. Hierzu wird ein Eingabefeld mittels JQuery selektiert und die autoNumeric-Funktion aufgerufen. Dabei kann ein Optionsobjekt übergeben werden.

    $("[data-name='tfMoney']").autoNumeric(options);
    

    Die verfügbaren Eigenschaften des Optionsobjekts sind unten beschrieben.

    Es sei angemerkt, dass die Optionen statt per JavaScript auch als HTML-Data-Attribute an dem Eingabefeld übergeben werden können:

    <input id="money-field"
    data-a-dec=","
    data-a-sign="kg"
    data-v-min="1"
    data-v-max="100"
    data-m-dec="3"
    >
    interface InitOptions {
        aDec: string;
        aForm: boolean;
        altDec: string;
        aPad: boolean;
        aSep: string;
        aSign: string;
        dGroup: GroupMode;
        lZero: ZeroMode;
        mDec: number;
        mRound: RoundMode;
        nBracket: BracketMode;
        pSign: SignMode;
        vMax: number;
        vMin: number;
        wEmpty: EmptyMode;
    }
    Index

    Eigenschaften

    aDec: string

    Das zu nutzende Dezimaltrennzeichen. Standardwert ist ein Punkt (.).

    aForm: boolean

    Ob der Anfangswert des Eingabefelds beim Laden der Seite formattiert werden soll.

    • true: Der Anfangswert wird beim Laden der Seite formattiert. (Standardverhalten)
    • false: Der Anfangswert wird beim Laden der Seite belassen, wie er ist. Erst bei Eingabe durch den Nutzer wird formattiert.
    altDec: string

    Diese Einstellung wurde mit dem Ziel entwickelt, verschiedene Tastaturbelegungen zu unterstützen. Erlaubt die Festlegung einer Taste zum Eingeben des Dezimaltrennzeichens, die anders als das festgelegte Dezimaltrennzeichen sein kann.

    aPad: boolean

    Ob Dezimalstellen immer bis zu eine Mindestzahl aufgefüllt werden sollen. true: Dezimalstellen werden immer mit Nullen am Ende aufgefüllt. (Standardwert) false: Es wird nicht aufgefüllt.

    aSep: string

    Das zu nutzende Trennzeichnen für Tausender. Standardwert ist ein Komma (,).

    aSign: string

    Das zu nutzende Währungs- oder Einheitensymbol, z.B. oder EUR. Standardwert ist undefined.

    Wenn nicht gegeben, wird kein Einheitensymbol angezeigt.

    dGroup: GroupMode

    Steuert, wie Ziffern gruppiert werden, also z.B.

    • 2: Gruppierung in Hunderten, z.B. 13.24.98
    • 3: Gruppierung in Tausendern, z.B. 132.498 (Standardwert)
    • 4: Gruppierung in Zehntausendern, z.B. 13.2498
    lZero: ZeroMode

    Wie führende Nullen behandelt werden sollen:

    • allow: Erlaubt das Eingeben von führenden Nullen. Bei focusout werden führende Nullen entfernt. (Standardwert)
    • deny: Führende Nullen sind verboten.
    • keep: Führende Nullen sind erlaubt und werden bei focusout nicht entfernt.
    mDec: number

    Überschribt die Dezimalstellen, welche mit den Einstellungen vMin / vMax gesetzt werden. Standardwert ist undefined.

    mRound: RoundMode

    Rundungsmodus, der genutzt werden soll. Verfügbare Modi sind:

    • S: 5-Aufrunden Symmetrisch (Standardwert)
    • A: 5-Aufrunden Asymmetrisch
    • s: 5-Abrunden Symmetrisch
    • a: 5-Abrunden Asymmetrisch
    • B: 5-Abrunden Ausgewogen ("Kaufmännisches Runden")
    • U: Aufrunden ("Runden weg von Null")
    • D: Abrunden ("Runden in Richtung Null") - wie Abschneiden
    • C: Nach oben runden ("In Richtung Positiv-Unendlich")
    • F: Nach unten runden ("In Richtung Negativ-Unendlich")
    • CHF: Runden für schweizerische Währung, auf "das nächste .00 oder .05"
    nBracket: BracketMode

    Gibt an, ob negative Zahlen mit Klammern dargestellt werden, wenn das Eingabefeld keine Fokus hat. Standardwert is undefined, also keine Darstellung mit Klammern.

    pSign: SignMode

    Gibt an, wo das Einheitensymbol angezeigt wird:

    • p: Präfix, also links von der Zahl (Standardwert).
    • s: Suffix, also rechts von der Zahl.
    vMax: number

    Gibt den Höchstwert an, der eingegeben werden darf. Standardwert ist 9999999999999.99.

    vMin: number

    Gibt den Mindestwert an, der eingegeben werden darf. Standardwert ist -9999999999999.99.

    wEmpty: EmptyMode

    Gibt an, wie leere Eingaben behandlet werden:

    • empty: Leere Eingaben sind erlaubt (Standardwert)
    • zero: Es muss wenigstens eine Null im Eingabefeld vorhanden sein.
    • sign: Es muss wenigstens ein Einheitensymbol im Eingabefeld vorhanden sein.