Addaw, joan hasierara Egin dohaintza

Teknika Teknika orokorrak WCAG 2.2

G224Testuari zentzua ematen dion koska pantaila estuetan gordetzea

Izen ofiziala W3Cn: Testuaren koska esanguratsua eta birmoldaketa (reflow) kontuan hartzea

Versión en castellano · Versió en català

Laburbilduz

Habiaratutako zerrendetan eta kode-zatietan, koskak (lerro bat eskuinera lekualdatzen duen marjinak) adierazten du zer den zeren menpeko. Orria handitzean edo mugikor batean ikustean, koska horrek mantendu egin behar du, baina txikiagoa izan. Horrela, testuak 320 pixeleko zabaleran sartzen jarraitzen du, eta ia ez da beharrezkoa alboetara korritzea.

Zergatik da garrantzitsua

Orria % 400era handitzen duenak 320 pixel zabaleko pantaila batean bezala ikusten du. Gauza bera gertatzen da mugikor txiki batean.

Koska kentzen bada, azpiatalak dituen izapide-zerrenda bat zerrenda laua dirudi. Python kodean, gainera, koska kentzeak programa aldatzen du.

Jatorrizko koska, oso zabala, mantentzen bada, testua pantailatik ateratzen da. Pertsonak ezkerrera eta eskuinera mugitu behar du lerro bakoitzean. Hori nekagarria da, eta haria galarazten du.

Nola egiten da

  1. Identifikatu non transmititzen duen koskak informazioa: habiaratutako zerrendak, hainbat mailatako aurkibideak, kode-blokeak.
  2. Definitu koska unitate malguetan, hala nola em edo rem, eta ez pixel handi eta finkoetan.
  3. Erabili media-kontsultak (@media, pantailaren zabaleraren arabera aldatzen diren CSS arauak) koska pantaila estuetan txikitzeko.
  4. Kodean, txikitu tabuladorearen tamaina tab-size bidez, edo maila bakoitzaren ezkerreko betegarria.
  5. Zerrenda batek maila asko baditu, eman testuari gutxieneko zabalera zentzuzko bat. Maila bakoitza ikusteko alboko korritze bat behar izan daiteke, baina haren barruan nahikoa da behera egitea.
  6. Lerro luzeak zatitzeak kodea hondatzen ez duenean, utzi zatitzen.

Nola egiaztatu

  1. Ireki orria 1280 pixel zabaleko leiho batean, eta handitu % 400era. Nabigatzailearen tresnetako gailu-modua ere balio du (F12), 320 pixeleko zabalerarekin.
  2. Bilatu habiaratutako zerrendak eta kode-blokeak.
  3. Egiaztatu mailak koskaren bidez bereizten direla oraindik.
  4. Egiaztatu testua behera eginez irakurtzen dela, lerro bakoitzean alboetara mugitu gabe. Zerrenda oso sakonetan onartzen da alboko korritze bat maila batera iristeko, baina ez elementu bakoitza irakurtzeko.

Adibidea

Habiaratutako zerrenden eta kodearen koska, pantaila estuetan erdira txikitzen dena, desagertu gabe.

ul ul { padding-left: 2em; }
pre { tab-size: 4; }

@media (max-width: 30em) {
  ul ul { padding-left: 1em; }
  pre { tab-size: 2; }
}
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko G224 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Aplikagarritasuna

Estiloak aldatzea onartzen duten teknologia guztiak

Deskribapena

Kasu batzuetan, testuaren koska garrantzitsutzat jo daiteke testu-edukiaren aurkezpenerako eta ulermenerako. Koskak kenduko balira, esanahia edo funtzionaltasuna kaltetu litezke. Adibidez, ordenatu gabeko zerrenden habiaraketa zailago antzeman daiteke koskak kentzen badira. Gainera, koskak mantentzea garrantzitsua izan daiteke kodearen ereduak ulertzen laguntzeko, edo are ezinbestekoa kodeak funtziona dezan.

Testu-kasu horietan koska mantentzea garrantzitsua denez, baliteke edukiaren atal zehatz horietan bi dimentsioko korritzea beharrezkoa izatea. Hala ere, badira estilo-aldaketak egin daitezkeenak koska gordetzen dela bermatzen laguntzeko eta, aldi berean, ikuspegi-eremuaren (viewport) barruan ahalik eta testu gehien erakusteko. Doikuntza horiek eginez gero, bi dimentsioko korritzea mugatu daiteke, edo are saihestu, eta horrek edukia irakurtzea errazten du.

Adibideak

Webgune batek informazioa habiaratutako zerrenda baten moduan transmititzen du. Zerrendaren hierarkia ulertzeko, haren edukiaren koska hartzen da oinarri. Zerrendako elementu bakoitzaren testua birmoldatzea garrantzitsua bada ere, zerrendaren hierarkia kaltetuta geratuko litzateke lautuko balitz, eduki guztia 320 CSS pixel zabaleko ikuspegi-eremu batean sar zedin.

Ondorengo adibide-zerrendak habiaratutako zerrenda gehigarriak ditu, guraso-zerrendako elementu bakoitzaren testuari testuinguru gehiago ematen diotenak. Hierarkia bisuala mantentzeko, zerrendaren maila bakoitzaren koska gorde egiten da, baina aldatu egiten da egileak definitutako CSS eten-puntu (breakpoint) batera iristean. Eten-puntu desberdinetarako estilo gehigarriak ezartzen dira, edukia 320 pixel zabaleko ikuspegi-eremu batetik haratago hedatzeko aukera arintzeko, eta, aldi berean, ikuspegi-eremuaren ertzekiko tarte bisuala kontuan hartzen da, edukia estu ez geratzen saiatzeko. Eten-puntu txikienean, zerrendako elementuen edukiak gutxieneko zabalera bat jasotzen du, habiaratutako maila asko dituzten zerrendak «zapaltzeko» arriskua arintzeko. Eten-puntu horretan, habiaratutako zerrenda-maila bakoitza ikusgai jar daiteke korritze horizontalaren bidez, eta, habiaratutako zerrenda bat ikuspegi-eremuaren barruan ikusgai dagoenean, korritze bertikala baino ez da beharko haren elementuen edukia irakurtzeko.


<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;
    }
}

Habiaratutako mailak 320 pixel zabaleko ikuspegi-eremu batean irakur daitezkeen zerrenda baten adibide praktikoa.

Kode-zatiak eskaintzen dituen webgune batek lerroen koska mantendu behar du; izan ere, koskak esanguratsuak dira kodearen egiturarako, eta, gainera, hizkuntza batzuetan, Python-en adibidez, nahitaezkoak dira kode-blokeak definitzeko.

Erabiltzaileak web-orria handitu ahala, koskaren CSSa doi daiteke beharrezko egitura hori mantentzeko eta, aldi berean, lerro bakar batean testu gehiago ikusteko.

Ondorengoa Python-eko kode-adibide bat da. Testu-lerro bakoitzaren koska beharrezkoa da bloke gisa exekutatzen diren sententzia-talde bat sortzeko.


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")

Ondorengo kode-adibideak erakusten du nola erabiltzen den koska HTML dokumentu bateko elementuen habiaraketa transmititzeko:


<html lang=en>
	<head>...</head>
	<body>
		<div>
			<!-- ... keep indenting as necessary  -->
		</div>
	</body>
</html>

Horrelako kode-blokeen koska ikuspegi-eremuaren tamaina desberdinetarako doi liteke CSS media-kontsulta (media query) baten bidez.


@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;
	}
}

Eten-puntu desberdinetan koskaren zabalera aldatzeko CSS erabiltzen duten kode-zatien adibide praktikoa.

Probak

Zerrendaren adibiderako prozedura

  1. Erakutsi web-orria orria handitu daitekeen edo tamainaz alda daitekeen erabiltzaile-agente batean.
  2. Handitu nabigatzailearen leihoa edo aldatu haren tamaina, ikuspegi-eremua 320 CSS pixel zabalekoa izan dadin.
  3. Zerrendaren edukia zabalera horretan sartzen da, eta, beraz, bertikalki korritzea baino ez da beharrezkoa zerrenda irakurtzeko.
  4. Edo, bestela, habiaratutako zerrenda bakoitza ikusgai jar daiteke korritze horizontalaren bidez. Korritze bertikala baino ez da beharrezkoa habiaratutako zerrenda-maila zehatz bakoitzaren barruko elementuen edukia irakurtzeko.

Espero diren emaitzak

  • 3. edo 4. egiaztapena egiazkoa da.

Kode-zatietarako prozedura

  1. Erakutsi web-orria orria handitu daitekeen edo tamainaz alda daitekeen erabiltzaile-agente batean.
  2. Handitu nabigatzailearen leihoa edo aldatu haren tamaina, ikuspegi-eremua 320 CSS pixel zabalekoa izan dadin.
  3. Kode-zatiak zabalera horretan sartzen dira, eta, beraz, bertikalki korritzea baino ez da beharrezkoa kode-lerro bakoitza irakurtzeko.
  4. Edo, bestela, lerroak ez doitzea funtsezkoa ez denean, kodea lerrora doitzen da, edo lerro-doikuntza ahalbidetzen duen mekanismo bat ematen da.
  5. Edo, bestela, koska eta lerro-jauziak esanguratsuak dira kodearen hizkuntzarako.

Espero diren emaitzak

  • 3., 4. edo 5. egiaztapena egiazkoa da.

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

W3Cren G224 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.