definition

Кога да се използва

За речници и двойки термин/дефиниция използвайте нативния HTML списък с описания: <dl> с <dt> (термин) и <dd> (дефиниция). За вграден термин, дефиниран в течащ текст, използвайте <dfn>. И двата варианта са достъпни за екранни четци без ARIA.

role="definition" е подходящо само когато заобикалящият елемент не може да бъде <dd> или <dfn> — например в система за управление на съдържание, която изобразява записи от речника като <div>. Сдвоявайте с role="term" върху съответния елемент с термина.

Ролята указва на екранните четци, че елементът съдържа дефиниция (обяснението), различна от дефинирания термин. Повечето помощни технологии предлагат малко допълнителна навигация за дефиниции — извън обявяването на ролята — така че практическата стойност е скромна; нативните елементи са почти винаги достатъчни.

Чести грешки

• role="definition" без сдвоен role="term". Дефиницията няма термин, към който да се прикрепи.
• Маркиране на термина с role="definition" (и обратно). Огледален образ на правилното съответствие.
• Употреба на role="definition" върху обикновен <p> елемент с основен текст, който случайно дефинира нещо. По-добре е да се използва <dfn> върху самия термин в текста.
• Речник, изграден с role="list" от role="listitem", при което всеки елемент смесва термина и дефиницията. Използвайте <dl>, за да се запази двойката термин/дефиниция.
• <dfn> без id за котвени връзки. Дефинициите са най-полезни, когато от други страници могат да се правят директни препратки към тях.

Пример

<!-- Предпочитан вариант -->
<dl>
  <dt>ARIA</dt>
  <dd>Accessible Rich Internet Applications, a set of attributes that add accessibility semantics to HTML.</dd>
  <dt>APG</dt>
  <dd>ARIA Authoring Practices Guide, the W3C reference of common widget patterns.</dd>
</dl>

<!-- Когато нативните елементи са невъзможни -->
<div role="term" id="aria-term">ARIA</div>
<div role="definition" aria-labelledby="aria-term">
  A set of attributes that add accessibility semantics to HTML.
</div>