Legend

Prezentare

Numește un grup de controale dintr-un fieldset — este primul element citit de un cititor de ecran la intrarea în grup.

Când se folosește

• ca prim copil al fiecărui `fieldset`, fără excepție — un fieldset fără legend nu are sens semantic pentru tehnologiile asistive.

Când nu se folosește

• ca titlu de secțiune generic — pentru asta se folosesc titlurile normale (`h2`/`h3`), nu `legend`, care se aplică exclusiv unui `fieldset`.

Anatomie

Un `<legend class="sd-legend">` (sau `sd-legend--large`), text simplu, fără markup imbricat suplimentar.

Variante

• implicit
• `sd-legend--large`, pereche cu `sd-label--large`

Stări

• nu are stări interactive proprii

Comportament

Element static, nativ browserului; anunțat automat de cititoarele de ecran la intrarea în fieldset, fără cod suplimentar.

Reguli de conținut

• formulează întrebarea complet — „Cum vrei să primești răspunsul?”, nu doar „Livrare”.

Cercetare

• https://github.com/ciprian-rus/sistem.digital/pull/49 (site extern)

Istoric

Structura completă a acestei secțiuni urmează șablonul canonic al paginii unei componente. Accesibilitatea (semantică, tastatură, focus) rămâne documentată separat, conform șablonului de accesibilitate.

Preview și markup canonic

Previzualizarea de mai jos redă exact șirul HTML afișat în exemplul de cod. Nu există o implementare paralelă pentru documentație.

Instalare și importuri

pnpm add @sistem-digital/tokens @sistem-digital/components

@import '@sistem-digital/components/forms.css';

<fieldset class="sd-fieldset"><legend class="sd-legend">Alege o opțiune</legend><label class="sd-choice"><input type="checkbox"> Sunt de acord</label></fieldset>

Contract și surse

• Documentația familiei Formulare
• Codul sursă (site extern)
• Changelog (site extern)

Schimbarea claselor publice, a markup-ului canonic sau a comportamentului helperelor necesită versionare și instrucțiuni de migrare.

Matricea design–cod

Disponibilitatea reală a acestei componente, calculată din pachetele publicate, conform schemei matricei design–cod. Rândurile Figma, testare cu tastatura și testare cu cititor de ecran rămân „Indisponibil” până la dovezi publicate separat (kit Figma, respectiv auditul manual de accesibilitate).