Addaw, ir a inicio Donar

Técnica PDF WCAG 2.2

PDF15Enviar un formulario PDF solo con un botón de envío

Nombre oficial en el W3C: Proporcionar botones de envío con la acción submit-form en formularios PDF

En pocas palabras

Un formulario PDF no debe enviarse ni cambiar de página solo porque se rellene un campo o se marque una opción. El envío debe ocurrir cuando la persona pulsa un botón pensado para ello, como «Enviar solicitud». En Acrobat se crea con la acción «Enviar un formulario».

Por qué es importante

Un cambio inesperado desorienta. Si al elegir la provincia en una lista el formulario se envía solo, se mandan datos incompletos y la persona no sabe qué ha pasado.

Afecta sobre todo a quien usa un lector de pantalla o el teclado, que recorre las opciones una a una. También a personas con dificultades de comprensión, que necesitan controlar cada paso.

Cómo se hace

  1. En Adobe Acrobat Pro, abra Herramientas > Preparar formulario y añada un botón.
  2. Abra sus propiedades. En la pestaña General, ponga un nombre interno sin espacios y una «Descripción emergente» como «Enviar solicitud».
  3. En la pestaña Opciones, elija un diseño con etiqueta y escriba en «Etiqueta» el texto visible: «Enviar solicitud».
  4. En la pestaña Acciones, elija el activador «Ratón arriba» (Mouse Up). Funciona también con teclado y solo actúa al pulsar el botón.
  5. Elija la acción «Enviar un formulario», pulse «Agregar» e indique la dirección del servidor o el correo que recibirá los datos.
  6. No ponga acciones de envío en otros campos, por ejemplo al salir de un campo o al pasar el ratón.

Cómo comprobarlo

  1. Rellene todo el formulario con el teclado. Ningún campo debe provocar un envío ni un salto de página.
  2. Llegue al botón con el tabulador y púlselo con Intro o Espacio. El formulario debe enviarse.
  3. En Preparar formulario, revise la pestaña Acciones de los demás campos. No deben contener «Enviar un formulario».
  4. Con NVDA, el botón debe anunciarse como «botón, Enviar solicitud».
Ver el texto completo del W3C (traducción al español)

Esta es una traducción no oficial al español de la técnica PDF15 de Techniques for WCAG 2.2, del W3C. Puede contener errores. El único documento oficial y normativo es la versión original en inglés, publicada en el sitio web del W3C.

Aplicabilidad

Documentos PDF etiquetados con formularios.

Descripción

El objetivo de esta técnica es proporcionar un mecanismo que permita a los usuarios solicitar explícitamente un cambio de contexto mediante la acción submit-form (enviar formulario) en un formulario PDF. El uso previsto de un botón de envío es generar una petición HTTP que envíe los datos introducidos en un formulario, por lo que es un control adecuado para provocar un cambio de contexto. En los documentos PDF, los botones de envío se implementan normalmente con una herramienta de creación de PDF.

Ejemplos

Añadir un botón de envío con Adobe Acrobat Pro

Este ejemplo se muestra con Adobe Acrobat Pro. Existen otras herramientas de software que realizan funciones similares.

  1. Seleccione la herramienta «Preparar formulario» (Prepare Form).
  2. Con la barra de herramientas «Preparar formulario», añada un botón al formulario.
  3. Seleccione el botón, acceda al menú contextual y elija la opción «Propiedades...».
  4. En la pestaña «General», indique un nombre (Name). Este nombre lo utilizará cualquier script de JavaScript, así que debe ser un valor que pueda asignarse a una variable.
  5. En la pestaña «General», indique una información de herramienta (tooltip) para el botón.
  6. En la pestaña «Opciones», elija una opción del menú «Diseño» (Layout) para la etiqueta del botón, la imagen del icono o ambas. A continuación, escriba un texto en el cuadro «Etiqueta» que identifique el botón como botón de envío y/o pulse «Elegir icono» y localice el archivo de imagen que desee utilizar.
  7. En la pestaña «Acciones»:
    • En «Seleccionar desencadenador» (Select Trigger), elija «Ratón hacia arriba» (Mouse Up). (El evento Mouse Up es accesible mediante teclado y, además, garantiza que el botón no cambiará el contexto de forma inesperada, como podría ocurrir con un evento Mouse Enter, al entrar el ratón).
    • En «Seleccionar acción» (Select Action), elija «Enviar un formulario» (Submit A Form).
    • Pulse «Agregar».
  8. En el cuadro de diálogo «Agregar», introduzca una URL para recoger los datos en un servidor o para recibir los datos del formulario como adjuntos de correo electrónico.

Añadir una acción de script a un botón de envío en un documento PDF mediante JavaScript

El siguiente código JavaScript ilustra el uso de un script para especificar la acción submit-form. Para añadir este script al campo de formulario:

  1. Abra el cuadro de diálogo «Propiedades de botón», como se muestra en el ejemplo 1, y seleccione la pestaña «Acciones».
  2. Seleccione «Ejecutar un JavaScript» (Run a JavaScript) en la lista desplegable y pulse el botón «Agregar».
  3. Introduzca el código JavaScript en el cuadro de diálogo «Editor de JavaScript».

Este ejemplo se muestra en funcionamiento en el ejemplo práctico de cómo añadir una acción de script a un botón de envío.

Pruebas

Procedimiento

  1. Para cada página que envíe un formulario, comprobar visualmente que el formulario contiene un botón de envío y verificar una de las siguientes opciones:

    • Tabular hasta el botón y comprobar que envía el formulario en respuesta a la acción del usuario de seleccionar el botón.
    • Abrir el documento PDF con una herramienta capaz de mostrar la acción submit-form y comprobar que la acción del botón es enviar el formulario.

Resultados esperados

  • La comprobación n.º 1 es verdadera para cada página que contiene un formulario.

Recursos

Cómo lo comprobamos en ADDAW

En cada auditoría de ADDAW revisamos esta técnica página a página y le entregamos los errores con capturas y la forma de corregirlos.

Solicitar una auditoría

Basado en la técnica PDF15 del W3C (WCAG 2.2). Explicación y ejemplos: ADDAW. Traducción no oficial del texto del W3C © W3C, licencia de documentos del W3C. ¿Ha visto un error? Escríbanos.