Tècnica Tècniques generals WCAG 2.2
G224Conservar el sagnat que dona sentit al text en pantalles estretes
Nom oficial al W3C: Tenir en compte el sagnat significatiu del text i el reajustament (reflow)
En poques paraules
En llistes imbricades i fragments de codi, el sagnat (el marge que desplaça una línia cap a la dreta) indica què depèn de què. En ampliar la pàgina o veure-la en un mòbil, aquest sagnat s'ha de mantenir, però més petit. Així el text continua cabent en 320 píxels d'amplada i gairebé no cal desplaçar-se cap als costats.
Per què és important
Qui amplia la pàgina al 400 % la veu com en una pantalla de 320 píxels d'amplada. El mateix passa en un mòbil petit.
Si es treu el sagnat, una llista de tràmits amb subapartats sembla una llista plana. En codi Python, a més, treure el sagnat canvia el programa.
Si es manté el sagnat original, molt ample, el text surt de la pantalla. La persona s'ha de moure a esquerra i dreta a cada línia. Això cansa i fa perdre el fil.
Com es fa
- Identifiqueu on el sagnat transmet informació: llistes imbricades, índexs de diversos nivells, blocs de codi.
- Definiu el sagnat en unitats flexibles, com ara
emorem, i no en píxels grans i fixos. - Utilitzeu consultes de mitjans (
@media, regles CSS que canvien segons l'amplada de la pantalla) per reduir el sagnat en pantalles estretes. - En el codi, reduïu la mida del tabulador amb
tab-sizeo el farciment esquerre de cada nivell. - Si una llista té molts nivells, doneu al text una amplada mínima raonable. Cada nivell pot necessitar un desplaçament lateral per veure'l, però dins seu n'hi ha prou de baixar.
- Quan partir les línies llargues no espatlli el codi, permeteu que es parteixin.
Com comprovar-ho
- Obriu la pàgina en una finestra de 1280 píxels d'amplada i amplieu-la al 400 %. També serveix el mode de dispositiu de les eines del navegador (F12) amb 320 píxels d'amplada.
- Busqueu les llistes imbricades i els blocs de codi.
- Comproveu que els nivells es continuen distingint pel sagnat.
- Comproveu que el text es llegeix baixant, sense moure-us cap als costats a cada línia. En llistes molt profundes s'accepta un desplaçament lateral per arribar a un nivell, però no per llegir cada element.
Exemple
Sagnat de llistes imbricades i de codi que es redueix a la meitat en pantalles estretes, sense desaparèixer.
ul ul { padding-left: 2em; }
pre { tab-size: 4; }
@media (max-width: 30em) {
ul ul { padding-left: 1em; }
pre { tab-size: 2; }
}
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica G224 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
Totes les tecnologies que admetin el canvi d'estils
Descripció
Hi pot haver casos en què el sagnat del text es consideri important per a la presentació i la comprensió del contingut textual. Si s'eliminessin els sagnats, el significat o la funcionalitat se'n podrien veure perjudicats. Per exemple, la imbricació de llistes no ordenades pot ser més difícil d'apreciar si s'eliminen els sagnats. A més, mantenir els sagnats pot ser important per ajudar a entendre els patrons del codi, si no imprescindible perquè el codi funcioni.
Atès que mantenir el sagnat és important en aquests casos de text, podria ser necessari el desplaçament en dues dimensions d'aquestes seccions concretes del contingut. No obstant això, continuen existint modificacions d'estil que es poden fer per ajudar a garantir que el sagnat es conservi i que, alhora, es mostri la major quantitat de text possible dins de l'àrea de visualització. Fer aquests ajustos pot limitar, si no evitar, el desplaçament en dues dimensions, cosa que facilita la lectura del contingut.
Exemples
Un lloc web transmet informació en forma de llista imbricada. La comprensió de la jerarquia de la llista es basa en el sagnat del seu contingut. Tot i que és important que el text de cada element de la llista es reajusti, la jerarquia de la llista es veuria perjudicada si s'aplanés perquè tot el contingut cabés en una àrea de visualització de 320 píxels CSS d'amplada.
La llista d'exemple següent conté llistes imbricades addicionals que aporten més context al text de cada element de la llista pare. Per mantenir la jerarquia visual, el sagnat de cada nivell de la llista es conserva, però es modifica quan s'arriba a un punt de ruptura (breakpoint) CSS definit per l'autor. S'estableixen estils addicionals per a diferents punts de ruptura amb la finalitat de mitigar la possibilitat que el contingut s'estengui més enllà d'una àrea de visualització de 320 píxels d'amplada, tenint en compte alhora l'espaiat visual respecte a les vores de l'àrea de visualització per intentar que el contingut no resulti atapeït. En el punt de ruptura més petit, el contingut dels elements de la llista rep una amplada mínima per mitigar el possible «aixafament» de les llistes amb molts nivells imbricats. En aquest punt de ruptura, cada nivell de llista imbricada es pot portar a la vista mitjançant desplaçament horitzontal i, un cop una llista imbricada és visible dins de l'àrea de visualització, només caldrà el desplaçament vertical per llegir el contingut dels seus elements.
<div class="example">
<ul>
<li>
<p>Make a list using one of the HTML list elements, or even an ARIA <code>role=list</code> container.</p>
<ul>
<li>
<p>There are three types of lists in HTML which can contain list items (<code>li</code> elements).</p>
<ul>
<li><p>the <code>ul</code> element</li>
<li><p>the <code>ol</code> element</li>
<li><p>the <code>menu</code> element</li>
</ul>
</li>
<li>
<p>Another type of list, description lists, exist as well - but they do not contain list items (<code>li</code> elements).</p>
</li>
...
</ul>
</li>
<li>
<p>Neither the start or end tags of any of the HTML list elements are omissible.</p>
<ul>
<li><p>The end tags of <code>li</code> elements can be omitted if the <code>li</code> element is immeditely followed by another <code>li</code> element or there is no more content in the parent list element.</p>
</li>
...
</ul>
</li>
...
</ul>
</div>
*, *::before, *::after {
box-sizing: border-box;
}
body, html {
font-family: arial;
}
@media screen and ( max-width: 640px ) {
.example {
overflow: auto;
max-width: 640px;
}
ul {
padding-inline-start: 1.25em;
}
li p {
padding: .25em;
margin: .5em 0 .5em -.25em;
max-width: 300px; /* saftey net for max-width */
}
}
@media screen and ( max-width: 400px ) {
ul { padding-inline-start: 1em; }
li p { min-width: 300px } {
min-width: 300px;
}
}
Un exemple pràctic d'una llista els nivells imbricats de la qual es poden llegir en una àrea de visualització de 320 píxels d'amplada.
Un lloc web que ofereix fragments de codi necessita mantenir el sagnat de les línies, ja que els sagnats són significatius no només per a l'estructura del codi, sinó que en alguns llenguatges, com ara Python, són obligatoris per definir blocs de codi.
A mesura que l'usuari amplia la pàgina web, el CSS del sagnat es pot ajustar per mantenir aquesta estructura necessària i permetre, alhora, que es vegi més text en una sola línia.
El que segueix representa un exemple de codi en Python. El sagnat de cada línia de text és necessari per crear un grup de sentències que s'executen com un bloc.
def complex_function(x):
if x > 0:
for i in range(x):
if i % 2 == 0:
print(f"{i} is even")
for a in range(i):
if a % 5 == 0:
print(f" {a} can be divided by 5")
else:
print(f" {a} cannot be divided by 5")
else:
print(f"{i} is odd")
for a in range(i):
if a % 2 == 0:
print(f" {a} is even")
else:
print(f" {a} is odd")
else:
print("x is not a positive number")
L'exemple de codi següent mostra l'ús del sagnat per transmetre la imbricació dels elements en un document HTML:
<html lang=en>
<head>...</head>
<body>
<div>
<!-- ... keep indenting as necessary -->
</div>
</body>
</html>
El sagnat de blocs de codi com aquests es podria ajustar per a diferents mides d'àrea de visualització mitjançant una consulta de mitjans (media query) CSS.
@media screen and ( min-width: 320px ) {
pre {
tab-size: 8px;
}
}
@media screen and ( min-width: 640px ) {
pre {
tab-size: 16px;
}
}
@media screen and ( min-width: 1280px ) {
pre {
tab-size: 32px;
}
}
Un exemple pràctic de fragments de codi que utilitzen CSS per modificar l'amplada del sagnat en diferents punts de ruptura.
Proves
Procediment per a l'exemple de la llista
- Mostrar la pàgina web en un agent d'usuari en què la pàgina es pugui ampliar o l'agent d'usuari pugui canviar de mida.
- Ampliar o canviar la mida de la finestra del navegador de manera que l'àrea de visualització equivalgui a 320 píxels CSS d'amplada.
- El contingut de la llista cap en aquesta amplada, de manera que només cal desplaçar-se verticalment per llegir la llista.
- O bé, cada llista imbricada es pot portar a la vista mitjançant desplaçament horitzontal. Només cal el desplaçament vertical per llegir el contingut dels elements de la llista dins de cada nivell concret de llista imbricada.
Resultats esperats
- La comprovació núm. 3 o la núm. 4 és certa.
Procediment per als fragments de codi
- Mostrar la pàgina web en un agent d'usuari en què la pàgina es pugui ampliar o l'agent d'usuari pugui canviar de mida.
- Ampliar o canviar la mida de la finestra del navegador de manera que l'àrea de visualització equivalgui a 320 píxels CSS d'amplada.
- Els fragments de codi caben en aquesta amplada, de manera que només cal desplaçar-se verticalment per llegir cada línia de codi.
- O bé, quan no sigui essencial que les línies no s'ajustin, el codi s'ajusta a la línia o es proporciona un mecanisme que permet l'ajust de línia.
- O bé, el sagnat i els salts de línia són significatius per al llenguatge del codi.
Resultats esperats
- La comprovació núm. 3, la núm. 4 o la núm. 5 és certa.
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 G224 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.