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 doeleinden. Er is geavanceerde kennis van JavaScript-programmering vereist om bestaande scripts te bewerken of nieuwe scripts toe te voegen. Informatiebronnen die kunnen helpen bij 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 JavaScript voor Acroform PDF-formulieren. Het ondersteunt geen JavaScript voor LiveCycle (XFA)-documenten.
Wat is JavaScript?
JavaScript is een objectgeoriënteerde programmeertaal. Het wordt vaak gebruikt om interactieve effecten in webbrowsers te creëren 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 ‘Documentscripts ’ of ‘Paginascripts ’. Er zijn over het algemeen vier soorten JavaScript:
Documentscripts: scripts op documentniveau bevinden zich bovenaan de script hië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, 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 geactiveerd door een handeling, zoals het sluiten, opslaan of afdrukken van een document. Met documentacties kunnen formulierontwerpers het document vóór of na een van deze handelingen wijzigen. Er zijn doorgaans vijf documentacties:
- Wordt gesloten: wordt geactiveerd voordat een PDF wordt gesloten. Deze actie wordt voornamelijk gebruikt om op te ruimen – bijvoorbeeld door iets uit te schakelen – als een document geavanceerde interactieve multimedia zoals video’s bevat.
- Wordt opgeslagen: wordt geactiveerd voordat een PDF wordt opgeslagen. Deze actie wordt voornamelijk gebruikt om automatische wijzigingen aan te brengen om de opgeslagen versie van het document te onderscheiden.
- Is opgeslagen: wordt weergegeven na het opslaan van een PDF. Deze actie wordt voornamelijk gebruikt om wijzigingen die in de actie ‘Wordt opgeslagen’ zijn aangebracht, ongedaan te maken.
- Wordt afgedrukt: wordt gevraagd voordat een PDF wordt afgedrukt. Deze actie wordt voornamelijk gebruikt om visuele wijzigingen aan een document aan te brengen, zoals het zichtbaar maken van een koptekst of stempel op een PDF.
- 'Is afgedrukt': wordt weergegeven nadat de PDF aan de afdrukwachtrij is toegevoegd. Deze actie wordt voornamelijk gebruikt om wijzigingen die in de actie 'Wordt afgedrukt' aan het document zijn aangebracht, ongedaan te maken.
Aantekeningsacties: Aantekeningsacties zijn gebeurtenissen op paginaniveau die voornamelijk verband houden met formulierelementen voor formuliervelden. Deze acties maken aangepaste functies of opmaak voor specifieke aantekeningen mogelijk. Gebruikers kunnen specifieke opmaak, berekeningen of validaties voor formuliervelden bewerken of toevoegen. Er zijn twee hoofdtypen scripts voor formuliervelden: ‘widgetscripts’ en ‘formulierwaardescripts’. Widgetscripts zijn acties die op een veld worden uitgevoerd. Formulierwaardescripts zijn acties die plaatsvinden wanneer de waarde van een formulierveld verandert.
- Enter: het widgetscript wordt uitgevoerd wanneer de cursor het formulierveld binnenkomt.
- Exit: het widgetscript wordt uitgevoerd wanneer de cursor het formulierveld verlaat.
- Focus: het widgetscript wordt uitgevoerd wanneer het formulierveld de toetsenbordfocus krijgt.
- Blur: het widgetscript wordt uitgevoerd wanneer het formulierveld de toetsenbordfocus verliest.
- Muis los: het widgetscript wordt uitgevoerd wanneer de muis/cursor boven het formulierveld zweeft en de gebruiker op de knop klikt.
- Muis los: het widgetscript wordt uitgevoerd wanneer de muis/cursor boven het formulierveld zweeft en de muisknop wordt losgelaten.
- Pagina geopend: zie Pagina-acties.
- Pagina gesloten: zie Pagina-acties.
- Opmaak: het formulierwaardescript wordt uitgevoerd na het validatiescript als het validatiescript waar is.
- Validate: het formulierwaardescript wordt uitgevoerd wanneer de bijbehorende veldwaarden in het document veranderen.
- Berekenen: het formulierwaardescript wordt uitgevoerd wanneer de veldwaarden van het document veranderen.
- Toetsaanslag: het formulierwaardescript wordt uitgevoerd wanneer er toetsaanslagen in een tekstveld worden ingevoerd.
JavaScript-voorkeuren Voordat JavaScript in een document kan worden uitgevoerd, moet het worden ingeschakeld in de voorkeuren. ( Gebruikersvoorkeuren ).
JavaScript inschakelen:
- Kies in de menubalk Nitro PDF Pro > Voorkeuren in het vervolgkeuzemenu.
- Selecteer het tabblad Algemeen in het dialoogvenster Voorkeuren.
- Vink de optie 'JavaScript inschakelen' aan.
PDF-JavaScripts bekijken en bewerken In het venster ‘Script’ van Nitro PDF Pro kunt u het JavaScript van een document bekijken en bewerken. Als er meerdere documenten tegelijkertijd zijn geopend in Nitro PDF Pro, toont het venster ‘Script’ de scripts van het document dat u op dat moment aan het bewerken bent.
- Kies in de menubalk 'Venster' > 'Scripts' in het vervolgkeuzemenu om het venster 'Script' weer te geven.
- Alle JavaScript-scripts die momenteel in het document zijn opgenomen, worden in het linkerdeelvenster weergegeven. De scripts van het document staan bovenaan. De paginascripts die op elke pagina zijn aangetroffen, worden daaronder weergegeven.
- Klik op een item in het linkerdeelvenster om het JavaScript in het script-editorvenster aan de rechterkant weer te geven.
- Klik in het script-editorvenster om het script te bewerken.
- Wijzigingen in scripts worden automatisch opgeslagen.
JavaScript-code uit een PDF verwijderen In het venster ‘Script’ kunt u JavaScript-code uit een PDF verwijderen. De JavaScript-code die momenteel in het document is opgenomen, wordt weergegeven in het linkerdeelvenster.
- Kies in de menubalk Venster > Scripts in het vervolgkeuzemenu om het venster Script weer te geven.
- Alle JavaScripts die momenteel in het document zijn opgenomen, worden in het linkerdeelvenster weergegeven. Documentscripts staan bovenaan. Paginascripts worden daaronder per pagina weergegeven.
- Klik op een item in het linkerdeelvenster om het JavaScript in het script-editorvenster aan de rechterkant weer te geven.
- Klik op het minteken - in de linkeronderhoek van het venster Script om een script te verwijderen.
- Wijzigingen in scripts worden automatisch opgeslagen.
JavaScript-scripts aan de PDF toevoegen: via het venster ‘Script’ kunt u nieuwe scripts aan de PDF toevoegen.
- Kies in de menubalk Venster > Scripts in het vervolgkeuzemenu om het venster Script weer te geven.
- JavaScript-acties die momenteel in het document zijn opgenomen, worden in het linkerdeelvenster weergegeven. Documentscripts staan bovenaan. Paginascripts worden daaronder per pagina weergegeven.
- Klik op het plusteken + in de linkerbenedenhoek van het venster Script om een nieuw script toe te voegen.
- Selecteer in het dialoogvenster Een script toevoegen een scripttype in het vervolgkeuzemenu Scripttype selecteren.
- Als u een annotatieactie aan een formulierveld toevoegt, selecteert u een actie in het vervolgkeuzemenu „Actie kiezen“. Zie Formulieren maken voor informatie over het toevoegen van berekeningen aan formuliervelden.
- Klik in het bewerkingsvenster en vervang de standaardtekst "// typ hier uw script" door een nieuw script.
- Wijzigingen in scripts worden automatisch opgeslagen.
JavaScripts uitvoeren Er zijn verschillende manieren om uw JavaScript te testen. Gebruik het JavaScript-venster om scripts regel voor regel uit te voeren.
- Houd de Option- (of Alt-)toets ingedrukt.
- Kies Venster > JavaScript-console.
- Typ of plak scripts in de console.
- Klik op ‘Uitvoeren’.
Om je formulier met berekeningen te testen, moet je overschakelen naar het tekstselectiegereedschap
(Command+1) om je formulier uit te proberen. Schakel terug naar het bewerkingsgereedschap
(Command+2) om het uiterlijk van de elementen die je in je formulier hebt geplaatst te bewerken.
(Command+1) om je formulier uit te proberen. Schakel terug naar het bewerkingsgereedschap
(Command+2) om het uiterlijk van de elementen die je in je formulier hebt geplaatst te bewerken.Opmerking: JavaScript-scripts worden alleen correct uitgevoerd als:
- Het script correct is.
- Het script wordt ondersteund door uw PDF-versie.
- Het script wordt ondersteund door Nitro PDF Pro.