Kontrolní seznam: Pravidla pro psaní, umístění a příklady

Kontrolní seznam je konečná množina nezávislých akcí nebo ověřovacích bran, které čtenář může označit jako nehotové nebo hotové. Jeho stav zaškrtnutí je součástí významu: splnění každé povinné položky by mělo prokázat, že pojmenovaný úkol, kontrola nebo stav připravenosti je dokončen.

Tento vykreslený příklad má ohraničený rozsah, čtyři stručné akce, viditelné nezaškrtnuté stavy a jednu podmínku dokončení. Převod stejných slov na dekorativní odrážky by odstranil příslib, že množinu lze dokončit.

Proč na tomto prvku záleží

Čtenáři používají kontrolní seznam k odlehčení paměti. Namísto držení všech požadavků v hlavě při přepínání mezi konceptem, prohlížečem, návrhem a publikačním rozhraním mohou zkontrolovat jednu podmínku po druhé a zaznamenávat průběh. Konečná hranice snižuje nejistotu: čtenář ví, co zbývá, co znamená „hotovo“ a kdy je bezpečné pokračovat.

Tato psychologická smlouva je silnější než „zde je několik užitečných nápadů.“ Zaškrtávací políčko vybízí k závazku, zatímco poslední nezaškrtnutá položka vytváří záměrné napětí. Prvek proto musí být poctivý ohledně svého rozsahu. Pokud seznam opomene povinnou bránu nebo zahrnuje vágní aspirace jako „udělejte stránku skvělou,“ rozhraní signalizuje jistotu, kterou si obsah nezaslouží.

Strojová extrahovatelnost je schopnost vyhledávačů, AI odpovědních systémů, asistivních technologií a publikačních nástrojů izolovat každou položku, aniž by ztratila svou roli nebo model dokončení. Typovaný kontrolní seznam odhaluje pojmenovanou kolekci, stabilní hranice položek, výchozí stavy a podmínku dokončení. Analyzátor dokáže rozlišit povinné brány od příkladů nebo výhod, zatímco AI systém může citovat jednu samostatnou akci s neporušeným předmětem kontrolního seznamu.

Než zvolíte komponentu, postupujte podle pravidel pro psaní prvků . Jejich pravidlo priority je sémantické: pokud je účelem bloku být dokončen nebo ověřen, použijte prvek kontrolního seznamu, i když by obyčejné odrážky mohly zobrazit stejná slova. Vizuální podobnost nezachovává stav, validaci, přístupnost ani mapování adaptéru.

Kdy jej použít

Použijte kontrolní seznam, když je množina konečná, každá položka může nezávisle projít nebo selhat a splnění povinných položek vytváří smysluplný stav. Vhodná témata zahrnují předpublikační kontrolu, požadavky na nákup, připravenost migrace, předání incidentu, úplnost dokumentace, kontrolu přístupnosti a pravidelnou údržbovou inspekci.

Aplikujte tři testy:

1. Test stavu: Lze každou položku jednoznačně označit jako nehotovou nebo hotovou?
2. Test hranice: Obsahuje seznam všechny požadované kontroly pro deklarovaný rozsah?
3. Test dokončení: Dokazuje dokončení povinných položek pojmenovaný výsledek?

Pokud je odpověď na kteroukoli otázku ne, je pravděpodobně přesnější jiný prvek. Běžné záměny jsou:

• Odrážkový seznam seskupuje fakta, možnosti, příklady nebo atributy. Jeho položky nejsou úkoly a množina se nestává dokončenou.
• Seznam kroků kóduje závislé pořadí. Pokud posunutí položky 4 před položku 2 může způsobit selhání, čísla a pokyny k nápravě jsou důležitější než zaškrtávací políčka.
• Seznam funkcí popisuje, co produkt má. „Podporuje export CSV“ není kontrola, pokud čtenář neověřuje uvedený požadavek.
• Seznam přání zaznamenává preference, jejichž hranice a priorita se mohou měnit. Neměl by slibovat dokončení.
• Bodovací tabulka hodnotí dimenze na škále. Binární stavy zaškrtnutí by ztratily užitečné stupně výkonu.
• Dlouhý postup se zaškrtávacím políčkem u každého kliknutí zaměňuje provádění s ověřováním. Vysvětlete postup jako kroky, poté přidejte krátký kontrolní seznam pro dokončení.

Nepoužívejte kontrolní seznam jako dekoraci na konci každé sekce. Opakovaná nezaškrtnutá políčka vnucují práci a naznačují, že čtenář neskončil, i když obsah nabízel pouze volitelné rady.

Kam jej umístit

Umístění se řídí okamžikem, kdy čtenář může jednat nebo ověřovat. Nejprve představte úkol, rozsah a požadovaný kontext; poté umístěte kontrolní seznam bezprostředně před rozhodnutí, které řídí, nebo bezprostředně za materiál, který shrnuje.

• Umístěte kontrolní seznam připravenosti za předpoklady a před nevratnou nebo nákladnou akci.
• Umístěte kontrolní seznam zajištění kvality za koncept, konfiguraci nebo postup, který hodnotí, a před schválení nebo publikaci.
• Umístěte kontrolní seznam nákupních požadavků po vysvětlení potřeb a omezení, ale před vytvořením užšího výběru produktů.
• Umístěte kontrolní seznam pravidelné údržby do sekce údržby, vedle její frekvence a vlastníka.
• Umístěte hlavní kontrolní seznam blízko začátku vyhrazeného článku s kontrolním seznamem, po krátkém prohlášení o rozsahu, a poté vysvětlete obtížné položky níže.

Kontrolní seznam nesmí být umístěn přímo vedle druhého kontrolního seznamu s překrývajícím se rozsahem; sloučte je nebo dejte každému vlastní nadpis a podmínku dokončení. Neumísťujte jej vedle postupového seznamu kroků bez uvedení, který blok je postup a který je ověření. Nesmí oddělovat varování od důsledku nebo požadované reakce, přerušovat srovnávací tabulku nebo být umístěn uvnitř výzvy k akci. Nikdy nedávejte propagační tlačítko mezi poslední položku a podmínku dokončení.

Anatomie

Označené oblasti jsou:

1. Nadpis rozsahu: pojmenovává přesný objekt a rozhodnutí, např. „Kontrola odkazů před publikací.“
2. Instrukce: říká, co dokončení umožňuje nebo prokazuje.
3. Ovládací prvek zaškrtnutí: zpřístupňuje neúplný nebo dokončený stav programově i vizuálně.
4. Popisek akce: začíná konkrétním slovesem a zůstává srozumitelný samostatně.
5. Volitelný kvalifikátor: poskytuje práh, umístění, vlastníka nebo požadavek na důkaz.
6. Indikátor povinnosti: odlišuje volitelné položky pouze tehdy, když to smlouva skutečně umožňuje.
7. Souhrn průběhu: v interaktivních variantách uvádí počet dokončených a celkových povinných položek.
8. Podmínka dokončení: uvádí výsledek dosažený po splnění všech povinných položek.

Slova zůstávají autoritativní. Ikona zaškrtnutí, zelený řádek nebo přeškrtnutý popisek mohou stav posílit, ale žádný z nich nemůže nahradit nativní nebo programový zaškrtnutý stav.

Příklady designu

Statický redakční kontrolní seznam

Použijte viditelné nezaškrtnuté ovládací prvky pro tisknutelný nebo referenční kontrolní seznam. Čtenář jej může kopírovat nebo tisknout, ale stránka netvrdí, že ukládá průběh.

Interaktivní kontrolní seznam s průběhem

Použijte, když čtenář těží z označování průběhu během relace. Oznamte počet bez přesouvání fokusu a poskytněte jasnou akci pro reset.

Povinný a volitelný kontrolní seznam

Použijte pouze tehdy, když volitelné úkoly skutečně neovlivňují podmínku dokončení. Označte volitelné položky textem; nikdy nespoléhejte pouze na světlejší barvu.

Seskupený kontrolní seznam

Pro více než deset celkových kontrol rozdělte práci do skupin po čtyřech až deseti s oddělenými nadpisy a podmínkami dokončení. Každá skupina je samostatně srozumitelná.

Tiskový stav

Tiskový výstup musí zachovat prázdné a dokončené značky v černobílé, ponechat popisky vedle jejich ovládacích prvků a vyhnout se rozdělení krátké skupiny přes stránky.

Parametry

| title | Prostý řetězec | Ano | 2–10 slov; 90 znaků | Žádný | První nadpis v nadřazeném těle | | instruction | Prostý text | Ano | 1 věta; 30 slov | „Dokončete všechny povinné položky.“ | Tělo za prvním nadpisem | | items | Opakovaná kolekce položek | Ano | 4–10 na skupinu | Žádná | Vnořená těla položek | | item.label | Prostý inline text | Ano | 3–12 slov; max. asi 80 znaků | První nadpis v těle položky | První nadpis | | item.detail | Omezený Markdown | Ne | 0–1 věta; 140 znaků | Vynecháno | Tělo položky za prvním nadpisem | | item.required | Logická hodnota | Ne | true nebo false | true | Atribut položky | | item.checked | Logická hodnota | Ne | true nebo false | false | Atribut položky; pouze autorské příklady | | interactive | Logická hodnota | Ne | true nebo false | false | Nadřazený atribut | | persist | Výčet | Ne | none, local nebo account | none | Nadřazený atribut | | completion | Prostý text | Ano | 1 věta; 25 slov | Žádný | Poslední odstavec v nadřazeném těle | | id | Identifikátor malými písmeny | Podmíněně | Unikátní na stránce; 2–8 slov se spojovníky | Generován, pak ukotven | Nadřazený atribut |

Výchozí hodnota checked je určena pro zpracované příklady, uložené šablony nebo stav úkolu vlastněný serverem. Redakční kontrolní seznamy začínají nezaškrtnuté; autoři nikdy nesmí předzaškrtnout položku jen proto, aby vytvořili atraktivnější snímek obrazovky. Pokud interactive=false, persist musí být none.

Syntaxe a příklady kódu

Kanonické mapování se řídí pravidly priority, těla a vnořených položek v základní smlouvě. Nadřazený prvek poskytuje chování kolekce; každá položka poskytuje jeden popisek, volitelný detail a stavová pole.

Přenosná Markdown direktiva

:::checklist{id="pre-publish-links" interactive=true persist=local}
## Pre-publish link check

Complete every required item before approving the page.

::item
### Open every internal link and confirm the destination exists
::

::item
### Confirm each anchor describes its destination out of context
::

::item{required=false}
### Check campaign parameters on optional promotional links
::

::item
### Verify keyboard focus is visible on every linked control
::

Complete when every required item passes and no exception remains.
:::

Hugo shortcode

{{< checklist id="pre-publish-links" title="Pre-publish link check" interactive="true" persist="local" completion="Complete when every required item passes and no exception remains." >}}
{{< checklist-item >}}Open every internal link and confirm the destination exists.{{< /checklist-item >}}
{{< checklist-item >}}Confirm each anchor describes its destination out of context.{{< /checklist-item >}}
{{< checklist-item required="false" >}}Check campaign parameters on optional promotional links.{{< /checklist-item >}}
{{< checklist-item >}}Verify keyboard focus is visible on every linked control.{{< /checklist-item >}}
{{< /checklist >}}

Toto je požadovaný tvar adaptéru pro Hugo, nikoli tvrzení, že úložiště již shortcode poskytuje. Dokud neexistuje registrovaný renderer, použijte pro živý příklad sémantické HTML, místo abyste napodobovali komponentu nesouvisejícími styly.

WordPress blok

<!-- wp:amicited/checklist {"id":"pre-publish-links","title":"Pre-publish link check","interactive":true,"persist":"local","completion":"Complete when every required item passes and no exception remains."} -->
<!-- wp:amicited/checklist-item -->
<p>Open every internal link and confirm the destination exists.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Confirm each anchor describes its destination out of context.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item {"required":false} -->
<p>Check campaign parameters on optional promotional links.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Verify keyboard focus is visible on every linked control.</p>
<!-- /wp:amicited/checklist-item -->
<!-- /wp:amicited/checklist -->

Všechny adaptéry musí zachovat zdrojové pořadí, stav povinnosti, viditelné popisky, podmínku dokončení a nezaškrtnutý obsah, pokud není skriptování k dispozici.

Příklady

Dobrý: ohraničená kontrola vydání

• Potvrďte, že verze vydání odpovídá schválenému záznamu o změně.
• Spusťte zdokumentovaný smoke test a přiložte jeho výsledek.
• Ověřte, že vlastník rollbacku je k dispozici během okna vydání.
• Zaznamenejte čas nasazení do časové osy incidentu.

Hotovo, když: všechny čtyři záznamy jsou přítomny a jmenovaný vlastník rollbacku potvrdil okno.

Funguje to, protože každá položka začíná pozorovatelnou akcí, zůstává v rámci jednoho rozhodnutí o vydání a má binární důkaz. Řádek o dokončení vysvětluje, co celá množina prokazuje.

Špatný: aspirační seznam obsahu

• Myslete na publikum.
• Udělejte článek poutavým.
• Zlepšete SEO.
• Přidejte cokoli dalšího, co pomůže.

Toto selhává, protože žádná z položek nedefinuje podmínku úspěchu, „cokoli dalšího“ činí množinu nekonečnou a zaškrtnutí políček by neprokázalo, že je článek připraven. Nahraďte aspirace ověřitelnými bránami, jako je „Pojmenujte jedno primární publikum v briefu“, nebo přesuňte neproveditelné pokyny do prózy.

Schema značkování a přístupnost

Neexistuje obecný typ Schema.org Checklist. Nemapujte nezávislé kontroly na HowToStep, pokud stránka skutečně nepopisuje seřazený postup a viditelný obsah tyto kroky neobsahuje. Kontrolní seznam může zůstat viditelným obsahem uvnitř Article, TechArticle, Product nebo jiného odůvodněného typu stránky, ale jeho zaškrtávací políčka nevytvářejí další způsobilost pro schema.

Používejte nativní ovládací prvky <input type="checkbox"> pro interaktivní stav a každý ovládací prvek spojte s <label> pomocí obalení nebo odpovídajících hodnot for a id. Statické zobrazení, které nelze změnit, nesmí vydávat za povolený ovládací prvek. Použijte zakázaná zaškrtávací políčka pro výslovně neinteraktivní příklad nebo seznam s textovými ekvivalenty jako „Nezaškrtnuto“ v kontextech, kde by formulářové ovládací prvky byly zavádějící.

Uživatelé klávesnice musí dosáhnout na každé povolené zaškrtávací políčko ve zdrojovém pořadí, přepnout jej klávesou Space a vidět trvalý indikátor fokusu. Po zaškrtnutí nepřesouvejte fokus. Pokud se aktualizuje zpráva o průběhu, oznamte stručný souhrn, např. „Čtyři z šesti povinných položek hotovo“, prostřednictvím zdvořilé živé oblasti; neoznamujte celý seznam znovu.

Zaškrtnuté a nezaškrtnuté stavy vyžadují více než barvu. Při zaškrtnutí zachovejte popisek, nenahrazujte jej „Hotovo“, protože akce musí zůstat identifikovatelná. Pokud průběh přetrvává, vysvětlete rozsah úložiště a poskytněte možnost Resetovat průběh. Užitečný obsah, indikátory povinnosti a podmínka dokončení musí zůstat v serverem vykresleném HTML, pokud JavaScript selže.

Pravidla pro psaní

Položky kontrolního seznamu jsou stručné, protože čtenář provádí nebo ověřuje, nikoli se učí celé téma uvnitř ovládacího prvku. Vysvětlete důvod v okolní próze před uvedením pravidla.

• Udržujte jeden kontrolní seznam na čtyřech až deseti položkách. Čtyři tvoří užitečnou konečnou množinu; více než deset se špatně prohlíží a signalizuje více fází.
• Udržujte každou akci na asi 80 znacích a třech až dvanácti slovech. Krátký popisek zůstává použitelný vedle ovládacího prvku a extrahovatelný bez okolní prózy.
• Začněte konkrétním rozkazovacím slovesem: Potvrďte, Otevřete, Porovnejte, Zaznamenejte, Otestujte, Přiložte nebo Ověřte. Vyhněte se slabým slovesům jako Zvažte, Pamatujte nebo Přemýšlejte o.
• Dejte každé položce jednu podmínku úspěchu. „Zkontrolujte název a odkazy“ může částečně projít, proto ji rozdělte na dvě položky.
• Udržujte položky nezávislé. Pokud jedna akce odemyká další, převeďte postup na kroky a kontrolní seznam použijte pouze pro závěrečné ověření.
• Udržujte gramatiku a úroveň paralelní. Nemíchejte „Potvrďte právní schválení“ s „Publikujte kampaň napříč všemi kanály a týden ji monitorujte.“
• Pojmenujte důkaz, pokud dokončení není přímo viditelné: přiložte zprávu, zaznamenejte časové razítko nebo získejte potvrzení schvalovatele.
• Označte volitelné položky výslovně a vylučte je z povinného průběhu. Volitelný musí znamenat, že podmínka dokončení zůstává splněna i bez nich.
• Používejte větovou kapitalizaci a koncová interpunkční znaménka konzistentně. Plné věty jsou preferovány, pokud položka obsahuje kvalifikátor.

Nikdy nedávejte do položky kontrolního seznamu:

• Několik seřazených podkroků, větvící logiku odstraňování problémů nebo druhý vnořený kontrolní seznam.
• Bezpečnostní varování, právní vyloučení odpovědnosti nebo nevratný důsledek, který musí být viděn před akcí.
• Odstavec vysvětlení, dlouhou citaci, svědectví, snímek obrazovky, video, formulář nebo propagační výzvu k akci.
• Subjektivní hodnocení, otevřenou aspiraci, nepodložený práh nebo požadavek bez pozorovatelného důkazu.
• Odkaz označený pouze „zde“, protože položka musí přežít extrakci bez okolního kontextu.

Typy příspěvků, které jej používají

Spojení níže jsou řízena frontmatter postTypes této stránky. „Povinný“ znamená, že hlavní úkol typu příspěvku závisí na modelu konečného dokončení; „doporučený“ a „volitelný“ závisí na tématu stránky.

QA kontrolní seznam

Obsah a umístění

• Nadpis pojmenovává jeden ohraničený objekt, rozhodnutí nebo stav připravenosti.
• Úvod vysvětluje, co dokončení povinných položek prokazuje.
• Použijte čtyři až deset položek, rozdělte větší práci do pojmenovaných skupin.
• Udržujte každou položku kolem 80 znaků a začněte konkrétním slovesem.
• Každá položka má jednu pozorovatelnou podmínku úspěchu a lze ji zaškrtnout nezávisle.
• Potvrďte, že přeskupení položek nenarušuje úkol.
• Množina je konečná a zahrnuje všechny povinné brány pro svůj uvedený rozsah.
• Volitelné položky jsou viditelně označeny a vyloučeny z povinného průběhu.
• Odstraňte vnořené postupy, varování, dlouhá vysvětlení, média a propagaci.

Hotovo, když: kolekce má jeden ohraničený účel a každá položka je stručná, nezávislá a ověřitelná.

Vykreslování a přístupnost

• Podmínka dokončení se objevuje bezprostředně za poslední položkou.
• Povolené ovládací prvky mají přiřazené popisky, ovládání klávesnicí a viditelný fokus.
• Stav není sdělován pouze barvou, ikonami, přeškrtnutím nebo pozicí.
• Interaktivní průběh funguje bez přesouvání fokusu a vysvětluje případnou perzistenci.
• Popisky a kritéria dokončení zůstávají dostupné bez CSS nebo JavaScriptu.
• Strukturovaná data udržujte na obalující stránce; nevytvářejte schema Checklist.
• Zachovejte stejná pole a pořadí ve všech třech mapováních platformy.
• Udržujte komentáře ke snímkům obrazovky jako instrukce; neodkazujte na chybějící obrázek.

Hotovo, když: stav, popisky, pořadí a význam dokončení přežijí všechny podporované cesty vykreslení.

FAQ

Šablona akademie vykresluje pět zkontrolovaných otázek z frontmatter [[faq]] této stránky. Týkají se počtu položek, rozdílu od odrážek a kroků, ukládání stavu a strukturovaných dat.