Skip to content
Otros artículos en esta categoría

Añadir o editar JavaScript

(Funcionalidad avanzada de Nitro PDF Pro)

En Nitro PDF Pro se utiliza JavaScript para crear funciones o acciones personalizadas en formularios PDF. Los comandos de JavaScript se pueden aplicar a los campos de los formularios para realizar cálculos, aplicar formato, llevar a cabo validaciones y muchas otras tareas. Se requieren conocimientos avanzados de programación en JavaScript para editar scripts existentes o añadir otros nuevos. En Internet hay disponibles recursos que pueden servir de ayuda con la programación en JavaScript, tanto en general como específica de Adobe, a través de  w3schools.com ,  pdfscripting.com , Adobe y muchas otras fuentes.

Nota: Nitro PDF Pro solo admite scripts de JavaScript para formularios PDF de Acroform. No admite scripts de JavaScript para documentos de LiveCycle (XFA).

¿Qué es JavaScript?

JavaScript es un lenguaje de programación orientado a objetos. Se utiliza habitualmente para crear efectos interactivos en navegadores web y ofrece una forma eficaz de personalizar archivos PDF.

Nitro PDF Pro te permite ver, añadir, eliminar o editar los scripts de JavaScript existentes a través de una ventana de scripts. Los scripts de JavaScript de un documento se clasifican como «Scripts de documento » o «Scripts de página ». En general, existen cuatro tipos de scripts de JavaScript:

Scripts de documento: los scripts a nivel de documento son los que se encuentran en la parte superior de la jerarquía de scripts de un documento PDF. Estos scripts son los primeros que se ejecutan cuando se carga un documento en Nitro PDF Pro. Los scripts de documento se utilizan para configurar operaciones, realizar pruebas de entorno de nivel superior o definir determinadas funciones y variables que utilizan otros scripts del documento.

Acciones del documento: las acciones del documento son eventos desencadenados por una actividad, como cerrar, guardar o imprimir un documento. Las «acciones» del documento permiten a los diseñadores de formularios modificar el documento antes o después de cualquiera de esas actividades. Normalmente hay cinco acciones del documento:

  • Se va a cerrar: se activa antes de cerrar un PDF. Esta acción se utiliza principalmente para realizar tareas de limpieza —como desactivar algún elemento— si un documento incluye contenido multimedia interactivo avanzado, como vídeos.
  • Se va a guardar: se activa antes de guardar un PDF. Esta acción se utiliza principalmente para realizar cambios automáticos que distingan la versión guardada del documento.
  • Se ha guardado: se activa tras guardar un PDF. Esta acción se utiliza principalmente para restaurar los cambios realizados en la acción «Se va a guardar».
  • Se va a imprimir: aparece antes de imprimir un PDF. Esta acción se utiliza principalmente para realizar cambios visuales en un documento, como hacer visible un encabezado o un sello en un PDF.
  • Se ha impreso: aparece tras añadir el PDF a la cola de impresión. Esta acción se utiliza principalmente para revertir los cambios realizados en el documento en la acción «Se va a imprimir».
Acciones de página: Las acciones a nivel de página son eventos que se activan a nivel de página, como la apertura y el cierre. Por ejemplo, «abrir» una página se refiere a cuando la página específica del documento está totalmente visible y su número de página asociado aparece en la  barra de herramientas . «Cerrar» una página se refiere al momento en que dicha página del documento ya no está completamente visible y su número de página asociado ya no aparece en la barra de herramientas. Estas acciones suelen ser útiles para gestionar páginas que contienen elementos multimedia interactivos, como temporizadores, vídeos o animaciones, que es posible que Nitro PDF Pro no admita actualmente.

Acciones de anotación: Las acciones de anotación son eventos a nivel de página asociados principalmente a elementos de formulario para campos de formulario. Estas acciones permiten aplicar funciones personalizadas o formato a anotaciones específicas. Los usuarios podrán editar o añadir formato específico, cálculos o validaciones para los campos de formulario. Los scripts de campos de formulario incluyen dos tipos principales: «scripts de widget» y «scripts de valor de formulario». Los scripts de widget son acciones que se realizan en un campo. Los scripts de valor de formulario son acciones que se producen cuando cambia el valor de un campo de formulario.

  • Entrada: el script de widget se ejecuta cuando el cursor entra en el campo del formulario.
  • Salida: el script de widget se ejecuta cuando el cursor sale del campo del formulario.
  • Foco: el script de widget se ejecuta cuando el campo del formulario obtiene el foco del teclado.
  • Desenfoque: el script de widget se ejecuta cuando el campo del formulario pierde el foco del teclado.
  • Soltar ratón: el script del widget se ejecuta cuando el ratón o el cursor se sitúa sobre el campo del formulario y el usuario hace clic en el botón.
  • Botón del ratón abajo: el script del widget se ejecuta cuando el ratón o el cursor se sitúa sobre el campo del formulario y se suelta el botón del ratón.
  • Página abierta: véase «Acciones de página».
  • Página cerrada: véase «Acciones de página».
  • Formato: el script «form-value» se ejecutará después del script «Validate» si este último es verdadero.
  • Validar: el script «form-value» se ejecutará cuando cambien los valores de los campos asociados en el documento.
  • Calcular: el script «form-value» se ejecutará cuando cambien los valores de los campos del documento.
  • Pulsación de tecla: el script «form-value» se ejecutará cuando se introduzcan pulsaciones de tecla en un campo de texto.
Nota: Los usuarios podrán ver todos los scripts disponibles tanto a nivel de documento como de página. Sin embargo, aunque técnicamente todos los scripts son editables, es posible que Nitro PDF Pro no admita todos los scripts JavaScript. Por ejemplo, Nitro PDF Pro no admite actualmente determinados contenidos multimedia, como los vídeos interactivos. No obstante, la aplicación sí admite scripts de JavaScript generales, como alertas, cálculos, formato y validación.

Preferencias de JavaScript Para que JavaScript pueda ejecutarse en un documento, debe estar habilitado en Preferencias. (  Preferencias del usuario ).

Habilitar JavaScript:

  1. En la barra de menús, selecciona Nitro PDF Pro > Preferencias en el menú desplegable.
  2. Selecciona la pestaña «General» en el cuadro de diálogo «Preferencias».
  3. Marca la opción «Habilitar JavaScript».

Visualización y edición de JavaScript en PDF La ventana «Script» de Nitro PDF Pro te permite ver y editar el código JavaScript de un documento. Si hay varios documentos abiertos simultáneamente en Nitro PDF Pro, la ventana «Script» mostrará los scripts del documento que estés editando en ese momento.

  1. En la barra de menús, selecciona Ventana > Scripts en el menú desplegable para mostrar la ventana «Script».
  2. Todos los scripts de JavaScript incluidos actualmente en el documento aparecen en el panel izquierdo. Los scripts del documento se muestran en la parte superior. Los scripts de página que se encuentran en cada página se muestran a continuación.
  3. Haz clic para seleccionar un elemento en el panel izquierdo y mostrar el código JavaScript en el panel del editor de scripts de la derecha.
  4. Haz clic dentro del panel del editor de scripts para comenzar a editar el script.
  5. Los cambios realizados en los scripts se guardarán automáticamente.
Nota: Los scripts de JavaScript de Adobe suelen identificarse con el prefijo «AF».

Eliminación de scripts de JavaScript de un PDF La ventana «Script» te permite eliminar scripts de JavaScript de un PDF. Los scripts de JavaScript incluidos actualmente en el documento aparecen en el panel izquierdo.

  1. En la barra de menús, selecciona Ventana > Scripts en el menú desplegable para mostrar la ventana «Script».
  2. Todos los scripts de JavaScript incluidos actualmente en el documento aparecen en el panel izquierdo. Los scripts del documento se muestran en la parte superior. Los scripts de página se muestran a continuación, uno por cada página.
  3. Haz clic para seleccionar un elemento en el panel izquierdo y mostrar el script JavaScript en el panel del editor de scripts de la derecha.
  4. Haz clic en el signo menos (-) situado en la esquina inferior izquierda de la ventana «Script» para eliminar un script.
  5. Los cambios realizados en los scripts se guardarán automáticamente.

Añadir scripts JavaScript al PDF: La ventana «Script» te permite añadir nuevos scripts al PDF.

  1. En la barra de menús, selecciona Ventana > Scripts en el menú desplegable para mostrar la ventana «Script».
  2. Las acciones de JavaScript incluidas actualmente en el documento aparecen en el panel izquierdo. Los scripts del documento se muestran en la parte superior. Los scripts de página se muestran a continuación, uno por cada página.
  3. Haz clic en el signo más + situado en la esquina inferior izquierda de la ventana «Script» para añadir un nuevo script.
  4. En el cuadro de diálogo «Añadir un script », selecciona un tipo de script en el menú desplegable «Seleccionar tipo de script ».
  5. Si vas a añadir una acción de anotación a un campo de formulario, selecciona una acción en el menú desplegable «Elegir acción». Para obtener información sobre cómo añadir cálculos a los campos de formulario, consulta  Creación de formularios .
  6. Haga clic dentro del panel de edición y sustituya el texto predeterminado «// escriba aquí su script» por un nuevo script.
  7. Los cambios realizados en los scripts se guardarán automáticamente.
Nota: Para añadir una acción de anotación a un campo de formulario específico, debes tener seleccionado dicho campo antes de hacer clic en el signo más (+) para añadir un script. Si no tienes seleccionada una anotación específica, solo podrás añadir scripts de documento o de página.

Ejecución de scripts de JavaScript Hay varias formas de probar su script de JavaScript. Para ejecutar los scripts línea por línea, utilice la ventana de JavaScript.

  1. Mantén pulsada la tecla Opción (o Alt).
  2. Selecciona Ventana > Consola de JavaScript.
  3. Escribe o pega los scripts en la consola.
  4. Haz clic en «Ejecutar».
Para probar tu formulario con cálculos, tendrás que cambiar a la herramienta de selección de texto select tool
(Comando+1) para poder probarlo. Vuelve a la herramienta de ediciónedit tool(Comando+2) para editar el aspecto de los elementos que hayas colocado en tu formulario.


Nota: Los scripts de JavaScript solo se ejecutarán correctamente si:

  • El script sea correcto.
  • Tu versión de PDF sea compatible con el script.
  • Nitro PDF Pro admita el script.

Última actualización: julio 29, 2025