JavaScript bewerken en toevoegen

(Geavanceerde functie van Nitro PDF Pro)

JavaScript wordt in Nitro PDF Pro gebruikt om aangepaste functies of acties in PDF-formulieren te maken. Javascript-opdrachten kunnen worden toegepast op formuliervelden voor berekeningen, opmaak, validaties en vele andere zaken. Geavanceerde kennis van JavaScript-programmering is vereist om bestaande scripts te bewerken of nieuwe scripts toe te voegen. Hulpbronnen die kunnen helpen met algemene of Adobe-specifieke JavaScript-programmering zijn online beschikbaar via w3schools.com, pdfscripting.com, Adobe, en vele andere bronnen.

Opmerking: Nitro PDF Pro ondersteunt alleen JavaScripts voor Acroform PDF-formulieren. Het ondersteunt geen JavaScripts voor LiveCycle (XFA) documenten.

JavaScript is een objectgeoriënteerde computerprogrammeertaal. Het wordt vaak gebruikt om interactieve effecten te creëren in webbrowsers en biedt een krachtige manier om PDF's aan te passen.

Met Nitro PDF Pro kunt u bestaande JavaScripts bekijken, toevoegen, verwijderen of bewerken via een scriptvenster. JavaScripts in een document worden weergegeven als Document scripts of Pagina scripts. Er zijn over het algemeen vier soorten JavaScript:

Documentscripts: scripts op documentniveau zijn scripts bovenaan de scripthiërarchie van een PDF-document. Deze scripts worden als eerste uitgevoerd wanneer een document in Nitro PDF Pro wordt geladen. Documentscripts worden gebruikt om bewerkingen in te stellen, om omgevingstests op het hoogste niveau uit te voeren, of om bepaalde functies en variabelen te definiëren die door andere scripts in het document worden gebruikt.

Documentacties: Documentacties zijn gebeurtenissen die worden veroorzaakt door een activiteit, zoals het sluiten, opslaan of afdrukken van een document. Met document "acties" kunnen formulierontwerpers het document voor of na deze activiteiten wijzigen. Meestal zijn er vijf documentacties:

• Will Close: gevraagd vóór het sluiten van een PDF. Deze actie wordt voornamelijk gebruikt om op te ruimen - zoals iets afsluiten - als een document geavanceerde interactieve multimedia bevat, zoals video's.
• Zal opslaan: gevraagd vóór het opslaan van een PDF. Deze actie wordt voornamelijk gebruikt om automatische wijzigingen aan te brengen om de opgeslagen versie van het document te onderscheiden.
• Heeft opgeslagen: gevraagd na het opslaan van een PDF. Deze actie wordt voornamelijk gebruikt om wijzigingen die zijn aangebracht in de actie "Opslaan" te herstellen.
• Will Print: gevraagd vóór het afdrukken van een PDF. Deze actie wordt voornamelijk gebruikt om visuele wijzigingen in een document aan te brengen, zoals het zichtbaar maken van een koptekst of stempel op een PDF.
• Did Print: gevraagd na het toevoegen van de PDF aan de afdrukwachtrij. Deze actie wordt voornamelijk gebruikt om wijzigingen die in het document zijn aangebracht in de actie "Afdrukken" te herstellen.

Pagina-acties: Acties op paginaniveau zijn gebeurtenissen op paginaniveau, zoals openen en sluiten. Het "openen" van een pagina betekent bijvoorbeeld dat de specifieke pagina van het document volledig zichtbaar is en dat het bijbehorende paginanummer wordt weergegeven op de werkbalk . Het "sluiten" van een pagina betekent dat de specifieke pagina van het document niet meer volledig zichtbaar is en dat het bijbehorende paginanummer niet meer wordt weergegeven in de werkbalk. Deze acties zijn over het algemeen nuttig voor het beheer van pagina's met interactieve multimedia zoals timers, video's of animaties, die Nitro PDF Pro momenteel niet ondersteunt.

Annotatieacties: Annotatieacties zijn gebeurtenissen op paginaniveau die voornamelijk geassocieerd worden met formulierelementen voor formuliervelden. Deze acties maken aangepaste functies of opmaak voor specifieke annotaties mogelijk. Gebruikers kunnen specifieke opmaak, berekeningen of validaties voor formuliervelden bewerken of toevoegen. Scripts voor formuliervelden omvatten twee hoofdtypen scripts: "Widget scripts" en "Formulier-waarde scripts". Widgetscripts zijn acties die op een veld worden uitgevoerd. Formulier-waardescripts zijn acties die plaatsvinden wanneer de waarde van een formulierveld verandert.

• Enter: widget script wordt uitgevoerd wanneer een cursor het formulierveld binnenkomt.
• Exit: widget script wordt uitgevoerd wanneer een cursor het formulierveld verlaat.
• Focus: widget script wordt uitgevoerd wanneer het formulierveld toetsenbordfocus krijgt.
• Vervagen: widget script wordt uitgevoerd wanneer het formulierveld de toetsenbordfocus verliest.
• Muis omhoog: widget script wordt uitgevoerd wanneer een muis/cursor over het formulierveld beweegt, en een gebruiker op de knop klikt.
• Muis omlaag: Het widget script wordt uitgevoerd wanneer een muis/cursor over het formulierveld beweegt en de muisknop wordt losgelaten.
• Pagina geopend: zie Pagina acties.
• Pagina gesloten: zie Pagina acties.
• Formaat: formulier-waarde script wordt uitgevoerd na het Validate script als het Validate script waar is.
• Valideer: formulier-waardescript wordt uitgevoerd wanneer geassocieerde veldwaarden in het document veranderen.
• Bereken: formulier-waardescript wordt uitgevoerd wanneer de veldwaarden van het document veranderen.
• Toetsaanslag: formulier-waardescript wordt uitgevoerd wanneer toetsaanslagen worden ingevoerd in een tekstveld.

Opmerking: Gebruikers zullen alle beschikbare scripts kunnen bekijken op zowel document- als paginaniveau. Hoewel alle scripts technisch gezien bewerkbaar zijn, ondersteunt Nitro PDF Pro mogelijk niet alle JavaScripts. Zo ondersteunt Nitro PDF Pro momenteel bepaalde multimedia, zoals interactieve video's, niet . De toepassing ondersteunt echter algemene JavaScripts zoals waarschuwingen, berekeningen, opmaak en validatie.

Voordat JavaScript in een document kan worden uitgevoerd, moet het worden ingeschakeld in Voorkeuren. (Gebruikersvoorkeuren).

JavaScript inschakelen:

1. Kies in de menubalk Nitro PDF Pro> Voorkeuren uit het dropdownmenu.
2. Selecteer het tabblad Algemeen in het venster Voorkeuren.
3. Vink de optie "JavaScript inschakelen" aan.

In het Script-venster van Nitro PDF Pro kunt u de JavaScript van een document bekijken en bewerken. Als meerdere documenten tegelijkertijd in Nitro PDF Pro zijn geopend, worden in het venster Script de scripts van het document weergegeven die u actief aan het bewerken bent.

1. Kies in de menubalk Venster > Scripts uit het dropdown menu om het Script-venster weer te geven.
2. Alle JavaScripts die momenteel in het document zijn opgenomen, staan in het linkerdeelvenster. Documentscripts staan bovenaan. De paginascripts op elke pagina staan hieronder.
3. Klik om een item in het linkerdeelvenster te selecteren om het JavaScript weer te geven in het rechterdeelvenster van de scriptbewerker.
4. Klik in het deelvenster van de scriptbewerker om het script te bewerken.
5. Wijzigingen in scripts worden automatisch opgeslagen.

Opmerking: Adobe JavaScripts worden gewoonlijk gekenmerkt door het voorvoegsel "AF".

In het venster Script kunt u JavaScripts in een PDF verwijderen. De JavaScripts die momenteel in het document zijn opgenomen, staan in het linkerdeelvenster.

1. Kies in de menubalk Venster > Scripts uit het dropdown menu om het Script-venster weer te geven.
2. Alle JavaScripts die momenteel in het document zijn opgenomen, staan in het linkerdeelvenster. Documentscripts staan bovenaan. Voor elke pagina worden hieronder paginascripts vermeld.
3. Klik om een item in het linkerdeelvenster te selecteren om het JavaScript weer te geven in het rechterdeelvenster van de scriptbewerker.
4. Klik op de min - linksonder in het Script-venster om een script te verwijderen.
5. Wijzigingen in scripts worden automatisch opgeslagen.

In het venster Script kunt u nieuwe scripts aan de PDF toevoegen.

1. Kies in de menubalk Venster > Scripts uit het dropdown menu om het Script-venster weer te geven.
2. De JavaScript-acties die momenteel in het document zijn opgenomen, staan in het linkerdeelvenster. Documentscripts staan bovenaan. Voor elke pagina worden hieronder paginascripts vermeld.
3. Klik op de plus + linksonder in het Script-venster om een nieuw script toe te voegen.
4. In het dialoogvenster Een script toevoegen selecteert u een scripttype in het keuzemenu Scripttype selecteren .
5. Als u een Annotatieactie aan een formulierveld toevoegt, selecteer dan een actie in het keuzemenu "Kies actie". Voor informatie over het toevoegen van berekeningen voor formuliervelden, zie Formulieren maken.
6. Klik in het bewerkingsvenster en vervang de standaardtekst "// typ hier uw script" door een nieuw script.
7. Wijzigingen in scripts worden automatisch opgeslagen.

Opmerking: Om een Annotatieactie aan een specifiek formulierveld toe te voegen, moet u het formulierveld geselecteerd hebben voordat u op het plusje + klikt om een script toe te voegen. Als u geen specifieke annotatie hebt geselecteerd, kunt u alleen Document of Pagina scripts toevoegen.

Er zijn een paar manieren om uw JavaScript te testen. Om scripts regel voor regel uit te voeren, gebruikt u het JavaScript-venster.

1. Houd de Option (of Alt) toets ingedrukt.
2. Kies Venster > JavaScript Console.
3. Typ of plak scripts in de Console.
4. Klik op Uitvoeren.

Om uw formulier met berekeningen te testen, moet u overschakelen naar het gereedschap Tekst selecteren

(Command+1) om uw vorm uit te proberen. Ga terug naar het gereedschap Bewerken

(Command+2) om het uiterlijk van elementen die u in uw formulier hebt geplaatst te bewerken.

Opmerking: JavaScripts worden alleen succesvol uitgevoerd als:

• Het script is correct.
• Het script wordt ondersteund door uw PDF-versie.
• Het script wordt ondersteund door Nitro PDF Pro.