definition

När används det

För ordlistor och term/definition-par, använd den native HTML-beskrivningslistan: <dl> med <dt> (term) och <dd> (definition). Eller, för en term som definieras inline i löpande text, använd <dfn>. Båda exponeras för skärmläsare utan ARIA.

role="definition" är lämpligt bara när det omgivande elementet inte kan vara <dd> eller <dfn> — till exempel inne i ett CMS som renderar ordlisteposter som <div>. Para med role="term" på det matchande termelementet.

Rollen talar om för skärmläsare att elementet innehåller en definition (förklaringen), skild från den term som definieras. De flesta hjälpmedel erbjuder föga extra navigering för definitioner utöver att rollen annonseras, så det praktiska värdet är blygsamt — de native elementen räcker nästan alltid.

Vanliga fel

• role="definition" utan ett parat role="term". Definitionen har ingen term att kopplas till.
• Att markera termen som role="definition" (och vice versa). Spegelvänd version av den korrekta mappningen.
• Att använda role="definition" på ett generiskt <p>-element med brödtext som råkar definiera något. Bättre att använda <dfn> på termen i löptexten.
• Ordlista byggd med role="list" av role="listitem" där varje post klipper ihop term och definition. Använd en <dl> så att term/definition-kopplingen bevaras.
• <dfn> utan id att länka till. Definitioner är mest användbara när andra sidor kan djuplänka till dem.

Exempel

<!-- Rekommenderat -->
<dl>
  <dt>ARIA</dt>
  <dd>Accessible Rich Internet Applications, en uppsättning attribut som lägger till tillgänglighetssemantik i HTML.</dd>
  <dt>APG</dt>
  <dd>ARIA Authoring Practices Guide, W3C:s referens för vanliga widget-mönster.</dd>
</dl>

<!-- När native element är omöjliga -->
<div role="term" id="aria-term">ARIA</div>
<div role="definition" aria-labelledby="aria-term">
  En uppsättning attribut som lägger till tillgänglighetssemantik i HTML.
</div>