====== JavaScript einbetten ======
<note tip>Dieses Dokument beschreibt nicht, wie in JavaScript programmiert wird, sondern wie JavaScript mithilfe von Scribus in ein PDF-Dokument eingebunden werden kann. Für Erklärungen zu JavaScript selbst vgl. Links unter [[#weblinks|„Weblinks“]]</note>
[[wpde>JavaScript|JavaScript]] ist eine verbreitete Programmiersprache, die vor allem im Web benutzt wird, um im Browser Programme auszuführen. Als Beispiel wird in diesem Artikel ein Dokument erstellt, das beim Öffnen des Dokuments ein Fenster mit dem Text „Hallo Welt!“ ausgibt sowie beim Klick auf einen Button ebenfalls diese Meldung anzeigt. Wie dies aussehen soll, zeigt [[https://wiki.scribus-user.de/extern/javascript.html|diese Test-Webseite]] und folgender Screenshot:

{{ :themen:javascript-pdf.png?300 |}}

Eine PDF-Testdatei, die wie hier beschrieben erstellt wurde: {{:themen:javascript-test.pdf|}}

<note important>**ToDo**:\\
Warum funktioniert „Hallo Welt“-Beispiel nicht beim Laden des PDFs?!?</note>

<note important>Nicht jeder PDF-Betrachter unterstützt JavaScript; Adobe Acrobat Reader unterstützt es.</note>

===== Funktion erstellen =====

Als erstes wird die Funktion für das Anzeigen des „Hallo Welts“ erstellt: In einem geöffneten Scribus-Dokument unter //Bearbeiten// > //JavaScripts…// > //Hinzufügen…// > //Neues Script:// ''Neues_Script'' > OK folgenden Code einfügen:

<code javascript>
function TestFunktion()
{
  app.alert('Hallo Welt!');
}
</code>

Anschließend das Script via //Datei// > //Speichern und Beenden// speichern, anschließend das Fenster schließen.

===== Button einfügen =====

Über den PDF-Schaltfläche-Button :schalter: einen Rahmen erzeugen. Per //Rechtsclick auf diesen Rahmen// > //PDF-Optionen// > //Eigenschaften des Feldes// folgendes Fenster öffnen:

{{:themen:feldeigenschaften.png|}}

Unter dem Reiter //Aktion// folgendes einstellen (Code via //Bearbeiten…// einfügen und dann per //Datei// > //Speichern und Beenden// abspeichern):

{{:themen:feldeigenschaften-aktion-mit-code.png|}}

Fenster anschließend durch Drücken des OK-Buttons speichern. Anschließend kann der Button noch gestaltet und mit einem erklärenden Text versehen werden (Textrahmen über ihn legen):

{{:themen:pdf-button-textrahmen.png|}}

Jetzt ist der Button funktionsfähig und kann nach dem Export als PDF ausprobiert werden.

===== JavaScript beim Öffnen des Dokuments ausführen =====

Im PDF-Export-Dialog unter dem Reiter //Betrachter// unter „Erweiterte Aktionen“ das im ersten Schritt erstellte JavaScript auswählen; das Dokument anschließend exportieren:

{{:themen:pdf-export-javascript.png|}}

Eine PDF-Testdatei, die wie hier beschrieben erstellt wurde: {{:themen:javascript-test.pdf|}}

===== Weblinks =====

  * wiki.**scribus.net**: [[https://wiki.scribus.net/canvas/How_to_enhance_your_PDF_forms_with_JavaScript|How to enhance your PDF forms with JavaScript]]
  * **Scribus-User-Forum**: [[http://www.scribus-user.de/forum/viewtopic.php?f=11&t=113&p=932&hilit=javascript#p932|Inhalt in andere PDF Textfelder übernehmen]]
  * **Adobe**: [[https://www.adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/js_api_reference.pdf|JavaScript for Acrobat API Reference]]
  * **Adobe**: [[https://www.adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/js_developer_guide.pdf|Developing Acrobat Applications Using JavaScript]]
  * **SELFHTML**-Wiki: [[https://wiki.selfhtml.org/wiki/JavaScript|JavaScript]] (Grundlagen von JavaScript, allerdings eher mit Schwerpunkt auf Anwendung mit HTML/DOM)