Skip to content
Altri articoli in questa categoria

Aggiungi o modifica JavaScript

(Funzionalità 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 dei moduli per eseguire calcoli, formattazioni, convalide e molte altre operazioni. Per modificare gli script esistenti o aggiungerne di nuovi è necessaria una conoscenza avanzata della programmazione JavaScript. Online sono disponibili risorse utili per la programmazione JavaScript in generale o specifica per Adobe su  w3schools.com ,  pdfscripting.com , Adobe e molte altre fonti.

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

Che cos’è JavaScript?

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

Nitro PDF Pro consente di visualizzare, aggiungere, eliminare o modificare gli script JavaScript esistenti tramite una finestra dedicata. Gli script JavaScript presenti in un documento sono elencati come "Script del documento " o "Script della pagina ". Esistono generalmente quattro tipi di script JavaScript:

Script del documento: gli script a livello di documento sono quelli situati al vertice della gerarchia degli script 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 operazioni, eseguire test dell’ambiente di primo livello o definire determinate funzioni e variabili utilizzate da altri script presenti nel documento.

Azioni del documento: le azioni del documento sono eventi innescati 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:

  • Will Close: attivata prima della chiusura di un PDF. Questa azione viene utilizzata principalmente per ripulire il documento — ad esempio disattivando alcuni elementi — qualora il documento includa contenuti multimediali interattivi avanzati come i video.
  • "Salverà": attivata prima del salvataggio di un PDF. Questa azione viene utilizzata principalmente per apportare modifiche automatiche volte a distinguere la versione salvata del documento.
  • Salvataggio effettuato: viene visualizzata dopo il salvataggio di un PDF. Questa azione viene utilizzata principalmente per ripristinare le modifiche apportate nell’azione “Salvataggio imminente”.
  • Stampa imminente: richiesta prima della stampa di un PDF. Questa azione viene utilizzata principalmente per apportare modifiche visive a un documento, come rendere visibile un'intestazione o un timbro su un PDF.
  • Stampa effettuata: richiesta dopo l’aggiunta del PDF alla coda di stampa. Questa azione viene utilizzata principalmente per ripristinare le modifiche apportate al documento nell’azione “Stampa imminente”.
Azioni a livello di pagina: le azioni a livello di pagina sono eventi attivati a livello di pagina, come l’apertura e la chiusura. Ad esempio, “aprire” una pagina si riferisce al momento in cui la pagina specifica del documento è completamente visibile e il numero di pagina associato è visualizzato nella  barra degli strumenti . “Chiudere” una pagina si riferisce al momento in cui la pagina specifica del documento non è più completamente visibile e il numero di pagina associato non è più visualizzato nella barra degli strumenti. Queste azioni sono generalmente utili per gestire pagine contenenti contenuti multimediali interattivi come timer, video o animazioni, che Nitro PDF Pro al momento potrebbe non supportare.

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

  • Enter: lo script del widget viene eseguito quando il cursore entra nel campo del modulo.
  • Script di uscita: lo script del widget viene eseguito quando il cursore esce dal 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 da tastiera.
  • Rilascio del mouse: lo script del widget viene eseguito quando il mouse o il cursore si posiziona sul campo del modulo e l'utente fa clic sul pulsante.
  • Rilascio del mouse: lo script del widget viene eseguito quando il mouse o il cursore passa sopra il campo del modulo e il pulsante del mouse viene rilasciato.
  • Pagina aperta: vedi Azioni della pagina.
  • Pagina chiusa: vedi Azioni della pagina.
  • Formato: lo script form-value verrà eseguito dopo lo script Validate se quest'ultimo restituisce il valore true.
  • Convalida: lo script del valore del modulo verrà eseguito quando cambiano i valori dei campi associati nel documento.
  • Calcola: lo script del valore del modulo verrà eseguito quando i valori dei campi del documento cambiano.
  • Pressione tasto: lo script form-value verrà eseguito quando vengono immessi caratteri 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 determinati contenuti multimediali come i video interattivi. Tuttavia, l’applicazione supporta JavaScript generici quali avvisi, calcoli, formattazione e convalida.

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

Abilita JavaScript:

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

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

  1. Dalla barra dei menu, selezionare Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Tutti gli script JavaScript attualmente inclusi nel documento sono elencati nel riquadro di sinistra. Gli script del documento sono elencati in alto. Gli script di pagina presenti in ciascuna pagina sono elencati sotto.
  3. Fare clic per selezionare una voce nel riquadro di sinistra per visualizzare il codice JavaScript nel riquadro dell’editor di script a destra.
  4. Fare clic all’interno del riquadro dell’editor di script per iniziare a modificare lo script.
  5. Le modifiche apportate agli script verranno salvate automaticamente.
Nota: gli script JavaScript di Adobe sono solitamente contrassegnati dal prefisso “AF”.

Eliminazione dei JavaScript da un PDF La finestra Script consente di eliminare i JavaScript da un PDF. I JavaScript attualmente inclusi nel documento sono elencati nel riquadro di sinistra.

  1. Dalla barra dei menu, seleziona Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Tutti gli script JavaScript attualmente inclusi nel documento sono elencati nel riquadro di sinistra. Gli script del documento sono elencati in alto. Gli script di pagina sono elencati sotto per ciascuna pagina.
  3. Fare clic per selezionare una voce nel riquadro di sinistra per visualizzare lo script JavaScript nel riquadro dell’editor di script a destra.
  4. Fare clic sul segno meno - situato nell’angolo in basso a sinistra della finestra Script per eliminare uno script.
  5. Le modifiche apportate agli script verranno salvate automaticamente.

Aggiunta di script JavaScript al PDF La finestra "Script" consente di aggiungere nuovi script al PDF.

  1. Dalla barra dei menu, seleziona Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Le azioni JavaScript attualmente incluse nel documento sono elencate nel riquadro di sinistra. Gli script del documento sono elencati in alto. Gli script di pagina sono elencati sotto per ciascuna pagina.
  3. Fare clic sul segno più + situato nell’angolo in basso a sinistra della finestra Script per aggiungere un nuovo script.
  4. Nella finestra di dialogo Aggiungi uno script, selezionare un tipo di script dal menu a discesa Seleziona tipo di script.
  5. Se si aggiunge un'azione di annotazione a un campo del modulo, selezionare un'azione dal menu a discesa "Scegli azione". Per informazioni sull'aggiunta di calcoli ai campi del modulo, consultare la sezione  Creazione di moduli .
  6. Fare clic all’interno del riquadro di modifica e sostituire il testo predefinito “// digitare qui lo script” con un nuovo script.
  7. Le modifiche apportate agli script verranno salvate automaticamente.
Nota: per aggiungere un'azione di annotazione a un campo specifico del modulo, è necessario aver selezionato il campo del modulo prima di fare clic sul segno più (+) per aggiungere uno script. Se non è stata selezionata un'annotazione specifica, è possibile aggiungere solo script di documento o di pagina.

Esecuzione di script JavaScript Esistono diversi modi per testare il proprio script JavaScript. Per eseguire gli script riga per riga, utilizzare la finestra JavaScript.

  1. Tenere premuto il tasto Opzione (o Alt).
  2. Selezionare Finestra > Console JavaScript.
  3. Digitare o incollare gli script nella Console.
  4. Fare clic su Esegui.
Per testare il modulo con i calcoli, dovrai passare allo strumento Seleziona testo select tool
(Comando+1) per provare il modulo. Torna allo strumento Modificaedit tool(Comando+2) per modificare l'aspetto degli elementi che hai inserito nel modulo.


Nota: gli script JavaScript verranno eseguiti correttamente solo se:

  • Lo script è corretto.
  • Lo script è supportato dalla versione del PDF in uso.
  • Lo script è supportato da Nitro PDF Pro.

Ultimo aggiornamento: luglio 29, 2025