User Guide    Caratteristiche avanzate    Modifica e aggiunta di JavaScript

Modifica e aggiunta di JavaScript

(Caratteristica avanzata di PDFpenPro)

JavaScript è usato in PDFpenPro per creare funzioni o azioni personalizzate nei moduli PDF. I comandi Javascript possono essere applicati ai campi del modulo per i calcoli, la formattazione, le validazioni 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 attraverso w3schools.com, pdfscripting.com, Adobe, e molte altre fonti.

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

Cos'è JavaScript?

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

PDFpenPro permette di visualizzare, aggiungere, cancellare o modificare i JavaScript esistenti attraverso una finestra di scripting. Gli script in un documento sono elencati come script di documento o come script di pagina. Ci sono generalmente quattro tipi di JavaScript:

Script del documento: gli script a livello di documento sono script in cima alla gerarchia di scripting di un documento PDF. Questi script sono i primi eseguiti quando un documento viene caricato in PDFpenPro. Gli script del documento sono usati per impostare operazioni, eseguire test di ambiente di alto livello, o definire certe funzioni e variabili usate da altri script nel documento.

Azioni del documento: le azioni del documento sono eventi richiesti da un'attività come chiudere, salvare o stampare un documento. Le "azioni" del documento permettono ai progettisti di moduli di cambiare il documento prima o dopo qualsiasi di queste attività. Di solito ci sono cinque azioni del documento:

  • Will Close: richiesto prima di chiudere un PDF. Questa azione è usata principalmente per ripulire, come spegnere qualcosa, se un documento include multimedia interattivi avanzati come i video.
  • Will Save: richiesto prima di salvare un PDF. Questa azione è usata principalmente per fare delle modifiche automatiche per distinguere la versione salvata del documento.
  • Ha fatto Salva: richiesto dopo aver salvato un PDF. Questa azione è usata principalmente per ripristinare le modifiche fatte nell'azione "Will Save".
  • Will Print: richiesto prima di stampare un PDF. Questa azione è utilizzata principalmente per apportare modifiche visive a un documento, come rendere visibile un'intestazione o un timbro su un PDF.
  • Did Print: richiesto dopo aver aggiunto il PDF alla coda di stampa. Questa azione è usata principalmente per ripristinare le modifiche fatte al documento nell'azione "Will Print".

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 suo numero di pagina associato si riflette nella barra degli strumenti. La "chiusura" di una pagina si riferisce a quando la pagina specifica del documento non è più completamente visibile e il suo numero di pagina associato non si riflette più nella barra degli strumenti. Queste azioni sono generalmente utili per gestire le pagine che contengono multimedia interattivi come timer, video o animazioni, che PDFpenPro attualmente potrebbe non supportare.

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

  • Enter: lo script del widget viene eseguito quando un cursore entra nel campo del modulo.
  • Exit: lo script del widget viene eseguito quando un cursore esce dal campo del modulo.
  • Focus: lo script del widget viene eseguito quando il campo del modulo raggiunge 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: vedi Azioni di pagina.
  • Pagina chiusa: vedi Azioni di pagina.
  • Formato: lo script form-value verrà eseguito dopo lo script Validate se lo script Validate è vero.
  • Validate: lo script form-value verrà eseguito quando i valori dei campi associati nel documento cambiano.
  • Calculate: lo script form-value verrà eseguito quando i valori dei campi del documento cambiano.
  • Keystroke: lo script form-value verrà eseguito quando vengono inseriti dei tasti in un campo di testo.

Nota: gli utenti saranno in grado di visualizzare tutti gli script disponibili sia a livello di documento che di pagina. Tuttavia, mentre tutti gli script sono tecnicamente modificabili, PDFpenPro potrebbe non supportare tutti i JavaScript. Per esempio, PDFpenPro attualmente non supporta certi multimedia come i video interattivi. Tuttavia, l ' applicazione supporta JavaScript generali come avvisi, calcoli, formattazione e validazione.

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 PDFpenPro > Preferenze dal menu a discesa.
  2. Seleziona la scheda Generale nella finestra di dialogo delle Preferenze.
  3. Seleziona l'opzione "Abilita JavaScript".

Visualizzazione e modifica di PDF JavaScript

La finestra Script di PDFpenPro permette di visualizzare e modificare il JavaScript di un documento. Se più documenti sono aperti simultaneamente in PDFpenPro, la finestra Script visualizzerà gli script del documento che state attivamente modificando.

  1. Dalla barra dei menu, scegliete Window > Scripts dal menu a discesa per visualizzare la finestra Script.
  2. Tutti i JavaScript attualmente inclusi nel documento sono elencati nel pannello di sinistra. Gli script dei documenti sono elencati in alto. Gli script di pagina che si trovano in ogni pagina sono elencati qui sotto.
  3. Clicca per selezionare un elemento nel pannello di sinistra per visualizzare il JavaScript nel pannello dell'editor di script sulla destra.
  4. Clicca 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 solitamente caratterizzati dal prefisso "AF."

Eliminazione di PDF JavaScript

La finestra Script permette di eliminare i JavaScript in un PDF. I JavaScript attualmente inclusi nel documento sono elencati nel pannello di sinistra.

  1. Dalla barra dei menu, scegliete Window > Scripts dal menu a discesa per visualizzare la finestra Script.
  2. Tutti i JavaScript attualmente inclusi nel documento sono elencati nel pannello di sinistra. Gli script dei documenti sono elencati in alto. Gli script di pagina sono elencati di seguito per ogni pagina.
  3. Clicca per selezionare un elemento nel pannello di sinistra per visualizzare il JavaScript nel pannello dell'editor di script sulla destra.
  4. Clicca sul meno - situato nell'angolo in basso a sinistra della finestra Script per cancellare uno script.
  5. Le modifiche apportate agli script verranno salvate automaticamente.

Aggiungere PDF JavaScripts

La finestra Script permette di aggiungere nuovi script al PDF.

  1. Dalla barra dei menu, scegliete Window > Scripts dal menu a discesa per visualizzare la finestra Script.
  2. Le azioni JavaScript attualmente incluse nel documento sono elencate nel pannello di sinistra. Gli script dei documenti sono elencati in alto. Gli script di pagina sono elencati di seguito per ogni pagina.
  3. Fai clic sul più + situato nell'angolo in basso a sinistra della finestra Script per aggiungere un nuovo script.
  4. Nella finestra di dialogo Add a script, seleziona un tipo di script dal menu a discesa Select script type.
  5. Se aggiungi un'azione di annotazione a un campo del modulo, seleziona un'azione dal menu a discesa "Choose action". Per informazioni sull'aggiunta di calcoli ai campi dei moduli, vedere Creazione di moduli.
  6. Cliccate all'interno del pannello di editing e sostituite il testo predefinito "// type your script here" 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, devi avere il campo del modulo selezionato prima di cliccare il più + per aggiungere uno script. Se non hai selezionato un'annotazione specifica, puoi aggiungere solo script di documento o di pagina.

Esecuzione di JavaScript

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

  1. Tenere premuto il tasto Opzione (o Alt).
  2. Scegliere Finestra > Console JavaScript.
  3. Digitare o incollare gli script nella console.
  4. Fare clic su Esegui.

Per testare il tuo modulo con i calcoli, dovrai passare allo strumento Seleziona testoselect tool (Comando+1) per provare il tuo modulo. Torna allo strumento di modifica strumento modifica (Command+2) per modificare l'aspetto degli elementi che hai inserito nel tuo modulo.

Nota: i JavaScript saranno eseguiti con successo solo se:

  • Lo script è corretto.
  • Lo script è supportato dalla tua versione del PDF.
  • Lo script è supportato da PDFpenPro.