Tècnica HTML WCAG 2.2
H71Agrupar camps de formulari relacionats amb fieldset i legend
Nom oficial al W3C: Proporcionar una descripció per als grups de controls de formulari amb els elements fieldset i legend
En poques paraules
Quan diversos camps responen a la mateixa pregunta, com les opcions «Sí» i «No», s'agrupen amb fieldset. La pregunta s'escriu a legend. Així el lector de pantalla anuncia la pregunta en entrar al grup, i cada opció té sentit encara que se senti sola.
Per què és important
A la vista, la pregunta i les seves opcions formen un bloc. Però un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) anuncia cada camp per separat. Si un formulari té tres preguntes de «Sí / No», la persona només sent «Sí» o «No», sense saber a què respon.
Amb <fieldset> i <legend>, el lector diu la pregunta en entrar al grup. Això ajuda en enquestes, en formularis de cita prèvia o en separar les dades d'enviament i de facturació.
Com es fa
- Envolteu cada grup de botons d'opció o de caselles relacionades en un
<fieldset>. - Poseu la pregunta o el nom del grup en un
<legend>, com a primer element delfieldset. - Manteniu un
<label>a cada camp: ellegendno el substitueix. - Escriviu un
legendcurt, perquè alguns lectors el repeteixen a cada camp. - Si no us agrada la vora, canvieu-ne l'aspecte amb CSS. No elimineu el
fieldset.
Exemple pràctic
Cal en formularis amb diverses preguntes de «Sí / No» o amb grups de caselles, com una cita prèvia o una enquesta. Aquí l'etiqueta de cada opció no diu, per si sola, a quina pregunta pertany.
Així no: Preguntes en paràgrafs solts
Cada pregunta és un p i cada grup és un div. A la vista s'entén. Però amb el tabulador i el lector de pantalla només se sent «Sí, botó d'opció» o «No, botó d'opció». No se sap a quina pregunta correspon.

La demostració conté, a propòsit, l'error d'accessibilitat que s'explica.
Mostra el codi de l'exemple incorrecte
<style>
.grupo { border: 1px solid #767676; padding: 4px 12px 8px; margin: 0 0 12px; }
.pregunta { font-weight: bold; margin: 4px 0; }
</style>
<form action="#">
<div class="grupo">
<p class="pregunta">És la vostra primera visita a l'oficina?</p>
<input type="radio" name="primera" id="primera-si" value="si">
<label for="primera-si">Sí</label>
<input type="radio" name="primera" id="primera-no" value="no">
<label for="primera-no">No</label>
</div>
<div class="grupo">
<p class="pregunta">Voleu rebre un recordatori per SMS?</p>
<input type="radio" name="sms" id="sms-si" value="si">
<label for="sms-si">Sí</label>
<input type="radio" name="sms" id="sms-no" value="no">
<label for="sms-no">No</label>
</div>
<button type="submit">Confirma la cita</button>
</form>Així sí: fieldset i legend a cada pregunta
Cada div passa a ser un fieldset, i cada pregunta, un legend col·locat com a primer fill del grup. L'aspecte es manté amb CSS. El lector de pantalla anuncia la pregunta en entrar al grup, i així «Sí» i «No» tenen context.
Proveu-ho aquí:
Mostra el codi de l'exemple correcte
<style>
.grupo { border: 1px solid #767676; padding: 4px 12px 8px; margin: 0 0 12px; }
.pregunta { font-weight: bold; margin: 4px 0; padding: 0 4px; }
</style>
<form action="#">
<fieldset class="grupo">
<legend class="pregunta">És la vostra primera visita a l'oficina?</legend>
<input type="radio" name="primera" id="primera-si" value="si">
<label for="primera-si">Sí</label>
<input type="radio" name="primera" id="primera-no" value="no">
<label for="primera-no">No</label>
</fieldset>
<fieldset class="grupo">
<legend class="pregunta">Voleu rebre un recordatori per SMS?</legend>
<input type="radio" name="sms" id="sms-si" value="si">
<label for="sms-si">Sí</label>
<input type="radio" name="sms" id="sms-no" value="no">
<label for="sms-no">No</label>
</fieldset>
<button type="submit">Confirma la cita</button>
</form>Com comprovar-ho
Errors freqüents en auditories
- Preguntes de «Sí / No» o escales de valoració maquetades amb div i p, sense fieldset ni legend.
- Un fieldset amb la pregunta dins d'un h3 o un p, i sense legend. El grup es queda sense nom.
- Treure el fieldset per eliminar la vora que posa el navegador, en lloc de canviar-ne l'estil amb CSS.
- Niar fieldset sense necessitat (un per a tot el formulari i un altre per a cada camp). Els anuncis es fan més llargs.
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica H71 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
Descripció
L'objectiu d'aquesta tècnica és proporcionar una agrupació semàntica als controls de formulari relacionats. Això permet als usuaris comprendre la relació entre els controls i interactuar amb el formulari amb més rapidesa i eficàcia.
Els controls de formulari es poden agrupar tancant-los dins de l'element fieldset. Tots els controls dins d'un fieldset determinat queden així relacionats. El primer element dins del fieldset ha de ser un element legend, que proporciona una etiqueta o descripció per al grup. Els autors han d'evitar niar elements fieldset innecessàriament, ja que pot generar confusió.
Agrupar els controls és especialment important en el cas dels botons d'opció i les caselles de selecció relacionats. Un conjunt de botons d'opció o de caselles de selecció està relacionat quan tots envien valors per a un mateix camp amb nom. Funcionen de la mateixa manera que les llistes de selecció, ja que permeten a l'usuari triar entre un conjunt d'opcions, amb la diferència que les llistes de selecció són un únic control, mentre que els botons d'opció i les caselles de selecció són diversos controls. L'etiqueta individual associada a cada botó d'opció o casella de selecció pot no transmetre completament el context descriptiu del grup. En aquesta situació és essencial agrupar-los semànticament per facilitar que es tractin com un únic control, així com per proporcionar una descripció addicional a nivell de grup. Sovint, els agents d'usuari presenten el valor del legend abans de l'etiqueta de cada control per oferir aquesta descripció i, a més, per recordar als usuaris que formen part del mateix grup.
També pot ser útil agrupar altres conjunts de controls menys estretament relacionats que els botons d'opció i les caselles de selecció. Per exemple, diversos camps que recullen l'adreça d'un usuari es podrien agrupar amb un legend «Adreça», i així es proporcionaria una descripció a nivell de grup per a aquests controls. Com a regla general, es pot dir que quan un grup de controls dins d'un formulari més ampli necessita un encapçalament addicional que ofereixi una descripció específica d'aquest grup concret, l'ús dels elements fieldset i legend és apropiat.
Tanmateix, quan un grup de botons d'opció o caselles de selecció relacionats (fins i tot amb valors per a un mateix camp amb nom) inclou instruccions clares i opcions ben diferenciades (és a dir, quan l'etiqueta individual associada a cada control concret proporciona una descripció suficient), no cal utilitzar els elements fieldset i legend. En aquest cas, H44 és suficient.
De vegades els autors eviten utilitzar l'element fieldset per la seva presentació predeterminada al navegador, que dibuixa una vora al voltant dels controls agrupats. Aquesta agrupació visual també és útil, i els autors haurien de considerar seriosament conservar-la (o alguna forma d'agrupació visual). L'efecte visual es pot modificar amb CSS sobreescrivint la propietat border del fieldset i la propietat position del legend.
Exemples
Un examen tipus test
Aquest exemple mostra una pregunta d'examen amb una qüestió i cinc respostes possibles. Cada resposta es representa amb un botó d'opció (input type="radio"). Els botons d'opció estan continguts dins d'un fieldset. La pregunta de l'examen es marca amb l'element legend. Cada camp té el mateix atribut name, la qual cosa indica que aquests botons d'opció estan relacionats i s'han d'agrupar com es mostra. Observeu també que, encara que els atributs name tenen el mateix valor, els valors dels atributs id han de ser únics.
<fieldset>
<legend>The play <cite>Hamlet</cite> was written by:</legend>
<div>
<input checked="checked" id="shakesp" name="hamlet" type="radio" value="a">
<label for="shakesp">William Shakespeare</label>
</div>
<div>
<input id="austen" name="hamlet" type="radio" value="b">
<label for="austen">Jane Austen</label>
</div>
<div>
<input id="gbshaw" name="hamlet" type="radio" value="c">
<label for="gbshaw">George Bernard Shaw</label>
</div>
<div>
<input id="woolf" name="hamlet" type="radio" value="d">
<label for="woolf">Virginia Woolf</label>
</div>
<div>
<input id="dickens" name="hamlet" type="radio" value="e">
<label for="dickens">Charles Dickens</label>
</div>
</fieldset>
Un conjunt de caselles de selecció
La pàgina de perfil d'usuari d'un lloc web permet als usuaris indicar els seus interessos marcant diverses caselles de selecció. Cada casella de selecció (input type="checkbox") té un label. Les caselles de selecció estan contingudes dins d'un fieldset, i l'element legend conté la indicació per a tot el grup de caselles.
<fieldset>
<legend>I am interested in the following (check all that apply):</legend>
<div>
<input id="photo" name="interests" type="checkbox" value="ph">
<label for="photo">Photography</label>
</div>
<div>
<input checked="checked" id="watercol" name="interests" type="checkbox" value="wa">
<label for="watercol">Watercolor</label>
</div>
<div>
<input checked="checked" id="acrylic" name="interests" type="checkbox" value="ac">
<label for="acrylic">Acrylic</label>
</div>
</fieldset>
Controls relacionats lògicament
En aquest exemple, els camps de formulari de l'adreça de residència i de l'adreça postal es distingeixen pel valor del legend de cada agrupació fieldset.
<form action="/adduser" method="post">
<fieldset>
<legend>Your Residential Address</legend>
<div>
<label for="raddress">Address:</label>
<input autocomplete="street-address" id="raddress" name="raddress" type="text">
</div>
<div>
<label for="rzip">Postal/Zip Code:</label>
<input autocomplete="postal-code" id="rzip" name="rzip" type="text">
</div>
</fieldset>
<fieldset>
<legend>Your Postal Address</legend>
<div>
<label for="paddress">Address:</label>
<input autocomplete="street-address" id="paddress" name="paddress" type="text">
</div>
<div>
<label for="pzip">Postal/Zip Code:</label>
<input autocomplete="postal-code" id="pzip" name="pzip" type="text">
</div>
</fieldset>
</form>
Proves
Procediment
Per als grups de controls relacionats en què les etiquetes individuals de cada control no proporcionen una descripció suficient i es necessita una descripció addicional a nivell de grup:
- Comprovar que el grup d'elements
inputoselectrelacionats lògicament està contingut dins d'elementsfieldset. - Comprovar que cada
fieldsetté un elementlegendque és el primer fill delfieldseti inclou una descripció d'aquest grup.
Resultats esperats
- Totes les comprovacions 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.
Basat en la tècnica H71 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.