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

Tècnica ARIA WCAG 2.2

ARIA2Marcar els camps obligatoris amb aria-required

Nom oficial al W3C: Identificar un camp obligatori amb la propietat aria-required

Versión en castellano · Irakurri fitxa hau euskaraz

En poques paraules

Quan un formulari assenyala un camp obligatori amb un asterisc, un color o la paraula «obligatori», l'atribut aria-required="true" transmet aquesta dada al lector de pantalla. Així també ho sap qui no veu la marca. L'avís visible hi ha de continuar: aria-required tot sol no n'hi ha prou.

Per què és important

L'asterisc vermell o la vora de color només es veuen. Un lector de pantalla (programa que llegeix en veu alta la pantalla) pot saltar-se l'asterisc o dir «asterisc» i prou.

Si ningú no l'avisa, la persona envia incomplet el formulari de cita prèvia i rep errors. Amb aria-required="true", el lector anuncia «obligatori» en arribar al camp, abans d'emplenar-lo.

Com es fa

  1. Indiqueu de manera visible quins camps són obligatoris: un asterisc, la paraula «obligatori» o totes dues coses. Expliqueu l'asterisc al principi del formulari.
  2. Afegiu aria-required="true" a cada camp obligatori, i només a aquests.
  3. En controls fets a mida, com ara un grup d'opcions amb role="radiogroup", poseu l'atribut a l'element que agrupa les opcions.
  4. En camps HTML normals també serveix l'atribut required. A més d'avisar el lector, activa la validació del navegador.
  5. Si un camp deixa de ser obligatori segons una altra resposta, canvieu el valor a false amb JavaScript.

Com comprovar-ho

  1. Localitzeu tots els camps que es mostren com a obligatoris.
  2. Reviseu al codi que cadascun té aria-required="true" o required, i que els opcionals no en tenen.
  3. Amb les eines del navegador (F12, tauler «Accessibilitat»), confirmeu que el camp hi figura com a obligatori («required»).
  4. Recorreu el formulari amb NVDA o VoiceOver. A cada camp obligatori heu de sentir «obligatori» o «requerit».

Exemple

Camp obligatori d'un formulari de cita prèvia, marcat amb asterisc i amb aria-required.

<p>Els camps marcats amb * són obligatoris.</p>
<label for="dni">DNI o NIE *</label>
<input type="text" id="dni" aria-required="true">
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA2 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

Tecnologies compatibles amb Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és reforçar la indicació per programari que un camp de formulari (que es mostra com a obligatori mitjançant la presentació) és imprescindible perquè el formulari es pugui enviar correctament.

El fet que l'element sigui obligatori se sol presentar visualment (mitjançant un símbol textual o no textual, un text que indica que l'entrada és obligatòria, o bé color o estils), però això pot no ser determinable per programari com a part del nom del camp.

La propietat aria-required de WAI-ARIA indica que cal l'entrada de l'usuari abans de l'enviament. La propietat aria-required pot tenir els valors true o false. Per exemple, si l'usuari ha d'emplenar un camp d'adreça, aria-required s'estableix en true.

Aquesta tècnica es considera recomanada per complir el criteri 3.3.2 Etiquetes o instruccions, perquè l'ús d'aria-required="true" tot sol, sense cap indicador visual, no seria perceptible per a la majoria dels usuaris.

Tanmateix, quan el camp porta associat un asterisc o un altre símbol textual, utilitzar la propietat aria-required a més de la presentació visual permet que els agents d'usuari transmetin aquesta informació important a l'usuari de la manera pròpia de cada agent d'usuari. Consulteu ARIA in HTML per obtenir informació sobre com proporcionar estats i propietats de WAI-ARIA amb HTML. Els estats i les propietats de WAI-ARIA també són compatibles amb altres llenguatges; consulteu la documentació d'aquests llenguatges.

Exemples

La propietat required s'indica amb un asterisc col·locat dins de l'element label

<form>
  <p>Note: * denotes a required field</p>
  <div>
    <label for="usrname">Login name *:</label>
    <input aria-required="true" autocomplete="username" id="usrname" type="text">
  </div>
  <div>
    <label for="pwd">Password *:</label>
    <input aria-required="true" autocomplete="current-password" 
     id="pwd" type="password">
  </div>
  <div>
    <input type="submit" value="Login">
  </div>
</form>

La propietat required s'indica amb la paraula "required" (obligatori) col·locada al costat de l'element label

<form>
  <div>
    <label for="fname">First name:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="given-name" id="fname" type="text">
  </div>
  <div>
    <label for="mname">Middle name:</label> <span>(required)</span>
    <input autocomplete="additional-name" id="mname" type="text">
  </div>
  <div>
    <label for="lname">Last name:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="family-name" id="lname" type="text">
  </div>
  <div>
    <label for="email">Email address:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="email" id="email" type="text">
  </div>
  <div>
    <label for="zip_post">Zip / Postal code:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="postal-code" id="zip_post" type="text">
  </div>
  <div>
    <input type="submit" value="Next Step">
  </div>
</form>

Els camps obligatoris s'indiquen amb una vora vermella al voltant dels camps i una icona d'estrella generada mitjançant CSS amb ::after

Aquest exemple utilitza botons d'opció personalitzats amb role=radio. Les propietats CSS estan disponibles sota el formulari.

<form>
  <label data-required="true" for="acctnum">Account Number</label>
  <input aria-required="true" id="acctnum" type="text">
  <p data-required="true" id="radio_label">
    Please send an alert when balance exceeds $3,000.
  </p>
  <ul aria-required="true" aria-labelledby="radio_label" role="radiogroup">
    <li aria-checked="false" id="rb1" role="radio" tabindex="0">Yes</li>
    <li aria-checked="false" id="rb2" role="radio" tabindex="-1">No</li>
  </ul>
</form>

Definició d'estils CSS corresponent a aquest exemple:

[aria-required=true] {
  border: red thin solid;
}
[data-required=true]::after {
  content: url('/iconStar.gif');
}

Proves

Procediment

Per a cada control que es mostra com a obligatori mitjançant la presentació.

  1. Comprovar si hi ha l'atribut aria-required:
  2. Comprovar si el valor de l'atribut aria-required es correspon amb l'estat d'obligatorietat correcte del component de la interfície d'usuari.

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 són certes

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 ARIA2 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.