JavaScript-Funktionen erstellen und wiederverwenden

Das Skriptobjekt ist ein Objekt, in dem Sie JavaScript-Funktionen und -Werte getrennt von konkreten Formularobjekten speichern können. Üblicherweise verwenden Sie das Skriptobjekt zur Erstellung von benutzerdefinierten Funktionen und Methoden, die Sie als Teil von JavaScript-Skripten an mehreren Stellen in Ihrem Formular verwenden möchten. Dadurch wird der Arbeitsaufwand, der bei der Skripterstellung für sich wiederholende Aktionen normalerweise anfällt, erheblich reduziert.

Das Skriptobjekt unterstützt nur Skripten, die in JavaScript geschrieben wurden. Hinsichtlich der Stellen, an welchen die Skripten ausgeführt werden, gibt es jedoch keine Einschränkungen. Es muss lediglich gewährleistet sein, dass die Skriptsprache für das Ereignis, welches das Skriptobjekt auslöst, auf JavaScript eingestellt ist.

Im Allgemeinen verarbeiten Acrobat und Forms die Skripterstellung eines Skriptobjekts auf die gleiche Weise, es gibt jedoch auch Unterschiede.

Nur Skripten, die für die Ausführung auf dem Client konfiguriert sind, können Skriptobjekte nutzen, die für die Ausführung auf dem Client konfiguriert sind, und umgekehrt.

So erstellen Sie ein Skriptobjekt

Die Erstellung eines Skriptobjekts erfolgt in zwei Phasen. Die erste Phase besteht darin, das Objekt selbst dem Formularentwurf hinzuzufügen; die zweite Phase ist die eigentliche Erstellung des Skripts, das Sie im Skriptobjekt speichern möchten.

  1. Erstellen Sie ein neues Formular oder öffnen Sie ein vorhandenes.

  2. Klicken Sie in der Palette „Hierarchie“ mit der rechten Maustaste auf ein Objekt auf Formularebene bzw. auf Teilformularebene und wählen Sie „Skriptobjekt einfügen“.

    Grafik in Originalgröße anzeigen
    A. Objekt auf Formularebene B. Objekt auf Teilformularebene C. Skriptobjekt auf Teilformularebene D. Skriptobjekt auf Formularebene
  3. (Optional) Klicken Sie mit der rechten Maustaste auf das Skriptobjekt und wählen Sie „Objekt umbenennen“.

So fügen Sie einem Skriptobjekt Skripten hinzu

Nachdem Sie Ihr Formular mit einem Skriptobjekt versehen haben, können Sie mit dem Skript-Editor Skripten hinzufügen.

  1. Wählen Sie in der Palette „Hierarchie“ das Skriptobjekt „“ aus.

    Der Skript-Editor wird angezeigt. Die Liste „Anzeigen“ enthält den Wert „Skriptobjekt“ und die Liste „Sprache“ den Wert „JavaScript“. Sie können keinen dieser Werte ändern.

  2. Geben Sie im Feld "Skriptquelle" Ihr Skript ein.

  3. Zum Testen des Formulars klicken Sie auf die Registerkarte „PDF-Vorschau“.

Beispiel

Erstellen Sie ein Skriptobjekt namens feedback, welches die folgende Funktion enthält:

function emptyCheck(oField) { 
 
    if ((oField.rawValue == null) || (oField.rawValue == "")) { 
        xfa.host.messageBox("You must input a value for this field.", "Error Message", 3); 
    } 
}

So referenzieren Sie JavaScript-Funktionen in einem Skriptobjekt

Nachdem Sie einem Skriptobjekt Skripten hinzugefügt haben, können Sie das Skriptobjekt von jedem Ereignis aus referenzieren, das JavaScript-Skripten unterstützt.

  1. Wählen Sie ein Objekt im Formular und anschließend unter „Anzeigen“ ein Ereignis aus.

  2. Erstellen Sie eine Referenz zum Skriptobjekt und zu beliebigen Funktionen im Skriptobjekt. In der folgenden generischen Syntax wird davon ausgegangen, dass sich das Objekt, von dem aus das Skriptobjekt referenziert wird, in der Formularhierarchie auf derselben Ebene wie das Skriptobjekt befindet bzw. dass sich das Skriptobjekt in der Formularhierarchie auf der obersten Ebene befindet.

    script_object.function_name(parameter1, ...);

  3. Wenden Sie das neue Skript auf das Formularobjekt an und testen Sie es durch Anzeigen einer Formularvorschau auf der Registerkarte „PDF-Vorschau“.

Ähnlich wie beim Referenzieren anderer Objekte auf einem Formular müssen Sie beim Referenzieren des Skriptobjekts eine gültige Syntax angeben, die auch die Position des Objekts innerhalb der Formularhierarchie beinhaltet. Weitere Informationen zum Referenzieren von Objekten bei der Skripterstellung finden Sie unter Objekteigenschaften und -werte referenzieren.

Beispiel

Verwenden Sie das Skriptobjektbeispiel aus So fügen Sie einem Skriptobjekt Skripten hinzu und platzieren Sie das folgende JavaScript-Skript auf dem Ereignis exit für ein Textfeld. Testen Sie das Formular durch Anzeige auf der Registerkarte „PDF-Vorschau“.