Përmbajtje
Lista në përmbajtje
A përmban faqja lista me pika ose me numra; mjeti e quan mungesën e tyre shenjë teksti të vështirë për t'u skanuar.
Çfarë është
Ky kontroll shikon nëse faqja përmban të paktën një <ul> ose <ol>.
Listat janë mjeti më i thjeshtë për të kthyer një varg njësish në strukturë të dukshme: hapa, kushte, përbërës, karakteristika. Ato lexohen nga syri pa u lexuar fjalë për fjalë, dhe lexuesit e ekranit i njoftojnë me numrin e elementeve — "listë me gjashtë njësi" — çka i jep dëgjuesit orientim që teksti i rrjedhshëm nuk ia jep.
Kjo nuk do të thotë se çdo faqe duhet të ketë listë. Një ese, një njoftim, një faqe kontakti mund të mos kenë asnjë dhe të jenë të përsosura.
Pse ka rëndësi
Efekti më i prekshëm është te skanueshmëria. Vizitori që kërkon një hap të veçantë e gjen atë në listë brenda sekondash; në një paragraf ai duhet ta lexojë të tërin.
Efekti i dytë është te kërkimi: motorët i nxjerrin listat si përgjigje të drejtpërdrejta te rezultatet — pikërisht sepse struktura është e qartë. Një varg hapash i shkruar si paragraf nuk përzgjidhet dot.
Efekti i tretë është te aksesueshmëria: një listë e shkruar me viza dhe <br> duket si listë por nuk është. Lexuesi i ekranit lexon një paragraf të gjatë me viza brenda, pa asnjë njoftim strukture dhe pa mundësi për të kaluar nga njësia në njësi.
Pra ky kontroll shpesh nuk gjen mungesë listash — gjen lista të shkruara gabim.
Si rregullohet
<!-- e drejtë -->
<ol>
<li>Fike laptopin dhe hiqe karikuesin.</li>
<li>Hiq bateritë nëse janë të lëvizshme.</li>
<li>Prite pesë minuta para se ta hapësh.</li>
</ol>
<!-- e gabuar: duket si listë, nuk është -->
<p>– Fike laptopin<br>– Hiq bateritë<br>– Prit pesë minuta</p>Hapat:
- `<ol>` kur rendi ka rëndësi, `<ul>` kur jo.
- Mos përdor `<br>` dhe viza për të imituar listën.
- Mos i bëj listat me nga një element. Një listë me një njësi njoftohet si listë dhe ngatërron.
- Mos e kthe çdo gjë në listë. Prozë e mirë e ndarë nga lista të vërteta lexohet më mirë se një faqe me vetëm pika.
Si e mat ky mjet
ContentQualityAnalyzer::analyzeStructure() (services/ContentQualityAnalyzer.php:214) kërkon //ul | //ol dhe kthen flamurin has_lists bashkë me numrin. Kur ai flamur është i rremë, jepet një konstatim informativ dhe zbriten 3 pikë (:54).
E njëjta metodë numëron edhe tabela, citime dhe blloqe kodi, por vetëm mungesa e listave prodhon konstatim.
Çfarë NUK e mat
Kontrolli numëron çdo <ul> dhe <ol> në dokument, përfshirë ato të menusë së navigimit dhe të fundfaqes — të cilat janë pothuajse gjithnjë lista. Prandaj në praktikë ky konstatim pothuajse nuk aktivizohet kurrë, edhe kur teksti kryesor nuk ka asnjë listë. Në një shabllon normal me menu, has_lists është gjithnjë i vërtetë.
Nuk bëhet asnjë dallim midis listave brenda <main> dhe atyre të navigimit, dhe nuk kontrollohet as cilësia e listës — një <ul> me një element të vetëm e kalon.
Anasjelltas, listat e imituara me <br> dhe viza — problemi i vërtetë — nuk kapen fare.
Kodi që e kryen matjen
services/ContentQualityAnalyzer.php:214— ContentQualityAnalyzer::analyzeStructureservices/ContentQualityAnalyzer.php:54— has_lists