メインコンテンツへスキップ

dd要素


1.仕様

DD要素は、
定義用語とその説明を
関連付けをした一覧の
定義用語の説明を
表します。

dd

定義の説明 (definition description)

種類

通常要素

カテゴリ

なし

使用できるコンテキスト
  • dl要素の子であるdt要素の後
  • dl要素の子であるdiv要素の子であるdt要素の後

dl要素の子であるdt要素の後のコンテンツとして、使用できます。
dl要素の子であるdiv要素の子であるdt要素の後を そのコンテンツとして、使用できます。

dl要素内の、dt要素またはdd要素の後。

dl要素の子であるdiv要素内の、dt要素またはdd要素の後。

タグの省略
終了タグは省略できます。

dd要素の直後に別の dd要素または dt要素が続く場合、または親要素にそれ以上のコンテンツがない場合は、dd要素の終了タグを省略できます。

コンテンツ属性

グローバル属性のみ

DOM インターフェイス
HTMLElement
  1. [Exposed=Window]
  2. interface HTMLElement : Element {
  3. [HTMLConstructor] constructor();
  4.  
  5. // metadata attributes
  6. [CEReactions] attribute DOMString title;
  7. [CEReactions] attribute DOMString lang;
  8. [CEReactions] attribute boolean translate;
  9. [CEReactions] attribute DOMString dir;
  10.  
  11. // user interaction
  12. [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
  13. [CEReactions] attribute DOMString inert;
  14. undefined click();
  15. [CEReactions] attribute DOMString accessKey;
  16. readonly attribute DOMString accessKeyLabel;
  17. [CEReactions] attribute boolean draggable;
  18. [CEReactions] attribute boolean spellcheck;
  19. [CEReactions] attribute DOMString writingSuggestions;
  20. [CEReactions] attribute DOMString autocapitalize;
  21.  
  22. [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
  23. [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
  24.  
  25. ElementInternals attachInternals();
  26.  
  27. // The popover API
  28. undefined showPopover();
  29. undefined hidePopover();
  30. boolean togglePopover(optional boolean force);
  31. [CEReactions] attribute DOMString? popover;
  32. };
  33.  
  34. HTMLElement includes GlobalEventHandlers;
  35. HTMLElement includes ElementContentEditable;
  36. HTMLElement includes HTMLOrSVGElement;
Element
  1. [Exposed=Window]
  2. interface Element : Node {
  3. readonly attribute DOMString? namespaceURI;
  4. readonly attribute DOMString? prefix;
  5. readonly attribute DOMString localName;
  6. readonly attribute DOMString tagName;
  7.  
  8. [CEReactions] attribute DOMString id;
  9. [CEReactions] attribute DOMString className;
  10. [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
  11. [CEReactions, Unscopable] attribute DOMString slot;
  12.  
  13. boolean hasAttributes();
  14. [SameObject] readonly attribute NamedNodeMap attributes;
  15. sequence<DOMString> getAttributeNames();
  16. DOMString? getAttribute(DOMString qualifiedName);
  17. DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
  18. [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
  19. [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
  20. [CEReactions] undefined removeAttribute(DOMString qualifiedName);
  21. [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
  22. [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
  23. boolean hasAttribute(DOMString qualifiedName);
  24. boolean hasAttributeNS(DOMString? namespace, DOMString localName);
  25.  
  26. Attr? getAttributeNode(DOMString qualifiedName);
  27. Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
  28. [CEReactions] Attr? setAttributeNode(Attr attr);
  29. [CEReactions] Attr? setAttributeNodeNS(Attr attr);
  30. [CEReactions] Attr removeAttributeNode(Attr attr);
  31.  
  32. ShadowRoot attachShadow(ShadowRootInit init);
  33. readonly attribute ShadowRoot? shadowRoot;
  34.  
  35. Element? closest(DOMString selectors);
  36. boolean matches(DOMString selectors);
  37. boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
  38.  
  39. HTMLCollection getElementsByTagName(DOMString qualifiedName);
  40. HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
  41. HTMLCollection getElementsByClassName(DOMString classNames);
  42.  
  43. [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
  44. undefined insertAdjacentText(DOMString where, DOMString data); // legacy
  45. };
GlobalEventHandlers
  1. interface mixin GlobalEventHandlers {
  2. attribute EventHandler onabort;
  3. attribute EventHandler onauxclick;
  4. attribute EventHandler onbeforeinput;
  5. attribute EventHandler onbeforematch;
  6. attribute EventHandler onbeforetoggle;
  7. attribute EventHandler onblur;
  8. attribute EventHandler oncancel;
  9. attribute EventHandler oncanplay;
  10. attribute EventHandler oncanplaythrough;
  11. attribute EventHandler onchange;
  12. attribute EventHandler onclick;
  13. attribute EventHandler onclose;
  14. attribute EventHandler oncontextlost;
  15. attribute EventHandler oncontextmenu;
  16. attribute EventHandler oncontextrestored;
  17. attribute EventHandler oncopy;
  18. attribute EventHandler oncuechange;
  19. attribute EventHandler oncut;
  20. attribute EventHandler ondblclick;
  21. attribute EventHandler ondrag;
  22. attribute EventHandler ondragend;
  23. attribute EventHandler ondragenter;
  24. attribute EventHandler ondragleave;
  25. attribute EventHandler ondragover;
  26. attribute EventHandler ondragstart;
  27. attribute EventHandler ondrop;
  28. attribute EventHandler ondurationchange;
  29. attribute EventHandler onemptied;
  30. attribute EventHandler onended;
  31. attribute OnErrorEventHandler onerror;
  32. attribute EventHandler onfocus;
  33. attribute EventHandler onformdata;
  34. attribute EventHandler oninput;
  35. attribute EventHandler oninvalid;
  36. attribute EventHandler onkeydown;
  37. attribute EventHandler onkeypress;
  38. attribute EventHandler onkeyup;
  39. attribute EventHandler onload;
  40. attribute EventHandler onloadeddata;
  41. attribute EventHandler onloadedmetadata;
  42. attribute EventHandler onloadstart;
  43. attribute EventHandler onmousedown;
  44. [LegacyLenientThis] attribute EventHandler onmouseenter;
  45. [LegacyLenientThis] attribute EventHandler onmouseleave;
  46. attribute EventHandler onmousemove;
  47. attribute EventHandler onmouseout;
  48. attribute EventHandler onmouseover;
  49. attribute EventHandler onmouseup;
  50. attribute EventHandler onpaste;
  51. attribute EventHandler onpause;
  52. attribute EventHandler onplay;
  53. attribute EventHandler onplaying;
  54. attribute EventHandler onprogress;
  55. attribute EventHandler onratechange;
  56. attribute EventHandler onreset;
  57. attribute EventHandler onresize;
  58. attribute EventHandler onscroll;
  59. attribute EventHandler onscrollend;
  60. attribute EventHandler onsecuritypolicyviolation;
  61. attribute EventHandler onseeked;
  62. attribute EventHandler onseeking;
  63. attribute EventHandler onselect;
  64. attribute EventHandler onslotchange;
  65. attribute EventHandler onstalled;
  66. attribute EventHandler onsubmit;
  67. attribute EventHandler onsuspend;
  68. attribute EventHandler ontimeupdate;
  69. attribute EventHandler ontoggle;
  70. attribute EventHandler onvolumechange;
  71. attribute EventHandler onwaiting;
  72. attribute EventHandler onwebkitanimationend;
  73. attribute EventHandler onwebkitanimationiteration;
  74. attribute EventHandler onwebkitanimationstart;
  75. attribute EventHandler onwebkittransitionend;
  76. attribute EventHandler onwheel;
  77. };
ElementContentEditable
  1. interface mixin ElementContentEditable {
  2. [CEReactions] attribute DOMString contentEditable;
  3. [CEReactions] attribute DOMString enterKeyHint;
  4. readonly attribute boolean isContentEditable;
  5. [CEReactions] attribute DOMString inputMode;
  6. };
HTMLOrSVGElement
  1. interface mixin HTMLOrSVGElement {
  2. [SameObject] readonly attribute DOMStringMap dataset;
  3. attribute DOMString nonce; // intentionally no [CEReactions]
  4.  
  5. [CEReactions] attribute boolean autofocus;
  6. [CEReactions] attribute long tabIndex;
  7. undefined focus(optional FocusOptions options = {});
  8. undefined blur();
  9. };
ARIA in HTML
暗黙的="No" ARIAロール="No" aria-* 属性="GlobalAny"

暗黙的な ARIAセマンティクスがありませんが、意味はあり、この意味は、ARIA によって提供されず、ARIA のユーザーに公開されていないロール、状態、プロパティで表現される可能性があります。

作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。

レンダリング
ブロックボックス
リスト
  1. dd {
  2. display: block;
  3. margin-inline-start: 40px;
  4. unicode-bidi: isolate;
  5. }

CSS を大雑把に読むと、 ブロックレベルのブロックコンテナボックス(ブロックボックス)を生成します。 などになります。

説明
dd要素は、説明、定義、または値を表します。

dd要素は、定義用語とその説明を関連付けした一覧(リスト・list)の説明を表します。
名前と値のグループは、用語と定義, メタデータのトピックと値, 質問と回答, またはその他の名前と値のデータのグループです。 HTML Living Standard での例示で、 1 つのグループに 2 つのメタデータラベルと 2 つの値がある例があるので、n 対 m の関係付けが可能な様です。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>dd要素の例 - (Example of dd element) | 離珠のHTMLでしぃ!</title>
  6. </head>
  7. <body>
  8. <h1>dd要素の例</h1>
  9. <dl>
  10. <div>
  11. <dt>用語</dt>
  12. <dd>説明</dd>
  13. </div>
  14. </dl>
  15. </body>
  16. </html>

このサンプルへのリンクです。
(./exdd.htm)

JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "dd": {
  3. "check": "2024-09-01",
  4. "group": "List",
  5. "element": "- - (%Flow)* -- definition description. (Normal elements.) [None] --",
  6. "attlist": {"%Global;": ""},
  7. "comment": "定義の説明 (definition description)",
  8. "point": "説明、定義、または値を表します。",
  9. "description": [
  10. "定義用語とその説明を関連付けした一覧(リスト・list)の説明を表します。",
  11. "名前と値のグループは、用語と定義, メタデータのトピックと値, 質問と回答, またはその他の名前と値のデータのグループです。 HTML Living Standard での例示で、 1 つのグループに 2 つのメタデータラベルと 2 つの値がある例があるので、n 対 m の関係付けが可能な様です。",
  12. ],
  13. "kind": "Normal",
  14. "categories": "None",
  15. "used": [
  16. "dl (dt+,dd+)",
  17. "dl div (dt+,dd+)",
  18. ],
  19. "usedsupplement": [
  20. "dl要素内の、dt要素またはdd要素の後。",
  21. "dl要素の子であるdiv要素内の、dt要素またはdd要素の後。",
  22. ],
  23. "contentmodel": "dd (%Flow)*",
  24. "tag": [
  25. "-",
  26. "O",
  27. ],
  28. "tagsupplement": "dd要素の直後に別の dd要素または dt要素が続く場合、または親要素にそれ以上のコンテンツがない場合は、dd要素の終了タグを省略できます。",
  29. "attributes": "Global",
  30. "dominterface": "HTMLElement",
  31. "rendering": [
  32. "Lists",
  33. "Bidirectional",
  34. ],
  35. "reference": [
  36. {
  37. "title": "HTML Living Standard. 4.4.11 The dd element.",
  38. "href": "https://html.spec.whatwg.org/multipage/grouping-content.html#the-dd-element",
  39. "heading": "HTML Living Standard. 4.4.11 The dd element",
  40. "sub": "Last Updated 27 August 2024",
  41. },
  42. {
  43. "title": "HTML Living Standard. 15 Rendering 15.3.7 Lists.",
  44. "href": "https://html.spec.whatwg.org/multipage/rendering.html#lists",
  45. "heading": "HTML Living Standard. 15 Rendering 15.3.7 Lists",
  46. "sub": "Last Updated 27 August 2024",
  47. },
  48. {
  49. "title": "HTML 5.2 W3C Recommendation. 4.4.11 The dd element. W3C Recommendation, 14 December 2017.",
  50. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/grouping-content.html#the-dd-element",
  51. "heading": "HTML 5.2 W3C 勧告. 4.4.11 The dd element",
  52. "sub": "W3C勧告、2017年12月14日",
  53. },
  54. {
  55. "title": "HTML 5.2 W3C Recommendation. 10.3.8. Lists.",
  56. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#section-lists",
  57. "heading": "HTML 5.2 W3C 勧告. 10.3.8. Lists",
  58. "sub": "W3C勧告、2017年12月14日",
  59. },
  60. {
  61. "title": "HTML 5.1 W3C Recommendation. 4.4.10 The dd element. W3C Recommendation, 1 November 2016.",
  62. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/grouping-content.html#the-dd-element",
  63. "heading": "HTML 5.1 W3C 勧告. 4.4.10 The dd element",
  64. "sub": "W3C勧告、2016年11月1日",
  65. },
  66. {
  67. "title": "HTML 5.1 W3C Recommendation. 10.3.8. Lists. W3C Recommendation, 1 November 2016.",
  68. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#section-lists",
  69. "heading": "HTML 5.1 W3C 勧告. 10.3.8. Lists",
  70. "sub": "W3C勧告、2016年11月1日",
  71. },
  72. {
  73. "title": "HTML 4.01 Specification W3C Recommendation. 10.3 Definition lists: the DL, DT, and DD elements. W3C Recommendation 24 December 1999.",
  74. "href": "https://www.w3.org/TR/html401/struct/lists.html#h-10.3",
  75. "heading": "HTML 4.01 Specification W3C 勧告. 10.3 Definition lists: the DL, DT, and DD elements",
  76. "sub": "W3C勧告1999年12月24日",
  77. },
  78. {
  79. "title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
  80. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/",
  81. "heading": "HTML 3.2 Reference Specification",
  82. "sub": "W3C勧告1997年1月14日",
  83. },
  84. {
  85. "title": "Hypertext Markup Language - 2.0. November 1995.",
  86. "href": "https://www.ietf.org/rfc/rfc1866.txt",
  87. "heading": "Hypertext Markup Language - 2.0",
  88. "sub": "November 1995",
  89. },
  90. {
  91. "title": "Hypertext Markup Language (HTML). June 1993.",
  92. "href": "https://www.w3.org/MarkUp/draft-ietf-iiir-html-01.txt",
  93. "heading": "Hypertext Markup Language (HTML)",
  94. "sub": "June 1993",
  95. },
  96. {
  97. "title": "MDN Web Docs. HTML <dd>: The Description Details element.",
  98. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/dd",
  99. "heading": "<dd>: 詳細説明要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  100. },
  101. ],
  102. "version": {
  103. "first": "HTML",
  104. "latest": "HTML Living Standard",
  105. },
  106. }
  107. }

注意: 簡易に描画する為に、各項目の後ろに , を付与しています。JSON の形式では、末尾の項目の後には , は付けません。

最終確認日

2024-09-01


2.使用可能な箇所

dl要素,
div要素 に
配置できます。

dl要素, div要素に配置できます。

dl要素内の、dt要素またはdd要素の後に配置できます。空の場合はそこに配置できます。(合わせて前にdt要素を配置する必要があります。)

dl要素の子であるdiv要素内の、dt要素またはdd要素の後に配置できます。そのdiv要素が空の場合はそこに配置できます。(合わせて前にdt要素を配置する必要があります。)

dt要素dd要素でグループとして関係を表すので、順番に意味があります。 用語と説明のグループとして解説すると、dt要素で用語を表しそれに続くdd要素でその用語の説明を表します。そしてdt要素dt要素の後ろに続く場合は、それに続くdd要素がそれらの用語の説明を表します。つまり続く用語に同じ説明という事です。 また、説明1, 説明2と説明が複数ある場合は、dd要素dd要素が続く訳です。この続いたdd要素はその前のdt要素の説明となります。尚、dd要素に続くdt要素との間に直接の関連性はありません。同じdl要素の子孫である要素という関係性はあるので、dl要素の影響は等しく受けます。また隣接する要素という事で、マージンの相殺などはあります。 なにより違う用語の説明なので、その違いを意識して表したい処です。


3.配置できるコンテンツ

ヘディングコンテンツ,
セクショニングコンテンツ,
header要素,
footer要素 を除く
フローコンテンツ
配置できます。

dd
Flow
content
  1. <dl>
  2. <dt>テーマ</dt>
  3. <dd>ディスクリプション</dd>
  4. </dl>

dd要素のコンテンツとしてフローコンテンツが配置できて、そのコンテンツが定義用語の説明と表される訳です。

ブロック
フォーマット
コンテキスト
コンテンツ

ボックスで表すと、dd要素が存在して、その中に フローコンテンツがあります。

dd要素は、ブロックレベルブロックコンテナであるボックスを生成します。dd要素を含むブロックフォーマットコンテキストがない場合は、新しいブロックフォーマットコンテキストを確立します。dd要素は、フローコンテンツを配置します。なのでここで インラインフォーマットコンテキストが確立されるか否かは、配置するコンテンツ次第です。
尚、この説明は各要素のレンダリングに関する指定が既定値での話で、個々にスタイルを指定した場合はこの限りではありません。


4.属性

グローバル属性のみ、
設定できます。

dd要素は、グローバル属性のみ 設定できます。


5.Web API

id属性を用いて
getElementById()メソッドで
要素を取得する方法がお勧めです。

dd要素を表すプロパティはないので、id属性を用いて documentgetElementById()メソッドで、要素を取得する方法がお勧めです。この時に取得できるのはHTMLElement オブジェクトです。


6.レンダリング

  1. dd {
  2. display: block;
  3. margin-inline-start: 40px;
  4. unicode-bidi: isolate;
  5. }

dd要素は、ブロックレベルのブロックコンテナであるボックスを生成します。

ブロックフォーマットコンテキストに参加して、ブロックフォーマットコンテキストを継承, 確立します。もし、インラインフォーマットコンテキストに参加するコンテンツのみを含む場合は、新しいインラインフォーマットコンテキストを確立します。次に、すべてのインラインコンテンツをラップするルートインラインボックスも生成します。

unicode-bidi は、置換されない要素のレンダリングでの Bidirectional text(双方向テキスト) に於いての期待される仕様の様です。


7.気を付ける点

一覧表(リスト)

definition description という事で、説明となるのでが、definition list という事で、一覧表(リスト)の一部でもあります。
安易に説明を丁寧に記述していると、文が長くコンテンツとして大きくなります。 説明の補足に図などを添えれば、尚の事コンテンツが大きくなりがちです。 その大きい方が良い場合は、見出し, 区分(セクション) にした方が良いかもしれません。


8.付記