Angepasste Funktionen

Für größere Flexibilität können Sie angepasste JavaScript-Funktionen erstellen, um Daten in Seiten und Ansichten zu bearbeiten.
  • Definieren Sie auf einer Seite die angepasste JavaScript -Funktion in einem angepassten HTML innerhalb von <script> -Tags.
  • Definieren Sie in einer Ansicht die angepassten JavaScript-Funktionen im Inline-JavaScript-Editor unter Verhalten.

Mithilfe der Schlüsselwörter this und page

Im Inline-JavaScript einer Ansicht verwendet das Schlüsselwort this den Geltungsbereich des ursprünglichen globalen Ausführungskontextes, d. h. this bezieht sich auf die Ansicht selbst und kann auch auf eine beliebige Ansicht verweisen, die in ihr verschachtelt ist.

Im folgenden Beispiel verfügt das Anmeldeformular über einen Text und eine Kennwortansicht, die auf der Seite definiert sind, mit den Steuer-IDs und. Beachten Sie, wie this im Inline-JavaScript verwendet wird. Die Funktion wird im Kontext der Ansicht this definiert. Gleiches gilt für die Variablen, die in der Funktion definiert sind.

Das Schlüsselwort page kann entweder in einem benutzerdefinierten HTML-Code oder im Inline-JavaScript einer Ansicht verwendet werden. Das Element page bezieht sich auf die oberste Ansicht der Seite, was bedeutet, dass auf die Ansichten in der Seite und außerdem auf die darin verschachtelten Ansichten zugegriffen werden kann. Für die verschachtelten Ansichten müssen Sie die Pfade definieren. Wenn Sie beispielsweise versucht haben, in der Sicht auf Seitenebene auf die Steuer-ID zuzugreifen, würden Sie den Pfad wie folgt angeben:

Beachten Sie, dass bei dieser Methode für die Definition einer Funktion kein Schlüsselwort verwendet wird, das dem Funktionsnamen vorangestellt ist, da die Funktion auf Seitenebene nicht mehrdeutig ist. Beachten Sie auch, wie das Schlüsselwort page anstelle von thisverwendet wird und der Pfad zu in der Funktion definiert werden musste. Im Beispiel ist dies die Steuer-ID der Ansicht und die Textsteuerelement-ID.

Angepasste Funktionen aufrufen

Nachdem Sie eine Funktion unter Verwendung einer der zuvor beschriebenen Methoden definiert haben, kann auf Ihre Funktion über die Ereignishandler einer beliebigen Ansicht zugegriffen werden. Verwenden Sie zum Aufrufen einer Funktion oder in den Konfigurationsoptionen des Ereignishandlers. Im folgenden Beispiel wird Ihre angepasste Funktion zum Ereignishandler einer Schaltfläche hinzugefügt.

Wenn eine Funktion auf weiteren Ebenen definiert ist, z. B. in der Seite und in der Ansicht, wird die Version aufgerufen, die am nächsten zur Ansicht ist. In unserem Beispiel ist, da sowohl auf Seiten-als auch auf Ansichtsebene definiert ist, die aufgerufene Version die in der Ansicht selbst definierte Version. Funktionen, die auf derselben Ebene wie der Aufruf definiert sind, werden zuerst durchsucht, und anschließend wird die Suche sequenziell über die Ebenen nach oben durchgeführt, bis die definierte Funktion gefunden wird.

In einer Verbundansicht werden dafür definierte Funktionen gegenüber gleichnamigen Funktionen bevorzugt, die in angepasstem HTML oder in einem Inhaltsfeld auf der Seite definiert sind. Auch wenn es eine temporäre Ansicht mit einem Inhaltsfeld gibt, das dieselbe benannte Funktion hat, wird die Funktion in der temporären Ansicht anstelle der Funktion im eigentlichen übergeordneten Element aufgerufen. In der Blattansicht ist nicht bekannt, ob das Inhaltsfeld diese Funktion hat. Wenn die falsche Funktion aufgerufen wird, funktioniert sie nicht. Dieses Verhalten kann zu Problemen führen, wenn beispielsweise ein Entwickler ein gebrauchsfertiges Toolkit verwendet, das zufällig die Ansicht mit dem Inhaltsfeld enthält, das die gleiche Funktion mit demselben Namen hat.
Wichtig: Um Namenskonflikte oder Konflikte zu vermeiden, verwenden Sie eindeutige Funktionsnamen, indem Sie Präfixe oder Suffixe zu Funktionen hinzufügen, die in einer Verbundansicht definiert sind.

Angepasste Funktionen mit Parametern erstellen

Eine angepasste Funktion kann auch in Argumenten übergeben werden, wodurch sie in anderen Arten von Ansichten wiederverwendbar ist. Die Methode setLabel wird in vielen Ansichten häufig verwendet. Sie können eine einzelne Funktion mit einem Parameter erstellen.

Der Funktion changeLabel wurde der Parameter zugewiesen. Anschließend können Sie eine Methode für dieses Steuerelement aufrufen. In diesem Fall wurde die Methode setLabel aufgerufen, um die Bezeichnung zu ändern. Wenn Sie die Funktion changeLabel aufrufen möchten, können Sie sie in einer der Ereignisse einer Ansicht aufrufen.

Es wurde eine Textansicht hinzugefügt, die die Funktion changeLabel aus dem Ereignis aufruft. Für die Funktion ist kein Argument erforderlich, da die Ansicht des Steuerelements immer als erstes Argument übergeben wird. Solange die Ansicht die aufgerufene Methode in der angepassten Funktion hat, wird die angepasste Funktion mit verschiedenen Typen von Ansichten verwendet.

Weitere Informationen zu den verfügbaren Methoden finden Sie unter Benutzerschnittstellen-Toolkit JavaScript API.