Guida per l'utente
Nitro PDF Pro MacOS

Modifica e aggiunta di JavaScript

(Funzione avanzata di Nitro PDF Pro)

JavaScript viene utilizzato in Nitro PDF Pro per creare funzioni o azioni personalizzate nei moduli PDF. I comandi Javascript possono essere applicati ai campi del modulo per calcoli, formattazione, convalide e molte altre cose. È richiesta una conoscenza avanzata della programmazione JavaScript per modificare gli script esistenti o aggiungerne di nuovi. Le risorse che possono aiutare nella programmazione JavaScript generale o specifica di Adobe sono disponibili online attraverso w3schools.com, pdfscripting.com, Adobe e molte altre fonti.

Nota: Nitro PDF Pro supporta solo JavaScript per i moduli Acroform PDF. Non supporta JavaScript per i documenti LiveCycle (XFA).

Che cos'è JavaScript?

JavaScript è un linguaggio di programmazione informatica orientato agli oggetti. È comunemente utilizzato per creare effetti interattivi all'interno dei browser web e offre un modo potente per personalizzare i PDF.

Nitro PDF Pro le permette di visualizzare, aggiungere, eliminare o modificare i JavaScript esistenti attraverso una finestra di scripting. I JavaScript in un documento sono elencati come script Documento o script Pagina . In genere ci sono quattro tipi di JavaScript:

Script a livello di documento: gli script a livello di documento sono script in cima alla gerarchia di scripting di un documento PDF. Questi script sono i primi ad essere eseguiti quando un documento viene caricato in Nitro PDF Pro. Gli script del documento vengono utilizzati per impostare le operazioni, eseguire test di primo livello dell'ambiente o definire alcune funzioni e variabili utilizzate da altri script del documento.

Azioni del documento: le azioni del documento sono eventi sollecitati da un'attività come la chiusura, il salvataggio o la stampa di un documento. Le "azioni" del documento consentono ai progettisti di moduli di modificare il documento prima o dopo una qualsiasi di queste attività. Di solito ci sono cinque azioni del documento:

  • Chiuderà: richiesto prima di chiudere un PDF. Questa azione viene utilizzata principalmente per pulire, ad esempio per spegnere qualcosa, se un documento contiene contenuti multimediali interattivi avanzati come i video.
  • Salverà: richiesto prima di salvare un PDF. Questa azione viene utilizzata principalmente per apportare modifiche automatiche per distinguere la versione salvata del documento.
  • Ha salvato: richiesto dopo aver salvato un PDF. Questa azione è utilizzata principalmente per ripristinare le modifiche apportate nell'azione "Salverà".
  • Stampa: richiesto prima di stampare un PDF. Questa azione viene utilizzata principalmente per apportare modifiche visive a un documento, come ad esempio rendere visibile un'intestazione o un timbro su un PDF.
  • Ha stampato: richiesto dopo aver aggiunto il PDF alla coda di stampa. Questa azione viene utilizzata principalmente per ripristinare le modifiche apportate al documento nell'azione "Stampa".

Azioni a livello di pagina: Le azioni a livello di pagina sono eventi attivati a livello di pagina, come l'apertura e la chiusura. Per esempio, "aprire" una pagina si riferisce a quando la pagina specifica del documento è completamente visibile e il numero di pagina associato si riflette nella barra degli strumenti . La "chiusura" di una pagina si riferisce al momento in cui la pagina specifica del documento non è più completamente visibile e il numero di pagina associato non si riflette più nella Barra degli strumenti. Queste azioni sono generalmente utili per la gestione di pagine contenenti contenuti multimediali interattivi come timer, video o animazioni, che Nitro PDF Pro attualmente non supporta.

Azioni di annotazione: Le azioni di annotazione sono eventi a livello di pagina associati principalmente agli elementi del modulo per i campi del modulo. Queste azioni consentono funzioni o formattazioni personalizzate per annotazioni specifiche. Gli utenti potranno modificare o aggiungere formattazioni, calcoli o convalide specifiche per i campi del modulo. Gli script dei campi modulo comprendono due tipi principali di script: "Widget scripts" e "Form-value scripts". Gli script del widget sono azioni eseguite su un campo. Gli script di valore del modulo sono azioni che si verificano quando il valore di un campo del modulo cambia.

  • Inserisci: lo script del widget viene eseguito quando il cursore entra nel campo del modulo.
  • Exit: lo script del widget viene eseguito quando il cursore lascia il campo del modulo.
  • Focus: lo script del widget viene eseguito quando il campo del modulo ottiene il focus della tastiera.
  • Blur: lo script del widget viene eseguito quando il campo del modulo perde il focus della tastiera.
  • Mouse up: lo script del widget viene eseguito quando il mouse/cursore passa sopra il campo del modulo e l'utente clicca sul pulsante.
  • Mouse down: lo script del widget viene eseguito quando il mouse/cursore passa sopra il campo del modulo e il pulsante del mouse viene rilasciato.
  • Pagina aperta: vedere Azioni della pagina.
  • Pagina chiusa: vedere Azioni della pagina.
  • Formato: lo script Form-value verrà eseguito dopo lo script Validate, se lo script Validate è vero.
  • Validate: lo script del valore del modulo verrà eseguito quando i valori dei campi associati nel documento cambiano.
  • Calcola: lo script del valore del modulo verrà eseguito quando i valori dei campi del documento cambiano.
  • Keystroke: lo script modulo-valore viene eseguito quando viene digitato un tasto in un campo di testo.

Nota: gli utenti potranno visualizzare tutti gli script disponibili sia a livello di Documento che di Pagina. Tuttavia, sebbene tutti gli script siano tecnicamente modificabili, Nitro PDF Pro potrebbe non supportare tutti i JavaScript. Ad esempio, Nitro PDF Pro attualmente non supporta alcuni contenuti multimediali come i video interattivi. Tuttavia, l'applicazione supporta JavaScript generali come avvisi, calcoli, formattazione e convalida.

Preferenze JavaScript

Prima che JavaScript possa essere eseguito in un documento, deve essere abilitato nelle Preferenze. (Preferenze utente).

Abilita JavaScript:

  1. Dalla barra dei menu, scelga Nitro PDF Pro> Preferenze dal menu a discesa.
  2. Selezioni la scheda Generale nella finestra di dialogo Preferenze.
  3. Selezioni l'opzione "Abilita JavaScript".

Visualizzazione e modifica di PDF JavaScript

La finestra Script di Nitro PDF Pro le consente di visualizzare e modificare il codice JavaScript di un documento. Se sono aperti contemporaneamente più documenti in Nitro PDF Pro, la finestra Script visualizzerà gli script del documento che sta modificando attivamente.

  1. Dalla barra dei menu, scelga Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Tutti i JavaScript attualmente inclusi nel documento sono elencati nel riquadro sinistro. Gli script dei documenti sono elencati in alto. Gli script di pagina presenti in ogni pagina sono elencati di seguito.
  3. Clicchi per selezionare un elemento nel riquadro sinistro per visualizzare il JavaScript nel riquadro dell'editor di script a destra.
  4. Clicchi all'interno del riquadro dell'editor di script per iniziare a modificare lo script.
  5. Le modifiche apportate agli script verranno salvate automaticamente.

Nota: i JavaScript Adobe sono solitamente caratterizzati dal prefisso "AF".

Eliminazione di PDF JavaScript

La finestra Script le permette di eliminare i JavaScript in un PDF. I JavaScript attualmente inclusi nel documento sono elencati nel riquadro sinistro.

  1. Dalla barra dei menu, scelga Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Tutti i JavaScript attualmente inclusi nel documento sono elencati nel riquadro sinistro. Gli script dei documenti sono elencati in alto. Gli script di pagina sono elencati di seguito per ogni pagina.
  3. Clicchi per selezionare un elemento nel riquadro sinistro per visualizzare il JavaScript nel riquadro dell'editor di script a destra.
  4. Clicchi sul segno meno - situato nell'angolo inferiore sinistro della finestra Script per eliminare uno script.
  5. Le modifiche apportate agli script verranno salvate automaticamente.

Aggiunta di PDF JavaScript

La finestra Script le consente di aggiungere nuovi script al PDF.

  1. Dalla barra dei menu, scelga Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Le azioni JavaScript attualmente incluse nel documento sono elencate nel riquadro sinistro. Gli script dei documenti sono elencati in alto. Gli script di pagina sono elencati di seguito per ogni pagina.
  3. Clicchi sul pulsante più + situato nell'angolo inferiore sinistro della finestra Script per aggiungere un nuovo script.
  4. Nella finestra di dialogo Aggiungere uno script , selezioni un tipo di script dal menu a discesa Selezionare il tipo di script .
  5. Se aggiunge un'azione di annotazione a un campo modulo, selezioni un'azione dal menu a discesa "Scegli l'azione". Per informazioni sull'aggiunta dei calcoli dei campi dei moduli, consulti Creazione di moduli.
  6. Clicchi all'interno del riquadro di modifica e sostituisca il testo predefinito "// digiti qui il suo script" con un nuovo script.
  7. Le modifiche apportate agli script verranno salvate automaticamente.

Nota: per aggiungere un'azione di annotazione a un campo modulo specifico, deve aver selezionato il campo modulo prima di cliccare sui pulsanti più + per aggiungere uno script. Se non ha selezionato un'annotazione specifica, può aggiungere solo gli script Documento o Pagina .

Esecuzione di JavaScript

Ci sono un paio di modi per testare il suo JavaScript. Per eseguire gli script riga per riga, utilizzi la finestra JavaScript.

  1. Tenga premuto il tasto Opzione (o Alt).
  2. Scelga Finestra > Console JavaScript.
  3. Digiti o incolli gli script nella Console.
  4. Clicchi su Esegui.
Per testare il suo modulo con i calcoli, dovrà passare allo Strumento Seleziona testo
selezionare lo strumento
(Comando+1) per provare il suo modulo. Torna allo Strumento Modifica
strumento di modifica
(Comando+2) per modificare l'aspetto degli elementi che ha inserito nel suo modulo.

Nota: i JavaScript verranno eseguiti con successo solo se:

  • Lo script è corretto.
  • Lo script è supportato dalla versione PDF in uso.
  • Lo script è supportato da Nitro PDF Pro.
Tag
Nitro PDF Pro per MacOS Caratteristiche avanzate