Spesifikasjonstabeller: format, regler og eksempler
Bygg spesifikasjonstabeller som gjør tekniske fakta enkle å skanne, sammenligne, spørre i og utvinne med semantisk markup, konsistente enheter og eksplisitte ukjente verdier.
En spesifikasjonstabell gjør fakta om ett emne om til eksplisitte etikett–verdi-par. En leser kan finne driftstemperaturen uten å lese en produktbeskrivelse på nytt, og en maskin kan bevare forholdet mellom «Driftstemperatur» og «−10 til 45 °C» uten å gjette hvilket tall som tilhører hvilken påstand.
| Brukskapasitet | 512 Wh |
|---|---|
| Kontinuerlig AC-utgang | 500 W |
| Dimensjoner (B × H × D) | 280 × 190 × 210 mm |
| Driftstemperatur | −10 til 45 °C |
| Vannmotstandsklasse | Ukjent |
| Drivstofftype | Ikke relevant |
Produktnavnet og verdiene over er illustrerende. Strukturen er produksjonsmodellen: ett emne, én presis etikett per rad, én verdi med sin enhet, og en eksplisitt status der en faktisk verdi ikke kan oppgis.
Hvorfor dette elementet betyr noe
Spesifikasjonstekst får lesere til å utføre unødvendig rekonstruksjon. Tenk på: «Enheten veier 6,4 kilo, leverer 500 watt kontinuerlig, måler 280 ganger 190 ganger 210 millimeter, og kan operere fra minus 10 til 45 grader Celsius.» Setningen er grammatisk korrekt, men en kjøper som bare ser etter dimensjoner, må tolke hver setningsdel. Å komme tilbake senere for å sjekke utgangen betyr å tolke den på nytt. En tabell flytter etikettene til en forutsigbar kant og verdiene til en andre kolonne, noe som reduserer minnearbeid og gjør skanning pålitelig.
Strukturen betyr like mye for maskiner. Maskinutvinnbarhet er evnen en crawler, et søkesystem, en assistent eller et nedstrøms publiseringsverktøy har til å bevare betydningen og relasjonene i innhold. Naturlig <table>, <th scope="row"> og <td>-markup angir at radoverskriften kvalifiserer den tilstøtende verdien. Det produserer et pålitelig par: «Brukskapasitet — 512 Wh». De samme to strengene innebygd i salgsfremmende setninger krever inferens på språknivå, og en stilsatt samling av urelaterte <div>-elementer kan eksponere visuell justering uten å eksponere en datarelasjon.
Spørrbart betyr ikke at hvert nettsted blir en database. Det betyr at hvert faktum har en stabil etikett, en diskret verdi og forutsigbar markup, slik at en leser eller et system kan spørre etter én egenskap uten å trekke ut hele avsnittet. Sammenlignbart betyr at separat publiserte produkter kan bruke de samme kanoniske etikettene og enhetene, slik at verdier kan justeres senere uten først å normalisere «omtrent en halv kilowatt», «500 watt» og «0,5 kW». En spesifikasjonstabell muliggjør den senere sammenligningen; den er ikke selv en sammenligning med mindre den viser flere emner side om side.
Når du skal bruke det
Bruk en spesifikasjonstabell når siden beskriver én enhet og lesere trenger minst tre diskrete, verifiserte fakta. Typiske emner inkluderer et produkt, programvareplan, API, filformat, anlegg, kjøretøy, organisasjon, tjenestepakke eller teknisk standard. Egnede fakta har avgrensede svar: dimensjoner, støttede operativsystemer, tilkoblingstype, svarformat, garantitid, juridisk navn, dekningsområde, versjon eller en oppgitt grense.
Bruk tekst rundt tabellen til å forklare konsekvenser. «Maksimal nyttelast: 18 kg» hører hjemme i tabellen; hvorfor den grensen utelukker en bestemt installasjon hører hjemme i tekst. Tabellen skal svare på «hva er verdien?» mens den omkringliggende forklaringen svarer på «hvorfor betyr det noe?»
Nære tilfeller er vanlige:
- Når to eller flere produkter må vurderes etter felles kriterier, bruk en sammenligningstabell i stedet. En spesifikasjonstabell har ett emne; å legge til flere verdikolonner endrer formålet.
- Når innholdet er en sekvens av hendelser, bruk en tidslinje. Datoer i en to-kolonne-tabell gjør ikke automatisk relasjonene kronologiske.
- Når hver rad trenger flere setninger med tolkning, bruk overskrifter og tekst. Tette avsnitt inne i celler hindrer skanning og blir vanskelige på smale skjermer.
- Når listen bare inneholder to enkle fakta, bruk en setning eller definisjonsliste med mindre innleggstypen krever en registrert spesifikasjonstabell. En tabell skal skape gjenfinningsverdi, ikke pynte på et lite faktum.
- Når verdier oppdateres kontinuerlig, koble elementet til en eid datakilde og vis en innhentingstid. En manuelt kopiert «live»-verdi blir misvisende så snart den endrer seg.
- Når dokumentet beskriver feltnavn, typer og valideringsbegrensninger, bruk den grupperte varianten nedenfor; ikke press hele datamodellen inn i én teksttung «Detaljer»-celle.
Skrivereglene for elementer har forrang: velg elementet basert på avsnittets formål, ikke etter overskriften eller utseendet. Hvis en blokks jobb er å vise spesifikasjoner, forblir den en spesifikasjonstabell selv når temaet kunne gjengitt de samme ordene som kort.
Hvor du skal plassere det
Plasser den første spesifikasjonstabellen etter at emnet er identifisert og før siden ber leseren om å tolke, konfigurere, sammenligne eller kjøpe det. På en produktside betyr det normalt etter den konsise produktbeskrivelsen og viktigste fordelen, men før detaljerte funksjonsforklaringer. I dokumentasjon, plasser en forutsetnings- eller protokolltabell umiddelbart før prosedyren som er avhengig av den. Lesere trenger å vite hva verdiene beskriver før de ser dem, men bør ikke måtte krysse en lang fortelling for å hente dem.
Hvis siden har flere kategorier, plasser hver tabell under en beskrivende H2 eller H3 som «Fysiske spesifikasjoner» eller «Kompatibilitet». Hold kategoritittelen utenfor tabellen; bildeteksten navngir da det presise emnet og omfanget. Behold samme etikettrekkefølge på søstersider slik at en leser ikke må lære mønsteret på nytt.
Ikke plasser en spesifikasjonstabell rett ved siden av en annen tett tabell, et skjermbilde i full bredde eller en animert karusell. To konkurrerende rutenett skaper en uklar lesevei og er spesielt vanskelige i nettbrettbredder. Ikke sett inn en handlingsknapp mellom en bildetekst og radene, plasser fotnoter i en urelatert komponent, eller legg et salgsfremmende krav i verdikolonnen. Hold bildetekst, tabell, statusforklaring, verifiseringsdato og kildehenvisning som én avgrenset enhet. Følg opp med forklaring før du introduserer et annet datatungt element.
Anatomi
Den merkede illustrasjonen må identifisere disse delene:
- Seksjonsoverskrift: navngir kategorien når en side har mer enn én tabell, for eksempel fysiske eller elektriske spesifikasjoner.
- Bildetekst: identifiserer emnet og det eksakte omfanget av tabellen. Den må gi mening utenfor den omkringliggende teksten.
- Radoverskrift: bruker det kanoniske, entydige navnet på én egenskap.
- Verdi: inneholder ett faktum snarere enn kommentarer eller et salgsargument.
- Enhet: vises med hver numerisk verdi med mindre verdien er virkelig enhetsløs.
- Statusverdi: skriver «Ukjent» eller «Ikke relevant» i stedet for å la en celle stå tom.
- Verifiseringsdato: oppgir når variable fakta sist ble kontrollert.
- Kildehenvisning: identifiserer primærsystemet, dokumentet, testen eller eieren som verdiene kom fra.
Ukjent betyr at egenskapen gjelder, men ingen pålitelig verdi var tilgjengelig på verifiseringstidspunktet. Ikke relevant betyr at egenskapens premiss ikke gjelder for dette emnet. Ikke tilgjengelig er igjen annerledes: det betyr at en egenskap eller et alternativ mangler. Null er en målt eller oppgitt verdi. En tom celle kommuniserer ingen av disse betydningene og er derfor ikke tillatt.
Designeksempler
Alle designvarianter beholder opprinnelig tabellmarkup, radoverskrifter, synlige etiketter, tekstverdier og en bildetekst. Stil kan endre tetthet og gruppering, men kan ikke gjøre faktaene om til et bilde eller la farge bære mening alene.
Standard to-kolonne: standarden for ett emne og tre til tolv fakta. Etiketter opptar den første kolonnen og verdier den andre. Bruk den for produkt-, bedrifts-, plan- og tjenestefakta.
Gruppert: to eller flere korte tabeller deler et større spesifikasjonssett etter leseroppgave. Hver gruppe får en overskrift og hver tabell beholder sin egen bildetekst. Ikke bruk sammenslåtte skillelinjerader som visuelle overskrifter, da de kompliserer navigasjon og utvinning.
Feltreferanse: en dokumentasjonsvariant for egenskaper hvis betydning krever konsistente sekundærfelt som type, krav og begrensning. Den første kolonnen bruker radoverskrift-semantikk, mens hver sekundærdimensjon har en kolonneoverskrift.
Kompakt mobil: etiketter og verdier brytes naturlig uten å redusere skriftstørrelsen. En enkel to-kolonne-tabell bør flyte innenfor beholderen. En bredere feltreferansevariant kan rulle inne i en merket, tastaturfokuserbar region; den må ikke få hele siden til å rulle horisontalt.
Parametere
Følgende kontrakt definerer det bærbare elementet. «Kilde» i den siste kolonnen angir hvor rendringsprogrammet henter parameteren, ikke hvor det faktiske kravet ble undersøkt.
| Navn | Type | Påkrevd | Min/maks | Standard | Kilde |
|---|---|---|---|---|---|
| title | Ren tekststreng | Nei | 3–10 ord | Fraværende | Første overskrift i brødteksten |
| caption | Ren tekststreng | Ja | 5–20 ord | Ingen | Attributt |
| variant | Enum: standard, grouped, field-reference, compact | Nei | Én verdi | standard | Attributt |
| verified | ISO 8601-dato eller dato-klokkeslett | Betinget | Én eksakt verdi | Ingen | Attributt |
| columns | Ordnet liste | Betinget | 2 for standard; 3–5 for feltreferanse | Spesifikasjon, Verdi | Overskriftsrad i brødtekst |
| rows | Ordnet liste med like lange rader | Ja | 3–12 per tabell anbefalt | Ingen | Brødtekst |
| source | Ren tekst med valgfri URL | Ja for eksternt hevdede eller variable fakta | 1–3 primærkilder | Ingen | Brødtekst etter tabell |
| status-legend | Etikett-til-betydning-kart | Betinget | Én definisjon per brukt status | Kanoniske betydninger | Brødtekst etter tabell |
Bruk verified når pris, kompatibilitet, tilgjengelighet, versjonsstøtte, kapasitet eller annen verdi kan endres. En publikasjonsdato er ikke en erstatning: den sier når siden ble publisert, ikke når spesifikasjonen ble kontrollert.
Syntaks og kodeeksempler
Alle implementasjoner kartlegger til samme bildetekst, ordnede rader, statusbetydninger, verifiseringsverdi og kilde. Den bærbare direktiven er den kanoniske forfatterskrevne formen.
Bærbar 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 akseptere navngitte parametere og gjengi pipe-table-brødteksten som semantiske tabellrader. Notasjonen nedenfor definerer den tiltenkte kartleggingen; det innebærer ikke at en ny lokal shortcode skal opprettes innenfor en artikkeloppgave.
{{< 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 >}}
Rendreren må utdata <table>, <caption>, <tbody>, <th scope="row"> og <td>. En feltreferansevariant trenger også <thead> med scope="col"-overskrifter. Den må bevare minustegn, multiplikasjonstegn, enhetsmellomrom og statustekst nøyaktig.
WordPress-blokk
<!-- 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-implementasjon kan bruke redigerbare blokk-kontroller i stedet for bokstavelig HTML, men dens lagrede attributter og server-renderte utdata må bevare samme kontrakt. Forfattere må ikke erstatte med et skjermbilde eller en generisk kolonneblokk.
Eksempler
Bra: komplette, normaliserte produktfakta
| Forsyningsspenning | 12–24 V DC |
|---|---|
| Strømforbruk | 2,4 W maksimalt |
| Kabellengde | 3 m |
| Driftstemperatur | −20 til 60 °C |
| Inntrengingsbeskyttelse | IP67 |
| Utskiftbart batteri | Ikke relevant |
Verifisert: 27. august 2026. Kilde: illustrerende godkjent installasjonsark, revisjon 2.
Dette fungerer fordi bildeteksten identifiserer ett emne og én kontekst. Hver etikett navngir en testbar egenskap, områder beholder sine enheter, dimensjoner blander ikke systemer, og maksimal effekt er skilt fra typisk effekt. «Ikke relevant» er berettiget fordi en kablet sensor ikke har noe batteri å skifte; det skjuler ikke en ukjent batterispesifikasjon. Tabellen kan skannes av en person, navigeres via radoverskrift, eller transformeres til diskrete egenskaps–verdi-par.
Dårlig: tvetydige pseudo-data
| Strøm | Lav |
|---|---|
| Kabel | 3 |
| Temperatur | −20–140° |
| Beskyttelse | Solid og værbestandig |
| Batteri | |
| Kompatibilitet | Fungerer med de fleste systemer og er enkel å installere i nesten alle miljøer |
Den dårlige tabellen ser organisert ut, men gir ikke pålitelige data. «Strøm» kan bety forsyningsspenning eller forbruk, mens «Lav» ikke er målbart. Kabellengde mangler enhet. Temperaturraden navngir ikke Celsius eller Fahrenheit og ser ut til å blande et område med et gradetegn. «Solid» er salgsspråk snarere enn en inntrengingsbeskyttelsesklasse. Den tomme battericellen sier ikke om faktaet er ukjent, irrelevant, null eller utilsiktet utelatt. Kompatibilitetspåstanden pakker en udefinert populasjon og installasjonsvurdering inn i én celle.
Reparer det ved å dele brede etiketter opp i kanoniske egenskaper, hente verdier fra en navngitt primærkilde, legge til enhet på hver måling, og erstatte tomme felt med korrekt status. Hvis kilden ikke oppgir inntrengingsklassen, skriv «Ukjent»; ikke gjør markedsføringsspråk om til en oppdiktet teknisk verdi.
Skjemamarkup og tilgjengelighet
Det finnes ingen generell Schema.org-type for en spesifikasjonstabell. Tabellen forblir verdifull semantisk HTML selv når den ikke produserer JSON-LD. Når den omsluttende siden representerer en kvalifiserende enhet, kartlegg kun eksakte, verifiserte fakta til støttede egenskaper: for eksempel et produkts sku, weight, width, height, depth, material eller additionalProperty-oppføringer der det er hensiktsmessig. Organisasjonsfakta kan kartlegges til egenskaper som juridisk navn eller adresse. Den synlige tabellen og strukturerte data må samsvare, bruke samme enheter og komme fra samme kilde. Ikke oppfinn vurderinger, tilbud, identifikatorer eller skjemaegenskaper fordi en rad finnes.
Tilgjengelighet begynner med ekte markup. Gi tabellen en beskrivende <caption>. Bruk <th scope="row"> for hver spesifikasjonsetikett; feltreferansevarianter trenger også <th scope="col"> i en <thead>. Hold leserekkefølgen logisk i kilden, ikke bare på skjermen. Ikke bruk tomme celler, sammenslåtte celler, ikon-only-statuser, farge-only-gruppering eller verktøytips som eneste plassering av en verdi. Forkortelser som AC, DC og IP bør forklares i nærliggende tekst når målgruppen kanskje ikke kjenner dem.
En grunnleggende to-kolonne-tabell bør brytes naturlig i stedet for å rulle når det er praktisk mulig. Når en bredere tabell krever horisontal rulling, hold den i en region med en tilgjengelig merkelapp og tabindex="0", bevar en synlig tastaturfokusindikator, og lås aldri den første kolonnen på en måte som dekker verdier ved høy zoom. Test ved 200 % zoom, med tastaturnavigasjon og med stilark slått av; etikett–verdi-forholdet må overleve alle tre.
Skriveregler
Reglene beskytter gjenfinning og sammenligning, så presisjon kommer før kompakthet:
- Bruk 3–12 rader per tabell. Del lengre sett etter leseroppgave — fysisk, elektrisk, kompatibilitet, kommersielt — i stedet for å lage en udifferensiert vegg av fakta.
- Hold etiketter på 1–6 ord der det er mulig. Bruk et kvalifikator som «maksimal», «typisk», «installert» eller «per bruker» når det endrer betydningen.
- Hold en normal verdi til én linje og høyst 12 ord. Flytt tolkning, unntak og anbefalinger til tilstøtende tekst eller en direkte tilknyttet merknad.
- Bruk ett målesystem per tabell med mindre målgruppen virkelig trenger begge. Når begge er påkrevd, presenter primærverdien først og konverteringen i parentes for hver relevant rad.
- Sett enhet ved siden av hver numerisk måling:
512 Wh,3 mog45 °C. Stol aldri på at en overskrift leverer enhet til bare noen rader. - Normaliser tilsvarende egenskaper på tvers av søstersider. Velg én etikett og én enhet — for eksempel «Vekt» i kilo — og ikke veksle med «Masse», pund eller vage fraser uten en dokumentert grunn.
- Bruk eksakte statusord:
Unknown,Not applicableellerNot available. Definer dem én gang når mer enn én status vises. Bruk aldri bindestrek, tom celle,TBC, spørsmålstegn eller farge for å antyde status. - Bruk en faktabasert, nøytral tone. Verdier kan være gunstige, men ord som «fantastisk», «ultraskjapp», «best-i-klassen» og «generøs» er konklusjoner, ikke spesifikasjoner.
- Sett aldri handlingsknapper, attester, avsnitt med salgstekst, uforklarte poengsummer, ubegrunnede sammenligninger eller dekorative bilder inne i en verdicelle.
- Oppgi kilden og en eksakt verifiseringsdato for variable eller eksternt hevdede verdier. Hvis eierskap er uklart, er tabellen ikke klar for publisering.
Innleggstyper som bruker det
postTypes-feltet i front matter styrer de godkjente bruksområdene nedenfor. Inkludering betyr at innleggstypen kan kreve eller ha nytte av elementet; det betyr ikke at hver side må fremstille tre fakta for å tilfredsstille en layout.
| Innleggstype | Typisk emne | Bruk tabellen til |
|---|---|---|
| produktside | Ett produkt eller én modell | Dimensjoner, kapasitet, materialer, kompatibilitet, garanti og identifikatorer |
| kategoriside | Én definert kategori | Felles kategori-begrensninger eller et representativt spesifikasjonsvokabular, ikke produkt-sammenligning |
| kjøpeguide | Ett vurdert element innenfor guiden | Beslutningsrelevante fakta som støtter tekstvurderingen |
| funksjonsside | Én programvareegenskap | Grenser, støttede formater, tillatelser, tilgjengelighet og krav |
| integrasjonsside | Én systemtilkobling | Autentisering, synkroniseringsretning, støttede objekter, frekvens og plankrav |
| dokumentasjonsartikkel | Ett API, én fil, én kommando eller ett konfigurasjonsobjekt | Felt, typer, aksepterte verdier, standardverdier, grenser og forutsetninger |
| bedriftsprofil | Én organisasjon | Juridisk navn, stiftelsesdato, hovedkontor, identifikatorer, eierskap og verifisert omfang |
| leverandørprofil | Én leverandør | Dekning, sertifiseringer, tjenestemodell, kontraktsfakta og støttekanaler |
QA-sjekkliste
- Tabellen beskriver ett tydelig identifisert emne; flere alternativer er ikke forkledd som en spesifikasjonstabell.
- Bildeteksten navngir både emnet og tabellens omfang.
- Hver egenskap bruker en presis, kanonisk etikett og hver celle inneholder én verdi.
- Numeriske verdier inkluderer konsistente enheter, kvalifikatorer, områder og dimensjoner.
- Ingen celle er tom;
Ukjent,Ikke relevantogIkke tilgjengeligbrukes kun med sine definerte betydninger. - Påstander samsvarer med en navngitt primærkilde, og variable fakta viser en eksakt verifiseringsdato.
- Den publiserte utdataen bruker naturlig
<table>,<caption>, radoverskrifter og dataceller i stedet for et bilde eller et visuelt rutenett. - Feltreferansevarianter inkluderer kolonneoverskrifter og bevarer alle overskrifterelasjoner.
- Tabellen fungerer ved smale bredder, 200 % zoom, med tastaturnavigasjon og med stilark slått av.
- Farge, ikoner, forkortelser og verktøytips er aldri den eneste måten å forstå en verdi på.
- Synlige fakta og eventuelle kvalifiserende Schema.org-egenskaper samsvarer nøyaktig.
- Salgsfremmende påstander, tolkning, handlingsknapper og lang tekst er plassert utenfor tabellen.
- Elementet følger playbookens forrangsregel, og den valgte innleggstypen inkluderer elementet i sin innholdskontrakt.
Flere veiledninger i denne delen
Klar til å sette det ut i livet?
Gratis sjekk · 7 dagers prøveperiode · ingen kredittkort