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

Tècnica ARIA WCAG 2.2

ARIA21Marcar els camps amb errors amb aria-invalid

Nom oficial al W3C: Utilitzar aria-invalid per indicar un camp amb error

Versión en castellano

En poques paraules

Quan un camp de formulari no supera la validació, s'hi afegeix aria-invalid="true". Aleshores el lector de pantalla anuncia que la dada no és vàlida. L'ideal és enllaçar també el missatge d'error amb aria-describedby, perquè se senti què falla i com arreglar-ho.

Per què és important

Molts webs marquen els errors només amb una vora vermella. Qui no hi veu bé o no distingeix colors no sap quin camp falla.

Amb aria-invalid="true", el lector de pantalla diu «no vàlid» en arribar al camp. Si, a més, el missatge està enllaçat, la persona sent, per exemple, «Correu electrònic, no vàlid, falta l'arrova».

Com es fa

  1. No poseu aria-invalid="true" en carregar la pàgina. Afegiu-lo només quan el camp no hagi superat la validació.
  2. Traieu-lo, o canvieu-lo a "false", tan bon punt la dada sigui correcta.
  3. Escriviu al costat del camp un missatge d'error visible que digui què falla.
  4. Enllaceu el missatge amb el camp: doneu-li un id i afegiu al camp aria-describedby amb aquest id.
  5. No confieu només en el color. Incloeu-hi text o una icona amb text alternatiu.

Com comprovar-ho

  1. Carregueu la pàgina i comproveu que cap camp no té encara aria-invalid="true".
  2. Envieu el formulari amb dades buides o mal escrites. Els camps que fallen han de passar a aria-invalid="true".
  3. Corregiu una dada i comproveu que l'atribut desapareix o torna a "false".
  4. Amb un lector de pantalla, aneu a un camp amb error. Ha d'anunciar «no vàlid» i el text de l'error.

Exemple

Camp d'adreça electrònica després de no superar la validació, amb el seu missatge d'error enllaçat.

<label for="correo">Correu electrònic</label>
<input type="email" id="correo"
       aria-invalid="true" aria-describedby="error-correo">
<p id="error-correo">
  Error: falta l'arrova (@). Exemple: nom@domini.cat
</p>
Veure el text complet del W3C (traducció al català)

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

HTML amb Accessible Rich Internet Applications.

Descripció

Aquesta tècnica mostra com es pot utilitzar aria-invalid per identificar els camps que no han superat la validació. L'atribut aria-invalid es pot utilitzar com a part d'un patró de validació personalitzat, en lloc d'utilitzar l'atribut required d'HTML juntament amb tipus d'entrada específics (per exemple: type="email").

L'atribut aria-invalid no s'ha d'establir en "true" abans que es faci la validació de l'entrada. Establir aria-invalid en "false" equival a no posar l'atribut en el control de formulari.

Exemples

Utilitzar aria-invalid en camps obligatoris

L'atribut aria-invalid s'utilitza en els camps obligatoris que són buits quan s'envia el formulari. Un missatge situat damunt del formulari indica a l'usuari que hi ha camps de formulari que s'han d'emplenar.

HTML:
<form name="signup" id="signup" method="post" action="">
  <p id="errors" aria-live="assertive"></p>
  <div>
    <label for="first">First Name (required)</label>
    <input aria-invalid="false" autocomplete="given-name" id="first" name="first" type="text">
  </div>
  <div>
    <label for="last">Last Name (required)</label>
    <input aria-invalid="false" autocomplete="family-name" id="last" name="last" type="text">
  </div>
  <div>
    <label for="email">Email (required)</label>
    <input aria-invalid="false" autocomplete="email" id="email" name="email" type="text">
  </div>
  <div>
    <button id="button" type="submit">Sign Up</button>
  </div>
</form>
CSS:
label.failed {
  background:#CE0000;
  color:#fff;
}
JavaScript:

Aquestes són les dues funcions JavaScript que estableixen l'atribut aria-invalid="true" i després creen el missatge d'error de validació:

const requiredFields = ['first', 'last', 'email'];
let errorCount = 0;
requiredFields.forEach(fieldId => {
  const field = document.getElementById(fieldId);
  if (field.value.trim() === '') {
    field.setAttribute('aria-invalid', 'true');
    document.querySelector(`label[for='${fieldId}']`).classList.add('failed');
    errorCount++;
  }
});
if (errorCount > 0) {
  errText.textContent = `Please complete all ${errorCount} required ${errorCount === 1 ? 'field' : 'fields'} and retry`;
}

Exemple funcional: utilitzar aria-invalid en camps obligatoris.

Identificar errors en el format de les dades

En aquest exemple, aria-invalid i aria-describedby s'utilitzen conjuntament per indicar un error quan el número d'identificació personal (PIN), l'adreça electrònica o la data d'inici no tenen el format esperat. El missatge d'error s'associa al camp mitjançant aria-describedby, i aria-invalid facilita trobar per programari els camps amb errors.

Característiques

  • Afegeix un atribut aria-invalid="true" a un camp de formulari si falten les dades introduïdes o no tenen el format esperat:
    • El PIN conté menys de 4 caràcters;
    • L'adreça electrònica no compleix el format requerit;
    • El cognom ha de contenir almenys dues lletres;
    • La data d'inici de la pòlissa és anterior a la data d'avui.
  • Mostra un missatge d'error que es connecta per programari amb el camp de formulari corresponent mitjançant l'atribut aria-describedby.
HTML:
<div class="control">
  <label for="pin4">PIN * (4 digits)</label>
  <input id="pin4" name="pin4" pattern="\d{4}" size="4" type="text" aria-describedby="pin4-errormsg" aria-invalid="true" class="error">
  <span class="errtext" id="pin4-errormsg">Error: PIN is required</span>
</div>
CSS:
.error {
  border: #CE0000 thin solid;
}
.errtext {
  background: #EEEEFF url('error-icon.svg') no-repeat right 0.25em center;
  color:#CE0000;
  display:block;
  margin-bottom: 1em;
  max-width: fit-content;
  padding: .25em 1.6em .25em .25em;
}
JavaScript:

Cal JavaScript per afegir els atributs aria-invalid, aria-describedby i class, així com per afegir el text de l'error. Aquesta funció és la part rellevant de l'script de validació complet:

function addFieldError(field, message) {
  const errId = field.id + '-errormsg';
  const errDiv = document.createElement('div');
  errDiv.className = 'errtext';
  errDiv.id = errId;
  errDiv.textContent = message;
  field.parentNode.appendChild(errDiv);
  field.setAttribute('aria-describedby', errId);
  field.setAttribute('aria-invalid', 'true');
  field.classList.add('error');
}

Exemple funcional: identificar errors en el format de les dades.

Proves

Procediment

Per a cada control de formulari que depengui d'aria-invalid per transmetre un error de validació:

  1. Comprovar que aria-invalid no està establert en true quan no hi ha cap error de validació.
  2. Comprovar que aria-invalid està establert en true quan sí que hi ha un error de validació.
  3. Comprovar que les etiquetes associades per programari o el text d'instruccions associat per programari al camp proporcionen prou informació per entendre l'error.

Resultats esperats

  • Les comprovacions núm. 1 a núm. 3 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 ARIA21 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.