Guide de l'utilisateur
Nitro PDF Mac

Modification et ajout de JavaScript

(Fonction avancée de Nitro PDF Pro)

JavaScript est utilisé dans Nitro PDF Pro pour créer des fonctions ou des actions personnalisées dans les formulaires PDF. Les commandes Javascript peuvent être appliquées aux champs de formulaire pour les calculs, le formatage, les validations et bien d’autres choses. Une connaissance avancée de la programmation JavaScript est requise pour éditer des scripts existants ou ajouter de nouveaux scripts. Les ressources qui peuvent aider à la programmation JavaScript générale ou spécifique à Adobe sont disponibles en ligne via w3schools.com, pdfscripting.com, Adobe et de nombreuses autres sources.

Remarque : Nitro PDF Pro ne prend en charge que les JavaScripts pour les formulaires PDF Acroform. Il ne prend pas en charge les JavaScripts pour les documents LiveCycle (XFA).

Qu’est-ce que JavaScript ?

JavaScript est un langage de programmation informatique orienté objet. Il est couramment utilisé pour créer des effets interactifs dans les navigateurs Web et fournit un moyen puissant de personnaliser les PDF.

Nitro PDF Pro vous permet d’afficher, d’ajouter, de supprimer ou de modifier des JavaScripts existants via une fenêtre de script. JavaScripts dans un document répertorie en tant que scripts de document ou scripts de page . Il existe généralement quatre types de JavaScript :

Scripts de document : les scripts au niveau du document sont des scripts situés en haut de la hiérarchie de script d’un document PDF. Ces scripts sont les premiers exécutés lors du chargement d’un document dans Nitro PDF Pro. Les scripts de document sont utilisés pour configurer des opérations, effectuer des tests d’environnement de niveau supérieur ou définir certaines fonctions et variables utilisées par d’autres scripts dans le document.

Actions de document : les actions de document sont des événements déclenchés par une activité telle que la fermeture, l’enregistrement ou l’impression d’un document. Les « actions » de document permettent aux concepteurs de formulaires de modifier le document avant ou après l’une de ces activités. Il y a généralement cinq actions de document :

  • Se fermera : invité avant de fermer un fichier PDF. Cette action est principalement utilisée pour nettoyer, par exemple en éteignant quelque chose, si un document inclut du multimédia interactif avancé comme des vidéos.
  • Enregistrera : invité avant d’enregistrer un PDF. Cette action permet principalement d’apporter des modifications automatiques pour distinguer la version enregistrée du document.
  • Enregistrement effectué : invité après l’enregistrement d’un fichier PDF. Cette action est principalement utilisée pour restaurer les modifications apportées dans l’action « Enregistrera ».
  • Imprimera : invité avant l’impression d’un fichier PDF. Cette action est principalement utilisée pour apporter des modifications visuelles à un document, telles que rendre visible un en-tête ou un tampon sur un PDF.
  • Impression effectuée : invité après l’ajout au fichier PDF de la file d’attente d’impression. Cette action est principalement utilisée pour restaurer les modifications apportées au document dans l’action « Imprimer ».

Actions de page : les actions au niveau de la page sont des événements déclenchés au niveau de la page, tels que l’ouverture et la fermeture. Par exemple, « ouvrir » une page fait référence au moment où la page spécifique du document est à la fois entièrement visible et que son numéro de page associé est reflété dans la barre d’outils. La « fermeture » d’une page fait référence au moment où la page spécifique du document n’est plus entièrement visible et que son numéro de page associé n’est plus reflété dans la barre d’outils. Ces actions sont généralement utiles pour gérer des pages contenant du contenu multimédia interactif tel que des minuteries, des vidéos ou des animations, que Nitro PDF Pro ne prend actuellement pas en charge.

Actions d’annotation : les actions d’annotation sont des événements au niveau de la page associés principalement aux éléments de formulaire pour les champs de formulaire. Ces actions activent des fonctions personnalisées ou la mise en forme pour des annotations spécifiques. Les utilisateurs pourront modifier ou ajouter une mise en forme, des calculs ou des validations spécifiques pour les champs de formulaire. Les scripts de champ de formulaire incluent deux principaux types de scripts : « Scripts de widget » et « Scripts de valeur de formulaire ». Les scripts de widget sont des actions effectuées sur un champ. Les scripts de valeur de formulaire sont des actions qui se produisent lorsque la valeur d’un champ de formulaire change.

  • Entrée : le script widget s’exécute lorsqu’un curseur entre dans le champ de formulaire.
  • Quitter : le script widget s’exécute lorsqu’un curseur quitte le champ de formulaire.
  • Focus : le script widget s’exécute lorsque le champ de formulaire atteint le focus clavier.
  • Flou : le script widget s’exécute lorsque le champ de formulaire perd le focus clavier.
  • Souris vers le haut : le script de widget s’exécute lorsqu’une souris/curseur survole le champ de formulaire et qu’un utilisateur clique sur le bouton.
  • Souris enfoncée : le script widget s’exécute lorsqu’une souris/curseur survole le champ de formulaire et que le bouton de la souris est relâché.
  • Page ouverte : voir Actions de la page.
  • Page fermée : voir Actions de page.
  • Format : le script form-value s’exécutera après le script Validate si le script Validate a la valeur true.
  • Valider : le script form-value s’exécute lorsque les valeurs de champ associées dans le document changent.
  • Calculer : le script form-value s’exécute lorsque les valeurs de champ du document changent.
  • Frappe : le script form-value s’exécute lorsque des frappes sont entrées dans un champ de texte.

Remarque : Les utilisateurs pourront afficher tous les scripts disponibles au niveau du document et de la page. Cependant, bien que tous les scripts soient techniquement modifiables, Nitro PDF Pro peut ne pas prendre en charge tous les JavaScripts. Par exemple, Nitro PDF Pro ne prend actuellement pas en charge certains multimédias tels que les vidéos interactives. Toutefois, l’application prend en charge les JavaScripts généraux tels que les alertes, les calculs, la mise en forme et la validation.

Préférences JavaScript

Pour que JavaScript puisse s’exécuter dans un document, il doit être activé dans les Préférences. (Préférences de l’utilisateur).

Activer JavaScript :

  1. Dans la barre de menus, choisissez Préférences Nitro PDF Pro > dans le menu déroulant.
  2. Sélectionnez l’onglet Général dans la boîte de dialogue Préférences.
  3. Cochez l’option « Activer JavaScript ».

Affichage et modification de JavaScripts PDF

La fenêtre Script de Nitro PDF Pro vous permet d’afficher et de modifier le code JavaScript d’un document. Si plusieurs documents sont ouverts simultanément dans Nitro PDF Pro, la fenêtre Script affiche les scripts du document que vous modifiez activement.

  1. Dans la barre de menus, choisissez Fenêtre > Scripts dans le menu déroulant pour afficher la fenêtre Script.
  2. Tous les JavaScripts actuellement inclus dans le document sont répertoriés dans le volet gauche. Les scripts de document sont répertoriés en haut. Les scripts de page trouvés sur chaque page sont répertoriés ci-dessous.
  3. Cliquez pour sélectionner un élément dans le volet gauche pour afficher le code JavaScript dans le volet de l’éditeur de script à droite.
  4. Cliquez dans le volet de l’éditeur de script pour commencer à modifier le script.
  5. Les modifications apportées aux scripts seront enregistrées automatiquement.

Remarque : les JavaScripts Adobe sont généralement caractérisés par le préfixe « AF ».

Suppression de JavaScripts PDF

La fenêtre Script vous permet de supprimer des JavaScripts dans un fichier PDF. Les JavaScripts actuellement inclus dans le document sont répertoriés dans le volet gauche.

  1. Dans la barre de menus, choisissez Fenêtre > Scripts dans le menu déroulant pour afficher la fenêtre Script.
  2. Tous les JavaScripts actuellement inclus dans le document sont répertoriés dans le volet gauche. Les scripts de document sont répertoriés en haut. Les scripts de page sont répertoriés ci-dessous pour chaque page.
  3. Cliquez pour sélectionner un élément dans le volet gauche pour afficher le code JavaScript dans le volet de l’éditeur de script à droite.
  4. Cliquez sur le signe moins - situé dans le coin inférieur gauche de la fenêtre Script pour supprimer un script.
  5. Les modifications apportées aux scripts seront enregistrées automatiquement.

Ajout de JavaScripts PDF

La fenêtre Script vous permet d’ajouter de nouveaux scripts au fichier PDF.

  1. Dans la barre de menus, choisissez Fenêtre > Scripts dans le menu déroulant pour afficher la fenêtre Script.
  2. Les actions JavaScript actuellement incluses dans le document sont répertoriées dans le volet gauche. Les scripts de document sont répertoriés en haut. Les scripts de page sont répertoriés ci-dessous pour chaque page.
  3. Cliquez sur le signe plus + situé dans le coin inférieur gauche de la fenêtre Script pour ajouter un nouveau script.
  4. Dans la boîte de dialogue Ajouter un script, sélectionnez un type de script dans le menu déroulant Sélectionner un type de script.
  5. Si vous ajoutez une action d’annotation à un champ de formulaire, sélectionnez une action dans le menu déroulant " Choisir une action « . Pour plus d’informations sur l’ajout de calculs de champs de formulaire, consultez Création de formulaires.
  6. Cliquez à l’intérieur du volet d’édition et remplacez le texte par défaut « // tapez votre script ici » par un nouveau script.
  7. Les modifications apportées aux scripts seront enregistrées automatiquement.

Remarque : Pour ajouter une action d’annotation à un champ de formulaire spécifique, vous devez sélectionner le champ de formulaire avant de cliquer sur le signe + plus pour ajouter un script. Si aucune annotation spécifique n’est sélectionnée, vous pouvez uniquement ajouter des scripts de document ou de page .

Exécution de JavaScripts

Il existe plusieurs façons de tester votre JavaScript. Pour exécuter des scripts ligne par ligne, utilisez la fenêtre JavaScript.

  1. Maintenez la touche Option (ou Alt) enfoncée.
  2. Choisissez Fenêtre > Console JavaScript.
  3. Tapez ou collez des scripts dans la console.
  4. Cliquez sur Exécuter.
Pour tester votre formulaire avec des calculs, vous devrez passer à l’outil Sélectionner du texte
Sélectionner l’outil
(Commande +1) afin d’essayer votre formulaire. Revenez à l’outil d’édition
outil d’édition
(Commande+2) afin de modifier l’apparence des éléments que vous avez placés dans votre formulaire.

Remarque : Les JavaScripts ne s’exécuteront correctement que si :

  • Le script est correct.
  • Le script est pris en charge par votre version PDF.
  • Le script est pris en charge par Nitro PDF Pro.
Tags