Addaw, anar a la pàgina d'inici Donar

Tècnica PDF WCAG 2.2

PDF15Enviar un formulari PDF només amb un botó d'enviament

Nom oficial al W3C: Proporcionar botons d'enviament amb l'acció submit-form en formularis PDF

Versión en castellano

En poques paraules

Un formulari PDF no s'ha d'enviar ni canviar de pàgina només perquè s'empleni un camp o es marqui una opció. L'enviament s'ha de produir quan la persona prem un botó pensat per a això, com ara «Envia la sol·licitud». A l'Acrobat es crea amb l'acció «Envia un formulari».

Per què és important

Un canvi inesperat desorienta. Si en triar la província en una llista el formulari s'envia sol, s'envien dades incompletes i la persona no sap què ha passat.

Afecta sobretot qui fa servir un lector de pantalla o el teclat, que recorre les opcions una per una. També les persones amb dificultats de comprensió, que necessiten controlar cada pas.

Com es fa

  1. A l'Adobe Acrobat Pro, obriu Eines > Prepara el formulari i afegiu-hi un botó.
  2. Obriu-ne les propietats. A la pestanya General, poseu-hi un nom intern sense espais i una «Descripció emergent» com ara «Envia la sol·licitud».
  3. A la pestanya Opcions, trieu un disseny amb etiqueta i escriviu a «Etiqueta» el text visible: «Envia la sol·licitud».
  4. A la pestanya Accions, trieu el desencadenant «Ratolí amunt» (Mouse Up). També funciona amb teclat i només actua en prémer el botó.
  5. Trieu l'acció «Envia un formulari», premeu «Afegeix» i indiqueu l'adreça del servidor o el correu que rebrà les dades.
  6. No poseu accions d'enviament en altres camps, per exemple en sortir d'un camp o en passar el ratolí.

Com comprovar-ho

  1. Empleneu tot el formulari amb el teclat. Cap camp no ha de provocar un enviament ni un salt de pàgina.
  2. Arribeu al botó amb el tabulador i premeu-lo amb Retorn o Espai. El formulari s'ha d'enviar.
  3. A Prepara el formulari, reviseu la pestanya Accions dels altres camps. No han de contenir «Envia un formulari».
  4. Amb l'NVDA, el botó s'ha d'anunciar com a «botó, Envia la sol·licitud».
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica PDF15 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Aplicabilitat

Documents PDF etiquetats amb formularis.

Descripció

L'objectiu d'aquesta tècnica és proporcionar un mecanisme que permeti als usuaris sol·licitar explícitament un canvi de context mitjançant l'acció submit-form (enviar formulari) en un formulari PDF. L'ús previst d'un botó d'enviament és generar una petició HTTP que enviï les dades introduïdes en un formulari, per la qual cosa és un control adequat per provocar un canvi de context. En els documents PDF, els botons d'enviament s'implementen normalment amb una eina de creació de PDF.

Exemples

Afegir un botó d'enviament amb l'Adobe Acrobat Pro

Aquest exemple es mostra amb l'Adobe Acrobat Pro. Hi ha altres eines de programari que fan funcions similars.

  1. Seleccioneu l'eina «Prepara el formulari» (Prepare Form).
  2. Amb la barra d'eines «Prepara el formulari», afegiu un botó al formulari.
  3. Seleccioneu el botó, accediu al menú contextual i trieu l'opció «Propietats...».
  4. A la pestanya «General», indiqueu un nom (Name). Aquest nom el farà servir qualsevol script de JavaScript, de manera que ha de ser un valor que es pugui assignar a una variable.
  5. A la pestanya «General», indiqueu una informació d'eina (tooltip) per al botó.
  6. A la pestanya «Opcions», trieu una opció del menú «Disseny» (Layout) per a l'etiqueta del botó, la imatge de la icona o totes dues. A continuació, escriviu un text al quadre «Etiqueta» que identifiqui el botó com a botó d'enviament o premeu «Tria una icona» i localitzeu el fitxer d'imatge que vulgueu fer servir, o feu totes dues coses.
  7. A la pestanya «Accions»:
    • A «Selecciona el desencadenant» (Select Trigger), trieu «Ratolí amunt» (Mouse Up). (L'esdeveniment Mouse Up és accessible amb el teclat i, a més, garanteix que el botó no canviarà el context de manera inesperada, com podria passar amb un esdeveniment Mouse Enter, en entrar el ratolí).
    • A «Selecciona l'acció» (Select Action), trieu «Envia un formulari» (Submit A Form).
    • Premeu «Afegeix».
  8. Al quadre de diàleg «Afegeix», introduïu un URL per recollir les dades en un servidor o per rebre les dades del formulari com a adjunts de correu electrònic.

Afegir una acció d'script a un botó d'enviament en un document PDF mitjançant JavaScript

El codi JavaScript següent il·lustra l'ús d'un script per especificar l'acció submit-form. Per afegir aquest script al camp de formulari:

  1. Obriu el quadre de diàleg «Propietats del botó», com es mostra a l'exemple 1, i seleccioneu la pestanya «Accions».
  2. Seleccioneu «Executa un JavaScript» (Run a JavaScript) a la llista desplegable i premeu el botó «Afegeix».
  3. Introduïu el codi JavaScript al quadre de diàleg «Editor de JavaScript».

Aquest exemple es mostra en funcionament a l'exemple pràctic de com afegir una acció d'script a un botó d'enviament.

Proves

Procediment

  1. Per a cada pàgina que enviï un formulari, comprovar visualment que el formulari conté un botó d'enviament i verificar una de les opcions següents:

    • Tabular fins al botó i comprovar que envia el formulari en resposta a l'acció de l'usuari de seleccionar el botó.
    • Obrir el document PDF amb una eina capaç de mostrar l'acció submit-form i comprovar que l'acció del botó és enviar el formulari.

Resultats esperats

  • La comprovació núm. 1 és certa per a cada pàgina que conté un formulari.

Recursos

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica PDF15 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.