Spec-Zone.ru › HTML

<dfn> — элемент определения HTML

Базовая поддержка Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и во многих версиях браузеров. Она поддерживается браузерами с июля 2015 года.

  • Подробнее
  • Полная таблица совместимости
  • Отправить отзыв
>

Элемент <dfn> HTML обозначает термин, которому предстоит дать определение. Элемент <dfn> следует использовать в составе полного утверждения-определения, где полное определение термина может находиться в одном из следующих мест:

  • В родительском абзаце (блоке текста, иногда обозначенном элементом <p>)
  • В паре <dt>/<dd>
  • В ближайшем предке элемента <dfn>, являющемся секцией,

Попробуйте

<p>
  A <dfn id="def-validator">validator</dfn> is a program that checks for syntax
  errors in code or documents.
</p>
dfn {
  /* Add your styles here */
}

Атрибуты

Атрибуты этого элемента включают глобальные атрибуты.

Атрибут title имеет особое значение, описанное ниже.

Примечания по использованию

При использовании элемента <dfn> есть некоторые не совсем очевидные нюансы. Рассмотрим их здесь.

Указание определяемого термина

Определяемый термин устанавливается по следующим правилам:

  1. Если у элемента <dfn> есть атрибут title, значением атрибута title считается определяемый термин. При этом элемент должен содержать текст, но этот текст может быть сокращением (возможно, с использованием элемента <abbr>) или другой формой термина.
  2. Если элемент <dfn> содержит только один дочерний элемент, не имеет собственного текстового содержимого, а дочерний элемент является элементом <abbr> с собственным атрибутом title, точное значение атрибута title элемента <abbr> считается определяемым термином.
  3. В противном случае текстовое содержимое элемента <dfn> считается определяемым термином. Это показано в первом примере ниже.

Примечание: Если у элемента <dfn> есть атрибут title, он должен содержать определяемый термин и не должен содержать никакого другого текста.

Ссылки на элементы <dfn>

Если добавить атрибут id к элементу <dfn>, на него можно будет ссылаться с помощью элементов <a>. Такие ссылки следует оформлять как употребления термина, чтобы читатель мог быстро перейти к его определению, если оно ему незнакомо, щёлкнув ссылку на термин.

Это показано в примере ниже в разделе Ссылки на определения.

Примеры

Рассмотрим несколько примеров различных сценариев использования.

Базовое обозначение термина

В этом примере обычный элемент <dfn> указывает расположение термина в определении.

HTML

<p>
  The <strong>HTML Definition element (<dfn>&lt;dfn&gt;</dfn>)</strong> is used
  to indicate the term being defined within the context of a definition phrase
  or sentence.
</p>

Поскольку у элемента <dfn> нет атрибута title, в качестве определяемого термина используется текстовое содержимое самого элемента <dfn>.

Результат

Ссылки на определения

Чтобы добавить ссылки на определения, создайте их привычным способом с помощью элемента <a>.

HTML

<p>
  The
  <strong>HTML Definition element (<dfn id="definition-dfn">&lt;dfn&gt;</dfn>)</strong>
  is used to indicate the term being defined within the context of a definition
  phrase or sentence.
</p>

<p>
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Graece donan, Latine
  voluptatem vocant. Confecta res esset. Duo Reges: constructio interrete.
  Scrupulum, inquam, abeunti;
</p>

<p>
  Because of all of that, we decided to use the
  <code><a href="#definition-dfn">&lt;dfn&gt;</a></code> element for this
  project.
</p>

Здесь определение снабжено атрибутом id со значением "definition-dfn", который можно использовать в качестве цели ссылки. Далее создаётся ссылка с помощью <a>, а атрибуту href присваивается значение "#definition-dfn", чтобы создать ссылку на определение.

Результат

Совместное использование сокращений и определений

В некоторых случаях при определении термина может потребоваться использовать его сокращение. Это можно сделать, совместно применив элементы <dfn> и <abbr>, как показано ниже:

HTML

<p>
  The <dfn><abbr title="Hubble Space Telescope">HST</abbr></dfn> is among the
  most productive scientific instruments ever constructed. It has been in orbit
  for over 20 years, scanning the sky and returning data and photographs of
  unprecedented quality and detail.
</p>

<p>
  Indeed, the <abbr title="Hubble Space Telescope">HST</abbr> has arguably done
  more to advance science than any device ever built.
</p>

Обратите внимание на элемент <abbr>, вложенный в <dfn>. Первый указывает, что термин является сокращением («HST»), и задаёт полное название («Hubble Space Telescope») в атрибуте title. Второй указывает, что сокращённый термин является определяемым термином.

Результат

Техническая сводка

Категории содержимого Потоковое содержимое, фразовое содержимое, осязаемое содержимое.
Допустимое содержимое Фразовое содержимое, но элемент <dfn> не должен быть его потомком.
Пропуск тегов Не допускается: начальный и конечный теги обязательны.
Допустимые родители Любой элемент, допускающий фразовое содержимое.
Неявная роль ARIA term
Допустимые роли ARIA Любая
Интерфейс DOM HTMLElement

Спецификации

Спецификация
HTML>
# the-dfn-element>

Совместимость с браузерами

Настольные Мобильные
Chrome Edge Firefox Opera Safari Chrome для Android Firefox для Android Opera для Android Safari для iOS Samsung Internet WebView для Android WebView для iOS
dfn 15 12 1 15 6 18 4 14 6 1.0 4.4 6

См. также

  • Элементы, связанные со списками определений: <dl>, <dt>, <dd>
  • <abbr>

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dfn

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API