Vlastné zoznamy: Schéma položky, obmedzenia a príklady

Vlastný zoznam je opakovateľná kolekcia položiek, ktoré zdieľajú malú schému polí. Každá položka môže mať názov, stručný súhrn, jednu alebo dve metadátové hodnoty a cieľový odkaz. Táto štruktúra poskytuje čitateľom viac kontextu ako zoznam s odrážkami bez toho, aby sa každá položka správala ako samostatná produktová karta .

Príklad — podporované exportné formáty

• CSV — Tabuľkové riadky pre analýzu v tabuľkovom procesore. Najlepšie pre ploché záznamy. Dostupnosť: Všetky plány. Akcia: Zobraziť nastavenie CSV exportu.
• JSON — Vnorené záznamy pre aplikácie a dátové pipelines. Najlepšie pre zachovanie vzťahov medzi poľami. Dostupnosť: Pro a Enterprise. Akcia: Prečítať JSON referenciu.
• Google Sheets — Synchronizovaný hárok pre tímy, ktoré kontrolujú dáta bez kódu. Dostupnosť: Pro a Enterprise. Akcia: Pripojiť Google Sheets.

Vykreslený prvok by nemal byť dekoratívnou verziou týchto odrážok. Mal by zobraziť jednu kolekciu obsahujúcu tri položky a každá položka by mala zachovať rovnaké polia title, summary, bestFor, availability a url. Model polí — nie okraj, ikona alebo počet stĺpcov — robí zoznam vlastným.

Prečo je tento prvok dôležitý

Bežný text skrýva opakovanie. Ak je šesť integrácií opísaných v šiestich odsekoch, čitateľ musí zistiť, že každý odsek obsahuje názov systému, podporovanú akciu, požiadavku na účet a odkaz na nastavenie. Vlastný zoznam pomenúva tieto opakujúce sa časti prostredníctvom jednej schémy položky: definovanej sady polí používaných každou položkou. Čitatelia sa naučia vzor po prvom vstupe a môžu predvídateľne skenovať ďalšie vstupy.

Táto konzistentnosť tiež zlepšuje opätovné použitie. Systém správy obsahu môže overiť povinné polia, šablóna môže vykresliť každú položku bez značkovania špecifického pre stránku a downstream aplikácia môže transformovať rovnaký zdroj do kompaktného mobilného zoznamu alebo prehľadávateľného adresára. Vyhľadávače a AI systémy dostanú diskrétne hranice položiek, namiesto toho, aby museli odvodzovať, kde jedna entita končí a druhá začína.

Prvok je dôležitý, pretože existuje bežná medzera medzi dvoma platnými štruktúrami. Odrážky fungujú, keď je každá položka jedným kompaktným vyhlásením. Karty fungujú, keď každá položka potrebuje nezávislé obrázky, niekoľko obchodných atribútov, výraznú akciu alebo dostatočnú vizuálnu váhu na samostatné státie. Mnohé kolekcie nepotrebujú ani jeden extrém. Integračný zoznam môže vyžadovať názov, dvojvetný súhrn schopností, stav a odkaz. Sploštenie do odrážok stratí polia; nafúknutie do kariet plytvá miestom a pôsobí reklamne.

Štruktúra nie je výhovorkou na vytváranie každej kolekcie na mieru. Jednorazový dizajn vedie k nekonzistentným poliam, usporiadaniu, prístupnosti a responzívnemu správaniu. Preto sa najskôr uplatňujú pravidlá písania prvkov : identifikujte opakovanú informačnú potrebu, zaregistrujte najmenšiu schému, ktorá ju spĺňa, a udržujte obsah prenositeľný medzi renderovacími nástrojmi.

Kedy ho použiť

Použite vlastný zoznam, keď všetky položky odpovedajú na rovnakú otázku čitateľa, každá potrebuje dva až päť viditeľných polí a primárnou úlohou je prezerať alebo navigovať, nie porovnávať každú hodnotu vedľa seba. Vhodné kolekcie zahŕňajú integrácie, oblasti služieb, podporované formáty, sťahovanie zdrojov, typy partnerov, tímové zodpovednosti, ukážky adresárov a zoskupené funkcie.

Pred výberom vykonajte štyri testy:

1. Opakovateľnosť: Môže každá položka používať rovnaké povinné polia bez vymýšľania výnimiek?
2. Nezávislosť: Môže čitateľ pochopiť jednu položku bez prečítania predchádzajúcej?
3. Skenovateľnosť: Je vzor názov-plus-súhrn užitočnejší ako mriežka porovnateľných hodnôt?
4. Akcia: Potrebuje každá položka najviac jeden primárny cieľ?

Ak sú odpovede áno, vlastný zoznam je pravdepodobne vhodný. Použite iný prvok, keď kolekcia zlyhá v jednom z týchto testov:

• Použite zoznam s odrážkami, keď položky potrebujú len jednu paralelnú vetu a žiadne samostatné metadáta.
• Použite porovnávaciu tabuľku , keď čitatelia musia skenovať rovnaké kritériá vertikálne alebo horizontálne naprieč alternatívami.
• Použite produktovú kartu, keď obrázok, cena, ponuka, hodnotenie, dostupnosť a nákupná akcia robia z každej položky významnú obchodnú jednotku.
• Použite zoznam krokov, keď pozícia vyjadruje postupnosť, nie redakčné usporiadanie.
• Použite slovník alebo definičný vzor, keď každý vstup je v podstate dvojica pojem–definícia.
• Použite nadpisy a súvislý text, keď položky vyžadujú rôzne polia alebo viac ako približne 100 slov vysvetlenia.

Nevyberajte vlastný zoznam len preto, že dizajn volá po opakovaných rámčekoch. Najprv dokážte, že existuje stabilný model obsahu. Ak má položka jedna cenu, položka dva životopis autora a položka tri veľkosť súboru na stiahnutie, nie sú to jedna kolekcia, aj keď ich CSS dokáže zarovnať.

Kam ho umiestniť

Umiestnite zoznam potom, čo stránka definuje kolekciu a jej pravidlo zahrnutia. „Podporované integrácie" je len označenie; „Tieto integrácie môžu posielať auditované stránky do vlastného reportovacieho pracovného priestoru" hovorí čitateľom, čo členstvo znamená. Keď výber alebo testovanie vytvorilo množinu, vysvetlite túto metódu pred prvou položkou, aby zoznam nenaznačoval nepodloženú úplnosť alebo poradie.

Umiestnite kolekciu blízko k rozhodovacej alebo navigačnej úlohe, ktorú slúži. Integračná stránka by mala predstaviť prepojenie a jeho výsledok pred uvedením podporovaných pracovných postupov. Adresár by mal vysvetliť rozsah a filtre pred zobrazením záznamov. Sprievodca zoznamom by mal uviesť metódu hodnotenia pred prezentáciou vybraných položiek.

Neprerušujte zoznam súvislým textom, reklamami, výzvami na akciu alebo nesúvisiacimi snímkami obrazovky. Hranice položiek musia zostať súvislé. Kvalifikácie umiestnite do definovaných metadát príslušnej položky alebo vysvetlite podmienku platnú pre celú kolekciu pred alebo za celým zoznamom. Ak je potrebných viac ako dvanásť položiek, zoskupte ich pod zmysluplné podnadpisy, pridajte filtrovanie alebo nasmerujte čitateľov na Adresárový index . Nevytvárajte nekonečný vizuálny blok.

Anatómia

Kompletný vlastný zoznam má tieto oblasti:

1. Názov kolekcie: pomenúva množinu v jazyku čitateľa, nie v internom názve komponentu.
2. Vyhlásenie o rozsahu: definuje, čo je oprávnené na zahrnutie a či je kolekcia úplná, vybraná alebo ilustratívna.
3. Kontajner zoznamu: vytvára jednu sémantickú kolekciu a vlastní počet položiek.
4. Názov položky: jednoznačne identifikuje entitu, zdroj, schopnosť alebo možnosť.
5. Súhrn položky: vysvetľuje relevantný rozdiel alebo použitie položky v jednej alebo dvoch vetách.
6. Skupina metadát: zobrazuje nula až tri označené fakty z registrovanej schémy.
7. Primárna akcia: odkazuje na jeden jasný cieľ pomocou popisného textu kotvy.
8. Hranica položky: používa medzeru, čiaru alebo zdržanlivé povrchové úpravy bez odpojenia položky od jej kolekcie.

Vyhlásenie o rozsahu predchádza bežnému zlyhaniu presnosti. „Dostupné integrácie" naznačuje úplnosť; „Bežné reportovacie integrácie" deklaruje výber. Autor musí zvoliť formuláciu, ktorú zdrojové dáta dokážu podporiť.

Príklady dizajnu

Renderovací nástroj môže meniť hustotu, ale musí zachovať poradie polí, sémantickú štruktúru zoznamu a predvídateľné poradie čítania.

Stohovaný redakčný zoznam

Použite predvolený stohovaný dizajn, keď súhrny nesú väčšinu hodnoty. Udržujte názov prvý, súhrn druhý, metadáta tretie a akciu poslednú. Postačuje jemný oddeľovač; každá položka nepotrebuje vyvýšenú kartu.

Kompaktná ukážka adresára

Použite kompaktný variant, keď názvy a jedna metadátová hodnota umožňujú čitateľom vybrať cieľ. Súhrn môže byť kratší, ale označenia musia zostať viditeľné. Nikdy nenahrádzajte zmysluplný stav nevysvetlenou farebnou bodkou.

Zoskupený zoznam

Použite skupiny, keď jedna stabilná klasifikácia rozdeľuje kolekciu ôsmich až dvadsiatich štyroch položiek do sekcií. Nadpisy skupín musia opisovať skutočnú taxonómiu, ako je typ exportu alebo región služby. Nezoskupujte len kvôli dosiahnutiu rovnakých stĺpcov.

Úzke zobrazovacie okno

Pri úzkych šírkach zachovajte poradie zdroja a umiestnite metadáta pod súhrn. Neskrývajte polia, ktoré zostávajú relevantné, nezmenšujte text na udržanie stĺpcov ani nepresúvajte akcie preč od ich položky.

Parametre

Nižšie uvedená schéma je zámerne obmedzená. Pole sa stáva súčasťou komponentu len vtedy, keď je užitočné naprieč celou kolekciou, nie preto, že jedna položka náhodou má preň údaje.

Tri položky sú minimum, pretože pár je zvyčajne jasnejší ako súvislý text, dvojstĺpcové porovnanie alebo dve rozsiahle karty. Dvanásť je normálne maximum, pretože skenovanie dlhého nefiltrovaného zoznamu je neefektívne. Strop dvadsaťštyri pri zoskupení je ochranné obmedzenie, nie cieľ; väčšie alebo často sa meniace množiny potrebujú adresár, vyhľadávanie, stránkovanie alebo dátovo riadenú aplikáciu.

Zvoľte ordered=true len vtedy, keď viditeľné poradie vyjadruje deklarované hodnotenie. Redakčné pohodlie, abecedné triedenie alebo poradie dátového zdroja nevytvára hodnotenie. Keď je hodnotenie skutočné, uveďte metodológiu a zachovajte pozíciu vo viditeľnom výstupe aj v štruktúrovaných dátach.

Syntax a príklady kódu

Prenosná direktíva definuje autorskú zmluvu. Adaptéry platforiem môžu ukladať dáta inak, ale musia zachovať rovnaké názvy polí, poradie položiek, voliteľnosť a viditeľný výstup.

Prenosná direktíva Markdown

:::custom-listing{title="Export formats" variant=stacked}
These are the formats available for sending completed audit records to another workspace.

:::item{id=csv title="CSV" url="/docs/exports/csv/"}
Tabular rows for spreadsheet analysis and flat-file ingestion.

- Best for: Spreadsheet analysis
- Availability: All plans
- Action: View CSV export setup
:::

:::item{id=json title="JSON" url="/docs/exports/json/"}
Nested records that preserve relationships for applications and data pipelines.

- Best for: Automated workflows
- Availability: Pro and Enterprise
- Action: Read the JSON reference
:::

:::item{id=sheets title="Google Sheets" url="/docs/exports/google-sheets/"}
A synchronized worksheet for teams that review data without code.

- Best for: Shared review
- Availability: Pro and Enterprise
- Action: Connect Google Sheets
:::
:::

Príkladové URL adresy opisujú len prenosnú syntax; implementácia ich musí nahradiť overenými cieľmi. Neuverejňujte príkladovú cestu ako živý odkaz len preto, že sa nachádza v bloku kódu.

Hugo adaptér

{{< custom-listing title="Export formats" variant="stacked" >}}
  {{< custom-listing-item id="csv" title="CSV" url="/docs/exports/csv/" action-label="View CSV export setup" >}}
  Tabular rows for spreadsheet analysis and flat-file ingestion.

  **Best for:** Spreadsheet analysis  
  **Availability:** All plans
  {{< /custom-listing-item >}}
{{< /custom-listing >}}

Tento zápis špecifikuje budúci alebo projektový adaptér; neoprávňuje na vytvorenie lokálneho shortcode pre stránku. Všetky parametre sú pomenované. Kým adaptér neexistuje, vykreslite kolekciu ako sémantické HTML pomocou <ul> a <li> alebo ako natívny Markdown, namiesto tichého vynechávania vzťahov medzi poľami.

WordPress blok

<!-- wp:amicited/custom-listing {"title":"Export formats","variant":"stacked"} -->
<ul class="custom-listing">
  <li data-item-id="csv">
    <h3>CSV</h3>
    <p>Tabular rows for spreadsheet analysis and flat-file ingestion.</p>
    <dl><dt>Best for</dt><dd>Spreadsheet analysis</dd><dt>Availability</dt><dd>All plans</dd></dl>
    <a href="/docs/exports/csv/">View CSV export setup</a>
  </li>
</ul>
<!-- /wp:amicited/custom-listing -->

Natívne bloky sú prijateľnou náhradou, keď vytvárajú jeden zoznam, jednu položku zoznamu na vstup, skutočné nadpisy, definičný zoznam pre označené metadáta a popisné odkazy. Generický blok stĺpcov nie je spoľahlivou náhradou, pretože poradie zdroja a zoskupenie položiek sa často na mobile rozbije.

Príklady

Dobrý príklad: konzistentný zoznam zdrojov

Migračné zdroje

Tieto zdroje podporujú tímy pri príprave, vykonávaní a overovaní migrácie webu.

1. Tabuľka presmerovaní — Zaznamenáva každú starú URL, jej schválený cieľ, vlastníka a stav overenia. Formát: Tabuľka. Fáza: Plánovanie. Akcia: Stiahnuť tabuľku presmerovaní.
2. Validačný skript pre spustenie — Kontroluje stavové kódy, reťazce presmerovaní, kanonické ciele a indexovateľnosť pre migrovanú množinu URL. Formát: Skript. Fáza: Spustenie. Akcia: Skontrolovať nastavenie validácie.
3. Monitorovací prehľad po spustení — Sleduje zlyhania prehľadávania a neočakávané zmeny návštevnosti po nasadení. Formát: Dashboard. Fáza: Monitorovanie. Akcia: Nakonfigurovať monitorovací prehľad.

Toto funguje, pretože každá položka používa rovnakých päť polí: názov, súhrn, formát, fázu a akciu. Rozsah vysvetľuje, prečo zdroje patria k sebe. Číslovanie odráža deklarovanú migračnú fázu, nie tvrdenie, že prvý zdroj je „najlepší". Každá akcia identifikuje svoj cieľ namiesto opakovania „Dozvedieť sa viac".

Zlý príklad: rámčeky bez zdieľaného modelu

Užitočné veci

• SEO kontrolný zoznam — Náš obľúbený sprievodca. Nedávno aktualizované. Dozvedieť sa viac.
• Prémiový audit — 499 €, zahŕňa hovor a správu. Päť hviezdičiek. Kúpiť teraz.
• Viktor — Technický vedúci z Bratislavy, dostupný v utorky.
• API dokumentácia — Autentifikácia, limity, chyby, príklady, SDK, changelog, stav, podpora a dvadsať ďalších tém.

Toto zlyháva ešte pred začiatkom vizuálneho dizajnu. Množina mieša zdroj, službu, osobu a oblasť dokumentácie. Polia sa menia pri každej položke, „nedávno" nemá dátum, hodnotenie nemá zdroj a stupnicu a hĺbka položky siaha od fragmentu po osnovu sekcie. Rozdeľte obsah podľa účelu a potom vyberte registrovaný prvok pre každú kolekciu. Ohraničenie okolo nekonzistentných údajov nevytvára vlastný zoznam.

Zlý príklad: zoznam, ktorý by mal byť tabuľkou

Predpokladajme šesť plánov, z ktorých každý zobrazuje mesačnú cenu, ročnú cenu, limit používateľov, úložisko, dobu odozvy podpory a dostupnosť SSO. Čitatelia potrebujú porovnať rovnakých šesť hodnôt naprieč všetkými plánmi. Zoznam by ich nútil zapamätať si plán jedna pri prechádzaní plánu šesť. Použite porovnávaciu tabuľku, pretože úlohou je vzájomné porovnávanie položiek. Ak každý plán potrebuje aj vyhlásenie o pozícii a nákupnú akciu, umiestnite ich mimo tabuľky alebo vedľa nej pomocou registrovaného komponentu plánu stránky; nezdvojujte konfliktné hodnoty v dvoch zdrojoch.

Schéma značkovania a prístupnosť

Vykreslite kolekciu s natívnou sémantikou zoznamu. Použite <ul>, keď poradie položiek nemá význam, a <ol>, keď stránka deklaruje skutočnú postupnosť alebo poradie. Každý vstup patrí do jedného <li>. V rámci neho použite skutočný nadpis na správnej úrovni dokumentu, odsek pre súhrn a <dl>, <dt>, <dd> pre označené metadáta. Čítač obrazovky by mal naraziť na názov položky pred jej opisom, faktami a akciou.

Nerobte z celej položky príliš veľký odkaz, keď obsahuje iný ovládací prvok alebo niekoľko textových oblastí. Dajte primárnemu odkazu popisný štítok, napríklad „Zobraziť nastavenie CSV exportu". Ak sa používa vzor natiahnutého odkazu (stretched link), jeho indikátor zaostrenia musí zostať viditeľný a jeho prístupný názov musí stále opisovať cieľ. Ikony potrebujú alternatívny text len vtedy, keď komunikujú informácie, ktoré už nie sú prítomné v texte. Dekoratívne ikony by mali byť skryté pred asistenčnými technológiami.

Vizuálne poradie a poradie zdroja sa musia zhodovať. Viacstĺpcové desktopové rozloženie sa musí zložiť bez čítania položka jedna, položka tri, položka päť, potom položka dva. Označenia metadát nemôžu zmiznúť len preto, že opakované hodnoty sú vizuálne zarovnané; „Enterprise" samo o sebe nehovorí nevidomému čitateľovi, či opisuje dostupnosť, publikum alebo podporu.

Štruktúrované dáta ItemList sú voliteľné, nie predvolený stylingový háčik. Použite ich, keď je viditeľná kolekcia zmysluplným konečným zoznamom a stránka profituje z identifikácie tejto kolekcie. Mapujte každý viditeľný vstup na itemListElement. Zahrňte position len pre skutočný usporiadaný zoznam a zabezpečte, aby názvy, URL a počty zodpovedali vykreslenému obsahu. Neoznačujte navigačné menu, ľubovoľné upútavky funkcií alebo čiastočnú množinu, ako keby boli úplným zoradeným zoznamom. Keď sú vstupy identifikovateľnými entitami, ako sú organizácie alebo softvérové aplikácie, použite najkonkrétnejší oprávnený typ len vtedy, keď stránka poskytuje a overuje požadované identifikačné údaje.

Pravidlá písania

1. Vysvetlite členstvo pred predstavením členov. Čitatelia potrebujú vedieť, či je množina úplná, vybraná, sponzorovaná, zoradená alebo ilustratívna, skôr než začnú interpretovať vynechanie alebo poradie. Uveďte pravidlo zahrnutia vo vete o rozsahu.
2. Definujte jednu schému položky pred písaním položiek. Konzistentné polia umožňujú čitateľom naučiť sa jeden vzor skenovania a validácii zachytiť chýbajúci obsah. Zaregistrujte povinné a voliteľné polia predtým, ako autori naplnia kolekciu.
3. Udržujte povinné polia skutočne univerzálne. Nominálne povinné pole, ktoré autori vyplnia „N/A" v polovici vstupov, je nesprávne pole alebo dôkaz, že kolekcia obsahuje rôzne typy položiek.
4. Obmedzte viditeľné metadáta na tri páry. Viac polí posúva úlohu smerom k porovnávaniu a sťažuje skenovanie každého riadku. Presuňte sekundárne fakty na cieľovú stránku alebo použite tabuľku.
5. Píšte súhrny pre rozdiel, nie opakovanie. Názov už pomenúva položku. Použite súhrn na vysvetlenie jej relevantnej schopnosti, publika, obmedzenia alebo úlohy.
6. Používajte paralelné označenia a jednotky. Nestriedajte „Plán", „Dostupné na" a „Úroveň" pre rovnaký koncept. Normalizujte dátumy, meny, jednotky a slovník stavov pred vykreslením.
7. Dajte každej položke jednu primárnu akciu. Konkurujúce tlačidlá menia referenčný zoznam na mriežku kariet a zatemňujú zamýšľaný ďalší krok. Sekundárne ciele umiestnite na detailnú stránku.
8. Deklarujte zmysluplné poradie. Abecedné, chronologické, hodnotené, redakčné a poradie podľa zdrojového systému vytvárajú rôzne očakávania. Pomenujte poradie, keď by mohlo ovplyvniť interpretáciu.
9. Stanovte minimálne a maximálne počty. Používajte tri až dvanásť položiek normálne, až dvadsaťštyri len v užitočných skupinách. Zmeňte vzor, keď kolekcia prekročí tieto hranice.
10. Udržujte jeden zdroj pravdy. Ak sa cena, stav, dostupnosť alebo iné premenlivé pole objavuje inde, napĺňajte každú reprezentáciu z rovnakého vlastného zdroja a v prípade potreby zverejnite dátum overenia.

Typy príspevkov, ktoré ho používajú

• Sprievodca zoznamom (listicle) používa vlastný zoznam, keď každý vybraný vstup potrebuje rovnaký súhrn, vhodnosť, obmedzenie a ďalší odkaz, ale nie hustú porovnávaciu maticu.
• Stránka Najlepšie-X-pre-Y ho môže použiť pre odporúčania špecifické pre publikum po vysvetlení metódy hodnotenia. Poradie musí byť explicitné, nie implikované vizuálnym usporiadaním.
• Stránka Alternatívy k X môže prezentovať možnosti náhrady s konzistentnými poliami „najlepšie pre", kompromis a odkaz na detail pred užším porovnaním.
• Kategóriová stránka používa kompaktný alebo zoskupený zoznam na ukážku zvládnuteľnej množiny podradených produktov alebo služieb, keď filtrovanie ešte nie je potrebné.
• Adresárový index používa prvok len pre ukážku alebo malý, stabilný adresár. Veľké množiny entít potrebujú vyhľadávanie, filtre, stránkovanie a dátovo podporované adresárové rozhranie.
• Profil spoločnosti môže uvádzať overené obchodné jednotky, certifikácie alebo lokality, keď každý vstup zdieľa rovnaké polia.
• Profil dodávateľa môže uvádzať podporované služby, regióny alebo modely spolupráce bez premenenia profilu na mriežku produktov.
• Integračná stránka môže uvádzať podporované pracovné postupy, dátové objekty, spúšťače alebo ciele pomocou predvídateľnej schémy schopností a požiadaviek.

Prítomnosť kolekcie nevyžaduje tento prvok. Použite ho len vtedy, keď vlastný model polí zlepšuje vyhľadávanie alebo navigáciu. Krátka sada predpokladov stále patrí do odrážok a matica schopností stále patrí do tabuľky.

Kontrolný zoznam QA

• Kolekcia má názov a vetu o rozsahu, ktorá definuje zahrnutie.
• Každá položka predstavuje rovnaký typ entity, zdroja, schopnosti alebo možnosti.
• Povinné a voliteľné polia sú zdokumentované pred zadávaním obsahu.
• Každá položka má unikátne stabilné ID, názov a 12–60-slovný súhrn.
• Žiadna položka nevymýšľa pole, ktoré chýba v registrovanej schéme.
• Kolekcia obsahuje 3–12 položiek, alebo odôvodnené skupiny s najviac 24 celkovo.
• Položky majú najviac tri viditeľné metadátové páry a jednu primárnu akciu.
• Označenia, jednotky, stavy, dátumy a znenie akcií sú konzistentné.
• Poradie je deklarované, keď implikuje hodnotenie, chronológiu alebo prioritu.
• Namiesto toho bola zvolená tabuľka, keď je hlavnou úlohou vzájomné porovnanie položiek.
• Výstup používa jeden sémantický <ul> alebo <ol> s jedným <li> na položku.
• Nadpisy nasledujú hierarchiu stránky a metadáta používajú sémantiku termín–opis.
• [ 】 Klávesnicové zaostrenie je viditeľné a odkazy opisujú svoje ciele.
• Poradie zdroja sa zhoduje s vizuálnym poradím na desktopových aj mobilných šírkach.
• Značkovanie ItemList, ak je prítomné, zodpovedá viditeľným položkám, poradiu, počtu, názvom a URL.
• Premenlivé hodnoty pochádzajú z vlastného zdroja a obsahujú primeraný dátum overenia.

FAQ

Nižšie uvedené otázky riešia hranice, ktoré najčastejšie spôsobujú, že sa vlastný zoznam posúva k odrážkam, kartám alebo tabuľkám.

Čo je to vlastný zoznam?

Vlastný zoznam je opakovateľná kolekcia, ktorej položky zdieľajú malú pomenovanú schému polí, ako je názov, súhrn, metadáta a odkaz. Nachádza sa medzi jednoduchým zoznamom s odrážkami a vizuálne nezávislou mriežkou kariet.

Koľko položiek by mal obsahovať vlastný zoznam?

Použite tri až dvanásť položiek ako bežný redakčný rozsah. Dve položky zvyčajne vyžadujú súvislý text alebo komponent vedľa seba. Viac ako dvanásť potrebuje užitočné zoskupenie, filtrovanie, stránkovanie alebo adresárový vzor; zoskupený variant nesmie presiahnuť dvadsaťštyri položiek.

Kedy by sa mal vlastný zoznam stať tabuľkou?

Použite tabuľku, keď čitatelia musia porovnávať väčšinu položiek podľa rovnakých troch alebo viacerých polí, najmä číselných hodnôt, dátumov, stavov alebo schopností áno/nie. Použite zoznam, keď sú súhrny a ďalšie odkazy dôležitejšie ako vzájomné porovnávanie položiek.

Potrebuje vlastný zoznam schému ItemList?

Nie. Pridajte ItemList len vtedy, keď je kolekcia zmysluplná a konečná, každá označená položka je viditeľná a akákoľvek pozícia odráža deklarované poradie. Bežné navigačné, upútavkové zoznamy a zoznamy súvisiaceho obsahu zvyčajne potrebujú sémantické HTML, nie špeciálnu schému.

Môžu mať položky rôzne polia?

Chýbať môžu len voliteľné polia definované zdieľanou schémou. Nedovoľte autorom vymýšľať polia pre jednotlivé položky. Ak niekoľko položiek potrebuje iný informačný model, rozdeľte ich do iného zoznamu alebo zvoľte vhodnejší prvok.