HTML-элемент <dl>
(от англ. Description List), служащий контейнером для списка пар терминов и их описаний. Этот элемент обычно используют при создании глоссария или для отображения метаданных (списка пар ключ-значение).
До спецификации HTML5, <dl>
был известен как «Список определений».
Content categories | Flow content, and if the <dl> element's children include one name-value pair, palpable content. |
---|---|
Permitted content | Zero or more <dt> elements, each followed by one or more <dd> elements. |
Tag omission | None, both the starting and ending tag are mandatory. |
Permitted parent elements | Any element that accepts flow content. |
DOM interface | HTMLDListElement |
Атрибуты
Для данного элемента доступны глобальные атрибуты.
compact
- Заставляет определение отображаться на той же строке, что и термин. В настоящее время этот атрибут не поддерживается.
Примеры
Одиночные термин и определение
<dl> <dt>Firefox</dt> <dd>A free, open source, cross-platform, graphical web browser developed by the Mozilla Corporation and hundreds of volunteers.</dd> <!-- other terms and definitions --> </dl>
Результат:
Множественные термины с одним определением
<dl> <dt>Firefox</dt> <dt>Mozilla Firefox</dt> <dt>Fx</dt> <dd>A free, open source, cross-platform, graphical web browser developed by the Mozilla Corporation and hundreds of volunteers.</dd> <!-- other terms and definitions --> </dl>
Результат:
Одиночный термин со множественными определениями
<dl> <dt>Firefox</dt> <dd>A free, open source, cross-platform, graphical web browser developed by the Mozilla Corporation and hundreds of volunteers.</dd> <dd>The Red Panda also known as the Lesser Panda, Wah, Bear Cat or Firefox, is a mostly herbivorous mammal, slightly larger than a domestic cat (60 cm long).</dd> <!-- other terms and definitions --> </dl>
Результат:
Множественные термины и определения
Кроме того, можно определить несколько терминов с несколькими соответствующими определениями, путем комбинирования приведенных выше примеров.
Метаданные
Список определений очень полезен для отображения метаданных? как список пар ключ-значение.
<dl> <dt>Name</dt> <dd>Godzilla</dd> <dt>Born</dt> <dd>1952</dd> <dt>Birthplace</dt> <dd>Japan</dd> <dt>Color</dt> <dd>Green</dd> </dl>
Подсказка: Может быть полезно задать разделитель для пары ключ-значение при помощи CSS3, например:
dt:after { content: ": "; }
Примечание
Не используйте данный элемент (как и элемент <ul>
) просто для создания отступов на странице. Не смотря на то, что это работает, — это является плохой практикой и подменяет семантическое значение списка определений.
Чтобы изменить отступ определений терминов, воспользуйтесь CSS-свойством margin
.
Спецификации
Спецификация | Статус | Комментарий |
---|---|---|
WHATWG HTML Living Standard Определение '<dl>' в этой спецификации. |
Живой стандарт | |
HTML5 Определение '<dl>' в этой спецификации. |
Рекомендация | |
HTML 4.01 Specification Определение '<dl>' в этой спецификации. |
Рекомендация | Initial definition |
Поддержка браузерами
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 1.0 | (Да) | (Да) | (Да) | (Да) |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Да) | (Да) | (Да) | (Да) | (Да) |