Table of contents

A table of contents (tartalomjegyzék) segítségével a felhasználók áttekinthetik az oldalak szöveges tartalmát, és az őket érdeklő részekhez navigálhatnak.

Fejlesztői dokumentáció Felépítés

Title: A komponens címe, alapértelmezetten Tartalom.

Link: Az oldalon belülre mutató linkek.

Indicator: Az aktív linket kiemelő keret.

Opciók Behúzás

A komponens két szintű hierarchiát támogat. A második szintet az Indented opcióval kontrollálható behúzással jelezzük.

Működés Interakciós állapotok

A komponens interaktív elemei a design system sztenderd interakciós állapotainak logikáját követik.

Interaktív területek

A komponens linkjei külön interaktív területeket képeznek.

Görgetés követése

Ha görgetésnél egy szekció eléri a képernyő közepét, a szekcióhoz tartozó link automatikusan aktív állapotúra vált.

Használati megfontolások Pozíció

A tartalomjegyzék a szöveges tartalom jobb vagy bal oldalán, illetve a tartalomba ágyazva használható.

Mobileszközökön a tartalomba ágyazva használjuk, de érdemes megfontolni a tartalomjegyzék elrejtését.

Tartalomba ágyazott table of contents
Konkrét szekciók megosztása

A tartalomjegyzékben szereplő szekciók egyedi URI fragmenttel rendelkeznek, így ezek közvetlenül is megoszthatóak lesznek.

Sticky mód

A komponenst érdemes úgynevezett sticky módon implementálni, azaz úgy, hogy kövesse a görgetést. Így bármikor elérhető lesz a felhasználó számra, ami növeli a használhatóságot.

Mivel a komponens élőben frissül, a felhasználó mindig tudni fogja, hol tart az oldalon belül.

Akadálymentesség Kontrasztarányok

A komponens a design system kontrasztcélokkal generált szemantikus színeit használja, ezért megfelel az akadálymentesítési követelményeknek. A tokenizálás miatt ez színsémától és sötét vagy világos módtól függetlenül igaz.

A kontraszt minimumokat a design system legsötétetebb – sötét módban a legvilágosabb – hátterén generáljuk, emiatt ez az arány minden más használható háttéren ennél csak jobb lehet.

Ha a komponenst nem tokenizált háttérszínen használjuk, manuálisan ellenőrizni kell a kontrasztot!

Színhasználat

A komponens állapotai és kiegészítő elemei nem kizárólag színnel közlik az információt. Így a színtévesztő vagy színvak, illetve a monokróm kijelzőt használó felhasználók is megkapják a szükséges információkat.

Billentyűzettel való használat

A link tabbal fókuszálható és enterrel aktiválható.

Implementáció

A komponens navigációként van implementálva.