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

picture要素

1.仕様

PICTURE要素は、
含まれる img要素に
複数のソースを提供する
コンテナです。

picture

複数のソースを提供するコンテナ (a container which provides multiple sources)

種類

通常要素

カテゴリ

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

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

エンベデッドコンテンツを受け入れる要素は、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個以上のsource要素と、それに続く1つのimg要素 オプションでスクリプトをサポートする要素が混在

0個以上のsource要素と、それに続く1つのimg要素が配置できます。オプションで、スクリプトをサポートする要素を混在して配置できます。

スクリプトをサポートする要素に分類される要素は、script要素, template要素 です。

タグの省略

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

コンテンツ属性

グローバル属性のみ

DOM インターフェイス
HTMLPictureElement
  1. [Exposed=Window]
  2. interface HTMLPictureElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4. };
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-* 属性="No"

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

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

記述できる aria-* 属性はありません。
著者は picture要素に aria-hidden属性を指定できます。それ以外の場合、他の aria-* 属性は許可されません。

レンダリング
特になし

CSS を大雑把に読むと、 特に指定はされていません。既定値から、フローレイアウトに配置されたときにインラインレベルのボックス(インラインボックス)を生成すると思われます。 などになります。

説明
picture要素は、含まれる img要素に複数のソースを提供するコンテナです。

picture要素は、含まれる img要素に複数のソースを提供するコンテナです。これにより、作成者は、画面のピクセル密度、ビューポートのサイズ、画像形式、その他の要素に基づいて、どの画像リソースを使用するかについて、ユーザー エージェントに宣言的に制御したりヒントを提供したりできます。picture要素は、その子を表します。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>picture要素の例 - (Example of picture element) | 離珠のHTMLでしぃ！</title>
  6. </head>
  7. <body>
  8. <h1>picture要素の例</h1>
  9. <picture>
  10. <source srcset="../Img/G00/demo.gif" media="(max-width: 640px)">
  11. <img src="../Img/G00/risyu.png" alt="Sample gif">
  12. </picture>
  13. <p>この例の picture要素は、画面の横幅で用意している画像が異なります。</p>
  14. </body>
  15. </html>

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

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "picture": {
  3. "check": "2024-09-29",
  4. "group": "Embedded",
  5. "element": "- - (source+,img) +(%Script) -- a container which provides multiple sources. (Normal elements.) [Flow|Phrasing|Embedded|Palpable] --",
  6. "attlist": {"%Global;": ""},
  7. "comment": "複数のソースを提供するコンテナ (a container which provides multiple sources)",
  8. "point": "含まれる img要素に複数のソースを提供するコンテナです。",
  9. "description": "含まれる img要素に複数のソースを提供するコンテナです。これにより、作成者は、画面のピクセル密度、ビューポートのサイズ、画像形式、その他の要素に基づいて、どの画像リソースを使用するかについて、ユーザー エージェントに宣言的に制御したりヒントを提供したりできます。picture要素は、その子を表します。",
  10. "kind": "Normal",
  11. "categories": [
  12. "Flow",
  13. "Phrasing",
  14. "Embedded",
  15. "Palpable",
  16. ],
  17. "used": "parent %Embedded",
  18. "contentmodel": "picture (source*,img) +(%Scriptsupporting)",
  19. "tag": [
  20. "-",
  21. "-",
  22. ],
  23. "attributes": "Global",
  24. "dominterface": "HTMLPictureElement",
  25. "rendering": "None",
  26. "reference": [
  27. {
  28. "title": "HTML Living Standard. 4.8.1 The picture element",
  29. "href": "https://html.spec.whatwg.org/multipage/embedded-content.html#the-picture-element",
  30. "heading": "HTML Living Standard. 4.8.1 The picture element",
  31. "sub": "Last Updated 27 August 2024",
  32. },
  33. {
  34. "title": "HTML 5.2 W3C Recommendation. 4.7.3. The picture element. W3C Recommendation, 14 December 2017.",
  35. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/semantics-embedded-content.html#the-picture-element",
  36. "heading": "HTML 5.2 W3C 勧告. 4.7.3. The picture element",
  37. "sub": "W3C勧告、2017年12月14日",
  38. },
  39. {
  40. "title": "HTML 5.1 W3C Recommendation. 4.7.3. The picture element. W3C Recommendation, 1 November 2016.",
  41. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/semantics-embedded-content.html#the-picture-element",
  42. "heading": "HTML 5.1 W3C 勧告. 4.7.3. The picture element",
  43. "sub": "W3C勧告、2016年11月1日",
  44. },
  45. {
  46. "title": "MDN Web Docs. HTML <picture>: The Picture element.",
  47. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/picture",
  48. "heading": "MDN Web Docs. HTML <picture>: 画像要素",
  49. },
  50. ],
  51. "version": {
  52. "first": "HTML5.1",
  53. "latest": "HTML Living Standard",
  54. },
  55. }
  56. }

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

最終確認日

2024-09-29

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

3.コンテンツモデル

4.コンテンツ属性

5.DOM インターフェイス

6.レンダリング

7.気を付ける点

明示

  1. <img src="./demo.gif" srcset="risyu.png 469w, demo.gif" sizes="(min-width: 640px) 469px" alt="Sample gif">

img要素で srcset属性等を用いても、同等の機能をユーザーエージェントの裁量で実現できます。ただし、ユーザーエージェント（ブラウザ等）の判断に振る舞いは任されています。

Sample gif

8.付記