Guida per l'utente
Nitro PDF Mac

Modifica e aggiunta di 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 i calcoli, la formattazione, le convalide e molte altre cose. È richiesta una conoscenza avanzata della programmazione JavaScript per modificare gli script esistenti o aggiungere nuovi script. Le risorse che possono aiutare con la programmazione JavaScript generale o specifica per Adobe sono disponibili online tramite w 3 schools.com, pdfscripting.com , Adobe e molte altre fonti.

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

Cos'è JavaScript?

JavaScript è un linguaggio di programmazione per computer orientato agli oggetti. Viene comunemente utilizzato per creare effetti interattivi all'interno dei browser Web e fornisce un modo efficace per personalizzare i PDF.

Nitro PDF Pro consente di visualizzare, aggiungere, eliminare o modificare JavaScript esistenti tramite una finestra di scripting. I JavaScript in un documento vengono elencati come Script del documento o Script della pagina . Esistono generalmente quattro tipi di JavaScript:

Script di documenti: gli script a livello di documento sono script in cima alla gerarchia di script di un documento PDF. Questi script sono i primi eseguiti quando un documento viene caricato in Nitro PDF Pro. Gli script del documento vengono utilizzati per impostare operazioni, eseguire test ambientali di primo livello o definire determinate funzioni e variabili utilizzate da altri script nel documento.

Azioni sui documenti: le azioni sui documenti sono eventi richiesti 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 tali attività. Di solito ci sono cinque azioni del documento:

  • Si chiuderà: richiesto prima di chiudere un PDF. Questa azione viene utilizzata principalmente per ripulire, ad esempio spegnere qualcosa, se un documento include 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.
  • Did Save : richiesto dopo aver salvato un PDF. Questa azione viene utilizzata principalmente per ripristinare le modifiche apportate nell'azione "Sarà salvato".
  • Verrà stampato: richiesto prima di stampare 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.
  • Did Print : richiesto dopo l'aggiunta al PDF nella coda di stampa. Questa azione viene utilizzata principalmente per ripristinare le modifiche apportate al documento nell'azione "Stampa".

Azioni di pagina: le azioni a livello di pagina sono eventi attivati a livello di pagina, come l'apertura e la chiusura. Ad esempio, per "apertura" di una pagina si intende quando la pagina specifica del documento è completamente visibile e il numero di pagina associato si riflette nella barra degli strumenti . "Chiusura" di una pagina si riferisce a quando la pagina specifica del documento non è più completamente visibile e il numero di pagina associato non è più riflesso 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 al momento potrebbe non supportare.

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 abilitano funzioni personalizzate o formattazione per annotazioni specifiche. Gli utenti potranno modificare o aggiungere formattazioni, calcoli o convalide specifici per i campi del modulo. Gli script dei campi modulo includono due tipi principali di script: "Script widget" e "Script valore modulo". Gli script widget sono azioni eseguite su un campo. Gli script valore-modulo sono azioni che si verificano quando il valore di un campo modulo cambia.

  • Invio : lo script del widget viene eseguito quando un cursore entra nel campo del modulo.
  • Esci : lo script del widget viene eseguito quando un cursore lascia il campo del modulo.
  • Focus : lo script del widget viene eseguito quando il campo del modulo raggiunge lo stato attivo della tastiera.
  • Sfocatura : lo script del widget viene eseguito quando il campo del modulo perde lo stato attivo della tastiera.
  • Mouse in alto : lo script del widget viene eseguito quando un mouse/cursore passa sopra il campo del modulo e un utente fa clic sul pulsante.
  • Mouse giù : lo script del widget viene eseguito quando un 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 Convalida se lo script Convalida è true.
  • Convalida : lo script del valore del modulo verrà eseguito quando i valori dei campi associati nel documento vengono modificati.
  • Calcola : lo script del valore del modulo verrà eseguito quando i valori dei campi del documento cambiano.
  • Sequenza di tasti : lo script del valore del modulo verrà eseguito quando le sequenze di tasti vengono immesse 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 in Preferenze. ( Preferenze utente ).

Abilita JavaScript :

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

Visualizzazione e modifica di JavaScript PDF

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

  1. Dalla barra dei menu, scegli Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Tutti i JavaScript attualmente inclusi nel documento sono elencati nel riquadro di sinistra. Gli script dei documenti sono elencati in alto. Gli script di pagina trovati in ciascuna pagina sono elencati di seguito.
  3. Fare clic per selezionare un elemento nel riquadro a sinistra per visualizzare 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 Adobe JavaScript sono generalmente caratterizzati dal prefisso "AF".

Eliminazione di JavaScript PDF

La finestra Script consente di eliminare JavaScript in un PDF. I JavaScript attualmente inclusi nel documento sono elencati nel riquadro di sinistra.

  1. Dalla barra dei menu, scegli Finestra > Script dal menu a discesa per visualizzare la finestra Script.
  2. Tutti i JavaScript attualmente inclusi nel documento sono elencati nel riquadro di sinistra. Gli script dei documenti sono elencati in alto. Gli script di pagina sono elencati di seguito per ciascuna pagina.
  3. Fare clic per selezionare un elemento nel riquadro a sinistra per visualizzare JavaScript nel riquadro dell'editor di script a destra.
  4. Fare clic 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 JavaScript PDF

La finestra Script consente di aggiungere nuovi script al PDF.

  1. Dalla barra dei menu, scegli 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 dei documenti sono elencati in alto. Gli script di pagina sono elencati di seguito per ciascuna pagina.
  3. Fare clic sul segno più + situato nell'angolo inferiore sinistro della finestra Script per aggiungere un nuovo script.
  4. Nella finestra di dialogo Aggiungi uno script , seleziona un tipo di script dal menu a discesa Seleziona tipo di script .
  5. Se aggiungi un'azione di annotazione a un campo del modulo, seleziona un'azione dal menu a discesa "Scegli azione". Per informazioni sull'aggiunta di calcoli dei campi modulo, vedere Creazione di moduli .
  6. Fai clic all'interno del riquadro di modifica e sostituisci il testo predefinito "// digita qui il tuo 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, è necessario che il campo modulo sia selezionato prima di fare clic sul segno più + per aggiungere uno script. Se non hai selezionato un'annotazione specifica, puoi solo aggiungere script Documento o Pagina .

Esecuzione di JavaScript

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

  1. Tieni premuto il tasto Opzione (o Alt).
  2. Scegli Finestra > Console JavaScript.
  3. Digita o incolla gli script nella Console.
  4. Fare clic su Esegui .
Per testare il tuo modulo con i calcoli, dovrai passare allo strumento Seleziona testo
seleziona strumento
(Comando+ 1 ) per provare il tuo modulo. Torna allo strumento Modifica
strumento di modifica
(Comando+ 2 ) per modificare l'aspetto degli elementi che hai inserito nel modulo.

Nota : i JavaScript verranno eseguiti correttamente solo se:

  • Lo script è corretto.
  • Lo script è supportato dalla tua versione PDF.
  • Lo script è supportato da Nitro PDF Pro.
Tag
Nitro PDF Mac Funzioni avanzate