Specifikationstabeller: Format, regler og eksempler
Opbyg specifikationstabeller, der gør tekniske fakta lette at scanne, sammenligne, forespørge og udtrække med semantisk markup, konsistente enheder og eksplicitte ukendte værdier.
En specifikationstabel omdanner fakta om ét emne til eksplicitte etiket–værdi-par. En læser kan finde driftstemperaturen uden at genlæse en produktbeskrivelse, og en maskine kan bevare forholdet mellem “Driftstemperatur” og “−10 til 45 °C” uden at gætte på, hvilket tal der hører til hvilken påstand.
| Brugbar kapacitet | 512 Wh |
|---|---|
| Kontinuerlig AC-udgang | 500 W |
| Mål (B × H × D) | 280 × 190 × 210 mm |
| Driftstemperatur | −10 til 45 °C |
| Vandtæthedsklassifikation | Ukendt |
| Brændstoftype | Ikke relevant |
Produktnavnet og værdierne ovenfor er illustrative. Strukturen er produktionsmodellen: ét emne, én præcis etiket pr. række, én værdi med dens enhed og en eksplicit status, hvor en faktuel værdi ikke kan leveres.
Hvorfor dette element er vigtigt
Specifikationsprosa får læsere til at udføre unødvendig rekonstruktion. Overvej: “Enheden vejer 6,4 kg, leverer 500 watt kontinuerligt, måler 280 gange 190 gange 210 millimeter og kan fungere fra minus 10 til 45 grader Celsius.” Sætningen er grammatisk korrekt, men en køber, der kun leder efter mål, må analysere hver sætning. At vende tilbage senere for at tjekke udgangseffekten betyder at analysere den igen. En tabel flytter etiketterne til en forudsigelig kant og værdierne til en anden kolonne, hvilket reducerer hukommelsesarbejde og gør scanning pålidelig.
Strukturen betyder lige så meget for maskiner. Maskinekstraherbarhed er evnen hos en crawler, søgesystem, assistent eller downstream-publiceringsværktøj til at bevare betydningen og relationerne i indhold. Indbygget <table>, <th scope="row"> og <td> markup angiver, at rækkeoverskriften kvalificerer den tilstødende værdi. Det producerer et pålideligt par: “Brugbar kapacitet — 512 Wh.” De samme to strenge indlejret blandt salgsfremmende sætninger kræver sproglig inferens, og en stylesamling af uafhængige <div>-elementer kan eksponere visuel justering uden at eksponere en datarelation.
Forespørgelig betyder ikke, at hver hjemmeside bliver en database. Det betyder, at hvert faktum har en stabil etiket, en diskret værdi og forudsigeligt markup, så en læser eller et system kan spørge efter én egenskab uden at udtrække hele afsnittet. Sammenlignelig betyder, at separat publicerede produkter kan bruge de samme kanoniske etiketter og enheder, så værdier kan sammenstilles senere uden først at normalisere “omkring en halv kilowatt,” “500 watt” og “0,5 kW.” En specifikationstabel muliggør den senere sammenligning; den er ikke i sig selv en sammenligning, medmindre den præsenterer flere emner side om side.
Hvornår skal det bruges
Brug en specifikationstabel, når siden beskriver én enhed, og læsere har brug for mindst tre diskrete, verificerede fakta. Typiske emner inkluderer et produkt, softwareplan, API, filformat, facilitet, køretøj, organisation, servicepakke eller teknisk standard. Egnede fakta har afgrænsede svar: dimensioner, understøttede operativsystemer, stiktype, svarformat, garantiperiode, juridisk navn, dækningsområde, version eller en angivet grænse.
Brug prosa omkring tabellen til at forklare konsekvenser. “Maksimal nyttelast: 18 kg” hører til i tabellen; hvorfor den grænse udelukker en bestemt installation hører til i prosa. Tabellen skal besvare “hvad er værdien?” mens den omkringliggende forklaring besvarer “hvorfor betyder det noget?”
Næsten-mis-forhold er almindelige:
- Når to eller flere produkter skal vurderes ud fra fælles kriterier, brug i stedet en sammenligningstabel . En specifikationstabel har ét emne; at tilføje flere værdikolonner ændrer dens formål.
- Når indholdet er en række af hændelser, brug en tidslinje. Datoer i en to-kolonne tabel gør ikke automatisk relationerne kronologiske.
- Når hver række har brug for flere sætninger med fortolkning, brug overskrifter og prosa. Tætte afsnit inde i celler besejrer scanning og bliver svære på små skærme.
- Når listen kun indeholder to simple fakta, brug en sætning eller en definitionsliste, medmindre indlægstypen kræver en registreret specifikationstabel. En tabel skal skabe genfindingsværdi, ikke dekorere en lille faktum.
- Når værdier opdateres kontinuerligt, forbind elementet til en ejet datakilde og vis et hentningstidspunkt. En manuelt kopieret “live”-værdi bliver vildledende, så snart den afviger.
- Når dokumentet beskriver feltnavne, typer og valideringsbegrænsninger, brug den grupperede variant nedenfor; pres ikke hele datamodellen ind i én prosa-tung “Detaljer”-celle.
Elementets skriveregler har forrang: vælg elementet ud fra passagens formål, ikke dens overskrift eller udseende. Hvis en bloks opgave er at præsentere specifikationer, forbliver det en specifikationstabel, selv når temaet kunne gengive de samme ord som kort.
Hvor skal den placeres
Placer den første specifikationstabel efter at emnet er blevet identificeret og før siden beder læseren om at fortolke, konfigurere, sammenligne eller købe det. På en produktside betyder det normalt efter den kortfattede produktbeskrivelse og primære fordel, men før detaljerede funktionsforklaringer. I dokumentation skal du placere en forudsætnings- eller protokoltabel umiddelbart før den procedure, der afhænger af den. Læsere har brug for at vide, hvad værdierne beskriver, før de ser dem, men bør ikke skulle krydse en lang fortælling for at hente dem.
Hvis siden har flere kategorier, placer hver tabel under en beskrivende H2 eller H3 såsom “Fysiske specifikationer” eller “Kompatibilitet.” Behold kategorititlen uden for tabellen; billedteksten navngiver derefter det præcise emne og omfang. Bevar samme etiketrækkefølge på søstersider, så en læser ikke skal genlære mønsteret.
Placer ikke en specifikationstabel direkte ved siden af en anden tæt tabel, et fuldbreddeskærmbillede eller en animeret karrusel. To konkurrerende gitre skaber en uklar læsebane og er især akavet ved tabletbredder. Indsæt ikke et call to action mellem en billedtekst og dens rækker, placer ikke fodnoter i en ikke-relateret komponent, og læg ikke et salgsfremmende udsagn i værdikolonnen. Hold billedtekst, tabel, statusforklaring, verifikationsdato og kildehenvisning som én afgrænset enhed. Følg op med forklaring, før du introducerer et andet datatungt element.
Anatomi
Det mærkede billede skal identificere disse dele:
- Sektionsoverskrift: navngiver kategorien, når en side har mere end én tabel, såsom fysiske eller elektriske specifikationer.
- Billedtekst: identificerer emnet og det præcise omfang af tabellen. Den skal give mening uden for det omkringliggende afsnit.
- Rækkeoverskrift: bruger det kanoniske, entydige navn på én egenskab.
- Værdi: indeholder ét faktum frem for kommentar eller et salgsudsagn.
- Enhed: vises med enhver numerisk værdi, medmindre værdien er ægte enhedsløs.
- Statusværdi: staver “Ukendt” eller “Ikke relevant” frem for at efterlade en tom celle.
- Verifikationsdato: angiver, hvornår volatile fakta sidst blev kontrolleret.
- Kildehenvisning: identificerer det primære system, dokument, test eller ejer, som værdierne stammer fra.
Ukendt betyder, at egenskaben gælder, men ingen troværdig værdi var tilgængelig på verifikationstidspunktet. Ikke relevant betyder, at egenskabens præmis ikke gælder for dette emne. Ikke tilgængelig er noget andet: det betyder, at en funktion eller mulighed er fraværende. Nul er en målt eller oplyst værdi. En tom celle kommunikerer ingen af disse betydninger og er derfor ikke tilladt.
Designeksempler
Hver designvariant bevarer indbygget tabelmarkup, rækkeoverskrifter, synlige etiketter, tekstværdier og en billedtekst. Styling kan ændre tæthed og gruppering, men den kan ikke gøre fakta til et billede eller lade farve bære betydning alene.
Standard to-kolonne: standarden for ét emne og tre til tolv fakta. Etiketter optager første kolonne og værdier den anden. Brug den til produkt-, virksomheds-, plan- og servicefakta.
Grupperet: to eller flere korte tabeller deler et større specifikationssæt op efter læserens opgave. Hver gruppe får en overskrift, og hver tabel beholder sin egen billedtekst. Brug ikke sammenflettede separatorrækker som visuelle overskrifter, da de komplicerer navigation og ekstraktion.
Felthåndbog: en dokumentationsvariant for egenskaber, hvis betydning kræver konsistente sekundære felter såsom type, krav og begrænsning. Første kolonne bruger rækkeoverskrifts-semantik, mens hver sekundær dimension har en kolonneoverskrift.
Kompakt mobil: etiketter og værdier brydes naturligt uden at reducere skriftstørrelsen. En simpel to-kolonne tabel skal kunne flyde inden for sin beholder. En bredere felthåndbogsvariant kan scrolle inden i en mærket, tastaturfokusérbar region; den må ikke få hele siden til at scrolle vandret.
Parametre
Følgende kontrakt definerer det portable element. “Kilde” i den sidste kolonne angiver, hvor rendereren henter parameteren, ikke hvor det faktuelle krav blev undersøgt.
| Navn | Type | Påkrævet | Min/maks | Standard | Kilde |
|---|---|---|---|---|---|
| title | Almindelig streng | Nej | 3–10 ord | Fraværende | Første overskrift i brødtekst |
| caption | Almindelig streng | Ja | 5–20 ord | Ingen | Attribut |
| variant | Enum: standard, grouped, field-reference, compact | Nej | Én værdi | standard | Attribut |
| verified | ISO 8601-dato eller dato-tid | Betinget | Én præcis værdi | Ingen | Attribut |
| columns | Ordnet liste | Betinget | 2 for standard; 3–5 for felthåndbog | Specifikation, Værdi | Overskriftsrække i brødtekst |
| rows | Ordnet liste af lige lange rækker | Ja | 3–12 pr. tabel anbefales | Ingen | Brødtekst |
| source | Almindelig tekst med valgfri URL | Ja for eksternt hævdede eller volatile fakta | 1–3 primære kilder | Ingen | Brødtekst efter tabel |
| status-legend | Etiket-til-betydning-kort | Betinget | Én definition pr. anvendt status | Kanoniske betydninger | Brødtekst efter tabel |
Brug verified når altid pris, kompatibilitet, tilgængelighed, versionssupport, kapacitet eller en anden værdi kan ændre sig. En udgivelsesdato er ikke en erstatning: den fortæller, hvornår siden blev udgivet, ikke hvornår specifikationen blev kontrolleret.
Syntaks og kodeeksempler
Alle implementationer kortlægger til den samme billedtekst, ordnede rækker, statusbetydninger, verifikationsværdi og kilde. Det portable direktiv er den kanoniske, forfattede form.
Portabel Markdown-direktiv
:::spec-table{caption="Northstar Field 500 — core specifications" verified="2026-08-27"}
| Specification | Value |
|---|---|
| Usable capacity | 512 Wh |
| Continuous AC output | 500 W |
| Dimensions (W × H × D) | 280 × 190 × 210 mm |
| Water-resistance rating | Unknown |
| Fuel type | Not applicable |
Status: Unknown = relevant but not verified; Not applicable = cannot apply.
Source: approved product data sheet, revision 4.
:::
Hugo shortcode
Hugo-adapteren bør kun acceptere navngivne parametre og gengive pipe-table-brødteksten som semantiske tabelrækker. Notationen nedenfor definerer den tiltænkte kortlægning; det indebærer ikke, at en ny lokal shortcode skal oprettes inden for en artikelopgave.
{{< spec-table caption="Northstar Field 500 — core specifications" verified="2026-08-27" >}}
| Specification | Value |
|---|---|
| Usable capacity | 512 Wh |
| Continuous AC output | 500 W |
| Dimensions (W × H × D) | 280 × 190 × 210 mm |
| Water-resistance rating | Unknown |
| Fuel type | Not applicable |
Status: Unknown = relevant but not verified; Not applicable = cannot apply.
Source: approved product data sheet, revision 4.
{{< /spec-table >}}
Rendereren skal udskrive <table>, <caption>, <tbody>, <th scope="row"> og <td>. En felthåndbogsvariant har også brug for <thead> med scope="col"-overskrifter. Den skal bevare minustegn, gangetegn, enhedsmellemrum og statustekst nøjagtigt.
WordPress-blok
<!-- wp:amicited/spec-table {"caption":"Northstar Field 500 — core specifications","verified":"2026-08-27","variant":"standard"} -->
<table>
<tbody>
<tr><th scope="row">Usable capacity</th><td>512 Wh</td></tr>
<tr><th scope="row">Continuous AC output</th><td>500 W</td></tr>
<tr><th scope="row">Dimensions (W × H × D)</th><td>280 × 190 × 210 mm</td></tr>
<tr><th scope="row">Water-resistance rating</th><td>Unknown</td></tr>
<tr><th scope="row">Fuel type</th><td>Not applicable</td></tr>
</tbody>
</table>
<p class="spec-table__status">Unknown = relevant but not verified; Not applicable = cannot apply.</p>
<p class="spec-table__source">Source: approved product data sheet, revision 4.</p>
<!-- /wp:amicited/spec-table -->
En WordPress-implementation kan bruge redigerbare blokkontroller frem for bogstavelig HTML, men dens gemte attributter og server-gengivne output skal bevare samme kontrakt. Forfattere må ikke erstatte med et skærmbillede eller en generisk kolonneblok.
Eksempler
God: komplette, normaliserede produktfakta
| Forsyningsspænding | 12–24 V DC |
|---|---|
| Strømforbrug | 2,4 W maksimum |
| Kabellængde | 3 m |
| Driftstemperatur | −20 til 60 °C |
| Indtrængningsbeskyttelsesklasse | IP67 |
| Udskifteligt batteri | Ikke relevant |
Verificeret: 27. august 2026. Kilde: illustrativt godkendt installationsark, revision 2.
Dette virker, fordi billedteksten identificerer ét emne og én kontekst. Hver etiket navngiver en testbar egenskab, intervaller beholder deres enheder, dimensioner blander ikke systemer, og maksimal effekt er adskilt fra typisk effekt. “Ikke relevant” er berettiget, fordi en kablet sensor ikke har noget batteri at udskifte; det skjuler ikke en ukendt batterispecifikation. Tabellen kan scannes af en person, navigeres via rækkeoverskrifter eller omdannes til diskrete egenskab–værdi-par.
Dårlig: tvetydig pseudo-data
| Strøm | Lav |
|---|---|
| Kabel | 3 |
| Temperatur | −20–140° |
| Beskyttelse | Robust og vejrklar |
| Batteri | |
| Kompatibilitet | Virker med de fleste systemer og er let at installere i næsten alle miljøer |
Den dårlige tabel ser organiseret ud, men giver ikke pålidelige data. “Strøm” kunne betyde forsyningsspænding eller forbrug, mens “Lav” ikke er målbart. Kabellængde mangler en enhed. Temperaturrækken angiver ikke Celsius eller Fahrenheit og ser ud til at blande et interval med et gradtegn. “Robust” er salgssprog frem for en indtrængningsbeskyttelsesklasse. Den tomme battericelle fortæller ikke, om faktum er ukendt, irrelevant, nul eller utilsigtet udeladt. Kompatibilitetspåstanden samler en udefineret population og installationsvurdering i én celle.
Reparer det ved at opdele brede etiketter i kanoniske egenskaber, hente værdier fra en navngiven primær kilde, tilføje en enhed til hver måling og erstatte tomme felter med den korrekte status. Hvis kilden ikke angiver indtrængningsbeskyttelsesklassen, skriv “Ukendt”; konverter ikke marketingsprog til en opfundet teknisk værdi.
Schema-markup og tilgængelighed
Der findes ingen generel Schema.org-type for en specifikationstabel. Tabellen forbliver værdifuld semantisk HTML, selv når den ikke producerer nogen JSON-LD. Når den omsluttende side repræsenterer en kvalificerende enhed, kortlæg kun nøjagtige, verificerede fakta til understøttede egenskaber: for eksempel et produkts sku, weight, width, height, depth, material eller additionalProperty-poster, hvor det er passende. Organisationsfakta kan kortlægges til egenskaber såsom juridisk navn eller adresse. Den synlige tabel og strukturerede data skal være enige, bruge de samme enheder og komme fra samme kilde. Opfind ikke vurderinger, tilbud, identifikatorer eller schema-egenskaber, fordi en række findes.
Tilgængelighed begynder med rigtigt markup. Giv tabellen en beskrivende <caption>. Brug <th scope="row"> for hver specifikationsetiket; felthåndbogsvarianter har også brug for <th scope="col"> i en <thead>. Hold læserækkefølgen logisk i kilden, ikke kun på skærmen. Brug ikke tomme celler, sammenflettede celler, ikon-only-statusser, farve-only-gruppering eller tooltips som den eneste placering af en værdi. Forkortelser som AC, DC og IP bør udvides i nærliggende prosa, når målgruppen muligvis ikke kender dem.
En grundlæggende to-kolonne tabel bør brydes frem for at scrolle, når det er praktisk muligt. Når en bredere tabel kræver vandret scroll, hold den i en region med en tilgængelig etiket og tabindex="0", bevar en synlig tastaturfokusindikator, og lås aldrig den første kolonne på en måde, der dækker værdier ved høj zoom. Test ved 200 % zoom, med tastaturnavigation og med styles deaktiveret; etiket–værdi-forholdet skal overleve alle tre.
Skriveregler
Reglerne beskytter genfinding og sammenligning, så præcision kommer før kompakthed:
- Brug 3–12 rækker pr. tabel. Del længere sæt op efter læserens opgave—fysisk, elektrisk, kompatibilitet, kommerciel—frem for at skabe en udifferentieret mur af fakta.
- Hold etiketter på 1–6 ord, hvor det er muligt. Brug en kvalifikation som “maksimal,” “typisk,” “installeret” eller “pr. bruger,” når det ændrer betydningen.
- Hold en normal værdi på én linje og højst 12 ord. Flyt fortolkning, undtagelser og anbefalinger til tilstødende prosa eller en direkte tilknyttet note.
- Brug ét målesystem pr. tabel, medmindre publikum reelt har brug for begge. Når begge er påkrævet, præsenter den primære værdi først og konverteringen i parentes for hver relevant række.
- Sæt en enhed ved hver numerisk måling:
512 Wh,3 mog45 °C. Stol aldrig på, at en overskrift leverer en enhed til kun nogle rækker. - Normaliser ækvivalente egenskaber på tværs af søstersider. Vælg én etiket og én enhed—såsom “Vægt” i kilogram—og skift ikke med “Masse,” pund eller vage vendinger uden en dokumenteret grund.
- Brug præcise statusord:
Ukendt,Ikke relevantellerIkke tilgængelig. Definér dem én gang, når mere end én status optræder. Brug aldrig en bindestreg, tom celle,TBC, spørgsmålstegn eller farve til at antyde status. - Brug en faktuel, neutral tone. Værdier kan være gunstige, men ord som “fantastisk,” “ultra-hurtig,” “bedst-i-klassen” og “generøs” er konklusioner, ikke specifikationer.
- Placer aldrig call to action, udtalelser, afsnit med salgskopi, uforklarede scores, uunderstøttede sammenligninger eller dekorative billeder inde i en værdicelle.
- Angiv kilden og en præcis verifikationsdato for volatile eller eksternt hævdede værdier. Hvis ejerskab er uklart, er tabellen ikke klar til offentliggørelse.
Indlægstyper, der bruger det
postTypes-frontmatter-feltet driver de godkendte anvendelser nedenfor. Inklusion betyder, at indlægstypen kan kræve eller have gavn af elementet; det betyder ikke, at hver side skal fremstille tre fakta for at tilfredsstille et layout.
| Indlægstype | Typisk emne | Brug tabellen til |
|---|---|---|
| produktside | Ét produkt eller én model | Dimensioner, kapacitet, materialer, kompatibilitet, garanti og identifikatorer |
| kategoriside | Én defineret kategori | Fælles kategori-begrænsninger eller et repræsentativt specifikationsvokabular, ikke produktsammenligning |
| købsguide | Ét evalueret emne inden for guiden | Beslutningsrelevante fakta, der understøtter prose-vurderingen |
| funktionsside | Én softwarekapacitet | Grænser, understøttede formater, tilladelser, tilgængelighed og krav |
| integrationsside | Én systemforbindelse | Godkendelse, synkroniseringsretning, understøttede objekter, frekvens og plankrav |
| dokumentationsartikel | Ét API, fil, kommando eller konfigurationsobjekt | Felter, typer, accepterede værdier, standarder, grænser og forudsætninger |
| virksomhedsprofil | Én organisation | Juridisk navn, stiftelsesdato, hovedkontor, identifikatorer, ejerskab og verificeret omfang |
| leverandørprofil | Én leverandør | Dækning, certificeringer, servicemodel, kontraktfakta og supportkanaler |
QA-tjekliste
- Tabellen beskriver ét klart identificeret emne; flere muligheder er ikke blevet forklædt som en specifikationstabel.
- Billedteksten navngiver både emnet og tabellens omfang.
- Hver egenskab bruger en præcis, kanonisk etiket, og hver celle indeholder én værdi.
- Numeriske værdier inkluderer konsistente enheder, kvalifikationer, intervaller og dimensioner.
- Ingen celle er tom;
Ukendt,Ikke relevantogIkke tilgængeligbruges kun med deres definerede betydninger. - Påstande matcher en navngiven primær kilde, og volatile fakta viser en præcis verifikationsdato.
- Det publicerede output bruger indbygget
<table>,<caption>, rækkeoverskrifter og dataceller frem for et billede eller visuelt gitter. - Felthåndbogsvarianten inkluderer kolonneoverskrifter og bevarer alle overskriftsrelationer.
- Tabellen fungerer ved smalle bredder, 200 % zoom, med tastaturnavigation og med styles deaktiveret.
- Farve, ikoner, forkortelser og tooltips er aldrig den eneste måde at forstå en værdi på.
- Synlige fakta og eventuelle kvalificerende Schema.org-egenskaber stemmer nøjagtigt overens.
- Salgsfremmende påstande, fortolkning, call to action og lang prosa sidder uden for tabellen.
- Elementet følger playbook’ens forrangregel, og den valgte indlægstype inkluderer elementet i sin indholdskontrakt.
Flere tutorials i dette afsnit
Klar til at føre det ud i livet?
Gratis tjek · 7-dages prøveperiode · intet kreditkort