Guide de l'utilisateur
Nitro PDF Mac

Modification et ajout de JavaScript

(Fonctionnalité 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 modifier des scripts existants ou ajouter de nouveaux scripts. Des ressources qui peuvent aider à la programmation JavaScript générale ou spécifique à Adobe sont disponibles en ligne via w 3 schools.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 JavaScripts pour les documents LiveCycle (XFA).

Qu'est-ce que JavaScript ?

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

Nitro PDF Pro vous permet d'afficher, d'ajouter, de supprimer ou de modifier des JavaScripts existants via une fenêtre de script. Les JavaScripts d'un document sont répertoriés comme des scripts de document ou des 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 au sommet 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 existe généralement cinq actions de document :

  • Will Close : demandé avant de fermer un PDFs. Cette action est principalement utilisée pour nettoyer, par exemple en éteignant quelque chose, si un document comprend du multimédia interactif avancé comme des vidéos.
  • Enregistrera : invité avant d'enregistrer un PDF. Cette action est principalement utilisée pour apporter des modifications automatiques afin de distinguer la version enregistrée du document.
  • Did Save : invité après l'enregistrement d'un PDF. Cette action est principalement utilisée pour restaurer les modifications apportées dans l'action "Va enregistrer".
  • Imprimera : invité avant d'imprimer un 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.
  • Did Print : demandé après avoir ajouté le PDFs à la file d'attente d'impression. Cette action est principalement utilisée pour restaurer les modifications apportées au document dans l'action "Imprimera".

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, "l'ouverture" d'une page fait référence au moment où la page spécifique du document est entièrement visible et où 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 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 multimédia interactif, comme des minuteurs, 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 d'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 : les "scripts de widget" et les "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 du widget s'exécute lorsqu'un curseur entre dans le champ du formulaire.
  • Quitter : le script du widget s'exécute lorsqu'un curseur quitte le champ du formulaire.
  • Focus : le script du widget s'exécute lorsque le champ du formulaire atteint le focus clavier.
  • Flou : le script du widget s'exécute lorsque le champ du formulaire perd le focus clavier.
  • Souris vers le haut : le script du widget s'exécute lorsqu'une souris/curseur survole le champ du formulaire et qu'un utilisateur clique sur le bouton.
  • Souris enfoncée : le script du widget s'exécute lorsqu'une souris/curseur survole le champ du formulaire et que le bouton de la souris est relâché.
  • Page ouverte : voir Actions de la page.
  • Page fermée : voir Actions de la page.
  • Format : le script form-value s'exécutera après le script Validate si le script Validate est vrai.
  • Valider : le script de valeur de formulaire s'exécute lorsque les valeurs de champ associées dans le document changent.
  • Calculer : le script form-value s'exécutera lorsque les valeurs des champs du document changeront.
  • Frappe : le script forme-valeur s'exécute lorsque des frappes sont saisies dans un champ de texte.

Remarque : Les utilisateurs pourront voir tous les scripts disponibles aux niveaux Document et 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. Cependant, l'application prend en charge les JavaScripts généraux tels que les alertes, les calculs, le formatage et la validation.

Préférences JavaScript

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

Activer Javascript :

  1. Dans la barre de menus, choisissez Nitro PDF Pro> Préférences 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 édition de JavaScripts PDF

La fenêtre Script de Nitro PDF Pro vous permet d'afficher et de modifier le 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 de 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 de gauche pour afficher le JavaScript dans le volet de droite de l'éditeur de script.
  4. Cliquez dans le volet de l'éditeur de script pour commencer à modifier le script.
  5. Les modifications apportées aux scripts seront automatiquement enregistrées.

Remarque : Les JavaScripts d'Adobe sont généralement caractérisés par le préfixe "AF".

Suppression de PDFs JavaScripts

La fenêtre Script vous permet de supprimer les JavaScripts dans un PDFs. Les JavaScripts actuellement inclus dans le document sont répertoriés dans le volet de 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 de 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 de gauche pour afficher le JavaScript dans le volet de droite de l'éditeur de script.
  4. Cliquez sur le signe moins - situé dans le coin inférieur gauche de la fenêtre de script pour supprimer un script.
  5. Les modifications apportées aux scripts seront automatiquement enregistrées.

Ajout de JavaScript PDF

La fenêtre Script vous permet d'ajouter de nouveaux scripts au PDFs.

  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 de 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 plus + situé dans le coin inférieur gauche de la fenêtre de 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 champ de formulaire, voir 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 automatiquement enregistrées.

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

Exécuter des 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 de sélection de texte
Sélectionner un Tool
(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 scénario est correct.
  • Le script est pris en charge par votre version PDFs.
  • Le script est pris en charge par Nitro PDF Pro.
Tags