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

Tècnica Scripts de client WCAG 2.2

SCR19Actualitzar una llista desplegable segons el que s'ha triat en una altra sense canviar de pàgina

Nom oficial al W3C: Utilitzar un esdeveniment onchange en un element select sense provocar un canvi de context

Versión en castellano

En poques paraules

És habitual que, en triar una opció en un desplegable, canviïn les opcions d'un altre, com ara província i municipi. Aquesta tècnica ho fa amb JavaScript sense canviar de pàgina ni moure el focus. El desplegable que canvia va sempre després del que provoca el canvi.

Per què és important

Qui fa servir el teclat recorre les opcions d'un desplegable amb les fletxes. En alguns navegadors, cada fletxa ja compta com un canvi.

Si aquest canvi enviés el formulari o obrís una altra pàgina, la persona en sortiria sense voler. Si actualitza un desplegable que ja ha passat, no s'assabentaria del canvi.

Com es fa

  1. Utilitzeu l'esdeveniment change del primer desplegable només per emplenar el segon. No envieu el formulari ni canvieu de pàgina.
  2. Col·loqueu el desplegable que s'actualitza després del primer, al codi i a la pantalla.
  3. Tingueu a la pàgina les dades necessàries o carregueu-les de manera ràpida i sense moure el focus.
  4. Deixeu el focus on és. La persona trobarà les noves opcions quan avanci amb el tabulador.
  5. Si cal, afegiu un text que expliqui que el segon camp depèn del primer.

Com comprovar-ho

  1. Amb el teclat, trieu una opció al primer desplegable.
  2. Avanceu amb el tabulador fins al segon i comproveu que mostra les opcions correctes.
  3. Torneu al primer i recorreu-ne les opcions amb les fletxes. No ha de canviar de pàgina ni s'ha de moure el focus.
  4. Proveu-ho també amb un lector de pantalla.

Exemple

En triar la província, s'emplena la llista de municipis, que va just després.

<label for="provincia">Província</label>
<select id="provincia">
  <option value="murcia">Múrcia</option>
  <option value="alicante">Alacant</option>
</select>
<label for="municipio">Municipi</label>
<select id="municipio"></select>
<script>
  provincia.addEventListener("change", () => rellenarMunicipios(provincia.value));
</script>
Veure el text complet del W3C (traducció al català)

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

Descripció

L'objectiu d'aquesta tècnica és demostrar com utilitzar correctament un esdeveniment onchange amb un element select per actualitzar altres elements de la pàgina web. Aquesta tècnica no provoca un canvi de context. Quan hi ha un o més elements select a la pàgina web, un esdeveniment onchange en un d'ells pot actualitzar les opcions d'un altre element select de la pàgina web. Totes les dades que necessiten els elements select estan incloses dins de la pàgina web.

És important assenyalar que l'element select que es modifica està situat després de l'element select desencadenant en l'ordre de lectura de la pàgina web. Això garanteix que les tecnologies de suport detectin el canvi i que els usuaris trobin les noves dades quan l'element modificat rebi el focus. Aquesta tècnica depèn de la compatibilitat amb JavaScript de l'agent d'usuari.

Exemples

Aquest exemple conté dos elements select. Quan se selecciona un element al primer select, les opcions de l'altre select s'actualitzen en conseqüència. El primer element select conté una llista de continents. El segon element select contindrà una llista parcial de països situats al continent seleccionat. Hi ha un esdeveniment onchange associat al select de continents. Quan canvia la selecció de continent, els elements del select de països es modifiquen mitjançant JavaScript a través del Document Object Model (DOM). Totes les dades necessàries, la llista de països i de continents, estan incloses dins de la pàgina web.

Resum del codi que figura a continuació

  • Variable de tipus array countryLists, que conté la llista de països de cada continent de l'element select desencadenant.
  • Funció countryChange(), que és cridada per l'esdeveniment onchange de l'element select de continents.
  • El codi HTML per crear els elements select al cos de la pàgina web.
<!doctype html> 
<html lang="en"> 
  <head> 
    <meta charset=utf-8"> 
    <title>Dynamic Select Statements</title> 
    <script>
    // array of possible countries in the same order as they appear
    // in the country selection list 
    var countryLists = new Array(4) 
    countryLists["empty"] = ["Select a Country"]; 
    countryLists["North America"] = ["Canada", "United States", "Mexico"]; 
    countryLists["South America"] = ["Brazil", "Argentina", "Chile", "Ecuador"]; 
    countryLists["Asia"] = ["Russia", "China", "Japan"]; 
    countryLists["Europe"]= ["Britain", "France", "Spain", "Germany"]; 
    /* CountryChange() is called from the onchange event of a select element. 
     * param selectObj - the select object which fired the on change event. 
    */ 
    function countryChange(selectObj) { 
    // get the index of the selected option 
    var idx = selectObj.selectedIndex; 
    // get the value of the selected option 
    var which = selectObj.options[idx].value; 
    // use the selected option value to retrieve the list of items 
    // from the countryLists array 
    cList = countryLists[which]; 
    // get the country select element via its known id 
    var cSelect = document.getElementById("country"); 
    // remove the current options from the country select 
    var len=cSelect.options.length; 
    while (cSelect.options.length > 0) { 
      cSelect.remove(0); 
    } 
    var newOption; 
    // create new options 
    for (var i=0; i<cList.length; i++) { 
      newOption = document.createElement("option"); 
      newOption.value = cList[i];  // assumes option string and value are the same 
      newOption.text=cList[i]; 
   // add the new option 
    try { 
      cSelect.add(newOption);  // this will fail in DOM browsers but is needed for IE 
    } 
    catch (e) { 
      cSelect.appendChild(newOption); 
    } 
  } 
} 
  </script>
</head>
<body>
  <h1>Dynamic Select Statements</h1>
  <label for="continent">Select Continent</label>
  <select id="continent" onchange="countryChange(this);">
    <option value="empty">Select a Continent</option>
    <option value="North America">North America</option>
    <option value="South America">South America</option>
    <option value="Asia">Asia</option>
    <option value="Europe">Europe</option>
  </select>
  <div>
    <label for="country">Select a country</label>
    <select id="country">
      <option value="0">Select a country</option>
    </select>
  </div>
</body>
</html>

Aquí hi ha un exemple pràctic: Dynamic Select (select dinàmic)

Proves

Procediment

  1. Navegar fins a l'element select desencadenant (en aquest exemple, el de selecció de continents) i canviar el valor del select.
  2. Navegar fins a l'element select que actualitza el desencadenant (en aquest exemple, el de selecció de països).
  3. Comprovar que a l'altre element select es mostren els valors d'opció corresponents.
  4. Navegar fins a l'element select desencadenant i recórrer les opcions sense canviar el valor.
  5. Comprovar que a l'element associat es continuen mostrant els valors d'opció corresponents.

Es recomana provar els elements select amb una tecnologia de suport per verificar que es reconeixen els canvis a l'element associat.

Resultats esperats

  • Les comprovacions núm. 3 i núm. 5 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 SCR19 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.