Tabele specyfikacji: format, zasady i przykłady

Tabela specyfikacji przekształca fakty o jednym podmiocie w jawne pary etykieta–wartość. Czytelnik może znaleźć temperaturę roboczą bez ponownego czytania opisu produktu, a maszyna może zachować związek między „Temperaturą roboczą” a „−10 do 45 °C” bez zgadywania, która liczba należy do którego stwierdzenia.

Nazwa produktu i powyższe wartości mają charakter ilustracyjny. Struktura jest modelem produkcyjnym: jeden podmiot, jedna precyzyjna etykieta na wiersz, jedna wartość z jej jednostką oraz jawny status, gdy wartość faktyczna nie może być dostarczona.

Dlaczego ten element ma znaczenie

Proza opisująca specyfikacje zmusza czytelników do wykonywania możliwej do uniknięcia rekonstrukcji. Rozważ: „Urządzenie waży 6,4 kilograma, dostarcza 500 watów w sposób ciągły, ma wymiary 280 na 190 na 210 milimetrów i może pracować w temperaturze od minus 10 do 45 stopni Celsjusza.” To zdanie jest poprawne gramatycznie, ale kupujący szukający tylko wymiarów musi analizować każde zdanie. Powrót później w celu sprawdzenia danych wyjściowych oznacza ponowną analizę. Tabela przenosi etykiety na przewidywalną krawędź, a wartości do drugiej kolumny, zmniejszając wysiłek pamięciowy i czyniąc skanowanie niezawodnym.

Struktura ma równie duże znaczenie dla maszyn. Ekstrahowalność maszynowa to zdolność crawlera, systemu wyszukiwania, asystenta lub narzędzia publikacyjnego do zachowania znaczenia i relacji w treści. Natywny znacznik <table>, <th scope="row"> i <td> stwierdza, że nagłówek wiersza kwalifikuje sąsiednią wartość. Tworzy on niezawodną parę: „Pojemność użytkowa — 512 Wh.” Te same dwa ciągi znaków osadzone wśród zdań promocyjnych wymagają wnioskowania na poziomie językowym, a stylizowana kolekcja niepowiązanych elementów <div> może ujawniać wizualne wyrównanie bez ujawniania relacji danych.

„Możliwość odpytywania” nie oznacza, że każda witryna staje się bazą danych. Oznacza, że każdy fakt ma stabilną etykietę, dyskretną wartość i przewidywalny znacznik, dzięki czemu czytelnik lub system może zapytać o jedną właściwość bez wyodrębniania całego akapitu. „Możliwość porównywania” oznacza, że osobno publikowane produkty mogą używać tych samych kanonicznych etykiet i jednostek, umożliwiając późniejsze dopasowanie wartości bez konieczności normalizowania „około pół kilowata”, „500 watów” i „0,5 kW”. Tabela specyfikacji umożliwia to późniejsze porównanie; sama w sobie nie jest porównaniem, chyba że przedstawia wiele podmiotów obok siebie.

Kiedy go używać

Używaj tabeli specyfikacji, gdy strona opisuje jeden podmiot, a czytelnicy potrzebują co najmniej trzech dyskretnych, zweryfikowanych faktów. Typowe podmioty obejmują produkt, plan oprogramowania, API, format pliku, obiekt, pojazd, organizację, pakiet usług lub standard techniczny. Odpowiednie fakty mają ograniczone odpowiedzi: wymiary, obsługiwane systemy operacyjne, typ złącza, format odpowiedzi, okres gwarancji, nazwę prawną, obszar pokrycia, wersję lub określony limit.

Używaj prozy wokół tabeli, aby wyjaśnić konsekwencje. „Maksymalny udźwig: 18 kg” należy do tabeli; dlaczego ten limit wyklucza konkretną instalację — należy do prozy. Tabela powinna odpowiedzieć na pytanie „jaka jest wartość?”, podczas gdy otaczające wyjaśnienie odpowiada na „dlaczego to ma znaczenie?”

Przypadki graniczne są powszechne:

• Gdy dwa lub więcej produktów musi być ocenianych według wspólnych kryteriów, zamiast tego użyj tabeli porównawczej . Tabela specyfikacji ma jeden podmiot; dodanie kilku kolumn wartości zmienia jej cel.
• Gdy treść jest sekwencją zdarzeń, użyj osi czasu. Daty w dwukolumnowej tabeli nie tworzą automatycznie zależności chronologicznych.
• Gdy każdy wiersz wymaga kilku zdań interpretacji, użyj nagłówków i prozy. Gęste akapity wewnątrz komórek utrudniają skanowanie i stają się trudne na wąskich ekranach.
• Gdy lista zawiera tylko dwa proste fakty, użyj zdania lub listy definicji, chyba że typ wpisu wymaga zarejestrowanej tabeli specyfikacji. Tabela powinna tworzyć wartość wyszukiwania, a nie dekorować mały fakt.
• Gdy wartości aktualizują się w sposób ciągły, połącz element z własnym źródłem danych i pokaż czas pobrania. Ręcznie skopiowana wartość „na żywo” staje się myląca, gdy tylko się zmieni.
• Gdy dokument opisuje nazwy pól, typy i ograniczenia walidacji, użyj poniższego wariantu grupowanego; nie wciskaj całego modelu danych do jednej, przeładowanej prozą komórki „Szczegóły”.

Zasady pisania elementów mają pierwszeństwo: wybierz element według celu fragmentu, a nie jego nagłówka lub wyglądu. Jeśli zadaniem bloku jest przedstawienie specyfikacji, pozostaje on tabelą specyfikacji, nawet jeśli motyw mógłby wyrenderować te same słowa jako karty.

Gdzie go umieścić

Umieść pierwszą tabelę specyfikacji po zidentyfikowaniu podmiotu, a przed momentem, w którym strona prosi czytelnika o interpretację, konfigurację, porównanie lub zakup. Na stronie produktu oznacza to zazwyczaj po zwięzłym opisie produktu i kluczowej korzyści, ale przed szczegółowymi wyjaśnieniami funkcji. W dokumentacji umieść tabelę wymagań wstępnych lub protokołu bezpośrednio przed procedurą, która na nich polega. Czytelnicy muszą wiedzieć, jakie wartości opisują, zanim je zobaczą, ale nie powinni musieć przebijać się przez długą narrację, aby je znaleźć.

Jeśli strona ma kilka kategorii, umieść każdą tabelę pod opisowym nagłówkiem H2 lub H3, takim jak „Specyfikacje fizyczne” lub „Zgodność”. Trzymaj tytuł kategorii poza tabelą; wtedy podpis określa precyzyjny podmiot i zakres. Zachowaj tę samą kolejność etykiet na stronach pokrewnych, aby czytelnik nie musiał uczyć się wzorca od nowa.

Nie umieszczaj tabeli specyfikacji bezpośrednio obok innej gęstej tabeli, zrzutu ekranu na pełną szerokość lub animowanego karuzeli. Dwie konkurujące ze sobą siatki tworzą niejasną ścieżkę czytania i są szczególnie nieporęczne na szerokościach tabletu. Nie wstawiaj wezwania do działania między podpisem a jego wierszami, nie umieszczaj przypisów w niepowiązanym komponencie ani nie umieszczaj twierdzeń promocyjnych w kolumnie wartości. Zachowaj podpis, tabelę, legendę statusu, datę weryfikacji i notatkę źródłową jako jedną zamkniętą jednostkę. Po niej umieść wyjaśnienie, zanim wprowadzisz kolejny element bogaty w dane.

Anatomia

Oznaczony obraz musi identyfikować następujące części:

1. Nagłówek sekcji: nazywa kategorię, gdy strona ma więcej niż jedną tabelę, np. specyfikacje fizyczne lub elektryczne.
2. Podpis: identyfikuje podmiot i dokładny zakres tabeli. Musi mieć sens poza otaczającym akapitem.
3. Nagłówek wiersza: używa kanonicznej, jednoznacznej nazwy jednej właściwości.
4. Wartość: zawiera jeden fakt, a nie komentarz lub twierdzenie sprzedażowe.
5. Jednostka: pojawia się przy każdej wartości liczbowej, chyba że wartość jest rzeczywiście bezwymiarowa.
6. Wartość statusu: zapisuje „Nieznane” lub „Nie dotyczy” zamiast pozostawiania pustej komórki.
7. Data weryfikacji: określa, kiedy zmienne fakty zostały ostatnio sprawdzone.
8. Notatka źródłowa: identyfikuje główny system, dokument, test lub właściciela, z którego pochodzą wartości.

Nieznane oznacza, że właściwość ma zastosowanie, ale w momencie weryfikacji nie była dostępna żadna wiarygodna wartość. Nie dotyczy oznacza, że przesłanka właściwości nie ma zastosowania do tego podmiotu. Niedostępne to z kolei coś innego: oznacza, że funkcja lub opcja jest nieobecna. Zero to zmierzona lub zadeklarowana wartość. Pusta komórka nie przekazuje żadnego z tych znaczeń i dlatego jest niedozwolona.

Przykłady projektowe

Każdy wariant projektowy zachowuje natywny znacznik tabeli, nagłówki wierszy, widoczne etykiety, wartości tekstowe i podpis. Stylizacja może zmieniać gęstość i grupowanie, ale nie może przekształcać faktów w obraz ani sprawiać, że kolor sam w sobie niesie znaczenie.

Standardowa dwukolumnowa: domyślna dla jednego podmiotu i od trzech do dwunastu faktów. Etykiety zajmują pierwszą kolumnę, a wartości drugą. Używaj jej dla faktów dotyczących produktu, firmy, planu i usługi.

Grupowana: dwie lub więcej krótkich tabel dzieli większy zestaw specyfikacji według zadania czytelnika. Każda grupa otrzymuje nagłówek, a każda tabela zachowuje własny podpis. Nie używaj scalonych wierszy separatora jako wizualnych nagłówków, ponieważ komplikują one nawigację i ekstrakcję.

Referencja pól: wariant dokumentacyjny dla właściwości, których znaczenie wymaga spójnych pól pomocniczych, takich jak typ, wymaganie i ograniczenie. Pierwsza kolumna używa semantyki nagłówka wiersza, podczas gdy każdy wymiar pomocniczy ma nagłówek kolumny.

Kompaktowa mobilna: etykiety i wartości zawijają się naturalnie bez zmniejszania rozmiaru czcionki. Prosta dwukolumnowa tabela powinna przekształcać się w swoim kontenerze. Szerszy wariant referencji pól może przewijać się wewnątrz oznaczonego, dostępnego z klawiatury regionu; nie może powodować poziomego przewijania całej strony.

Parametry

Poniższy kontrakt definiuje przenośny element. „Źródło” w ostatniej kolumnie określa, skąd renderer pobiera parametr, a nie gdzie badano fakt.

Używaj verified, gdy cena, zgodność, dostępność, wsparcie wersji, pojemność lub inna wartość może się zmienić. Data publikacji nie jest substytutem: mówi, kiedy strona została opublikowana, a nie kiedy sprawdzono specyfikację.

Składnia i przykłady kodu

Wszystkie implementacje odwzorowują ten sam podpis, uporządkowane wiersze, znaczenia statusów, wartość weryfikacji i źródło. Dyrektywa przenośna jest kanoniczną formą autorską.

Przenośna dyrektywa Markdown

:::spec-table{caption="Northstar Field 500 — podstawowe specyfikacje" verified="2026-08-27"}
| Specyfikacja | Wartość |
|---|---|---|
| Pojemność użytkowa | 512 Wh |
| Ciągła moc wyjściowa AC | 500 W |
| Wymiary (S × W × G) | 280 × 190 × 210 mm |
| Klasa wodoodporności | Nieznane |
| Rodzaj paliwa | Nie dotyczy |

Status: Nieznane = istotne, ale niezweryfikowane; Nie dotyczy = nie może mieć zastosowania.

Źródło: zatwierdzona karta danych produktu, wersja 4.
:::

Skrót Hugo

Adapter Hugo powinien akceptować tylko nazwane parametry i renderować treść tabeli potokowej jako semantyczne wiersze tabeli. Poniższy zapis określa zamierzone mapowanie; nie oznacza, że należy utworzyć nowy lokalny skrót w ramach zadania artykułu.

{{< spec-table caption="Northstar Field 500 — podstawowe specyfikacje" verified="2026-08-27" >}}
| Specyfikacja | Wartość |
|---|---|---|
| Pojemność użytkowa | 512 Wh |
| Ciągła moc wyjściowa AC | 500 W |
| Wymiary (S × W × G) | 280 × 190 × 210 mm |
| Klasa wodoodporności | Nieznane |
| Rodzaj paliwa | Nie dotyczy |

Status: Nieznane = istotne, ale niezweryfikowane; Nie dotyczy = nie może mieć zastosowania.

Źródło: zatwierdzona karta danych produktu, wersja 4.
{{< /spec-table >}}

Renderer musi generować <table>, <caption>, <tbody>, <th scope="row"> i <td>. Wariant field-reference wymaga również <thead> z nagłówkami scope="col". Musi dokładnie zachować znaki minusa, znaki mnożenia, odstępy jednostek i tekst statusu.

Blok WordPress

<!-- wp:amicited/spec-table {"caption":"Northstar Field 500 — podstawowe specyfikacje","verified":"2026-08-27","variant":"standard"} -->
<table>
  <tbody>
    <tr><th scope="row">Pojemność użytkowa</th><td>512 Wh</td></tr>
    <tr><th scope="row">Ciągła moc wyjściowa AC</th><td>500 W</td></tr>
    <tr><th scope="row">Wymiary (S × W × G)</th><td>280 × 190 × 210 mm</td></tr>
    <tr><th scope="row">Klasa wodoodporności</th><td>Nieznane</td></tr>
    <tr><th scope="row">Rodzaj paliwa</th><td>Nie dotyczy</td></tr>
  </tbody>
</table>
<p class="spec-table__status">Nieznane = istotne, ale niezweryfikowane; Nie dotyczy = nie może mieć zastosowania.</p>
<p class="spec-table__source">Źródło: zatwierdzona karta danych produktu, wersja 4.</p>
<!-- /wp:amicited/spec-table -->

Implementacja WordPress może używać edytowalnych kontrolek bloków zamiast dosłownego HTML, ale jej zapisane atrybuty i wyrenderowany po stronie serwera wynik muszą zachować ten sam kontrakt. Autorzy nie mogą zastępować tego zrzutem ekranu ani ogólnym blokiem kolumn.

Przykłady

Dobrze: kompletne, znormalizowane fakty produktu

Zweryfikowano: 27 sierpnia 2026. Źródło: przykładowy zatwierdzony arkusz instalacyjny, wersja 2.

To działa, ponieważ podpis identyfikuje jeden podmiot i jeden kontekst. Każda etykieta nazywa mierzalną właściwość, zakresy zachowują swoje jednostki, wymiary nie mieszają systemów, a moc maksymalna jest odróżniona od typowej. „Nie dotyczy” jest uzasadnione, ponieważ czujnik przewodowy nie ma baterii do wymiany; nie ukrywa nieznanej specyfikacji baterii. Tabela może być skanowana przez osobę, przeglądana według nagłówka wiersza lub przekształcana w dyskretne pary właściwość–wartość.

Źle: niejednoznaczne pseudodane

Zła tabela wygląda na uporządkowaną, ale nie dostarcza wiarygodnych danych. „Zasilanie” może oznaczać napięcie zasilania lub pobór mocy, podczas gdy „Niski” nie jest mierzalne. Długość kabla nie ma jednostki. Wiersz temperatury nie określa, czy chodzi o Celsjusza, czy Fahrenheita i wydaje się mieszać zakres z symbolem stopnia. „Wytrzymały” to język promocyjny, a nie klasa ochrony obudowy. Pusta komórka baterii nie mówi, czy fakt jest nieznany, nieistotny, zerowy czy przypadkowo pominięty. Twierdzenie o zgodności pakuje w jedną komórkę niezdefiniowaną populację i ocenę instalacyjną.

Napraw to, dzieląc szerokie etykiety na kanoniczne właściwości, pozyskując wartości z nazwanego źródła podstawowego, dodając jednostkę do każdego pomiaru i zastępując puste miejsca poprawnym statusem. Jeśli źródło nie podaje klasy ochrony obudowy, napisz „Nieznane”; nie przekształcaj języka marketingowego w wymyśloną wartość techniczną.

Znacznik schematu i dostępność

Nie ma ogólnego typu Schema.org dla tabeli specyfikacji. Tabela pozostaje wartościowym semantycznym HTML, nawet jeśli nie generuje JSON-LD. Gdy otaczająca strona reprezentuje kwalifikujący się podmiot, mapuj tylko dokładne, zweryfikowane fakty do obsługiwanych właściwości: na przykład sku, weight, width, height, depth, material lub additionalProperty produktu, gdzie ma to zastosowanie. Fakty dotyczące organizacji mogą być mapowane do właściwości takich jak nazwa prawna lub adres. Widoczna tabela i dane strukturalne muszą być zgodne, używać tych samych jednostek i pochodzić z tego samego źródła. Nie wymyślaj ocen, ofert, identyfikatorów ani właściwości schematu tylko dlatego, że istnieje wiersz.

Dostępność zaczyna się od prawdziwego znacznika. Nadaj tabeli opisowy <caption>. Używaj <th scope="row"> dla każdej etykiety specyfikacji; warianty field-reference wymagają również <th scope="col"> w <thead>. Zachowaj logiczną kolejność czytania w źródle, nie tylko na ekranie. Nie używaj pustych komórek, scalonych komórek, statusów tylko w formie ikon, grupowania tylko za pomocą koloru ani etykietek narzędziowych jako jedynego miejsca wartości. Skróty takie jak AC, DC i IP powinny być rozwinięte w pobliskiej prozie, gdy docelowa grupa odbiorców może ich nie znać.

Podstawowa dwukolumnowa tabela powinna zawijać się, a nie przewijać, gdy tylko jest to praktyczne. Gdy szersza tabela wymaga przewijania poziomego, zamknij ją w regionie z dostępną etykietą i tabindex="0", zachowaj widoczny wskaźnik fokusu klawiatury i nigdy nie blokuj pierwszej kolumny w sposób, który zakrywa wartości przy wysokim powiększeniu. Testuj przy 200% powiększeniu, z nawigacją klawiaturową i z wyłączonymi stylami; relacja etykieta–wartość musi przetrwać wszystkie trzy warunki.

Zasady pisania

Zasady chronią wyszukiwanie i porównywanie, więc precyzja ma pierwszeństwo przed zwięzłością:

• Używaj 3–12 wierszy na tabelę. Dziel dłuższe zestawy według zadania czytelnika — fizyczne, elektryczne, zgodność, handlowe — zamiast tworzyć niezróżnicowaną ścianę faktów.
• Tam, gdzie to możliwe, utrzymuj etykiety do 1–6 słów. Używaj kwalifikatora, takiego jak „maksymalnie”, „typowy”, „zainstalowany” lub „na użytkownika”, gdy zmienia to znaczenie.
• Utrzymuj normalną wartość w jednym wierszu i nie więcej niż 12 słów. Przenoś interpretację, wyjątki i zalecenia do sąsiedniej prozy lub bezpośrednio powiązanej notatki.
• Używaj jednego systemu miar na tabelę, chyba że odbiorcy rzeczywiście potrzebują obu. Gdy oba są wymagane, podaj główną wartość jako pierwszą, a przeliczenie w nawiasach dla każdego odpowiedniego wiersza.
• Umieść jednostkę przy każdym pomiarze liczbowym: 512 Wh, 3 m i 45 °C. Nigdy nie polegaj na nagłówku, który dostarcza jednostkę tylko do niektórych wierszy.
• Normalizuj równoważne właściwości na stronach pokrewnych. Wybierz jedną etykietę i jedną jednostkę — np. „Waga” w kilogramach — i nie zmieniaj naprzemiennie z „Masa”, funtami ani niejasnymi frazami bez udokumentowanego powodu.
• Używaj dokładnych słów statusu: Nieznane, Nie dotyczy lub Niedostępne. Zdefiniuj je raz, gdy pojawia się więcej niż jeden status. Nigdy nie używaj myślnika, pustej komórki, TBC, znaku zapytania ani koloru do sugerowania statusu.
• Używaj rzeczowego, neutralnego tonu. Wartości mogą być korzystne, ale słowa takie jak „niesamowity”, „ultraszybki”, „najlepszy w klasie” i „hojny” to wnioski, a nie specyfikacje.
• Nigdy nie umieszczaj wezwań do działania, opinii, akapitów tekstu sprzedażowego, niewyjaśnionych wyników, niepopartych porównań ani dekoracyjnych obrazów w komórce wartości.
• Podaj źródło i dokładną datę weryfikacji dla zmiennych lub zewnętrznie potwierdzonych wartości. Jeśli własność jest niejasna, tabela nie jest gotowa do publikacji.

Typy wpisów, które go używają

Pole postTypes w metadanych określa zatwierdzone zastosowania poniżej. Włączenie oznacza, że typ wpisu może wymagać elementu lub czerpać z niego korzyści; nie oznacza, że każda strona musi wymyślić trzy fakty, aby spełnić układ.

Lista kontrolna QA

• Tabela opisuje jeden jasno zidentyfikowany podmiot; wiele opcji nie zostało zamaskowanych jako tabela specyfikacji.
• Podpis określa zarówno podmiot, jak i zakres tabeli.
• Każda właściwość używa precyzyjnej, kanonicznej etykiety, a każda komórka zawiera jedną wartość.
• Wartości liczbowe zawierają spójne jednostki, kwalifikatory, zakresy i wymiary.
• Żadna komórka nie jest pusta; Nieznane, Nie dotyczy i Niedostępne są używane tylko z ich zdefiniowanymi znaczeniami.
• Twierdzenia są zgodne z nazwanym źródłem podstawowym, a zmienne fakty pokazują dokładną datę weryfikacji.
• Opublikowany wynik używa natywnego <table>, <caption>, nagłówków wierszy i komórek danych, a nie obrazu lub siatki wizualnej.
• Warianty field-reference zawierają nagłówki kolumn i zachowują wszystkie relacje nagłówków.
• Tabela działa na wąskich szerokościach, przy 200% powiększeniu, z nawigacją klawiaturową i z wyłączonymi stylami.
• Kolor, ikony, skróty i etykietki narzędziowe nigdy nie są jedynym sposobem na zrozumienie wartości.
• Widoczne fakty i wszelkie kwalifikujące się właściwości Schema.org są dokładnie zgodne.
• Twierdzenia promocyjne, interpretacja, wezwania do działania i długa proza znajdują się poza tabelą.
• Element jest zgodny z regułą pierwszeństwa playbooka, a wybrany typ wpisu zawiera element w swoim kontrakcie treści.