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
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
- A l'Adobe Acrobat Pro, obriu Eines > Prepara el formulari i afegiu-hi un botó.
- 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».
- A la pestanya Opcions, trieu un disseny amb etiqueta i escriviu a «Etiqueta» el text visible: «Envia la sol·licitud».
- A la pestanya Accions, trieu el desencadenant «Ratolí amunt» (Mouse Up). També funciona amb teclat i només actua en prémer el botó.
- Trieu l'acció «Envia un formulari», premeu «Afegeix» i indiqueu l'adreça del servidor o el correu que rebrà les dades.
- No poseu accions d'enviament en altres camps, per exemple en sortir d'un camp o en passar el ratolí.
Com comprovar-ho
- Empleneu tot el formulari amb el teclat. Cap camp no ha de provocar un enviament ni un salt de pàgina.
- Arribeu al botó amb el tabulador i premeu-lo amb Retorn o Espai. El formulari s'ha d'enviar.
- A Prepara el formulari, reviseu la pestanya Accions dels altres camps. No han de contenir «Envia un formulari».
- 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.
- Seleccioneu l'eina «Prepara el formulari» (Prepare Form).
- Amb la barra d'eines «Prepara el formulari», afegiu un botó al formulari.
- Seleccioneu el botó, accediu al menú contextual i trieu l'opció «Propietats...».
- 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.
- A la pestanya «General», indiqueu una informació d'eina (tooltip) per al botó.
- 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.
- 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».
- 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:
- Obriu el quadre de diàleg «Propietats del botó», com es mostra a l'exemple 1, i seleccioneu la pestanya «Accions».
- Seleccioneu «Executa un JavaScript» (Run a JavaScript) a la llista desplegable i premeu el botó «Afegeix».
- 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
-
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
- Secció 12.7.5.2 (Submit-Form Action) de PDF 1.7 (ISO 32000-1) (PDF)
- Create and verify PDF accessibility (Acrobat Pro) (crear i comprovar l'accessibilitat d'un PDF)
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.
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.