Skip to content
Other articles in this category

Ajouter ou modifier du code 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 effectuer des calculs, des mises en forme, des validations et bien d’autres opérations. Des connaissances avancées en programmation JavaScript sont requises pour modifier des scripts existants ou en ajouter de nouveaux. Des ressources pouvant vous aider dans la programmation JavaScript générale ou spécifique à Adobe sont disponibles en ligne sur  w3schools.com ,  pdfscripting.com , Adobe et de nombreuses autres sources.

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

Qu'est-ce que JavaScript ?

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

Nitro PDF Pro vous permet d’afficher, d’ajouter, de supprimer ou de modifier des scripts JavaScript existants via une fenêtre de script. Les scripts JavaScript d’un document sont répertoriés soit comme « Scripts de document », soit comme « Scripts de page ». Il existe généralement quatre types de scripts JavaScript :

Scripts de document: les scripts de document sont situés au sommet de la hiérarchie des scripts d’un document PDF. Ce sont les premiers à être exécutés lorsqu’un document est chargé dans Nitro PDF Pro. Les scripts de document servent à configurer des opérations, à effectuer des tests d’environnement de haut niveau ou à définir certaines fonctions et variables utilisées par d’autres scripts du 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 » : déclenchée avant la fermeture d’un PDF. Cette action sert principalement à effectuer des opérations de nettoyage — comme la désactivation de certains éléments — si un document contient du contenu multimédia interactif avancé, tel que des vidéos.
  • «Va enregistrer » : déclenchée avant l’enregistrement d’un PDF. Cette action sert principalement à apporter des modifications automatiques afin de distinguer la version enregistrée du document.
  • Enregistrement effectué: déclenchée après l’enregistrement d’un PDF. Cette action sert principalement à restaurer les modifications apportées lors de l’action « Enregistrement à venir ».
  • Va imprimer: s’affiche avant l’impression d’un PDF. Cette action sert principalement à apporter des modifications visuelles à un document, par exemple en rendant visible un en-tête ou un tampon sur un PDF.
  • A imprimé: s’affiche après l’ajout du PDF à la file d’attente d’impression. Cette action sert principalement à restaurer les modifications apportées au document lors de l’action « Va 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 signifie que la page spécifique du document est à la fois entièrement visible et que son numéro de page associé apparaît dans la  barre d’outils . La « fermeture » d’une page désigne le moment où la page spécifique du document n’est plus entièrement visible et où son numéro de page associé n’apparaît plus 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 peut-être pas en charge pour le moment.

Actions d’annotation: les actions d’annotation sont des événements au niveau de la page, principalement associés aux éléments de formulaire pour les champs de formulaire. Ces actions permettent d’appliquer des fonctions personnalisées ou une mise en forme spécifique à certaines annotations. Les utilisateurs pourront modifier ou ajouter une mise en forme, des calculs ou des validations spécifiques aux champs de formulaire. Les scripts de champs de formulaire comprennent deux grands 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 de widget s’exécute lorsqu’un curseur entre dans le champ de formulaire.
  • Sortie: le script de widget s’exécute lorsque le curseur quitte le champ du formulaire.
  • Focus: le script de widget s’exécute lorsque le champ de formulaire reçoit le focus clavier.
  • Perte de focus: le script de widget s’exécute lorsque le champ de formulaire perd le focus clavier.
  • Relâchement de la souris: le script du widget s'exécute lorsque la souris ou le curseur survole le champ du formulaire et que l'utilisateur clique sur le bouton.
  • Relâchement de la souris: le script du widget s'exécute lorsque la souris ou le curseur survole le champ du formulaire et que le bouton de la souris est relâché.
  • Page ouverte: voir Actions de page.
  • Page fermée: voir Actions de page.
  • Format: le script « form-value » s'exécutera après le script « Validate » si ce dernier renvoie la valeur « true ».
  • Validation: le script « form-value » s'exécutera lorsque les valeurs des champs associés dans le document changeront.
  • Calculer: le script « form-value » s'exécute lorsque les valeurs des champs du document changent.
  • Frappe: le script « form-value » s'exécutera lorsque des caractères seront saisis dans un champ de texte.
Remarque: les utilisateurs pourront consulter tous les scripts disponibles tant au niveau du document qu'au niveau de la page. Cependant, bien que tous les scripts soient techniquement modifiables, Nitro PDF Pro peut ne pas prendre en charge tous les scripts JavaScript. À titre d’exemple, Nitro PDF Pro ne prend actuellement pas en charge certains éléments multimédias tels que les vidéos interactives. En revanche, l’application prend en charge les scripts JavaScript courants tels que les alertes, les calculs, la mise en forme et la validation.

Préférences JavaScript Avant de pouvoir exécuter du code JavaScript dans un document, il faut l'activer dans les Préférences (  Préférences utilisateur ).

Activer JavaScript:

  1. Dans la barre de menus, sélectionnez 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 modification des scripts JavaScript dans les PDF La fenêtre « Script » de Nitro PDF Pro vous permet d’afficher et de modifier les scripts 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 êtes en train de modifier.

  1. Dans la barre de menus, choisissez Fenêtre > Scripts dans le menu déroulant pour afficher la fenêtre Script.
  2. Tous les scripts JavaScript actuellement inclus dans le document sont répertoriés dans le volet de gauche. Les scripts du document apparaissent en haut. Les scripts de page présents sur chaque page sont répertoriés en dessous.
  3. Cliquez pour sélectionner un élément dans le volet de gauche afin d’afficher le code JavaScript dans le volet de l’éditeur de script situé à droite.
  4. Cliquez à l'intérieur du volet de l'éditeur de script pour commencer à modifier le script.
  5. Les modifications apportées aux scripts sont enregistrées automatiquement.
Remarque: les scripts JavaScript d’Adobe sont généralement identifiés par le préfixe « AF ».

Suppression des scripts JavaScript d’un PDF La fenêtre « Script » vous permet de supprimer des scripts JavaScript d’un PDF. Les scripts JavaScript actuellement inclus dans le document sont répertoriés dans le volet de gauche.

  1. Dans la barre de menus, sélectionnez Fenêtre > Scripts dans le menu déroulant pour afficher la fenêtre Scripts.
  2. Tous les scripts JavaScript actuellement inclus dans le document sont répertoriés dans le volet de gauche. Les scripts du 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 afin d’afficher le script JavaScript dans le volet de l’éditeur de scripts situé à droite.
  4. Cliquez sur le signe moins (-) situé dans le coin inférieur gauche de la fenêtre « Scripts » pour supprimer un script.
  5. Les modifications apportées aux scripts sont enregistrées automatiquement.

Ajout de scripts JavaScript au PDF La fenêtre « Script » vous permet d’ajouter de nouveaux scripts au PDF.

  1. Dans la barre de menus, sélectionnez Fenêtre > Scripts dans le menu déroulant pour afficher la fenêtre Scripts.
  2. Les actions JavaScript actuellement incluses dans le document sont répertoriées dans le volet de gauche. Les scripts du document apparaissent en haut. Les scripts de page sont répertoriés en dessous, page par page.
  3. Cliquez sur le signe « + » situé dans le coin inférieur gauche de la fenêtre « Scripts » 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 aux champs de formulaire, consultez la section  Création de formulaires .
  6. Cliquez dans le volet d’édition et remplacez le texte par défaut « // saisissez votre script ici » par un nouveau script.
  7. Les modifications apportées aux scripts sont enregistrées automatiquement.
Remarque: pour ajouter une action d’annotation à un champ de formulaire spécifique, vous devez avoir sélectionné ce champ avant de cliquer sur le signe 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écution de scripts JavaScript Il existe plusieurs façons de tester votre script JavaScript. Pour exécuter les scripts ligne par ligne, utilisez la fenêtre JavaScript.

  1. Maintenez la touche Option (ou Alt) enfoncée.
  2. Sélectionnez Fenêtre > Console JavaScript.
  3. Saisissez ou collez vos scripts dans la console.
  4. Cliquez sur Exécuter.
Pour tester votre formulaire comportant des calculs, vous devrez passer à l’outil de sélection de texte select tool
(Commande+1) afin de tester votre formulaire. Revenez à l’outil d’éditionedit tool(Commande+2) pour modifier l’apparence des éléments que vous avez placés dans votre formulaire.


Remarque: les scripts JavaScript ne s'exécuteront correctement que si :

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

Last updated: juillet 29, 2025