Špecifikačné tabuľky: Formát, pravidlá a príklady

Špecifikačná tabuľka mení fakty o jednom subjekte na explicitné dvojice označenie–hodnota. Čitateľ nájde prevádzkovú teplotu bez opätovného čítania popisu produktu a stroj dokáže zachovať vzťah medzi „Prevádzková teplota“ a „−10 až 45 °C“ bez toho, aby musel hádať, ktoré číslo patrí ktorému tvrdeniu.

Názov produktu a hodnoty vyššie sú ilustračné. Štruktúra je produkčný model: jeden subjekt, jedno presné označenie na riadok, jedna hodnota s jednotkou a explicitný stav tam, kde faktickú hodnotu nemožno poskytnúť.

Prečo na tomto prvku záleží

Špecifikačný text núti čitateľov vykonávať vyhýbateľnú rekonštrukciu. Predstavte si: „Jednotka váži 6,4 kilogramu, dodáva 500 wattov nepretržite, meria 280 krát 190 krát 210 milimetrov a môže pracovať od mínus 10 do 45 stupňov Celzia.“ Veta je gramaticky správna, ale kupujúci, ktorý hľadá len rozmery, musí analyzovať každú časť. Neskorší návrat na kontrolu výstupu znamená opätovnú analýzu. Tabuľka presúva označenia na predvídateľný okraj a hodnoty do druhého stĺpca, čím znižuje pamäťovú prácu a robí skenovanie spoľahlivým.

Štruktúra je rovnako dôležitá pre stroje. Strojová extrahovateľnosť je schopnosť prehľadávača, vyhľadávacieho systému, asistenta alebo nadväzujúceho publikačného nástroja zachovať význam a vzťahy v obsahu. Natívne značenie <table>, <th scope="row"> a <td> vyjadruje, že hlavička riadku kvalifikuje priľahlú hodnotu. Vytvára spoľahlivý pár: „Využiteľná kapacita — 512 Wh.“ Rovnaké dva reťazce vložené medzi propagačné vety vyžadujú inferenciu na úrovni jazyka a upravená kolekcia nesúvisiacich prvkov <div> môže odhaliť vizuálne zarovnanie bez odhalenia dátového vzťahu.

Dopytovateľnosť neznamená, že každá webová stránka sa stane databázou. Znamená to, že každý fakt má stabilné označenie, diskrétnu hodnotu a predvídateľné značenie, takže čitateľ alebo systém môže požiadať o jednu vlastnosť bez extrahovania celého odseku. Porovnateľnosť znamená, že samostatne publikované produkty môžu používať rovnaké kanonické označenia a jednotky, čo umožňuje neskoršie zosúladenie hodnôt bez najprv normalizácie „asi pol kilowattu“, „500 wattov“ a „0,5 kW“. Špecifikačná tabuľka umožňuje toto neskoršie porovnanie; sama o sebe nie je porovnaním, pokiaľ neprezentuje viacero subjektov vedľa seba.

Kedy ju použiť

Použite špecifikačnú tabuľku, keď stránka opisuje jednu entitu a čitatelia potrebujú aspoň tri diskrétne, overené fakty. Typické subjekty zahŕňajú produkt, softvérový plán, API, formát súboru, zariadenie, vozidlo, organizáciu, balík služieb alebo technickú normu. Vhodné fakty majú ohraničené odpovede: rozmery, podporované operačné systémy, typ konektora, formát odpovede, záručná doba, právny názov, oblasť pokrytia, verzia alebo stanovený limit.

Použite text okolo tabuľky na vysvetlenie dôsledkov. „Maximálne užitočné zaťaženie: 18 kg“ patrí do tabuľky; prečo tento limit vylučuje konkrétnu inštaláciu, patrí do textu. Tabuľka by mala odpovedať na otázku „aká je hodnota?“, zatiaľ čo okolité vysvetlenie odpovedá na otázku „prečo na tom záleží?“

Bežné prípady, ktoré sa takmer prekrývajú:

• Keď sa dva alebo viac produktov musí posudzovať podľa spoločných kritérií, použite namiesto toho porovnávaciu tabuľku . Špecifikačná tabuľka má jeden subjekt; pridanie niekoľkých stĺpcov hodnôt mení jej účel.
• Keď je obsahom postupnosť udalostí, použite časovú os. Dátumy v dvojstĺpcovej tabuľke automaticky nevytvárajú chronologické vzťahy.
• Keď každý riadok potrebuje niekoľko viet interpretácie, použite nadpisy a text. Husté odseky vo vnútri buniek bránia skenovaniu a stávajú sa problematickými na úzkych obrazovkách.
• Keď zoznam obsahuje len dva jednoduché fakty, použite vetu alebo definičný zoznam, pokiaľ typ príspevku nevyžaduje registrovanú špecifikačnú tabuľku. Tabuľka by mala vytvárať hodnotu vyhľadávania, nie dekorovať malý fakt.
• Keď sa hodnoty neustále aktualizujú, pripojte prvok k vlastnému zdroju údajov a zobrazte čas získania. Manuálne skopírovaná „živá“ hodnota sa stáva zavádzajúcou, len čo sa zmení.
• Keď dokument opisuje názvy polí, typy a validačné obmedzenia, použite variant so zoskupením uvedený nižšie; nevtesnávajte celý dátový model do jednej textovo ťažkej bunky „Podrobnosti“.

Pravidlá písania prvkov majú prednosť: vyberte prvok podľa účelu pasáže, nie podľa jej nadpisu alebo vzhľadu. Ak je úlohou bloku zverejniť špecifikácie, zostáva špecifikačnou tabuľkou, aj keď by téma mohla rovnaké slová vykresliť ako karty.

Kam ju umiestniť

Umiestnite prvú špecifikačnú tabuľku potom, čo bol subjekt identifikovaný, a skôr ako stránka požiada čitateľa o interpretáciu, konfiguráciu, porovnanie alebo kúpu. Na stránke produktu to zvyčajne znamená po stručnom popise produktu a kľúčovom prínose, ale pred podrobnými vysvetleniami funkcií. V dokumentácii umiestnite tabuľku predpokladov alebo protokolu bezprostredne pred postup, ktorý sa na ňu spolieha. Čitatelia potrebujú vedieť, čo hodnoty opisujú, skôr než ich uvidia, ale nemali by musieť prejsť dlhým rozprávaním, aby sa k nim dostali.

Ak má stránka niekoľko kategórií, umiestnite každú tabuľku pod opisný H2 alebo H3, napríklad „Fyzické špecifikácie“ alebo „Kompatibilita“. Udržujte názov kategórie mimo tabuľky; popis potom uvádza presný subjekt a rozsah. Zachovajte rovnaké poradie označení na súvisiacich stránkach, aby čitateľ nemusel znovu učiť vzor.

Neumiestňujte špecifikačnú tabuľku priamo vedľa inej hustej tabuľky, celoobrazovkového screenshotu alebo animovaného karuselu. Dve konkurujúce si mriežky vytvárajú nejasnú cestu čítania a sú obzvlášť nevhodné pri šírke tabletu. Nevkladajte výzvu na akciu medzi popis a jeho riadky, neumiestňujte poznámky pod čiarou do nesúvisiacej komponenty ani nevkladajte propagačné tvrdenie do stĺpca hodnôt. Udržujte popis, tabuľku, legendu stavov, dátum overenia a zdrojovú poznámku ako jeden ohraničený celok. Nasledujte vysvetlením pred zavedením ďalšieho prvku náročného na údaje.

Anatómia

Označený obrázok musí identifikovať tieto časti:

1. Nadpis sekcie: pomenúva kategóriu, keď má stránka viac ako jednu tabuľku, napríklad fyzické alebo elektrické špecifikácie.
2. Popis: identifikuje subjekt a presný rozsah tabuľky. Musí dávať zmysel aj mimo okolitého odseku.
3. Hlavička riadku: používa kanonický, jednoznačný názov jednej vlastnosti.
4. Hodnota: obsahuje jeden fakt, nie komentár alebo predajné tvrdenie.
5. Jednotka: uvádza sa pri každej číselnej hodnote, pokiaľ hodnota nie je skutočne bezjednotková.
6. Stavová hodnota: uvádza „Neznáme“ alebo „Neuplatňuje sa“ namiesto ponechania prázdnej bunky.
7. Dátum overenia: uvádza, kedy boli premenlivé fakty naposledy skontrolované.
8. Zdrojová poznámka: identifikuje primárny systém, dokument, test alebo vlastníka, z ktorého hodnoty pochádzajú.

Neznáme znamená, že vlastnosť platí, ale v čase overenia nebola k dispozícii žiadna dôveryhodná hodnota. Neuplatňuje sa znamená, že predpoklad vlastnosti sa na tento subjekt nevzťahuje. Nie je k dispozícii je opäť odlišné: znamená, že schopnosť alebo možnosť chýba. Nula je nameraná alebo deklarovaná hodnota. Prázdna bunka nevyjadruje žiadny z týchto významov, a preto nie je povolená.

Príklady dizajnu

Každý variant dizajnu zachováva natívne tabuľkové značenie, hlavičky riadkov, viditeľné označenia, textové hodnoty a popis. Štylizácia môže meniť hustotu a zoskupenie, ale nemôže premeniť fakty na obrázok ani nechať farbu niesť význam samostatne.

Štandardná dvojstĺpcová: predvolená pre jeden subjekt a tri až dvanásť faktov. Označenia zaberajú prvý stĺpec a hodnoty druhý. Použite ju pre fakty o produkte, spoločnosti, pláne a službe.

Zoskupená: dve alebo viac krátkych tabuliek rozdeľuje väčšiu sadu špecifikácií podľa úlohy čitateľa. Každá skupina dostane nadpis a každá tabuľka si zachováva vlastný popis. Nepoužívajte zlúčené oddeľovacie riadky ako vizuálne nadpisy, pretože komplikujú navigáciu a extrakciu.

Referencia polí: dokumentačný variant pre vlastnosti, ktorých význam vyžaduje konzistentné sekundárne polia, ako je typ, požiadavka a obmedzenie. Prvý stĺpec používa sémantiku hlavičky riadku, zatiaľ čo každá sekundárna dimenzia má hlavičku stĺpca.

Kompaktná mobilná: označenia a hodnoty sa prirodzene zalamujú bez zmenšovania veľkosti písma. Jednoduchá dvojstĺpcová tabuľka by sa mala prispôsobiť v rámci svojho kontajnera. Širší variant referencie polí sa môže posúvať vnútri označenej, klávesnicovo prístupnej oblasti; nesmie spôsobiť horizontálne posúvanie celej stránky.

Parametre

Nasledujúca zmluva definuje prenosný prvok. „Zdroj“ v poslednom stĺpci uvádza, odkiaľ renderer získava parameter, nie kde bol faktický nárok preskúmaný.

Použite verified vždy, keď sa cena, kompatibilita, dostupnosť, podpora verzií, kapacita alebo iná hodnota môže zmeniť. Dátum publikácie nie je náhradou: hovorí, kedy bola stránka zverejnená, nie kedy bola špecifikácia skontrolovaná.

Syntax a príklady kódu

Všetky implementácie mapujú rovnaký popis, zoradené riadky, významy stavov, hodnotu overenia a zdroj. Prenosná direktíva je kanonická autorská forma.

Prenosná direktíva Markdown

:::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 adaptér by mal akceptovať iba pomenované parametre a vykresliť telo pipe-tabuľky ako sémantické riadky tabuľky. Zápis nižšie definuje zamýšľané mapovanie; neznamená, že by sa mala v rámci úlohy článku vytvoriť nová lokálna shortcode.

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

Renderer musí výstupovať <table>, <caption>, <tbody>, <th scope="row"> a <td>. Variant field-reference tiež potrebuje <thead> s hlavičkami scope="col". Musí presne zachovať znamienka mínus, násobenia, medzery jednotiek a stavový text.

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

WordPress implementácia môže používať editovateľné ovládacie prvky bloku namiesto doslovného HTML, ale jej uložené atribúty a serverom vykreslený výstup musia zachovať rovnakú zmluvu. Autori nesmú nahrádzať screenshotom alebo generickým blokom stĺpcov.

Príklady

Dobrý: úplné, normalizované fakty o produkte

Overené: 27. augusta 2026. Zdroj: ilustračný schválený inštalačný list, revízia 2.

Funguje to, pretože popis identifikuje jeden subjekt a jeden kontext. Každé označenie pomenúva testovateľnú vlastnosť, rozsahy si zachovávajú jednotky, rozmery nemiešajú systémy a maximálny výkon je odlíšený od typického výkonu. „Neuplatňuje sa“ je odôvodnené, pretože káblový senzor nemá batériu na výmenu; neskrýva neznámu špecifikáciu batérie. Tabuľku môže skenovať človek, navigovať podľa hlavičky riadku alebo transformovať na diskrétne dvojice vlastnosť–hodnota.

Zlý: nejednoznačné pseudoúdaje

Zlý príklad vyzerá usporiadane, ale neposkytuje spoľahlivé údaje. „Napájanie“ môže znamenať napájacie napätie alebo spotrebu, zatiaľ čo „Nízke“ nie je merateľné. Dĺžka kábla nemá jednotku. Riadok teploty neuvádza Celzia ani Fahrenheita a zdá sa, že mieša rozsah so stupňom. „Odolná“ je propagačný jazyk, nie stupeň krytia. Prázdna bunka batérie nehovorí, či je fakt neznámy, irelevantný, nulový alebo náhodne vynechaný. Tvrdenie o kompatibilite balí do jednej bunky nedefinovanú populáciu a úsudok o inštalácii.

Opravte to rozdelením širokých označení na kanonické vlastnosti, získaním hodnôt z pomenovaného primárneho zdroja, pridaním jednotky ku každému meraniu a nahradením prázdnych miest správnym stavom. Ak zdroj neuvádza stupeň krytia, napíšte „Neznáme“; nekonvertujte marketingový jazyk na vymyslenú technickú hodnotu.

Schema značenie a prístupnosť

Neexistuje všeobecný typ Schema.org pre špecifikačnú tabuľku. Tabuľka zostáva hodnotným sémantickým HTML, aj keď negeneruje JSON-LD. Keď obklopujúca stránka predstavuje oprávnenú entitu, mapujte iba presné, overené fakty na podporované vlastnosti: napríklad sku, weight, width, height, depth, material alebo additionalProperty produktu tam, kde je to vhodné. Fakty o organizácii môžu byť mapované na vlastnosti ako právny názov alebo adresa. Viditeľná tabuľka a štruktúrované údaje sa musia zhodovať, používať rovnaké jednotky a pochádzať z rovnakého zdroja. Nevymýšľajte hodnotenia, ponuky, identifikátory ani vlastnosti schémy len preto, že existuje riadok.

Prístupnosť začína skutočným značením. Dajte tabuľke opisný <caption>. Použite <th scope="row"> pre každé označenie špecifikácie; varianty field-reference tiež potrebujú <th scope="col"> v <thead>. Udržujte poradie čítania logické v zdroji, nielen na obrazovke. Nepoužívajte prázdne bunky, zlúčené bunky, iba ikonové stavy, iba farebné zoskupenia ani tooltipy ako jediné miesto hodnoty. Skratky ako AC, DC a IP by mali byť vysvetlené v blízkom texte, ak ich cieľové publikum nemusí poznať.

Základná dvojstĺpcová tabuľka by sa mala skôr zalamovať ako posúvať, kedykoľvek je to praktické. Keď širšia tabuľka vyžaduje horizontálne posúvanie, umiestnite ju do oblasti s prístupným označením a tabindex="0", zachovajte viditeľný indikátor klávesnicového zamerania a nikdy nezamykajte prvý stĺpec spôsobom, ktorý zakrýva hodnoty pri vysokom zväčšení. Testujte pri 200% zväčšení, s klávesnicovou navigáciou a s vypnutými štýlmi; vzťah označenie–hodnota musí prežiť všetky tri.

Pravidlá písania

Pravidlá chránia vyhľadávanie a porovnávanie, preto presnosť má prednosť pred kompaktnosťou:

• Používajte 3–12 riadkov na tabuľku. Rozdeľte dlhšie sady podľa úlohy čitateľa — fyzické, elektrické, kompatibilita, obchodné — namiesto vytvárania nediferencovanej steny faktov.
• Udržujte označenia na 1–6 slovách tam, kde je to možné. Použite kvalifikátor ako „maximálne“, „typické“, „inštalované“ alebo „na používateľa“, keď mení význam.
• Bežnú hodnotu udržujte na jednom riadku a maximálne 12 slovách. Interpretáciu, výnimky a odporúčania presuňte do susedného textu alebo priamo súvisiacej poznámky.
• Používajte jeden merací systém na tabuľku, pokiaľ publikum skutočne nepotrebuje oba. Ak sú potrebné oba, uveďte primárnu hodnotu ako prvú a prepočet v zátvorkách pre každý príslušný riadok.
• Umiestnite jednotku ku každému číselnému meraniu: 512 Wh, 3 m a 45 °C. Nikdy sa nespoliehajte na to, že nadpis dodá jednotku iba niektorým riadkom.
• Normalizujte ekvivalentné vlastnosti na súvisiacich stránkach. Vyberte jedno označenie a jednu jednotku — napríklad „Hmotnosť“ v kilogramoch — a nestriedajte s „Váha“, librami alebo vágne frázy bez zdokumentovaného dôvodu.
• Používajte presné stavové slová: Neznáme, Neuplatňuje sa alebo Nie je k dispozícii. Definujte ich raz, ak sa vyskytuje viac ako jeden stav. Nikdy nepoužívajte pomlčku, prázdnu bunku, TBC, otáznik ani farbu na vyjadrenie stavu.
• Používajte faktický, neutrálny tón. Hodnoty môžu byť priaznivé, ale slová ako „úžasný“, „ultrarýchly“, „najlepší v triede“ a „veľkorysý“ sú závery, nie špecifikácie.
• Nikdy nevkladajte výzvy na akciu, referencie, odseky predajného textu, nevysvetlené skóre, nepodložené porovnania alebo dekoratívne obrázky do bunky hodnoty.
• Uveďte zdroj a presný dátum overenia pre premenlivé alebo externe tvrdené hodnoty. Ak vlastníctvo nie je jasné, tabuľka nie je pripravená na publikovanie.

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

Pole frontmatter postTypes riadi schválené použitia nižšie. Zaradenie znamená, že typ príspevku môže vyžadovať alebo profitovať z prvku; neznamená to, že každá stránka musí vytvoriť tri fakty, aby uspokojila rozloženie.

Kontrolný zoznam QA

• Tabuľka opisuje jeden jasne identifikovaný subjekt; viaceré možnosti nie sú maskované ako špecifikačná tabuľka.
• Popis uvádza názov subjektu aj rozsah tabuľky.
• Každá vlastnosť používa presné, kanonické označenie a každá bunka obsahuje jednu hodnotu.
• Číselné hodnoty zahŕňajú konzistentné jednotky, kvalifikátory, rozsahy a rozmery.
• Žiadna bunka nie je prázdna; Neznáme, Neuplatňuje sa a Nie je k dispozícii sú použité iba so svojimi definovanými významami.
• Tvrdenia sa zhodujú s pomenovaným primárnym zdrojom a premenlivé fakty zobrazujú presný dátum overenia.
• Publikovaný výstup používa natívne <table>, <caption>, hlavičky riadkov a dátové bunky namiesto obrázka alebo vizuálnej mriežky.
• Varianty field-reference zahŕňajú hlavičky stĺpcov a zachovávajú všetky vzťahy hlavičiek.
• Tabuľka funguje pri úzkych šírkach, 200% zväčšení, s klávesnicovou navigáciou a s vypnutými štýlmi.
• Farba, ikony, skratky a tooltipy nie sú nikdy jediným spôsobom, ako pochopiť hodnotu.
• Viditeľné fakty a všetky oprávnené vlastnosti Schema.org sa presne zhodujú.
• Propagačné tvrdenia, interpretácia, výzvy na akciu a dlhý text sú mimo tabuľky.
• Prvok nasleduje pravidlo priority playbooku a vybraný typ príspevku zahŕňa prvok vo svojej obsahovej zmluve.