Tècnica PDF WCAG 2.2
PDF5Indicar els camps obligatoris als formularis PDF
Nom oficial al W3C: Indicar els controls de formulari obligatoris en formularis PDF
En poques paraules
En un formulari PDF, els camps que s'han d'emplenar sí o sí es marquen com a obligatoris a les seves propietats. A més, l'etiqueta del camp ho diu. Si la persona intenta enviar el formulari amb un camp obligatori buit, apareix un avís que explica què falta.
Per què és important
Molts tràmits utilitzen formularis PDF: una sol·licitud de subvenció, una instància general o una inscripció. Si no se sap quins camps són obligatoris, la persona els deixa en blanc i la sol·licitud torna amb errors.
Qui utilitza un lector de pantalla (programa que llegeix en veu alta el contingut) no veu l'asterisc vermell. Necessita que el camp estigui marcat com a obligatori al mateix PDF, perquè el lector ho anunciï.
Com es fa
- A l'Acrobat Pro, obriu l'eina «Prepara el formulari». Feu clic amb el botó dret al camp, trieu «Propietats» i marqueu «Obligatori».
- Indiqueu-ho també a l'etiqueta i a la descripció del camp: «Data de naixement (obligatori)».
- Si utilitzeu un asterisc, expliqueu al principi del formulari què significa: «Els camps amb * són obligatoris».
- Assegureu-vos que, en enviar amb camps buits, surt un avís que anomena el camp que falta.
- Si l'avís es fa amb un script, pot portar el focus al camp buit quan es tanqui. Feu-ho només si la persona ho espera.
Com comprovar-ho
- Comproveu que l'etiqueta de cada camp obligatori ho indica amb text.
- Deixeu buit un camp obligatori i intenteu enviar el formulari. Ha d'aparèixer un avís que digui què falta.
- Recorreu el formulari amb NVDA o JAWS. En arribar al camp, el lector ha de dir «obligatori» o «requerit».
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica PDF5 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 avisar l'usuari quan no s'ha emplenat un camp que s'ha de completar en un formulari PDF. Els camps obligatoris s'implementen mitjançant l'entrada /Ff del diccionari del camp de formulari. Normalment això es fa amb una eina de creació de PDF.
Si es troben errors, un quadre de diàleg d'alerta descriu en text la naturalesa de l'error. Això es pot aconseguir mitjançant scripts creats per l'autor (vegeu, per exemple, SCR18: Proporcionar validació i alertes al costat del client). Els agents d'usuari, com l'Adobe Acrobat Pro i el LiveCycle, poden proporcionar alertes automàtiques (tal com es descriu als exemples següents).
Un cop l'usuari tanca el quadre de diàleg d'alerta, pot ser útil que l'script col·loqui el focus del teclat al camp on s'ha produït l'error, tot i que alguns usuaris poden esperar que el focus es mantingui a l'últim control que el tenia abans que aparegués l'alerta. Els autors han de vigilar per garantir que qualsevol moviment del focus sigui l'esperat. Per exemple, si l'alerta anuncia que falta un número de telèfon obligatori, col·locar el focus al camp del número de telèfon en tancar l'alerta es pot considerar útil i esperable. En alguns casos, però, això pot no ser possible. Si es produeixen diversos errors d'entrada a la pàgina, cal adoptar un altre enfocament per informar dels errors. (Vegeu, per exemple, l'Adobe SDK.)
Garantir que els usuaris sàpiguen que s'ha produït un error, puguin determinar què està malament i puguin corregir-ho és clau per a la usabilitat i l'accessibilitat del programari. Complir aquest objectiu ajuda que tots els usuaris puguin completar les transaccions amb facilitat i confiança.
Etiquetes dels controls de formulari obligatoris
També és important que els usuaris sàpiguen que es pot produir un error. Aquesta informació es pot incorporar a les etiquetes; per exemple, «Data (obligatori)» o l'ús d'un asterisc vermell per indicar els camps obligatoris. (Assegureu-vos que a cada formulari amb camps obligatoris hi apareix una llegenda, p. ex. «* = camp obligatori»). Vegeu PDF10.
Exemples
Crear un camp obligatori en un formulari PDF amb l'Acrobat Pro
- Obriu l'eina Prepara el formulari (Prepare Form), accediu al menú contextual del camp de formulari i seleccioneu l'opció Propietats.
- Si el camp de formulari és obligatori, marqueu la casella Obligatori (Required). Aquesta casella de selecció obliga l'usuari a emplenar el camp de formulari seleccionat. Si l'usuari intenta enviar el formulari amb un camp obligatori en blanc, apareix un missatge d'error i el camp obligatori buit queda ressaltat.
Aquest exemple es mostra en funcionament a l'exemple pràctic de creació d'un camp obligatori a l'Acrobat.
Afegir un camp de text obligatori en un formulari PDF mitjançant el tipus de camp /Tx i l'indicador Ff
El fragment de codi següent il·lustra el codi típic de les definicions d'objecte d'un camp de text habitual. Observeu que el camp de text és obligatori, mitjançant l'indicador Ff. Normalment això ho fa una eina de creació.
<< /AP -dict-
/DA /Helv 0 Tf 0 g
/DR -dict-
/F 0x4
/FT Tx % FT key set to Tx for Text Field
/Ff 0x2 % Ff integer 0x2 value indicates required
/P -dict-
/Rect -array-
/StructParent 0x1
/Subtype Widget
/T First % Partial field name First
/TU First name (required) % TU tool tip value serves as short description
/Type Annot
/V Pat Jones
>>
...
<Start Stream>
BT
/P <</MCID 0 >>BDC
/CS0 cs 0 scn
/TT0 1 Tf
-0.001 Tc 0.003 Tw 11.04 0 0 11.04 72 709.56 Tm
[(P)-6(le)-3(as)10(e)-3( )11(P)-6(rin)2(t)-3( Y)8(o)-7(u)2(r N)4(a)11(m)-6(e)]TJ
0 Tc 0 Tw 9.533 0 Td
( )Tj
-0.004 Tc 0.004 Tw 0.217 0 Td
[(\()-5(R)-4(e)5(q)-1(u)-1(i)-3(r)-3(e)-6(d)-1(\))]TJ
EMC
/P <</MCID 1 >>BDC
0 Tc 0 Tw 4.283 0 Td
[( )-2( )]TJ
EMC
/ArtifactSpan <</MCID 2 >>BDC
0.002 Tc -0.002 Tw 0.456 0 Td
[(__)11(___)11(___)11(___)11(___)11(_)11(____)11(___)11(___)11(__)]TJ
0 Tc 0 Tw 13.391 0 Td
( )Tj
EMC
ET
<End Stream>
Proves
Procediment
Per a cada camp de formulari obligatori, verificar que es proporcionen informació de validació i instruccions aplicant el següent:
- Comprovar que la condició d'obligatori s'indica a l'etiqueta del control de formulari.
- Deixar el camp en blanc i enviar el formulari. Comprovar que es proporciona una alerta que descriu l'error.
- Utilitzar una eina que exposi el document a través de l'API d'accessibilitat i verificar que s'indica la propietat d'obligatori.
Resultats esperats
- Les comprovacions núm. 1, núm. 2 i núm. 3 són certes.
Recursos
- Secció 12.7 (Interactive Forms) de PDF 1.7 (ISO 32000-1) (PDF)
- Create and verify PDF accessibility (Acrobat Pro) (crear i verificar 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 PDF5 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.