Checklista: Skrivregler, placering och exempel

En checklista är en ändlig uppsättning oberoende handlingar eller verifieringsgrindar som en läsare kan markera som ofullständig eller fullständig. Dess avmarkerbara tillstånd är en del av innebörden: att slutföra varje obligatoriskt objekt bör bevisa att en namngiven uppgift, granskning eller beredskapsstatus är avslutad.

Detta renderade exempel har en avgränsad omfattning, fyra koncisa handlingar, synliga omarkerade tillstånd och ett slutförandevillkor. Att omvandla samma ord till dekorativa punkter skulle ta bort löftet om att uppsättningen kan slutföras.

Varför detta element är viktigt

Läsare använder en checklista för att avlasta minnet. Istället för att hålla varje krav i minnet medan de växlar mellan ett utkast, webbläsare, design och publiceringsgränssnitt, kan de inspektera ett villkor i taget och registrera framsteg. Den ändliga avgränsningen minskar osäkerheten: läsaren vet vad som återstår, vad “klart” innebär och när det är tryggt att gå vidare.

Det psykologiska kontraktet är starkare än “här är några användbara idéer.” En kryssruta inbjuder till engagemang, medan det sista omarkerade objektet skapar medveten spänning. Elementet måste därför vara ärligt om sin omfattning. Om listan utelämnar en obligatorisk grind eller innehåller vaga ambitioner som “gör sidan bra”, signalerar gränssnittet en säkerhet som innehållet inte förtjänat.

Maskinextraherbarhet är förmågan hos sökmotorer, AI-svarssystem, hjälpmedelsteknik och publiceringsverktyg att isolera varje objekt utan att förlora dess roll eller slutförandemodell. En typad checklista exponerar en namngiven samling, stabila objektsgränser, initiala tillstånd och ett slutförandevillkor. En parser kan skilja obligatoriska grindar från exempel eller fördelar, medan ett AI-system kan citera en fristående handling med checklistans ämne intakt.

Följ skrivreglerna för element innan du väljer komponenten. Deras prioritetsregel är semantisk: när syftet med ett block är att slutföras eller verifieras, använd checklisterelementet även om vanliga punkter skulle kunna visa samma ord. Visuell likhet bevarar inte tillstånd, validering, tillgänglighet eller adapterkartläggning.

När det ska användas

Använd en checklista när uppsättningen är ändlig, varje objekt oberoende kan godkännas eller underkännas, och slutförandet av de obligatoriska objekten upprättar ett meningsfullt villkor. Lämpliga ämnen inkluderar granskning före publicering, upphandlingskrav, migreringsberedskap, incidentöverlämning, dokumentfullständighet, tillgänglighetsgranskning och återkommande underhållsinspektion.

Tillämpa tre test:

1. Tillståndstest: Kan varje objekt entydigt markeras som ofullständigt eller fullständigt?
2. Avgränsningstest: Innehåller listan alla nödvändiga kontroller för sin deklarerade omfattning?
3. Slutförandetest: Bevisar slutförandet av de obligatoriska objekten ett namngivet resultat?

Om något svar är nej, är ett annat element troligen mer korrekt. De vanliga nära misstagen är:

• En punktlista grupperar fakta, alternativ, exempel eller attribut. Dess objekt är inte uppgifter och uppsättningen blir inte fullständig.
• En steglista kodar beroende sekvens. Om att flytta objekt 4 före objekt 2 kan orsaka fel, är siffror och återhämtningsvägledning viktigare än kryssrutor.
• En funktionslista beskriver vad en produkt har. “Stöder CSV-export” är inte en kontroll om inte läsaren verifierar ett angivet krav.
• En önskelista registrerar preferenser vars gränser och prioritet kan ändras. Den bör inte lova slutförande.
• Ett poängkort utvärderar dimensioner på en skala. Binära kryssmarkeringar skulle kasta bort användbara prestationsgrader.
• En lång procedur med en kryssruta bredvid varje klick förväxlar utförande med verifiering. Förklara proceduren som steg, lägg sedan till en kort slutförandechecklista.

Använd inte en checklista som dekoration i slutet av varje avsnitt. Upprepade omarkerade rutor pålägger arbete och antyder att läsaren inte har slutfört, även när innehållet endast gav valfria råd.

Var det ska placeras

Placeringen följer det ögonblick då läsaren kan agera eller verifiera. Introducera först uppgiften, omfattningen och nödvändigt sammanhang; placera sedan checklistan omedelbart före beslutet den styr eller omedelbart efter materialet den sammanfattar.

• Placera en beredskapschecklista efter förkunskaper och före en oåterkallelig eller dyr handling.
• Placera en kvalitetssäkringschecklista efter utkastet, konfigurationen eller proceduren den utvärderar och före godkännande eller publicering.
• Placera en checklista för inköpskrav efter att behov och begränsningar förklarats men innan produkter gallras.
• Placera en checklista för återkommande inspektion inom underhållsavsnittet, bredvid dess frekvens och ägare.
• Placera huvudchecklistan nära toppen av en dedikerad checklista-artikel, efter en kort omfattningsbeskrivning, och förklara sedan svåra objekt nedanför.

En checklista får inte sitta direkt bredvid en andra checklista med överlappande omfattning; slå ihop dem eller ge var och en en distinkt rubrik och slutförandevillkor. Placera den inte bredvid en sekventiell steglista utan att ange vilket block som är proceduren och vilket som är verifieringen. Den får inte dela en varning från konsekvensen eller den nödvändiga åtgärden, avbryta en jämförelsetabell eller sitta inuti en uppmaning till handling. Placera aldrig en reklamknapp mellan det sista objektet och slutförandevillkoret.

Anatomi

De märkta regionerna är:

1. Omfattningsrubrik: namnger det exakta objektet och beslutet, till exempel “Länkkontroll före publicering.”
2. Instruktion: säger vad slutförande tillåter eller bevisar.
3. Kryssrutekontroll: exponerar ofullständigt eller fullständigt tillstånd programmatiskt och visuellt.
4. Handlingsetikett: börjar med ett konkret verb och förblir begriplig i sig själv.
5. Valfri kvalificerare: anger ett tröskelvärde, plats, ägare eller beviskrav.
6. Obligatorisk indikator: skiljer valfria objekt endast när avtalet verkligen tillåter dem.
7. Framstegssammanfattning: rapporterar slutförda och totala obligatoriska objekt i interaktiva varianter.
8. Slutförandevillkor: anger resultatet som uppnås när alla obligatoriska objekt är godkända.

Orden förblir auktoritativa. En bockikon, grön rad eller genomstruken etikett kan förstärka tillstånd, men ingen kan ersätta det inbyggda eller programmatiska markerade tillståndet.

Designexempel

Statisk redaktionell checklista

Använd synliga omarkerade kontroller för en utskrivbar eller referenschecklista. Läsaren kan kopiera eller skriva ut den, men sidan hävdar inte att den sparar framsteg.

Interaktiv framstegschecklista

Använd när läsaren drar nytta av att markera framsteg under en session. Meddela antalet utan att flytta fokus och tillhandahåll en tydlig återställningsåtgärd.

Obligatorisk och valfri checklista

Använd endast när valfria uppgifter verkligen inte påverkar slutförandevillkoret. Märk valfria objekt i text; förlita dig aldrig på ljusare färg.

Grupperad checklista

För fler än tio totala kontroller, dela upp arbetet i grupper om fyra till tio med separata rubriker och slutförandevillkor. Varje grupp är oberoende begriplig.

Utskriftsläge

Utskrift måste behålla tomma och ifyllda markeringar i svartvitt, hålla etiketter bredvid sina kontroller och undvika att dela en kort grupp över sidor.

Parametrar

Det initiala checked-värdet är för genomarbetade exempel, sparade mallar eller serverägda uppgiftstillstånd. Redaktionella checklistor börjar omarkerade; författare får aldrig förkryssa ett objekt enbart för att skapa en mer attraktiv skärmdump. Om interactive=false måste persist vara none.

Syntax och kodexempel

Den kanoniska kartläggningen följer prioritets-, brödtext- och kapslade objektreglerna i baskontraktet. Det överordnade elementet tillhandahåller samlingsbeteende; varje objekt tillhandahåller en etikett, valfri detalj och tillståndsfält.

Bärbar Markdown-direktiv

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

Detta är den obligatoriska Hugo-adapterformen, inte ett påstående om att databasen redan tillhandahåller shortcoden. Tills en registrerad renderare finns, använd semantisk HTML för ett levande exempel istället för att imitera komponenten med orelaterade stilar.

WordPress-block

<!-- 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 -->

Alla adaptrar måste bevara källordning, obligatoriskt tillstånd, synliga etiketter, slutförandevillkoret och det omarkerade innehållet när skriptning inte är tillgänglig.

Exempel

Bra: en avgränsad versionskontroll

• Bekräfta att versionen matchar den godkända ändringsposten.
• Kör den dokumenterade röktesten och bifoga dess resultat.
• Kontrollera att återställningsägaren är tillgänglig under versionsfönstret.
• Registrera distributionstiden i incidenttidslinjen.

Klart när: alla fyra poster finns och den namngivna återställningsägaren har bekräftat fönstret.

Detta fungerar eftersom varje objekt börjar med en observerbar handling, håller sig inom ett versionsbeslut och har binära bevis. Slutföranderaden förklarar vad hela uppsättningen bevisar.

Dålig: en ambitiös innehållslista

• Tänk på målgruppen.
• Gör artikeln engagerande.
• Förbättra SEO.
• Lägg till allt annat som hjälper.

Detta misslyckas eftersom inget av objekten definierar ett godkännandevillkor, “allt annat” gör uppsättningen oändlig, och att fylla i rutorna skulle inte bevisa att artikeln är redo. Ersätt ambitioner med verifierbara grindar som “Ange en primär målgrupp i briefen” eller flytta icke-handlingsbar vägledning till prosa.

Schema-markering och tillgänglighet

Det finns ingen allmän Schema.org-typ Checklist. Mappa inte oberoende kontroller till HowToStep om inte sidan verkligen beskriver en ordnad procedur och det synliga innehållet innehåller dessa steg. En checklista kan förbli synligt innehåll inuti Article, TechArticle, Product eller en annan motiverad sidtyp, men dess kryssrutor skapar inte extra schema-berättigande.

Använd inbyggda <input type="checkbox">-kontroller för interaktivt tillstånd och koppla varje kontroll till en <label> med omslutning eller matchande for- och id-värden. En statisk visning som inte kan ändras får inte utge sig för att vara en aktiverad kontroll. Använd inaktiverade kryssrutor för ett uttryckligen icke-interaktivt exempel, eller använd en lista med textmotsvarigheter som “Inte markerad” i sammanhang där formulärkontroller skulle vara missvisande.

Tangentbordsanvändare måste nå varje aktiverad kryssruta i källordning, växla den med mellanslagstangenten och se en beständig fokusindikator. Flytta inte fokus efter en markering. Om ett framstegsmeddelande uppdateras, meddela en kort sammanfattning som “Fyra av sex obligatoriska objekt slutförda” genom en artig live-region; meddela inte hela listan igen.

Markerade och omarkerade tillstånd kräver mer än färg. Bevara etiketten när den är markerad istället för att ersätta den med “Klart”, eftersom handlingen måste förbli identifierbar. Om framsteg består, förklara lagringsomfattningen och tillhandahåll Återställ framsteg. Det användbara innehållet, obligatoriska indikatorer och slutförandevillkoret måste finnas kvar i server-renderad HTML när JavaScript misslyckas.

Skrivregler

Checklistobjekt är kompakta eftersom läsaren utför eller verifierar, inte lär sig hela ämnet inuti kontrollen. Förklara anledningen i omgivande prosa innan du anger regeln.

• Håll en checklista till fyra till tio objekt. Fyra etablerar en användbar ändlig uppsättning; fler än tio blir svåra att skanna och signalerar flera faser.
• Håll varje handling till cirka 80 tecken och tre till tolv ord. En kort etikett förblir användbar bredvid en kontroll och extraherbar utan intilliggande prosa.
• Börja med ett specifikt imperativt verb: Bekräfta, Öppna, Jämför, Registrera, Testa, Bifoga eller Kontrollera. Undvik svaga verb som Överväg, Kom ihåg eller Tänk på.
• Ge varje objekt ett godkännandevillkor. “Kontrollera titeln och länkarna” kan delvis godkännas, så dela upp det i två objekt.
• Håll objekt oberoende. Om en handling låser upp nästa, omvandla proceduren till steg och använd checklistan endast för slutlig verifiering.
• Håll grammatik och nivå parallell. Blanda inte “Bekräfta juridiskt godkännande” med “Publicera kampanjen över alla kanaler och övervaka den under en vecka.”
• Namnge bevis när slutförande inte är direkt synligt: bifoga rapporten, registrera tidsstämpeln eller erhåll godkännarens bekräftelse.
• Markera valfria objekt explicit och exkludera dem från obligatoriska framsteg. Valfri måste innebära att slutförandevillkoret förblir sant utan dem.
• Använd meningars versalisering och avslutande skiljetecken konsekvent. Hela meningar föredras när ett objekt innehåller en kvalificerare.

Placera aldrig dessa inuti ett checklistobjekt:

• Flera ordnade delsteg, förgrenande felsökningslogik eller en andra kapslad checklista.
• En säkerhetsvarning, juridisk ansvarsfriskrivning eller oåterkallelig konsekvens som måste ses före handling.
• Ett stycke förklaring, långt citat, vittnesmål, skärmdump, video, formulär eller reklamuppmaning till handling.
• En subjektiv poäng, öppen ambition, ostödd tröskel eller krav utan observerbart bevis.
• En länk märkt endast “här,” eftersom objektet måste överleva extraktion utan omgivande sammanhang.

Inläggstyper som använder det

Kopplingarna nedan drivs av denna sidas postTypes-frontmatter. “Obligatorisk” innebär att inläggstypens kärnuppgift beror på en ändlig slutförandemodell; “rekommenderad” och “valfri” beror på sidans ämne.

QA-checklista

Innehåll och placering

• Rubriken namnger ett avgränsat objekt, beslut eller beredskapsstatus.
• Introduktionen förklarar vad slutförandet av de obligatoriska objekten bevisar.
• Använd fyra till tio objekt, dela upp större arbete i namngivna grupper.
• Håll varje objekt nära 80 tecken och börja med ett konkret verb.
• Varje objekt har ett observerbart godkännandevillkor och kan kontrolleras oberoende.
• Bekräfta att omordning av objekt inte bryter uppgiften.
• Uppsättningen är ändlig och inkluderar varje obligatorisk grind för sin angivna omfattning.
• Valfria objekt är synligt märkta och exkluderade från obligatoriska framsteg.
• Ta bort kapslade procedurer, varningar, långa förklaringar, media och reklam.

Klart när: samlingen har ett avgränsat syfte och varje objekt är koncist, oberoende och verifierbart.

Rendering och tillgänglighet

• Slutförandevillkoret visas direkt efter det sista objektet.
• Aktiverade kontroller har associerade etiketter, tangentbordsoperation och synligt fokus.
• Tillstånd kommuniceras inte enbart genom färg, ikoner, genomstrykning eller position.
• Interaktiva framsteg fungerar utan att flytta fokus och förklarar eventuell beständighet.
• Etiketter och slutförandekriterier förblir tillgängliga utan CSS eller JavaScript.
• Behåll strukturerad data på den omgivande sidan; uppfinn inte Checklist-schema.
• Bevara samma fält och ordning i alla tre plattformskartläggningar.
• Behåll skärmdumpskommentarer som instruktioner; hänvisa inte till saknad bild.

Klart när: tillstånd, etiketter, ordning och slutförandebetydelse överlever varje renderingsväg som stöds.

FAQ

Academy-mallen renderar de fem granskade frågorna i denna sidas [[faq]]-frontmatter. De täcker antal objekt, skillnaden från punktlistor och steglistor, sparat tillstånd och strukturerad data.