formcycle 8.1.0 - JavaScript für Formulare

Diese JavaScript-Hilfe gibt es für jede Version von formcycle. Hier klicken, um die Hilfe für eine andere formcycle-Version einzusehen.

Auf dieser Seite findet sich die Dokumentation zu allen JavaScript-Funktionen, die im Formular bereitstehen und genutzt werden können. Im Folgenden eine kurze Übersicht, welche Arten von Funktionen es gibt und wo diese zu finden sind.

Alle in dieser Hilfe beschriebenen Funktionen stehen auch für die Autovervollständigung im JavaScript-Bereich des Designers zur Verfügung.

Wie kann überhaupt auf formcycle-spezifische Funktionen und Objekte zugegriffen werden? Hier gibt es die folgenden Möglichkeiten, unten noch genauer erläutert:

Globaler (window) Geltungsbereich

Einige wenige Funktionen und Objekte stehen direkt im globalen Geltungsbereich zu Verfügung. Auf diese wird zugegriffen, indem entweder der Name direkt genutzt wird oder auf die entsprechende Eigenschaft des window-Objekts zugegriffen wird. Zum Beispiel:

// Zugriff auf das globale Objekte "XFC_METADATA" und den Untereintrag "serverTime"
window.XFC_METADATA.serverTime;

// Es kann auch direkt ohne "window." zugegriffen werden.
XFC_METADATA.serverTime;

Diese Funktionen und Objekte sind in dieser Hilfe unter formcycle/window zu finden.

xutil-Objekt

Um den globalen Geltungsbereich nicht zu verschmutzen, werden neue Funktionen nun meist im formcycle-Objekt jQuery.xutil abgelegt. Auf dieses wird mit dem Präfix $.xutil zugegriffen:

// Holt den Wert des URL-Parameters mit dem Namen "lang" (Sprache)
$.xutil.getFormParam("lang");

Diese Funktionen und Objekte sind in dieser Hilfe unter formcycle/XUtil zu finden.

JQuery-Erweiterungen

Für die Formulare von formcycle wird die Bibliothek JQuery benutzt. Nach dem Selektieren von HTML-Elementen über JQuery bietet diese Bibliothek eine Vielzahl von Funktionen, um mit diesen Elementen weiter zu arbeiten. Zudem erlaubt JQuery es, hier neue Funktionen hinzuzufügen.

formcycle bietet viele Funktionen, die auf Elemente angewendet werden können, die mit JQuerys selektiert wurden:

// Selektieren des Elements "tfID" mit JQuery
const tfID = $("[name='tfID']");

// Benutzerdefinierte Validierung des Felds tfID
tfMail.errorFunc(() => this.value.length === 5 ? "" : "ID muss 5 Stellen haben.");

Diese Funktionen sind in dieser Hilfe unter formcycle/JQuery zu finden.

JQuery

Die Bibliothek JQuery wird von formcycle genutzt und mit ausgeliefert. Der Vollständigkeit halber findet sich die Dokumentation von JQuery auch noch einmal in dieser Hilfe unter jquery.