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

audio要素

1.仕様

AUDIO要素は、
サウンドまたは
オーディオストリームを
表します。

audio

オーディオコンテンツ (audio)

種類

通常要素

カテゴリ
  • フローコンテンツ
  • フレージングコンテンツ
  • エンベデッドコンテンツ
  • インタラクティブコンテンツ(条件付き)
  • パルパブルコンテンツ(条件付き)

controls属性がある場合は、インタラクティブコンテンツ。

controls属性がある場合は、パルパブルコンテンツ。

使用できるコンテキスト
エンベデッドコンテンツを受け入れる要素

エンベデッドコンテンツを受け入れる要素のコンテンツとして、使用できます。

エンベデッドコンテンツを受け入れる要素は、body要素, section要素, nav要素, aside要素, article要素, header要素, footer要素, main要素, address要素, li要素, dt要素, dd要素, caption要素, th要素, td要素, form要素, fieldset要素, search要素, blockquote要素, figure要素, figcaption要素, div要素, dialog要素, h1要素, h2要素, h3要素, h4要素, h5要素, h6要素, p要素, pre要素, output要素, progress要素, meter要素, datalist要素, abbr要素, b要素, bdi要素, bdo要素, cite要素, code要素, data要素, dfn要素, em要素, i要素, kbd要素, mark要素, q要素, s要素, samp要素, small要素, span要素, strong要素, sub要素, sup要素, u要素, var要素 です。

コンテンツモデル
  • 0個以上のtrack要素と、それに続く透過的コンテンツ (メディア要素 を除く)
  • 0個以上のsource要素と、それに続く0個以上のtrack要素と、それに続く透過的コンテンツ (メディア要素 を除く)

0個以上のtrack要素と、それに続く透過的コンテンツが配置できます。ですが、メディア要素は子孫に持てません。
0個以上のsource要素と、それに続く0個以上のtrack要素と、それに続く透過的コンテンツが配置できます。ですが、メディア要素は子孫に持てません。

メディア要素を除く透過的コンテンツに分類される要素は、 です。

要素に src属性がある場合は、0 個以上のtrack要素があり、透明ですが、メディア要素の子孫はありません。

要素に src属性がない場合は、0 個以上のsource要素があり、0 個以上のtrack要素があり、透明ですが、メディア要素の子孫はありません。

タグの省略

どちらのタグも省略できません。

コンテンツ属性
グローバル属性 他
src属性
リソースのアドレス
crossorigin属性
要素がクロスオリジンリクエストを処理する方法
preload属性
メディアリソースにどの程度のバッファリングが必要かを示すヒント
autoplay属性
ページが読み込まれたときにメディアリソースを自動的に開始できることを示唆する
loop属性
メディアリソースをループするかどうか
muted属性
デフォルトでメディアリソースをミュートするかどうか
controls属性
ユーザーエージェントコントロールを表示
DOM インターフェイス
HTMLAudioElement
  1. [Exposed=Window, LegacyFactoryFunction=Audio(optional DOMString src)]
  2. interface HTMLAudioElement : HTMLMediaElement {
  3. [HTMLConstructor] constructor();
  4. };
HTMLMediaElement
  1. [Exposed=Window]
  2. interface HTMLMediaElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. // error state
  6. readonly attribute MediaError? error;
  7.  
  8. // network state
  9. [CEReactions] attribute USVString src;
  10. attribute MediaProvider? srcObject;
  11. readonly attribute USVString currentSrc;
  12. [CEReactions] attribute DOMString? crossOrigin;
  13. const unsigned short NETWORK_EMPTY = 0;
  14. const unsigned short NETWORK_IDLE = 1;
  15. const unsigned short NETWORK_LOADING = 2;
  16. const unsigned short NETWORK_NO_SOURCE = 3;
  17. readonly attribute unsigned short networkState;
  18. [CEReactions] attribute DOMString preload;
  19. readonly attribute TimeRanges buffered;
  20. undefined load();
  21. CanPlayTypeResult canPlayType(DOMString type);
  22.  
  23. // ready state
  24. const unsigned short HAVE_NOTHING = 0;
  25. const unsigned short HAVE_METADATA = 1;
  26. const unsigned short HAVE_CURRENT_DATA = 2;
  27. const unsigned short HAVE_FUTURE_DATA = 3;
  28. const unsigned short HAVE_ENOUGH_DATA = 4;
  29. readonly attribute unsigned short readyState;
  30. readonly attribute boolean seeking;
  31.  
  32. // playback state
  33. attribute double currentTime;
  34. undefined fastSeek(double time);
  35. readonly attribute unrestricted double duration;
  36. object getStartDate();
  37. readonly attribute boolean paused;
  38. attribute double defaultPlaybackRate;
  39. attribute double playbackRate;
  40. attribute boolean preservesPitch;
  41. readonly attribute TimeRanges played;
  42. readonly attribute TimeRanges seekable;
  43. readonly attribute boolean ended;
  44. [CEReactions] attribute boolean autoplay;
  45. [CEReactions] attribute boolean loop;
  46. Promise play();
  47. undefined pause();
  48.  
  49. // controls
  50. [CEReactions] attribute boolean controls;
  51. attribute double volume;
  52. attribute boolean muted;
  53. [CEReactions] attribute boolean defaultMuted;
  54.  
  55. // tracks
  56. [SameObject] readonly attribute AudioTrackList audioTracks;
  57. [SameObject] readonly attribute VideoTrackList videoTracks;
  58. [SameObject] readonly attribute TextTrackList textTracks;
  59. TextTrack addTextTrack(TextTrackKind kind, optional DOMString label = "", optional DOMString language = "");
  60. };
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ロール="あり" aria-* 属性="GlobalAny"

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

作成者が要素に指定してもよい ARIAロール値は、 application です。

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

レンダリング
エンベデッドコンテンツ

CSS を大雑把に読むと、 などになります。

説明
audio要素は、サウンドまたはオーディオストリームを表します。

audio要素は、audio要素内にコンテンツが提供される場合があります。ユーザーエージェントは、このコンテンツをユーザーに表示してはなりません。これは、オーディオをサポートしていない古い Webブラウザーを対象としており、これらの古いブラウザーのユーザーに、オーディオコンテンツにアクセスする方法を知らせるテキストを表示できます。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>audio要素の例 - (Example of audio element) | 離珠のHTMLでしぃ！</title>
  6. </head>
  7. <body>
  8. <h1>audio要素の例</h1>
  9. <audio src="./demo.mp3">このテキストは、audio要素に対応していないブラウザーで代替として表示</audio>
  10. <p>この例の audio要素は、音声ファイルを用意しておりません。記述の例示だけとなっています。</p>
  11. </body>
  12. </html>

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

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "audio": {
  3. "check": "2024-09-29",
  4. "group": "Embedded",
  5. "element": "- - (source*,track*,%Transparent) -(%Media) -- audio. (Normal elements.) [Flow|Phrasing|Embedded|Interactivelimited|Palpablelimited] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "src": "%URI; #IMPLIED -- Address of the resource --",
  9. "crossorigin": "CDATA #IMPLIED -- How the element handles crossorigin requests --",
  10. "preload": "CDATA #IMPLIED -- Hints how much buffering the media resource will likely need --",
  11. "autoplay": "(autoplay) #IMPLIED -- Hint that the media resource can be started automatically when the page is loaded --",
  12. "loop": "(loop) #IMPLIED -- Whether to loop the media resource --",
  13. "muted": "(muted) #IMPLIED -- Whether to mute the media resource by default --",
  14. "controls": "(controls) #IMPLIED -- Show user agent controls --",
  15. },
  16. "comment": "オーディオコンテンツ (audio)",
  17. "point": "サウンドまたはオーディオストリームを表します。",
  18. "description": "audio要素内にコンテンツが提供される場合があります。ユーザーエージェントは、このコンテンツをユーザーに表示してはなりません。これは、オーディオをサポートしていない古い Webブラウザーを対象としており、これらの古いブラウザーのユーザーに、オーディオコンテンツにアクセスする方法を知らせるテキストを表示できます。",
  19. "kind": "Normal",
  20. "categories": [
  21. "Flow",
  22. "Phrasing",
  23. "Embedded",
  24. "Interactivelimited",
  25. "Palpablelimited",
  26. ],
  27. "categoriessupplement": [
  28. "controls属性がある場合は、インタラクティブコンテンツ。",
  29. "controls属性がある場合は、パルパブルコンテンツ。",
  30. ],
  31. "used": "parent %Embedded",
  32. "contentmodel": [
  33. "audio (track*,%Transparent) -(%Media)",
  34. "audio (source*,track*,%Transparent) -(%Media)",
  35. ],
  36. "contentmodelsupplement": [
  37. "要素に src属性がある場合は、0 個以上のtrack要素があり、透明ですが、メディア要素の子孫はありません。",
  38. "要素に src属性がない場合は、0 個以上のsource要素があり、0 個以上のtrack要素があり、透明ですが、メディア要素の子孫はありません。",
  39. ],
  40. "tag": [
  41. "-",
  42. "-",
  43. ],
  44. "attributes": {
  45. "src": "リソースのアドレス",
  46. "crossorigin": "要素がクロスオリジンリクエストを処理する方法",
  47. "preload": "メディアリソースにどの程度のバッファリングが必要かを示すヒント",
  48. "autoplay": "ページが読み込まれたときにメディアリソースを自動的に開始できることを示唆する",
  49. "loop": "メディアリソースをループするかどうか",
  50. "muted": "デフォルトでメディアリソースをミュートするかどうか",
  51. "controls": "ユーザーエージェントコントロールを表示",
  52. },
  53. "dominterface": "HTMLAudioElement",
  54. "rendering": "Embedded",
  55. "reference": [
  56. {
  57. "title": "HTML Living Standard. 4.8.9 The audio element",
  58. "href": "https://html.spec.whatwg.org/multipage/media.html#the-audio-element",
  59. "heading": "HTML Living Standard. 4.8.9 The audio element",
  60. "sub": "Last Updated 27 August 2024",
  61. },
  62. {
  63. "title": "HTML Living Standard. 15 Rendering 15.4.1 Embedded content",
  64. "href": "https://html.spec.whatwg.org/multipage/rendering.html#embedded-content-rendering-rules",
  65. "heading": "HTML Living Standard. 15 Rendering 15.4.1 Embedded content",
  66. "sub": "Last Updated 27 August 2024",
  67. },
  68. {
  69. "title": "HTML 5.2 W3C Recommendation. 4.7.11. The audio element. W3C Recommendation, 14 December 2017.",
  70. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/semantics-embedded-content.html#the-audio-element",
  71. "heading": "HTML 5.2 W3C 勧告. 4.7.11. The audio element",
  72. "sub": "W3C勧告、2017年12月14日",
  73. },
  74. {
  75. "title": "HTML 5.2 W3C Recommendation. 10.4.1. Embedded content. W3C Recommendation, 14 December 2017.",
  76. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#replaced-elements-embedded-content",
  77. "heading": "HTML 5.2 W3C 勧告. 10.4.1. Embedded content",
  78. "sub": "W3C勧告、2017年12月14日",
  79. },
  80. {
  81. "title": "HTML 5.1 W3C Recommendation. 4.7.11. The audio element. W3C Recommendation, 1 November 2016.",
  82. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/semantics-embedded-content.html#the-audio-element",
  83. "heading": "HTML 5.1 W3C 勧告. 4.7.11. The audio element",
  84. "sub": "W3C勧告、2016年11月1日",
  85. },
  86. {
  87. "title": "HTML 5.1 W3C Recommendation. 10.4.1. Embedded content. W3C Recommendation, 1 November 2016.",
  88. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#replaced-elements-embedded-content",
  89. "heading": "HTML 5.1 W3C 勧告. 10.4.1. Embedded content",
  90. "sub": "W3C勧告、2016年11月1日",
  91. },
  92. {
  93. "title": "HTML 5 W3C Recommendation. 4.7.7 The audio element. W3C Recommendation, 28 October 2014.",
  94. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-audio-element",
  95. "heading": "HTML 5 W3C 勧告. 4.7.7 The audio element",
  96. "sub": "W3C勧告、2014年10月28日",
  97. },
  98. {
  99. "title": "HTML 5 W3C Recommendation. 10.4.1 Embedded content. W3C Recommendation, 28 October 2014.",
  100. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#embedded-content-1",
  101. "heading": "HTML 5 W3C 勧告. 10.4.1 Embedded content",
  102. "sub": "W3C勧告、2014年10月28日",
  103. },
  104. {
  105. "title": "MDN Web Docs. HTML <audio>: The Embed Audio element.",
  106. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/audio",
  107. "heading": "MDN Web Docs. HTML <audio>: 埋め込み音声要素",
  108. },
  109. ],
  110. "version": {
  111. "first": "HTML5",
  112. "latest": "HTML Living Standard",
  113. },
  114. }
  115. }

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

最終確認日

2024-09-29

2.使用できるコンテキスト

3.コンテンツモデル

4.コンテンツ属性

5.DOM インターフェイス

6.レンダリング

7.気を付ける点

8.付記