Edición y adición de JavaScript

(Característica avanzada de Nitro PDF Pro)

JavaScript se utiliza en Nitro PDF Pro para crear funciones o acciones personalizadas en formularios PDF. Los comandos Javascript pueden aplicarse a los campos del formulario para realizar cálculos, formatear, validar y muchas otras cosas. Se requieren conocimientos avanzados de programación JavaScript para editar los scripts existentes o añadir nuevos scripts. En w3schools.com encontrará recursos que pueden ayudarle con la programación de JavaScript general o específica de Adobe, pdfscripting.com, Adobe, y muchas otras fuentes.

Nota: Nitro PDF Pro sólo admite JavaScripts para formularios PDF Acroform. No admite JavaScripts para documentos LiveCycle (XFA).

JavaScript es un lenguaje de programación informática orientado a objetos. Se utiliza habitualmente para crear efectos interactivos en los navegadores web y proporciona una potente forma de personalizar los PDF.

Nitro PDF Pro le permite ver, añadir, eliminar o editar JavaScripts existentes a través de una ventana de scripts. Los JavaScripts de un documento aparecen como Scripts del documento o Scripts de la página . En general, existen cuatro tipos de JavaScript:

Scripts de documento: los scripts de nivel de documento son scripts situados 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 del documento se utilizan para configurar operaciones, realizar pruebas de entorno de alto nivel o definir determinadas funciones y variables utilizadas por otros scripts del documento.

Acciones de documento: las acciones de documento son eventos provocados 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. Suele haber cinco acciones documentales:

• Cerrará: se le preguntará antes de cerrar un PDF. Esta acción se utiliza principalmente para limpiar -como apagar algo- si un documento incluye multimedia interactivo avanzado como vídeos.
• Guardará: se le preguntará antes de guardar un PDF. Esta acción se utiliza principalmente para realizar cambios automáticos que distingan la versión guardada del documento.
• Did Save: se solicita después de guardar un PDF. Esta acción se utiliza principalmente para restaurar los cambios realizados en la acción "Guardará".
• Will Print: se le preguntará 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.
• Did Print: se solicita después de añadir al 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 "Imprimirá".

Acciones a nivel de página: Las acciones a nivel de página son eventos desencadenados 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 es totalmente 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 totalmente visible y su número de página asociado ya no se refleja en la barra de herramientas. Estas acciones suelen ser útiles para gestionar páginas que contengan multimedia interactiva, como temporizadores, vídeos o animaciones, que actualmente Nitro PDF Pro no admite.

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 funciones o formatos personalizados para anotaciones específicas. Los usuarios podrán editar o añadir un formato específico, cálculos o validaciones para los campos de formulario. Los scripts de campos de formulario incluyen dos tipos principales de scripts: "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.

• Entrar: el script del widget se ejecuta cuando un cursor entra en el campo del formulario.
• Salir: el script del widget se ejecuta cuando el cursor abandona el campo del formulario.
• Focus: el script del widget se ejecuta cuando el campo del formulario obtiene el foco del teclado.
• Blur: el script del widget se ejecuta cuando el campo del formulario pierde el foco del teclado.
• Ratón arriba: el script del widget se ejecuta cuando el ratón/cursor pasa por encima del campo del formulario y el usuario pulsa el botón.
• Ratón pulsado: el script del widget se ejecuta cuando el ratón/cursor pasa por encima del campo del formulario y se suelta el botón del ratón.
• Página abierta: ver Acciones de la página.
• Página cerrada: ver Acciones de la página.
• Formato: el script del valor del formulario se ejecutará después del script Validar si el script Validar es verdadero.
• Validar: el script de valores de formulario se ejecutará cuando cambien los valores de los campos asociados en el documento.
• Calcular: el script de valores de formulario se ejecutará cuando cambien los valores de los campos del documento.
• Pulsación de teclas: el script de valor de formulario se ejecutará cuando se introduzcan pulsaciones de teclas en un campo de texto.

Nota: Los usuarios podrán ver todos los guiones disponibles tanto a nivel de documento como de página. Sin embargo, aunque todos los scripts son técnicamente editables, es posible que Nitro PDF Pro no admita todos los JavaScripts. A modo de ejemplo, Nitro PDF Pro actualmente no es compatible con ciertos elementos multimedia como los vídeos interactivos. Sin embargo, la aplicación sí admite JavaScripts generales como alertas, cálculos, formateo y validación.

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

Activar 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. Marque la opción "Activar 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 aparecen en el panel izquierdo. Los guiones de los documentos aparecen en la parte superior. A continuación se enumeran las secuencias de comandos de cada página.
3. Haga clic para seleccionar un elemento en el panel izquierdo para mostrar el JavaScript en el panel del editor de scripts de la derecha.
4. Haga clic dentro del panel del editor de scripts para comenzar a editar el script.
5. Los cambios realizados en los guiones se guardarán automáticamente.

Nota: Los JavaScripts de Adobe suelen caracterizarse por el prefijo "AF".

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 aparecen en el panel izquierdo. Los guiones de los documentos aparecen en la parte superior. A continuación se enumeran los guiones de cada página.
3. Haga clic para seleccionar un elemento en el panel izquierdo para mostrar el JavaScript en el panel del editor de scripts de la derecha.
4. Haga 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 guiones se guardarán automáticamente.

La ventana Script le permite añadir 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 JavaScript incluidas actualmente en el documento se enumeran en el panel izquierdo. Los guiones de los documentos aparecen en la parte superior. A continuación se enumeran los guiones de cada página.
3. Haga 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 , seleccione un tipo de script en el menú desplegable Seleccionar tipo de script .
5. Si añade 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 añadir cálculos de campos de formulario, consulte Creación de formularios.
6. Haga clic dentro del panel de edición y sustituya el texto por defecto "// escriba aquí su script" por un nuevo script.
7. Los cambios realizados en los guiones se guardarán automáticamente.

Nota: Para añadir una acción de anotación a un campo de formulario específico, debe tener seleccionado el campo de formulario antes de hacer clic en el signo más + para añadir un guión. Si no tiene seleccionada una anotación específica, sólo podrá añadir guiones Documento o Página .

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

1. Mantenga pulsada la tecla Opción (o Alt).
2. Seleccione Ventana > Consola JavaScript.
3. Escriba o pegue los guiones en la consola.
4. Haga clic en Ejecutar.

Para probar su formulario con cálculos, deberá cambiar a la herramienta Seleccionar texto

(Comando+1) para probar su forma. Vuelva a la herramienta de edición

(Comando+2) para editar la apariencia de los elementos que ha colocado en su formulario.

Nota: Los JavaScripts sólo se ejecutarán con éxito si:

• El guión es correcto.
• El script es compatible con su versión de PDF.
• El script es compatible con Nitro PDF Pro.