(Erweiterte Funktion von Nitro PDF Pro)
JavaScript wird in Nitro PDF Pro verwendet, um benutzerdefinierte Funktionen oder Aktionen in PDF-Formularen zu erstellen. Javascript-Befehle können für Berechnungen, Formatierungen, Validierungen und viele andere Dinge auf Formularfelder angewendet werden. Fortgeschrittene Kenntnisse der JavaScript-Programmierung sind erforderlich, um bestehende Skripts zu bearbeiten oder neue Skripts hinzuzufügen. Ressourcen, die Ihnen bei der allgemeinen oder Adobe-spezifischen JavaScript-Programmierung helfen können, sind online auf w3 schools.com verfügbar. pdfscripting.com, Adobe und viele andere Quellen.
Hinweis: Nitro PDF Pro unterstützt nur JavaScripts für Acroform-PDF-Formulare. Es unterstützt keine JavaScripts für LiveCycle (XFA) -Dokumente.
Was ist JavaScript?
JavaScript ist eine objektorientierte Computerprogrammiersprache. Es wird häufig verwendet, um interaktive Effekte in Webbrowsern zu erstellen, und bietet eine leistungsstarke Möglichkeit, PDFs anzupassen.
Nitro PDF Pro ermöglicht es Ihnen, vorhandene JavaScripts über ein Skriptfenster anzusehen, hinzuzufügen, zu löschen oder zu bearbeiten. JavaScripts in einem Dokument werden entweder als Dokumentskripte oder als Seitenskripte aufgeführt. Im Allgemeinen gibt es vier Arten von JavaScript:
Dokumentskripte: Skripte auf Dokumentebene sind Skripte, die in der Skripthierarchie eines PDF-Dokuments ganz oben stehen. Diese Skripte werden zuerst ausgeführt, wenn ein Dokument in Nitro PDF Pro geladen wird. Dokumentskripte werden verwendet, um Operationen einzurichten, Umgebungstests auf höchster Ebene durchzuführen oder bestimmte Funktionen und Variablen zu definieren, die von anderen Skripten im Dokument verwendet werden.
Dokumentenaktionen: Dokumentaktionen sind Ereignisse, die durch eine Aktivität wie das Schließen, Speichern oder Drucken eines Dokuments ausgelöst werden. Die „Aktionen“ von Dokumenten ermöglichen es Formulardesignern, das Dokument vor oder nach einer dieser Aktivitäten zu ändern. In der Regel gibt es fünf Dokumentenaktionen:
- Wird geschlossen: wird vor dem Schließen einer PDF-Datei gefragt. Diese Aktion wird hauptsächlich verwendet, um zu bereinigen — zum Beispiel etwas auszuschalten —, wenn ein Dokument fortgeschrittene interaktive Multimedia-Inhalte wie Videos enthält.
- Wird speichern: wird vor dem Speichern einer PDF-Datei gefragt. Diese Aktion wird hauptsächlich verwendet, um automatische Änderungen vorzunehmen, um die gespeicherte Version des Dokuments zu unterscheiden.
- Hat gespeichert: wird nach dem Speichern einer PDF-Datei gefragt. Diese Aktion wird hauptsächlich verwendet, um Änderungen wiederherzustellen, die in der Aktion „Wird gespeichert“ vorgenommen wurden.
- Wird drucken: wird vor dem Drucken einer PDF-Datei gefragt. Diese Aktion wird hauptsächlich verwendet, um visuelle Änderungen an einem Dokument vorzunehmen, z. B. um eine Kopfzeile oder einen Stempel in einer PDF-Datei sichtbar zu machen.
- Gedruckt: wird nach dem Hinzufügen zur PDF-Datei zur Druckwarteschlange aufgefordert. Diese Aktion wird hauptsächlich verwendet, um Änderungen wiederherzustellen, die im Rahmen der Aktion „Wird gedruckt“ an dem Dokument vorgenommen wurden.
Seitenaktionen: Aktionen auf Seitenebene sind Ereignisse, die auf Seitenebene ausgelöst werden, wie das Öffnen und Schließen. Zum Beispiel bedeutet „Öffnen“ einer Seite, wenn die spezifische Seite des Dokuments vollständig sichtbar ist und die zugehörige Seitenzahl in der Symbolleiste wiedergegeben wird. Das „Schließen“ einer Seite bedeutet, dass die spezifische Seite des Dokuments nicht mehr vollständig sichtbar ist und die zugehörige Seitenzahl nicht mehr in der Symbolleiste angezeigt wird. Diese Aktionen sind generell nützlich, um Seiten zu verwalten, die interaktive Multimedia-Inhalte wie Timer, Videos oder Animationen enthalten, die Nitro PDF Pro derzeit möglicherweise nicht unterstützt.
Annotationsaktionen: Annotationsaktionen sind Ereignisse auf Seitenebene, die hauptsächlich Formularelementen für Formularfelder zugeordnet sind. Diese Aktionen ermöglichen benutzerdefinierte Funktionen oder Formatierungen für bestimmte Anmerkungen. Benutzer werden spezifische Formatierungen, Berechnungen oder Validierungen für Formularfelder bearbeiten oder hinzufügen können. Zu Formularfeldskripten gehören zwei Haupttypen von Skripten: „Widget-Skripts“ und „Formularwert-Skripts“. Widget-Skripts sind Aktionen, die auf einem Feld ausgeführt werden. Formularwert-Skripts sind Aktionen, die ausgeführt werden, wenn sich der Wert eines Formularfeldes ändert.
- Enter: Das Widget-Skript wird ausgeführt, wenn ein Cursor das Formularfeld betritt.
- Exit: Das Widget-Skript wird ausgeführt, wenn ein Cursor das Formularfeld verlässt.
- Fokus: Das Widget-Skript wird ausgeführt, wenn das Formularfeld den Tastaturfokus erreicht.
- Blur: Das Widget-Skript wird ausgeführt, wenn das Formularfeld den Tastaturfokus verliert.
- Maus hoch: Das Widget-Skript wird ausgeführt, wenn eine Maus/ein Cursor über dem Formularfeld schwebt und ein Benutzer auf die Schaltfläche klickt.
- Maus runter: Das Widget-Skript wird ausgeführt, wenn eine Maus/ein Cursor über dem Formularfeld schwebt und die Maustaste losgelassen wird.
- Seite geöffnet: siehe Seitenaktionen.
- Seite geschlossen: siehe Seitenaktionen.
- Format: Das Formwert-Skript wird nach dem Validate-Skript ausgeführt, wenn das Validate-Skript wahr ist.
- Bestätigen: Das Formularwert-Skript wird ausgeführt, wenn sich die zugehörigen Feldwerte im Dokument ändern.
- Berechnen: Das Formularwert-Skript wird ausgeführt, wenn sich die Feldwerte des Dokuments ändern.
- Tastenanschlag: Das Formularwert-Skript wird ausgeführt, wenn Tastatureingaben in ein Textfeld eingegeben werden.
Hinweis: Benutzer werden alle verfügbaren Skripts sowohl auf Dokument- als auch auf Seitenebene einsehen können. Obwohl alle Skripte technisch editierbar sind, unterstützt Nitro PDF Pro möglicherweise nicht alle JavaScripts. Zum Beispiel unterstützt Nitro PDF Pro derzeit bestimmte Multimediafunktionen wie interaktive Videos nicht. Die Anwendung unterstützt jedoch allgemeine JavaScripts wie Warnungen, Berechnungen, Formatierung und Validierung.
JavaScript-Einstellungen
Bevor JavaScript in einem Dokument ausgeführt werden kann, muss es in den Einstellungen aktiviert sein. (Benutzereinstellungen).
Aktivieren Sie JavaScript:
- Wählen Sie in der Menüleiste Nitro PDF Pro> Preferences aus dem Drop-down-Menü.
- Wählen Sie im Dialogfeld „Einstellungen“ die Registerkarte „Allgemein“.
- Markieren Sie die Option „JavaScript aktivieren“.
PDF-JavaScripts anzeigen und bearbeiten
Das Skriptfenster in Nitro PDF Pro ermöglicht es Ihnen, das JavaScript eines Dokuments anzusehen und zu bearbeiten. Wenn mehrere Dokumente gleichzeitig in Nitro PDF Pro geöffnet sind, werden im Skriptfenster die Skripts des Dokuments angezeigt, die Sie gerade bearbeiten.
- Wählen Sie in der Menüleiste Windows> Scripts aus dem Drop-down-Menü aus, um das Skriptfenster anzuzeigen.
- Alle JavaScripts, die derzeit in dem Dokument enthalten sind, sind im linken Bereich aufgeführt. Dokumentskripte sind oben aufgeführt. Die Seitenskripte, die auf jeder Seite zu finden sind, sind unten aufgeführt.
- Klicken Sie, um ein Element im linken Bereich auszuwählen, um das JavaScript im Bereich des Skript-Editors auf der rechten Seite anzuzeigen.
- Klicken Sie in den Bereich des Skript-Editors, um mit der Bearbeitung des Skripts zu beginnen.
- Änderungen an Skripten werden automatisch gespeichert.
Hinweis: Adobe-JavaScripts sind normalerweise durch das Präfix „AF“ gekennzeichnet.
Löschen von PDF-JavaScripts
Das Skriptfenster ermöglicht es Ihnen, JavaScripts in einer PDF-Datei zu löschen. Die derzeit im Dokument enthaltenen JavaScripts sind im linken Bereich aufgeführt.
- Wählen Sie in der Menüleiste Windows> Scripts aus dem Drop-down-Menü aus, um das Skriptfenster anzuzeigen.
- Alle JavaScripts, die derzeit in dem Dokument enthalten sind, sind im linken Bereich aufgeführt. Dokumentskripte sind oben aufgeführt. Seitenskripte sind unten für jede Seite aufgeführt.
- Klicken Sie, um ein Element im linken Bereich auszuwählen, um das JavaScript im Bereich des Skript-Editors auf der rechten Seite anzuzeigen.
- Klicken Sie auf das Minus in der unteren linken Ecke des Skriptfensters, um ein Script zu löschen.
- Änderungen an Skripten werden automatisch gespeichert.
Hinzufügen von PDF-JavaScripts
Das Skriptfenster ermöglicht es Ihnen, dem PDF neue Skripte hinzuzufügen.
- Wählen Sie in der Menüleiste Windows> Scripts aus dem Drop-down-Menü aus, um das Skriptfenster anzuzeigen.
- Die derzeit im Dokument enthaltenen JavaScript-Aktionen sind im linken Bereich aufgeführt. Dokumentskripte sind oben aufgeführt. Seitenskripte sind unten für jede Seite aufgeführt.
- Klicken Sie auf das Pluszeichen + in der unteren linken Ecke des Skriptfensters, um ein neues Skript hinzuzufügen.
- Wählen Sie im Dialogfeld „Skript hinzufügen“ einen Skripttyp aus dem Drop-down-Menü „Skripttyp auswählen“ aus.
- Wenn Sie eine Anmerkungsaktion zu einem Formularfeld hinzufügen, wählen Sie eine Aktion aus dem" Dropdown-Menü Aktion" auswählen aus. Informationen zum Hinzufügen von Formularfeldberechnungen finden Sie unter Formulare erstellen.
- Klicken Sie in den Bearbeitungsbereich und ersetzen Sie den Standardtext"//geben Sie Ihr Skript hier" durch ein neues Skript ein.
- Änderungen an Skripten werden automatisch gespeichert.
Hinweis: Um eine Annotation-Aktion zu einem bestimmten Formularfeld hinzuzufügen, müssen Sie das Formularfeld ausgewählt haben, bevor Sie auf das Pluszeichen + klicken, um ein Skript hinzuzufügen. Wenn Sie keine bestimmte Anmerkung ausgewählt haben, können Sie nur Dokument - oder Seitenskripts hinzufügen.
JavaScripts ausführen
Es gibt ein paar Möglichkeiten, Ihr JavaScript zu testen. Verwenden Sie das JavaScript-Fenster, um Skripts Zeile für Zeile auszuführen.
- Halten Sie die Wahltaste (oder Alt) gedrückt.
- Wählen Sie Windows> JavaScript Console.
- Geben Sie Skripts in der Konsole ein oder fügen Sie sie ein.
- Klicken Sie auf Ausführen.
Hinweis: JavaScripts werden nur erfolgreich ausgeführt, wenn:
- Das Drehbuch ist korrekt.
- Das Skript wird von Ihrer PDF-Version unterstützt.
- Das Skript wird von Nitro PDF Pro unterstützt.