Manual del Usuario
PDFs para bebés niños

Edición y adición de JavaScript

(Función avanzada de Nitro PDF Pro)

JavaScript se utiliza en Nitro PDF Pro para crear funciones o acciones personalizadas en formularios PDF. Los comandos de Javascript se pueden aplicar a campos de formulario para cálculos, formateo, validaciones y muchas otras cosas. Se requiere un conocimiento avanzado de la programación de JavaScript para editar scripts existentes o agregar nuevos scripts. Los recursos que pueden ayudar con la programación de JavaScript general o específica de Adobe están disponibles en línea a través de w 3 schools.com, pdfscripting.com , Adobe y muchas otras fuentes.

Nota : Nitro PDF Pro solo admite JavaScript para formularios PDF de Acroform. No es compatible con JavaScripts para documentos LiveCycle (XFA).

¿Qué es JavaScript?

JavaScript es un lenguaje de programación de computadoras orientado a objetos. Se usa comúnmente para crear efectos interactivos dentro de los navegadores web y proporciona una forma poderosa de personalizar PDFs.

Nitro PDF Pro le permite ver, agregar, eliminar o editar archivos JavaScript existentes a través de una ventana de secuencias de comandos. Los JavaScripts en un documento se enumeran como scripts de documento o scripts de página . En general, hay cuatro tipos de JavaScript:

Scripts de documentos: los scripts de nivel de documento son scripts 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 documentos se utilizan para configurar operaciones, realizar pruebas de entorno de nivel superior o definir ciertas funciones y variables utilizadas por otros scripts en el documento.

Acciones de documentos: las acciones de documentos son eventos provocados por una actividad como cerrar, guardar o imprimir un documento. Las "acciones" del documento permiten a los diseñadores de formularios cambiar el documento antes o después de cualquiera de esas actividades. Por lo general, hay cinco acciones de documentos:

  • Will Close: se le solicita antes de cerrar un PDFs. Esta acción se usa principalmente para limpiar, como apagar algo, si un documento incluye multimedia interactiva avanzada como videos.
  • Guardará : se le solicita antes de guardar un PDF. Esta acción se utiliza principalmente para realizar cambios automáticos para distinguir la versión guardada del documento.
  • ¿Guardó ?: se le solicita después de guardar un PDF. Esta acción se utiliza principalmente para restaurar los cambios realizados en la acción "Se guardará".
  • Will Print: se le solicita antes de imprimir un PDFs. Esta acción se usa principalmente para realizar cambios visuales en un documento, como hacer visible un encabezado o un sello en un PDFs.
  • Imprimió: se le solicita después de agregar PDF a la cola de impresión. Esta acción se utiliza principalmente para restaurar los cambios realizados en el documento en la acción "Se imprimirá".

Acciones de página: las acciones a nivel de página son eventos que se desencadenan a nivel de página, como abrir y cerrar. Por ejemplo, "abrir" una página se refiere a cuando la página específica del documento es completamente visible y su número de página asociado se refleja en la barra de herramientas. “Cerrar” una página se refiere a cuando la página específica del documento ya no es completamente visible y su número de página asociado ya no se refleja en la barra de herramientas. Estas acciones suelen ser útiles para administrar páginas que contienen multimedia interactiva, como temporizadores, videos o animaciones, que actualmente Nitro PDF Pro puede no admitir.

Acciones de anotación: las acciones de anotación son eventos a nivel de página asociados principalmente con elementos de formulario para campos de formulario. Estas acciones habilitan funciones personalizadas o formato para anotaciones específicas. Los usuarios podrán editar o agregar formatos, cálculos o validaciones específicos para los campos de formulario. Los scripts de campo de formulario incluyen dos tipos principales de scripts: "Scripts de widget" y "Scripts de valor de formulario". Los scripts de widgets son acciones realizadas en un campo. Los scripts de valor de formulario son acciones que ocurren cuando cambia el valor de un campo de formulario.

  • Enter : el script del widget se ejecuta cuando un cursor ingresa al campo del formulario.
  • Salir : la secuencia de comandos del widget se ejecuta cuando un cursor sale del campo de formulario.
  • Foco : la secuencia de comandos del widget se ejecuta cuando el campo del formulario alcanza el foco del teclado.
  • Desenfoque : la secuencia de comandos del widget se ejecuta cuando el campo del formulario pierde el foco del teclado.
  • Ratón arriba : la secuencia de comandos del widget se ejecuta cuando el mouse/cursor se desplaza sobre el campo del formulario y el usuario hace clic en el botón.
  • Ratón hacia abajo : la secuencia de comandos del widget se ejecuta cuando un mouse/cursor se desplaza sobre el campo de formulario y se suelta el botón del mouse.
  • Página abierta : ver Acciones de la página.
  • Página cerrada : ver Acciones de la página.
  • Formato : el script de valor de forma se ejecutará después del script Validate si el script Validate es verdadero.
  • Validar : el script de valor de formulario se ejecutará cuando cambien los valores de campo asociados en el documento.
  • Calcular : el script de valor de formulario se ejecutará cuando cambien los valores de campo del documento.
  • Pulsación de tecla: el script de valor de forma se ejecutará cuando se introduzcan pulsaciones de tecla en un campo de texto.

Nota : los usuarios podrán ver todos los scripts disponibles tanto en el nivel del documento como en el de la página. Sin embargo, aunque todos los scripts son técnicamente editables, es posible que Nitro PDF Pro no admita todos los JavaScript. Por ejemplo, Nitro PDF Pro actualmente no es compatible con ciertos elementos multimedia, como videos interactivos. Sin embargo, la aplicación admite JavaScripts generales, como alertas, cálculos, formateo y validación.

Preferencias de JavaScript

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

Habilitar JavaScript:

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

Visualización y edición de PDF JavaScript

La ventana Script de Nitro PDF Pro le permite ver y editar el 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á editando activamente.

  1. En la barra de menús, seleccione Ventana > Scripts en el menú desplegable para mostrar la ventana Script.
  2. Todos los JavaScripts incluidos actualmente en el documento se enumeran en el panel izquierdo. Los scripts de documentos se enumeran en la parte superior. Los scripts de página que se encuentran en cada página se enumeran a continuación.
  3. Haga clic para seleccionar un elemento en el panel izquierdo para mostrar el JavaScript en el panel del editor de secuencias de comandos a la derecha.
  4. Haga clic dentro del panel del editor de secuencias de comandos para comenzar a editar la secuencia de comandos.
  5. Los cambios realizados en los scripts se guardarán automáticamente.

Nota: los métaScripts de Adobe generalmente se caracterizan por el prefijo "AF".

Eliminación de archivos JavaScript de PDF

La ventana Script le permite eliminar JavaScripts en un PDF. Los JavaScripts incluidos actualmente en el documento se enumeran en el panel izquierdo.

  1. En la barra de menús, seleccione Ventana > Scripts en el menú desplegable para mostrar la ventana Script.
  2. Todos los JavaScripts incluidos actualmente en el documento se enumeran en el panel izquierdo. Los scripts de documentos se enumeran en la parte superior. Los scripts de página se enumeran a continuación para cada página.
  3. Haga clic para seleccionar un elemento en el panel izquierdo para mostrar el JavaScript en el panel del editor de secuencias de comandos a la derecha.
  4. Haga clic en el signo menos , ubicado 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.

Adición de JavaScript en PDF

La ventana Script le permite agregar nuevos scripts al PDF.

  1. En la barra de menús, seleccione 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 de documentos aparecen en la parte superior. Los scripts de página aparecen a continuación para cada página.
  3. Haga clic en el signo más + ubicado en la esquina inferior izquierda de la ventana Script para agregar un nuevo script.
  4. En el cuadro de diálogo Agregar un script , seleccione un tipo de script en el menú desplegable Seleccionar tipo de script .
  5. Si agrega una acción de anotación a un campo de formulario, seleccione una acción del menú desplegable "Elegir acción". Para obtener información sobre cómo agregar cálculos de campos de formulario, consulte Creación de formularios .
  6. Haga clic dentro del panel de edición y reemplace el texto predeterminado "// escriba su secuencia de comandos aquí" con una nueva secuencia de comandos.
  7. Los cambios realizados en los scripts se guardarán automáticamente.

Nota : para agregar una acción de anotación a un campo de formulario específico, debe tener el campo de formulario seleccionado antes de hacer clic en el signo más + para agregar un script. Si no tiene una anotación específica seleccionada, solo puede agregar secuencias de comandos de documento o página .

Ejecutando JavaScripts

Hay un par de maneras de probar su JavaScript. Para ejecutar scripts línea por línea, use la ventana de JavaScript.

  1. Mantenga presionada la tecla Opción (o Alt).
  2. Elija Ventana > Consola de JavaScript.
  3. Escriba o pegue scripts en la Consola.
  4. Haga clic en Ejecutar .
Para probar tu formulario con cálculos, deberás cambiar a la Tool Seleccionar texto
Seleccione herramienta
(Comando+1) para probar tu formulario. Vuelve a la herramienta de edición
Editar herramienta
(Comando+ 2 ) para editar la apariencia de los elementos que ha colocado en su formulario.

Nota : los JavaScripts solo se ejecutarán correctamente si:

  • El guión es correcto.
  • El script es compatible con tu versión PDFs.
  • El script es compatible con Nitro PDF Pro.
Etiquetas
PDFs para bebés niños Funciones avanzadas