目次

  1. 1 はじめに
  2. 2 共通インフラストラクチャ
  3. 3 HTML文書の意味論、構造、およびAPI
  4. 4 HTMLの要素
  5. 5 マイクロデータ
  6. 6 ユーザーインタラクション
  7. 7 ウェブページの読み込み
  8. 8 ウェブアプリケーションAPI
  9. 9 通信
  10. 10 Webワーカー
  11. 11 ワークレット
  12. 12 ウェブストレージ
  13. 13 HTML構文
  14. 14 XML構文
  15. 15 レンダリング
  16. 16 廃止された機能
  17. 17 IANA考慮事項
  18. 索引
  19. 参考文献
  20. 謝辞
  21. 知的財産権

目次

  1. 1 はじめに
    1. 1.1 この仕様の位置付け
    2. 1.2 これはHTML5ですか?
    3. 1.3 背景
    4. 1.4 対象読者
    5. 1.5 範囲
    6. 1.6 歴史
    7. 1.7 設計メモ
      1. 1.7.1 スクリプト実行の直列化可能性
      2. 1.7.2 拡張性
    8. 1.8 HTMLとXMLの構文の違い
    9. 1.9 この仕様の構成
      1. 1.9.1 この仕様の読み方
      2. 1.9.2 文章体裁の規則
    10. 1.10 HTMLの簡単な紹介
      1. 1.10.1 HTMLで安全なアプリケーションを作成する
      2. 1.10.2 スクリプトAPIを使用する際に避けるべき一般的な落とし穴
      3. 1.10.3 HTMLを書く際にミスを発見する方法：バリデーターと適合チェッカー
    11. 1.11 作成者のための適合要件
      1. 1.11.1 表示専用のマークアップ
      2. 1.11.2 構文エラー
      3. 1.11.3 コンテンツモデルと属性値に関する制限
    12. 1.12 推奨読書
  2. 2 共通インフラストラクチャ
    1. 2.1 用語
      1. 2.1.1 並行処理
      2. 2.1.2 リソース
      3. 2.1.3 XML互換性
      4. 2.1.4 DOMツリー
      5. 2.1.5 スクリプティング
      6. 2.1.6 プラグイン
      7. 2.1.7 文字エンコーディング
      8. 2.1.8 適合クラス
      9. 2.1.9 依存関係
      10. 2.1.10 拡張性
      11. 2.1.11 XPathおよびXSLTとの相互作用
    2. 2.2 ポリシーで制御された機能
    3. 2.3 共通マイクロ構文
      1. 2.3.1 共通のパーサー慣用句
      2. 2.3.2 ブール属性
      3. 2.3.3 キーワードと列挙型属性
      4. 2.3.4 数字
        1. 2.3.4.1 符号付き整数
        2. 2.3.4.2 非負の整数
        3. 2.3.4.3 浮動小数点数
        4. 2.3.4.4 パーセンテージと長さ
        5. 2.3.4.5 ゼロでないパーセンテージと長さ
        6. 2.3.4.6 浮動小数点数のリスト
        7. 2.3.4.7 次元のリスト
      5. 2.3.5 日付と時刻
        1. 2.3.5.1 月
        2. 2.3.5.2 日付
        3. 2.3.5.3 年のない日付
        4. 2.3.5.4 時間
        5. 2.3.5.5 ローカルの日付と時刻
        6. 2.3.5.6 タイムゾーン
        7. 2.3.5.7 グローバルの日付と時刻
        8. 2.3.5.8 週
        9. 2.3.5.9 デュレーション
        10. 2.3.5.10 より曖昧な時間の瞬間
      6. 2.3.6 レガシーカラー
      7. 2.3.7 スペースで区切られたトークン
      8. 2.3.8 コンマ区切りのトークン
      9. 2.3.9 参照
      10. 2.3.10 メディアクエリ
      11. 2.3.11 一意の内部値
    4. 2.4 URL
      1. 2.4.1 用語
      2. 2.4.2 URLの解析
      3. 2.4.3 ベースURLの動的変更
    5. 2.5 リソースのフェッチ
      1. 2.5.1 用語
      2. 2.5.2 リソースの種類を決定する
      3. 2.5.3 meta要素から文字エンコーディングを抽出する
      4. 2.5.4 CORS設定属性
      5. 2.5.5 リファラーポリシー属性
      6. 2.5.6 Nonce 属性
      7. 2.5.7 レイジーローディング属性
      8. 2.5.8 ブロッキング属性
      9. 2.5.9 フェッチ優先属性
    6. 2.6 共通DOMインターフェース
      1. 2.6.1 IDL属性へのコンテンツ属性の反映
      2. 2.6.2 仕様でのreflectの使用
      3. 2.6.3 コレクション
        1. 2.6.3.1 HTMLAllCollectionインターフェイス
          1. 2.6.3.1.1 [[Call]] ( thisArgument, argumentsList )
        2. 2.6.3.2 HTMLFormControlsCollectionインターフェイス
        3. 2.6.3.3 HTMLOptionsCollectionインターフェイス
      4. 2.6.4 DOMStringListインターフェイス
    7. 2.7 構造化データの安全な受け渡し
      1. 2.7.1 シリアル化可能オブジェクト
      2. 2.7.2 転送可能なオブジェクト
      3. 2.7.3 StructuredSerializeInternal ( value, forStorage [ , memory ] )
      4. 2.7.4 StructuredSerialize ( value )
      5. 2.7.5 StructuredSerializeForStorage ( value )
      6. 2.7.6 StructuredDeserialize ( serialized, targetRealm [ , memory ] )
      7. 2.7.7 StructuredSerializeWithTransfer ( value, transferList )
      8. 2.7.8 StructuredDeserializeWithTransfer ( serializeWithTransferResult, targetRealm )
      9. 2.7.9 他の仕様からのシリアライズと転送の実行
      10. 2.7.10 構造化クローンAPI
  3. 3 HTML文書のセマンティクス、構造、およびAPI
    1. 3.1 文書
      1. 3.1.1 Documentオブジェクト
      2. 3.1.2 DocumentOrShadowRootインターフェイス
      3. 3.1.3 リソースメタデータ管理
      4. 3.1.4 ドキュメント読み込みステータスの報告
      5. 3.1.5 レンダーブロッキングメカニズム
      6. 3.1.6 DOMツリーアクセサ
    2. 3.2 要素
      1. 3.2.1 セマンティクス
      2. 3.2.2 DOMの要素
      3. 3.2.3 HTML要素のコンストラクタ
      4. 3.2.4 要素の定義
        1. 3.2.4.1 属性
      5. 3.2.5 コンテンツモデル
        1. 3.2.5.1 「何も含まない」コンテンツモデル
        2. 3.2.5.2 コンテンツの種類
          1. 3.2.5.2.1 メタデータコンテンツ
          2. 3.2.5.2.2 フローコンテンツ
          3. 3.2.5.2.3 区分化コンテンツ
          4. 3.2.5.2.4 見出しコンテンツ
          5. 3.2.5.2.5 フレージングコンテンツ
          6. 3.2.5.2.6 埋め込みコンテンツ
          7. 3.2.5.2.7 インタラクティブコンテンツ
          8. 3.2.5.2.8 触知可能なコンテンツ
          9. 3.2.5.2.9 スクリプト支援要素
        3. 3.2.5.3 透明なコンテンツモデル
        4. 3.2.5.4 段落
      6. 3.2.6 グローバル属性
        1. 3.2.6.1 title属性
        2. 3.2.6.2 langとxml:lang属性
        3. 3.2.6.3 translate属性
        4. 3.2.6.4 dir属性
        5. 3.2.6.5 style属性
        6. 3.2.6.6 カスタムの非表示データを埋め込むための data-* 属性
      7. 3.2.7 innerTextおよびouterTextプロパティ
      8. 3.2.8 双方向アルゴリズムに関連する要件
        1. 3.2.8.1 双方向アルゴリズムの書式設定文字に関する著者適合基準
        2. 3.2.8.2 ユーザーエージェント適合基準
      9. 3.2.9 ARIAおよびプラットフォームアクセシビリティAPIに関連する要件
  4. 4 HTMLの要素
    1. 4.1 文書要素
      1. 4.1.1 html要素
    2. 4.2 ドキュメントのメタデータ
      1. 4.2.1 head要素
      2. 4.2.2 title要素
      3. 4.2.3 base要素
      4. 4.2.4 link要素
        1. 4.2.4.1 media属性の処理
        2. 4.2.4.2 type属性の処理
        3. 4.2.4.3 link要素からリソースを取得して処理する
        4. 4.2.4.4 リンク`Link`ヘッダーの処理
        5. 4.2.4.5 早期ヒント
        6. 4.2.4.6 link要素を使用して作成されたハイパーリンクをユーザーが辿る手段の提供
      5. 4.2.5 meta要素
        1. 4.2.5.1 標準メタデータ名
        2. 4.2.5.2 その他のメタデータ名
        3. 4.2.5.3 プラグマ指令
        4. 4.2.5.4 文書の文字エンコーディングの指定
      6. 4.2.6 style要素
      7. 4.2.7 スタイリングとスクリプティングの相互作用
    3. 4.3 セクション
      1. 4.3.1 body要素
      2. 4.3.2 article要素
      3. 4.3.3 section要素
      4. 4.3.4 nav要素
      5. 4.3.5 aside要素
      6. 4.3.6 h1, h2, h3, h4, h5および h6要素
      7. 4.3.7 hgroup要素
      8. 4.3.8 header要素
      9. 4.3.9 footer要素
      10. 4.3.10 address要素
      11. 4.3.11 見出しとアウトライン
        1. 4.3.11.1 サンプルアウトライン
        2. 4.3.11.2 ユーザーへのアウトラインの表示
      12. 4.3.12 使用の概要
        1. 4.3.12.1 記事またはセクション？
    4. 4.4 コンテンツのグループ化
      1. 4.4.1 p要素
      2. 4.4.2 hr要素
      3. 4.4.3 pre要素
      4. 4.4.4 blockquote要素
      5. 4.4.5 ol要素
      6. 4.4.6 ul要素
      7. 4.4.7 menu要素
      8. 4.4.8 li要素
      9. 4.4.9 dl要素
      10. 4.4.10 dt要素
      11. 4.4.11 dd要素
      12. 4.4.12 figure要素
      13. 4.4.13 figcaption要素
      14. 4.4.14 main要素
      15. 4.4.15 search要素
      16. 4.4.16 div要素
    5. 4.5 テキストレベルのセマンティクス
      1. 4.5.1 a要素
      2. 4.5.2 em要素
      3. 4.5.3 strong要素
      4. 4.5.4 small要素
      5. 4.5.5 s要素
      6. 4.5.6 cite要素
      7. 4.5.7 q要素
      8. 4.5.8 dfn要素
      9. 4.5.9 abbr要素
      10. 4.5.10 ruby要素
      11. 4.5.11 rt要素
      12. 4.5.12 rp要素
      13. 4.5.13 data要素
      14. 4.5.14 time要素
      15. 4.5.15 code要素
      16. 4.5.16 var要素
      17. 4.5.17 samp要素
      18. 4.5.18 kbd要素
      19. 4.5.19 subおよびsup要素
      20. 4.5.20 i要素
      21. 4.5.21 b要素
      22. 4.5.22 u要素
      23. 4.5.23 mark要素
      24. 4.5.24 bdi要素
      25. 4.5.25 bdo要素
      26. 4.5.26 span要素
      27. 4.5.27 br要素
      28. 4.5.28 wbr要素
      29. 4.5.29 使用の概要
    6. 4.6 リンク
      1. 4.6.1 イントロダクション
      2. 4.6.2 aおよびarea要素によって作成されるリンク
      3. 4.6.3 aおよびarea要素のAPI
      4. 4.6.4 ハイパーリンクのフォロー
      5. 4.6.5 リソースのダウンロード
      6. 4.6.6 ハイパーリンク監査
        1. 4.6.6.1 `Ping-From`ヘッダーと`Ping-To`ヘッダー
      7. 4.6.7 リンクタイプ
        1. 4.6.7.1 リンクタイプ "alternate"
        2. 4.6.7.2 リンクタイプ "author"
        3. 4.6.7.3 リンクタイプ "bookmark"
        4. 4.6.7.4 リンクタイプ "canonical"
        5. 4.6.7.5 リンクタイプ "dns-prefetch"
        6. 4.6.7.6 リンクタイプ "expect"
        7. 4.6.7.7 リンクタイプ "external"
        8. 4.6.7.8 リンクタイプ "help"
        9. 4.6.7.9 リンクタイプ "icon"
        10. 4.6.7.10 リンクタイプ "license"
        11. 4.6.7.11 リンクタイプ "manifest"
        12. 4.6.7.12 リンクタイプ "modulepreload"
        13. 4.6.7.13 リンクタイプ "nofollow"
        14. 4.6.7.14 リンクタイプ "noopener"
        15. 4.6.7.15 リンクタイプ "noreferrer"
        16. 4.6.7.16 リンクタイプ "opener"
        17. 4.6.7.17 リンクタイプ "pingback"
        18. 4.6.7.18 リンクタイプ "preconnect"
        19. 4.6.7.19 リンクタイプ "prefetch"
        20. 4.6.7.20 リンクタイプ "preload"
        21. 4.6.7.21 リンクタイプ "privacy-policy"
        22. 4.6.7.22 リンクタイプ "search"
        23. 4.6.7.23 リンクタイプ "stylesheet"
        24. 4.6.7.24 リンクタイプ "tag"
        25. 4.6.7.25 リンクタイプ "terms-of-service"
        26. 4.6.7.26 順序リンクタイプ
          1. 4.6.7.26.1 リンクタイプ "next"
          2. 4.6.7.26.2 リンクタイプ "prev"
        27. 4.6.7.27 その他のリンクタイプ
    7. 4.7 編集
      1. 4.7.1 ins要素
      2. 4.7.2 del要素
      3. 4.7.3 ins要素とdel要素に共通する属性
      4. 4.7.4 編集と段落
      5. 4.7.5 編集とリスト
      6. 4.7.6 編集とテーブル
    8. 4.8 埋め込みコンテンツ
      1. 4.8.1 picture要素
      2. 4.8.2 source要素
      3. 4.8.3 img要素
      4. 4.8.4 画像
        1. 4.8.4.1 概要
          1. 4.8.4.1.1 適応画像
        2. 4.8.4.2 source、img、link要素に共通の属性
          1. 4.8.4.2.1 Srcset属性
          2. 4.8.4.2.2 サイズ属性
        3. 4.8.4.3 処理モデル
          1. 4.8.4.3.1 画像を取得するタイミング
          2. 4.8.4.3.2 DOM変異への反応
          3. 4.8.4.3.3 利用可能な画像のリスト
          4. 4.8.4.3.4 画像のデコード
          5. 4.8.4.3.5 画像データの更新
          6. 4.8.4.3.6 プレゼンテーションのための画像の準備
          7. 4.8.4.3.7 画像ソースの選択
          8. 4.8.4.3.8 属性からソースセットの作成
          9. 4.8.4.3.9 ソースセットの更新
          10. 4.8.4.3.10 srcset属性の解析
          11. 4.8.4.3.11 sizes属性の解析
          12. 4.8.4.3.12 ソース密度の正規化
          13. 4.8.4.3.13 環境の変化に反応する
        4. 4.8.4.4 画像の代替となるテキストを提供するための要件
          1. 4.8.4.4.1 一般的なガイドライン
          2. 4.8.4.4.2 画像のみを含むリンクまたはボタン
          3. 4.8.4.4.3 代替グラフィカル表現を持つフレーズや段落: チャート、ダイアグラム、グラフ、地図、イラスト
          4. 4.8.4.4.4 代替グラフィカル表現を持つ短いフレーズやラベル: アイコン、ロゴ
          5. 4.8.4.4.5 書体効果を狙ってグラフィック化されたテキスト
          6. 4.8.4.4.6 周囲のテキストの一部をグラフィカルに表現したもの
          7. 4.8.4.4.7 補助的な画像
          8. 4.8.4.4.8 純粋に装飾的で情報を追加しない画像
          9. 4.8.4.4.9 複数の画像が連結して1つの大きな画像を形成するが、リンクがない場合
          10. 4.8.4.4.10 リンクを含む複数の画像が連結して1つの大きな画像を形成する場合
          11. 4.8.4.4.11 コンテンツの重要な部分
          12. 4.8.4.4.12 ユーザーを対象としない画像
          13. 4.8.4.4.13 画像を表示できることがわかっている特定の人物に向けたメールまたはプライベートドキュメント内の画像
          14. 4.8.4.4.14 マークアップジェネレーターへのガイダンス
          15. 4.8.4.4.15 適合チェッカーへのガイダンス
      5. 4.8.5 iframe要素
      6. 4.8.6 embed要素
      7. 4.8.7 object要素
      8. 4.8.8 video要素
      9. 4.8.9 audio要素
      10. 4.8.10 track要素
      11. 4.8.11 メディア要素
        1. 4.8.11.1 エラーコード
        2. 4.8.11.2 メディアリソースの場所
        3. 4.8.11.3 MIMEタイプ
        4. 4.8.11.4 ネットワーク状態
        5. 4.8.11.5 メディアリソースの読み込み
        6. 4.8.11.6 メディアリソース内のオフセット
        7. 4.8.11.7 レディ状態
        8. 4.8.11.8 メディアリソースの再生
        9. 4.8.11.9 シーク
        10. 4.8.11.10 複数のメディアトラックを持つメディアリソース
          1. 4.8.11.10.1 AudioTrackListおよびVideoTrackListオブジェクト
          2. 4.8.11.10.2 特定のオーディオおよびビデオトラックを宣言的に選択する
        11. 4.8.11.11 タイムドテキストトラック
          1. 4.8.11.11.1 テキストトラックモデル
          2. 4.8.11.11.2 インバンドテキストトラックの取得
          3. 4.8.11.11.3 アウトバンドテキストトラックの取得
          4. 4.8.11.11.4 さまざまな形式でキューを公開するためのガイドラインをテキストトラックキューとして公開します
          5. 4.8.11.11.5 テキストトラックAPI
          6. 4.8.11.11.6 テキストトラックAPIオブジェクトのイベントハンドラー
          7. 4.8.11.11.7 メタデータテキストトラックのベストプラクティス
        12. 4.8.11.12 URLを介してトラックの種類を識別する
        13. 4.8.11.13 ユーザーインターフェース
        14. 4.8.11.14 時間範囲
        15. 4.8.11.15 TrackEventインターフェース
        16. 4.8.11.16 イベントの概要
        17. 4.8.11.17 セキュリティとプライバシーに関する考慮事項
        18. 4.8.11.18 メディア要素を使用する著者のためのベストプラクティス
        19. 4.8.11.19 メディア要素を実装する際のベストプラクティス
      12. 4.8.12 map要素
      13. 4.8.13 area要素
      14. 4.8.14 イメージマップ
        1. 4.8.14.1 オーサリング
        2. 4.8.14.2 処理モデル
      15. 4.8.15 MathML
      16. 4.8.16 SVG
      17. 4.8.17 次元属性
    9. 4.9 表データ
      1. 4.9.1 table要素
        1. 4.9.1.1 テーブルを説明するための技術
        2. 4.9.1.2 テーブルデザインの技術
      2. 4.9.2 caption要素
      3. 4.9.3 colgroup要素
      4. 4.9.4 col要素
      5. 4.9.5 tbody要素
      6. 4.9.6 thead要素
      7. 4.9.7 tfoot要素
      8. 4.9.8 tr要素
      9. 4.9.9 td要素
      10. 4.9.10 th要素
      11. 4.9.11 tdおよびth要素に共通する属性
      12. 4.9.12 処理モデル
        1. 4.9.12.1 テーブルの形成
        2. 4.9.12.2 データセルとヘッダーセルの関係を形成する
      13. 4.9.13 例
    10. 4.10 フォーム
      1. 4.10.1 導入
        1. 4.10.1.1 フォームのユーザーインターフェースの記述
        2. 4.10.1.2 フォームのサーバーサイド処理の実装
        3. 4.10.1.3 フォームをサーバーと通信するように設定する
        4. 4.10.1.4 クライアント側のフォーム検証
        5. 4.10.1.5 フォームコントロールのクライアントサイド自動入力の有効化
        6. 4.10.1.6 モバイルデバイスでのユーザーエクスペリエンスの向上
        7. 4.10.1.7 フィールドタイプ、オートフィルフィールド名、および入力モダリティの違い
        8. 4.10.1.8 日付、時刻、および数値の形式
      2. 4.10.2 カテゴリ
      3. 4.10.3 form要素
      4. 4.10.4 label要素
      5. 4.10.5 input要素
        1. 4.10.5.1 type属性の状態
          1. 4.10.5.1.1 Hidden状態 (type=hidden)
          2. 4.10.5.1.2 Text (type=text)状態およびSearch状態 (type=search)
          3. 4.10.5.1.3 電話状態 (type=tel)
          4. 4.10.5.1.4 URL状態 (type=url)
          5. 4.10.5.1.5 メール状態 (type=email)
          6. 4.10.5.1.6 パスワード状態 (type=password)
          7. 4.10.5.1.7 日付状態 (type=date)
          8. 4.10.5.1.8 月状態 (type=month)
          9. 4.10.5.1.9 週状態 (type=week)
          10. 4.10.5.1.10 時間状態 (type=time)
          11. 4.10.5.1.11 ローカル日時 状態 (type=datetime-local)
          12. 4.10.5.1.12 数値状態 (type=number)
          13. 4.10.5.1.13 範囲状態 (type=range)
          14. 4.10.5.1.14 カラー 状態 (type=color)
          15. 4.10.5.1.15 チェックボックスの状態 (type=checkbox)
          16. 4.10.5.1.16 ラジオボタンの状態 (type=radio)
          17. 4.10.5.1.17 ファイルアップロードの状態 (type=file)
          18. 4.10.5.1.18 送信ボタン状態 (type=submit)
          19. 4.10.5.1.19 画像ボタン状態 (type=image)
          20. 4.10.5.1.20 リセットボタン 状態 (type=reset)
          21. 4.10.5.1.21 ボタン 状態 (type=button)
        2. 4.10.5.2 フォームコントロールのローカリゼーションに関する実装上の注意事項
        3. 4.10.5.3 共通のinput要素の属性
          1. 4.10.5.3.1 maxlengthおよびminlength属性
          2. 4.10.5.3.2 size属性
          3. 4.10.5.3.3 readonly属性
          4. 4.10.5.3.4 required属性
          5. 4.10.5.3.5 multiple属性
          6. 4.10.5.3.6 pattern属性
          7. 4.10.5.3.7 min属性およびmax属性
          8. 4.10.5.3.8 step属性
          9. 4.10.5.3.9 list属性
          10. 4.10.5.3.10 placeholder属性
        4. 4.10.5.4 共通のinput要素API
        5. 4.10.5.5 共通イベントの動作
      6. 4.10.6 button要素
      7. 4.10.7 select要素
      8. 4.10.8 datalist要素
      9. 4.10.9 optgroup要素
      10. 4.10.10 option要素
      11. 4.10.11 textarea要素
      12. 4.10.12 output要素
      13. 4.10.13 progress要素
      14. 4.10.14 meter要素
      15. 4.10.15 fieldset要素
      16. 4.10.16 legend要素
      17. 4.10.17 フォームコントロールのインフラストラクチャ
        1. 4.10.17.1 フォームコントロールの値
        2. 4.10.17.2 変更可能性
        3. 4.10.17.3 コントロールとフォームの関連付け
      18. 4.10.18 フォームコントロールに共通する属性
        1. 4.10.18.1 フォームコントロールの命名: name属性
        2. 4.10.18.2 要素の方向性の送信: dirname属性
        3. 4.10.18.3 ユーザー入力の長さの制限: maxlength属性
        4. 4.10.18.4 最小入力長の要件を設定: minlength属性
        5. 4.10.18.5 フォームコントロールの有効化と無効化: disabled属性
        6. 4.10.18.6 フォーム送信属性
        7. 4.10.18.7 オートフィル
          1. 4.10.18.7.1 オートフィルによるフォームコントロールの自動入力: autocomplete属性
          2. 4.10.18.7.2 処理モデル
      19. 4.10.19 テキストコントロールの選択に関するAPI
      20. 4.10.20 制約
        1. 4.10.20.1 定義
        2. 4.10.20.2 制約の検証
        3. 4.10.20.3 制約検証API
        4. 4.10.20.4 セキュリティ
      21. 4.10.21 フォーム送信
        1. 4.10.21.1 はじめに
        2. 4.10.21.2 暗黙の送信
        3. 4.10.21.3 フォーム送信アルゴリズム
        4. 4.10.21.4 エントリリストの構築
        5. 4.10.21.5 フォーム送信エンコーディングの選択
        6. 4.10.21.6 エントリーリストを名前と値のペアのリストに変換する
        7. 4.10.21.7 URLエンコードされたフォームデータ
        8. 4.10.21.8 マルチパートフォームデータ
        9. 4.10.21.9 プレーンテキストのフォームデータ
        10. 4.10.21.10 SubmitEventインターフェイス
        11. 4.10.21.11 FormDataEventインターフェイス
      22. 4.10.22 フォームのリセット
    11. 4.11 インタラクティブ要素
      1. 4.11.1 details要素
      2. 4.11.2 summary要素
      3. 4.11.3 コマンド
        1. 4.11.3.1 ファセット
        2. 4.11.3.2 a要素を使用してコマンドを定義する
        3. 4.11.3.3 button要素を使用してコマンドを定義する
        4. 4.11.3.4 input要素を使用してコマンドを定義する
        5. 4.11.3.5 option要素を使用してコマンドを定義する
        6. 4.11.3.6 legend要素でaccesskey属性を使用してコマンドを定義する
        7. 4.11.3.7 accesskey属性を使用して他の要素でコマンドを定義する
      4. 4.11.4 dialog要素
      5. 4.11.5 ダイアログのライトディスミス
    12. 4.12 スクリプティング
      1. 4.12.1 script要素
        1. 4.12.1.1 処理モデル
        2. 4.12.1.2 スクリプト言語
        3. 4.12.1.3 スクリプト要素の内容に対する制限
        4. 4.12.1.4 外部スクリプトのインラインドキュメント
        5. 4.12.1.5 script要素とXSLTの相互作用
      2. 4.12.2 noscript要素
      3. 4.12.3 template要素
        1. 4.12.3.1 template要素とXSLTおよびXPathの相互作用
      4. 4.12.4 slot要素
      5. 4.12.5 canvas要素
        1. 4.12.5.1 2Dレンダリングコンテキスト
          1. 4.12.5.1.1 Implementation notes
          2. 4.12.5.1.2 キャンバス設定
          3. 4.12.5.1.3 キャンバスの状態
          4. 4.12.5.1.4 線のスタイル
          5. 4.12.5.1.5 テキストスタイル
          6. 4.12.5.1.6 パスの構築
          7. 4.12.5.1.7 Path2Dオブジェクト
          8. 4.12.5.1.8 変換
          9. 4.12.5.1.9 2Dレンダリングコンテキストの画像ソース
          10. 4.12.5.1.10 塗りつぶしとストロークスタイル
          11. 4.12.5.1.11 ビットマップへの長方形の描画
          12. 4.12.5.1.12 ビットマップにテキストを描画する
          13. 4.12.5.1.13 キャンバスへのパスの描画
          14. 4.12.5.1.14 フォーカスリングの描画
          15. 4.12.5.1.15 画像の描画
          16. 4.12.5.1.16 ピクセル操作
          17. 4.12.5.1.17 合成
          18. 4.12.5.1.18 画像のスムージング
          19. 4.12.5.1.19 シャドウ
          20. 4.12.5.1.20 フィルター
          21. 4.12.5.1.21 外部定義のSVGフィルターの使用
          22. 4.12.5.1.22 描画モデル
          23. 4.12.5.1.23 ベストプラクティス
          24. 4.12.5.1.24 例
        2. 4.12.5.2 ImageBitmapレンダリングコンテキスト
          1. 4.12.5.2.1 はじめに
          2. 4.12.5.2.2 ImageBitmapRenderingContextインターフェイス
        3. 4.12.5.3 OffscreenCanvasインターフェイス
          1. 4.12.5.3.1 オフスクリーン2Dレンダリングコンテキスト
        4. 4.12.5.4 色空間と色空間変換
        5. 4.12.5.5 ビットマップのファイルへのシリアル化
        6. 4.12.5.6 canvas要素のセキュリティ
        7. 4.12.5.7 プリマルチプライドアルファと2Dレンダリングコンテキスト
    13. 4.13 カスタム要素
      1. 4.13.1 はじめに
        1. 4.13.1.1 独立したカスタム要素の作成
        2. 4.13.1.2 フォームに関連するカスタム要素の作成
        3. 4.13.1.3 デフォルトのアクセシブルなロール、状態、およびプロパティを持つカスタム要素の作成
        4. 4.13.1.4 カスタマイズされたビルトイン要素の作成
        5. 4.13.1.5 自律カスタム要素の欠点
        6. 4.13.1.6 要素の生成後のアップグレード
        7. 4.13.1.7 カスタム要素の状態の公開
      2. 4.13.2 カスタム要素のコンストラクターと反応の要件
        1. 4.13.2.1 移動時のカスタム要素の状態の保持
      3. 4.13.3 カスタム要素の基本概念
      4. 4.13.4 CustomElementRegistryインターフェース
      5. 4.13.5 アップグレード
      6. 4.13.6 カスタム要素のリアクション
      7. 4.13.7 要素内部機能
        1. 4.13.7.1 ElementInternalsインターフェース
        2. 4.13.7.2 シャドウルートへのアクセス
        3. 4.13.7.3 フォーム関連カスタム要素
        4. 4.13.7.4 アクセシビリティセマンティクス
        5. 4.13.7.5 カスタム状態擬似クラス
    14. 4.14 専用の要素がない一般的な慣用表現
      1. 4.14.1 パンくずリストナビゲーション
      2. 4.14.2 タグクラウド
      3. 4.14.3 会話
      4. 4.14.4 脚注
    15. 4.15 無効化された要素
    16. 4.16 セレクターとCSSを使用したHTML要素のマッチング
      1. 4.16.1 CSS 'attr()'関数の大文字小文字の区別
      2. 4.16.2 セレクタの大文字小文字の区別
      3. 4.16.3 疑似クラス
  5. 5 マイクロデータ
    1. 5.1 はじめに
      1. 5.1.1 概要
      2. 5.1.2 基本構文
      3. 5.1.3 タイプ付きアイテム
      4. 5.1.4 アイテムのグローバル識別子
      5. 5.1.5 語彙を定義する際の名前の選択
    2. 5.2 マイクロデータのエンコーディング
      1. 5.2.1 マイクロデータモデル
      2. 5.2.2 アイテム
      3. 5.2.3 名前: itemprop 属性
      4. 5.2.4 値
      5. 5.2.5 アイテムに名前を関連付ける
      6. 5.2.6 マイクロデータと他の名前空間
    3. 5.3 マイクロデータ語彙のサンプル
      1. 5.3.1 vCard
        1. 5.3.1.1 vCardへの変換
        2. 5.3.1.2 例
      2. 5.3.2 vEvent
        1. 5.3.2.1 iCalendarへの変換
        2. 5.3.2.2 例
      3. 5.3.3 ライセンス付与作品
        1. 5.3.3.1 例
    4. 5.4 HTMLを他のフォーマットに変換
      1. 5.4.1 JSON
  6. 6 ユーザーインタラクション
    1. 6.1 hidden 属性
    2. 6.2 ページの可視性
      1. 6.2.1 VisibilityStateEntry インターフェイス
    3. 6.3 非活性サブツリー
      1. 6.3.1 モーダルダイアログと非活性サブツリー
      2. 6.3.2 inert 属性
    4. 6.4 ユーザーアクティベーションの追跡
      1. 6.4.1 データモデル
      2. 6.4.2 処理モデル
      3. 6.4.3 ユーザーアクティベーションに依存するAPI
      4. 6.4.4 UserActivation インターフェース
      5. 6.4.5 ユーザーエージェントの自動化
    5. 6.5 要素のアクティベーション動作
      1. 6.5.1 ToggleEvent インターフェイス
      2. 6.5.2 CommandEvent インターフェース
    6. 6.6 フォーカス
      1. 6.6.1 序論
      2. 6.6.2 データモデル
      3. 6.6.3 tabindex 属性
      4. 6.6.4 処理モデル
      5. 6.6.5 順次フォーカスナビゲーション
      6. 6.6.6 フォーカス管理API
      7. 6.6.7 autofocus 属性
    7. 6.7 キーボードショートカットの割り当て
      1. 6.7.1 はじめに
      2. 6.7.2 accesskey 属性
      3. 6.7.3 処理モデル
    8. 6.8 編集
      1. 6.8.1 ドキュメント領域の編集可能化: contenteditable コンテンツ属性
      2. 6.8.2 ドキュメント全体を編集可能にする: designMode getterおよびsetter
      3. 6.8.3 インページエディタのベストプラクティス
      4. 6.8.4 編集API
      5. 6.8.5 スペルと文法のチェック
      6. 6.8.6 書き込み提案
      7. 6.8.7 自動大文字化
      8. 6.8.8 自動修正
      9. 6.8.9 入力モダリティ: inputmode 属性
      10. 6.8.10 入力モダリティ: enterkeyhint 属性
    9. 6.9 ページ内検索
      1. 6.9.1 はじめに
      2. 6.9.2 details と hidden=until-found との相互作用
      3. 6.9.3 選択との相互作用
    10. 6.10 閉じるリクエストと閉じるウォッチャー
      1. 6.10.1 閉じるリクエスト
      2. 6.10.2 閉じる監視器のインフラ
      3. 6.10.3 CloseWatcher インターフェイス
    11. 6.11 ドラッグアンドドロップ
      1. 6.11.1 はじめに
      2. 6.11.2 ドラッグデータストア
      3. 6.11.3 DataTransfer インターフェース
        1. 6.11.3.1 DataTransferItemList インターフェース
        2. 6.11.3.2 DataTransferItem インターフェース
      4. 6.11.4 DragEvent インターフェース
      5. 6.11.5 処理モデル
      6. 6.11.6 イベントの概要
      7. 6.11.7 draggable 属性
      8. 6.11.8 ドラッグアンドドロップモデルにおけるセキュリティリスク
    12. 6.12 popover 属性
      1. 6.12.1 ポップオーバーターゲット属性
      2. 6.12.2 ポップオーバーライトディスミス
  7. 7 ウェブページの読み込み
    1. 7.1 サポートする概念
      1. 7.1.1 オリジン
        1. 7.1.1.1 サイト
        2. 7.1.1.2 同一オリジン制約の緩和
      2. 7.1.2 オリジンキー付きエージェントクラスタ
      3. 7.1.3 クロスオリジンオープナーポリシー
        1. 7.1.3.1 ヘッダー
        2. 7.1.3.2 クロスオリジンオープナーポリシーによるブラウジングコンテキストグループの切り替え
        3. 7.1.3.3 レポート
      4. 7.1.4 クロスオリジン埋め込みポリシー
        1. 7.1.4.1 ヘッダー
        2. 7.1.4.2 埋め込みポリシーのチェック
      5. 7.1.5 サンドボックス
      6. 7.1.6 ポリシーコンテナ
    2. 7.2 ナビゲーションおよびセッション履歴に関連するAPI
      1. 7.2.1 セキュリティインフラストラクチャー: Window, WindowProxy, および Locationオブジェクト
        1. 7.2.1.1 IDLとの統合
        2. 7.2.1.2 共有内部スロット: [[CrossOriginPropertyDescriptorMap]]
        3. 7.2.1.3 共通の抽象操作
          1. 7.2.1.3.1 CrossOriginProperties (O)
          2. 7.2.1.3.2 CrossOriginPropertyFallback (P)
          3. 7.2.1.3.3 IsPlatformObjectSameOrigin (O)
          4. 7.2.1.3.4 CrossOriginGetOwnPropertyHelper (O, P)
          5. 7.2.1.3.5 CrossOriginGet (O, P, Receiver)
          6. 7.2.1.3.6 CrossOriginSet (O, P, V, Receiver)
          7. 7.2.1.3.7 CrossOriginOwnPropertyKeys (O)
      2. 7.2.2 The Window object
        1. 7.2.2.1 ウィンドウの開閉
        2. 7.2.2.2 Windowオブジェクトにおけるインデックスアクセス
        3. 7.2.2.3 Windowオブジェクトでの名前付きアクセス
        4. 7.2.2.4関連するウィンドウへのアクセス
        5. 7.2.2.5 歴史的なブラウザーインターフェース 要素のAPI
        6. 7.2.2.6 Windowオブジェクトのスクリプト設定
      3. 7.2.3 WindowProxyエキゾチックオブジェクト
        1. 7.2.3.1 [[GetPrototypeOf]] ()
        2. 7.2.3.2 [[SetPrototypeOf]] (V)
        3. 7.2.3.3 [[IsExtensible]] ()
        4. 7.2.3.4 [[PreventExtensions]] ()
        5. 7.2.3.5 [[GetOwnProperty]] (P)
        6. 7.2.3.6 [[DefineOwnProperty]] (P, Desc)
        7. 7.2.3.7 [[Get]] (P, Receiver)
        8. 7.2.3.8 [[Set]] (P, V, Receiver)
        9. 7.2.3.9 [[Delete]] (P)
        10. 7.2.3.10 [[OwnPropertyKeys]] ()
      4. 7.2.4 Locationインターフェース
        1. 7.2.4.1 [[GetPrototypeOf]] ()
        2. 7.2.4.2 [[SetPrototypeOf]] (V)
        3. 7.2.4.3 [[IsExtensible]] ()
        4. 7.2.4.4 [[PreventExtensions]] ()
        5. 7.2.4.5 [[GetOwnProperty]] (P)
        6. 7.2.4.6 [[DefineOwnProperty]] (P, Desc)
        7. 7.2.4.7 [[Get]] (P, Receiver)
        8. 7.2.4.8 [[Set]] (P, V, Receiver)
        9. 7.2.4.9 [[Delete]] (P)
        10. 7.2.4.10 [[OwnPropertyKeys]] ()
      5. 7.2.5 Historyインターフェース
      6. 7.2.6 ナビゲーションAPI
        1. 7.2.6.1 はじめに
        2. 7.2.6.2 Navigationインターフェース
        3. 7.2.6.3 コアインフラストラクチャ
        4. 7.2.6.4 エントリリストの初期化と更新
        5. 7.2.6.5 NavigationHistoryEntryインターフェース
        6. 7.2.6.6 履歴エントリリスト
        7. 7.2.6.7 ナビゲーションの開始
        8. 7.2.6.8 進行中のナビゲーショントラッキング
        9. 7.2.6.9 NavigationActivationインターフェース
        10. 7.2.6.10 navigateイベント
          1. 7.2.6.10.1 NavigateEventインターフェース
          2. 7.2.6.10.2 NavigationDestinationインターフェース
          3. 7.2.6.10.3 イベントの発火
          4. 7.2.6.10.4 スクロールとフォーカスの動作
      7. 7.2.7 イベントインターフェース
        1. 7.2.7.1 NavigationCurrentEntryChangeEventインターフェース
        2. 7.2.7.2 PopStateEventインターフェース
        3. 7.2.7.3 HashChangeEventインターフェース
        4. 7.2.7.4 PageSwapEventインターフェース
        5. 7.2.7.5 PageRevealEventインターフェース
        6. 7.2.7.6 PageTransitionEventインターフェース
        7. 7.2.7.7 BeforeUnloadEventインターフェース
      8. 7.2.8 NotRestoredReasonsインターフェース
    3. 7.3 ドキュメントのシーケンスのためのインフラストラクチャ
      1. 7.3.1 ナビゲーブル
        1. 7.3.1.1 トラバース可能なナビゲーブル
        2. 7.3.1.2 最上位のトラバース可能なナビゲーブル
        3. 7.3.1.3 子ナビゲーブル
        4. 7.3.1.4 Jake ダイアグラム
        5. 7.3.1.5 関連するナビゲーブルコレクション
        6. 7.3.1.6 ナビゲーブルの破棄
        7. 7.3.1.7 ナビゲーブルターゲット名
      2. 7.3.2 ブラウジングコンテキスト
        1. 7.3.2.1 ブラウジングコンテキストの作成
        2. 7.3.2.2 関連するブラウジングコンテキスト
        3. 7.3.2.3 ブラウジングコンテキストのグループ
      3. 7.3.3 完全にアクティブなドキュメント
    4. 7.4 ナビゲーションとセッション履歴
      1. 7.4.1 セッション履歴
        1. 7.4.1.1 セッション履歴エントリ
        2. 7.4.1.2 ドキュメント状態
        3. 7.4.1.3 セッション履歴の集中管理による変更
        4. 7.4.1.4 セッション履歴に対する低レベルの操作
      2. 7.4.2 ナビゲーション
        1. 7.4.2.1 サポート概念
        2. 7.4.2.2 ナビゲーションの開始
        3. 7.4.2.3 ナビゲーションの終了
          1. 7.4.2.3.1 通常のクロスドキュメントナビゲーションの場合
          2. 7.4.2.3.2 javascript: URLの特別なケース
          3. 7.4.2.3.3 フラグメントナビゲーション
          4. 7.4.2.3.4 非フェッチスキームと外部ソフトウェア
        4. 7.4.2.4 ナビゲーションの防止
        5. 7.4.2.5 ナビゲーションの中止
      3. 7.4.3 リロードとトラバース
      4. 7.4.4 非フラグメント同期「ナビゲーション」
      5. 7.4.5 セッション履歴エントリの設定
      6. 7.4.6 履歴ステップの適用
        1. 7.4.6.1 トラバーサブルの更新
        2. 7.4.6.2 ドキュメントの更新
        3. 7.4.6.3 ドキュメントの表示
        4. 7.4.6.4 フラグメントへのスクロール
        5. 7.4.6.5 永続化された履歴エントリの状態
    5. 7.5 ドキュメントライフサイクル
      1. 7.5.1 共有ドキュメント作成インフラストラクチャ
      2. 7.5.2 HTML文書の読み込み
      3. 7.5.3 XML文書の読み込み
      4. 7.5.4 テキスト文書の読み込み
      5. 7.5.5 multipart/x-mixed-replace文書の読み込み
      6. 7.5.6 メディア文書の読み込み
      7. 7.5.7 DOMを持たないインラインコンテンツ用の文書の読み込み
      8. 7.5.8 読み込みプロセスの完了
      9. 7.5.9 文書のアンロード
      10. 7.5.10 文書の破棄
      11. 7.5.11 ドキュメントの読み込みを中止する
    6. 7.6 X-Frame-Optionsヘッダー
    7. 7.7 Refreshヘッダー
    8. 7.8 ブラウザユーザー インターフェースの考慮事項
  8. 8 ウェブアプリケーションAPI
    1. 8.1 スクリプティング
      1. 8.1.1 はじめに
      2. 8.1.2 エージェントとエージェントクラスター
        1. 8.1.2.1 JavaScriptエージェント形式との統合
        2. 8.1.2.2 JavaScriptエージェントクラスター形式との統合
      3. 8.1.3 レルムとその対応物
        1. 8.1.3.1 環境
        2. 8.1.3.2 環境設定オブジェクト
        3. 8.1.3.3 レルム、設定オブジェクト、およびグローバルオブジェクト
          1. 8.1.3.3.1 エントリ
          2. 8.1.3.3.2 インカンバント
          3. 8.1.3.3.3 現在
          4. 8.1.3.3.4 関連
        4. 8.1.3.4 スクリプトの有効化と無効化
        5. 8.1.3.5 セキュアなコンテキスト
      4. 8.1.4 スクリプト処理モデル
        1. 8.1.4.1 スクリプト
        2. 8.1.4.2 スクリプトのフェッチ
        3. 8.1.4.3 スクリプトの作成
        4. 8.1.4.4 スクリプトの呼び出し
        5. 8.1.4.5 スクリプトの終了
        6. 8.1.4.6 実行時スクリプトエラー
        7. 8.1.4.7 未処理のPromiseの拒否
        8. 8.1.4.8 インポートマップ解析結果
      5. 8.1.5 モジュール指定子の解決
        1. 8.1.5.1 解決アルゴリズム
        2. 8.1.5.2 インポートマップ
        3. 8.1.5.3 インポートマップ処理モデル
      6. 8.1.6 JavaScript仕様のホストフック
        1. 8.1.6.1 HostEnsureCanAddPrivateElement(O)
        2. 8.1.6.2 HostEnsureCanCompileStrings(realm, parameterStrings, bodyString, codeString, compilationType, parameterArgs, bodyArg)
        3. 8.1.6.3 HostGetCodeForEval(argument)
        4. 8.1.6.4 HostPromiseRejectionTracker(promise, operation)
        5. 8.1.6.5 HostSystemUTCEpochNanoseconds(global)
        6. 8.1.6.6 ジョブ関連のホストフック
          1. 8.1.6.6.1 HostCallJobCallback(callback, V, argumentsList)
          2. 8.1.6.6.2 HostEnqueueFinalizationRegistryCleanupJob(finalizationRegistry)
          3. 8.1.6.6.3 HostEnqueueGenericJob(job, realm)
          4. 8.1.6.6.4 HostEnqueuePromiseJob(job, realm)
          5. 8.1.6.6.5 HostEnqueueTimeoutJob(job, realm, milliseconds)
          6. 8.1.6.6.6 HostMakeJobCallback(callable)
        7. 8.1.6.7 モジュールに関連ホストフック
          1. 8.1.6.7.1 HostGetImportMetaProperties(moduleRecord)
          2. 8.1.6.7.2 HostGetSupportedImportAttributes()
          3. 8.1.6.7.3 HostLoadImportedModule(referrer, moduleRequest, loadState, payload)
      7. 8.1.7 イベントループ
        1. 8.1.7.1 定義
        2. 8.1.7.2 タスクのキューイング
        3. 8.1.7.3 処理モデル
        4. 8.1.7.4 汎用タスクソース
        5. 8.1.7.5 他の仕様からイベントループを扱う方法
      8. 8.1.8 イベント
        1. 8.1.8.1 イベントハンドラー
        2. 8.1.8.2 要素、Documentオブジェクト、およびWindowオブジェクトのイベントハンドラー
          1. 8.1.8.2.1 IDL定義
        3. 8.1.8.3 イベントの発火
    2. 8.2 WindowOrWorkerGlobalScope ミキシン
    3. 8.3 Base64ユーティリティメソッド
    4. 8.4 動的マークアップ挿入
      1. 8.4.1 入力ストリームのオープン
      2. 8.4.2 入力ストリームのクローズ
      3. 8.4.3 document.write()
      4. 8.4.4 document.writeln()
    5. 8.5 DOM解析およびシリアライゼーション API
      1. 8.5.1 DOMParser インターフェイス
      2. 8.5.2 危険なHTML解析メソッド
      3. 8.5.3 HTMLシリアル化メソッド
      4. 8.5.4 innerHTMLプロパティ
      5. 8.5.5 outerHTMLプロパティ
      6. 8.5.6 insertAdjacentHTML()メソッド
      7. 8.5.7 createContextualFragment()メソッド
      8. 8.5.8 XMLSerializer インターフェース
    6. 8.6 タイマー
    7. 8.7 マイクロタスクのキュー
    8. 8.8 ユーザープロンプト
      1. 8.8.1 シンプルダイアログ
      2. 8.8.2 印刷
    9. 8.9 システムの状態と機能
      1. 8.9.1 Navigatorオブジェクト
        1. 8.9.1.1 クライアントの識別
        2. 8.9.1.2 言語設定
        3. 8.9.1.3 ブラウザの状態
        4. 8.9.1.4 カスタムスキームハンドラー: registerProtocolHandler()メソッド
          1. 8.9.1.4.1 安全性とプライバシー
          2. 8.9.1.4.2 ユーザーエージェントの自動化
        5. 8.9.1.5 クッキー
        6. 8.9.1.6 PDF 閲覧サポート
    10. 8.10 画像
      1. 8.10.1 ImageData インターフェイス
      2. 8.10.2 ImageBitmap インターフェイス
    11. 8.11 アニメーションフレーム
  9. 9 通信
    1. 9.1 MessageEventインターフェース
    2. 9.2 サーバー送信イベント
      1. 9.2.1 概要
      2. 9.2.2 EventSourceインターフェース
      3. 9.2.3 処理モデル
      4. 9.2.4 `Last-Event-ID`ヘッダー
      5. 9.2.5 イベントストリームの解析
      6. 9.2.6 イベントストリームの解釈
      7. 9.2.7 作成時の注意点
      8. 9.2.8 コネクションレスプッシュとその他の機能
      9. 9.2.9 ガベージコレクション
      10. 9.2.10 実装のアドバイス
    3. 9.3 クロスドキュメントメッセージング
      1. 9.3.1 序章
      2. 9.3.2 セキュリティ
        1. 9.3.2.1 作成者
        2. 9.3.2.2 ユーザーエージェント
      3. 9.3.3 メッセージの送信
    4. 9.4 チャンネルメッセージング
      1. 9.4.1 イントロダクション
        1. 9.4.1.1 例
        2. 9.4.1.2 Webにおけるオブジェクト能力モデルの基盤としてのポート
        3. 9.4.1.3 サービス実装の抽象化の基盤としてのポート
      2. 9.4.2 メッセージチャネル
      3. 9.4.3 MessageEventTarget ミックスイン
      4. 9.4.4 メッセージポート
      5. 9.4.5 ポートとガベージコレクション
    5. 9.5 他の閲覧コンテキストへのブロードキャスト
  10. 10Web workers
    1. 10.1 はじめに
      1. 10.1.1 範囲
      2. 10.1.2 例
        1. 10.1.2.1 バックグラウンドでの数値計算ワーカー
        2. 10.1.2.2 JavaScript モジュールを使用したワーカーの使用
        3. 10.1.2.3 共有ワーカーの紹介
        4. 10.1.2.4 共有ワーカーを使用した共有状態
        5. 10.1.2.5 デリゲーション
        6. 10.1.2.6 ライブラリの提供
      3. 10.1.3 チュートリアル
        1. 10.1.3.1 専用ワーカーの作成
        2. 10.1.3.2 専用ワーカーとの通信
        3. 10.1.3.3 共有ワーカー
    2. 10.2 インフラストラクチャ
      1. 10.2.1 グローバルスコープ
        1. 10.2.1.1 WorkerGlobalScope共通インターフェース
        2. 10.2.1.2 専用ワーカーとDedicatedWorkerGlobalScopeインターフェース
        3. 10.2.1.3 共有ワーカーとSharedWorkerGlobalScopeインターフェース
      2. 10.2.2 イベントループ
      3. 10.2.3 ワーカーのライフタイム
      4. 10.2.4 処理モデル
      5. 10.2.5 実行時スクリプトエラー
      6. 10.2.6 ワーカーの作成
        1. 10.2.6.1 AbstractWorkerミックスイン
        2. 10.2.6.2 ワーカーのスクリプト設定
        3. 10.2.6.3 専用ワーカーとWorkerインターフェース
        4. 10.2.6.4 共有ワーカーとSharedWorkerインターフェース
      7. 10.2.7 同時ハードウェア機能
    3. 10.3 ワーカーで使用可能なAPI
      1. 10.3.1 スクリプトとライブラリのインポート
      2. 10.3.2 WorkerNavigatorインターフェース
      3. 10.3.3 WorkerLocationインターフェース
  11. 11 ワークレット
    1. 11.1 導入
      1. 11.1.1 動機
      2. 11.1.2 コードの冪等性
      3. 11.1.3 推測的評価
    2. 11.2 例
      1. 11.2.1 スクリプトの読み込み
      2. 11.2.2 クラスの登録とメソッドの呼び出し
    3. 11.3 基盤
      1. 11.3.1 グローバルスコープ
        1. 11.3.1.1 エージェントとイベントループ
        2. 11.3.1.2 作成と終了
        3. 11.3.1.3 ワークレットのスクリプト設定
      2. 11.3.2 Workletクラス
      3. 11.3.3 ワークレットのライフタイム
  12. 12 Web ストレージ
    1. 12.1 はじめに
    2. 12.2 API
      1. 12.2.1 Storageインターフェース
      2. 12.2.2 sessionStorageゲッター
      3. 12.2.3 localStorageゲッター
      4. 12.2.4 StorageEventインターフェース
    3. 12.3 プライバシー
      1. 12.3.1 ユーザートラッキング
      2. 12.3.2 データの機密性
    4. 12.4 セキュリティ
      1. 12.4.1 DNS スプーフィング攻撃
      2. 12.4.2 クロスディレクトリアタック
      3. 12.4.3 実装のリスク
  13. 13 HTML 構文
    1. 13.1 HTML ドキュメントの作成
      1. 13.1.1 DOCTYPE
      2. 13.1.2 要素
        1. 13.1.2.1 開始タグ
        2. 13.1.2.2 終了タグ
        3. 13.1.2.3 属性
        4. 13.1.2.4 省略可能なタグ
        5. 13.1.2.5 内容モデルの制限
        6. 13.1.2.6 生のテキスト要素およびエスケープ可能な生のテキスト要素の内容に対する制約
      3. 13.1.3 テキスト
        1. 13.1.3.1 改行
      4. 13.1.4 文字参照
      5. 13.1.5 CDATA セクション
      6. 13.1.6 コメント
    2. 13.2 HTML文書の解析
      1. 13.2.1 解析モデルの概要
      2. 13.2.2 解析エラー
      3. 13.2.3 入力バイトストリーム
        1. 13.2.3.1 既知の文字エンコーディングでのパース
        2. 13.2.3.2 文字エンコーディングの決定
        3. 13.2.3.3 文字エンコーディング
        4. 13.2.3.4 解析中のエンコーディングの変更
        5. 13.2.3.5 入力ストリームの前処理
      4. 13.2.4 パース状態
        1. 13.2.4.1 挿入モード
        2. 13.2.4.2 開いている要素のスタック
        3. 13.2.4.3 アクティブなフォーマット要素のリスト
        4. 13.2.4.4 要素ポインタ
        5. 13.2.4.5 その他の解析状態フラグ
      5. 13.2.5 トークン化
        1. 13.2.5.1 データ状態
        2. 13.2.5.2 RCDATA 状態
        3. 13.2.5.3 RAWTEXT 状態
        4. 13.2.5.4 スクリプトデータ状態
        5. 13.2.5.5 PLAINTEXT状態
        6. 13.2.5.6 タグ開始状態
        7. 13.2.5.7 終了タグ開始状態
        8. 13.2.5.8 タグ名状態
        9. 13.2.5.9 RCDATA小なり記号状態
        10. 13.2.5.10 RCDATA終了タグ開始状態
        11. 13.2.5.11 RCDATA終了タグ名状態
        12. 13.2.5.12 RAWTEXT小なり記号状態
        13. 13.2.5.13 RAWTEXT終了タグ開始状態
        14. 13.2.5.14 RAWTEXT終了タグ名状態
        15. 13.2.5.15 スクリプトデータ小なり記号状態
        16. 13.2.5.16 スクリプトデータ終了タグ開始状態
        17. 13.2.5.17 スクリプトデータ終了タグ名状態
        18. 13.2.5.18 スクリプトデータエスケープ開始状態
        19. 13.2.5.19 スクリプトデータエスケープ開始ダッシュ状態
        20. 13.2.5.20 スクリプトデータエスケープ状態
        21. 13.2.5.21 スクリプトデータエスケープダッシュ状態
        22. 13.2.5.22 スクリプトデータエスケープダッシュダッシュ状態
        23. 13.2.5.23 スクリプトデータエスケープ小なり記号状態
        24. 13.2.5.24 スクリプトデータエスケープ終了タグ開始状態
        25. 13.2.5.25 スクリプトデータエスケープ終了タグ名状態
        26. 13.2.5.26 スクリプトデータダブルエスケープ開始状態
        27. 13.2.5.27 スクリプトデータダブルエスケープ状態
        28. 13.2.5.28 スクリプトデータダブルエスケープダッシュ状態
        29. 13.2.5.29 スクリプトデータダブルエスケープダッシュダッシュ状態
        30. 13.2.5.30 スクリプトデータダブルエスケープ小なり記号状態
        31. 13.2.5.31 スクリプトデータダブルエスケープ終了状態
        32. 13.2.5.32 属性名の前状態
        33. 13.2.5.33 属性名状態
        34. 13.2.5.34 属性名の後状態
        35. 13.2.5.35 属性値の前状態
        36. 13.2.5.36 属性値 (二重引用符付き) 状態
        37. 13.2.5.37 属性値 (シングルクォート付き) 状態
        38. 13.2.5.38 属性値 (引用符なし) 状態
        39. 13.2.5.39 属性値 (引用符付き) の後の状態
        40. 13.2.5.40 自己終了タグ開始状態
        41. 13.2.5.41 偽のコメント状態
        42. 13.2.5.42 マークアップ宣言開始状態
        43. 13.2.5.43 コメント開始状態
        44. 13.2.5.44 コメント開始ダッシュ状態
        45. 13.2.5.45 コメント状態
        46. 13.2.5.46 コメント小なり記号状態
        47. 13.2.5.47 コメント小なり記号感嘆符状態
        48. 13.2.5.48 コメント小なり記号感嘆符ダッシュ状態
        49. 13.2.5.49 コメント小なり記号感嘆符ダッシュダッシュ状態
        50. 13.2.5.50 コメント終了ダッシュ状態
        51. 13.2.5.51 コメント終了状態
        52. 13.2.5.52 コメント終了感嘆符状態
        53. 13.2.5.53 DOCTYPE 状態
        54. 13.2.5.54 DOCTYPE名の前状態
        55. 13.2.5.55 DOCTYPE名の状態
        56. 13.2.5.56 DOCTYPE名の後状態
        57. 13.2.5.57 DOCTYPEパブリックキーワード後状態
        58. 13.2.5.58 DOCTYPEパブリック識別子の前状態
        59. 13.2.5.59 DOCTYPEパブリック識別子（二重引用符付き）状態
        60. 13.2.5.60 DOCTYPEパブリック識別子（単一引用符付き）状態
        61. 13.2.5.61 DOCTYPEパブリック識別子後状態
        62. 13.2.5.62 DOCTYPEパブリック識別子とシステム識別子の間の状態
        63. 13.2.5.63 DOCTYPEシステムキーワード後状態
        64. 13.2.5.64 DOCTYPEシステム識別子前状態
        65. 13.2.5.65 DOCTYPEシステム識別子（二重引用符付き）状態
        66. 13.2.5.66 DOCTYPEシステム識別子（単一引用符付き）状態
        67. 13.2.5.67 DOCTYPEシステム識別子後状態
        68. 13.2.5.68 偽のDOCTYPE状態
        69. 13.2.5.69 CDATAセクション状態
        70. 13.2.5.70 CDATAセクション括弧状態
        71. 13.2.5.71 CDATAセクション終了状態
        72. 13.2.5.72 文字参照状態
        73. 13.2.5.73 名前付き文字参照状態
        74. 13.2.5.74 曖昧なアンパサンド状態
        75. 13.2.5.75 数値文字参照状態
        76. 13.2.5.76 16進数文字参照開始状態
        77. 13.2.5.77 10進数文字参照開始状態
        78. 13.2.5.78 16進数文字参照状態
        79. 13.2.5.79 10進数文字参照状態
        80. 13.2.5.80 数値文字参照終了状態
      6. 13.2.6 ツリー構築
        1. 13.2.6.1 ノードの作成と挿入
        2. 13.2.6.2 テキストのみを含む要素の解析
        3. 13.2.6.3暗黙の終了タグを持つ要素を閉じる
        4. 13.2.6.4 HTMLコンテンツのトークン解析ルール
          1. 13.2.6.4.1 「初期」挿入モード
          2. 13.2.6.4.2 「htmlの前」挿入モード
          3. 13.2.6.4.3 「headの前」挿入モード
          4. 13.2.6.4.4 「head内」挿入モード
          5. 13.2.6.4.5 「in head noscript」 挿入モード
          6. 13.2.6.4.6 「ヘッド後」挿入モード
          7. 13.2.6.4.7 「本文内」挿入モード
          8. 13.2.6.4.8 「テキスト」挿入モード
          9. 13.2.6.4.9 「テーブル内」挿入モード
          10. 13.2.6.4.10 「テーブルテキスト内」挿入モード
          11. 13.2.6.4.11 「キャプション内」挿入モード
          12. 13.2.6.4.12 「カラムグループ内」挿入モード
          13. 13.2.6.4.13 「テーブル本文内」挿入モード
          14. 13.2.6.4.14 「行内」挿入モード
          15. 13.2.6.4.15 「セル内」挿入モード
          16. 13.2.6.4.16 「select内」挿入モード
          17. 13.2.6.4.17 「テーブル内のselect内」 挿入モード
          18. 13.2.6.4.18 「テンプレート内」挿入モード
          19. 13.2.6.4.19 「ボディ終了後」挿入モード
          20. 13.2.6.4.20 「フレームセット内」挿入モード
          21. 13.2.6.4.21 「フレームセット後」挿入モード
          22. 13.2.6.4.22 「本文後」挿入モード
          23. 13.2.6.4.23 「フレームセット後」挿入モード
        5. 13.2.6.5 外部コンテンツでトークンを解析するためのルールin foreign content
      7. 13.2.7 終了
      8. 13.2.8 推測的HTML解析
      9. 13.2.9 HTML DOMのインフォセットへの強制
      10. 13.2.10 パーサーにおけるエラーハンドリングと奇妙なケースの紹介
        1. 13.2.10.1 入れ子が間違ったタグ: <b><i></b></i>
        2. 13.2.10.2 入れ子が正しくないタグ: <b><p></b></p>
        3. 13.2.10.3 テーブル内の予期しないマークアップ
        4. 13.2.10.4 パース中にページを変更するスクリプト
        5. 13.2.10.5 複数のドキュメント間を移動するスクリプトの実行
        6. 13.2.10.6 未閉じのフォーマット要素
    3. 13.3 HTMLフラグメントのシリアライズ
    4. 13.4 HTMLフラグメントの解析
    5. 13.5 名前付き文字参照
  14. 14 XML構文
    1. 14.1 XML構文でドキュメントを書く
    2. 14.2 XML文書の解析
    3. 14.3 XMLフラグメントのシリアル化
    4. 14.4 XMLフラグメントの解析
  15. 15 レンダリング
    1. 15.1 序論
    2. 15.2 CSSユーザーエージェントのスタイルシートとプレゼンテーショナルヒント
    3. 15.3 置換されない要素
      1. 15.3.1 隠し要素
      2. 15.3.2 ページ
      3. 15.3.3 フローコンテンツ
      4. 15.3.4 フレージングコンテンツ
      5. 15.3.5 双方向テキスト
      6. 15.3.6 セクションと見出し
      7. 15.3.7 リスト
      8. 15.3.8 テーブル
      9. 15.3.9 マージンの折り畳みの癖
      10. 15.3.10 フォームコントロール
      11. 15.3.11 hr 要素
      12. 15.3.12 fieldset と legend 要素
    4. 15.4 置換要素
      1. 15.4.1 埋め込みコンテンツ
      2. 15.4.2 画像
      3. 15.4.3 埋め込みコンテンツおよび画像の属性
      4. 15.4.4画像マップ
    5. 15.5 ウィジェット
      1. 15.5.1 ネイティブアピアランス
      2. 15.5.2 書字モード
      3. 15.5.3 ボタンレイアウト
      4. 15.5.4 button 要素
      5. 15.5.5 details および summary 要素
      6. 15.5.6 input 要素をテキスト入力ウィジェットとして使用
      7. 15.5.7 input 要素のドメイン固有ウィジェットとしての使用
      8. 15.5.8 input 要素のレンジコントロールとしての使用
      9. 15.5.9 input 要素のカラーウェルとしての使用
      10. 15.5.10 input 要素のチェックボックスおよびラジオボタンウィジェットとしての使用
      11. 15.5.11 input 要素のファイルアップロードコントロールとしての使用
      12. 15.5.12 input 要素のボタンとしての使用
      13. 15.5.13 marquee 要素
      14. 15.5.14 meter 要素
      15. 15.5.15 progress 要素
      16. 15.5.16 select 要素
      17. 15.5.17 textarea 要素
    6. 15.6 フレームとフレームセット
    7. 15.7 インタラクティブメディア
      1. 15.7.1 リンク、フォーム、ナビゲーション
      2. 15.7.2 title 属性
      3. 15.7.3 編集ホスト
      4. 15.7.4 ネイティブユーザーインターフェイスでレンダリングされたテキスト
    8. 15.8 印刷メディア
    9. 15.9 スタイルなしXMLドキュメント
  16. 16 廃止された機能
    1. 16.1 廃止されたが適合する機能
      1. 16.1.1 廃止されたが適合する機能に対する警告
    2. 16.2 非適合機能
    3. 16.3 実装の要件
      1. 16.3.1 marquee 要素
      2. 16.3.2 フレーム
      3. 16.3.3 その他の要素、属性、API
  17. 17 IANAの考慮事項
    1. 17.1 text/html
    2. 17.2 multipart/x-mixed-replace
    3. 17.3 application/xhtml+xml
    4. 17.4 text/ping
    5. 17.5 application/microdata+json
    6. 17.6 text/event-stream
    7. 17.7 web+ スキームプレフィックス
  18. インデックス
    1. 要素
    2. 要素のコンテンツカテゴリ
    3. 属性
    4. 要素インターフェース
    5. すべてのインターフェース
    6. イベント
    7. HTTP ヘッダー
    8. MIME タイプ
  19. 参考文献
  20. 謝辞
  21. 知的財産権

1 はじめに

1.1 この仕様の位置付け

この仕様は、ウェブプラットフォームの大部分を非常に詳細に定義しています。他の仕様と比較した場合のこの仕様の位置付けは、以下のようにまとめることができます：

CSS SVG MathML Service Workers IDB Fetch CSP AV1 Opus PNG この仕様 HTTP TLS DOM Unicode Web IDL MIME URL XML JavaScript Encoding

1.2 これはHTML5ですか?

このセクションは規範的ではありません。

簡単に言えば: はい。

もう少し詳しく言うと、「HTML5」という用語は、現代のウェブ技術を指す流行語として広く使われています。その多く（すべてではありませんが）はWHATWGで開発されています。このドキュメントもその一つです。他のドキュメントはWHATWG標準概要から入手できます。

1.3 背景

このセクションは規範的ではありません。

HTMLはワールドワイドウェブのコアマークアップ言語です。元々、HTMLは科学文書を意味的に記述するための言語として主に設計されました。しかし、その一般的な設計により、後年には他の種類の文書やアプリケーションを記述するために適応されてきました。

1.4 対象読者

このセクションは規範的ではありません。

この仕様は、この仕様で定義された機能を使用する文書やスクリプトの作成者、ページ上でこの仕様で定義された機能を操作するツールの実装者、およびこの仕様の要件に対して文書や実装の正確性を確認しようとする人々を対象としています。

このドキュメントは、ウェブ技術に対して少なくとも最低限の知識を持っていない読者には、適していない可能性があります。なぜなら、ところどころで正確さのために明確さを犠牲にし、完全さのために簡潔さを犠牲にしているからです。より分かりやすいチュートリアルや作成ガイドが、このトピックへのより優しい導入を提供してくれます。

特に、DOMの基本的な理解が、この仕様の技術的な部分を完全に理解するために必要です。また、Web IDL、HTTP、XML、Unicode、文字エンコーディング、JavaScript、およびCSSの理解も役立ちますが、必須ではありません。

1.5 範囲

このセクションは規範的ではありません。

この仕様は、静的な文書から動的なアプリケーションまで、ウェブ上でアクセシブルなページを作成するためのセマンティックレベルのマークアップ言語と、それに関連するセマンティックレベルのスクリプトAPIを提供することに限定されています。

この仕様の範囲には、メディア固有のプレゼンテーションのカスタマイズを提供するためのメカニズムは含まれていません（ただし、ウェブブラウザーのデフォルトのレンダリングルールはこの仕様の末尾に含まれており、言語の一部としてCSSにフックするためのいくつかのメカニズムが提供されています）。

この仕様の範囲は、オペレーティングシステム全体を記述することではありません。特に、ハードウェア構成ソフトウェア、画像操作ツール、およびユーザーが高性能ワークステーションで日常的に使用すると予想されるアプリケーションは範囲外です。アプリケーションに関しては、この仕様は特に、ユーザーがたまに使用する、または異なる場所から定期的に使用することが予想される、低いCPU要件のアプリケーションを対象としています。このようなアプリケーションの例としては、オンライン購入システム、検索システム、ゲーム（特にマルチプレイヤーオンラインゲーム）、公共の電話帳や住所録、通信ソフトウェア（メールクライアント、インスタントメッセージクライアント、ディスカッションソフトウェア）、文書編集ソフトウェアなどがあります。

1.6 歴史

このセクションは規範的ではありません。

HTMLは、最初の5年間（1990-1995年）に数回の改訂を経て、多くの拡張を経験し、主に最初はCERN、次にIETFでホストされました。

W3Cの設立に伴い、HTMLの開発は再び場所を変更しました。1995年にHTML 3.0として知られるHTMLの拡張に関する最初の失敗した試みは、1997年に完成したHTML 3.2として知られるより実用的なアプローチに道を譲りました。その同じ年にHTML4が迅速に続きました。

翌年、W3CのメンバーはHTMLの進化を停止し、代わりにXMLベースの同等物であるXHTMLの開発を開始することを決定しました。この努力は、2000年に完成した、HTML4のXMLでの再定式化であるXHTML 1.0として知られるものから始まりました。新しいシリアル化を追加した以外に新機能はなく、その後、W3Cの焦点はXHTMLを拡張しやすくすることに向けられました。XHTML Modularizationの旗印の下で、この取り組みは行われました。これと並行して、W3Cは以前のHTMLおよびXHTML言語と互換性のない新しい言語にも取り組み、それをXHTML2と呼びました。

1998年にHTMLの進化が停止されたころ、ブラウザーベンダーによって開発されたHTMLのAPIの一部が指定され、DOM Level 1（1998年）およびDOM Level 2 CoreとDOM Level 2 HTML（2000年に開始され、2003年に最高潮に達しました）という名前で公開されました。これらの努力はその後縮小し、2004年にDOM Level 3の一部の仕様が公開されましたが、すべてのLevel 3ドラフトが完成する前に作業グループは閉鎖されました。

2003年には、ウェブフォームの次世代として位置付けられたXFormsの公開が、HTML自体の進化に対する新たな関心を呼び起こしました。これは、既存の技術（例えばHTML）を置き換えるのではなく、まったく新しい技術（RSSや後のAtomなど）に限定されているという認識から生まれました。

HTML4のフォームを拡張して、XForms 1.0が導入した多くの機能を、既存のHTMLウェブページと互換性のないレンダリングエンジンをブラウザーが実装する必要なしに提供できることを示す概念実証が、この新たな関心の最初の成果でした。この初期段階では、草案はすでに公開されており、すべてのソースからの意見が求められていましたが、仕様はオペラソフトウェアの著作権の下にのみありました。

HTMLの進化を再開すべきという考えは、2004年のW3Cワークショップで試され、HTML5の作業の基礎を成すいくつかの原則（以下に記述）および前述のフォーム関連機能に関する初期の草案提案が、MozillaとOperaによってW3Cに共同で提示されました。提案は、ウェブの進化のために以前に選ばれた方向と矛盾するという理由で拒否されました。W3Cのスタッフとメンバーは、代わりにXMLベースの代替品を開発し続けることに投票しました。

その直後、Apple、Mozilla、Operaは、WHATWGという新しい場の下でこの取り組みを続ける意向を共同で発表しました。公開のメーリングリストが作成され、草案はWHATWGのサイトに移されました。著作権はその後、3社の共同所有に改訂され、仕様の再利用が可能になりました。

WHATWGは、特に技術が後方互換性を持つ必要があること、仕様と実装が一致する必要があること（たとえそれが実装ではなく仕様を変更することを意味する場合でも）、および仕様が非常に詳細である必要があることといういくつかの基本原則に基づいていました。これにより、実装が互いにリバースエンジニアリングすることなく完全な相互運用性を実現できるようにする必要がありました。

特に後者の要件により、HTML5仕様の範囲には、以前は3つの別々の文書で指定されていたHTML4、XHTML1、およびDOM2 HTMLが含まれる必要がありました。また、これまでに考えられていたよりもはるかに多くの詳細を含める必要がありました。

2006年にW3Cは最終的にHTML5の開発に参加する意向を示し、2007年には、WHATWGと協力してHTML5仕様の開発に取り組む作業グループが設立されました。Apple、Mozilla、Operaは、仕様をW3Cの著作権の下で公開することを許可し、同時にWHATWGサイトにより制約の少ないライセンスを持つバージョンを保持しました。

数年間、両グループは協力して作業を続けました。しかし、2011年には、両グループは異なる目標を持っているとの結論に達しました。W3Cは「完成」バージョンの「HTML5」を公開したいと考え、WHATWGはプラットフォームの進化に合わせて必要に応じて新機能を追加し、既知の問題を抱えた状態で仕様を固定するのではなく、仕様を継続的に維持するリビングスタンダードとしてHTMLの作業を続けたいと考えました。

2019年、WHATWGとW3Cは、今後HTMLの単一バージョンを共同で開発することに合意しました。これがこの文書です。

1.7 設計メモ

このセクションは規範的ではありません。

HTMLの多くの側面は、一見すると無意味で一貫性がないように見えることを認めざるを得ません。

HTML、そのサポートとなるDOM API、およびその多くのサポート技術は、数十年にわたって、異なる優先事項を持つさまざまな人々によって開発されてきましたが、多くの場合、彼らはお互いの存在を知らなかったのです。

そのため、機能は多くのソースから生まれ、一貫して設計されていないことがしばしばあります。さらに、ウェブのユニークな特性により、実装のバグが事実上、そして今では法的に標準となっていることがよくあります。なぜなら、コンテンツが意図せずにそれらに依存して書かれることが多く、修正が行われる前にそうなってしまうからです。

それにもかかわらず、特定の設計目標に従うための努力がなされてきました。これらは次のいくつかのサブセクションで説明されています。

1.7.1 スクリプト実行のシリアライズ可能性

このセクションは規範的ではありません。

ウェブ作成者がマルチスレッドの複雑さにさらされないようにするために、HTMLおよびDOM APIは、スクリプトが他のスクリプトの同時実行を検出できないように設計されています。ワーカーを使用しても、すべてのグローバルでのすべてのスクリプトの実行を完全にシリアライズするかのように実装の動作を考えることが意図されています。

この一般的な設計原則の例外は、JavaScriptのSharedArrayBuffer クラスです。SharedArrayBuffer オブジェクトを使用すると、他のエージェントでスクリプトが同時に実行されていることが実際に観察できます。さらに、JavaScriptのメモリモデルのため、シリアライズされたスクリプト実行によってだけでなく、シリアライズされたステートメント実行によっても表現できない状況があります。

1.7.2 拡張性

このセクションは規範的ではありません。

HTMLには、安全にセマンティクスを追加するために使用できるさまざまな拡張メカニズムがあります：

1.8 HTMLとXMLの構文の違い

このセクションは規範的ではありません。

この仕様は、文書やアプリケーションを記述するための抽象言語と、この言語を使用するリソースのメモリ内表現と対話するためのいくつかのAPIを定義しています。

メモリ内表現は「DOM HTML」、または略して「DOM」として知られています。

この抽象言語を使用するリソースを送信するために使用できるさまざまな具体的な構文があり、そのうちの2つはこの仕様で定義されています。

最初の具体的な構文はHTML構文です。これはほとんどの作成者に推奨される形式です。ほとんどのレガシーウェブブラウザと互換性があります。ドキュメントがtext/html MIMEタイプで送信される場合、それはウェブブラウザによってHTMLドキュメントとして処理されます。この仕様は単に「HTML」として知られる最新のHTML構文を定義しています。

2番目の具体的な構文はXMLです。ドキュメントがapplication/xhtml+xmlのようなXML MIMEタイプで送信される場合、それはウェブブラウザによってXMLドキュメントとして扱われ、XMLプロセッサによって解析されます。作成者は、XMLとHTMLの処理が異なることを念頭に置いてください。特に、些細な構文エラーでも、XMLとしてラベル付けされたドキュメントが完全にレンダリングされるのを防ぐ可能性がありますが、HTML構文では無視されます。

HTMLのXML構文はかつて「XHTML」と呼ばれていましたが、この仕様ではその用語を使用していません（他の理由として、MathMLやSVGのHTML構文にはそのような用語が使用されていないためです）。

DOM、HTML構文、およびXML構文は、すべて同じコンテンツを表現することはできません。例えば、名前空間はHTML構文では表現できませんが、DOMやXML構文ではサポートされています。同様に、noscript機能を使用するドキュメントは、HTML構文で表現できますが、DOMやXML構文では表現できません。文字列「-->」を含むコメントは、HTMLおよびXML構文ではなく、DOMでのみ表現できます。

1.9 この仕様の構成

このセクションは規範的ではありません。

この仕様は以下の主要なセクションに分かれています：

イントロダクション
HTML標準のコンテキストを提供する非規範的な資料。
共通インフラストラクチャ
適合クラス、アルゴリズム、定義、および仕様の他の部分の共通基盤。
HTML文書のセマンティクス、構造、およびAPI
文書は要素から構築されます。これらの要素はDOMを使用してツリーを形成します。このセクションでは、このDOMの機能を定義するとともに、すべての要素に共通する機能や、要素を定義する際に使用される概念を紹介します。
HTMLの要素
各要素には定義された意味があり、このセクションで説明されています。要素の使用方法に関する著者向けのルールと、各要素を処理するためのユーザーエージェントの要件も示されています。これには、ビデオ再生や字幕、フォームコントロールとフォーム送信、HTMLキャンバスと呼ばれる2DグラフィックスAPIなど、HTMLの大きな特徴が含まれます。
マイクロデータ
この仕様は、ドキュメントに機械可読な注釈を追加するためのメカニズムを導入しており、これによりツールはドキュメントから名前と値のペアのツリーを抽出できます。このセクションでは、このメカニズムと、HTMLドキュメントを他の形式に変換するために使用できるいくつかのアルゴリズムを説明します。このセクションでは、連絡先情報、カレンダーイベント、ライセンス作品のためのいくつかのサンプルマイクロデータ語彙も定義しています。
ユーザーインタラクション
HTML文書は、ユーザーがコンテンツと対話し、変更するためのさまざまなメカニズムを提供できます。このセクションでは、フォーカスの動作やドラッグアンドドロップなどについて説明しています。
ウェブページの読み込み
HTML文書は孤立して存在するわけではありません。このセクションでは、ウェブブラウザのように複数のページを扱う環境に影響を与える多くの機能を定義しています。
ウェブアプリケーションAPI
このセクションでは、HTMLでアプリケーションをスクリプト化するための基本的な機能を紹介します。
ウェブワーカー
このセクションでは、JavaScriptでバックグラウンドスレッドを実行するためのAPIを定義しています。
ワークレット
このセクションでは、JavaScriptをメインの実行環境とは別に実行するためのインフラストラクチャを定義しています。
通信API
このセクションでは、HTMLで記述されたアプリケーションが、同じクライアント上で動作する異なるドメインの他のアプリケーションと通信するために使用できるいくつかのメカニズムについて説明しています。また、サーバープッシュイベントストリームメカニズムであるサーバー送信イベント（EventSource）や、スクリプト用の双方向フルデュプレックスソケットプロトコルであるWeb Socketsについても紹介しています。
ウェブストレージ
このセクションでは、名前と値のペアに基づくクライアントサイドのストレージメカニズムを定義しています。
HTML構文
XML構文
これらすべての機能がシリアル化された形式で表現され、他の人々に送信されない限り意味がありません。そのため、これらのセクションでは、HTMLとXMLの構文と、それらの構文を使用してコンテンツを解析するためのルールを定義しています。
レンダリング
このセクションでは、ウェブブラウザのデフォルトのレンダリングルールを定義しています。

また、いくつかの付録があり、廃止された機能やIANAの考慮事項をリストアップしており、いくつかの索引も含まれています。

1.9.1 この仕様の読み方

この仕様は他のすべての仕様と同様に読むべきです。まず、最初から最後まで何度も読みます。そして、少なくとも一度は逆順に読みます。次に、内容一覧からランダムにセクションを選び、すべての相互参照をたどりながら読みます。

以下の適合要件セクションに記載されているように、この仕様はさまざまな適合クラスのための適合基準を説明しています。特に、プロデューサー（例：著者や彼らが作成する文書）に適用される適合要件と、コンシューマー（例：ウェブブラウザー）に適用される適合要件があります。これらは、何を要求しているかによって区別できます：プロデューサーに対する要件は許可されるものを述べており、コンシューマーに対する要件はソフトウェアがどのように動作すべきかを述べています。

例えば、「foo属性の値は有効な整数でなければならない」というのはプロデューサーに対する要件です。なぜなら、それが許可される値を規定しているからです。一方で、「foo属性の値は整数を解析するためのルールを使用して解析されなければならない」というのはコンシューマーに対する要件です。なぜなら、それがコンテンツをどのように処理するかを記述しているからです。

プロデューサーに対する要件は、コンシューマーに対してはまったく影響を与えません。

上記の例を続けると、特定の属性の値が有効な整数に制約されるという要件は、コンシューマーに対する要件について何も意味しないことを強調しておきます。実際には、コンシューマーがその属性を不透明な文字列として扱うことが要求されているかもしれません。その場合、値が要件に準拠しているかどうかにはまったく影響されません。あるいは、コンシューマーが無効な（この場合は非数値の）値をどのように処理するかを定義する特定のルールを使用して値を解析することが求められているかもしれません。

1.9.2 文章体裁の規則

これは定義、要件、または説明です。

これは注釈です。

これは例です。

これは未解決の問題です。

これは警告です。

[Exposed=Window]
 interface Example {
   // this is an IDL definition
 };
variable = object.method([optionalArgument])

これはインターフェースの使用法を説明する著者への注釈です。 

/* this is a CSS fragment */

用語の定義インスタンスはこのようにマークアップされます。その用語の使用例はこのようにまたはこのようにマークアップされます。

要素、属性、またはAPIの定義インスタンスはこのようにマークアップされます。それらの要素、属性、またはAPIへの参照はこのようにマークアップされます。

その他のコード片はこのようにマークアップされます。

変数はこのようにマークアップされます。

アルゴリズムでは、同期セクション内のステップは⌛でマークされます。

場合によっては、条件とそれに対応する要件の形式で要件が提示されることがあります。このような場合、条件に適用される要件は、常にその条件に続く最初の要件セットです。これには、これらの要件に対して複数の条件セットがある場合でも該当します。そのようなケースは次のように提示されます：

これは条件です
これは別の条件です
これは上記の条件に適用される要件です。
これは第三の条件です
これは第三の条件に適用される要件です。

1.10 HTMLの簡単な紹介

このセクションは規範的ではありません。

基本的なHTMLドキュメントは次のようになります：

<!DOCTYPE html>
 <html lang="en">
  <head>
   <title>Sample page</title>
  </head>
  <body>
   <h1>Sample page</h1>
   <p>This is a <a href="demo.html">simple</a> sample.</p>
   <!-- this is a comment -->
  </body>
 </html>

HTMLドキュメントは、要素とテキストのツリーで構成されています。各要素は、開始タグ（例えば「<body>」）と終了タグ（例えば「</body>」）でソース内に示されます。（特定の開始タグと終了タグは、特定のケースで省略され、他のタグによって暗黙的に示されます。）

タグは、要素が互いに完全に内包されるようにネストされ、重複しないようにする必要があります：

<p>This is <em>very <strong>wrong</em>!</strong></p>
<p>This <em>is <strong>correct</strong>.</em></p>

この仕様は、HTMLで使用できる一連の要素と、要素をネストする方法に関するルールを定義しています。

要素には、その動作を制御する属性を持たせることができます。以下の例では、a要素とそのhref属性を使用して作成されたハイパーリンクがあります：

<a href="demo.html">simple</a>

属性は開始タグの内部に配置され、名前と値から成り、それらは「=」文字で区切られます。属性値に引用符がない場合、それが含まれていない場合は" ' ` = <または>を含む場合を除き、ASCIIの空白文字は残したままにすることができます。それ以外の場合は、単一引用符または二重引用符のいずれかで引用する必要があります。値が空の文字列である場合は、値と「=」文字全体を省略することもできます。 

<!-- empty attributes -->
 <input name=address disabled>
 <input name=address disabled="">

 <!-- attributes with a value -->
 <input name=address maxlength=200>
 <input name=address maxlength='200'>
 <input name=address maxlength="200">

HTMLユーザーエージェント（例：ウェブブラウザ）は、このマークアップを解析し、それをDOM（Document Object Model）ツリーに変換します。DOMツリーは、ドキュメントのメモリ内表現です。

DOMツリーには、DocumentTypeノード、Elementノード、Textノード、Commentノード、場合によってはProcessingInstructionノードなど、さまざまな種類のノードが含まれます。

このセクションの上部にあるマークアップスニペットは、次のDOMツリーに変換されます：

このツリーのドキュメント要素は、HTMLドキュメントで常にその位置にあるhtml要素です。これには、head要素とbody要素、およびそれらの間にテキストノードが含まれています。

DOMツリーには、予想以上に多くのテキストノードが含まれています。これは、ソースに多数のスペース（ここでは「␣」で表される）と改行（「⏎」）が含まれており、これらがすべてDOMのテキストノードとして表示されるためです。ただし、歴史的な理由から、元のマークアップ内のすべてのスペースと改行がDOMに表示されるわけではありません。特に、head開始タグの前のすべての空白は静かに削除され、body終了タグの後のすべての空白は、bodyの最後に配置されます。

head要素には、title要素が含まれており、これは「Sample page」というテキストを含むテキストノード自体を含んでいます。同様に、body要素には、h1要素、p要素、およびコメントが含まれています。

このDOMツリーは、ページ内のスクリプトから操作することができます。スクリプト（通常はJavaScript）は、script要素を使用して埋め込むか、イベントハンドラーのコンテンツ属性を使用して埋め込むことができる小さなプログラムです。例えば、フォームのoutput要素の値を「Hello World」に設定するスクリプトを含むフォームは次のようになります：

<form name="main">
  Result: <output name="result"></output>
  <script>
   document.forms.main.elements.result.value = 'Hello World';
  </script>
 </form>

DOMツリー内の各要素はオブジェクトで表されており、これらのオブジェクトには操作できるようにするためのAPIがあります。例えば、リンク（上記のツリー内のa要素など）の「href」属性は、いくつかの方法で変更できます： 

var a = document.links[0]; // ドキュメント内の最初のリンクを取得
 a.href = 'sample.html'; // リンク先のURLを変更
 a.protocol = 'https'; // URLのスキーム部分だけを変更
 a.setAttribute('href', 'https://example.com/'); // 属性の内容を直接変更

DOMツリーは、HTMLドキュメントが実装によって処理および表示されるとき（特にウェブブラウザーのようなインタラクティブな実装の場合）に使用される表現方法であるため、この仕様は上記のマークアップよりも主にDOMツリーの観点で記述されています。

HTMLドキュメントは、インタラクティブなコンテンツを媒体に依存しない形で表現します。HTMLドキュメントは、画面に表示されたり、音声合成装置で読み上げられたり、点字ディスプレイに表示されたりすることがあります。これらのレンダリングがどのように行われるかを正確に制御するために、作成者はCSSのようなスタイリング言語を使用することができます。

次の例では、CSSを使用してページが黄色地に青色のテキストになっています。

<!DOCTYPE html>
 <html lang="en">
  <head>
   <title>Sample styled page</title>
   <style>
    body { background: navy; color: yellow; }
   </style>
  </head>
  <body>
   <h1>Sample styled page</h1>
   <p>This page is just a demo.</p>
  </body>
 </html>

HTMLの使用方法についての詳細は、作成者にチュートリアルやガイドを参照することをお勧めします。この仕様に含まれているいくつかの例も役立つかもしれませんが、初心者の作成者には、この仕様が必要に応じて定義している言語の詳細レベルが最初は理解しにくいかもしれないことを注意しておきます。

1.10.1 HTMLで安全なアプリケーションを作成する

このセクションは規範的ではありません。

HTMLを使用してインタラクティブなサイトを作成する場合、攻撃者がサイト自体やサイトのユーザーのセキュリティを侵害する脆弱性を導入しないよう注意が必要です。

この問題に関する包括的な研究はこのドキュメントの範囲外であり、作成者にはこの問題をより詳細に研究することを強くお勧めします。ただし、このセクションでは、HTMLアプリケーション開発における一般的な落とし穴について簡単に紹介します。

ウェブのセキュリティモデルは「オリジン」の概念に基づいており、それに対応してウェブ上の多くの潜在的な攻撃はオリジンをまたがるアクションに関連しています。[ORIGIN]

ユーザー入力の未検証
クロスサイトスクリプティング（XSS）
SQLインジェクション

信頼できない入力、たとえばユーザー生成コンテンツ（テキストコメントなど）、URLパラメータ内の値、サードパーティサイトからのメッセージなどを受け入れる際には、使用する前にデータを検証し、表示する際には適切にエスケープすることが不可欠です。これを怠ると、悪意のあるユーザーがさまざまな攻撃を実行できるようになります。これには、偽のユーザー情報（負の年齢など）を提供するような比較的無害なものから、情報を含むページをユーザーが閲覧するたびにスクリプトを実行し、攻撃を拡散させるような深刻なもの、さらにはサーバー上のすべてのデータを削除するような壊滅的なものまで含まれます。

ユーザー入力を検証するためのフィルタを書く際には、必ずホワイトリストベースのフィルタを使用し、既知の安全な構文を許可し、それ以外のすべての入力を禁止する必要があります。ブラックリストベースのフィルタ（既知の悪意のある入力を禁止し、それ以外のすべてを許可する）は安全ではありません。なぜなら、悪意のあるものすべてがまだ知られているわけではないからです（たとえば、将来発明されるかもしれないものなど）。

たとえば、あるページが表示内容を決定するためにURLのクエリ文字列を参照し、次のようにユーザーをそのページにリダイレクトしてメッセージを表示するとします：

<ul>
  <li><a href="message.cgi?say=Hello">Say Hello</a>
  <li><a href="message.cgi?say=Welcome">Say Welcome</a>
  <li><a href="message.cgi?say=Kittens">Say Kittens</a>
 </ul>

メッセージがエスケープされずにユーザーに表示された場合、悪意のある攻撃者がスクリプト要素を含むURLを作成することができます：

https://example.com/message.cgi?say=%3Cscript%3Ealert%28%27Oh%20no%21%27%29%3C/script%3E

攻撃者がこのページを訪問するよう被害者ユーザーを誘導すると、攻撃者が選んだスクリプトがページ上で実行されます。このようなスクリプトは、そのサイトが提供する機能に応じて、数多くの悪意のある操作を行う可能性があります。たとえば、そのサイトがeコマースショップである場合、そのようなスクリプトはユーザーに気づかれずに不要な購入を任意の回数行わせることができます。

これはクロスサイトスクリプティング攻撃と呼ばれます。

サイトにコードを実行させるためのトリックを試みるために使用できる構文は多数あります。以下に、作成者がホワイトリストフィルタを作成する際に考慮することが推奨されるいくつかの構文を示します：

クロスサイトリクエストフォージェリ（CSRF）

サイトがユーザー固有の副作用を伴うフォーム送信を許可する場合（たとえば、ユーザーの名前でフォーラムにメッセージを投稿する、購入を行う、パスポートを申請するなど）、リクエストがユーザーによって意図的に行われたものであり、他のサイトがユーザーをだまして知らないうちにリクエストを行わせたものではないことを確認することが重要です。

この問題は、HTMLフォームが他のオリジンに送信される可能性があるために存在します。

サイトは、フォームにユーザー固有の隠しトークンを挿入するか、すべてのリクエストで`Origin`ヘッダーをチェックすることで、このような攻撃を防ぐことができます。

クリックジャッキング

ユーザーにとって意図しない操作を行わせる可能性のあるインターフェースを提供するページは、ユーザーがインターフェースを誤って有効にしてしまう可能性を回避するように設計する必要があります。

ユーザーがこのようにだまされる方法の一つは、悪意のあるサイトが被害者のサイトを小さなiframeに配置し、ユーザーにリアクションゲームをさせるように説得する場合です。ユーザーがゲームをプレイしている間、悪意のあるサイトはiframeをマウスカーソルの下に素早く配置し、ユーザーがクリックしようとする瞬間に被害者サイトのインターフェースをクリックさせるようにします。

これを回避するために、フレーム内で使用されることを予期していないサイトは、フレーム内にないことを検出した場合にのみインターフェースを有効にすることが推奨されます（たとえば、windowオブジェクトをtop属性の値と比較するなど）。

1.10.2 スクリプトAPIを使用する際に避けるべき一般的な落とし穴

このセクションは規範的ではありません。

HTMLのスクリプトには「実行完了まで実行する」という意味があります。つまり、ブラウザはスクリプトを中断せずに実行し、その後で他のイベントを発生させたり、ドキュメントの解析を続行したりします。

一方、HTMLファイルの解析はインクリメンタルに行われ、パーサーはスクリプトを実行するためにいつでも停止できます。これは通常、良いことですが、作成者はイベントハンドラーをイベントが発生する可能性がある前にフックしないよう注意する必要があります。

これを確実に行うための2つの技術があります：イベントハンドラーコンテンツ属性を使用するか、要素を作成し、同じスクリプト内でイベントハンドラーを追加する方法です。後者は安全です。前述したように、スクリプトは他のイベントが発生する前に完了するまで実行されるためです。

これが現れる一例は、img要素とloadイベントです。このイベントは、特に画像がすでにキャッシュされている場合（よくあることです）、要素が解析されるとすぐに発生する可能性があります。

ここで、作成者はonloadハンドラーを使用して、img要素にloadイベントをキャッチさせます： 

<img src="games.png" alt="Games" onload="gamesLogoHasLoaded(event)">

要素がスクリプトによって追加されている場合、イベントハンドラーが同じスクリプト内で追加される限り、イベントが見逃されることはありません：

<script>
  var img = new Image();
  img.src = 'games.png';
  img.alt = 'Games'; 
  img.onload = gamesLogoHasLoaded; 
  // img.addEventListener('load', gamesLogoHasLoaded, false); // も機能します
 </script>

しかし、作成者が最初にimg要素を作成し、その後別のスクリプトでイベントリスナーを追加した場合、loadイベントがその間に発生し、見逃される可能性があります： 

<!-- このスタイルは使わないでください、競合状態があります！ -->
  <img id="games" src="games.png" alt="Games"> 
  <!-- パーサーが一時停止している間に'load'イベントが発生する可能性があります。 -->
  <script> 
   var img = document.getElementById('games'); 
   img.onload = gamesLogoHasLoaded; // 発生しないかもしれません！
  </script>

1.10.3 HTMLを書く際にミスを発見する方法：バリデーターと適合チェッカー

このセクションは規範的ではありません。

作成者には、一般的なミスを発見するために適合チェッカー（バリデーターとも呼ばれます）を利用することを推奨します。WHATWGは以下のURLでそのようなツールのリストを提供しています：https://whatwg.org/validator/

1.11 作成者のための適合要件

このセクションは規範的ではありません。

以前のHTML仕様とは異なり、この仕様では無効なドキュメントと有効なドキュメントの処理がある程度詳しく定義されています。

ただし、無効なコンテンツの処理がほとんどの場合よく定義されているにもかかわらず、ドキュメントの適合要件は依然として重要です。実際には、相互運用性（すべての実装が特定のコンテンツを信頼できる、一貫したまたは同等の方法で処理する状況）がドキュメント適合要件の唯一の目標ではありません。このセクションでは、適合ドキュメントとエラードキュメントを区別する理由のいくつかを詳細に説明します。

1.11.1 表示専用のマークアップ

このセクションは規範的ではありません。

以前のバージョンのHTMLに含まれていたほとんどの表示専用機能は、もはや許可されていません。一般的に、表示専用のマークアップには以下のような問題があることが判明しています：

表示専用要素の使用はアクセシビリティの低下につながる

表示専用のマークアップを使用して支援技術（AT）ユーザーにとって受け入れ可能な体験を提供することは可能ですが（例：ARIAの使用）、意味的に適切なマークアップを使用するよりもはるかに難しいです。さらに、そのような技術を使用しても、テキストモードブラウザのユーザーなど、非AT非グラフィカルユーザーに対してページをアクセシブルにすることはできません。

一方、媒体に依存しないマークアップを使用することで、より多くのユーザー（例：テキストブラウザのユーザー）に対応できるドキュメントを簡単に作成することができます。

メンテナンスコストの増加

スタイルに依存しない形で書かれたサイトは、メンテナンスがはるかに簡単です。たとえば、<font color="">を使用しているサイトの色を変更する場合、サイト全体で変更が必要ですが、CSSに基づくサイトの場合、単一のファイルを変更するだけで済みます。

ドキュメントサイズの増加

表示専用のマークアップは冗長になりがちであり、その結果、ドキュメントサイズが大きくなります。

これらの理由から、このバージョンのHTMLでは表示専用のマークアップが削除されました。この変更は驚くべきことではありません。HTML4では何年も前に表示専用マークアップが非推奨とされ、作成者が表示専用マークアップから移行するのを支援するためのモード（HTML4 Transitional）が提供されました。その後、XHTML 1.1ではそれらの機能が完全に廃止されました。

HTMLに残されている唯一の表示専用のマークアップ機能は、style属性とstyle要素です。style属性の使用は、プロダクション環境ではあまり推奨されませんが、迅速なプロトタイピングに役立ちます（そのルールを後で別のスタイルシートに移動できるため）。また、別のスタイルシートが不便な場合には特定のスタイルを提供するために使用することができます。同様に、style要素は、シンジケーションやページ固有のスタイルに役立ちますが、一般的にはスタイルが複数のページに適用される場合、外部スタイルシートの方が便利です。

また、以前は表示専用とされていたいくつかの要素が、この仕様では媒体に依存しない形で再定義されていることにも注意が必要です：b、i、hr、s、small、およびu。

1.11.2 構文エラー

このセクションは規範的ではありません。

HTMLの構文は、さまざまな問題を回避するために制約されています。

直感に反するエラーハンドリングの挙動

特定の無効な構文構造は、解析されると非常に直感に反するDOMツリーを生成することがあります。

たとえば、次のマークアップ断片は、対応するtable要素の前にhr要素が位置するDOMを生成します:

<table><hr>...
オプションのエラー回復を伴うエラー

ユーザーエージェントが、より奇妙で複雑なエラーハンドリングルールを実装することなく制御された環境で使用できるようにするために、ユーザーエージェントは、解析エラーに遭遇した場合に失敗することが許されています。

ストリーミングユーザーエージェントと互換性のないエラー

特定のエラーハンドリングの挙動（たとえば、前述の<table><hr>...の例の挙動など）は、ストリーミングユーザーエージェント（HTMLファイルを状態を保持せずに一度のパスで処理するユーザーエージェント）と互換性がありません。そのようなユーザーエージェントとの互換性の問題を回避するために、そのような挙動を引き起こす構文は無効と見なされます。

インフォセットの強制を引き起こす可能性のあるエラー

XMLに基づくユーザーエージェントがHTMLパーサーに接続されている場合、HTMLファイルによってXMLが強制する特定の不変条件（たとえば、要素や属性の名前に複数のコロンが含まれることはない）が違反される可能性があります。これに対処するには、HTML DOMをXML互換のインフォセットに強制的に変換する必要がある場合があります。このような処理が必要なほとんどの構文構造は無効と見なされます。（連続する2つのハイフンを含むコメントや、ハイフンで終わるコメントは、HTML構文で許可される例外です。）

非常にパフォーマンスが低下するエラー

特定の構文構造は、非常にパフォーマンスが低下することがあります。そのような構文の使用を思いとどまらせるために、それらは通常非適合とされます。

たとえば、次のマークアップは、すべての未閉鎖のi要素が各段落で再構築されるため、パフォーマンスが低下し、各段落にますます多くの要素が追加されることになります: 

<p><i>She dreamt.
 <p><i>She dreamt that she ate breakfast.
 <p><i>Then lunch.
 <p><i>And finally dinner.

この断片に対応するDOMは次のようになります:

脆弱な構文構造を含むエラー

歴史的な理由から、比較的脆弱な構文構造があります。このような問題に偶然遭遇するユーザーの数を減らすために、それらは非適合とされています。

たとえば、属性内での特定の名前付き文字参照の解析は、閉じセミコロンが省略されていても行われます。アンパサンドと文字を続けて書くことは安全ですが、その文字が名前付き文字参照を構成する場合、その文字が意図せずにその文字として解釈される可能性があります。

この断片では、属性の値は「?bill&ted」です:

<a href="?bill&ted">Bill and Ted</a>

しかし、次の断片では、属性の値は実際には「?art©」であり、意図していた「?art&copy」ではありません。これは、閉じセミコロンがなくても「&copy」が「&copy;」と同じように処理され、「©」と解釈されるためです: 

<a href="?art&copy">Art and Copy</a>

この問題を回避するために、すべての名前付き文字参照はセミコロンで終わる必要があり、セミコロンなしで名前付き文字参照を使用することはエラーとしてフラグが立てられます。

したがって、上記のケースを表現する正しい方法は次のとおりです:

<a href="?bill&ted">Bill and Ted</a> <!-- &tedは名前付き文字参照ではないので問題ありません -->
<a href="?art&amp;copy">Art and Copy</a> <!-- &がエスケープされている必要があります。なぜなら、&copyは名前付き文字参照だからです -->
レガシーユーザーエージェントにおける既知の相互運用性問題を含むエラー

特定の構文構造は、レガシーユーザーエージェントで特に微妙または重大な問題を引き起こすことが知られており、それらは非適合とされ、作成者がそれらを回避できるようにします。

たとえば、U+0060 GRAVE ACCENT文字（`）が引用符なしの属性で許可されていないのは、このためです。特定のレガシーユーザーエージェントでは、それが引用符文字として扱われることがあります。

別の例として、DOCTYPEがクイックモードをトリガーする必要があるのは、レガシーユーザーエージェントのクイックモードの挙動が多くの場合、ほとんど文書化されていないためです。

作成者がセキュリティ攻撃にさらされるリスクを伴うエラー

特定の制約は、既知のセキュリティ問題を回避するためにのみ存在します。

たとえば、UTF-7の使用に関する制約は、UTF-7を使用した既知のクロスサイトスクリプティング攻撃から作成者が被害を受けないようにするためだけに存在します。[UTF7]

作成者の意図が不明確な場合

作成者の意図が非常に不明確なマークアップは、しばしば非適合とされます。これらのエラーを早期に修正することで、後のメンテナンスが容易になります。

たとえば、作成者が次のコードでh1見出しまたはh2見出しを意図していたのかが不明です: 

<h1>Contact details</h2>
誤植である可能性が高い場合

ユーザーが単純な誤植をした場合、そのエラーが早期に検出されると便利です。これは、作成者のデバッグ時間を大幅に節約できます。このため、この仕様では、要素名や属性名などが仕様で定義された名前と一致しない場合、それをエラーと見なすことが多いです。

たとえば、作成者が<capton>と入力してしまった場合、これがエラーとしてフラグが立てられ、作成者はすぐに誤植を修正できます。

将来の新しい構文に干渉する可能性があるエラー

言語構文が将来拡張される可能性を考慮して、その他の点では無害な機能が禁止されています。

たとえば、終了タグ内の「属性」は現在無視されていますが、それらは無効です。これは、将来言語がその構文機能を使用する変更を行った場合でも、既に展開されている（かつ有効な！）コンテンツと競合しないようにするためです。

一部の作成者は、すべての属性を常に引用符で囲み、すべてのオプションのタグを常に含める習慣を持っていることが役立つと感じています。そのような作成者を支援するために、適合チェッカーはそのような慣行を強制する操作モードを提供することができます。

1.11.3 コンテンツモデルと属性値に関する制限

このセクションは規範的ではありません。

言語の構文に加えて、この仕様は要素や属性の指定方法に関する制限も課しています。これらの制限は、同様の理由で存在します:

疑わしいセマンティクスを持つコンテンツに関するエラー

定義された意味を持つ要素の誤用を避けるため、コンテンツモデルが定義されており、そのような入れ子が疑わしい価値を持つ場合には要素の入れ子を制限します。

たとえば、この仕様では、section 要素をkbd 要素内に入れ子にすることを禁止しています。なぜなら、作成者がセクション全体をキー入力することを意図している可能性が非常に低いためです。

セマンティクスの表現に矛盾があるエラー

同様に、要素の使用において作成者の誤りに注意を促すために、表現されたセマンティクスに明確な矛盾がある場合も適合エラーと見なされます。

たとえば、以下のフラグメントでは、セマンティクスが意味不明です。区切り線がセルであることや、ラジオボタンが進捗バーであることはありえません。

<hr role="cell">
<input type=radio role=progressbar>

もう一つの例として、ul 要素のコンテンツモデルに関する制限があります。これは、li 要素のみを子要素として許可します。リストとは定義上、0個以上のリスト項目から成るものであり、ul 要素がli 要素以外のものを含む場合、それが何を意味しているのかが明確ではありません。

デフォルトのスタイルが混乱を招く可能性がある場合

特定の要素には、特定の組み合わせが混乱を招く可能性が高いデフォルトのスタイルや動作があります。これらの問題がない同等の代替手段がある場合、混乱を招く組み合わせは許可されていません。

たとえば、div 要素はブロックボックスとしてレンダリングされ、span 要素はインラインボックスとしてレンダリングされます。ブロックボックスを インラインボックスに入れ子にするのは不必要に混乱を招きます。div 要素を入れ子にする、またはspan 要素を入れ子にする、あるいはspan 要素をdiv 要素の中に入れ子にすることで同じ目的を達成できますが、後者の方法のみがブロックボックスをインラインボックスに入れることを伴うため、この組み合わせは許可されていません。

別の例としては、インタラクティブコンテンツを入れ子にすることができない方法があります。たとえば、button 要素にtextarea 要素を含めることはできません。これは、そのような入れ子のデフォルトの動作がユーザーにとって非常に混乱を招くためです。これらの要素を入れ子にする代わりに、隣り合わせに配置することができます。

仕様の誤解の可能性を示すエラー

何かが許可されていないのは、それを許可すると作成者に混乱を招く可能性があるためです。

たとえば、disabled 属性を"false"に設定することは禁止されています。これは、見かけ上は要素が有効であることを意味しているように見えますが、実際には要素が無効であることを意味しているためです（実装にとって重要なのは属性の存在であり、その値ではありません）。

言語を単純化するために課された制限に関するエラー

一部の適合エラーは、作成者が学ぶ必要がある言語を簡素化するために存在します。

たとえば、area 要素のshape 属性は、実際にはcirc とcircle 値の両方を同義語として受け入れるにもかかわらず、circ 値の使用を禁止しています。これは、チュートリアルや他の学習支援ツールを簡素化するためです。両方を許可することにはメリットがなく、言語を教える際には混乱を招くだけです。

パーサーの癖に関するエラー

特定の要素は、いくつかの偏った方法でパースされます（主に歴史的な理由から）、それらのコンテンツモデルの制限は、作成者がこれらの問題に直面しないようにすることを目的としています。

たとえば、form 要素はフレージングコンテンツの中に入れることはできません。なぜなら、HTMLとしてパースされると、form 要素の開始タグがp 要素の終了タグを暗黙的に示すためです。したがって、次のマークアップは1つの段落ではなく、2つの段落を生成します: 

<p>Welcome. <form><label>Name:</label> <input></form>

これは次のようにパースされます:

<p>Welcome. </p><form><label>Name:</label> <input></form>
スクリプトがデバッグが難しい方法で失敗する可能性があるエラー

一部のエラーは、デバッグが難しいスクリプトの問題を防ぐためのものです。

たとえば、同じ値を持つ2つのid 属性を持つことが適合しないとされるのは、重複するIDが間違った要素を選択する原因となり、場合によってはその原因を特定するのが困難な災害的な影響を引き起こすためです。

作成者の時間を浪費するエラー

一部の構造は、歴史的に多くの作成者の時間を浪費してきたため、それを避けるように作成者を促すことで、将来の作業で時間を節約できるようにするために禁止されています。

たとえば、script 要素のsrc 属性が要素の内容を無視させることがあります。しかし、特に要素の内容が実行可能なスクリプトのように見える場合、これは明らかではなく、作成者がインラインスクリプトをデバッグしようとして多くの時間を費やすことになります。これを防ぐために、この仕様ではsrc 属性が存在する場合に、script 要素に実行可能なスクリプトが含まれている場合、それを適合しないとしています。これにより、ドキュメントを検証している作成者がこの種の誤りで時間を浪費する可能性が低くなります。

HTMLとXMLの構文を行き来する作成者に影響を与える領域に関連するエラー

一部の作成者は、XMLとHTMLの両方として解釈され、同様の結果をもたらすファイルを作成することを好みます。この慣行は、スクリプト、スタイリング、または自動シリアル化のいかなる種類を含む場合、さまざまな微妙な問題が絡み合うため、一般的には推奨されませんが、この仕様には少なくともその困難をある程度緩和するためのいくつかの制限があります。これにより、作成者がHTMLとXMLの構文間を移行する際の一時的なステップとしてこれを使用しやすくなります。

たとえば、lang 属性とxml:lang 属性の値を同期させるための複雑なルールがあります。

もう一つの例として、HTMLシリアライゼーションにおけるxmlns属性の値に対する制限があります。これは、処理がHTMLまたはXMLとして行われた場合でも、適合するドキュメント内の要素が同じ名前空間に収まるようにするためです。

将来の拡張のために予約された領域に関連するエラー

言語構文を将来のリビジョンで拡張できるようにするための制限と同様に、要素のコンテンツモデルや属性の値に対する制限の一部は、HTML語彙の将来の拡張を可能にするためのものです。

たとえば、target 属性の値をU+005F低線（_）文字で始まる特定の事前定義された値のみに制限することで、将来的に事前定義された新しい値を導入しても、作成者が定義した値と競合することがなくなります。

他の仕様の誤用を示すエラー

特定の制限は、他の仕様によって課された制限をサポートすることを目的としています。

たとえば、メディアクエリリストを取る属性に対して、有効なメディアクエリリストのみを使用することを要求することで、その仕様の適合ルールに従うことの重要性を強調しています。

1.12 推奨読書

このセクションは規範的ではありません。

この仕様書の読者にとって、以下の文書が興味深いかもしれません。

World Wide Webのための文字モデル1.0: 基礎 [CHARMOD]

このアーキテクチャ仕様は、仕様書の著者、ソフトウェア開発者、およびコンテンツ開発者に、Unicode標準とISO/IEC 10646によって共同で定義されたユニバーサル文字集合に基づいて、ワールドワイドウェブ上の相互運用可能なテキスト操作のための共通の参照を提供します。取り上げられるトピックには、「文字」「エンコーディング」「文字列」の用語の使用、参照処理モデル、文字エンコーディングの選択と識別、文字エスケープ、および文字列のインデックス作成が含まれます。

Unicode Security Considerations [UTR36]

Unicodeには非常に多くの文字が含まれており、世界の様々な書記体系を取り入れているため、不適切な使用はプログラムやシステムをセキュリティ攻撃にさらす可能性があります。特に、より多くの製品が国際化されるにつれて、これは重要になっています。この文書では、プログラマー、システムアナリスト、標準開発者、およびユーザーが考慮すべきいくつかのセキュリティ上の考慮事項を説明し、問題のリスクを軽減するための具体的な推奨事項を提供しています。

Web Content Accessibility Guidelines (WCAG) [WCAG]

Web Content Accessibility Guidelines (WCAG)は、ウェブコンテンツをよりアクセスしやすくするための広範な推奨事項を網羅しています。これらのガイドラインに従うことで、視覚障害、聴覚障害、学習障害、認知障害、運動制限、言語障害、光過敏症、およびそれらの組み合わせを含む障害を持つ人々に対して、より多くの人々がコンテンツにアクセスできるようになります。また、これらのガイドラインに従うことで、一般的なユーザーにとってもウェブコンテンツがより使いやすくなることがよくあります。

Authoring Tool Accessibility Guidelines (ATAG) 2.0 [ATAG]

この仕様書は、障害を持つ人々にとってよりアクセスしやすいウェブコンテンツ作成ツールを設計するためのガイドラインを提供します。これらのガイドラインに準拠した作成ツールは、障害を持つ著者にとってアクセス可能なユーザーインターフェースを提供するだけでなく、すべての著者がアクセス可能なウェブコンテンツを作成、サポート、および促進することを可能にします。

User Agent Accessibility Guidelines (UAAG) 2.0 [UAAG]

この文書は、障害を持つ人々にとってウェブアクセシビリティの障壁を低くするユーザーエージェントを設計するためのガイドラインを提供します。ユーザーエージェントには、ウェブコンテンツを取得してレンダリングするブラウザやその他の種類のソフトウェアが含まれます。これらのガイドラインに準拠したユーザーエージェントは、自身のユーザーインターフェースと他の技術（特に支援技術）と通信する能力を通じてアクセシビリティを促進します。さらに、障害を持つユーザーだけでなく、すべてのユーザーにとって準拠したユーザーエージェントがより使いやすくなるはずです。

2 共通インフラストラクチャ

この仕様書はInfraに依存しています。 [INFRA]

2.1 用語

この仕様書では、HTMLおよびXML属性とIDL属性の両方を参照し、しばしば同じ文脈でそれらを扱います。どちらが参照されているのかが明確でない場合、それらはHTMLおよびXML属性に対してはコンテンツ属性、IDLインターフェースで定義されているものにはIDL属性と呼ばれます。同様に、"プロパティ"という用語は、JavaScriptオブジェクトのプロパティとCSSプロパティの両方に使用されます。これらが曖昧な場合、それぞれオブジェクトプロパティおよびCSSプロパティとして区別されます。

一般的に、仕様書が機能がHTML構文またはXML構文に適用されると述べる場合、それは他方の言語も含まれます。ある機能が特にどちらか一方にのみ適用される場合は、「HTMLの場合、...（これはXMLには適用されません）」のように明確に述べられます。

この仕様書では、ドキュメントという用語は、短い静的ドキュメントからリッチなマルチメディアを含む長いエッセイやレポート、完全なインタラクティブアプリケーションまで、HTMLのあらゆる使用に言及するために使用されます。この用語は、Documentオブジェクトとその子孫DOMツリー、ならびに文脈に応じてHTML構文またはXML構文を使用するシリアル化されたバイトストリームの両方を指すために使用されます。

DOM構造の文脈では、用語HTMLドキュメントおよびXMLドキュメントは、DOMで定義されているように使用され、Documentオブジェクトが置かれる2つの異なるモードを具体的に指します。[DOM]（そのような使用は常に定義へのリンクが付けられています。）

バイトストリームの文脈では、HTMLドキュメントという用語はtext/htmlとしてラベル付けされたリソースを指し、XMLドキュメントという用語はXML MIMEタイプとしてラベル付けされたリソースを指します。

簡潔さのために、表示、描画、視覚化のような用語が、ドキュメントがユーザーにどのようにレンダリングされるかを指して使用されることがあります。これらの用語は視覚的な媒体を意味するものではなく、他の媒体にも同等の方法で適用されると見なさなければなりません。

2.1.1 並行処理

ステップを並行して実行するとは、そのステップが他の標準のロジック（例：イベントループなど）と同時に、一つずつ順番に実行されることを意味します。この標準では、この並行処理がどのように実現されるかについて具体的なメカニズムは定義されていません。例えば、タイムシェアリング協調型マルチタスク、ファイバー、スレッド、プロセス、異なるハイパースレッド、コア、CPU、マシンなどが考えられます。それに対して、即時に実行されるべき操作は、現在実行中のタスクを中断し、自分自身を実行し、その後に先に実行されていたタスクを再開しなければなりません。

並行処理を活用した仕様を記述するためのガイダンスについては、他の仕様からイベントループを扱うを参照してください。

同じデータに対して動作する異なる並行処理アルゴリズム間の競合状態を回避するために、並行キューを使用することができます。

並行キューとは、連続して実行されなければならないアルゴリズムステップのキューを表します。

並行キューには、アルゴリズムキュー（キュー）があり、初期状態では空です。

並行キューにステップをエンキューするには、そのアルゴリズムステップを並行キューのアルゴリズムキューにエンキューします。

新しい並行キューを開始するには、次のステップを実行します。

  1. parallelQueueを新しい並行キューとします。

  2. 次のステップを並行して実行します。

    1. 常に次の処理を行います。

      1. stepsを、parallelQueueのアルゴリズムキューからデキューした結果とします。

      2. stepsが何もなければ、それを実行します。

      3. アサート: stepsの実行が例外を投げなかったことを確認します。並行して実行されるステップは例外を投げることはできません。

      実装はこれを継続的に実行されるループとして実装することは期待されていません。標準のアルゴリズムは理解しやすいものにするためであり、バッテリー寿命やパフォーマンスに優れているとは限りません。

  3. parallelQueueを返します。

並行して実行されるステップは、さらに他のステップを並行して実行することができます。例：並行キューの中で、一連のステップをキューと並行して実行することが有用です。

標準がnameList（リスト）を定義し、nameListにnameを追加するメソッドが定義されていると仮定します。ただし、nameListが既にnameを含んでいる場合、それは拒否されます。

次の解決策はレースコンディションの問題を抱えています。

  1. p を、これの関連レルムで作成された新しいプロミスとします。

  2. global を、これの関連グローバルオブジェクトとします。

  3. 以下のステップを並行して実行します：

    1. nameList が name を含む場合、global で与えられたDOM操作タスクソースで、p を TypeError で拒否するためのグローバルタスクをキューに入れ、これらのステップを中止します。

    2. 潜在的に時間のかかる何らかの作業を行います。

    3. name を nameList に追加します。

    4. global で与えられたDOM操作タスクソースで、p を undefined で解決するためのグローバルタスクをキューに入れます。

  4. p を返します。

上記の2つの呼び出しは同時に実行される可能性があり、ステップ2.1の時点でnameがnameListに存在しないが、ステップ2.3が実行される前にnameが追加される可能性があるため、nameがnameListに2回含まれる結果となります。

並行キューはこの問題を解決します。標準は、nameListQueueを新しい並行キューを開始する結果とし、次のようにします。

  1. p を、これの関連レルムで作成された新しいプロミスとします。

  2. global を、これの関連グローバルオブジェクトとします。

  3. nameListQueue に以下のステップをキューに入れます：

    1. nameList が name を含む場合、global で与えられたDOM操作タスクソースで、p を TypeError で拒否するためのグローバルタスクをキューに入れ、これらのステップを中止します。

    2. 潜在的に時間のかかる何らかの作業を行います。

    3. name を nameList に追加します。

    4. global で与えられたDOM操作タスクソースで、p を undefined で解決するためのグローバルタスクをキューに入れます。

  4. p を返します。

このステップはキューに追加され、レース条件が回避されます。

2.1.2 リソース

この仕様書では、外部リソースの意味を解釈できる実装がユーザーエージェントにあるかどうかを指す際に、サポートという用語を使用します。あるフォーマットやタイプがサポートされているとは、そのフォーマットやタイプの外部リソースを、リソースの重要な部分が無視されることなく処理できる実装があることを意味します。特定のリソースがサポートされているかどうかは、リソースのフォーマットで使用されている機能によって異なる場合があります。

例えば、PNG画像がサポートされているフォーマットと見なされるのは、そのピクセルデータがデコードされ、レンダリングできる場合です。たとえその画像にアニメーションデータが含まれていたとしても、実装がそれを知らずに処理できるならば、サポートされていると見なされます。

MPEG-4ビデオファイルがサポートされているフォーマットと見なされないのは、使用されている圧縮フォーマットがサポートされていない場合です。たとえ実装がファイルのメタデータからムービーの寸法を判断できたとしても、サポートされているとは見なされません。

一部の仕様書、特にHTTP仕様書で表現と呼ばれるものは、この仕様書ではリソースと呼ばれます。 [HTTP]

リソースの重要なサブリソースとは、リソースが正しく処理されるために利用可能である必要があるサブリソースを指します。どのリソースが重要と見なされるかは、そのリソースのフォーマットを定義する仕様書によって定義されます。

CSSスタイルシートの場合、ここでは暫定的に、@importルールを介してインポートされた他のスタイルシート、及び他のインポートされたスタイルシートによって間接的にインポートされたスタイルシートが重要なサブリソースであると定義します。

この定義は完全に相互運用可能ではありません。さらに、一部のユーザーエージェントは、背景画像やウェブフォントなどのリソースを重要なサブリソースとして扱っているようです。理想的には、CSS作業部会がこれを定義するべきです。進捗を追跡するために、w3c/csswg-drafts issue #1088を参照してください。

2.1.3 XML互換性

HTMLからXMLへの移行を容易にするために、この仕様に準拠するユーザーエージェントは、HTML内の要素を、少なくともDOMとCSSの目的において、http://www.w3.org/1999/xhtml名前空間に配置します。HTML要素という用語は、XML文書内でも、その名前空間にある任意の要素を指します。

特に明記されていない限り、この仕様で定義または言及されているすべての要素は、HTML名前空間（"http://www.w3.org/1999/xhtml"）にあり、この仕様で定義または言及されているすべての属性には名前空間がありません。

要素型という用語は、特定のローカル名と名前空間を持つ要素の集合を指すために使用されます。例えば、button要素は、button要素型を持つ要素であり、これはそれらが「button」というローカル名と、（上記で定義されたように）HTML名前空間を持つことを意味します。

属性名は、Name生成規則に一致し、U+003A コロン文字 (:) を含まない場合、XML互換であると言われます。[XML]

2.1.4 DOMツリー

ある要素や属性が無視される、別の値として扱われる、または何か他のものとして処理されると記載されている場合、これはノードがDOM内に存在する後の処理のみを指します。このような状況でユーザーエージェントがDOMを変更してはなりません。

コンテンツ属性は、その新しい値が以前の値と異なる場合にのみ変更されるとみなされます。すでに持っている値に属性を設定しても、それは変更とはみなされません。

空という用語が属性値、テキストノード、または文字列に対して使用される場合、それはテキストの長さがゼロであることを意味します（すなわち、制御文字やU+0020スペースさえも含まれていない）。

HTML要素は、要素のローカル名に対して定義された、特定のHTML要素挿入手順、HTML要素接続後手順、HTML要素削除手順、およびHTML要素移動手順を持つことができます。

HTML標準のための挿入ステップは、insertedNodeを引数として以下のように定義されます。

  1. もし insertedNode が 名前空間 が HTML 名前空間 である要素であり、この標準が insertedNode の ローカル名 に対するHTML 要素挿入手順を定義している場合、その対応するHTML 要素挿入手順を insertedNode に対して実行します。

  2. insertedNodeがフォーム関連要素であるか、またはフォーム関連要素の祖先である場合、次のステップを実行します。

    1. そのフォーム関連要素のパーサー挿入フラグが設定されている場合、処理を終了します。

    2. そのフォーム関連要素のフォームオーナーをリセットします。

  3. もしinsertedNodeがElement で、開いている要素のスタックに ない場合、HTMLパーサーの 内部リソースリンクの処理を行います。 insertedNodeのノードドキュメントに基づいています。

HTML標準の接続後ステップは、insertedNode が与えられた場合、次のように定義されます。

  1. もし insertedNode が、その 名前空間 が HTML 名前空間 に属する要素であり、かつこの標準が insertedNode の ローカル名 に対して HTML 要素接続後の手順 を定義している場合、insertedNode に対して対応する HTML 要素接続後の手順 を実行します。

HTML標準のための削除ステップは、removedNodeとoldParentを引数として以下のように定義されます。

  1. documentをremovedNodeのノードドキュメントとして設定します。

  2. もしdocumentのフォーカスされたエリアがremovedNodeである場合、documentのビューポートにdocumentのフォーカスされたエリアを設定し、documentのナビゲーションAPIの進行中のナビゲーション中にフォーカスが変更されたをfalseに設定します。

    これによって、フォーカス解除ステップ、フォーカスステップ、またはフォーカス更新ステップは実行されず、そのためblurイベントやchangeイベントは発生しません。

  3. もし removedNode が 名前空間 が HTML 名前空間 である要素であり、この標準が removedNode の ローカル名 に対するHTML 要素削除手順を定義している場合、その対応するHTML 要素削除手順を removedNode および oldParent に対して実行します。

  4. removedNodeがフォーム関連要素であるか、またはフォーム関連要素の祖先である場合、次のステップを実行します。

    1. そのフォーム関連要素がフォームオーナーを持ち、かつそのフォーム関連要素とフォームオーナーが同じツリーに属さない場合、そのフォーム関連要素のフォームオーナーをリセットします。

  5. もしremovedNodeのポップオーバー属性がNo Popover Stateにない場合、removedNodeに対してポップオーバーアルゴリズムを非表示にするを実行し、false、false、およびfalseを設定します。

HTML標準の移動ステップは、movedNode が与えられた場合、次のように定義されます。

  1. movedNode が、その名前空間がHTML名前空間である要素であり、かつこの標準が movedNode のローカル名に対応するHTML要素移動ステップを定義している場合、movedNode が与えられた対応するHTML要素移動ステップを実行します。

  2. movedNode がフォーム関連要素であるか、フォーム関連要素の祖先である場合：

    1. フォーム関連要素がフォームオーナーを持ち、かつフォーム関連要素とそのフォームオーナーがもはや同じツリーにない場合、フォーム関連要素のフォームオーナーをリセットします。

ノードがドキュメントに挿入された場合、それは挿入ステップがそれを引数として実行され、それが今やドキュメントツリー内に存在している場合を指します。同様に、ノードがドキュメントから削除された場合、それは削除ステップがそれを引数として実行され、それが今やドキュメントツリー内にない場合を指します。

ノードが接続されたとき、それは挿入ステップがそれを引数として実行され、それが今や接続された場合を指します。同様に、ノードが接続が解除されたとき、それは削除ステップがそれを引数として実行され、それが今や接続されていない場合を指します。

ノードはブラウジングコンテキストに接続されている場合、それは接続された状態であり、そのシャドウを含むルートのブラウジングコンテキストがnullでない場合を指します。ノードがブラウジングコンテキストに接続されたとき、それは挿入ステップがそれを引数として実行され、それが今やブラウジングコンテキストに接続されている場合を指します。ノードがブラウジングコンテキストから切断された場合、それは削除ステップがそれを引数として実行され、それが今やブラウジングコンテキストに接続されていない場合、またはそのシャドウを含むルートのブラウジングコンテキストがnullになった場合を指します。

2.1.5 スクリプティング

Fooという構築は、Fooが実際にはインターフェースである場合、より正確な「インターフェースFooを実装するオブジェクト」という表現の代わりに使われることがあります。

IDL属性は、その値が取得されるとき（例：著者スクリプトによって）に取得中であると言い、新しい値が割り当てられるときに設定中であると言います。

DOMオブジェクトがライブであると言われる場合、そのオブジェクト上の属性やメソッドは、データのスナップショットではなく、実際の基礎データに対して動作しなければなりません。

2.1.6 プラグイン

用語プラグインは、ユーザーエージェントによって使用される 実装依存のコンテンツハンドラーのセットを指し、 Documentオブジェクトのユーザーエージェントのレンダリングに 関与することができますが、子ナビゲーラブルとしては 動作せず、Documentに新しいNodeオブジェクトを DOMに追加することはありません。

通常、このようなコンテンツハンドラーはサードパーティによって提供されますが、ユーザーエージェントが 組み込みのコンテンツハンドラーをプラグインとして指定することもできます。

ユーザーエージェントは、text/plain および application/octet-stream が登録されたプラグインを持っているとは考えてはなりません。

プラグインの一例としては、ユーザーがPDFファイルに移動するときに、ナビゲーラブルで インスタンス化されるPDFビューアが挙げられます。これは、PDFビューアコンポーネントを実装した 当事者がユーザーエージェント自体を実装した当事者と同じであったかどうかに関係なく、プラグインとして 数えられます。ただし、ユーザーエージェントとは別に起動されるPDFビューアアプリケーション（同じ インターフェースを使用しないもの）は、この定義ではプラグインとは見なされません。

この仕様はプラグインとの相互作用のメカニズムを定義していません。これは、ユーザーエージェントおよびプラットフォーム固有の ものとされているためです。いくつかのユーザーエージェントは、Netscape Plugin APIのようなプラグインメカニズムを サポートすることを選択するかもしれませんし、リモートコンテンツコンバータを使用するか、特定のタイプに対して 組み込みのサポートを持つかもしれません。実際、この仕様はユーザーエージェントにプラグインをサポートするよう 要求していません。[NPAPI]

ブラウザは、プラグイン向けの外部コンテンツと相互作用する際に、 極めて注意するべきです。サードパーティのソフトウェアがユーザーエージェント自体と同じ権限で実行される 場合、そのサードパーティソフトウェアの脆弱性は、ユーザーエージェントの脆弱性と同じくらい危険です。

(これはトラッキングベクターです。) 異なるユーザーが異なるセットのプラグインを持つことは、 ユーザーがユニークに識別される可能性を高めるトラッキングベクターを提供します。そのため、ユーザーエージェントは 各ユーザーに対して正確に同じセットのプラグインをサポートするよう 勧められています。

2.1.7 文字エンコーディング

文字エンコーディング、または それが曖昧でない場合は単にエンコーディングは、バイトストリームとUnicode文字列間の変換方法を定義するものであり、 Encodingで定義されています。エンコーディングにはエンコーディング名と1つ以上のエンコーディングラベルがあり、Encoding標準では エンコーディングの名前とラベルと呼ばれています。[ENCODING]

2.1.8 適合クラス

この仕様書は、ユーザーエージェント（実装者向け）および文書（著者やオーサリングツールの実装者向け）の適合基準について説明しています。

適合文書とは、文書の適合基準をすべて満たす文書のことです。読みやすさのために、これらの適合要件の一部は著者に対する適合要件として表現されていますが、そのような要件は暗黙的に文書に対する要件となります。定義により、すべての文書は著者が存在すると仮定されています（場合によっては、その著者自体がユーザーエージェントであることもあります—その場合、そのユーザーエージェントには追加の規則が適用されます）。

例えば、「著者はfoobar要素を使用してはならない」という要件があれば、それは文書にfoobarという名前の要素を含めてはならないことを意味します。

文書の適合要件と実装の適合要件の間に暗黙の関係はありません。ユーザーエージェントは、非適合文書を自由に扱うことはできません。この仕様書で説明されている処理モデルは、入力文書の適合性に関わらず、実装に適用されます。

ユーザーエージェントは、異なる適合要件を持ついくつかの（重複する）カテゴリに分かれます。

ウェブブラウザおよびその他のインタラクティブなユーザーエージェント

XML構文をサポートするウェブブラウザは、この仕様書で説明されているように、XML文書内にあるHTML名前空間の要素や属性を処理し、ユーザーがそれらと対話できるようにしなければなりません。ただし、他の仕様書によってこれらの要素のセマンティクスが上書きされている場合を除きます。

適合するウェブブラウザは、XML文書内にscript要素を見つけた場合、その要素に含まれるスクリプトを実行します。ただし、その要素がXSLTで表現された変換の中にある場合（ユーザーエージェントがXSLTをサポートしていると仮定して）、プロセッサは代わりにscript要素を変換の一部を構成する不透明な要素として扱います。

HTML構文をサポートするウェブブラウザは、HTML MIMEタイプでラベル付けされた文書を、この仕様書で説明されているように処理し、ユーザーがそれらと対話できるようにしなければなりません。

スクリプトをサポートするユーザーエージェントは、この仕様書に記載されているIDLフラグメントの適合実装でもなければなりません。Web IDL参照。[WEBIDL]

HTML要素のセマンティクスを上書きする仕様書は、通常、その要素を表すDOMオブジェクトに対する要件を上書きしません。例えば、上記の例では、script要素は依然としてHTMLScriptElementインターフェースを実装することになります。

非インタラクティブなプレゼンテーションユーザーエージェント

HTMLおよびXML文書を処理して非インタラクティブなバージョンをレンダリングするだけのユーザーエージェントは、ユーザーインタラクションに関する要件を除いて、ウェブブラウザと同じ適合基準を満たさなければなりません。

非インタラクティブなプレゼンテーションユーザーエージェントの典型的な例としては、プリンタ（静的UA）やオーバーヘッドディスプレイ（動的UA）があります。ほとんどの静的非インタラクティブプレゼンテーションユーザーエージェントは、スクリプトのサポートがないことを選択することが期待されます。

非インタラクティブだが動的なプレゼンテーションUAは、スクリプトを実行し、フォームを動的に送信するなどの処理を行います。しかし、ユーザーが文書と対話できない場合、フォーカスの概念は無意味なので、UAはフォーカス関連のDOM APIをサポートする必要はありません。

推奨されるデフォルトレンダリングをサポートするビジュアルユーザーエージェント

インタラクティブかどうかにかかわらず、ユーザーエージェントは、この仕様書で定義されている推奨されるデフォルトレンダリングをサポートするものと指定される場合があります（おそらくユーザーオプションとして）。

これは必須ではありません。特に、推奨されるデフォルトレンダリングを実装するユーザーエージェントであっても、ユーザーの体験を向上させるために、このデフォルトをオーバーライドする設定を提供することが推奨されます。例えば、色のコントラストを変更したり、異なるフォーカススタイルを使用したり、ユーザーにとってよりアクセシブルで使いやすい体験を提供するなどです。

推奨されるデフォルトレンダリングをサポートするものとして指定されたユーザーエージェントは、そのように指定されている間、ユーザーエージェントが実装することが期待されると定義されているルールを実装しなければなりません。

スクリプトサポートのないユーザーエージェント

スクリプトをサポートしていない、またはスクリプト機能を完全に無効にしている実装は、この仕様書に記載されているイベントおよびDOMインターフェースをサポートする義務はありません。イベントモデルやDOMに基づいて定義されている部分については、そのようなユーザーエージェントは、イベントやDOMがサポートされているかのように動作しなければなりません。

スクリプトはアプリケーションの不可欠な部分を構成することがあります。スクリプトをサポートしていない、またはスクリプトを無効にしているウェブブラウザは、著者の意図を完全に伝えることができないかもしれません。

適合チェッカー

適合チェッカーは、この仕様書で説明されている適用される適合基準に従って、文書が適合していることを確認しなければなりません。自動適合チェッカーは、著者の意図を解釈する必要があるエラー（例えば、blockquote要素の内容が引用でない場合、文書は適合しないが、人間の判断なしでは適合チェッカーはそれを確認する必要はない）を検出することから免除されます。

適合チェッカーは、ブラウジングコンテキストなしで解析された場合（つまり、スクリプトが実行されず、パーサーのスクリプトフラグが無効になっている）の入力文書が適合していることを確認しなければならず、ブラウジングコンテキストで解析された場合にも文書が適合していることを確認するべきです。そして、スクリプトが一時的にスクリプトの実行中にのみ発生する非適合状態を引き起こさないことを確認するべきです。（これは「SHOULD」であり、「MUST」ではありません。なぜなら、これは不可能であることが証明されているためです。[COMPUTABLE]）

"HTMLバリデーター"という用語は、この仕様書の適用される要件に適合する適合チェッカーを指すために使用することができます。

XML DTDは、この仕様書のすべての適合要件を表現することはできません。したがって、バリデーティングXMLプロセッサーとDTDは適合チェッカーを構成することはできません。また、この仕様書で定義されている2つのオーサリングフォーマットのいずれもSGMLのアプリケーションではないため、バリデーティングSGMLシステムも適合チェッカーを構成することはできません。

言い換えれば、適合基準には3つのタイプがあります：

  1. DTDで表現できる基準。
  2. DTDでは表現できないが、機械によってチェックできる基準。
  3. 人間によってのみチェックできる基準。

適合チェッカーは、最初の2つをチェックしなければなりません。単純なDTDベースのバリデーターは、最初のクラスのエラーのみをチェックするため、この仕様書に従った適合チェッカーとは見なされません。

データマイニングツール

HTMLおよびXML文書をレンダリングや適合チェック以外の目的で処理するアプリケーションやツールは、処理する文書のセマンティクスに従って行動するべきです。

例えば、文書のアウトラインを生成するツールが、各段落のネストレベルを増やし、見出しにはネストレベルを増やさない場合、そのツールは適合していないことになります。

オーサリングツールとマークアップ生成ツール

オーサリングツールとマークアップ生成ツールは、適合文書を生成しなければなりません。著者に適用される適合基準は、適切な場合、オーサリングツールにも適用されます。

オーサリングツールは、要素を指定された目的のみに使用するという厳しい要件からは免除されますが、これはあくまでオーサリングツールが著者の意図を判断できない場合に限ります。しかし、オーサリングツールは、要素を自動的に誤用したり、ユーザーに誤用を奨励したりしてはなりません。

例えば、任意の連絡先情報にaddress要素を使用することは適合していません。この要素は、最も近いarticle要素やbody要素の先祖に対する連絡先情報のマークアップにのみ使用できます。しかし、オーサリングツールがこの違いを判断することはおそらくできないため、オーサリングツールはその要件から免除されます。ただし、これは、オーサリングツールが任意のイタリック体のテキストブロックにaddress要素を使用できることを意味するわけではなく、ユーザーが連絡先情報の挿入ツールを使用している場合に、そのユーザーが実際に連絡先情報を挿入しているかどうかを確認する必要がないだけです。

適合チェックに関して言えば、エディターは、適合チェッカーが検証する範囲で文書が適合していることを確認しなければなりません。

オーサリングツールが非適合文書を編集する場合、編集セッション中に編集されなかった文書のセクションにおいては、適合エラーを保持することができます（つまり、編集ツールは誤った内容をラウンドトリップさせることが許可されています）。ただし、エラーが保持された場合、オーサリングツールは出力が適合していると主張してはなりません。

オーサリングツールは、大まかに言って、構造やセマンティックデータから作業するツールと、見たままのメディア固有の編集に基づいて作業するツール（WYSIWYG）の2種類に分かれることが期待されます。

前者は、HTMLをオーサリングするツールにとって好ましいメカニズムです。なぜなら、ソース情報の構造を使用して、どのHTML要素や属性が最も適切であるかを判断できるからです。

ただし、WYSIWYGツールも正当なものです。WYSIWYGツールは、自分が適切であると知っている要素を使用し、適切であると知らない要素を使用してはなりません。これにより、極端な場合には、div、b、i、spanなど、わずかな要素に限り、フローレイアウト要素の使用が制限され、style属性が多用される可能性があります。

すべてのオーサリングツール、WYSIWYGかどうかにかかわらず、ユーザーがよく構造化され、セマンティックに豊かで、メディアに依存しないコンテンツを作成できるように最善を尽くすべきです。

既存のコンテンツや以前の仕様書との互換性のため、この仕様書では2つのオーサリングフォーマットについて説明しています：1つはXMLに基づいており、もう1つはSGMLに触発されたカスタムフォーマット（HTML構文と呼ばれます）です。実装はこれら2つの形式の少なくとも1つをサポートしなければなりませんが、両方をサポートすることが奨励されています。

いくつかの適合要件は、要素、属性、メソッド、またはオブジェクトに対する要件として表現されています。このような要件は、コンテンツモデルの制約を説明するものと、実装の動作を説明するものに分類されます。前者は文書やオーサリングツールに対する要件であり、後者はユーザーエージェントに対する要件です。同様に、いくつかの適合要件は、著者に対する要件として表現されています。そのような要件は、著者が生成する文書に対する適合要件として解釈されるべきです（つまり、この仕様書は、著者に対する適合基準と文書に対する適合基準を区別していません）。

2.1.9 依存関係

この仕様は、いくつかの他の基本的な仕様に依存しています。

Infra

以下の用語はInfraで定義されています： [INFRA]

Unicodeとエンコーディング

Unicode文字セットはテキストデータを表すために使用され、エンコーディング は文字エンコーディングに関する要件を定義します。 [UNICODE]

この仕様は用語を導入しています それらの仕様で定義された用語に基づいていますが、前述のように説明されています。

以下の用語はエンコーディングで定義されているように使用されます：[ENCODING]

XMLおよび関連仕様

HTMLのXML構文をサポートする実装は、いくつかのバージョンのXMLとその対応する名前空間仕様をサポートする必要があります。なぜなら、その構文は名前空間を持つXMLシリアル化を使用しているからです。[XML] [XMLNS]

データマイニングツールやスクリプトを実行せずにコンテンツを操作する他のユーザーエージェント、CSSやXPath式を評価する、またはそれ以外の方法で結果のDOMを任意のコンテンツに公開する場合、「名前空間をサポート」するには、単にそのDOMノードアナログが特定の名前空間に属していると主張するだけでよく、実際に名前空間文字列を公開する必要はありません。

HTML構文では、名前空間接頭辞や名前空間宣言はXMLでの同様の効果を持たないことに注意してください。たとえば、HTML要素名ではコロンに特別な意味はありません。

名前spaceを持つ属性は、XML名前空間で定義されています。 拡張可能なマークアップ言語（XML）で定義されています。[XML]

Name の生成規則はXMLで定義されています。 [XML]

この仕様はまた、<?xml-stylesheet?> 処理命令に言及しています。これはXML文書にスタイルシートを関連付けるで定義されています。 [XMLSSPI]

この仕様では、XSLTProcessor インターフェースとそのtransformToFragment()およびtransformToDocument()メソッドにも非公式に言及しています。 [XSLTP]

URL

以下の用語はURLで定義されています： [URL]

この仕様では、次のスキームやプロトコルも参照しています：

メディアフラグメント構文はメディアフラグメントURIで定義されています。[MEDIAFRAG]

HTTPおよび関連仕様

以下の用語はHTTP仕様で定義されています： [HTTP]

次の用語はHTTPステートマネジメントメカニズムで定義されています： [COOKIES]

次の用語はWebリンクで定義されています： [WEBLINK]

次の用語はHTTPの構造化フィールド値で定義されています： [STRUCTURED-FIELDS]

次の用語はMIMEスニッフィングで定義されています： [MIMESNIFF]

Fetch

次の用語はFetchで定義されています： [FETCH]

次の用語はリファラーポリシーで定義されています： [REFERRERPOLICY]

次の用語はMixed Contentで定義されています： [MIX]

次の用語はSubresource Integrityで定義されています： [SRI]

ペイントタイミング

以下の用語はペイントタイミングで定義されています：[PAINTTIMING]

ナビゲーションタイミング

以下の用語はナビゲーションタイミングで定義されています：[NAVIGATIONTIMING]

リソースタイミング

以下の用語はリソースタイミングで定義されています：[RESOURCETIMING]

パフォーマンスタイムライン

以下の用語はパフォーマンスタイムラインで定義されています：[PERFORMANCETIMELINE]

ロングアニメーションフレーム

以下の用語はロングアニメーションフレームで定義されています：[LONGANIMATIONFRAMES]

ロングタスク

以下の用語はロングタスクで定義されています：[LONGTASKS]

Web IDL

この仕様書に記載されているIDLフラグメントは、Web IDLで記述された準拠IDLフラグメントとして解釈されなければなりません。[WEBIDL]

以下の用語はWeb IDLで定義されています：

Web IDLはまた、この仕様書のWeb IDLフラグメントで使用されている以下のタイプを定義しています：

この仕様書でスローという用語はWeb IDLで定義されている意味で使用されます。DOMExceptionタイプと、次の例外名はWeb IDLで定義され、この仕様書で使用されています：

この仕様書がユーザーエージェントに、特定の時間を表すDateオブジェクトを作成する（それは特別な値Not-a-Numberである可能性がある）ことを要求する場合、その時間のミリ秒コンポーネントがあれば、それは整数に切り捨てられ、生成された新しいDateオブジェクトの時間値は、切り捨てられた時間を表さなければなりません。

例えば、2000年1月1日00:00:00.023045Zの23045ミリオンズ秒後の時間を考えた場合、作成されたDateオブジェクトは、同じ時間を表すもので、その時間は2000年1月1日00:00:00.023Z、すなわち45ミリオンズ秒前の時間と同じです。指定された時間がNaNである場合、結果は特定の瞬間を表さないDateオブジェクトになります。

JavaScript

この仕様書で記述されている言語の一部は、基盤となるスクリプト言語としてJavaScriptのみをサポートします。[JAVASCRIPT]

「JavaScript」という用語は、ECMA-262ではなく、JavaScriptという用語が広く知られているため、使用されています。

以下の用語はJavaScript仕様書で定義され、この仕様書で使用されています：

JavaScript をサポートするユーザーエージェントは、Dynamic Code Brand Checks 提案も実装しなければなりません。以下の用語はこの提案で定義され、本仕様で使用されています： [JSDYNAMICCODEBRANDCHECKS]

JavaScript をサポートするユーザーエージェントは、ECMAScript Internationalization API も実装しなければなりません。[JSINTL]

JavaScript をサポートするユーザーエージェントは、Temporal 提案も実装しなければなりません。以下の用語はこの提案で定義され、本仕様で使用されています： [JSTEMPORAL]

WebAssembly

以下の用語は WebAssembly JavaScript Interface で定義されています： [WASMJS]

DOM

文書オブジェクトモデル（DOM）は、文書とその内容の表現、つまりモデルです。DOM は API だけではなく、HTML 実装の準拠基準がこの仕様で定義されており、DOM 上の操作に基づいています。[DOM]

実装は DOM と UI Events で定義されたイベントをサポートする必要があります。なぜなら、この仕様は DOM に基づいて定義されており、一部の機能は DOM インターフェースの拡張として定義されているからです。[DOM] [UIEVENTS]

特に、以下の機能が DOM に定義されています：[DOM]

以下の機能は UI Events で定義されています：[UIEVENTS]

以下の機能は Touch Events で定義されています：[TOUCH]

以下の機能は Pointer Events で定義されています：[POINTEREVENTS]

以下のイベントは Clipboard API and events で定義されています：[CLIPBOARD-APIS]

この仕様では、イベントのtypeを指すために name という用語を使用することがあります。たとえば、「click という名前のイベント」や「イベント名が keypress の場合」のように、イベントの「name」と「type」は同義です。

以下の機能は DOM Parsing and Serialization で定義されています：[DOMPARSING]

以下の機能は Selection API で定義されています：[SELECTION]

ユーザーエージェントは、execCommand で説明されている機能を実装することが推奨されます。[EXECCOMMAND]

以下の機能は Fullscreen API で定義されています：[FULLSCREEN]

High Resolution Time は、以下の機能を提供します：[HRT]

ファイルAPI

この仕様は、ファイルAPIで定義されている以下の機能を使用しています： [FILEAPI]

インデックス付きデータベースAPI

以下の用語はIndexed Database APIで定義されています： [INDEXEDDB]

メディアソース拡張

以下の用語はメディアソース拡張で定義されています： [MEDIASOURCE]

メディアキャプチャとストリーム

以下の用語はメディアキャプチャとストリームで定義されています： [MEDIASTREAM]

レポーティング

以下の用語はレポーティングで定義されています： [REPORTING]

XMLHttpRequest

以下の機能と用語はXMLHttpRequestで定義されています： [XHR]

バッテリーステータス

以下の機能はバッテリーステータスAPIで定義されています： [BATTERY]

メディアクエリ

実装にはメディアクエリをサポートする必要があります。<media-condition> 機能はそこに定義されています。[MQ]

CSSモジュール

この仕様の実装にはCSS全体のサポートは必要ありません（ただし、特にウェブブラウザ向けには推奨されます）が、一部の機能は特定のCSS要件に基づいて定義されています。

この仕様が何かを特定のCSS文法に従って解析 する必要があると要求する場合、CSS構文の関連アルゴリズムに従う必要があります。 エラーハンドリングルールを含みます。[CSSSYNTAX]

たとえば、スタイルシートの終わりが予期せず見つかった場合、すべての開いた構造体を閉じるように、ユーザーエージェントは要求されます。このため、 色の値として "rgb(0,0,0"（閉じかっこが不足している）の文字列を解析するとき、このエラーハンドリングルールにより閉じかっこが暗黙的に追加され、色 '黒' が得られます。ただし、類似の構造体 "rgb(0,0,"（閉じかっこと「青」値が不足している）の場合、開いている構造体を閉じても有効な値が得られないため、解析できません。

以下の用語と機能はカスケーディングスタイルシート （CSS）で定義されています：[CSS]

'display'プロパティの基本バージョンはCSSで定義されており、そのプロパティは他のCSSモジュールによって拡張されています。 [CSS] [CSSRUBY] [CSSTABLE]

以下の用語と機能はCSSボックスモデルで定義されています： [CSSBOX]

以下の機能はCSS Logical Propertiesで定義されています： [CSSLOGICAL]

以下の用語と機能はCSS Colorで定義されています： [CSSCOLOR]

以下の用語はCSS Imagesで定義されています： [CSSIMAGES]

ペイントソース という用語はCSS Images Level 4で定義されており、特定のHTML要素とCSSの'element()'関数の 相互作用を定義するために使用されます。 [CSSIMAGES4]

以下の機能はCSS Backgrounds and Bordersで定義されています： [CSSBG]

CSS Backgrounds and Bordersは、次のボーダープロパティも定義しています： [CSSBG]

ボーダープロパティ
上 下 左 右
幅 'border-top-width' 'border-bottom-width' 'border-left-width' 'border-right-width'
スタイル 'border-top-style' 'border-bottom-style' 'border-left-style' 'border-right-style'
色 'border-top-color' 'border-bottom-color' 'border-left-color' 'border-right-color'

以下の機能はCSS Box Alignmentで定義されています： [CSSALIGN]

以下の用語と機能はCSS Displayで定義されています： [CSSDISPLAY]

CSS Flexible Box Layoutで次の機能が定義されています： [CSSFLEXBOX]

CSS Fontsで次の用語と機能が定義されています： [CSSFONTS]

CSS Grid Layoutで次の機能が定義されています： [CSSGRID]

CSS Inline Layoutで次の用語が定義されています： [CSSINLINE]

CSS Box Sizingで次の用語と機能が定義されています： [CSSSIZING]

CSS Lists and Countersで次の機能が定義されています。 [CSSLISTS]

CSS Overflowで次の機能が定義されています。 [CSSOVERFLOW]

CSS Positioned Layoutで次の用語と機能が定義されています： [CSSPOSITION]

CSS Multi-column Layoutで次の機能が定義されています。 [CSSMULTICOL]

'ruby-base' 値はCSS Ruby Layoutで定義されています。 [CSSRUBY]

CSS Tableで次の機能が定義されています： [CSSTABLE]

CSS Textで次の機能が定義されています： [CSSTEXT]

CSS Writing Modesで次の機能が定義されています： [CSSWM]

CSS Basic User Interfaceで次の機能が定義されています： [CSSUI]

アニメーションを更新してイベントを送信するアルゴリズムupdate animations and send eventsはWeb Animationsに定義されています。 [WEBANIMATIONS]

スクリプトをサポートする実装は、CSSオブジェクトモデルをサポートする必要があります。以下の機能と用語はCSSOM仕様で定義されています：[CSSOM] [CSSOMVIEW]

以下の機能と用語はCSS Syntaxで定義されています： [CSSSYNTAX]

以下の用語はSelectorsで定義されています：[SELECTORS]

以下の機能はCSS Values and Unitsで定義されています： [CSSVALUES]

以下の機能はCSS View Transitionsで定義されています： [CSSVIEWTRANSITIONS]

スタイル属性という用語は、CSS Style Attributesで定義されています。[CSSATTR]

以下の用語はCSS Cascading and Inheritanceで定義されています： [CSSCASCADE]

CanvasRenderingContext2D オブジェクトのフォント使用は、CSSFontsおよびFont Loading仕様に記載された機能に依存し、特にFontFaceオブジェクトとフォントソースの概念に依存します。 [CSSFONTS] [CSSFONTLOAD]

以下のインターフェースと用語はGeometry Interfacesで定義されています： [GEOMETRY]

以下の用語はCSS Scopingで定義されています：[CSSSCOPING]

以下の用語と機能はCSS Color Adjustmentで定義されています： [CSSCOLORADJUST]

以下の用語はCSS Pseudo-Elementsで定義されています：[CSSPSEUDO]

以下の用語はCSS Containmentで定義されています：[CSSCONTAIN]

以下の用語はCSS Anchor Positioningで定義されています： [CSSANCHOR]

Intersection Observer

以下の用語はIntersection Observerで定義されています： [INTERSECTIONOBSERVER]

Resize Observer

以下の用語はResize Observerで定義されています： [RESIZEOBSERVER]

WebGL

以下のインターフェースはWebGL仕様で定義されています：[WEBGL]

WebGPU

以下のインターフェースはWebGPUで定義されています：[WEBGPU]

WebVTT

実装は、字幕、キャプション、メタデータなどのテキストトラックフォーマットとしてWebVTTをサポートする場合があります。[WEBVTT]

この仕様で使用されている以下の用語はWebVTTで定義されています：

ARIA

role属性は Accessible Rich Internet Applications (ARIA)で定義されており、以下のロールも同様です：[ARIA]

さらに、以下のaria-*コンテンツ属性はARIAで定義されています：[ARIA]

最後に、以下の用語はARIAで定義されています： [ARIA]

コンテンツセキュリティポリシー

以下の用語はコンテンツセキュリティポリシーで定義されています: [CSP]

サービスワーカー

以下の用語はサービスワーカーで定義されています: [SW]

セキュアコンテキスト

以下のアルゴリズムはセキュアコンテキストで定義されています: [SECURE-CONTEXTS]

パーミッションポリシー

以下の用語はパーミッションポリシーで定義されています: [PERMISSIONSPOLICY]

ペイメントリクエストAPI

以下の機能はペイメントリクエストAPIで定義されています: [PAYMENTREQUEST]

MathML

MathML全体のサポートはこの仕様では必須ではありません（ただし、少なくともウェブブラウザには推奨されています）が、特定の機能はMathMLの一部を実装していることに依存しています。 [MATHML]

以下の機能は数式マークアップ言語 (MathML)で定義されています:

SVG

SVG全体のサポートはこの仕様では必須ではありません（ただし、少なくともウェブブラウザには推奨されています）が、特定の機能はSVGの一部を実装していることに依存しています。

SVGを実装するユーザーエージェントは、SVG 2仕様を実装し、それ以前のリビジョンを実装してはなりません。

以下の機能はSVG 2仕様で定義されています: [SVG]

フィルター効果

以下の機能はフィルター効果で定義されています: [FILTERS]

コンポジット

以下の機能はコンポジットとブレンディングで定義されています: [COMPOSITE]

バックグラウンドタスクの協調スケジューリング

以下の機能はバックグラウンドタスクの協調スケジューリングで定義されています: [REQUESTIDLECALLBACK]

画面の向き

以下の用語は画面の向きで定義されています: [SCREENORIENTATION]

ストレージ

以下の用語はストレージで定義されています: [STORAGE]

ウェブアプリマニフェスト

以下の機能はウェブアプリマニフェストで定義されています: [MANIFEST]

WebAssembly JavaScript インターフェイス: ESM 統合

次の用語は WebAssembly JavaScript インターフェイス: ESM 統合 で定義されています: [WASMESM]

WebCodecs

以下の機能はWebCodecsで定義されています: [WEBCODECS]

WebDriver

以下の用語はWebDriverで定義されています: [WEBDRIVER]

WebDriver BiDi

以下の用語はWebDriver BiDiで定義されています: [WEBDRIVERBIDI]

Web Cryptography API

以下の用語はWeb Cryptography APIで定義されています: [WEBCRYPTO]

WebSockets

以下の用語はWebSocketsで定義されています: [WEBSOCKETS]

WebTransport

以下の用語はWebTransportで定義されています: [WEBTRANSPORT]

公開鍵証明書にアクセスするためのAPIであるウェブ認証

以下の用語は公開鍵証明書にアクセスするためのAPIであるウェブ認証で定義されています: [WEBAUTHN]

資格管理

以下の用語は資格管理で定義されています: [CREDMAN]

コンソール

以下の用語はコンソールで定義されています: [CONSOLE]

ウェブロックAPI

以下の用語はウェブロックAPIで定義されています: [WEBLOCKS]

Trusted Types

この仕様では、Trusted Typesで定義された以下の機能を使用します: [TRUSTED-TYPES]

WebRTC API

以下の用語はWebRTC APIで定義されています： [WEBRTC]

ピクチャーインピクチャー API

以下の用語はピクチャーインピクチャー APIで定義されています： [PICTUREINPICTURE]

アイドル検出 API

以下の用語はアイドル検出 APIで定義されています：

Web Speech API

以下の用語はWeb Speech APIで定義されています：

WebOTP API

以下の用語はWebOTP APIで定義されています：

Web Share API

以下の用語はWeb Share APIで定義されています：

Web Smart Card API

以下の用語はWeb Smart Card APIで定義されています：

Webバックグラウンド同期

以下の用語はWebバックグラウンド同期で定義されています：

Web定期バックグラウンド同期

以下の用語はWeb定期バックグラウンド同期で定義されています：

Webバックグラウンドフェッチ

以下の用語はバックグラウンドフェッチで定義されています：

キーボードロック

以下の用語はキーボードロックで定義されています：

Web MIDI API

以下の用語はWeb MIDI APIで定義されています：

汎用センサーAPI

以下の用語は汎用センサーAPIで定義されています：

WebHID API

以下の用語はWebHID APIで定義されています：

WebXR Device API

以下の用語はWebXR Device APIで定義されています：

この仕様は、特定のネットワークプロトコル、スタイルシート言語、スクリプト言語、または上記リストで要求されている以外のDOM仕様のサポートを必須とはしません。しかし、この仕様で記述されている言語は、スタイリング言語としてCSS、スクリプト言語としてJavaScript、ネットワークプロトコルとしてHTTPに偏っており、いくつかの機能はこれらの言語やプロトコルが使用されていることを前提としています。

HTTPプロトコルを実装するユーザーエージェントは、HTTPステートマネジメントメカニズム（クッキー）も実装しなければなりません。[HTTP] [COOKIES]

この仕様は、各セクションにおいて文字エンコーディング、画像フォーマット、オーディオフォーマット、およびビデオフォーマットに関する追加の要件を持つ可能性があります。

2.1.10 拡張性

ベンダー固有のプロプライエタリなユーザーエージェント拡張は、この仕様に対して強く推奨されません。文書はそのような拡張を使用してはならず、そのような行為は相互運用性を低下させ、ユーザーベースを断片化し、特定のユーザーエージェントのユーザーだけが問題のコンテンツにアクセスできるようにしてしまいます。

すべての拡張は、この仕様で定義された機能に矛盾を生じさせたり、不適合を引き起こしたりしないように定義されなければなりません。

例えば、強く推奨されていないものの、実装がコントロールに新しいIDL属性「typeTime」を追加し、ユーザーが現在の値を選択するのにかかった時間を返す（仮に）ことが考えられます。一方で、フォームのelements配列に新しいコントロールを定義することは、上記の要件に違反します。これは、この仕様で定義されたelementsの定義に違反するからです。

この仕様に対してベンダー中立の拡張が必要な場合は、この仕様を適切に更新するか、またはこの仕様の要件を上書きする拡張仕様を作成することができます。この仕様を適用する人が、その拡張仕様の要件を認識することを決定した場合、その拡張仕様は、この仕様における適合要件の目的で適用可能な仕様となります。

誰かが任意のバイトストリームを適合すると定義する仕様を作成し、その無作為なデータが適合していると主張することは可能です。しかし、それは他の人にとってもその無作為なデータが適合していることを意味するわけではありません。もし誰かがその仕様が自分の作業には適用されないと決定した場合、彼らはその無作為なデータが単なるゴミであり、まったく適合していないと正当に言うことができます。適合に関して重要なのは、その特定のコミュニティが同意するものが適用可能であるということです。

ユーザーエージェントは、理解できない要素や属性を意味的に中立として扱わなければなりません。これらをDOMに残し（DOMプロセッサ向け）、CSSに従ってスタイリングし（CSSプロセッサ向け）、そこから何らかの意味を推測してはなりません。

機能のサポートが無効になった場合（例: セキュリティ問題を緩和するための緊急措置、開発を支援するため、またはパフォーマンスの理由で）、ユーザーエージェントは、その機能が全くサポートされていないかのように行動し、この仕様でその機能が言及されていないかのように扱わなければなりません。例えば、特定の機能がWeb IDLインターフェースの属性を介してアクセスされる場合、その属性自体をそのインターフェースを実装するオブジェクトから除外しなければなりません—オブジェクトに属性を残しておきながら、nullを返すか、例外をスローするのでは不十分です。

2.1.11 XPathおよびXSLTとの相互作用

HTML文書に関するこの仕様で記述されている方法で解析または作成されたXPath 1.0の実装（例えば、document.evaluate() APIの一部として）は、次の編集がXPath 1.0仕様に適用されたかのように動作しなければなりません。

まず、この段落を削除します:

QNameは、ノードテスト内で式コンテキストの名前空間宣言を使用して展開名に展開されます。これは、開始タグと終了タグでの要素型名の展開と同じ方法ですが、xmlnsで宣言されたデフォルト名前空間は使用されません。QNameにプレフィックスがない場合、名前空間URIはnullになります（これは属性名が展開される方法と同じです）。QNameにプレフィックスがあり、式コンテキストに名前空間宣言がない場合、それはエラーです。

次に、次の内容をその場所に挿入します:

ノードテスト内のQNameは、式コンテキストの名前空間宣言を使用して展開名に展開されます。QNameにプレフィックスがある場合、そのプレフィックスに対応する名前空間URIが式コンテキストに存在しなければなりません。そのプレフィックスに対応する名前空間URIがそのプレフィックスに関連付けられたものです。QNameにプレフィックスがあり、式コンテキストに名前空間宣言がない場合、それはエラーです。

QNameにプレフィックスがなく、軸の主要ノード型が要素である場合、デフォルト要素名前空間が使用されます。それ以外の場合、QNameにプレフィックスがない場合、名前空間URIはnullです。デフォルト要素名前空間は、XPath式のコンテキストのメンバーです。DOM3 XPath APIを使用してXPath式を実行する際のデフォルト要素名前空間の値は、次の方法で決定されます:

  1. コンテキストノードがHTML DOMからのものである場合、デフォルト要素名前空間は「http://www.w3.org/1999/xhtml」です。
  2. それ以外の場合、デフォルト要素名前空間URIはnullです。

これは、XPath 2.0のデフォルト要素名前空間機能をXPath 1.0に追加し、HTML文書に対してHTML名前空間をデフォルト要素名前空間として使用することに相当します。この変更は、レガシーHTMLコンテンツとの互換性を保ちながら、この仕様がHTML要素に使用する名前空間に関して導入する変更をサポートするため、およびXPath 2.0ではなくXPath 1.0を使用することを望むことに動機付けられています。

この変更は、XPath 1.0仕様の意図的な違反であり、 実装がレガシーコンテンツと互換性を持ちながら、この仕様がHTML要素に使用される名前空間に関してHTMLに導入する変更をサポートできるようにしたいという要望に基づいています。 [XPATH10]

出力メソッドが「html」である場合（明示的に指定された場合、またはXSLT 1.0のデフォルト規則により）、DOMに出力するXSLT 1.0プロセッサーは次のように影響を受けます:

変換プログラムが名前空間を持たない要素を出力する場合、プロセッサは対応するDOM要素ノードを構築する前に、その要素の名前空間をHTML名前空間に変更し、要素のローカル名をASCII小文字に変換し、要素上の非名前空間属性の名前もASCII小文字に変換しなければなりません。

この要件は、XSLT 1.0仕様の意図的な違反であり、この仕様がHTMLの名前空間と大文字・小文字の区別のルールを、DOMベースのXSLT変換と互換性がなくなるような方法で変更するため、必要となります。（出力をシリアライズするプロセッサは影響を受けません。）[XSLT10]

この仕様は、XSLT処理がHTMLパーサーインフラストラクチャとどのように相互作用するかを正確には指定していません（例えば、XSLTプロセッサーが何らかの要素をオープン要素のスタックに配置するかのように動作するかどうか）。しかし、XSLTプロセッサーは成功した場合には解析を停止し、処理が中止された場合には、まず現在の文書の準備状況を「interactive」に更新し、その後「complete」に更新する必要があります。

この仕様は、XSLTがナビゲーションアルゴリズムとどのように相互作用するか、イベントループとどのように適合するか、またはエラーページがどのように処理されるか（例: XSLTエラーが増分XSLT出力を置き換えるか、インラインでレンダリングされるかなど）を指定していません。

XSLTとHTML、XSLT、XPath、およびHTMLの相互作用に関しては、script要素セクションおよびtemplate要素セクションに非規範的なコメントが追加されています。

2.2 ポリシーで制御される機能

Headers/Permissions-Policy/document-domain

1つのエンジンのみでのサポート。

Firefox🔰 74+SafariいいえChrome🔰 88+
Opera不明Edge🔰 88+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome AndroidいいえWebView Android不明Samsung Internet不明Opera Android不明

この文書では、以下のポリシーで制御される機能を定義しています:

Headers/Feature-Policy/autoplay

Firefox🔰 74+SafariいいえChrome64+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

Headers/Permissions-Policy/autoplay

1つのエンジンのみでのサポート。

Firefox🔰 74+SafariいいえChrome88+
Opera不明Edge88+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

2.3 共通マイクロ構文

HTMLには、日付や数値など、特定のデータ型を受け入れるさまざまな場所があります。このセクションでは、そのようなフォーマットのコンテンツに対する適合基準と、それらを解析する方法について説明します。

実装者は、以下で説明する構文の解析を実装するために使用する可能性のあるサードパーティのライブラリを慎重に検討することを強く推奨します。たとえば、日付ライブラリは、この仕様で要求されるエラーハンドリング動作とは異なる動作を実装する可能性があります。これは、日付構文に関する仕様ではエラーハンドリング動作が定義されていないことが多く、そのため実装によってエラーの処理方法が大きく異なるからです。

2.3.1 共通のパーサー慣用句

以下で説明するいくつかのマイクロパーサーは、解析される文字列を保持するinput変数と、input内で次に解析される文字にポインタを指すposition変数を持つパターンに従います。

2.3.2 ブール属性

多くの属性がブール属性です。要素にブール属性が存在する場合、その値はtrueを表し、属性が存在しない場合はfalseを表します。

属性が存在する場合、その値は空の文字列であるか、属性の正規名に対してASCII大文字小文字を区別しない一致を持つ値でなければなりません。また、その値には前後に空白があってはなりません。

ブール属性には「true」や「false」の値を指定することはできません。false値を表すには、属性を完全に省略する必要があります。

ここにチェックされ、無効化されたチェックボックスの例があります。checked属性とdisabled属性がブール属性です。

<label><input type=checkbox checked name=cheese disabled> Cheese</label>

これは次のように書くこともできます:

<label><input type=checkbox checked=checked name=cheese disabled=disabled> Cheese</label>

また、スタイルを混ぜても、次のようにしても同等です:

<label><input type='checkbox' checked name=cheese disabled=""> Cheese</label>

2.3.3 キーワードと列挙型属性

列挙型属性と呼ばれる属性は、有限の状態を持ちます。このような属性の状態は、属性の値、各属性の仕様に記載されているキーワード/状態のマッピングセット、および属性の仕様に記載されている2つの特別な状態を組み合わせて導き出されます。これらの特別な状態は、無効値デフォルトと欠損値デフォルトです。

複数のキーワードが同じ状態にマップされることがあります。

空の文字列が有効なキーワードである場合があります。欠損値デフォルトは、属性が欠損している場合にのみ適用され、空の文字列が指定されている場合には適用されないことに注意してください。

属性の状態を決定するには、以下の手順を使用します:

  1. 属性が指定されていない場合:

    1. 属性に欠損値デフォルト状態が定義されている場合、その欠損値デフォルト状態を返します。

    2. それ以外の場合、状態を返しません。

  2. 属性の値が、その属性に定義されているキーワードのいずれかとASCII大文字小文字を区別しない一致である場合、そのキーワードで表される状態を返します。

  3. 属性に無効値デフォルト状態が定義されている場合、その無効値デフォルト状態を返します。

  4. 状態を返しません。

著作適合性の目的のために、列挙型属性が指定されている場合、その属性の値は、その属性の適合キーワードのいずれかとASCII大文字小文字を区別しない一致であり、先頭または末尾に空白がないものでなければなりません。

反映の目的のために、キーワードがマップされている状態は正規キーワードを持つと言われます。これは以下のように決定されます:

2.3.4 数字

2.3.4.1 符号付き整数

文字列が1つ以上のASCII数字で構成されており、任意でU+002D HYPHEN-MINUS文字（-）で始まる場合、その文字列は有効な整数です。

U+002D HYPHEN-MINUS（-）プレフィックスがない有効な整数は、その数字列が表す10進数の値を表します。U+002D HYPHEN-MINUS（-）プレフィックスがある有効な整数は、U+002D HYPHEN-MINUSの後に続く数字列が表す10進数の値をゼロから引いた値を表します。

整数を解析するためのルールは、次のアルゴリズムで示されています。このアルゴリズムが呼び出されたときは、指定された順序でステップを実行し、値を返す最初のステップで中止しなければなりません。このアルゴリズムは、整数またはエラーのいずれかを返します。

  1. inputを解析中の文字列とします。

  2. positionをinput内のポインタとし、最初は文字列の先頭を指します。

  3. signには「正」の値を設定します。

  4. ASCII空白文字をスキップし、positionをinput内の次の位置に進めます。

  5. positionがinputの終端を超えている場合、エラーを返します。

  6. positionが指している文字（最初の文字）がU+002D HYPHEN-MINUS文字（-）の場合:

    1. signを「負」に設定します。

    2. positionを次の文字に進めます。

    3. positionがinputの終端を超えている場合、エラーを返します。

    それ以外の場合、positionが指している文字（最初の文字）がU+002B PLUS SIGN文字（+）の場合:

    1. positionを次の文字に進めます。（「+」は無視されますが、適合していません。）

    2. positionがinputの終端を超えている場合、エラーを返します。

  7. positionが指している文字がASCII数字でない場合、エラーを返します。

  8. コードポイントのシーケンスを収集し、positionを基にinputからASCII数字のシーケンスとして解釈します。その結果得られたシーケンスを10進数の整数として解釈し、valueにその整数を設定します。

  9. signが「正」の場合はvalueを返し、それ以外の場合はvalueをゼロから引いた結果を返します。

2.3.4.2 非負の整数

文字列が1つ以上のASCII数字で構成されている場合、その文字列は有効な非負の整数です。

有効な非負の整数は、その数字列が表す10進数の値を表します。

非負の整数を解析するためのルールは、次のアルゴリズムで示されています。このアルゴリズムが呼び出されたときは、指定された順序でステップを実行し、値を返す最初のステップで中止しなければなりません。このアルゴリズムは、ゼロ、正の整数、またはエラーのいずれかを返します。

  1. inputを解析中の文字列とします。

  2. valueを、整数を解析するためのルールを使用してinputを解析した結果とします。

  3. valueがエラーの場合、エラーを返します。

  4. valueがゼロ未満の場合、エラーを返します。

  5. valueを返します。

2.3.4.3 浮動小数点数

文字列が次の条件を満たす場合、それは有効な浮動小数点数です。

  1. オプションとして、U+002D HYPHEN-MINUS文字（-）。

  2. 次のうち一つまたは両方が、この順序で含まれていること：

    1. 1つ以上のASCII数字の並び。

    2. 次の2つが、この順序で含まれていること：

      1. 単一のU+002E FULL STOP文字（.）。

      2. 1つ以上のASCII数字の並び。

  3. オプションとして：

    1. U+0065 LATIN SMALL LETTER E文字（e）またはU+0045 LATIN CAPITAL LETTER E文字（E）。

    2. オプションとして、U+002D HYPHEN-MINUS文字（-）またはU+002B PLUS SIGN文字（+）。

    3. 1つ以上のASCII数字の並び。

有効な浮動小数点数は、シグニフィカンドを10の指数に掛けた数を表します。シグニフィカンドは最初の数であり、それは10進数として解釈され（小数点と小数点後の数字を含む場合があります）、文字列全体がU+002D HYPHEN-MINUS文字（-）で始まり、数値がゼロでない場合はシグニフィカンドを負の数として解釈します。指数はEの後の数であり（Eと数の間にU+002D HYPHEN-MINUS文字（-）があり、数がゼロでない場合は負の数として解釈され、そうでない場合はEと数の間にU+002B PLUS SIGN文字（+）があっても無視されます）。Eがない場合、指数はゼロとして扱われます。

InfinityとNaN（非数）値は、有効な浮動小数点数ではありません。

有効な浮動小数点数の概念は、通常、著者が許可される内容を制限するためにのみ使用され、ユーザーエージェントの要件では浮動小数点数値を解析するためのルールが使用されます（例えば、max属性やprogress要素）。ただし、いくつかのケースでは、ユーザーエージェントの要件には文字列が有効な浮動小数点数であるかどうかのチェックが含まれる場合があります（例えば、値のサニタイズアルゴリズムやsrcset属性を解析するアルゴリズム）。

浮動小数点数としての数nの最良の表現は、ToString(n)を実行して得られる文字列です。抽象操作ToStringは一意に決定されません。特定の値に対して複数の可能な文字列がToStringから得られる場合、ユーザーエージェントは常にその値に対して同じ文字列を返さなければなりません（ただし、他のユーザーエージェントが使用する値と異なる場合があります）。

浮動小数点数値を解析するためのルールは、次のアルゴリズムで示されています。このアルゴリズムは、最初に値を返すステップで中止しなければなりません。このアルゴリズムは、数値またはエラーのいずれかを返します。

  1. inputを解析中の文字列とします。

  2. positionを、inputの開始位置を指すポインタとします。

  3. valueに値1を設定します。

  4. divisorに値1を設定します。

  5. exponentに値1を設定します。

  6. ASCIIの空白をスキップします。

  7. positionがinputの終わりを超えている場合、エラーを返します。

  8. positionが指している文字がU+002D HYPHEN-MINUS文字（-）である場合：

    1. valueとdivisorを-1に変更します。
    2. positionを次の文字に進めます。
    3. positionがinputの終わりを超えている場合、エラーを返します。

    それ以外の場合、positionが指している文字がU+002B PLUS SIGN文字（+）である場合：

    1. positionを次の文字に進めます。（「+」は無視されますが、準拠していません。）
    2. positionがinputの終わりを超えている場合、エラーを返します。

  9. positionが指している文字がU+002E FULL STOP（.）であり、それがinputの最後の文字でなく、その次の文字がASCII数字である場合、valueをゼロに設定し、ステップ「Fraction」に進みます。

  10. positionが指している文字がASCII数字でない場合、エラーを返します。

  11. コードポイントのシーケンスを収集し、それをASCII数字として解釈し、そのシーケンスを10進数として解釈します。valueをその整数で掛けます。

  12. positionがinputの終わりを超えている場合、ステップ「Conversion」に進みます。

  13. Fraction：positionが指している文字がU+002E FULL STOP（.）である場合、次のサブステップを実行します：

    1. positionを次の文字に進めます。
    2. positionがinputの終わりを超えている場合、またはpositionが指している文字がASCII数字、U+0065 LATIN SMALL LETTER E（e）、またはU+0045 LATIN CAPITAL LETTER E（E）でない場合、ステップ「Conversion」に進みます。
    3. positionが指している文字がU+0065 LATIN SMALL LETTER E文字（e）またはU+0045 LATIN CAPITAL LETTER E文字（E）である場合、これ以降のサブステップをスキップします。
    4. Fraction loop：divisorを10倍します。
    5. positionが指している文字を10進数の数字（0..9）として解釈し、それをdivisorで割り、valueに加えます。
    6. positionを次の文字に進めます。
    7. positionがinputの終わりを超えている場合、ステップ「Conversion」に進みます。
    8. positionが指している文字がASCII数字である場合、このサブステップの「Fraction loop」に戻ります。

  14. もしpositionがU+0065 (e)またはU+0045 (E)を指している場合、次のようにします:

    1. positionを次の文字に進めます。

    2. もしpositionがinputの末尾を超えている場合は、conversionとラベル付けされたステップにジャンプします。

    3. もしpositionがU+002D HYPHEN-MINUS文字（-）を指している場合:

      1. exponentを−1に変更します。
      2. positionを次の文字に進めます。

      3. もしpositionがinputの末尾を超えている場合は、conversionとラベル付けされたステップにジャンプします。

      そうでなく、positionがU+002B PLUS SIGN文字（+）を指している場合:

      1. positionを次の文字に進めます。

      2. もしpositionがinputの末尾を超えている場合は、conversionとラベル付けされたステップにジャンプします。

    4. もしpositionがASCII digitでない場合は、conversionとラベル付けされたステップにジャンプします。

    5. コードポイントのシーケンスを収集し、それがASCII digitsである場合、inputからpositionを与えて、その結果のシーケンスを10進数の整数として解釈します。exponentにその整数を掛けます。

    6. valueを10のexponent乗で掛けます。

  15. Conversion：Sを、有限のIEEE 754倍精度浮動小数点値（-0を除く）で構成された集合としますが、特別な値21024と-21024が追加されています。

  16. rounded-valueをSの中でvalueに最も近い数とし、同じくらい近い値が2つある場合は、偶数のシグニフィカンドを持つ数を選びます。（この目的のために、特別な値21024と-21024は偶数のシグニフィカンドを持つと見なされます。）

  17. rounded-valueが21024または-21024である場合、エラーを返します。

  18. rounded-valueを返します。

2.3.4.4 パーセンテージと長さ

寸法値を解析するためのルールは、次のアルゴリズムで示されています。呼び出されたとき、手順は指定された順序で実行され、値を返す最初のステップで中止しなければなりません。このアルゴリズムは、0.0以上の数値または失敗を返します。数値が返される場合、それはさらにパーセンテージまたは長さとして分類されます。

  1. inputを解析中の文字列とします。

  2. positionをinputの開始位置を指す位置変数とします。

  3. ASCIIの空白をスキップします。

  4. positionがinputの終わりを超えているか、positionが指しているコードポイントがASCII数字でない場合、失敗を返します。

  5. コードポイントのシーケンスを収集し、それをASCII数字として解釈し、そのシーケンスを10進数として解釈します。valueをその数値とします。

  6. positionがinputの終わりを超えている場合、valueを長さとして返します。

  7. positionが指しているコードポイントがU+002E（.）である場合、次を実行します：

    1. positionを1だけ進めます。

    2. もしpositionがinputの末尾を超えているか、またはinput内のpositionにあるコードポイントがASCII digitでない場合は、現在の寸法値をvalue、input、およびpositionとともに返します。

    3. divisorの値を1に設定します。

    4. 真の場合:

      1. divisorに10を掛けます。

      2. positionのinput内のコードポイントの値を、10進数の数字（0..9）として解釈し、それをdivisorで割った値をvalueに加えます。

      3. positionを1だけ進めます。

      4. もしpositionがinputの末尾を超えている場合は、valueを長さとして返します。

      5. もしinput内のpositionにあるコードポイントがASCII digitでない場合は、中断します。

  8. 現在の寸法値をvalue、input、positionで返します。

現在の寸法値は、value、input、positionを用いて次のように決定されます：

  1. positionがinputの終わりを超えている場合、valueを長さとして返します。
  2. positionが指しているコードポイントがU+0025（%）である場合、valueをパーセンテージとして返します。
  3. valueを長さとして返します。
2.3.4.5 ゼロでないパーセンテージと長さ

ゼロでない寸法値を解析するためのルールは、次のアルゴリズムで示されています。呼び出されたとき、手順は指定された順序で実行され、値を返す最初のステップで中止しなければなりません。このアルゴリズムは、0.0より大きい数値またはエラーを返します。数値が返される場合、それはさらにパーセンテージまたは長さとして分類されます。

  1. inputを解析中の文字列とします。
  2. valueを、寸法値を解析するためのルールを使用して解析したinputの結果とします。
  3. valueがエラーの場合、エラーを返します。
  4. valueがゼロの場合、エラーを返します。
  5. valueがパーセンテージの場合、valueをパーセンテージとして返します。
  6. valueを長さとして返します。
2.3.4.6 浮動小数点数のリスト

有効な浮動小数点数のリストは、U+002C コンマ文字で区切られた有効な浮動小数点数の集まりであり、それ以外の文字（例えばASCII空白）を含んではいけません。さらに、与えられる浮動小数点数の数や許容される値の範囲に制限があるかもしれません。

浮動小数点数リストを解析するためのルールは次の通りです：

  1. inputを解析している文字列とします。

  2. positionをinput内の文字列の先頭を指すポインタとして設定します。

  3. numbersを空の浮動小数点数のリストとして設定します。このリストがこのアルゴリズムの結果となります。

  4. コードポイントのシーケンスを収集し、それがASCIIホワイトスペース、U+002C コンマ、または U+003B セミコロン文字である場合、inputからpositionを指定して収集します。これにより、先頭の区切り文字をスキップします。

  5. positionがinputの終わりを過ぎていない限り：

    1. コードポイントのシーケンスを収集し、それがASCIIホワイトスペース、U+002C コンマ、U+003B セミコロン、ASCII数字、U+002E ピリオド、または U+002D ハイフンマイナス文字でない場合、inputからpositionを指定して収集します。これにより、先頭のゴミをスキップします。

    2. コードポイントのシーケンスを収集し、それがASCIIホワイトスペース、U+002C コンマ、または U+003B セミコロン文字でない場合、inputからpositionを指定して収集し、unparsed numberに結果を設定します。

    3. numberをunparsed numberを使用して解析した結果とします。解析ルールは浮動小数点数値の解析ルールに従います。

    4. numberがエラーの場合、numberをゼロに設定します。

    5. numberをnumbersに追加します。

    6. コードポイントのシーケンスを収集し、それがASCIIホワイトスペース、U+002C コンマ、または U+003B セミコロン文字である場合、inputからpositionを指定して収集します。これにより、区切り文字をスキップします。

  6. numbersを返します。

2.3.4.7 次元のリスト

次元のリストを解析するためのルールは次の通りです。これらのルールは、パーセンテージ、相対的、絶対的のいずれかの単位を持つ、0個以上の数値と単位のペアのリストを返します。

  1. raw inputを解析する文字列とします。

  2. raw inputの最後の文字がU+002C コンマ文字（,）であれば、その文字をraw inputから削除します。

  3. 文字列raw inputをコンマで分割します。結果のトークンのリストをraw tokensとします。

  4. resultを空の数値/単位ペアのリストとします。

  5. 各トークンがraw tokensにある間、以下のサブステップを実行します：

    1. inputをトークンとします。

    2. positionをinputへのポインタとし、初期状態では文字列の開始位置を指します。

    3. valueを数値0とします。

    4. unitをabsoluteとします。

    5. positionがinputの終端を超えている場合、unitをrelativeに設定し、最後のサブステップにジャンプします。

    6. positionの文字がASCII数字であれば、コードポイントのシーケンスを収集し、それがASCII数字からinputのpositionを指定して得られた場合、その結果のシーケンスを10進数の整数として解釈し、その整数でvalueを増加させます。

    7. positionの文字がU+002E（.）の場合：

      1. コードポイントのシーケンスを収集し、それがASCIIホワイトスペースとASCII数字である場合、inputのpositionを指定して収集し、sにその結果のシーケンスを設定します。

      2. sからすべてのASCIIホワイトスペースを削除します。

      3. sが空文字列でない場合、次を行います：

        1. sの文字数をlengthとします（スペースが削除された後）。

        2. fractionをsを10進整数として解釈し、その数を10lengthで割った結果とします。

        3. valueをfractionで増加させます。

    8. ASCIIホワイトスペースをスキップします。inputのpositionを指定して行います。

    9. positionの文字がU+0025 パーセント記号（%）の場合、unitをpercentageに設定します。

      それ以外の場合、positionの文字がU+002A アスタリスク（*）の場合、unitをrelativeに設定します。

    10. valueによって示される数値とunitによって示される単位のペアをresultに追加します。

  6. リストresultを返します。

2.3.5 日付と時刻

以下のアルゴリズムでは、月month、年yearの月の日数は次のようになります：monthが1、3、5、7、8、10、12の場合は31日、monthが4、6、9、11の場合は30日、monthが2でyearが400で割り切れるか、4で割り切れるが100で割り切れない場合は29日、その他の場合は28日です。これはグレゴリオ暦の閏年を考慮しています。[GREGORIAN]

このセクションで定義されている日付と時刻の構文で使用されるASCII数字は、10進数を表します。

ここで説明する形式は対応するISO8601形式のサブセットを意図していますが、この仕様はISO8601よりもはるかに詳細な解析ルールを定義しています。したがって、実装者は以下に記述された解析ルールを実装する際に使用する日付解析ライブラリを慎重に検討することをお勧めします。ISO8601ライブラリは、日付や時刻を完全に同じ方法で解析しない場合があります。[ISO8601]

この仕様がプロレプティックグレゴリオ暦に言及する場合、それは現代のグレゴリオ暦を意味し、年1までさかのぼって外挿されます。プロレプティックグレゴリオ暦の日付、時にはプロレプティックグレゴリオ日付として明示的に言及されることもありますが、それはそのカレンダーが使用されていなかった時点(または場所)でもそのカレンダーを使用して記述されるものです。[GREGORIAN]

この仕様でグレゴリオ暦をワイヤフォーマットとして使用するのは、決定に関与した者の文化的偏見の結果としての任意の選択です。著者向けのセクションで日付、時刻、数字の形式、およびフォームコントロールのローカライズに関する実装ノートも参照してください。また、time要素も参照してください。

2.3.5.1 月

月は、年と月以外の日付情報およびタイムゾーン情報を持たない特定のプロレプティックグレゴリオ日付で構成されます。[GREGORIAN]

文字列が、次の順序で構成される場合、その文字列は年yearと月monthを表す有効な月文字列です：

  1. 4桁以上のASCII数字、yearを表し、year > 0
  2. U+002D ハイフンマイナス文字(-)
  3. 2桁のASCII数字、monthを表し、1 ≤ month ≤ 12

月文字列を解析するためのルールは次のとおりです。これにより、年と月が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. inputを解析中の文字列とします。
  2. positionをinput内のポインタとし、文字列の先頭を指すように初期化します。
  3. 月コンポーネントを解析して、yearとmonthを取得します。これが何も返さない場合、失敗します。
  4. もしpositionがinputの終わりを超えていない場合、失敗します。
  5. yearとmonthを返します。

input文字列とpositionを与えられた場合の月コンポーネントを解析するためのルールは次のとおりです。これにより、年と月が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが少なくとも4文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 year をその数値とします。

  2. year がゼロより大きい数値でない場合は、失敗します。

  3. position が input の末尾を超えている場合、または position の文字が U+002D HYPHEN-MINUS 文字でない場合は、失敗します。 それ以外の場合は、position を1文字進めます。

  4. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 month をその数値とします。

  5. month が 1 ≤ month ≤ 12 の範囲の数値でない場合は、失敗します。

  6. year と month を返します。

2.3.5.2 日付

日付は、年、月、日で構成され、タイムゾーン情報を含まない特定のプロレプティックグレゴリオ日付で構成されます。[GREGORIAN]

文字列が、次の順序で構成される場合、その文字列は年year、月month、日dayを表す有効な日付文字列です:

  1. 有効な月文字列、yearおよびmonthを表す
  2. U+002D ハイフンマイナス文字(-)
  3. 2桁のASCII数字、dayを表し、範囲は1 ≤ day ≤ maxdayであり、maxdayは月monthおよび年yearの日数です。

日付文字列を解析するためのルールは次のとおりです。これにより、日付が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. inputを解析中の文字列とします。
  2. positionをinput内のポインタとし、文字列の先頭を指すように初期化します。
  3. 日付コンポーネントを解析して、year、month、およびdayを取得します。これが何も返さない場合、失敗します。
  4. もしpositionがinputの終わりを超えていない場合、失敗します。
  5. dateをyear、month、dayの年、月、日で構成される日付とします。
  6. dateを返します。

input文字列とpositionを与えられた場合の日付コンポーネントを解析するためのルールは次のとおりです。これにより、年、月、日が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. 月コンポーネントを解析して、yearとmonthを取得します。これが何も返さない場合、失敗します。
  2. maxdayを月monthおよび年yearの日数とします。
  3. もしpositionがinputの終わりを超えているか、positionの位置にある文字がU+002D ハイフンマイナス文字でない場合、失敗します。そうでない場合、positionを1文字進めます。

  4. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 day をその数値とします。

  5. dayが1 ≤ day ≤ maxdayの範囲にない場合、失敗します。
  6. year、month、およびdayを返します。
2.3.5.3 年なし日付

年なし日付は、グレゴリオ暦の月とその月内の日で構成されますが、年は関連付けられていません。[GREGORIAN]

文字列が、次の順序で構成される場合、その文字列は月monthと日dayを表す有効な年なし日付文字列です:

  1. 任意で、2つのU+002D ハイフンマイナス文字(-)
  2. 2つのASCII数字、monthを表し、範囲は1 ≤ month ≤ 12
  3. U+002D ハイフンマイナス文字(-)
  4. 2つのASCII数字、dayを表し、範囲は1 ≤ day ≤ maxday、ここでmaxdayは任意の閏年の月monthの日数です（例えば、4年や2000年など）

言い換えれば、monthが「02」である場合、2月を意味し、その日が29日であっても、閏年であったかのように解釈されます。

年なし日付文字列を解析するためのルールは次のとおりです。これにより、月と日が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. inputを解析中の文字列とします。
  2. positionをinput内のポインタとし、文字列の先頭を指すように初期化します。
  3. 年なし日付コンポーネントを解析して、monthとdayを取得します。これが何も返さない場合、失敗します。
  4. もしpositionがinputの終わりを超えていない場合、失敗します。
  5. monthとdayを返します。

input文字列とpositionを与えられた場合の年なし日付コンポーネントを解析するためのルールは次のとおりです。これにより、月と日が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. 一連のコードポイントを収集し、それがU+002D ハイフンマイナス文字であるとして収集します。収集されたシーケンスが正確にゼロまたは2文字でない場合、失敗します。

  2. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 month をその数値とします。

  3. monthが1 ≤ month ≤ 12の範囲にない場合、失敗します。
  4. maxdayを任意の閏年の月monthの日数とします。
  5. もしpositionがinputの終わりを超えているか、positionの位置にある文字がU+002D ハイフンマイナス文字でない場合、失敗します。そうでない場合、positionを1文字進めます。

  6. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 day をその数値とします。

  7. dayが1 ≤ day ≤ maxdayの範囲にない場合、失敗します。
  8. monthとdayを返します。
2.3.5.4 時間

時間 は、時刻情報がなく、時間、分、秒、および秒の小数部分で構成されます。

文字列が次のコンポーネントを指定された順序で含む場合、それは時hour、分minute、秒secondを表す有効な時間文字列です：

  1. 2つのASCII数字、hourを表し、範囲は 0 ≤ hour ≤ 23
  2. U+003A コロン文字（:）
  3. 2つのASCII数字、minuteを表し、範囲は 0 ≤ minute ≤ 59
  4. secondがゼロでない場合、またはオプションでsecondがゼロの場合：
    1. U+003A コロン文字（:）
    2. 2つのASCII数字、secondの整数部分を表し、 範囲は0 ≤ s ≤ 59
    3. secondが整数でない場合、またはオプションでsecondが整数の場合：
      1. U+002E ピリオド文字（.）
      2. 1、2、または3のASCII数字、secondの小数部分を表します

secondコンポーネントは60または61にすることはできません。リープセコンドは表現できません。

時間文字列を解析するためのルールは次のとおりです。これにより、時間が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. inputを解析中の文字列とします。
  2. positionをinput内のポインタとし、文字列の先頭を指すように初期化します。
  3. 時間コンポーネントを解析して、hour、minute、およびsecondを取得します。これが何も返さない場合、失敗します。
  4. もしpositionがinputの終わりを超えていない場合、失敗します。
  5. timeをhour、minute、およびsecondの時間とします。
  6. timeを返します。

時間コンポーネントを解析するためのルールは次のとおりです。input文字列とpositionを与えられた場合、これにより、時間、分、秒が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 hour をその数値とします。

  2. hourが範囲0 ≤ hour ≤ 23の数値でない場合は失敗します。

  3. positionがinputの終わりを超えているか、またはpositionの文字がU+003A コロン文字（:）でない場合は失敗します。それ以外の場合は、positionを1文字進めます。

  4. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 minute をその数値とします。

  5. minuteが範囲0 ≤ minute ≤ 59の数値でない場合は失敗します。

  6. secondを0に設定します。

  7. positionがinputの終わりを超えておらず、かつpositionの文字がU+003A（:）の場合、次のようにします：

    1. positionをinputの次の文字に進めます。

    2. positionがinputの終わりを超えている、またはinputの最後の文字である、またはpositionで始まる次の2文字が両方ともASCII 数字でない場合は失敗します。

    3. コードポイントのシーケンスを収集し、それがASCII 数字またはU+002E ピリオド文字（.）であることを確認します。inputからpositionを基に収集します。収集したシーケンスが3文字である場合、または3文字を超えており3文字目がU+002E ピリオド文字でない場合、またはU+002E ピリオド文字が1つ以上含まれている場合は失敗します。それ以外の場合は、得られたシーケンスを10進数として解釈し（小数部分があるかもしれません）、その数値をsecondに設定します。

    4. secondが範囲0 ≤ second  < 60の数値でない場合は失敗します。

  8. hour、minute、およびsecondを返します。

2.3.5.5 ローカルな日付と時刻

ローカルな日付と時刻は、特定のプロレプティックグレゴリオ暦日付（年、月、および日）と、タイムゾーンを含まない時間（時、分、秒、および秒の小数部）から構成されます。[GREGORIAN]

文字列が以下の順序で構成される場合、その文字列は日付と時刻を表す有効なローカルな日付と時刻の文字列です:

  1. 有効な日付文字列、日付を表す
  2. U+0054 ラテン大文字 T (T) 文字または U+0020 スペース文字
  3. 有効な時間文字列、時刻を表す

文字列が以下の順序で構成される場合、その文字列は日付と時刻を表す有効な正規化されたローカルな日付と時刻の文字列です:

  1. 有効な日付文字列、日付を表す
  2. U+0054 ラテン大文字 T 文字
  3. 有効な時間文字列、時刻を表すが、可能な限り短い文字列として表現される（例えば、与えられた時刻がその分の0秒である場合は秒のコンポーネントを完全に省略する）

ローカルな日付と時刻の文字列を解析するためのルールは次のとおりです。これにより、日付と時刻が返されるか、何も返されません。アルゴリズムが「失敗する」と言った場合、それはその時点で中止され、何も返されないことを意味します。

  1. inputを解析中の文字列とします。
  2. positionをinput内のポインタとし、文字列の先頭を指すように初期化します。
  3. 日付コンポーネントを解析して、year、month、およびdayを取得します。これが何も返さない場合、失敗します。
  4. もしpositionがinputの終わりを超えているか、positionにある文字がU+0054 ラテン大文字 T 文字または U+0020 スペース文字のいずれでもない場合、失敗します。そうでない場合、positionを1文字進めます。
  5. 時間コンポーネントを解析して、hour、minute、およびsecondを取得します。これが何も返さない場合、失敗します。
  6. もしpositionがinputの終わりを超えていない場合、失敗します。
  7. dateをyear、month、およびdayの日付とします。
  8. timeをhour、minute、およびsecondの時刻とします。
  9. dateとtimeを返します。
2.3.5.6 タイムゾーン

タイムゾーンオフセットは、符号付きの時間と分の数値から成ります。

文字列がタイムゾーンオフセットを表す有効なタイムゾーンオフセット文字列であるためには、次のいずれかでなければなりません：

この形式では、タイムゾーンオフセットは -23:59 から +23:59 まで対応しています。現在実際に使用されているタイムゾーンのオフセット範囲は -12:00 から +14:00 までであり、実際のタイムゾーンの分コンポーネントは常に 00、30、または 45 です。ただし、タイムゾーンは政治的な問題として扱われるため、将来的に変更される可能性があります。

詳細については、以下のグローバル日付と時刻 セクションの使用ノートと例を参照してください。

タイムゾーンオフセット文字列を解析する ためのルールは次の通りです。これにより、タイムゾーンオフセットが返されるか、何も返されません。アルゴリズムが「失敗」と言った場合は、その時点で中止され、何も返されません。

  1. input を解析中の文字列とします。

  2. position を input へのポインタとして、文字列の先頭を指すようにします。

  3. タイムゾーンオフセットコンポーネントを解析して timezonehours と timezoneminutes を取得します。これが何も返さなかった場合は失敗します。

  4. もし position が input の終わりを越えていない場合、失敗します。

  5. UTC から timezonehours 時間および timezoneminutes 分のタイムゾーンオフセットを返します。

タイムゾーンオフセットコンポーネントを解析する ためのルールは次の通りです。これはタイムゾーンの時間とタイムゾーンの分を返すか、何も返しません。アルゴリズムが「失敗」と言った場合は、その時点で中止され、何も返されません。

  1. もし position にある文字が U+005A ラテン大文字 Z 文字 (Z) の場合：

    1. timezonehours を 0 とします。

    2. timezoneminutes を 0 とします。

    3. position を次の文字に進めます。

    そうでない場合、もし position にある文字が U+002B プラス記号 (+) または U+002D ハイフン記号 (-) の場合：

    1. もし position にある文字が U+002B プラス記号 (+) の場合、sign を "positive" とします。そうでなければ、U+002D ハイフン記号 (-) であり、sign を "negative" とします。

    2. position を次の文字に進めます。

    3. コードポイントのシーケンスを収集する ASCII 数字 を収集します。s を収集したシーケンスとします。

    4. s が正確に二文字の場合：

      1. s を10進数の整数として解釈します。timezonehours をその数値とします。

      2. position が input の末尾を超えている場合、または position の文字が U+003A COLON 文字でない場合は、失敗します。 それ以外の場合は、position を1文字進めます。

      3. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 timezoneminutes をその数値とします。

      s が正確に四文字の場合：

      1. s の最初の2文字を10進数の整数として解釈します。timezonehours をその数値とします。

      2. s の最後の2文字を10進数の整数として解釈します。timezoneminutes をその数値とします。

      そうでなければ、失敗します。

    5. timezonehours が範囲 0 ≤ timezonehours ≤ 23 の数値でない場合、失敗します。

    6. sign が "negative" の場合、timezonehours を反転させます。

    7. timezoneminutes が範囲 0 ≤ timezoneminutes ≤ 59 の数値でない場合、失敗します。

    8. sign が "negative" の場合、timezoneminutes を反転させます。

    そうでなければ、失敗します。

  2. timezonehours と timezoneminutes を返します。

2.3.5.7 グローバル日付と時刻

グローバル日付と時刻 は、特定の先験的グレゴリオ暦の日付（年、月、日を含む）と、時間（時、分、秒、秒の小数部分を含む）、そして時差を表すサイン付きの時間と分からなる。

文字列が次の要素で構成されている場合、それは日付、時刻、および時差を表す有効なグローバル日付と時刻の文字列です：

  1. 有効な日付文字列、日付を表す
  2. U+0054 ラテン大文字 T 文字 (T) または U+0020 スペース文字
  3. 有効な時刻文字列、時刻を表す
  4. 有効な時差文字列、時差を表す

UTCの形成前の時刻は、UT1（0°経度での地球太陽時間）で表現され解釈されなければならず、UTC（SI秒で刻まれるUT1の近似値）ではありません。タイムゾーンの形成前の時刻は、UT1時刻として明示的なタイムゾーンとともに、グリニッジ、ロンドンで観測された時刻との差を近似した形で表現し解釈されなければなりません。

次は、有効なグローバル日付と時刻の文字列として書かれた日付の例です。

"0037-12-13 00:00Z"
ローマ皇帝ネロの誕生日（ロンドン時間を使用する地域で）。この実際の日付に関するさらなる議論は以下を参照してください。
"1979-10-14T12:00:00.001-04:00"
1979年10月14日の正午1ミリ秒後、米国東海岸の夏時間で使用されていたタイムゾーン。
"8592-01-01T02:09+02:09"
8592年1月1日のUTC真夜中。この時刻に関連付けられるタイムゾーンはUTCの2時間9分先で、現在は実際のタイムゾーンではありませんが、許可されています。

これらの日付について注目すべき点は次のとおりです：

グローバル日付と時刻の文字列を解析する ルールは次のとおりです。これにより、UTCの時刻と、ラウンドトリップまたは表示目的のための関連する時差情報が返されるか、何も返されません。アルゴリズムが「失敗した」と言った場合、その時点で中止され、何も返されません。

  1. input を解析する文字列とします。

  2. position を input 内のポインタとし、初期状態で文字列の開始位置を指します。

  3. 日付コンポーネントを解析する ことで、year、month、および day を取得します。これが何も返さない場合は、失敗します。

  4. position が input の末尾を超えているか、position の文字が U+0054 ラテン大文字 T 文字 (T) または U+0020 スペース文字でない場合は、失敗します。それ以外の場合、position を1文字進めます。

  5. 時刻コンポーネントを解析する ことで、hour、minute、および second を取得します。これが何も返さない場合は、失敗します。

  6. position が input の末尾を超えている場合は、失敗します。

  7. 時差コンポーネントを解析する ことで、timezonehours と timezoneminutes を取得します。これが何も返さない場合は、失敗します。

  8. position が input の末尾を超えていない場合は、失敗します。

  9. time を、year 年、month 月、day 日、hour 時、minute 分、second 秒の時刻から、timezonehours 時間と timezoneminutes 分を引いた瞬間とします。その瞬間はUTCタイムゾーンでの瞬間です。

  10. timezone を timezonehours 時間と timezoneminutes 分のUTCからの偏差とします。

  11. time と timezone を返します。

2.3.5.8 週

週 とは、週番号と、月曜日から始まる7日間の期間を表す週番号で構成されます。このカレンダーシステムでは、各週年には以下に定義されたように52または53のそのような7日間の期間があります。1969年12月29日（1969-12-29）のグレゴリオ暦の日付で始まる7日間の期間は、1970年の週年で週番号1として定義されます。連続する週は順番に番号付けされます。週年内の番号1の週の前の週は、前の週年の最後の週であり、その逆も同様です。 [GREGORIAN]

週年番号がyearの週年が53週間を持つ場合、それは以下のいずれかに対応します： 先験的グレゴリオ暦のyear年の最初の日（1月1日）が木曜日であるか、またはyear年の先験的グレゴリオ暦の最初の日（1月1日）が水曜日であり、かつyearが400で割り切れるか、または100で割り切れない4で割り切れる数である場合。その他の週年は52週間です。

53週間の週年の最終日の週番号は53であり、52週間の週年の最終日の週番号は52です。

特定の日の週年番号は、その日を含む年の番号と異なる場合があります。このHTMLのバージョンでは、週年yの最初の週は、グレゴリオ暦の年yの最初の木曜日を含む週です。

現代の目的では、ここで定義された週は、ISO 8601で定義されたISO週と同等です。 [ISO8601]

文字列が週年yearと週weekを表す有効な週文字列であるためには、次のコンポーネントで構成されている必要があります：

  1. 4桁以上のASCII数字、yearを表すもので、year > 0
  2. U+002D ハイフン (-) 文字
  3. U+0057 ラテン大文字 W 文字 (W)
  4. 2桁のASCII数字、週weekを表すもので、範囲1 ≤ week ≤ maxweek、ここでmaxweekは週年yearの最終日の週番号

週文字列を解析するルールは次のとおりです。これにより、週年番号と週番号が返されるか、何も返されません。アルゴリズムが「失敗した」と言った場合、その時点で中止され、何も返されません。

  1. input を解析する文字列とします。

  2. position を input 内のポインタとし、初期状態で文字列の開始位置を指します。

  3. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが少なくとも4文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 year をその数値とします。

  4. もしyearがゼロより大きい数でない場合、失敗します。

  5. positionがinputの末尾を超えているか、positionの文字がU+002D ハイフン (-) 文字でない場合、失敗します。そうでなければ、positionを1文字進めます。

  6. positionがinputの末尾を超えているか、positionの文字がU+0057 ラテン大文字 W 文字 (W) でない場合、失敗します。そうでなければ、positionを1文字進めます。

  7. position を指定して input から ASCII 数字であるコードポイントのシーケンスを収集します。収集されたシーケンスが正確に2文字長でない場合は、失敗します。それ以外の場合は、結果のシーケンスを10進数の整数として解釈します。 week をその数値とします。

  8. maxweekを年yearの最終日の週番号とします。

  9. もしweekが範囲1 ≤ week ≤ maxweekの数でない場合、失敗します。

  10. positionがnot inputの末尾を超えていない場合、失敗します。

  11. 週年番号yearと週番号weekを返します。

2.3.5.9 デュレーション

デュレーションは、秒数の数で構成されます。

月と秒は比較できません（1か月は正確な秒数ではなく、その長さは起算日によって異なるため）、この仕様で定義されたデュレーションには月（または12か月に相当する年）を含むことはできません。特定の秒数を示すデュレーションのみが説明できます。

文字列がデュレーション tを表す有効なデュレーション文字列である場合、それが以下のいずれかで構成されている必要があります：

期間文字列を解析するルールは以下の通りです。これにより、期間が返されるか、何も返されません。アルゴリズムが「失敗」と言った場合、その時点で中止され、何も返されないことを意味します。

  1. inputを解析する文字列とします。

  2. positionをinput内のポインタとし、最初は文字列の先頭を指します。

  3. months、seconds、およびcomponent countをすべてゼロに設定します。

  4. M-disambiguatorをminutesに設定します。

    このフラグのもう一つの値はmonthsです。これはISO8601の期間において「M」単位を区別するために使用されます。この単位は月と分の両方を表します。月は許可されていませんが、将来的な互換性のため、または他のコンテキストで有効であるISO8601の期間を誤解しないように解析されます。

  5. ASCII空白文字をスキップして、positionが指す位置のinput内を確認します。

  6. positionがinputの終端を過ぎている場合、失敗します。

  7. positionが指すinput内の文字がU+0050 LATIN CAPITAL LETTER Pである場合、positionを次の文字に進め、M-disambiguatorをmonthsに設定し、ASCII空白文字をスキップしてpositionが指す位置のinput内を確認します。

  8. ループ開始:

    1. unitsを未定義にします。これは次のいずれかの値に設定されます: years、months、weeks、days、hours、minutes、およびseconds。

    2. next characterを未定義にします。これはinputから文字を処理するために使用されます。

    3. positionがinputの終端を過ぎている場合、ループを終了します。

    4. positionが指すinput内の文字がU+0054 LATIN CAPITAL LETTER Tである場合、positionを次の文字に進め、M-disambiguatorをminutesに設定し、ASCII空白文字をスキップしてpositionが指す位置のinput内を確認し、処理を続行します。

    5. next characterをpositionが指すinput内の文字に設定します。

    6. next characterがU+002E FULL STOP (.)である場合、Nをゼロに設定します。(positionを進めないでください。それは後で処理されます。)

      そうでない場合、next characterがASCII数字である場合、コードポイントのシーケンスを収集し、positionが指す位置のinputからそれらを収集し、その結果のシーケンスを10進数の整数として解釈し、Nにその数値を設定します。

      それ以外の場合、next characterが数字の一部ではない場合、失敗します。

    7. positionがinputの終端を過ぎている場合、失敗します。

    8. next characterをpositionが指すinput内の文字に設定し、今回はpositionを次の文字に進めます。(以前next characterがU+002E FULL STOP (.)だった場合、今回もその文字のままです。)

    9. next characterがU+002E (.)である場合、次のようにします:

      1. コードポイントのシーケンスを収集し、positionが指す位置のinputからそれらを収集します。sを結果のシーケンスに設定します。

      2. sが空文字列の場合、失敗します。

      3. lengthをsの文字数に設定します。

      4. fractionをsを10進数の整数として解釈した結果とし、その数値を10lengthで割ります。

      5. Nをfractionで増加させます。

      6. ASCII空白文字をスキップして、positionが指す位置のinput内を確認します。

      7. positionがinputの終端を過ぎている場合、失敗します。

      8. next characterをpositionが指すinput内の文字に設定し、positionを次の文字に進めます。

      9. next characterがU+0053 LATIN CAPITAL LETTER SまたはU+0073 LATIN SMALL LETTER Sのどちらでもない場合、失敗します。

      10. unitsをsecondsに設定します。

      それ以外の場合:

      1. next characterがASCII空白文字である場合、ASCII空白文字をスキップしてpositionが指す位置のinput内を確認し、next characterをpositionが指すinput内の文字に設定し、positionを次の文字に進めます。

      2. next characterがU+0059 LATIN CAPITAL LETTER YまたはU+0079 LATIN SMALL LETTER Yである場合、unitsをyearsに設定し、M-disambiguatorをmonthsに設定します。

        next characterがU+004D LATIN CAPITAL LETTER MまたはU+006D LATIN SMALL LETTER Mであり、M-disambiguatorがmonthsである場合、unitsをmonthsに設定します。

        next characterがU+0057 LATIN CAPITAL LETTER WまたはU+0077 LATIN SMALL LETTER Wである場合、unitsをweeksに設定し、M-disambiguatorをminutesに設定します。

        next characterがU+0044 LATIN CAPITAL LETTER DまたはU+0064 LATIN SMALL LETTER Dである場合、unitsをdaysに設定し、M-disambiguatorをminutesに設定します。

        next characterがU+0048 LATIN CAPITAL LETTER HまたはU+0068 LATIN SMALL LETTER Hである場合、unitsをhoursに設定し、M-disambiguatorをminutesに設定します。

        next characterがU+004D LATIN CAPITAL LETTER MまたはU+006D LATIN SMALL LETTER Mであり、M-disambiguatorがminutesである場合、unitsをminutesに設定します。

        next characterがU+0053 LATIN CAPITAL LETTER SまたはU+0073 LATIN SMALL LETTER Sである場合、unitsをsecondsに設定し、M-disambiguatorをminutesに設定します。

        それ以外の場合、next characterが上記のいずれでもない場合、失敗します。

    10. component countをインクリメントします。

    11. multiplierを1に設定します。

    12. unitsがyearsである場合、multiplierに12を掛け、unitsをmonthsに設定します。

    13. unitsがmonthsである場合、Nとmultiplierの積をmonthsに加えます。

      それ以外の場合:

      1. unitsがweeksである場合、multiplierに7を掛け、unitsをdaysに設定します。

      2. unitsがdaysである場合、multiplierに24を掛け、unitsをhoursに設定します。

      3. unitsがhoursである場合、multiplierに60を掛け、unitsをminutesに設定します。

      4. unitsがminutesである場合、multiplierに60を掛け、unitsをsecondsに設定します。

      5. 強制的に、unitsはsecondsに設定されます。Nとmultiplierの積をsecondsに加えます。

    14. ASCII空白文字をスキップして、positionが指す位置のinput内を確認します。

  9. component countがゼロの場合、失敗します。

  10. monthsがゼロでない場合、失敗します。

  11. seconds秒で構成された期間を返します。

2.3.5.10 より曖昧な時間の瞬間

文字列が任意の時間を含む有効な日付文字列であるためには、それが次のいずれかである必要があります。

日付または時間の文字列を解析するためのルールは以下の通りです。アルゴリズムは日付、時間、世界日付および時間、もしくは何も返しません。アルゴリズムが「失敗する」と述べた場合、それはその時点で中止され、何も返されないことを意味します。

  1. input を解析中の文字列とします。

  2. position を input 内のポインタとし、初期状態では文字列の開始位置を指します。

  3. position と同じ位置に start position を設定します。

  4. date present フラグと time present フラグを true に設定します。

  5. 日付コンポーネントを解析する ことで year、month、day を取得します。これが失敗した場合、date present フラグを false に設定します。

  6. もし date present が true であり、position が input の終端を超えていない場合、および position の文字が U+0054 ラテン大文字 T 文字（T）または U+0020 スペース文字である場合、position を input 内の次の文字に進めます。

    それ以外の場合、もし date present が true であり、かつ position が input の終端を超えているか、または position の文字が U+0054 ラテン大文字 T 文字でも U+0020 スペース文字でもない場合、time present フラグを false に設定します。

    それ以外の場合、もし date present が false であれば、position を start position と同じ位置に戻します。

  7. もし time present フラグが true であれば、時間コンポーネントを解析する ことで hour、minute、second を取得します。これが何も返さない場合、失敗します。

  8. もし date present フラグと time present フラグが両方とも true であるにもかかわらず、position が input の終端を超えている場合、失敗します。

  9. もし date present フラグと time present フラグが両方とも true であれば、タイムゾーンオフセットコンポーネントを解析する ことで timezonehours と timezoneminutes を取得します。これが何も返さない場合、失敗します。

  10. もし position が input の終端を超えていない場合、失敗します。

  11. もし date present フラグが true で time present フラグが false であれば、date を year、month、day からなる日付とし、date を返します。

    それ以外の場合、もし time present フラグが true で date present フラグが false であれば、time を hour、minute、second からなる時間とし、time を返します。

    それ以外の場合、time を year、month、day、hour、minute、second からなる瞬間とし、これに timezonehours 時間と timezoneminutes 分を引いた、UTC タイムゾーンでの瞬間とし、timezone を UTC から timezonehours 時間および timezoneminutes 分とし、time と timezone を返します。

2.3.6 レガシーカラー

一部の廃止されたレガシー属性は、文字列 input を指定して、レガシーカラー値を解析するためのルールを使用して色を解析します。これらはCSSカラーまたは失敗を返します。

  1. input が空の文字列の場合、失敗を返します。

  2. input から先頭および末尾のASCII空白を削除します。

  3. input が「transparent」のASCII大文字小文字を区別しない一致である場合、失敗を返します。

  4. input が名前付きカラーのいずれかのASCII大文字小文字を区別しない一致である場合、そのキーワードに対応するCSSカラーを返します。 [CSSCOLOR]

    CSS2システムカラーは認識されません。

  5. input のコードポイント長が4で、input の最初の文字がU+0023 (#) であり、input の最後の3文字がすべてASCII16進数である場合：

    1. result をCSSカラーとします。

    2. input の2番目の文字を16進数として解釈します。result の赤成分を、結果の数値に17を掛けたものとします。

    3. input の3番目の文字を16進数として解釈します。result の緑成分を、結果の数値に17を掛けたものとします。

    4. input の4番目の文字を16進数として解釈します。result の青成分を、結果の数値に17を掛けたものとします。

    5. result を返します。

  6. input 内のU+FFFFより大きいコードポイント（つまり、基本多言語面にない文字）を「00」に置き換えます。

  7. input のコードポイント長が128より大きい場合、input を切り捨て、最初の128文字のみを残します。

  8. input の最初の文字がU+0023 (#) の場合、それを取り除きます。

  9. input 内のASCII16進数でない文字をU+0030 (0) に置き換えます。

  10. input のコードポイント長がゼロであるか、3の倍数でない間、U+0030 (0) をinput に追加します。

  11. input を同じコードポイント長の3つの文字列に分割し、3つのコンポーネントを取得します。length を、これらのコンポーネントすべてが持つコードポイント長（input のコードポイント長の3分の1）とします。

  12. length が8より大きい場合、各コンポーネントの先頭のlength-8文字を削除し、length を8とします。

  13. length が2より大きく、各コンポーネントの最初の文字がU+0030 (0) である間、その文字を削除し、length を1減らします。

  14. length がまだ2より大きい場合、各コンポーネントを切り捨て、各コンポーネントの最初の2文字のみを残します。

  15. result をCSSカラーとします。

  16. 最初のコンポーネントを16進数として解釈します。result の赤成分を、結果の数値とします。

  17. 2番目のコンポーネントを16進数として解釈します。result の緑成分を、結果の数値とします。

  18. 3番目のコンポーネントを16進数として解釈します。result の青成分を、結果の数値とします。

  19. result を返します。

2.3.7 スペースで区切られたトークン

スペースで区切られたトークンのセットは、1つ以上のASCII空白文字で区切られたゼロ個以上の単語（トークンと呼ばれる）を含む文字列です。単語は、1つ以上の文字からなる任意の文字列で、ASCII空白文字を含まないものとします。

スペースで区切られたトークンのセットを含む文字列には、先頭または末尾にASCII空白文字が含まれている場合があります。

順序のない一意のスペースで区切られたトークンのセットは、トークンが重複していないスペースで区切られたトークンのセットです。

順序がある一意のスペースで区切られたトークンのセットは、トークンが重複していないが、トークンの順序に意味があるスペースで区切られたトークンのセットです。

スペースで区切られたトークンのセットには、許可された値の定義済みセットがある場合があります。許可された値のセットが定義されている場合、トークンはその許可された値のリストからのものでなければなりません。その他の値は非準拠です。許可された値のセットが提供されていない場合は、すべての値が準拠とされます。

スペースで区切られたトークンのセットにおいてトークンを比較する方法（例: 大文字小文字を区別するかどうか）は、セットごとに定義されます。

2.3.8 コンマ区切りのトークン

コンマ区切りのトークンのセットは、ゼロ個以上のトークンを含む文字列で、各トークンは次のトークンとU+002C COMMA文字（,）で区切られています。トークンはゼロ個以上の文字からなる任意の文字列であり、ASCII空白文字で始まったり終わったりせず、U+002C COMMA文字（,）を含まないものとし、任意でASCII空白文字で囲まれている場合があります。

例えば、文字列「 a ,b,,d d 」は、4つのトークン「a」、「b」、「」（空の文字列）、および「d d」で構成されます。各トークンの前後の空白はトークンの一部とはみなされず、空の文字列もトークンになり得ます。

コンマ区切りのトークンのセットには、有効なトークンを構成するものに関するさらなる制限が課される場合があります。そのような制限が定義されている場合、トークンはすべてその制限に適合しなければなりません。その他の値は非準拠です。もしそのような制限が指定されていない場合、すべての値が準拠となります。

2.3.9 参照

type型の要素への有効なハッシュ名参照は、U+0023 番号記号文字（#）で始まり、そのtype型の要素のname属性の値と完全に一致する文字列で構成されます。その要素は同じツリー内に存在します。

type型の要素へのハッシュ名参照を解析するためのルールは、コンテキストノードscopeが与えられた場合、以下の通りです。

  1. 解析されている文字列にU+0023 番号記号文字が含まれていない場合、または文字列内の最初の番号記号文字が文字列の最後の文字である場合、nullを返します。

  2. sを、解析されている文字列内の最初のU+0023 番号記号文字の直後の文字からその文字列の終わりまでの文字列とします。

  3. scopeのツリー内で、ツリー順にsの値を持つidまたはname属性を持つ最初のtype型の要素を返します。該当する要素がない場合はnullを返します。

    id属性は解析時に考慮されますが、値が有効なハッシュ名参照であるかどうかを決定する際には使用されません。つまり、idに基づいて要素を参照するハッシュ名参照は、（その要素に同じ値のname属性がある場合を除いて）準拠エラーです。

2.3.10 メディアクエリ

文字列が有効なメディアクエリリストであるためには、それがMedia Queriesの<media-query-list>生成規則に一致する必要があります。[MQ]

文字列がユーザーの環境に一致するためには、それが空の文字列、ASCII空白文字のみで構成された文字列、またはMedia Queriesで定義されたユーザーの環境に一致するメディアクエリリストである必要があります。[MQ]

2.3.11 一意の内部値

一意の内部値は、シリアライズ可能で、値で比較可能であり、スクリプトに公開されない値です。

新しい一意の内部値を作成するには、このアルゴリズムで以前に返されたことのない一意の内部値を返します。

2.4 URL

2.4.1 用語

文字列が有効な非空のURLであるためには、それが有効なURL文字列であり、かつ空文字列ではない必要があります。

文字列がスペースで囲まれた可能性のある有効なURLであるためには、それから先頭および末尾のASCII空白文字を取り除いた後に、それが有効なURL文字列である必要があります。

文字列がスペースで囲まれた可能性のある有効な非空のURLであるためには、それから先頭および末尾のASCII空白文字を取り除いた後に、それが有効な非空のURLである必要があります。

この仕様では、about:legacy-compatというURLを予約済みで解決不可能なURLとして定義していますが、XMLツールとの互換性を確保するためにDOCTYPEにおいてHTML文書で使用されます。[ABOUT]

この仕様では、about:html-kindというURLを予約済みで解決不可能なURLとして定義していますが、これはメディアトラックの種類を識別するために使用されます。[ABOUT]

この仕様では、about:srcdocというURLを予約済みで解決不可能なURLとして定義していますが、これはURLがiframeのsrcdoc文書として使用されます。[ABOUT]

DocumentオブジェクトdocumentのフォールバックベースURLは、次の手順を実行して取得されるURLレコードです:

  1. もしdocumentがiframeのsrcdoc文書である場合:

    1. 確認: documentのaboutベースURLがnullでないことを確認します。

    2. documentのaboutベースURLを返します。

  2. もしdocumentのURLがabout:blankに一致し、かつdocumentのaboutベースURLがnullでない場合、documentのaboutベースURLを返します。

  3. documentのURLを返します。

Documentオブジェクトの文書ベースURLは、次の手順を実行して取得されるURLレコードです:

  1. もしbase要素がなく、そのhref属性がDocumentにない場合、DocumentのフォールバックベースURLを返します。

  2. それ以外の場合、Document内でhref属性を持つ最初のbase要素の凍結ベースURLを返します。ツリー順で。

URLがabout:blankに一致するためには、そのスキームが「about」であり、そのパスが単一の文字列「blank」を含み、そのユーザー名およびパスワードが空文字列であり、そのホストがnullである必要があります。

このようなURLのクエリおよびフラグメントはnullでない可能性があります。例えば、URLレコードは「about:blank?foo#bar」を解析して作成されたabout:blankに一致します。

URLがabout:srcdocに一致するためには、そのスキームが「about」であり、そのパスが単一の文字列「srcdoc」を含み、そのクエリがnullであり、そのユーザー名およびパスワードが空文字列であり、そのホストがnullである必要があります。

about:srcdocがURLのクエリをnullにする理由は、iframe srcdocドキュメントのURLに非nullのクエリを持つことができないためです。これは、URLの集合のうち、about:srcdocに一致するものは、そのフラグメントのみが異なるからです。

2.4.2 URLの解析

URLを解析することは、文字列を受け取り、それが表すURLレコードを取得するプロセスです。このプロセスはURLで定義されていますが、HTML標準ではベースURLやエンコーディングを抽象化するためのいくつかのラッパーが定義されています。[URL]

新しいAPIのほとんどはURLを解析するを使用します。古いAPIやHTML要素は、エンコーディングを考慮してURLを解析するを使用する理由があるかもしれません。カスタムベースURLが必要な場合やベースURLが不要な場合は、URLパーサーを直接使用することももちろん可能です。

urlという文字列を、Documentオブジェクトまたは環境設定オブジェクトであるenvironmentに対してURLを解析するためには、次のステップを実行します。これらは失敗またはURLを返します。

  1. もしenvironmentがDocumentオブジェクトであれば、baseURLをenvironmentのベースURLとし、それ以外の場合はenvironmentのAPIベースURLとします。

  2. baseURLを使用して、urlに対してURLパーサーを適用した結果を返します。

urlという文字列を、Documentオブジェクトまたは環境設定オブジェクトであるenvironmentに対してエンコーディングを考慮してURLを解析するためには、次のステップを実行します。これらは失敗またはURLを返します。

  1. encodingをUTF-8とします。

  2. もしenvironmentがDocumentオブジェクトであれば、encodingをenvironmentの文字エンコーディングに設定します。

  3. それ以外の場合、もしenvironmentの関連グローバルオブジェクトがWindowオブジェクトであれば、encodingをenvironmentの関連グローバルオブジェクトの関連するDocumentの文字エンコーディングに設定します。

  4. もしenvironmentがDocumentオブジェクトであれば、baseURLをenvironmentのベースURLとし、それ以外の場合はenvironmentのAPIベースURLとします。

  5. baseURLとencodingを使用して、urlに対してURLパーサーを適用した結果を返します。

urlという文字列を、Documentオブジェクトまたは環境設定オブジェクトであるenvironmentに対してエンコーディングを考慮してURLを解析およびシリアル化するためには、次のステップを実行します。これらは失敗または文字列を返します。

  1. urlを、environmentに対してエンコーディングを考慮してURLを解析することによって得られる結果とします。

  2. もしurlが失敗であれば、失敗を返します。

  3. urlに対してURLシリアライザーを適用した結果を返します。

2.4.3 ベースURLの動的変更

文書の文書ベースURLが変更された場合、その文書内のすべての要素はベースURLの変更によって影響を受けることになります。

以下はベースURL変更手順であり、要素がベースURLの変更によって影響を受ける（DOMで定義されているように）際に実行されます:

要素がハイパーリンクを作成する場合

もし、ハイパーリンクによって識別されるURLがユーザーに表示されている場合、またはそのURLから得られたデータが表示に影響を与えている場合、href属性の値は、要素のノード文書に対して再解析され、適切にUIが更新されるべきです。

例えば、CSSの:link/:visited疑似クラスが影響を受ける可能性があります。

ハイパーリンクにping属性があり、そのURL(s)がユーザーに表示されている場合、ping属性のトークンは要素のノード文書に対して再解析され、適切にUIが更新されるべきです。

要素がq、blockquote、ins、またはdel要素であり、cite属性を持つ場合

もし、cite属性によって識別されるURLがユーザーに表示されている場合、またはそのURLから得られたデータが表示に影響を与えている場合、cite属性の値は要素のノード文書に対して再解析され、適切にUIが更新されるべきです。

その他の場合

要素は直接影響を受けません。

例えば、ベースURLを変更しても、img要素によって表示される画像には影響しませんが、その後のスクリプトからのsrcIDL属性のアクセスでは、表示されている画像に対応しなくなる可能性がある新しい絶対URLが返されます。

2.5 リソースのフェッチ

2.5.1 用語

レスポンスのタイプが"basic"、"cors"、または"default"である場合、そのレスポンスはCORS同一オリジンです。[FETCH]

レスポンスのタイプが"opaque"または"opaqueredirect"である場合、そのレスポンスはCORSクロスオリジンです。

レスポンスの不安全なレスポンスは、もし存在するならその内部レスポンスであり、そうでない場合はレスポンス自体です。

url、destination、corsAttributeState、およびオプションの同一オリジンフォールバックフラグが与えられた場合に潜在的なCORSリクエストを作成するには、次のステップを実行します:

  1. corsAttributeStateがNo CORSである場合、modeを"no-cors"とし、それ以外の場合は"cors"とします。

  2. もし同一オリジンフォールバックフラグが設定されていて、modeが"no-cors"である場合、modeを"same-origin"に設定します。

  3. credentialsModeを"include"とします。

  4. corsAttributeStateがAnonymousである場合、credentialsModeを"same-origin"に設定します。

  5. URLがurl、宛先がdestination、モードがmode、認証情報モードが credentialsModeであり、かつuse-URL-credentialsフラグが設定されている、新しいリクエストを返します。

2.5.2 リソースの種類を決定する

リソースのContent-Typeメタデータは、MIME Sniffingの要件に従って取得および解釈されなければなりません。[MIMESNIFF]

リソースの計算されたMIMEタイプは、MIME Sniffingで示された要件に従って求めなければなりません。[MIMESNIFF]

画像を特定するための規則、リソースがテキストかバイナリかを区別するための規則、および音声および動画を特定するための規則もMIME Sniffingで定義されています。これらの規則は、結果としてMIMEタイプを返します。[MIMESNIFF]

MIME Sniffingの規則は正確に遵守することが重要です。ユーザーエージェントがサーバーの期待とは異なるヒューリスティックでコンテンツタイプを検出する場合、セキュリティ問題が発生する可能性があります。詳細はMIME Sniffingを参照してください。[MIMESNIFF]

2.5.3 meta要素から文字エンコーディングを抽出する

meta 要素から文字エンコーディングを抽出するためのアルゴリズムは、文字列 s が与えられた場合、次のとおりです。これは文字エンコーディングまたは何も返しません。

  1. positionをsのポインタとし、初期位置を文字列の先頭に設定します。

  2. ループ: positionの後にs内で最初に現れる7文字を探し、その文字列が"charset"とASCII大文字小文字を区別しない一致であるか確認します。そのような一致が見つからなかった場合、何も返さず終了します。

  3. "charset"の後に続くASCII空白文字をスキップします（存在しない場合もあります）。

  4. 次の文字がU+003D EQUALS SIGN（=）でない場合、positionを次の文字の直前に移動し、ループラベルのステップに戻ります。

  5. 等号の後に続くASCII空白文字をスキップします（存在しない場合もあります）。

  6. 次の文字を以下のように処理します:

    それがU+0022 QUOTATION MARK（"）であり、s内に後続のU+0022 QUOTATION MARK（"）が存在する場合
    それがU+0027 APOSTROPHE（'）であり、s内に後続のU+0027 APOSTROPHE（'）が存在する場合
    この文字とその次に現れる同じ文字との間の部分文字列からエンコーディングを取得した結果を返します。
    それが一致しないU+0022 QUOTATION MARK（"）である場合
    それが一致しないU+0027 APOSTROPHE（'）である場合
    次の文字が存在しない場合
    何も返しません。
    それ以外の場合
    この文字から始まり、最初に現れるASCII空白文字またはU+003B SEMICOLON（;）のいずれか、またはsの終わりまでの文字列を使用して、エンコーディングを取得した結果を返します。

このアルゴリズムはHTTP仕様書内のものとは異なります（例えば、HTTPではシングルクォートの使用が許可されておらず、このアルゴリズムがサポートしていないバックスラッシュエスケープ機構のサポートが必要です）。このアルゴリズムは、歴史的にはHTTPに関連する文脈で使用されていましたが、実装によってサポートされる構文はしばらく前に分岐しました。[HTTP]

2.5.4 CORS設定属性

CORS設定属性は、次のキーワードと状態を持つ列挙属性です:

キーワード 状態 簡単な説明
anonymous Anonymous 要素のリクエストは、そのモードが"cors"に設定され、その認証モードが"same-origin"に設定されます。
(空の文字列)
use-credentials Use Credentials 要素のリクエストは、そのモードが"cors"に設定され、その認証モードが"include"に設定されます。

属性の欠損値のデフォルトはNo CORS 状態であり、その無効値のデフォルトはAnonymous 状態です。

CORS設定属性により管理されるフェッチの大部分は、潜在的なCORSリクエストを作成するアルゴリズムを通じて実行されます。

リクエストのモードが常に"cors"であるよりモダンな機能に対しては、特定のCORS設定属性が再利用され、わずかに異なる意味を持つようになります。これにより、リクエストのリクエストの認証モードのみに影響を与えるようになります。この変換を行うために、特定のCORS設定属性に対してCORS設定属性認証モードを次の状態に応じて定義します:

No CORS
Anonymous
"same-origin"
Use Credentials
"include"

2.5.5 リファラーポリシー属性

リファラーポリシー属性は列挙属性です。空の文字列を含む各リファラーポリシーがこの属性のキーワードであり、同名の状態にマッピングされます。

この属性の欠落値のデフォルトおよび無効値のデフォルトはいずれも空の文字列状態です。

これらの状態がさまざまなフェッチの処理モデルに与える影響については、この仕様全体、Fetch、およびReferrer Policyでより詳細に定義されています。[FETCH] [REFERRERPOLICY]

特定のフェッチに対してどの処理モデルが使用されるかに寄与するシグナルはいくつかありますが、リファラーポリシー属性はその一部に過ぎません。一般的に、これらのシグナルが処理される順序は以下の通りです:

  1. 最初に、noreferrerリンクタイプの存在を確認します。

  2. 次に、リファラーポリシー属性の値を確認します。

  3. その後、meta要素のname属性がreferrerに設定されているかを確認します。

  4. 最後に、Referrer-PolicyHTTPヘッダーを確認します。

2.5.6 Nonce 属性

Global_attributes/nonce

すべての最新エンジンでサポートされています。

Firefox31+SafariはいChromeはい
Opera不明Edgeはい
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

nonce コンテンツ属性は、暗号化された nonce（「一度だけ使用される番号」）を表し、特定のフェッチが許可されるかどうかを判断するために Content Security Policy によって使用されます。値はテキストです。[CSP]

nonce コンテンツ属性を持つ要素は、暗号化された nonce がスクリプトにのみ公開されるようにし（CSS 属性セレクタなどのサイドチャネルには公開されません）、コンテンツ属性から値を取得し、[[CryptographicNonce]] という内部スロットに移動させ、スクリプトに HTMLOrSVGElement インターフェースミックスインを介して公開し、コンテンツ属性を空文字列に設定します。特に指定がない限り、スロットの値は空文字列です。

element.nonce

element の暗号化された nonce に設定された値を返します。セッターが使用されていない場合、これは元々 nonce コンテンツ属性に見つかった値になります。

element.nonce = value

element の暗号化された nonce の値を更新します。

HTMLElement/nonce

Firefox75+Safari🔰 10+Chrome61+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

nonce IDL 属性は、取得時にこの要素の [[CryptographicNonce]] の値を返し、設定時にこの要素の [[CryptographicNonce]] に設定された値を設定します。

nonce IDL 属性のセッターが対応するコンテンツ属性を更新しないことに注目してください。これと、ブラウジングコンテキストに接続されたときに要素の nonce コンテンツ属性を空文字列に設定する以下の設定は、セレクタなどのコンテンツ属性を簡単に読み取れるメカニズムを介して nonce 値が外部に流出するのを防ぐために設けられています。この動作について詳しくは、issue #2369 で紹介されています。

次の 属性変更手順 は、nonce コンテンツ属性に使用されます：

  1. element が 含む HTMLOrSVGElement を持たない場合、リターンします。

  2. localName が nonce ではないか、または namespace が null でない場合、リターンします。

  3. value が null の場合、element の [[CryptographicNonce]] を空文字列に設定します。

  4. それ以外の場合、element の [[CryptographicNonce]] を value に設定します。

要素が 含む HTMLOrSVGElement を ブラウジングコンテキストに接続されたとき、ユーザーエージェントはelementに対して次の手順を実行する必要があります：

  1. CSP listをelementのシャドウを含むルートのポリシーコンテナのCSP リストにします。

  2. CSP list がヘッダーで配信されたコンテンツセキュリティポリシーを含む場合、かつ element が、その値が空の文字列ではないnonce コンテンツ属性を持つ場合：

    1. nonce を element の[[CryptographicNonce]]に設定します。

    2. 属性値を設定するでelementの "nonce" を使用し、空文字列にします。

    3. element の [[CryptographicNonce]] を nonce に設定します。

    もしelementの[[CryptographicNonce]] が復元されなければ、この時点で空文字列になります。

node、copy、およびsubtree が与えられた、HTMLOrSVGElement を含む要素のクローニングステップは、copy の [[CryptographicNonce]] を node の [[CryptographicNonce]] に設定することです。

2.5.7 レイジーローディング属性

Lazy_loading

すべての最新エンジンでサポートされています。

Firefox75+Safari15.4+Chrome77+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

レイジーローディング属性は、以下のキーワードと状態を持つ列挙属性です:

キーワード 状態 簡潔な説明
lazy Lazy 条件が満たされるまでリソースのフェッチを遅らせるために使用されます。
eager Eager リソースを即座にフェッチするために使用されます。デフォルトの状態です。

この属性は、ユーザーエージェントに対し、リソースを即座にフェッチするか、要素に関連する条件が満たされるまでフェッチを遅らせるよう指示します。

この属性の欠落値のデフォルトと無効値のデフォルトは、どちらもEager状態です。

レイジーロード要素のステップは、element に対して次のように行われます:

  1. スクリプトが無効になっている場合 elementに対し、false を返します。

    これは追跡防止策であり、スクリプトが無効になっているときにレイジーローディングがサポートされていると、ページのマークアップに画像を戦略的に配置することで、ユーザーの大まかなスクロール位置を追跡することが可能になってしまうためです。

  2. element の レイジーローディング属性がLazy 状態にある場合、true を返します。

  3. false を返します。

各imgおよびiframe要素には、関連するレイジーロード再開ステップがあり、最初は null に設定されています。

imgおよびiframe要素がレイジーロードを行う場合、これらのステップはレイジーロードインターセクションオブザーバーのコールバックから、またはレイジーローディング属性がEager状態に設定されたときに実行されます。これにより、要素のロードが続行されます。

各Documentには、最初は null に設定されているレイジーロードインターセクションオブザーバーがあり、IntersectionObserverインスタンスに設定できます。

レイジーローディング要素のインターセクション観察を開始するためにelementに対して、次の手順を実行します:

  1. elementのノードドキュメントをdocとします。

  2. もしdocのレイジーロードインターセクションオブザーバーが null である場合、新しいIntersectionObserverインスタンスに設定します。初期設定は次のとおりです:

    元のIntersectionObserverコンストラクタの値を使用することが意図されています。ただし、Intersection Observerが仕様内での使用に適した低レベルのフックを公開するまでは、JavaScript で公開されたコンストラクタを使用する必要があります。これを追跡しているバグはw3c/IntersectionObserver#464を参照してください。[INTERSECTIONOBSERVER]

  3. docのレイジーロードインターセクションオブザーバーのobserveメソッドを呼び出し、引数にelementを設定します。

    元のobserveメソッドの値を使用することが意図されています。w3c/IntersectionObserver#464を参照してください。[INTERSECTIONOBSERVER]

レイジーローディング要素のインターセクション観察を停止するためにelementに対して、次の手順を実行します:

  1. elementのノードドキュメントをdocとします。

  2. 断言: docのレイジーロードインターセクションオブザーバーが null でないこと。

  3. docのレイジーロードインターセクションオブザーバーのunobserveメソッドを呼び出し、引数にelementを設定します。

    元のunobserveメソッドの値を使用することが意図されています。w3c/IntersectionObserver#464を参照してください。[INTERSECTIONOBSERVER]

(これは追跡ベクトルです。) レイジーロードスクロールマージンは実装依存の値ですが、以下の提案を考慮する必要があります:

プライバシーのために、レイジーロードスクロールマージンが追加情報を漏洩しないことが重要です。例えば、現在のデバイスでの典型的なスクロール速度が不正確であっても、新しいフィンガープリントベクトルが導入されないようにする必要があります。

2.5.8 ブロッキング属性

ブロッキング属性は、特定の操作が外部リソースのフェッチにおいてブロックされるべきであることを明示的に示します。ブロックされる可能性のある操作は、以下の表に示されている文字列であるブロッキングトークン候補によって表されます。

ブロッキングトークン候補 説明
"render" この要素は潜在的にレンダーブロッキングである可能性があります。

将来的には、ブロッキングトークン候補が増える可能性があります。

ブロッキング属性には、スペースで区切られた順不同の一意のトークン集合であり、各トークンがブロッキングトークン候補である値を持たなければなりません。サポートされているトークンは、ブロッキング属性のブロッキングトークン候補です。任意の要素は、ブロッキング属性を最大で1つしか持つことができません。

要素elに対するブロッキングトークンセットは、以下の手順に従った結果です:

  1. elのブロッキング属性の値をvalueとします。この属性が存在しない場合は空文字列とします。

  2. valueをASCII小文字に変換されたvalueに設定します。

  3. ASCII空白文字でvalueを分割した結果をrawTokensとします。

  4. rawTokensの要素で、ブロッキングトークン候補であるものを含むセットを返します。

要素は、ブロッキングトークンセットに"render"が含まれている場合、または個々の要素で定義される暗黙的に潜在的にレンダーブロッキングである場合に、潜在的にレンダーブロッキングとなります。デフォルトでは、要素は暗黙的に潜在的にレンダーブロッキングではありません。

2.5.9 フェッチ優先属性

フェッチ優先属性は、次のキーワードと状態を持つ列挙属性です:

キーワード 状態 簡潔な説明
high High 同じデスティネーションを持つ他のリソースに対して、フェッチが高優先度であることを示します。
low Low 同じデスティネーションを持つ他のリソースに対して、フェッチが低優先度であることを示します。
auto Auto 同じデスティネーションを持つ他のリソースに対して、フェッチの優先度を自動的に決定することを示します。

この属性の欠落値のデフォルトおよび無効値のデフォルトは、どちらもAuto状態です。

2.6 共通DOMインターフェース

2.6.1 IDL属性へのコンテンツ属性の反映

反映のための構成要素は次のとおりです:

反映されたIDL属性は、反映されるように定義できます。反映されたコンテンツ属性名が反映されたターゲットの。一般的には、IDL属性ゲッターがコンテンツ属性の現在の値を返し、セッターがコンテンツ属性の値を指定された値に変更することを意味します。

反映されたターゲットが要素である場合、反映されたIDL属性は、support ElementInternalsを宣言することもできます。これにより、ElementInternalsインターフェイスも、同じ識別子で反映されたIDL属性を持ち、反映されたIDL属性が同じ反映されたコンテンツ属性名を反映することを意味します。

fooBarIDL属性は、foobarコンテンツ属性を反映し、support ElementInternalsする必要があります。

反映されたターゲットには、次の関連アルゴリズムがあります:

反映されたターゲットが要素elementである場合、これらは次のように定義されます:

get the element

  1. elementを返します。

get the content attribute

  1. attributeを、null、反映されたコンテンツ属性名、およびelementを指定して、名前空間とローカル名で属性を取得するの実行結果とします。

  2. attributeがnullの場合、nullを返します。

  3. attributeのvalueを返します。

set the content attribute、文字列valueを指定して

  1. 属性値を設定するをelement、反映されたコンテンツ属性名、 およびvalueを指定して実行します。

delete the content attribute

  1. 名前空間とローカル名で属性を削除するを、null、反映されたコンテンツ属性名、 およびelementを指定して実行します。

反映されたターゲットがElementInternalsオブジェクトelementInternalsである場合、それらは次のように定義されます:

get the element

  1. elementInternalsのターゲット要素を返します。

get the content attribute

  1. もしelementInternalsのターゲット要素の内部コンテンツ属性マップ[反映されたコンテンツ属性名]が存在しない場合、nullを返します。

  2. elementInternalsのターゲット要素の内部コンテンツ属性マップ[反映されたコンテンツ属性名]を返します。

set the content attribute、文字列valueを指定して

  1. 設定elementInternalsのターゲット要素の内部コンテンツ属性マップ[反映されたコンテンツ属性名]をvalueに。

delete the content attribute

  1. 削除elementInternalsのターゲット要素の内部コンテンツ属性マップ[反映されたコンテンツ属性名]を削除します。

これは、ElementInternalsオブジェクトの冗長なデータ構造につながります。これらのオブジェクトは、ターゲット要素の内部コンテンツ属性マップを直接操作することができず、反映が単方向にしか行われないためです。しかし、このアプローチは、反映されたターゲット間で共有されるIDL属性を定義し、共通のAPIセマンティクスの利点を享受するために、エラーを防ぐために選ばれました。

型がDOMStringまたはDOMString?のIDL属性は、反映されるコンテンツ属性が列挙された場合にのみ、既知の値のみに制限されることがあります。以下の処理モデルによると、そのようなIDL属性のゲッターは、その列挙された属性のキーワード、または空文字列またはnullのみを返します。

反映されたIDL属性が型DOMStringを持つ場合:

反映されたIDL属性が型DOMString?を持つ場合:

反映されたIDL属性が型 USVString を持つ場合：

反映されたIDL属性が型booleanを持つ場合:

これはbooleanコンテンツ属性のルールに対応します。

反映されたIDL属性が型long、またはオプションで非負数のみに制限されるとオプションでデフォルト値defaultValueを持つ場合:

反映されたIDL属性が型double、オプションで正の数にのみ制限されるとオプションでデフォルト値defaultValueを持つ場合:

InfinityとNot-a-Number (NaN)の値は、Web IDLで定義されているように、設定時に例外をスローします。[WEBIDL]

反映されたIDL属性が型DOMTokenListを持つ場合、そのゲッターステップは、関連する要素がthisであり、関連する属性のローカル名が反映されたコンテンツ属性名であるDOMTokenListオブジェクトを返すことです。仕様著者は、この型のIDL属性に対してsupport ElementInternalsを使用することはできません。

反映されたIDL属性が型T?を持ち、TがElementまたはElementから継承するインターフェイスである場合、attrが反映されたコンテンツ属性名の場合:

この型の反映されたIDL属性は、一貫性を保つために識別子を"Element"で終わらせることが強く推奨されます。

もし反映されたIDL属性 がFrozenArray<T>?型を持つ場合、ここでTはElement またはElementから継承されるインターフェースのいずれかであるとします。 次に、 attrが反映されたコンテンツ属性名 である場合は次のようになります:

このタイプの反映されたIDL属性には、一貫性を保つために識別子の末尾に「Elements」を付けることが強く推奨されます。

2.6.2 仕様でのreflectの使用

リフレクションは主に、反映されたIDL属性を通じてコンテンツ属性への型付きアクセスを提供することで、ウェブ開発者の利便性を向上させることを目的としています。ウェブプラットフォームが基づいている最終的な信頼性の源は、コンテンツ属性そのものです。つまり、仕様の著者は、反映されたIDL属性のゲッターやセッターのステップを使用するのではなく、コンテンツ属性の存在と値を使用しなければなりません。（または、列挙された属性の状態など、上にある抽象化されたものを使用します。）

このルールには、次のような型を持つ反映されたIDL属性に関して重要な例外が2つあります:

これらの場合、仕様の著者は反映ターゲットのattr-関連要素を取得するおよびattr-関連要素を取得するをそれぞれ使用しなければなりません。コンテンツ属性の存在と値は使用してはならず、それらは反映されたIDL属性と完全には同期できません。

反映ターゲットの明示的に設定されたattr-要素、明示的に設定されたattr-要素、キャッシュされたattr-関連要素、およびキャッシュされたattr-関連要素オブジェクトは内部実装の詳細として扱われ、使用されるべきではありません。

2.6.3 コレクション

HTMLFormControlsCollection およびHTMLOptionsCollection インターフェースは、コレクションであり、HTMLCollection インターフェースから派生しています。HTMLAllCollection インターフェースはコレクションですが、派生はしていません。

2.6.3.1 HTMLAllCollection インターフェース

HTMLAllCollection インターフェースは、レガシー属性であるdocument.all のために使用されます。これはHTMLCollectionと同様に機能しますが、主な違いは、そのメソッドのさまざまな（誤用も含む）使用法が全て何かしらの結果を返すことと、プロパティアクセスの代わりに関数として呼び出すことができることです。

すべてのHTMLAllCollection オブジェクトはDocumentにルートを持ち、すべての要素に一致するフィルタを持つため、コレクションによって表されるHTMLAllCollection オブジェクトの要素は、ルートDocumentのすべての子孫要素で構成されています。

HTMLAllCollectionインターフェイスを実装するオブジェクトは、レガシープラットフォームオブジェクトであり、以下のセクションに記載されている追加の[[Call]]内部メソッドを持ちます。また、[[IsHTMLDDA]]内部スロットも持っています。

HTMLAllCollection インターフェースを実装するオブジェクトは、[[IsHTMLDDA]]内部スロットを持つため、いくつかの異常な動作をします:

これらの特別な動作は、2つの種類のレガシーコンテンツとの互換性を目的としています: 1つは、document.all の存在を使用してレガシーユーザーエージェントを検出するもの、もう1つは、そのレガシーユーザーエージェントのみをサポートし、document.all オブジェクトをその存在をテストせずに使用するものです。 [JAVASCRIPT] 

[Exposed=Window,
  LegacyUnenumerableNamedProperties]
 interface HTMLAllCollection {
   readonly attribute unsigned long length;
   getter Element (unsigned long index);
   getter (HTMLCollection or Element)? namedItem(DOMString name);
   (HTMLCollection or Element)? item(optional DOMString nameOrIndex);
 
   // Note: HTMLAllCollection objects have a custom [[Call]] internal method and an [[IsHTMLDDA]] internal slot.
 };

オブジェクトのサポートされているプロパティインデックスは、HTMLCollection オブジェクトに定義されているものと同じです。

サポートされているプロパティ名には、すべての要素のid属性の非空の値、およびすべてのコレクションによって表されるname属性の非空の値が含まれます。これらは"all"-named要素に含まれるものであり、ツリー順に従い、後続の重複を無視し、要素が両方を提供する場合、idがnameよりも優先されます。

lengthゲッターステップは、コレクションによって表されるノードの数を返すことです。

インデックス付きプロパティゲッターは、渡されたインデックスを考慮して、"all"-indexed要素を取得する結果を返す必要があります。

namedItem(name)メソッドステップは、渡されたnameを考慮して、"all"-named要素を取得する結果を返すことです。

item(nameOrIndex)メソッドステップは次のとおりです:

  1. nameOrIndexが提供されていない場合は、nullを返します。

  2. 渡されたnameOrIndexを考慮して、"all"-indexedまたはnamed要素を取得する結果を返します。

以下の要素は"all"-named要素です: a, button, embed, form, frame, frameset, iframe, img, input, map, meta, object, select, および textarea

"all"-indexed要素を取得するために、 HTMLAllCollection collectionからインデックスindexを与えられた場合、collection内のindex番目の要素を返すか、そのようなindex番目の要素が存在しない場合はnullを返します。

"all"-named要素を取得するために、 HTMLAllCollection collectionからnameを与えられた場合、次の手順を実行します:

  1. nameが空文字列の場合、nullを返します。

  2. subCollectionを、同じDocumentにルートを持つHTMLCollection オブジェクトとし、そのフィルタが次のいずれかにのみ一致するものとします:

  3. subCollectionに正確に1つの要素が含まれている場合、その要素を返します。

  4. それ以外の場合、subCollectionが空である場合はnullを返します。

  5. それ以外の場合、subCollectionを返します。

"all"-indexedまたはnamed要素を取得するために、 HTMLAllCollection collectionからnameOrIndexを与えられた場合、次の手順を実行します:

  1. JavaScriptの文字列値に変換されたnameOrIndexが配列インデックスプロパティ名である場合、渡されたnameOrIndexによって表される数値を考慮して、"all"-indexed要素を取得する結果を返します。

  2. 渡されたnameOrIndexを考慮して、"all"-named要素を取得する結果を返します。

2.6.3.1.1 [[Call]] ( thisArgument, argumentsList )

  1. もしargumentsListのサイズがゼロであるか、argumentsList[0]がundefinedである場合、nullを返します。

  2. nameOrIndexを、変換する結果とします。 argumentsList[0]をDOMStringに変換します。

  3. resultを、"all"-インデックスまたは名前付き要素を取得する このHTMLAllCollectionから nameOrIndexを与えられたものとします。

  4. resultをECMAScript値に変換する結果を返します。

thisArgumentは無視されるため、Function.prototype.call.call(document.all, null, "x")のようなコードでも要素の検索を行います。（document.all.callは存在しません。なぜならdocument.allはFunction.prototypeを継承していないためです。）

2.6.3.2 HTMLFormControlsCollection インターフェース

HTMLFormControlsCollection インターフェースは、form要素内のコレクションとして、リストされた要素に使用されます。

HTMLFormControlsCollection

現在のすべてのエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer対応なし
Firefox Android？Safari iOS1+Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+

RadioNodeList

現在のすべてのエンジンでサポートされています。

Firefox33+Safari7+Chrome21+
Opera？Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？ 
[Exposed=Window]
 interface HTMLFormControlsCollection : HTMLCollection {
   // inherits length and item()
   getter (RadioNodeList or Element)? namedItem(DOMString name); // shadows inherited namedItem()
 };
 
 [Exposed=Window]
 interface RadioNodeList : NodeList {
   attribute DOMString value;
 };
collection.length

collection内の要素の数を返します。

element = collection.item(index)
element = collection[index]

collection内のインデックスindexにある項目を返します。項目はツリー順に並べ替えられます。

element = collection.namedItem(name)

HTMLFormControlsCollection/namedItem

現在のすべてのエンジンでサポートされています。

Firefox33+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer対応なし
Firefox Android？Safari iOS1+Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+
radioNodeList = collection.namedItem(name)
element = collection[name]
radioNodeList = collection[name]

collectionからIDまたは name nameを持つ項目を返します。

一致する項目が複数ある場合、それらすべての要素を含むRadioNodeList オブジェクトが返されます。

radioNodeList.value

radioNodeListによって表される最初のチェックされたラジオボタンの値を返します。

radioNodeList.value = value

radioNodeListによって表される最初のラジオボタンで、値がvalueに等しいものをチェックします。

オブジェクトのサポートされているプロパティインデックスは、HTMLCollection オブジェクトに定義されているものと同じです。

サポートされているプロパティ名には、すべての要素のid属性の非空の値、およびすべてのコレクションによって表されるname属性の非空の値が含まれます。これらは"all"-named要素に含まれるものであり、ツリー順に従い、後続の重複を無視し、要素が両方を提供する場合、idがnameよりも優先されます。

namedItem(name)メソッドは、次のアルゴリズムに従って動作する必要があります:

  1. nameが空文字列の場合、nullを返してアルゴリズムを終了します。
  2. メソッドが呼び出された時点で、nameに等しいid属性またはname属性を持つノードがコレクション内に1つだけある場合、そのノードを返してアルゴリズムを終了します。
  3. それ以外の場合、nameに等しいid属性またはname属性を持つノードがコレクション内に存在しない場合、nullを返してアルゴリズムを終了します。
  4. それ以外の場合、新しいRadioNodeListオブジェクトを作成し、それはHTMLFormControlsCollectionオブジェクトのライブビューを表し、さらにフィルタリングしてnameに等しいid属性またはname属性を持つノードのみが含まれるようにします。RadioNodeListオブジェクト内のノードはツリー順に並べ替えられる必要があります。
  5. そのRadioNodeListオブジェクトを返します。

RadioNodeListインターフェースのメンバーは、NodeListオブジェクトでの動作と同じように振る舞う必要があります。

RadioNodeList/value

現在のすべてのエンジンでサポートされています。

Firefox33+Safari7+Chrome21+
Opera？Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

value IDL属性は、RadioNodeListオブジェクト上で、取得時には次の手順を実行した結果の値を返す必要があります。

  1. elementを、ツリー順で最初にRadioNodeListオブジェクトによって表される、input要素で、そのtype属性がRadio Button状態であり、チェックされているのがtrueであるものとします。そうでない場合はnullとします。

  2. elementがnullである場合、空文字列を返します。

  3. elementがvalue属性を持たない要素である場合、文字列「on」を返します。

  4. それ以外の場合は、elementのvalue属性の値を返します。

設定時には、valueIDL属性は次の手順を実行する必要があります。

  1. 新しい値が文字列「on」である場合、elementを、次の手順に従ってRadioNodeListオブジェクトによって表される最初の要素とします。ツリー順で、input要素であり、そのtype属性がRadio Button状態であり、そのvalueコンテンツ属性が存在しないか、存在し、新しい値と等しい場合とします。そのような要素が存在しない場合は、代わりにelementをnullとします。

    それ以外の場合、elementを、ツリー順で最初の要素とします。RadioNodeListオブジェクトによって表される、input要素で、そのtype属性がRadio Button状態であり、そのvalueコンテンツ属性が存在し、新しい値と等しい場合とします。そのような要素が存在しない場合は、代わりにelementをnullとします。

  2. もしelementがnullでない場合、そのチェックされている状態をtrueに設定します。

2.6.3.3 HTMLOptionsCollection インターフェース

HTMLOptionsCollection

すべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android？Safari iOS1+Chrome Android？WebView Android37+Samsung Internet？Opera Android12.1+

HTMLOptionsCollection インターフェースは、option 要素の コレクション に使用されます。常に select 要素にルートされており、その要素の子孫を操作するための属性やメソッドを持っています。 

[Exposed=Window]
interface HTMLOptionsCollection : HTMLCollection {
   // inherits item(), namedItem()
   [CEReactions] attribute unsigned long length; // shadows inherited length
   [CEReactions] setter undefined (unsigned long index, HTMLOptionElement? option);
   [CEReactions] undefined add((HTMLOptionElement or HTMLOptGroupElement) element, optional (HTMLElement or long)? before = null);
   [CEReactions] undefined remove(long index);
   attribute long selectedIndex;
};
collection.length

collection の要素数を返します。

collection.length = value

既存の長さよりも小さい値を設定すると、collection に対応するコンテナ内の option 要素の数が切り詰められます。

既存の長さよりも大きい値を設定すると、その値が100000以下である限り、collection に対応するコンテナに新しい空白の option 要素が追加されます。

element = collection.item(index)
element = collection[index]

collection 内のインデックス index にある項目を返します。アイテムはツリー順でソートされています。

collection[index] = element

index が collection 内のアイテム数よりも大きい場合、対応するコンテナに新しい空白の option 要素を追加します。

null に設定すると、collection からインデックス index の項目を削除します。

オプション要素が設定されている場合、collection 内のインデックス index にその要素を追加または置き換えます。

element = collection.namedItem(name)
element = collection[name]

collection から、ID または name が name に一致するアイテムを返します。

複数の一致するアイテムがある場合、最初のものが返されます。

collection.add(element[, before])

element を before で指定されたノードの前に挿入します。

before 引数は数値でもかまいません。その場合、element はその番号のアイテムの前に挿入されます。collection の要素である場合、その要素の前に element を挿入します。

before が省略された場合、null または範囲外の数値の場合、element はリストの最後に追加されます。

element が挿入される要素の祖先である場合、"HierarchyRequestError" DOMException がスローされます。

collection.remove(index)

collection からインデックス index の項目を削除します。

collection.selectedIndex

最初の選択項目のインデックスを返します。選択項目がない場合は -1 を返します。

collection.selectedIndex = index

collection 内のインデックス index の option 要素に選択を変更します。

対応するプロパティ インデックスは、HTMLCollection オブジェクトで定義されています。

length のゲッターは、コレクションが表すノードの数を返します。

length のセッターは次の手順に従います。

  1. 現在のノードの数を represented by the collection として取得します。

  2. 指定された値が current より大きい場合、次の操作を行います。

    1. 指定された値が 100,000 を超える場合、何も返さないで終了します。

    2. n を value - current として取得します。

    3. n 個の新しい option 要素を、属性も子ノードも持たない状態で、select 要素に追加します。これは、this がルートとなっている要素です。

  3. 指定された値が current より小さい場合、次の操作を行います。

    1. n を current - value として取得します。

    2. コレクションの最後の n ノードをその親ノードから削除します。

length を設定しても、optgroup 要素が削除または追加されることはなく、既存の optgroup 要素に新しい子が追加されることもありません（ただし、既存の子が削除されることはあります）。

対応するプロパティ名には、コレクションが表すすべての要素の id および name 属性の空でない値が含まれます。これらは ツリー順 で並び替えられ、後の重複を無視します。要素が両方の値を持ち、それらが異なり、どちらも以前のエントリの重複でない場合、要素の id が name よりも先に来ます。

ユーザー エージェントが 新しいインデックス付きプロパティの値を設定する または 既存のインデックス付きプロパティの値を設定する 際には、次のアルゴリズムを実行する必要があります。

  1. value が null の場合、remove メソッドの手順を index を引数として呼び出し、終了します。

  2. length を コレクションが表すノード の数として取得します。

  3. n を index - length として取得します。

  4. n がゼロより大きい場合、新しい属性や子ノードのない option 要素が含まれる DocumentFragment を select 要素に追加します。

  5. n がゼロ以上の場合、value を select 要素に追加します。それ以外の場合、コレクション内の index 番目の要素を value に置き換えます。

add(element, before) メソッドは、次のアルゴリズムに従って動作する必要があります。

  1. element が select 要素の祖先である場合、HTMLOptionsCollection にルートされている場合、"HierarchyRequestError" DOMException をスローします。

  2. before が要素であり、その要素が select 要素の子孫でない場合、HTMLOptionsCollection にルートされている場合、"NotFoundError" DOMException をスローします。

  3. element と before が同じ要素である場合、何も返さず終了します。

  4. before がノードである場合、そのノードを reference とします。そうでない場合、before が整数であり、コレクション内に before 番目のノードが存在する場合、そのノードを reference とします。それ以外の場合は、reference を null とします。

  5. reference が null でない場合、reference の親ノードを parent とします。それ以外の場合、parent を select 要素とします。HTMLOptionsCollection にルートされている要素を親ノードとします。

  6. Pre-insert element を parent ノードに reference の前に挿入します。

remove(index) メソッドは、次のアルゴリズムに従って動作する必要があります。

  1. コレクションが表すノードの数がゼロの場合、何も返さず終了します。

  2. index が 0 以上の数値でなく、かつコレクションが表すノードの数より小さい場合、何も返さず終了します。

  3. element をコレクション内の index 番目の要素とします。

  4. element をその親ノードから削除します。

selectedIndex IDL 属性は、select 要素の同名の属性と同様に動作する必要があります。HTMLOptionsCollection にルートされています。

2.6.4 DOMStringList インターフェース

DOMStringList

すべての現行エンジンでサポートされています。

Firefox1+Safari5.1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

DOMStringList インターフェースは、文字列のリストを表す非モダンなレトロな方法です。

[Exposed=(Window,Worker)]
 interface DOMStringList {
   readonly attribute unsigned long length;
   getter DOMString? item(unsigned long index);
   boolean contains(DOMString string);
 };

新しいAPIはsequence<DOMString>または これに相当するものを使用し、DOMStringListを使用してはなりません。

strings.length

stringsに含まれる文字列の数を返します。

strings[index]
strings.item(index)

stringsからインデックスindexにある文字列を返します。

strings.contains(string)

stringsにstringが含まれている場合はtrueを、それ以外の場合はfalseを返します。

各DOMStringList オブジェクトには、リストが関連付けられています。

DOMStringList インターフェースはインデックス付きプロパティをサポートします。 対応するプロパティ インデックスは、この オブジェクトの関連リストのインデックスです。

DOMStringList/length

すべての現行エンジンでサポートされています。

Firefox1+Safari5.1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

length ゲッターの手順は、関連リストのこのオブジェクトのサイズを返すことです。

DOMStringList/item

すべての現行エンジンでサポートされています。

Firefox1+Safari5.1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

item(index) メソッドの手順は、 index番目の項目をこのオブジェクトの関連リストから返すこと、indexプラス1が関連リストのサイズを超える場合はnullを返すことです。

DOMStringList/contains

すべての現行エンジンでサポートされています。

Firefox1.5+Safari5.1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

contains(string) メソッドの手順は、このオブジェクトの関連リストがstringを含んでいる場合はtrueを、それ以外の場合はfalseを返すことです。

2.7 構造化データの安全な受け渡し

JavaScriptオブジェクトを含む、 プラットフォームオブジェクト を異なるレルム の間で受け渡すことをサポートするために、この仕様はオブジェクトのシリアル化とデシリアル化のためのインフラストラクチャを定義しています。場合によってはデータのコピーではなく、基になるデータの転送が行われることもあります。このシリアル化/デシリアル化プロセスは「構造化複製」として総称されますが、ほとんどのAPIは別々のシリアル化とデシリアル化のステップを実行します。（例外として、structuredClone() メソッドがあります。）

このセクションでは、JavaScript仕様の用語とタイポグラフィの慣例を使用します。[JAVASCRIPT]

2.7.1 シリアル化可能オブジェクト

/developer.mozilla.org/en-US/docs/Glossary/Serializable_object

Firefox103+SafariいいえChrome77+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

/developer.mozilla.org/en-US/docs/Glossary/Serializable_object

Firefox103+SafariいいえChrome77+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

/developer.mozilla.org/en-US/docs/Glossary/Serializable_object

Firefox103+SafariいいえChrome77+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

/developer.mozilla.org/en-US/docs/Glossary/Serializable_object

Firefox103+SafariいいえChrome77+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

シリアル化可能なオブジェクト はシリアル化され、後でデシリアル化されることができます。これは、特定の レルムに依存しません。これにより、ディスクに保存され 後で復元されたり、エージェント間や エージェントクラスタ を越えてクローンを作成することができます。

すべてのオブジェクトがシリアル化可能オブジェクト であるわけではなく、すべての シリアル化可能オブジェクト の側面が必ずしもシリアル化されるとは限りません。

プラットフォームオブジェクト は、その主要インターフェースが [Serializable] IDL拡張属性で装飾されている場合、シリアル化可能なオブジェクトとなることができます。このようなインターフェースは、以下のアルゴリズムを定義する必要があります。

シリアル化手順 プラットフォームオブジェクト value、レコード serialized、およびブール値 forStorageを使用します。

valueのデータをserializedのフィールドにシリアル化する手順です。serializedにシリアル化されたデータは、どの レルム にも依存しないものでなければなりません。

シリアル化が不可能な場合、これらの手順は例外をスローすることがあります。

これらの手順は、ネストされたデータ構造をシリアル化するために サブシリアル化 を実行することがあります。StructuredSerialize を直接呼び出すべきではありません。そうすると、重要なmemory引数が省略されるためです。

これらの手順の導入において、アルゴリズムに関連しない場合は forStorage引数に言及することを省略する必要があります。

デシリアル化手順 レコード serialized、 プラットフォームオブジェクト value、および レルム targetRealmを使用します。

serializedのデータをデシリアル化し、それを使用して valueを適切に設定する一連の手順です。valueは、内部データが設定されていない新しく作成された プラットフォームオブジェクトのインスタンスになります。 それを設定するのはこれらの手順の役割です。

デシリアル化が不可能な場合、これらの手順は例外をスローすることがあります。

これらの手順は、ネストされたデータ構造をデシリアル化するために サブデシリアル化 を実行することがあります。StructuredDeserialize を直接呼び出すべきではありません。そうすると、重要なtargetRealmおよびmemory引数が省略されるためです。

各プラットフォームオブジェクトの定義により、これらの手順でシリアル化およびデシリアル化されるデータが決定されます。通常、これらの手順は非常に対称的です。

[Serializable]拡張属性は、 引数を取るべきではなく、インターフェースにのみ表示される必要があります。また、インターフェースに複数回表示されるべきではありません。

特定のプラットフォームオブジェクトに対しては、 そのオブジェクトの主要なインターフェースのみが （デ）シリアル化プロセス中に考慮されます。したがって、インターフェースの定義に継承が含まれる場合、 継承チェーン内の各[Serializable] で注釈されたインターフェースは、独立したシリアル化手順 およびデシリアル化手順を定義し、 継承されたインターフェースから生じる可能性のある重要なデータを考慮に入れる必要があります。

たとえば、プラットフォームオブジェクトPersonを定義しているとし、 それに関連する2つのデータがあります：

その後、Personインスタンスをシリアル化可能オブジェクト にすることができ、Personインターフェースに[Serializable] 拡張属性で注釈し、次の付随するアルゴリズムを定義することで実現できます：

シリアル化手順

  1. serialized.[[Name]]にvalueの関連する名前の値を設定します。

  2. serializedBestFriendを、valueの関連する親友の値の サブシリアル化に設定します。

  3. serialized.[[BestFriend]]にserializedBestFriendを設定します。

デシリアル化手順

  1. valueの関連する名前の値をserialized.[[Name]]に設定します。

  2. deserializedBestFriendを、serialized.[[BestFriend]]の サブデシリアル化に設定します。

  3. valueの関連する親友の値をdeserializedBestFriendに設定します。

JavaScript仕様で定義されているオブジェクトは、 StructuredSerialize 抽象操作によって直接処理されます。

元々、この仕様では、あるレルムから別のレルムに複製できる「複製可能オブジェクト」の概念が定義されていました。しかし、より複雑な状況での動作を明確に指定するために、モデルが更新され、シリアル化とデシリアル化が明示的に行われるようになりました。

2.7.2 転送可能なオブジェクト

転送可能なオブジェクト は、エージェント間で転送されることをサポートします。転送は、基になるデータへの参照を共有しながらオブジェクトを再作成し、その後転送されるオブジェクトをデタッチすることを実質的に意味します。これは高価なリソースの所有権を移転するのに役立ちます。すべてのオブジェクトが転送可能なオブジェクトであるわけではなく、転送可能なオブジェクトであっても、そのすべての側面が転送時に必ずしも保存されるわけではありません。

転送は不可逆かつ冪等ではない操作です。いったんオブジェクトが転送されると、それは再び転送されたり、使用されたりすることはできません。

プラットフォームオブジェクトは、転送可能なオブジェクトになることができます。その主要インターフェースが、[Transferable]IDL拡張属性で装飾されている場合、そのようなインターフェースは以下のアルゴリズムも定義する必要があります。

転送手順、プラットフォームオブジェクト valueとレコード dataHolderを受け取ります。

valueのデータをdataHolderのフィールドに転送する一連の手順です。dataHolderに保持される結果のデータは、任意のレルムに依存しないものでなければなりません。

これらの手順は、転送が不可能な場合に例外をスローすることがあります。

転送受信手順、レコード dataHolderとプラットフォームオブジェクト valueを受け取ります。

dataHolderのデータを受信し、それを使用してvalueを適切に設定する一連の手順です。valueは、質問中のプラットフォームオブジェクト型の新しく作成されたインスタンスであり、内部データは設定されていません。これを設定するのがこれらの手順の役割です。

受信が不可能な場合、これらの手順は例外をスローすることがあります。

各プラットフォームオブジェクトの定義により、これらの手順でどのデータが転送されるかが決定されます。通常、これらの手順は非常に対称的です。

[Transferable]拡張属性は、 引数を取るべきではなく、インターフェースにのみ表示される必要があります。また、インターフェースに複数回表示されるべきではありません。

特定のプラットフォームオブジェクトに対しては、そのオブジェクトの主要インターフェースのみが転送プロセス中に考慮されます。したがって、インターフェースの定義に継承が含まれる場合、継承チェーン内の各[Transferable]で注釈されたインターフェースは、独立した転送手順および転送受信手順 を定義し、継承されたインターフェースから生じる可能性のある重要なデータを考慮に入れる必要があります。

プラットフォームオブジェクトで、転送可能なオブジェクトは、[[Detached]]内部スロットを持ちます。これにより、いったんプラットフォームオブジェクトが転送されると、それを再度転送することはできなくなります。

JavaScript仕様で定義されているオブジェクトは、StructuredSerializeWithTransfer抽象操作によって直接処理されます。

2.7.3 StructuredSerializeInternal ( value, forStorage [ , memory ] )

StructuredSerializeInternal抽象操作は、JavaScriptの値valueを入力として受け取り、それをレルムレルムに依存しない形にシリアル化し、ここではレコードとして表現されます。このシリアル化された形式には、後で異なるレルムで新しいJavaScriptの値にデシリアル化するために必要な情報がすべて含まれています。

このプロセスは、たとえばシリアル化できないオブジェクトをシリアル化しようとすると例外をスローすることがあります。

  1. memoryが提供されていない場合、memoryを空のマップとします。

    memoryマップの目的は、オブジェクトを2回シリアル化しないようにすることです。これにより、サイクルとグラフ内の重複するオブジェクトの同一性が保持されます。

  2. memory[value]が存在する場合は、memory[value]を返します。

  3. deepをfalseに設定します。

  4. value が undefined、null、Boolean、Number、BigInt、またはStringの場合、{ [[Type]]: "primitive", [[Value]]: value } を返します。

  5. value がSymbol の場合、"DataCloneError" DOMException をスローします。

  6. serializedを未初期化の値に設定します。

  7. もしvalueが[[BooleanData]]内部スロットを持っている場合、serializedを{ [[Type]]: "Boolean", [[BooleanData]]: value.[[BooleanData]] }に設定します。

  8. それ以外の場合、valueが[[NumberData]]内部スロットを持っている場合、serializedを{ [[Type]]: "Number", [[NumberData]]: value.[[NumberData]] }に設定します。

  9. それ以外の場合、valueが[[BigIntData]] 内部スロットを持っている場合、serializedを{ [[Type]]: "BigInt", [[BigIntData]]: value.[[BigIntData]] }に設定します。

  10. それ以外の場合、valueが[[StringData]]内部スロットを持っている場合、serializedを{ [[Type]]: "String", [[StringData]]: value.[[StringData]] }に設定します。

  11. それ以外の場合、valueが[[DateValue]]内部スロットを持っている場合、serializedを{ [[Type]]: "Date", [[DateValue]]: value.[[DateValue]] }に設定します。

  12. それ以外の場合、valueが[[RegExpMatcher]]内部スロットを持っている場合、serializedを{ [[Type]]: "RegExp", [[RegExpMatcher]]: value.[[RegExpMatcher]], [[OriginalSource]]: value.[[OriginalSource]], [[OriginalFlags]]: value.[[OriginalFlags]] }に設定します。

  13. それ以外の場合、valueが[[ArrayBufferData]]内部スロットを持っている場合：

    1. もしIsSharedArrayBuffer(value)がtrueである場合：

      1. もし現在の設定オブジェクトのクロスオリジン隔離能力がfalseである場合、"DataCloneError" DOMExceptionをスローします。

        このチェックは、SharedArrayBufferがエージェントクラスターagent clusterを離れることができないため、シリアル化時（デシリアル化時ではない）にのみ必要です。

      2. もしforStorageがtrueである場合、"DataCloneError" DOMExceptionをスローします。

      3. もしvalueが[[ArrayBufferMaxByteLength]]内部スロットを持っている場合、serializedを{ [[Type]]: "GrowableSharedArrayBuffer", [[ArrayBufferData]]: value.[[ArrayBufferData]], [[ArrayBufferByteLengthData]]: value.[[ArrayBufferByteLengthData]], [[ArrayBufferMaxByteLength]]: value.[[ArrayBufferMaxByteLength]], [[AgentCluster]]: 周囲のエージェントのエージェントクラスター }に設定します。

      4. それ以外の場合、serializedを{ [[Type]]: "SharedArrayBuffer", [[ArrayBufferData]]: value.[[ArrayBufferData]], [[ArrayBufferByteLength]]: value.[[ArrayBufferByteLength]], [[AgentCluster]]: 周囲のエージェントのエージェントクラスター }に設定します。

    2. それ以外の場合：

      1. もしIsDetachedBuffer(value)がtrueである場合、"DataCloneError" DOMExceptionをスローします。

      2. sizeをvalue.[[ArrayBufferByteLength]]に設定します。

      3. dataCopyを?CreateByteDataBlock(size)に設定します。

        これは、割り当てに失敗した場合にRangeError例外をスローする可能性があります。

      4. 実行するCopyDataBlockBytes(dataCopy, 0, value.[[ArrayBufferData]], 0, size)。

      5. もしvalueが[[ArrayBufferMaxByteLength]]内部スロットを持っている場合、serializedを{ [[Type]]: "ResizableArrayBuffer", [[ArrayBufferData]]: dataCopy, [[ArrayBufferByteLength]]: size, [[ArrayBufferMaxByteLength]]: value.[[ArrayBufferMaxByteLength]] }に設定します。

      6. それ以外の場合、serializedを{ [[Type]]: "ArrayBuffer", [[ArrayBufferData]]: dataCopy, [[ArrayBufferByteLength]]: size }に設定します。

  14. それ以外の場合、valueが[[ViewedArrayBuffer]]内部スロットを持っている場合：

    1. もしIsArrayBufferViewOutOfBounds(value) がtrueである場合、"DataCloneError" DOMExceptionをスローします。

    2. bufferをvalueの[[ViewedArrayBuffer]]内部スロットの値に設定します。

    3. bufferSerializedを？StructuredSerializeInternal(buffer, forStorage, memory)に設定します。

    4. Assert: bufferSerialized.[[Type]]が"ArrayBuffer", "ResizableArrayBuffer", "SharedArrayBuffer", または "GrowableSharedArrayBuffer"であることを確認します。

    5. もしvalueが[[DataView]]内部スロットを持っている場合、serializedを{ [[Type]]: "ArrayBufferView", [[Constructor]]: "DataView", [[ArrayBufferSerialized]]: bufferSerialized, [[ByteLength]]: value.[[ByteLength]], [[ByteOffset]]: value.[[ByteOffset]] }に設定します。

    6. それ以外の場合：

      1. Assert: valueが[[TypedArrayName]] 内部スロットを持っていることを確認します。

      2. serializedを{ [[Type]]: "ArrayBufferView", [[Constructor]]: value.[[TypedArrayName]], [[ArrayBufferSerialized]]: bufferSerialized, [[ByteLength]]: value.[[ByteLength]], [[ByteOffset]]: value.[[ByteOffset]], [[ArrayLength]]: value.[[ArrayLength]] }に設定します。

  15. それ以外の場合、valueが[[MapData]]内部スロットを持っている場合：

    1. serializedを{ [[Type]]: "Map", [[MapData]]: 新しい空のリスト }に設定します。

    2. deepをtrueに設定します。

  16. それ以外の場合、valueが[[SetData]]内部スロットを持っている場合：

    1. serializedを{ [[Type]]: "Set", [[SetData]]: 新しい空のリスト }に設定します。

    2. deepをtrueに設定します。

  17. それ以外の場合、valueが[[ErrorData]]内部スロットを持ち、valueがプラットフォームオブジェクトでない場合：

    1. nameを？Get(value, "name")に設定します。

    2. もしnameが"Error", "EvalError", "RangeError", "ReferenceError", "SyntaxError", "TypeError", または"URIError"のいずれでもない場合、nameを"Error"に設定します。

    3. valueMessageDescを？value.[[GetOwnProperty]]("message")に設定します。

    4. もしIsDataDescriptor(valueMessageDesc) がfalseである場合、messageをundefinedに設定し、そうでない場合は？ToString(valueMessageDesc.[[Value]])に設定します。

    5. serializedを{ [[Type]]: "Error", [[Name]]: name, [[Message]]: message }に設定します。

    6. ユーザーエージェントは、stackプロパティなどのまだ指定されていない興味深い付随データのシリアル化された表現をserializedに添付するべきです。

      このデータの指定に関する進行中の作業については、Error Stacks提案を参照してください。[JSERRORSTACKS]

  18. それ以外の場合、valueが配列の異常オブジェクトである場合：

    1. valueLenDescriptorを？OrdinaryGetOwnProperty(value, "length")に設定します。

    2. valueLenをvalueLenDescriptor.[[Value]]に設定します。

    3. serializedを{ [[Type]]: "Array", [[Length]]: valueLen, [[Properties]]: 新しい空のリスト }に設定します。

    4. deepをtrueに設定します。

  19. それ以外の場合、valueがプラットフォームオブジェクトであり、それがシリアル化可能オブジェクトである場合：

    1. もしvalueが[[Detached]]内部スロットを持ち、その値がtrueである場合、"DataCloneError" DOMExceptionをスローします。

    2. typeStringをvalueの主要なインターフェースの識別子に設定します。

    3. serializedを{ [[Type]]: typeString }に設定します。

    4. deepをtrueに設定します。

  20. それ以外の場合、valueがプラットフォームオブジェクトである場合、"DataCloneError" DOMExceptionをスローします。

  21. それ以外の場合、もしIsCallable(value)がtrueである場合、"DataCloneError" DOMExceptionをスローします。

  22. それ以外の場合、もしvalueが[[Prototype]], [[Extensible]], または[[PrivateElements]]以外の内部スロットを持っている場合、"DataCloneError" DOMExceptionをスローします。

    たとえば、[[PromiseState]]や[[WeakMapData]]内部スロット。

  23. それ以外の場合、valueが異常なオブジェクトであり、valueが任意の%Object.prototype%に関連付けられた固有のオブジェクトでない場合、 "DataCloneError" DOMExceptionをスローします。

    たとえば、プロキシオブジェクト。

  24. それ以外の場合：

    1. serializedを{ [[Type]]: "Object", [[Properties]]: 新しい空のリスト }に設定します。

    2. deepをtrueに設定します。

    %Object.prototype%はこのステップとその後のステップによって処理されます。最終的な結果として、その異常性は無視され、デシリアル化後は空のオブジェクト（不変プロトタイプの異常オブジェクトではない）となります。

  25. Set memory[value]を serializedに設定します。

  26. もしdeepがtrueである場合：

    1. もしvalueが[[MapData]]内部スロットを持っている場合：

      1. copiedListを新しい空のリストに設定します。

      2. 各 レコード { [[Key]], [[Value]] } entryをvalue.[[MapData]]から実行します：

        1. copiedEntryを新しいレコード { [[Key]]: entry.[[Key]], [[Value]]: entry.[[Value]] }に設定します。

        2. もしcopiedEntry.[[Key]]が特別な値emptyでない場合、copiedEntryをcopiedListに追加します。

      3. 各 レコード { [[Key]], [[Value]] } entryをcopiedListから実行します：

        1. serializedKeyを？StructuredSerializeInternal(entry.[[Key]], forStorage, memory)に設定します。

        2. serializedValueを？StructuredSerializeInternal(entry.[[Value]], forStorage, memory)に設定します。

        3. 追加します { [[Key]]: serializedKey, [[Value]]: serializedValue }をserialized.[[MapData]]に。

    2. それ以外の場合、valueが[[SetData]]内部スロットを持っている場合：

      1. copiedListを新しい空のリストに設定します。

      2. 各 entryをvalue.[[SetData]]から実行します：

        1. もしentryが特別な値emptyでない場合、追加します entryをcopiedListに。

      3. 各 entryをcopiedListから実行します：

        1. serializedEntryを？StructuredSerializeInternal(entry, forStorage, memory)に設定します。

        2. 追加します serializedEntryをserialized.[[SetData]]に。

    3. それ以外の場合、valueがプラットフォームオブジェクトであり、シリアル化可能オブジェクトである場合、valueのシリアル化手順をvalueの主要なインターフェースに基づいて実行し、serializedおよびforStorageを考慮して実行します。

      シリアル化手順ではサブシリアル化を行う必要がある場合があります。これは、値subValueを入力として受け取り、StructuredSerializeInternal(subValue, forStorage, memory)を返す操作です。（言い換えれば、サブシリアル化は、この呼び出し内で一貫性を持たせるためにStructuredSerializeInternalを特化したものです。）

    4. それ以外の場合、!EnumerableOwnProperties(value, key)内の各keyについて：

      1. もし!HasOwnProperty(value, key) がtrueである場合：

        1. inputValueを？value.[[Get]](key, value)に設定します。

        2. outputValueを？StructuredSerializeInternal(inputValue, forStorage, memory)に設定します。

        3. 追加します { [[Key]]: key, [[Value]]: outputValue }をserialized.[[Properties]]に。

  27. serializedを返します。

RecordはStructuredSerializeInternalによって生成される際に、他のレコードへの「ポインタ」を含み、循環参照を作成する可能性があることを理解することが重要です。例えば、次のJavaScriptオブジェクトをStructuredSerializeInternalに渡すとき:

const o = {};
 o.myself = o;

次の結果が生成されます：

{
   [[Type]]: "Object",
   [[Properties]]: «
     {
       [[Key]]: "myself",
       [[Value]]: <a pointer to this whole structure>
     }
   »
 }

2.7.4 StructuredSerialize ( value )

  1. ?StructuredSerializeInternal(value, false)を返します。

2.7.5 StructuredSerializeForStorage ( value )

  1. ? StructuredSerializeInternal(value, true)を返します。

2.7.6 StructuredDeserialize ( serialized, targetRealm [ , memory ] )

構造化デシリアライズ抽象操作は、レコードserializedを入力として受け取り、これが以前にStructuredSerializeまたはStructuredSerializeForStorageによって生成されたものであれば、それをtargetRealmに作成された新しいJavaScript値にデシリアライズします。

このプロセスは、特にArrayBufferオブジェクトのような新しいオブジェクトのメモリを確保しようとしたときに、例外をスローする可能性があります。

  1. もしmemoryが提供されていない場合、memoryを空のマップとします。

    このmemoryマップの目的は、オブジェクトを二重にデシリアライズしないようにすることです。これにより、グラフ内の重複オブジェクトの循環とアイデンティティが保持されます。

  2. もしmemory[serialized]が存在する場合、memory[serialized]を返します。

  3. deepをfalseに設定します。

  4. valueを未初期化の値に設定します。

  5. もしserialized.[[Type]]が"primitive"である場合、valueをserialized.[[Value]]に設定します。

  6. それ以外の場合、もしserialized.[[Type]]が"Boolean"である場合、valueをtargetRealmに新たに作成されたBooleanオブジェクトに設定し、その[[BooleanData]]内部スロットの値をserialized.[[BooleanData]]に設定します。

  7. それ以外の場合、もしserialized.[[Type]]が"Number"である場合、valueをtargetRealmに新たに作成されたNumberオブジェクトに設定し、その[[NumberData]]内部スロットの値をserialized.[[NumberData]]に設定します。

  8. それ以外の場合、もしserialized.[[Type]]が"BigInt"である場合、valueをtargetRealmに新たに作成されたBigIntオブジェクトに設定し、その[[BigIntData]]内部スロットの値をserialized.[[BigIntData]]に設定します。

  9. それ以外の場合、もしserialized.[[Type]]が"String"である場合、valueをtargetRealmに新たに作成されたStringオブジェクトに設定し、その[[StringData]]内部スロットの値をserialized.[[StringData]]に設定します。

  10. それ以外の場合、もしserialized.[[Type]]が"Date"である場合、valueをtargetRealmに新たに作成されたDateオブジェクトに設定し、その[[DateValue]]内部スロットの値をserialized.[[DateValue]]に設定します。

  11. それ以外の場合、もしserialized.[[Type]]が"RegExp"である場合、valueをtargetRealmに新たに作成されたRegExpオブジェクトに設定し、その[[RegExpMatcher]]内部スロットの値をserialized.[[RegExpMatcher]]に、[[OriginalSource]]内部スロットの値をserialized.[[OriginalSource]]に、[[OriginalFlags]]内部スロットの値をserialized.[[OriginalFlags]]に設定します。

  12. それ以外の場合、もしserialized.[[Type]]が"SharedArrayBuffer"である場合：

    1. もしtargetRealmの対応するエージェントクラスタがserialized.[[AgentCluster]]と異なる場合、"DataCloneError" DOMExceptionをスローします。

    2. それ以外の場合、valueをtargetRealmに新たに作成されたSharedArrayBufferオブジェクトに設定し、その[[ArrayBufferData]]内部スロットの値をserialized.[[ArrayBufferData]]に、[[ArrayBufferByteLength]]内部スロットの値をserialized.[[ArrayBufferByteLength]]に設定します。

  13. それ以外の場合、もしserialized.[[Type]]が"GrowableSharedArrayBuffer"である場合：

    1. もしtargetRealmの対応するエージェントクラスタがserialized.[[AgentCluster]]と異なる場合、"DataCloneError" DOMExceptionをスローします。

    2. それ以外の場合、valueをtargetRealmに新たに作成されたSharedArrayBufferオブジェクトに設定し、その[[ArrayBufferData]]内部スロットの値をserialized.[[ArrayBufferData]]に、[[ArrayBufferByteLengthData]]内部スロットの値をserialized.[[ArrayBufferByteLengthData]]に、[[ArrayBufferMaxByteLength]]内部スロットの値をserialized.[[ArrayBufferMaxByteLength]]に設定します。

  14. それ以外の場合、もしserialized.[[Type]]が"ArrayBuffer"である場合、valueをtargetRealmに新たに作成されたArrayBufferオブジェクトに設定し、その[[ArrayBufferData]]内部スロットの値をserialized.[[ArrayBufferData]]に、[[ArrayBufferByteLength]]内部スロットの値をserialized.[[ArrayBufferByteLength]]に設定します。

    これが例外をスローした場合、それをキャッチし、その後"DataCloneError" DOMExceptionをスローします。

    このステップは、ArrayBufferオブジェクトを作成するためのメモリが十分に利用できない場合、例外をスローする可能性があります。

  15. それ以外の場合、もしserialized.[[Type]]が"ResizableArrayBuffer"である場合、valueをtargetRealmに新たに作成されたArrayBufferオブジェクトに設定し、その[[ArrayBufferData]]内部スロットの値をserialized.[[ArrayBufferData]]に、[[ArrayBufferByteLength]]内部スロットの値をserialized.[[ArrayBufferByteLength]]に、[[ArrayBufferMaxByteLength]]内部スロットの値をserialized.[[ArrayBufferMaxByteLength]]に設定します。

    これが例外をスローした場合、それをキャッチし、その後"DataCloneError" DOMExceptionをスローします。

    このステップは、ArrayBufferオブジェクトを作成するためのメモリが十分に利用できない場合、例外をスローする可能性があります。

  16. それ以外の場合、もしserialized.[[Type]]が"ArrayBufferView"である場合：

    1. deserializedArrayBufferを？StructuredDeserialize(serialized.[[ArrayBufferSerialized]], targetRealm, memory)に設定します。

    2. もしserialized.[[Constructor]]が"DataView"である場合、valueをtargetRealmに新たに作成されたDataViewオブジェクトに設定し、その[[ViewedArrayBuffer]]内部スロットの値をdeserializedArrayBufferに、[[ByteLength]]内部スロットの値をserialized.[[ByteLength]]に、[[ByteOffset]]内部スロットの値をserialized.[[ByteOffset]]に設定します。

    3. それ以外の場合、valueをtargetRealmに新たに作成された型付き配列オブジェクトに設定し、serialized.[[Constructor]]によって指定されたコンストラクタを使用し、その[[ViewedArrayBuffer]]内部スロットの値をdeserializedArrayBufferに、[[TypedArrayName]]内部スロットの値をserialized.[[Constructor]]に、[[ByteLength]]内部スロットの値をserialized.[[ByteLength]]に、[[ByteOffset]]内部スロットの値をserialized.[[ByteOffset]]に、そして[[ArrayLength]]内部スロットの値をserialized.[[ArrayLength]]に設定します。

  17. それ以外の場合、もしserialized.[[Type]]が"Map"である場合：

    1. valueをtargetRealmに新たに作成されたMapオブジェクトに設定し、その[[MapData]]内部スロットの値を新しい空のリストに設定します。

    2. deepをtrueに設定します。

  18. それ以外の場合、もしserialized.[[Type]]が"Set"である場合：

    1. valueをtargetRealmに新たに作成されたSetオブジェクトに設定し、その[[SetData]]内部スロットの値を新しい空のリストに設定します。

    2. deepをtrueに設定します。

  19. それ以外の場合、もしserialized.[[Type]]が"Array"である場合：

    1. outputProtoをtargetRealm.[[Intrinsics]].[[%Array.prototype%]]に設定します。

    2. valueを！ArrayCreate(serialized.[[Length]], outputProto)に設定します。

    3. deepをtrueに設定します。

  20. それ以外の場合、もしserialized.[[Type]]が"Object"である場合：

    1. valueをtargetRealmに新たに作成されたオブジェクトに設定します。

    2. deepをtrueに設定します。

  21. それ以外の場合、もしserialized.[[Type]]が"Error"である場合：

    1. prototypeを%Error.prototype%に設定します。

    2. もしserialized.[[Name]]が"EvalError"である場合、prototypeを%EvalError.prototype%に設定します。

    3. もしserialized.[[Name]]が"RangeError"である場合、prototype を%RangeError.prototype%に設定します。

    4. もしserialized.[[Name]]が"ReferenceError"である場合、prototypeを%ReferenceError.prototype%に設定します。

    5. もしserialized.[[Name]]が"SyntaxError"である場合、prototypeを%SyntaxError.prototype%に設定します。

    6. もしserialized.[[Name]]が"TypeError"である場合、prototypeを%TypeError.prototype%に設定します。

    7. もしserialized.[[Name]]が"URIError"である場合、prototypeを%URIError.prototype%に設定します。

    8. messageをserialized.[[Message]]に設定します。

    9. valueをOrdinaryObjectCreate(prototype, « [[ErrorData]] »)に設定します。

    10. messageDescをプロパティディスクリプタ{ [[Value]]: message, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }に設定します。

    11. もしmessageが未定義でない場合、！OrdinaryDefineOwnProperty(value, "message", messageDesc)を実行します。

    12. serializedに添付されたすべての関連データはデシリアライズされ、valueに添付されるべきです。

  22. それ以外の場合：

    1. interfaceNameをserialized.[[Type]]に設定します。

    2. もしinterfaceNameで識別されたインターフェースがtargetRealmで公開されていない場合、"DataCloneError" DOMExceptionをスローします。

    3. valueをinterfaceNameで識別されたインターフェースの新しいインスタンスに設定し、targetRealmで作成します。

    4. deepをtrueに設定します。

  23. 設定 memory[serialized]をvalueにします。

  24. もしdeepがtrueである場合：

    1. もしserialized.[[Type]]が"Map"である場合：

      1. 各 レコード { [[Key]], [[Value]] } entryについて、serialized.[[MapData]]:

        1. deserializedKeyを？StructuredDeserialize(entry.[[Key]], targetRealm, memory)に設定します。

        2. deserializedValueを？StructuredDeserialize(entry.[[Value]], targetRealm, memory)に設定します。

        3. 追加 { [[Key]]: deserializedKey, [[Value]]: deserializedValue }をvalue.[[MapData]]に。

    2. それ以外の場合、もしserialized.[[Type]]が"Set"である場合：

      1. 各 entryについて、 serialized.[[SetData]]:

        1. deserializedEntryを？StructuredDeserialize(entry, targetRealm, memory)に設定します。

        2. 追加 deserializedEntry をvalue.[[SetData]]に。

    3. それ以外の場合、もしserialized.[[Type]]が"Array"または"Object"である場合：

      1. 各 レコード { [[Key]], [[Value]] } entryについて、serialized.[[Properties]]:

        1. deserializedValueを？StructuredDeserialize(entry.[[Value]], targetRealm, memory)に設定します。

        2. resultを！CreateDataProperty(value, entry.[[Key]], deserializedValue)に設定します。

        3. アサート: resultがtrueであること。

    4. それ以外の場合：

      1. インターフェース識別子serialized.[[Type]]に対応するデシリアライズ手順を実行します。指定された インターフェース、serialized、value、および targetRealmに対して行います。

        デシリアライズ手順 は、サブデシリアライズを実行する必要があるかもしれません。これは、入力として以前にシリアライズされたレコードsubSerializedを取り、それをStructuredDeserialize(subSerialized, targetRealm, memory)として返します。 （言い換えれば、サブデシリアライズはStructuredDeserializeの特殊化であり、 この呼び出し内で一貫して行われることを保証します。）

  25. valueを返します。

2.7.7 StructuredSerializeWithTransfer ( value, transferList )

  1. memoryを空のマップに設定します。

    通常のStructuredSerializeInternalの使用法に加えて、 このアルゴリズムでは、memoryはtransferList内のアイテムを無視し、 代わりに独自の処理を行うためにも使用されます。

  2. 各transferableに対して、 transferList内の要素について実行します：

    1. もしtransferableが[[ArrayBufferData]]内部スロットを持たず、 [[Detached]]内部スロットも持っていない場合、 "DataCloneError" DOMExceptionをスローします。

    2. もしtransferableが[[ArrayBufferData]]内部スロットを持ち、かつIsSharedArrayBuffer(transferable)がtrueである場合、 "DataCloneError" DOMExceptionをスローします。

    3. もしmemory[transferable]が存在する場合、 "DataCloneError" DOMExceptionをスローします。

    4. 設定 memory[transferable]を{ [[Type]]: 未初期化の値 }にします。

      transferableはまだ転送されていません。転送には副作用が伴い、StructuredSerializeInternalがまず例外をスローできるようにする必要があります。

  3. serializedを？StructuredSerializeInternal(value, false, memory)に設定します。

  4. transferDataHoldersを新しい空のリストに設定します。

  5. 各transferableに対して、 transferList内の要素について実行します：

    1. もしtransferableが[[ArrayBufferData]]内部スロットを持ち、 IsDetachedBuffer(transferable)がtrueである場合、 "DataCloneError" DOMExceptionをスローします。

    2. もしtransferableが[[Detached]]内部スロットを持ち、transferable.[[Detached]]がtrueである場合、 "DataCloneError" DOMExceptionをスローします。

    3. dataHolderをmemory[transferable]に設定します。

    4. もしtransferableが[[ArrayBufferData]]内部スロットを持つ場合：

      1. もしtransferableが[[ArrayBufferMaxByteLength]]内部スロットを持つ場合：

        1. dataHolder.[[Type]]を"ResizableArrayBuffer"に設定します。

        2. dataHolder.[[ArrayBufferData]]をtransferable.[[ArrayBufferData]]に設定します。

        3. dataHolder.[[ArrayBufferByteLength]]をtransferable.[[ArrayBufferByteLength]]に設定します。

        4. dataHolder.[[ArrayBufferMaxByteLength]]をtransferable.[[ArrayBufferMaxByteLength]]に設定します。

      2. それ以外の場合：

        1. dataHolder.[[Type]]を"ArrayBuffer"に設定します。

        2. dataHolder.[[ArrayBufferData]]をtransferable.[[ArrayBufferData]]に設定します。

        3. dataHolder.[[ArrayBufferByteLength]]をtransferable.[[ArrayBufferByteLength]]に設定します。

      3. ？DetachArrayBuffer(transferable)を実行します。

        仕様は[[ArrayBufferDetachKey]]内部スロットを使用してArrayBufferがデタッチされないようにすることができます。これは、例えば WebAssembly JavaScript Interfaceで使用されます。[WASMJS]

    5. それ以外の場合：

      1. アサート: transferableはプラットフォームオブジェクトであり、 転送可能なオブジェクトです。

      2. interfaceNameをtransferableのプライマリインターフェース の識別子に設定します。

      3. dataHolder.[[Type]]をinterfaceNameに設定します。

      4. 指定されたインターフェースinterfaceNameに対応する転送手順をtransferableと dataHolderを使用して実行します。

      5. transferable.[[Detached]]をtrueに設定します。

    6. 追加 dataHolderをtransferDataHoldersに。

  6. { [[Serialized]]: serialized, [[TransferDataHolders]]: transferDataHolders }を返します。

2.7.8 StructuredDeserializeWithTransfer ( serializeWithTransferResult, targetRealm )

  1. memoryを空のマップに設定します。

    StructuredSerializeWithTransfer と同様に、通常のStructuredDeserializeでの使用方法に加えて、 このアルゴリズムでは、memoryが serializeWithTransferResult.[[TransferDataHolders]]内の項目を無視し、 独自の処理を行うためにも使用されます。

  2. transferredValuesを新しい空のリストに設定します。

  3. 各 transferDataHolderに対して、 serializeWithTransferResult.[[TransferDataHolders]]内の要素について実行します：

    1. valueを未初期化の値に設定します。

    2. もしtransferDataHolder.[[Type]]が"ArrayBuffer"である場合、 valueをtargetRealm内の新しいArrayBufferオブジェクトに設定し、 その[[ArrayBufferData]]内部スロットの値をtransferDataHolder.[[ArrayBufferData]]に、 その[[ArrayBufferByteLength]]内部スロットの値をtransferDataHolder.[[ArrayBufferByteLength]]に設定します。

      [[ArrayBufferData]]がデシリアライズ中にアクセス可能な場合、元のメモリが そのまま新しいArrayBufferに移されるため、新しいメモリの割り当てが必要ないため、 このステップで例外がスローされる可能性は低いです。例えば、ソースおよびターゲットの レルムが同じプロセス内にある場合などです。

    3. それ以外の場合、もしtransferDataHolder.[[Type]]が"ResizableArrayBuffer"である場合、 valueをtargetRealm内の新しいArrayBufferオブジェクトに設定し、 その[[ArrayBufferData]]内部スロットの値を transferDataHolder.[[ArrayBufferData]]に、 その[[ArrayBufferByteLength]]内部スロットの値を transferDataHolder.[[ArrayBufferByteLength]]に、 そして[[ArrayBufferMaxByteLength]]内部スロットの値を transferDataHolder.[[ArrayBufferMaxByteLength]]に設定します。

      前述の理由と同様に、このステップでも例外がスローされる可能性は低いです。

    4. それ以外の場合：

      1. interfaceNameをtransferDataHolder.[[Type]]に設定します。

      2. もしinterfaceNameで識別されたインターフェースが targetRealmに公開されていない場合、 "DataCloneError" DOMExceptionをスローします。

      3. valueをinterfaceNameで識別されたインターフェースの targetRealm内で作成された新しいインスタンスに設定します。

      4. 指定されたインターフェースinterfaceNameに対応する受信転送手順 をtransferDataHolderとvalueを使用して実行します。

    5. 設定 memory[transferDataHolder]を valueに。

    6. 追加 valueを transferredValuesに。

  4. deserializedを？ StructuredDeserialize(serializeWithTransferResult.[[Serialized]], targetRealm, memory)に設定します。

  5. { [[Deserialized]]: deserialized, [[TransferredValues]]: transferredValues }を返します。

2.7.9 他の仕様からのシリアライズと転送の実行

他の仕様では、ここで定義された抽象操作を使用することができます。以下は、各抽象操作が通常どのような場合に有用であるかについてのガイドラインと例を提供します。

StructuredSerializeWithTransfer
StructuredDeserializeWithTransfer

別のrealmに値を転送リストと共にクローンするが、ターゲットrealmが事前に知られていない場合。この場合、シリアライズステップは即座に実行でき、デシリアライズステップはターゲットrealmが判明するまで遅らせることができます。

messagePort.postMessage()はこの一対の抽象操作を使用しますが、MessagePortが出荷されるまで、宛先のrealmは知られません。

StructuredSerialize
StructuredSerializeForStorage
StructuredDeserialize

特定の値のRealmに依存しないスナップショットを作成し、それを無期限に保存し、後で再度JavaScriptの値として具現化することができ、場合によっては複数回行うことができます。

StructuredSerializeForStorageは、シリアライズされたデータがRealm間で渡されるのではなく、永続的に保存されることが予想される場合に使用できます。共有メモリを保存することには意味がないため、SharedArrayBufferオブジェクトをシリアライズしようとするとエラーが発生します。同様に、forStorage引数がtrueの場合、カスタムシリアライズ手順を持つプラットフォームオブジェクトが渡されたときに、エラーが発生するか、異なる動作をする可能性があります。

history.pushState()やhistory.replaceState()は、提供された状態オブジェクトに対してStructuredSerializeForStorageを使用し、それを適切なセッション履歴エントリにシリアライズされた状態として保存します。そして、StructuredDeserializeが使用され、history.stateプロパティが、最初に提供された状態オブジェクトのクローンを返せるようにします。

broadcastChannel.postMessage()は、入力にStructuredSerializeを使用し、結果に対してStructuredDeserializeを複数回使用し、ブロードキャストされる各宛先に新しいクローンを生成します。複数の宛先がある状況では転送は意味がないことに注意してください。

JavaScriptの値をファイルシステムに永続化するAPIは、入力に対してStructuredSerializeForStorageを使用し、出力に対してStructuredDeserializeを使用します。

一般的に、呼び出し側はJavaScript値の代わりにWeb IDL値を渡すことができ、その際はこれらのアルゴリズムを呼び出す前に暗黙の変換が行われると理解されます。

ユーザーエージェントメソッドに同期的にコールバックされる結果として呼び出されない呼び出しサイトは、StructuredSerialize、StructuredSerializeForStorage、またはStructuredSerializeWithTransfer抽象操作を実行する前に、スクリプトを実行する準備をしっかりと行い、コールバックを実行する準備をしっかりと行う必要があります。これは、シリアライズプロセスが最終的な深いシリアライズステップの一部として作成者定義のアクセサを呼び出す可能性があり、これらのアクセサが、entryとincumbentの概念が適切にセットアップされていることに依存する操作を呼び出す可能性があるためです。

window.postMessage()はその引数に対してStructuredSerializeWithTransferを実行しますが、アルゴリズムの同期部分内で即座にそれを行うため、このアルゴリズムを使用してもスクリプトを実行する準備やコールバックを実行する準備をする必要はありません。

対照的に、ある著者提供オブジェクトを定期的にStructuredSerializeを使ってシリアライズする仮想APIが、タスクをイベントループ上で直接実行する場合、適切な準備を事前に行う必要があります。現在のところ、プラットフォーム上でそのようなAPIは存在しませんが、通常は、著者コードの同期結果として、前もってシリアライズを実行する方が簡単です。

2.7.10 構造化クローンAPI

result = self.structuredClone(value[, { transfer }])

入力値を取得し、構造化クローンアルゴリズムを実行することでディープコピーを返します。転送可能オブジェクトがtransfer配列にリストされている場合、それらは単にクローンされるのではなく転送されます。つまり、それらは入力値内で使用できなくなります。

入力値の一部がシリアライズ可能でない場合は、"DataCloneError"DOMExceptionをスローします。

structuredClone

現在のすべてのエンジンでサポートされています。

Firefox94+Safari15.4+Chrome98+
Opera?Edge98+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

structuredClone(value, options) メソッドの手順は次のとおりです：

  1. serializedをStructuredSerializeWithTransfer(value, options["transfer"])に設定します。

  2. deserializeRecordをStructuredDeserializeWithTransfer(serialized, thisの関連するrealm)に設定します。

  3. deserializeRecord.[[Deserialized]]を返します。

3 HTML文書のセマンティクス、構造、およびAPI

3.1 文書

HTML UA内のすべてのXMLおよびHTML文書は、Documentオブジェクトによって表されます。[DOM]

Document オブジェクトのURLは、DOMで定義されています。これはDocument オブジェクトが作成されるときに最初に設定されますが、Document オブジェクトの存続期間中に変更される可能性があります。たとえば、ユーザーがページ上のフラグメントにナビゲートしたときや、pushState() メソッドが新しいURLで呼び出されたときに変更されます。[DOM]

インタラクティブなユーザーエージェントは、通常DocumentオブジェクトのURLをユーザーインターフェイスに表示します。これは、サイトが別のサイトになりすましているかどうかをユーザーが確認する主な手段です。

Document オブジェクトのオリジンは、DOMで定義されています。これはDocument オブジェクトが作成されるときに最初に設定され、Documentの存続期間中にdocument.domainを設定した場合にのみ変更できます。Documentのオリジンは、そのURLのオリジンと異なる場合があります。 たとえば、子ナビゲーション可能オブジェクトが作成されると、そのアクティブドキュメントのオリジンは、そのアクティブドキュメントのURLが about:blankであっても、その親のアクティブドキュメントのオリジンから継承されます。[DOM]

DocumentがcreateDocument()またはcreateHTMLDocument()メソッドを使用してスクリプトによって作成される場合、Documentはすぐにポストロードタスクの準備が整います。

文書のリファラーは、Documentが作成されるときに設定できる文字列（URLを表す）です。明示的に設定されていない場合、その値は空文字列です。

3.1.1 Documentオブジェクト

Document

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

DOM は、この仕様が大幅に拡張する Document インターフェイスを定義しています。

enum DocumentReadyState { "loading", "interactive", "complete" };
 enum DocumentVisibilityState { "visible", "hidden" };
 typedef (HTMLScriptElement or SVGScriptElement) HTMLOrSVGScriptElement;
 
 [LegacyOverrideBuiltIns]
 partial interface Document {
   static Document parseHTMLUnsafe((TrustedHTML or DOMString) html);
 
   // resource metadata management
   [PutForwards=href, LegacyUnforgeable] readonly attribute Location? location;
   attribute USVString domain;
   readonly attribute USVString referrer;
   attribute USVString cookie;
   readonly attribute DOMString lastModified;
   readonly attribute DocumentReadyState readyState;
 
   // DOM tree accessors
   getter object (DOMString name);
   [CEReactions] attribute DOMString title;
   [CEReactions] attribute DOMString dir;
   [CEReactions] attribute HTMLElement? body;
   readonly attribute HTMLHeadElement? head;
   [SameObject] readonly attribute HTMLCollection images;
   [SameObject] readonly attribute HTMLCollection embeds;
   [SameObject] readonly attribute HTMLCollection plugins;
   [SameObject] readonly attribute HTMLCollection links;
   [SameObject] readonly attribute HTMLCollection forms;
   [SameObject] readonly attribute HTMLCollection scripts;
   NodeList getElementsByName(DOMString elementName);
   readonly attribute HTMLOrSVGScriptElement? currentScript; // classic scripts in a document tree only
 
   // dynamic markup insertion
   [CEReactions] Document open(optional DOMString unused1, optional DOMString unused2); // both arguments are ignored
   WindowProxy? open(USVString url, DOMString name, DOMString features);
   [CEReactions] undefined close();
   [CEReactions] undefined write((TrustedHTML or DOMString)... text);
   [CEReactions] undefined writeln((TrustedHTML or DOMString)... text);
 
   // user interaction
   readonly attribute WindowProxy? defaultView;
   boolean hasFocus();
   [CEReactions] attribute DOMString designMode;
   [CEReactions] boolean execCommand(DOMString commandId, optional boolean showUI = false, optional DOMString value = "");
   boolean queryCommandEnabled(DOMString commandId);
   boolean queryCommandIndeterm(DOMString commandId);
   boolean queryCommandState(DOMString commandId);
   boolean queryCommandSupported(DOMString commandId);
   DOMString queryCommandValue(DOMString commandId);
   readonly attribute boolean hidden;
   readonly attribute DocumentVisibilityState visibilityState;
 
   // special event handler IDL attributes that only apply to Document objects
   [LegacyLenientThis] attribute EventHandler onreadystatechange;
   attribute EventHandler onvisibilitychange;
 
   // also has obsolete members
 };
 Document includes GlobalEventHandlers;

Documentごとにポリシーコンテナ（ポリシーコンテナ）があり、最初は新しいポリシーコンテナであり、Documentに適用されるポリシーを含みます。

Documentごとに権限ポリシーがあり、これは権限ポリシーであり、最初は空です。

Documentごとにモジュールマップがあり、これはモジュールマップであり、最初は空です。

Documentごとにオープナーポリシーがあり、これはオープナーポリシーであり、最初は新しいオープナーポリシーです。

Documentごとに初期about:blankフラグがあり、これはブール値で、最初はfalseです。

DocumentごとにWebDriver BiDiの読み込み中のナビゲーションIDがあり、これはナビゲーションIDまたはnullであり、最初はnullです。

名前が示すように、これはWebDriver BiDi仕様とのインターフェースに使用され、このDocumentを作成したナビゲーションが進行中のナビゲーションであったときに使用された元のナビゲーションIDに結び付けられる方法で、Documentのライフサイクルの初期段階で発生する特定の出来事について通知する必要があります。これは最終的に、WebDriver BiDiが読み込みプロセスを終了と見なした後にnullに戻されます。[BIDI]

DocumentごとにaboutベースURLがあり、これはURLまたはnullで、最初はnullです。

これは「about:」スキームを持つDocumentにのみ設定されます。

Documentごとにbfcacheブロッキングの詳細があり、これはセットであり、復元されなかった理由の詳細が含まれ、最初は空です。

各Documentは開いているダイアログリストを持ちます。これはdialog要素のリストであり、最初は空です。

3.1.2 DocumentOrShadowRootインターフェイス

DOMはDocumentOrShadowRootミックスインを定義しており、この仕様はそれを拡張します。 

partial interface mixin DocumentOrShadowRoot {
   readonly attribute Element? activeElement;
 };

3.1.3 リソースメタデータ管理

document.referrer

Document/referrer

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

ユーザーがこのページにナビゲートした元のDocumentのURLを返します。ただし、ブロックされているか、元のドキュメントが存在しない場合は、空の文字列を返します。

noreferrerリンクタイプを使用して、リファラーをブロックすることができます。

referrer属性は文書のリファラーを返さなければなりません。

document.cookie [ = value ]

Documentに適用されるHTTPクッキーを返します。クッキーが存在しない場合や、このリソースに適用できない場合は、空の文字列が返されます。

クッキーを設定することができ、要素のHTTPクッキーセットに新しいクッキーを追加します。

内容がiframeでsandbox属性を持つ場合など、不透明なオリジンにサンドボックス化されている場合、取得および設定時に"SecurityError" DOMExceptionがスローされます。

Document/cookie

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

cookie属性は、文書のURLで特定されたリソースのクッキーを表します。

以下のいずれかの条件に該当するDocumentオブジェクトは、クッキーに非対応のDocumentオブジェクトです:

(これはトラッキングベクターです。) 取得時に、ドキュメントがクッキー回避Documentオブジェクトである場合、ユーザーエージェントは空の文字列を返さなければなりません。そうでない場合、Documentのオリジンが不透明なオリジンである場合、ユーザーエージェントは"SecurityError"DOMExceptionをスローしなければなりません。そうでない場合、ユーザーエージェントはドキュメントのURLに対してクッキー文字列を、"非HTTP" API用にBOMなしUTF-8デコードを使用して返さなければなりません。[COOKIES]

設定時に、文書がクッキーに非対応のDocumentオブジェクトである場合、ユーザーエージェントは何もしないでください。それ以外の場合、文書のオリジンが不透明なオリジンである場合、ユーザーエージェントは"SecurityError" DOMExceptionをスローしなければなりません。それ以外の場合、ユーザーエージェントは、文書のURLに対して新しい値を含むSet-Cookie文字列を受信したときと同様に、BOMなしでUTF-8エンコードされた値を使用して、非HTTP API経由で操作する必要があります。[COOKIES] [ENCODING]

cookie属性はフレームを超えてアクセス可能であるため、クッキーのパス制限は、サイトのどの部分にどのクッキーが送信されるかを管理するためのツールであり、セキュリティ機能ではありません。

cookie属性のゲッターとセッターは、共有状態に同期的にアクセスします。ロック機構がないため、マルチプロセスユーザーエージェントの他のブラウジングコンテキストがスクリプト実行中にクッキーを変更する可能性があります。例えば、サイトがクッキーを読み取り、その値を増加させ、次にそれを再設定し、その新しいクッキーの値をセッションの一意識別子として使用しようとした場合、同時に2つの異なるブラウザウィンドウでこれを行うと、両方のセッションに同じ「一意」の識別子を使用してしまう可能性があり、結果的に重大な影響を及ぼす可能性があります。

document.lastModified

Document/lastModified

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ドキュメントの最終変更日をサーバーから報告された形式で、ユーザーのローカルタイムゾーンで"MM/DD/YYYY hh:mm:ss"の形式で返します。

最終変更日が不明な場合、代わりに現在の時刻が返されます。

lastModified属性は、取得時にDocumentのソースファイルの最終変更日時をユーザーのローカルタイムゾーンで次の形式で返さなければなりません。

  1. 日付の月の部分。

  2. U+002F SOLIDUS文字（/）。

  3. 日付の日の部分。

  4. U+002F SOLIDUS文字（/）。

  5. 日付の年の部分。

  6. U+0020 SPACE文字。

  7. 時刻の時間の部分。

  8. U+003A COLON文字（:）。

  9. 時刻の分の部分。

  10. U+003A COLON文字（:）。

  11. 時刻の秒の部分。

上記の数値部分（年を除く）はすべて、必要に応じてゼロパディングされた2桁のASCII数字で10進数を表さなければなりません。年は、必要に応じてゼロパディングされた4桁以上の最短の文字列として、10進数を表すASCII数字として表さなければなりません。

Documentのソースファイルの最終変更日時は、使用されるネットワーキングプロトコルの関連機能、例としてドキュメントのHTTP `Last-Modified` ヘッダーの値や、ローカルファイルのファイルシステム内のメタデータから派生させなければなりません。最終変更日時が不明な場合、この属性は上記の形式で現在の日時を返さなければなりません。

3.1.4 ドキュメント読み込みステータスの報告

document.readyState

Documentが読み込み中の場合は"loading"、パースが完了しサブリソースの読み込みが続いている場合は"interactive"、すべて読み込みが完了した場合は"complete"を返します。

この値が変わると、readystatechangeイベントがDocumentオブジェクトで発生します。

DOMContentLoadedイベントは、"interactive"に遷移した後、"complete"に遷移する前に、async属性を持つscript要素以外のすべてのサブリソースが読み込まれた時点で発生します。

Document/readyState

すべての現在のエンジンでサポートされています。

Firefox3.6+ Safari1+ Chrome1+
Opera11+ Edge79+
Edge (Legacy)12+ Internet Explorer11
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11+

各Documentは、現在のドキュメントの準備状態を持ちます。これは文字列で、初期状態は"complete"です。

「Document」オブジェクトを作成および初期化する アルゴリズムを介して作成されたDocumentオブジェクトの場合、どのスクリプトもdocument.readyStateの値を確認する前に、この値はすぐに「loading」にリセットされます。 このデフォルトは、初期about:blank Documentオブジェクトや、ブラウジングコンテキストを持たないDocumentオブジェクトにも適用されます。

readyStateのゲッターステップは、thisの現在のドキュメントの準備状態を返すことです。

DocumentdocumentのreadinessValueを現在のドキュメントの準備状態を更新するには：

  1. documentの現在のドキュメントの準備状態がreadinessValueと等しい場合は、リターンします。

  2. documentの現在のドキュメントの準備状態をreadinessValueに設定します。

  3. documentがHTMLパーサーに関連付けられている場合：

    1. nowを、現在の高精度時間をdocumentの関連するグローバルオブジェクトに基づいて取得します。

    2. readinessValueが"complete"であり、documentのロードタイミング情報のDOM完了時間が0である場合、documentのロードタイミング情報のDOM完了時間をnowに設定します。

    3. それ以外の場合で、readinessValueが"interactive"であり、documentのロードタイミング情報のDOMインタラクティブ時間が0である場合、documentのロードタイミング情報のDOMインタラクティブ時間をnowに設定します。

  4. イベントを発火します。名前はreadystatechangeです。documentで発生します。

Documentは、HTMLパーサーまたはXMLパーサーに関連付けられており、まだ停止または中断されていない場合、アクティブパーサーを持っていると言われます。

Documentはドキュメントのロードタイミング情報ロードタイミング情報を持っています。

Documentは、ドキュメントのアンロードタイミング情報前のドキュメントアンロードタイミングを持っています。

Documentは、クロスオリジンリダイレクトによって作成されたというブール値を持ちます。初期状態はfalseです。

ドキュメントのロードタイミング情報構造体には、以下の項目があります。

ナビゲーション開始時間 (デフォルト 0)
数値
DOMインタラクティブ時間 (デフォルト 0)
DOMコンテンツロードイベント開始時間 (デフォルト 0)
DOMコンテンツロードイベント終了時間 (デフォルト 0)
DOM完了時間 (デフォルト 0)
ロードイベント開始時間 (デフォルト 0)
ロードイベント終了時間 (デフォルト 0)
DOMHighResTimeStamp値

ドキュメントのアンロードタイミング情報構造体には、以下の項目があります。

アンロードイベント開始時間 (デフォルト 0)
アンロードイベント終了時間 (デフォルト 0)
DOMHighResTimeStamp値

3.1.5 レンダーブロッキングメカニズム

各Documentは、最初は空のセットであるレンダーブロッキング要素セット（セット）を持ちます。

次の条件が成立する場合、Document documentはレンダーブロッキング要素を追加することができます。 documentのコンテンツタイプが「text/html」であり、documentのボディ要素がnullである場合です。

次の条件が両方とも真である場合、Document documentはレンダーブロックされます。

要素elは、elのノードドキュメント documentがレンダーブロックされている場合、かつelがdocumentのレンダーブロッキング要素セットに含まれている場合、レンダーブロッキングと見なされます。

要素elに対してレンダーブロッキングを行うには：

  1. elのノードドキュメントをdocumentとします。

  2. もしdocumentがレンダーブロッキング要素を追加することを許可している場合は、セットに追加します。elをdocumentのレンダーブロッキング要素セットに追加します。

要素elに対してレンダーブロックを解除するには：

  1. elのノードドキュメントをdocumentとします。

  2. 削除します。elをdocumentのレンダーブロッキング要素セットから削除します。

あるレンダーブロッキング要素elがブラウジングコンテキストとの接続が切れるか、elのブロッキング属性の値が変更されてelがもはや潜在的にレンダーブロッキングでなくなる場合、レンダーブロックを解除します。

3.1.6 DOMツリーアクセサ

文書のhtml要素は、html要素であればその文書要素となり、そうでなければnullです。

document.head

Document/head

現在のすべてのエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera11+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS4+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

head要素を返します。

文書のhead要素は、head要素が存在すれば、html要素の最初の子であり、そうでなければnullです。

head属性は、取得時に、文書のhead要素（head要素またはnull）を返さなければなりません。

document.title [ = value ]

文書のタイトルを返します。HTMLではtitle要素によって、SVGではSVGのtitle要素によって定義されます。

設定することもでき、文書のタイトルを更新します。適切な要素が存在しない場合、新しい値は無視されます。

文書のtitle要素は、文書内で最初に現れるtitle要素（ツリー順）であり、存在しない場合はnullです。

Document/title

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

title属性は、取得時に次のアルゴリズムを実行しなければなりません：

  1. もし文書要素がSVGsvg要素である場合、valueを最初のSVGtitle要素の子テキストコンテンツに設定します。

  2. それ以外の場合、valueを最初のtitle要素の子テキストコンテンツに設定し、title要素がnullの場合は空文字列に設定します。

  3. ASCII空白文字を削除および圧縮します。

  4. valueを返します。

設定時に、次のリストで最初に一致する条件に対応するステップを実行する必要があります：

もし文書要素がSVGsvg要素である場合

  1. もしSVGtitle要素がdocument elementの子である場合、最初のelementをその要素に設定します。

  2. それ以外の場合：

    1. element を、ドキュメント要素のノードドキュメント、「title」、およびSVG名前空間を指定して要素を作成した結果とします。

    2. elementを最初の子としてdocument elementに挿入します。

  3. 文字列をすべて置換し、新しい値をelementに設定します。

もし文書要素がHTML名前空間内にある場合

  1. title要素がnullで、head要素がnullである場合は、リターンします。

  2. もしtitle要素がnullでない場合、elementをtitle要素に設定します。

  3. それ以外の場合：

    1. element を、ドキュメント要素のノードドキュメント、「title」、およびHTML名前空間を指定して要素を作成した結果とします。

    2. 新しい値ををhead要素に挿入します。

  4. 文字列をすべて置換し、新しい値をelementに設定します。

それ以外の場合

何もしません。

document.body [ = value ]

Document/body

現在のすべてのエンジンでサポートされています。

Firefox60+Safari1+Chrome1+
Opera9.6+Edge79+
Edge (レガシー)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

body要素を返します。

設定することもでき、body要素を置き換えます。

新しい値がbody要素やframeset要素でない場合は、"HierarchyRequestError" DOMExceptionをスローします。

文書のbody要素は、html要素の子の中で最初に現れるbody要素またはframeset要素であり、該当する要素がない場合はnullです。

body属性は、取得時に、文書のbody要素（body要素またはframeset要素、もしくはnull）を返さなければなりません。設定時には、次のアルゴリズムを実行する必要があります：

  1. 新しい値がbody要素やframeset要素でない場合、"HierarchyRequestError" DOMExceptionをスローします。
  2. それ以外の場合、新しい値がbody要素と同じであれば、リターンします。
  3. それ以外の場合、body要素がnullでなければ、新しい値でbody要素を置き換え、リターンします。
  4. それ以外の場合、文書要素が存在しない場合、"HierarchyRequestError" DOMExceptionをスローします。
  5. それ以外の場合、body要素がnullですが、文書要素が存在します。新しい値を文書要素に挿入します。

getterによって返されるbody属性の値は、必ずしもsetterに渡されたものとは限りません。

この例では、セッターが正常にbody要素を挿入します（ただし、これは非準拠です。SVG はSVG svgの子としてbodyを許可していないため）。しかし、ゲッターはドキュメント要素がhtmlでないため、nullを返します。 

<svg xmlns="http://www.w3.org/2000/svg">
  <script>
   document.body = document.createElementNS("http://www.w3.org/1999/xhtml", "body");
   console.assert(document.body === null);
  </script>
 </svg>
document.images

Document/images

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTML ドキュメント内の img 要素の HTMLCollection を返します。

document.embeds

Document/embeds

すべての現在のエンジンでサポートされています。

Firefox1+Safari10.1+Chrome64+
Opera51+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+
document.plugins

Document/plugins

すべての現在のエンジンでサポートされています。

Firefox1+Safari10.1+Chrome64+
Opera51+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android?Safari iOS10.3+Chrome Android?WebView Android?Samsung Internet?Opera Android47+

HTML ドキュメント内の embed 要素の HTMLCollection を返します。

document.links

Document/links

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTML ドキュメント内の a および area 要素の HTMLCollection を返します。これらの要素は href 属性を持ちます。

document.forms

Document/forms

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTML ドキュメント内の form 要素の HTMLCollection を返します。

document.scripts

Document/scripts

すべての現在のエンジンでサポートされています。

Firefox9+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTML ドキュメント内の script 要素の HTMLCollection を返します。

images 属性は、Document ノードにルート化された HTMLCollection を返す必要があります。このフィルタは、img 要素にのみ一致します。

embeds 属性は、Document ノードにルート化された HTMLCollection を返す必要があります。このフィルタは、embed 要素にのみ一致します。

plugins 属性は、embeds 属性によって返されるものと同じオブジェクトを返す必要があります。

links 属性は、Document ノードにルート化された HTMLCollection を返す必要があります。このフィルタは、a 要素の href 属性および area 要素の href 属性にのみ一致します。

forms 属性は、Document ノードにルート化された HTMLCollection を返す必要があります。このフィルタは、form 要素にのみ一致します。

scripts 属性は、Document ノードにルート化された HTMLCollection を返す必要があります。このフィルタは、script 要素にのみ一致します。

collection = document.getElementsByName(name)

Document/getElementsByName

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera5+Edge79+
Edge (Legacy)12+Internet Explorer5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

指定された name 値を持つ NodeList を返します。この要素は、Document 内に存在します。

getElementsByName(elementName) メソッドは、指定された elementName 値を持つ要素を含む、ライブの NodeList を返します。この NodeList は、ツリー順に並べられた、name 属性が elementName 引数と同一であるすべての HTML 要素 から構成されます。Document オブジェクトで同じ引数を指定してメソッドを再度呼び出すと、ユーザーエージェントは以前の呼び出しで返されたオブジェクトと同じものを返すことがあります。それ以外の場合、新しい NodeList オブジェクトを返す必要があります。

document.currentScript

Document/currentScript

現在のすべてのエンジンでサポートされています。

Firefox4+Safari8+Chrome29+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

クラシックスクリプト を表す限り、現在実行中の script 要素、または SVG script 要素を返します。再入可能なスクリプト実行の場合、まだ実行が完了していないスクリプトの中で最も最近実行を開始したものを返します。

Document が現在 script 要素や SVG script 要素を実行していない場合 (例: 実行中のスクリプトがイベントハンドラやタイムアウトであるため)、または現在実行中の script 要素や SVG script 要素が モジュールスクリプト を表す場合は、null を返します。

currentScript 属性は、取得時に最後に設定された値を返さなければなりません。Document が作成されるとき、currentScript は null に初期化されなければなりません。

この API は、script 要素や SVG script 要素をグローバルに公開するため、実装者および標準化コミュニティでの支持を失っています。そのため、モジュールスクリプト を実行するときや、シャドウツリー 内でスクリプトを実行するときなど、新しいコンテキストでは利用できません。このようなコンテキストで実行中のスクリプトを識別する新しいソリューションを作成することを検討していますが、それはグローバルに公開されないようにする予定です: issue #1013 を参照してください。

Document インターフェースは、名前付きプロパティ をサポートします。任意の時点で Document オブジェクト document の サポートされるプロパティ名 は、後の重複を無視して、それらを提供する要素に従って ツリー順 で構成され、同じ要素が両方に寄与する場合は、id 属性からの値が name 属性からの値よりも前に来るものとします。

名前付きプロパティ name の値を Document に対して決定するために、ユーザーエージェントは次の手順を使用して取得された値を返す必要があります。

  1. elements を、Document を ルート とするドキュメントツリー内で name という名前を持つ 名前付き要素 のリストとします。

    アルゴリズムが Web IDL によって 呼び出されない限り、少なくとも1つの要素が存在します。

  2. elements に要素が1つだけ含まれており、その要素が iframe 要素で、その iframe 要素の コンテンツナビゲーブル が null でない場合、その要素の アクティブな WindowProxy を返します。

  3. それ以外の場合、elements に要素が1つだけ含まれている場合、その要素を返します。

  4. それ以外の場合、name という名前を持つ 名前付き要素 のみを一致させるフィルタを持つ HTMLCollection を Document ノードにルート化されたものとして返します。

名前付き要素は、上記のアルゴリズムの目的において、以下のいずれかに該当する要素です。

embed 要素または object 要素は、公開された 先祖が存在せず、object 要素において、フォールバックコンテンツを表示していないか、object または embed 子孫が存在しない場合に 公開された とみなされます。

dir 属性は、Document インターフェース上で、dir コンテンツ属性とともに定義されています。

3.2 要素

3.2.1 セマンティクス

HTMLの要素、属性、および属性値は、この仕様によって特定の意味（セマンティクス）を持つように定義されています。例えば、ol要素は順序付きリストを表し、 lang属性はコンテンツの言語を表します。

これらの定義により、Webブラウザや検索エンジンなどのHTMLプロセッサが、作成者が考慮していなかったさまざまな文脈でドキュメントやアプリケーションを表示および利用できるようになります。

単純な例として、デスクトップコンピュータのWebブラウザのみを考慮して作成されたWebページを考えてみましょう:

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>My Page</title>
  </head>
  <body>
   <h1>Welcome to my page</h1>
   <p>I like cars and lorries and have a big Jeep!</p>
   <h2>Where I live</h2>
   <p>I live in a small hut on a mountain!</p>
  </body>
 </html>

HTMLは意味を伝えるものであり、見た目を表現するものではないため、同じページが小さなモバイルフォンのブラウザでも利用できます。例えば、デスクトップで見出しが大きな文字で表示される場合でも、モバイルフォンのブラウザではページ全体で同じサイズの文字を使用し、見出しは太字で表示されるかもしれません。

さらに、画面サイズの違いだけでなく、同じページを視覚障害者が音声合成をベースにしたブラウザを使用して閲覧することもできます。この場合、ページは画面に表示されるのではなく、例えばヘッドホンを通じて音声でユーザーに読み上げられます。見出しには大きな文字を使用する代わりに、音声ブラウザでは異なる音量や遅い速度の声を使用することがあります。

それだけではありません。ブラウザはページのどの部分が見出しであるかを知っているため、ユーザーがドキュメントを迅速に移動できるようなドキュメントアウトラインを作成し、「次の見出しにジャンプ」や「前の見出しにジャンプ」するキーを使用して、ページ内をすばやく移動できる機能を提供することができます。これらの機能は、特に音声ブラウザで一般的であり、ユーザーがページをすばやく移動するのが難しい場合に便利です。

ブラウザを超えても、この情報は活用されます。検索エンジンは見出しを使用してページを効果的にインデックス化したり、検索結果からページ内のサブセクションへのクイックリンクを提供したりすることができます。ツールは見出しを使用して目次を作成することができ、この仕様の目次も実際にはそのように生成されています。

この例では見出しに焦点を当てましたが、同じ原則がHTML内のすべてのセマンティクスに適用されます。

作成者は、要素、属性、または属性値を、それらの適切なセマンティックな目的以外の目的で使用してはなりません。そうすると、ソフトウェアがページを正しく処理できなくなるからです。

例えば、以下のコードスニペットは、企業サイトの見出しを表すことを意図していますが、2行目はサブセクションの見出しとしてではなく、単にサブヘッディングまたはサブタイトル（同じセクションの補助的な見出し）として表示されるため、非準拠です。 

<body>
  <h1>ACME Corporation</h1>
  <h2>The leaders in arbitrary fast delivery since 1920</h2>
  ...

このような状況にはhgroup要素を使用することができます: 

<body>
  <hgroup>
   <h1>ACME Corporation</h1>
   <p>The leaders in arbitrary fast delivery since 1920</p>
  </hgroup>
  ...

次の例では、文法的には正しいにもかかわらず、セルに配置されたデータが明らかに表形式データではなく、cite要素が誤用されているため、同様に非準拠です:

<!DOCTYPE HTML>
 <html lang="en-GB">
  <head> <title> Demonstration </title> </head>
  </body>
   <table>
    <tr> <td> My favourite animal is the cat. </td> </tr>
    <tr>
     <td>
      —<a href="https://example.org/~ernest/"><cite>Ernest</cite></a>,
      in an essay from 1992
     </td>
    </tr></table></body></html>

これにより、これらのセマンティクスに依存するソフトウェアが誤動作することになります。例えば、視覚障害者がドキュメント内の表をナビゲートできる音声ブラウザは、上記の引用を表として報告し、ユーザーを混乱させるでしょう。同様に、ページから作品のタイトルを抽出するツールは、「Ernest」を作品のタイトルとして抽出してしまいますが、実際にはそれは作品のタイトルではなく人名です。

このドキュメントの修正バージョンは次のようになります:

<!DOCTYPE HTML>
 <html lang="en-GB">
  <head> <title> Demonstration </title> </head>
  </body>
   <blockquote>
    <p> My favourite animal is the cat. </p>
   </blockquote>
   <p>
    —<a href="https://example.org/~ernest/">Ernest</a>,
    in an essay from 1992
   </p></body></html>

作成者は、この仕様または他の適用可能な仕様によって許可されていない要素、属性、または属性値を使用してはなりません。そうすることは、将来的に言語を拡張することを著しく困難にします。

次の例では、非準拠の属性値「carpet」と、この仕様で許可されていない非準拠の属性「texture」が含まれています:

<label>Carpet: <input type="carpet" name="c" texture="deep pile"></label>

このマークアップを正しくするための代替方法は次のとおりです:

<label>Carpet: <input type="text" class="carpet" name="c" data-texture="deep pile"></label>

DOMノードのノードドキュメントの閲覧コンテキストがnullである場合、 HTML構文の要件およびXML構文の要件を除き、すべてのドキュメント適合性要件が免除されます。

特に、template要素のtemplateコンテンツのノードドキュメントの閲覧コンテキストは nullです。例えば、コンテンツモデルの要件や、属性値のマイクロ構文要件はtemplate要素のtemplateコンテンツには適用されません。この例では、img要素が、template要素外では無効となるプレースホルダを持つ属性値を持っています。 

<template>
  <article>
   <img src="{{src}}" alt="{{alt}}">
   <h1></h1>
  </article>
 </template>

ただし、上記のマークアップで</h1>終了タグを省略すると、それはHTML構文の違反となり、適合性チェッカーによってエラーとしてフラグが立てられます。

スクリプトやその他のメカニズムを使用することで、ユーザーエージェントが処理中に、属性、テキスト、さらにはドキュメント全体の構造が動的に変化することがあります。ドキュメントの任意の瞬間におけるセマンティクスは、その瞬間のドキュメントの状態によって表され、そのためドキュメントのセマンティクスは時間とともに変化する可能性があります。ユーザーエージェントはこれが発生すると、ドキュメントの表示を更新しなければなりません。

HTMLにはprogress要素があり、プログレスバーを表します。その「value」属性がスクリプトによって動的に更新された場合、ユーザーエージェントは進行状況が変化していることを表示するためにレンダリングを更新します。

3.2.2 DOMの要素

DOM内のHTML要素を表すノードは、この仕様の関連セクションにリストされているインターフェースを実装し、スクリプトに公開しなければなりません。これには、HTML要素がXMLドキュメント内にある場合も含まれます。これらのドキュメントが別のコンテキストにある場合（例: XSLT変換内）でも同様です。

DOM内の要素は、物事を表現します。つまり、それらはセマンティクスとして知られる固有の意味を持っています。

例えば、ol要素は順序付きリストを表します。

要素は、明示的または暗黙的に参照（言及）されることがあります。DOM内の要素を明示的に参照する1つの方法は、その要素にid属性を付与し、そのid属性の値をフラグメントとして使用してハイパーリンクを作成することです。ただし、参照にはハイパーリンクは必須ではありません。要素を指す方法であれば何でもかまいません。

次のfigure要素を考えてみましょう。この要素にはid属性が付与されています:

<figure id="module-script-graph">
   <img src="module-script-graph.svg" alt="Module A depends on module B, which depends             on modules C and D.">
   <figcaption>Figure 27: a simple module graph</figcaption>
 </figure>

ハイパーリンクベースの参照は、次のようにa要素を使用して作成できます:

As we can see in <a href="#module-script-graph">figure 27</a>, ...

しかし、figure要素を参照する方法は他にも多くあります。例えば次のようなものがあります:

すべてのHTML要素のインターフェースが継承し、追加の要件がない要素が使用しなければならない基本的なインターフェースは、HTMLElementインターフェースです。

HTMLElement

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android1+Samsung Internet?Opera Android10.1+

HTMLUnknownElement

現在のすべてのエンジンでサポートされています。

Firefox1+Safari6+Chrome15+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+ 
[Exposed=Window]
interface HTMLElement : Element {
  [HTMLConstructor] constructor();

  // metadata attributes
  [CEReactions] attribute DOMString title;
  [CEReactions] attribute DOMString lang;
  [CEReactions] attribute boolean translate;
  [CEReactions] attribute DOMString dir;

  // user interaction
  [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
  [CEReactions] attribute boolean inert;
  undefined click();
  [CEReactions] attribute DOMString accessKey;
  readonly attribute DOMString accessKeyLabel;
  [CEReactions] attribute boolean draggable;
  [CEReactions] attribute boolean spellcheck;
  [CEReactions] attribute DOMString writingSuggestions;
  [CEReactions] attribute DOMString autocapitalize;
  [CEReactions] attribute boolean autocorrect;

  [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
  [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;

  ElementInternals attachInternals();

  // The popover API
  undefined showPopover(optional ShowPopoverOptions options = {});
  undefined hidePopover();
  boolean togglePopover(optional (TogglePopoverOptions or boolean) options = {});
  [CEReactions] attribute DOMString? popover;
};

dictionary ShowPopoverOptions {
  HTMLElement source;
};

dictionary TogglePopoverOptions : ShowPopoverOptions {
  boolean force;
};

HTMLElement includes GlobalEventHandlers;
HTMLElement includes ElementContentEditable;
HTMLElement includes HTMLOrSVGElement;

[Exposed=Window]
interface HTMLUnknownElement : HTMLElement {
  // Note: intentionally no [HTMLConstructor]
};

HTMLElementインターフェースには、さまざまな機能に関連するメソッドや属性が含まれており、そのため、このインターフェースのメンバーはこの仕様書のさまざまなセクションで説明されています。

nameという名前を持つ要素の要素インターフェースは、HTML名前空間で次のように決定されます:

  1. nameがapplet、bgsound、blink、isindex、keygen、multicol、nextid、またはspacerである場合、HTMLUnknownElementを返します。

  2. nameがacronym、basefont、big、center、nobr、noembed、noframes、plaintext、rb、rtc、strike、またはttである場合、HTMLElementを返します。

  3. nameがlistingまたはxmpである場合、HTMLPreElementを返します。

  4. それ以外の場合、この仕様でnameというローカル名に対応する要素タイプに適したインターフェースが定義されている場合、そのインターフェースを返します。

  5. 他の適用可能な仕様でnameに適したインターフェースが定義されている場合、そのインターフェースを返します。

  6. nameが有効なカスタム要素名である場合、HTMLElementを返します。

  7. HTMLUnknownElementを返します。

有効なカスタム要素名の場合にHTMLElementを使用するのは、将来のアップグレードが、HTMLElementからサブクラスへの線形遷移のみを引き起こし、HTMLUnknownElementから無関係なサブクラスへの横方向の遷移を引き起こさないようにするためです。

HTMLとSVGの要素間で共有される機能には、HTMLOrSVGElementインターフェースミックスインが使用されます: [SVG] 

interface mixin HTMLOrSVGElement {
  [SameObject] readonly attribute DOMStringMap dataset;
  attribute DOMString nonce; // intentionally no [CEReactions]

  [CEReactions] attribute boolean autofocus;
  [CEReactions] attribute long tabIndex;
  undefined focus(optional FocusOptions options = {});
  undefined blur();
};

HTMLでもSVGでもない要素の例としては、次のように作成されるものがあります:

const el = document.createElementNS("some namespace", "example");
 console.assert(el.constructor === Element);

3.2.3 HTML要素のコンストラクタ

カスタム要素機能をサポートするために、すべてのHTML要素には特別なコンストラクタ動作があります。これは、[HTMLConstructor]IDL拡張属性で示されます。これにより、以下に詳述されているように、特定のインターフェースオブジェクトが呼び出されたときに特定の動作を行うことが示されています。

[HTMLConstructor]拡張属性は引数を取らず、コンストラクタ操作にのみ表示される必要があります。これは、コンストラクタ操作に1回だけ表示され、インターフェースには、注釈付きのコンストラクタ操作のみが含まれ、他の操作は含まれない必要があります。注釈付きのコンストラクタ操作は、引数を取らないように宣言されなければなりません。

[HTMLConstructor]拡張属性で注釈されたコンストラクタ操作で宣言されたインターフェースには、次のオーバーライドされたコンストラクタステップがあります:

  1. NewTargetがアクティブ関数オブジェクトと等しい場合、TypeErrorをスローします。

    これは、カスタム要素がコンストラクタとして要素インターフェースを使用して定義されている場合に発生します:

    customElements.define("bad-1", HTMLButtonElement);
 new HTMLButtonElement();          // (1)
 document.createElement("bad-1");  // (2)

    この場合、HTMLButtonElementの実行中に（明示的に(1)のように、または暗黙的に(2)のように）、アクティブ関数オブジェクトとNewTargetはどちらもHTMLButtonElementです。このチェックがなければ、HTMLButtonElementのインスタンスをbad-1というローカル名で作成することが可能になります。

  2. registry を null とします。

  3. 周囲のエージェントのアクティブなカスタム要素コンストラクタマップ[NewTarget] が存在する場合：

    1. registry を周囲のエージェントの アクティブなカスタム要素コンストラクタマップ[NewTarget] に設定します。

    2. 周囲のエージェントの アクティブなカスタム要素コンストラクタマップ[NewTarget] を削除します。

  4. それ以外の場合、registry を現在のグローバルオブジェクトの関連付けられた Documentのカスタム要素レジストリに設定します。

  5. definition を、registry のカスタム要素定義セット内の、コンストラクタが NewTarget と等しいアイテムとします。そのようなアイテムがない場合は、TypeError をスローします。

    registry のカスタム要素定義セットには、undefined のコンストラクタを持つアイテムは存在できないため、このステップはHTML要素コンストラクタが関数として呼び出されることも防ぎます（その場合、NewTarget は undefined になります）。

  6. isValue を null とします。

  7. もしdefinitionのローカル名がdefinitionの名前と等しい場合（すなわち、definitionが自律カスタム要素のためのものである場合）、次のようにします:

    1. アクティブ関数オブジェクトがHTMLElementでない場合、TypeErrorをスローします。

      これは、カスタム要素がローカル名を拡張しないように定義されているが、HTMLElementでないクラスから継承している場合に発生します: 

      customElements.define("bad-2", class Bad2 extends HTMLParagraphElement {});

      この場合、Bad2のインスタンスを構築する際に発生する（暗黙的な）super()呼び出し中に、アクティブ関数オブジェクトはHTMLParagraphElementであり、HTMLElementではありません。

  8. それ以外の場合（すなわち、definitionがカスタマイズされた組み込み要素のためのものである場合）:

    1. valid local namesを、この仕様または他の適用可能な仕様で定義されたローカル名のリストとし、それがアクティブ関数オブジェクトを要素インターフェースとして使用します。

    2. valid local namesがdefinitionのローカル名を含まない場合、TypeErrorをスローします。

      これは、カスタム要素が特定のローカル名を拡張するように定義されているが、間違ったクラスから継承している場合に発生します:

      customElements.define("bad-3", class Bad3 extends HTMLQuoteElement {}, { extends: "p" });

      この場合、Bad3のインスタンスを構築する際に発生する（暗黙的な）super()呼び出し中に、valid local namesにはqとblockquoteが含まれていますが、definitionのローカル名はpであり、そのリストには含まれていません。

    3. isValueをdefinitionの名前に設定します。

  9. もしdefinitionの構築スタックが空であれば、次のようにします:

    1. elementをインターフェースを実装する新しいオブジェクトを内部的に作成することの結果とし、現在の領域とNewTargetを与えます。

    2. elementのノードドキュメントを現在のグローバルオブジェクトの関連するDocumentに設定します。

    3. elementの名前空間をHTML名前空間に設定します。

    4. elementの名前空間プレフィックスをnullに設定します。

    5. elementのローカル名をdefinitionのローカル名に設定します。

    6. elementのカスタム要素の状態を"custom"に設定します。

    7. elementのカスタム要素定義をdefinitionに設定します。

    8. elementのis valueをisValueに設定します。

    9. elementを返します。

    これは、作成者スクリプトがnew MyCustomElement()のようにして直接新しいカスタム要素を構築する場合に発生します。

  10. prototypeを？Get(NewTarget、"prototype")にします。

  11. prototype がObject ではない場合：

    1. realmを？GetFunctionRealm(NewTarget)に設定します。

    2. prototypeを、インターフェースプロトタイプオブジェクトのrealmに設定し、そのインターフェースがアクティブ関数オブジェクトのインターフェースと同じであるものとします。

    アクティブ関数オブジェクトの領域はrealmでない可能性があるため、私たちは領域を超えて「同じインターフェース」という一般的な概念を使用しています。インターフェースオブジェクトの等価性を探しているわけではありません。このフォールバック動作には、NewTargetの領域を使用し、適切なプロトタイプをそこに見つけることが含まれ、これはJavaScriptビルトインおよびWebIDLのインターフェースを実装する新しいオブジェクトを内部的に作成するアルゴリズムに類似した動作に一致するように設計されています。

  12. elementをdefinitionの構築スタックの最後のエントリとします。

  13. elementが既に構築済みのマーカーである場合、TypeErrorをスローします。

    これは、作成者コードがカスタム要素コンストラクタ内で非準拠である場合に発生します。例えば、super()を呼び出す前に、構築中のクラスの別のインスタンスを作成する場合などです: 

    let doSillyThing = true;
 
 class DontDoThis extends HTMLElement {
   constructor() {
     if (doSillyThing) {
       doSillyThing = false;
       new DontDoThis();// Now the construction stack will contain an already constructed marker.
     }

     // This will then fail with a TypeError:
     super(); 
   } 
 }

    これはまた、作成者コードがカスタム要素コンストラクタ内で非準拠であり、super()を2回呼び出す場合にも発生します。JavaScript仕様によれば、これは実際にはスーパークラスのコンストラクタ（すなわちこのアルゴリズム）を2回実行した後、エラーをスローします: 

    class DontDoThisEither extends HTMLElement { 
   constructor() { 
     super(); 
     // This will throw, but not until it has already called into the HTMLElement constructor
     super(); 
   } 
 }

  14. ？element.[[SetPrototypeOf]](prototype)を実行します。

  15. definitionの構築スタックの最後のエントリを既に構築済みのマーカーに置き換えます。

  16. elementを返します。

    このステップは通常、カスタム要素をアップグレードする際に達成されます。既存の要素が返され、カスタム要素コンストラクタ内のsuper()呼び出しが、その既存の要素をthisに割り当てます。

[HTMLConstructor]によって暗示されるコンストラクタ動作に加えて、いくつかの要素には名前付きコンストラクタもあります（これらは実際にはprototypeプロパティが変更されたファクトリ関数です）。

HTML要素の名前付きコンストラクタは、カスタム要素コンストラクタを定義する際のextends句でも使用できます： 

class AutoEmbiggenedImage extends Image { 
   constructor(width, height) { 
     super(width * 10, height * 10); 
   } 
 } 
 
 customElements.define("auto-embiggened", AutoEmbiggenedImage, { extends: "img" }); 
 
 const image = new AutoEmbiggenedImage(15, 20); 
 console.assert(image.width === 150); 
 console.assert(image.height === 200);

3.2.4 要素の定義

この仕様書の各要素には、以下の情報を含む定義があります:

カテゴリ

要素が属するカテゴリのリストです。これらは、各要素のコンテンツモデルを定義する際に使用されます。

この要素が使用されるコンテキスト

要素が使用される場所についての非規範的な説明です。この情報は、この要素を子として許可する要素のコンテンツモデルと重複しており、あくまで便宜のために提供されています。

簡単にするために、最も具体的な期待のみがリストされています。

例えば、すべてのフレージングコンテンツはフローコンテンツです。したがって、フレージングコンテンツである要素は、"フレージングコンテンツが期待される場所"としてのみリストされます。これは、より具体的な期待事項だからです。フローコンテンツが期待される場所では、フレージングコンテンツも期待され、その期待に応えることができます。

コンテンツモデル

要素の子および子孫として含まれるべきコンテンツの規範的な説明です。

text/htmlにおけるタグの省略

text/html構文で、開始および終了タグが省略できるかどうかについての非規範的な説明です。この情報は、省略可能なタグセクションで示される規範的要件と重複しており、便宜のために要素定義内で提供されています。

コンテンツ属性

要素に指定できる属性の規範的なリスト（禁止されていない限り）、およびそれらの属性に関する非規範的な説明です。（ダッシュの左側の内容が規範的であり、右側の内容は規範的ではありません。）

アクセシビリティに関する考慮事項

作成者向け: ARIAのrole属性およびaria-*属性の使用に関する適合要件は、ARIA in HTMLで定義されています。[ARIA] [ARIAHTML]

実装者向け: アクセシビリティAPIのセマンティクスを実装するためのユーザーエージェントの要件は、HTML Accessibility API Mappingsに定義されています。[HTMLAAM]

DOMインターフェース

その要素が実装しなければならないDOMインターフェースの規範的な定義です。

次に、その要素が表現する内容、および作成者や実装に適用される追加の規範的な適合基準の説明が続きます。例が含まれることもあります。

3.2.4.1 属性

属性値は文字列です。特に指定がない限り、HTML要素の属性値は空の文字列を含む任意の文字列であり、そのような属性値に指定できるテキストに制限はありません。

3.2.5 コンテンツモデル

この仕様で定義された各要素には、要素の期待されるコンテンツの説明であるコンテンツモデルがあります。HTML要素は、その要素のコンテンツモデルに記載された要件に一致するコンテンツを持たなければなりません。要素のコンテンツとは、DOM内のその要素の子要素を指します。

ASCIIホワイトスペースは、要素間では常に許可されています。ユーザーエージェントは、ソースマークアップ内の要素間にあるこれらの文字を、DOM内のテキストノードとして表現します。空のテキストノードや、それらの文字のみで構成されるテキストノードは、要素間ホワイトスペースと見なされます。

要素間ホワイトスペース、コメントノード、および処理命令ノードは、要素のコンテンツがその要素のコンテンツモデルに一致するかどうかを判断する際には無視されなければならず、文書や要素のセマンティクスを定義するアルゴリズムに従う際にも無視されなければなりません。

したがって、要素Aが他の要素Bによって前後に置かれているとされるのは、AとBが同じ親ノードを持ち、他の要素ノードやテキストノード（要素間ホワイトスペース以外）がそれらの間に存在しない場合です。同様に、要素が唯一の子であるとされるのは、その要素が要素間ホワイトスペース、コメントノード、および処理命令ノード以外の他のノードを含まない場合です。

作成者は、HTML要素を、各要素に定義された場所や他の仕様書で明示的に要求される場所以外のどこにも使用してはなりません。XML複合文書の場合、これらのコンテキストは、関連するコンテキストを提供するように定義された他の名前空間の要素内にある場合があります。

The Atom Syndication Formatはcontent要素を定義しています。そのtype属性がxhtmlの値を持つ場合、The Atom Syndication Formatはそれに単一のHTMLdiv要素を含むことを要求します。したがって、div要素はそのコンテキストで許可されていますが、これはこの仕様書で明示的に規範的に記述されているわけではありません。[ATOM]

さらに、HTML要素は親ノードを持たない孤立ノードである場合があります。

たとえば、td要素を作成し、スクリプト内のグローバル変数に保存することは、td要素が通常はtr要素内でのみ使用されるべきであるにもかかわらず、適合しています。 

var data = {
   name: "Banana",
   cell: document.createElement('td'),
 };
3.2.5.1 「何も含まない」コンテンツモデル

要素のコンテンツモデルが何も含まないの場合、その要素にはテキストノード（要素間ホワイトスペースを除く）や要素ノードを含めてはなりません。

コンテンツモデルが「何も含まない」ほとんどのHTML要素は、便宜上、空要素（終了タグを持たない要素）でもあります。しかし、これらは完全に別の概念です。

3.2.5.2 コンテンツの種類

HTMLの各要素は、似た特性を持つ要素をまとめる1つ以上のカテゴリに属します。この仕様書では、以下の広範なカテゴリが使用されています:

一部の要素は、この仕様書の他の部分で定義される他のカテゴリにも属します。

これらのカテゴリは次のように関連しています:

セクショニングコンテンツ、見出しコンテンツ、フレージングコンテンツ、埋め込みコンテンツ、およびインタラクティブコンテンツはすべてフローコンテンツの一種です。メタデータは時にはフローコンテンツです。メタデータとインタラクティブコンテンツは時にはフレージングコンテンツです。埋め込みコンテンツはフレージングコンテンツの一種でもあり、時にはインタラクティブコンテンツでもあります。

その他のカテゴリも特定の目的のために使用されます。例えば、フォームコントロールは、共通の要件を定義するためにいくつかのカテゴリを使用して指定されています。一部の要素には独自の要件があり、特定のカテゴリには該当しません。

3.2.5.2.1 メタデータコンテンツ

メタデータコンテンツは、他のコンテンツの表示や動作を設定したり、ドキュメントと他のドキュメントとの関係を設定したり、他の「帯域外」情報を伝達するコンテンツです。

主にメタデータ関連のセマンティクスを持つ他の名前空間の要素（例: RDF）もメタデータコンテンツです。

したがって、XMLシリアル化では、次のようにRDFを使用できます:

<html xmlns="http://www.w3.org/1999/xhtml"
       xmlns:r="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xml:lang="en">
  <head>
   <title>Hedral's Home Page</title>
   <r:RDF>
    <Person xmlns="http://www.w3.org/2000/10/swap/pim/contact#"
            r:about="https://hedral.example.com/#">
     <fullName>Cat Hedral</fullName>
     <mailbox r:resource="mailto:hedral@damowmow.com"/>
     <personalTitle>Sir</personalTitle>
    </Person>
   </r:RDF>
  </head>
  <body>
   <h1>My home page</h1>
   <p>I like playing with string, I guess. Sister says squirrels are fun
   too so sometimes I follow her to play with them.</p>
  </body>
 </html>

ただし、HTMLシリアル化ではこれはできません。

3.2.5.2.2 フローコンテンツ

文書やアプリケーションの本文で使用されるほとんどの要素は、フローコンテンツに分類されます。

3.2.5.2.3 区分化コンテンツ

区分化コンテンツは、headerおよびfooter要素の範囲を定義するコンテンツです。

3.2.5.2.4 見出しコンテンツ

見出しコンテンツは、セクションの見出しを定義します（区分化コンテンツ要素を使用して明示的にマークアップされているか、または見出しコンテンツ自体によって暗黙的に決定されます）。

3.2.5.2.5 フレージングコンテンツ

フレージングコンテンツは、文書のテキストおよび段落内でそのテキストをマークアップする要素です。フレージングコンテンツのまとまりが段落を形成します。

フレージングコンテンツとして分類された要素の多くは、フレージングコンテンツとして分類された要素しか含めることができず、フローコンテンツを含めることはできません。

テキストは、コンテンツモデルの文脈では、何もないか、テキストノードを意味します。テキストは単独でコンテンツモデルとして使用されることもありますが、フレージングコンテンツでもあり、要素間の空白（テキストノードが空であるか、ASCIIスペース文字のみが含まれている場合）にもなります。

テキストノードおよび属性値は、スカラー値でなければならず、非文字や制御文字（ただしASCIIスペース文字を除く）を含んではなりません。

この仕様には、テキストノードおよび属性値の正確な値に対して、文脈に応じた追加の制約が含まれています。

3.2.5.2.6 埋め込みコンテンツ

埋め込みコンテンツとは、別のリソースを文書に取り込むコンテンツや、他のボキャブラリーから文書に挿入されたコンテンツのことです。

HTML名前空間以外の名前空間からの要素で、メタデータではなくコンテンツを伝えるものは、この仕様で定義されたコンテンツモデルの目的のために、埋め込みコンテンツと見なされます。（例：MathMLやSVG。）

一部の埋め込みコンテンツ要素は、フォールバックコンテンツを持つことがあります。これは、外部リソースが使用できない場合（例：サポートされていないフォーマットであるため）に使用されるコンテンツです。要素定義には、フォールバックがある場合、その内容が記載されています。

3.2.5.2.7 インタラクティブコンテンツ

インタラクティブコンテンツとは、ユーザーの操作を目的としたコンテンツです。

3.2.5.2.8 触知可能なコンテンツ

一般的なルールとして、内容モデルがフローコンテンツまたは フレージングコンテンツのいずれかを許可する要素には、 hidden属性が指定されていない、 少なくとも1つの内容が触知可能なコンテンツである必要があります。

触知可能なコンテンツは、要素に 空でない内容を提供することで、要素を非空にします。例えば、空でないテキストや、 ユーザーが聞くことができるaudio要素、または video、img、 またはcanvas要素など、見ることができるもの、あるいは他のインタラクティブなものです（例えば、インタラクティブなフォームコントロール）。

ただし、この要件は厳密な要件ではありません。スクリプトによって後で埋められるプレースホルダーとして要素が使用される場合や、 テンプレートの一部であり、多くのページでは埋められるが、特定のページでは関連性がない場合など、要素が正当な理由で空である場合が多々あります。

適合チェッカーは、著者支援としてこの要件を満たしていない要素を見つけるためのメカニズムを提供することが推奨されます。

次の要素は触知可能なコンテンツです:

3.2.5.2.9 スクリプト支援要素

スクリプト支援要素は、それ自体では何も表現しない（すなわち、表示されない）要素ですが、スクリプトをサポートするために使用されます。例えば、ユーザーのための機能を提供します。

以下の要素はスクリプト支援要素です:

3.2.5.3 透明なコンテンツモデル

一部の要素は透明と表現され、そのコンテンツモデルの説明に「透明」という用語が使用されています。透明な要素のコンテンツモデルは、その親要素のコンテンツモデルから派生します。「透明」な部分に必要な要素は、透明な要素が含まれている親要素のコンテンツモデルの該当部分で必要とされる要素と同じです。

例えば、ins要素がruby要素の内部にある場合、その中にrt要素を含めることはできません。これは、ruby要素のコンテンツモデルでins要素が許可されている部分がフレージングコンテンツを許可する部分であり、rt要素はフレージングコンテンツではないためです。

透明な要素が互いに入れ子になっている場合、このプロセスを反復的に適用する必要があります。

次のマークアップフラグメントを考えてみましょう：

<p><object><ins><map><a href="/">Apples</a></map></ins></object></p>

「Apples」がa要素内で許可されているかどうかを確認するには、コンテンツモデルを調べます。a要素のコンテンツモデルは透過的であり、map要素、ins要素、object要素も同様です。object要素はp要素内にあり、そのコンテンツモデルは フレージングコンテンツです。したがって、テキストはフレージングコンテンツであるため、「Apples」は許可されます。

透明な要素に親要素がない場合、そのコンテンツモデルの「透明」な部分は、代わりにフローコンテンツを受け入れるものとして扱わなければなりません。

3.2.5.4 段落

このセクションで定義されている段落という用語は、p要素の定義だけでなく、より広範な文書の解釈方法を説明するために使用されます。ここで定義される段落の概念は、段落をマークアップするためのいくつかの方法の一つに過ぎません。

段落は通常、特定のトピックを扱う1つまたは複数の文を含むブロックのテキストとして構成されるフレージングコンテンツの流れですが、一般的なテーマのグループ化にも使用されます。例えば、住所も段落と見なされるし、フォームの一部、署名、または詩のスタンザも同様です。

次の例では、セクション内に2つの段落があります。また、段落ではないフレージングコンテンツを含む見出しもあります。コメントや要素間の空白が段落を形成しないことに注意してください。

<section>
   <h2>段落の例</h2>
   これはこの例の<em>最初の</em>段落です。
   <p>これは2番目の段落です。</p>
   <!-- これは段落ではありません。 -->
 </section>

フローコンテンツ内の段落は、a、ins、del、およびmap要素が問題を複雑にすることなく、文書がどのように見えるかに基づいて定義されます。これらの要素はハイブリッドコンテンツモデルを持ち、段落の境界をまたぐことができます。以下の最初の2つの例がそのことを示しています。

一般的に、段落の境界をまたぐ要素を持つことは避けた方が良いです。そのようなマークアップを維持することは困難です。

次の例では、前の例のマークアップを取り、insおよびdel要素をいくつかのマークアップの周りに配置して、テキストが変更されたことを示しています（この場合、変更はあまり意味をなさないかもしれません）。この例は、insおよびdel要素が含まれていても、前の例と全く同じ段落を持っていることに注意してください。ins要素は見出しと最初の段落の境界をまたぎ、del要素は2つの段落の間の境界をまたいでいます。

<section>
   <ins><h2>段落の例</h2>
   これはこの</ins>例の<em>最初の</em>段落です<del>。
   <p>これは2番目の段落です。</p></del>
   <!-- これは段落ではありません。 -->
 </section>

viewを、文書内のa、ins、del、およびmap要素をそのコンテンツで置き換えたDOMのビューとします。次に、view内で、他のタイプのコンテンツで中断されないフレージングコンテンツノードの兄弟関係の各流れについて、その流れの最初のノードをfirst、最後のノードをlastとします。そのような流れのうち、少なくとも1つのノードが埋め込みコンテンツでも要素間の空白でもない場合、元のDOMにそのfirstの直前からlastの直後まで段落が存在します（したがって、段落はa、ins、del、およびmap要素をまたぐことができます）。

適合性チェックツールは、段落が互いに重なっているケースについて著者に警告を出すことができます（これは、object、video、audio、およびcanvas要素を使用する場合、また、HTMLをさらに埋め込むことができる他の名前空間の要素、例えばSVG svgやMathML mathなどで間接的に発生することがあります）。

段落は、p要素によって明示的に形成されることもあります。

p要素は、個々の段落をラップするために使用でき、そうでなければフレージングコンテンツ以外のコンテンツが段落を互いに区切ることがない場合に使用されます。

次の例では、リンクが最初の段落の半分、2つの段落を区切る見出しのすべて、および2番目の段落の半分にまたがっています。リンクは段落と見出しをまたいでいます。

<header>
  Welcome!
  <a href="about.html">
   This is home of...
   <h1>The Falcons!</h1>
   The Lockheed Martin multirole jet fighter aircraft!
  </a>
  This page discusses the F-16 Fighting Falcon's innermost secrets.
 </header>

これを別の方法でマークアップし、今回は段落を明示的に示し、1つのリンク要素を3つに分割してみましょう:

<header>
  <p>Welcome! <a href="about.html">This is home of...</a></p>
  <h1><a href="about.html">The Falcons!</a></h1>
  <p><a href="about.html">The Lockheed Martin multirole jet
  fighter aircraft!</a> This page discusses the F-16 Fighting
  Falcon's innermost secrets.</p>
 </header>

段落がフォールバックコンテンツを定義する特定の要素を使用している場合、段落が重なる可能性があります。例えば、次のセクションでは:

<section>
  <h2>私の猫たち</h2>
  あなたは私の猫シミュレーターで遊ぶことができます。
  <object data="cats.sim">
   猫シミュレーターを見るには、次のリンクのいずれかを使用してください:
   <ul>
    <li><a href="cats.sim">シミュレーター ファイルをダウンロード</a>
    <li><a href="https://sims.example.com/watch?v=LYds5xY4INU">オンライン シミュレーターを使用</a>
   </ul>
   または、Mellblom ブラウザーにアップグレードしてください。
  </object>
  私はそれをとても誇りに思っています。
 </section>

5つの段落があります:

  1. object要素を含む、「あなたは私の猫シミュレーターで遊ぶことができます。object 私はそれをとても誇りに思っています。」という段落。
  2. 「猫シミュレーターを見るには、次のリンクのいずれかを使用してください。」という段落。
  3. 「シミュレーター ファイルをダウンロード」という段落。
  4. 「オンライン シミュレーターを使用」という段落。
  5. 「または、Mellblom ブラウザーにアップグレードしてください。」という段落。

最初の段落は他の4つと重なっています。「cats.sim」リソースをサポートするユーザーエージェントは最初の段落のみを表示しますが、フォールバックを表示するユーザーエージェントは、最初の段落の最初の文を2番目の段落と同じ段落内に表示し、最後の段落を最初の段落の2番目の文の先頭に表示するため、混乱を招きます。

この混乱を避けるためには、明示的なp要素を使用することができます。例えば: 

<section>
  <h2>私の猫たち</h2>
  <p>あなたは私の猫シミュレーターで遊ぶことができます。</p>
  <object data="cats.sim">
   <p>猫シミュレーターを見るには、次のリンクのいずれかを使用してください。</p>
   <ul>
    <li><a href="cats.sim">シミュレーター ファイルをダウンロード</a>
    <li><a href="https://sims.example.com/watch?v=LYds5xY4INU">オンライン シミュレーターを使用</a>
   </ul>
   <p>または、Mellblom ブラウザーにアップグレードしてください。</p>
  </object>
  <p>私はそれをとても誇りに思っています。</p>
 </section>

3.2.6 グローバル属性

グローバル属性

以下の属性はすべてのHTML要素に共通であり、この仕様で定義されていない要素にも指定できます:

これらの属性は、この仕様でHTML要素の属性としてのみ定義されています。この仕様がこれらの属性を持つ要素について言及する場合、これらの属性を持つと定義されていない名前空間の要素は、これらの属性を持つ要素とは見なされません。

例えば、次のXMLフラグメントでは、"bogus"要素は、この仕様で定義されたdir属性を持っていませんが、dirという名前の属性を持っています。したがって、最内のspan要素の方向性は、div要素から間接的に継承された'rtl'です。

<div xmlns="http://www.w3.org/1999/xhtml" dir="rtl">
  <bogus xmlns="https://example.net/ns" dir="ltr">
   <span xmlns="http://www.w3.org/1999/xhtml">
   </span>
  </bogus>
 </div>

グローバル属性/slot

すべての現在のエンジンでサポートされています。

Firefox63+Safari10+Chrome53+
Opera?Edge79+
Edge (レガシー)いいえInternet Explorer?
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

DOMは、任意の名前空間内の任意の要素に対して、class、id、およびslot属性のユーザーエージェント要件を定義します。[DOM]

class、id、およびslot属性は、すべてのHTML要素に指定できます。

HTML要素に指定された場合、class属性は、その要素が属するさまざまなクラスを表す空白で区切られたトークンのセットでなければなりません。

要素にクラスを割り当てると、CSSのセレクターでのクラスのマッチング、DOMのgetElementsByClassName()メソッド、およびその他の機能に影響を与えます。

class属性で使用できるトークンには追加の制限はありませんが、著者はコンテンツの性質を説明する値を使用することをお勧めします。

HTML要素に指定された場合、id属性の値は、要素のIDの中で一意でなければならず、少なくとも1文字を含んでいなければなりません。値にはASCII空白を含めてはなりません。

id属性は、その要素の一意の識別子（ID）を指定します。

IDの形式には他の制限はありません。特に、IDは数字だけで構成されたり、数字で始まったり、アンダースコアで始まったり、句読点だけで構成されたりすることができます。

要素の一意の識別子は、主にドキュメントの特定の部分にリンクする方法として、スクリプトで要素をターゲットにする方法として、またはCSSから特定の要素をスタイル設定する方法として使用されます。

識別子は不透明な文字列です。id属性の値から特定の意味を導き出してはなりません。

slot属性には、HTML要素に固有の適合要件はありません。

slot属性は、要素にスロットを割り当てるために使用されます。slot属性を持つ要素は、slot要素によって作成されたスロットに割り当てられます。そのslot要素がシャドウツリー内にあり、そのルートのホストが対応するslot属性値を持つ場合に限ります。

支援技術製品がHTML要素と属性よりも細かいインターフェースを公開できるようにするために、支援技術製品のための注釈を指定できます（ARIAのroleおよびaria-*属性）。[ARIA]

次のイベントハンドラーコンテンツ属性は、任意のHTML要素に指定できます:

アスタリスクが付いている属性は、body要素に指定された場合、同じ名前のWindowオブジェクトのイベントハンドラーを公開するため、異なる意味を持ちます。

これらの属性はすべての要素に適用されますが、すべての要素で有用というわけではありません。例えば、メディア要素だけが、ユーザーエージェントによって発生するvolumechangeイベントを受信することがあります。

カスタムデータ属性（例:data-foldernameまたはdata-msgid）は、ページに固有のカスタムデータ、状態、注釈などを保存するために、任意のHTML要素に指定できます。

HTMLドキュメントでは、HTML名前空間内の要素には、"http://www.w3.org/1999/xhtml"という正確な値を持つxmlns属性を指定できます。これはXMLドキュメントには適用されません。

HTMLでは、xmlns属性は全く効果がありません。それは基本的にお守りのようなものです。XMLへの移行やXMLからの移行を少しでも容易にするために許可されています。HTMLパーサーによって解析されると、その属性は名前空間には入らず、XMLの名前空間宣言属性のように"http://www.w3.org/2000/xmlns/"名前空間には入りません。

XMLでは、xmlns属性は名前空間宣言メカニズムの一部であり、要素にxmlns属性が指定されていない名前空間を持つことはできません。

XMLは、XML名前空間内の任意の要素に、xml:space属性を使用することも許可しています。この属性は、HTMLでは効果がなく、HTMLのデフォルトの動作は空白を保持することです。[XML]

HTML要素にtext/html構文でxml:space属性をシリアライズする方法はありません。

3.2.6.1 title 属性

Global_attributes/title

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

title属性は、要素に対する助言情報を表します。ツールチップに適したものである必要があります。リンクの場合、これがターゲットリソースのタイトルまたは説明である可能性があります。画像の場合、画像のクレジットまたは説明である可能性があります。段落の場合、脚注やテキストに対するコメントである可能性があります。引用の場合、ソースに関する追加情報である可能性があります。インタラクティブコンテンツの場合、それが要素のラベルや使用方法に関する指示である可能性があります。値はテキストです。

title属性に依存することは現在推奨されていません。多くのユーザーエージェントが、この仕様で要求されているように属性をアクセシブルな方法で公開しないためです（例えば、ツールチップを表示するにはマウスなどのポインティングデバイスが必要であり、キーボードのみのユーザーやモダンな電話やタブレットを使用しているタッチのみのユーザーを除外する可能性があります）。

この属性が要素に省略されている場合、それはこの属性が設定された最も近い祖先のHTML要素のtitle属性が、この要素にも関連していることを意味します。この属性を設定すると、祖先の助言情報がこの要素に関連していないことを明示的に示します。この属性を空の文字列に設定することは、この要素には助言情報がないことを示します。

title属性の値にU+000A LINE FEED (LF)文字が含まれている場合、内容は複数の行に分割されます。各U+000A LINE FEED (LF)文字は改行を表します。

title属性で改行を使用する際には注意が必要です。

例えば、次のスニペットは実際には改行が含まれた省略語の展開を定義しています:

<p>私のログは、今日HTTPにいくつかの関心があったことを示しています<abbr title="Hypertext
 Transport Protocol">HTTP</abbr>です。</p>

いくつかの要素（link、abbr、inputなど）は、上記のセマンティクスを超えてtitle属性の追加のセマンティクスを定義しています。

要素の助言情報は、次のアルゴリズムが返す値です。このアルゴリズムが値を返すと、アルゴリズムは中断されます。アルゴリズムが空の文字列を返した場合、助言情報は存在しません。

  1. 要素がtitle属性を持っている場合、その値に対して改行を正規化する操作を実行した結果を返します。

  2. 要素が親要素を持っている場合、親要素の助言情報を返します。

  3. 空の文字列を返します。

ユーザーエージェントは、要素に助言情報がある場合、ユーザーに通知する必要があります。さもなければ、情報は発見できません。

HTMLElement/title

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

titleIDL属性は、titleコンテンツ属性を反映する必要があります。

3.2.6.2 lang と xml:lang 属性

Global_attributes/lang

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

lang属性（名前空間なし）は、要素の内容およびテキストを含む要素の属性の主な言語を指定します。その値は、有効な BCP 47 言語タグ、または空の文字列でなければなりません。この属性を空の文字列に設定することは、主な言語が不明であることを示します。[BCP47]

lang属性は、XML名前空間内に定義されています。[XML]

これらの属性が要素に省略された場合、この要素の言語は、親要素の言語と同じになります（もしあれば）（ただし、slot要素はシャドウツリー内の要素を除きます）。

名前空間なしのlang属性は、任意のHTML要素で使用できます。

lang属性は、XML 名前空間で、HTML 要素に使用でき、XML ドキュメントに使用できます。また、関連する仕様が許可する場合には、他の名前空間の要素にも使用できます（特に、MathML や SVG は、lang 属性を、XML 名前空間で指定することを許可しています）。lang属性が名前空間に属さず、lang 属性が XML 名前空間に指定されている場合、同じ要素上でそれらは、ASCII 大文字小文字を区別しない 形で、完全に同じ値を持たなければなりません。

著者は、名前空間なしのlang属性をXML名前空間のHTML要素に対してHTMLドキュメントで使用してはなりません。XMLへの移行を容易にするために、著者は、名前空間なしの属性をプレフィックスなしで、リテラルのローカル名"xml:lang"でHTMLドキュメントのHTML要素に指定できますが、この属性は、名前空間なしのlang属性も指定されている場合にのみ指定する必要があります。両方の属性は、ASCII大文字と小文字を区別しない方法で比較される際に、同じ値を持っていなければなりません。

名前空間なしでプレフィックスなし、リテラルのローカル名"xml:lang"を持つ属性は、言語処理には何の影響もありません。

ノードの言語を決定するには、ユーザーエージェントは次のリストの最初の適切なステップを使用する必要があります:

ノードがXML名前空間にあるlang属性を持つ要素である場合

その属性の値を使用します。

ノードがHTML要素またはSVG名前空間にある要素で、名前空間なしのlang属性を持つ場合

その属性の値を使用します。

ノードの親がシャドウルートである場合

その言語を、シャドウルートのホストに使用します。

ノードの親要素がnullでない場合

その言語を親要素に使用します。

それ以外の場合

プラグマ設定のデフォルト言語が設定されている場合、それがノードの言語です。プラグマ設定のデフォルト言語が設定されていない場合、上位レベルのプロトコル（HTTPなど）からの言語情報（存在する場合）が最終的なフォールバック言語として使用されます。そのような言語情報がない場合、および上位レベルのプロトコルが複数の言語を報告する場合、ノードの言語は不明であり、対応する言語タグは空の文字列です。

結果の値が認識されない言語タグである場合、それは与えられた言語タグを持つ未知の言語として扱われ、他のすべての言語と区別されなければなりません。ラウンドトリップや言語タグを期待する他のサービスとの通信の目的で、ユーザーエージェントは未知の言語タグを修正せずに通過させ、BCP 47 言語タグとしてタグ付けする必要があります。そうすれば、後続のサービスがデータを別のタイプの言語記述として解釈することはありません。[BCP47]

例えば、lang="xyzzy"を持つ要素は、セレクタ:lang(xyzzy)（例：CSS）で一致しますが、:lang(abcde)では一致しません。どちらも同様に無効ですが、これも同様です。同様に、連携して動作するウェブブラウザとスクリーンリーダーが、要素の言語について通信する場合、ブラウザはスクリーンリーダーにその言語が "xyzzy" であることを伝えます。たとえそれが無効であると知っていても、スクリーンリーダーがそのタグをサポートしている可能性があるためです。たとえスクリーンリーダーが BCP 47 と別の言語名エンコーディングの構文の両方をサポートしていて、その別の構文で "xyzzy" がベラルーシ語を表す方法であったとしても、BCP 47 でベラルーシ語が "be" というコードで記述されているため、スクリーンリーダーがテキストをベラルーシ語として扱い始めるのは誤りです。

結果の値が空の文字列である場合、それはノードの言語が明示的に不明であることを意味すると解釈されなければなりません。

ユーザーエージェントは、適切な処理やレンダリングを決定するために要素の言語を使用することがあります（例えば、適切なフォントや発音の選択、辞書の選択、日付ピッカーなどのフォームコントロールのユーザーインターフェイスのため）。

HTMLElement/lang

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

langIDL属性は、名前空間なしのlangコンテンツ属性を反映する必要があります。

3.2.6.3 translate 属性

Global_attributes/translate

すべての現在のエンジンでサポートされています。

Firefox111+Safari6+Chrome19+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

translate 属性は、要素の属性値とその Text ノードの子がページのローカライズ時に翻訳されるか、または変更されずに残されるかを指定するために使用されます。この属性は 列挙型の属性であり、次のキーワードと状態を持ちます:

キーワード 状態 簡単な説明
yes Yes 翻訳モードを 翻訳可能 に設定します。
(空の文字列)
no No 翻訳モードを翻訳不可に設定します。

この属性の 欠損値のデフォルト と 無効値のデフォルト はどちらも Inherit 状態です。

すべての要素（非 HTML 要素も含む）は、翻訳モードを持ち、それは 翻訳可能 状態または 翻訳不可 状態のいずれかです。HTML要素の translate 属性が Yes 状態にある場合、その要素の 翻訳モード は 翻訳可能 状態になります。それ以外の場合、要素の translate 属性が No 状態にある場合、その要素の 翻訳モード は 翻訳不可 状態になります。それ以外の場合、要素の translate 属性が Inherit 状態にあるか、またはその要素がHTML要素でないため、translate 属性を持たない場合、いずれの場合もその要素の 翻訳モード は、親要素が存在する場合、親要素と同じ状態になります。親要素が null の場合は 翻訳可能 状態になります。

要素が 翻訳可能 状態にある場合、その要素の 翻訳可能属性 とその Text ノードの子の値は、ページがローカライズされたときに翻訳されます。

要素が 翻訳不可 状態にある場合、その要素の属性値とその Text ノードの子の値は、ページがローカライズされたときにそのまま残されます。例えば、その要素に人名やプログラムの名前が含まれている場合です。

次の属性は 翻訳可能属性 です:

他の仕様が、他の 翻訳可能属性 を定義する場合があります。例えば、ARIA では aria-label 属性が翻訳可能であると定義されます。

translate IDL 属性は、取得時に、要素の 翻訳モード が 翻訳可能 状態にある場合は true を返し、そうでない場合は false を返す必要があります。設定時には、新しい値が true の場合はコンテンツ属性の値を "yes" に設定し、それ以外の場合はコンテンツ属性の値を "no" に設定する必要があります。

この例では、ドキュメント内のすべてがページがローカライズされたときに翻訳されますが、サンプルのキーボード入力とサンプルのプログラム出力は例外です:

<!DOCTYPE HTML>
 <html lang=en> <!-- default on the document element is translate=yes -->
  <head>
   <title>The Bee Game</title> <!-- implied translate=yes inherited from ancestors -->
  </head>
  <body>
   <p>The Bee Game is a text adventure game in English.</p>
   <p>When the game launches, the first thing you should do is type
   <kbd translate=no>eat honey</kbd>. The game will respond with:</p>
   <pre><samp translate=no>Yum yum! That was some good honey!</samp></pre>
  </body>
 </html>
3.2.6.4 dir 属性

Global_attributes/dir

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

dir 属性は 列挙属性 であり、次のキーワードと状態を持ちます:

キーワード 状態 簡潔な説明
ltr LTR 要素の内容は左から右へのテキストとして明示的に方向が隔離されます。
rtl RTL 要素の内容は右から左へのテキストとして明示的に方向が隔離されます。
auto Auto 要素の内容は明示的に方向が隔離されますが、その方向は要素の内容を使用してプログラムによって決定されます（以下に説明します）。

Auto 状態で使用されるヒューリスティックは非常に粗いです （双方向アルゴリズムの段落レベルの決定に類似した方法で、最初の強い方向性を持つ文字のみを見ます）。著者は、テキストの方向が本当に不明で、サーバーサイドで適用できるより良いヒューリスティックがない場合にのみ、この値を最後の手段として使用するように勧められています。 [BIDI]

textarea および pre 要素の場合、ヒューリスティックは段落ごとに適用されます。

属性の 欠損値のデフォルト および 無効値のデフォルト はどちらも Undefined 状態です。

要素の 方向性 （HTML 要素に限らず、任意の要素）は、 'ltr' または 'rtl' のいずれかです。要素 element の 方向性 を計算するには、 element の dir 属性状態を基に判断します:

LTR

'ltr' を返します。

RTL

'rtl' を返します。

Auto

  1. element の 自動方向性 を求めます。

  2. result が null の場合、'ltr' を返します。

  3. result を返します。

Undefined
element が bdi 要素である場合

  1. element の 自動方向性 を求めます。

  2. result が null の場合、'ltr' を返します。

  3. result を返します。

element が input 要素であり、type 属性が 電話 状態の場合

'ltr' を返します。

その他

element の 親方向性 を返します。

dir 属性は HTML 要素 のみ定義されているため、他の名前空間の要素には存在し得ません。したがって、他の名前空間の要素は常に 親方向性 を使用することになります。

自動方向性を持つフォーム関連要素 は次のとおりです:

自動方向性 を要素 element に対して計算するには:

  1. element が 自動方向性を持つフォーム関連要素 である場合:

    1. element の 値 に双方向の文字タイプ AL または R の文字が含まれ、その前に双方向の文字タイプ L の文字がない場合、'rtl' を返します。 [BIDI]

    2. element の 値 が空でない場合、'ltr' を返します。

    3. null を返します。

  2. element が slot 要素で、その ルート が シャドウルート であり、element の 割り当てられたノード が空でない場合:

    1. それぞれのノードchildに対して、elementの割り当てられたノードのうち:

      1. childDirectionをnullに設定します。

      2. childがTextノードである場合、childDirectionをchildのテキストノードの方向性に設定します。

      3. その他の場合:

        1. 確認: child はElementノードです。

        2. childDirectionをchildの含まれるテキストの自動方向性に設定します。ルートを除外できるかをtrueに設定して。

      4. childDirectionがnullでない場合、childDirectionを返します。

    2. nullを返します。

  3. 次にelementの含まれるテキストの自動方向性を返します。ルートを除外できるかをfalseに設定します。

含まれるテキストの自動方向性を、要素elementに対して計算するには:

  1. それぞれのノードdescendantに対して、elementの子孫のうち、ツリー順に:

    1. 以下のいずれかが含まれる場合

      • descendant
      • descendantのelementの子孫である任意の先祖要素
      • もしcanExcludeRootがtrueであれば、element

      以下のいずれかの場合

      続行します。

    2. descendantがslot要素で、そのルートがシャドウルートの場合、その方向性を返します。

    3. descendantがTextノードでない場合、続行します。

    4. descendantのテキストノードの方向性をresultに設定します。

    5. resultがnullでない場合、resultを返します。

  2. nullを返します。

テキストノードの方向性を、Textノードtextに対して計算するには:

  1. textのデータが双方向の文字タイプL、AL、またはRを持つコードポイントを含まない場合、nullを返します。 [BIDI]

  2. textのデータの最初の双方向の文字タイプL、AL、またはRを持つコードポイントをcodePointに設定します。

  3. codePointが双方向の文字タイプALまたはRを持つ場合、'rtl'を返します。

  4. codePointが双方向の文字タイプLを持つ場合、'ltr'を返します。

親方向性を、要素elementに対して計算するには:

  1. elementの親ノードparentNodeを設定します。

  2. parentNodeがシャドウルートの場合、そのparentNodeの方向性を返します。そのホストの。

  3. parentNodeが要素である場合、そのparentNodeの方向性を返します。

  4. 'ltr'を返します。

この属性は双方向アルゴリズムを含むレンダリング要件があります。

HTML要素の属性の方向性は、その属性のテキストが何らかの形でレンダリングに含まれるときに使用されますが、次のリストの最初の適切なステップに従って決定されます:

属性が方向性対応の属性であり、要素のdir属性がAuto状態である場合

属性の値に双方向の文字タイプL、AL、またはRの文字がある最初の文字（論理順序で）を見つけます。[BIDI]

そのような文字が見つかり、それが双方向の文字タイプALまたはRである場合、属性の方向性は 'rtl' です。

それ以外の場合、属性の方向性は 'ltr' です。

その他
属性の方向性は、要素の方向性と同じです。。

以下の属性は方向性対応の属性です:

document.dir [ = value ]

html要素のdir属性の値を返します（存在する場合）。

設定可能であり、html要素のdir属性の値を「ltr」、「rtl」、または「auto」のいずれかに置き換えることができます。

html要素が存在しない場合、空の文字列を返し、新しい値は無視されます。

HTMLElement/dir

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

要素上のdir IDL属性は、その要素のdirコンテンツ属性を反映する必要があります。既知の値のみに制限されます。

Document/dir

すべての現在のエンジンでサポートされています。

Firefox1+Safari10.1+Chrome64+
Opera51+Edge79+
Edge (旧版)12+Internet Explorer5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

dir IDL属性は、Documentオブジェクト上で、反映する必要があります。dirコンテンツ属性をhtml要素に設定します（存在する場合）。この要素が存在しない場合、この属性は空の文字列を返し、設定時には何もしません。

著者は、CSSを使用するのではなく、dir属性を使用してテキストの方向性を指定することを強くお勧めします。これにより、CSSがない場合でもドキュメントが正しくレンダリングされ続けるためです（例: 検索エンジンによって解釈される場合など）。

このマークアップフラグメントは、IMチャットの会話を示しています。

<p dir=auto class="u1"><b><bdi>Student</bdi>:</b> How do you write "What's your name?" in Arabic?</p>
<p dir=auto class="u2"><b><bdi>Teacher</bdi>:</b> ما اسمك؟</p>
<p dir=auto class="u1"><b><bdi>Student</bdi>:</b> Thanks.</p>
<p dir=auto class="u2"><b><bdi>Teacher</bdi>:</b> That's written "شكرًا".</p>
<p dir=auto class="u2"><b><bdi>Teacher</bdi>:</b> Do you know how to write "Please"?</p>
<p dir=auto class="u1"><b><bdi>Student</bdi>:</b> "من فضلك", right?</p>

適切なスタイルシートとp要素のデフォルトの配置スタイル（つまり段落の開始端にテキストを整列する）を与えると、レンダリング結果は次のようになる可能性があります。

各段落は別々のブロックとしてレンダリングされ、段落は左揃えになりますが、2番目と最後の段落は右揃えになり、ユーザー名（この例では「Student」と「Teacher」）は右に揃えられ、その左にコロンが配置され、その前にテキストが配置されます。

前述のように、auto値は万能ではありません。この例の最後の段落はアラビア文字で始まるため、右から左のテキストとして誤解され、「right?」がアラビア文字の左に配置される結果になります。

3.2.6.5 style 属性

Global_attributes/style

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

すべてのHTML 要素には、styleコンテンツ属性が設定できます。これは、CSS Style Attributesで定義されているスタイル属性です。[CSSATTR]

CSSをサポートするユーザーエージェントでは、属性が追加されるか値が変更された際に、その属性の値がスタイル属性の規則に従って解析される必要があります。[CSSATTR]

しかし、属性の要素のインライン動作がコンテンツセキュリティポリシーによってブロックされるべきかどうかアルゴリズムを属性の要素、「スタイル属性」、および属性の値で実行した際に「ブロック」と判断された場合、属性値で定義されたスタイルルールは要素には適用されません。[CSP]

ドキュメントが任意の要素にstyle属性を使用する場合、それらの属性が削除されても理解可能で使える状態でなければなりません。

特に、style属性を使用してコンテンツを非表示にしたり表示したり、またはドキュメントに他に含まれていない意味を伝えることは非準拠です（コンテンツを非表示にしたり表示したりするには、hidden属性を使用してください）。

element.style

要素のstyle属性に対応するCSSStyleDeclarationオブジェクトを返します。

styleIDL属性は、CSS Object Modelで定義されています。[CSSOM]

次の例では、色に言及している単語が、span要素とstyle属性を使用して、視覚的なメディアでその色を表示するようにマークアップされています。 

<p>My sweat suit is <span style="color: green; background:
 transparent">green</span> and my eyes are <span style="color: blue;
 background: transparent">blue</span>.</p>
3.2.6.6 カスタムの非表示データを埋め込むための data-* 属性

Global_attributes/data-*

すべての現在のエンジンでサポートされています。

Firefox6+Safari5.1+Chrome7+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

カスタムデータ属性は、名前が "data-" で始まり、 ハイフンの後に少なくとも1文字が続き、XML互換であり、 ASCIIの大文字アルファベットを含まない、名前空間に属さない属性です。

すべてのHTML要素において、HTML文書では、 属性名は自動的にASCII小文字化されるため、ASCII大文字の制限はそのような文書には影響しません。

カスタムデータ属性は、 ページやアプリケーションに固有のカスタムデータ、状態、注釈などを格納することを目的としています。これに適した他の属性や要素がない場合に使用されます。

これらの属性は、属性を使用するサイトの管理者に知られていないソフトウェアで使用することを意図していません。複数の独立したツールによって使用される汎用拡張機能には、この仕様を拡張して明示的に機能を提供するか、マイクロデータのような標準化された語彙を使用する技術を使用する必要があります。

たとえば、音楽に関するサイトが、アルバムのトラックを表すリスト項目に各トラックの長さを含むカスタムデータ属性を追加し、サイト自身がこの情報を使用してトラックの長さでリストをソートしたり、特定の長さのトラックをフィルタリングしたりできるようにすることが考えられます。 

<ol>
  <li data-length="2m11s">Beyond The Sea</li>
  ...
 </ol>

ただし、汎用ソフトウェアがこのデータを使用して特定の長さのトラックを検索するのは不適切です。

これは、これらの属性はサイトのスクリプトによって使用されることを意図しており、公開可能なメタデータのための汎用的な拡張機構ではないからです。

同様に、ページ作成者が、使用する予定の翻訳ツール用の情報を提供するマークアップを書くこともできます。

<p>The third <span data-mytrans-de="Anspruch">claim</span> covers the case of <span
 translate="no">HTML</span> markup.</p>

この例では、「data-mytrans-de」属性は、「claim」をドイツ語に翻訳する際にMyTrans製品が使用する特定のテキストを提供します。ただし、標準のtranslate属性は、「HTML」がすべての言語で変更されないように指示しています。標準の属性が利用できる場合、カスタムデータ属性を使用する必要はありません。

この例では、PaymentRequestの機能検出の結果をカスタムデータ属性に保存し、チェックアウトページを異なるスタイルで表示するためにCSSで使用することができます。 

<script>
  if ('PaymentRequest' in window) {
    document.documentElement.dataset.hasPaymentRequest = '';
  }
 </script>

ここで、data-has-payment-request属性は、ブール属性として効果的に使用されています。属性の存在を確認するだけで十分です。しかし、著者が望む場合、後で機能の限定された機能を示す値を格納することもできます。

すべてのHTML要素には、任意の数のカスタムデータ属性を指定し、任意の値を持たせることができます。

著者は、これらの拡張が無視され、関連するCSSが削除されてもページが引き続き使用可能であるように慎重に設計する必要があります。

ユーザーエージェントは、これらの属性や値から実装動作を派生させてはなりません。ユーザーエージェントを対象とした仕様は、これらの属性に意味のある値を定義してはなりません。

JavaScriptライブラリは、カスタムデータ属性を使用することができます。それらは、使用されるページの一部と見なされるからです。多くの著者が再利用するライブラリの著者は、競合のリスクを減らすために、属性名に名前を含めることを推奨します。また、可能であれば、ライブラリ著者は、属性名に使用する正確な名前をカスタマイズできるAPIを提供することをお勧めします。そうすれば、同じ名前を知らずに選んだライブラリを同じページで使用したり、互換性のない複数のバージョンを同じページで使用することができます。

たとえば、「DoQuery」というライブラリは、data-doquery-rangeのような属性名を使用し、「jJo」というライブラリは、data-jjo-rangeのような属性名を使用することができます。また、jJoライブラリは、使用するプレフィックスを設定するAPIを提供することができます（例：J.setDataPrefix('j2')、これにより、属性名がdata-j2-rangeになります）。

element.dataset

HTMLElement/dataset

すべての現在のエンジンでサポートされています。

Firefox6+Safari5.1+Chrome7+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android11+

SVGElement/dataset

すべての現在のエンジンでサポートされています。

Firefox51+Safari5.1+Chrome55+
Opera41+Edge79+
Edge (Legacy)17+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android41+

要素のdata-*属性のためのDOMStringMapオブジェクトを返します。

ハイフンで区切られた名前はキャメルケースに変換されます。例えば、data-foo-bar=""はelement.dataset.fooBarとなります。

datasetIDL属性は、要素上のすべてのdata-*属性への便利なアクセサを提供します。取得時に、datasetIDL属性は、この要素に関連付けられたDOMStringMapを返さなければなりません。

DOMStringMapインターフェイスは、dataset属性のために使用されます。各DOMStringMapには、関連付けられた要素があります。

[Exposed=Window,
  LegacyOverrideBuiltIns]
 interface DOMStringMap {
   getter DOMString (DOMString name);
   [CEReactions] setter undefined (DOMString name, DOMString value);
   [CEReactions] deleter undefined (DOMString name);
 };

DOMStringMapの名前と値のペアを取得するには、次のアルゴリズムを実行します。

  1. list を名前と値のペアの空のリストにします。

  2. DOMStringMapの関連付けられた要素上の、最初の5文字が "data-" で始まり、残りの文字にASCIIの大文字アルファベットが含まれていない各コンテンツ属性について、それらの属性が要素の属性リストに表示される順序で、属性名の最初の5文字を削除した名前と属性の値を持つ名前と値のペアをlistに追加します。

  3. listの各名前に対して、その名前にU+002Dハイフンマイナス文字(-)が含まれており、ASCIIの小文字アルファベットが続いている場合、U+002Dハイフンマイナス文字(-)を削除し、その後に続く文字を同じ文字で置き換え、ASCII大文字に変換します。

  4. listを返します。

DOMStringMapオブジェクトのサポートされているプロパティ名は、その瞬間に名前と値のペアを取得して返される各ペアの名前であり、その瞬間に返される順序で返されます。

名前付きプロパティの値を決定するには、nameと、リストにある名前がDOMStringMapで取得された名前と値のペアのリストの名前要素であり、値要素を返します。

新しい名前付きプロパティの値を設定する、または既存の名前付きプロパティの値を設定するには、プロパティ名nameと新しい値valueを指定して、次の手順を実行します。

  1. nameがU+002Dハイフンマイナス文字(-)を含み、その後にASCIIの小文字アルファベットが続く場合、"SyntaxError"をスローします。DOMException。

  2. name内の各ASCII大文字に対して、文字の前にU+002Dハイフンマイナス文字(-)を挿入し、その文字を同じ文字で置き換え、ASCII小文字に変換します。

  3. nameの先頭にdata-文字列を挿入します。

  4. nameがXMLName生成規則と一致しない場合、"InvalidCharacterError"をスローします。DOMException。

  5. 属性値を設定します、DOMStringMapのnameとvalueを使用して、関連付けられた要素を使用します。

既存の名前付きプロパティを削除するnameのために、次の手順を実行します。

  1. name内の各ASCII大文字に対して、文字の前にU+002Dハイフンマイナス文字(-)を挿入し、その文字を同じ文字で置き換え、ASCII小文字に変換します。

  2. nameの先頭にdata-文字列を挿入します。

  3. 名前によって属性を削除します、nameとDOMStringMapのnameと関連付けられた要素を使用します。

このアルゴリズムは、[WEBIDL]によって、名前と値のペアを取得するために以前のアルゴリズムによって与えられた名前に対してのみ呼び出されます。

例えば、ウェブページが宇宙船を表す要素を持ちたい場合（例えば、ゲームの一部として）、それはクラス属性と共にdata-*属性を使用する必要があります。 

<div class="spaceship" data-ship-id="92432"
      data-weapons="laser 2" data-shields="50%"
      data-x="30" data-y="10" data-z="90">
  <button class="fire"
          onclick="spaceships[this.parentNode.dataset.shipId].fire()">
   Fire
  </button>
 </div>

ハイフンで区切られた属性名がAPIでキャメルケースになることに注意してください。

次のフラグメントと同様の構造を持つ要素を考えてみましょう。

<img class="tower" id="tower5" data-x="12" data-y="5"
      data-ai="robotarget" data-hp="46" data-ability="flames" src="towers/rocket.png" alt="Rocket Tower">

...スプラッシュダメージを処理する関数splashDamage()があり、その最初の引数が処理する要素であると考えられます。

function splashDamage(node, x, y, damage) {
   if (node.classList.contains('tower') && // 'class' 属性をチェックします
       node.dataset.x == x && // 'data-x' 属性を読み取ります
       node.dataset.y == y) { // 'data-y' 属性を読み取ります
     var hp = parseInt(node.dataset.hp); // 'data-hp' 属性を読み取ります
     hp = hp - damage;
     if (hp < 0) {
       hp = 0;
       node.dataset.ai = 'dead'; // 'data-ai' 属性を設定します
       delete node.dataset.ability; // 'data-ability' 属性を削除します
     }
     node.dataset.hp = hp; // 'data-hp' 属性を設定します
   }
 }

3.2.7 innerText および outerText プロパティ

HTMLElement/innerText

すべての現行エンジンでサポートされています。

Firefox45+Safari1+Chrome1+
Opera9.6+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android1+Samsung Internet?Opera Android10.1+
element.innerText [ = value ]

要素の「レンダリングされた」テキストコンテンツを返します。

指定された値で要素の子を置き換えることができますが、改行はbr要素に変換されます。

element.outerText [ = value ]

要素の「レンダリングされた」テキストコンテンツを返します。

指定された値で要素を置き換えることができますが、改行はbr要素に変換されます。

テキスト取得手順は、HTMLElement elementに対して次のように行います:

  1. もしelementがレンダリングされていないか、ユーザーエージェントが非CSSユーザーエージェントの場合、elementの子孫テキストコンテンツを返します。

    このステップは驚くべき結果を生むことがあります。たとえば、innerTextゲッターがレンダリングされていない要素で呼び出された場合、そのテキストコンテンツが返されますが、レンダリングされている要素でアクセスされた場合、レンダリングされていないすべての子要素のテキストコンテンツは無視されます。

  2. resultsを新しい空のリストとします。

  3. elementの各子ノードnodeに対して:

    1. currentを、レンダリングされたテキスト収集手順をnodeで実行した結果として得られるリストとします。resultsの各項目は文字列または正の整数（必須の改行数）となります。

      直感的には、必須の改行数の項目は、そのポイントに一定数の改行が出現することを意味しますが、これらは隣接する必須の改行数の項目によって誘導される改行とともに折り畳まれることがあります。これはCSSのマージン折り畳みと似ています。

    2. current内の各項目itemについて、itemをresultsに追加します。

  4. 削除します。resultsから空の文字列となる項目を削除します。

  5. 削除します。resultsの先頭または末尾にある連続した必須の改行数項目のランを削除します。

  6. 置換します。残りの連続する必須の改行数項目のランを、それぞれの必須の改行数項目の値の最大値と同じ数のU+000A LFコードポイントを含む文字列に置き換えます。

  7. resultsの文字列項目を連結して返します。

HTMLElement/outerText

すべての現在のエンジンでサポートされています。

Firefox98+Safari1.3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android1+Samsung Internet?Opera Android12.1+

innerTextと outerText のゲッターステップは、テキスト取得手順をthisで実行した結果を返すことです。

レンダリングされたテキスト収集手順は、ノード nodeに対して次のように行います:

  1. itemsを、nodeの各子ノードに対してレンダリングされたテキスト収集手順を実行し、その結果をリストとして連結したものにします。

  2. もしnodeの計算値が'visibility'が'visible'でない場合、itemsを返します。

  3. もしnodeがレンダリングされていない場合、itemsを返します。このステップの目的のために、次の要素は、計算値が'display'が'none'でない場合に記載されているように動作しなければなりません:

    itemsは'display:contents'のために空でない可能性があります。

  4. もしnodeがテキストノードである場合、nodeが生成する各CSSテキストボックスに対して、内容の順番で、そのボックスのテキストをCSSの'white-space'処理ルールと'text-transform'ルールを適用した後のテキストを計算し、itemsを得られた文字列のリストに設定し、itemsを返します。 CSSの'white-space'処理ルールは若干修正されます。行の終わりの折り畳み可能なスペースは常に折り畳まれますが、行がブロックの最後の行であるか、br要素で終了する場合にのみ削除されます。ソフトハイフンは保持されるべきです。 [CSSTEXT]

  5. もしnodeがbr要素である場合、追加します。itemsにU+000A LFコードポイントを含む文字列を追加します。

  6. もしnodeの計算値が'display'が'table-cell'であり、nodeのCSSボックスが、それを囲む'table-row'ボックスの最後の'table-cell'ボックスでない場合、追加します。itemsにU+0009 TABコードポイントを含む文字列を追加します。

  7. もしnodeの計算値が'display'が'table-row'であり、nodeのCSSボックスが最も近い祖先'table'ボックスの最後の'table-row'ボックスでない場合、追加します。itemsにU+000A LFコードポイントを含む文字列を追加します。

  8. もしnodeがp要素である場合、追加します。itemsの先頭と末尾に2（必須の改行数）を追加します。

  9. もしnodeの使用値が'display'がブロックレベルまたは'テーブルキャプション'である場合、追加します。itemsの先頭と末尾に1（必須の改行数）を追加します。[CSSDISPLAY]

    フロートや絶対配置された要素はこのカテゴリに該当します。

  10. itemsを返します。

注意、ほとんどの置換要素の子ノード（例：textarea、 input、 video — ただし buttonは除く）は、 厳密にはCSSによってレンダリングされず、このアルゴリズムの目的にはCSSボックスを持ちません。

このアルゴリズムはレンジに対して一般化して動作するようにすることができます。これにより、Selectionの文字列化に使用できる基盤となり、おそらくレンジで直接公開することができます。詳細はBugzilla bug 10583をご覧ください。

内部テキスト設定手順は、HTMLElement elementと文字列valueが与えられた場合に以下を実行します:

  1. fragmentを、elementのノードドキュメントが与えられたvalueのためのレンダリングされたテキストフラグメントにします。

  2. すべてを置き換えるでelement内のfragmentを使用します。

innerTextの セッターステップは、内部テキスト設定手順を実行することです。

outerTextの セッターステップは以下の通りです:

  1. もしthisの親がnullである場合、"NoModificationAllowedError" DOMExceptionをスローします。

  2. nextをthisの次の兄弟ノードにします。

  3. previousをthisの前の兄弟ノードにします。

  4. fragmentを、与えられた値のためにレンダリングされたテキストフラグメントにします。

  5. もしfragmentに子ノードがない場合、新しいテキストノードを追加します。データが空の文字列であり、ノードドキュメントがthisのノードドキュメントである新しいノードをfragmentに追加します。

  6. 置き換えます。thisをfragmentでthisの親ノード内で置き換えます。

  7. もしnextがnullでなく、nextの前の兄弟ノードがテキストノードである場合、nextの次のテキストノードとマージします。

  8. もしpreviousがテキストノードである場合、previousを用いて次のテキストノードとマージします。

レンダリングされたテキストフラグメントは、documentが与えられたドキュメントに対して、文字列inputのために次の手順を実行します:

  1. fragmentを、新しいドキュメントフラグメントにします。そのノードドキュメントはdocumentです。

  2. positionをinputの位置変数に設定し、初期値はinputの先頭を指します。

  3. textを空の文字列にします。

  4. positionがinputの終わりを過ぎていない間:

    1. コードポイントのシーケンスを収集するを行います。U+000A LFまたはU+000D CRではないコードポイントをinputから収集し、positionに設定します。

    2. もしtextが空の文字列でない場合、新しいテキストノードをfragmentに追加します。そのデータはtextであり、ノードドキュメントはdocumentです。

    3. positionがinputの終わりを過ぎていない間、およびpositionにあるコードポイントがU+000A LFまたはU+000D CRである間:

      1. もしpositionにあるコードポイントがU+000D CRであり、次のコードポイントがU+000A LFである場合、positionをinputの次のコードポイントに進めます。

      2. positionをinputの次のコードポイントに進めます。

      3. document、「br」、およびHTML名前空間を指定して要素を作成した結果を、fragment に追加します。

  5. fragmentを返します。

次のテキストノードとマージは、テキストノードnodeが与えられた場合に以下を実行します:

  1. nextをnodeの次の兄弟ノードにします。

  2. もしnextがテキストノードでない場合、終了します。

  3. データを置き換えます。nodeを使用し、nodeのデータの長さ、0、およびnextのデータを置き換えます。

  4. 削除 next。

3.2.8 双方向アルゴリズムに関連する要件

3.2.8.1 双方向アルゴリズムの書式設定文字に関する著者適合基準

テキストコンテンツがHTML要素に含まれるテキストノード内や、自由形式のテキストを許可するHTML要素の属性内には、U+202AからU+202EおよびU+2066からU+2069の範囲にある文字（双方向アルゴリズム書式設定文字）が含まれることがあります。[BIDI]

著者は、双方向アルゴリズム書式設定文字を手動で管理するのではなく、dir属性、bdo要素、およびbdi要素を使用することが推奨されます。双方向アルゴリズム書式設定文字はCSSと相性が悪いです。

3.2.8.2 ユーザーエージェント適合基準

ユーザーエージェントは、文書や文書の一部をレンダリングする際に文字の適切な順序を決定するために、Unicode双方向アルゴリズムを実装しなければなりません。[BIDI]

HTMLをUnicode双方向アルゴリズムにマッピングする方法は3つのいずれかでなければなりません。ユーザーエージェントはCSSを実装しなければならず、特にCSSの'unicode-bidi'、'direction'、および'content'プロパティを実装しなければならず、そのユーザーエージェントスタイルシートにこの仕様のレンダリングセクションに記載されているこれらのプロパティを使用したルールが含まれている必要があります。あるいは、ユーザーエージェントは、上述のプロパティのみを実装し、文書に指定されたスタイルシートがそれらを上書きしないようにしつつ、ユーザーエージェントスタイルシートがすべての前述のルールを含んでいるかのように振る舞う必要があります。または、ユーザーエージェントは同等のセマンティクスを持つ他のスタイリング言語を実装しなければなりません。[CSSGC]

次の要素と属性には、レンダリングセクションで定義されている要件があり、このセクションの要件により、すべてのユーザーエージェントに対して（推奨されるデフォルトのレンダリングをサポートするものだけでなく）要件が課されます:

3.2.9 ARIAおよびプラットフォームアクセシビリティAPIに関連する要件

ユーザーエージェントがHTML要素HTML要素でアクセシビリティAPIのセマンティクスを実装するための要件は、HTML Accessibility API Mappingsに定義されています。また、カスタム要素elementに対して、デフォルトのARIAロールセマンティクスは次のように決定されます:[HTMLAAM]

  1. mapをelementの内部コンテンツ属性マップに設定します。

  2. もしmap["role"]が存在する場合、それを返します。

  3. ロールを返しません。

同様に、カスタム要素elementに対して、ARIAステートおよびプロパティセマンティクスのデフォルトは、stateOrPropertyという名前のステートまたはプロパティに対して、次のように決定されます:

  1. もしelementのアタッチされた内部がnullでない場合:

    1. もしelementのアタッチされた内部の関連するstateOrProperty要素を取得するが存在する場合、それを実行した結果を返します。

    2. もしelementのアタッチされた内部の関連するstateOrProperty要素を取得するが存在する場合、それを実行した結果を返します。

  2. もしelementの内部コンテンツ属性マップ[stateOrProperty]が存在する場合、それを返します。

  3. stateOrPropertyのデフォルト値を返します。

ここで言及されている「デフォルトのセマンティクス」は、ARIAで「ネイティブ」、「暗黙的」、または「ホスト言語セマンティクス」とも呼ばれることがあります。[ARIA]

これらの定義の1つの含意は、デフォルトのセマンティクスが時間とともに変化する可能性があるということです。これにより、カスタム要素は組み込み要素と同様の表現力を持つことができます。たとえば、a要素のデフォルトのARIAロールセマンティクスが、href属性の追加や削除によってどのように変わるかと比較できます。

この動作の例については、カスタム要素セクションを参照してください。

ARIA roleおよびaria-*属性の使用をチェックするための適合チェッカーの要件は、ARIA in HTMLに定義されています。[ARIAHTML]

4 HTMLの要素

4.1 文書要素

4.1.1 html 要素

Element/html

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLHtmlElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素を使用できるコンテキスト:
文書の文書要素として。
複合文書内のサブドキュメントフラグメントが許可されている場所。
コンテンツモデル:
head 要素の後に body 要素が続く。
text/htmlでのタグの省略:
html 要素の開始タグは、html 要素内の最初の要素がコメントでない場合、省略できます。
html 要素の終了タグは、html 要素の直後にコメントがない場合、省略できます。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
インターフェース HTMLHtmlElement : HTMLElement {
  [HTMLConstructor] コンストラクタ();
  
  // 非推奨メンバーも含む
};

html 要素はHTML文書のルートを表します。

著者は、ルートhtml要素にlang属性を指定して文書の言語を設定することが推奨されています。これにより、音声合成ツールが使用する発音を判断し、翻訳ツールが適用するルールを判断するのに役立ちます。

以下の例のhtml 要素は、文書の言語が英語であることを宣言しています。

<!DOCTYPE html>
<html lang="en">
<head>
<title>Swapping Songs</title>
</head>
<body>
<h1>Swapping Songs</h1>
<p>Tonight I swapped some of the songs I wrote with some friends, who gave me some of the songs they wrote. I love sharing my music.</p>
</body>
</html>

4.2 ドキュメントのメタデータ

4.2.1 head 要素

要素/head

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLHeadElement

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
html要素の最初の要素として。
内容モデル:
ドキュメントがiframe srcdocドキュメントである場合、または上位プロトコルからタイトル情報が提供されている場合: メタデータ内容の0個以上の要素。その中にtitle要素は1つのみ、base要素は1つのみ。
それ以外の場合: メタデータ内容の1つ以上の要素。その中にtitle要素は1つのみ、base要素は1つのみ。
text/htmlでのタグの省略:
head要素の開始タグは、要素が空の場合、またはhead要素内の最初のものが要素の場合、省略可能です。
head要素の終了タグは、head要素が直後にASCII ホワイトスペースまたはコメントがない場合、省略可能です。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
作者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLHeadElement : HTMLElement {
   [HTMLConstructor] constructor();
 };

head要素は、ドキュメントのメタデータの集合を表します。

head要素内のメタデータの集合は、大きい場合も小さい場合もあります。以下は非常に短いものの例です。 

<!doctype html>
 <html lang=en>
  <head>
   <title>A document with a short head</title>
  </head>
  <body>
  ...

以下は、より長いものの例です。

<!DOCTYPE HTML>
 <HTML LANG="EN">
  <HEAD>
   <META CHARSET="UTF-8">
   <BASE HREF="https://www.example.com/">
   <TITLE>An application with a long head</TITLE>
   <LINK REL="STYLESHEET" HREF="default.css">
   <LINK REL="STYLESHEET ALTERNATE" HREF="big.css" TITLE="Big Text">
   <SCRIPT SRC="support.js"></SCRIPT>
   <META NAME="APPLICATION-NAME" CONTENT="Long headed application">
  </HEAD>
  <BODY>
  ...

title 要素はほとんどの状況で必須の子要素ですが、 上位プロトコルがタイトル情報を提供する場合、たとえばHTMLがメール作成形式として使用される場合のメールの件名で、 title要素は省略できます。

4.2.2 title 要素

Element/title

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer1+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLTitleElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
メタデータ コンテンツ。
この要素が使用されるコンテキスト:
他のtitle要素を含まないhead要素内で。
コンテンツモデル:
テキストであり、要素間の空白ではないもの。
text/html でのタグ省略:
いずれのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLTitleElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString text;
 };

title要素は、ドキュメントのタイトルまたは名前を表します。 著者は、ドキュメントが文脈を外れて使用された場合でも識別できるタイトルを使用するべきです。例えば、ユーザーの履歴やブックマーク、検索結果などで使用される場合です。ドキュメントのタイトルは、文脈を外れても独立して存在する必要がない最初の見出しとは異なることが多いです。

ドキュメントにはtitle要素が1つしか存在してはいけません。

ドキュメントDocumentにタイトルが必要ない場合は、title要素が不要である可能性があります。要素が必要かどうかについては、head要素のコンテンツモデルを参照してください。

title.text [ = value ]

要素の子テキストコンテンツを返します。

設定可能であり、指定された値で要素の子を置き換えます。

text 属性のゲッターは、このtitle要素の子テキストコンテンツを返す必要があります。

text属性のセッターは、すべての文字列を置き換え、このtitle要素内に指定された値を適用する必要があります。

ここでは、適切なタイトルの例と、その同じページで使用されるトップレベルの見出しとの対比を示します。

  <title>Introduction to The Mating Rituals of Bees</title>
     ...
   <h1>Introduction</h1>
   <p>This companion guide to the highly successful
   <cite>Introduction to Medieval Bee-Keeping</cite> book is...

次のページは同じサイトの一部かもしれません。タイトルが主題を明確に記述しているのに対して、最初の見出しは文脈を理解している読者を前提としているため、ダンスがサルサなのかワルツなのかを疑問に思うことはありません:

  <title>Dances used during bee mating rituals</title>
     ...
   <h1>The Dances</h1>

ドキュメントのタイトルとして使用する文字列は、document.titleIDL属性によって与えられます。

ユーザーエージェントは、ユーザーインターフェイスでドキュメントを参照する際に、ドキュメントのタイトルを使用する必要があります。title要素の内容がこのように使用される場合、そのtitle要素の方向性を使用して、ユーザーインターフェイス内でドキュメントのタイトルの方向性を設定する必要があります。

4.2.3 base 要素

Element/base

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLBaseElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
メタデータ コンテンツ。
この要素が使用されるコンテキスト:
他のbase要素を含まないhead要素内で。
コンテンツモデル:
なし。
text/html でのタグ省略:
終了タグはありません。
コンテンツ属性:
グローバル属性
href — ドキュメントの基本 URL
target — デフォルトのナビゲーション可能なハイパーリンクのナビゲーションおよびフォームの送信
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLBaseElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute USVString href;
   [CEReactions] attribute DOMString target;
 };

base要素は、ドキュメントの基本 URLを指定して、URLの解析を行うためのものであり、ナビゲーション可能なデフォルトの名前を指定してハイパーリンクをたどるためのものです。この要素は、この情報以外のコンテンツを表すものではありません。

ドキュメントにはbase要素が1つしか存在してはいけません。

base要素には、href属性、target属性、またはその両方が必要です。

href属性が指定されている場合、その内容は有効な URLを含んでいる必要があります。

base 要素は、href 属性を持つ場合、URL を取るように定義された属性を持つツリー内の他のどの要素よりも前に来なければなりません。

href 属性を持つbase 要素が複数ある場合、最初の要素以外はすべて無視されます。

target属性が指定されている場合、それには有効なナビゲーション可能なターゲット名またはキーワードが含まれている必要があります。これは、ナビゲーション可能な要素がハイパーリンクおよびフォームがナビゲーションを行う際のデフォルトとして使用されることを指定します。

base要素がtarget属性を持つ場合、それはツリー内のハイパーリンクを表す要素の前に配置されなければなりません。

複数のbase要素がtarget属性を持つ場合、最初の要素以外は無視されます。

要素のターゲットを取得するには、a、area、またはform要素elementおよびオプションの文字列またはnull（デフォルトはnull）targetを指定して、次の手順を実行します。

  1. もしtargetがnullであれば：

    1. もしelementがtarget属性を持っていれば、その属性の値をtargetに設定します。

    2. それ以外の場合、elementのノードドキュメントにbase要素がtarget属性を持っていれば、最初のそのようなbase要素のtarget属性の値をtargetに設定します。

  2. もしtargetがnullでなく、ASCII タブまたは改行文字を含み、かつU+003C（<）を含んでいる場合、targetを"_blank"に設定します。

  3. targetを返します。

base要素が最初のbase要素であり、hrefコンテンツ属性を持つ要素である場合、凍結された基本 URLを持ちます。次のいずれかの状況が発生したときに、凍結された基本 URLを即座に設定しなければなりません。

凍結された基本 URL を設定するには、要素elementに対して次の手順を実行します：

  1. elementのノードドキュメントをdocumentとします。

  2. urlRecordを、elementのhrefコンテンツ属性の値をdocumentのフォールバック基本 URLおよびdocumentの文字エンコーディングで解析した結果とします。（したがって、base要素は自身に影響を受けません。）

  3. 次のいずれかが真である場合：

  4. elementの凍結された基本 URLをurlRecordに設定します。

hrefIDL属性は、取得時に次のアルゴリズムを実行した結果を返す必要があります：

  1. elementのノードドキュメントをdocumentとします。

  2. urlを、この要素のhref属性の値（存在する場合）とし、存在しない場合は空文字列とします。

  3. urlRecordを、documentのフォールバック基本 URLおよびdocumentの文字エンコーディングでurlを解析した結果とします。（したがって、base要素は他のbase要素や自身の影響を受けません。）

  4. urlRecordが失敗した場合、urlを返します。

  5. urlRecordのシリアル化を返します。

hrefIDL属性は、設定時に、指定された新しい値でhrefコンテンツ属性を設定する必要があります。

targetIDL属性は、同じ名前のコンテンツ属性を反映する必要があります。

この例では、base要素を使用して、ドキュメントの基本 URLを設定しています：

<!DOCTYPE html>
 <html lang="en">
     <head>
         <title>This is an example for the &lt;base&gt; element</title>
         <base href="https://www.example.com/news/index.html">
     </head>
     <body>
         <p>Visit the <a href="archives.html">archives</a>.</p>
     </body>
 </html>

上記の例のリンクは、"https://www.example.com/news/archives.html" へのリンクになります。

要素/link

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLLinkElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
メタデータコンテンツ.
要素がbodyに許可されている場合: フローコンテンツ.
要素がbodyに許可されている場合: フレージングコンテンツ.
この要素が使用できるコンテキスト:
メタデータコンテンツが期待される場所。
noscript要素の中で、かつhead要素の子として。
要素がbodyに許可されている場合: フレージングコンテンツが期待される場所。
コンテンツモデル:
なし.
text/htmlにおけるタグの省略:
終了タグなし。
コンテンツ属性:
グローバル属性
href — ハイパーリンクのアドレス
crossorigin — 要素がクロスオリジンリクエストをどのように処理するか
rel — ハイパーリンクを含む文書とリンク先のリソースとの関係
media — 適用可能なメディア
integrity — サブリソースインテグリティチェックに使用されるインテグリティメタデータ [SRI]
hreflang — リンクされたリソースの言語
type — 参照されるリソースの種類のヒント
referrerpolicy — 要素によって開始されるフェッチに対するリファラーポリシー
sizes — アイコンのサイズ（rel="icon"の場合）
imagesrcset — 異なる状況（例：高解像度ディスプレイ、小型モニターなど）で使用する画像（rel="preload"の場合）
imagesizes — 異なるページレイアウトに対応する画像のサイズ（rel="preload"の場合）
as — プリロードリクエストの潜在的な宛先（rel="preload"およびrel="modulepreload"の場合）
blocking — 要素が潜在的にレンダーブロックかどうか
color — サイトのアイコンをカスタマイズするときに使用する色（rel="mask-icon"の場合）
disabled — リンクが無効かどうか
fetchpriority — 要素によって開始されるフェッチに対する優先度を設定
また、この要素の特別なセマンティクスを持つ属性としてtitleがあります: リンクのタイトル; CSSスタイルシートセット名
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOMインターフェイス:
[Exposed=Window]
 interface HTMLLinkElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute USVString href;
   [CEReactions] attribute DOMString? crossOrigin;
   [CEReactions] attribute DOMString rel;
   [CEReactions] attribute DOMString as;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList relList;
   [CEReactions] attribute DOMString media;
   [CEReactions] attribute DOMString integrity;
   [CEReactions] attribute DOMString hreflang;
   [CEReactions] attribute DOMString type;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList sizes;
   [CEReactions] attribute USVString imageSrcset;
   [CEReactions] attribute DOMString imageSizes;
   [CEReactions] attribute DOMString referrerPolicy;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList blocking;
   [CEReactions] attribute boolean disabled;
   [CEReactions] attribute DOMString fetchPriority;
 
   // 古いメンバーもあります
 };
 HTMLLinkElement には LinkStyle;

link要素は、著者がドキュメントを他のリソースにリンクさせることを可能にします。

リンクのアドレスはhref属性によって指定されます。href属性が存在する場合、その値は有効な空でないURL（周囲にスペースがある可能性あり）でなければなりません。hrefまたはimagesrcsetのいずれか、または両方の属性が存在している必要があります。

hrefおよびimagesrcset属性が両方とも存在しない場合、この要素はリンクを定義しません。

示されるリンクの種類（関係性）はrel属性の値によって決定されます。もし存在するならば、その値はユニークな空白で区切られたトークンの順不同セットでなければなりません。許可されるキーワードとその意味は後のセクションで定義されています。rel属性が存在しない、またはキーワードがない、または使用されたキーワードがこの仕様で定義されている許可されたキーワードに該当しない場合、この要素はリンクを作成しません。

relのサポートされるトークンは、HTMLリンクタイプで定義されており、link要素に許可されているもの、処理モデルに影響を与えるもの、そしてユーザーエージェントでサポートされているものです。可能なサポートされるトークンは以下の通りです：alternate、dns-prefetch、expect、icon、manifest、modulepreload、next、pingback、preconnect、prefetch、preload、search、およびstylesheetです。relのサポートされるトークンは、ユーザーエージェントが処理モデルを実装しているこのリストのトークンのみを含める必要があります。

理論的には、canonicalキーワードの処理モデルをサポートするユーザーエージェントが存在する可能性がありますが、それはJavaScriptを実行する検索エンジンである場合に限られます。しかし、実際にはそれは非常にまれです。したがって、ほとんどの場合、canonicalはrelのサポートされるトークンに含めるべきではありません。

link要素は、rel属性またはitemprop属性のいずれか一方、しかし両方ではなく、を持つ必要があります。

link要素がitemprop属性を持っているか、またはrel属性にbody-okとして指定されているキーワードのみが含まれている場合、その要素は本文に許可されるとされます。これは、その要素がフレージングコンテンツが期待される場所で使用できることを意味します。

もしrel属性が使用されている場合、この要素はページのbody内でのみ使用できる場合があります。itemprop属性と一緒に使用される場合、この要素はhead要素内およびページのbody内の両方で使用できますが、これはマイクロデータモデルの制約を受けます。

link要素を使用して、2つのカテゴリのリンクを作成できます: 外部リソースへのリンクとハイパーリンクです。リンクタイプのセクションでは、特定のリンクタイプが外部リソースかハイパーリンクかを定義しています。1つのlink要素は、複数のリンクを作成できます（そのうちのいくつかは外部リソースリンクで、他はいくつかはハイパーリンクであるかもしれません）。どのリンクがどれだけ作成されるかは、rel属性に指定されたキーワードによって決まります。ユーザーエージェントは、リンクを要素単位ではなく、リンク単位で処理する必要があります。

1つのlink要素で作成される各リンクは、個別に処理されます。例えば、link要素が2つあり、どちらもrel="stylesheet"である場合、それぞれが別個の外部リソースと見なされ、各リソースはそれぞれの属性によって独立して影響を受けます。同様に、1つのlink要素がrel属性にnext stylesheetの値を持つ場合、それはnextキーワードによって1つのハイパーリンクとstylesheetキーワードによって1つの外部リソースリンクを作成し、他の属性（例えばmediaやtitle）によって異なる影響を受けます。

例えば、次のlink要素は、同じページへの2つのハイパーリンクを作成します：

<link rel="author license" href="/about">

この要素によって作成される2つのリンクは、1つが現在のページの著者に関する情報を持っているという意味を持ち、もう1つが現在のページが提供されているライセンスに関する情報を持っているという意味を持っています。

ハイパーリンクは、link要素とそのrel属性で作成され、ドキュメント全体に適用されます。これは、rel属性を持つaやarea要素とは対照的であり、これらの要素はドキュメント内でリンクが配置された場所によってリンクのコンテキストが決まります。

aおよびarea要素によって作成されたリンクとは異なり、ハイパーリンクは、link要素によって作成されても、デフォルトではドキュメントの一部として表示されません。これらのリンクは主にセマンティック情報を提供し、その情報はページやページのコンテンツを消費する他のソフトウェアによって使用される可能性があります。さらに、ユーザーエージェントは、そのようなハイパーリンクをたどるための独自のUIを提供することができます。

外部リソースへのリンクの正確な動作は、関連するリンクタイプで定義された正確な関係に依存します。

crossorigin属性は、CORS設定属性です。これは、外部リソースリンクでの使用を意図しています。

media属性は、リソースが適用されるメディアを指定します。値は有効なメディアクエリリストでなければなりません。

サブリソースの整合性

すべての現在のエンジンでサポートされています。

Firefox43+ Safari11.1+ Chrome45+
Opera? Edge79+
Edge (レガシー)17+ Internet Explorerサポートされていません
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

integrity 属性は、この要素が担当するリクエストの 整合性メタデータ を表します。値はテキストです。この属性は、link 要素で、rel 属性に stylesheet、 preload、 または modulepreload キーワードを含む場合にのみ指定する必要があります。 [SRI]

hreflang 属性は、 link 要素にあり、 hreflang 属性と同じ意味を持ちます。

type 属性は、リンクされたリソースの MIME タイプ を指定します。これは純粋に参考のためのものです。値は 有効な MIME タイプ文字列 でなければなりません。

外部リソースリンク の場合、 type 属性は、ユーザーエージェントがサポートしていないリソースを フェッチしないようにするためのヒントとして使用されます。

referrerpolicy属性は、リファラーポリシー属性です。これは外部リソースリンクでの使用を意図しており、リンクされたリソースをフェッチおよび処理する際に使用されるリファラーポリシーを設定するのに役立ちます。[REFERRERPOLICY]

title 属性はリンクのタイトルを指定します。 1つの例外を除いて、これは純粋に参考のためのものです。その例外は、ドキュメントツリー内 にある スタイルシートリンクの場合で、この場合、title 属性は、 CSS スタイルシートセット を定義します。

title 属性は、 link 要素のグローバル属性である title 属性とは異なります。 他の多くの要素においては、タイトルのないリンクは親要素のタイトルを継承しません。それは単にタイトルがないだけです。

imagesrcset属性が存在する可能性があり、これはsrcset属性です。

imagesrcset属性とhref属性（幅記述子が使用されていない場合）を一緒に使用すると、画像ソースがソースセットに追加されます。

もしimagesrcset属性が存在し、かつ画像候補文字列が幅記述子を使用している場合、imagesizes属性も存在する必要があり、これはサイズ属性です。imagesizes属性はソースサイズをソースセットに提供します。

imagesrcset属性とimagesizes属性は、link要素にのみ指定する必要があります。この要素には、rel属性にpreloadキーワードが指定されていること、およびas属性が"image"状態にあることが条件となります。

これらの属性を使用すると、後で対応するsrcsetおよびsizes属性を持つimg要素で使用される適切なリソースをプリロードできます。 

<link rel="preload" as="image" imagesrcset="wolf_400px.jpg 400w, wolf_800px.jpg 800w, wolf_1600px.jpg 1600w" imagesizes="50vw">

この例では、href属性を省略しています。これは、imagesrcsetをサポートしないブラウザに対してのみ関連性があり、その場合、誤った画像がプリロードされる可能性があるためです。

imagesrcset属性は、media属性と組み合わせて使用することができ、アートディレクション用のリソースを適切にプリロードできます。

<link rel="preload" as="image" imagesrcset="dog-cropped-1x.jpg, dog-cropped-2x.jpg 2x" media="(max-width: 800px)">

sizes属性は、視覚メディア用のアイコンのサイズを指定します。値が存在する場合、それは単なるアドバイスです。ユーザーエージェントは、複数のアイコンが利用可能な場合にどのアイコンを使用するかを決定するために値を使用する可能性があります。指定されている場合、属性の値は一意のスペースで区切られたトークンの順序のないセットであり、ASCII大文字と小文字を区別しないである必要があります。各値は、文字列"any"とASCII大文字と小文字を区別しない一致を持つか、または有効な非負整数2つで構成され、それらはU+0030DIGIT ZERO (0)文字を先頭に持たず、1つのU+0078 LATIN SMALL LETTER XまたはU+0058 LATIN CAPITAL LETTER X文字で区切られます。この属性は、link要素にのみ指定される必要があります。この要素にはrel属性が指定されており、アイコンキーワードまたはapple-touch-iconキーワードを指定している必要があります。

apple-touch-iconキーワードは、リンクタイプの事前定義セットへの拡張として登録されていますが、ユーザーエージェントはこれをサポートする必要はありません。

as属性は、href属性で指定されたリソースのプリロードリクエストの潜在的な宛先を指定します。これは列挙された属性です。各潜在的な宛先は、この属性のキーワードであり、同名の状態にマッピングされます。この属性は、link要素に指定する必要があり、rel属性にpreloadキーワードが含まれている必要があります。link要素には、rel属性にmodulepreloadキーワードが含まれている場合に指定することができます。その場合、スクリプトに類似した宛先の値を持たなければなりません。他のlink要素では、指定する必要はありません。

as属性の使用方法に関する処理モデルは、個々のリンクタイプのリンクされたリソースのフェッチおよび処理アルゴリズムに記載されています。

この属性には、欠落値のデフォルトまたは無効値のデフォルトがありません。したがって、属性の無効な値や欠落した値は、どの状態にもマップされません。これは処理モデルで考慮されています。preloadリンクの場合、どちらの条件もエラーです。modulepreloadリンクの場合、欠落値は"script"として扱われます。

blocking属性は、ブロッキング属性です。この属性は、stylesheetおよびexpectリンクタイプで使用され、これらのキーワードを含むrel属性を持つリンク要素にのみ指定される必要があります。

color属性はmask-iconリンクタイプで使用されます。この属性は、link要素にのみ指定される必要があります。この要素にはrel属性が含まれ、mask-iconキーワードを含んでいる必要があります。値は、CSSの<color>プロダクションと一致する文字列である必要があり、サイトをピン留めした際にユーザーが表示するアイコンの表示をカスタマイズするための推奨される色を定義します。

この仕様には、color属性に関するユーザーエージェントの要件は含まれていません。

mask-iconキーワードは、リンクタイプの事前定義セットへの拡張として登録されていますが、ユーザーエージェントはこれをサポートする必要はありません。

link要素には、明示的に有効化されているかどうかを示すブール値が関連付けられています。これは初期状態ではfalseです。

disabled属性はブール属性であり、stylesheetリンクタイプで使用されます。この属性は、link要素にのみ指定される必要があります。この要素にはrel属性が含まれ、stylesheetキーワードを含んでいる必要があります。

いつでもdisabled属性が削除されると、link要素の明示的に有効化された属性がtrueに設定されます。

disabled属性を動的に削除すると、例えばdocument.querySelector("link").removeAttribute("disabled")を使用することで、スタイルシートがフェッチされて適用されます。 

<link disabled rel="alternate stylesheet" href="css/pooh">

HTMLLinkElement/fetchPriority

FirefoxいいえSafari🔰 プレビュー+Chrome102+
Opera不明Edge102+
Edge (レガシー)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

fetchpriority属性はフェッチ優先度属性であり、外部リソースリンクで使用することを目的としています。ここでは、リンクされたリソースをフェッチして処理する際に使用される優先順位を設定します。

HTMLLinkElement/rel

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android12.1+

IDL属性href、hreflang、integrity、media、rel、sizes、type、blocking、およびdisabledは、それぞれ同名のコンテンツ属性を反映する必要があります。

color属性には反映されるIDL属性がありませんが、これは後で追加される可能性があります。

HTMLLinkElement/as

すべての現在のエンジンでサポートされています。

Firefox56+Safari10+Chrome50+
Opera不明Edge79+
Edge (レガシー)17+Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

asIDL属性は、asコンテンツ属性を反映し、既知の値のみに限定されます。

crossOriginIDL属性は、crossoriginコンテンツ属性を反映し、既知の値のみに限定されます。

HTMLLinkElement/referrerPolicy

すべての現在のエンジンでサポートされています。

Firefox50+Safari14.1+Chrome58+
Opera不明Edge79+
Edge (レガシー)不明Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

referrerPolicyIDL属性は、referrerpolicyコンテンツ属性を反映し、既知の値のみに限定されます。

fetchPriorityIDL属性は、fetchpriorityコンテンツ属性を反映し、既知の値のみに限定されます。

imageSrcsetIDL属性は、imagesrcsetコンテンツ属性を反映しなければなりません。

imageSizesIDL属性は、imagesizesコンテンツ属性を反映しなければなりません。

HTMLLinkElement/relList

すべての現在のエンジンでサポートされています。

Firefox30+Safari9+Chrome50+
Opera不明Edge79+
Edge (レガシー)17+Internet Explorerいいえ
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

relListIDL属性は、relコンテンツ属性を反映しなければなりません。

relList属性は、機能検出に使用できます。supports()メソッドを呼び出して、どのリンクタイプがサポートされているかを確認することができます。

4.2.4.1 media 属性の処理

リンクが ハイパーリンク である場合、media 属性は純粋に助言的なものであり、当該文書がどのメディア向けに設計されているかを説明します。

しかし、リンクが 外部リソースリンク である場合、media 属性は強制的です。ユーザーエージェントは、media 属性の値が環境と一致する場合、他の関連する条件が適用されるときに外部リソースを適用し、そうでない場合は適用してはなりません。

media 属性が省略された場合のデフォルトは「all」であり、デフォルトではリンクはすべてのメディアに適用されることを意味します。

外部リソースにはその適用範囲を制限するさらなる制約が定義されている場合があります。たとえば、CSSスタイルシートには@mediaブロックが含まれていることがあります。この仕様は、そのような追加の制約や要件を上書きしません。

4.2.4.2 type 属性の処理

type 属性が存在する場合、ユーザーエージェントはリソースが指定されたタイプであると仮定しなければなりません（たとえそれが有効なMIMEタイプ文字列ではない場合、例えば空文字列であっても）。属性が省略されているが、外部リソースリンク タイプにデフォルトのタイプが定義されている場合、ユーザーエージェントはリソースがそのタイプであると仮定しなければなりません。ユーザーエージェントが指定されたリンクの関係に対して指定されたMIMEタイプをサポートしていない場合、ユーザーエージェントはリンクされたリソースを取得および処理してはならず、ユーザーエージェントが指定されたリンク関係に対して指定されたMIMEタイプをサポートしている場合、ユーザーエージェントは外部リソースリンクの特定のタイプに指定された適切なタイミングでリンクされたリソースを取得および処理する必要があります。属性が省略されていて、外部リソースリンクのタイプにデフォルトのタイプが定義されていないが、ユーザーエージェントがタイプが既知でサポートされている場合にリンクされたリソースを取得および処理する場合、ユーザーエージェントはリンクされたリソースがサポートされると仮定して取得および処理するべきです。

ユーザーエージェントは、 type 属性を権威あるものと見なしてはなりません。リソースを取得した際、ユーザーエージェントは type 属性を使用してその実際のタイプを決定してはなりません。リソースを適用するかどうかを決定するために使用されるのは、上記の仮定されたタイプではなく、実際のタイプです。

stylesheetリンクタイプは、リソースの Content-Type メタデータ を処理するためのルールを定義しています。

ユーザーエージェントがリソースのタイプを確立したら、ユーザーエージェントはサポートされているタイプであり、他の関連条件が適用される場合にリソースを適用し、そうでない場合はリソースを無視する必要があります。

ドキュメントに以下のようにラベル付けされたスタイルシートリンクが含まれている場合：

<link rel="stylesheet" href="A" type="text/plain">
<link rel="stylesheet" href="B" type="text/css">
<link rel="stylesheet" href="C">

...その場合、CSSスタイルシートのみをサポートする準拠したユーザーエージェントは、BファイルとCファイルを取得し、Aファイルをスキップします（text/plainがCSSスタイルシートのMIMEタイプではないため）。

BファイルとCファイルについては、次にサーバーによって返された実際のタイプを確認します。それらが text/cssとして送信された場合、スタイルが適用されますが、それが text/plain、またはその他のタイプとしてラベル付けされている場合は適用されません。

もし2つのファイルのうち1つが Content-Type メタデータ なしで返されたり、「null」のような構文的に誤ったタイプで返されたりした場合、stylesheetリンクのデフォルトタイプが適用されます。このデフォルトタイプが text/cssであるため、スタイルシートは適用されます。

デフォルトのリンクされたリソースの取得と処理は、link 要素elを引数として以下の手順で行います：

  1. optionsをリンク要素からオプションを作成する結果として取得します。

  2. requestをリンクリクエストを作成する結果として取得します。

  3. requestがnullである場合、リターンします。

  4. requestの同期フラグを設定します。

  5. リンクされたリソースの取得準備ステップを実行し、elとrequestを渡します。結果がfalseの場合、リターンします。

  6. requestのイニシエータータイプを、elのrel属性にキーワードstylesheetが含まれている場合は「css」、それ以外の場合は「link」に設定します。

  7. リクエストをフェッチし、レスポンス処理ボディを消費するを次の手順で設定し、 レスポンス responseとnull、失敗、またはバイトシーケンス bodyBytesを指定します：

    1. successをtrueに設定します。

    2. 次のいずれかがtrueである場合：

      その場合、successをfalseに設定します。

      CSSのパースエラーやPNGのデコードエラーなど、コンテンツ固有のエラーはsuccessに影響を与えません。

    3. それ以外の場合、リンクリソースのクリティカルサブリソースの読み込みが完了するまで待機します。

      リンクタイプのクリティカルサブリソースを定義する仕様（例：CSS）は、これらのサブリソースがどのようにフェッチされ処理されるかを記述することが期待されています。しかし、これは現在明示的ではないため、この仕様ではリンクリソースのクリティカルサブリソースがフェッチされ処理されるのを待つことを記述し、これが正しく行われることを期待しています。

    4. リンクされたリソースを処理するステップを、el、success、response、およびbodyBytesを指定して実行します。

リンクリクエストを作成するためには、リンク処理オプション optionsを使用します：

  1. アサート：optionsのhrefが空文字列でないことを確認します。

  2. もしoptionsのdestinationがnullである場合、nullを返します。

  3. urlをURLのエンコードとパースの結果として取得し、optionsのhrefを基にoptionsの基本URLに対して相対的に行います。

    基本URLをドキュメントや環境の代わりに渡すことはissue #9715によって追跡されています。

  4. urlが失敗した場合、nullを返します。

  5. requestをポテンシャルCORSリクエストを作成する結果として取得し、url、optionsのdestination、およびoptionsのcrossoriginを指定します。

  6. requestのポリシーコンテナをoptionsのポリシーコンテナに設定します。

  7. requestのインテグリティメタデータをoptionsのインテグリティに設定します。

  8. requestの暗号学的ナンスメタデータをoptionsの暗号学的ナンスメタデータに設定します。

  9. requestのリファラーポリシーをoptionsのリファラーポリシーに設定します。

  10. requestのクライアントをoptionsの環境に設定します。

  11. requestの優先度をoptionsのフェッチ優先度に設定します。

  12. requestを返します。

ユーザーエージェントは、必要に応じてのみこれらのリソースをフェッチして処理することを選択するかもしれません。すべての外部リソースを事前に積極的にフェッチする代わりに、適用されていないものはフェッチしません。

リンクされたリソースの取得と処理アルゴリズムに類似して、すべての外部リソースリンクは、リンクされたリソースを処理するアルゴリズムを持っており、これにはlink要素el、ブール値success、レスポンスresponse、およびバイトシーケンスbodyBytesを引数とします。個別のリンクタイプが独自のリンクされたリソースを処理するアルゴリズムを提供することがありますが、特に明記されていない限り、そのアルゴリズムは何も行いません。

特定のrelキーワードに対して別段の指定がない限り、要素はその要素のロードイベントを遅延させる必要があります。この遅延は要素のノードドキュメントまで適用され、すべての試みがリンクされたリソースの取得と処理とそのクリティカルサブリソースの完了まで行われます。（ユーザーエージェントがまだフェッチおよび処理を試みていないリソース、例えばリソースが必要になるまで待機しているものはロードイベントを遅延しません。）

外部リソースリンクとなりうるすべてのリンクタイプは、リンク処理オプションを受け取る、リンクヘッダーを処理するアルゴリズムを定義しています。このアルゴリズムは、HTTPレスポンスヘッダーに`Link` ヘッダーとして表示された場合に、それらがどのように反応するかを定義します。

ほとんどのリンクタイプでは、このアルゴリズムは何もしません。要約表は、リンクタイプが定義されたリンクヘッダーを処理する手順を持っているかどうかをすばやく確認するのに役立ちます。

リンク処理オプションは構造体です。次の項目があります:

href (デフォルトは空文字列)
宛先 (デフォルトは空文字列)
起動者 (デフォルトは"link")
integrity (デフォルトは空文字列)
type (デフォルトは空文字列)
暗号化ノンスメタデータ (デフォルトは空文字列)
文字列
クロスオリジン (デフォルトはクロスオリジンなし)
CORS設定属性の状態
リファラーポリシー (デフォルトは空文字列)
リファラーポリシー
ソースセット (デフォルトはnull)
nullまたはソースセット
ベースURL
URL
オリジン
オリジン
環境
環境
ポリシーコンテナ
ポリシーコンテナ
ドキュメント (デフォルトはnull)
nullまたはDocument
ドキュメント準備完了時 (デフォルトはnull)
nullまたはDocumentを受け取るアルゴリズム
フェッチの優先度 (デフォルトはAuto)
フェッチ優先度属性の状態

リンク処理オプションにはベースURLとhrefがありますが、これは、URLがオプションのソースセットの結果である可能性があるためです。

リンク要素からリンクオプションを作成するには、link要素elを指定します:

  1. documentをelのノードドキュメントとします。

  2. optionsを次のリンク処理オプションとして新しく作成します。

    宛先
    elのas属性の状態を翻訳した結果。
    クロスオリジン
    elのcrossoriginコンテンツ属性の状態
    リファラーポリシー
    elのreferrerpolicyコンテンツ属性の状態
    ソースセット
    elのソースセット
    ベースURL
    documentのドキュメントベースURL
    オリジン
    documentのオリジン
    環境
    documentの関連設定オブジェクト
    ポリシーコンテナ
    documentのポリシーコンテナ
    ドキュメント
    document
    暗号化ノンスメタデータ
    elの[[CryptographicNonce]]内部スロットの現在の値
    フェッチの優先度
    elのfetchpriorityコンテンツ属性の状態

  3. もしelがhref属性を持っている場合、optionsのhrefを elのhref属性の値に設定します。

  4. もしelがintegrity属性を持っている場合、optionsのintegrityをelのintegrityコンテンツ属性の値に設定します。

  5. もしelがtype属性を持っている場合、optionsのtypeを elのtype属性の値に設定します。

  6. アサート: optionsのhrefが空文字列でないか、またはoptionsのソースセットがnullでないか。

    link要素がhrefやimagesrcsetを持たない場合、リンクを表しません。

  7. optionsを返します。

ヘッダーからリンクを抽出するには、ヘッダーリスト headersを指定します:

  1. linksを新しいリストとします。

  2. rawLinkHeaders を、headers から `Link` を取得、デコード、および分割した結果とします。

  3. 各 linkHeaderに対して、rawLinkHeadersの内容を次のように処理します:

    1. linkObjectをlinkHeaderのパースした結果とする。[WEBLINK]

    2. もしlinkObject["target_uri"]が存在しない場合、続行する。

    3. linkObjectをlinksに追加する。

  4. linksを返します。

リンクヘッダーを処理するには、Document doc、レスポンス response、および"pre-media"または"media"phaseを指定します:

  1. linksを次の結果として取得します。リンクを抽出する responseのヘッダーリストから取得します。

  2. 各 linkObjectに対して、linksの内容を次のように処理します:

    1. relをlinkObject["relation_type"]として取得します。

    2. attribsをlinkObject["target_attributes"]として取得します。

    3. expectedPhaseを"media"として取得します。もしsrcset、 "imagesrcset", またはmediaがattribsに存在する場合、それ以外の場合は"pre-media"を取得します。

    4. もしexpectedPhaseがphaseでない場合、処理を続けます。

    5. もしattribs["media"]が存在し、attribs["media"]が環境に一致しない場合、処理を続けます。

    6. optionsを次のリンク処理オプションとして新しく作成します。

      href
      linkObject["target_uri"]
      ベースURL
      docのドキュメントベースURL
      オリジン
      docのオリジン
      環境
      docの関連設定オブジェクト
      ポリシーコンテナ
      docのポリシーコンテナ
      ドキュメント
      doc

    7. 解析されたヘッダー属性からリンクオプションを適用します。attribsを指定してoptionsに適用します。

    8. もしattribs["imagesrcset"]が存在し、attribs["imagesizes"]が存在する場合、optionsのソースセットをlinkObject["target_uri"], attribs["imagesrcset"],attribs["imagesizes"],およびnullを指定してソースセットを作成します。

    9. リンクヘッダーを処理する手順をrelに対して実行し、optionsを指定します。

解析されたヘッダー属性からリンクオプションを適用するには、リンク処理オプション optionsをattribsを指定して適用します:

  1. もしattribs["as"]が存在する場合、optionsの宛先をattribs["as"]を翻訳した結果に設定します。

  2. もしattribs["crossorigin"]が存在し、ASCII大文字小文字を区別しない比較により、CORS設定属性キーワードのいずれかに一致する場合、optionsのクロスオリジンをそのキーワードに対応するCORS設定属性状態に設定します。

  3. もしattribs["integrity"]が存在する場合、optionsのintegrityをattribs["integrity"]に設定します。

  4. もしattribs["referrerpolicy"]が存在し、ASCII大文字小文字を区別しない比較により、リファラーポリシーのいずれかに一致する場合、optionsのリファラーポリシーをそのリファラーポリシーに設定します。

  5. もしattribs["nonce"]が存在する場合、optionsのノンスをattribs["nonce"]に設定します。

  6. もしattribs["type"]が存在する場合、optionsのタイプをattribs["type"]に設定します。

  7. もしattribs["fetchpriority"]が存在し、ASCII大文字小文字を区別しない比較により、フェッチ優先度属性キーワードのいずれかに一致する場合、optionsのフェッチの優先度をそのフェッチ優先度属性キーワードに設定します。

4.2.4.5早期ヒント

Status/103

Firefoxpreview+SafariNoChrome103+
OperaNoEdge103+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

早期ヒントは、ナビゲーションリクエストがサーバーによって完全に処理され、レスポンスコードが提供される前に、ドキュメントによって使用される可能性のあるリソースを推測的にロードするなど、ユーザーエージェントがいくつかの操作を実行できるようにします。サーバーは、最終的なレスポンスを提供する前に、103ステータスコードを使用してレスポンスを提供することで早期ヒントを示すことができます。[RFC8297]

互換性の理由から、早期ヒントは通常HTTP/2以降で提供されますが、可読性のために、以下ではHTTP/1.1スタイルの表記を使用しています。

たとえば、次のレスポンスシーケンスが与えられた場合:

103 Early Hint
 Link: </image.png>; rel=preload; as=image
200 OK
 Content-Type: text/html
 
 <!DOCTYPE html>
 ...
 <img src="/image.png">

画像はHTMLコンテンツが到着する前にロードを開始します。

ナビゲーション中に提供される最初の早期ヒントレスポンスのみが処理され、クロスオリジンリダイレクトが続く場合は破棄されます。

`Link` ヘッダーに加えて、103レスポンスにコンテンツセキュリティポリシーヘッダーが含まれている可能性があり、早期ヒントを処理する際に適用されます。

たとえば、次のレスポンスシーケンスが与えられた場合:

103 Early Hint
 Content-Security-Policy: style-src: self;
 Link: </style.css>; rel=preload; as=style
103 Early Hint
 Link: </image.png>; rel=preload; as=image
302 Redirect
 Location: /alternate.html
200 OK
 Content-Security-Policy: style-src: none;
 Link: </font.ttf>; rel=preload; as=font

フォントとスタイルはロードされ、画像は破棄されます。最終的なリダイレクトチェーンで最初の早期ヒントレスポンスのみが尊重されます。リクエストがスタイルをフェッチする前に遅れて送信されたコンテンツセキュリティポリシーヘッダーは、スタイルがドキュメントにアクセスできないようにします。

早期ヒントヘッダーを処理するには、レスポンス responseと環境 reservedEnvironmentを指定します:

早期ヒント`Link` ヘッダーは、最終的なレスポンスからの`Link` ヘッダー、次にlink要素の前に常に処理されます。これは、早期および最終的な`Link`ヘッダーの内容を、Documentのhead要素にそれぞれ順番に追加することと同等です。

  1. earlyPolicyContainerをresponseとreservedEnvironmentを指定してフェッチレスポンスからポリシーコンテナを作成した結果とします。

    これにより、早期ヒントレスポンスにコンテンツセキュリティポリシーを含めることができ、早期ヒントリクエストをフェッチするときに適用されます。

  2. linksをresponseのヘッダーリストからリンクを抽出した結果とします。

  3. earlyHintsを空のリストとします。

  4. 各 linkObjectに対して、linksの内容を次のように処理します:

    早期ヒントリンクヘッダーを受信した瞬間に、earlyRequestのフェッチを開始します。Documentが作成される前に戻ってきた場合、そのレスポンスをearlyResponseとして設定し、Documentが作成されると、それをコミットします（link要素であるかのようにプリロードされたリソースのマップで利用可能にします）。Documentが先に作成された場合、レスポンスが利用可能になった時点でそれをコミットします。

    1. relをlinkObject["relation_type"]として取得します。

    2. optionsを次のリンク処理オプションとして新しく作成します。

      href
      linkObject["target_uri"]
      起動者
      "early-hint"
      ベースURL
      responseのURL
      オリジン
      responseのURLのオリジン
      環境
      reservedEnvironment
      ポリシーコンテナ
      earlyPolicyContainer

    3. attribsをlinkObject["target_attributes"]として取得します。

      as、 crossorigin、 integrity、 およびtype属性は、早期ヒント処理の一部として処理されます。他の属性、特にblocking、 imagesrcset、 imagesizes、 およびmediaは、Documentが作成された後にのみ適用されます。

    4. 解析されたヘッダー属性からリンクオプションを適用します。attribsを指定してoptionsに適用します。

    5. optionsを基にrelに対してリンクヘッダーを処理する手順を実行する。

    6. optionsをearlyHintsに追加する。

  5. 次のサブステップをDocument docに対して実行します: 各 optionsをearlyHintsに含めます:

    1. もしoptionsのドキュメント準備完了時がnullである場合、optionsのドキュメントをdocに設定します。

    2. そうでない場合、optionsのドキュメント準備完了時を呼び出してdocを渡します。

インタラクティブなユーザーエージェントは、ユーザーにlink要素を使用して作成されたハイパーリンクを辿る手段をユーザーインターフェース内のどこかに提供することができます。このハイパーリンクを辿るアルゴリズムの呼び出しでは、userInvolvement引数を"ブラウザーUI"に設定する必要があります。具体的なインターフェースはこの仕様では定義されていませんが、以下の情報を含むことが考えられます（要素の属性から取得し、以下で定義されているように、いずれかの形式で、可能であれば簡略化された形で）、ドキュメント内の各link要素で作成された各ハイパーリンクについて:

ユーザーエージェントは、リソースの種類（type属性による）など、他の情報も含めることができます。

4.2.5 meta要素

Element/meta

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLMetaElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
メタデータコンテンツ。
itemprop属性が存在する場合：フローコンテンツ。
itemprop属性が存在する場合：フレージングコンテンツ。
この要素が使用されるコンテキスト:
charset属性が存在する場合、または要素のhttp-equiv属性がエンコーディング宣言状態にある場合：head要素内で使用します。
http-equiv属性が存在するが、エンコーディング宣言状態にない場合：head要素内で使用します。
http-equiv属性が存在するが、エンコーディング宣言状態にない場合：noscript要素内で、かつhead要素の子要素として使用します。
name属性が存在する場合：メタデータコンテンツが期待される場所で使用します。
itemprop属性が存在する場合：メタデータコンテンツが期待される場所で使用します。
itemprop属性が存在する場合：フレージングコンテンツが期待される場所で使用します。
コンテンツモデル:
なし。
text/htmlにおけるタグの省略:
終了タグはありません。
コンテンツ属性:
グローバル属性
name — メタデータ名
http-equiv — プラグマ指示
content — 要素の値
charset — 文字エンコーディング宣言
media — 適用メディア
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLMetaElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute DOMString httpEquiv;
   [CEReactions] attribute DOMString content;
   [CEReactions] attribute DOMString media;
 
   // 非推奨メンバーもあります
 };

meta要素は、title、base、link、style、およびscript要素を使用して表現できないさまざまな種類のメタデータを表します。

meta要素は、name属性を使用してドキュメントレベルのメタデータを表すことができ、http-equiv属性を使用してプラグマ指示を表し、HTMLドキュメントが文字列形式にシリアル化される場合（例: ネットワーク経由での送信やディスクに保存する場合）には、charset属性を使用して文字エンコーディング宣言を行います。

正確には、name、http-equiv、charset、およびitemprop属性のうちの1つだけが指定されている必要があります。

name、http-equiv、またはitempropのいずれかが指定されている場合、content属性も指定する必要があります。そうでない場合は、省略する必要があります。

charset属性は、ドキュメントで使用される文字エンコーディングを指定します。これは文字エンコーディング宣言です。この属性が存在する場合、その値は"utf-8"という文字列に対してASCII大文字小文字を区別しない一致でなければなりません。

charset属性は、XMLドキュメントでは効果がありませんが、XMLドキュメント間の移行を容易にするために許可されています。

meta要素には、ドキュメントごとにcharset属性を持つ要素が複数存在してはなりません。

content属性は、要素がこれらの目的で使用される場合に、ドキュメントのメタデータまたはプラグマ指示の値を示します。許可される値は、次のセクションで説明されているように、正確なコンテキストに依存します。

meta要素にname属性がある場合、それはドキュメントメタデータを設定します。ドキュメントメタデータは、名前と値のペアの形式で表現され、name属性が名前を示し、同じ要素のcontent属性が値を示します。名前は、設定されているメタデータの側面を指定します。有効な名前とその値の意味は、次のセクションで説明されています。meta要素にcontent属性がない場合、メタデータの名前と値のペアの値の部分は空文字列になります。

media属性は、メタデータが適用されるメディアを示します。その値は有効なメディアクエリリストでなければなりません。nameがtheme-colorでない限り、media属性は処理モデルには影響せず、著者によって使用されるべきではありません。

name、content、およびmediaIDL属性は、同じ名前の対応するコンテンツ属性を反映する必要があります。IDL属性httpEquivは、コンテンツ属性http-equivを反映する必要があります。

4.2.5.1 標準メタデータ名

Element/meta/name

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

この仕様では、name 属性を持つ meta 要素のためにいくつかの名前が定義されています。

名前は大文字と小文字を区別せず、ASCII 大文字と小文字を区別しない 方法で比較される必要があります。

application-name

値は、そのページが表す Web アプリケーションの名前を示す、短い自由形式の文字列でなければなりません。ページが Web アプリケーションでない場合、application-name メタデータ名を使用してはなりません。Web アプリケーションの名前の翻訳は、lang 属性を使用して各言語を指定することができます。

文書内で、同じ 言語 を持ち、name 属性の値が ASCII 大文字と小文字を区別しない 方式で application-name と一致する meta 要素は、文書ごとに 1 つしか存在してはなりません。

ユーザーエージェントは、UI でページの title よりもアプリケーション名を優先して使用することができます。なぜなら、タイトルには、特定の時点でのページのステータスに関連するステータスメッセージなどが含まれている可能性があるからです。

指定された言語の順序付きリストが与えられた場合（例：イギリス英語、アメリカ英語、英語）、ユーザーエージェントは次の手順を実行する必要があります:

  1. languages を言語のリストとします。

  2. default language を、言語とし、Document の ドキュメント要素の言語に設定します。 その言語が未知でない場合に限ります。

  3. もし default language があり、languages に含まれている言語とは異なる場合、それを languages に追加します。

  4. winning language を、languages の中で最初に、次の条件を満たす meta 要素が存在する言語とします。その name 属性の値が、application-name と ASCII 大文字と小文字を区別しない 方式で一致し、その言語が 言語 と一致するものです。

    もしどの言語にもそのような meta 要素が存在しない場合、リターンします。与えられたアプリケーション名は存在しません。

  5. 最初の meta 要素の content 属性の値を返します。 その要素は Document 内で ツリー順 で最初に見つかるもので、 name 属性の値が ASCII 大文字と小文字を区別しない 方式で一致し、その言語が winning language であるものです。

このアルゴリズムは、例えばブックマークにラベルを付ける際に、ブラウザがページ名を必要とする場合に使用されます。ユーザーがアルゴリズムに提供する言語は、ユーザーの好みの言語となります。

author

値は、ページの著者の名前を示す自由形式の文字列でなければなりません。

description

値はページを説明する自由形式の文字列でなければなりません。この値は、ページのディレクトリ（例：検索エンジン）で使用するのに適している必要があります。 meta 要素が name 属性値と ASCII 大文字小文字の区別なく description と一致する文書ごとに、1つしか存在してはなりません。

generator

値は、文書の生成に使用されたソフトウェアパッケージの1つを識別する自由形式の文字列でなければなりません。この値は、例えば、ユーザーがテキストエディタでマークアップを書いたページのように、ソフトウェアによって生成されていないページには使用してはなりません。

"Frontweaver"というツールが、ページの head 要素内に出力するものを示します。このツールがページの生成に使用されたことを識別するためのものです: 

<meta name=generator content="Frontweaver 8.2">
keywords

値は、ページに関連するキーワードのコンマ区切りトークンのセットでなければなりません。

このページは、イギリスの高速道路の書体に関するものであり、ユーザーがページを検索する際に使用する可能性のあるいくつかのキーワードを指定するために meta 要素を使用しています: 

<!DOCTYPE HTML>
 <html lang="en-GB">
  <head>
   <title>Typefaces on UK motorways</title>
   <meta name="keywords" content="british,type face,font,fonts,highway,highways">
  </head>
  <body>
   ...

多くの検索エンジンは、この機能が歴史的に信頼性に欠け、ユーザーに役立たない方法で検索エンジンの結果をスパムする手段として誤用されてきたため、このようなキーワードを考慮しないことがあります。

ユーザーエージェントが、ページに適用可能なキーワードのリストを取得するには、次の手順を実行する必要があります:

  1. keywords を空のリストにします。

  2. meta 要素のそれぞれに対して、name 属性と content 属性を持ち、name 属性の値が ASCII 大文字小文字の区別なく keywords と一致する場合:

    1. 要素の content 属性の値をコンマで分割します。

    2. 結果のトークンがあれば、それを keywords に追加します。

  3. keywords から重複を削除します。

  4. keywords を返します。これは、ページに適用可能として著者が指定したキーワードのリストです。

ユーザーエージェントは、値の信頼性に対する十分な確信がない場合、この情報を使用すべきではありません。

例えば、コンテンツ管理システムが、システム内のページのキーワード情報を使用して、サイト固有の検索エンジンのインデックスを作成するのは合理的ですが、大規模なコンテンツアグリゲーターがこの情報を使用すると、一部のユーザーが不適切なキーワードを使用してランキングメカニズムを操作しようとする可能性が高くなります。

referrer

この値は、文書 のデフォルトの リファラーポリシー を定義する リファラーポリシー でなければなりません。 [REFERRERPOLICY]

任意の meta 要素 element が 文書に 挿入された 場合、 またはその name または content 属性が変更された場合、ユーザーエージェントは次のアルゴリズムを実行する必要があります:

  1. element が 文書ツリー内 にない場合、戻ります。

  2. element に、値が "referrer" と ASCII 大文字小文字を区別しない 一致する name 属性がない場合、戻ります。

  3. element に content 属性がない場合、 またはその属性の値が空の文字列である場合、戻ります。

  4. value を element の content 属性の値とし、 ASCII 小文字 に変換します。

  5. 以下の表の最初の列にある値のいずれかで value がある場合、 value を2列目に示す値に設定します:

    レガシー値 リファラーポリシー
    never no-referrer
    default デフォルトのリファラーポリシー
    always unsafe-url
    origin-when-crossorigin origin-when-cross-origin

  6. value が リファラーポリシー の1つである場合、 element の ノード文書 の ポリシーコンテナ の リファラーポリシー を policy に設定します。

歴史的な理由から、他の標準メタデータ名とは異なり、referrer の処理モデルは、要素の削除に応答せず、ツリー順 を使用しません。この状態の中で最も最近挿入された、または最も最近変更された meta 要素のみが影響を与えます。

theme-color

Element/meta/name/theme-color

FirefoxいいえSafari15+Chrome🔰 73+
OperaいいえEdge🔰 79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android80+WebView AndroidいいえSamsung Internet6.2+Opera Androidいいえ

この値は、CSS の <color> プロダクションと一致する文字列でなければならず、 ユーザーエージェントがページまたは周辺のユーザーインターフェイスの表示をカスタマイズするために使用する推奨される色を定義します。たとえば、ブラウザーは、指定された値を使用してページのタイトルバーをカラー表示したり、タブバーやタスクスイッチャーでハイライトとして使用することがあります。

HTML ドキュメント内では、media 属性の値は、meta 要素のすべての中で一意でなければなりません。また、name 属性の値は、theme-color と ASCII 大文字小文字を区別しない 一致でなければなりません。

この標準自体は、「WHATWG グリーン」をテーマカラーとして使用しています:

<!DOCTYPE HTML>
 <title>HTML Standard</title>
 <meta name="theme-color" content="#3c790a">
 ...

media 属性は、提供された色が使用されるべきコンテキストを説明するために使用される場合があります。

この標準のテーマカラーとして「WHATWG グリーン」をダークモードでのみ使用したい場合は、prefers-color-scheme メディア機能を使用できます:

<!DOCTYPE HTML>
 <title>HTML Standard</title>
 <meta name="theme-color" content="#3c790a" media="(prefers-color-scheme: dark)">
 ...

ページのテーマカラーを取得するには、ユーザーエージェントは次の手順を実行する必要があります:

  1. candidate elements を、以下の基準を満たすすべての meta 要素のリストとします。 順序は ツリー順 です。

  2. candidate elements の各 element について:

    1. element が media 属性を持っており、element の media 属性の値が 環境に一致しない 場合は 続行 します。

    2. element の content 属性の値から、前後の ASCII 文字の空白を取り除いた 結果を value とします。

    3. value を 解析 し、その結果を color とします。

    4. color が失敗でない場合、その color を返します。

  3. 何も返しません（ページにテーマカラーがない場合）。

任意の meta 要素が 文書に挿入される または 文書から削除される 場合、 または既存の meta 要素の name、 content、 または media 属性が変更される、または環境が変化して、いずれかの meta 要素の media 属性の値が環境と一致するか、 一致しなくなる場合は、ユーザーエージェントは上記のアルゴリズムを再実行し、その結果を影響を受ける UI に適用する必要があります。

UI でテーマカラーを使用する際、ユーザーエージェントは、該当する UI に適した形でテーマカラーを調整することがあります。たとえば、ユーザーエージェントがテーマカラーを背景色として使用し、その上に白いテキストを表示することを意図している場合、十分なコントラストを確保するために、その部分の UI でテーマカラーのより暗いバージョンを使用することがあります。

color-scheme

ユーザーエージェントがページの背景をすぐに希望する配色でレンダリングできるようにするため（ページ内のすべての CSS の読み込みを待つのではなく）、meta 要素で 'color-scheme' 値を指定できます。

この値は、CSS の 'color-scheme' プロパティの値の構文に一致する文字列でなければなりません。 これにより、ページがサポートする配色 が決定されます。

ドキュメント内では、meta 要素に name 属性値が ASCII 大文字小文字を区別しない 一致で color-scheme に 設定された要素が 1 つ以上あってはなりません。

次の宣言は、ページが暗い背景色と明るい前景色を含む配色に対応していることを示しています:

<meta name="color-scheme" content="dark">

ページがサポートする配色を取得するには、ユーザーエージェントは次の手順を実行する必要があります:

  1. candidate elements を、以下の基準を満たすすべての meta 要素のリストとします。 順序は ツリー順 です。

  2. candidate elements の各 element について:

    1. element の content 属性の値を与えて、コンポーネント値のリストを解析する結果を parsed とします。
    2. parsed が有効な CSS 'color-scheme' プロパティ値である場合、 parsed を返します。

  3. null を返します。

任意の meta 要素が 文書に挿入される または 文書から削除される 場合、 または既存の meta 要素の name または content 属性が変更された場合、ユーザーエージェントは上記のアルゴリズムを再実行する必要があります。

これらのルールは一致する要素が見つかるまで次々に要素を確認するため、著者はレガシーユーザーエージェントのフォールバックに対応する複数の値を提供できます。 プロパティに対する CSS のフォールバックの仕組みとは逆に、複数の meta 要素は、レガシー値が新しい値の後に配置される必要があります。

4.2.5.2 その他のメタデータ名

誰でも独自のメタデータ名の事前定義セットに対する拡張を作成して使用することができます。このような拡張を登録する必要はありません。

ただし、次のいずれかの場合には、新しいメタデータ名を作成すべきではありません:

また、新しいメタデータ名を作成して使用する前に、WHATWG Wiki MetaExtensions ページを参照することが推奨されます。 これは、既に使用されているメタデータ名を選択するのを避け、既に使用されているメタデータ名の目的を重複させることを避け、新しい標準化された名前が 選択した名前と衝突するのを避けるためです。[WHATWGWIKI]

誰でもいつでも WHATWG Wiki MetaExtensions ページを編集してメタデータ名を追加することができます。 新しいメタデータ名は、次の情報で指定することができます:

キーワード

実際に定義される名前です。この名前は、他の定義済みの名前と混同されないようにする必要があります（例: 大文字小文字のみが異なる場合など）。

簡潔な説明

メタデータ名の意味とその値が要求される形式についての簡潔で非標準的な説明です。

仕様
メタデータ名の意味と要件に関する詳細な説明へのリンクです。それは、ウィキの別のページ、または外部ページへのリンクである可能性があります。
同義語

まったく同じ処理要件を持つ他の名前のリストです。著者は、定義された同義語の名前を使用すべきではありません（これはレガシーコンテンツのサポートのためにのみ意図されています）。 誰でも、実際には使用されていない同義語を削除することができます。レガシーコンテンツとの互換性のために同義語として処理する必要がある名前のみがこの方法で登録されます。

ステータス

次のいずれかです:

提案
その名前は広範なピアレビューと承認を受けていません。誰かがそれを提案し、使用中または使用予定です。
批准
その名前は広範なピアレビューと承認を受けています。名前を使用するページの処理方法を明確に定義する仕様があります。 誤って使用された場合の対処方法も含まれます。
中止
そのメタデータ名は広範なピアレビューを受けており、不適切と判断されました。 既存のページはこのメタデータ名を使用していますが、新しいページではそれを避けるべきです。 「簡潔な説明」と「仕様」のエントリに、著者が代わりに使用すべきものがあれば、その詳細が記載されています。

メタデータ名が既存の値と重複していると判明した場合、それは削除され、既存の値の同義語としてリストされるべきです。

メタデータ名が「提案」状態で1か月以上使用されずに追加された場合、または仕様されていない場合、それは WHATWG Wiki MetaExtensions ページから削除される可能性があります。

メタデータ名が「提案」状態で追加され、既存の値と重複していると判明した場合、それは削除され、既存の値の同義語としてリストされるべきです。 メタデータ名が「提案」状態で追加され、害があると判明した場合、それは「中止」状態に変更されるべきです。

誰でもいつでもステータスを変更できますが、上記の定義に従ってのみ行うべきです。

4.2.5.3 プラグマ指令

http-equiv属性が meta要素に指定されている場合、 その要素はプラグマ指令となります。

http-equiv属性は、 以下のキーワードと状態を持つ列挙型属性です:

キーワード 適合性 状態 簡潔な説明
content-language No Content language プラグマセットのデフォルト言語を設定します。
content-type エンコーディング宣言 charsetを設定する代替形式です。
default-style デフォルトスタイル デフォルトのCSSスタイルシートセットの 名前を設定します。
refresh リフレッシュ タイマー付きのリダイレクトとして動作します。
set-cookie No Set-Cookie 効果はありません。
x-ua-compatible X-UA-Compatible 実際には、Internet Explorerが仕様により近づくよう促します。
content-security-policy コンテンツセキュリティポリシー コンテンツセキュリティポリシーを Documentに適用します。

meta要素が ドキュメントに挿入 される際に、そのhttp-equiv属性が 存在し、上記のいずれかの状態を表す場合、ユーザーエージェントは以下のリストに記載されているその状態に適したアルゴリズムを実行する必要があります。

コンテンツ言語の状態 (http-equiv="content-language")

この機能は適合していません。著者は代わりにlang属性を使用することが推奨されます。

このプラグマはプラグマセットのデフォルト言語を設定します。 このようなプラグマが正常に処理されるまでは、 プラグマセットのデフォルト言語 は存在しません。

  1. meta要素に content 属性がない場合、処理を終了します。

  2. 要素のcontent 属性に U+002C COMMA 文字（,）が含まれている場合、処理を終了します。

  3. inputを、要素のcontent 属性の値に設定します。

  4. positionをinputの最初の文字を指すように設定します。

  5. ASCIIホワイトスペースをスキップします。

  6. コードポイントのシーケンスを収集し、 それらがASCIIホワイトスペースでないことを確認します。

  7. candidateを前のステップで得られた文字列に設定します。

  8. candidateが空の文字列の場合、処理を終了します。

  9. プラグマセットのデフォルト言語 をcandidateに設定します。

    値が複数のスペース区切りトークンで構成されている場合、最初のトークン以外は無視されます。

このプラグマは、同じ名前を持つHTTP `Content-Language` ヘッダーとはほとんど似ていません。 [HTTP]

エンコーディング宣言の状態 (http-equiv="content-type")

エンコーディング宣言の状態 は、charset 属性を設定する代替形式に過ぎません。これは 文字エンコーディング宣言 です。この状態のユーザーエージェント要件はすべて、仕様のパーセクションによって処理されます。

meta要素に http-equiv 属性があり、その属性がエンコーディング宣言の状態である場合、 content属性の 値は次の文字列とASCII大小区別しない一致を持たなければなりません: "text/html;"。 オプションで、任意の数のASCIIホワイトスペースが続き、その後に "charset=utf-8"が続きます。

ドキュメントには、meta 要素に http-equiv 属性があり、その属性がエンコーディング宣言の状態であるものと、 charset 属性を持つ要素の両方を含めることはできません。

エンコーディング宣言の状態は HTMLドキュメントで使用できますが、その状態の http-equiv 属性を持つ要素は XMLドキュメントでは使用できません。

デフォルトスタイルの状態 (http-equiv="default-style")

Alternative_style_sheets

Support in one engine only.

Firefox3+Safari?Chrome1–48
OperaYesEdgeNo
Edge (Legacy)?Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

このプラグマは、デフォルトのCSSスタイルシートセットの名前を 設定します。

  1. meta要素に content 属性がない場合、またはその属性の値が空の文字列である場合、処理を終了します。

  2. 優先CSSスタイルシートセット名を変更し、その名前を 要素のcontent 属性の値に設定します。 [CSSOM]

リフレッシュ状態 (http-equiv="refresh")

このプラグマはタイマー付きリダイレクトとして機能します。

Documentオブジェクトには、 その関連付けられた宣言的リフレッシュを行う （ブール値）があり、最初は false です。

  1. meta要素に content 属性がない場合、またはその属性の値が空の文字列である場合、処理を終了します。

  2. inputを要素のcontent 属性の値に設定します。

  3. 共通の宣言的リフレッシュ手順 を、meta 要素のノードドキュメント、 input、およびmeta要素を使って実行します。

共通の宣言的リフレッシュ手順は、Documentオブジェクト document、文字列input、およびオプションでmeta要素 metaを使用して以下のように行われます:

  1. もしdocumentの宣言的リフレッシュを行うが true である場合、処理を終了します。

  2. positionをinputの最初のコードポイントを指すように設定します。

  3. ASCIIホワイトスペースをスキップします。

  4. timeを0に設定します。

  5. コードポイントのシーケンスを収集し、 それらがASCII数字であることを確認します。 inputから収集されたものをtimeStringと呼びます。

  6. もしtimeStringが空の文字列である場合、次のステップを実行します:

    1. もしpositionが指すinputのコードポイントがU+002E (.)でない場合、処理を終了します。

  7. そうでない場合、timeをtimeStringの解析結果に設定します。 非負整数の解析ルール を使用します。

  8. コードポイントのシーケンスを収集し、 それらがASCII数字およびU+002E (.) 文字であることを確認します。 収集された文字は無視します。

  9. urlRecordをdocumentのURLに設定します。

  10. もしpositionがinputの末尾を超えていない場合、次のステップを実行します:

    1. もしpositionが指すinputのコードポイントがU+003B (;)、U+002C (,)、 またはASCIIホワイトスペースでない場合、処理を終了します。

    2. ASCIIホワイトスペースをスキップします。

    3. もしpositionが指すinputのコードポイントがU+003B (;)またはU+002C (,)である場合、 positionを次のコードポイントに進めます。

    4. ASCIIホワイトスペースをスキップします。

  11. もしpositionがinputの末尾を超えていない場合、次のステップを実行します:

    1. urlStringをinputのpositionから末尾までの部分文字列に設定します。

    2. もしpositionが指すコードポイントがU+0055 (U)またはU+0075 (u)である場合、 positionを次のコードポイントに進めます。そうでない場合は、 skip quotesとラベル付けされたステップに進みます。

    3. もしpositionが指すコードポイントがU+0052 (R)またはU+0072 (r)である場合、 positionを次のコードポイントに進めます。そうでない場合は、 parseとラベル付けされたステップに進みます。

    4. もしpositionが指すコードポイントがU+004C (L)またはU+006C (l)である場合、 positionを次のコードポイントに進めます。そうでない場合は、 parseとラベル付けされたステップに進みます。

    5. ASCIIホワイトスペースをスキップします。

    6. もしpositionが指すコードポイントがU+003D (=)である場合、 positionを次のコードポイントに進めます。 そうでない場合は、parseとラベル付けされたステップに進みます。

    7. ASCIIホワイトスペースをスキップします。

    8. skip quotes: もしpositionが指すコードポイントがU+0027 (')またはU+0022 (")である場合、 quoteをそのコードポイントに設定し、positionを次の コードポイントに進めます。そうでない場合は、 quoteを空の文字列に設定します。

    9. urlStringをinputのpositionから末尾までの部分文字列に設定します。

    10. もしquoteが空の文字列でなく、urlString内にquoteと等しい コードポイントがある場合、 urlStringをその位置で切り詰めます。

    11. parse: urlRecordをdocumentに相対的な urlStringのURLのエンコーディング解析 の結果に設定します。

    12. もしurlRecordが失敗した場合、処理を終了します。

  12. documentの宣言的リフレッシュを行うを true に設定します。

  13. 次のいずれかまたは複数のステップを実行します:

    さらに、ユーザーエージェントは、タイマーの状態、タイマー付きリダイレクトの目的地など、 その操作のすべての側面について、ユーザーに通知することができます。

meta要素に http-equiv 属性があり、その属性がリフレッシュ状態である場合、content 属性の値は次のいずれかでなければなりません:

前者の場合、整数はページがリロードされるまでの秒数を表し、後者の場合、整数はページが指定されたURLで置き換えられるまでの秒数を表します。

ニュース組織のフロントページは、次のようなマークアップをページのhead要素に含めることで、 ページが5分ごとにサーバーから自動的にリロードされることを保証できます: 

<meta http-equiv="Refresh" content="300">

ページの連続したスライドショーとして自動化するために、各ページを次のページにリフレッシュするために、 次のようなマークアップを使用することができます:

<meta http-equiv="Refresh" content="20; URL=page4.html">
Set-Cookie状態 (http-equiv="set-cookie")

このプラグマは適合しておらず、効果はありません。

ユーザーエージェントはこのプラグマを無視する必要があります。

X-UA-Compatible状態 (http-equiv="x-ua-compatible")

実際には、このプラグマはInternet Explorerが仕様により近づくよう促します。

meta要素に http-equiv 属性があり、その属性がX-UA-Compatible状態である場合、 content属性の 値は、"IE=edge"という文字列とASCII大小区別しない一致を持たなければなりません。

ユーザーエージェントはこのプラグマを無視する必要があります。

コンテンツセキュリティポリシー状態 (http-equiv="content-security-policy")

このプラグマはポリシーを適用し、 コンテンツセキュリティポリシーを Documentに適用します。 [CSP]

  1. meta要素が head要素の子でない場合、処理を終了します。

  2. meta要素に content 属性がない場合、またはその属性の値が空の文字列である場合、処理を終了します。

  3. policyを、コンテンツセキュリティポリシーのシリアライズされたコンテンツセキュリティポリシーの解析アルゴリズムの実行結果に設定します。 解析はmeta 要素の content属性の値を使用し、 ソースを"meta"、ディスポジションを"enforce"とします。

  4. policyから、report-uri、 frame-ancestors、 およびsandbox 指令をすべて削除します。

  5. ポリシーを適用します。

meta要素に http-equiv 属性があり、その属性がコンテンツセキュリティポリシー状態である場合、 content属性の 値は、 有効なコンテンツセキュリティポリシーでなければなりませんが、 その中にはreport-uri、 frame-ancestors、 またはsandbox 指令を含めることはできません。 content属性に与えられた コンテンツセキュリティポリシーは現在のドキュメントに 適用されます。[CSP]

ドキュメントにmeta要素が 挿入される時点で、一部のリソースがすでに取得されている可能性があります。例えば、画像は、 meta要素に http-equiv 属性があり、その属性がコンテンツセキュリティポリシー状態 である場合に、 利用可能な画像のリスト に動的に挿入される前に保存されている可能性があります。すでに取得されたリソースが、後から コンテンツセキュリティポリシーによってブロックされる保証はありません。 後から適用される場合です。

ページがクロスサイトスクリプティング攻撃のリスクを軽減するために、インラインJavaScriptの実行を防止し、 すべてのプラグインコンテンツをブロックするポリシーを選択する場合、次のようなポリシーを使用できます: 

<meta http-equiv="Content-Security-Policy" content="script-src 'self'; object-src 'none'">

ドキュメントに同じ状態を持つmeta要素が 同時に複数存在してはなりません。

4.2.5.4 文書の文字エンコーディングの指定

文字エンコーディング宣言は、文書を保存または送信する際に使用される文字エンコーディングを指定するメカニズムです。

Encoding標準では、UTF-8 文字エンコーディングの使用を要求し、これを識別するために"utf-8" エンコーディングラベルを使用することを求めています。これらの要件により、文書の文字エンコーディング宣言が存在する場合、エンコーディングラベルが"utf-8"に対してASCII大文字小文字を区別しない一致で指定されることが必要です。文字エンコーディング宣言が存在するかどうかにかかわらず、文書のエンコードに使用される実際の文字エンコーディングはUTF-8でなければなりません。[ENCODING]

上記の規則を強制するために、オーサリングツールは新しく作成された文書に対してUTF-8をデフォルトとして使用しなければなりません。

次の制限も適用されます：

さらに、meta要素に関するいくつかの制限により、文書ごとにmetaベースの文字エンコーディング宣言は1つしか存在できません。

もしHTML文書がBOMで始まらず、そのエンコーディングがContent-Typeメタデータによって明示的に指定されておらず、文書がiframeのsrcdoc文書でない場合、エンコーディングはmeta要素とcharset属性、またはmeta要素とhttp-equiv属性を使用して指定する必要があります。これらの要素はエンコーディング宣言状態で使用される必要があります。

文字エンコーディング宣言は、すべての文字がASCII範囲内であっても必要です。なぜなら、フォーム内でユーザーによって入力された非ASCII文字やスクリプトによって生成されたURLなどを処理するために文字エンコーディングが必要だからです。

非UTF-8エンコーディングを使用すると、フォームの送信やURLエンコーディングに予期しない結果をもたらす可能性があります。デフォルトでは、これらは文書の文字エンコーディングを使用します。

文書がiframeのsrcdocドキュメントである場合、その文書には文字エンコーディング宣言を含めてはいけません。（この場合、ソースは既にデコードされています。なぜなら、それはiframeを含む文書の一部であるからです。）

XMLでは、必要に応じて、インライン文字エンコーディング情報にXML宣言を使用する必要があります。

HTMLでは、文字エンコーディングがUTF-8であることを宣言するために、作成者は次のマークアップを文書の上部（head要素内）に含めることができます：

<meta charset="utf-8">

XMLでは、代わりに文書の最上部にXML宣言を使用します：

<?xml version="1.0" encoding="utf-8"?>

4.2.6 style要素

Element/style

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3.5+Edge79+
Edge (Legacy)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

HTMLStyleElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリー:
メタデータコンテンツ。
この要素が使用されるコンテキスト:
メタデータコンテンツが予想される場所。
noscript 要素内で head 要素の子要素として使用されます。
コンテンツモデル:
テキストは、準拠したスタイルシートを与えます。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
media — 適用されるメディア
blocking — この要素が潜在的にレンダーブロックする可能性があるかどうか
さらに、この要素には title 属性が特別な意味を持ちます： CSSスタイルシートセット名
アクセシビリティに関する考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
[Exposed=Window]
interface HTMLStyleElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   attribute boolean disabled;
   [CEReactions] attribute DOMString media;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList blocking;
 
   // 廃止されたメンバーも含む
};
HTMLStyleElement includes LinkStyle;

style要素は、作成者がドキュメントにCSSスタイルシートを埋め込むことを可能にします。style要素は、スタイル処理モデルの複数の入力の一つです。この要素は、ユーザーのためのコンテンツを表現するものではありません。

HTMLStyleElement/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)13+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

disabledのゲッターステップは次の通りです：

  1. この要素に関連するCSSスタイルシートがない場合、falseを返します。

  2. この要素の関連するCSSスタイルシートのdisabledフラグが設定されている場合、trueを返します。

  3. falseを返します。

disabledのセッターステップは次の通りです：

  1. この要素に関連するCSSスタイルシートがない場合、処理を終了します。

  2. 与えられた値がtrueである場合、この要素の関連するCSSスタイルシートのdisabledフラグを設定します。そうでない場合は、この要素の関連するCSSスタイルシートのdisabledフラグを解除します。

重要なのは、disabled属性の割り当ては、style要素に関連するCSSスタイルシートがある場合にのみ効果を発揮します：

const style = document.createElement('style');
style.disabled = true;
style.textContent = 'body { background-color: red; }';
document.body.append(style);
console.log(style.disabled); // false

media属性は、スタイルが適用されるメディアを指定します。値は有効なメディアクエリリストでなければなりません。ユーザーエージェントは、media属性の値が環境に一致する場合、またその他の関連条件が適用される場合にスタイルを適用し、それ以外の場合は適用しないようにする必要があります。

スタイルは、たとえばCSSの@mediaブロックの使用などで、さらに範囲が制限される場合があります。この仕様は、そうした追加の制限や要件を上書きするものではありません。

属性が省略された場合のデフォルトは「all」、つまりデフォルトでスタイルがすべてのメディアに適用されることを意味します。

blocking属性は、ブロッキング属性です。

Alternative_style_sheets

1つのエンジンのみでサポートされています。

Firefox3+Safari?Chrome1–48
OperaYesEdgeNo
Edge (Legacy)?Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

title属性は、style要素でCSSスタイルシートセットを定義します。style要素にtitle属性がない場合、その要素にはタイトルがありません。祖先のtitle属性は、style要素には適用されません。style要素がドキュメントツリー内にない場合、title属性は無視されます。[CSSOM]

style要素のtitle属性は、link要素のtitle属性と同様に、グローバルなtitle属性とは異なります。つまり、タイトルのないstyleブロックは親要素のタイトルを継承せず、単にタイトルを持たないということです。

style要素の子テキストコンテンツは、準拠したスタイルシートでなければなりません。

もしstyle要素がそのノード文書のパーサーによって作成された場合、その要素は暗黙的にレンダーブロックの可能性があると見なされます。

次のいずれかの条件が発生した場合、ユーザーエージェントはスタイルstyleブロックを更新するアルゴリズムを実行する必要があります:

スタイルstyleブロックを更新するアルゴリズムは次の通りです:

  1. elementをstyle要素とする。

  2. elementが関連付けられたCSSスタイルシートを持っている場合、該当するCSSスタイルシートを削除する。

  3. elementが接続されていない場合は、処理を終了する。

  4. elementのtype属性が存在し、その値が空文字列でもなく、"text/css"とASCII大文字小文字区別なく一致するわけでもない場合は、処理を終了する。

    特に、"text/css; charset=utf-8"のようなパラメーターを持つtype値は、このアルゴリズムが早期に終了する原因となります。

  5. Content Security Policyによってインライン動作がブロックされるべきかどうかのアルゴリズムが、style要素、"style"、およびstyle要素の子テキストコンテンツに対して実行された際に"Blocked"を返す場合、処理を終了する。[CSP]

  6. 次のプロパティを持つCSSスタイルシートを作成する:

    type

    text/css

    所有者ノード

    element

    メディア

    elementのmedia属性。

    これは、現在存在しないかもしれない属性への参照であり、属性の現在の値のコピーではありません。CSSOMは、属性が動的に設定、変更、または削除されたときに何が起こるかを定義しています。

    タイトル

    elementがドキュメントツリー内にある場合はtitle属性、それ以外の場合は空文字列。

    これもまた、属性への参照です。

    代替フラグ

    未設定。

    オリジンクリーンフラグ

    設定済み。

    位置
    親CSSスタイルシート
    所有者CSSルール

    null

    disabledフラグ

    デフォルト値のまま。

    CSSルール

    初期化されていないまま。

    これは正しくないようです。おそらく要素の子テキストコンテンツを使用する必要があるでしょうか？問題#2997として追跡されています。

  7. もしelementがスクリプトブロックスタイルシートに貢献する場合、elementをそのノードドキュメントのスクリプトブロックスタイルシートセットに追加する。

  8. もしelementのmedia属性の値が環境に一致する場合、そしてelementが潜在的にレンダーブロックする場合、elementでのレンダリングをブロックする。

スタイルシートのクリティカルサブリソースを取得する試みが完了したとき、または、スタイルシートがクリティカルサブリソースを持たない場合、スタイルシートがパースおよび処理された後、ユーザーエージェントは次の手順を実行する必要があります:

クリティカルサブリソースの取得は明確に定義されていません; おそらく問題#968が最良の解決策でしょう。その間、クリティカルサブリソースリクエストは、style要素が現在レンダーブロックしているかどうかに応じてレンダーブロック設定を行うべきです。

  1. elementをスタイルシートに関連付けられたstyle要素とする。

  2. successをtrueとする。

  3. 何らかの理由（例：DNSエラー、HTTP 404レスポンス、接続の早期終了、サポートされていないコンテンツタイプ）でスタイルシートのクリティカルサブリソースの取得が失敗した場合、successをfalseに設定する。

    コンテンツ固有のエラー、例：CSSパースエラーやPNGデコードエラーはsuccessに影響しません。

  4. elementと次のステップを基に要素タスクをキューに入れる:

    1. successがtrueの場合、elementでloadという名前のイベントを発火する。

    2. それ以外の場合、elementでerrorという名前のイベントを発火する。

    3. もしelementがスクリプトブロックスタイルシートに貢献している場合:

      1. 断言: elementのノードドキュメントのスクリプトブロックスタイルシートセットがelementを含んでいること。

      2. elementをノードドキュメントのスクリプトブロックスタイルシートセットから削除する。

    4. elementでレンダリングを解除する。

要素のロードイベントを遅延させる必要があります。要素のノードドキュメントがスタイルシートのクリティカルサブリソースをすべて取得する試みが完了するまで。

この仕様はスタイルシステムを指定していませんが、CSSはほとんどのウェブブラウザでサポートされることが予想されます。[CSS]

HTMLStyleElement/media

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

mediaおよびblockingIDL属性は、それぞれ同名のコンテンツ属性を反映する必要があります。

LinkStyleインターフェイスは、この要素でも実装されています。[CSSOM]

以下の文書では、強調表現がイタリック体の代わりに鮮やかな赤色のテキストでスタイルされ、作品のタイトルやラテン語の単語はデフォルトのイタリック体のままです。適切な要素を使用することで、ドキュメントの再スタイリングが容易になることが示されています。 

<!DOCTYPE html>
<html lang="en-US">
  <head>
   <title>My favorite book</title>
   <style>
    body { color: black; background: white; }
    em { font-style: normal; color: red; }
   </style>
  </head>
  <body>
   <p>My <em>favorite</em> book of all time has <em>got</em> to be
   <cite>A Cat's Life</cite>. It is a book by P. Rahmel that talks
   about the <i lang="la">Felis catus</i> in modern human society.</p>
  </body>
</html>

4.2.7 スタイリングとスクリプティングの相互作用

スタイルシートが他のリソースを参照していない場合（例：style要素で指定された内部スタイルシートで@importルールがない場合）、スタイルルールは即座にスクリプトに対して利用可能にする必要があります。それ以外の場合は、スタイルルールはイベントループがレンダリングを更新する段階に達した時点でのみスクリプトに対して利用可能にする必要があります。

DocumentのコンテキストでHTMLパーサーまたはXMLパーサーにおいて、次のすべての条件が真である場合、要素elはスクリプトをブロックするスタイルシートを提供するとされます:

上記の規則の対応部分が<?xml-stylesheet?>PIにも適用されることが期待されています。ただし、これはまだ十分に調査されていません。

Documentには、最初は空の順序付きセットであるスクリプトをブロックするスタイルシートセットが含まれます。

Documentdocumentは、次の手順で真が返される場合、スクリプトをブロックするスタイルシートを持つとされます:

  1. もしdocumentのスクリプトをブロックするスタイルシートセットが空でない場合は、真を返す。

  2. もしdocumentのノードナビゲーブルがnullである場合は、偽を返す。

  3. containerDocumentをdocumentのノードナビゲーブルのコンテナドキュメントとする。

  4. もしcontainerDocumentがnullでなく、かつcontainerDocumentのスクリプトをブロックするスタイルシートセットが空でない場合は、真を返す。

  5. 偽を返す。

Documentは、スクリプトをブロックするスタイルシートを持たない場合にスクリプトをブロックするスタイルシートを持たないとされます。

4.3 セクション

Introduction_to_HTML/Document_and_website_structure#HTML_for_structuring_content

すべての現在のエンジンでサポートされています。

Firefox4+ Safari5+ Chrome5+
Opera11.1+ Edge79+
Edge (レガシー)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11.1+

4.3.1 body要素

Element/body

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLBodyElement

すべての現在のエンジンでサポートされています。

Firefox1+ Safari3+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS1+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+
カテゴリ:
なし。
この要素が使用できるコンテキスト:
html要素の2番目の要素として。
コンテンツモデル:
フローコンテンツ。
text/htmlにおけるタグの省略:
body要素の開始タグは、要素が空であるか、body要素内の最初のものがASCIIホワイトスペースまたはコメントでない場合に省略できます。ただし、body要素内の最初のものがmeta、noscript、link、script、style、またはtemplate要素である場合を除きます。
body要素の終了タグは、body要素の直後にコメントがない場合に省略できます。
コンテンツ属性:
グローバル属性
onafterprint
onbeforeprint
onbeforeunload
onhashchange
onlanguagechange
onmessage
onmessageerror
onoffline
ononline
onpageswap
onpagehide
onpagereveal
onpageshow
onpopstate
onrejectionhandled
onstorage
onunhandledrejection
onunload
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェース:
[Exposed=Window]
 interface HTMLBodyElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // 過去のメンバーも含む
 };
 
 HTMLBodyElement includes WindowEventHandlers;

body要素は文書の内容を表します。

適合する文書には、body要素が1つだけ存在します。document.bodyIDL属性は、スクリプトが文書のbody要素に簡単にアクセスできるようにします。

一部のDOM操作（例えば、ドラッグアンドドロップモデルの一部）は、"body要素"の用語で定義されています。これは、DOM内の特定の要素を指しており、任意のbody要素ではありません。

body要素は、イベントハンドラーコンテンツ属性として、イベントハンドラーの一部を公開します。また、それらのイベントハンドラーIDL属性をミラーリングします。

Windowオブジェクトのイベントハンドラーは、Window-reflecting body要素イベントハンドラーセットによって命名され、body要素上で公開され、通常HTML要素でサポートされる同じ名前の汎用イベントハンドラーを置き換えます。

したがって、例えば、errorイベントがDocumentのbody要素の子で発生し、バブリングされた場合、そのイベントはまずその要素のonerrorのイベントハンドラーコンテンツ属性をトリガーし、その後にルートhtml要素のそれをトリガーし、その後、onerrorのイベントハンドラーコンテンツ属性をトリガーします。これは、イベントがターゲットから、body、html、Document、Windowにバブリングされ、イベントハンドラーがWindowを監視していて、bodyを監視していないためです。しかし、addEventListener()を使用してbodyにアタッチされた通常のイベントリスナーは、イベントがWindowオブジェクトに到達したときではなく、bodyを通過したときに実行されます。

このページでは、ユーザーがオンラインかオフラインかを示すインジケーターを更新します:

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>オンラインかオフラインか？</title>
   <script>
    function update(online) {
      document.getElementById('status').textContent =
        online ? 'オンライン' : 'オフライン';
    }
   </script>
  </head>
  <body ononline="update(true)"
        onoffline="update(false)"
        onload="update(navigator.onLine)">
   <p>You are: <span id="status">(不明)</span></p>
  </body>
 </html>

4.3.2 article 要素

Element/article

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ.
セクショニングコンテンツ.
明示的コンテンツ.
この要素を使用できるコンテキスト:
セクショニングコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ.
text/html でのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOM インターフェース:
HTMLElement を使用します。

article 要素は、ドキュメント、ページ、アプリケーション、またはサイト内で独立して配布可能または再利用可能な、完全または自己完結型のコンテンツを表します。これは、たとえばフォーラム投稿、雑誌や新聞の記事、ブログ記事、ユーザーが投稿したコメント、インタラクティブなウィジェットやガジェット、または他の独立したコンテンツ項目である可能性があります。

article 要素が入れ子になっている場合、内側の article 要素は、外側の article の内容に原則として関連する記事を表します。たとえば、ユーザーが投稿したコメントを受け入れるサイトのブログ記事は、ブログ記事のために article 要素内に入れ子になっている要素として、コメントを article 要素として表すことができます。

article 要素に関連する著者情報（address 要素を参照）は、入れ子になった article 要素には適用されません。

特にシンジケーションで再配布されるコンテンツで使用される場合、article 要素は、Atom の entry 要素に似た目的を持ちます。[ATOM]

schema.org マイクロデータ語彙は、CreativeWork のサブタイプの1つを使用して、article 要素の発行日を提供するために使用できます。

ページの主な内容（フッター、ヘッダー、ナビゲーションブロック、サイドバーを除く）がすべて1つの自己完結型の構成である場合、その内容は article でマークされる場合がありますが、その場合は技術的には冗長です（ページが単一の構成であることは自明であり、それは単一のドキュメントであるためです）。

この例では、article 要素を使用してブログ記事を表示し、いくつかの schema.org 注釈を含んでいます:

<article itemscope itemtype="http://schema.org/BlogPosting">
  <header>
   <h2 itemprop="headline">人生で最も重要なルール</h2>
   <p><time itemprop="datePublished" datetime="2009-10-09">3日前</time></p>
   <link itemprop="url" href="?comments=0">
  </header>
  <p>マイクが近くにある場合、何を言っているかが全世界に送信されていると考えてください。真剣に。</p>
  </p>...</p>
  <footer>
   <a itemprop="discussionUrl" href="?comments=1">コメントを見る...</a>
  </footer>
 </article>

こちらは同じブログ投稿ですが、いくつかのコメントを表示しています:

<article itemscope itemtype="http://schema.org/BlogPosting">
  <header>
   <h2 itemprop="headline">人生で最も重要なルール</h2>
   <p><time itemprop="datePublished" datetime="2009-10-09">3日前</time></p>
   <link itemprop="url" href="?comments=0">
  </header>
  <p>マイクが近くにある場合、何を言っているかが全世界に送信されていると考えてください。真剣に。</p>
  </p>...</p>
  <section>
   <h1>コメント</h1>
   <article itemprop="comment" itemscope itemtype="http://schema.org/Comment" id="c1">
    <link itemprop="url" href="#c1">
    </footer>
     <p>投稿者: <span itemprop="creator" itemscope itemtype="http://schema.org/Person">
      <span itemprop="name">ジョージ・ワシントン</span>
     </span></p>
     <p><time itemprop="dateCreated" datetime="2009-10-10">15分前</time></p>
    </footer>
    </p>そうですね！特にロビイストの友達の話をしているときに！</p>
   </article>
   </article itemprop="comment" itemscope itemtype="http://schema.org/Comment" id="c2">
    <link itemprop="url" href="#c2">
    </footer>
     <p>投稿者: <span itemprop="creator" itemscope itemtype="http://schema.org/Person">
      <span itemprop="name">ジョージ・ハモンド</span>
     </span></p>
     <p><time itemprop="dateCreated" datetime="2009-10-10">5分前</time></p>
    </footer>
    </p>へえ、君と同じ名前だね。</p>
   </article>
  </section>
 </article>

各コメントの情報（投稿者や日時など）を提供するために footer 要素が使用されていることに注目してください。この要素は、適切な場合にセクションの冒頭に表示することができます。このケースでは header を使用しても問題はありません。これは主に著者の好みの問題です。

この例では、article 要素がポータルページのウィジェットをホストするために使用されています。ウィジェットは、特定のスタイルとスクリプトされた動作を取得するために、カスタマイズされたビルトイン要素 として実装されています。

<!DOCTYPE HTML>
<html lang=en>
<title>eHome Portal</title>
<script src="/scripts/widgets.js"></script>
<link rel=stylesheet href="/styles/main.css">
<article is="stock-widget">
<h2>Stocks</h2>
<table>
<thead> <tr> <th> Stock <th> Value <th> Delta
<tbody> <template> <tr> <td> <td> <td> </template>
</table>
<p> <input type=button value="Refresh" onclick="this.parentElement.refresh()">
</article>
</article is="news-widget">
<h2>News</h2>
<ul>
<template><li> <p><img> <strong></strong></p></p></template></ul></p> </article>

4.3.3 section 要素

Element/section

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ。
セクショニングコンテンツ。
パルパブルコンテンツ。
使用できるコンテキスト:
セクショニングコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用します。

section要素は、文書またはアプリケーションの一般的なセクションを表します。このコンテキストでのセクションは、通常、見出しを伴うテーマごとのグループ化を指します。

セクションの例としては、章、タブ付きダイアログボックスのさまざまなタブページ、または論文の番号付きセクションがあります。ウェブサイトのホームページは、イントロダクション、ニュース項目、お問い合わせ情報などのセクションに分割することができます。

著者は、article要素の代わりに、section要素を使用することを推奨します。

section要素は、汎用的なコンテナ要素ではありません。要素がスタイリング目的でのみ必要である場合や、スクリプトの便宜上必要な場合、著者は代わりにdiv要素を使用することが推奨されます。一般的なルールとして、section要素は、要素の内容が文書のアウトラインに明示的にリストされる場合にのみ適しています。

以下の例では、リンゴに関する記事（より大きなウェブページの一部）が表示されており、2つの短いセクションが含まれています。

<article>
  <hgroup>
   <h2>リンゴ</h2>
   <p>美味しくておいしい果物！</p>
  </hgroup>
  <p>リンゴはリンゴの木の果実です。</p><section>
   <h3>レッドデリシャス</h3>
   <p>これらの明るい赤色のリンゴは、多くのスーパーマーケットで最も一般的に見られるものです。</p>
  </section>
  <section>
   <h3>グラニースミス</h3>
   <p>これらのジューシーで緑色のリンゴは、アップルパイの素晴らしいフィリングになります。</p>
  </section>
 </article>

以下は、卒業生のリストと式典の説明の2つのセクションを持つ卒業式プログラムです。（この例のマークアップは、要素間の空白を最小限に抑えるために時折使用される珍しいスタイルが特徴です。）

<!DOCTYPE Html>
 <Html Lang=En>
  <Head>
    <Title>Graduation Ceremony Summer 2022</Title>
    </Head>
  <Body>
    <H1>卒業式</H1>
    <Section>
      <H2>式典</H2>
      <P>入場行進</P>
      <P>卒業生代表挨拶</P>
      <P>生徒会長挨拶</P>
      <P>卒業証書授与</P>
      <P>校長の閉会挨拶</P>
    </Section>
    <Section>
      <H2>卒業生</H2>
      <Ul>
        <Li>モリー・カーペンター</Li>
        <Li>アナスタシア・ルッチオ</Li>
        <Li>エベネザー・マッコイ</Li>
        <Li>カリン・マーフィー</Li>
        <Li>トーマス・レイス</Li>
        <Li>スーザン・ロドリゲス</Li>
      </Ul>
    </Section>
  </Body>
 </Html>

この例では、著者がいくつかのセクションを章として、いくつかを付録としてマークアップし、CSSを使用してこれら2つのクラスのセクションのヘッダーを異なるスタイルにしています。

<style>
  section { border: double medium; margin: 2em; }
  section.chapter h2 { font: 2em Roboto, Helvetica Neue, sans-serif; }
  section.appendix h2 { font: small-caps 2em Roboto, Helvetica Neue, sans-serif; }
 </style>
 <header>
  <hgroup>
   <h1>私の本</h1>
   <p>あまり内容のないサンプル</p>
  </hgroup>
  <p><small>Dummy Publicorp Ltd. 発行</small></p>
 </header>
 <section class="chapter">
  <h2>私の最初の章</h2>
  <p>これは私の章の最初のものです。あまり多くは語りません。</p>
  <p>しかし、2つの段落があります！</p>
 </section>
 <section class="chapter">
  <h2>続く：第2章</h2>
  <p>ブラ・ディ・ブラ、ディ・ブラ・ディ・ブラ。ブーム。</p>
 </section>
 <section class="chapter">
  <h2>第3章：さらなる例</h2>
  <p>明るい色とアーストーンの戦いが気付かれないことはありません。</p>
  <p>しかし、それが私の物語を台無しにするかもしれません。</p>
 </section>
 <section class="appendix">
  <h2>付録A：例の概要</h2>
  <p>これらはデモンストレーションです。</p>
 </section>
 <section class="appendix">
  <h2>付録B：いくつかの結論的な発言</h2>
  <p>この長い例が、セクションが実際のセクションを示すために使用される限り、スタイル設定が可能であることを示していることを願っています。</p>
 </section>

4.3.4 nav要素

Element/nav

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (旧バージョン)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ。
セクショニングコンテンツ。
明確なコンテンツ。
この要素が使用できるコンテキスト:
セクショニングコンテンツが予想される場所。
コンテンツモデル:
フローコンテンツ。
text/htmlでのタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用します。

nav要素は、ページの他の部分や他のページへのリンクを含むセクションを表します: ナビゲーションリンクを持つセクションです。

ページ内のすべてのリンクグループがnav要素に含まれる必要はありません—この要素は主に主要なナビゲーションブロックで構成されるセクションを意図しています。特に、フッターには、利用規約、ホームページ、著作権ページなど、サイトのさまざまなページへの短いリンクリストが含まれることがよくあります。このような場合、footer要素のみで十分です; このような場合にはnav要素を使用することもできますが、通常は不要です。

ナビゲーション情報の初期表示を省略することが役立つユーザー、またはナビゲーション情報を即座に利用可能にすることが役立つユーザーを対象としたユーザーエージェント（スクリーンリーダーなど）は、この要素を使用して、ページのどのコンテンツを最初にスキップするか、またはリクエストに応じて提供するか（またはその両方）を判断することができます。

次の例では、nav要素が2つあり、1つはサイト全体の主要ナビゲーション用で、もう1つはページ自体の二次ナビゲーション用です。 

<body>
  <h1>The Wiki Center Of Exampland</h1>
  <nav>
   <ul>
    <li><a href="/">Home</a></li>
    <li><a href="/events">Current Events</a></li>
    ...more...
   </ul>
  </nav>
  <article>
   <header>
    <h2>Demos in Exampland</h2>
    <p>Written by A. N. Other.</p>
   </header>
   <nav>
    <ul>
     <li><a href="#public">Public demonstrations</a></li>
     <li><a href="#destroy">Demolitions</a></li>
     ...more...
    </ul>
   </nav>
   <div>
    <section id="public">
     <h2>Public demonstrations</h2>
     <p>...more...</p>
    </section>
    <section id="destroy">
     <h2>Demolitions</h2>
     <p>...more...</p>
    </section>
    ...more...
   </div>
   </footer>
    <p><a href="?edit">Edit</a> | <a href="?delete">Delete</a> | <a href="?Rename">Rename</a></p>
   </footer>
  </article>
  </footer>
   <p><small>© copyright 1998 Exampland Emperor</small></p>
  </footer>
 </body>

次の例では、ページにいくつかのリンクが存在する場所がありますが、これらの場所のうち1つだけがナビゲーションセクションと見なされます。

<body itemscope itemtype="http://schema.org/Blog">
  <header>
   <h1>Wake up sheeple!</h1>
   <p><a href="news.html">News</a> -
      <a href="blog.html">Blog</a> -
      <a href="forums.html">Forums</a></p>
   <p>Last Modified: <span itemprop="dateModified">2009-04-01</span></p>
   <nav>
    <h2>Navigation</h2>
    <ul>
     <li><a href="articles.html">Index of all articles</a></li>
     <li><a href="today.html">Things sheeple need to wake up for today</a></li>
     <li><a href="successes.html">Sheeple we have managed to wake</a></li>
    </ul>
   </nav>
  </header>
  <main>
   <article itemprop="blogPosts" itemscope itemtype="http://schema.org/BlogPosting">
    <header>
     <h2 itemprop="headline">My Day at the Beach</h2>
    </header>
    <div itemprop="articleBody">
     <p>Today I went to the beach and had a lot of fun.</p>
     ...more content...
    </div>
    <footer>
     <p>Posted <time itemprop="datePublished" datetime="2009-10-10">Thursday</time>.</p>
    </footer>
   </article>
   ...more blog posts...
  </main>
  </footer>
   <p>Copyright ©
    <span itemprop="copyrightYear">2010</span>
    <span itemprop="copyrightHolder">The Example Company</span>
   </p>
   <p><a href="about.html">About</a> -
      <a href="policy.html">Privacy Policy</a> -
      <a href="contact.html">Contact Us</a></p>
  </footer>
 </body>

上記の例では、microdataの注釈もあり、ブログ記事の日付やその他のメタデータをschema.orgの語彙を使用して提供しています。

nav要素はリストを含む必要はなく、他の種類のコンテンツを含むこともできます。このナビゲーションブロックでは、リンクが文章で提供されています: 

<nav>
  <h1>Navigation</h1>
  <p>You are on my home page. To the north lies <a href="/blog">my
  blog</a>, from whence the sounds of battle can be heard. To the east
  you can see a large mountain, upon which many <a
  href="/school">school papers</a> are littered. Far up thus mountain
  you can spy a little figure who appears to be me, desperately
  scribbling a <a href="/school/thesis">thesis</a>.</p>
  <p>To the west are several exits. One fun-looking exit is labeled <a
  href="https://games.example.com/">"games"</a>. Another more
  boring-looking exit is labeled <a
  href="https://isp.example.net/">ISP™</a>.</p>
  <p>To the south lies a dark and dank <a href="/about">contacts
  page</a>. Cobwebs cover its disused entrance, and at one point you
  see a rat run quickly out of the page.</p>
 </nav>

この例では、nav要素がメールアプリケーションで使用され、ユーザーがフォルダーを切り替えることができます: 

<p><input type=button value="Compose" onclick="compose()"></p>
<nav>
<h1>フォルダー</h1>
<ul>
 <li> <a href="/inbox" onclick="return openFolder(this.href)">受信トレイ</a> <span class=count></span>
 </li> <li> <a href="/sent" onclick="return openFolder(this.href)">送信済み</a>
 </li> <li> <a href="/drafts" onclick="return openFolder(this.href)">下書き</a>
 </li> <li> <a href="/trash" onclick="return openFolder(this.href)">ごみ箱</a>
 </li> <li> <a href="/customers" onclick="return openFolder(this.href)">顧客</a>
</ul>
</nav>

4.3.5 aside要素

Element/aside

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ.
セクショニングコンテンツ.
実質コンテンツ.
この要素を使用できる文脈:
セクショニングコンテンツが予期される場所。
コンテンツモデル:
フローコンテンツ.
text/htmlでのタグ省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOMインターフェース:
HTMLElementを使用します。

aside要素は、その周りのコンテンツに対して間接的に関連するセクションを表し、そのコンテンツから分離していると見なすことができます。このようなセクションは、印刷されたタイポグラフィではサイドバーとしてよく表現されます。

この要素は、引用やサイドバー、広告、nav要素のグループ、またはページのメインコンテンツとは別のコンテンツとして考えられる他のコンテンツのために使用できます。

括弧書きのように、本文の流れの一部である場合にaside要素を使用するのは適切ではありません。

次の例は、長いヨーロッパに関するニュース記事の中で、スイスに関する背景資料をマークアップするためにasideが使用されている例を示しています。

<aside>
<h2>Switzerland</h2>
<p>Switzerland, a land-locked country in the middle of geographic
Europe, has not joined the geopolitical European Union, though it is
a signatory to a number of European treaties.</p>
</aside>

次の例は、長い記事の中で引用をマークアップするためにasideが使用されている例を示しています。

...
 
<p>He later joined a large company, continuing on the same work.
<q>I love my job. People ask me what I do for fun when I'm not at
work. But I'm paid to do my hobby, so I never know what to
answer. Some people wonder what they would do if they didn't have to
work... but I know what I would do, because I was unemployed for a
year, and I filled that time doing exactly what I do now.</q></p>

<aside>
<q>People ask me what I do for fun when I'm not at work. But I'm
paid to do my hobby, so I never know what to answer.</q>
</aside>

<p>Of course his work — or should that be hobby? —
isn't his only passion. He also enjoys other pleasures.</p>

...

次の抜粋は、ブログのブログロールやその他のサイドコンテンツのためにasideがどのように使用できるかを示しています: 

<body>
  <header>
   <h1>My wonderful blog</h1>
   <p>My tagline</p>
  </header>
  <aside>
   <!-- this aside contains two sections that are tangentially related
   to the page, namely, links to other blogs, and links to blog posts
   from this blog -->
   <nav>
    <h2>My blogroll</h2>
    <ul>
     <li><a href="https://blog.example.com/">Example Blog</a>
    </ul>
   </nav>
   <nav>
    <h2>Archives</h2>
    <ol reversed>
     <li><a href="/last-post">My last post</a>
     <li><a href="/first-post">My first post</a>
    </ol>
   </nav>
  </aside>
  <aside>
   <!-- this aside is tangentially related to the page also, it
   contains twitter messages from the blog author -->
   <h1>Twitter Feed</h1>
   <blockquote cite="https://twitter.example.net/t31351234">
    I'm on vacation, writing my blog.
   </blockquote>
   <blockquote cite="https://twitter.example.net/t31219752">
    I'm going to go on vacation soon.
   </blockquote>
  </aside>
  <article>
   <!-- this is a blog post -->
   <h2>My last post</h2>
   <p>This is my last post.</p>
   <footer>
    <p><a href="/last-post" rel=bookmark>Permalink</a>
   </footer>
  </article>
  <article>
   <!-- this is also a blog post -->
   <h2>My first post</h2>
   <p>This is my first post.</p>
   <aside>
    <!-- this aside is about the blog post, since it's inside the
    <article> element; it would be wrong, for instance, to put the
    blogroll here, since the blogroll isn't really related to this post
    specifically, only to the page as a whole -->
    <h2>Posting</h2>
    <p>While I'm thinking about it, I wanted to say something about
    posting. Posting is fun!</p>
   </aside>
   <footer>
    <p><a href="/first-post" rel=bookmark>Permalink</a>
   </footer>
  </article>
  <footer>
   <p><a href="/archives">Archives</a> -
    <a href="/about">About me</a> -
    <a href="/copyright">Copyright</a></p>
  </footer>
 </body>

4.3.6 h1、h2、h3、h4、h5 および h6 要素

Element/Heading_Elements

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/Heading_Elements

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/Heading_Elements

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/Heading_Elements

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/Heading_Elements

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/Heading_Elements

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLHeadingElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
見出しコンテンツ。
感じられるコンテンツ。
この要素が使用できるコンテキスト:
hgroup要素の子要素として。
見出しコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ。
text/html におけるタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
作成者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLHeadingElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // also has obsolete members
 };

これらの要素は、そのセクションの見出しを表します。

これらの要素のセマンティクスと意味は、見出しとアウトラインのセクションで定義されています。

これらの要素は、その名前にある数字によって見出しレベルが決まります。 見出しレベルは、ネストされたセクションのレベルに対応しています。 h1 要素はトップレベルセクション用であり、 h2 はサブセクション用、h3は サブサブセクション用です。

それぞれのドキュメントのアウトライン（見出しとセクション構造）に関しては、これらの2つのスニペットはセマンティクス的に等価です。

<body>
 <h1>Let's call it a draw(ing surface)</h1>
 <h2>Diving in</h2>
 <h2>Simple shapes</h2>
 <h2>Canvas coordinates</h2>
 <h3>Canvas coordinates diagram</h3>
 <h2>Paths</h2>
 </body>
<body>
  <h1>Let's call it a draw(ing surface)</h1>
  <section>
   <h2>Diving in</h2>
  </section>
  <section>
   <h2>Simple shapes</h2>
  </section>
  <section>
   <h2>Canvas coordinates</h2>
   <section>
    <h3>Canvas coordinates diagram</h3>
   </section>
  </section>
  <section>
   <h2>Paths</h2>
  </section>
 </body>

作成者は、簡潔さのために前者のスタイルを好むか、追加のスタイリングフックのために後者のスタイルを好むかもしれません。どちらが最良かは、単に好まれる作成スタイルの問題です。

4.3.7 hgroup 要素

Element/hgroup

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android2.2+Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ。
見出しコンテンツ。
感じられるコンテンツ。
この要素が使用できるコンテキスト:
見出しコンテンツが期待される場所。
コンテンツモデル:
0 個以上のp要素が続き、次に 1 つのh1、 h2、 h3、 h4、 h5、 またはh6 要素が続き、その後に 0 個以上の p要素が続き、必要に応じてスクリプトサポート要素と混在します。
text/html におけるタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
作成者向け。
実装者向け。
DOM インターフェイス:
HTMLElementを使用します。

hgroup要素は、見出しと関連コンテンツを表します。この要素は、h1–h6要素と 1 つ以上のp要素をグループ化して、サブ見出し、代替タイトル、またはキャッチフレーズを表すコンテンツを含めるために使用できます。

ここに、hgroup要素に含まれる有効な見出しの例をいくつか示します。 

<hgroup>
  <h1>The reality dysfunction</h1>
  <p>Space is not the only void</p>
 </hgroup>
<hgroup>
  <h1>Dr. Strangelove</h1>
  <p>Or: How I Learned to Stop Worrying and Love the Bomb</p>
 </hgroup>

4.3.8 header 要素

Element/header

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ。
感じられるコンテンツ。
この要素が使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ、ただしheaderまたはfooter要素の子孫を含まないこと。
text/html におけるタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
先祖要素としてセクショニングコンテンツ要素がある場合: 作成者向け；実装者向け。
それ以外の場合: 作成者向け；実装者向け。
DOM インターフェイス:
HTMLElementを使用します。

header要素は、紹介やナビゲーションの補助要素のグループを表します。

header要素は通常、見出し (h1–h6要素やhgroup要素)を含むことを意図していますが、これは必須ではありません。header要素は、セクションの目次、検索フォーム、または関連するロゴをラップするためにも使用できます。

いくつかのサンプルヘッダーを紹介します。これは、ゲーム用の最初のものです。

<header>
  <p>Welcome to...</p>
  <h1>Voidwars!</h1>
 </header>

次のスニペットは、要素が仕様のヘッダーをマークアップするためにどのように使用できるかを示しています。

<header>
  <hgroup>
   <h1>Fullscreen API</h1>
   <p>現行標準 — 最終更新日 2015年10月19日</p>
  </hgroup>
  <dl>
   <dt>参加:</dt>
   <dd><a href="https://github.com/whatwg/fullscreen">GitHub whatwg/fullscreen</a></dd>
   <dt>コミット:</dt>
   <dd><a href="https://github.com/whatwg/fullscreen/commits">GitHub whatwg/fullscreen/commits</a></dd>
  </dl>
 </header>

header要素はセクショニングコンテンツではありません; 新しいセクションを導入しません。

この例では、ページにはh1要素によって与えられたページの見出しがあり、h2要素によって与えられた 2 つのサブセクションがあります。header要素の後のコンテンツは、header要素で開始された最後のサブセクションの一部です。なぜなら、header要素はアウトラインアルゴリズムに関与しないためです。 

<body>
  <header>
   <h1>Little Green Guys With Guns</h1>
   <nav>
    <ul>
     <li><a href="/games">Games</a>
     <li><a href="/forum">Forum</a>
     <li><a href="/download">Download</a>
    </ul>
   </nav>
   <h2>Important News</h2> <!-- これが2つ目のサブセクションを開始します -->
   <!-- これは「Important News」というタイトルのサブセクションの一部です -->
   <p>今日のゲームをプレイするには、クライアントを更新する必要があります。</p>
   <h2>Games</h2> <!-- これが3つ目のサブセクションを開始します -->
  </header>
  <p>あなたには 3 つのアクティブなゲームがあります:</p>
  <!-- これはまだ「Games」というタイトルのサブセクションの一部です -->
  ...

Element/footer

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11.1+
カテゴリ:
フローコンテンツ。
感じられるコンテンツ。
この要素が使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ、ただしheaderまたはfooter要素の子孫を含まないこと。
text/html におけるタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
先祖要素としてセクショニングコンテンツ要素がある場合: 作成者向け；実装者向け。
それ以外の場合: 作成者向け；実装者向け。
DOM インターフェイス:
HTMLElementを使用します。

footer要素は、最も近い先祖セクショニングコンテンツ要素、またはそのような先祖がない場合は本文要素のフッターを表します。フッターには通常、そのセクションに関する情報（誰が書いたか、関連文書へのリンク、著作権データなど）が含まれます。

footer要素にセクション全体が含まれている場合、それらは付録、索引、長いコロフォン、詳細なライセンス契約、およびその他のそのような内容を表します。

セクションの著者または編集者の連絡先情報は、address要素に含めるべきであり、場合によってはfooter内に配置されることもあります。署名や他の情報はheaderまたはfooterのいずれにも（あるいはどちらにも）配置できます。これらの要素の主な目的は、単に作成者が説明的なマークアップを書きやすく、維持およびスタイル設定しやすくすることです。特定の構造を作成者に強制することを意図しているわけではありません。

フッターは必ずしもセクションの終わりに表示される必要はありませんが、通常は表示されます。

先祖セクショニングコンテンツ要素がない場合、ページ全体に適用されます。

footer要素はそれ自体がセクショニングコンテンツではありません; 新しいセクションを導入しません。

次に、上部と下部に同じコンテンツを持つ 2 つのフッターがあるページの例を示します。

<body>
  <footer><a href="../">目次に戻る...</a></footer>
  <hgroup>
   <h1>Lorem ipsum</h1>
   <p>The ipsum of all lorems</p>
  </hgroup>
  <p>A dolor sit amet, consectetur adipisicing elit, sed do eiusmod
  tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
  veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
  ea commodo consequat. Duis aute irure dolor in reprehenderit in
  voluptate velit esse cillum dolore eu fugiat nulla
  pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
  culpa qui officia deserunt mollit anim id est laborum.</p>
  <footer><a href="../">目次に戻る...</a></footer>
 </body>

次の例は、footer要素が、サイト全体のフッターとセクションのフッターの両方に使用されていることを示しています。 

<!DOCTYPE HTML>
 <HTML LANG="en"><HEAD>
 <TITLE>The Ramblings of a Scientist</TITLE>
 <BODY>
 <H1>The Ramblings of a Scientist</H1>
 <ARTICLE>
  <H1>Episode 15</H1>
  <VIDEO SRC="/fm/015.ogv" CONTROLS PRELOAD>
   <P><A HREF="/fm/015.ogv">ビデオをダウンロードする</A>.</P>
  </VIDEO>
  <FOOTER> <!-- 記事のフッター -->
   <P>公開日時 <TIME DATETIME="2009-10-21T18:26-07:00">2009/10/21 午後 6:26</TIME></P>
  </FOOTER>
 </ARTICLE>
 <ARTICLE>
  <H1>私の好きな列車</H1>
  <P>私は列車が大好きです。私が一番好きな列車はコーフです。</P>
  <P>石炭車を引いているのを見るのは楽しいです。それは非常に小さく見えるからです。</P>
  <FOOTER> <!-- 記事のフッター -->
   <P>公開日時 <TIME DATETIME="2009-09-15T14:54-07:00">2009/09/15 午後 2:54</TIME></P>
  </FOOTER>
 </ARTICLE>
 <FOOTER> <!-- サイト全体のフッター -->
  <NAV>
   <P><A HREF="/credits.html">クレジット</A> —
      <A HREF="/tos.html">サービス利用規約</A> —
      <A HREF="/index.html">ブログインデックス</A></P>
  </NAV>
  <P>著作権 © 2009 ゴードン・フリーマン</P>
 </FOOTER>
 </BODY>
 </HTML>

いくつかのサイトデザインには、「ファットフッター」と呼ばれることがあるものがあります — 多くの素材を含むフッターで、画像、他の記事へのリンク、フィードバックを送信するページへのリンク、特別オファーなどが含まれることがあります。ある意味、フッターに「トップページ全体」があるようなものです。

この断片は、「ファットフッター」を持つサイトのページの底部を示しています。

...
  <footer>
   <nav>
    <section>
     <h1>記事</h1>
     <p><img src="images/somersaults.jpeg" alt=""> ジムと一緒に
     私たちの宙返りクラス！この二部構成の記事で、ジムがペースを取り戻す方法を教えてくれます。<a href="articles/somersaults/1">パート1</a> · <a href="articles/somersaults/2">パート2</a></p>
     <p><img src="images/kindplus.jpeg"> 崖の端を歩くのに疲れた？私たちのゲストライター、ララがバーを通過する方法を教えてくれます。<a href="articles/kindplus/1">続きを読む...</a></p>
     <p><img src="images/crisps.jpeg"> チップはもうダメです、残っているのはジャガイモだけです。それをどうしますか？ <a
     href="articles/crisps/1">続きを読む...</a></p>
    </section>
    <ul>
     <li><a href="/about">私たちについて...</a>
     <li><a href="/feedback">フィードバックを送る！</a>
     <li><a href="/sitemap">サイトマップ</a>
    </ul>
   </nav>
   <p><small>著作権 © 2015 The Snacker —
   <a href="/tos">サービス利用規約</a></small></p>
  </footer>
 </body>

4.3.10 address 要素

Element/address

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
触知可能コンテンツ.
この要素が使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツですが、見出しコンテンツや、セクション化コンテンツ、 header、 footer、または address 要素の子孫を含めることはできません。
text/html におけるタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
作成者向け.
実装者向け.
DOM インターフェース:
HTMLElement を使用します。

address 要素は、その最も近い article または body 要素の祖先の連絡先情報を表します。それが body 要素 である場合、連絡先情報は文書全体に適用されます。

例えば、HTML に関連する W3C ウェブサイトのページには、次のような連絡先情報が含まれる場合があります。

<ADDRESS>
<A href="../People/Raggett/">Dave Raggett</A>,
<A href="../People/Arnaud/">Arnaud Le Hors</A>,
contact persons for the <A href="Activity">W3C HTML Activity</A>
</ADDRESS>

address 要素は、任意の住所（例えば、郵送先住所）を表すために使用してはなりません。ただし、それらの住所が関連する連絡先情報である場合を除きます。（一般的な郵送先住所をマークアップするには、p 要素が適しています。）

address 要素には、連絡先情報以外の情報を含めてはなりません。

例えば、次のものは address 要素の不適合な使用です。

<ADDRESS>Last Modified: 1999/12/24 23:37:50</ADDRESS>

通常、address 要素は、footer 要素に他の情報と共に含まれます。

ノード node の連絡先情報は、次のリストから最初に適用される項目によって定義された address 要素のコレクションです。

node が article 要素の場合
node が body 要素の場合

連絡先情報は、node を祖先とし、他の body 要素または article 要素の祖先を持たない address 要素です。

node の祖先に article 要素がある場合
node の祖先に body 要素がある場合

node の連絡先情報は、最も近い article または body 要素の祖先の連絡先情報と同じです。

node の ノード文書 が body 要素 を持っている場合

node の連絡先情報は、Document の body 要素 の連絡先情報と同じです。

それ以外の場合

node には連絡先情報がありません。

ユーザーエージェントは、ノードの連絡先情報をユーザーに公開したり、セクションを連絡先情報に基づいてインデックスするなど、他の目的で使用することがあります。

この例では、フッターには連絡先情報と著作権表示が含まれています。

<footer>
  <address>
   For more details, contact
   <a href="mailto:js@example.com">John Smith</a>.
  </address>
  <p><small>© copyright 2038 Example Corp.</small></p>
 </footer>

4.3.11 見出しとアウトライン

h1–h6 要素には、その要素名の数字によって決まる見出しレベルがあります。

これらの要素は見出しを表します。見出しの 見出しレベルが低いほど、その見出しの祖先セクションが少なくなります。

アウトラインは、ドキュメント内のすべての見出しを、ツリー順で含むものです。

アウトラインは、たとえば目次を生成するときに、ドキュメントのアウトラインを生成するために使用されるべきです。インタラクティブな目次を作成するときは、エントリがユーザーを関連する見出しにジャンプさせるべきです。

ドキュメントに1つ以上の見出しがある場合、少なくとも1つの見出しがアウトライン内で 見出しレベル 1 を持つべきです。

見出しに続く各見出しは、leadの見出しレベル以下、同じ、または1つ上のレベルの見出しレベルを持たなければなりません。

次の例は、準拠していません:

<body>
  <h1>Apples</h1>
  <p>Apples are fruit.</p>
  <section>
   <h3>Taste</h3>
   <p>They taste lovely.</p>
  </section>
 </body>

次のように書き換えると、準拠するようになります:

<body>
  <h1>Apples</h1>
  <p>Apples are fruit.</p>
  <section>
   <h2>Taste</h2>
   <p>They taste lovely.</p>
  </section>
 </body>
4.3.11.1 サンプルアウトライン

次のマークアップフラグメントは:

<body>
   <hgroup id="document-title">
     <h1>HTML: Living Standard</h1>
     <p>Last Updated 12 August 2016</p>
   </hgroup>
   <p>Some intro to the document.</p>
   <h2>Table of contents</h2>
   <ol id=toc>...</ol>
   <h2>First section</h2>
   <p>Some intro to the first section.</p>
 </body>

...3つのドキュメント見出しを生成します:

  1. <h1>HTML: Living Standard</h1>

  2. <h2>Table of contents</h2>.

  3. <h2>First section</h2>.

アウトラインのレンダリングされたビューは次のように見えるかもしれません:

トップレベルセクションが"HTML: Living Standard"という見出しと2つのサブセクション; "Table of contents"と"First section"を持つ。

まず、章やサブセクションが非常に短い本のドキュメントです:

<!DOCTYPE HTML>
 <html lang=en>
 <title>The Tax Book (all in one page)</title>
 <h1>The Tax Book</h1>
 <h2>Earning money</h2>
 <p>Earning money is good.</p>
 <h3>Getting a job</h3>
 <p>To earn money you typically need a job.</p>
 <h2>Spending money</h2>
 <p>Spending is what money is mainly used for.</p>
 <h3>Cheap things</h3>
 <p>Buying cheap things often not cost-effective.</p>
 <h3>Expensive things</h3>
 <p>The most expensive thing is often not the most cost-effective either.</p>
 <h2>Investing money</h2>
 <p>You can lend your money to other people.</p>
 <h2>Losing money</h2>
 <p>If you spend money or invest money, sooner or later you will lose money.
 <h3>Poor judgement</h3>
 <p>Usually if you lose money it's because you made a mistake.</p>

このアウトラインは次のように表示されるかもしれません:

  1. The Tax Book
    1. Earning money
      1. Getting a job
    2. Spending money
      1. Cheap things
      2. Expensive things
    3. Investing money
    4. Losing money
      1. Poor judgement

title要素は見出しではないことに注意してください。

ドキュメントには複数のトップレベルの見出しを含めることができます:

<!DOCTYPE HTML>
 <html lang=en>
 <title>Alphabetic Fruit</title>
 <h1>Apples</h1>
 <p>Pomaceous.</p>
 <h1>Bananas</h1>
 <p>Edible.</p>
 <h1>Carambola</h1>
 <p>Star.</p>

このドキュメントのアウトラインは次のように表示されるかもしれません:

  1. Apples
  2. Bananas
  3. Carambola

header要素は、ドキュメントのアウトラインに影響を与えません:

<!DOCTYPE HTML>
 <html lang="en">
 <title>We're adopting a child! — Ray's blog</title>
 <h1>Ray's blog</h1>
 <article>
  <header>
   <nav>
    <a href="?t=-1d">Yesterday</a>;
    <a href="?t=-7d">Last week</a>;
    <a href="?t=-1m">Last month</a>
   </nav>
   <h2>We're adopting a child!</h2>
  </header>
  <p>As of today, Janine and I have signed the papers to become
  the proud parents of baby Diane! We've been looking forward to
  this day for weeks.</p>
 </article>
 </html>

このドキュメントのアウトラインは次のように表示されるかもしれません:

  1. Ray's blog
    1. We're adopting a child!

次の例は準拠していますが、見出しレベルが1である見出しがないため推奨されません:

<!DOCTYPE HTML>
 <html lang=en>
 <title>Alphabetic Fruit</title>
 <section>
  <h2>Apples</h2>
  <p>Pomaceous.</p>
 </section>
 <section>
  <h2>Bananas</h2>
  <p>Edible.</p>
 </section>
 <section>
  <h2>Carambola</h2>
  <p>Star.</p>

このドキュメントのアウトラインは次のように表示されるかもしれません:

    1. Apples
    2. Bananas
    3. Carambola

次の例は準拠していますが、最初の見出しのレベルが1でないため推奨されません:

<!DOCTYPE HTML>
 <html lang=en>
 <title>Feathers on The Site of Encyclopedic Knowledge</title>
  <h2>A plea from our caretakers</h2>
  <p>Please, we beg of you, send help! We're stuck in the server room!</p>
 <h1>Feathers</h1>
 <p>Epidermal growths.</p>

このドキュメントのアウトラインは次のように表示されるかもしれません:

    1. A plea from our caretakers
  2. Feathers
4.3.11.2 ユーザーへのアウトラインの表示

ユーザーエージェントは、ユーザーがナビゲーションを容易に行えるように、ページのアウトラインを表示することを推奨します。これは特に、スクリーンリーダーなどの非視覚メディアにおいて重要です。

例えば、ユーザーエージェントは以下のように矢印キーをマッピングすることができます：

Shift + ← 左
前の見出しに移動
Shift + → 右
次の見出しに移動
Shift + ↑ 上
現在の見出しレベルよりも1つ低いレベルの次の見出しに移動
Shift + ↓ 下
現在の見出しと同じレベルの次の見出しに移動

4.3.12 使用の概要

このセクションは規範的ではありません。

要素 目的
例
body 文書の内容。 
<!DOCTYPE HTML>
 <html lang="en">
  <head> <title>Steve Hill's Home Page</title> </head>
  <body> <p>Hard Trance is My Life.</p> </body>
 </html>
article 文書、ページ、アプリケーション、またはサイト内の完全または独立した構成要素。例えば、フォーラムの投稿、雑誌や新聞の記事、ブログのエントリー、ユーザー投稿のコメント、インタラクティブウィジェットやガジェット、またはその他の独立したコンテンツアイテムが含まれる可能性があります。 
<article>
  <img src="/tumblr_masqy2s5yn1rzfqbpo1_500.jpg" alt="Yellow smiley face with the caption 'masif'">
  <p>My fave Masif tee so far!</p>
  <footer>Posted 2 days ago</footer>
 </article>
 <article>
  <img src="/tumblr_m9tf6wSr6W1rzfqbpo1_500.jpg" alt="">
  <p>Happy 2nd birthday Masif Saturdays!!!</p>
  <footer>Posted 3 weeks ago</footer>
 </article>
section 文書またはアプリケーションの一般的なセクション。この文脈では、セクションとは、通常、見出しを伴う内容のテーマ別のグループ化を指します。 
<h1>Biography</h1>
 <section>
  <h1>The facts</h1>
  <p>1500+ shows, 14+ countries</p>
 </section>
 <section>
  <h1>2010/2011 figures per year</h1>
  <p>100+ shows, 8+ countries</p>
 </section>
nav ページ内の他のページまたはページ内の部分へのリンクを含むセクション: ナビゲーションリンクが含まれるセクション。 
<nav>
  <p><a href="/">Home</a>
  <p><a href="/biog.html">Bio</a>
  <p><a href="/discog.html">Discog</a>
 </nav>
aside aside要素の周囲の内容に関連するが、それとは独立して考えられるコンテンツを含むページのセクション。このようなセクションは、印刷されたタイポグラフィでしばしばサイドバーとして表現されます。 
<h1>Music</h1>
 <p>As any burner can tell you, the event has a lot of trance.</p>
 <aside>You can buy the music we played at our <a href="buy.html">playlist page</a>.</aside>
 <p>This year we played a kind of trance that originated in Belgium, Germany, and the Netherlands in the mid-90s.</p>
h1–h6 見出し 
<h1>The Guide To Music On The Playa</h1>
 <h2>The Main Stage</h2>
 <p>If you want to play on a stage, you should bring one.</p>
 <h2>Amplified Music</h2>
 <p>Amplifiers up to 300W or 90dB are welcome.</p>
hgroup 見出しと関連コンテンツ。この要素は、1つまたは複数の

要素を含むh1–h6 要素を、サブヘッディング、代替タイトル、またはキャッチフレーズを表す内容としてグループ化するために使用できます。 

<hgroup>
  <h1>Burning Music</h1>
  <p>The Guide To Music On The Playa</p>
 </hgroup>
 <section>
  <hgroup>
   <h1>Main Stage</h1>
   <p>The Fiction Of A Music Festival</p>
  </hgroup>
  <p>If you want to play on a stage, you should bring one.</p>
 </section>
 <section>
  <hgroup>
   <h1>Loudness!</h1>
   <p>Questions About Amplified Music</p>
  </hgroup>
  <p>Amplifiers up to 300W or 90dB are welcome.</p>
 </section>
header 導入的またはナビゲーション的な支援のグループ。 
<article>
  <header>
   <h1>Hard Trance is My Life</h1>
   <p>By DJ Steve Hill and Technikal</p>
  </header>
  <p>The album with the amusing punctuation has red artwork.</p>
 </article>
footer 最も近い祖先セクショニングコンテンツ要素、またはそのような祖先がない場合はbody 要素のフッター。フッターには通常、そのセクションに関する情報、著者に関するデータ、関連文書へのリンク、著作権情報などが含まれます。 
<article>
  <h1>Hard Trance is My Life</h1>
  <p>The album with the amusing punctuation has red artwork.</p>
  <footer>
   <p>Artists: DJ Steve Hill and Technikal</p>
  </footer>
 </article>
4.3.12.1 記事またはセクション？

このセクションは非規範的です。

sectionは他の何かの一部を構成します。articleはそれ自体が独立したものです。しかし、どちらがどちらなのかどうやって分かるのでしょうか？本当の答えは「著者の意図次第」というのがほとんどです。

例えば、「グラニースミス」という章がある本を想像してみてください。そこには「これらのジューシーな緑のリンゴはアップルパイのフィリングに最適です。」とだけ書かれているとします。それはsectionです。なぜなら、（おそらく）他の種類のリンゴに関する多くの章があるからです。

一方で、ツイートやredditのコメント、tumblrの投稿、新聞のクラシファイド広告に「グラニースミス。これらのジューシーな緑のリンゴはアップルパイのフィリングに最適です。」とだけ書かれているとしたら、それはarticleです。なぜなら、それが全体だからです。

記事へのコメントは、コメントしているarticleの一部ではないため、それ自体が独立したarticleです。

4.4 コンテンツのグループ化

4.4.1 p 要素

Element/p

すべての現行エンジンでのサポート。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLParagraphElement

すべての現行エンジンでのサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
パルパブルコンテンツ.
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
text/html でのタグ省略:
p 要素の 終了タグ は、次の要素が p 要素の後に続く場合に省略できます address, article, aside, blockquote, details, div, dl, fieldset, figcaption, figure, footer, form, h1, h2, h3, h4, h5, h6, header, hgroup, hr, main, menu, nav, ol, p, pre, search, section, table, または ul 要素、または親要素に他のコンテンツがなく、親要素が HTML 要素 であり、次の要素でない場合 a, audio, del, ins, map, noscript, または video 要素、または 自律型カスタム要素。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLParagraphElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // also has obsolete members
 };

p 要素は 表します 段落。

段落は通常、隣接するブロックから空白行やインデントによって物理的に分離されたテキストブロックとして視覚メディアに表されますが、スタイルシートやユーザーエージェントは、段落の区切りを異なる方法で表示することもできます。たとえば、インラインピルクロウ (¶) を使用することもできます。

次の例は、適合する HTML フラグメントです:

<p>The little kitten gently seated herself on a piece of
carpet. Later in her life, this would be referred to as the time the
cat sat on the mat.</p>
<fieldset>
 <legend>Personal information</legend>
 <p>
   <label>Name: <input name="n"></label>
   <label><input name="anon" type="checkbox"> Hide from other users</label>
 </p>
 <p><label>Address: <textarea name="a"></textarea></label></p>
</fieldset>
<p>There was once an example from Femley,<br>
Whose markup was of dubious quality.<br>
The validator complained,<br>
So the author was pained,<br>
To move the error from the markup to the rhyming.</p>

p 要素は、より具体的な要素がより適切である場合には使用しないでください。

次の例は技術的には正しいです:

<section>
  <!-- ... -->
  <p>最終更新日: 2001-04-23</p>
  <p>著者: fred@example.com</p>
 </section>

ただし、次のようにマークアップする方が良いです:

<section>
  <!-- ... -->
  <footer>最終更新日: 2001-04-23</footer>
  <address>著者: fred@example.com</address>
 </section>

または:

<section>
  <!-- ... -->
  <footer>
   <p>最終更新日: 2001-04-23</p>
   <address>著者: fred@example.com</address>
  </footer>
 </section>

リスト要素（特に ol と ul 要素）は、p 要素の子要素になることはできません。そのため、文に箇条書きリストが含まれている場合、それをどのようにマークアップするかが問題になることがあります。

例えば、この素晴らしい文には次のような箇条書きがあります

さらに以下で説明されます。

解決策は、HTML の段落が論理的な概念ではなく、構造的な概念であることを認識することです。上記の素晴らしい例では、実際にはこの仕様で定義される 5つ の段落があります: リストの前に1つ、各箇条書きに1つ、リストの後に1つ。

上記の例のマークアップは次のようになります:

<p>例えば、この素晴らしい文には次のような箇条書きがあります</p>
 <ul>
  <li>ウィザード、
  <li>光速を超える旅行、そして
  <li>テレパシー、
 </ul>
 <p>さらに以下で説明されます。</p>

複数の「構造的」段落で構成される「論理的」段落を便利にスタイルしたい場合、div 要素を p 要素の代わりに使用できます。

例えば、上記の例は次のようにすることができます:

<div>例えば、この素晴らしい文には次のような箇条書きがあります
 <ul>
  <li>ウィザード、
  <li>光速を超える旅行、そして
  <li>テレパシー、
 </ul>
 さらに以下で説明されます。</div>

この例は依然として5つの構造的段落を持っていますが、著者は例の各部分を個別に考慮するのではなく、div 全体をスタイルすることができます。

4.4.2 hr 要素

Element/hr

すべての現行エンジンでのサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLHRElement

すべての現行エンジンでのサポート。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
この要素を使用できるコンテキスト:
フローコンテンツ が期待される場所。
select 要素の子要素として。
コンテンツモデル:
何も含まない。
text/html でのタグ省略:
終了タグ なし。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLHRElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // also has obsolete members
 };

hr 要素は 表します 段落レベルの主題の分割を、例えば物語のシーン変更や参考書のセクション内での話題の転換を。または、select 要素のオプションセット間の区切りを表します。

次の架空のプロジェクトマニュアルの抜粋には、セクション内でトピックを区切るために hr 要素が使用されている2つのセクションが示されています。 

<section>
  <h1>通信</h1>
  <p>コミュニケーションにはさまざまな方法があります。このセクションでは、プロジェクトで使用されている重要な方法のいくつかを紹介します。</p>
  <hr>
  <p>通信石はペアであるようで、神秘的な特性を持っています：</p>
  <ul>
   <li>単独で使用した場合、起動されると双方向に思考を転送できます。</li>
   <li>他のデバイスと一緒に使用した場合、自分の意識を別の体に転送できます。</li>
   <li>両方の石を他のデバイスと一緒に使用した場合、意識が体を交換します。</li>
  </ul>
  <hr>
  <p>無線機はメートル単位の電磁スペクトルを使用します。</p>
  <hr>
  <p>信号弾はナノメートル範囲の電磁スペクトルを使用します。</p>
 </section>
 <section>
  <h1>食物</h1>
  <p>プロジェクトのすべての食物は配給されています：</p>
  <dl>
   <dt>じゃがいも</dt>
   <dd>1日2個</dd>
   <dt>スープ</dt>
   <dd>1日1杯</dd>
  </dl>
  <hr>
  <p>料理はシェフが決められたローテーションで行います。</p>
 </section>

セクション間に hr 要素を配置する必要はありません、 なぜなら section 要素や h1 要素が主題の変化を意味するからです。

Peter F. Hamilton の Pandora's Star からの次の抜粋には、シーン変更の前の2つの段落とその後の段落が示されています。印刷された本では、シーン変更は2番目と3番目の段落の間に1つの孤立した中心に配置された星で表されていますが、ここでは hr 要素を使用して表されています。

<p>Dudley was ninety-two, in his second life, and fast approaching
 time for another rejuvenation. Despite his body having the physical
 age of a standard fifty-year-old, the prospect of a long degrading
 campaign within academia was one he regarded with dread. For a
 supposedly advanced civilization, the Intersolar Commonwealth could be
 appallingly backward at times, not to mention cruel.</p>
 <p><i>Maybe it won't be that bad</i>, he told himself. The lie was
 comforting enough to get him through the rest of the night's
 shift.</p>
 <hr>
 <p>The Carlton AllLander drove Dudley home just after dawn. Like the
 astronomer, the vehicle was old and worn, but perfectly capable of
 doing its job. It had a cheap diesel engine, common enough on a
 semi-frontier world like Gralmond, although its drive array was a
 thoroughly modern photoneural processor. With its high suspension and
 deep-tread tyres it could plough along the dirt track to the
 observatory in all weather and seasons, including the metre-deep snow
 of Gralmond's winters.</p>

hr 要素は、文書の アウトラインには影響しません。

4.4.3 pre 要素

Element/pre

すべての現行エンジンでのサポート。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLPreElement

すべての現行エンジンでのサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
パルパブルコンテンツ.
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ。
text/html でのタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLPreElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // also has obsolete members
 };

pre 要素は、整形済みテキストのブロックを表し、構造が要素ではなく印刷上の規則によって表されます。

HTML 構文では、pre 要素の開始タグに続く先頭の改行文字が取り除かれます。

pre 要素が使用されるケースの例:

著者は、フォーマットが失われた場合に整形済みテキストがどのように表示されるかを考慮することをお勧めします。これは、音声合成装置や点字ディスプレイなどのユーザーに当てはまります。ASCII アートのような場合には、テキストの説明など、より普遍的にアクセス可能な代替の表現が読者にとって望ましいでしょう。

コンピュータコードのブロックを表すには、pre 要素を code 要素と共に使用することができます。また、コンピュータ出力のブロックを表すには、pre 要素を samp 要素と共に使用することができます。同様に、kbd 要素を pre 要素内で使用して、ユーザーが入力するテキストを示すことができます。

この要素は双方向アルゴリズムに関するレンダリング要件を持ちます。

次のスニペットでは、コンピュータコードのサンプルが表示されています。

<p>これは <code>Panel</code> コンストラクタです:</p>
 <pre><code>function Panel(element, canClose, closeHandler) {
   this.element = element;
   this.canClose = canClose;
   this.closeHandler = function () { if (closeHandler) closeHandler() };
 }</code></pre>

次のスニペットでは、samp と kbd 要素が pre 要素内に混在して、Zork I のセッションが表示されています。

<pre><samp>You are in an open field west of a big white house with a boarded
 front door.
 There is a small mailbox here.
 
 ></samp> <kbd>open mailbox</kbd>
 
 <samp>Opening the mailbox reveals:
 A leaflet.
 
 ></samp></pre>

次の例では、pre 要素を使用してその異常なフォーマットを保持している現代詩が示されています。このフォーマットは詩自体の本質的な部分を形成します。

<pre>                maxling
 
 it is with a          heart
                heavy
 
 that i admit loss of a feline
         so           loved
 
 a friend lost to the
         unknown
                                 (night)
 
 ~cdr 11dec07</pre>

4.4.4 blockquote 要素

Element/blockquote

すべての現行エンジンでのサポート。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLQuoteElement

すべての現行エンジンでのサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
パルパブルコンテンツ.
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ。
text/html でのタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
cite — 引用の出典または編集に関する追加情報へのリンク
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
interface HTMLQuoteElement : HTMLElement {
[HTMLConstructor] constructor();

[CEReactions] attribute USVString cite;
};

HTMLQuoteElement インターフェイスは、q 要素にも使用されます。

blockquote 要素は、他のソースから引用されたセクションを表します。

blockquote 内のコンテンツは、他のソースからの引用である必要があり、そのアドレスがある場合は cite 属性で引用することができます。

cite 属性が存在する場合、それは 有効な URL (スペースで囲まれている可能性あり) でなければなりません。対応する引用リンクを取得するためには、その属性の値は要素の ノードドキュメント に対して 解析 されなければなりません。ユーザーエージェントは、そのような引用リンクをユーザーがたどることを許可する場合がありますが、これらは主にプライベートな使用（例: サイトの引用の使用に関する統計を収集するサーバー側のスクリプトなど）を目的としており、読者のためではありません。

blockquote の内容は、省略されるか、テキストの言語の慣習に従って文脈が追加されることがあります。

例えば、英語では伝統的に角括弧を使用します。次の文章を含むページを考えてみましょう。「Jane はクラッカーを食べた。そして彼女はリンゴと魚が好きだと言った。」これを次のように引用できます:

<blockquote>
<p>[Jane] then said she liked [...] fish.</p>
</blockquote>

引用の出典がある場合は、blockquote 要素の外に配置する必要があります。

例えば、ここでは引用の出典が引用の後の段落に与えられています:

<blockquote>
  <p>I contend that we are both atheists. I just believe in one fewer
  god than you do. When you understand why you dismiss all the other
  possible gods, you will understand why I dismiss yours.</p>
 </blockquote>
 <p>— Stephen Roberts</p>

以下の他の例は、出典を示す他の方法を示しています。

cite IDL 属性は、要素の cite コンテンツ属性を 反映する必要があります。

ここでは、blockquote 要素が figure 要素とその figcaption と共に使用され、引用をその出典に明確に関連付けています（これは引用の一部ではないため、blockquote 内には属しません）。 

<figure>
  <blockquote>
   <p>The truth may be puzzling. It may take some work to grapple with.
   It may be counterintuitive. It may contradict deeply held
   prejudices. It may not be consonant with what we desperately want to
   be true. But our preferences do not determine what's true. We have a
   method, and that method helps us to reach not absolute truth, only
   asymptotic approaches to the truth — never there, just closer
   and closer, always finding vast new oceans of undiscovered
   possibilities. Cleverly designed experiments are the key.</p>
  </blockquote>
  <figcaption>Carl Sagan, in "<cite>Wonder and Skepticism</cite>", from
  the <cite>Skeptical Inquirer</cite> Volume 19, Issue 1 (January-February
  1995)</figcaption>
 </figure>

次の例では、cite と blockquote の併用が示されています。

<p>His next piece was the aptly named <cite>Sonnet 130</cite>:</p>
 <blockquote cite="https://quotes.example.org/s/sonnet130.html">
   <p>My mistress' eyes are nothing like the sun,<br>
   Coral is far more red, than her lips red,<br>
   ...

この例では、フォーラムの投稿が blockquote を使用してユーザーがどの投稿に返信しているかを示す方法を示しています。article 要素はスレッド化をマークアップするために各投稿に使用されています。

<article>
  <h1><a href="https://bacon.example.com/?blog=109431">Bacon on a crowbar</a></h1>
  <article>
   <header><strong>t3yw</strong> 12 points 1 hour ago</header>
   <p>I bet a narwhal would love that.</p>
   <footer><a href="?pid=29578">permalink</a></footer>
   <article>
    <header><strong>greg</strong> 8 points 1 hour ago</header>
    <blockquote><p>I bet a narwhal would love that.</p></blockquote>
    <p>Dude narwhals don't eat bacon.</p>
    <footer><a href="?pid=29579">permalink</a></footer>
    <article>
     <header><strong>t3yw</strong> 15 points 1 hour ago</header>
     <blockquote>
      <blockquote><p>I bet a narwhal would love that.</p></blockquote>
      <p>Dude narwhals don't eat bacon.</p>
     </blockquote>
     <p>Next thing you'll be saying they don't get capes and wizard
     hats either!</p>
     <footer><a href="?pid=29580">permalink</a></footer>
     <article>
      <article>
       <header><strong>boing</strong> -5 points 1 hour ago</header>
       <p>narwhals are worse than ceiling cat</p>
       <footer><a href="?pid=29581">permalink</a></footer>
      </article>
     </article>
    </article>
   </article>
   <article>
    <header><strong>fred</strong> 1 points 23 minutes ago</header>
    <blockquote><p>I bet a narwhal would love that.</p></blockquote>
    <p>I bet they'd love to peel a banana too.</p>
    <footer><a href="?pid=29582">permalink</a></footer>
   </article>
  </article>
 </article>

次の例は、blockquote を使用した短いスニペットの使用を示しており、p 要素を blockquote 要素内に使用する必要がないことを示しています: 

<p>He began his list of "lessons" with the following:</p>
 <blockquote>One should never assume that his side of
 the issue will be recognized, let alone that it will
 be conceded to have merits.</blockquote>
 <p>He continued with a number of similar points, ending with:</p>
 <blockquote>Finally, one should be prepared for the threat
 of breakdown in negotiations at any given moment and not
 be cowed by the possibility.</blockquote>
 <p>We shall now discuss these points...

会話を表現する方法の例は後のセクションに示されています。この目的のために cite と blockquote 要素を使用するのは適切ではありません。

4.4.5 ol 要素

Element/ol

すべての現行エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLOListElement

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
要素の子に少なくとも1つのli要素が含まれている場合: 実質的コンテンツ。
この要素を使用できる文脈:
フローコンテンツが予期される場所。
コンテンツモデル:
ゼロ個以上のliおよびスクリプトサポート要素。
text/htmlでのタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
reversed — リストを逆順に番号付け
start — リストの開始値
type — リストマーカーの種類
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
[Exposed=Window]
interface HTMLOListElement : HTMLElement {
[HTMLConstructor] constructor();

[CEReactions] attribute boolean reversed;
[CEReactions] attribute long start;
[CEReactions] attribute DOMString type;

// 廃止されたメンバーも含まれます
};

ol要素は、アイテムが意図的に順序付けされており、その順序を変更するとドキュメントの意味が変わるようなリストを表します。

リストのアイテムは、li要素の子ノードであり、ol要素内でツリー順に配置されます。

Element/ol#attr-reversed

すべての最新のエンジンでサポートされています。

Firefox18+ Safari6+ Chrome18+
Opera? Edge79+
Edge (レガシー)≤79+ Internet Explorerサポートなし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

reversed属性はブール属性です。存在する場合、リストが降順（...、3、2、1）であることを示します。属性が省略されている場合、リストは昇順（1、2、3、...）になります。

start属性は、存在する場合、有効な整数でなければなりません。この属性はリストの開始値を決定するために使用されます。

ol要素には、次のようにして決定される整数の開始値があります。

  1. もしol要素にstart属性がある場合、

    1. parsedを、属性値を整数として解析した結果とする。

    2. parsedがエラーでない場合、parsedを返す。

  2. もしol要素にreversed属性がある場合、所有されているli要素の数を返す。

  3. 1を返す。

type属性は、リスト内のマーカーの種類を指定するために使用されます。これは、アイテムがその番号/文字によって参照されるなどの場合に重要です。属性が指定されている場合、その値は同一である必要があり、次の表の最初のセルの1つに与えられた文字のいずれかでなければなりません。type属性は、表の最初のセルに一致する行の2番目の列に与えられた状態を表します。セルが一致しない場合、または属性が省略された場合、属性は10進数状態を表します。

キーワード 状態 説明 値1-3および3999-4001の例
1(U+0031) 10進数 10進数 1. 2. 3. ... 3999. 4000. 4001. ...
a (U+0061) 小文字アルファベット 小文字ラテンアルファベット a. b. c. ... ewu. ewv. eww. ...
A (U+0041) 大文字アルファベット 大文字ラテンアルファベット A. B. C. ... EWU. EWV. EWW. ...
i (U+0069) 小文字ローマ数字 小文字ローマ数字 i. ii. iii. ... mmmcmxcix. i̅v̅. i̅v̅i. ...
I (U+0049) 大文字ローマ数字 大文字ローマ数字 I. II. III. ... MMMCMXCIX. I̅V̅. I̅V̅I. ...

ユーザーエージェントは、type属性の状態に一致する形式でリストのアイテムをレンダリングする必要があります。値が0以下の数値の場合、type属性に関係なく、常に10進数システムを使用する必要があります。

CSSユーザーエージェントの場合、この属性の'list-style-type'CSSプロパティへのマッピングは、レンダリングセクションで与えられます（マッピングは簡単です：上記の状態は対応するCSS値と同じ名前を持っています）。

この属性を実装するために使用されるデフォルトのCSSリストスタイルを再定義することが可能です。これにより、リストアイテムの表示方法が影響を受けます。

reversedおよびtypeIDL属性は、それぞれの同名のコンテンツ属性を反映する必要があります。

startIDL属性は、同名のコンテンツ属性を反映し、デフォルト値として1を持つ必要があります。

これにより、startIDL属性は、属性が省略されていてreversed属性が指定されている場合、必ずしもリストの開始値と一致するわけではありません。

次のマークアップは、順序が重要であり、ol要素が適切であるリストを示しています。このリストを、ul要素を使用した同様のアイテムの例と比較して、ul要素を使用する例を参照してください。

<p>I have lived in the following countries (given in the order of when I first lived there):</p>
 <ol>
  <li>Switzerland
  <li>United Kingdom
  <li>United States
  <li>Norway
 </ol>

リストの順序を変更すると、ドキュメントの意味がどのように変わるかに注目してください。次の例では、最初の2つのアイテムの相対的な順序を変更することで、著者の出生地が変わりました。

<p>I have lived in the following countries (given in the order of when I first lived there):</p>
 <ol>
  <li>United Kingdom
  <li>Switzerland
  <li>United States
  <li>Norway
 </ol>

4.4.6 ul 要素

Element/ul

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLUListElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
要素の子要素に少なくとも1つの li 要素が含まれている場合：明示的コンテンツ。
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
0個以上の li および スクリプトサポート要素。
text/html 内でのタグ省略:
タグはどちらも省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
    interface HTMLUListElement : HTMLElement {
      [HTMLConstructor] constructor();
    
      // 廃止されたメンバーもあります
    };

ul 要素は、アイテムの順序が重要ではないリスト、つまり順序を変更してもドキュメントの意味が大幅に変わらないリストを表します。

リストのアイテムは、li 要素の子ノードであり、ul 要素の子ノードです。

次のマークアップは、順序が重要でなく、ul 要素が適切であるリストを示しています。このリストを、同じアイテムを使用した ol セクションの同等のリストと比較してみてください。

<p>I have lived in the following countries:</p>
 <ul>
  <li>Norway
  <li>Switzerland
  <li>United Kingdom
  <li>United States
 </ul>

リストの順序を変更してもドキュメントの意味が変わらないことに注意してください。上記のスニペットではアイテムがアルファベット順に並んでいますが、以下のスニペットでは 2007 年の現在の口座残高に基づいて並んでおり、ドキュメントの意味がまったく変わりません:

<p>I have lived in the following countries:</p>
 <ul>
  <li>Switzerland
  <li>Norway
  <li>United Kingdom
  <li>United States
 </ul>

4.4.7 menu 要素

Element/menu

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLMenuElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
要素の子要素に少なくとも1つの li 要素が含まれている場合：明示的コンテンツ。
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
0個以上の li および スクリプトサポート要素。
text/html 内でのタグ省略:
タグはどちらも省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
interface HTMLMenuElement : HTMLElement {
  [HTMLConstructor] constructor();

  // 廃止されたメンバーもあります
};

menu 要素は、項目の順序付けされていないリスト（li 要素で表される）の形で、その内容で構成されるツールバーを表します。それぞれの項目は、ユーザーが実行または起動できるコマンドを表します。

menu 要素は、コマンドの順序付けされていないリスト（「ツールバー」）を表現するための、ul のセマンティックな代替にすぎません。

この例では、テキスト編集アプリケーションが menu 要素を使用して、一連の編集コマンドを提供しています:

<menu>
  <li><button onclick="copy()"><img src="copy.svg" alt="Copy"></button></li>
  <li><button onclick="cut()"><img src="cut.svg" alt="Cut"></button></li>
  <li><button onclick="paste()"><img src="paste.svg" alt="Paste"></button></li>
</menu>

従来のツールバーメニューのように見せるスタイリングは、アプリケーションの役割です。

4.4.8 li 要素

要素/li

全ての現行エンジンでのサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLLIElement

全ての現行エンジンでのサポート。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素を使用できるコンテキスト:
ol 要素内。
ul 要素内。
menu 要素内。
コンテンツモデル:
フローコンテンツ。
text/html におけるタグの省略:
次の li 要素が続くか、親要素にこれ以上コンテンツがない場合、終了タグ を省略できます。
コンテンツ属性:
グローバル属性
要素が ul または menu 要素の子でない場合: value — リストアイテムの 序数。
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLLIElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute long value;
 
   // 廃止されたメンバーも含まれます
 };

li 要素は、リスト項目を表します。親要素が ol、ul、または menu 要素である場合、リストアイテムはこれらの要素で定義される親要素のリストの項目となります。それ以外の場合、リストアイテムには他の li 要素とのリスト関連の関係は定義されていません。

属性 value が存在する場合、有効な整数でなければなりません。これは、リストアイテムの 序数 を決定するために使用されます。li の リストオーナー が ol 要素である場合。

任意の要素で、計算された値 の 'display' が 'list-item' であるものには、 以下の方法で決定される リストオーナー がいます。

  1. その要素が レンダリングされていない 場合、null を返します。その要素には リストオーナー がありません。

  2. その要素の親要素を ancestor とします。

  3. その要素が ol、 ul、または menu の祖先を持つ場合、ancestor を最も近いそのような祖先要素に設定します。

  4. ancestor の最も近い包括的な祖先で、CSS ボックス を生成する要素を返します。

    このような要素は常に存在します。少なくとも ドキュメント要素 は常に CSS ボックス を生成します。

特定の リストオーナー owner が所有する各要素の 序数 を決定するために、次の手順を実行します:

  1. i を 1 に設定します。

  2. owner が ol 要素である場合、numbering を owner の 開始値 に設定します。 それ以外の場合、numbering を 1 に設定します。

  3. ループ: i が オーナーが所有するリストアイテム の数を超える場合、終了します。すべての 所有されたリストアイテム に 序数 が割り当てられました。

  4. item を owner が所有する i 番目のリストアイテム に設定し、木の順序 に従います。

  5. item が li 要素であり、value 属性を持つ場合、次の手順を実行します。

    1. 属性の値を整数として解析する結果を parsed に設定します。

    2. parsed がエラーでない場合、numbering を parsed に設定します。

  6. item の 序数 は numbering です。

  7. owner が ol 要素であり、owner が 逆順 属性を持っている場合、numbering を 1 減らします。 それ以外の場合、numbering を 1 増やします。

  8. i を 1 増やします。

  9. ループ ラベルの付いたステップに戻ります。

value IDL 属性は value コンテンツ属性の値を反映しなければなりません。

要素の value IDL 属性は、その序数 に直接対応するものではなく、単にコンテンツ属性を反映します。例えば、このリストの場合:

<ol>
  <li>アイテム 1
  <li value="3">アイテム 3
  <li>アイテム 4
 </ol>

序数は 1、3、4 ですが、value IDL 属性の取得時の戻り値は 0、3、0 です。

次の例では、トップテン映画が（逆順で）リストされています。figure 要素とその figcaption 要素を使用して、リストにタイトルを付ける方法に注目してください。

<figure>
  <figcaption>史上最高の映画トップ 10</figcaption>
  <ol>
   <li value="10"><cite>ジョシーとプッシーキャッツ</cite>、2001</li>
   <li value="9"><cite lang="sh">Црна мачка, бели мачор</cite>、1998</li>
   <li value="8"><cite>バグズ・ライフ</cite>、1998</li>
   <li value="7"><cite>トイ・ストーリー</cite>、1995</li>、
   <li value="6"><cite>モンスターズ・インク</cite>、2001</li>、
   <li value="5"><cite>カーズ</cite>、2006</li>、
   <li value="4"><cite>トイ・ストーリー 2</cite>、1999</li>、
   <li value="3"><cite>ファインディング・ニモ</cite>、2003</li>、
   <li value="2"><cite>Mr.インクレディブル</cite>、2004</li>、
   <li value="1"><cite>レミーのおいしいレストラン</cite>、2007</li>、
  </ol>
 </figure>

また、逆順 属性を ol 要素に使用することで、以下のようにマークアップすることもできます。 

<figure>
  <figcaption>史上最高の映画トップ 10</figcaption>
  <ol reversed>
   <li><cite>ジョシーとプッシーキャッツ</cite>、2001</li>
   <li><cite lang="sh">Црна мачка, бели мачор</cite>、1998</li>
   <li><cite>バグズ・ライフ</cite>、1998</li>
   <li><cite>トイ・ストーリー</cite>、1995</li>
   <li><cite>モンスターズ・インク</cite>、2001</li>
   <li><cite>カーズ</cite>、2006</li>
   <li><cite>トイ・ストーリー 2</cite>、1999</li>
   <li><cite>ファインディング・ニモ</cite>、2003</li>
   <li><cite>Mr.インクレディブル</cite>、2004</li>
   <li><cite>レミーのおいしいレストラン</cite>、2007</li>
  </ol>
 </figure>

h1 要素などの見出し要素を li 要素内に含めることは適合していますが、著者が意図したセマンティクスを伝えていない可能性が高いです。見出しは新しいセクションの始まりを示すため、リスト内の見出しは暗黙的にリストを複数のセクションに分割します。

4.4.9 dl 要素

要素/dl

すべての現行エンジンでのサポート。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLDListElement

すべての現行エンジンでのサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
この要素の子要素に少なくとも 1 つの名前と値のペアが含まれている場合: 具体的コンテンツ。
この要素を使用できるコンテキスト:
フローコンテンツが予期される場所。
コンテンツモデル:
いずれか: 1 つ以上の dt 要素のグループと、1 つ以上の dd 要素のグループ。これらは、スクリプトサポート要素 と混在する場合があります。
または: 1 つ以上の div 要素と、スクリプトサポート要素 が混在する場合があります。
text/html におけるタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLDListElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // 廃止されたメンバーも含まれます
 };

dl 要素は、0 個以上の名前と値のペア（記述リスト）からなる関連リストを表します。名前と値のペアは、1 つ以上の名前（dt 要素、子要素としての div 要素を含む場合があります）と、それに続く 1 つ以上の値（dd 要素、子要素としての div 要素を含む場合があります）で構成されます。他のノードは無視され、dt 要素と dd 要素の子要素、および dt 要素と dd 要素が div 要素の子要素である場合にのみ考慮されます。1 つの dl 要素内には、1 つの名前に対して 1 つ以上の dt 要素が含まれてはなりません。

名前と値のペアは、用語と定義、メタデータのトピックと値、質問と回答、またはその他の名前と値のデータのグループである可能性があります。

グループ内の値は代替案です。同じ値の一部を構成する複数の段落は、すべて同じ dd 要素内に記載する必要があります。

グループのリスト、および各グループ内の名前と値の順序は、重要である場合があります。

グループに マイクロデータ 属性や他の グローバル属性 を適用して注釈を付けたり、単にスタイリングの目的で使用したりするために、dl 要素内の各グループを div 要素でラップすることができます。これにより、dl 要素のセマンティクスは変わりません。

dl 要素 dl の名前と値のペアは、次のアルゴリズムを使用して決定されます。名前と値のペアには名前（dt 要素のリスト、初期は空）と値（dd 要素のリスト、初期は空）があります。

  1. groups を名前と値のペアの空のリストに設定します。

  2. current を新しい名前と値のペアに設定します。

  3. seenDd を false に設定します。

  4. child を dl の 最初の子要素 に設定します。

  5. grandchild を null に設定します。

  6. child が null でない間:

    1. child が div 要素である場合、次の手順を実行します:

      1. grandchild を child の 最初の子要素 に設定します。

      2. grandchild が null でない間:

        1. プロセス dt または dd を grandchild に対して実行します。

        2. grandchild を grandchild の 次の兄弟 に設定します。

    2. それ以外の場合、プロセス dt または dd を child に対して実行します。

    3. child を child の 次の兄弟 に設定します。

  7. current が空でない場合、current を groups に追加します。

  8. groups を返します。

ノード node に対して dt または dd をプロセスする ための処理を行うことは、次の手順を意味します:

  1. groups、current、および seenDd を、これらの手順を呼び出したアルゴリズム内の同じ名前の変数と同じものに設定します。

  2. node が dt 要素である場合、次の手順を実行します。

    1. seenDd が true である場合、current を groups に追加し、current を新しい名前と値のペアに設定し、seenDd を false に設定します。

    2. node を current の名前に追加します。

  3. それ以外の場合、node が dd 要素である場合、node を current の値に追加し、seenDd を true に設定します。

名前と値のペアに空のリストが名前または値として含まれている場合、しばしば dd 要素が dt 要素の代わりに誤って使用されていることが原因です。適合性チェッカーはそのようなミスを検出し、著者に適切なマークアップの使用方法を助言することができるかもしれません。

次の例では、1 つのエントリ（「著者」）が 2 つの値（「ジョン」と「ルーク」）にリンクされています。

<dl>
  <dt> 著者
  <dd> ジョン
  <dd> ルーク
  <dt> 編集者
  <dd> フランク
 </dl>

次の例では、1 つの定義が 2 つの用語にリンクされています。

<dl>
  <dt lang="en-US"> <dfn>color</dfn> </dt>
  <dt lang="en-GB"> <dfn>colour</dfn> </dt>
  <dd> 人間の場合、視覚の細かな構造が 3 つの異なるフィルター分析を識別する能力に起因する感覚です。</dd>
 </dl>

次の例は、メタデータの一種をマークアップするために dl 要素を使用する例です。例の最後では、1 つのグループに 2 つのメタデータラベル（「著者」と「編集者」）と 2 つの値（「ロバート・ロスマン」と「ダニエル・ジャクソン」）が含まれています。この例では、スタイリングを補助するために div 要素も使用されています。 

<dl>
  <div>
   <dt> 最終更新日時 </dt>
   <dd> 2004-12-23T23:33Z </dd>
  </div>
  <div>
   <dt> 推奨更新間隔 </dt>
   <dd> 60s </dd>
  </div> 
  <div>
   <dt> 著者 </dt>
   <dt> 編集者 </dt>
   <dd> ロバート・ロスマン </dd>
   <dd> ダニエル・ジャクソン </dd>
  </div>
 </dl>

次の例では、手順を提示するために dl 要素が使用されています。 ここでは手順の順序が重要です（他の例では、ブロックの順序は重要ではありませんでした）。

<p>次のようにして勝利ポイントを決定します（最初に一致するケースを使用します）：</p>
 <dl>
  <dt> ちょうど5つの金貨がある場合 </dt>
  <dd> 5つの勝利ポイントを獲得します </dd>
  <dt> 1つ以上の金貨があり、1つ以上の銀貨がある場合 </dt>
  <dd> 2つの勝利ポイントを獲得します </dd> 
  </dt> 1つ以上の銀貨がある場合 </dt> 
  <dd> 1つの勝利ポイントを獲得します </dd> 
  </dt> その他の場合 </dt> 
  <dd> 勝利ポイントは獲得できません </dd> 
 </dl>

次のスニペットでは、dl 要素が用語集として使用されています。定義されている単語を示すための dfn の使用に注目してください。

<dl>
  <dt><dfn>アパートメント</dfn>、n.</dt>
  <dd>1つ以上のスレッドと1つ以上のCOMオブジェクトをグループ化する実行コンテキスト。</dd>
  <dt><dfn>フラット</dfn>、n.</dt>
  <dd>空気の抜けたタイヤ。</dd>
  <dt><dfn>ホーム</dfn>、n.</dt>
  <dd>ユーザーのログインディレクトリ。</dd>
 </dl>

この例では、マイクロデータ 属性を使用して、dl 要素と div 要素を使用してフランスのレストランのアイスクリームデザートに注釈を付けています。 

<dl>
  <div itemscope itemtype="http://schema.org/Product">
   <dt itemprop="name">カフェまたはチョコレート・リエジョワ
   <dd itemprop="offers" itemscope itemtype="http://schema.org/Offer">
    <span itemprop="price">3.50</span>
    <data itemprop="priceCurrency" value="EUR">€</data>
   <dd itemprop="description">
    2つのカフェまたはチョコレートボール、1つのバニラボール、カフェまたはチョコレートソース、ホイップクリーム
  </div>
 
  <div itemscope itemtype="http://schema.org/Product">
   <dt itemprop="name">アメリカン
   <dd itemprop="offers" itemscope itemtype="http://schema.org/Offer">
    <span itemprop="price">3.50</span>
    <data itemprop="priceCurrency" value="EUR">€</data> 
   <dd itemprop="description">
    1つのクレームブリュレボール、1つのバニラボール、1つのキャラメルボール、ホイップクリーム
  </div>
 </dl>

div 要素がない場合、次のように itemref 属性を使用して、dd 要素のデータをアイテムとリンクする必要があります。

<dl>
  <dt itemscope itemtype="http://schema.org/Product" itemref="1-offer 1-description">
   <span itemprop="name">カフェまたはチョコレート・リエジョワ</span>
  <dd id="1-offer" itemprop="offers" itemscope itemtype="http://schema.org/Offer">
   <span itemprop="price">3.50</span>
   </data itemprop="priceCurrency" value="EUR">€</data> 
  </dd id="1-description" itemprop="description">
   2つのカフェまたはチョコレートボール、1つのバニラボール、カフェまたはチョコレートソース、ホイップクリーム
 
  </dt itemscope itemtype="http://schema.org/Product" itemref="2-offer 2-description">
   <span itemprop="name">アメリカン</span>
  <dd id="2-offer" itemprop="offers" itemscope itemtype="http://schema.org/Offer">
   <span itemprop="price">3.50</span>
   </data itemprop="priceCurrency" value="EUR">€</data> 
  </dd id="2-description" itemprop="description">
   1つのクレームブリュレボール、1つのバニラボール、1つのキャラメルボール、ホイップクリーム
 </dl>

dl 要素は、対話をマークアップするためには適していません。対話のマークアップ方法の例をご覧ください。

4.4.10 dt要素

Element/dt

すべての現在のエンジンでサポートされています。

Firefox1+ Safari4+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
カテゴリー:
なし。
使用できるコンテキスト:
dl要素内のddまたはdt要素の前。
dl要素の子であるdiv要素内のddまたはdt要素の前。
コンテンツモデル:
フローコンテンツ、ただし、header、footer、セクショニングコンテンツまたは見出しコンテンツの子孫を持たないこと。
text/htmlでのタグ省略:
dt要素の終了タグは、次に別のdt要素またはdd要素が続く場合に省略可能です。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用。

dt要素は、説明リスト（dl要素）の用語説明グループの用語または名前部分を表します。

dt要素自体は、dl要素内で使用されるとき、その内容が定義されている用語であることを示しませんが、これはdfn要素を使用して示すことができます。

次の例は、質問にはdt要素を、回答にはdd要素を使用してFAQをマークアップしたものです。

<article>
  <h1>FAQ</h1>
  <dl>
   <dt>What do we want?</dt>
   <dd>Our data.</dd>
   <dt>When do we want it?</dt>
   <dd>Now.</dd>
   <dt>Where is it?</dt>
   <dd>We are not sure.</dd>
  </dl>
 </article>

4.4.11 dd要素

Element/dd

すべての現在のエンジンでサポートされています。

Firefox1+ Safari4+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android4+ Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
カテゴリー:
なし。
使用できるコンテキスト:
dl要素内のdtまたはdd要素の後。
dl要素の子であるdiv要素内のdtまたはdd要素の後。
コンテンツモデル:
フローコンテンツ。
text/htmlでのタグ省略:
dd要素の終了タグは、次に別のdd要素またはdt要素が続く場合、または親要素にこれ以上コンテンツがない場合に省略可能です。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用。

dd要素は、説明リスト（dl要素）の用語説明グループの説明、定義、または値の部分を表します。

dlは、辞書のように語彙リストを定義するために使用できます。次の例では、dtとdfnで与えられた各エントリに、さまざまな定義の部分を示すいくつかのddがあります。

<dl>
  <dt><dfn>happiness</dfn></dt>
  <dd class="pronunciation">/ˈhæpinəs/</dd>
  <dd class="part-of-speech"><i><abbr>n.</abbr></i></dd>
  <dd>The state of being happy.</dd>
  <dd>Good fortune; success. <q>Oh <b>happiness</b>! It worked!</q></dd>
  <dt><dfn>rejoice</dfn></dt>
  <dd class="pronunciation">/rɪˈdʒɔɪs/</dd>
  <dd><i class="part-of-speech"><abbr>v.intr.</abbr></i> To be delighted oneself.</dd>
  <dd><i class="part-of-speech"><abbr>v.tr.</abbr></i> To cause one to be delighted.</dd>
 </dl>

4.4.12 figure要素

Element/figure

すべての現在のエンジンでサポートされています。

Firefox4+ Safari5.1+ Chrome8+
Opera11+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11+
カテゴリー:
フローコンテンツ。
可感知コンテンツ。
使用できるコンテキスト:
フローコンテンツが予想される場所。
コンテンツモデル:
次のいずれか: figcaption要素の後にフローコンテンツ。
または: フローコンテンツの後にfigcaption要素。
または: フローコンテンツ。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用。

figure要素は、オプションでキャプションを付けたフローコンテンツを表します。これは独立した内容で（完全な文のように）、通常はドキュメントの主要な流れから単一の単位として参照されます。

この文脈で「独立した」とは、必ずしも独立した存在を意味するわけではありません。たとえば、段落内の各文は独立していますが、文の一部である画像はfigureに適していませんが、画像で構成された完全な文は適しているといえます。

この要素は、イラスト、図、写真、コードリストなどを注釈するために使用できます。

figureがキャプション（たとえば図の番号）によって識別され、ドキュメントの主要なコンテンツから参照されている場合、こうしたコンテンツをページの横、専用ページ、または付録に移動させても、ドキュメントの流れに影響を与えずに済むようになります。

figure要素が相対的な位置（たとえば「上の写真」や「次の図が示すように」など）で参照されている場合、そのfigureを移動させるとページの意味が乱れてしまいます。著者は、ページが簡単に再スタイル化されてもページの意味が影響を受けないように、相対参照の代わりにラベルを使用してfigureを参照することを検討することをお勧めします。

最初のfigcaption要素の子要素がある場合は、そのfigure要素の内容のキャプションを表します。子figcaption要素がない場合、キャプションは存在しません。

figure要素の内容は、周囲の流れの一部です。たとえば、画像共有サイトで写真を表示することがページの目的である場合、figureとfigcaption要素を使用して、そのfigureにキャプションを明示的に提供できます。周囲の流れにわずかに関連するコンテンツや別の目的を果たすコンテンツの場合は、aside要素を使用するべきです（figureを包むこともできます）。たとえば、記事からのコンテンツを繰り返す引用が、読者を引き付けるためや重要なトピックを強調するために、figureよりもasideに適しているでしょう。

この例では、コードリストをマークアップするためにfigure要素を使用しています。

<p> <a href ="#l4">リスト4</a>で、主なコアインターフェースAPI宣言を確認できます。</p> 
<figure id="l4"> 
  <figcaption>リスト4. 主なコアインターフェースAPI宣言。</figcaption> 
  <pre><code>interface PrimaryCore {
  boolean verifyDataLine();
  undefined sendData(sequence&lt;byte> data);
  undefined initSelfDestruct();
}</code></pre> 
</figure> 
<p>APIはUTF-8を使用するように設計されています。</p>

ここでは、ページの主要なコンテンツとしてマークアップされたfigure要素を使用して、写真をマークアップしています（ギャラリーのように）。 

<!DOCTYPE HTML> 
<html lang="en"> 
<title>Bubbles at work — My Gallery™</title> 
<figure> 
  <img src="bubbles-work.jpeg" 
       alt="Bubbles, sitting in his office chair, works on his" 
            latest project intently."> 
  <figcaption>Bubbles at work</figcaption> 
</figure> 
<nav><a href="19414.html">前</a> — <a href="19416.html">次</a></nav>

この例では、figureではない画像と、figureである画像とビデオを示しています。最初の画像は、この例の2番目の文の一部であり、独立したユニットではないため、figureには不適切です。

<h2>Malinko's comics</h2> 
<p>この事件は、ある種の「知的財産」侵害に関するもので、漫画に関連しています（エキシビットAを参照）。訴訟は次の言葉で終わるトレーラーが公開された後に始まりました： 
<blockquote> 
<img src="promblem-packed-action.png" alt="ROUGH COPY! Promblem-Packed Action!"> 
</blockquote> 
<p>...が放送されました。弁護士が大きなノートを持って先制攻撃を開始しました。このトレーラーの完全なコピーはエキシビットBに含まれています。 
<figure> 
<img src="ex-a.png" alt="汚れた紙に描かれた2つの落書きのようなもの。"> 
<figcaption>エキシビットA. 主張された<cite>粗いコピー</cite>の漫画。</figcaption> 
</figure> 
<figure> 
<video src="ex-b.mov"></video> 
<figcaption>エキシビットB. <cite>粗いコピー</cite>のトレーラー。</figcaption> 
</figure> 
<p>訴訟は法廷外で解決されました。

この例では、詩の一部をfigureを使用してマークアップしています。 

<figure> 
<p>'Twas brillig, and the slithy toves<br> 
Did gyre and gimble in the wabe;<br> 
All mimsy were the borogoves,<br> 
And the mome raths outgrabe.</p> 
<figcaption><cite>ジャバウォックィ</cite>（第1詩）。ルイス・キャロル、1832-98</figcaption> 
</figure>

この例では、城に関するはるかに大きな作品の一部である可能性がある部分において、ネストされたfigure要素を使用して、グループキャプションと、グループ内の各figureに対する個別のキャプションの両方を提供しています: 

<figure> 
<figcaption>時代を超えての城: 1423年、1858年、そして1999年の順に。</figcaption> 
<figure> 
<figcaption>エッチング。匿名、約1423年。</figcaption> 
<img src="castle1423.jpeg" alt="城には1つの塔があり、高い壁に囲まれています。"> 
</figure> 
<figure> 
<figcaption>油絵。マリア・トウル、1858年。</figcaption> 
<img src="castle1858.jpeg" alt="城には現在2つの塔と2つの壁があります。"> 
</figure> 
<figure> 
<figcaption>フィルム写真。ピーター・ジャンクル、1999年。</figcaption> 
<img src="castle1999.jpeg" alt="城は廃墟となり、元の塔だけが一体化しています。"> 
</figure> 
</figure>

前の例は、ネストされたfigure/figcaptionペアの代わりにtitle属性を使用して、より簡潔に書くことができます: 

<figure> 
<img src="castle1423.jpeg" title="エッチング。匿名、約1423年。" alt="城には1つの塔があり、高い壁に囲まれています。"> 
<img src="castle1858.jpeg" title="油絵。マリア・トウル、1858年。" alt="城には現在2つの塔と2つの壁があります。"> 
<img src="castle1999.jpeg" title="フィルム写真。ピーター・ジャンクル、1999年。" alt="城は廃墟となり、元の塔だけが一体化しています。"> 
<figcaption>時代を超えての城: 1423年、1858年、そして1999年の順に。</figcaption> 
</figure>

figureは、コンテンツから暗黙的に参照される場合もあります:

<article> 
<h1>議会での財政交渉が行き詰まり、締め切りが迫る</h1> 
<figure> 
<img src="obama-reid.jpeg" alt="オバマとリードがオーバルオフィスで笑顔で座っています。"> 
<figcaption>バラク・オバマとハリー・リード。ホワイトハウスの報道写真。</figcaption> 
</figure> 
<p>火曜日、議会での財政行き詰まりを終わらせるための交渉が失速し、両院は政府を再開し、国の借入権限を引き上げる方法を模索していましたが、木曜日の締め切りが迫っていました。</p> 
... 
</article>

4.4.13 figcaption 要素

Element/figcaption

全ての現行エンジンでサポートされています。

Firefox4+Safari5.1+Chrome8+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+
カテゴリ:
なし。
この要素が使用できる文脈:
figure要素の最初または最後の子要素として。
内容モデル:
フローコンテンツ。
text/html内でのタグ省略:
どちらのタグも省略可能ではありません。
内容属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用します。

figcaption要素は、親figure要素の残りの内容を説明するキャプションまたは凡例を表します。

この要素には、ソースに関する追加情報を含めることができます:

<figcaption>
<p>アヒル。</p>
<p><small>写真提供: 🌟 ニュース</small></p>
</figcaption>
<figcaption>
<p>3部屋のアパートの平均家賃（非営利アパートを除く）</p>
<p>チューリッヒ統計局 — <time datetime=2017-11-14>2017年11月14日</time></p>
</figcaption>

4.4.14 main要素

Element/main

すべての現在のエンジンでサポートされています。

Firefox21+Safari7+Chrome26+
Opera16+Edge79+
Edge (Legacy)12+Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
有形コンテンツ。
この要素が使用できるコンテキスト:
フローコンテンツが期待される場所。ただし、それが階層的に正しいmain要素である場合に限ります。
コンテンツモデル:
フローコンテンツ。
text/html でのタグ省略:
どちらのタグも省略できません。
内容属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用します。

main 要素は、文書の主要な内容を表します。

文書には、main 要素が1つ以上あってはなりません。ただし、hidden属性が指定されていない場合に限ります。

階層的に正しい main 要素 とは、祖先要素が html、body、div、formに限られる要素です。また、アクセシブルな名前がない場合、および独立カスタム要素も含まれます。各main要素は、階層的に正しい main 要素でなければなりません。

この例では、ページの各コンポーネントがボックスでレンダリングされるプレゼンテーションを使用しています。ページのメインコンテンツ（ヘッダー、フッター、ナビゲーションバー、サイドバー以外の部分）をラップするために、main要素が使用されています。

<!DOCTYPE html>
<html lang="en">
<title>RPG System 17</title>
<style>
 header, nav, aside, main, footer {
   margin: 0.5em; border: thin solid; padding: 0.5em;
   background: #EFF; color: black; box-shadow: 0 0 0.25em #033;
 }
 h1, h2, p { margin: 0; }
 nav, main { float: left; }
 aside { float: right; }
 footer { clear: both; }
</style>
<header>
 <h1>System Eighteen</h1>
</header>
<nav>
 <a href="../16/">← System 17</a>
 <a href="../18/">RPXIX →</a>
</nav>
<aside>
 <p>This system has no HP mechanic, so there's no healing.
</aside>
<main>
 <h2>Character creation</h2>
 <p>Attributes (magic, strength, agility) are purchased at the cost of one point per level.</p>
 <h2>Rolls</h2>
 <p>Each encounter, roll the dice for all your skills. If you roll more than the opponent, you win.</p>
</main>
</footer>
 <p>Copyright © 2013
</footer>
</html>

次の例では、複数のmain要素が使用され、スクリプトが使用されてナビゲーションがサーバーラウンドトリップなしで機能し、現在のもの以外にはhidden属性が設定されます：

<!doctype html>
<html lang=en-CA>
<meta charset=utf-8>
<title> … </title>
<link rel=stylesheet href=spa.css>
<script src=spa.js async></script>
<nav>
 <a href=/>Home</a>
 <a href=/about>About</a>
 <a href=/contact>Contact</a>
</nav>
<main>
 <h1>Home</h1>
 …
</main>
<main hidden>
 <h1>About</h1>
 …
</main>
<main hidden>
 <h1>Contact</h1>
 …
</main>
</footer>Made with ❤️ by <a href=https://example.com/>Example 👻</a>.</footer>

4.4.15 search要素

要素/search

現在のエンジンではサポートされていません。

FirefoxいいえSafariいいえChromeいいえ
OperaいいえEdgeいいえ
Edge (Legacy)いいえInternet Explorerいいえ
Firefox Android？Safari iOS？Chrome AndroidいいえWebView Android？Samsung Internet？Opera Android？
カテゴリ:
フローコンテンツ.
触知可能なコンテンツ.
使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ.
タグの省略:
タグを省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOMインターフェース:
HTMLElementを使用します。

search要素は、検索やフィルタリング操作に関連するフォームコントロールやその他のコンテンツを含む文書やアプリケーションの一部を表します。これには、ウェブサイトやアプリケーションの検索、現在のウェブページの検索結果の検索やフィルタリング、またはインターネット全体やその一部に対する検索機能が含まれる場合があります。

search要素は、検索結果を提示するためだけに使用するのは適切ではありませんが、「クイック検索」結果の一部として提案やリンクを含めることができます。代わりに、検索結果のウェブページはそのウェブページの主なコンテンツの一部として提示されることが期待されます。

次の例では、著者がウェブページのheader内に検索フォームを含めています： 

<header>
   <h1><a href="/">My fancy blog</a></h1>
   ...
   <search>
     <form action="search.php">
       <label for="query">Find an article</label>
       <input id="query" name="q" type="search">
       <button type="submit">Go!</button>
     </form>
   </search>
 </header>

この例では、著者がウェブアプリケーションの検索機能を完全にJavaScriptで実装しています。サーバー側の送信を行うためにform要素は使用されていませんが、含まれているsearch要素が子孫コンテンツの目的を検索機能として意味的に識別しています。 

<search>
   <label>
     Find and filter your query
     <input type="search" id="query">
   </label>
   <label>
     <input type="checkbox" id="exact-only">
     Exact matches only
   </label>
 
   <section>
     <h3>Results found:</h3>
     <ul id="results">
       <li>
         <p><a href="services/consulting">Consulting services</a></p>
         <p>
           Find out how can we help you improve your business with our integrated consultants, Bob and Bob.
         </p>
       </li>
       ...
     </ul>
     <!--
       when a query returns or filters out all results
       render the no results message here
     -->
     <output id="no-results"></output>
   </section>
 </search>

次の例では、ページに2つの検索機能があります。最初の機能はウェブページのheaderにあり、ウェブサイトの内容を検索するためのグローバルメカニズムとして機能します。その目的は指定されたtitle属性によって示されています。2つ目はページの主なコンテンツの一部として含まれており、現在のページの内容を検索およびフィルタリングするためのメカニズムを表しています。目的を示す見出しを含んでいます。 

<body>
   <header>
     ...
     <search title="Website">
       ...
     </search>
   </header>
   <main>
     <h1>Hotels near your location</h1>
      <search>
        <h2>Filter results</h2>
        ...
      </search>
      <article>
       <!-- search result content -->
     </article>
   </main>
 </body>

4.4.16 div要素

要素/div

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera？Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

HTMLDivElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android？Safari iOS1+Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+
カテゴリ:
フローコンテンツ.
触知可能なコンテンツ.
使用できるコンテキスト:
フローコンテンツが期待される場所。
dl要素の子として。
コンテンツモデル:
要素がdl要素の子の場合: 1つ以上の dt要素に続いて1つ以上の dd要素が含まれ、オプションでスクリプトサポート要素が含まれることがあります。
要素がdl要素の子でない場合: フローコンテンツ。
タグの省略:
タグを省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOMインターフェース: 
[Exposed=Window]
interface HTMLDivElement : HTMLElement {
  [HTMLConstructor] constructor();

   // 廃止されたメンバーも含まれています
 };

div要素には特別な意味はありません。要素は子要素を表現します。連続した要素のグループに共通のセマンティクスをマークアップするために、class、lang、およびtitle属性と一緒に使用できます。また、dl要素内で使用し、dtおよびdd要素のグループをラップするために使用できます。

著者には、div要素を最後の手段として使用することを強くお勧めします。div要素の代わりにより適切な要素を使用すると、読者にとってのアクセシビリティが向上し、著者にとってのメンテナンスが容易になります。

たとえば、ブログ記事はarticleでマークアップし、章はsectionでマークアップし、ページのナビゲーション補助はnavでマークアップし、フォームコントロールのグループはfieldsetでマークアップします。

一方、div要素は、スタイル目的で、または同じ方法で注釈を付ける複数の段落をセクション内でラップするために便利です。以下の例では、2つの段落の言語を一度に設定する方法としてdiv要素を使用しており、2つの段落要素に個別に言語を設定する代わりに、div要素内でまとめています: 

<article lang="en-US">
  <h1>My use of language and my cats</h1>
  <p>My cat's behavior hasn't changed much since her absence, except
  that she plays her new physique to the neighbors regularly, in an
  attempt to get pets.</p>
  <div lang="en-GB">
   <p>My other cat, coloured black and white, is a sweetie. He followed
   us to the pool today, walking down the pavement with us. Yesterday
   he apparently visited our neighbours. I wonder if he recognises that
   their flat is a mirror image of ours.</p>
   <p>Hm, I just noticed that in the last paragraph I used British
   English. But I'm supposed to write in American English. So I
   shouldn't say "pavement" or "flat" or "colour"...</p>
  </div>
  <p>I should say "sidewalk" and "apartment" and "color"!</p>
 </article>

4.5 テキストレベルのセマンティクス

4.5.1 a要素

要素/a

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera？Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

HTMLAnchorElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
要素がhref属性を持つ場合: インタラクティブコンテンツ.
触知可能なコンテンツ.
使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
透過的ですが、インタラクティブコンテンツの子孫、 a要素の子孫、またはtabindex属性を指定された子孫が含まれていてはいけません。
タグの省略:
タグを省略できません。
コンテンツ属性:
グローバル属性
href — ハイパーリンクのアドレス
target — ナビゲーブルによるハイパーリンク ナビゲーション
download — リソースをナビゲートする代わりにダウンロードするかどうか、およびその場合のファイル名
ping — pingするURL
rel — ハイパーリンクを含む場所とリソースの間の関係
hreflang — リンク先リソースの言語
type — リンク先リソースの種類を示すヒント
referrerpolicy — 要素によって開始されるフェッチの参照ポリシー
アクセシビリティの考慮事項:
要素がhref属性を持つ場合: 著者向け; 実装者向け.
それ以外の場合: 著者向け; 実装者向け.
DOMインターフェース: 
[Exposed=Window]
 interface HTMLAnchorElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString target;
   [CEReactions] attribute DOMString download;
   [CEReactions] attribute USVString ping;
   [CEReactions] attribute DOMString rel;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList relList;
   [CEReactions] attribute DOMString hreflang;
   [CEReactions] attribute DOMString type;
 
   [CEReactions] attribute DOMString text;
 
   [CEReactions] attribute DOMString referrerPolicy;
 
   // also has obsolete members
 };
 HTMLAnchorElement includes HTMLHyperlinkElementUtils;

要素がa要素であり、href属性を持つ場合、 その要素はハイパーリンク（ハイパーテキストアンカー）をその内容でラベル付けします。

要素がa要素であり、href属性を持たない場合、 その要素はプレースホルダーとして機能し、関連性がある場合にリンクが置かれる可能性がある場所を表します。これは、要素の内容のみで構成されます。

target、 download、 ping、 rel、hreflang、 type、 およびreferrerpolicy 属性は、href属性が存在しない場合、省略する必要があります。

要素にitemprop属性が指定されている場合、そのa要素にはhref属性も指定されている必要があります。

サイトが全ページで一貫したナビゲーションツールバーを使用している場合、そのページ自体にリンクする通常のリンクはa要素でマークアップできます:

<nav>
<ul>
<li> <a href="/">ホーム</a> </li>
<li> <a href="/news">ニュース</a> </li>
<li> <a>例</a> </li>
<li> <a href="/legal">法的情報</a> </li>
</ul>
</nav>

href、target、download、 ping、 およびreferrerpolicy 属性は、ユーザーがハイパーリンクを辿るまたはハイパーリンクをダウンロードする際の動作に影響します。rel、 hreflang、 およびtype 属性は、ユーザーがリンクを辿る前にリンク先リソースの性質を示すために使用できます。

a.text

textContentと同じです。

HTMLAnchorElement/download

すべての現在のエンジンでサポートされています。

Firefox20+Safari10.1+Chrome15+
Opera？Edge79+
Edge (Legacy)13+Internet Explorerいいえ
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

HTMLAnchorElement/rel

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+

IDL属性download、ping、target、rel、hreflang、およびtypeは、同名のコンテンツ属性を反映する必要があります。

HTMLAnchorElement/relList

すべての現在のエンジンでサポートされています。

Firefox30+Safari9+Chrome65+
Opera？Edge79+
Edge (Legacy)18Internet Explorerいいえ
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

IDL属性relListは、relコンテンツ属性を反映する必要があります。

HTMLAnchorElement/referrerPolicy

すべての現在のエンジンでサポートされています。

Firefox50+Safari14+Chrome52+
Opera？Edge79+
Edge (Legacy)？Internet Explorerいいえ
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

IDL属性referrerPolicyは、referrerpolicyコンテンツ属性を反映する必要があり、既知の値のみが許可されます。

属性のゲッターtext は、この要素の子孫テキストコンテンツを返す必要があります。

属性のセッターtextは、与えられた値で文字列をすべて置換する必要があります。

a要素は、段落全体、リスト、テーブル、さらにはセクション全体を囲むことができます。ただし、内部にインタラクティブコンテンツ（例：ボタンや他のリンク）がない場合に限ります。この例は、全広告ブロックをリンクにする方法を示しています: 

<aside class="advertising">
<h1>広告</h1>
<a href="https://ad.example.com/?adid=1929&amp;pubid=1422">
<section>
<h1>Mellblomatic 9000!</h1>
<p>すべてのウィジェットをメルブロムに変えましょう!</p>
<p>9.99ドル、送料と手数料別</p>
</section>
</a>
<a href="https://ad.example.com/?adid=375&amp;pubid=1422">
<section>
<h1>メルブロムブラウザー</h1>
<p>光の速さでウェブ閲覧が可能。</p>
</p>他のブラウザはこれほど速くありません！</p>
</section>
</a>
</aside>

次の例は、スクリプトを使用してジョブリストのテーブル内の行全体を効果的にリンクにする方法を示しています:

<table>
<tr>
<th>職位
<th>チーム
<th>場所
</tr>
<tr>
<td><a href="/jobs/manager">マネージャー</a>
<td>Remotees
<td>リモート
</tr>
<td><a href="/jobs/director">ディレクター</a>
<td>Remotees
<td>リモート
</tr>
<td><a href="/jobs/astronaut">宇宙飛行士</a>
<td>建築
<td>リモート
</table>
<script>
document.querySelector("table").onclick = ({ target }) => {
if (target.parentElement.localName === "tr") {
const link = target.parentElement.querySelector("a");
if (link) {
link.click();
}
}
}
</script>

4.5.2 em要素

Element/em

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ。
テキスト/HTML内でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

em要素は、その内容のストレス強調を表します。

特定のコンテンツのストレスレベルは、その祖先em要素の数によって決まります。

ストレス強調の位置によって文の意味が変わります。この要素はコンテンツの不可欠な部分を形成します。このようにストレスが使用される正確な方法は言語によって異なります。

これらの例は、ストレス強調の変更が意味をどのように変えるかを示しています。まず、ストレスのない一般的な事実の表明:

<p>猫はかわいい動物です。</p>

最初の単語を強調することで、議論されている動物の種類が問題になっていることを示唆しています（おそらく誰かが犬がかわいいと主張しているかもしれません）:

<p><em>猫</em>はかわいい動物です。</p>

動詞にストレスを移すことで、文全体の真実が問題になっていることを強調します（おそらく誰かが猫はかわいくないと言っているかもしれません）:

<p>猫は<em>かわいいです</em>動物です。</p>

形容詞にストレスを移すことで、猫の正確な性質が再確認されます（おそらく誰かが猫は意地悪な動物だと提案したかもしれません）:

<p>猫は<em>かわいい</em>動物です。</p>

同様に、誰かが猫が野菜だと主張した場合、これを訂正するために最後の単語を強調するかもしれません:

<p>猫はかわいい<em>動物</em>です。</p>

文全体を強調することで、話者がこのポイントを強く伝えようとしていることが明らかになります。この種のストレス強調は通常、句読点にも影響を与えるため、ここでは感嘆符が使用されています。

<p><em>猫はかわいい動物です！</em></p>

怒りとかわいさの強調を混ぜると、次のようなマークアップが使用されることがあります:

<p><em>猫は</em>かわいい</em>動物です！</p>

em要素は、一般的な "イタリック" 要素ではありません。時には、テキストが段落の他の部分から目立つようにすることを意図している場合があります。このような場合は、i要素がより適切です。

em要素も重要性を伝えるために意図されているわけではありません。その目的には、 strong要素の方が適切です。

4.5.3 strong 要素

Element/strong

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ。
テキスト/HTML内でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

strong要素は、その内容に強い重要性、真剣さ、または緊急性を示します。

重要性: strong要素は、見出し、キャプション、または段落内で、他の部分よりも重要な部分を区別するために使用できます（これは、サブヘッディングをマークアップするために適したhgroup要素とは異なります）。

たとえば、前の段落の最初の単語は、strongでマークアップされ、段落の他の詳細なテキストと区別されています。

真剣さ: strong要素は、警告や注意の通知をマークアップするために使用できます。

緊急性: strong要素は、ドキュメントの他の部分よりもユーザーが早く見る必要がある内容を示すために使用できます。

コンテンツの相対的な重要度は、その祖先strong要素の数によって決まります。各strong要素は、その内容の重要性を高めます。

strong要素でテキストの重要性を変更しても、文の意味は変わりません。

ここでは、「chapter」という言葉と実際の章番号は単なる決まり文句であり、実際の章の名前はstrongでマークアップされています: 

<h1>Chapter 1: <strong>The Praxis</strong></h1>

次の例では、キャプション内の図の名前がstrongでマークアップされており、決まり文句のテキスト（前）と説明（後）と区別されています: 

<figcaption>Figure 1. <strong>Ant colony dynamics</strong>. The ants in this colony are
affected by the heat source (upper left) and the food source (lower right).</figcaption>

次の例では、見出しは実際には「Flowers, Bees, and Honey」ですが、著者は見出しに軽いユーモアを追加しています。strong要素は、最初の部分をマークアップして後の部分と区別するために使用されています。 

<h1><strong>Flowers, Bees, and Honey</strong> and other things I don't understand</h1>

以下は、ゲーム内の警告通知の例であり、各部分がその重要度に応じてマークアップされています:

<p><strong>Warning.</strong> This dungeon is dangerous.
<strong>Avoid the ducks.</strong> Take any gold you find.
<strong><strong>Do not take any of the diamonds</strong>,
they are explosive and <strong>will destroy anything within
ten meters.</strong></strong> You have been warned.</p>

次の例では、strong要素が、ユーザーが最初に読むべき部分を示すために使用されています。 

<p>Welcome to Remy, the reminder system.</p>
 <p>Your tasks for today:</p>
 <ul>
  <li><p><strong>Turn off the oven.</strong></p></li>
  <li><p>Put out the trash.</p></li>
  <li><p>Do the laundry.</p></li>
 </ul>

4.5.4 small 要素

Element/small

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ。
テキスト/HTML内でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

small要素は、サイドコメントや小さな文字で表されるテキストを表します。

小さな文字には、免責事項、注意書き、法的制約、または著作権が含まれることが多いです。また、出典の表示やライセンス要件の満たしに使用されることもあります。

small要素は、em要素で強調されたテキストやstrong要素で重要とマークされたテキストの重要性を「低減」するものではありません。強調されていないテキストや重要でないテキストをマークするには、それぞれemまたはstrong要素でマークアップしないでください。

small要素は、複数の段落、リスト、またはテキストセクションなど、長いテキストスパンに使用すべきではありません。短いテキストランにのみ使用されることを意図しています。たとえば、利用規約をリストするページのテキストは、small要素の適切な候補ではありません。このような場合、そのテキストはサイドコメントではなく、ページの主要なコンテンツです。

small要素は、小見出しに使用してはなりません。その目的には、hgroup要素を使用してください。

この例では、small要素は、ホテルの部屋の価格に付加価値税が含まれていないことを示すために使用されています: 

<dl>
<dt>Single room
<dd>199 € <small>breakfast included, VAT not included</small>
<dt>Double room
<dd>239 € <small>breakfast included, VAT not included</small>
</dl>

この2番目の例では、small要素が記事のサイドコメントに使用されています。 

<p>Example Corp today announced record profits for the
second quarter <small>(Full Disclosure: Foo News is a subsidiary of
Example Corp)</small>, leading to speculation about a third quarter
merger with Demo Group.</p>

これは、メインテキストの流れから外れた複数の段落にわたるサイドバーとは異なります。次の例では、同じ記事からのサイドバーが示されています。このサイドバーには、サイドバー内の情報の出典を示す小さな文字が含まれています。 

<aside>
<h1>Example Corp</h1>
<p>This company mostly creates small software and Web
sites.</p>
<p>The Example Corp company mission is "To provide entertainment
and news on a sample basis".</p>
<p><small>Information obtained from <a 
href="https://example.com/about.html">example.com</a> home
page.</small></p>
</aside>

この最後の例では、small要素が重要な小さな文字としてマークされています。 

<p><strong><small>Continued use of this service will result in a kiss.</small></strong></p>

4.5.5 s 要素

Element/s

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ。
テキスト/HTML内でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

s要素は、もはや正確でない、または関連性がない内容を表します。

s要素は文書の編集を示す際には適切ではありません。文書から削除されたテキストをマークするには、del要素を使用してください。

この例では、製品の推奨小売価格がもはや関連性がないとマークされており、その製品に新しいセール価格が適用されています。

<p>Buy our Iced Tea and Lemonade!</p>
<p><s>Recommended retail price: $3.99 per bottle</s></p>
<p><strong>Now selling for just $2.99 a bottle!</strong></p>

4.5.6 cite要素

Element/cite

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
パルパブルコンテンツ。
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

cite要素は、作品のタイトル (例: 書籍、論文、エッセイ、詩、スコア、曲、脚本、映画、テレビ番組、ゲーム、彫刻、絵画、劇場公演、演劇、オペラ、ミュージカル、展覧会、法律事件報告、コンピュータプログラムなど) を表します。これは引用されている作品または詳細に参照されている作品 (つまり、引用) である可能性があり、またはただ言及されているだけの作品である場合もあります。

人名は作品のタイトルではありません—たとえ人々がその人を作品と呼んだとしても—したがって、この要素を使用して人名をマークアップしてはなりません。(場合によっては、b要素が名前に適しているかもしれません。例えば、有名人の名前が強調されるゴシップ記事などでは、名前がキーワードとして異なるスタイルで表示されます。その他の場合、要素が本当に必要である場合は、span要素を使用できます。)

次の例は、cite要素の典型的な使用例を示しています: 

<p>私のお気に入りの本は<cite>The Reality Dysfunction</cite>です。著者はPeter F. Hamiltonです。私のお気に入りの漫画は<cite>Pearls Before Swine</cite>です。作者はStephan Pastisです。私のお気に入りの曲は<cite>Jive Samba</cite>です。演奏者はCannonball Adderley Sextetです。</p>

これは正しい使用例です:

<p>Wikipediaの記事<cite>HTML</cite>によると、2008年2月中旬の時点で、属性値を引用符なしで残すことは危険です。これは明らかに過度に簡略化されています。</p>

しかし、次の例は正しくありません。cite要素には、作品のタイトル以上のものが含まれています: 

<!-- この例をコピーしないでください、これは悪い使用例です！ -->
<p>WikipediaのHTMLに関する記事<cite>によると、2008年2月中旬の時点で、属性値を引用符なしで残すことは危険です。これは明らかに過度に簡略化されています。</p>

cite要素は、参考文献の書誌において重要な役割を果たしますが、これはタイトルのみをマークするために使用されます: 

<p><cite>世界人権宣言</cite>、国連、1948年12月。総会決議217 A (III) によって採択されました。</p>

引用は引用文ではありません (これはq要素に適しています)。

これは誤った使用例です。citeは引用文には適していません:

<p><cite>これは間違いです！</cite>とイアンは言いました。</p>

これは誤った使用例でもあります。なぜなら、人間は作品ではないからです:

<p><q>これはまだ間違いです！</q>と<cite>イアン</cite>が言いました。</p>

正しい使用例では、cite要素を使用しません:

<p><q>これは正しいです</q>とイアンは言いました。</p>

前述のように、b要素は、特定の種類のドキュメントで名前をキーワードとしてマークするために使用することができます: 

<p>そして<b>イアン</b>は言いました<q>ゴシップ記事では、これは正しいかもしれません！</q>。</p>

4.5.7 q要素

Element/q

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
パルパブルコンテンツ。
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
cite — 引用の元や編集に関する詳細へのリンク
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェイス:
HTMLQuoteElementを使用します。

q要素は、他のソースから引用されたフレージングコンテンツを表します。

要素の内容を引用する引用符などの句読点は、q要素の直前、直後、または内部に表示されてはなりません。それらはユーザーエージェントによってレンダリングに挿入されます。

q要素内のコンテンツは、別のソースから引用されたものでなければなりません。そのアドレスがある場合は、cite属性に引用することができます。ソースは、例えば小説や脚本の登場人物を引用する場合のように、架空のものであっても構いません。

cite属性が存在する場合、それはスペースに囲まれた有効なURLでなければなりません。対応する引用リンクを取得するためには、属性の値をURLを解析し、要素のノードドキュメントに対して相対的に処理する必要があります。ユーザーエージェントはユーザーがそのような引用リンクに従うことを許可するかもしれませんが、それらは主にプライベート用途 (例: 引用の使用状況に関する統計を収集するサーバーサイドスクリプトなど) を目的としており、読者向けではありません。

q要素は、引用を表さない引用符の代わりに使用してはなりません。例えば、q要素を皮肉な発言のマークアップに使用することは不適切です。

q要素を使用して引用をマークアップすることは完全に任意です。q要素を使用せずに明示的な引用符を使用することも同様に正しいです。

以下は、q要素の使用例です:

<p>The man said <q>Things that are impossible just take longer</q>. I disagreed with him.</p>

次の例では、q要素に明示的な引用リンクがあり、また引用が外部にあります: 

<p>The W3C page <cite>About W3C</cite> says the W3C's mission is <q cite="https://www.w3.org/Consortium/">To lead the World Wide Web to its full potential by developing protocols and guidelines that ensure long-term growth for the Web</q>. I disagree with this mission.</p>

次の例では、引用自体に引用が含まれています:

<p>In <cite>Example One</cite>, he writes <q>The man said <q>Things that are impossible just take longer</q>. I disagreed with him</q>. Well, I disagree even more!</p>

次の例では、q要素の代わりに引用符が使用されています:

<p>His best argument was ❝I disagree❞, which I thought was laughable.</p>

次の例では、引用はなく、引用符は単語を示すために使用されています。この場合、q要素を使用するのは不適切です。

<p>The word "ineffable" could have been used to describe the disaster resulting from the campaign's mismanagement.</p>

4.5.8 dfn 要素

Element/dfn

すべての現在のエンジンでサポートされています。

Firefox1+Safari6+Chrome15+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フロー コンテンツ。
フレージング コンテンツ。
触知可能なコンテンツ。
この要素が使用できる コンテキスト:
フレージング コンテンツが 期待される場所。
コンテンツ モデル:
フレージング コンテンツ、ただし dfn 要素の 子孫があってはなりません。
テキスト/htmlでの タグ省略:
いずれのタグも省略できません。
コンテンツ属性:
グローバル属性
また、title 属性はこの 要素に特別な意味があります: 完全な用語または略語の展開
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLElementを使用します。

dfn 要素は表す定義された用語のインスタンスです。段落、定義リストグループ、またはセクションが最も近い祖先であるdfn 要素も、その用語の定義を含まなければなりません。

定義用語: dfn 要素がtitle 属性を持っている場合、 その属性の正確な値が定義されている用語です。そうでない場合、もし正確に1つの要素子ノードと Text ノードを含み、その子要素がabbr 要素で title 属性を持っている場合、 その属性の正確な値が定義されている用語です。それ以外の場合は、子孫テキストコンテンツが dfn 要素の 定義されている用語を示します。

title 属性が dfn 要素に存在する場合、 それは定義されている用語のみを含まなければなりません。

title 属性は 祖先要素には影響しません。

a 要素がdfn 要素にリンクしている場合、 それはdfn 要素によって定義された用語のインスタンスを表します。

次の断片では、「Garage Door Opener」という用語が最初の段落で定義され、その後に2番目の段落で使用されます。どちらの場合も、実際に表示されるのは略語です。

<p>The <dfn><abbr title="Garage Door Opener">GDO</abbr></dfn>
 is a device that allows off-world teams to open the iris.</p>
 <!-- ... later in the document: -->
 <p>Teal'c activated his <abbr title="Garage Door Opener">GDO</abbr>
 and so Hammond ordered the iris to be opened.</p>

a 要素を追加することで、 参照 を明示的にすることができます: 

<p>The <dfn id=gdo><abbr title="Garage Door Opener">GDO</abbr></dfn>
 is a device that allows off-world teams to open the iris.</p>
 <!-- ... later in the document: -->
 <p>Teal'c activated his <a href=#gdo><abbr title="Garage Door Opener">GDO</abbr></a>
 and so Hammond ordered the iris to be opened.</p>

4.5.9 abbr 要素

Element/abbr

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome2+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer7+
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ。
テキスト/HTML内でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
また、title属性がこの要素に特別な意味を持ちます: 省略形の完全な用語または展開形
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

abbr要素は、略語または頭字語を表します。省略形の展開をオプションで含むことができます。title属性を使用して、省略形の展開を提供できます。指定されている場合、属性には省略形の展開のみが含まれている必要があります。

以下の段落には、abbr要素でマークアップされた略語が含まれています。この段落は、「Web Hypertext Application Technology Working Group」という用語を定義しています。

<p>The <dfn id=whatwg><abbr
title="Web Hypertext Application Technology Working Group">WHATWG</abbr></dfn>
is a loose unofficial collaboration of web browser manufacturers and
interested parties who wish to develop new technologies designed to
allow authors to write and deploy Applications over the World Wide
Web.</p>

別の書き方では、次のようになります。

<p>The <dfn id=whatwg>Web Hypertext Application Technology
Working Group</dfn> (<abbr
title="Web Hypertext Application Technology Working Group">WHATWG</abbr>)
is a loose unofficial collaboration of web browser manufacturers and
interested parties who wish to develop new technologies designed to
allow authors to write and deploy Applications over the World Wide
Web.</p>

この段落には2つの略語があります。1つだけが定義されていることに注目してください。展開が関連付けられていないもう1つの略語には、abbr要素が使用されていません。

<p>The
<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
started working on HTML5 in 2004.</p>

この段落は、略語をその定義にリンクしています。

<p>The <a href="#whatwg"><abbr
title="Web Hypertext Application Technology Working Group">WHATWG</abbr></a>
community does not have much representation from Asia.</p>

この段落は、展開を提供せずに略語をマークアップしています。これは、略語にスタイルを適用するためのフック（例：スモールキャップス）として使用される可能性があります。

<p>Philip` and Dashiva both denied that they were going to
get the issue counts from past revisions of the specification to
backfill the <abbr>WHATWG</abbr> issue graph.</p>

略語が複数形である場合、展開の文法的な数（単数形対複数形）は、要素の内容の文法的な数と一致している必要があります。

ここでは複数形が要素の外にあるため、展開は単数形です。

<p>Two <abbr title="Working Group">WG</abbr>s worked on
this specification: the <abbr>WHATWG</abbr> and the
<abbr>HTMLWG</abbr>.</p>

ここでは複数形が要素の中にあるため、展開は複数形です。

<p>Two <abbr title="Working Groups">WGs</abbr> worked on
this specification: the <abbr>WHATWG</abbr> and the
<abbr>HTMLWG</abbr>.</p>

略語は必ずしもこの要素でマークアップする必要はありません。この要素が役立つと考えられるのは次の場合です。

一度title属性で展開を提供しても、同じ文書内でtitle属性がないが同じ内容を持つ他のabbr要素が、同じ展開を持つように動作するとは限りません。すべてのabbr要素は独立しています。

4.5.10 ruby 要素

Element/ruby

すべての現在のエンジンでサポートされています。

Firefox38+Safari5+Chrome5+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
本文を参照。
テキスト/HTML内でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

ruby要素は、フレージングコンテンツの1つ以上のスパンにルビ注釈を付けることができます。ルビ注釈は、主に東アジアのタイポグラフィで発音のガイドとして使用されるベーステキストに沿って表示される短いテキストです。日本語では、この形式のタイポグラフィは「ふりがな」とも呼ばれます。

ruby要素のコンテンツモデルは、次の1つ以上のシーケンスで構成されます。

  1. 次のいずれか1つ：

  2. 次のいずれか1つ：

rubyおよびrt要素は、特に以下に説明するような、さまざまな種類の注釈に使用できます。日本語ルビやそのレンダリング方法の詳細については、日本語組版処理の要件を参照してください。[JLREQ]

執筆時点では、CSSはまだHTMLのruby要素のレンダリングを完全に制御する方法を提供していません。今後、CSSが以下に説明するスタイルをサポートするように拡張されることが期待されています。

日本語の個々のベース文字に対する単一ルビ

1つ以上のひらがなまたはカタカナ文字（ルビ注釈）が、各表意文字（ベーステキスト）に配置されます。これは、漢字の読みを提供するために使用されます。 

<ruby>B<rt>annotation</ruby>

この例では、各注釈が単一のベース文字に対応していることに注目してください。 

<ruby>君<rt>くん</ruby><ruby>子<rt>し</ruby>は<ruby>和<rt>わ</ruby>して<ruby>同<rt>どう</ruby>ぜず。

君くん子しは和わして同どうぜず。

この例は、2つのベーステキストと2つの注釈（それぞれに1つ）を持つ1つのruby要素を使用して、次のように書くこともできます。これは、2つのベーステキストと1つの注釈（上記のマークアップのように）を持つruby要素2つと同じです。 

<ruby>君<rt>くん</rt>子<rt>し</ruby>は<ruby>和<rt>わ</ruby>して<ruby>同<rt>どう</ruby>ぜず。
複合語（熟語）に対する単一ルビ

これは前のケースと似ていますが、複合語（ベーステキスト）にある各表意文字に、その読みがひらがなまたはカタカナ文字（ルビ注釈）で提供されます。違いは、ベーステキストのセグメントが互いに独立しているのではなく、複合語を形成していることです。 

<ruby>B<rt>annotation</rt>B</ruby>

この例では、各注釈が再び単一のベース文字に対応していることに注意してください。この例では、各複合語（熟語）は単一のruby要素に対応しています。

ここでのレンダリングは、各注釈が対応するベース文字の上（または縦書きでは横）に配置され、隣接する文字に重ならないことが期待されます。

<ruby>鬼<rt>き</rt>門<rt>もん</rt></ruby>の<ruby>方<rt>ほう</rt>角<rt>がく</rt></ruby>を<ruby>凝<rt>ぎょう</rt>視</rt>し</rt></ruby>する

鬼き門もんの方ほう角がくを凝ぎょう視 し する

熟語ルビ

これは前のケースと意味的には同じです（ベース複合語の各個別表意文字には、ひらがなまたはカタカナ文字の注釈が付けられます）が、レンダリングはより複雑な熟語ルビレンダリングです。

これは、複合語に対する単一ルビの同じ例です。異なるレンダリングは、異なるスタイリング（例：CSS）を使用して達成されることが期待されており、ここでは示されていません。

<ruby>鬼<rt>き</rt>門<rt>もん</rt></ruby>の<ruby>方<rt>ほう</rt>角<rt>がく</rt></ruby>を<ruby>凝<rt>ぎょう</rt>視</rt>し</rt></ruby>する

熟語ルビの位置付けの詳細については、 日本語組版処理の要件の付録Fを参照してください。[JLREQ]

意味を説明するためのグループルビ

注釈は、発音ではなくベーステキストの意味を説明します。そのため、ベーステキストと注釈の両方が複数の文字にまたがることがあります。 

<ruby>BASE<rt>annotation</ruby>

ここでは、複合語に対して対応するカタカナが注釈として与えられています。 

<ruby>境界面<rt>インターフェース</ruby>

境界面インターフェース

ここでは、複合語に対して英語の翻訳が注釈として提供されています。 

<ruby lang="ja">編集者<rt lang="en">editor</ruby>

編集者editor

熟字訓に対するグループルビ

発音が複数のベース文字に対応する場合、1対1のマッピングが難しい場合があります（英語では、「Colonel」や「Lieutenant」などの単語が、一部の方言では個々の文字に発音を直接対応させることが不明瞭な例です）。

この例では、花の種の名前に対して発音がグループルビを使用して提供されています： 

<ruby>紫陽花<rt>あじさい</ruby>

紫陽花あじさい

音韻と意味の両方の注釈を持つテキスト（両側ルビ）

時々、上記で説明したルビスタイルが組み合わさることがあります。

これが結果的に、同じ単一のベースセグメントをカバーする2つの注釈になる場合、注釈はただ背中合わせに配置することができます。 

<ruby>BASE<rt>annotation 1<rt>annotation 2</ruby>
<ruby>B<rt>a<rt>a</ruby><ruby>A<rt>a<rt>a</ruby><ruby>S<rt>a<rt>a</ruby><ruby>E<rt>a<rt>a</ruby>

この作為的な例では、いくつかのシンボルに英語とフランス語で名前が付けられています。 

<ruby>
  ♥ <rt> Heart <rt lang=fr> Cœur </rt>
  ☘ <rt> Shamrock <rt lang=fr> Trèfle </rt>
  ✶ <rt> Star </rt lang=fr> Étoile </rt>
 </ruby>

次のようなより複雑な状況では、ネストされたruby要素を使用して内部注釈を付け、次にそのruby全体に「外側」レベルで注釈を付けます。 

<ruby><ruby>B<rt>a</rt>A</rt>n</rt>S</rt>t</rt>E</rt>n</rt></ruby><rt>annotation</ruby>

ここでは、発音と意味の両方がルビ注釈で示されています。ネストされたruby要素の注釈は、各ベース文字に対して単一ルビの発音注釈を提供し、外側のrt要素の子であるruby要素の注釈は、ひらがなを使用して意味を提供します。 

<ruby><ruby>東<rt>とう</rt>南</rt>なん</rt></ruby><rt>たつみ</rt></ruby>の方角

東とう南なん たつみ の方角

これは同じ例ですが、意味が日本語ではなく英語で与えられています。 

<ruby><ruby>東<rt>とう</rt>南<rt>なん</rt></ruby><rt lang=en>Southeast</rt></ruby>の方角

東とう南なん Southeast の方角

ルビ 要素内で、 ルビ 要素の 祖先を持たない場合、コンテンツはセグメント化され、セグメントは3つのカテゴリに分類されます: 基本文セグメント、注釈 セグメント、無視セグメント。無視セグメントはドキュメントのセマンティクスの一部ではありません（これらは一部の 要素間の空白やrp 要素で構成されており、 後者はルビを全くサポートしないレガシーユーザーエージェントのために使用されます）。基本文セグメントは重複することが あり（DOMの任意の位置で2つのセグメントが重複する制限があり、重複するセグメントの開始点が重複するセグメント より早い場合、同じかそれ以降の終了点を持つ必要があり、終了点が重複するセグメントより遅い場合、同じかそれ以前の開始点 を持つ必要があります）。注釈セグメントはrt 要素に対応しています。各注釈セグメントはbase text segmentと関連付けることができ、 各base text segmentには注釈セグメントが関連付けられることがあります。（準拠したドキュメントでは、各base text segmentには少なくとも 1つの注釈セグメントが関連付けられ、各注釈セグメントは1つのbase text segmentと関連付けられます）。ルビ 要素は、それに含まれる base text segmentの集合と、それらのbase text segmentと注釈セグメントのマッピングの 結果を表します。セグメントはDOMレンジの観点で説明され、注釈セグメントの範囲は常に 正確に1つの要素で構成されます。[DOM]

特定の時点で、ルビ 要素の内容のセグメンテーションとカテゴリ化は、次のアルゴリズムを実行することで得られる結果です:

  1. base text segments を、各セグメントに潜在的にbase text subsegmentsのリストを含む空のリストとして定義します。

  2. annotation segments を、各セグメントに潜在的にbase text segmentまたはsubsegmentが関連付けられる空のリストとして定義します。

  3. root を、そのアルゴリズムが実行されるruby 要素として定義します。

  4. もしrootにルビ 要素の祖先がある場合、 endとラベル付けされたステップに進みます。

  5. current parent をrootと定義します。

  6. index を0と定義します。

  7. start index をnullと定義します。

  8. saved start index をnullと定義します。

  9. current base text をnullと定義します。

  10. Start mode: もしindexがcurrent parentの子ノードの数以上である場合、end modeとラベル付けされたステップに進みます。

  11. もしindex番目のcurrent parentのノードがrt 要素またはrp 要素である場合、annotation modeとラベル付けされたステップに進みます。

  12. start index にindexの値を設定します。

  13. Base mode: もしindex番目のcurrent parentのノードがruby 要素であり、 かつcurrent parentがrootと同じ要素である場合、ルビレベルをプッシュする としてstart modeとラベル付けされたステップに進みます。

  14. もしindex番目のcurrent parentのノードがrt 要素またはrp 要素である場合、現在の基本文を設定する としてannotation modeとラベル付けされたステップに進みます。

  15. index を1増やします。

  16. Base mode post-increment: もしindexがcurrent parentの子ノードの数以上である場合、end modeとラベル付けされたステップに進みます。

  17. base modeとラベル付けされたステップに戻ります。

  18. Annotation mode: もしindex番目のcurrent parentのノードがrt 要素である場合、ルビ注釈をプッシュする としてannotation mode incrementとラベル付けされたステップに進みます。

  19. もしindex番目のcurrent parentのノードがrp 要素である場合、annotation mode incrementとラベル付けされたステップに進みます。

  20. もしindex番目のcurrent parentのノードがText ノードでないか、もしくはText ノードであっても要素間の空白でない場合、base modeとラベル付けされたステップに進みます。

  21. Annotation mode increment: lookahead index をindexプラス1と定義します。

  22. Annotation mode white-space skipper: もしlookahead indexがcurrent parentの子ノードの数と等しい場合、end modeとラベル付けされたステップに進みます。

  23. もしlookahead index番目のcurrent parentのノードがrt 要素またはrp 要素である場合、 indexをlookahead indexに設定し、annotation modeとラベル付けされたステップに進みます。

  24. もしlookahead index番目のcurrent parentのノードがText ノードでないか、もしくはText ノードであっても要素間の空白でない場合、indexを増やさずにbase modeとラベル付けされたステップに進み、これまでに見た要素間の空白が次のbase text segmentの一部になります。

  25. lookahead indexを1増やします。

  26. Annotation mode white-space skipperとラベル付けされたステップに進みます。

  27. End mode: もしcurrent parentがrootと同じ要素でない場合、ルビレベルをポップする としてbase mode post-incrementとラベル付けされたステップに進みます。

  28. End: base text segmentsとannotation segmentsを返します。ルビ 要素のコンテンツのうち、それらのリストに記述されていない部分は、暗黙的にignored segmentとなります。

上記のステップで現在の基本文を設定すると記載されている場合、アルゴリズムのその時点で次のステップを実行します:

  1. text range を、開始が境界点 (current parent, start index) であり、終了が境界点 (current parent, index) であるDOM範囲とします。

  2. new text segment を、範囲 text range によって記述されるベーステキストセグメントとします。

  3. new text segment を base text segments に追加します。

  4. current base text を new text segment とします。

  5. start index を null とします。

上記のステップでルビレベルをプッシュすると記載されている場合、アルゴリズムのその時点で次のステップを実行します:

  1. current parentをcurrent parentのindex番目のノードとして定義します。

  2. indexを0と定義します。

  3. saved start indexをstart indexの値として設定します。

  4. start indexをnullと定義します。

上記のステップでルビレベルをポップすると記載されている場合、アルゴリズムのその時点で次のステップを実行します:

  1. indexをroot内のcurrent parentの位置として定義します。

  2. current parentをrootとして定義します。

  3. indexを1増やします。

  4. start indexをsaved start indexの値として設定します。

  5. saved start indexをnullと定義します。

上記のステップでルビ注釈をプッシュすると記載されている場合、アルゴリズムのその時点で次のステップを実行します:

  1. rtを、current parentのindex番目のノードであるrt要素として定義します。

  2. annotation rangeを、開始が current parent、indexであり、終了が current parent、indexプラス1であるDOMレンジとして定義します（つまりrtのみを含む）。

  3. new annotation segmentを、annotation rangeで記述された注釈セグメントとして定義します。

  4. もしcurrent base textがnullでない場合、new annotation segmentをcurrent base textに関連付けます。

  5. new annotation segmentをannotation segmentsに追加します。

この例では、日本語のテキスト漢字の各表意文字に、その読みがひらがなで注釈されています。

...
 <ruby>漢<rt>かん</rt>字<rt>じ</rt></ruby>
 ...

これがレンダリングされると次のようになります:

それぞれの主要な漢字に、その読みがひらがなで小さなフォントで上に表示されている。

この例では、繁体字中国語のテキスト漢字の各表意文字に、その注音符号が注釈されています。

<ruby>漢<rt>ㄏㄢˋ</rt>字<rt>ㄗˋ</rt></ruby>

これがレンダリングされると次のようになります:

それぞれの主要な漢字に、その注音符号が横に小さなフォントで表示されている。

この例では、簡体字中国語のテキスト汉字の各表意文字に、その拼音が注釈されています。

...<ruby>汉<rt>hàn</rt>字<rt>zì</rt></ruby>...

これがレンダリングされると次のようになります:

それぞれの主要な漢字に、その拼音が上に小さなフォントで表示されている。

このより複雑な例では、「HTML」という頭字語には4つの注釈があります: 頭字語全体に対するもの、HTの文字を「Hypertext」として展開するもの、Mの文字を「Markup」として展開するもの、Lの文字を「Language」として展開するもの。

<ruby>
  <ruby>HT<rt>Hypertext</rt>M<rt>Markup</rt>L<rt>Language</rt></ruby>
  <rt>An abstract language for describing documents and applications
 </ruby>

4.5.11 rt 要素

Element/rt

すべての現在のエンジンでサポートされています。

Firefox38+Safari5+Chrome5+
Opera?Edge79+
Edge (Legacy)?Internet Explorer5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
なし。
この要素が使用される文脈:
ruby 要素の子要素として。
内容モデル:
フレージングコンテンツ。
text/htmlでのタグ省略:
rt 要素の 終了タグ は、 rt 要素が直後にrt 要素または rp 要素が続く場合や、親要素内に他のコンテンツがない場合には省略できます。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェイス:
HTMLElement を使用します。

rt 要素は、ルビ注釈のルビテキストコンポーネントを示します。ruby 要素の子要素として存在する場合、 何も表しませんが、ruby 要素がそのそれが 表すものを決定する一部として使用します。

rt 要素がruby 要素の子要素でない場合、 その子要素と同じものを表します。

4.5.12 rp 要素

Element/rp

すべての現在のエンジンでサポートされています。

Firefox38+Safari5+Chrome5+
Opera?Edge79+
Edge (Legacy)?Internet Explorer5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
なし。
この要素が使用される文脈:
ruby 要素の子要素として、rt 要素の直前または直後に使用できます。
内容モデル:
テキスト。
text/htmlでのタグ省略:
rp 要素の 終了タグ は、rp 要素が直後にrt 要素または rp 要素が続く場合や、親要素内に他のコンテンツがない場合には省略できます。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェイス:
HTMLElement を使用します。

rp 要素は、ルビ注釈のルビテキストコンポーネントの周りに括弧やその他のコンテンツを提供するために使用され、ルビ注釈をサポートしないユーザーエージェントで表示されます。

rp 要素がruby 要素の子要素である場合、 何も表しません。rp 要素がruby 要素の子要素でない場合は、その子要素を表します。

上記の例では、テキスト 漢字 の各表意文字にその発音が注釈されていますが、rp を使用してレガシーユーザーエージェントで注釈が括弧で表示されるように拡張することができます:

...
<ruby>漢<rp>（</rp><rt>かん</rt><rp>）</rp>字<rp>（</rp><rt>じ</rt><rp>）</rp></ruby>
...

準拠するユーザーエージェントではレンダリングは上記のようになりますが、ルビをサポートしないユーザーエージェントでは次のようにレンダリングされます:

... 漢（かん）字（じ）...

セグメントに複数の注釈がある場合、rp 要素は注釈の間にも配置できます。以下は以前の作り込まれた例のコピーで、英語とフランス語で名前が付けられたシンボルがいくつか表示されていますが、今回はrp 要素も含まれています:

<ruby>
♥<rp>: </rp><rt>Heart</rt><rp>, </rp><rt lang=fr>Cœur</rt><rp>.</rp>
☘<rp>: </rp><rt>Shamrock</rt><rp>, </rp><rt lang=fr>Trèfle</rt><rp>.</rp>
✶<rp>: </rp><rt>Star</rt><rp>, </rp><rt lang=fr>Étoile</rt><rp>.</rp>
</ruby>

これにより、ルビ対応でないユーザーエージェントでのレンダリングは次のようになります:

♥: Heart, Cœur. ☘: Shamrock, Trèfle. ✶: Star, Étoile.

4.5.13 data 要素

Element/data

すべての現在のエンジンでサポートされています。

Firefox22+Safari10+Chrome62+
Opera?Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLDataElement

すべての現在のエンジンでサポートされています。

Firefox22+Safari10+Chrome62+
Opera?Edge79+
Edge (Legacy)14+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
有形コンテンツ。
この要素が使用される文脈:
フレージングコンテンツが予想される場所。
内容モデル:
フレージングコンテンツ。
text/htmlでのタグ省略:
いずれのタグも省略できません。
コンテンツ属性:
グローバル属性
value — 機械可読の値
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェイス: 
[Exposed=Window]
interface HTMLDataElement : HTMLElement {
 [HTMLConstructor] constructor();

 [CEReactions] attribute DOMString value;
};

data 要素は、その内容と、その内容の機械可読形式をvalue属性に関連付けて表します。

value属性は必須です。その値は、要素の内容を機械可読形式で表現したものでなければなりません。

値が日付や時間に関連している場合は、より具体的なtime要素を使用することができます。

この要素はいくつかの目的に使用できます。

この仕様で定義されているマイクロフォーマットやマイクロデータ属性と組み合わせると、この要素はデータ処理者のための機械可読値と、ウェブブラウザでのレンダリングのための人間可読値を提供します。この場合、value属性で使用されるフォーマットは、使用しているマイクロフォーマットやマイクロデータの語彙によって決まります。

しかし、この要素はページ内のスクリプトと組み合わせて使用することもできます。スクリプトが人間可読値とともにリテラル値を格納する場合です。このような場合、使用されるフォーマットはスクリプトのニーズにのみ依存します（data-*属性もこのような状況で役立つ場合があります）。

HTMLDataElement/value

すべての現在のエンジンでサポートされています。

Firefox22+Safari10+Chrome62+
Opera?Edge79+
Edge (Legacy)14+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

value IDL属性は、同じ名前のコンテンツ属性を反映する必要があります。

ここでは、テーブルのソート JavaScript ライブラリが、テキスト形式の列と分解形式の列の両方に表示された数字に対して、列ごとのソート機能を提供できるように、data 要素を使用して数値がエンコードされた短いテーブルを示します。

<script src="sortable.js"></script>
 <table class="sortable">
  <thead> <tr> <th> Game <th> Corporations <th> Map Size
  <tbody>
   <tr> <td> 1830 <td> <data value="8">Eight</data> <td> <data value="93">19+74 hexes (93 total)</data>
   <tr> <td> 1856 <td> <data value="11">Eleven</data> <td> <data value="99">12+87 hexes (99 total)</data>
   <tr> <td> 1870 <td> <data value="10">Ten</data> <td> <data value="149">4+145 hexes (149 total)</data>
 </table>

4.5.14 time 要素

Element/time

すべての現在のエンジンでサポートされています。

Firefox22+Safari7+Chrome62+
Opera49+Edge79+
Edge (Legacy)18Internet Explorerサポートされていません
Firefox Android?Safari iOS4+Chrome Android?WebView Android?Samsung Internet?Opera Android46+

HTMLTimeElement

すべての現在のエンジンでサポートされています。

Firefox22+Safari10+Chrome62+
Opera49+Edge79+
Edge (Legacy)14+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android46+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
実質コンテンツ。
この要素が使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
この要素がdatetime属性を持っている場合: フレージングコンテンツ。
それ以外の場合: テキスト、ただし下記の文章で説明されている要件に一致する必要があります。
text/html でのタグ省略:
タグの省略はできません。
コンテンツ属性:
グローバル属性
datetime — 機械が読み取れる値
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLTimeElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString dateTime;
 };

time 要素は、その内容と datetime 属性にあるその内容の機械可読形式を表します。内容の種類は、以下に説明されるさまざまな日付、時刻、タイムゾーンオフセット、および期間に限定されます。

datetime 属性は存在するかもしれません。存在する場合、その値は要素の内容を機械が読み取れる形式で表したものでなければなりません。

time 要素が datetime コンテンツ属性を持たない場合、その要素には子要素を持つことはできません。

time 要素の datetime 値 は、要素の datetime コンテンツ属性の値であり、存在する場合、そうでなければ 子テキストコンテンツ です。

time 要素の datetime 値 は、以下のいずれかの構文に一致しなければなりません。

有効な月文字列
<time>2011-11</time>
有効な日付文字列
<time>2011-11-18</time>
有効な年のない日付文字列
<time>11-18</time>
有効な時刻文字列
<time>14:54</time>
<time>14:54:39</time>
<time>14:54:39.929</time>
有効なローカルの日付と時刻の文字列
<time>2011-11-18T14:54</time>
<time>2011-11-18T14:54:39</time>
<time>2011-11-18T14:54:39.929</time>
<time>2011-11-18 14:54</time>
<time>2011-11-18 14:54:39</time>
<time>2011-11-18 14:54:39.929</time>

日付のある時刻ですが、タイムゾーンオフセットがないものは、各タイムゾーンで一日を通して同じ特定の時刻に観察されるイベントを指定するのに役立ちます。たとえば、2020 年の新年は、すべてのタイムゾーンで 2020-01-01 00:00 に祝われますが、すべてのタイムゾーンで同時に祝われるわけではありません。すべてのタイムゾーンで同時に発生するイベントの場合、たとえばビデオ会議のような会議には、有効なグローバルの日付と時刻の文字列 の方が役立つ可能性があります。

有効なタイムゾーンオフセット文字列
<time>Z</time>
<time>+0000</time>
<time>+00:00</time>
<time>-0800</time>
<time>-08:00</time>

日付のない時刻（または複数の日付で繰り返されるイベントを指す時刻）の場合、タイムゾーンオフセットを指定するよりも、その時刻を制御する地理的位置を指定する方が通常は役立ちます。なぜなら、地理的位置はサマータイムによってタイムゾーンオフセットを変更するからです。場合によっては、地理的位置がタイムゾーンを変更することさえあります。たとえば、2011 年の終わりにサモアで発生したように、タイムゾーンの境界が引き直された場合などです。各タイムゾーンの境界とそれぞれのゾーン内で適用されるルールを記述するタイムゾーンデータベースと呼ばれるデータベースが存在します。[TZDATABASE]

有効なグローバル日付と時刻の文字列
<time>2011-11-18T14:54Z</time>
<time>2011-11-18T14:54:39Z</time>
<time>2011-11-18T14:54:39.929Z</time>
<time>2011-11-18T14:54+0000</time>
<time>2011-11-18T14:54:39+0000</time>
<time>2011-11-18T14:54:39.929+0000</time>
<time>2011-11-18T14:54+00:00</time>
<time>2011-11-18T14:54:39+00:00</time>
<time>2011-11-18T14:54:39.929+00:00</time>
<time>2011-11-18T06:54-0800</time>
<time>2011-11-18T06:54:39-0800</time>
<time>2011-11-18T06:54:39.929-0800</time>
<time>2011-11-18T06:54-08:00</time>
<time>2011-11-18T06:54:39-08:00</time>
<time>2011-11-18T06:54:39.929-08:00</time>

日付とタイムゾーンオフセットを含む時刻は、特定のイベント、または特定の地理的位置に固定されていない仮想イベントの繰り返しを指定するのに役立ちます。たとえば、隕石の衝突の正確な時刻や、毎日 1400 UTC に開催される一連の会議などです。地理的な場所のタイムゾーンオフセットによって正確な時刻が異なるイベントの場合、有効なローカルの日付と時刻の文字列 とその地理的位置を組み合わせた方が役立つ可能性があります。

有効な週文字列
<time>2011-W47</time>
4 つ以上の ASCII 数字（そのうちの少なくとも 1 つが U+0030 DIGIT ZERO (0) ではないもの）
<time>2011</time>
<time>0001</time>
有効な期間文字列
<time>PT4H18M3S</time>
<time>4h 18m 3s</time>

要素の内容の機械可読の同等物は、要素のdatetime 値から次のアルゴリズムを使用して取得しなければなりません。

  1. 要素のdatetime 値から月文字列を解析して月が返された場合、それが機械可読の同等物です；終了。

  2. 要素のdatetime 値から日付文字列を解析して日付が返された場合、それが機械可読の同等物です；終了。

  3. 要素のdatetime 値から年なし日付文字列を解析して年なし日付が返された場合、それが機械可読の同等物です；終了。

  4. 要素のdatetime 値から時間文字列を解析して時間が返された場合、それが機械可読の同等物です；終了。

  5. 要素のdatetime 値からローカル日時文字列を解析してローカル日時が返された場合、それが機械可読の同等物です；終了。

  6. 要素のdatetime 値からタイムゾーンオフセット文字列を解析してタイムゾーンオフセットが返された場合、それが機械可読の同等物です；終了。

  7. 要素のdatetime 値からグローバル日時文字列を解析してグローバル日時が返された場合、それが機械可読の同等物です；終了。

  8. 要素のdatetime 値から週文字列を解析して週が返された場合、それが機械可読の同等物です；終了。

  9. 要素のdatetime 値が、少なくとも一つのU+0030 DIGIT ZERO（0）以外のASCII数字のみで構成されている場合、機械可読の同等物はその数字の十進数解釈であり、年を表します；終了。

  10. 要素のdatetime 値から期間文字列を解析して期間が返された場合、それが機械可読の同等物です；終了。

  11. 機械可読の同等物はありません。

上記のアルゴリズムは、任意の文字列sに対して、1つのアルゴリズムだけが値を返すように設計されているはずです。より効率的なアプローチは、これらのデータ型を一度に解析する単一のアルゴリズムを作成することかもしれません。そのようなアルゴリズムを開発することは読者に委ねられます。

HTMLTimeElement/dateTime

すべての現在のエンジンでサポートされています。

Firefox22+Safari10+Chrome62+
Opera49+Edge79+
Edge (Legacy)14+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android46+

dateTime IDL属性は、要素のdatetime内容属性を反映する必要があります。

time 要素は、たとえばマイクロフォーマットで日付をエンコードするために使用できます。以下は、time 要素を使用して hCalendar のバリアントを用いたイベントをエンコードする仮想的な方法を示しています。

<div class="vevent">
  <a class="url" href="http://www.web2con.com/">http://www.web2con.com/</a>
  <span class="summary">Web 2.0 Conference</span>:
  <time class="dtstart" datetime="2005-10-05">October 5</time> -
  <time class="dtend" datetime="2005-10-07">7</time>,
  at the <span class="location">Argent Hotel, San Francisco, CA</span>
 </div>

ここでは、架空のマイクロデータ語彙が Atom 語彙に基づいて使用されており、time 要素を使用してブログ投稿の発行日をマークアップしています。

<article itemscope itemtype="https://n.example.org/rfc4287">
  <h1 itemprop="title">Big tasks</h1>
  <footer>Published <time itemprop="published" datetime="2009-08-29">two days ago</time>.</footer>
  <p itemprop="content">Today, I went out and bought a bike for my kid.</p>
 </article>

この例では、別の記事の発行日が schema.org マイクロデータ語彙を使用して time 要素でマークアップされています。

<article itemscope itemtype="http://schema.org/BlogPosting">
  <h1 itemprop="headline">Small tasks</h1>
  <footer>Published <time itemprop="datePublished" datetime="2009-08-30">yesterday</time>.</footer>
  <p itemprop="articleBody">I put a bike bell on her bike.</p>
 </article>

以下のスニペットでは、time 要素を使用して ISO8601 形式の日付をエンコードし、後でスクリプトによって処理されます。

<p>Our first date was <time datetime="2006-09-23">a Saturday</time>.</p>

この2番目のスニペットでは、値に時刻が含まれています:

<p>We stopped talking at <time datetime="2006-09-24T05:00-07:00">5am the next morning</time>.</p>

ページに読み込まれるスクリプト（したがって time 要素を使用して日付や時刻をマークアップするページの内部規約に精通している）は、ページ全体をスキャンしてすべての time 要素を調べ、日付と時刻のインデックスを作成できます。

たとえば、この要素は、「Friday」という文字列に「2011年11月18日」が対応することを伝えます:

Today is <time datetime="2011-11-18">Friday</time>.

この例では、太平洋標準時 (PST) の特定の時間が指定されています:

Your next meeting is at <time datetime="2011-11-18T15:00-08:00">3pm</time>.

4.5.15 code 要素

Element/code

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できる コンテキスト:
フレージングコンテンツが 期待される場所。
コンテンツ モデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ 属性:
グローバル属性
アクセシビリティ に関する考慮事項:
著者向け.
実装者向け.
DOM インターフェース:
HTMLElementを使用します。

code 要素は、コンピュータコードの断片を表します。これは、XML要素名、ファイル名、コンピュータプログラム、またはコンピュータが認識する他の文字列である可能性があります。

コンピュータコードのマークアップに使用される言語を示す正式な方法はありません。 使用する言語を code 要素にマークしたい著者は、たとえば構文強調スクリプトが適切なルールを使用できるように、 class 属性を使用できます。 たとえば、要素に「language-」というプレフィックスを付けたクラスを追加します。

次の例は、段落内で要素名やコンピュータコードをマークアップするためにこの要素をどのように使用できるかを示しています。

<p>The <code>code</code> element represents a fragment of computer
code.</p>

<p>When you call the <code>activate()</code> method on the
<code>robotSnowman</code> object, the eyes glow.</p>

<p>The example below uses the <code>begin</code> keyword to indicate
the start of a statement block. It is paired with an <code>end</code>
keyword, which is followed by the <code>.</code> punctuation character
(full stop) to indicate the end of the program.</p>

次の例は、pre および code 要素を使用してコードブロックをマークアップする方法を示しています。

<pre><code class="language-pascal">var i: Integer;
begin
i := 1;
end.</code></pre>

その例では、使用言語を示すためにクラスが使用されています。

詳細については、pre 要素を参照してください。

4.5.16 var 要素

Element/var

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOM インターフェース:
HTMLElementを使用します。

var 要素は、変数を表します。これは、数学的表現やプログラミングの文脈での実際の変数、定数を表す識別子、物理量を識別する記号、関数のパラメーター、または単に文章中でプレースホルダーとして使用される用語である可能性があります。

次の段落では、文字「n」が文章中で変数として使用されています:

<p>If there are <var>n</var> pipes leading to the ice
cream factory then I expect at <em>least</em> <var>n</var>
flavors of ice cream to be available for purchase!</p>

数学に関しては、特に単純な表現を超えるものについては、MathML の方が適しています。 ただし、var 要素は、 MathML 表現で言及される特定の変数を指すために使用できます。

この例では、方程式が示されており、その方程式の変数を参照する凡例が付いています。 表現自体は MathML でマークアップされていますが、変数は var 要素を使用して凡例に記載されています。 

<figure>
<math>
<mi>a</mi>
<mo>=</mo>
<msqrt>
<msup><mi>b</mi><mn>2</mn></msup>
<mi>+</mi>
<msup><mi>c</mi><mn>2</mn></msup>
</msqrt>
</math>
<figcaption>
ピタゴラスの定理を使用して、三角形の斜辺 <var>a</var> を解きます。
三角形の他の辺は <var>b</var> および <var>c</var> です。
</figcaption>
</figure>

ここでは、質量エネルギー等価性を説明する方程式が文中で使用されており、その方程式に含まれる 変数や定数をマークアップするために var 要素が使用されています。 

<p>Then she turned to the blackboard and picked up the chalk. After a few moment's
thought, she wrote <var>E</var> = <var>m</var> <var>c</var><sup>2</sup>. The teacher
looked pleased.</p>

4.5.17 samp 要素

Element/samp

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOM インターフェース:
HTMLElementを使用します。

samp 要素は 他のプログラムやコンピュータシステムからのサンプルまたは引用された出力を表します。

詳細については、pre 要素および kbd 要素を参照してください。

この要素は、ウェブアプリケーションで即時出力を提供するために使用できる output 要素と対比することができます。

この例では、samp 要素がインラインで使用されています:

<p>The computer said <samp>Too much cheese in tray
two</samp> but I didn't know what that meant.</p>

2つ目の例は、コンソールプログラムのサンプル出力のブロックを示しています。ネストされた samp 要素と kbd 要素を使用することで、スタイルシートを使用してサンプル出力の特定の要素をスタイリングできます。 さらに詳細なマークアップで注釈が付けられている部分もあり、非常に精密なスタイリングが可能です。この目的を達成するために、span 要素が使用されています。 

<pre><samp><span class="prompt">jdoe@mowmow:~$</span> <kbd>ssh demo.example.com</kbd>
Last login: Tue Apr 12 09:10:17 2005 from mowmow.example.com on pts/1
Linux demo 2.6.10-grsec+gg3+e+fhs6b+nfs+gr0501+++p3+c4a+gr2b-reslog-v6.189 #1 SMP Tue Feb 1 11:22:36 PST 2005 i686 unknown

<span class="prompt">jdoe@demo:~$</span> <span class="cursor">_</span></samp></pre>

3つ目の例では、入力とその出力が示されています。この例では code 要素と samp 要素の両方が使用されています。 

<pre>
<code class="language-javascript">console.log(2.3 + 2.4)</code>
<samp>4.699999999999999</samp>
</pre>

4.5.18 kbd 要素

Element/kbd

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOM インターフェース:
HTMLElementを使用します。

kbd 要素は、ユーザー入力（通常はキーボード入力、ただし音声コマンドなどの他の入力も表すことができます）を表します。

kbd 要素が samp 要素内にネストされている場合、それはシステムによってエコーされた入力を表します。

kbd 要素が 含む samp 要素は、システム出力に基づく入力を表します。たとえば、メニュー項目を呼び出す場合などです。

kbd 要素が別の kbd 要素内にネストされている場合、それは入力メカニズムに適した実際のキーまたは他の単一の入力単位を表します。

ここでは、kbd 要素が押すべきキーを示すために使用されています:

<p>To make George eat an apple, press <kbd><kbd>Shift</kbd> + <kbd>F3</kbd></kbd></p>

2つ目の例では、ユーザーに特定のメニュー項目を選択するよう指示しています。外側の kbd 要素は入力ブロックをマークアップし、内側の kbd 要素は入力の各ステップを表し、それらの中の samp 要素は、システムによって表示されているメニューラベルなどに基づく入力を示しています: 

<p>To make George eat an apple, select
 <kbd><kbd><samp>File</samp></kbd>|<kbd><samp>Eat Apple...</samp></kbd></kbd>
</p>

このような精密さは必ずしも必要ではありません。次の例でも問題ありません:

<p>To make George eat an apple, select <kbd>File | Eat Apple...</kbd></p>

4.5.19 sub および sup 要素

Element/sub

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/sup

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
sub 要素: 著者向け; 実装者向け。
sup 要素: 著者向け; 実装者向け。
DOM インターフェース:
HTMLElement を使用します。

sup 要素は上付き文字を、sub 要素は下付き文字を 表します。

これらの要素は、特定の意味を持つ書体上の慣習をマークアップするためにのみ使用する必要があり、単なる書体上のプレゼンテーションのために使用してはなりません。たとえば、LaTeX ドキュメント作成システムの名前で sub および sup 要素を使用するのは不適切です。一般的に、これらの要素を使用しないと、コンテンツの意味が変わる場合にのみ使用する必要があります。

特定の言語では、上付き文字は一部の略語の書体上の慣習の一部です。

<p>Their names are
<span lang="fr"><abbr>M<sup>lle</sup></abbr> Gwendoline</span> and
<span lang="fr"><abbr>M<sup>me</sup></abbr> Denise</span>.</p>

sub 要素は、下付き文字を持つ変数に対して var 要素内で使用できます。

ここでは、sub 要素が、変数のファミリー内の変数を識別する下付き文字を表すために使用されています:

<p>The coordinate of the <var>i</var>th point is
(<var>x</sub><var>i</var></sub></var>, <var>y</sub><var>i</var></sub></var>).
For example, the 10th point has coordinate
(<var>x</sub>10</sub></var>, <var>y</sub>10</sub></var>).</p>

数学の式では、下付き文字と上付き文字がよく使用されます。著者は、数学をマークアップするために MathML の使用を推奨されますが、詳細な数学マークアップが不要な場合は、sub および sup を使用することもできます。 [MATHML] 

<var>E</var>=<var>m</var><var>c</var><sup>2</sup>
f(<var>x</var>, <var>n</var>) = log<sub>4</sub><var>x</var></sup><var>n</var></sup>

4.5.20 i 要素

Element/i

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLElement を使用します。

i 要素は、異なる声や雰囲気、あるいは通常の文章とは異なる品質を示す方法で、本文から区別されたテキストの範囲を表します。例えば、分類学的指定、技術用語、他の言語の慣用句、翻字、考え、西洋のテキストでの船名などです。

メインテキストとは異なる言語の用語には、lang 属性（または、XML では lang 属性を XML 名前空間で使用）を注釈する必要があります。

以下の例は、i 要素の使用例を示しています:

<p>The <i class="taxonomy">Felis silvestris catus</i> is cute.</p>
<p>The term <i>prose content</i> is defined above.</p>
<p>There is a certain <i lang="fr">je ne sais quoi</i> in the air.</p>

次の例では、夢のシーケンスが i 要素を使ってマークアップされています。 

<p>Raymond tried to sleep.</p>
<p><i>The ship sailed away on Thursday</i>, he
dreamt. <i>The ship had many people aboard, including a beautiful
princess called Carey. He watched her, day-in, day-out, hoping she
would notice him, but she never did.</i></p>
<p><i>Finally one night he picked up the courage to speak with
her—</i></p>
<p>Raymond woke with a start as the fire alarm rang out.</p>

著者は、class 属性を i 要素に使用して、この要素が使用される理由を特定することができます。たとえば、特定の使用スタイル（夢のシーケンスや分類学的用語など）が後日変更される場合に、著者がドキュメント全体（または関連する一連のドキュメント）を調べて各使用を注釈する必要がなくなります。

著者は、i 要素よりも適用できる他の要素を検討することをお勧めします。たとえば、ストレスの強調をマークアップするための em 要素や、用語の定義インスタンスをマークアップするための dfn 要素などです。

スタイルシートを使用して、他の要素と同様に i 要素を再スタイル化できます。したがって、i 要素内のコンテンツが必ずしもイタリック体で表示されるわけではありません。

4.5.21 b 要素

Element/b

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLElement を使用します。

b 要素は、特別な重要性を付与せずに、実用的な目的で注意が向けられているテキスト範囲を表します。例えば、文書の要約におけるキーワード、レビューでの製品名、インタラクティブなテキスト駆動型ソフトウェアでのアクション可能な言葉、または記事のリード文などです。

次の例は、b 要素を使用してキーワードを強調表示する例を示していますが、重要性を付与するためのマークアップではありません:

<p>The <b>frobonitor</b> and <b>barbinator</b> components are fried.</p>

次の例では、テキストアドベンチャーのオブジェクトを b 要素を使用して特別なものとして強調しています。

<p>You enter a small room. Your <b>sword</b> glows
brighter. A <b>rat</b> scurries past the corner wall.</p>

別の例として、b 要素を使用してリード文をマークアップするのが適切です。次の例では、BBC の記事 がどのようにマークアップされるかを示しています:

<article>
<h2>Kittens 'adopted' by pet rabbit</h2>
<p><b class="lede">Six abandoned kittens have found an
unexpected new mother figure — a pet rabbit.</b></p>
<p>Veterinary nurse Melanie Humble took the three-week-old
kittens to her Aberdeen home.</p>
[...]

i 要素と同様に、著者は class 属性を b 要素に使用して、後日スタイルが変更される場合に備えて、なぜこの要素が使用されているのかを特定することができます。これにより、ドキュメント全体を手動で注釈する必要がなくなります。

b 要素は、他のより適切な要素がない場合の最後の手段として使用するべきです。特に、見出しには h1 から h6 の要素を使用し、強調する場合には em 要素を使用し、重要性を示す場合には strong 要素を使用し、テキストをマークまたはハイライトする場合には mark 要素を使用すべきです。

次の使用例は不正確な使用です:

<p><b>WARNING!</b> Do not frob the barbinator!</p>

前の例では、正しい要素は strong であり、b ではありません。

スタイルシートを使用して、b 要素を他の要素と同様に再スタイル化することができます。したがって、b 要素内のコンテンツが必ずしも太字で表示されるわけではありません。

4.5.22 u 要素

Element/u

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLElement を使用します。

u 要素は、明示的にレンダリングされるが、非テキストの注釈を持つテキスト範囲を表します。例えば、中国語の名前を表すための文字 (中国の固有名詞マーク) や、綴り間違いを示すためのラベル付けなどがあります。

ほとんどの場合、他の要素を使用する方が適切です。例えば、強調を示す場合には em 要素を使用すべきです。キーワードやフレーズをマークする場合には、状況に応じて b 要素や mark 要素を使用すべきです。書籍のタイトルをマークする場合には cite 要素を使用すべきです。明示的なテキスト注釈をラベル付けする場合には ruby 要素を使用すべきです。技術用語、分類学的指定、翻字、考え、または西洋のテキストにおける船名をラベル付けする場合には i 要素を使用すべきです。

u 要素の視覚的なデフォルトのレンダリングは、ハイパーリンクの従来のレンダリング (下線) と競合します。著者は、u 要素がハイパーリンクと混同される可能性がある場合には、使用を避けることが推奨されます。

この例では、u 要素を使用して単語を誤字としてマークしています:

<p>The <u>see</u> is full of fish.</p>

4.5.23 mark 要素

Element/mark

すべての最新エンジンでサポートされています。

Firefox4+Safari5.1+Chrome7+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ.
テキスト/html におけるタグの省略:
タグは省略可能ではありません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLElement を使用します。

mark 要素は、1 つのドキュメント内で他の文脈において関連性のあるために参照または注釈目的でマークまたはハイライトされたテキスト範囲を表します。引用やその他の文章ブロックで使用される場合、それは最初に存在しなかったハイライトを示しており、元の著者が元々書いたときには重要とは考えられなかったテキスト部分に読者の注意を引くために追加されたことを意味します。ドキュメントの主要な文章で使用される場合、それはユーザーの現在の活動に関連する可能性が高い部分をハイライトすることを意味します。

次の例では、mark 要素を使用して特定の引用部分に注意を引く方法を示します:

<p lang="en-US">Consider the following quote:</p>
 <blockquote lang="en-GB">
  <p>Look around and you will find, no-one's really
  <mark>colour</mark> blind.</p>
 </blockquote>
 <p lang="en-US">As we can tell from the <em>spelling</em> of the word,
 the person writing this quote is clearly not American.</p>

(この要素を綴り間違いとしてマークすることが目的であった場合、u 要素、おそらくクラスを付与する方が適切でしょう。)

もう一つの例では、mark 要素が検索文字列に一致する文書の一部をハイライトする方法を示しています。誰かが文書を検索し、サーバーがユーザーが「kitten」という単語を検索していることを知っている場合、サーバーは次のように段落を変更して文書を返すかもしれません: 

<p>I also have some <mark>kitten</mark>s who are visiting me
 these days. They're really cute. I think they like my garden! Maybe I
 should adopt a <mark>kitten</mark>.</p>

次のスニペットでは、段落のテキストがコードの特定の部分に言及しています。

<p>The highlighted part below is where the error lies:</p>
 <pre><code>var i: Integer;
 begin
    i := <mark>1.1</mark>;
 end.</code></pre>

これは、構文ハイライトとは別物であり、構文ハイライトには span を使用するのが適しています。両方を組み合わせると、次のようになります:

<p>The highlighted part below is where the error lies:</p>
 <pre><code><span class=keyword>var</span> <span class=ident>i</span>: <span class=type>Integer</span>;
 <span class=keyword>begin</span>
    <span class=ident>i</span> := <span class=literal><mark>1.1</mark></span>;
 <span class=keyword>end</span>.</code></pre>

以下の例では、元々強調されていなかった引用文の一部を強調するために mark を使用する方法を示しています。この例では、一般的な印刷の慣例により、引用文内の mark 要素がイタリック体で表示されるようにスタイルが明示的に設定されています。

<style>
  blockquote mark, q mark {
    font: inherit; font-style: italic;
    text-decoration: none;
    background: transparent; color: inherit;
  }
  .bubble em {
    font: inherit; font-size: larger;
    text-decoration: underline;
  }
 </style>
 <article>
  <h1>She knew</h1>
  <p>Did you notice the subtle joke in the joke on panel 4?</p>
  <blockquote>
   <p class="bubble">I didn't <em>want</em> to believe. <mark>Of course
   on some level I realized it was a known-plaintext attack.</mark> But I
   couldn't admit it until I saw for myself.</p>
  </blockquote>
  <p>(Emphasis mine.) I thought that was great. It's so pedantic, yet it
  explains everything neatly.</p>
 </article>

なお、この例では em 要素は引用文の元のテキストの一部であり、mark 要素はコメントのために一部をハイライトしていることに注意してください。

次の例では、テキストの一部分の 重要性 を示す (strong) のと、テキストの 関連性 を示す (mark) の違いを示しています。これは教科書の抜粋で、試験に関連する部分がハイライトされています。安全警告は重要であるにもかかわらず、試験には関連していないようです。 

<h3>Wormhole Physics Introduction</h3>
 
 <p><mark>A wormhole in normal conditions can be held open for a
 maximum of just under 39 minutes.</mark> Conditions that can increase
 the time include a powerful energy source coupled to one or both of
 the gates connecting the wormhole, and a large gravity well (such as a
 black hole).</p>
 
 <p><mark>Momentum is preserved across the wormhole. Electromagnetic
 radiation can travel in both directions through a wormhole,
 but matter cannot.</mark></p>
 
 <p>When a wormhole is created, a vortex normally forms.
 <strong>Warning: The vortex caused by the wormhole opening will
 annihilate anything in its path.</strong> Vortexes can be avoided when
 using sufficiently advanced dialing technology.</p>
 
 <p><mark>An obstruction in a gate will prevent it from accepting a
 wormhole connection.</mark></p>

4.5.24 bdi要素

Element/bdi

すべての現行エンジンでサポートされています。

Firefox10+ Safari6+ Chrome16+
Opera? Edge79+
Edge (Legacy)? Internet Explorerサポートされていません
Firefox Android? Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
有形コンテンツ.
この要素が使用できる文脈:
フレージングコンテンツが期待される場所。
内容モデル:
フレージングコンテンツ.
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
また、dir グローバル属性は、この要素に特有の意味を持ちます。
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElement を使用します。

bdi要素は、双方向テキストの書式設定のために、その周囲から分離されるテキストの範囲を表します。[BIDI]

dir グローバル属性は、この要素においては auto がデフォルトであり、他の要素のように親要素から継承されることはありません。

この要素は双方向アルゴリズムに関するレンダリング要件を持っています。

この要素は、方向性が不明なユーザー生成コンテンツを埋め込む際に特に役立ちます。

この例では、ユーザー名とそのユーザーが投稿した件数が表示されます。もしbdi要素が使用されていなければ、アラビア語のユーザー名がテキストを混乱させてしまいます（双方向アルゴリズムにより、コロンと数字の「3」が「User」の隣に配置され、「posts」の隣に配置されるべきではありません）。 

<ul>
<li>User <bdi>jcranmer</bdi>: 12 posts.
<li>User <bdi>hober</bdi>: 5 posts.
<li>User <bdi>إيان</bdi>: 3 posts.
</ul>
bdi 要素を使用すると、ユーザー名は期待通りに動作します。
bdi要素がb要素に置き換えられると、ユーザー名が双方向アルゴリズムを混乱させ、3番目の箇条書きは「User 3 :」と表示され、その後にアラビア語の名前（右から左）が続き、「posts」とピリオドが続きます。

4.5.25 bdo要素

Element/bdo

すべての最新エンジンでサポートされています。

Firefox10+ Safari4+ Chrome15+
Opera? Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
有形コンテンツ.
この要素が使用できる文脈:
フレージングコンテンツが期待される場所。
内容モデル:
フレージングコンテンツ.
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
また、dir グローバル属性は、この要素に特有の意味を持ちます。
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElement を使用します。

bdo要素は、子要素に対する明示的なテキストの方向性フォーマット制御を表します。これにより、著者はUnicode双方向アルゴリズムをオーバーライドし、明示的に方向性のオーバーライドを指定できます。[BIDI]

著者は、この要素にdir属性を指定し、左から右へのオーバーライドを指定するためにltr値を指定し、右から左へのオーバーライドを指定するためにrtl値を指定する必要があります。auto値は指定してはなりません。

この要素は双方向アルゴリズムに関するレンダリング要件を持っています。

4.5.26 span要素

Element/span

すべての最新エンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLSpanElement

すべての最新エンジンでサポートされています。

Firefox1+ Safari6+ Chrome15+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
有形コンテンツ.
この要素が使用できる文脈:
フレージングコンテンツが期待される場所。
内容モデル:
フレージングコンテンツ.
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLSpanElement : HTMLElement {
   [HTMLConstructor] constructor();
 };

span要素自体は何も意味しませんが、グローバル属性と一緒に使用すると便利です。例としてclass、lang、またはdirがあります。この要素はその子要素を表します。

この例では、コードフラグメントが span 要素と class 属性を使用してマークアップされており、CSSからキーワードや識別子を色分けできるようにしています。

<pre><code class="lang-c"><span class="keyword">for</span> (<span class="ident">j</span> = 0; <span class="ident">j</span> &lt; 256; <span class="ident">j</span>++) {
   <span class="ident">i_t3</span> = (<span class="ident">i_t3</span> & 0x1ffff) | (<span class="ident">j</span> &lt;&lt; 17);
   <span class="ident">i_t6</span> = (((((((<span class="ident">i_t3</span> >> 3) ^ <span class="ident">i_t3</span>) >> 1) ^ <span class="ident">i_t3</span>) >> 8) ^ <span class="ident">i_t3</span>) >> 5) & 0xff;
   <span class="keyword">if</span> (<span class="ident">i_t6</span> == <span class="ident">i_t1</span>)
     <span class="keyword">break</span>;
 }</code></pre>

4.5.27 br要素

Element/br

すべての最新エンジンでサポートされています。

Firefox1+ Safari4+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLBRElement

すべての最新エンジンでサポートされています。

Firefox1+ Safari3+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS1+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
この要素が使用できる文脈:
フレージングコンテンツが期待される場所。
内容モデル:
なし.
text/htmlでのタグ省略:
終了タグなし。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLBRElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // 旧メンバーも含む
 };

br要素は改行を表します。

改行は通常、視覚メディアでは次のテキストを新しい行に物理的に移動させることで表されますが、スタイルシートやユーザーエージェントは、たとえば緑色の点として、または追加のスペースとして改行をレンダリングすることも同様に正当です。

br要素は、詩や住所のように、実際にコンテンツの一部としての改行にのみ使用されるべきです。

次の例は、br要素の正しい使用法です:

<p>P. Sherman<br>
42 Wallaby Way<br>
Sydney</p>

br要素は、段落内で主題別グループを分離するために使用されるべきではありません。

次の例は、br要素を誤用した非準拠の例です:

<p><a ...>34件のコメント.</a><br>
<a ...>コメントを追加.</a></p>
<p><label>名前: <input name="name"></label><br>
<label>住所: <input name="address"></label></p>

次の正しい例は、上記の代替として使用できます:

<p><a ...>34件のコメント.</a></p>
<p><a ...>コメントを追加.</a></p>
<p><label>名前: <input name="name"></label></p>
<p><label>住所: <input name="address"></label></p>

段落がbr要素だけで構成されている場合、それはプレースホルダーとしての空白行を表します（例: テンプレートでの使用）。このような空白行は、プレゼンテーション目的で使用してはなりません。

br要素内のコンテンツは、周囲のテキストの一部と見なされるべきではありません。

この要素は双方向アルゴリズムに関連するレンダリング要件を持ちます。

4.5.28 wbr要素

Element/wbr

すべての最新エンジンでサポートされています。

Firefox1+ Safari4+ Chrome1+
Opera11.6+ Edge79+
Edge (Legacy)? Internet Explorer5.5–7
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
この要素が使用できる文脈:
フレージングコンテンツが期待される場所。
内容モデル:
なし.
text/htmlでのタグ省略:
終了タグなし。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLElementを使用します。

wbr要素は改行の機会を表します。

次の例では、誰かが効果を狙って、1つの長い単語として書かれた何かを引用しています。ただし、テキストが読みやすい形で改行できるようにするために、引用内の個々の単語がwbr要素で区切られています。

<p>So then she pointed at the tiger and screamed
 "there<wbr>is<wbr>no<wbr>way<wbr>you<wbr>are<wbr>ever<wbr>going<wbr>to<wbr>catch<wbr>me"!</p>

wbr要素内のコンテンツは、周囲のテキストの一部と見なされるべきではありません。 

var wbr = document.createElement("wbr");
wbr.textContent = "This is wrong";
document.body.appendChild(wbr);

この要素は双方向アルゴリズムに関連するレンダリング要件を持ちます。

4.5.29 使用の概要

このセクションは規範的ではありません。

要素 目的 例
a ハイパーリンク 
Visit my <a href="drinks.html">drinks</a> page.
em 強調 
I must say I <em>adore</em> lemonade.
strong 重要性 
This tea is <strong>very hot</strong>.
small サイドコメント 
These grapes are made into wine. <small>Alcohol is addictive.</small>
s 不正確なテキスト 
Price: <s>£4.50</s> £2.00!
cite 作品のタイトル 
The case <cite>Hugo v. Danielle</cite> is relevant here.
q 引用 
The judge said <q>You can drink water from the fish tank</q> but advised against it.
dfn 定義 
The term <dfn>organic food</dfn> refers to food produced without synthetic chemicals.
abbr 略語 
Organic food in Ireland is certified by the <abbr title="Irish Organic Farmers and Growers Association">IOFGA</abbr>.
ruby, rt, rp ルビ注釈 
<ruby> OJ <rp>(<rt>Orange Juice</rp>)</ruby>
data 機械可読の値 
Available starting today! <data value="UPC:022014640201">North Coast Organic Apple Cider</data>
time 日付や時間の機械可読の値 
Available starting on <time datetime="2011-11-18">November 18th</time>!
code コンピュータコード 
The <code>fruitdb</code> program can be used for tracking fruit production.
var 変数 
If there are <var>n</var> fruit in the bowl, at least <var>n</var>÷2 will be ripe.
samp コンピュータの出力 
The computer said <samp>Unknown error -3</samp>.
kbd ユーザー入力 
Hit <kbd>F1</kbd> to continue.
sub 下付き文字 
Water is H<sub>2</sub>O.
sup 上付き文字 
The Hydrogen in heavy water is usually <sup>2</sup>H.
i 別の声 
Lemonade consists primarily of <i>Citrus limon</i>.
b キーワード 
Take a <b>lemon</b> and squeeze it with a <b>juicer</b>.
u 注釈 
The mixture of apple juice and <u class="spelling">eldeflower</u> juice is very pleasant.
mark ハイライト 
Elderflower cordial, with one <mark>part</mark> cordial to ten <mark>part</mark>s water, stands a<mark>part</mark> from the rest.
bdi テキストの方向性の分離 
The recommended restaurant is <bdi lang="">My Juice Café (At The Beach)</bdi>.
bdo テキストの方向性の書式設定 
The proposal is to write English, but in reverse order. "Juice" would become "<bdo dir=rtl>Juice</bdo>">
span その他 
In French we call it <span lang="fr">sirop de sureau</span>.
br 改行 
Simply Orange Juice Company<br>Apopka, FL 32703<br>U.S.A.
wbr 改行可能な位置 
www.simply<wbr>orange<wbr>juice.com

4.6.1 イントロダクション

リンクは、a、area、form、およびlink要素によって作成される概念的な構成です。これらは、現在のドキュメントと他のリソースとの間に接続を表します。HTMLには3種類のリンクがあります:

外部リソースへのリンク

これらは現在のドキュメントを補完するために使用されるリソースへのリンクであり、一般的にユーザーエージェントによって自動的に処理されます。すべての外部リソースへのリンクは、リソースの取得と処理を説明するリソースを取得して処理するアルゴリズムを持っています。

ハイパーリンク

これらは他のリソースへのリンクであり、ユーザーエージェントによって一般的にユーザーに公開され、ユーザーがこれらのリソースにナビゲートできるようにします。例えば、ブラウザでそれらを訪問したり、ダウンロードしたりすることができます。

内部リソースへのリンク

これらは現在のドキュメント内のリソースへのリンクであり、これらのリソースに特別な意味や動作を与えるために使用されます。

link要素にhref属性およびrel属性がある場合、rel属性のキーワードに対してリンクが作成されなければなりません。

同様に、aおよびarea要素にhref属性およびrel属性がある場合、リンクはリンクタイプセクションで定義されたキーワードに対しても作成されなければなりません。

同様に、form要素にrel属性がある場合、rel属性のキーワードに対してリンクが作成されなければなりません。

ハイパーリンクには、そのハイパーリンクの処理セマンティクスを変更する1つまたは複数のハイパーリンク注釈を持つことができます。

a および area 要素の href 属性は、有効なURL（スペースで囲まれている場合もあり）でなければなりません。

href 属性は必須ではありません。a および area 要素が href 属性を持たない場合、それらはハイパーリンクを作成しません。

target 属性が存在する場合、その値は 有効なナビゲーブルターゲット名またはキーワード でなければなりません。これは使用されるナビゲーブル の名前を指定します。ユーザーエージェントは、ハイパーリンクをたどる際にこの名前を使用します。

download 属性が存在する場合、著者がそのハイパーリンクを リソースのダウンロード に使用する意図があることを示します。この属性には値を持たせることができます。値が指定されている場合、その値はローカルファイルシステムでリソースをラベル付けするために推奨されるデフォルトのファイル名を指定します。許可される値に制限はありませんが、ほとんどのファイルシステムにはファイル名でサポートされる句読点に制限があるため、ユーザーエージェントはファイル名を適宜調整する可能性があることに注意が必要です。

Element/a#attr-ping

Support in all current engines.

Firefox🔰 1+Safari6+Chrome12+
Opera?Edge79+
Edge (Legacy)17+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android≤37+Samsung Internet?Opera Android?

ping 属性が存在する場合、ユーザーがハイパーリンクをたどる際に通知を受け取りたいリソースのURLを指定します。値は 空白で区切られたトークンのセット でなければならず、それぞれが 有効な非空のURL でなければならず、その スキーム は HTTP(S) スキーム でなければなりません。この値はユーザーエージェントが ハイパーリンク監査 に使用します。

rel 属性は、a 要素と area 要素に対して、どの種類のリンクを作成するかを制御します。この属性の値は 一意の空白で区切られたトークンの非順序セット でなければなりません。許可されるキーワードとその意味 は以下に定義されています。

rel の サポートされているトークン は、HTML リンクタイプ に定義されたキーワードであり、a 要素と area 要素で許可されているもので、処理モデルに影響を与え、ユーザーエージェントによってサポートされています。可能な サポートされているトークン は noreferrer、noopener、および opener です。rel の サポートされているトークン には、ユーザーエージェントが処理モデルを実装しているこのリストのトークンのみが含まれている必要があります。

rel 属性にはデフォルト値がありません。属性が省略されているか、属性内のいずれの値もユーザーエージェントによって認識されない場合、文書はリンク先リソースとの特定の関係を持たず、2つの間にハイパーリンクが存在するだけです。

hreflang 属性は、a 要素が ハイパーリンク を作成する場合、リンク先リソースの言語を指定します。これは純粋に助言的なものです。値は有効な BCP 47 言語タグでなければなりません。[BCP47] ユーザーエージェントは、この属性を権威あるものと見なしてはなりません。リソースを取得すると、ユーザーエージェントは、リソースに関連付けられた言語情報のみを使用して、その言語を判断し、リンクに含まれるメタデータを使用してはなりません。

type 属性が存在する場合、リンクされたリソースの MIME タイプ を指定します。これは純粋に助言的なものです。値は 有効な MIME タイプ文字列 でなければなりません。ユーザーエージェントは、リソースにリンクされたメタデータを使用してリソースのタイプを判断してはなりません。

referrerpolicy 属性は 参照ポリシー属性 です。その目的は、参照ポリシー を設定することです。[REFERRERPOLICY] に従って、ハイパーリンクをたどる 際に使用されます。

a または area 要素の アクティベーション動作 が呼び出されると、ユーザーエージェントはユーザーに対し、ハイパーリンクがナビゲーションに使用されるか、指定されたリソースがダウンロードされるかの選択肢を与えることがあります。

ユーザーの選好がない場合、要素に download 属性がない場合はデフォルトでナビゲーションが選択され、属性がある場合は指定されたリソースのダウンロードが選択されます。

a または area 要素の アクティベーション動作 は次の通りです：

  1. 要素に href 属性がない場合、何も行いません。

  2. hyperlinkSuffix を null に設定します。

  3. 要素が a 要素であり、イベントの target が img で、ismap 属性が指定されている場合:

    1. x および y を 0 に設定します。

    2. イベントの isTrusted 属性が true に初期化されている場合、クリック位置から画像の左端までの距離を x に設定し、クリック位置から画像の上端までの距離を y に設定します。

    3. x が負の場合、x を 0 に設定します。

    4. y が負の場合、y を 0 に設定します。

    5. hyperlinkSuffix を U+003F (?), x の値を基数 10 の整数として ASCII 数字で表現したもの、U+002C (,) 、および y の値を基数 10 の整数として ASCII 数字で表現したものの連結として設定します。

  4. ユーザーの関与をイベントの user navigation involvement として設定します。

  5. ユーザーがハイパーリンクをダウンロードすることを希望している場合、userInvolvement を "browser UI" に設定します。

    つまり、ユーザーがダウンロードを特に希望している場合、これは単に "activation" としてはカウントされません。

  6. element に download 属性がある場合、またはユーザーがハイパーリンクをダウンロードすることを希望している場合、element によって作成されたハイパーリンクを、hyperlinkSuffix に hyperlinkSuffix を設定し、userInvolvement に userInvolvement を設定して ダウンロード します。

  7. それ以外の場合、ハイパーリンクをフォローします。この際、hyperlinkSuffix を hyperlinkSuffix として、userInvolvement を userInvolvement として設定します。

4.6.3 aおよびarea要素のAPI

interface mixin HTMLHyperlinkElementUtils {
   [CEReactions] stringifier attribute USVString href;
   readonly attribute USVString origin;
   [CEReactions] attribute USVString protocol;
   [CEReactions] attribute USVString username;
   [CEReactions] attribute USVString password;
   [CEReactions] attribute USVString host;
   [CEReactions] attribute USVString hostname;
   [CEReactions] attribute USVString port;
   [CEReactions] attribute USVString pathname;
   [CEReactions] attribute USVString search;
   [CEReactions] attribute USVString hash;
 };
hyperlink.toString()
hyperlink.href

HTMLAnchorElement/href

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (古いバージョン)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLAnchorElement/toString

すべての現在のエンジンでサポートされています。

Firefox22+Safari3+Chrome52+
Opera?Edge79+
Edge (古いバージョン)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLAreaElement/href

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (古いバージョン)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLAreaElement/toString

すべての現在のエンジンでサポートされています。

Firefox22+Safari10.1+Chrome32+
Opera?Edge79+
Edge (古いバージョン)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ハイパーリンクの URL を返します。

URL を変更するために設定できます。

hyperlink.origin

HTMLAnchorElement/origin

すべての現在のエンジンでサポートされています。

Firefox26+Safari5.1+Chrome8+
Opera?Edge79+
Edge (レガシー)17+Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android?

HTMLAreaElement/origin

すべての現在のエンジンでサポートされています。

Firefox26+Safari10+Chrome32+
Opera?Edge79+
Edge (レガシー)17+Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?

ハイパーリンクの URL の起源を返します。

hyperlink.protocol

HTMLAnchorElement/protocol

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLAreaElement/protocol

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ハイパーリンクの URL のスキームを返します。

URL のスキームを変更するために設定できます。

hyperlink.username

HTMLAnchorElement/username

すべての現在のエンジンでサポートされています。

Firefox26+ Safari10+ Chrome32+
Opera? Edge79+
Edge (Legacy)? Internet Explorerなし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLAreaElement/username

すべての現在のエンジンでサポートされています。

Firefox26+ Safari10+ Chrome32+
Opera? Edge79+
Edge (Legacy)? Internet Explorerなし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ハイパーリンクのURLのユーザー名を返します。

設定することで、URLのユーザー名を変更できます。

hyperlink.password

HTMLAnchorElement/password

すべての現在のエンジンでサポートされています。

Firefox26+ Safari10+ Chrome32+
Opera? Edge79+
Edge (Legacy)? Internet Explorerなし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLAreaElement/password

すべての現在のエンジンでサポートされています。

Firefox26+ Safari10+ Chrome32+
Opera? Edge79+
Edge (Legacy)? Internet Explorerなし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ハイパーリンクのURLのパスワードを返します。

設定することで、URLのパスワードを変更できます。

hyperlink.host

HTMLAnchorElement/host

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLAreaElement/host

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ハイパーリンクのURLのホストとポート（スキームのデフォルトポートと異なる場合）を返します。

設定することで、URLのホストとポートを変更できます。

hyperlink.hostname

HTMLAnchorElement/hostname

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLAreaElement/hostname

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ハイパーリンクのURLのドメインを返します。

設定することで、URLのドメインを変更できます。

hyperlink.port

HTMLAnchorElement/port

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLAreaElement/port

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ハイパーリンクの URL のポートを返します。

URL のポートを変更するために設定できます。

hyperlink.pathname

HTMLAnchorElement/pathname

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLAreaElement/pathname

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ハイパーリンクの URL のパスを返します。

URL のパスを変更するために設定できます。

hyperlink.search

HTMLAnchorElement/search

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLAreaElement/search

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ハイパーリンクの URL のクエリを返します（非空の場合、先頭の "?" を含む）。

URL のクエリを変更するために設定できます（先頭の "?" は無視されます）。

hyperlink.hash

HTMLAnchorElement/hash

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLAreaElement/hash

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer5.5+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ハイパーリンクの URL のフラグメントを返します（非空の場合、先頭の "#" を含む）。

URL のフラグメントを変更するために設定できます（先頭の "#" は無視されます）。

HTMLHyperlinkElementUtilsミックスインを実装する要素には、関連付けられたURL（null またはURL）があり、初期状態ではnullです。

HTMLHyperlinkElementUtilsミックスインを実装する要素には、関連付けられたURLを設定するアルゴリズムがあり、次の手順を実行します:

  1. この要素のURLをnullに設定します。

  2. この要素のhrefコンテンツ属性が存在しない場合は、手順を終了します。

  3. この要素のhrefコンテンツ属性の値を、この要素のノードドキュメントに対して、URLのエンコードと解析を行った結果をurlとします。

  4. もしurlが失敗しなかった場合、この要素のURLをurlに設定します。

HTMLHyperlinkElementUtilsミックスインを実装する要素が作成されたとき、またはそれらの要素のhrefコンテンツ属性が設定、変更、または削除されたとき、ユーザーエージェントはURLを設定する必要があります。

これは、blob:URLに対してのみ観察可能です。解析が行われるときにBlob URL ストアの検索が関与するためです。

HTMLHyperlinkElementUtilsミックスインを実装する要素には、関連付けられたURLを再初期化するアルゴリズムがあり、次の手順を実行します:

  1. 要素のURLがnullではなく、そのスキームが "blob" であり、不透明なパスを持っている場合、これらの手順を終了します。

  2. URLを設定する。

hrefを更新するには、要素のhrefコンテンツ属性の値を、要素のURLにシリアライズされたものに設定します。

href の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null であり、this が href コンテンツ属性を持たない場合、空文字列を返します。

  4. それ以外の場合、もし url が null であれば、this の href コンテンツ属性の値を返します。

  5. url をシリアライズして返します。

href の setter 手順は、this の href コンテンツ属性の値を与えられた値に設定することです。

origin の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. もし this の URL が null であれば、空文字列を返します。

  3. オリジンのシリアライズを行い、その結果を返します。this の URL の オリジンを使用します。

protocol の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. もし this の URL が null であれば、":" を返します。

  3. this の URL の スキーム に ":" を付けて返します。

protocol の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. もし this の URL が null であれば、手順を終了します。

  3. 与えられた値に ":" を付けて、基本 URL 解析を行います。this の URL を URL として、スキーム開始状態として使用します。

  4. URL パーサーは複数の連続するコロンを無視するため、"https:" や "https::::" のような値を指定しても、"https" と同じ結果になります。

  5. href を更新します。

username の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. もし this の URL が null であれば、空文字列を返します。

  3. this の URL の ユーザー名 を返します。

username の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url が ユーザー名/パスワード/ポートを持てない場合、手順を終了します。

  4. ユーザー名を設定します。url と与えられた値を使用します。

  5. href を更新します。

password の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null であれば、空文字列を返します。

  4. url の パスワード を返します。

password の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url が ユーザー名/パスワード/ポートを持てない場合、手順を終了します。

  4. パスワードを設定します。url と与えられた値を使用します。

  5. href を更新します。

host の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url または url の ホスト が null であれば、空文字列を返します。

  4. もし url の ポート が null であれば、url の ホスト をシリアライズして返します。

  5. url の ホスト をシリアライズして返します。":" と url の ポート をシリアライズして返します。

host の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url が 不透明なパスを持つ場合、手順を終了します。

  4. 基本 URL 解析 を与えられた値で行い、url と url として、ホスト状態を 状態オーバーライドとして使用します。

  5. href を更新します。

hostname の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url または url の ホスト が null であれば、空文字列を返します。

  4. url の ホスト をシリアライズして返します。

hostname の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url が 不透明なパスを持つ場合、手順を終了します。

  4. 基本 URL 解析 を与えられた値で行い、url と url として、ホスト名の状態を 状態オーバーライドとして使用します。

  5. href を更新します。

port の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url または url の ポート が null であれば、空文字列を返します。

  4. url の ポート をシリアライズして返します。

port の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url が ユーザー名/パスワード/ポートを持てない場合、手順を終了します。

  4. 与えられた値が空文字列であれば、url の ポート を null に設定します。

  5. それ以外の場合は、基本 URL 解析 を行い、url を url として、ポート状態を 状態オーバーライドとして使用します。

  6. href を更新します。

pathname の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null であれば、空文字列を返します。

  4. url の URL パスをシリアライズ して返します。

pathname の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url が 不透明なパスを持つ場合、手順を終了します。

  4. url の パス を空のリストに設定します。

  5. 基本 URL 解析 を行い、url を url として、パス開始状態を 状態オーバーライドとして使用します。

  6. href を更新します。

search の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url の クエリ が null または空文字列であれば、空文字列を返します。

  4. url の クエリ の前に "?" を付けて返します。

search の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null であれば、手順を終了します。

  4. 与えられた値が空文字列であれば、url の クエリ を null に設定します。

  5. それ以外の場合:

    1. 与えられた値から先頭の "?" を 1 つ取り除いたものを input とします。

    2. url の クエリ を空文字列に設定します。

    3. 基本 URL 解析 を行い、url を url として、クエリ状態を 状態オーバーライドとして使用します。

  6. href を更新します。

hash の getter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null または url の フラグメント が null または空文字列であれば、空文字列を返します。

  4. url の フラグメント の前に "#" を付けて返します。

hash の setter 手順は次の通りです:

  1. URL を再初期化します。

  2. url を this の URL に設定します。

  3. もし url が null であれば、手順を終了します。

  4. 与えられた値が空文字列であれば、url の フラグメント を null に設定します。

  5. それ以外の場合:

    1. 与えられた値から先頭の "#" を 1 つ取り除いたものを input とします。

    2. url の フラグメント を空文字列に設定します。

    3. 基本 URL 解析 を行い、url を url として、フラグメント状態を 状態オーバーライドとして使用します。

  6. href を更新します。

以下のいずれかが該当する場合、要素 element はナビゲートできません:

これは、フォームの送信 にも使用されます。

a、area、または form 要素 element、URLレコード url、および 文字列 target を指定して、要素のnoopenerを取得するには、次の手順を実行します。これらはブール値を返します。

  1. element のリンクタイプにnoopenerまたはnoreferrer キーワードが含まれている場合は、trueを返します。

  2. element のリンクタイプにopener キーワードが含まれておらず、target が「_blank」のASCII大文字小文字を区別しない一致である場合は、trueを返します。

  3. url のBLOB URLエントリがnullでない場合：

    1. blobOrigin をurl のBLOB URLエントリの環境のオリジンとします。

    2. topLevelOrigin をelement の関連する設定オブジェクトのトップレベルオリジンとします。

    3. blobOrigin がtopLevelOrigin と同一サイトでない場合は、trueを返します。

  4. falseを返します。

要素 subject によって作成されたハイパーリンクをたどるには、オプションの hyperlinkSuffix (デフォルトは null) およびオプションの userInvolvement (デフォルトは「none」) を指定します：

  1. もし subject が ナビゲートできない場合、処理を終了します。

  2. targetAttributeValue を空文字列に設定します。

  3. もし subject が a または area 要素である場合、targetAttributeValue を 要素のターゲットを取得した結果に設定します。

  4. urlRecord を、subject の href 属性値を、subject の ノードドキュメントを基準としてURLのエンコーディング解析した結果とします。

  5. urlRecord が失敗の場合、戻ります。

  6. noopener を、subject、urlRecord、および targetAttributeValue を用いて要素の noopener を取得した結果とします。

  7. targetNavigable を ナビゲート可能な要素を選ぶルールを適用して得られる最初の値に設定します。

  8. もし targetNavigable が null である場合、処理を終了します。

  9. urlString を、urlRecord にURLシリアライザを適用した結果とします。

  10. もし hyperlinkSuffix が null でない場合、urlString に付加します。

  11. referrerPolicy を subject の referrerpolicy コンテンツ属性の現在の状態に設定します。

  12. もし subject の リンクタイプ が noreferrer キーワードを含む場合、referrerPolicy を "no-referrer" に設定します。

  13. subject のノードドキュメントを使用して、referrerPolicy を referrerPolicy に設定し、userInvolvement を userInvolvement に設定し、そして sourceElement を subject に設定して、targetNavigable を urlString へナビゲートします。

    ハイパーリンクのフォローには、完全にロードされていないドキュメントに対して特別な「置換」動作はありません。

4.6.5 リソースのダウンロード

HTMLAnchorElement/download

すべての現在のエンジンでサポートされています。

Firefox20+Safari10.1+Chrome15+
Opera?Edge79+
Edge (旧バージョン)13+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

場合によっては、リソースはすぐに表示されるのではなく、後で使用されることを意図しています。リソースがすぐに使用されるのではなく、後でダウンロードされることを示すには、download属性をそのリソースへのハイパーリンクを作成するaまたはarea要素に指定できます。

さらに、この属性には値を指定して、ユーザーエージェントがリソースをファイルシステムに保存する際に使用するファイル名を指定することもできます。この値は、`Content-Disposition` HTTPヘッダーのファイル名パラメータによって上書きされることがあります。[RFC6266]

クロスオリジンの状況では、download属性を`Content-Disposition` HTTPヘッダー、特にattachmentディスポジションタイプと組み合わせて使用する必要があります。これは、ユーザーが悪意のある活動の可能性を警告されるのを防ぐためです。 (これは、ユーザーが意識せずに個人情報や機密情報をダウンロードさせられるのを防ぐためです。)

ダウンロードするために、要素subjectが作成したハイパーリンクを、オプションのhyperlinkSuffix（デフォルトはnull）およびオプションのuserInvolvement（デフォルトは"none"）とともにフォローします。

  1. もしsubjectがナビゲートできない場合、処理を終了します。

  2. もしsubjectのノードドキュメントのアクティブサンドボックスフラグセットがサンドボックス化されたダウンロード閲覧コンテキストフラグを持っている場合、処理を終了します。

  3. urlStringを、subjectのhref属性値を基にURLのエンコード、パース、およびシリアライズした結果に設定します。

  4. もしurlStringが失敗した場合、処理を終了します。

  5. もしhyperlinkSuffixがnullでない場合、urlStringに追加します。

  6. もしuserInvolvementが"ブラウザUI"でない場合:

    1. アサート: subjectがdownload属性を持っていることを確認します。

    2. navigationをsubjectの関連するグローバルオブジェクトのナビゲーションAPIに設定します。

    3. filenameをsubjectのdownload属性の値に設定します。

    4. continue を、navigation でdestinationURL を urlString に設定し、userInvolvement を userInvolvement に設定し、sourceElement を subject に設定し、そしてfilename を filename に設定してダウンロードリクエストのnavigateイベントを発火させた結果とします。

    5. もしcontinueがfalseの場合、処理を終了します。

  7. 並行して次の手順を実行します:

    1. 必要に応じて、ユーザーエージェントはこれらの手順を中止することができます。もしそうすることがユーザーを潜在的な悪意のあるダウンロードから保護すると考えられる場合。

    2. requestをリクエストに新たに設定します。そのURLをurlStringに設定し、クライアントをエントリ設定オブジェクトに設定し、イニシエータを"download"に設定し、宛先を空の文字列に設定し、同期フラグおよびURL認証情報フラグを設定します。

    3. request をフェッチした結果をダウンロードとして処理します。

レスポンス response をダウンロードとして処理するには：

  1. suggestedFilename を、response の推奨ファイル名を取得した結果とします。

  2. ユーザーに response を後で使用するために保存する方法を提供します。ユーザーエージェントがファイル名を必要とする場合は、suggestedFilename を使用する必要があります。ファイルのダウンロードに関する問題があればユーザーに報告します。

  3. suggestedFilename を返します。

レスポンス response の推奨ファイル名を取得するには：

このアルゴリズムは、信頼できないサイトからのファイルのダウンロードに関わるセキュリティリスクを軽減することを目的としており、ユーザーエージェントはこれに従うことが強く推奨されます。

  1. filename を未定義値とします。

  2. response が `Content-Disposition` ヘッダーを持ち、そのヘッダーがattachment dispositionタイプを指定し、かつヘッダーにファイル名情報が含まれている場合、filename にヘッダーで指定された値を設定し、以下のサニタイズとラベル付けされたステップにジャンプします。[RFC6266]

  3. interface origin を、ダウンロードまたはダウンロードに至ったナビゲートアクションが開始されたDocumentのオリジンとします（もしあれば）。

  4. response origin をresponseのURLのオリジンとします。ただし、そのURLのスキームコンポーネントがdataである場合は、response originをinterface origin（もしあれば）と同じとします。

  5. interface origin がない場合、trusted operation をtrueとします。それ以外の場合、response origin がinterface origin と同一オリジンである場合はtrusted operation をtrueとし、そうでない場合はfalseとします。

  6. trusted operation がtrueであり、かつresponse が `Content-Disposition` ヘッダーを持ち、かつそのヘッダーにファイル名情報が含まれている場合、filename にヘッダーで指定された値を設定し、以下のサニタイズとラベル付けされたステップにジャンプします。[RFC6266]

  7. ダウンロードがaまたはarea要素によって作成されたハイパーリンクから開始されなかった場合、またはそれが開始されたハイパーリンクの要素がダウンロード開始時にdownload属性を持っていなかった場合、またはそのような属性があったがダウンロード開始時のその値が空の文字列であった場合は、提案されたファイル名なしとラベル付けされたステップにジャンプします。

  8. proposed filename に、ダウンロード開始時にダウンロードを開始したハイパーリンクの要素のdownload属性の値を設定します。

  9. trusted operation がtrueの場合、filename にproposed filenameの値を設定し、以下のサニタイズとラベル付けされたステップにジャンプします。

  10. response が `Content-Disposition` ヘッダーを持ち、かつそのヘッダーがattachment dispositionタイプを指定する場合、filename にproposed filenameの値を設定し、以下のサニタイズとラベル付けされたステップにジャンプします。[RFC6266]

  11. 提案されたファイル名なし：trusted operation がtrueである場合、またはユーザーが問題のレスポンスをダウンロードすることを優先すると示した場合は、filename にresponseのURLから実装定義の方法で導出された値を設定し、以下のサニタイズとラベル付けされたステップにジャンプします。

  12. filename をユーザーの優先ファイル名またはユーザーエージェントによって選択されたファイル名に設定し、以下のサニタイズとラベル付けされたステップにジャンプします。

    アルゴリズムがこのステップに到達した場合、ダウンロードはresponseとは異なるオリジンから開始され、オリジンはファイルをダウンロードに適しているとマークせず、ダウンロードはユーザーによって開始されませんでした。これは、download属性がダウンロードをトリガーするために使用されたため、またはresponseがユーザーエージェントがサポートするタイプではないためである可能性があります。

    これは危険である可能性があります。たとえば、悪意のあるサーバーが、ユーザーにデータが悪意のあるサーバーからのものであると誤認させることによって、ユーザーに気付かれずに個人情報をダウンロードさせ、その後悪意のあるサーバーに再アップロードさせようとする可能性があります。

    したがって、ユーザーがresponseがまったく異なるソースからのものであることを何らかの方法で通知され、混乱を防ぐために、潜在的に悪意のあるinterface originからの提案されたファイル名は無視されるべきであることは、ユーザーの利益になります。

  13. サニタイズ：オプションで、ユーザーがfilenameに影響を与えることを許可します。たとえば、ユーザーエージェントはユーザーにファイル名を要求し、上記で決定されたfilenameの値をデフォルト値として提供する可能性があります。

  14. filename をローカルファイルシステムに適するように調整します。

    たとえば、これにはファイル名で許可されていない文字の削除や、先頭および末尾の空白のトリミングが含まれる場合があります。

  15. プラットフォームの慣例がファイルシステム上のファイルのタイプを決定するために拡張子を一切使用しない場合は、filename をファイル名として返します。

  16. claimed type を、responseのContent-Typeメタデータによって与えられるタイプとします（もしあれば）。named type を、filenameの拡張子によって与えられるタイプとします（もしあれば）。このステップの目的のために、タイプとは、MIMEタイプから拡張子へのマッピングです。

  17. named type がユーザーの好みと一致する場合（たとえば、filenameの値がユーザーへのプロンプトによって決定されたため）、filename をファイル名として返します。

  18. claimed type とnamed type が同じタイプである場合（つまり、responseのContent-Typeメタデータによって与えられるタイプがfilenameの拡張子によって与えられるタイプと一致する場合）、filename をファイル名として返します。

  19. claimed type が既知である場合は、filename を変更して、claimed typeに対応する拡張子を追加します。

    そうでなければ、もしnamed typeが潜在的に危険であると知られている場合（例えば、プラットフォームの慣習によってネイティブ実行可能ファイル、シェルスクリプト、HTMLアプリケーション、または実行可能マクロ対応ドキュメントとして扱われる場合）、その場合、オプションでfilenameを変更して、既知の安全な拡張子（例えば ".txt"）を追加する。

    この最後のステップでは、実行可能ファイルをダウンロードできなくなるため、望ましくない場合があります。いつものように、実装者はこの問題に関してセキュリティとユーザビリティのバランスを取ることを余儀なくされます。

  20. filename をファイル名として返します。

このアルゴリズムの目的のために、ファイル拡張子とは、プラットフォームの慣例がファイルの種類を識別するために使用するファイル名の一部を指します。例えば、多くのオペレーティングシステムでは、ファイル名の最後のドット（"."）に続く部分を使用してファイルの種類を決定し、それに基づいてファイルの開き方や実行方法を決定します。

ユーザーエージェントは、レスポンス自体、そのURL、および任意のdownload属性によって提供されるディレクトリまたはパス情報を無視して、結果のファイルをユーザーのファイルシステムのどこに保存するかを決定する必要があります。

もし、ハイパーリンクがaまたはarea要素によって作成され、そのハイパーリンクがping属性を持っており、ユーザーがそのハイパーリンクをたどり、その要素のhref属性の値が、要素のノード文書に対して問題なく解析できる場合、ユーザーエージェントはping属性の値を、ASCII空白でその文字列を分割し、結果として得られる各トークンを要素のノード文書に対して解析し、その後、解析に失敗した場合を無視して、各結果URLのping URLについて、次の手順を実行しなければなりません:

  1. ping URLのスキームがHTTP(S)スキームでない場合、終了します。

  2. 任意で、終了します。（例えば、ユーザーエージェントはユーザーの表明された好みに従って、任意のping URLを無視することができます。）

  3. settingsObjectを要素のノード文書の関連する設定オブジェクトとします。

  4. requestを新しいリクエストとし、そのURLをping URLとし、メソッドを`POST`とし、ヘッダーリストを« (`Content-Type`, `text/ping`) »とし、ボディを`PING`とし、クライアントをsettingsObjectとし、宛先を空文字列とし、クレデンシャルモードを"include"とし、リファラーを"no-referrer"とし、URLクレデンシャルフラグを設定し、イニシエータータイプを"ping"とします。

  5. target URLを要素のhref属性の値を基に要素のノード文書に対してURLをエンコード、パース、シリアライズする結果とし、次に:

    監査対象のハイパーリンクを含む文書オブジェクトのURLとping URLが同一オリジンの場合
    オリジンが異なるが、監査対象のハイパーリンクを含む文書のURLのスキームが"https"でない場合
    requestには、監査対象のハイパーリンクを含む文書のURLを値として持つ`Ping-From`ヘッダーと、target URLを値として持つ`Ping-To`HTTPヘッダーを含める必要があります。
    その他の場合
    requestには、target URLを値として持つ`Ping-To`HTTPヘッダーを含める必要があります。requestには、`Ping-From`ヘッダーは含まれません。

  6. リクエストをフェッチします。

これは、主なフェッチと並行して行われることがあり、そのフェッチの結果とは無関係です。

ユーザーエージェントは、例えばHTTP `Referer`（参照）ヘッダーの送信を無効にする設定と組み合わせて、この動作を調整できるようにすべきです。ユーザーの好みに基づき、UAsは無視するか、リスト内の特定のURLを無視することができます（例: サードパーティURLを無視するなど）。これは、上記の手順で明示的に考慮されています。

ユーザーエージェントは、レスポンスに含まれるエンティティボディを無視しなければなりません。ユーザーエージェントは、レスポンスボディの受信を開始した後、接続を早期に閉じることができます。

ping属性が存在する場合、ユーザーエージェントは、ハイパーリンクをたどることで背景で二次的なリクエストが送信されることをユーザーに明確に示すべきです。場合によっては、実際のターゲットURLをリスト表示することも考えられます。

例えば、ビジュアルユーザーエージェントは、ステータスバーやツールチップに、ハイパーリンクの実際のURLとともにターゲットping URLのホスト名を表示することができます。

ping属性は、最も人気のあるオフサイトリンクを追跡したり、広告主がクリック率を追跡したりするためにウェブページが使用する、HTTPリダイレクトやJavaScriptのような既存の技術と冗長です。

しかし、ping属性は、これらの代替手段に対して次の利点をユーザーに提供します:

したがって、この機能がなくてもユーザーを追跡することは可能ですが、著者は、ユーザーエージェントがユーザー体験をより透明にするためにping属性を使用することを推奨します。

4.6.6.1 `Ping-From`ヘッダーと`Ping-To`ヘッダー

`Ping-From`ヘッダーと`Ping-To`HTTPリクエストヘッダーは、ハイパーリンク監査リクエストに含まれます。これらの値は、URLであり、シリアライズされたものです。

4.6.7 リンクタイプ

リンクタイプ

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

リンクタイプ

以下の表は、この仕様で定義されたリンクタイプを、それぞれのキーワードに基づいてまとめたものです。この表は規範的ではなく、リンクタイプの実際の定義は次のいくつかのセクションで示されています。

このセクションでは、参照された文書という用語は、リンクを表す要素によって識別されるリソースを指し、現在の文書という用語は、そのリンクを表す要素が見つかるリソースを指します。

link、a、area、またはform要素に適用されるリンクタイプを判断するには、その要素のrel属性をASCII空白で分割する必要があります。結果として得られるトークンは、その要素に適用されるリンクタイプのキーワードです。

特に指定がない限り、キーワードは各rel属性につき一度だけ指定する必要があります。

以下の表の後のいくつかのセクションでは、特定のキーワードの同義語が記載されています。指定された同義語は、ユーザーエージェントによって指定されたとおりに処理される必要がありますが、文書内で使用してはなりません（例えば、キーワード"copyright"）。

キーワードは常にASCII大文字小文字を区別しません。比較もそのように行わなければなりません。

したがって、rel="next"はrel="NEXT"と同じです。

body-okなキーワードは、link要素がボディに許可されているかどうかに影響します。body-okなキーワードは、dns-prefetch、modulepreload、pingback、preconnect、prefetch、preload、およびstylesheetです。

ウェブブラウザによって実装される新しいリンクタイプは、この標準に追加されるべきです。残りの部分は拡張として登録できます。

4.6.7.1 リンクタイプ"alternate"

代替スタイルシート

1つのエンジンでのみサポートされています。

Firefox3+Safari?Chrome1–48
OperaYesEdgeNo
Edge (Legacy)?Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

alternateキーワードは、link、a、およびarea要素で使用できます。

このキーワードの意味は、他の属性の値によって異なります。

要素がlink要素であり、rel属性にstylesheetキーワードも含まれている場合

alternateキーワードは、stylesheetキーワードの意味をそのキーワードに記載されている方法で修正します。alternateキーワード自体はリンクを作成しません。

ここでは、いくつかのスタイルシートを提供するlink要素のセットを示します:

<!-- 永続的なスタイルシート -->
<link rel="stylesheet" href="default.css">

<!-- 推奨される代替スタイルシート -->
<link rel="stylesheet" href="green.css" title="Green styles">

<!-- いくつかの代替スタイルシート -->
<link rel="alternate stylesheet" href="contrast.css" title="High contrast">
<link rel="alternate stylesheet" href="big.css" title="Big fonts">
<link rel="alternate stylesheet" href="wide.css" title="Wide screen">
alternateキーワードがtype属性にapplication/rss+xmlまたはapplication/atom+xmlの値が設定されている場合

このキーワードは、シンジケーションフィード（必ずしも現在のページと同じコンテンツをシンジケートするわけではない）を参照するハイパーリンクを作成します。

フィードの自動検出の目的で、ユーザーエージェントは、alternateキーワードを使用し、type属性にapplication/rss+xmlまたはapplication/atom+xmlの値が設定されている文書内のすべてのlink要素を考慮する必要があります。ユーザーエージェントがデフォルトのシンジケーションフィードの概念を持っている場合、最初の要素（ツリー順）をデフォルトとして使用する必要があります。

次のlink要素は、ブログのシンジケーションフィードを提供します: 

<link rel="alternate" type="application/atom+xml" href="posts.xml" title="Cool Stuff Blog">
<link rel="alternate" type="application/atom+xml" href="posts.xml?category=robots" title="Cool Stuff Blog: robots category">
<link rel="alternate" type="application/atom+xml" href="comments.xml" title="Cool Stuff Blog: Comments">

これらのlink要素は、フィード自動検出に従事しているユーザーエージェントによって使用され、最初の要素がデフォルトとして使用されます（該当する場合）。

次の例では、a要素を使用して、さまざまなシンジケーションフィードをユーザーに提供します: 

<p>You can access the planets database using Atom feeds:</p>
<ul>
<li><a href="recently-visited-planets.xml" rel="alternate" type="application/atom+xml">Recently Visited Planets</a></li>
<li><a href="known-bad-planets.xml" rel="alternate" type="application/atom+xml">Known Bad Planets</a></li>
<li><a href="unexplored-planets.xml" rel="alternate" type="application/atom+xml">Unexplored Planets</a></li>
</ul>

これらのリンクは、フィード自動検出では使用されません。

その他の場合

このキーワードは、現在の文書の代替表現を参照するハイパーリンクを作成します。

参照された文書の性質は、hreflangおよびtype属性によって示されます。

alternateキーワードがhreflang属性と共に使用され、その属性の値が文書要素の言語と異なる場合、それは参照された文書が翻訳であることを示します。

alternateキーワードがtype属性と共に使用される場合、それは参照された文書が指定された形式での現在の文書の再構成であることを示します。

hreflangおよびtype属性は、alternateキーワードと共に指定される場合、組み合わせて使用できます。

次の例では、他の言語を対象とし、他のメディアを対象とする代替フォーマットを使用したページのバージョンを指定する方法を示します:

<link rel=alternate href="/en/html" hreflang=en type=text/html title="English HTML"> 
<link rel=alternate href="/fr/html" hreflang=fr type=text/html title="French HTML"> 
<link rel=alternate href="/en/html/print" hreflang=en type=text/html media=print title="English HTML (for printing)"> 
<link rel=alternate href="/fr/html/print" hreflang=fr type=text/html media=print title="French HTML (for printing)"> 
<link rel=alternate href="/en/pdf" hreflang=en type=application/pdf title="English PDF"> 
<link rel=alternate href="/fr/pdf" hreflang=fr type=application/pdf title="French PDF">

この関係は推移的です。つまり、1つの文書がリンクタイプ"alternate"で他の2つの文書にリンクしている場合、それはその2つの文書が最初の文書の代替表現であることを意味するだけでなく、それらの2つの文書が互いに代替表現であることも意味します。

authorキーワードは、link、a、およびarea要素で使用できます。このキーワードはハイパーリンクを作成します。

aおよびarea要素の場合、authorキーワードは、参照された文書がハイパーリンクを定義している要素の最も近い先祖であるarticle要素の著者についての追加情報を提供することを示します。もしそのような要素が存在しない場合は、ページ全体の著者についての追加情報を提供します。

link要素の場合、authorキーワードは、参照された文書がページ全体の著者についての追加情報を提供することを示します。

"参照された文書"は、mailto:URLであり、著者のメールアドレスを示すことができますし、実際にそうであることが多いです。[MAILTO]

同義語: 歴史的な理由から、ユーザーエージェントはlink、a、およびarea要素にrev属性の値が"made"であるものを、リンク関係としてauthorキーワードが指定されているものとして扱わなければなりません。

bookmarkキーワードは、aおよびarea要素で使用できます。このキーワードはハイパーリンクを作成します。

bookmark キーワードは、問題のリンク要素の最も近い祖先article要素、または祖先article要素がない場合は、リンク要素が最も密接に関連付けられているセクションのパーマリンクを提供します。

次のスニペットには、3つのパーマリンクがあります。ユーザーエージェントは、パーマリンクが与えられている場所を見て、どのパーマリンクが仕様のどの部分に適用されるかを判断できます。

 ...
<body>
 <h1>パーマリンクの例</h1>
 <div id="a">
  <h2>最初の例</h2>
  <p><a href="a.html" rel="bookmark">このパーマリンクは、最初のH2から2番目のH2までのコンテンツにのみ適用されます</a>。DIVは正確にはそのセクションではありませんが、それに大まかに対応しています。</p>
 </div>
 <h2>2番目の例</h2>
 <article id="b">
  <p><a href="b.html" rel="bookmark">このパーマリンクは、外側のARTICLE要素に適用されます</a>（例えば、ブログ記事のように）。</p>
  <article id="c">
   <p><a href="c.html" rel="bookmark">このパーマリンクは、内側のARTICLE要素に適用されます</a>（例えば、ブログのコメントのように）。</p>
  </article>
 </article>
</body>
...

canonical キーワードは link 要素と共に使用できます。このキーワードは ハイパーリンク を作成します。

canonical キーワードは、href 属性で指定されたURLが現在のドキュメントにとって推奨されるURLであることを示します。これにより、検索エンジンが重複コンテンツを減らすのに役立ちます。詳細はThe Canonical Link Relation に記載されています。[RFC6596]

Link_types/dns-prefetch

Firefox3+Safari?Chrome46+
Opera?Edge79+
Edge (Legacy)NoInternet Explorer?
Firefox Android?Safari iOS?Chrome AndroidYesWebView Android46+Samsung Internet?Opera Android?

dns-prefetch キーワードは link 要素と共に使用できます。このキーワードは 外部リソースリンク を作成します。このキーワードは body-ok です。

dns-prefetch キーワードは、指定されたリソースの オリジン のDNS解決を事前に行うことが有益である可能性が高いことを示します。これは、ユーザーがそのオリジンにあるリソースを必要とする可能性が非常に高いためであり、DNS解決に関連する遅延コストを事前に解決することでユーザーエクスペリエンスが向上します。

dns-prefetch キーワードによって指定されたリソースのデフォルトタイプはありません。

この種類のリンクをフェッチして処理する 適切なタイミングは次のとおりです:

この種類のリンクリソースをフェッチして処理する 手順は、次のとおりです:

  1. el の href 属性の値を el の ノードドキュメント に対して相対的に指定して、URLのエンコードと解析 を行った結果として url を取得します。

  2. url が失敗した場合、返します。

  3. partitionKey を、ネットワークパーティションキーを決定する 結果として取得します。

  4. ユーザーエージェントは、partitionKey と url の オリジン を指定して オリジンを解決 する必要があります。

    このアルゴリズムの結果はキャッシュできるため、将来のフェッチが高速化される可能性があります。

expect キーワードは link 要素と共に使用できます。このキーワードは 内部リソースリンク を作成します。

内部リソースリンク は、expect キーワードによって作成され、リンクされている要素がドキュメントに接続され、完全に解析されるまでレンダリングを ブロック するために使用されます。

expect キーワードによって指定されたリソースのデフォルトタイプはありません。

次のいずれかの条件が link 要素 el に対して発生する場合:

そのときは、処理 el を実行します。

リンク 要素 el に対して、内部リソースリンクを処理するには、次の手順を実行します:

  1. el の ノードドキュメント を doc とします。

  2. el の href 属性の値を指定して URLのエンコードと解析 を行った結果として url を取得します。

  3. これが失敗するか、url が doc の URL と一致しない場合、レンダリングを解除 し、終了します。

  4. doc および url に対して 示された部分を選択する 結果として indicatedElement を取得します。

  5. 次のすべてが真である場合:

    その場合、レンダリングをブロック します el で。

  6. それ以外の場合、レンダリングを解除 します el で。

Document doc に対して、内部リソースリンクを処理するには:

  1. 各 expect リンク 要素 link を doc の レンダリングブロック要素セット 内で 処理 します。

属性変更手順 は、element、localName、value、および namespace を指定して、expect リンク 要素が動的に id および name の変更に対応することを保証するために使用されます:

  1. namespace が null でない場合、終了します。

  2. element が 開いている要素のスタック 上にある場合、終了します。

  3. 次のいずれかが真である場合:

    その場合、内部リソースリンクを処理する を element の ノードドキュメント に対して実行します。

external キーワードは、a、area、および form 要素と共に使用できます。このキーワードは ハイパーリンク を作成しませんが、要素によって作成された他のハイパーリンク（他のキーワードが作成しない場合は暗示されたハイパーリンク）に 注釈 を付けます。

external キーワードは、リンクが現在のドキュメントが構成するサイトの一部ではないドキュメントに導いていることを示します。

help キーワードは、link、a、area、および form 要素と共に使用できます。このキーワードは ハイパーリンク を作成します。

a、area、および form 要素に対して、help キーワードは、ハイパーリンクを定義する要素の親要素とその子要素のために、参照されるドキュメントがさらに支援情報を提供することを示します。

次の例では、フォームコントロールに関連するコンテキストに応じたヘルプが関連付けられています。ユーザーエージェントは、この情報を使用して、たとえば、ユーザーが「ヘルプ」または「F1」キーを押した場合に参照されたドキュメントを表示することができます。 

 <p><label> Topic: <input name=topic> <a href="help/topic.html" rel="help">(Help)</a></label></p>

link 要素に対して、help キーワードは、参照されるドキュメントがページ全体のヘルプを提供することを示します。

a および area 要素に対して、一部のブラウザでは、help キーワードがリンクに異なるカーソルを使用させることがあります。

4.6.7.9 リンクタイプ "icon"

Link_types#icon

現在のすべてのエンジンでサポートされています。

Firefox2+Safari3.1+Chrome4+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android4+Safari iOSNoChrome Android18+WebView Android38+Samsung Internet4.0+Opera AndroidNo
caniuse.com table

icon キーワードは link 要素と共に使用できます。このキーワードは 外部リソースリンク を作成します。

指定されたリソースはページまたはサイトを表すアイコンであり、ユーザーエージェントがユーザーインターフェイスでページを表す際に使用する必要があります。

アイコンは、聴覚アイコン、視覚アイコン、またはその他の種類のアイコンである可能性があります。複数のアイコンが提供されている場合、ユーザーエージェントは type、media、および sizes 属性に基づいて最も適切なアイコンを選択する必要があります。複数の等しく適切なアイコンがある場合、ユーザーエージェントはアイコンのリストを収集した時点で ツリー順 で最後に宣言されたアイコンを使用しなければなりません。ユーザーエージェントがアイコンを使用しようとしたが、そのアイコンが実際には不適切であると判断された場合（たとえば、サポートされていない形式を使用しているため）、ユーザーエージェントは属性によって判断された次に適切なアイコンを試す必要があります。

ユーザーエージェントはアイコンのリストが変更されたときにアイコンを更新する必要はありませんが、更新することが推奨されます。

icon キーワードによって指定されるリソースにはデフォルトのタイプがありません。ただし、リソースのタイプを判別する ために、ユーザーエージェントはリソースが画像であると想定する必要があります。

sizes キーワードは、ピクセル単位のアイコンサイズを表します（CSSピクセル ではなく、元のピクセルで表されます）。

2x（192dpi）表示用に意図された幅50 CSSピクセル のアイコンは、100ピクセルの幅を持つ必要があります。この機能は、小さい高解像度アイコンと大きい低解像度アイコンに異なるリソースを使用することを示すことをサポートしていません（たとえば、50×50 2xと100×100 1x）。

属性の値を解析して処理するには、ユーザーエージェントは最初に属性の値を ASCII空白文字で分割 し、次に各結果のキーワードを解析してそれが何を表しているかを決定する必要があります。

any キーワードは、リソースがスケーラブルアイコン（たとえば、SVG画像で提供されるもの）を含んでいることを表します。

その他のキーワードは、それが何を表しているかを判断するために、次のようにさらに解析する必要があります。

  1. キーワードに U+0078 LATIN SMALL LETTER X または U+0058 LATIN CAPITAL LETTER X 文字が1つだけ含まれていない場合、そのキーワードは何も表しません。そのキーワードに戻ります。

  2. width string は "x" または "X" の前の文字列です。

  3. height string は "x" または "X" の後の文字列です。

  4. width string または height string のいずれかが U+0030 DIGIT ZERO (0) 文字で始まるか、ASCII数字 以外の文字を含んでいる場合、そのキーワードは何も表しません。そのキーワードに戻ります。

  5. 負でない整数を解析するルール を width string に適用して、width を取得します。

  6. 負でない整数を解析するルール を height string に適用して、height を取得します。

  7. キーワードは、リソースに幅が width デバイスピクセル、高さが height デバイスピクセルのビットマップアイコンが含まれていることを表します。

sizes 属性に指定されたキーワードは、リンクされたリソースで実際に利用可能でないアイコンサイズを表してはいけません。

link 要素 el および リクエスト request に対するこのタイプのリンクリソースのための リンクリソースフェッチ設定ステップ は次のとおりです。

  1. request の 送信先 を "image" に設定します。

  2. true を返します。

このタイプのリンクリソースに対する リンクヘッダを処理する ステップは何もしません。

コード icon キーワードを持つ link が存在しない場合、スキーム が HTTP(S)スキーム である Document オブジェクトに対して、ユーザーエージェントはこれらのステップを並行して実行できます。

  1. request を新しい リクエスト として、URL を URLレコード であり、/favicon.ico を Document オブジェクトの URL に対して解決されたものとします。クライアント は Document オブジェクトの 関連設定オブジェクト、送信先 は "image"、同期フラグ は設定されており、クレデンシャルモード は "include"、URLクレデンシャルフラグを使用 は設定されています。

  2. response を フェッチ request の結果とします。

  3. response の 非安全なレスポンス をアイコンとして使用し、それが icon キーワードを使用して宣言されたかのように処理します。

次のスニペットは、複数のアイコンを含むアプリケーションの上部を示しています。

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>lsForums — Inbox</title>
   <link rel=icon href=favicon.png sizes="16x16" type="image/png">
   <link rel=icon href=windows.ico sizes="32x32 48x48" type="image/vnd.microsoft.icon">
   <link rel=icon href=mac.icns sizes="128x128 512x512 8192x8192 32768x32768">
   <link rel=icon href=iphone.png sizes="57x57" type="image/png">
   <link rel=icon href=gnome.svg sizes="any" type="image/svg+xml">
   <link rel=stylesheet href=lsforums.css>
   <script src=lsforums.js></script>
   <meta name=application-name content="lsForums">
  </head>
  <body>
   ...

歴史的な理由から、icon キーワードの前に "shortcut" キーワードが付くことがあります。"shortcut" キーワードが存在する場合、rel 属性の全体の値は、文字間に U+0020 スペース文字が1つだけ含まれており、他の ASCII空白文字 が含まれていない "shortcut icon" 文字列と ASCII大文字小文字の区別なく一致している必要があります。

license キーワードは、link、a、area、およびform要素で使用することができます。このキーワードはハイパーリンクを作成します。

licenseキーワードは、参照されたドキュメントが、現在のドキュメントの主なコンテンツが提供されている著作権ライセンス条件を提供することを示します。

この仕様では、ドキュメントの主なコンテンツと、主なコンテンツとは見なされないコンテンツを区別する方法を指定していません。この区別はユーザーに明確に示すべきです。

写真共有サイトを考えてみましょう。このサイトのページは写真を説明し、表示するものであり、そのページは次のようにマークアップされるかもしれません:

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>Exampl Pictures: Kissat</title>
   <link rel="stylesheet" href="/style/default">
  </head>
  <body>
   <h1>Kissat</h1>
   <nav>
    <a href="../">Return to photo index</a>
   </nav>
   <figure>
    <img src="/pix/39627052_fd8dcd98b5.jpg">
    <figcaption>Kissat</figcaption>
   </figure>
   <p>One of them has six toes!</p>
   <p><small><a rel="license" href="http://www.opensource.org/licenses/mit-license.php">MIT Licensed</a></small></p>
   <footer>
    <a href="/">Home</a> | <a href="../">Photo index</a>
    <p><small>© copyright 2009 Exampl Pictures. All Rights Reserved.</small></p>
   </footer>
  </body>
 </html>

この場合、licenseは写真（ドキュメントの主なコンテンツ）のみに適用され、ドキュメント全体には適用されません。特に、ドキュメントのデザインは、ドキュメントの下部に記載された著作権によって保護されており、このことをスタイリングでより明確にすることができます（例えば、ライセンスリンクを写真の近くに目立つように配置し、ページの著作権情報はページの下部に小さく薄く表示する）。

同義語: 歴史的な理由から、ユーザーエージェントは "copyright" キーワードを license キーワードと同様に扱う必要があります。

Link_types/manifest

サポートは1つのエンジンのみ。

Firefox?Safari?Chromeいいえ
Opera?Edgeいいえ
Edge (Legacy)?Internet Explorer?
Firefox Android?Safari iOS?Chrome AndroidはいWebView Android?Samsung Internet?Opera Android?

manifest キーワードは、link要素で使用できます。 このキーワードは外部リソースリンクを作成します。

manifest キーワードは、現在のドキュメントに関連するメタデータを提供するマニフェストファイルを示します。

manifestキーワードで指定されたリソースには、デフォルトのタイプはありません。

ウェブアプリケーションがインストールされていない場合、このリンクタイプのリンクされたリソースをフェッチおよび処理する適切なタイミングは、ユーザーエージェントが必要と判断したときです。例えば、ユーザーがウェブアプリケーションをインストールすることを選択したときです。

インストールされたウェブアプリケーションの場合、このリンクタイプのリンクされたリソースをフェッチおよび処理する適切なタイミングは次の通りです。

いずれの場合でも、ツリー順序で link 属性が最初に rel 属性に含まれる manifest トークンを使用できる要素のみが使用されます。

ユーザーエージェントは、このリンクタイプに対してロードイベントを遅延させてはなりません。

このリンクタイプのリンクされたリソースに対するリンクされたリソースのフェッチ設定手順は、 link要素 elとリクエスト request に与えられたときの手順です。

  1. navigable を el の ノードドキュメント の ノードナビゲーブル に設定します。

  2. navigable がnullの場合、falseを返します。

  3. navigable が トップレベルのトラバーサブル でない場合、falseを返します。

  4. request のイニシエーター を "manifest" に設定します。

  5. request の宛先 を "manifest" に設定します。

  6. request のモード を "cors" に設定します。

  7. request の資格情報モード を el の crossorigin コンテンツ属性のCORS設定属性資格情報モードに設定します。

  8. trueを返します。

リンクされたリソースを処理するには、link 要素 el、ブール値 success、レスポンス response、およびバイトシーケンス bodyBytes を与えます。

  1. response の コンテンツタイプメタデータ がJSON MIMEタイプでない場合、success をfalseに設定します。

  2. success がtrueの場合:

    1. document URL を el の ノードドキュメント のURL に設定します。

    2. manifest URL を response の URL に設定します。

    3. マニフェストを処理し、 document URL、 manifest URL および bodyBytes を指定します。[MANIFEST]

リンクヘッダーを処理する手順は、何もしないようにします。

Link_types/modulepreload

Firefox115+Safari?Chrome66+
Opera?Edge79+
Edge (Legacy)NoInternet Explorer?
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

modulepreload キーワードは、link 要素で使用できます。このキーワードは、外部リソースリンク を作成します。このキーワードはbody-okです。

modulepreload キーワードは、preload キーワードの特化した代替手段であり、モジュールスクリプト を事前にロードするための処理モデルに焦点を当てています。特に、モジュールスクリプトの特定のフェッチ動作（例：crossorigin 属性の異なる解釈を含む）を使用し、結果を後で評価するための適切な モジュールマップ に配置します。対照的に、preload キーワードを使用した同様の外部リソースリンク は、ドキュメントのモジュールマップに影響を与えずに、結果をプリロードキャッシュに配置します。

さらに、実装はモジュールスクリプト が依存関係を宣言することを利用して、指定されたモジュールの依存関係もフェッチすることができます。これは最適化の機会として意図されており、ユーザーエージェントはその依存関係が後で必要になる可能性が高いことを知っているためです。技術的な手段がない限り、一般的には観測されません。特に、適切な load または error イベントは、指定されたモジュールがフェッチされた後に発生し、依存関係を待つことはありません。

ユーザーエージェントは、このリンクタイプのためにロードイベントを遅延させてはなりません。

リンクされたリソースをフェッチして処理する適切なタイミングは、次の通りです:

他のリンク関係とは異なり、as、crossorigin、referrerpolicyなどの関連属性を変更しても、新しいフェッチはトリガーされません。これは、ドキュメントのモジュールマップが既存のフェッチで既にポピュレートされているためであり、再フェッチは無意味だからです。

リンクされたリソースをフェッチして処理するためのアルゴリズムは、modulepreloadリンクがリンク要素elである場合に適用され、次の手順で実行されます:

  1. もしelのhref属性の値が空文字列である場合は、終了します。

  2. elのas属性（destination）の現在の状態をdestinationとし、状態がない場合は「script」とします。

  3. もしdestinationがscript-likeでない場合、要素タスクをキューに追加し、ネットワーキングタスクソースにelを渡して、イベントを発火させます。このイベントはerrorという名前で、elに対して発火されます。その後、処理を終了します。

  4. elのhref属性の値をもとにurlをエンコーディングパースして決定し、elのノードドキュメントに相対するURLを取得します。

  5. もしurlがエラーとなった場合は、終了します。

  6. elのノードドキュメントの関連設定オブジェクトをsettings objectとします。

  7. elのcrossorigin属性に対応するCORS設定属性のクレデンシャルモードをcredentials modeとします。

  8. elの[[CryptographicNonce]]をcryptographic nonceとします。

  9. もしelがintegrity属性を持たない場合は、integrity metadataを、urlとsettings objectを使ってモジュールインテグリティメタデータを解決する結果に設定します。

  10. elのreferrerpolicy属性の現在の状態をreferrer policyとします。

  11. elのfetchpriority属性の現在の状態をfetch priorityとします。

  12. モジュールプリロードモジュールスクリプトグラフをフェッチするために、url、destination、settings object、optionsを使用して、次のステップを実行します:

    1. もしresultがnullの場合、イベントを発火し、 elでerrorという名前のイベントを発火して、処理を終了します。

    2. イベントを発火し、elでloadという名前のイベントを発火します。

リンクヘッダーを処理するこのタイプのリンクリソースのステップは、何も行いません。

次のスニペットは、複数のモジュールをプリロードしたアプリケーションの上部を示しています:

<!DOCTYPE html>
 <html lang="en">
 <title>IRCFog</title>
 
 <link rel="modulepreload" href="app.mjs">
 <link rel="modulepreload" href="helpers.mjs">
 <link rel="modulepreload" href="irc.mjs"><link rel="modulepreload" href="fog-machine.mjs">
 
 <script type="module" src="app.mjs">
 ...

このアプリケーションのモジュールグラフは次のように仮定します:

モジュールグラフはapp.mjsをルートとし、irc.mjsとfog-machine.mjsに依存しています。さらに、irc.mjsはhelpers.mjsに依存しています。

ここで、アプリケーション開発者は、modulepreload を使用して、モジュールグラフ内のすべてのモジュールを宣言し、ユーザーエージェントがそれらすべてのフェッチを開始するようにしています。このようなプリロードがない場合、HTTP/2 Server Pushなどの技術が導入されていない場合、ユーザーエージェントはhelpers.mjsを発見するまでに複数のネットワークリクエストを行う必要があるかもしれません。このようにして、modulepreload link 要素をアプリケーションのモジュールの「マニフェスト」として使用することができます。

次のコードは、modulepreload リンクがimport() と組み合わせて使用され、ネットワークフェッチが事前に行われることを保証し、import() が呼び出されたときにモジュールがすでに準備され（ただし評価はされていない）、モジュールマップに配置されていることを示しています:

<link rel="modulepreload" href="awesome-viewer.mjs">
 
 <button onclick="import('./awesome-viewer.mjs').then(m => m.view())">
   素晴らしいものを見る
 </button>

nofollowキーワードは、 a、 area、 およびform要素で使用できます。この キーワードはハイパーリンクを作成しませんが、要素によって 作成された他のハイパーリンク（他のキーワードが作成しない場合は暗黙のハイパーリンク）を注釈します。

nofollow キーワードは、リンクがページの元の著者または発行者によって承認されていないこと、またはリンク先の文書へのリンクが、 主に二つのページに関係する人物間の商業関係のために含まれていることを示します。

Link_types/noopener

現在のすべてのエンジンでサポートされています。

Firefox52+Safari10.1+Chrome49+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

noopener キーワードは、a、 area、 およびform要素で使用できます。この キーワードはハイパーリンクを作成しませんが、要素によって 作成された他のハイパーリンク（他のキーワードが作成しない場合は暗黙のハイパーリンク）を注釈します。

このキーワードは、新しく作成されたトップレベルのトラバーサブルが ハイパーリンクを辿ることで作成された場合、 補助ブラウジングコンテキストを含まないことを示します。 例えば、結果として得られるWindowの openerゲッターはnullを返します。

また、処理モデルも参照してください。

これは通常、トップレベルのトラバーサブルと 補助ブラウジングコンテキストを作成します （既存のナビゲーブルがなく、その ターゲット名が「example」ではないと仮定します）： 

<a href=help.html target=example>Help!</a>

これは同じ条件下で、補助ブラウジングコンテキストを含まないトップレベルのトラバーサブルを作成します：

<a href=help.html target=example rel=noopener>Help!</a>

これらは同等であり、親ナビゲーブルのみをナビゲートします：

<a href=index.html target=_parent>Home</a>
<a href=index.html target=_parent rel=noopener>Home</a>

Link_types/noreferrer

すべての現在のエンジンでサポートされています。

Firefox33+Safari5+Chrome16+
Opera?Edge79+
Edge (Legacy)13+Internet Explorer🔰 11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet1.5+Opera Android?

noreferrer キーワードは、a、 area、 およびform要素で使用できます。この キーワードはハイパーリンクを作成しませんが、要素によって 作成された他のハイパーリンク（他のキーワードが作成しない場合は暗黙のハイパーリンク）を注釈します。

これは、リンクを辿る際にリファラー情報が漏れないことを示し、同じ条件下でnoopenerキーワードの動作をも暗示します。

リファラーが直接操作される処理モデルも参照してください。

<a href="..." rel="noreferrer" target="_blank">は<a href="..." rel="noreferrer noopener" target="_blank">と同じ動作をします。

openerキーワードは、a、 area、 およびform要素で使用できます。このキーワードはハイパーリンクを作成しませんが、要素によって作成された他のハイパーリンク（他のキーワードが作成しない場合は暗黙のハイパーリンク）を注釈します。

このキーワードは、ハイパーリンクに従った結果、新たに作成されたトップレベルのトラバーサブルに補助的なブラウジングコンテキストが含まれることを示します。

また、処理モデルも参照してください。

次の例では、openerを使用して、ヘルプページのポップアップがオープナーをナビゲートできるようにしています。例えば、ユーザーが探している情報が別の場所にある場合などです。代替案としては、_blankの代わりに名前付きターゲットを使用することも考えられますが、既存の名前と競合する可能性があります。 

<a href="..." rel=opener target=_blank>Help!</a>

pingbackキーワードは、link要素で使用できます。このキーワードは外部リソースリンクを作成します。このキーワードはbody-okです。

pingbackキーワードの意味については、Pingback 1.0を参照してください。[PINGBACK]

Link_types/preconnect

すべての現行エンジンでサポートされています。

Firefox39+Safari11.1+Chrome46+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet4.0+Opera Android?

preconnectキーワードは、link要素で使用できます。このキーワードは外部リソースリンクを作成します。このキーワードはbody-okです。

preconnectキーワードは、指定されたリソースのオリジンへの接続を予め開始することが有益である可能性が高いことを示します。つまり、そのオリジンに存在するリソースをユーザーが必要とする可能性が高く、接続確立に伴う遅延コストを事前に処理することでユーザーエクスペリエンスが向上します。

preconnectキーワードによって指定されたリソースにはデフォルトのタイプはありません。

このリンクタイプでは、ロードイベントを遅延させてはいけません。

このタイプのリンクをフェッチして処理する適切なタイミングは以下の通りです。

リンクリソースのフェッチと処理手順は、link要素elが与えられた場合に、リンクオプションを作成し、その結果に基づいて事前接続を実行します。

このタイプのリンクリソースに対してリンクヘッダを処理する手順は、リンク処理オプション optionsが与えられた場合に、事前接続を実行することです。

事前接続をリンク処理オプション optionsに対して実行する方法：

  1. optionsのhrefが空文字列である場合、処理を終了します。

  2. optionsのhrefをURLのエンコード解析を行い、optionsのベースURLに相対的に解釈されたurlを取得します。

    ベースURLを文書や環境の代わりに渡すことについては、issue #9715で追跡されています。

  3. urlが失敗した場合、処理を終了します。

  4. urlのスキームがHTTP(S)スキームでない場合、処理を終了します。

  5. partitionKeyをネットワークパーティションキーの決定の結果として取得します。

  6. useCredentialsをtrueに設定します。

  7. もしoptionsのcrossoriginがAnonymousであり、optionsのoriginがurlのオリジンと同一オリジンでない場合、useCredentialsをfalseに設定します。

  8. ユーザーエージェントは、partitionKey、urlのオリジン、およびuseCredentialsを指定して接続を取得する必要があります。

    この接続は取得されますが、直接使用されることはありません。それは後続の使用のために接続プールに残ります。

    ユーザーエージェントは可能な限り事前接続を開始し、完全な接続ハンドシェイク（HTTPの場合はDNS+TCP、HTTPSのオリジンの場合はDNS+TCP+TLS）を実行するべきですが、リソースの制約や他の理由で部分的なハンドシェイク（HTTPの場合はDNSのみ、HTTPSの場合はDNSまたはDNS+TCP）を実行するか、完全にスキップすることを選択することが許されています。

    オリジンごとの最適な接続数は、交渉されたプロトコル、ユーザーの現在の接続プロファイル、利用可能なデバイスリソース、グローバル接続制限、および他のコンテキスト固有の変数に依存します。その結果、開かれる接続数の決定はユーザーエージェントに委ねられています。

Link_types/prefetch

Firefox2+SafariNoChrome8+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet1.5+Opera Android?

prefetchキーワードは、link要素で使用できます。このキーワードは外部リソースリンクを作成します。このキーワードはbody-okです。

prefetchキーワードは、指定されたリソースまたは同一サイトのドキュメントを事前にフェッチしてキャッシュすることが有益である可能性が高いことを示します。これは、ユーザーが将来のナビゲーションでこのリソースを必要とする可能性が高いためです。

prefetchキーワードによって指定されたリソースにはデフォルトのタイプはありません。

このタイプのリンクをフェッチして処理する適切なタイミングは以下の通りです。

リンクリソースのフェッチと処理アルゴリズムは、prefetchリンクが与えられた場合に、link要素elに対して次のように行われます。

  1. elのhref属性の値が空文字列の場合、処理を終了します。

  2. optionsをelからリンクオプションを作成する結果として取得します。

  3. optionsの宛先を空文字列に設定します。

  4. requestをoptionsからリンクリクエストを作成する結果として取得します。

  5. requestがnullである場合、処理を終了します。

  6. requestのイニシエーターを「prefetch」に設定します。

  7. processPrefetchResponseを、レスポンス responseとnull、失敗、またはバイトシーケンス bytesOrNullに対して次の手順を行うものとして設定します。

    1. responseがネットワークエラーである場合、イベントを発火し、elにerrorを設定します。

    2. それ以外の場合、イベントを発火し、elにloadを設定します。

  8. ユーザーエージェントは、requestをフェッチし、processResponseConsumeBodyをprocessPrefetchResponseに設定します。ユーザーエージェントは、現在のドキュメントに必要な他のリクエストを優先するために、requestのフェッチを遅延させることができます。

リンクヘッダを処理する手順は、何もしないことです。

Link_types/preload

1つのエンジンのみ対応しています。

Firefox85+Safari?🔰 50+
Opera37+🔰 79+
Edge (レガシー)非対応Internet Explorer?
Firefox Android?Safari iOS?Chrome Android?WebView Android50+Samsung Internet5.0+Opera Android?

preloadキーワードは、link要素で使用できます。このキーワードは、外部リソースリンクを作成します。このキーワードはbody-okです。

preloadキーワードは、ユーザーエージェントが指定されたリソースをあらかじめフェッチしてキャッシュすることを示します。これは、as属性によって指定された潜在的な宛先と、fetchpriority属性によって指定された優先度に従って行われます。このリソースが現在のナビゲーションに必要である可能性が高いためです。

ユーザーエージェントは、リソースがロードされた際に追加の操作を行う場合があります。例えば、画像をデコードしたり、スタイルシートを作成したりすることです。しかし、これらの追加操作は観察可能な効果を持つことはできません。

preloadキーワードに指定されるリソースのデフォルトタイプはありません。

ユーザーエージェントは、このリンクタイプに対してロードイベントを遅延させることはできません。

このリンクに対してリンクされたリソースをフェッチして処理する適切なタイミングは次のとおりです:

ドキュメントにはプリロードされたリソースのマップがあります。これは順序付けられたマップで、初期状態では空です。

プリロードキーは構造体です。以下の項目を持ちます:

URL
URL
宛先
文字列
モード
リクエストモード、"same-origin"、"cors"、または "no-cors"
資格情報モード
資格情報モード

プリロードエントリは構造体です。以下の項目を持ちます:

整合性メタデータ
文字列
レスポンス
Nullまたはレスポンス
レスポンスが利用可能なとき
Null、またはレスポンスを受け入れるアルゴリズム

プリロードされたリソースを消費するために、ウィンドウ windowが、URL url、文字列 destination、文字列 mode、文字列 credentialsMode、文字列 integrityMetadata、およびレスポンスを受け入れるアルゴリズム onResponseAvailableを指定した場合:

  1. key を url が プリロードキー、destination が 送信先、mode が モード、credentialsMode が 認証モード のプリロードキーとします。

  2. preloadsをwindowの関連ドキュメントのプリロードされたリソースのマップとします。

  3. もしkeyがpreloads内に存在しない場合は、falseを返します。

  4. entryをpreloads[key]とします。

  5. consumerIntegrityMetadataを、integrityMetadataの解析結果とします。

  6. preloadIntegrityMetadataを、entryの整合性メタデータの解析結果とします。

  7. 次の条件のいずれにも当てはまらない場合:

    その場合はfalseを返します。

    プリロードとコンシューマーの間で整合性メタデータが一致しない場合、両方がデータと一致していても、ネットワークからの追加のフェッチが発生します。

    ネットワークエラーがプリロードキャッシュに追加されることが重要です。これにより、プリロード要求がエラーになった場合、誤った応答が後でネットワークから再要求されることはありません。これにはセキュリティ上の影響もあります。開発者がプリロード要求にサブリソース整合性メタデータを指定したが、その後のリソース要求には指定しなかった場合を考えてみましょう。プリロード要求がサブリソース整合性検証に失敗して破棄された場合、リソース要求は整合性を検証せずにネットワークから潜在的に悪意のある応答をフェッチして消費します。 [SRI]

  8. 削除する preloads[key]

  9. もしentryのレスポンスがNullである場合、entryのレスポンスが利用可能なときをonResponseAvailableに設定します。

  10. それ以外の場合は、entryのレスポンスを使用してonResponseAvailableを呼び出します。

  11. trueを返します。

このセクションの目的のために、文字列typeが文字列destinationと一致するのは、次のアルゴリズムがtrueを返す場合です:

  1. もしtypeが空文字列である場合はtrueを返します。

  2. もしdestinationが"fetch"である場合はtrueを返します。

  3. mimeTypeRecordをパースした結果とします。

  4. もしmimeTypeRecordが失敗した場合はfalseを返します。

  5. もしmimeTypeRecordがユーザーエージェントによってサポートされていない場合は、falseを返します。

  6. 次のいずれかがtrueである場合:

    その場合はtrueを返します。

  7. falseを返します。

プリロードキーを作成するために、リクエスト requestを指定し、新しいプリロードキーを返します。このキーのURLはrequestのURL、宛先はrequestの宛先、モードはrequestのモード、そして資格情報モードはrequestの資格情報モードになります。

文字列destinationを指定してプリロード宛先を変換するために:

  1. もしdestinationが"fetch"、"font"、"image"、"script"、"style"、または"track"でない場合は、nullを返します。

  2. 変換結果を返します。

リンク処理オプション optionsと、レスポンスを受け入れるアルゴリズムprocessResponseをオプションとして指定してプリロードするために:

  1. もしoptionsのタイプがoptionsの宛先に一致しない場合、returnします。

  2. もしoptionsの宛先が"image"であり、optionsのソースセットがnullでない場合、optionsのhrefをソースセットから画像ソースを選択する結果に設定します。

  3. requestをリンクリクエストを作成する結果とします。

  4. もしrequestがnullの場合、returnします。

  5. unsafeEndTimeを0に設定します。

  6. entryを新しいプリロードエントリとし、その整合性メタデータをoptionsの整合性に設定します。

  7. keyをプリロードキーを作成する結果とします。

  8. もしoptionsのドキュメントが"pending"である場合、requestのイニシエータタイプを"early hint"に設定します。

  9. controllerをnullに設定します。

  10. reportTimingを、ドキュメント documentに対して、controllerにタイミングを報告するためのものとします。

  11. controllerを、requestをフェッチする結果とし、以下のステップに従ってprocessResponseConsumeBodyを設定します。responseを、null、失敗、またはバイトシーケンス bodyBytesとします:

    1. もしbodyBytesがバイトシーケンスである場合、responseのボディをbodyBytesのボディとして設定します。

      processResponseConsumeBodyを使用することにより、ボディ全体をネットワークからロードするようにしています。これは、プリロードが消費されるかどうか（現時点では不確定です）にかかわらず、プリローダがネットワークからボディ全体をロードすることを保証するために必要です。このステップでは、リクエストのボディを新しいボディにリセットし、同じバイトを含むようにします。これにより、他の仕様が実際に消費されるときにボディを読み取ることができます。

    2. それ以外の場合は、responseをネットワークエラーに設定します。

    3. unsafeEndTimeを安全でない共有現在時刻に設定します。

    4. もしoptionsのドキュメントがnullでない場合、reportTimingをoptionsのドキュメントに対して呼び出します。

    5. もしentryのレスポンスが利用可能なときがnullである場合、entryのレスポンスをresponseに設定します。そうでなければ、entryのレスポンスが利用可能なときを使用してresponseを呼び出します。

    6. もしprocessResponseが指定されている場合、responseを使用してprocessResponseを呼び出します。

  12. commitを、ドキュメント documentに対して以下のステップを行うものとします:

    1. もしentryのレスポンスがnullでない場合、documentに対してreportTimingを呼び出します。

    2. documentのプリロードされたリソースのマップ[key]をentryに設定します。

  13. もしoptionsのドキュメントがnullである場合、optionsのドキュメント準備完了時をcommitに設定します。それ以外の場合は、optionsのドキュメントを使用してcommitを呼び出します。

この種類のリンクリソースに対するリンクリソースをフェッチして処理する手順は、リンク要素elを与えられたときに行います:

  1. elのためにソースセットを更新する。

  2. optionsを要素からリンクオプションを作成する結果とします。

  3. optionsをプリロードし、以下のステップでresponseをレスポンスとします:

    1. もしresponseがネットワークエラーである場合、elでエラーという名前のイベントを発火します。それ以外の場合、elでロードという名前のイベントを発火します。

      実際のブラウザの動作はここで仕様と異なり、動作の変更の実現可能性はまだ調査されていません。issue #1142を参照してください。

リンクヘッダーを処理する手順は、この種類のリンクリソースに対して、リンク処理オプション optionsを指定して、プリロード optionsします。

privacy-policy キーワードは、link、a、および area 要素と共に使用できます。このキーワードは、ハイパーリンクを作成します。

privacy-policy キーワードは、参照される文書が、現在の文書に適用されるデータ収集および使用の実践に関する情報を含むことを示します。詳細は Additional Link Relation Types に記載されています。参照される文書は、スタンドアロンのプライバシーポリシーまたは、より一般的な文書の特定のセクションである可能性があります。[RFC6903]

search キーワードは、link、a、area、および form 要素と共に使用できます。このキーワードは、ハイパーリンクを作成します。

search キーワードは、参照される文書が、文書および関連リソースを検索するためのインターフェースを提供することを示します。

OpenSearch記述文書は、link 要素およびsearchリンクタイプと共に使用して、ユーザーエージェントが検索インターフェースを自動的に発見できるようにすることができます。[OPENSEARCH]

stylesheet キーワードは、link 要素と共に使用されます。このキーワードは、スタイリング処理モデルに貢献する外部リソースリンクを作成します。このキーワードは body-ok です。

指定されたリソースは、ドキュメントの表示方法を記述するCSSスタイルシート です。

Alternative_style_sheets

サポートは1つのエンジンのみ。

Firefox3+Safari?Chrome1–48
OperaはいEdgeいいえ
Edge (レガシー)?Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

もしalternate キーワードが link 要素にも指定されている場合、そのリンクは代替スタイルシートとなります。この場合、title 属性が link 要素に指定されていなければならず、値は空であってはいけません。

stylesheet キーワードで指定されたリソースのデフォルトタイプは、text/css です。

このタイプのlink要素は、その要素が暗黙的に潜在的なレンダーブロックであり、要素がそのノードドキュメントのパーサーによって作成された場合に適用されます。

disabled 属性がlink 要素にセットされ、stylesheet キーワードが設定されている場合、関連するCSSスタイルシートを無効にします。

このタイプのリンクを取得して処理するのに適切なタイミングは以下の通りです：

注意: ドキュメントがクイークモードに設定され、外部リソースの同一オリジンと一致し、外部リソースのContent-Typeメタデータがサポートされていないスタイルシートタイプである場合、ユーザーエージェントは代わりにそれをtext/cssと見なさなければなりません。

リンクされたリソースのフェッチ設定ステップは、リンク要素elおよびリクエストrequestが与えられた場合に適用されます:

  1. もしelのdisabled属性が設定されている場合、falseを返します。

  2. もしelがスクリプトブロックスタイルシートに貢献している場合、elをそのノードドキュメントのスクリプトブロックスタイルシートセットに追加します。

  3. もしelのmedia属性の値が環境に一致し、elが潜在的にレンダーブロックされる場合、elでレンダリングをブロックします。

  4. もしelが現在レンダーブロック中の場合、requestのレンダーブロックをtrueに設定します。

  5. trueを返します。

CSSOMのCSSスタイルシートを取得するアルゴリズムをissue #968に示された計画に基づき、デフォルトのリソース取得と処理アルゴリズムの代わりに使用する予定です。それまでの間、すべての重要なサブリソースに対するリクエストは、link要素が現在レンダーブロックしているかどうかに基づいて、そのレンダーブロックが設定されるべきです。

このタイプのリンクされたリソースを処理するには、リンク要素el、ブール値success、レスポンスresponse、およびバイトシーケンスbodyBytesが与えられます:

  1. リソースのContent-Typeメタデータがtext/cssでない場合、successをfalseに設定します。

  2. もしelがもはやスタイリング処理モデルに貢献する外部リソースリンクを作成しない場合、または、当該リソースが取得されてから再度取得する必要が生じた場合は:

    1. リストからelを削除し、elのノードドキュメントのスクリプトブロックスタイルシートセットから削除します。

    2. 戻ります。

  3. もしelが関連するCSSスタイルシートを持っている場合、そのCSSスタイルシートを削除します。

  4. もしsuccessがtrueであれば:

    1. 次のプロパティを持つCSSスタイルシートを作成します:

      タイプ

      text/css

      場所

      responseのURLリスト[0]

      ここでURLを提供するのは、w3c/csswg-drafts issue #9316が修正されることを前提としています。

      所有ノード

      el

      メディア

      elのmedia属性。

      これは、現在は存在しない可能性のある属性への参照であり、現在の属性値のコピーではありません。CSSOMでは、属性が動的に設定、変更、または削除された場合の動作が定義されています。

      タイトル

      もしelがドキュメントツリー内にある場合はelのtitle属性、そうでない場合は空文字列。

      これも同様に、属性の現在の値のコピーではなく、属性への参照です。

      代替フラグ

      リンクが代替スタイルシートであり、elの明示的に有効がfalseである場合は設定され、それ以外の場合は解除されます。

      オリジンクリーンフラグ

      リソースがCORS-同一オリジンである場合に設定され、それ以外の場合は解除されます。

      親CSSスタイルシート
      所有CSSルール

      null

      無効フラグ

      デフォルト値のままにします。

      CSSルール

      未初期化のままにします。

      これは正しくないように思えます。おそらくbodyBytesを使用すべきですか？issue #2997で追跡しています。

      CSS 環境エンコーディングは、次の手順を実行した結果です: [CSSSYNTAX]

      1. もしelがcharset属性を持っている場合、その属性の値からエンコーディングを取得します。成功した場合は、結果のエンコーディングを返します。[ENCODING]

      2. そうでない場合は、ドキュメントの文字エンコーディングを返します。[DOM]

    2. イベントを発火し、その名前をloadとし、elに対して行います。

  5. そうでない場合は、イベントを発火し、その名前をerrorとし、elに対して行います。

  6. もしelがスクリプトブロックスタイルシートに貢献している場合は:

    1. 確認: elのノードドキュメントのスクリプトブロックスタイルシートセットがelを含んでいることを確認します。

    2. リストからelを削除します。それをノードドキュメントのスクリプトブロックスタイルシートセットから削除します。

  7. elでレンダリングを解除します。

リンクヘッダーを処理するためのステップは、このタイプのリンクされたリソースには何も行わないことです。

tag キーワードは、a および area 要素と共に使用されます。このキーワードはハイパーリンクを作成します。

tag キーワードは、参照されたドキュメントが表すtagが現在のドキュメントに適用されることを示します。

このキーワードは、タグが現在のドキュメントに適用されることを示すため、複数のページにわたる人気のタグをリストするタグクラウドのマークアップに使用するのは不適切です。

このドキュメントは宝石に関するものであり、そのために "https://en.wikipedia.org/wiki/Gemstone" というタグが付けられています。これにより、米国の町、Rubyパッケージ形式、またはスイスの機関車クラスではなく、「宝石」タイプの宝石に適用されることが明確に分類されています。

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>My Precious</title>
  </head>
  <body>
   <header><h1>My precious</h1> <p>Summer 2012</p></header>
   <p>Recently I managed to dispose of a red gem that had been
   bothering me. I now have a much nicer blue sapphire.</p>
   <p>The red gem had been found in a bauxite stone while I was digging
   out the office level, but nobody was willing to haul it away. The
   same red gem stayed there for literally years.</p>
   <footer>
    タグ: <a rel=tag href="https://en.wikipedia.org/wiki/Gemstone">Gemstone</a>
   </footer>
  </body>
 </html>

このドキュメントでは、2つの記事があります。しかし、「tag」リンクはページ全体に適用されます（このリンクがどこに配置されても、記事要素内に配置されていても適用されます）。

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>Gem 4/4</title>
  </head>
  <body> 
   <article>
    <h1>801: シュタインボック</h1>
    <p>801号Gem 4/4電気ディーゼルはアイベックスがあり、2002年に再建されました。</p>
   </article> 
   <article>
    <h1>802: マーモット</h1>
    <figure> 
     <img src="https://upload.wikimedia.org/wikipedia/commons/b/b0/Trains_de_la_Bernina_en_hiver_2.jpg" alt="802号はパンタグラフと側面に高い換気口があり、赤かった。">
     <figcaption>1980年代、ラーゴ・ビアンコ上の802号。</figcaption> 
    </figure> 
    <p>802号Gem 4/4電気ディーゼルはマーモットがあり、2003年に再建されました。</p> 
   </article> 
   <p class="topic"><a rel=tag href="https://en.wikipedia.org/wiki/Rhaetian_Railway_Gem_4/4">Gem 4/4</a></p> 
  </body> 
 </html>

terms-of-service キーワードは、link、a、およびarea要素と共に使用できます。このキーワードはハイパーリンクを作成します。

terms-of-service キーワードは、参照されたドキュメントが、現在のドキュメントの提供者と、現在のドキュメントを使用しようとするユーザーとの間の契約に関する情報を含んでいることを示します。詳細については、Additional Link Relation Typesを参照してください。[RFC6903]

いくつかのドキュメントは、ドキュメントのシーケンスの一部を形成します。

ドキュメントのシーケンスとは、各ドキュメントが前の兄弟と次の兄弟を持つことができるものです。前の兄弟がないドキュメントはそのシーケンスの開始であり、次の兄弟がないドキュメントはそのシーケンスの終了です。

ドキュメントは複数のシーケンスの一部である場合があります。

next キーワードは、link、a、area、およびform要素と共に使用できます。このキーワードはハイパーリンクを作成します。

next キーワードは、ドキュメントがシーケンスの一部であり、リンクがシーケンス内の次の論理ドキュメントに導くことを示します。

next キーワードがlink要素で使用される場合、ユーザーエージェントは、そのようなリンクをdns-prefetch、preconnect、またはprefetchキーワードの1つを使用しているかのように処理する必要があります。ユーザーエージェントが使用するキーワードは実装に依存します。たとえば、ユーザーエージェントがデータ、バッテリー電力、または処理能力を節約しようとしている場合は、コストの低いpreconnect処理モデルを使用したいかもしれませんし、同様のシナリオにおける過去のユーザー行動のヒューリスティック分析に基づいてキーワードを選択したいかもしれません。

prev キーワードは、link、a、area、およびform要素と共に使用できます。このキーワードはハイパーリンクを作成します。

prev キーワードは、ドキュメントがシーケンスの一部であり、リンクがシーケンス内の前の論理ドキュメントに導くことを示します。

同義語: 歴史的な理由から、ユーザーエージェントは"previous"というキーワードもprevキーワードと同様に扱う必要があります。

定義済みのリンクタイプセットへの拡張は、既存のrel値のためのマイクロフォーマットページで登録できます。[MFREL]

誰でもいつでも既存のrel値のためのマイクロフォーマットページを編集して、タイプを追加することができます。拡張タイプには、次の情報を指定する必要があります。

キーワード

定義される実際の値。値は他の定義された値と紛らわしくないものでなければなりません（例: 大文字小文字の違いだけで異なる値）。

値にU+003Aコロン文字（:）が含まれている場合、それは絶対URLでなければなりません。

効果... linkに対して

次のうちの1つ:

許可されていません
キーワードはlink要素に指定してはなりません。
ハイパーリンク
キーワードはlink要素に指定できます。それはハイパーリンクを作成します。
外部リソース
キーワードはlink要素に指定できます。それは外部リソースリンクを作成します。
効果... aおよびareaに対して

次のうちの1つ:

許可されていません
キーワードはaおよびarea要素に指定してはなりません。
ハイパーリンク
キーワードはaおよびarea要素に指定できます。それはハイパーリンクを作成します。
外部リソース
キーワードはaおよびarea要素に指定できます。それは外部リソースリンクを作成します。
ハイパーリンク注釈
キーワードはaおよびarea要素に指定できます。それは、要素によって作成された他のハイパーリンクに注釈を付けます。
効果... formに対して

次のうちの1つ:

許可されていません
キーワードはform要素に指定してはなりません。
ハイパーリンク
キーワードはform要素に指定できます。それはハイパーリンクを作成します。
外部リソース
キーワードはform要素に指定できます。それは外部リソースリンクを作成します。
ハイパーリンク注釈
キーワードはform要素に指定できます。それは、要素によって作成された他のハイパーリンクに注釈を付けます。
簡潔な説明

キーワードの意味に関する非規範的な短い説明。

仕様

キーワードの意味と要件の詳細な説明へのリンク。それは、wikiの他のページへのリンク、または外部ページへのリンクである可能性があります。

同義語

処理要件が完全に同じである他のキーワード値のリスト。作成者は同義語として定義された値を使用すべきではありません。これらはあくまでレガシーコンテンツのサポートのためにユーザーエージェントがサポートすることを意図しています。誰でも実際に使用されていない同義語を削除することができます。このようにして、レガシーコンテンツとの互換性のために処理される必要がある名前だけが登録されるべきです。

ステータス

次のうちの1つ:

提案中
キーワードは広範なピアレビューと承認を受けていません。誰かがそれを提案し、または間もなく使用する予定です。
承認済み
キーワードは広範なピアレビューと承認を受けています。それには、キーワードを使用するページをどのように処理するか、誤って使用された場合も含めて明確に定義する仕様があります。
中止
キーワードは広範なピアレビューを受け、不十分であることが判明しました。このキーワードを使用している既存のページがありますが、新しいページはそれを避けるべきです。「簡潔な説明」および「仕様」エントリには、作成者が代わりに使用するべき詳細が記載されます。

キーワードが既存の値と重複していることが判明した場合、それは削除され、既存の値の同義語としてリストされるべきです。

提案中の状態で1か月以上使用されておらず、または指定されていない場合、そのキーワードはレジストリから削除される可能性があります。

提案中の状態で追加されたキーワードが既存の値と重複していることが判明した場合、それは削除され、既存の値の同義語としてリストされるべきです。提案中の状態で追加されたキーワードが有害であると判明した場合、それは「中止」ステータスに変更されるべきです。

誰でもいつでもステータスを変更できますが、上記の定義に従ってのみ行うべきです。

準拠チェッカーは、既存のrel値のためのマイクロフォーマットページで提供されている情報を使用して、値が許可されているかどうかを確認する必要があります。この仕様で定義された値、または「提案中」または「承認済み」とマークされた値は、「効果...」フィールドに記載されている要素で使用された場合、受け入れられる必要がありますが、この仕様で定義されていない値や、前述のページにリストされていない値は無効として拒否されなければなりません。準拠チェッカーは、この情報をキャッシュすることができます（例: パフォーマンス上の理由や信頼性の低いネットワーク接続の使用を避けるため）。

著者がこの仕様やwikiページで定義されていない新しいタイプを使用する場合、準拠チェッカーは上記の詳細を使用して、その値を「提案中」ステータスでwikiに追加することを提案するべきです。

既存のrel値のためのマイクロフォーマットページで「提案中」または「承認済み」のステータスを持つ拡張として定義されたタイプは、rel属性をlink、a、およびarea要素で「効果...」フィールドに従って使用することができます。[MFREL]

4.7 編集

ins 要素と del 要素は、文書への編集を表します。

4.7.1 ins 要素

要素/ins

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
知覚可能なコンテンツ。
この要素が使用できる文脈:
フレージングコンテンツが予期される場所。
コンテンツモデル:
透過。
text/html におけるタグの省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
cite — 引用元や編集に関する詳細情報へのリンク
datetime — 変更の日時（オプション）
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス:
HTMLModElement を使用します。

ins 要素は文書への追加を表します。

次の例は、1 つの段落の追加を表します:

<aside>
  <ins>
   <p> 私は果物が好きです。 </p>
  </ins>
 </aside>

次の例も同様です。ここでは、aside 要素内のすべての内容が フレージングコンテンツと見なされるため、段落は 1 つだけです: 

<aside>
  <ins>
   りんごは <em>おいしい</em>。
  </ins>
  <ins>
   梨もそうです。
  </ins>
 </aside>

ins 要素は 暗黙的な段落 の境界を超えてはいけません。

次の例では、2 つの段落が追加され、そのうち 2 番目の段落は 2 部に分けて挿入されています。この例の最初の ins 要素は 段落の境界を超えており、これは望ましくない形式と見なされます。

<aside>
  <!-- これは避けるべきです -->
  <ins datetime="2005-03-16 00:00Z">
   <p> 私は果物が好きです。 </p>
   りんごは <em>おいしい</em>。
  </ins>
  <ins datetime="2007-12-19 00:00Z">
   梨もそうです。
  </ins>
 </aside>

これをより適切にマークアップする方法を示します。要素は増えますが、どの要素も暗黙的な段落の境界を超えていません。

<aside>
  <ins datetime="2005-03-16 00:00Z">
   <p> 私は果物が好きです。 </p>
  </ins>
  <ins datetime="2005-03-16 00:00Z">
   りんごは <em>おいしい</em>。
  </ins>
  <ins datetime="2007-12-19 00:00Z">
   梨もそうです。
  </ins>
 </aside>

4.7.2 del 要素

要素/del

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
知覚可能なコンテンツ。
この要素が使用できる文脈:
フレージングコンテンツが予期される場所。
コンテンツモデル:
透過。
text/html におけるタグの省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
cite — 引用元や編集に関する詳細情報へのリンク
datetime — 変更の日時（オプション）
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス:
HTMLModElement を使用します。

del 要素は文書からの削除を表します。

del 要素は 暗黙的な段落 の境界を超えてはいけません。

次の例は、「やること」リストを示しており、完了した項目が完了日時と共に取り消し線で表示されています。

<h1>やること</h1>
 <ul>
  <li>食器洗い機を空にする</li>
  <li><del datetime="2009-10-11T01:25-07:00">ウォルター・ルウィンの講義を見る</del></li>
  <li><del datetime="2009-10-10T23:38-07:00">さらにトラックをダウンロードする</del></li>
  <li>プリンターを買う</li>
 </ul>

4.7.3 ins 要素と del 要素に共通する属性

cite 属性は、変更を説明する文書の URL を指定するために使用できます。その文書が長い場合、たとえば会議の議事録の場合、 著者は変更について説明している特定の部分を指すフラグメントを含めることが推奨されます。

もし cite 属性が存在する場合、それは変更を説明する 有効な URL であり、 かつスペースで囲まれている可能性があります。対応する引用リンクを取得するには、属性の値を要素の ノード文書に対して 解析する必要があります。 ユーザーエージェントは、そのような引用リンクをユーザーがたどることを許可するかもしれませんが、それらは主にプライベート用途（例：サイトの編集についての統計を収集するサーバーサイドスクリプトによって）を目的としています。

datetime 属性は、変更の日時を指定するために使用できます。

もし存在する場合、datetime 属性の値は 有効な日時文字列でなければなりません。

ユーザーエージェントは datetime 属性を 日付または時間の文字列を解析するアルゴリズムに従って解析しなければなりません。 もしそれが日付またはグローバル日時を返さない場合、 その変更には関連するタイムスタンプがありません（値は非準拠です。有効な日時文字列ではありません）。 それ以外の場合、変更は指定された日付またはグローバル日時に行われたものと見なされます。もし指定された値がグローバル日時である場合、ユーザーエージェントは関連するタイムゾーンオフセット情報を使用して指定された日時を表示するタイムゾーンを決定するべきです。

この値はユーザーに表示される場合がありますが、主にプライベート用途を目的としています。

ins 要素と del 要素は、HTMLModElement インターフェイスを実装しなければなりません:

HTMLModElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+ 
[Exposed=Window]
 interface HTMLModElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute USVString cite;
   [CEReactions] attribute DOMString dateTime;
 };

cite IDL 属性は、要素の cite コンテンツ属性を反映しなければなりません。 dateTime IDL 属性は、要素の datetime コンテンツ属性を反映しなければなりません。

4.7.4 編集と段落

このセクションは規範的ではありません。

ins 要素と del 要素は段落構造に影響を与えないため、明示的な p 要素がなく 段落が暗黙的に解釈される場合、一つの ins または del 要素が、全体の段落やその他の 非フレージングコンテンツ要素、および別の段落の一部をまたがることがあります。例えば以下のように: 

<section>
  <ins>
   <p>
    これは挿入された段落です。
   </p>
   これは、上記の段落と同時に挿入された別の段落の最初の文です。
  </ins>
  これは、もともとあった2番目の文です。
 </section>

一部の段落を p 要素で包むことで、同じ ins または del 要素で、1つの段落の終わり、2つ目の段落全体、および3つ目の段落の始まりをカバーすることさえ可能です（ただし、これは非常に紛らわしく、良い実践とは見なされません）: 

<section>
  これは最初の段落です。 <ins>この文が挿入されました。
  <p>この2番目の段落が挿入されました。</p>
  この文も挿入されました。</ins> これは、この例の3つ目の段落です。
  <!-- （これはしないでください） -->
 </section>

しかし、暗黙的な段落が定義されている方法により、1つの段落の終わりと次の段落の始まりを同じ ins または del 要素でマークアップすることはできません。その代わりに、1つ（または2つ）の p 要素と2つの ins または del 要素を使用する必要があります。例えば次のように: 

<section>
  <p>これは最初の段落です。 <del>この文が削除されました。</del></p>
  <p><del>この文も削除されました。</del> この文には別の &lt;del&gt; 要素が必要でした。</p>
 </section>

上記の混乱も一因であるため、著者は常にすべての段落を p 要素でマークアップし、ins や del 要素が 暗黙的な段落の境界を越えないようにすることが強く推奨されます。

4.7.5 編集とリスト

このセクションは規範的ではありません。

ol 要素と ul 要素のコンテンツモデルは、ins および del 要素を子要素として許可していません。リストは、削除としてマークされた項目も含めて、常にすべての項目を表します。

項目が挿入または削除されたことを示すために、ins または del 要素を li 要素の内容の周りに包むことができます。項目が別の項目に置き換えられたことを示すために、単一の li 要素に1つ以上の del 要素を配置し、その後に1つ以上の ins 要素を続けることができます。

次の例では、空の状態で始まったリストに項目が追加され、時間とともに削除されました。強調表示された部分は、リストの「現在」の状態を示しています。ただし、リスト項目の番号は編集を考慮していません。

<h1>ストップシップバグ</h1>
 <ol>
  <li><ins datetime="2008-02-12T15:20Z">バグ 225: 雪で雨センサーが作動しない</ins></li>
  <li><del datetime="2008-03-01T20:22Z"><ins datetime="2008-02-14T12:02Z">バグ 228: 4月にウォーターバッファがオーバーフローする</ins></del></li>
  <li><ins datetime="2008-02-16T13:50Z">バグ 230: 給湯器が再生可能燃料を使用しない</ins></li>
  <li><del datetime="2008-02-20T21:15Z"><ins datetime="2008-02-16T14:25Z">バグ 232: 起動後に二酸化炭素排出が検出される</ins></del></li>
 </ol>

次の例では、果物だけが含まれていたリストが、色だけのリストに置き換えられました。

<h1></del>果物リスト</del><ins>色リスト</ins></h1>
 <ul>
  <li><del>ライム</del><ins>グリーン</ins></li>
  <li><del>リンゴ</del></li>
  <li>オレンジ</li>
  <li><del>ナシ</del></li>
  <li><ins>ティール</ins></li>
  <li><del>レモン</del></ins>イエロー</ins></li>
  <li>オリーブ</li>
  <li><ins>パープル</ins></li>
 </ul>

4.7.6 編集とテーブル

このセクションは規範的ではありません。

テーブルモデルの一部を構成する要素には、ins および del 要素を許可しない複雑なコンテンツモデル要件があるため、テーブルへの編集を示すことは難しい場合があります。

行全体または列全体が追加または削除されたことを示すために、その行または列内の各セルの内容全体を ins または del 要素で包むことができます。

ここでは、テーブルの行が追加されています:

<table>
  <thead>
   <tr> <th> ゲーム名           <th> ゲームパブリッシャー   <th> 評価
  <tbody> 
   <tr> <td> Diablo 2            <td> Blizzard         <td> 8/10 
   <tr> <td> Portal              <td> Valve            <td> 10/10 
   <tr> <td> <ins>Portal 2</ins> <td> <ins>Valve</ins> <td> <ins>10/10</ins>
 </table>

ここでは、列が削除されています（削除された時間と、それを説明するページへのリンクも示されています）:

<table>
  <thead>
   <tr> <th> ゲーム名           <th> ゲームパブリッシャー   <th> <del cite="/edits/r192" datetime="2011-05-02 14:23Z">評価</del>
  <tbody> 
   <tr> <td> Diablo 2            <td> Blizzard         <td> <del cite="/edits/r192" datetime="2011-05-02 14:23Z">8/10</del>
   <tr> <td> Portal              <td> Valve            <td> <del cite="/edits/r192" datetime="2011-05-02 14:23Z">10/10</del>
   </table>

一般的に言って、より複雑な編集（例: セルが削除され、その後すべてのセルが上または左に移動されたことを示すなど）を示す良い方法はありません。

4.8 埋め込みコンテンツ

4.8.1 picture 要素

要素/picture

すべての現在のエンジンでサポートされています。

Firefox38+Safari9.1+Chrome38+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLPictureElement

すべての現在のエンジンでサポートされています。

Firefox38+Safari9.1+Chrome38+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
埋め込みコンテンツ。
知覚可能なコンテンツ。
この要素が使用できる文脈:
埋め込みコンテンツが期待される場所。
コンテンツモデル:
0個以上の source 要素に続いて、1つの img 要素が続く。スクリプトサポート要素と混在することもある。
text/html におけるタグの省略:
タグは省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLPictureElement : HTMLElement {
   [HTMLConstructor] constructor();
 };

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

picture 要素は、似たような外見を持つ video 要素や audio 要素とは少し異なります。これらすべてには source 要素が含まれていますが、source 要素の src 属性は、picture 要素内にネストされている場合は意味を持ちません。また、リソース選択アルゴリズムも異なります。さらに、picture 要素自体は何も表示しません。単に、その中に含まれている img 要素に対して、複数の URL から選択できるコンテキストを提供するだけです。

4.8.2 source 要素

要素/source

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLSourceElement

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
picture 要素の子要素として、img 要素の前に。
メディア要素の子要素として、フローコンテンツや track 要素の前に。
コンテンツモデル:
なし。
text/html におけるタグの省略:
終了タグなし。
コンテンツ属性:
グローバル属性
type — 埋め込みリソースのタイプ
media — 適用されるメディア
src (audio または video 内) — リソースのアドレス
srcset (picture 内) — 高解像度ディスプレイや小型モニタなど、異なる状況で使用する画像
sizes (picture 内) — 異なるページレイアウト用の画像サイズ
width (picture 内) — 水平方向の寸法
height (picture 内) — 垂直方向の寸法
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window]
 interface HTMLSourceElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute USVString src;
   [CEReactions] attribute DOMString type;
   [CEReactions] attribute USVString srcset;
   [CEReactions] attribute DOMString sizes;
   [CEReactions] attribute DOMString media;
   [CEReactions] attribute unsigned long width;
   [CEReactions] attribute unsigned long height;
 };

source 要素は、img 要素に対して複数の代替 ソースセットを指定したり、メディア要素に対して複数の代替 メディアリソースを指定したりすることができます。これは単独では何も表しません。

type 属性は存在する場合があります。存在する場合、値は 有効な MIME タイプ文字列 でなければなりません。

media 属性も存在する場合があります。存在する場合、値には 有効なメディアクエリリスト が含まれている必要があります。ユーザーエージェントは、その値が環境に一致しない場合、次の source 要素にスキップします。

media 属性は、メディア要素のリソース選択アルゴリズム中に一度だけ評価されます。対照的に、picture 要素を使用する場合、ユーザーエージェントは環境の変化に対応します。

残りの要件は、親が picture 要素か、メディア要素かによって異なります:

source 要素の親が picture 要素の場合

srcset 属性が存在しなければなりません。また、srcset 属性です。

srcset 属性は、source 要素が選択された場合に、ソースセットに 画像ソースを提供します。

もし srcset 属性に 画像候補文字列が幅記述子を使用して存在する場合、sizes 属性も存在する場合があります。さらに、次の兄弟 img 要素が自動サイズを許可しない場合、sizes 属性が存在しなければなりません。sizes 属性は sizes 属性であり、source 要素が選択された場合、ソースサイズを ソースセットに提供します。

もし img 要素が自動サイズを許可する場合、先行する兄弟 source 要素には sizes 属性を省略することができます。このような場合、auto を指定したのと同等です。

source 要素は 寸法属性をサポートします。img 要素は、source 要素の width と height 属性を使用して、そのレンダリング寸法とアスペクト比を決定できます。レンダリングのセクションで定義されているように。

type 属性は、ソースセット内の画像のタイプを指定し、ユーザーエージェントが指定されたタイプをサポートしていない場合、次の source 要素にスキップできるようにします。

もし type 属性が指定されていない場合、ユーザーエージェントは画像フォーマットを取得した後、それをサポートしていないと判明しても、別の source 要素を選択しません。

source 要素が次の兄弟 source 要素または img 要素を持ち、srcset 属性が指定されている場合、少なくとも次のいずれかを持っていなければなりません:

src 属性は存在してはなりません。

source 要素の親が メディア要素の場合

src 属性は、URL をメディアリソースに指定します。その値は 有効な非空 URL で、前後にスペースが含まれている可能性があります。この属性は存在しなければなりません。

type 属性は メディアリソース のタイプを指定し、ユーザーエージェントがこの メディアリソース を取得する前に再生可能かどうかを判断するのに役立ちます。特定の MIME タイプが定義する codecs パラメータは、リソースのエンコード方法を正確に指定するために必要な場合があります。[RFC6381]

source 要素の src または type 属性を、要素がすでに video または audio 要素に挿入されているときに動的に変更しても効果はありません。再生内容を変更するには、単に メディア要素 に直接 src 属性を使用し、利用可能なリソースから選択するために canPlayType() メソッドを使用することが考えられます。一般的に、ドキュメントが解析された後で source 要素を手動で操作するのは不必要に複雑なアプローチです。

以下のリストには、codecs= MIME パラメータを type 属性で使用するいくつかの例が示されています。

H.264 制約ベースラインプロファイルビデオ（メインおよび拡張ビデオ互換）レベル3およびMP4コンテナ内の低複雑度AACオーディオ 
<source src='video.mp4' type='video/mp4; codecs="avc1.42E01E, mp4a.40.2"'>
H.264 拡張プロファイルビデオ（ベースライン互換）レベル3およびMP4コンテナ内の低複雑度AACオーディオ 
<source src='video.mp4' type='video/mp4; codecs="avc1.58A01E, mp4a.40.2"'>
H.264 メインプロファイルビデオレベル3およびMP4コンテナ内の低複雑度AACオーディオ 
<source src='video.mp4' type='video/mp4; codecs="avc1.4D401E, mp4a.40.2"'>
H.264 'ハイ' プロファイルビデオ（メイン、ベースライン、拡張プロファイルとは互換性がありません）レベル3およびMP4コンテナ内の低複雑度AACオーディオ 
<source src='video.mp4' type='video/mp4; codecs="avc1.64001E, mp4a.40.2"'>
MPEG-4 Visual Simple Profile Level 0 ビデオとMP4コンテナ内の低複雑度AACオーディオ 
<source src='video.mp4' type='video/mp4; codecs="mp4v.20.8, mp4a.40.2"'>
MPEG-4 Advanced Simple Profile Level 0 ビデオとMP4コンテナ内の低複雑度AACオーディオ 
<source src='video.mp4' type='video/mp4; codecs="mp4v.20.240, mp4a.40.2"'>
MPEG-4 Visual Simple Profile Level 0 ビデオと3GPPコンテナ内のAMRオーディオ 
<source src='video.3gp' type='video/3gpp; codecs="mp4v.20.8, samr"'>
Theora ビデオとOggコンテナ内のVorbisオーディオ 
<source src='video.ogv' type='video/ogg; codecs="theora, vorbis"'>
Theora ビデオとOggコンテナ内のSpeexオーディオ 
<source src='video.ogv' type='video/ogg; codecs="theora, speex"'>
Oggコンテナ内のVorbisオーディオのみ 
<source src='audio.ogg' type='audio/ogg; codecs=vorbis'>
Oggコンテナ内のSpeexオーディオのみ 
<source src='audio.spx' type='audio/ogg; codecs=speex'>
Oggコンテナ内のFLACオーディオのみ 
<source src='audio.oga' type='audio/ogg; codecs=flac'>
Oggコンテナ内のDiracビデオとVorbisオーディオ 
<source src='video.ogv' type='video/ogg; codecs="dirac, vorbis"'>

srcset および sizes 属性は存在してはなりません。

insertedNode を指定したsource HTML要素挿入手順は次のとおりです。

  1. parent を insertedNode の親とします。

  2. parent がsrc属性を持たず、そのnetworkStateがNETWORK_EMPTYの値を持つメディア要素である場合、そのメディア要素のリソース選択アルゴリズムを呼び出します。

  3. parent がpicture要素である場合、parentの子の各childについて反復処理を行い、childがimg要素である場合、これをchildの関連する変更としてカウントします。

movedNode とoldParent を指定したsource HTML要素移動手順は次のとおりです。

  1. oldParent がpicture要素である場合、oldParentの子の各childについて反復処理を行い、childがimg要素である場合、これをchildの関連する変更としてカウントします。

removedNode とoldParent を指定したsource HTML要素削除手順は次のとおりです。

  1. oldParent がpicture要素である場合、oldParentの子の各childについて反復処理を行い、childがimg要素である場合、これをchildの関連する変更としてカウントします。

IDL属性src、type、srcset、sizes、およびmediaは、同じ名前のそれぞれのコンテンツ属性を反映しなければなりません。

提供されたメディアリソースがすべてのユーザーエージェントでレンダリングできるかどうかを著者が確信していない場合、著者は最後のエラーイベントをsource要素でリッスンし、フォールバック動作をトリガーすることができます。 

<script>
  function fallback(video) {
    // <video> の内容で置き換える
    while (video.hasChildNodes()) {
      if (video.firstChild instanceof HTMLSourceElement)
        video.removeChild(video.firstChild);
      else
        video.parentNode.insertBefore(video.firstChild, video);
    }
    video.parentNode.removeChild(video);
  }
 </script>
 <video controls autoplay>
  <source src='video.mp4' type='video/mp4; codecs="avc1.42E01E, mp4a.40.2"'>
  <source src='video.ogv' type='video/ogg; codecs="theora, vorbis"'
          onerror="fallback(parentNode)">
  ...
 </video>

4.8.3 img 要素

要素/img

すべての現行エンジンでサポート。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLImageElement

すべての現行エンジンでサポート。

Firefox1+Safari1+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
埋め込みコンテンツ。
フォーム関連要素。
要素に usemap 属性がある場合: インタラクティブコンテンツ。
明確なコンテンツ。
この要素が使用できるコンテキスト:
埋め込みコンテンツが期待される場所。
すべての source 要素の後で、 picture 要素の子として。
コンテンツモデル:
なし。
text/html でのタグ省略:
終了タグはありません。
コンテンツ属性:
グローバル属性
alt — 画像が利用できない場合に使用する代替テキスト
src — リソースのアドレス
srcset — 高解像度ディスプレイ、小型モニターなど、さまざまな状況で使用する画像
sizes — 異なるページレイアウトの画像サイズ
crossorigin — この要素がクロスオリジンリクエストを処理する方法
usemap — 使用するイメージマップの名前
ismap — 画像がサーバーサイドイメージマップであるかどうか
width — 水平次元
height — 垂直次元
referrerpolicy — この要素によって開始されたフェッチのリファラーポリシー
decoding — プレゼンテーション用にこの画像を処理するときに使用するデコードのヒント
loading — ローディングの延期を決定するときに使用
fetchpriority — この要素によって開始されたフェッチの優先度を設定します
アクセシビリティの考慮事項:
要素に非空の alt 属性がある場合: 著者向け; 実装者向け。
そうでない場合: 著者向け; 実装者向け。
DOM インターフェイス: 
[Exposed=Window,
  LegacyFactoryFunction=Image(optional unsigned long width, optional unsigned long height)]
 interface HTMLImageElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString alt;
   [CEReactions] attribute USVString src;
   [CEReactions] attribute USVString srcset;
   [CEReactions] attribute DOMString sizes;
   [CEReactions] attribute DOMString? crossOrigin;
   [CEReactions] attribute DOMString useMap;
   [CEReactions] attribute boolean isMap;
   [CEReactions] attribute unsigned long width;
   [CEReactions] attribute unsigned long height;
   readonly attribute unsigned long naturalWidth;
   readonly attribute unsigned long naturalHeight;
   readonly attribute boolean complete;
   readonly attribute USVString currentSrc;
   [CEReactions] attribute DOMString referrerPolicy;
   [CEReactions] attribute DOMString decoding;
   [CEReactions] attribute DOMString loading;
   [CEReactions] attribute DOMString fetchPriority;
 
   Promise<undefined> decode();
 
   // also has obsolete members
 };

img 要素は画像を表します。

img 要素には、最初に要素自体に設定される寸法属性ソースがあります。

HTMLImageElement/src

すべての現行エンジンでサポート。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Element/img#attr-srcset

すべての現行エンジンでサポート。

Firefox38+Safari8+Chrome34+
Opera?Edge79+
Edge (Legacy)≤18+Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

src属性およびsrcset属性、そして親がpicture要素である場合に、前の兄弟要素であるsource要素のsrcset属性に指定された画像が埋め込みコンテンツです。alt属性の値は、画像を処理できない人や画像の読み込みを無効にしている人のために同等のコンテンツを提供します（つまり、これはimg要素のフォールバックコンテンツです）。

alt属性の値に関する要件は、別のセクションで説明されています。

src 属性と srcset 属性の少なくとも1つが存在しなければなりません。

src 属性が存在する場合、それはスペースで囲まれる可能性のある、空でない有効なURLを含まなければなりません。これは、ページ化もスクリプト化もされていない、非対話的で、オプションでアニメーション化された画像リソースを参照します。

上記の要件は、画像が静的なビットマップ（例：PNG、GIF、JPEG）、単一ページのベクタードキュメント（単一ページのPDF、SVGドキュメント要素を含むXMLファイル）、アニメーション化されたビットマップ（APNG、アニメーションGIF）、アニメーション化されたベクターグラフィックス（宣言型SMILアニメーションを使用するSVGドキュメント要素を含むXMLファイル）などであることを意味します。しかし、これらの定義は、スクリプトを含むSVGファイル、複数ページのPDFファイル、インタラクティブなMNGファイル、HTMLドキュメント、プレーンテキストドキュメントなどを除外します。[PNG] [GIF] [JPEG] [PDF] [XML] [APNG] [SVG] [MNG]

srcset 属性は srcset 属性です。

srcset 属性と src 属性（幅記述子が使用されていない場合）は、ソースセットに画像ソースを提供します（source 要素が選択されなかった場合）。

srcset 属性が存在し、幅記述子を使用する画像候補文字列がある場合、sizes 属性も存在しなければなりません。 srcset 属性が指定されておらず、loading 属性が遅延状態の場合、sizes 属性は値 "auto"（ASCII 大文字小文字を区別しない）で指定できます。sizes 属性は sizes 属性であり、ソースセットにソースサイズを提供します（source 要素が選択されなかった場合）。

img要素は、以下の条件を満たす場合に自動サイズを許可します:

Attributes/crossorigin

すべての現行エンジンでサポート。

Firefox8+Safari6+Chrome13+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

crossorigin 属性はCORS 設定属性です。その目的は、クロスオリジンアクセスを許可するサードパーティサイトの画像を canvas で使用できるようにすることです。

referrerpolicy 属性はリファラーポリシー属性です。その目的は、画像をフェッチする際に使用される リファラーポリシーを設定することです。[REFERRERPOLICY]

decoding 属性は、この画像をデコードするための優先方法を示します。この属性が存在する場合、画像デコードヒントでなければなりません。この属性の 欠落値のデフォルト および 無効値のデフォルト はどちらも Auto状態です。

HTMLImageElement/fetchPriority

Firefoxいいえ🔰プレビュー+102+
Opera?Edge102+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

fetchpriority 属性はフェッチ優先属性です。その目的は、画像をフェッチする際に使用される優先度を設定することです。

loading 属性は遅延読み込み属性です。その目的は、ビューポートの外にある画像を読み込むポリシーを示すことです。

loading 属性の状態が 早期状態に変更されたとき、ユーザーエージェントは次のステップを実行する必要があります:

  1. resumptionSteps を img 要素の遅延読み込み再開ステップに設定します。

  2. もし resumptionSteps が null であれば、終了します。

  3. img の遅延読み込み再開ステップを null に設定します。

  4. resumptionSteps を実行します。 

<img src="1.jpeg" alt="1">
<img src="2.jpeg" loading=eager alt="2">
<img src="3.jpeg" loading=lazy alt="3">
<div id=very-large></div> <!-- この div の後のすべての要素はビューポートの下にあります -->
<img src="4.jpeg" alt="4">
<img src="5.jpeg" loading=lazy alt="5">

上記の例では、画像は次のように読み込まれます:

1.jpeg, 2.jpeg, 4.jpeg

これらの画像は早期に読み込まれ、ウィンドウの load イベントを遅延させます。

3.jpeg

この画像はビューポート内にあるため、レイアウトが判明したときに読み込まれますが、ウィンドウの load イベントを遅延させません。

5.jpeg

この画像はビューポートにスクロールされた後にのみ読み込まれ、ウィンドウの load イベントを遅延させません。

開発者は、width および height 属性を使用して遅延読み込みされた画像の好ましいアスペクト比を指定することを推奨します。これは、CSS が画像の width および height プロパティを設定していても、画像の読み込み後にページレイアウトが移動するのを防ぐためです。

insertedNode を指定したimg HTML要素挿入手順は次のとおりです。

  1. insertedNode の親がpicture要素である場合、これをinsertedNodeの関連する変更としてカウントします。

movedNode とoldParent を指定したimg HTML要素移動手順は次のとおりです。

  1. oldParent がpicture要素である場合、これをmovedNodeの関連する変更としてカウントします。

removedNode とoldParent を指定したimg HTML要素削除手順は次のとおりです。

  1. oldParent がpicture要素である場合、これをremovedNodeの関連する変更としてカウントします。

img 要素はレイアウトツールとして使用してはなりません。特に、img 要素を透明な画像の表示に使用してはなりません。これらの画像は意味を伝えることがほとんどなく、文書に有用なものを追加することもめったにありません。

img 要素が表す内容は、src 属性および alt 属性によって異なります。

src 属性が設定され、かつ alt 属性が空の文字列に設定されている場合

画像は装飾的またはコンテンツの補足的なものであり、文書内の他の情報と冗長である可能性があります。

画像が利用可能であり、ユーザーエージェントがその画像を表示するように設定されている場合、要素はその画像データを表します。

それ以外の場合、要素は何も表しません。レンダリングから完全に省略される場合があります。ユーザーエージェントは、画像が存在するがレンダリングから省略されたことをユーザーに通知する場合があります。

src 属性が設定され、かつ alt 属性が空でない値に設定されている場合

画像はコンテンツの重要な部分であり、alt 属性はその画像のテキスト等価物または代替物を提供します。

画像が利用可能であり、ユーザーエージェントがその画像を表示するように設定されている場合、要素はその画像データを表します。

それ以外の場合、要素は alt 属性で指定されたテキストを表します。ユーザーエージェントは、画像が存在するがレンダリングから省略されたことをユーザーに通知する場合があります。

src 属性が設定され、alt 属性が設定されていない場合

画像はコンテンツの重要な部分である可能性があり、画像のテキスト等価物が利用できない状態です。

適合文書において、alt 属性が欠如していることは、画像がコンテンツの重要な部分であることを示していますが、画像が生成されたときにその画像のテキストによる代替が利用できなかったことを意味します。

画像が利用可能であり、ユーザーエージェントがその画像を表示するように設定されている場合、要素はその画像データを表します。

画像が空の文字列を持つ src 属性を持っている場合、要素は何も表しません。

それ以外の場合、ユーザーエージェントは画像がレンダリングされていないことを示す何らかの指標を表示すべきです。また、ユーザーの要求に応じて、設定されている場合、またはナビゲーションに応じてコンテキスト情報を提供する必要がある場合、次のようにキャプション情報を提供する場合があります:

  1. 画像に空の文字列ではない値を持つtitle属性がある場合、その属性の値を返します。

  2. 画像が、子figcaption要素を持つfigure要素の子孫であり、figcaption要素とその子孫を無視すると、figure要素に要素間の空白とimg要素以外のフローコンテンツの子孫がない場合、最初に見つかったそのようなfigcaption要素の内容を返します。

  3. 何も返しません。（キャプション情報はありません。）

src 属性が設定されておらず、かつ alt 属性が空の文字列に設定されているか、またはまったく設定されていない場合

要素は何も表しません。

それ以外の場合

要素は alt 属性で指定されたテキストを表します。

alt 属性は助言情報を表しません。ユーザーエージェントは alt 属性の内容を title 属性の内容と同じように表示してはなりません。

ユーザーエージェントは、常にユーザーに画像を表示するオプションや、画像の表示を防ぐオプションを提供することができます。ユーザーが画像を見ることができない場合（視覚障害がある場合やグラフィック機能のないテキスト端末を使用している場合など）、ユーザーエージェントはユーザーが画像を活用できるように支援するためのヒューリスティックを適用することもできます。たとえば、画像内のテキストを光学文字認識 (OCR) することなどが考えられます。

ユーザーエージェントは alt 属性が欠落している場合の修復を推奨しますが、著者はそのような動作に依存してはなりません。画像の代替として機能するテキストを提供するための要件については、以下で詳しく説明します。

img 要素の内容は、レンダリングの目的では無視されます。

usemap 属性が存在する場合、画像に関連するイメージマップがあることを示すことができます。

ismap 属性は、a 要素の子孫であり、href 属性を持つ要素に使用された場合、その要素がサーバーサイドイメージマップへのアクセスを提供することを示します。これにより、対応する a 要素でのイベントの処理方法に影響を与えます。

ismap 属性はブール属性です。この属性は、祖先に a 要素があり、href 属性を持っていない要素には指定してはなりません。

usemap および ismap 属性は、source 要素と、media 属性を指定した picture 要素と一緒に使用されると、混乱を招く動作を引き起こす可能性があります。

img 要素は寸法属性をサポートします。

HTMLImageElement/alt

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLImageElement/srcset

すべての現行エンジンでサポートされています。

Firefox38+Safari8+Chrome34+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLImageElement/sizes

すべての現行エンジンでサポートされています。

Firefox38+Safari9.1+Chrome38+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

IDL属性であるalt、src、srcset、およびsizesは、同じ名前のそれぞれのコンテンツ属性を反映しなければなりません。

HTMLImageElement/crossOrigin

すべての現行エンジンでサポートされています。

Firefox8+Safari6+Chrome13+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

crossOrigin IDL属性は、crossoriginコンテンツ属性を反映し、既知の値にのみ限定されます。

HTMLImageElement/useMap

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

useMap IDL属性は、usemapコンテンツ属性を反映しなければなりません。

HTMLImageElement/isMap

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

isMap IDL属性は、ismapコンテンツ属性を反映しなければなりません。

HTMLImageElement/referrerPolicy

すべての現行エンジンでサポートされています。

Firefox50+Safari14+Chrome52+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

referrerPolicy IDL属性は、referrerpolicyコンテンツ属性を反映しなければなりません。また、既知の値に限定されます。

HTMLImageElement/decoding

すべての現行エンジンでサポートされています。

Firefox63+Safari11.1+Chrome65+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

SVGImageElement/decoding

Firefox63+SafariNoChrome65+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

decoding IDL属性は、decodingコンテンツ属性を反映し、既知の値に限定されます。

HTMLImageElement/loading

すべての現行エンジンでサポートされています。

Firefox75+Safari15.4+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

loading IDL属性は、loadingコンテンツ属性を反映し、既知の値に限定されます。

fetchPriority IDL属性は、fetchpriorityコンテンツ属性を反映し、既知の値に限定されます。

image.width [ = value ]

HTMLImageElement/width

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
image.height [ = value ]

HTMLImageElement/height

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

これらの属性は、画像の実際のレンダリング寸法を返すか、寸法が不明な場合は0を返します。

それらを設定することにより、対応するコンテンツ属性を変更することができます。

image.naturalWidth

HTMLImageElement/naturalWidth

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
image.naturalHeight

HTMLImageElement/naturalHeight

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

これらの属性は、画像の自然な寸法を返すか、寸法が不明な場合は0を返します。

image.complete

HTMLImageElement/complete

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

画像が完全にダウンロードされた場合、または画像が指定されていない場合はtrueを返し、それ以外の場合はfalseを返します。

image.currentSrc

HTMLImageElement/currentSrc

すべての現行エンジンでサポートされています。

Firefox38+Safari9.1+Chrome38+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

画像の絶対URLを返します。

image.decode()

HTMLImageElement/decode

すべての現行エンジンでサポートされています。

Firefox68+Safari11.1+Chrome64+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

SVGImageElement/decode

Firefox68+SafariNoChrome64+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

このメソッドは、ユーザーエージェントに画像を並行してデコードさせ、デコードが完了すると解決されるpromiseを返します。

画像をデコードできない場合、promiseは"EncodingError" DOMExceptionで拒否されます。

image = new Image([ width [, height ] ])

HTMLImageElement/Image

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

新しいimg要素を返し、該当する引数で指定された場合、widthおよびheight属性を設定します。

IDL属性widthおよびheightは、画像がレンダリングされている場合は、その画像のレンダリングされた幅と高さをCSSピクセル単位で返さなければなりません。また、画像が密度補正された自然な幅と高さを持ち、利用可能であるが、レンダリングされていない場合は、その幅と高さをCSSピクセル単位で返さなければなりません。そうでない場合、画像が利用可能でないか、密度補正された自然な幅と高さを持っていない場合は、0を返します。[CSS]

設定時には、それらは同じ名前の対応するコンテンツ属性を反映しているかのように動作しなければなりません。

IDL属性naturalWidthおよびnaturalHeightは、画像が密度補正された自然な幅と高さを持ち、利用可能である場合、その幅と高さをCSSピクセル単位で返さなければなりません。そうでない場合は、0を返します。[CSS]

画像の密度補正された自然な幅と高さは、そのメタデータに指定された向きを考慮しているため、naturalWidthおよびnaturalHeightは、'image-orientation'プロパティの値に関係なく、画像を正しく向けるために必要な回転を適用した後の寸法を反映します。

IDL属性completeのゲッターステップは以下の通りです：

  1. 次のいずれかが真である場合：

    この場合、trueを返します。

  2. それ以外の場合、falseを返します。

IDL属性currentSrcは、img要素の現在のリクエストの現在のURLを返さなければなりません。

IDLメソッドdecode()は、呼び出されたとき、次のステップを実行しなければなりません：

  1. 新しいpromiseを作成します。

  2. マイクロタスクをキューに入れ、次のステップを実行します：

    これは、画像データの更新が同じくマイクロタスク内で行われるためです。したがって、次のようなコードを適切に処理するには、 

    img.src = "stars.jpg";
 img.decode();

    stars.jpgを正しくデコードするには、処理を1つのマイクロタスクだけ遅らせる必要があります。

    1. global を、これの関連するグローバルオブジェクトとします。

    2. 次のいずれかが真である場合：

      その場合、promise を「EncodingError」 DOMExceptionで拒否します。

    3. それ以外の場合、並行して、次のいずれかのケースが発生するのを待ち、対応するアクションを実行します：

      このimg要素のノードドキュメントが完全にアクティブでなくなる
      このimg要素の現在のリクエストが変更されるか、変更される
      このimg要素の現在のリクエストの状態が破損する

      global を使用してDOM操作タスクソースでグローバルタスクをキューに入れ、promise を「EncodingError」 DOMExceptionで拒否します。

      このimg要素の現在のリクエストの状態が完全に利用可能になる

      画像をデコードします。

      この画像に対してデコードを実行する必要がない場合（たとえば、ベクターグラフィックであるため）、またはデコードプロセスが正常に完了した場合、global を使用してDOM操作タスクソースでグローバルタスクをキューに入れ、promise をundefinedで解決します。

      デコードが失敗した場合（たとえば、無効な画像データのため）、global を使用してDOM操作タスクソースでグローバルタスクをキューに入れ、promise を「EncodingError」 DOMExceptionで拒否します。

      ユーザーエージェントは、デコードされたメディアデータが、イベントループの次の成功したレンダリングの更新ステップの少なくとも終わりまで容易に利用可能な状態を維持するようにする必要があります。これはAPIコントラクトの重要な部分であり、可能な限り破られるべきではありません。（通常、これはデコードされた画像データを削除する必要がある低メモリ状況、または画像がこの期間デコードされた形式で保持するには大きすぎる場合にのみ違反されます。）

      アニメーション画像は、すべてのフレームがロードされた後にのみ完全に利用可能になります。したがって、実装がその時点より前に最初のフレームをデコードできたとしても、上記の手順ではそうせず、代わりにすべてのフレームが利用可能になるまで待機します。

  3. promiseを返します。

decode()メソッドを使用しない場合、img要素をロードしてから表示するプロセスは次のようになります： 

const img = new Image();
img.src = "nebula.jpg";
img.onload = () => {
    document.body.appendChild(img);
};
img.onerror = () => {
    document.body.appendChild(new Text("Could not load the nebula :("));
};

しかし、これは画像をDOMに挿入した後に発生する描画がメインスレッドでの同期デコードを引き起こすため、フレームが大幅に落ちる可能性があります。

これを代わりにdecode()メソッドを使用して次のように書き換えることができます： 

const img = new Image();
img.src = "nebula.jpg";
img.decode().then(() => {
    document.body.appendChild(img);
}).catch(() => {
    document.body.appendChild(new Text("Could not load the nebula :("));
});

この後者の形式は、ユーザーエージェントが画像を並列でデコードし、デコードプロセスが完了してからDOMに挿入する（つまり、描画を引き起こす）ことにより、元の形式で発生するフレーム落ちを回避します。

decode()メソッドは、デコードされた画像データが少なくとも1フレームにわたって利用可能であることを保証しようとするため、requestAnimationFrame()APIと組み合わせることができます。これは、すべてのDOM変更がアニメーションフレームコールバックとしてまとめられることを保証するコーディングスタイルやフレームワークと共に使用できることを意味します： 

const container = document.querySelector("#container");

const { containerWidth, containerHeight } = computeDesiredSize();
requestAnimationFrame(() => {
    container.style.width = containerWidth;
    container.style.height = containerHeight;
});

// ...

const img = new Image();
img.src = "supernova.jpg";
img.decode().then(() => {
    requestAnimationFrame(() => container.appendChild(img));
});

レガシーファクトリ関数は、HTMLImageElementオブジェクトを作成するために提供されています（createElement()のようなDOMのファクトリメソッドに加えて）：Image(width, height)。このレガシーファクトリ関数が呼び出されたとき、次の手順を実行しなければなりません:

  1. documentを、現在のグローバルオブジェクトの関連するDocumentとします。

  2. img を、document、「img」、およびHTML名前空間を指定して要素を作成した結果とします。

  3. もしwidthが指定されている場合、"width"を使用してimgに対して属性値を設定します。

  4. もしheightが指定されている場合、"height"を使用してimgに対して属性値を設定します。

  5. imgを返します。

単一の画像には、文脈に応じて適切な代替テキストが異なる場合があります。

以下の各ケースでは、同じ画像が使用されていますが、毎回 alt テキストが異なります。 この画像はスイスのジュネーブ州にあるカロージュ市の紋章です。

ここでは補足的なアイコンとして使用されています：

<p>私はカロージュに住んでいました<img src="carouge.svg" alt="">。</p>

ここでは町を表すアイコンとして使用されています：

<p>故郷: <img src="carouge.svg" alt="カロージュ"></p>

ここでは町に関する文章の一部として使用されています：

<p>カロージュには紋章があります</p>
 <p><img src="carouge.svg" alt="紋章には木の前に座っているライオンが描かれています。"></p>
 <p>この紋章は町中の装飾として使われています。</p>

ここでは、画像の代わりに説明文が提供される場合、または画像の代わりに使用される場合に使用されています：

<p>カロージュには紋章があります</p>
 <p><img src="carouge.svg" alt=""></p>
 <p>紋章には木の前に座っているライオンが描かれています。 この紋章は町中の装飾として使われています。</p>

ここではストーリーの一部として使用されています：

<p>彼女はフォルダを手に取り、一枚の紙が落ちました。</p>
 <p><img src="carouge.svg" alt="盾の形をした紙には、赤い背景、緑の木、舌を出した黄色いライオンが描かれており、その尾はS字型になっています。"></p>
 <p>彼女はフォルダを見つめました。S！ 彼女がずっと探していた答えは、単にSの文字でした！ それをどうして今まで見逃していたのだろう？ 全てが繋がりました。ヘクターがライオンの尾について言及した電話、マリアが舌を出したときのこと…</p>

ここでは、画像が何であるかは発表時には不明であり、代替テキストを提供できず、画像の簡単なキャプションのみが title 属性に提供されています：

<p>最後に紋章をアップロードしたユーザーがこの画像をアップロードしました：</p>
 <p><img src="last-uploaded-coat-of-arms.cgi" title="ユーザーがアップロードした紋章。"></p>

理想的には、このケースでも実際の代替テキストを提供する方法を見つけることが望ましいです。例えば、前のユーザーに問い合わせるなどして。代替テキストを提供しないことは、画像を表示できない人々（例：視覚障害者、非常に低帯域幅の接続を使用しているユーザー、バイト単位で課金されるユーザー、またはテキストのみのWebブラウザーを使用することを余儀なくされているユーザー）にとって、文書の使用をより困難にします。

同じ画像が異なる文脈で使用され、それぞれに適した異なる代替テキストを持つさらに多くの例を以下に示します。

<article>
  <h1>私の猫たち</h1>
  <h2>フラッフィー</h2>
  <p>フラッフィーは私のお気に入りです</p>
  <img src="fluffy.jpg" alt="彼女は毛糸の玉で遊ぶのが好きです。">
  </p>彼女は本当にかわいいです。</p>
  <h2>マイルズ</h2>
  <p>私のもう一匹の猫、マイルズはただ食べて寝るだけです</p>
 </article>
<article>
  <h1>写真撮影</h1>
  <h2>室内で動く被写体を撮影する</h2>
  <p>ここでのコツは、予測することです。被写体がどの速度で、どの距離で通過するかを知ることです</p>
  <img src="fluffy.jpg" alt="毛糸の玉を追いかける猫を、この技術でうまく撮影できます。">
  </h2>夜の自然</h2>
  </p>これを実現するには、非常に感度の高いフィルム、または強力なフラッシュライトが必要です</p>
 </article>
<article>
  <h1>私について</h1>
  <h2>私のペットたち</h2>
  <p>私はフラッフィーという名の猫と、マイルズという名の犬を飼っています</p>
  <img src="fluffy.jpg" alt="私の猫フラッフィーは、よく一人で遊んでいます。">
  </p>私の犬マイルズとは一緒に長い散歩に行くのが好きです</p>
  <h2>音楽</h2>
  </p>散歩の後、頭を空っぽにしてバッハを聴くのが好きです</p>
 </article>
<article>
  <h1>フラッフィーと毛糸</h1>
  </p>フラッフィーは毛糸で遊ぶのが好きな猫でした。ジャンプも好きでした</p>
  <aside><img src="fluffy.jpg" alt="" title="フラッフィー"></aside>
  </p>彼女は朝に遊び、夜に遊びました</p>
 </article>

4.8.4 画像

4.8.4.1 概要

このセクションは非規範的です。

HTMLに画像を埋め込むには、画像リソースが1つしかない場合、img要素とそのsrc属性を使用します。

<h2>今日の注目記事</h2>
<img src="/uploads/100-marie-lloyd.jpg" alt="" width="100" height="150">
<p><b><a href="/wiki/Marie_Lloyd">Marie Lloyd</a></b> (1870–1922) はイギリスの<a href="/wiki/Music_hall">ミュージックホール</a>歌手で、...

ただし、ユーザーエージェントが選択できる複数の画像リソースを使用したい場合もあります。

上記の状況は相互に排他的ではありません。たとえば、デバイスピクセル比が異なる場合に異なるリソースを組み合わせることと、アートディレクションを組み合わせることは合理的です。

これらの問題をスクリプトを使用して解決することは可能ですが、それにより別の問題が発生します：

これを踏まえ、この仕様では上記の問題に対処するためにいくつかの機能を宣言的に導入しています。

デバイスピクセル比に基づく選択、画像のレンダリングサイズが固定されている場合

srcおよびsrcset属性は、img要素に使用され、x記述子を使用して、サイズだけが異なる複数の画像（小さい画像は大きい画像の縮小版です）を提供することができます。

x記述子は、画像のレンダリングサイズがビューポート幅に依存する場合（ビューポートベースの選択）には適していませんが、アートディレクションと一緒に使用することができます。

<h2>今日の注目記事</h2>
<img src="/uploads/100-marie-lloyd.jpg"
srcset="/uploads/150-marie-lloyd.jpg 1.5x, /uploads/200-marie-lloyd.jpg 2x"
alt="" width="100" height="150">
<p><b><a href="/wiki/Marie_Lloyd">Marie Lloyd</a></b> (1870–1922) はイギリスの<a href="/wiki/Music_hall">ミュージックホール</a>歌手で、...

ユーザーエージェントは、ユーザーの画面のピクセル密度、ズームレベル、およびネットワーク状況などの他の要因に応じて、指定されたリソースのいずれかを選択できます。

古いユーザーエージェントとの互換性を確保するために、srcset属性をまだ理解していない場合、URLの1つがimg要素のsrc属性に指定されます。これにより、古いユーザーエージェントでも何かしらの（おそらく低解像度の）画像が表示されます。新しいユーザーエージェントでは、src属性はsrcsetに1x記述子が指定されたかのように、リソース選択に参加します。

画像のレンダリングサイズは幅および高さ属性で指定されており、ユーザーエージェントは画像がダウンロードされる前にそのスペースを確保できます。

ビューポートベースの選択

srcsetおよびsizes属性はw記述子を使用して、サイズだけが異なる複数の画像（小さい画像は大きい画像の縮小版です）を提供するために使用できます。

この例では、バナー画像がビューポート幅全体を占めています（適切なCSSを使用）。

<h1><img sizes="100vw" srcset="wolf-400.jpg 400w, wolf-800.jpg 800w, wolf-1600.jpg 1600w"
src="wolf-400.jpg" alt="The rad wolf"></h1>

ユーザーエージェントは、指定されたw記述子およびsizes属性に基づいて、各画像の有効なピクセル密度を計算し、ユーザーの画面のピクセル密度、ズームレベル、およびネットワーク状況などの他の要因に応じて、指定されたリソースのいずれかを選択できます。

ユーザーの画面が320CSSピクセル幅の場合、これはwolf-400.jpg 1.25x, wolf-800.jpg 2.5x, wolf-1600.jpg 5xを指定したことに相当します。一方、ユーザーの画面が1200CSSピクセル幅の場合、これはwolf-400.jpg 0.33x, wolf-800.jpg 0.67x, wolf-1600.jpg 1.33xを指定したことに相当します。w記述子およびsizes属性を使用することで、ユーザーエージェントはデバイスのサイズに関係なく、適切な画像ソースをダウンロードできます。

後方互換性を確保するために、URLの1つがimg要素のsrc属性に指定されています。新しいユーザーエージェントでは、src属性は、srcset属性がw記述子を使用している場合に無視されます。

この例では、ビューポート幅に応じて3つのレイアウトが設定されています。狭いレイアウトでは画像が1列（各画像の幅は約100%）、中間レイアウトでは画像が2列（各画像の幅は約50%）、最も広いレイアウトでは画像が3列で、ページの余白もあります（各画像の幅は約33%）。これらのレイアウトは、それぞれ30emおよび50emのビューポート幅で切り替わります。 

<img sizes="(max-width: 30em) 100vw, (max-width: 50em) 50vw, calc(33vw - 100px)"
srcset="swing-200.jpg 200w, swing-400.jpg 400w, swing-800.jpg 800w, swing-1600.jpg 1600w"
src="swing-400.jpg" alt="Kettlebell Swing">

sizes属性は、30emおよび50emでレイアウトのブレークポイントを設定し、これらのブレークポイント間で画像のサイズを100vw、50vw、またはcalc(33vw - 100px)と宣言します。これらのサイズは、CSSで指定された実際の画像幅と必ずしも一致する必要はありません。

ユーザーエージェントは、sizes属性から幅を選択し、最初に一致する<media-condition>（括弧内の部分）がtrueで評価されるもの、またはすべてがfalseで評価される場合は最後のアイテムcalc(33vw - 100px)を使用します。

たとえば、ビューポート幅が29emの場合、(max-width: 30em)がtrueで評価され100vwが使用されるため、リソース選択の目的で画像サイズは29emです。一方、ビューポート幅が32emの場合、(max-width: 30em)はfalseで評価されますが、(max-width: 50em)はtrueで評価され50vwが使用されるため、リソース選択の目的で画像サイズはビューポート幅の半分である16emになります。わずかに広いビューポートが異なるレイアウトのため、画像が小さくなることに注意してください。

その後、ユーザーエージェントは有効なピクセル密度を計算し、前の例と同様に適切なリソースを選択できます。

この例は前の例と同じですが、画像は遅延ロードされます。この場合、sizes属性はautoキーワードを使用でき、ユーザーエージェントはソースサイズのために幅属性（またはCSSで指定された幅）を使用します。 

<img loading="lazy" width="200" height="200" sizes="auto"
srcset="swing-200.jpg 200w, swing-400.jpg 400w, swing-800.jpg 800w, swing-1600.jpg 1600w"
src="swing-400.jpg" alt="Kettlebell Swing">

レガシーユーザーエージェントとの互換性を高めるために、autoキーワードをサポートしていない場合、必要に応じてフォールバックサイズを指定できます。 

<img loading="lazy" width="200" height="200"
sizes="auto, (max-width: 30em) 100vw, (max-width: 50em) 50vw, calc(33vw - 100px)"
srcset="swing-200.jpg 200w, swing-400.jpg 400w, swing-800.jpg 800w, swing-1600.jpg 1600w"
src="swing-400.jpg" alt="Kettlebell Swing">
アートディレクションベースの選択

picture要素およびsource要素は、media属性と組み合わせて、画像コンテンツを変更するために使用できます（例えば、小さい画像は大きい画像のトリミング版である可能性があります）。 

<picture>
<source media="(min-width: 45em)" srcset="large.jpg">
<source media="(min-width: 32em)" srcset="med.jpg">
<img src="small.jpg" alt="The wolf runs through the snow.">
</picture>

ユーザーエージェントは、source要素のmedia属性のメディアクエリが一致する最初の要素を選択し、その後、そのsrcset属性から適切なURLを選択します。

選択されたリソースに応じて、画像のレンダリングサイズが変化します。CSSを使用して、ユーザーエージェントが画像をダウンロードする前に使用できる寸法を指定できます。

img { width: 300px; height: 300px }
@media (min-width: 32em) { img { width: 500px; height:300px } }
@media (min-width: 45em) { img { width: 700px; height:400px } }

この例はアートディレクションとデバイスピクセル比に基づく選択を組み合わせたものです。ビューポートの半分を占めるバナーが、ワイドスクリーン用とナロースクリーン用の2つのバージョンで提供されます。 

<h1>
<picture>
<source media="(max-width: 500px)" srcset="banner-phone.jpeg, banner-phone-HD.jpeg 2x">
<img src="banner.jpeg" srcset="banner-HD.jpeg 2x" alt="朝食コンボ">
</picture>
</h1>
画像フォーマットベースの選択

type属性はsource要素に使用され、異なるフォーマットの複数の画像を提供するために使用できます。 

<h2>今日の注目記事</h2>
<picture>
<source srcset="/uploads/100-marie-lloyd.webp" type="image/webp">
<source srcset="/uploads/100-marie-lloyd.jxr" type="image/vnd.ms-photo">
<img src="/uploads/100-marie-lloyd.jpg" alt="" width="100" height="150">
</picture>
<p><b><a href="/wiki/Marie_Lloyd">Marie Lloyd</a></b> (1870–1922) はイギリスの<a href="/wiki/Music_hall">ミュージックホール</a>歌手で、...

この例では、ユーザーエージェントは、サポートされているMIMEタイプを持つtype属性を持つ最初のソースを選択します。ユーザーエージェントがWebP画像をサポートしている場合、最初のsource要素が選択されます。そうでなくても、ユーザーエージェントがJPEG XR画像をサポートしている場合、2番目のsource要素が選択されます。それらのフォーマットのいずれもサポートされていない場合は、img要素が選択されます。

4.8.4.1.1 適応画像

このセクションは規範的ではありません。

CSSとメディアクエリを使用して、ユーザーの環境に動的に適応するグラフィカルなページレイアウトを構築できます。特に、異なるビューポートの寸法やピクセル密度に対応するためです。しかし、コンテンツに関しては、CSSは助けになりません。代わりに、img要素のsrcset属性とpicture要素を使用します。このセクションでは、これらの機能の使用方法を示すサンプルケースを説明します。

たとえば、幅が600CSSピクセルを超える広い画面では、a-rectangle.pngという名前の300×150の画像を使用し、600CSSピクセル以下の小さな画面では、a-square.pngという名前の100×100の小さい画像を使用する場合、このようなマークアップになります： 

<figure>
  <picture>
   <source srcset="a-square.png" media="(max-width: 600px)">
   <img src="a-rectangle.png" alt="バーニー・フランクがスーツと眼鏡を着用しています。">
  </picture>
  <figcaption>バーニー・フランク、2011年</figcaption>
</figure>

alt属性に何を入れるべきかについては、画像の代替として機能するテキストを提供するための要件のセクションを参照してください。

この問題は、画像の読み込み時にユーザーエージェントが画像の寸法を必ずしも知っているわけではないことです。ページの読み込み中にレイアウトが何度も再フローされるのを防ぐために、CSSとCSSメディアクエリを使用して寸法を提供できます： 

<style>
  #a { width: 300px; height: 150px; }
  @media (max-width: 600px) { #a { width: 100px; height: 100px; } }
</style>
<figure>
  <picture>
   <source srcset="a-square.png" media="(max-width: 600px)">
   <img src="a-rectangle.png" alt="バーニー・フランクがスーツと眼鏡を着用しています。" id="a">
  </picture>
  <figcaption>バーニー・フランク、2011年</figcaption>
</figure>

あるいは、source 要素と img 要素で width 属性と height 属性を使用して、幅と高さを指定することもできます。 

<figure>
 <picture>
  <source srcset="a-square.png" media="(max-width: 600px)" width="100" height="100">
  <img src="a-rectangle.png" width="300" height="150"
  alt="Barney Frank wears a suit and glasses.">
 </picture>
 <figcaption>Barney Frank, 2011</figcaption>
</figure>

img 要素は src 属性とともに使用され、picture 要素をサポートしないレガシーユーザーエージェントで使用する画像の URL を指定します。これにより、src 属性でどの画像を提供するかという問題が生じます。

著者がレガシーユーザーエージェントで最大の画像を望む場合、マークアップは次のようになります：

<picture>
  <source srcset="pear-mobile.jpeg" media="(max-width: 720px)">
  <source srcset="pear-tablet.jpeg" media="(max-width: 1280px)">
  <img src="pear-desktop.jpeg" alt="梨はジューシーです。">
</picture>

しかし、レガシーのモバイルユーザーエージェントがより重要な場合は、すべての画像をsource要素にリストし、src属性を完全に無効にすることができます。

<picture>
  <source srcset="pear-mobile.jpeg" media="(max-width: 720px)">
  <source srcset="pear-tablet.jpeg" media="(max-width: 1280px)">
  <source srcset="pear-desktop.jpeg">
  <img src="pear-mobile.jpeg" alt="梨はジューシーです。">
</picture>

この時点では、src属性はpictureをサポートするユーザーエージェントによって完全に無視されているため、src属性は、最大でも最小でもない画像にデフォルト設定できます：

<picture>
  <source srcset="pear-mobile.jpeg" media="(max-width: 720px)">
  <source srcset="pear-tablet.jpeg" media="(max-width: 1280px)">
  <source srcset="pear-desktop.jpeg">
  <img src="pear-tablet.jpeg" alt="梨はジューシーです。">
</picture>

上記では、max-widthメディア機能を使用して、画像が対象とする最大の(ビューポート)寸法を指定していますが、代わりにmin-widthを使用することも可能です。

<picture>
  <source srcset="pear-desktop.jpeg" media="(min-width: 1281px)">
  <source srcset="pear-tablet.jpeg" media="(min-width: 721px)">
  <img src="pear-mobile.jpeg" alt="梨はジューシーです。">
</picture>
4.8.4.2 source、 img、 link 要素に共通の属性
4.8.4.2.1 Srcset 属性

srcset 属性とは、このセクションで定義されている要件を持つ属性のことです。

存在する場合、その値は1つ以上の 画像候補文字列で構成され、 それぞれはU+002Cコンマ文字(,)で次のものと区切られていなければなりません。 画像候補文字列に記述子がなく、URLの後に ASCII空白文字がない場合、 次の 画像候補文字列は 1つ以上の ASCII空白文字で始まらなければなりません。

画像候補文字列は、以下のコンポーネントで構成され、リストの下に説明されている追加の制限があります。

  1. 0個以上の ASCII空白文字。

  2. 有効な非空URLで、U+002Cコンマ文字(,)で始まらず、終わらないもので、非対話型でオプションでアニメーション可能な、ページングもスクリプトもされていない画像リソースを参照します。

  3. 0個以上の ASCII空白文字。

  4. 以下のいずれかを0個または1個含みます：

  5. 0個以上の ASCII空白文字。

同じ要素に対して、別の画像候補文字列の幅の記述子の値と同じ幅の記述子の値を持つ画像候補文字列が存在してはなりません。

同じ要素に対して、別の画像候補文字列のピクセル密度記述子の値と同じピクセル密度記述子の値を持つ画像候補文字列が存在してはなりません。この要件の目的では、記述子を持たない画像候補文字列は、1xの記述子を持つ画像候補文字列と同等と見なされます。

要素に対して、幅の記述子が指定されている場合、その要素の他のすべての画像候補文字列も幅の記述子を指定していなければなりません。

画像候補文字列の幅の記述子に指定された幅は、その画像候補文字列のURLによって提供されるリソースの自然な幅と一致していなければなりません（自然な幅が存在する場合）。

要素にsizes属性が存在する場合、その要素のすべての画像候補文字列は幅の記述子を指定していなければなりません。

4.8.4.2.2 サイズ属性

サイズ属性とは、このセクションで定義されている要件を持つ属性のことです。

存在する場合、その値は 有効なソースサイズリストでなければなりません。

有効なソースサイズリストとは、次の文法に一致する文字列のことです： [CSSVALUES] [MQ] 

<source-size-list> = <source-size>#? , <source-size-value>
<source-size> = <media-condition> <source-size-value> | auto
<source-size-value> = <length> | auto

<source-size-value>が<長さ>の場合、その値は負であってはならず、数学関数以外のCSS関数を使用してはなりません。

キーワードautoは、サイズ属性を解析で計算された幅を示します。存在する場合、それは最初のエントリでなければならず、<source-size-list>全体の値が"auto"(ASCII大文字小文字を区別しない)であるか、"auto,"(ASCII大文字小文字を区別しない)で始まらなければなりません。

もし、img要素が画像のロードを開始し、画像データを更新または環境の変化に対応アルゴリズムによってロードが開始されている場合は、自動サイズを許可し、レンダリングされている場合、autoが具体的なオブジェクトサイズの幅となります。そうでない場合、autoの値は無視され、代わりに次のソースサイズが使用されます。

autoキーワードは、次の条件が満たされている場合、サイズ属性のソース要素およびサイズ属性のimg要素で指定することができます。そうでない場合、autoを指定してはなりません。

さらに、幅および高さ属性やCSSを使用して寸法を指定することが強く推奨されます。寸法が指定されていない場合、sizes="auto"はレンダリングセクションでcontain-intrinsic-size: 300px 150pxを意味するため、画像はおそらく300x150の寸法でレンダリングされることになります。

<source-size-value>は画像の意図したレイアウト幅を示します。著者は、<メディア条件>を使用して、異なる環境に対して異なる幅を指定できます。

パーセンテージは<source-size-value>では許可されていません。これは、それが何に対して相対的であるかについての混乱を避けるためです。'vw'ユニットは、ビューポート幅に対して相対的なサイズに使用できます。

4.8.4.3 処理モデル

img要素には、現在のリクエストと保留中のリクエストがあります。現在のリクエストは最初、新しい画像リクエストに設定されます。保留中のリクエストは最初、nullに設定されます。

画像リクエストには、状態、現在のURL、および画像データがあります。

画像リクエストの状態は、次のいずれかです:

利用不可
ユーザーエージェントが画像データを取得していない、または画像データの一部またはすべてを取得しているが、画像の寸法を得るのに十分なデコードがまだ行われていない。
部分的に利用可能
ユーザーエージェントが画像データの一部を取得し、少なくとも画像の寸法が利用可能である。
完全に利用可能
ユーザーエージェントが画像データのすべてを取得し、少なくとも画像の寸法が利用可能である。
破損
ユーザーエージェントが取得可能なすべての画像データを取得したが、画像をデコードして寸法を得ることができない（例：画像が破損している、形式がサポートされていない、またはデータが取得できなかったなど）。

画像リクエストの現在のURLは、最初は空の文字列です。

画像リクエストの画像データは、デコードされた画像データです。

画像リクエストの状態が部分的に利用可能または完全に利用可能である場合、画像リクエストは利用可能とされます。

img要素の現在のリクエストの状態が完全に利用可能であり、ユーザーエージェントがメディアデータをエラーなくデコードできる場合、img要素は完全にデコード可能とされます。

画像リクエストの状態は最初、利用不可に設定されています。

img要素の現在のリクエストが利用可能である場合、img要素は、画像の密度補正済み自然幅（あれば）を持つ描画ソースを提供し、高さは画像の密度補正済み自然高さ（あれば）となり、外観は画像の自然な外観となります。

img要素は、srcset属性が指定されているか、親要素がpicture要素である場合に、srcsetまたはpictureを使用するとされています。

すべてのimg要素には、最後に選択されたソースがあり、最初はnullに設定されている必要があります。

すべての画像リクエストには、現在のピクセル密度があり、最初は1に設定されている必要があります。

すべての画像リクエストには、優先される密度補正済み寸法があり、それは幅と高さを含む構造体かnullである必要があります。最初はnullに設定されている必要があります。

img要素imgの密度補正済み自然幅と高さを決定するために:

  1. dimをimgの現在のリクエストの優先される密度補正済み寸法に設定します。

    優先される密度補正済み寸法は、画像内のメタ情報に基づいて画像をプレゼンテーションに準備するアルゴリズムで設定されます。

  2. dimがnullの場合、dimをimgの自然な寸法に設定します。

  3. dimの幅をimgの現在のリクエストの現在のピクセル密度で割った値に設定します。

  4. dimの高さをimgの現在のリクエストの現在のピクセル密度で割った値に設定します。

  5. dimを返します。

例えば、現在のピクセル密度が3.125の場合、それは1インチあたり300デバイスピクセルがあることを意味し、画像データが300x600の場合、密度補正済み自然幅と高さは96 CSSピクセル x 192 CSSピクセルとなります。

すべてのimgおよびlink要素は、ソースセットと関連付けられています。

ソースセットは、0個以上の画像ソースとソースサイズからなる順序付けられたセットです。

画像ソースは、URLであり、オプションでピクセル密度記述子または幅記述子を持ちます。

ソースサイズは、<source-size-value>です。ソースサイズがビューポートに対して相対的な単位を持つ場合、それはimg要素のノードドキュメントのビューポートに対して解釈されなければなりません。他の単位はメディアクエリでの解釈と同じでなければなりません。[MQ]

構文解析エラーは、このセクションのアルゴリズムにおける入力と要件の非致命的な不一致を示します。ユーザーエージェントは、構文解析エラーを何らかの形で公開することが推奨されます。

画像が正常にフェッチされたかどうか（例: レスポンスステータスがOKステータスであったかどうか）は、画像のタイプやそれが有効な画像であるかどうかを判断する際には無視されなければなりません。

これにより、サーバーがエラー応答を返した画像でも、それが表示されることが可能になります。

ユーザーエージェントは、画像のタイプを判断するために、画像の関連するコンテンツタイプヘッダーがofficial typeを示すように、画像のスニッフィングルールを適用する必要があります。これらのルールが適用されない場合は、画像のタイプは画像の関連するコンテンツタイプヘッダーで示されるタイプでなければなりません。

ユーザーエージェントは、img要素で非画像リソース（例: ドキュメント要素がHTML要素であるXMLファイル）をサポートしてはなりません。ユーザーエージェントは、画像リソースに埋め込まれた実行可能コード（例: スクリプト）を実行してはなりません。ユーザーエージェントは、マルチページリソース（例: PDFファイル）の最初のページのみを表示しなければなりません。ユーザーエージェントは、リソースがインタラクティブに動作することを許可してはなりませんが、リソース内のアニメーションは尊重する必要があります。

この仕様は、どの画像タイプがサポートされるべきかを規定していません。

4.8.4.3.1 画像を取得するタイミング

デフォルトでは、画像はすぐに取得されます。ユーザーエージェントは、代わりにオンデマンドで取得するオプションをユーザーに提供することができます。（たとえば、帯域幅が制限されているユーザーがオンデマンドオプションを使用することがあります。）

画像をすぐに取得する場合、ユーザーエージェントは、img要素が作成されたとき、または関連する変更が発生したときに、必要に応じてアニメーションを再起動するフラグを設定し、その要素の画像データを同期的に更新しなければなりません。

オンデマンドで画像を取得する場合、ユーザーエージェントは、img要素の画像データが必要なときに（つまり、オンデマンドで）画像データを更新しなければなりませんが、img要素の現在のリクエストの状態が利用不可の場合に限ります。img要素が関連する変更を受けた場合、ユーザーエージェントが画像をオンデマンドでのみ取得する場合、img要素の現在のリクエストの状態は利用不可に戻る必要があります。

4.8.4.3.2 DOM変異への反応

img要素に対する関連する変異は以下の通りです。

4.8.4.3.3利用可能な画像のリスト

各Documentオブジェクトには、利用可能な画像のリストが必要です。このリスト内の各画像は、絶対URL、CORS設定属性モード、およびモードがNo CORSでない場合はオリジンを含むタプルで識別されます。また、各画像には上位レイヤーキャッシュを無視するフラグが付いています。ユーザーエージェントは、いつでも1つのDocumentオブジェクトの利用可能な画像のリストのエントリを別のオブジェクトにコピーできます（例: Documentが作成されたときに、他のDocument内で読み込まれたすべての画像を追加できます）。ただし、この方法でコピーされたエントリのキーを変更してはならず、コピーされたエントリの上位レイヤーキャッシュを無視フラグは解除される必要があります。ユーザーエージェントは、メモリを節約するためなどに、これらのリストから画像をいつでも削除できます。ユーザーエージェントは、リソースの上位レイヤーキャッシュのセマンティクスに応じて、利用可能な画像のリストのエントリを適切に削除する必要があります（例: HTTP `Cache-Control`レスポンスヘッダー）。上位レイヤーキャッシュを無視フラグが解除された場合に限ります。

利用可能な画像のリストは、src属性を以前にロードされたURLに変更する際に同期的な切り替えを可能にし、同じドキュメント内でキャッシュを許可しない場合でも画像の再ダウンロードを避けるために意図されています。これは、前の画像がまだロード中である間に同じ画像を再ダウンロードすることを避けるためには使用されません。

ユーザーエージェントは、利用可能な画像のリストとは別に画像データを保存することもできます。

例えば、リソースがHTTPレスポンスヘッダー`Cache-Control: must-revalidate`を持ち、その上位レイヤーキャッシュを無視するフラグが解除されている場合、ユーザーエージェントはそれを利用可能な画像のリストから削除しますが、画像データを別途保存し、サーバーが`304 Not Modified`ステータスで応答した場合にそれを使用することができます。

4.8.4.3.4 画像のデコード

画像データは通常、ファイルサイズを削減するためにエンコードされています。そのため、ユーザーエージェントが画像を画面に表示するためには、そのデータをデコードする必要があります。デコードとは、画像のメディアデータをビットマップ形式に変換し、画面に表示できるようにするプロセスです。このプロセスは、コンテンツの表示に関わる他のプロセスに比べて遅いことがあります。そのため、ユーザーエージェントは最適なユーザーエクスペリエンスを提供するために、デコードを実行するタイミングを選択できます。

画像のデコードは、それが完了するまで他のコンテンツの表示を妨げる場合、同期的であると言われます。通常、これにより、画像と他のコンテンツが同時に原子的に表示される効果があります。ただし、この表示は、デコードにかかる時間の分だけ遅れます。

画像のデコードが他のコンテンツの表示を妨げない場合、それは非同期的であると言われます。これにより、非画像コンテンツがより早く表示される効果があります。ただし、デコードが完了するまで画像コンテンツは画面に表示されません。デコードが完了すると、画面は画像で更新されます。

同期モードと非同期モードのどちらでも、最終的なコンテンツは同じ時間が経過した後に画面に表示されます。主な違いは、ユーザーエージェントが最終的なコンテンツを表示する前に非画像コンテンツを先行して表示するかどうかです。

ユーザーエージェントが同期デコードを行うか非同期デコードを行うかを決定する際の補助として、decoding属性をimg要素に設定することができます。decoding属性の可能な値は、以下の画像デコードのヒントキーワードです。

キーワード 状態 説明
sync 同期 この画像を他のコンテンツと原子的に表示するために、同期的にデコードすることを示します。
async 非同期 他のコンテンツの表示を遅らせないために、この画像を非同期的にデコードすることを示します。
auto 自動 デコードモードに関する特別な指定がないことを示します（デフォルト）。

画像をデコードする際、ユーザーエージェントはdecoding属性の状態で示された優先度を尊重するべきです。状態がAutoの場合、ユーザーエージェントは任意のデコード動作を選択できます。

decode()メソッドを使用して、デコード動作を制御することも可能です。decode()メソッドは、コンテンツを画面に表示するプロセスとは独立してデコードを実行するため、decoding属性の影響を受けません。

4.8.4.3.5 画像データの更新

このアルゴリズムは並行して実行されているステップからは呼び出せません。ユーザーエージェントが並行して実行されているステップからこのアルゴリズムを呼び出す必要がある場合、タスクをキューに入れる必要があります。

ユーザーエージェントがimg要素の画像データを更新する場合、オプションでアニメーションの再起動フラグが設定されている場合や、オプションでイベントの省略フラグが設定されている場合は、以下のステップを実行する必要があります。

  1. 要素のノードドキュメントが完全にアクティブでない場合、次のようにします：

    1. このアルゴリズムを並行して実行し続けます。

    2. 要素のノードドキュメントが完全にアクティブになるまで待ちます。

    3. このインスタンスの後にこのimg要素に対するこのアルゴリズムの別のインスタンスが開始された場合（たとえそれが中止され、もはや実行されていなくても）、戻ります。

    4. このアルゴリズムを続行するためにマイクロタスクをキューに入れます。

  2. ユーザーエージェントが画像をサポートできない場合、または画像のサポートが無効になっている場合は、現在のリクエストと保留中のリクエストの画像リクエストを中止し、現在のリクエストの状態を利用不可に設定し、保留中のリクエストをnullに設定して、戻ります。

  3. previousURL を現在のリクエストの現在のURLとします。

  4. selected sourceをnullに、selected pixel densityを未定義に設定します。

  5. 要素がsrcsetまたはpictureを使用しておらず、src属性が指定されていて、その値が空文字列でない場合、selected sourceを要素のsrc属性の値に設定し、selected pixel densityを1.0に設定します。

  6. 要素の最後に選択されたソースをselected sourceに設定します。

  7. selected sourceがnullでない場合、次のステップを実行します：

    1. urlStringを、要素のノードドキュメントに相対的にselected sourceをURLのエンコーディング、パース、およびシリアライズした結果として設定します。

    2. urlStringが失敗した場合、この内側のステップセットを中止します。

    3. keyを、urlString、要素のimg要素のcrossorigin属性のモード、およびそのモードがNo CORSでない場合、要素のノードドキュメントのオリジンからなるタプルに設定します。

    4. 利用可能な画像のリストにkeyのエントリが含まれている場合、次のようにします：

      1. そのエントリの上位レイヤーキャッシュを無視するフラグを設定します。

      2. 現在のリクエストと保留中のリクエストの画像リクエストを中止します。

      3. 保留中のリクエストをnullに設定します。

      4. 現在のリクエストを、新しい画像リクエストに設定し、その画像データをエントリのデータにし、その状態を完全に利用可能に設定します。

      5. img要素を指定して、現在のリクエストをプレゼンテーション用に準備します。

      6. 現在のリクエストの現在のピクセル密度をselected pixel densityに設定します。

      7. DOM操作タスクソースでimg要素に対して以下のステップを実行するタスクをキューに入れます：

        1. アニメーションの再起動が設定されている場合、アニメーションを再起動します。

        2. 現在のリクエストの現在のURLをurlStringに設定します。

        3. イベントを省略が設定されていない場合、またはpreviousURLがurlStringと等しくない場合、loadイベントをimg要素に発火します。

      8. 画像データの更新アルゴリズムを中止します。

  8. マイクロタスクをキューに入れます、このアルゴリズムの残りの部分を実行し、アルゴリズムを呼び出したタスクを続行できるようにします。

  9. このimg要素に対するこのアルゴリズムの別のインスタンスが、このインスタンスの後に開始された場合（たとえそれが中止され、もはや実行されていなくても）、戻ります。

    例えば、src、srcset、crossorigin属性が連続して設定される場合などに、複数のリクエストを回避するために、最後のインスタンスのみが効果を持ちます。

  10. selected sourceとselected pixel densityを、それぞれ画像ソースを選択する結果のURLとピクセル密度に設定します。

  11. selected sourceがnullである場合、次のようにします：

    1. 現在のリクエストの状態を壊れたに設定し、画像リクエストを中止し、保留中のリクエストをnullに設定します。

    2. DOM操作タスクソースでimg要素に対して以下のステップを実行するタスクをキューに入れます：

      1. 現在のリクエストの現在のURLを空文字列に変更します。

      2. 次のすべてが真である場合：

        • 要素にsrc属性があるか、またはsrcsetまたはpictureを使用している場合。

        • イベントの省略が設定されていない場合、またはpreviousURLが空文字列でない場合。

        次に、errorイベントをimg要素に発火します。

    3. 戻ります。

  12. urlStringを、要素のノードドキュメントに相対的にselected sourceをURLのエンコーディング、パース、およびシリアライズした結果として設定します。

  13. urlStringが失敗した場合、次のようにします：

    1. 現在のリクエストと保留中のリクエストの画像リクエストを中止します。

    2. 現在のリクエストの状態を壊れたに設定します。

    3. 保留中のリクエストをnullに設定します。

    4. DOM操作タスクソースでimg要素に対して以下のステップを実行するタスクをキューに入れます：

      1. 現在のリクエストの現在のURLをselected sourceに変更します。

      2. イベントを省略が設定されていない場合、またはpreviousURLがselected sourceと等しくない場合、errorイベントをimg要素に発火します。

    5. 戻ります。

  14. 保留中のリクエストがnullでなく、urlStringがpending requestの現在のURLと同じ場合、戻ります。

  15. urlStringがcurrent requestの現在のURLと同じであり、current requestの状態が部分的に利用可能である場合、pending requestの画像リクエストを中止し、DOM操作タスクソースでimg要素に対して以下のステップを実行するタスクをキューに入れ、アニメーションの再起動が設定されている場合は、アニメーションを再起動します。

  16. 保留中のリクエストの画像リクエストを中止します。

  17. image requestを、新しい画像リクエストに設定し、その現在のURLをurlStringに設定します。

  18. current requestの状態が利用不可または壊れたである場合、current requestをimage requestに設定します。それ以外の場合は、pending requestをimage requestに設定します。

  19. requestを、urlString、"image"、および要素のcrossoriginコンテンツ属性の現在の状態を与えて潜在的なCORSリクエストを作成した結果に設定します。

  20. requestのクライアントを、要素のノードドキュメントの関連設定オブジェクトに設定します。

  21. 要素がsrcsetまたはpictureを使用している場合、requestのイニシエータを"imageset"に設定します。

  22. requestのリファラーポリシーを、要素のreferrerpolicy属性の現在の状態に設定します。

  23. requestの優先度を、要素のfetchpriority属性の現在の状態に設定します。

  24. delay load eventを、imgの遅延ロード属性がEager状態にある場合、またはimgのためにスクリプトが無効化されている場合はtrueに設定し、それ以外の場合はfalseに設定します。

  25. imgに対して遅延ロード要素ステップを実行するがtrueを返す場合、次のようにします：

    1. imgの遅延ロード再開ステップを、このアルゴリズムの残り部分に設定し、画像を取得ステップから始めます。

    2. img要素に対して遅延ロード要素のインターセクション監視を開始します。

    3. 戻ります。

  26. 画像を取得: フェッチ requestを行います。このアルゴリズムから戻り、フェッチのプロセス応答の一部として残りのステップを実行します。

    この方法で取得されたリソースは、image requestの画像データです。それはCORS-同一オリジンまたはCORS-クロスオリジンのいずれかであり、これは画像が他のAPIとどのように相互作用するか（例: canvasに使用された場合）に影響します。

    delay load eventがtrueの場合、画像のフェッチは、リソースがフェッチされた後にネットワーキングタスクソースによってキューに入れられたタスクが実行されるまで、その要素のノードドキュメントのロードイベントを遅延させなければなりません。

    これにより、ユーザーのローカルネットワークの簡単なポートスキャンを実行することが可能になります（特にスクリプティングと組み合わせた場合、ただしスクリプティングは実際にはそのような攻撃を実行するために必要ではありません）。ユーザーエージェントは、この攻撃を緩和するために、上記で説明されているものより厳格なクロスオリジンアクセス制御ポリシーを実装することができますが、残念ながらそのようなポリシーは通常、既存のウェブコンテンツとの互換性がありません。

  27. できるだけ早く、次のリストから適用可能な最初のエントリにジャンプします：

    リソースタイプがmultipart/x-mixed-replaceである場合

    画像がフェッチされている間に、ネットワーキングタスクソースによってキューに入れられた次のタスクは、次のステップを実行する必要があります：

    1. image requestが保留中のリクエストであり、少なくとも1つのボディパートが完全にデコードされている場合、現在のリクエストを中止し、保留中のリクエストを現在のリクエストにアップグレードします。

    2. それ以外の場合、image requestが保留中のリクエストであり、ユーザーエージェントがimage requestの画像が致命的に破損していて、画像の寸法を取得できないことを確認できる場合、現在のリクエストを中止し、保留中のリクエストを現在のリクエストにアップグレードし、image requestの状態を壊れたに設定します。

    3. それ以外の場合、image requestが現在のリクエストであり、その状態が利用不可であり、ユーザーエージェントがimage requestの画像の幅と高さを確認できる場合、current requestの状態を部分的に利用可能に設定します。

    4. それ以外の場合、image requestが現在のリクエストであり、その状態が利用不可であり、ユーザーエージェントがimage requestの画像が致命的に破損していて、画像の寸法を取得できないことを確認できる場合、current requestの状態を壊れたに設定します。

    画像のフェッチ中にネットワークタスクソースによってキューに入れられた各タスクは、画像のプレゼンテーションを更新する必要がありますが、新しいボディパーツが到着するたびに、ユーザーエージェントが画像の幅と高さを決定できる場合は、img要素を指定してimg要素の現在のリクエストをプレゼンテーション用に準備し、前の画像を置き換える必要があります。 1つのボディパーツが完全にデコードされたら、次の手順を実行します：

    1. img要素の現在のリクエストの状態を完全に利用可能に設定します。

    2. maybe omit events が設定されていないか、previousURL が urlString と等しくない場合、img要素を指定してDOM操作タスクソースで要素タスクをキューに入れ、img要素でloadという名前のイベントを発火させます。

    リソースタイプおよびデータがサポートされている画像形式に対応している場合

    画像がフェッチされている間に、ネットワーキングタスクソースによってキューに入れられた次のタスクは、次のステップを実行する必要があります：

    1. ユーザーエージェントがimage requestの画像の幅と高さを確認でき、image requestが保留中のリクエストである場合、image requestの状態を部分的に利用可能に設定します。

    2. それ以外の場合、ユーザーエージェントがimage requestの画像の幅と高さを特定でき、かつimage requestが現在のリクエストである場合、img要素を指定してimage requestをプレゼンテーション用に準備し、image requestの 状態を部分的に利用可能に設定します。

    3. それ以外の場合、ユーザーエージェントがimage requestの画像が致命的に破損していて、画像の寸法を取得できないことを確認でき、image requestが保留中のリクエストである場合、次のようにします：

      1. 現在のリクエストと保留中のリクエストの画像リクエストを中止します。

      2. 保留中のリクエストを現在のリクエストにアップグレードします。

      3. current requestの状態を壊れたに設定します。

      4. errorイベントをimg要素に発火します。

    4. それ以外の場合、ユーザーエージェントがimage requestの画像が致命的に破損していて、画像の寸法を取得できないことを確認でき、image requestが現在のリクエストである場合、次のようにします：

      1. 画像リクエストを中止します。

      2. イベントを省略が設定されていない場合、またはpreviousURLがurlStringと等しくない場合、errorイベントをimg要素に発火します。

    そのタスクと、それに続く各タスク（画像がフェッチされている間にimage requestが現在のリクエストである場合）、および各タスクがネットワーキングタスクソースによってキューに入れられるキューされる場合、適切に画像のプレゼンテーションを更新する必要があります（例: 画像がプログレッシブJPEGである場合、各パケットが画像の解像度を改善できます）。

    さらに、リソースがフェッチされた後にネットワーキングタスクソースによってキューに入れられた最後のタスクは、追加で以下のステップを実行する必要があります：

    1. image requestが保留中のリクエストである場合、画像リクエストを中止し、現在のリクエストに対して、保留中のリクエストを現在のリクエストにアップグレードし、プレゼンテーションのためにimage requestを準備します。img要素に基づいて行います。

    2. image requestを完全に利用可能な状態に設定します。

    3. keyを使用して、利用可能な画像のリストに画像を追加し、上位レイヤーのキャッシングを無視するフラグを設定します。

    4. maybe omit eventsが設定されていない、またはpreviousURLがurlStringと等しくない場合、イベントを発火します。このイベントはloadという名前で、img要素で発生します。

    それ以外の場合

    画像データがサポートされているファイル形式ではない場合、ユーザーエージェントはimage requestの状態を破損に設定し、現在のリクエストと保留中のリクエストの画像リクエストを中止し、image requestが保留中のリクエストである場合は保留中のリクエストを現在のリクエストにアップグレードし、 そして、maybe omit eventsが設定されていないか、previousURLがurlStringと等しくない場合は、img要素を指定してDOM操作タスクソースで要素タスクをキューに入れ、img要素でerrorという名前のイベントを発火させます。

ユーザーエージェントが上記のアルゴリズムを要素xに対して実行している間、その要素が接続されているかどうかに関係なく、要素のノードドキュメントから要素xへの強い参照が存在しなければなりません。

画像リクエストを中止するとは、画像リクエストまたはnullのimage requestに対して、以下の手順を実行することを意味します:

  1. image requestがnullの場合、終了します。

  2. 存在する場合は、image requestの画像データを忘れます。

  3. image requestに対するフェッチアルゴリズムの実行を中止し、そのアルゴリズムによって生成された保留中のタスクを破棄します。

保留中のリクエストを現在のリクエストにアップグレードするとは、img要素に対して、以下の手順を実行することを意味します:

  1. img要素の現在のリクエストを保留中のリクエストに設定します。

  2. img要素の保留中のリクエストをnullに設定します。

4.8.4.3.6 プレゼンテーションのための画像の準備

画像要素imgに対して画像リクエストreqを準備するには、以下の手順を実行します:

  1. exifTagMapを、関連するコーデックで定義されている通りに、reqの画像データから取得したEXIFタグとします。

  2. physicalWidthとphysicalHeightを、関連するコーデックで定義されている通りに、reqの画像データから取得した幅と高さとします。

  3. dimXをexifTagMapのタグ0xA002 (PixelXDimension)の値とします。

  4. dimYをexifTagMapのタグ0xA003 (PixelYDimension)の値とします。

  5. resXをexifTagMapのタグ0x011A (XResolution)の値とします。

  6. resYをexifTagMapのタグ0x011B (YResolution)の値とします。

  7. resUnitをexifTagMapのタグ0x0128 (ResolutionUnit)の値とします。

  8. dimXまたはdimYのいずれかが正の整数でない場合、終了します。

  9. resXまたはresYのいずれかが正の浮動小数点数でない場合、終了します。

  10. resUnitが2 (インチ)に等しくない場合、終了します。

  11. widthFromDensityをphysicalWidthの値に72を掛けたものをresXで割ったものとします。

  12. heightFromDensityをphysicalHeightの値に72を掛けたものをresYで割ったものとします。

  13. widthFromDensityがdimXと等しくない場合、またはheightFromDensityがdimYと等しくない場合、終了します。

  14. reqの画像データがCORSクロスオリジンの場合、imgの自然な寸法をdimXとdimYに設定し、imgのピクセルデータをそれに応じてスケールし、終了します。

  15. reqの優先される密度補正寸法を、幅をdimXに、高さをdimYに設定した構造体に設定します。

  16. reqのimg要素のプレゼンテーションを適切に更新します。

EXIFの解像度はCSSポイント/インチに相当するため、解像度からサイズを計算するための基準は72です。

画像がすでに表示された後にEXIFが到着した場合の扱いはまだ規定されていません。詳細はissue #4929を参照してください。

4.8.4.3.7 画像ソースの選択

画像要素elに対してimgを指定して画像ソースを選択するには、以下の手順を実行します:

  1. elのソースセットを更新します。

  2. もしelのソースセットが空であれば、URLとしてnull、ピクセル密度として未定義を返します。

  3. elのソースセットから画像を選択した結果を返します。

ソースセットsourceSetに対して画像ソースを選択するには、以下の手順を実行します:

  1. もしsourceSetのエントリーbが、以前のエントリーaと同じピクセル密度記述子を持つ場合、そのエントリーbを削除します。このステップを、sourceSet内のエントリーが以前のエントリーと同じピクセル密度記述子を持たなくなるまで繰り返します。

  2. 実装依存の方法で、sourceSetから1つの画像ソースを選択し、これをselectedSourceとします。

  3. selectedSourceとその関連するピクセル密度を返します。

4.8.4.3.8 属性からソースセットの作成

文字列default source、文字列srcset、文字列sizes、および要素またはnullimgを指定してソースセットを作成するには、以下の手順を実行します:

  1. source setを空のソースセットとします。

  2. もしsrcsetが空でない文字列であれば、source setを解析した結果に設定します。

  3. ソースサイズを、imgを用いてsizesを解析した結果とします。

  4. もしdefault sourceが空でなく、source setにピクセル密度記述子の値が1である画像ソースや、幅記述子を持つ画像ソースが含まれていない場合、default sourceをsource setに追加します。

  5. source setのソース密度を正規化します。

  6. source setを返します。

4.8.4.3.9 ソースセットの更新

特定のimgまたはlink要素elのソースセットを更新するよう求められた場合、ユーザーエージェントは以下の処理を行わなければなりません:

  1. elのソースセットを空のソースセットに設定します。

  2. elementsを「el」に設定します。

  3. elが親ノードがpicture要素であるimg要素の場合、elementsの内容をelの親ノードの子要素に置き換え、相対順序を保持します。

  4. imgをelがimg要素である場合はelに、それ以外の場合はnullに設定します。

  5. 各childをelements内で次のように処理します:

    1. childがelである場合:

      1. default sourceを空文字列に設定します。

      2. srcsetを空文字列に設定します。

      3. sizesを空文字列に設定します。

      4. elがimg要素であり、srcset属性を持っている場合、その属性の値をsrcsetに設定します。

      5. それ以外の場合、elがlink要素であり、imagesrcset属性を持っている場合、その属性の値をsrcsetに設定します。

      6. elがimg要素であり、sizes属性を持っている場合、その属性の値をsizesに設定します。

      7. それ以外の場合、elがlink要素であり、imagesizes属性を持っている場合、その属性の値をsizesに設定します。

      8. elがimg要素であり、src属性を持っている場合、その属性の値をdefault sourceに設定します。

      9. それ以外の場合、elがlink要素であり、href属性を持っている場合、その属性の値をdefault sourceに設定します。

      10. elのソースセットを、default source、srcset、sizes、およびimgを与えてソースセットを作成する結果に設定します。

      11. 終了します。

        elがlink要素である場合、elementsにはelのみが含まれているため、このステップはすぐに実行され、アルゴリズムの残りの部分は実行されません。

    2. childがsource要素でない場合、次の子要素に進む。

    3. childがsrcset属性を持っていない場合、次の子要素に進む。

    4. childのsrcset属性を解析するを実行し、返されたソースセットをsource setに設定します。

    5. source setに画像ソースが一つもない場合、次の子要素に進む。

    6. childがmedia属性を持ち、その値が環境に一致しない場合、次の子要素に進む。

    7. childのsizes属性を解析するをimgに対して実行し、source setのソースサイズを返された値に設定します。

    8. childがtype属性を持ち、その値が未知またはサポートされていないMIMEタイプである場合、次の子要素に進む。

    9. childがwidthまたはheight属性を持っている場合、elの寸法属性ソースをchildに設定します。それ以外の場合は、elの寸法属性ソースをelに設定します。

    10. source setのソース密度を正規化します。

    11. elのソースセットをsource setに設定します。

    12. 終了します。

各img要素は、直前の兄弟source要素およびimg要素自体を考慮し、画像ソースを選択します。他の（無効な）要素、同じpicture要素内の他のimg要素、または該当するimg要素の後続の兄弟source要素は無視されます。

4.8.4.3.10 srcset属性の解析

要素からsrcset属性を解析するように要求された場合、要素のsrcset属性の値を次のように解析します:

  1. inputをこのアルゴリズムに渡された値とします。

  2. positionをinput内のポインタとし、初期位置を文字列の先頭に設定します。

  3. candidatesを最初は空のソースセットとします。

  4. 分割ループ: コードポイントのシーケンスを収集し、positionを指定してinputからspace-charactersまたはU+002C COMMA文字を収集します。U+002C COMMA文字が収集された場合、それは解析エラーです。

  5. positionがinputの終わりを越えている場合、candidatesを返します。

  6. コードポイントのシーケンスを収集し、positionを指定してinputからspace-characters-2以外のものを収集し、それをurlとします。

  7. descriptorsを新しい空のリストとします。

  8. urlがU+002C (,)で終わる場合:

    1. urlからすべての末尾のU+002C COMMA文字を削除します。これで複数の文字が削除された場合、それは解析エラーです。

    それ以外の場合:

    1. ディスクリプタトークナイザ: ASCII空白文字をスキップし、inputとpositionを指定します。

    2. current descriptorを空の文字列とします。

    3. stateをin descriptorに設定します。

    4. cをpositionでの文字とします。このステップでは、"EOF"はinputの終わりを超えた位置を表す特別な文字です。

      In descriptor

      cの値に応じて次の処理を行います:

      ASCII空白文字

      current descriptorが空でない場合、それをdescriptorsに追加し、current descriptorを空の文字列に設定します。stateをafter descriptorに設定します。

      U+002C COMMA (,)

      positionをinput内の次の文字に進めます。current descriptorが空でない場合、それをdescriptorsに追加します。ディスクリプタパーサーのステップにジャンプします。

      U+0028 LEFT PARENTHESIS (()

      cをcurrent descriptorに追加します。stateをin parensに設定します。

      EOF

      current descriptorが空でない場合、それをdescriptorsに追加します。ディスクリプタパーサーのステップにジャンプします。

      その他

      cをcurrent descriptorに追加します。

      In parens

      cの値に応じて次の処理を行います:

      U+0029 RIGHT PARENTHESIS ())

      cをcurrent descriptorに追加します。stateをin descriptorに設定します。

      EOF

      current descriptorをdescriptorsに追加します。ディスクリプタパーサーのステップにジャンプします。

      その他

      cをcurrent descriptorに追加します。

      After descriptor

      cの値に応じて次の処理を行います:

      ASCII空白文字

      この状態のままにします。

      EOF

      ディスクリプタパーサーのステップにジャンプします。

      その他

      stateをin descriptorに設定し、positionをinput内の前の文字に戻します。

      positionをinput内の次の文字に進めます。このステップを繰り返します。

      将来の追加に互換性を持たせるため、このアルゴリズムは複数のディスクリプタや括弧付きのディスクリプタをサポートします。

  9. ディスクリプタパーサー: errorをnoとします。

  10. widthをabsentとします。

  11. densityをabsentとします。

  12. future-compat-hをabsentとします。

  13. descriptors内の各ディスクリプタについて、次のリストから適切なステップを実行します:

    ディスクリプタが有効な非負整数とU+0077 LATIN SMALL LETTER W文字から成る場合

    1. ユーザーエージェントがsizes属性をサポートしていない場合、errorをyesとします。

      準拠するユーザーエージェントはsizes属性をサポートします。ただし、ユーザーエージェントは通常、機能を段階的に実装して出荷します。

    2. widthとdensityの両方がabsentでない場合、errorをyesとします。

    3. 非負整数を解析するためのルールをディスクリプタに適用します。結果が0の場合、errorをyesとします。それ以外の場合、widthをその結果とします。

    ディスクリプタが有効な浮動小数点数とU+0078 LATIN SMALL LETTER X文字から成る場合

    1. width、density、future-compat-hのすべてがabsentでない場合、errorをyesとします。

    2. 浮動小数点数値を解析するためのルールをディスクリプタに適用します。結果が0未満の場合、errorをyesとします。それ以外の場合、densityをその結果とします。

      densityが0の場合、自然な寸法が無限大になります。ユーザーエージェントは、画像がどれだけ大きく表示されるかに制限があると予想されます。

    ディスクリプタが有効な非負整数とU+0068 LATIN SMALL LETTER H文字から成る場合

    これは解析エラーです。

    1. future-compat-hとdensityの両方がabsentでない場合、errorをyesとします。

    2. 非負整数を解析するためのルールをディスクリプタに適用します。結果が0の場合、errorをyesとします。それ以外の場合、future-compat-hをその結果とします。

    その他

    errorをyesとします。

  14. future-compat-hがabsentでなく、widthがabsentの場合、errorをyesとします。

  15. errorがnoのままであれば、新しい画像ソースをcandidatesに追加します。そのURLがurlであり、幅がabsentでない場合はwidth、ピクセル密度がabsentでない場合はdensityに関連付けられています。それ以外の場合、解析エラーが発生します。

  16. 分割ループのステップに戻ります。

4.8.4.3.11 sizes属性の解析

要素elementから、img要素またはnullimgを指定してsizes属性を解析するように要求された場合:

  1. unparsed sizes listを、elementのsizes属性の値からコンマ区切りのコンポーネント値リストを解析した結果とします（属性が存在しない場合は空の文字列）。[CSSSYNTAX]

  2. sizeをnullとします。

  3. unparsed sizes list内の各unparsed sizeについて:

    1. unparsed sizeの末尾からすべての連続する<whitespace-token>を削除します。unparsed sizeが空になった場合、それは解析エラーです。続行します。

    2. もしunparsed sizeの最後のコンポーネント値が有効な非負の<source-size-value>である場合、その値をsizeに設定し、unparsed sizeからコンポーネント値を削除します。数学関数以外のCSS関数は無効です。それ以外の場合は解析エラーが発生し、続行します。

    3. もしsizeがautoであり、imgがnullでなく、imgがレンダリングされている場合、そしてimgが自動サイズを許可する場合、sizeをimgの具体的なオブジェクトサイズの幅（CSSピクセル）に設定します。

      もしsizeがまだautoである場合、それは無視されます。

    4. unparsed sizeの末尾からすべての連続する<whitespace-token>を削除します。unparsed sizeが空になった場合:

      1. もしこれがunparsed sizes list内の最後の項目でなかった場合、それは解析エラーです。

      2. もしsizeがautoでない場合、そのsizeを返します。それ以外の場合は続行します。

    5. 残りのコンポーネント値をunparsed sizeで<メディア条件>として解析します。正しく解析されなかった場合、または正しく解析されたが<メディア条件>がfalseに評価された場合、続行します。[MQ]

    6. もしsizeがautoでない場合、そのsizeを返します。それ以外の場合は続行します。

  4. 100vwを返します。

裸の<source-size-value>（<長さ>）を（<メディア条件>を伴わずに）<source-size-list>のエントリとして使用することは無効ですが、解析アルゴリズムは、リストの任意の時点でそれを受け入れ、リストの先行するエントリが使用されていなかった場合に、すぐにそのサイズを受け入れます。これは将来の拡張を可能にし、単純な著者エラー（最後のコンマのようなもの）から保護するためです。裸のautoキーワードは、レガシーユーザーエージェントへのフォールバックを提供するために、他のエントリを後に続けることが許可されています。

4.8.4.3.12 ソース密度の正規化

画像ソースには、ピクセル密度記述子、幅記述子、またはURLに付随する記述子がない場合があります。ソースセットを正規化すると、すべての画像ソースにピクセル密度記述子が与えられます。

あるソースセットの密度を正規化するように要求された場合、ユーザーエージェントは次の操作を行う必要があります:

  1. source setのソースサイズをsource sizeとします。

  2. source set内の各画像ソースについて:

    1. もし画像ソースにピクセル密度記述子がある場合、次の画像ソースへ進みます。

    2. それ以外の場合、画像ソースが幅記述子を持つ場合、幅記述子を、幅記述子の値をsource sizeで除算した値とxの単位を持つピクセル密度記述子に置き換えます。

      ソースサイズが0の場合、密度は無限大になり、その結果、自然な寸法は0x0になります。

    3. それ以外の場合、画像ソースに1xのピクセル密度記述子を与えます。

4.8.4.3.13 環境の変化に反応する

ユーザーエージェントは、環境の変化に反応するために、img要素の画像を更新するための以下のアルゴリズムをいつでも実行できます。（ユーザーエージェントは、このアルゴリズムを実行することを義務付けられているわけではありません。たとえば、ユーザーがページを見ていない場合、環境が再び変化する可能性があるため、どの画像を使用するかを判断する前に、ユーザーがページに戻るまで待つかもしれません。）

ユーザーがビューポートのサイズを変更したとき（例：ウィンドウのサイズ変更やページのズーム変更）、およびimg要素がドキュメントに挿入されたときに、このアルゴリズムを実行することが推奨されます。これにより、新しいビューポートに一致するように、密度補正された自然な幅と高さが一致し、アートディレクションが関係する場合に適切な画像が選択されます。

  1. 安定状態を待つ。同期セクションは、このアルゴリズムの残りのステップ全体で構成されます。このアルゴリズムが同期セクションが終了したと指示するまでです。（同期セクションのステップは、⌛でマークされています。）

  2. ⌛ img要素がsrcsetまたはpictureを使用していない場合、そのノードドキュメントが完全にアクティブでなく、画像データのリソースタイプがmultipart/x-mixed-replaceである場合、または保留中のリクエストがnullでない場合は、終了します。

  3. ⌛ 画像ソースを選択することにより、結果として得られるURLとピクセル密度をそれぞれselected sourceおよびselected pixel densityとします。

  4. ⌛ selected sourceがnullの場合は終了します。

  5. ⌛ selected sourceとselected pixel densityが要素の最後に選択されたソースおよび現在のピクセル密度と同じ場合は、終了します。

  6. ⌛ selected sourceを、要素のノードドキュメントに対してURLのエンコード、パース、およびシリアライズを行う結果として得られるurlStringとします。

  7. ⌛ urlStringが失敗した場合、終了します。

  8. ⌛ corsAttributeStateを要素のcrossoriginコンテンツ属性の状態とします。

  9. ⌛ originをimg要素のノードドキュメントのオリジンとします。

  10. ⌛ clientをimg要素のノードドキュメントの関連設定オブジェクトとします。

  11. ⌛ keyをurlString、corsAttributeState、およびcorsAttributeStateがNo CORSでない場合のoriginからなるタプルとします。

  12. ⌛ image requestを、新しい画像リクエストとし、その現在のURLをurlStringとします。

  13. ⌛ 要素の保留中のリクエストをimage requestとします。

  14. 残りのステップを並行して続けながら、同期セクションを終了します。

  15. もし利用可能な画像のリストにkeyのエントリが含まれている場合、image requestの画像データをそのエントリのデータに設定します。次のステップに進みます。

    それ以外の場合:

    1. requestを潜在的CORSリクエストを作成する結果として得られるものとし、urlString、「image」、およびcorsAttributeStateを設定します。

    2. requestのクライアントをclient、イニシエータを「imageset」に設定し、requestの同期フラグを設定します。

    3. requestのリファラーポリシーを要素のreferrerpolicy属性の現在の状態に設定します。

    4. requestの優先度を要素のfetchpriority属性の現在の状態に設定します。

    5. requestの結果をフェッチの結果とします。

    6. もしresponseの不安全な応答がネットワークエラーである場合、または画像形式がサポートされていない場合（画像スニッフィングルールを適用して決定）、またはimage requestの画像が致命的な方法で破損しており、画像の寸法を取得できない場合、またはリソースタイプがmultipart/x-mixed-replaceである場合は、保留中のリクエストをnullに設定し、これらのステップを中止します。

    7. それ以外の場合、responseの不安全な応答がimage requestの画像データとなります。それはCORS同一オリジンまたはCORSクロスオリジンのいずれかであり、これは他のAPIとの画像の相互作用に影響します（例：canvasで使用される場合）。

  16. 次のステップを使用して、img要素に対して要素タスクをキューに入れます:

    1. もしこのアルゴリズムが開始されて以来、img要素に関連する突然変異が発生した場合、保留中のリクエストをnullに設定し、これらのステップを中止します。

    2. img要素の最後に選択されたソースをselected sourceとし、img要素の現在のピクセル密度をselected pixel densityとします。

    3. image requestの状態を完全に利用可能に設定します。

    4. keyを使用して、画像を利用可能な画像のリストに追加し、上位レイヤーキャッシングを無視するフラグを設定します。

    5. 保留中のリクエストを現在のリクエストにアップグレードします。

    6. img要素を指定して、image requestをプレゼンテーションのために準備します。

    7. イベントを発火します。このイベントはloadという名前で、img要素で発生します。

4.8.4.4 画像の代替となるテキストを提供するための要件
4.8.4.4.1 一般的なガイドライン

特に指定がない限り、alt属性は指定されなければならず、その値は空であってはなりません。値は画像の適切な代替となるものでなければなりません。alt属性の具体的な要件は、以下のセクションで説明するように、画像が何を表現することを意図しているかに依存します。

代替テキストを書く際に考慮すべき最も一般的なルールは次のとおりです: すべての画像をそのalt属性のテキストに置き換えても、ページの意味が変わらないようにすることです。

したがって、一般的には、画像を含めることができなかった場合にどのように記述したかを考えることで、代替テキストを書くことができます。

このことから派生するのは、alt属性の値には、画像のキャプション、タイトル、または凡例と見なされる可能性のあるテキストを含めるべきではないということです。それは、画像の代わりにユーザーが使用できる代替テキストを含むべきであり、画像を補完するためのものではありません。補足情報にはtitle属性を使用できます。

もう一つの派生事項として、alt属性の値は、画像の横にある文章ですでに提供されている情報を繰り返してはなりません。

代替テキストを考える一つの方法は、画像が存在することに言及せずに、電話で誰かにページを読み上げる方法を考えることです。画像の代わりに言うことは、代替テキストを書く際の良い出発点となります。

a要素がハイパーリンクを作成する場合、またはbutton要素が、テキストコンテンツを持たず、1つ以上の画像のみを含む場合、alt属性にはリンクまたはボタンの目的を伝えるテキストを含める必要があります。

この例では、ユーザーは3つの中から好みの色を選択するよう求められます。それぞれの色は画像で表示されていますが、ユーザーエージェントを画像を表示しないように設定しているユーザーには、色の名前が代わりに使用されます: 

<h1>Pick your color</h1>
 <ul>
  <li><a href="green.html"><img src="green.jpeg" alt="Green"></a></li>
  <li><a href="blue.html"><img src="blue.jpeg" alt="Blue"></a></li>
  <li><a href="red.html"><img src="red.jpeg" alt="Red"></a></li>
 </ul>

この例では、それぞれのボタンに、ユーザーが望む色出力の種類を示す一連の画像が設定されています。最初の画像が、各ケースで代替テキストを提供するために使用されています。

<button name="rgb"><img src="red" alt="RGB"><img src="green" alt=""><img src="blue" alt=""></button>
 <button name="cmyk"><img src="cyan" alt="CMYK"><img src="magenta" alt=""><img src="yellow" alt=""><img src="black" alt=""></button>

それぞれの画像がテキストの一部を表しているため、このように書くこともできます:

<button name="rgb"><img src="red" alt="R"><img src="green" alt="G"><img src="blue" alt="B"></button>
 <button name="cmyk"><img src="cyan" alt="C"><img src="magenta" alt="M"><img src="yellow" alt="Y"><img src="black" alt="K"></button>

ただし、他の代替テキストの場合、これでは機能しないこともあり、各ケースで全ての代替テキストを1つの画像にまとめる方が理にかなっているかもしれません:

<button name="rgb"><img src="red" alt="sRGB profile"><img src="green" alt=""><img src="blue" alt=""></button>
 <button name="cmyk"><img src="cyan" alt="CMYK profile"><img src="magenta" alt=""><img src="yellow" alt=""><img src="black" alt=""></button>
4.8.4.4.3 代替グラフィカル表現を持つフレーズや段落: チャート、ダイアグラム、グラフ、地図、イラスト

時には、フローチャート、図、グラフ、または道順を示す簡単な地図のように、グラフィカルな形式で表現した方がより明確になることがあります。このような場合、img要素を使用して画像を提供することができますが、画像を見ることができないユーザー（例えば、非常に遅い接続を使用しているため、テキストのみのブラウザを使用しているため、またはハンズフリーの自動車音声ウェブブラウザでページを読み上げているため、あるいは単に視覚障害があるため）でも伝えたいメッセージを理解できるように、より簡単なテキスト版も提供する必要があります。

テキストはalt属性に与えられ、src属性で指定された画像と同じメッセージを伝えなければなりません。

代替テキストは画像の代替であり、画像の説明ではないことを理解することが重要です。

以下の例では、画像形式のフローチャートがあり、alt属性のテキストでフローチャートがプローズ形式で書き換えられています: 

<p>In the common case, the data handled by the tokenization stage
 comes from the network, but it can also come from script.</p>
 <p><img src="images/parsing-model-overview.svg" alt="The Network
 passes data to the Input Stream Preprocessor, which passes it to the
 Tokenizer, which passes it to the Tree Construction stage. From there,
 data goes to both the DOM and to Script Execution. Script Execution is
 linked to the DOM, and, using document.write(), passes data to the
 Tokenizer."></p>

ここに、説明に画像を含める問題に対する良い解決策と悪い解決策を示す別の例があります。

まず、良い解決策です。このサンプルは、画像が存在しなかった場合にプローズで記述したであろう内容を代替テキストとすべきことを示しています。

<!-- This is the correct way to do things. -->
 <p>
  You are standing in an open field west of a house.
  <img src="house.jpeg" alt="The house is white, with a boarded front door.">
  There is a small mailbox here.
 </p>

次に、悪い解決策です。この間違った方法では、代替テキストが単に画像の説明になっているだけで、画像のテキストによる代替とはなっていません。画像が表示されないとき、最初の例ほどテキストが自然に流れないため、これは良くありません。 

<!-- This is the wrong way to do things. -->
 <p>
  You are standing in an open field west of a house.
  <img src="house.jpeg" alt="A white house, with a boarded front door.">
  There is a small mailbox here.
 </p>

"Photo of white house with boarded door"のようなテキストも同様に悪い代替テキストとなります（ただし、これはtitle属性や、figcaption要素を持つfigureに適している場合があります）。

4.8.4.4.4 代替グラフィカル表現を持つ短いフレーズやラベル: アイコン、ロゴ

ドキュメントには、アイコン形式で情報を含めることができます。アイコンは、ビジュアルブラウザのユーザーが一目で機能を認識できるようにすることを意図しています。

場合によっては、アイコンが同じ意味を伝えるテキストラベルを補完するものとなっています。その場合、alt属性は存在しなければなりませんが、空でなければなりません。

ここでは、アイコンが同じ意味を伝えるテキストの隣にあるため、alt属性は空になっています: 

<nav>
  <p><a href="/help/"><img src="/icons/help.png" alt=""> Help</a></p>
  <p><a href="/configure/"><img src="/icons/configuration.png" alt="">
  Configuration Tools</a></p>
 </nav>

他の場合では、アイコンの隣にその意味を説明するテキストがなく、アイコンは自己説明的であることが求められます。その場合、alt属性には同等のテキストラベルが与えられなければなりません。

ここでは、ニュースサイトの投稿にアイコンがラベルとして使用され、そのトピックを示しています。

<body>
  <article>
   <header>
    <h1>Ratatouille wins <i>Best Movie of the Year</i> award</h1>
    <p><img src="movies.png" alt="Movies"></p>
   </header>
   <p>Pixar has won yet another <i>Best Movie of the Year</i> award,
   making this its 8th win in the last 12 years.</p>
  </article>
  </article>
   <header>
    <h1>Latest TWiT episode is online</h1>
    <p><img src="podcasts.png" alt="Podcasts"></p>
   </header>
   <p>The latest TWiT episode has been posted, in which we hear
   several tech news stories as well as learning much more about the
   iPhone. This week, the panelists compare how reflective their
   iPhones' Apple logos are.</p>
  </article>
 </body>

多くのページには、企業、組織、プロジェクト、バンド、ソフトウェアパッケージ、国など、特定のエンティティを表すロゴ、記章、旗、または紋章が含まれています。

ロゴがエンティティを表すために使用されている場合（例えば、ページの見出しとして）、alt属性には、ロゴによって表されるエンティティの名前を含める必要があります。alt属性に「ロゴ」という単語などのテキストを含めてはなりません。伝えられているのは、それがロゴであるという事実ではなく、エンティティそのものです。

ロゴがそれが表すエンティティの名前の隣に配置されている場合、そのロゴは補足的なものであり、alt属性は空でなければなりません。

ロゴが単に装飾として使用されている場合（ブランド化、または、例えば、ロゴが属するエンティティに言及している記事のサイド画像として使用されている場合）、純粋に装飾的な画像に関する以下の記述が適用されます。ロゴが実際に議論されている場合、それは代替グラフィカル表現を持つフレーズや段落（ロゴの説明）として使用されており、上記の最初の記述が適用されます。

以下のスニペットには、上記の4つのケースすべてが含まれています。まず、会社を表すために使用されているロゴを見てみましょう:

<h1><img src="XYZ.gif" alt="The XYZ company"></h1>

次に、ロゴが会社名の隣に配置されている段落を見てみましょう。この場合、代替テキストはありません:

<article>
  <h2>News</h2>
  <p>We have recently been looking at buying the <img src="alpha.gif"
  alt=""> ΑΒΓ company, a small Greek company
  specializing in our type of product.</p>

この3番目のスニペットでは、記事全体の一部として、サイドにロゴが使用されています:

<aside><p><img src="alpha-large.gif" alt=""></p></aside>
  <p>The ΑΒΓ company has had a good quarter, and our
  pie chart studies of their accounts suggest a much bigger blue slice
  than its green and orange slices, which is always a good sign.</p>
 </article>

最後に、ロゴについて論じている意見記事があり、そのため、代替テキストに詳細が記述されています。

<p>Consider for a moment their logo:</p>
 
 <p><img src="/images/logo" alt="It consists of a green circle with a
 green question mark centered inside it."></p>
 
 </p>How unoriginal can you get? I mean, oooooh, a question mark, how
 <em>revolutionary</em>, how utterly </em>ground-breaking</em>, I'm
 sure everyone will rush to adopt those specifications now! They could
 at least have tried for some sort of, I don't know, sequence of
 rounded squares with varying shades of green and bold white outlines,
 at least that would look good on the cover of a blue book.</p>

この例は、画像が表示されていない場合に、代替テキストが使用され、最初から画像がなかったかのように、テキストが周囲のテキストにシームレスに流れるように代替テキストが書かれるべきであることを示しています。

4.8.4.4.5 書体効果を狙ってグラフィック化されたテキスト

時には、画像がテキストだけで構成されており、その画像の目的は実際の書体効果を強調することではなく、単にテキストそのものを伝えることです。

そのような場合、alt属性は存在しなければなりませんが、画像に書かれているのと同じテキストで構成されなければなりません。

例えば、「Earth Day」というテキストが花や植物で飾られたグラフィックを考えてみてください。このテキストが単に見出しとして使用され、グラフィカルユーザーのためにページを華やかにするために使用されている場合、正しい代替テキストは「Earth Day」と同じテキストであり、装飾について言及する必要はありません:

<h1><img src="earthdayheading.png" alt="Earth Day"></h1>

装飾写本では、いくつかの文字の画像にグラフィックが使用されることがあります。そのような状況では、代替テキストは画像が表す文字だけになります。

<p><img src="initials/o.svg" alt="O">nce upon a time and a long long time ago, late at
 night, when it was dark, over the hills, through the woods, across a great ocean, in a land far
 away, in a small house, on a hill, under a full moon...

画像がUnicodeで表現できない文字を表すために使用される場合、例えば外字、異体字、または新しい通貨記号のような新しい文字の場合、代替テキストは同じものをより一般的な方法で書いたものでなければなりません。例えば、その文字の発音を示すために、平仮名や片仮名を使用することができます。

1997年のこの例では、1本ではなく2本のバーが中央にある巻き毛のEのように見える新しい通貨記号が画像を使用して表されています。代替テキストには、その文字の発音が示されています。

<p>Only <img src="euro.png" alt="euro ">5.99!

同じ目的を果たすことができる場合には、文字が使用されるべきです。例えば、装飾があるためにテキストで直接表現できない場合や、適切な文字が存在しない場合（外字の場合のように）、画像を使用することが適切です。

作成者がシステムのデフォルトフォントが特定の文字をサポートしていないために画像を使用したくなる場合、ウェブフォントは画像よりも優れた解決策です。

4.8.4.4.6 周囲のテキストの一部をグラフィカルに表現したもの

多くの場合、画像は実際には補足的なものであり、その存在は単に周囲のテキストを強調するためのものです。このような場合、alt属性は存在しなければなりませんが、その値は空の文字列でなければなりません。

一般的に、画像を削除してもページの有用性が損なわれることがなく、画像を含めることでビジュアルブラウザのユーザーが概念を理解しやすくなる場合、画像はこのカテゴリに該当します。

前の段落をグラフィカルに表現したフローチャート:

<p>The Network passes data to the Input Stream Preprocessor, which
 passes it to the Tokenizer, which passes it to the Tree Construction
 stage. From there, data goes to both the DOM and to Script Execution.
 Script Execution is linked to the DOM, and, using document.write(),
 passes data to the Tokenizer.</p>
 <p><img src="images/parsing-model-overview.svg" alt=""></p>

このような場合、単なるキャプションを含む代替テキストを含めることは誤りです。キャプションを含める場合は、title属性を使用するか、figureおよびfigcaption要素を使用することができます。後者の場合、画像は実際には代替グラフィカル表現を持つフレーズや段落となり、代替テキストが必要になります。 

<!-- Using the title="" attribute -->
 <p>The Network passes data to the Input Stream Preprocessor, which
 passes it to the Tokenizer, which passes it to the Tree Construction
 stage. From there, data goes to both the DOM and to Script Execution.
 Script Execution is linked to the DOM, and, using document.write(),
 passes data to the Tokenizer.</p>
 <p><img src="images/parsing-model-overview.svg" alt=""
         title="Flowchart representation of the parsing model."></p>
<!-- Using <figure> and <figcaption> -->
 <p>The Network passes data to the Input Stream Preprocessor, which
 passes it to the Tokenizer, which passes it to the Tree Construction
 stage. From there, data goes to both the DOM and to Script Execution.
 Script Execution is linked to the DOM, and, using document.write(),
 passes data to the Tokenizer.</p>
 <figure>
  <img src="images/parsing-model-overview.svg" alt="The Network leads to
  the Input Stream Preprocessor, which leads to the Tokenizer, which
  leads to the Tree Construction stage. The Tree Construction stage
  leads to two items. The first is Script Execution, which leads via
  document.write() back to the Tokenizer. The second item from which
  Tree Construction leads is the DOM. The DOM is related to the Script
  Execution.">
  <figcaption>Flowchart representation of the parsing model.</figcaption>
 </figure>
<!-- This is WRONG. Do not do this. Instead, do what the above examples do. -->
 <p>The Network passes data to the Input Stream Preprocessor, which
 passes it to the Tokenizer, which passes it to the Tree Construction
 stage. From there, data goes to both the DOM and to Script Execution.
 Script Execution is linked to the DOM, and, using document.write(),
 passes data to the Tokenizer.</p>
 <p><img src="images/parsing-model-overview.svg"
         alt="Flowchart representation of the parsing model."></p>
 <!-- Never put the image's caption in the alt="" attribute! -->

前の段落をグラフィカルに表現したグラフ:

<p>According to a study covering several billion pages,
 about 62% of documents on the web in 2007 triggered the Quirks
 rendering mode of web browsers, about 30% triggered the Almost
 Standards mode, and about 9% triggered the Standards mode.</p>
 <p><img src="rendering-mode-pie-chart.png" alt=""></p>
4.8.4.4.7 補助的な画像

時には、画像がコンテンツにとって重要ではないものの、純粋に装飾的でもなく、テキストと完全に重複しているわけでもない場合があります。このような場合、alt属性は存在しなければならず、その値は空の文字列であるか、画像が伝える情報のテキスト表現である必要があります。画像にタイトルを示すキャプションがある場合、alt属性の値は空であってはなりません（視覚に頼らない読者にとって非常に混乱を招くためです）。

政治家についての記事で、その個人の顔が画像に表示されている状況を考えてみてください。画像は純粋に装飾的ではなく、記事に関連しています。また、画像は記事と完全に重複しているわけでもなく、政治家の外見を示しています。代替テキストを提供するかどうかは、画像が文章の解釈に影響を与えるかどうかに基づいて決定される、著者の判断です。

この最初のバリエーションでは、画像が文脈なしに表示され、代替テキストは提供されていません:

<p><img src="president.jpeg" alt=""> Ahead of today's referendum,
 the President wrote an open letter to all registered voters. In it, she admitted that the country was
 divided.</p>

もし写真がただの顔であれば、それを説明する価値はないかもしれません。個人が赤毛か金髪か、白い肌か黒い肌か、目が一つか二つかは、読者にとって関心のないことです。

しかし、写真がより動的で、例えば政治家が怒っている、特に喜んでいる、または悲嘆に暮れている様子を示している場合、代替テキストは記事のトーンを設定する上で役立つでしょう。そうでなければ、この記事が伝えるべきトーンが欠けてしまうかもしれません: 

<p><img src="president.jpeg" alt="The President is sad.">
 Ahead of today's referendum, the President wrote an open letter to all
 registered voters. In it, she admitted that the country was divided.
 </p>
<p><img src="president.jpeg" alt="The President is happy!">
 Ahead of today's referendum, the President wrote an open letter to all
 registered voters. In it, she admitted that the country was divided.
 </p>

個人が「悲しい」か「嬉しい」かは、段落の残り部分の解釈に影響を与えます。彼女は国が分断されていることに不満を示しているのか、それとも分断された国が彼女の政治的キャリアにとって良いと感じているのか？解釈は画像に基づいて変わります。

画像にキャプションがある場合、代替テキストを含めることで、視覚に頼らないユーザーがキャプションが何を指しているのかを理解するのを防ぐことができます。

<p>Ahead of today's referendum, the President wrote an open letter to
 all registered voters. In it, she admitted that the country was divided.</p>
 <figure>
  <img src="president.jpeg"
       alt="A high forehead, cheerful disposition, and dark hair round out the President's face.">
  <figcaption> The President of Ruritania. Photo © 2014 PolitiPhoto. </figcaption>
 </figure>
4.8.4.4.8 純粋に装飾的で情報を追加しない画像

画像が装飾的であるが、特にページ固有のものでない場合（例えば、サイト全体のデザインスキームの一部を構成する画像など）、その画像はドキュメントのマークアップではなく、サイトのCSSで指定されるべきです。

しかし、周囲のテキストで言及されていないが、それでもある程度の関連性がある装飾的な画像は、img要素を使用してページに含めることができます。このような画像は装飾的ですが、それでもコンテンツの一部を形成しています。このような場合、alt属性は存在しなければならず、その値は空の文字列でなければなりません。

画像が関連性があるにもかかわらず純粋に装飾的である例としては、バーニングマンのイベントについてのブログ記事に掲載されたブラックロックシティの風景写真や、詩を朗読するページに掲載されたその詩に触発された絵画の画像などが挙げられます。以下のスニペットは、後者のケースの例を示しています（このスニペットには最初の詩節のみが含まれています）： 

<h1>The Lady of Shalott</h1>
 <p><img src="shalott.jpeg" alt=""></p>
 <p>On either side the river lie<br>
 Long fields of barley and of rye,<br>
 That clothe the wold and meet the sky;<br>
 And through the field the road run by<br>
 To many-tower'd Camelot;<br>
 And up and down the people go,<br>
 Gazing where the lilies blow<br>
 Round an island there below,<br>
 The island of Shalott.</p>

画像が小さな画像ファイルに分割され、それらが再び組み合わさって完全な画像を形成する場合、その画像の1つには、全体の画像に適用される適切な規則に従ってalt属性が設定されなければならず、残りのすべての画像にはalt属性が空の文字列として設定されなければなりません。

以下の例では、XYZ Corpの会社ロゴを表す画像が2つの部分に分割されています。最初の部分には「XYZ」という文字が含まれ、2番目の部分には「Corp」という文字が含まれています。代替テキスト「XYZ Corp」は最初の画像にすべて含まれています。

<h1><img src="logo1.png" alt="XYZ Corp"><img src="logo2.png" alt=""></h1>

次の例では、評価が3つの塗りつぶされた星と2つの空の星として表示されます。代替テキストは「★★★☆☆」とすることもできますが、著者はより親切に「5つ中3つ」として評価を示すことを選択しました。それが最初の画像の代替テキストであり、残りの画像には空の代替テキストが設定されています。 

<p>Rating: <meter max=5 value=3><img src="1" alt="3 out of 5"
   ><img src="1" alt=""><img src="1" alt=""><img src="0" alt=""
   ><img src="0" alt=""></meter></p>

一般的には、リンク用に画像をスライスする代わりに、イメージマップを使用するべきです。

しかし、画像が実際にスライスされ、スライスされた画像のいずれかがリンクの唯一の内容となっている場合、リンクごとに1つの画像に、そのリンクの目的を表すalt属性に代替テキストが設定されなければなりません。

次の例では、飛んでいるスパゲッティモンスターの紋章を表す画像が、左側のヌードルの付属物と右側のヌードルの付属物が異なる画像で表現されており、ユーザーが冒険の中で左側または右側を選択できるようにしています。

<h1>The Church</h1>
 <p>You come across a flying spaghetti monster. Which side of His
 Noodliness do you wish to reach out for?</p>
 <p><a href="?go=left" ><img src="fsm-left.png"  alt="Left side. "></a
   ><img src="fsm-middle.png" alt=""
   ><a href="?go=right"><img src="fsm-right.png" alt="Right side."></a></p>
4.8.4.4.11 コンテンツの重要な部分

場合によっては、画像がコンテンツの重要な部分を占めることがあります。例えば、フォトギャラリーの一部であるページの場合、その画像がページ全体の要点であることがあります。

コンテンツの重要な部分である画像に対して代替テキストを提供する方法は、画像の出自に依存します。

一般的なケース

詳細な代替テキストを提供できる場合、例えば、雑誌のレビューにおけるスクリーンショットの一部、漫画の一部、またはその写真に関するブログエントリの写真などの場合、その画像の代わりとなるテキストをalt属性の内容として提供する必要があります。

新しいOSのスクリーンショットギャラリーで、代替テキストが付いたスクリーンショット:

<figure>
  <img src="KDE%20Light%20desktop.png"
       alt="デスクトップは青で、左側にシステム、ホーム、K-Mailなどと
 いったアイコンが2列に並んでいます。ウィンドウが開かれており、メニューが
 ウィンドウに収まりきらない場合、次の行に折り返されることが示されています。
 ウィンドウには上部にアイコンのリストがあり、その下にアドレスバーがあり、
 左側にはタブ用のアイコンのリスト、下部にはステータスバーがあり、中央には
 2つのペインがあります。デスクトップには画面下部にいくつかのボタン、ペイジャー、
 開いているアプリケーションのリスト、および時計が配置されています。">
  <figcaption>KDEデスクトップのスクリーンショット。</figcaption>

財務報告書のグラフ:

<img src="sales.gif"
      title="売上グラフ"
      alt="1998年から2005年にかけて、各年の売上増加率は次の通りです: 624%、75%、138%、40%、35%、9%、21%">

「売上グラフ」は、売上グラフにとって不十分な代替テキストであることに注意してください。キャプションとして適したテキストは、一般的に代替テキストとして適していません。

完全な説明が困難な画像

場合によっては、画像の性質上、詳細な代替テキストを提供することが実際には難しいことがあります。例えば、画像が不明瞭であったり、複雑なフラクタルであったり、詳細な地形図である場合です。

このような場合でも、alt属性には適切な代替テキストが含まれている必要がありますが、多少簡潔なものでも構いません。

場合によっては、画像を適切に説明できるテキストが存在しないことがあります。例えば、ロールシャッハのインクブロットテストを有効に説明できるテキストはほとんどありません。しかし、簡潔であっても、何もないよりは良いです: 

<figure>
  <img src="/commons/a/a7/Rorschach1.jpg" alt="左右対称で縁が不明瞭な形状、中央に小さな隙間、中央から少しずれたところに2つの大きな隙間、その下に似た隙間が2つあります。輪郭は上半分が下半分よりも広く、側面は中央よりも上に伸び、中央は側面よりも下に伸びています。">
  <figcaption>ロールシャッハ・インクブロットテストの最初の10枚のカードのうちの1枚の黒い輪郭。</figcaption>

以下のような代替テキストの使用は非常に悪い例です:

<!-- この例は間違っています。コピーしないでください。 -->
 <figure>
  <img src="/commons/a/a7/Rorschach1.jpg" alt="ロールシャッハ・インクブロットテストの最初の10枚のカードのうちの1枚の黒い輪郭。">
  <figcaption>ロールシャッハ・インクブロットテストの最初の10枚のカードのうちの1枚の黒い輪郭。</figcaption>
 </figure>

このようにキャプションを代替テキストに含めることは有用ではありません。画像を表示できないユーザーに対してキャプションを二重に提供することになり、1回だけキャプションを読んだり聞いたりするよりも助けになりません。

フラクタルなど、定義上無限の詳細を持つ画像も、完全な説明が難しい例です。

以下の例は、マンデルブロ集合の画像全体に対して代替テキストを提供する方法の一例です。

<img src="ms1.jpeg" alt="マンデルブロ集合は、正の方向にある実軸上の尖点を持つ心臓型で、負の方向に接触する小さな球体が同じ中心線に沿って配置されており、これら2つの形状がさまざまなサイズの小さな球体に囲まれています。">

同様に、例えば伝記に掲載されている人物の顔写真なども、コンテンツにとって非常に重要であると考えられることがありますが、完全に代替できるテキストを提供するのは難しいことがあります:

<section class="bio">
  <h1>アイザック・アシモフの伝記</h1>
  <p>アイザックは1920年にアイザック・ユードヴィッチ・オズィモフとして生まれ、非常に多作な作家でした。</p>
  <p><img src="headpics/asimov.jpeg" alt="アイザック・アシモフは黒髪で、高い額とメガネをかけていました。後年には、長い白いもみあげをしていました。"></p>
  <p>アシモフはロシアで生まれ、3歳のときに米国に移住しました。</p>
  </p>...</p>
 </section>

このような場合、代替テキストに画像自体の存在に言及する必要はなく（むしろ避けるべきです）、そのようなテキストはブラウザ自体が画像の存在を報告することと重複するためです。例えば、「アイザック・アシモフの写真」という代替テキストを使用した場合、準拠したユーザーエージェントは「（画像）アイザック・アシモフの写真」と読み上げるかもしれず、「（画像）アイザック・アシモフは黒髪で、高い額とメガネをかけていました…」のほうが有用です。

内容が不明な画像

残念ながら、代替テキストがまったく提供されない場合もあります。例えば、画像が自動的に取得され、関連する代替テキストが提供されていない場合（例：ウェブカメラ）や、ユーザーが提供した画像を使用してページがスクリプトで生成されるが、ユーザーが適切な代替テキストを提供しなかった場合（例：写真共有サイト）や、著者自体が画像の内容を知らない場合（例：盲目の写真家がブログに画像を共有する場合）などです。

このような場合、alt属性は省略しても構いませんが、次の条件のいずれかを満たす必要があります。

このようなケースは可能な限り最小限に抑える必要があります。著者が実際に代替テキストを提供できる可能性がわずかでもある場合には、alt属性を省略することは許されません。

写真共有サイトで、サイトがキャプション以外のメタデータを持たずに画像を受け取った場合、そのようにマークアップできます:

<figure>
  <img src="1100670787_6a7c664aef.jpg">
  <figcaption>私たちと一緒にどこへでも旅したバブルス。</figcaption>
 </figure>

ただし、画像の重要な部分について詳細な説明をユーザーから取得し、ページに含めるのが望ましいです。

盲目のユーザーのブログに、ユーザーが撮影した写真が表示されている場合です。最初は、ユーザーが撮影した写真が何を示しているかがわからないかもしれません:

<article>
  <h1>私は写真を撮りました</h1>
  <p>今日は外出して写真を撮りました！</p>
  <figure>
   <img src="photo2.jpeg">
   <figcaption>私のポーチから盲目的に撮影された写真。</figcaption>
  </figure>
 </article>

その後、ユーザーが友人から画像の説明を得て、代替テキストを含めることができるようになります:

<article>
  <h1>私は写真を撮りました</h1>
  <p>今日は外出して写真を撮りました！</p>
  <figure>
   <img src="photo2.jpeg" alt="写真には、私の屋根の縁から吊り下げられているリスの餌箱が写っています。餌箱は半分しか満たされておらず、リスは見当たりません。背景には、ぼやけた木々が写っています。餌箱は木製で、金属製の格子があり、中にはピーナッツが入っています。屋根の縁も木製で、白く塗られ、青い縞模様が入っています。">
   <figcaption>私のポーチから盲目的に撮影された写真。</figcaption>
  </article>

場合によっては、画像の要点がテキスト説明が利用できないことであり、ユーザーが説明を提供する必要がある場合もあります。例えば、CAPTCHA画像の要点は、ユーザーがグラフィックを実際に読むことができるかどうかを確認することです。以下はCAPTCHAをマークアップする方法の一例です（title属性に注意してください）: 

<p><label>この画像には何が書かれていますか？
 <img src="captcha.cgi?id=8934" title="CAPTCHA">
 <input type=text name=captcha></label>
 (画像が表示できない場合は、<a href="?audio">音声テスト</a>を使用できます。)</p>

別の例として、画像を表示して代替テキストを求めるソフトウェアがあり、その目的は正しい代替テキストを提供するページを作成することです。このようなページには、次のように画像の表が含まれることがあります: 

<table>
  <thead>
   <tr> <th> 画像 <th> 説明
  </tbody>
   <tr>
    <td> <img src="2421.png" title="画像640x100、ファイル名 'banner.gif'">
    <td> <input name="alt2421">
   </tr>
    <td> <img src="2422.png" title="画像200x480、ファイル名 'ad3.gif'">
    <td> <input name="alt2422">
 </table>

この例でも、可能な限り有用な情報がtitle属性に含まれていることに注意してください。

一部のユーザーは、画像をまったく使用できない場合があります（例：非常に遅い接続のため、テキストのみのブラウザを使用しているため、ハンズフリーの自動車音声ウェブブラウザでページが読み上げられているため、単に視覚障害があるためなど）。したがって、上記の例のように代替テキストが利用できず、提供できない場合にのみ、alt属性を省略することが許可されます。著者の努力不足は、alt属性を省略する正当な理由ではありません。

4.8.4.4.12 ユーザーを対象としない画像

一般的に、著者はimg要素を画像表示以外の目的で使用することを避けるべきです。

もしimg要素が、例えばページビューをカウントするサービスの一部として画像表示以外の目的で使用される場合、alt属性は空の文字列にする必要があります。

そのような場合、width属性とheight属性は両方ともゼロに設定すべきです。

4.8.4.4.13 画像を表示できることがわかっている特定の人物に向けたメールまたはプライベートドキュメント内の画像

このセクションは、公開アクセス可能なドキュメントや、著者が個人的に知らない可能性のあるターゲットオーディエンスを持つドキュメント（例えばウェブサイト上のドキュメント、公開メールリストに送信されたメール、ソフトウェアドキュメントなど）には適用されません。

特定の人物に向けたプライベートなコミュニケーション（HTMLメールなど）で、その人物が画像を表示できることがわかっている場合には、alt属性を省略することができます。ただし、そのような場合でも、ユーザーが画像をサポートしないメールクライアントを使用した場合や、ドキュメントが他のユーザーに転送された場合に備えて、適切な代替テキストを含めることが強く推奨されます。

4.8.4.4.14 マークアップジェネレーターへのガイダンス

マークアップジェネレーター（WYSIWYGオーサリングツールなど）は、可能な限りユーザーから代替テキストを取得する必要があります。しかし、多くの場合、これが不可能であることも認識されています。

リンクの唯一の内容である画像の場合、マークアップジェネレーターはリンク先のタイトルやURLを調べ、得られた情報を代替テキストとして使用する必要があります。

キャプションがある画像については、マークアップジェネレーターはfigureおよびfigcaption要素、またはtitle属性を使用して画像のキャプションを提供する必要があります。

最終手段として、実装者は、画像が周囲のコンテンツに特有であるが情報を追加しない純粋に装飾的な画像であると想定してalt属性を空の文字列に設定するか、画像がコンテンツの重要な部分であると想定してalt属性をまったく省略する必要があります。

マークアップジェネレーターは、代替テキストを取得できなかったimg要素に対してgenerator-unable-to-provide-required-alt属性を指定することができます。この属性の値は空の文字列でなければなりません。このような属性を含むドキュメントは適合していませんが、適合チェッカーはこのエラーを静かに無視します。

これは、最先端の自動適合チェッカーが偽の代替テキストと正しい代替テキストを区別できないために、マークアップジェネレーターが適合チェッカーを黙らせるためだけに偽の代替テキストを提供するという更に悪質なエラーに置き換える圧力を避けることを目的としています。

マークアップジェネレーターは、一般に画像自体のファイル名を代替テキストとして使用することを避けるべきです。同様に、マークアップジェネレーターはプレゼンテーションユーザーエージェント（例：ウェブブラウザ）にも同様に利用可能なコンテンツから代替テキストを生成することを避けるべきです。

これは、ページが生成されると通常は更新されませんが、その後にページを読み取るブラウザはユーザーによって更新される可能性があるため、ブラウザはページを生成したときのマークアップジェネレーターよりも、より最新で精緻化されたヒューリスティックを持っている可能性が高いためです。

4.8.4.4.15 適合チェッカーへのガイダンス

適合チェッカーは、次の条件のいずれかが該当しない限り、alt属性の欠如をエラーとして報告しなければなりません:

4.8.5 iframe要素

要素/iframe

すべての現行エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera15+Edge79+
Edge（レガシー）12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

HTMLIFrameElement

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge（レガシー）12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
埋め込みコンテンツ。
インタラクティブコンテンツ。
有形コンテンツ。
この要素が使用される文脈:
埋め込みコンテンツが予想される場所。
コンテンツモデル:
なし。
text/htmlでのタグ省略:
タグは省略不可。
コンテンツ属性:
グローバル属性
src — リソースのアドレス
srcdoc — iframe内に表示するドキュメント
name — ナビゲーション可能なコンテンツの名前
sandbox — ネストされたコンテンツのセキュリティルール
allow — Permissions policyをiframeのコンテンツに適用
allowfullscreen — iframeのコンテンツがrequestFullscreen()を使用できるかどうか
width — 横方向のサイズ
height — 縦方向のサイズ
referrerpolicy — リファラーポリシーをフェッチで適用する
loading — ローディングの遅延を決定する際に使用される
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLIFrameElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute USVString src;
   [CEReactions] attribute (TrustedHTML or DOMString) srcdoc;
   [CEReactions] attribute DOMString name;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList sandbox;
   [CEReactions] attribute DOMString allow;
   [CEReactions] attribute boolean allowFullscreen;
   [CEReactions] attribute DOMString width;
   [CEReactions] attribute DOMString height;
   [CEReactions] attribute DOMString referrerPolicy;
   [CEReactions] attribute DOMString loading;
   readonly attribute Document? contentDocument;
   readonly attribute WindowProxy? contentWindow;
   Document? getSVGDocument();
 
   // also has obsolete members
 };

iframe 要素は、そのナビゲーション可能なコンテンツを表します。

src 属性は、要素のURL を指定し、そのナビゲーション可能なコンテンツを含むべきです。この属性が存在する場合、それは有効な非空のURLであり、空白に囲まれている可能性があります。itemprop 属性がiframe要素に指定されている場合は、src属性も指定する必要があります。

要素/iframe#attr-srcdoc

すべての現行エンジンでサポートされています。

Firefox25+Safari6+Chrome20+
Opera?Edge79+
Edge（レガシー）?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?

srcdoc 属性は、その要素のナビゲーション可能なコンテンツを含むべきページの内容を指定します。この属性の値は、構築に使用されます。iframe srcdocドキュメントを構成するDocumentのURLは、about:srcdocと一致します。

srcdoc 属性が存在する場合、その値はHTML構文を使用し、以下の構文要素を順番に含む必要があります:

  1. 任意の数のコメントとASCIIホワイトスペース。
  2. オプションでDOCTYPE。
  3. 任意の数のコメントとASCIIホワイトスペース。
  4. ドキュメント要素、html形式の要素。
  5. 任意の数のコメントとASCIIホワイトスペース。

上記の要件はXMLドキュメントにも適用されます。

ここでは、ブログがsrcdoc 属性をsandbox属性と組み合わせて使用し、この機能をサポートするユーザーエージェントのユーザーに、ブログ投稿コメントにおけるスクリプトインジェクションからの保護のための追加の保護層を提供しています: 

<article>
  <h1>私は自分の雑誌を手に入れました！</h1>
  <p>多くの努力の末、ついに出版社を見つけ、今や自分の雑誌を持っています！素晴らしいでしょ？！9月に最初の号が発行され、食べ物を手に入れる方法や、箱に入る方法に関する記事があります。とても素晴らしいです！</p>
  <footer>
   <p>執筆者 <a href="/users/cap">cap</a>, 1時間前。
  </footer>
  </article>
   <footer>13分前、<a href="/users/ch">ch</a>は書いた: </footer>
   <iframe sandbox srcdoc="<p>カバー写真はもう撮れましたか？"></iframe>
  </article>
  <article>
   <footer>9分前、<a href="/users/ch">ch</a>は書いた: </footer>
   <iframe sandbox srcdoc="<p>ええ、私のギャラリーで見られます <a href=&quot;/gallery?mode=cover&amp;amp;page=1&quot;>ここ</a>で。"></iframe>
  </article>
  <article>
   <footer>5分前、<a href="/users/ch">ch</a>は書いた: </footer>
   <iframe sandbox srcdoc="<p>それはアールのテーブルです。<p>次号の表紙にはアール&amp;amp;私を載せるべきです。"></iframe>
  </article>

引用符がどのようにエスケープされなければならないか（さもなければsrcdoc属性が早期に終了してしまう）、およびサンドボックス化されたコンテンツで言及される生のアンパサンド（例えばURLやプローズ内で）がどのように二重にエスケープされる必要があるかに注意してください—一度目は元の解析時にアンパサンドが保持されるため、二度目はサンドボックス化されたコンテンツを解析する際にアンパサンドが誤解釈されないようにするためです。

さらに、DOCTYPEがiframe srcdocドキュメントではオプションであり、html、head、およびbody要素には開始タグと終了タグが省略可能であり、title要素もiframe srcdocドキュメントではオプションであることに注意してください。そのため、srcdoc属性内のマークアップは、ドキュメント全体を表現しているにもかかわらず、比較的簡潔にすることができます。これは、body要素の内容のみが文法に直接記述される必要があり、他の要素は暗黙的に存在しているからです。

HTML構文では、著者はU+0022引用符文字（"）を使用して属性の内容を囲み、その後にすべてのU+0026アンパサンド（&）およびU+0022引用符（"）文字をエスケープし、さらに安全なコンテンツ埋め込みを保証するためにsandbox属性を指定することを覚えておくだけで済みます。（引用符の前にアンパサンドをエスケープし、引用符が&quot;となり、&amp;quot;にならないようにすることを忘れないでください。）

XMLでは、U+003C小なり記号（<）もエスケープする必要があります。属性値の正規化を防ぐために、XMLのいくつかの空白文字、特にU+0009タブ（tab）、U+000Aラインフィード（LF）、およびU+000Dキャリッジリターン（CR）もエスケープする必要があります。[XML]

src属性とsrcdoc属性が両方指定されている場合、srcdoc属性が優先されます。これにより、srcdoc属性をサポートしないレガシーユーザーエージェントのために、フォールバックURLを提供できます。

insertedNode を指定したiframe HTML要素接続後ステップは次のとおりです。

  1. insertedNode のために新しい子ナビゲーション可能オブジェクトを作成します。

  2. insertedNode がsandbox属性を持つ場合、属性の値とinsertedNodeのiframeサンドボックスフラグセットを指定して、サンドボックスディレクティブを解析します。

  3. initialInsertion をtrueに設定して、insertedNode のiframe属性を処理します。

iframeのHTML要素削除ステップは、removedNodeを指定して子ナビゲーブルを破壊することです。

これは、unloadイベントが発生せずに行われます （要素のコンテンツドキュメントは破壊されますが、unloadされるわけではありません）。

iframeはシャドウツリー内で処理されますが、 上記に従い、その動作のいくつかの側面はシャドウツリーに関して明確に定義されていません。詳細はissue #763を参照してください。

iframe 要素に非nullのナビゲーション可能なコンテンツがあり、 srcdoc属性が設定、変更、または削除された場合、 ユーザーエージェントはiframe属性を処理しなければなりません。

同様に、非nullのナビゲーション可能なコンテンツを持ち、srcdoc属性が指定されていないiframe要素において、 src属性が設定、変更、または削除された場合、 ユーザーエージェントはiframe属性を処理しなければなりません。

elementに対してiframe属性を処理するには、 任意のブール値initialInsertion （デフォルトはfalse）を指定します:

  1. もしelementのsrcdoc 属性が 指定されている場合:

    1. elementの現在のナビゲーションは遅延ロードされていたブール値をfalseに設定します。

    2. 要素を遅延ロードするかどうかのステップをelementに対して実行し、trueを返す場合は:

      1. elementの遅延ロード再開ステップを、このアルゴリズムのsrcdocリソースへナビゲートというラベルのステップから始めるように設定します。

      2. elementの現在のナビゲーションは遅延ロードされていたブール値をtrueに設定します。

      3. elementのために遅延ロード要素のインターセクション監視を開始します。

      4. 終了します。

    3. srcdocリソースへナビゲート: element、about:srcdoc、空文字列、およびelementのsrcdoc属性の値を指定してiframeまたはframeをナビゲートします。

      生成されたDocumentはiframe srcdocドキュメントと見なさなければなりません。

  2. それ以外の場合:

    1. elementとinitialInsertionを指定してiframeおよびframe要素の共有属性処理ステップを実行し、その結果をurlに設定します。

    2. もしurlがnullであれば、終了します。

    3. urlがabout:blankと一致し、initialInsertionがtrueである場合:

      1. elementを指定してiframeロードイベントステップを実行します。

      2. 終了します。

    4. elementのreferrerpolicy コンテンツ属性の現在の状態をreferrerPolicyに設定します。

    5. elementの現在のナビゲーションは遅延ロードされていたブール値をfalseに設定します。

    6. 要素を遅延ロードするかどうかのステップをelementに対して実行し、trueを返す場合:

      1. elementの遅延ロード再開ステップを、このアルゴリズムのnavigateというラベルのステップから始めるように設定します。

      2. elementの現在のナビゲーションは遅延ロードされていたブール値をtrueに設定します。

      3. elementのために遅延ロード要素のインターセクション監視を開始します。

      4. 終了します。

    7. ナビゲート: element、url、およびreferrerPolicyを指定してiframeまたはframeをナビゲートします。

elementおよびブール値initialInsertionを指定してiframeおよびframe要素の共有属性処理ステップを実行するには:

  1. urlをURLレコードのabout:blankに設定します。

  2. elementにsrc属性が指定されており、その値が空文字列でない場合:

    1. その属性の値をelementのノードドキュメントに対して相対的にURLをエンコーディングして解析します結果をmaybeURLに設定します。

    2. もしmaybeURLが失敗でない場合、urlをmaybeURLに設定します。

  3. elementのノードナビゲーブルの包括的先祖ナビゲーブルに、urlを等しいと見なせるアクティブドキュメントを持つナビゲーブルが含まれている場合、nullを返します。

  4. urlがabout:blankと一致し、 initialInsertionがtrueである場合、elementのナビゲーション可能なコンテンツのアクティブドキュメントとurlを指定してURLおよび履歴更新ステップを実行します。

    これは、urlがabout:blank?fooのようなものである場合に必要です。もしurlが単なるabout:blankである場合、これは何もしません。

  5. urlを返します。

要素 element、URL url、リファラーポリシー referrerPolicy、オプションの文字列または null の srcdocString（デフォルトは null）、およびオプションのブール値 initialInsertion（デフォルトは false）を指定して iframe または frame をナビゲートする には：

  1. historyHandlingを"auto"に設定します。

  2. elementのナビゲーション可能なコンテンツのアクティブドキュメントが完全にロードされていない場合、 historyHandlingを"replace"に設定します。

  3. もしelementがiframeである場合、 elementの保留中のリソースタイミング開始時間を elementのノードドキュメントの関連するグローバルオブジェクトを指定して現在の高解像度時間に設定します。

  4. element のコンテンツナビゲーション可能を url へ、element のノードドキュメントを使用してナビゲートします。historyHandling は historyHandling に、referrerPolicy は referrerPolicy に、documentResource は srcdocString に、そして initialInsertion は initialInsertion に設定します。

各Documentにはiframeロード進行中フラグとiframeロードミュートフラグがあります。Documentが作成されたとき、これらのフラグはそのDocumentに対して未設定でなければなりません。

elementを指定してiframeロードイベントステップを実行するには:

  1. アサート: elementのナビゲーション可能なコンテンツがnullでないこと。

  2. childDocumentをelementのナビゲーション可能なコンテンツのアクティブドキュメントに設定します。

  3. もしchildDocumentがそのiframeロードミュートフラグを設定している場合、終了します。

  4. elementの保留中のリソースタイミング開始時間が nullでない場合:

    1. elementのノードドキュメントの 関連するグローバルオブジェクトをglobalに設定します。

    2. globalを指定してフェッチタイミング情報を新たに作成し、 開始時間をelementの 保留中のリソースタイミング開始時間 に設定し、応答終了時間を globalを指定して現在の高解像度時間に設定します。

    3. fallbackTimingInfo、url、 "iframe"、 global、空文字列、新しい 応答本文情報、および0を指定してリソースタイミングをマークします。

    4. elementの保留中のリソースタイミング開始時間 をnullに設定します。

  5. childDocumentのiframeロード進行中フラグを設定します。

  6. elementでloadという名前のイベントを発生させます。

  7. childDocumentのiframeロード進行中フラグを解除します。

これは、スクリプティングと組み合わせることで、ローカルネットワークのHTTPサーバーのURLスペースを探索するために使用できます。ユーザーエージェントは、この攻撃を軽減するために、上記よりも厳しいクロスオリジンアクセス制御ポリシーを実装することがありますが、残念ながらそのようなポリシーは通常、既存のウェブコンテンツとの互換性がありません。

要素タイプがロードイベントを遅延させる可能性がある場合、そのタイプの各要素elementについて、ユーザーエージェントは、elementのナビゲーション可能なコンテンツが非nullであり、次のいずれかが当てはまる場合、そのelementのノードドキュメントのロードイベントを遅延させます:

elementのナビゲーション可能なコンテンツが再びナビゲートされると、loadイベントの処理中にそのロードイベントがさらに遅延します。

iframe 要素には、 現在のナビゲーションが遅延ロードされたブール値が関連付けられており、初期状態ではfalseです。これは、iframe属性を処理するアルゴリズムで設定および解除されます。

iframe 要素の 現在のナビゲーションが遅延ロードされたブール値がfalseの場合、その要素はロードイベントを遅延させる可能性があります。

iframe 要素には、 nullまたはDOMHighResTimeStamp保留中のリソースタイミング開始時間が関連付けられており、初期状態ではnullに設定されています。

要素が作成されたとき、srcdoc属性が設定されておらず、 src属性が 設定されていないか、設定されていてもその値が解析できない場合、 要素のナビゲーション可能なコンテンツは、初期のabout:blankのDocumentに留まります。

ユーザーがこのページからナビゲートした場合、 iframeのナビゲーション可能なコンテンツのアクティブWindowProxyオブジェクトは新しいWindowオブジェクトを新しいDocumentオブジェクトにプロキシしますが、src属性は変更されません。

name属性が存在する場合、その値は有効なナビゲーションターゲット名でなければなりません。指定された値は、コンテンツナビゲーションが存在する場合に、その要素の名前として使用されます。

Element/iframe#attr-sandbox

すべての現行エンジンでサポートされています。

Firefox17+Safari5+Chrome4+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

sandbox属性が指定されている場合、iframe内にホストされるコンテンツに追加の制限が適用されます。その値は、順不同の一意なスペース区切りトークンのセットでなければなりません。これらのトークンはASCIIケースインセンシティブでなければなりません。指定可能な値は以下の通りです:

この属性が設定されると、コンテンツは不透明なオリジンからのものであると見なされ、フォーム、スクリプト、および潜在的に迷惑なAPIが無効になり、リンクは他のナビゲーブルをターゲットにすることができなくなります。allow-same-originキーワードは、コンテンツが不透明なオリジンに強制されるのではなく、その実際のオリジンからのものであると見なされるようにします。allow-top-navigationキーワードは、コンテンツがそのトラバースナビゲーブルをナビゲートできるようにします。また、allow-top-navigation-by-user-activationキーワードは、同様の動作をしますが、ブラウジングコンテキストのアクティブウィンドウが一時的なアクティベーションを持つ場合にのみ、そのようなナビゲーションを許可します。allow-top-navigation-to-custom-protocolsキーワードは、非フェッチスキームへのナビゲーションを外部ソフトウェアに引き渡すことを再度有効にします。そして、allow-forms、allow-modals、allow-orientation-lock、allow-pointer-lock、allow-popups、allow-presentation、allow-scripts、およびallow-popups-to-escape-sandboxキーワードは、それぞれフォーム、モーダルダイアログ、画面の向きロック、ポインタロックAPI、ポップアップ、プレゼンテーションAPI、スクリプト、およびサンドボックス化されていない補助ブラウジングコンテキストの作成を再度有効にします。allow-downloadsキーワードは、コンテンツがダウンロードを実行できるようにします。[POINTERLOCK] [SCREENORIENTATION] [PRESENTATION]

allow-top-navigationおよびallow-top-navigation-by-user-activationキーワードは、両方とも指定してはいけません。このような非準拠のマークアップでは、allow-top-navigationのみが効果を持ちます。

同様に、allow-top-navigation-to-custom-protocolsキーワードは、allow-top-navigationまたはallow-popupsのいずれかが指定されている場合には指定してはいけません。これは冗長です。

サンドボックス化されたコンテンツ内でalert()、confirm()、およびprompt()を許可するには、allow-modalsおよびallow-same-originキーワードを両方指定する必要があり、読み込まれたURLが同一オリジンであり、トップレベルのオリジンと一致する必要があります。allow-same-originキーワードがないと、コンテンツは常にクロスオリジンとして扱われ、クロスオリジンコンテンツはシンプルダイアログを表示できません。

allow-scriptsとallow-same-originキーワードを、埋め込まれたページがページコンテンツと同一オリジンである場合に一緒に設定すると、埋め込まれたページは単にsandbox属性を削除して自分自身をリロードするだけで、事実上サンドボックスを完全に回避することができます。

これらのフラグは、iframe要素のコンテンツナビゲーブルがナビゲートされるときにのみ効果を発揮します。これらを削除したり、sandbox属性全体を削除しても、すでにロードされているページには影響を与えません。

潜在的に危険なファイルは、iframe要素を含むファイルと同じサーバーから提供されるべきではありません。攻撃者がユーザーを直接その悪意のあるコンテンツに誘導することができる場合、サンドボックス化はほとんど役に立ちません。悪意のあるHTMLコンテンツによって引き起こされる可能性のある被害を制限するために、それは専用の別のドメインから提供されるべきです。異なるドメインを使用することで、ユーザーがそのページに直接アクセスするようにだまされた場合でも、ファイル内のスクリプトがサイトを攻撃できなくなります。これは、sandbox属性の保護なしで実行される可能性があるからです。

iframe 要素の sandbox 属性が設定または変更され、それが null でない コンテンツナビゲーブル を持っている場合、ユーザーエージェントは サンドボックスディレクティブを解析 し、その属性の値とその iframe 要素の iframe サンドボックスフラグセット を基に処理を行います。

iframe 要素の sandbox 属性が削除され、それが null でない コンテンツナビゲーブル を持っている場合、ユーザーエージェントはその iframe 要素の iframe サンドボックスフラグセット を空にする必要があります。

この例では、完全に未知の、潜在的に危険な、ユーザー提供の HTML コンテンツがページに埋め込まれています。別のドメインから提供されているため、通常のクロスサイト制限が適用されます。さらに、埋め込まれたページはスクリプト、プラグイン、フォームが無効化されており、自身以外のフレームやウィンドウ（または自身が埋め込んだフレームやウィンドウ）をナビゲートすることはできません。 

<p>We're not scared of you! Here is your content, unedited:</p>
<iframe sandbox src="https://usercontent.example.net/getusercontent.cgi?id=12193"></iframe>

攻撃者がユーザーを直接そのページに誘導しようとする場合、ページがサイトのオリジンのコンテキストで実行されないように、別のドメインを使用することが重要です。これにより、ページ内で発見された攻撃に対してユーザーが脆弱になるのを防ぎます。

この例では、別のサイトからのガジェットが埋め込まれています。ガジェットにはスクリプトとフォームが有効で、オリジンサンドボックスの制限が解除され、ガジェットがその起源サーバーと通信できるようになっています。それでもサンドボックスは有効であり、プラグインやポップアップが無効化されているため、ユーザーがマルウェアやその他の迷惑なものにさらされるリスクが軽減されます。 

<iframe sandbox="allow-same-origin allow-forms allow-scripts"
src="https://maps.example.com/embedded.html"></iframe>

ファイル A に次の断片が含まれていたとします:

<iframe sandbox="allow-same-origin allow-forms" src=B></iframe>

ファイル B にも iframe が含まれていたとします:

<iframe sandbox="allow-scripts" src=C></iframe>

さらに、ファイル C にリンクが含まれていたとします:

<a href=D>Link</a>

この例では、すべてのファイルがtext/htmlとして提供されていると仮定します。

このシナリオでは、ページ C にはすべてのサンドボックスフラグが設定されています。スクリプトは無効になっています。これは、A の iframe でスクリプトが無効になっているためであり、これにより B の allow-scripts キーワードが上書きされます。フォームも無効になっています。これは、B の内部の iframe が allow-forms キーワードを持っていないためです。

今、A のスクリプトが A と B のすべての sandbox 属性を削除したと仮定します。これにより、すぐには何も変わりません。ユーザーが C のリンクをクリックし、ページ D を B の iframe にロードすると、ページ D は B の iframe に allow-same-origin および allow-forms キーワードが設定されていたかのように動作します。なぜなら、それはページ B が読み込まれたときの A の コンテンツナビゲーブル の状態だったからです。

一般的に言って、動的に sandbox 属性を削除または変更することはお勧めできません。なぜなら、何が許可され、何が許可されないかを論理的に判断することが非常に難しくなる可能性があるからです。

allow 属性が指定された場合、コンテナポリシー が決定され、それが 権限ポリシー として使用されます。これは、Document が iframe の コンテンツナビゲーブル 内で初期化されるときに適用されます。その値は、シリアライズされた権限ポリシーである必要があります。[PERMISSIONSPOLICY]

この例では、iframe を使用して、オンラインナビゲーションサービスから地図を埋め込んでいます。allow 属性は、ネストされたコンテキスト内で Geolocation API を有効にするために使用されています。

<iframe src="https://maps.example.com/" allow="geolocation"></iframe>

allowfullscreen 属性は、ブール属性です。指定されている場合、Document オブジェクトが iframe 要素の コンテンツナビゲーブル 内で初期化されるときに、「fullscreen」機能が任意の オリジン から使用できるようにすることを示します。これは、権限ポリシー属性を処理する アルゴリズムによって強制されます。[PERMISSIONSPOLICY]

ここでは、iframe を使用して、ビデオサイトからプレイヤーを埋め込んでいます。allowfullscreen 属性は、プレイヤーがビデオをフルスクリーンで表示できるようにするために必要です。

<article>
<header>
<p><img src="/usericons/1627591962735"> <b>Fred Flintstone</b></p>
<p><a href="/posts/3095182851" rel=bookmark>12:44</a> — <a href="#acl-3095182851">Private Post</a></p>
</header>
<p>Check out my new ride!</p>
<iframe src="https://video.example.com/embed?id=92469812" allowfullscreen></iframe>
</article>

allow 属性および allowfullscreen 属性は、iframe 要素の コンテンツナビゲーブル 内の機能にアクセスできるようにすることはできません。その要素の ノードドキュメント が既にその機能の使用を許可されていない場合、これらの属性は機能しません。

Document オブジェクト document がポリシー制御機能 feature を 使用することを許可されている かどうかを判断するには、以下のステップを実行します:

  1. document の ブラウジングコンテキスト が null の場合、false を返します。

  2. document が 完全にアクティブ でない場合、false を返します。

  3. 機能がドキュメントで有効であり、オリジンに対して有効である かどうかを feature 、document 、および document の オリジン で確認し、その結果が "有効" であれば、true を返します。

  4. false を返します。

これらの属性は、コンテンツナビゲーブルのアクティブドキュメントにおける権限ポリシーにのみ影響を与えるため、allowおよびallowfullscreen属性は、iframeのコンテンツナビゲーブルがナビゲートされたときにのみ効果を発揮します。これらの属性を追加または削除しても、既に読み込まれたドキュメントには影響を与えません。

iframe要素は、埋め込みコンテンツが特定の寸法を持つ場合（例：広告ユニットが明確に定義された寸法を持つ場合）に、寸法属性をサポートしています。

iframe要素には、フォールバックコンテンツが含まれることはなく、指定された初期コンテンツが正常に使用されるかどうかにかかわらず、常に新しい子ナビゲーブルを作成します。

referrerpolicy属性は、リファラーポリシー属性です。その目的は、リファラーポリシーを設定することで、iframe属性の処理時に使用されます。[REFERRERPOLICY]

loading属性は、遅延読み込み属性です。その目的は、ビューポート外にあるiframe要素の読み込みポリシーを示すことです。

loading属性の状態がEager状態に変更されたとき、ユーザーエージェントは次のステップを実行する必要があります：

  1. resumptionStepsを、iframe要素の遅延読み込み再開ステップとします。

  2. もしresumptionStepsがnullである場合は、何も返しません。

  3. iframeの遅延読み込み再開ステップをnullに設定します。

  4. resumptionStepsを実行します。

iframe要素の子孫は何も表しません。（iframe要素をサポートしていないレガシーユーザーエージェントでは、コンテンツがマークアップとして解析され、フォールバックコンテンツとして機能する可能性があります。）

HTMLパーサーは、iframe要素内のマークアップをテキストとして扱います。

HTMLIFrameElement/src

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

src、name、sandbox、およびallowIDL属性は、それぞれのコンテンツ属性と同名のコンテンツ属性を反映しなければなりません。

HTMLIFrameElement/srcdoc

すべての現在のエンジンでサポートされています。

Firefox25+Safari6+Chrome20+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

srcdocのゲッターステップは次のとおりです：

  1. attributeを、名前空間およびローカル名で属性を取得する結果とします。null、srcdocのローカル名、およびthisを指定します。

  2. もしattributeがnullであれば、空の文字列を返します。

  3. attributeの値を返します。

srcdocのセッターステップは次のとおりです：

  1. compliantStringを、TrustedHTML、thisの関連するグローバルオブジェクト、与えられた値、"HTMLIFrameElement srcdoc"、および"script"を指定して、信頼されたタイプの準拠文字列を取得するアルゴリズムを呼び出す結果とします。

  2. 属性値を設定するを使用し、this、srcdocのローカル名、およびcompliantStringを指定します。

サポートされているトークンは、sandboxのDOMTokenListに対して定義された許可された値と、ユーザーエージェントがサポートしている値です。

allowFullscreenIDL属性は、同名のコンテンツ属性を反映しなければなりません。

HTMLIFrameElement/referrerPolicy

すべての現在のエンジンでサポートされています。

Firefox50+Safari14+Chrome52+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

referrerPolicyIDL属性は、同名のコンテンツ属性を反映しなければならず、既知の値のみに制限されます。

loadingIDL属性は、同名のコンテンツ属性を反映しなければならず、既知の値のみに制限されます。

HTMLIFrameElement/contentDocument

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

contentDocumentゲッターステップは、thisのコンテンツドキュメントを返すことです。

HTMLIFrameElement/contentWindow

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

contentWindowゲッターステップは、thisのコンテンツウィンドウを返すことです。

ここでは、iframeを使用して広告仲介業者から広告を表示するページの例を示します： 

<iframe src="https://ads.example.com/?customerid=923513721&amp;format=banner"
 width="468" height="60"></iframe>

4.8.6 embed要素

Element/embed

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLEmbedElement

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリー:
フローコンテンツ。
フレージングコンテンツ。
埋め込みコンテンツ。
インタラクティブコンテンツ。
実体コンテンツ。
この要素が使用できるコンテキスト:
埋め込みコンテンツが期待される場所。
コンテンツモデル:
何もない。
text/htmlにおけるタグ省略:
終了タグはありません。
コンテンツ属性:
グローバル属性
src — リソースのアドレス
type — 埋め込まれたリソースのタイプ
width — 水平方向の寸法
height — 垂直方向の寸法
名前空間のないその他の属性（本文参照）。
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
interface HTMLEmbedElement : HTMLElement {
  [HTMLConstructor] constructor();

  [CEReactions] attribute USVString src;
  [CEReactions] attribute DOMString type;
  [CEReactions] attribute DOMString width;
  [CEReactions] attribute DOMString height;
  Document? getSVGDocument();

  // 古いメンバーも持つ
};

embed要素は、外部アプリケーションやインタラクティブコンテンツの統合ポイントを提供します。

src属性は、埋め込まれるリソースのURLを指定します。この属性が存在する場合、有効な空でないURL（スペースで囲まれている可能性あり）を含めなければなりません。

itemprop属性がembed要素に指定されている場合、src属性も指定されなければなりません。

type属性が存在する場合、プラグインを選択するために使用されるMIMEタイプを指定します。この値は有効なMIMEタイプ文字列でなければなりません。type属性とsrc属性が共に存在する場合、type属性は、src属性によって指定されたリソースの明示的なコンテンツタイプメタデータと同じタイプを指定しなければなりません。

以下のいずれかの条件が発生している場合、その要素に対してインスタンス化されたプラグインは削除され、embed要素は何も表しません：

embed要素は、以下の条件がすべて同時に満たされるときに潜在的にアクティブであると言われます：

embed要素が潜在的にアクティブではなかったが、潜在的にアクティブになる時、または潜在的にアクティブな状態を維持し続け、src属性が設定され、変更され、または削除された場合、またはtype属性が設定され、変更され、または削除された場合、ユーザーエージェントは、その要素に対して要素タスクをキューに追加し、その要素のために embed要素のセットアップ手順を実行する必要があります。

embed要素のセットアップ手順は、指定されたembed要素elementに対して以下のように行われます:

  1. 他のタスクがその後、elementのためにembed要素のセットアップ手順を実行するためにキューに追加された場合は、終了します。

  2. elementにsrc属性が設定されている場合、次の手順を実行します：

    1. urlを、elementのsrc属性の値をelementのノードドキュメントに対して相対的にURLのエンコード解析を行うことによって得られる結果にします。

    2. urlが失敗であれば、終了します。

    3. requestを新しいリクエストとし、そのURLをurl、クライアントをelementのノードドキュメントの関連設定オブジェクト、宛先を「embed」、資格情報モードを「include」、モードを「navigate」、発起人タイプを「embed」、URL資格情報フラグを設定したものにします。

    4. requestをフェッチし、レスポンスの処理を、レスポンス responseに対して以下の手順を設定して実行します：

      1. 他のタスクがその後、elementのためにembed要素のセットアップ手順を実行するためにキューに追加された場合は、終了します。

      2. responseがネットワークエラーである場合、elementにloadという名前のイベントを発火させ、終了します。

      3. typeをelementとresponseに基づいてコンテンツのタイプを決定する結果にします。

      4. typeに応じてスイッチします：

        null

        1. elementに対してプラグインを表示しないことを行います。

        それ以外

        1. elementのコンテンツナビゲーブルがnullであれば、elementのために新しい子ナビゲーブルを作成します。

        2. elementのコンテンツナビゲーブルを、responseのURLに、elementのノードドキュメントを使用して、レスポンスをresponseに設定し、履歴処理を「replace」に設定してナビゲートします。

          elementのsrc属性は、コンテンツナビゲーブルが他の場所にさらにナビゲートされた場合には更新されません。

        3. elementは今やそのコンテンツナビゲーブルを表しています。

      リソースのフェッチは、elementのノードドキュメントのロードイベントを遅らせる必要があります。

  3. それ以外の場合、elementに対してプラグインを表示しないことを行います。

コンテンツのタイプを、指定されたembed要素elementとレスポンスresponseに基づいて決定するには、次の手順を実行します:

  1. elementにtype属性があり、その属性の値がプラグインがサポートするタイプである場合、その値を返します。

  2. responseのパスコンポーネントがURLに含まれており、それがプラグインがサポートするパターンと一致する場合、そのプラグインが処理できるタイプを返します。

    例えば、あるプラグインは、パスコンポーネントが「.swf」で終わるURLを処理できると主張するかもしれません。

  3. responseに明示的なコンテンツタイプメタデータがあり、その値がプラグインがサポートするタイプである場合、その値を返します。

  4. nullを返します。

上記のアルゴリズムが、responseにokステータスがない場合でも、responseを許可するのは意図的です。これにより、サーバーはエラーレスポンス（例：HTTP 500内部サーバーエラーコード）を持っていても、プラグインデータを返すことができます。

embed要素に対してプラグインを表示しない方法は以下の通りです:

  1. elementに対して子ナビゲーブルを破壊します。

  2. elementに対してプラグインが見つからなかったことを示すインジケータを表示し、その内容をelementとして表示します。

  3. elementは何も表さなくなります。

embed要素にはフォールバックコンテンツがなく、その子孫は無視されます。

embed要素が潜在的にアクティブでなくなると、その要素に対してインスタンス化されたプラグインはアンロードされなければなりません。

embed要素はロードイベントを遅らせる可能性があります。

embed要素は寸法属性をサポートします。

srcおよびtypeというIDL属性は、それぞれ同名のコンテンツ属性を反映しなければなりません。

4.8.7 object 要素

Element/object

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLObjectElement

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
埋め込みコンテンツ。
リスト フォーム関連要素。
触知可能なコンテンツ。
この要素が使用できるコンテキスト:
埋め込みコンテンツが期待される場所。
コンテンツモデル:
透明。
text/html におけるタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
data — リソースのアドレス
type — 埋め込まれたリソースのタイプ
name — コンテンツナビゲーブルの名前
form — フォーム要素と関連付ける
width — 水平方向の寸法
height — 垂直方向の寸法
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
[Exposed=Window]
interface HTMLObjectElement : HTMLElement {
  [HTMLConstructor] constructor();

  [CEReactions] attribute USVString data;
  [CEReactions] attribute DOMString type;
  [CEReactions] attribute DOMString name;
  readonly attribute HTMLFormElement? form;
  [CEReactions] attribute DOMString width;
  [CEReactions] attribute DOMString height;
  readonly attribute Document? contentDocument;
  readonly attribute WindowProxy? contentWindow;
  Document? getSVGDocument();

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  boolean reportValidity();
  undefined setCustomValidity(DOMString error);

  // 古いメンバーも持つ
};

object要素によってインスタンス化されたコンテンツのタイプに応じて、このノードは他のインターフェースもサポートします。

object要素は、外部リソースを表すことができ、そのリソースのタイプに応じて、画像として扱われるか、子ナビゲーブルとして扱われます。

data属性は、リソースのURLを指定します。この属性は必須であり、有効な空でない URL（スペースで囲まれている可能性あり）を含まなければなりません。

type属性が存在する場合、リソースのタイプを指定します。存在する場合、この属性は有効な MIME タイプ文字列でなければなりません。

name属性が存在する場合、有効なナビゲーブルターゲット名でなければなりません。指定された値は、要素のコンテンツナビゲーブルの名前に使用され、適用可能であれば、要素のコンテンツナビゲーブルが作成されるときに存在します。

次のいずれかの条件が発生するとき:

...ユーザーエージェントは、object要素に対して、次の手順を実行してその要素が何を表すかを（再）決定するために要素タスクをキューに追加する必要があります。このタスクがキューに追加されるか、または実行中である場合は、要素のノードドキュメントのロードイベントを遅らせる必要があります。

  1. ユーザーがこのobject要素の通常の動作の代わりにフォールバックコンテンツを表示するように指定した場合、以下のフォールバックとラベル付けされたステップにジャンプします。

    例えば、ユーザーがそのコンテンツがよりアクセスしやすい形式を使用しているために、要素のフォールバックコンテンツの表示を要求することがあります。

  2. 要素に先祖となるメディア要素がある場合、または先祖となるobject要素があり、それがフォールバックコンテンツを表示していない場合、または要素が文書内にあり、そのブラウジングコンテキストがnullでない場合、あるいは要素のノード文書が完全にアクティブでない場合、または要素がオープン要素のスタックの中にまだある場合、または要素がレンダリングされていない場合は、以下のフォールバックとラベル付けされたステップにジャンプします。

  3. もしdata属性が存在し、その値が空でない場合：

    1. もしtype属性が存在し、その値がユーザーエージェントがサポートしていないタイプである場合、ユーザーエージェントは実際のタイプを調べるためにコンテンツを取得することなく、以下のフォールバックとラベル付けされたステップにジャンプできます。

    2. urlを、data属性の値と要素のノード文書に基づいて、URLをエンコーディング解析することで得られた結果とします。

    3. もしurlが失敗した場合、イベントをerrorという名前で要素に対して発生させ、以下のフォールバックとラベル付けされたステップにジャンプします。

    4. requestを新しいリクエストとし、そのurlをURLとし、クライアントは要素のノード文書の関連設定オブジェクトとし、デスティネーションは"object"とし、認証モードは"include"とし、モードは"navigate"とし、イニシエータータイプは"object"とし、URLクレデンシャルを使用するフラグが設定されているとします。

    5. リクエストをフェッチします。

      リソースの取得は、リソースが取得された後にネットワーキングタスクソースによってキューに入れられたタスクが実行されるまで、要素のノードドキュメントのロードイベントを遅延させる必要があります。

    6. リソースがまだ利用できない場合（例：リソースがキャッシュにないため、リソースのロードにネットワーク上でリクエストが必要である場合）、以下のフォールバックとラベル付けされたステップにジャンプします。リソースが利用可能になるとネットワーキングタスクソースによってキューに入れられるタスクは、このステップからアルゴリズムを再開する必要があります。リソースは断続的にロードでき、ユーザーエージェントは十分なデータが取得されたときにリソースを「利用可能」と見なすオプションがあります。

    7. ロードが失敗した場合（例：HTTP 404エラー、DNSエラーがあった場合）、イベントをerrorという名前で要素に対して発生させ、その後、以下のフォールバックとラベル付けされたステップにジャンプします。

    8. 次の手順でresource typeを決定します：

      1. resource typeを不明にします。

      2. ユーザーエージェントがこのリソースのContent-Typeヘッダーを厳密に遵守するように設定されている場合、およびリソースに関連するContent-Typeメタデータがある場合、resource typeをリソースのContent-Typeメタデータに指定されているタイプとし、以下のハンドラーとラベル付けされたステップにジャンプします。

        これにより、サイトが特定のタイプを使用してリソースを埋め込もうとしているが、リモートサイトがそれを上書きし、代わりにユーザーエージェントに異なるタイプのコンテンツを提供し、異なるセキュリティ特性を持つ可能性があるという脆弱性が生じる可能性があります。

      3. 次のリストから適切な一連の手順を実行します：

        リソースに関連するContent-Typeメタデータがある場合

        1. binaryをfalseに設定します。

        2. リソースのContent-Typeメタデータに指定されているタイプが"text/plain"であり、リソースに対してテキストまたはバイナリかを区別するルールを適用した結果、リソースがtext/plainでない場合、binaryをtrueに設定します。

        3. リソースのContent-Typeメタデータに指定されているタイプが"application/octet-stream"である場合、binaryをtrueに設定します。

        4. もしbinaryがfalseであれば、resource typeをリソースのContent-Typeメタデータに指定されているタイプにし、以下のハンドラーとラベル付けされたステップにジャンプします。

        5. もしtype属性が存在し、かつその値がapplication/octet-streamでない場合、以下の手順を実行します：

          1. もしその属性の値が、"image/"で始まり、かつresource typeが不明の場合、resource typeをtype属性に指定されているタイプとします。

          2. 以下のハンドラーとラベル付けされたステップにジャンプします。

        リソースに関連するContent-Typeメタデータがない場合

        1. もしtype属性が存在する場合、tentative typeをtype属性に指定されているタイプとします。

          そうでない場合、tentative typeをリソースの計算されたタイプとします。

        2. もしtentative typeがapplication/octet-streamでない場合、resource typeをtentative typeとし、以下のハンドラーとラベル付けされたステップにジャンプします。

      4. 指定されたリソースのURLパーサーアルゴリズムを適用した結果（リダイレクト後）として、URLレコードが、パスコンポーネントと一致するパターンを持つ場合、resource typeをそのプラグインが処理できるタイプとします。

        例えば、プラグインが".swf"で終わるパスコンポーネントを持つリソースを処理できると指定する場合があります。

      このステップが完了するか、上記のサブステップのいずれかが次のステップに直接ジャンプすることで、resource typeが依然として不明である可能性があります。いずれの場合でも、次のステップでフォールバックがトリガーされます。

    9. ハンドラー: 次のケースのうち最初に一致するものとしてコンテンツを処理します：

      リソースタイプがXML MIMEタイプである場合、またはリソースタイプが"image/"で始まらない場合

      もしobject要素のコンテンツナビゲーブルがnullである場合、その要素のために新しい子ナビゲーブルを作成します。

      response を、フェッチからのレスポンスとします。

      responseのURLがabout:blankと一致しない場合、要素のノードドキュメントを使用して、historyHandlingを「replace」に設定して、要素のコンテンツナビゲーション可能オブジェクトをresponseのURLにナビゲートします。

      要素のコンテンツナビゲーブルが他の場所にさらにナビゲートされた場合でも、要素のdata属性は更新されません。

      object要素はそのコンテンツナビゲーブルを表します。

      リソースタイプが"image/"で始まり、画像サポートが無効化されていない場合

      object要素に対して子ナビゲーブルを破壊します。

      画像のスニッフィングルールを適用して画像のタイプを決定します。

      object要素は指定された画像を表します。

      もし画像が不正であるか、またはサポートされていないフォーマットであるためにレンダリングできない場合は、以下のフォールバックとラベル付けされたステップにジャンプします。

      それ以外の場合

      指定されたresource typeはサポートされていません。以下のフォールバックとラベル付けされたステップにジャンプします。

      前のステップがresource type不明のまま終了した場合、これはトリガーされるケースです。

    10. 要素の内容はobject要素が表すものの一部ではありません。

    11. もしobject要素がそのコンテンツナビゲーブルを表していない場合、リソースが完全にロードされた後で、DOM操作タスクソースに要素タスクをキューし、要素に対してloadという名前のイベントを発生させます。

      もし要素がそのコンテンツナビゲーブルを表している場合、作成されたDocumentが完全にロードが完了したときに同様のタスクがキューに入れられます。

    12. 戻ります。

  4. フォールバック: object要素はその子要素を表します。これは要素のフォールバックコンテンツです。要素に対して子ナビゲーブルを破壊します。

上述のアルゴリズムにより、object要素の内容は、参照されたリソースが表示できない場合（例：404エラーが発生した場合）にのみ使用されるフォールバックコンテンツとして機能します。これにより、複数のobject要素を入れ子にして、それぞれ異なる能力を持つユーザーエージェントをターゲットにすることができ、ユーザーエージェントはサポートする最初のものを選択します。

object要素はロードイベントを遅延させる可能性があります。

form属性は、object要素をフォームの所有者と明示的に関連付けるために使用されます。

object要素は、寸法属性をサポートしています。

HTMLObjectElement/data

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLObjectElement/type

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLObjectElement/name

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

IDL属性data、type、およびnameは、それぞれ同名のコンテンツ属性を反映する必要があります。

HTMLObjectElement/contentDocument

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

contentDocumentゲッターステップは、thisのコンテンツドキュメントを返すことです。

HTMLObjectElement/contentWindow

すべての現在のエンジンでサポートされています。

Firefox22+Safari13+Chrome53+
Opera?Edge79+
Edge (Legacy)17+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

contentWindowゲッターステップは、thisのコンテンツウィンドウを返すことです。

willValidate、validity、validationMessage属性、およびcheckValidity()、reportValidity()、setCustomValidity()メソッドは、制約検証APIの一部です。formIDL属性は、要素のフォームAPIの一部です。

この例では、object要素を使用してHTMLページが別のページに埋め込まれています。 

<figure>
  <object data="clock.html"></object>
  <figcaption>My HTML Clock</figcaption>
 </figure>

4.8.8 video要素

Element/video

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLVideoElement

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
カテゴリ:
フローコンテンツ
フレージングコンテンツ
埋め込みコンテンツ
要素がcontrols属性を持つ場合: インタラクティブコンテンツ
パルパブルコンテンツ
この要素が使用される文脈:
埋め込みコンテンツが予期される場所
コンテンツモデル:
要素がsrc属性を持つ場合:
ゼロまたはそれ以上のtrack要素、その後透明、ただし、メディア要素の子孫は含まれない。
要素がsrc属性を持たない場合: ゼロまたはそれ以上のsource要素、その後ゼロまたはそれ以上のtrack要素、その後透明、ただし、メディア要素の子孫は含まれない。
text/htmlでのタグ省略:
いずれのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
src — リソースのアドレス
crossorigin — クロスオリジンリクエストの処理方法
poster — ビデオ再生前に表示するポスターフレーム
preload — メディアリソースが必要とするバッファリングのヒント
autoplay — ページが読み込まれたときに自動的にメディアリソースを開始できることを示唆する
playsinline — ユーザーエージェントに、ビデオコンテンツを要素の再生エリア内に表示することを促す
loop — メディアリソースをループ再生するかどうか
muted — メディアリソースをデフォルトでミュートするかどうか
controls — ユーザーエージェントコントロールを表示するかどうか
width — 水平次元
height — 垂直次元
アクセシビリティの考慮事項:
著者向け
実装者向け
DOMインターフェース:
[Exposed=Window]
 interface HTMLVideoElement : HTMLMediaElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute unsigned long width;
   [CEReactions] attribute unsigned long height;
   readonly attribute unsigned long videoWidth;
   readonly attribute unsigned long videoHeight;
   [CEReactions] attribute USVString poster;
   [CEReactions] attribute boolean playsInline;
 };

video要素は、ビデオや映画、字幕付きのオーディオファイルを再生するために使用されます。

video要素内にコンテンツを提供することができますが、ユーザーエージェントはこのコンテンツをユーザーに表示しないようにすべきです。このコンテンツは、video要素をサポートしていない古いウェブブラウザ向けであり、そのような古いブラウザのユーザーに対してビデオコンテンツにアクセスする方法を知らせるためにテキストが表示されます。

特に、このコンテンツはアクセシビリティの問題を解決することを目的としているわけではありません。視覚障害者、聴覚障害者、そしてその他の身体的または認知的障害を持つ人々にビデオコンテンツをアクセス可能にするために、さまざまな機能が利用可能です。キャプションは、ビデオストリームに埋め込まれるか、track要素を使用して外部ファイルとして提供できます。手話トラックはビデオストリームに埋め込むことができます。音声説明はビデオストリームに埋め込むか、WebVTTファイルを使用してテキスト形式で提供し、ユーザーエージェントによって音声合成されることもあります。WebVTTは、チャプタータイトルの提供にも使用できます。メディア要素をまったく使用したくないユーザー向けに、video要素の近くの文中でリンクを使用して、トランスクリプトやその他のテキスト代替を提供することもできます。[WEBVTT]

video要素は、メディア要素であり、そのメディアデータは表面的にはビデオデータであり、関連するオーディオデータが含まれる可能性があります。

src、crossorigin、preload、autoplay、loop、muted、controls属性は、すべてのメディア要素に共通の属性です。

poster属性は、ユーザーエージェントがビデオデータが利用できない間に表示できる画像ファイルのURLを指定します。この属性が存在する場合、その内容は有効な非空のURLで、スペースで囲まれている可能性があります。

指定されたリソースが使用される場合、要素が作成されるとき、またはposter属性が設定、変更、または削除されたときに、ユーザーエージェントは次の手順を実行して、要素のポスターフレームを決定しなければなりません（要素のポスターフラグの値に関係なく）。

  1. このvideo要素に対して実行中のインスタンスが存在する場合、そのインスタンスを中断し、ポスターフレームを変更せずに終了します。

  2. poster属性の値が空文字列であるか、または属性が存在しない場合、ポスターフレームはありません。終了します。

  3. 属性の値を相対して、URLのエンコーディングと解析の結果をurlとします。要素のノード文書に相対して。

  4. もしurlが失敗した場合、終了します。ポスターフレームはありません。

  5. requestを新しいリクエストとし、URLをurl、クライアントを要素のノード文書の関連する設定オブジェクト、宛先をimage、発信元タイプをvideo、資格情報モードをinclude、URL資格情報フラグを設定します。

  6. リクエストをフェッチします。これにより、要素のロードイベントを遅延させる必要があります。要素のノード文書の。

  7. 画像が取得できた場合、その画像がポスターフレームとなります。それ以外の場合、ポスターフレームは存在しません。

poster属性で指定された画像、つまりポスターフレームは、ビデオの代表的なフレーム（通常は最初の非空白のフレーム）であり、ビデオの概要をユーザーに伝えることを目的としています。

playsinline属性はブール属性です。この属性が存在する場合、それはユーザーエージェントに対するヒントとして機能し、ビデオをデフォルトでドキュメント内で「インライン」で表示し、要素の再生エリアに制約され、フルスクリーンや独立したリサイズ可能なウィンドウで表示されることはありません。

playsinline属性が存在しないからといって、ビデオがデフォルトでフルスクリーンで表示されることを意味するわけではありません。実際、ほとんどのユーザーエージェントはデフォルトでビデオをすべてインラインで再生することを選択しており、そのようなユーザーエージェントではplaysinline属性には何の効果もありません。

video 要素は、以下のリストで最初に一致する条件に対して、指定された内容を表します。

ビデオデータが利用できない場合（要素の readyState 属性が HAVE_NOTHING または HAVE_METADATA であり、ビデオデータがまだ全く取得されていない場合、または要素の readyState 属性が以降のいずれかの値であるが、メディアリソース にビデオチャンネルがない場合）
video 要素は、存在する場合は ポスターフレーム を表し、それ以外の場合は 透明な黒 を表し、自然な寸法 はありません。
video 要素が 一時停止中 で、現在の再生位置 がビデオの最初のフレームであり、要素の ポスターフラグを表示 が設定されている場合
video 要素は、存在する場合は ポスターフレーム を表し、それ以外の場合はビデオの最初のフレームを表します。
video 要素が 一時停止中 で、現在の再生位置 に対応するビデオのフレームが利用できない場合（例えば、ビデオがシーク中またはバッファリング中である場合）
video 要素が 再生中である可能性 も 一時停止中 でもない場合（例えば、シーク中または停止中の場合）
video 要素は、最後にレンダリングされたビデオのフレームを表します。
video 要素が 一時停止中 の場合
video 要素は、現在の再生位置 に対応するビデオのフレームを表します。
その他（video 要素にビデオチャンネルがあり、再生中である可能性がある場合）
video 要素は、連続的に増加する 現在の位置 のフレームを表します。現在の再生位置 が変わり、最後にレンダリングされたフレームがビデオの 現在の再生位置 に対応しなくなった場合、新しいフレームがレンダリングされなければなりません。

ビデオのフレームは、選択されたビデオトラック から取得される必要があります。イベントループ が最後に ステップ1 に到達したときに選択されたトラックです。

ビデオストリーム内の特定の再生位置に対応するフレームは、ビデオストリームの形式によって定義されます。

video 要素は、テキストトラックのキュー をも 表します。テキストトラックキューアクティブフラグ が設定され、テキストトラック が 表示モード になっている場合、そして メディアリソース のオーディオも現在の再生位置において表します。

メディアリソース に関連付けられたオーディオは、再生される場合、現在の再生位置 に同期して再生される必要があります。ユーザーエージェントは、イベントループ が最後にステップ1に到達したときに有効化されたオーディオトラックからオーディオを再生しなければなりません。

さらに、ユーザーエージェントは、ビデオ上または要素の再生エリアの他の領域にテキストやアイコンを重ねたり、その他の適切な方法で、"バッファリング中"、"ビデオがロードされていません"、"エラー"、またはより詳細な情報などのメッセージをユーザーに提供することができます。

ビデオをレンダリングできないユーザーエージェントは、代わりに要素を外部のビデオ再生ユーティリティへのリンクやビデオデータ自体 を表すようにすることができます。

video 要素の メディアリソース にビデオチャンネルがある場合、要素は、ペイントソース を提供します。このソースの幅は メディアリソース の自然幅、高さは メディアリソース の 自然高さ であり、その見た目は、利用可能な場合は 現在の再生位置 に対応するビデオのフレームの外観であり、そうでない場合（例えば、ビデオがシーク中またはバッファリング中である場合）、以前の外観であり、それも利用できない場合（例えば、ビデオが最初のフレームをロード中であるため）には、黒である場合があります。

video.videoWidth

HTMLVideoElement/videoWidth

すべての現在のエンジンでサポートされています。

Firefox3.5+ Safari3.1+ Chrome3+
Opera10.5+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS3+ Chrome Android? WebView Android37+ Samsung Internet? Opera Android11+
video.videoHeight

HTMLVideoElement/videoHeight

すべての現在のエンジンでサポートされています。

Firefox3.5+ Safari3.1+ Chrome3+
Opera10.5+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS3+ Chrome Android? WebView Android37+ Samsung Internet? Opera Android11+

これらの属性は、ビデオの自然な寸法を返すか、寸法が不明な場合は0を返します。

自然な幅と自然な高さは、メディアリソースの寸法を、リソースの寸法、アスペクト比、クリンアパーチャ、解像度などを考慮した後のCSS ピクセルでの寸法として定義されます。アナモルフィックフォーマットがビデオデータの寸法にアスペクト比をどのように適用するかを定義していない場合、ユーザーエージェントは、1つの寸法を増加させ、もう1つの寸法を変更せずに比率を適用する必要があります。

videoWidth IDL属性は、ビデオの自然な幅をCSS ピクセルで返す必要があります。videoHeight IDL属性は、ビデオの自然な高さをCSS ピクセルで返す必要があります。要素のreadyState属性がHAVE_NOTHINGの場合、属性は0を返す必要があります。

ビデオの自然な幅または自然な高さが変更された場合（たとえば、選択されたビデオトラックが変更されたため）、要素のreadyState属性がHAVE_NOTHINGでない場合、ユーザーエージェントはメディア要素タスクをキューに入れる必要があり、イベントを発火し、resizeという名前のイベントをメディア要素で発生させる必要があります。

video要素は、寸法属性をサポートしています。

特定のスタイルルールがない場合、ビデオコンテンツは要素の再生エリア内で最大サイズで中央に表示され、ビデオコンテンツのアスペクト比が維持されるようにレンダリングされるべきです。したがって、再生エリアのアスペクト比がビデオのアスペクト比と一致しない場合、ビデオはレターボックスまたはピラーボックス形式で表示されます。要素の再生エリアのビデオを含まない部分は、何も表さないことを意味します。

CSSを実装しているユーザーエージェントでは、上記の要件は、レンダリングセクションで提案されているスタイルルールを使用することで実装できます。

自然な幅は、video要素の再生エリアのポスターフレームが利用可能であり、要素が現在そのポスターフレームを表している場合、そのポスターフレームの自然な幅です。そうでない場合は、ビデオリソースの自然な幅です。ビデオリソースが利用可能でない場合、自然な幅は失われます。

自然な高さは、video要素の再生エリアのポスターフレームが利用可能であり、要素が現在そのポスターフレームを表している場合、そのポスターフレームの自然な高さです。そうでない場合は、ビデオリソースの自然な高さです。ビデオリソースが利用可能でない場合、自然な高さは失われます。

デフォルトのオブジェクトサイズは、幅300 CSSピクセル、高さ150 CSSピクセルです。[CSSIMAGES]

ユーザーエージェントは、クローズドキャプション、音声説明トラック、およびビデオストリームに関連するその他の追加データの表示を有効または無効にするコントロールを提供すべきですが、これらの機能はページの通常のレンダリングを妨げないようにすべきです。

ユーザーエージェントは、ユーザーにより適した方法でビデオコンテンツを表示できるようにするかもしれません。たとえば、フルスクリーンや独立したサイズ変更可能なウィンドウで表示することができます。ユーザーエージェントは、ビデオの再生時にデフォルトでこのような表示モードをトリガーすることもできますが、playsinline属性が指定されている場合はそうすべきではありません。他のユーザーインターフェイス機能と同様に、これを有効にするコントロールは、ユーザーエージェントがユーザーインターフェイスをユーザーに公開している場合を除き、ページの通常のレンダリングを妨げるべきではありません。ただし、このような独立した表示モードでは、controls属性がない場合でも、ユーザーエージェントは完全なユーザーインターフェイスを表示することができます。

ユーザーエージェントは、ビデオ再生中にスクリーンセーバーを無効にするなど、ユーザーの体験を妨げる可能性のあるシステム機能にビデオ再生が影響を与えることを許可する場合があります。

poster IDL属性は、posterコンテンツ属性を反映する必要があります。

playsInline IDL属性は、playsinlineコンテンツ属性を反映する必要があります。

次の例は、ビデオが正しく再生されなかった場合を検出する方法を示しています。

<script>
  function failed(e) {
    // ビデオの再生が失敗した場合 - なぜかを示すメッセージを表示する
    switch (e.target.error.code) {
      case e.target.error.MEDIA_ERR_ABORTED:
        alert('ビデオの再生が中止されました。');
        break;
      case e.target.error.MEDIA_ERR_NETWORK:
        alert('ネットワークエラーにより、ビデオのダウンロードが途中で失敗しました。');
        break;
      case e.target.error.MEDIA_ERR_DECODE:
        alert('ビデオの再生が、破損問題やブラウザがサポートしていない機能を使用したため中止されました。');
        break;
      case e.target.error.MEDIA_ERR_SRC_NOT_SUPPORTED:
        alert('サーバーまたはネットワークが失敗したか、形式がサポートされていないため、ビデオをロードできませんでした。');
        break;
      default:
        alert('不明なエラーが発生しました。');
        break;
    }
  }
 </script>
 <p><video src="tgif.vid" autoplay controls onerror="failed(event)"></video></p>
 <p><a href="tgif.vid">ビデオファイルをダウンロード</a>.</p>

4.8.9 audio 要素

要素/audio

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (旧バージョン)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android3+Samsung Internet?Opera Android11+

HTMLAudioElement

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (旧バージョン)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
埋め込みコンテンツ.
この要素にcontrols属性がある場合: インタラクティブコンテンツ.
この要素にcontrols属性がある場合: パルパブルコンテンツ.
この要素が使用できるコンテキスト:
埋め込みコンテンツが期待される場所。
コンテンツモデル:
要素にsrc属性がある場合: 0個以上のtrack要素、その後 透過的だが、メディア要素の子孫は含まない。
要素にsrc属性がない場合: 0個以上の source要素、その後 0個以上のtrack要素、その後 透過的だが、メディア要素の子孫は含まない。
text/htmlでのタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
src — リソースのアドレス
crossorigin — クロスオリジンリクエストの処理方法
preload — メディアリソースが必要とするバッファリングの量を示唆します
autoplay — ページが読み込まれたときにメディアリソースを自動的に再生できることを示唆します
loop — メディアリソースをループ再生するかどうか
muted — デフォルトでメディアリソースをミュートするかどうか
controls — ユーザーエージェントのコントロールを表示する
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOMインターフェース: 
[Exposed=Window,
LegacyFactoryFunction=Audio(optional DOMString src)]
interface HTMLAudioElement : HTMLMediaElement {
[HTMLConstructor] constructor();
};

audio要素は、音声またはオーディオストリームを表します。

audio要素の中にコンテンツを提供することができます。ユーザーエージェントはこのコンテンツをユーザーに表示すべきではありません。これは、audioをサポートしない古いウェブブラウザ向けであり、これらの古いブラウザのユーザーに音声コンテンツにアクセスする方法を知らせるためのテキストを表示することを目的としています。

特に、このコンテンツはアクセシビリティの問題に対処するためのものではありません。聴覚障害者やその他の身体的・認知的障害を持つ人々のために、音声コンテンツをアクセシブルにするためのさまざまな機能が利用可能です。キャプションや手話ビデオが利用可能な場合、video要素を使用して音声を再生し、ユーザーが視覚的な代替手段を有効にできるようにすることができます。章のタイトルをtrack要素とWebVTTファイルを使用して提供し、ナビゲーションを支援することができます。また、もちろん、トランスクリプトやその他のテキストによる代替手段をaudio要素の近くの文章で単にリンクすることで提供することができます。[WEBVTT]

audio要素は、メディア要素であり、そのメディアデータは表向きにはオーディオデータです。

src、crossorigin、preload、autoplay、loop、muted、およびcontrols属性は、すべてのメディア要素に共通する属性です。

audio = new Audio([ url ])

HTMLAudioElement/Audio

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome4+
Opera12.1+Edge79+
Edge (旧バージョン)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

audio要素を返し、適用可能な場合は引数に渡された値をsrc属性に設定します。

HTMLAudioElementオブジェクトを作成するためのレガシーファクトリ関数が提供されています（DOMからのファクトリメソッドに加えて、例えばcreateElement()などです）。Audio(src)。レガシーファクトリ関数が呼び出された場合、次の手順を実行する必要があります:

  1. documentを現在のグローバルオブジェクトの関連するDocumentとする。

  2. audio を、document、「audio」、およびHTML名前空間を指定して要素を作成した結果とします。

  3. 属性値を設定するaudioのために"preload"と"auto"を使用する。

  4. もしsrcが与えられた場合、属性値を設定するaudioのために"src"とsrcを用いる。（これにより、オブジェクトのリソース選択アルゴリズムを返す前にユーザーエージェントが呼び出すことを引き起こす）

  5. audioを返す。

4.8.10 track要素

Element/track

すべての現在のエンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android25+WebView Android?Samsung Internet?Opera Android12.1+

HTMLTrackElement

すべての現在のエンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
カテゴリ:
なし。
この要素が使用できるコンテキスト:
メディア要素の子として、フローコンテンツの前に。
コンテンツモデル:
なし。
text/htmlでのタグ省略:
終了タグはなし。
コンテンツ属性:
グローバル属性
kind — テキストトラックの種類
src — リソースのアドレス
srclang — テキストトラックの言語
label — ユーザーに見えるラベル
default — 他のテキストトラックがより適切でない場合にトラックを有効にする
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
interface HTMLTrackElement : HTMLElement {
  [HTMLConstructor] constructor();

  [CEReactions] attribute DOMString kind;
  [CEReactions] attribute USVString src;
  [CEReactions] attribute DOMString srclang;
  [CEReactions] attribute DOMString label;
  [CEReactions] attribute boolean default;

  const unsigned short NONE = 0;
  const unsigned short LOADING = 1;
  const unsigned short LOADED = 2;
  const unsigned short ERROR = 3;
  readonly attribute unsigned short readyState;

  readonly attribute TextTrack track;
};

track要素は、メディア要素に対して、外部の明示的なタイミング付きテキストトラックを指定するために使用されます。この要素自体は何も表しません。

kind属性は、列挙属性であり、次のキーワードと状態を持ちます:

キーワード 状態 簡単な説明
subtitles 字幕 音声が利用可能であるが理解できない場合（例：ユーザーがメディアリソースの音声トラックの言語を理解しない場合）に適した対話の文字起こしまたは翻訳。ビデオ上に重ねて表示されます。
captions キャプション 音声が利用できないか、はっきり聞こえない場合に適した対話、効果音、関連する音楽の手がかり、およびその他の関連する音声情報の文字起こしまたは翻訳（例：音声がミュートされている場合や、周囲の騒音によってかき消されている場合、またはユーザーが聴覚障害者である場合）。ビデオ上に重ねて表示され、聴覚障害者向けに適切にラベル付けされます。
descriptions 説明 ビデオコンポーネントが隠れている、利用できない、または使用できない場合に音声合成用に意図されたメディアリソースのビデオコンポーネントのテキスト説明（例：ユーザーが画面を見ないでアプリケーションを操作している場合や、ユーザーが盲目である場合）。音声として合成されます。
chapters チャプターメタデータ スクリプトから使用されることを意図したトラック。ユーザーエージェントによって表示されません。
metadata メタデータ

属性の欠落値デフォルトは字幕状態であり、無効値デフォルトはメタデータ状態です。

src属性は、テキストトラックデータのURLを指定します。値は有効な非空のURLであり、スペースで囲まれている場合があります。この属性は必須です。

この要素には関連付けられたトラックURL（文字列）があり、初期状態は空の文字列です。

要素のsrc属性が設定されたとき、次の手順を実行します:

  1. trackURLを失敗に設定します。

  2. valueを要素のsrc属性の値に設定します。

  3. valueが空でない場合、trackURLを、要素のノードドキュメントに対してvalueを与えた場合のURLのエンコード、パース、およびシリアライズの結果に設定します。

  4. 要素のトラックURLをtrackURLに設定します。失敗でない場合はそれに設定し、それ以外の場合は空の文字列に設定します。

要素のトラックURLがWebVTTリソースを識別し、要素のkind属性がチャプターメタデータまたはメタデータ状態にない場合、WebVTTファイルはキューテキストを使用するWebVTTファイルである必要があります。[WEBVTT]

srclang属性は、テキストトラックデータの言語を指定します。値は有効なBCP 47言語タグである必要があります。この属性は、要素のkind属性が字幕状態にある場合は必須です。[BCP47]

要素がsrclang属性を持ち、その値が空でない場合、要素のトラック言語はその属性の値です。それ以外の場合、要素にはトラック言語がありません。

label属性は、ユーザーが読みやすいトラックのタイトルを指定します。このタイトルは、ユーザーエージェントがそのユーザーインターフェイスで字幕、キャプション、および音声説明トラックを一覧表示する際に使用されます。

label属性の値は、属性が存在する場合、空の文字列であってはなりません。また、同じメディア要素の子であり、kind属性が同じ状態にある、track要素が2つあってはなりません。また、それらのsrclang属性が欠落しているか、同じ言語を表す値を持ち、それらのlabel属性が再び両方とも欠落しているか、同じ値を持っている場合も同様です。

要素が空でないlabel属性を持っている場合、その要素のトラックラベルはその属性の値です。それ以外の場合、要素のトラックラベルは空の文字列です。

default属性はブール属性であり、指定されている場合、ユーザーの設定が他のトラックをより適切であると示さない限り、トラックが有効になることを示します。

メディア要素には、字幕状態またはキャプション状態にあるtrack要素の子が1つだけ存在し、そのdefault属性が指定されている必要があります。

メディア要素には、説明状態にあるtrack要素の子が1つだけ存在し、そのdefault属性が指定されている必要があります。

メディア要素には、チャプターメタデータ状態にあるtrack要素の子が1つだけ存在し、そのdefault属性が指定されている必要があります。

track要素のうち、kind属性がメタデータ状態にあり、default属性が指定されているものの数には制限がありません。

track.readyState

テキストトラックの準備状態を返します。これは、次のリストの数値で表されます:

track.NONE (0)
テキストトラックが読み込まれていない状態。
track.LOADING (1)
テキストトラックの読み込み中状態。
track.LOADED (2)
テキストトラックが読み込まれた状態。
track.ERROR (3)
テキストトラックの読み込みに失敗した状態。
track.track
TextTrackオブジェクトを返します。これは、track要素のテキストトラックに対応します。

readyState属性は、track要素のテキストトラックのテキストトラックの準備状態に対応する数値値を返さなければなりません。

NONE（数値値0）
テキストトラックが読み込まれていない状態。
LOADING（数値値1）
テキストトラックの読み込み中状態。
LOADED（数値値2）
テキストトラックが読み込まれた状態。
ERROR（数値値3）
テキストトラックの読み込みに失敗した状態。

trackIDL属性は、取得時に、track要素のテキストトラックに対応するTextTrackオブジェクトを返さなければなりません。

HTMLTrackElement/src

すべての現在のエンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

src, srclang, label, およびdefaultIDL属性は、同名のそれぞれのコンテンツ属性を反映しなければなりません。kindIDL属性は、同名のコンテンツ属性を反映しなければならず、既知の値のみに限定されます。

このビデオには、いくつかの言語の字幕があります:

<video src="brave.webm">
<track kind=subtitles src=brave.en.vtt srclang=en label="English">
<track kind=captions src=brave.en.hoh.vtt srclang=en label="English for the Hard of Hearing">
<track kind=subtitles src=brave.fr.vtt srclang=fr lang=fr label="Français">
<track kind=subtitles src=brave.de.vtt srclang=de lang=de label="Deutsch">
</video>

（最後の2つのlang属性は、字幕自体の言語ではなく、label属性の言語を示します。字幕の言語は、srclang属性によって指定されます。）

4.8.11 メディア要素

HTMLMediaElementオブジェクト（この仕様ではaudioおよびvideo）は、単にメディア要素として知られています。

HTMLMediaElement

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+ 
enum CanPlayTypeResult { "" /* empty string */, "maybe", "probably" };
 typedef (MediaStream or MediaSource or Blob) MediaProvider;
 
 [Exposed=Window]
 interface HTMLMediaElement : HTMLElement {
 
   // error state
   readonly attribute MediaError? error;
 
   // network state
   [CEReactions] attribute USVString src;
   attribute MediaProvider? srcObject;
   readonly attribute USVString currentSrc;
   [CEReactions] attribute DOMString? crossOrigin;
   const unsigned short NETWORK_EMPTY = 0;
   const unsigned short NETWORK_IDLE = 1;
   const unsigned short NETWORK_LOADING = 2;
   const unsigned short NETWORK_NO_SOURCE = 3;
   readonly attribute unsigned short networkState;
   [CEReactions] attribute DOMString preload;
   readonly attribute TimeRanges buffered;
   undefined load();
   CanPlayTypeResult canPlayType(DOMString type);
 
   // ready state
   const unsigned short HAVE_NOTHING = 0;
   const unsigned short HAVE_METADATA = 1;
   const unsigned short HAVE_CURRENT_DATA = 2;
   const unsigned short HAVE_FUTURE_DATA = 3;
   const unsigned short HAVE_ENOUGH_DATA = 4;
   readonly attribute unsigned short readyState;
   readonly attribute boolean seeking;
 
   // playback state
   attribute double currentTime;
   undefined fastSeek(double time);
   readonly attribute unrestricted double duration;
   object getStartDate();
   readonly attribute boolean paused;
   attribute double defaultPlaybackRate;
   attribute double playbackRate;
   attribute boolean preservesPitch;
   readonly attribute TimeRanges played;
   readonly attribute TimeRanges seekable;
   readonly attribute boolean ended;
   [CEReactions] attribute boolean autoplay;
   [CEReactions] attribute boolean loop;
   Promise<undefined> play();
   undefined pause();
 
   // controls
   [CEReactions] attribute boolean controls;
   attribute double volume;
   attribute boolean muted;
   [CEReactions] attribute boolean defaultMuted;
 
   // tracks
   [SameObject] readonly attribute AudioTrackList audioTracks;
   [SameObject] readonly attribute VideoTrackList videoTracks;
   [SameObject] readonly attribute TextTrackList textTracks;
   TextTrack addTextTrack(TextTrackKind kind, optional DOMString label = "", optional DOMString language = "");
 };

メディア要素属性であるsrc、crossorigin、preload、autoplay、loop、muted、およびcontrolsは、すべてのメディア要素に適用されます。それらはこのセクションで定義されています。

メディア要素は、音声データや、映像および音声データをユーザーに提示するために使用されます。これは、このセクションでメディアデータと呼ばれています。このセクションは、音声または映像のためのメディア要素に等しく適用されるためです。 メディアリソースという用語は、完全な映像ファイルや音声ファイルなど、メディアデータ全体を指すために使用されます。

メディアリソースには、"none"、"multiple"、"rewritten"、またはオリジン"のいずれかのオリジンが関連付けられています。それは初期状態では"none"に設定されています。

メディアリソースには、複数の音声および映像トラックが含まれることがあります。メディア要素の目的のために、メディアリソースの映像データは、要素のvideoTracks属性によって現在選択されているトラック（もしあれば）のみであり、イベントループが最後にステップ1に到達したときに適用されます。また、メディアリソースの音声データは、要素のaudioTracks属性によって現在有効になっているすべてのトラック（もしあれば）をミキシングした結果です。

audio要素とvideo要素の両方が、音声および映像のために使用されることがあります。主な違いは、audio要素には視覚コンテンツ（映像やキャプションなど）の再生エリアがないのに対し、video要素にはそれがあるという点です。

各メディア要素には、一意のメディア要素イベントタスクソースがあります。

あるメディア要素elementと一連のステップstepsに対してメディア要素タスクをキューに入れるには、要素タスクをキューに入れ、elementとstepsを指定して、メディア要素イベントタスクソースにタスクをキューに入れます。

4.8.11.1 エラーコード

MediaError

現在のすべてのエンジンでサポートされています。

Firefox4+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
media.error

HTMLMediaElement/error

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在のエラー状態を表すMediaErrorオブジェクトを返します。

エラーがない場合はnullを返します。

すべてのメディア要素には関連するエラーステータスがあり、これは、要素が最後にリソース選択アルゴリズムを呼び出して以来、発生した最後のエラーを記録します。error属性は、取得時に、この最後のエラーに対して作成されたMediaErrorオブジェクトを返すか、エラーがない場合はnullを返します。

[Exposed=Window]
 interface MediaError {
   const unsigned short MEDIA_ERR_ABORTED = 1;
   const unsigned short MEDIA_ERR_NETWORK = 2;
   const unsigned short MEDIA_ERR_DECODE = 3;
   const unsigned short MEDIA_ERR_SRC_NOT_SUPPORTED = 4;
 
   readonly attribute unsigned short code;
   readonly attribute DOMString message;
 };
media.error.code

MediaError/code

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在のエラーのエラーコードを以下のリストから返します。

media.error.message

MediaError/message

現在のすべてのエンジンでサポートされています。

Firefox52+Safari15+Chrome59+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

発生したエラー条件に関する特定の診断メッセージを返します。メッセージとメッセージ形式は、異なるユーザーエージェント間で一般的に一様ではありません。このようなメッセージが利用できない場合は、空の文字列が返されます。

すべてのMediaErrorオブジェクトには、文字列であるメッセージと、次のいずれかのコードがあります。

MEDIA_ERR_ABORTED（数値値 1）
メディアリソースの取得プロセスが、ユーザーの要求によりユーザーエージェントによって中止されました。
MEDIA_ERR_NETWORK（数値値 2）
ネットワークエラーが発生し、リソースが使用可能であると判断された後、メディアリソースの取得がユーザーエージェントによって停止されました。
MEDIA_ERR_DECODE（数値値 3）
リソースが使用可能であると判断された後、メディアリソースのデコード中にエラーが発生しました。
MEDIA_ERR_SRC_NOT_SUPPORTED（数値値 4）
src属性または割り当てられたメディアプロバイダーオブジェクトによって示されたメディアリソースが適切でありませんでした。

エラーコードが上記の値のいずれかであるMediaErrorを作成するには、指定されたエラーコードを持つ新しいMediaErrorオブジェクトを返します。このオブジェクトのコードは指定されたエラーコードであり、メッセージは、エラー条件の原因についてユーザーエージェントが提供できる詳細を含む文字列であるか、ユーザーエージェントがそのような詳細を提供できない場合は空の文字列です。このメッセージ文字列には、提供されたエラーコードを通じて既に利用可能な情報のみを含めるべきではありません。たとえば、コードを文字列形式に変換するだけではいけません。エラーコードで提供された情報以上の追加情報がない場合、メッセージは空の文字列に設定されなければなりません。

codeのgetterステップは、thisのコードを返します。

messageのgetterステップは、thisのメッセージを返します。

4.8.11.2 メディアリソースの場所

src コンテンツ属性は、メディア要素の表示するURLを指定します。この属性が存在する場合、有効な非空のURLが含まれている必要があります。

itemprop 属性がメディア要素に指定されている場合、src属性も指定されている必要があります。

crossorigin コンテンツ属性は、メディア要素のCORS設定属性です。

メディア要素がsrc属性を持って作成された場合、ユーザーエージェントは直ちにそのメディア要素のリソース選択アルゴリズムを呼び出す必要があります。

メディア要素のsrc属性が設定または変更された場合、ユーザーエージェントはそのメディア要素のメディア要素の読み込みアルゴリズムを呼び出す必要があります。 (src 属性を削除しても、source 要素が存在していても、これを実行することはできません。)

HTMLMediaElement/src

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

src IDL属性は、メディア要素のコンテンツ属性と同じ名前を反映する必要があります。

HTMLMediaElement/crossOrigin

すべての現在のエンジンでサポートされています。

Firefox22+Safari10+Chrome33+
Opera?Edge79+
Edge (Legacy)13+Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

crossOrigin IDL属性は、crossoriginコンテンツ属性を反映し、既知の値のみに制限される必要があります。

メディアプロバイダーオブジェクトは、メディアリソースをURLとは別に表現できるオブジェクトです。MediaStreamオブジェクト、MediaSourceオブジェクト、およびBlobオブジェクトは、すべてメディアプロバイダーオブジェクトです。

各メディア要素には、割り当てられたメディアプロバイダーオブジェクトを持つことができ、これはメディアプロバイダーオブジェクトです。メディア要素が作成されると、それには割り当てられたメディアプロバイダーオブジェクトはありません。

media.srcObject [ = source ]

HTMLMediaElement/srcObject

1つのエンジンのみでサポートされています。

Firefox🔰 42+Safari11+Chrome🔰 108+
Opera?Edge🔰 108+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

このプロパティを使用すると、メディア要素にメディアプロバイダーオブジェクトを割り当てることができます。

media.currentSrc

HTMLMediaElement/currentSrc

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在のURLのメディアリソースを返します。

メディアリソースがない場合、またはメディアリソースにURLがない場合は、空の文字列を返します。

currentSrc IDL属性は、最初に空の文字列に設定される必要があります。その値は、以下で定義されているリソース選択アルゴリズムによって変更されます。

srcObject IDL属性は、取得時に要素の割り当てられたメディアプロバイダーオブジェクトを返す必要があり、存在しない場合はnullを返します。設定時には、要素の割り当てられたメディアプロバイダーオブジェクトを新しい値に設定し、その後、要素のメディア要素の読み込みアルゴリズムを呼び出す必要があります。

メディアリソースを指定する方法は3つあります: srcObject IDL属性、src コンテンツ属性、およびsource要素です。IDL属性が優先され、次にコンテンツ属性、最後に要素が優先されます。

4.8.11.3 MIMEタイプ

メディアリソースは、そのタイプ、具体的にはMIMEタイプで説明されることがあります。一部のケースではcodecsパラメータが付いていることもあります。（codecsパラメータが許可されるかどうかはMIMEタイプによります。）[RFC6381]

タイプは通常、いくつかの点で不完全な説明です。例えば、"video/mpeg" はコンテナタイプしか示しておらず、"video/mp4; codecs="avc1.42E01E, mp4a.40.2"" のようなタイプでさえ、実際のビットレート（最大ビットレートのみ）などの情報は含まれていません。このため、あるタイプが与えられた場合、ユーザーエージェントは、そのタイプのメディアを再生できるかどうか（さまざまな信頼度で）を判断できる場合があり、またはそのタイプのメディアを絶対に再生できないことを判断できる場合もあります。

ユーザーエージェントが再生できないことを知っているタイプとは、例えばコンテナタイプを認識しない、または指定されたコーデックをサポートしていないために、リソースを確実にサポートしていないものを指します。

MIMEタイプ "application/octet-stream"（パラメータなし）は、決してユーザーエージェントが再生できないことを知っているタイプではありません。ユーザーエージェントは、そのタイプを、潜在的なメディアリソースをラベル付けする際に、明示的なContent-Typeメタデータが欠けているのと同等に扱う必要があります。

ここで特別扱いされるのは、パラメータのないMIMEタイプ "application/octet-stream" のみです。これにパラメータが含まれている場合、それは他のMIMEタイプと同様に扱われます。これは、未知のMIMEタイプのパラメータは無視すべきだというルールからの逸脱です。

media.canPlayType(type)

HTMLMediaElement/canPlayType

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

ユーザーエージェントが与えられたタイプのメディアリソースを再生できるかどうかに対する信頼度に基づいて、空の文字列（否定的な応答）、"maybe"、または"probably"を返します。

canPlayType(type) メソッドは、type がユーザーエージェントが再生できないことを知っているタイプである場合、または "application/octet-stream" タイプである場合、空の文字列を返さなければなりません。ユーザーエージェントがそのタイプがレンダリング可能であると自信を持っている場合には、"probably" を返さなければなりません。そうでなければ、"maybe" を返さなければなりません。実装者は、タイプがサポートされているかどうかを確実に確認できない限り、"maybe" を返すことを推奨します。一般的に、ユーザーエージェントは、codecsパラメータが存在しない場合、そのパラメータを許可するタイプに対して "probably" を返すべきではありません。

このスクリプトは、ユーザーエージェントが（架空の）新しいフォーマットをサポートしているかどうかをテストし、video要素を動的に使用するかどうかを決定します。

<section id="video">
  <p><a href="playing-cats.nfv">Download video</a></p>
 </section>
 <script>
  const videoSection = document.getElementById('video');
  const videoElement = document.createElement('video');
  const support = videoElement.canPlayType('video/x-new-fictional-format;codecs="kittens,bunnies"');
  if (support === "probably") {
    videoElement.setAttribute("src", "playing-cats.nfv");
    videoSection.replaceChildren(videoElement);
  }
 </script>

type属性は、source要素で、ユーザーエージェントがレンダリングできないフォーマットを使用するリソースのダウンロードを回避することができます。

4.8.11.4 ネットワーク状態
media.networkState

HTMLMediaElement/networkState

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android4+Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

要素の現在のネットワーク活動状態を、以下のリストに示すコードの中から返します。

メディア要素がネットワークとやり取りする際に、その現在のネットワーク活動は、networkState属性によって表されます。取得時に、次の値のいずれかを返さなければなりません:

NETWORK_EMPTY（数値 0）
要素はまだ初期化されていません。すべての属性は初期状態です。
NETWORK_IDLE（数値 1）
要素のリソース選択アルゴリズムがアクティブであり、リソースを選択していますが、現在ネットワークを実際には使用していません。
NETWORK_LOADING（数値 2）
ユーザーエージェントがデータのダウンロードを積極的に試みています。
NETWORK_NO_SOURCE（数値 3）
要素のリソース選択アルゴリズムがアクティブですが、まだ使用するリソースが見つかっていません。

リソース選択アルゴリズムは、networkState属性の値が変わる正確なタイミングと、この状態の変化を示すイベントがいつ発生するかを記述しています。

4.8.11.5 メディアリソースの読み込み
media.load()

HTMLMediaElement/load

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

要素をリセットし、新しいメディアリソースの選択と読み込みを最初から開始させます。

すべてのメディア要素には、自動再生可能フラグがあり、これは最初に true の状態で開始し、ロードイベントを遅延させるフラグがあり、これは最初に false の状態で開始する必要があります。ロードイベントを遅延させるフラグが true の場合、要素はそのドキュメントのロードイベントを遅延させる必要があります。

load()メソッドがメディア要素で呼び出されたとき、ユーザーエージェントはメディア要素の読み込みアルゴリズムを実行する必要があります。

メディア要素には、最初は false に設定されている関連するブール値の現在停止しているかどうかが存在します。

メディア要素の読み込みアルゴリズムは、次のステップで構成されています。

  1. この要素の現在停止しているかどうかを false に設定します。

  2. この要素に対して既に実行中のリソース選択アルゴリズムのインスタンスを中止します。

  3. pending tasksを、メディア要素のメディア要素イベントタスクソースからのすべてのタスクのリストにします。

  4. pending tasks内の、保留中の再生プロミスを解決するまたは保留中の再生プロミスを拒否するタスクに対しては、それらのプロミスをキューに入れられた順番に従って即座に解決または拒否します。

  5. pending tasks内の各タスクをそのタスクキューから削除します。

    基本的に、メディア要素が新しいリソースの読み込みを開始すると、保留中のイベントやコールバックが破棄され、解決/拒否が保留中のプロミスが即座に解決/拒否されます。

  6. メディア要素のnetworkStateがNETWORK_LOADINGまたはNETWORK_IDLEに設定されている場合、メディア要素タスクをキューに入れる必要があります。 イベントを発生させるという指定されたメディア要素に基づいて、abortという名前のイベントをメディア要素に発生させます。

  7. メディア要素のnetworkStateがNETWORK_EMPTYに設定されていない場合は、以下を実行します。

    1. メディア要素タスクをキューに入れるという指定されたメディア要素に基づいて、イベントを発生させるという作業を続けます。イベント名は、emptiedであり、対象のメディア要素です。

    2. もしメディア要素のフェッチプロセスが進行中であれば、ユーザーエージェントはそれを停止する必要があります。

    3. メディアプロバイダーオブジェクトがMediaSourceオブジェクトである場合、それをデタッチします。

    4. メディア要素のメディアリソース固有のトラックを忘れる。

    5. readyStateがHAVE_NOTHINGに設定されていない場合、それをその状態に設定します。

    6. もしpaused属性が false の場合、以下を実行します。

      1. paused属性を true に設定します。

      2. 保留中の再生プロミスを取得すると保留中の再生プロミスを拒否する、その結果と"AbortError"を持つDOMExceptionと共に拒否します。

    7. seekingが true の場合、それを false に設定します。

    8. 現在の再生位置を 0 に設定します。

      公式の再生位置を 0 に設定します。

      これにより公式の再生位置が変更された場合、メディア要素タスクをキューに入れるという指定されたメディア要素に基づいて、イベントを発生させるという作業を続けます。イベント名は、timeupdateです。

    9. タイムラインオフセットを NaN（Not-a-Number）に設定します。

    10. duration属性を NaN（Not-a-Number）に更新します。

      ユーザーエージェントは、この特定の期間の変更に対してdurationchangeイベントを発生させません。

  8. playbackRate属性をdefaultPlaybackRate属性の値に設定します。

  9. error属性を null に設定し、自動再生可能フラグを true に設定します。

  10. メディア要素のリソース選択アルゴリズムを呼び出します。

  11. この要素の以前の再生中のメディアリソースの再生は停止します。

メディア要素のリソース選択アルゴリズムは次のようになります。このアルゴリズムは常にタスクの一部として呼び出されますが、このアルゴリズムの最初のステップの一つは戻り、残りのステップを並行して実行し続けます。さらに、このアルゴリズムはイベントループのメカニズムと密接に連携しています。特に、同期セクションを持っており（これらはイベントループアルゴリズムの一部としてトリガーされます）。このようなセクション内のステップは⌛でマークされています。

  1. 要素のnetworkState属性をNETWORK_NO_SOURCEに設定します。

  2. 要素のポスター表示フラグを true に設定します。

  3. メディア要素のロードイベントを遅延させるフラグを true に設定します（これによりロードイベントが遅延します）。

  4. 安定した状態を待つことを行い、このアルゴリズムを呼び出したタスクが続行できるようにします。同期セクションは、このアルゴリズムの残りのすべてのステップで構成されており、アルゴリズムが同期セクションが終了したと通知するまで続きます。（同期セクション内のステップは⌛でマークされています。）

  5. ⌛ もしメディア要素のパーサーによってブロックされているフラグが false の場合、保留中のテキストトラックのリストを作成します。

  6. ⌛ もしメディア要素にメディアプロバイダーオブジェクトが割り当てられている場合、modeをobjectに設定します。

    ⌛ それ以外の場合、もしメディア要素にメディアプロバイダーオブジェクトが割り当てられていないが、src属性がある場合、modeをattributeに設定します。

    ⌛ それ以外の場合、もしメディア要素にメディアプロバイダーオブジェクトが割り当てられておらず、src属性もなく、source要素の子がある場合、modeをchildrenに設定し、candidateを最初のそのようなsource要素の子として木構造順で設定します。

    ⌛ それ以外の場合、メディア要素にはメディアプロバイダーオブジェクトが割り当てられておらず、src属性もなく、source要素の子もありません：

    1. ⌛networkStateをNETWORK_EMPTYに設定します。

    2. ⌛ 要素のロードイベントを遅延させるフラグを false に設定します。これにより、ロードイベントを遅延させることが停止します。

    3. 同期セクションを終了し、戻ります。

  7. ⌛メディア要素のnetworkState属性をNETWORK_LOADINGに設定します。

  8. ⌛メディア要素タスクをキューに入れるという指定されたメディア要素に基づいて、イベントを発生させるという作業を続けます。イベント名は、loadstartです。

  9. 以下のリストから適切なステップを実行します。

    もしmodeがobjectである場合

    1. ⌛currentSrc属性を空の文字列に設定します。

    2. 同期セクションを終了し、残りのステップを並行して続行します。

    3. リソースフェッチアルゴリズムを割り当てられたメディアプロバイダーオブジェクトと共に実行します。このアルゴリズムがこのアルゴリズムを中止せずに終了した場合、ロードは失敗します。

    4. メディアプロバイダーで失敗: このステップに到達したことは、メディアリソースの読み込みが失敗したことを示します。保留中の再生プロミスを取得するとメディア要素タスクをキューに入れるという指定されたメディア要素に基づいて、専用のメディアソース失敗ステップを実行します。

    5. 前のステップでキューに入れられたタスクが実行されるまで待ちます。

    6. 戻ります。このアルゴリズムが再度トリガーされるまで、要素は別のリソースの読み込みを試みません。

    もしmodeがattributeである場合

    1. ⌛src属性の値が空の文字列である場合、同期セクションを終了し、以下のattribute で失敗ステップに移動します。

    2. ⌛urlRecordをURL のエンコーディングと解析の結果に設定します。これは、最後に変更された際のsrc属性の値に基づいて、メディア要素のノードドキュメントに対して相対的に行われます。

    3. ⌛urlRecordが失敗でない場合、currentSrc属性をurlRecordにURL シリアライザを適用した結果に設定します。

    4. 同期セクションを終了し、残りのステップを並行して続行します。

    5. urlRecordが失敗でない場合、urlRecordを使用してリソースフェッチアルゴリズムを実行します。このアルゴリズムがこのアルゴリズムを中止せずに終了した場合、ロードは失敗します。

    6. attribute で失敗: このステップに到達したことは、メディアリソースの読み込みが失敗したか、urlRecordが失敗であることを示します。保留中の再生プロミスを取得するとメディア要素タスクをキューに入れるという指定されたメディア要素に基づいて、専用のメディアソース失敗ステップを実行します。

    7. 前のステップでキューに入れられたタスクが実行されるまで待ちます。

    8. 戻ります。このアルゴリズムが再度トリガーされるまで、要素は別のリソースの読み込みを試みません。

    その他 (modeがchildrenである場合)

    1. ⌛ pointer を、メディア要素の子リスト内の2つの隣接するノードによって定義される位置とします。リストの開始（リスト内の最初のノードの前、もしあれば）とリストの終了（リスト内の最後のノードの後、もしあれば）をそれ自体がノードであるとして扱います。一方のノードはpointerの前のノードであり、もう一方のノードはpointerの後のノードです。最初に、pointerをcandidateノードと次のノード（もしあれば）の間の位置、またはそれが最後のノードである場合はリストの終了とします。

      ノードがメディア要素に挿入、削除、および移動されると、pointerは次のように更新されなければなりません：

      pointerを定義する2つのノードの間に新しいノードが挿入または移動された場合
      pointerをpointerの前のノードと新しいノードの間の点とします。言い換えれば、pointerでの挿入はpointerの後に行われます。
      pointerの前のノードが削除された場合
      pointerをpointerの後のノードとpointerの後のノードの前のノードの間の点とします。言い換えれば、pointerは残りのノードに対して移動しません。
      pointerの後のノードが削除された場合
      pointerをpointerの前のノードとpointerの前のノードの後のノードの間の点とします。前のケースと同様に、pointerは残りのノードに対して移動しません。

      その他の変更はpointerに影響しません。

    2. ⌛ 候補を処理：candidateがsrc属性を持たない場合、またはそのsrc属性の値が空の文字列である場合、同期セクションを終了し、以下の要素で失敗ステップにジャンプします。

    3. ⌛ candidateが、その値が環境に一致しないmedia属性を持つ場合、同期セクションを終了し、以下の要素で失敗ステップにジャンプします。

    4. ⌛ urlRecordを、src属性が最後に変更されたときのcandidateのノードドキュメントを基準として、candidateのsrc属性の値を指定してURLをエンコード解析した結果とします。

    5. ⌛ urlRecordが失敗の場合、同期セクションを終了し、以下の要素で失敗ステップにジャンプします。

    6. ⌛ candidateが、その値がMIMEタイプとして解析されたとき（そのパラメータを定義するタイプについては、codecsパラメータによって記述されるコーデックを含む）、ユーザーエージェントがレンダリングできないとわかっているタイプを表すtype属性を持つ場合、同期セクションを終了し、以下の要素で失敗ステップにジャンプします。

    7. ⌛ currentSrc属性を、urlRecordにURLシリアライザを適用した結果に設定します。

    8. 同期セクションを終了し、残りのステップを並行して続行します。

    9. urlRecordを使用してリソースフェッチアルゴリズムを実行します。そのアルゴリズムがこれを中止せずに戻った場合、ロードは失敗しました。

    10. 要素で失敗：メディア要素を指定してメディア要素タスクをキューに入れ、candidateでerrorという名前のイベントを発火させます。

    11. 安定状態を待機します。同期セクションは、アルゴリズムが同期セクションが終了したと言うまで、このアルゴリズムの残りのすべてのステップで構成されます。（同期セクションのステップには⌛マークが付いています。）

    12. ⌛ メディア要素のメディアリソース固有のトラックを忘れます。

    13. ⌛ 次の候補を見つける：candidateをnullとします。

    14. ⌛ 検索ループ：pointerの後のノードがリストの終了である場合、以下の待機中ステップにジャンプします。

    15. ⌛ pointerの後のノードがsource要素である場合、candidateをその要素とします。

    16. ⌛ pointerを、pointerの前のノードが以前pointerの後ろにあったノードになり、pointerの後ろのノードが、もしあれば、以前pointerの後ろにあったノードの後ろのノードになるように進めます。

    17. ⌛ candidateがnullの場合、検索ループステップに戻ります。それ以外の場合は、候補を処理ステップに戻ります。

    18. ⌛ 待機中：要素のnetworkState属性をNETWORK_NO_SOURCE値に設定します。

    19. ⌛ 要素のポスター表示フラグをtrueに設定します。

    20. ⌛ メディア要素を指定してメディア要素タスクをキューに入れ、要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

    21. 同期セクションを終了し、残りのステップを並行して続行します。

    22. pointerの後のノードがリストの終了以外のノードになるまで待機します。（このステップは永遠に待機する可能性があります。）

    23. 安定状態を待機します。同期セクションは、アルゴリズムが同期セクションが終了したと言うまで、このアルゴリズムの残りのすべてのステップで構成されます。（同期セクションのステップには⌛マークが付いています。）

    24. ⌛ 要素のロードイベント遅延フラグをtrueに戻します（これにより、まだ発火されていない場合に備えて、ロードイベントが再び遅延されます）。

    25. ⌛ networkStateをNETWORK_LOADINGに戻します。

    26. ⌛ 上記の次の候補を見つけるステップに戻ります。

    プロミスのリストpromises を伴う専用メディアソース失敗ステップは、次のステップです。

    1. error属性をMediaErrorを作成する結果に設定し、MEDIA_ERR_SRC_NOT_SUPPORTEDを返します。

    2. メディア要素のメディアリソース固有のトラックを忘れる。

    3. 要素のnetworkState属性をNETWORK_NO_SOURCEに設定します。

    4. 要素のポスター表示フラグを true に設定します。

    5. イベントを発生させるという作業を続けます。イベント名は、errorであり、対象はメディア要素です。

    6. 保留中の再生プロミスを拒否するをpromisesと共に、"NotSupportedError"のDOMExceptionを使用して実行します。

    7. 要素のロードイベントを遅延させるフラグを false に設定します。これにより、ロードイベントを遅延させることが停止します。

与えられたメディア応答を検証するためには、応答 response、メディアリソース resource、および "entire resource" または (number, number or "until end") のタプル byteRange を与える必要があります。

  1. response がネットワークエラーの場合、falseを返します。

  2. byteRange が "entire resource" の場合、trueを返します。

  3. internalResponse を response の安全でない応答として設定します。

  4. internalResponse のステータスが200の場合、trueを返します。

  5. internalResponse のステータスが206でない場合、falseを返します。

  6. internalResponseからcontent-range 値を抽出する結果が失敗した場合、falseを返します。

    抽出された値は使用されず、特にbyteRangeと比較されません。このステップは、`Content-Range`ヘッダーの構文検証として機能しますが、応答の`Content-Range`値がリクエストの`Range`値と一致しない場合、それは失敗と見なされません。

  7. internalResponse のURLが null の場合、origin を "rewritten" に設定します。それ以外の場合は、internalResponse のURLのオリジンに設定します。

  8. previousOrigin をresourceのオリジンとして設定します。

  9. 以下のいずれかが真である場合：

    この場合、resource のオリジンをoriginに設定します。

    それ以外の場合、responseがCORS-クロスオリジンである場合は、falseを返します。

    それ以外の場合、resource のオリジンを"multiple"に設定します。

    これは、範囲ヘッダーを持つ不透明な応答が、異なるオリジンからの他の応答と一緒にパッチされることで情報が漏洩しないようにします。

  10. true を返します。

メディア要素 および指定された URL レコード または メディアプロバイダオブジェクト のための リソースフェッチアルゴリズム は次の通りです:

  1. mode をリモートとします。

  2. アルゴリズムがメディアプロバイダーオブジェクトで呼び出された場合、mode をローカルに設定します。

    それ以外の場合：

    1. object を、URLレコードのBLOB URLエントリとメディア要素のノードドキュメントの関連する設定オブジェクトを使用してBLOBオブジェクトを取得した結果とします。

    2. object がメディアプロバイダーオブジェクトである場合、mode をローカルに設定します。

  3. mode がリモートである場合、current media resource をこのアルゴリズムに渡されたURLレコードによって与えられるリソースとします。それ以外の場合、current media resource をメディアプロバイダーオブジェクトによって与えられるリソースとします。いずれにしても、current media resource は要素のメディアリソースになります。

  4. メディア要素の保留中のテキストトラックのリストから、すべてのメディアリソース固有のテキストトラックを削除します（もしあれば）。

  5. 次のリストから適切な手順を実行します：

    mode がリモートの場合

    1. オプションで、次のサブステップを実行します。これは、ユーザーエージェントがユーザーが明示的に要求するまでリソースのフェッチを試みないようにする場合（たとえば、preload属性のnoneキーワードを実装する方法として）の期待される動作です。

      1. networkStateをNETWORK_IDLEに設定します。

      2. メディア要素を指定してメディア要素タスクをキューに入れ、要素でsuspendという名前のイベントを発火させます。

      3. メディア要素を指定してメディア要素タスクをキューに入れ、要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

      4. タスクが実行されるのを待ちます。

      5. 実装定義のイベント（たとえば、ユーザーがメディア要素の再生開始を要求する）を待ちます。

      6. 要素のロードイベント遅延フラグをtrueに戻します（これにより、まだ発火されていない場合に備えて、ロードイベントが再び遅延されます）。

      7. networkStateをNETWORK_LOADINGに設定します。

    2. destination を、メディア要素がaudio要素である場合は「audio」、それ以外の場合は「video」とします。

    3. request を、current media resourceのURLレコード、destination、およびメディア要素のcrossoriginコンテンツ属性の現在の状態を指定して潜在的なCORSリクエストを作成した結果とします。

    4. requestのクライアントを、メディア要素のノードドキュメントの関連する設定オブジェクトに設定します。

    5. requestのイニシエータータイプをdestinationに設定します。

    6. byteRange（「entire resource」または（数値、数値または「until end」）タプル）を、メディアデータの欠落データを満たすために必要なバイト範囲とします。この値は実装定義であり、コーデック、ネットワーク条件、またはその他のヒューリスティックに依存する場合があります。ユーザーエージェントはリソースを完全にフェッチすることを決定する場合があり、その場合byteRangeは「entire resource」になります。バイトオフセットから最後までフェッチする場合、byteRangeは（数値、「until end」）になります。または、2つのバイトオフセット間の範囲をフェッチする場合、byteRangeは2つのオフセットを表す（数値、数値）タプルになります。

    7. byteRangeが「entire resource」でない場合：

      1. byteRange[1]が「until end」である場合、byteRange[0]を指定してrequestに範囲ヘッダーを追加します。

      2. それ以外の場合、byteRange[0]とbyteRange[1]を指定してrequestに範囲ヘッダーを追加します。

    8. レスポンスresponseを指定して、processResponseを次のステップに設定して、requestをフェッチします：

      1. globalをメディア要素のノードドキュメントの関連するグローバルオブジェクトとします。

      2. updateMediaを、メディア要素を指定してメディア要素タスクをキューに入れ、以下のメディアデータ処理ステップリストから最初の適切なステップを実行することとします。（この作業がネットワークタスクソースを使用するのではなく、適切なメディア要素イベントタスクソースに対して行われるように、このために新しいタスクが使用されます。）

      3. processEndOfMediaを次のステップとします：フェッチプロセスがメディアデータのデコードを含め、エラーなしで完了し、すべてのデータがネットワークアクセスなしでユーザーエージェントに利用可能である場合、ユーザーエージェントは以下の最終ステップに進まなければなりません。これは、ウェブラジオなどの無限のリソースをストリーミングする場合や、リソースがユーザーエージェントのデータキャッシュ能力よりも長い場合など、決して起こらない可能性があります。

      4. current media resourceとbyteRangeを指定してresponseを検証した結果がfalseである場合、これらのステップを中止します。

      5. それ以外の場合、updateMedia、processEndOfMedia、空のアルゴリズム、およびglobalを指定して、responseのボディを段階的に読み取ります。

      6. この方法で取得されたresponseの安全でないレスポンスの内容でメディアデータを更新します。responseはCORS同一オリジンまたはCORSクロスオリジンである可能性があります。これは、メディアデータで参照される字幕がAPIで公開されるかどうか、およびvideo要素の場合、ビデオが描画されるときにcanvasが汚染されるかどうかに影響します。

      メディア要素ストールタイムアウトは、実装定義の長さの時間であり、約3秒である必要があります。 メディアデータを積極的に取得しようとしているメディア要素が、メディア要素ストールタイムアウトに等しい期間データを受信できなかった場合、ユーザーエージェントはメディア要素を指定してメディア要素タスクをキューに入れ、次の処理を実行する必要があります：

      1. 要素でstalledという名前のイベントを発火させます。

      2. 要素の現在ストールしているをtrueに設定します。

      ユーザーエージェントは、ユーザーがメディアデータのダウンロードを選択的にブロックまたは遅くすることを許可する場合があります。 メディア要素のダウンロードが完全にブロックされた場合、ユーザーエージェントは（接続が閉じられたかのように動作するのではなく）ストールしたかのように動作する必要があります。ダウンロードの速度は、たとえば、同じ帯域幅を共有する他の接続とのバランスを取るために、ユーザーエージェントによって自動的に調整される場合もあります。

      ユーザーエージェントは、たとえば、1時間のメディアリソースの5分をバッファリングした後、ユーザーがリソースを再生するかどうかを決定するのを待っている間、インタラクティブリソースでユーザー入力を待っている間、またはユーザーがページから移動したときに、いつでもコンテンツをこれ以上ダウンロードしないことを決定する場合があります。メディア要素のダウンロードが中断された場合、ユーザーエージェントはメディア要素を指定してメディア要素タスクをキューに入れ、networkStateをNETWORK_IDLEに設定し、要素でsuspendという名前のイベントを発火させます。リソースのダウンロードが再開された場合、ユーザーエージェントはメディア要素を指定してメディア要素タスクをキューに入れ、networkStateをNETWORK_LOADINGに設定します。 これらのタスクのキューイングの間、ロードは中断されます（したがって、上記で説明したようにprogressイベントは発火しません）。

      preload属性は、autoplay属性がない場合でも、作成者が推奨すると考えるバッファリングの量に関するヒントを提供します。

      ユーザーエージェントがダウンロードを完全に中断することを決定した場合、たとえば、ユーザーが再生を開始するまでこれ以上コンテンツをダウンロードせずに待機している場合、ユーザーエージェントはメディア要素を指定してメディア要素タスクをキューに入れ、要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

      上記の手順はリクエストを発行するためのアルゴリズムを示していますが、ユーザーエージェントは、特にエラー状態の場合、これらの正確な手段以外の手段を使用する場合があります。たとえば、ユーザーエージェントはサーバーに再接続したり、ストリーミングプロトコルに切り替えたりする場合があります。ユーザーエージェントは、リソースのフェッチを試みるのをあきらめた場合にのみ、リソースがエラーであると見なし、上記の手順のエラー分岐に進む必要があります。

      メディアリソースの形式を決定するために、ユーザーエージェントはオーディオとビデオを具体的にスニッフィングするためのルールを使用する必要があります。

      ロードが中断されていない間（下記参照）、350ms（±200ms）ごと、または受信したバイトごと、いずれか頻度が低い方で、メディア要素を指定してメディア要素タスクをキューに入れます：

      1. 要素でprogressという名前のイベントを発火させます。

      2. 要素の現在ストールしているをfalseに設定します。

      ユーザーエージェントがメディアリソースの一部を取得するためにまだネットワークアクセスが必要な場合でも、ユーザーエージェントはこのステップにとどまる必要があります。

      たとえば、ユーザーエージェントがビデオの前半を破棄した場合、再生が終了した後でも、ユーザーエージェントはこのステップにとどまります。なぜなら、ユーザーが最初に戻る可能性があるからです。実際、この状況では、再生が終了すると、ユーザーエージェントは、前述のようにsuspendイベントを発火させることになります。

    それ以外の場合（modeはローカル）

    current media resourceによって記述されるリソース（もしあれば）には、メディアデータが含まれています。これはCORS同一オリジンです。

    current media resourceが生データストリーム（たとえば、Fileオブジェクトから）である場合、メディアリソースの形式を決定するために、ユーザーエージェントはオーディオとビデオを具体的にスニッフィングするためのルールを使用する必要があります。それ以外の場合、データストリームが事前にデコードされている場合、形式は関連する仕様によって与えられる形式です。

    current media resourceの新しいデータが利用可能になるたびに、メディア要素を指定してメディア要素タスクをキューに入れ、以下のメディアデータ処理ステップリストから最初の適切なステップを実行します。

    current media resourceが完全に使い果たされた場合（たとえば、Blobのすべてのバイトが処理された場合）、デコードエラーがなかった場合、ユーザーエージェントは以下の最終ステップに進まなければなりません。これは、たとえばcurrent media resourceがMediaStreamである場合など、決して起こらない可能性があります。

    メディアデータ処理ステップリストは次のとおりです：

    メディアデータがネットワークエラーのためにまったくフェッチできず、ユーザーエージェントがリソースのフェッチをあきらめた場合
    メディアデータはフェッチできるが、検査によってサポートされていない形式であることが判明した場合、またはその他の理由でまったくレンダリングできない場合

    DNSエラー、HTTP 4xxおよび5xxエラー（および他のプロトコルでの同等のエラー）、およびユーザーエージェントがcurrent media resourceが使用可能かどうかを確立する前に発生するその他の致命的なネットワークエラー、ならびにサポートされていないコンテナ形式を使用しているファイル、またはすべてのデータに対してサポートされていないコーデックを使用しているファイルは、ユーザーエージェントに次のステップを実行させる必要があります：

    1. ユーザーエージェントはフェッチプロセスをキャンセルする必要があります。

    2. このサブアルゴリズムを中止し、リソース選択アルゴリズムに戻ります。

    メディアリソースにオーディオトラックがあると判明した場合

    1. オーディオトラックを表すAudioTrackオブジェクトを作成します。

    2. メディア要素のaudioTracks属性のAudioTrackListオブジェクトを新しいAudioTrackオブジェクトで更新します。

    3. enableを不明とします。

    4. メディアリソースまたはcurrent media resourceのURLが有効にする特定のオーディオトラックセットを示している場合、またはユーザーエージェントがユーザーエクスペリエンスを向上させるために特定のオーディオトラックの選択を容易にする情報を持っている場合：このオーディオトラックが有効にするものの1つである場合、enableをtrueに設定し、それ以外の場合はenableをfalseに設定します。

      これはメディアフラグメント構文によってトリガーされる可能性がありますが、たとえばユーザーエージェントがステレオオーディオトラックよりも5.1サラウンドサウンドオーディオトラックを選択することによってもトリガーされる可能性があります。

    5. enableがまだ不明である場合、メディア要素にまだ有効なオーディオトラックがない場合、enableをtrueに設定し、それ以外の場合はenableをfalseに設定します。

    6. enableがtrueである場合、このオーディオトラックを有効にし、それ以外の場合はこのオーディオトラックを有効にしません。

    7. このAudioTrackListオブジェクトで、track属性を新しいAudioTrackオブジェクトに初期化して、TrackEventを使用してaddtrackという名前のイベントを発火させます。

    メディアリソースにビデオトラックがあると判明した場合

    1. ビデオトラックを表すVideoTrackオブジェクトを作成します。

    2. メディア要素のvideoTracks属性のVideoTrackListオブジェクトを新しいVideoTrackオブジェクトで更新します。

    3. enableを不明とします。

    4. メディアリソースまたはcurrent media resourceのURLが有効にする特定のビデオトラックセットを示している場合、またはユーザーエージェントがユーザーエクスペリエンスを向上させるために特定のビデオトラックの選択を容易にする情報を持っている場合：このビデオトラックがそのような最初のビデオトラックである場合、enableをtrueに設定し、それ以外の場合はenableをfalseに設定します。

      これもメディアフラグメント構文によってトリガーされる可能性があります。

    5. enableがまだ不明である場合、メディア要素にまだ選択されたビデオトラックがない場合、enableをtrueに設定し、それ以外の場合はenableをfalseに設定します。

    6. enableがtrueである場合、このトラックを選択し、以前に選択されたビデオトラックの選択を解除します。それ以外の場合は、このビデオトラックを選択しません。他のトラックの選択が解除された場合、changeイベントが発火します。

    7. このVideoTrackListオブジェクトで、track属性を新しいVideoTrackオブジェクトに初期化して、TrackEventを使用してaddtrackという名前のイベントを発火させます。

    メディアリソースの期間、その寸法、およびその他のメタデータを決定するのに十分なメディアデータがフェッチされたら

    これは、リソースが使用可能であることを示します。ユーザーエージェントは次のサブステップに従う必要があります：

    1. メディアデータに基づいて、現在の再生位置と最も早い可能な位置の目的のためにメディアタイムラインを確立します。

    2. 前のステップで確立されたメディアタイムラインのゼロ時間に対応する日時（もしあれば）にタイムラインオフセットを更新します。メディアリソースによって明示的な日時が与えられていない場合、タイムラインオフセットはNot-a-Number（NaN）に設定されなければなりません。

    3. 現在の再生位置と公式の再生位置を最も早い可能な位置に設定します。

    4. 上記で確立されたメディアタイムライン上のリソースの最後のフレームの時間（既知の場合）でduration属性を更新します。不明な場合（たとえば、原則として無限のストリーム）、duration属性を正の無限大の値に更新します。

      ユーザーエージェントは、この時点で要素でdurationchangeという名前のイベントを発火させるために、メディア要素を指定してメディア要素タスクをキューに入れます。

    5. video要素の場合、videoWidth属性とvideoHeight属性を設定し、メディア要素でresizeという名前のイベントを発火させるために、メディア要素を指定してメディア要素タスクをキューに入れます。

      寸法がその後変更された場合、さらにresizeイベントが発火します。

    6. readyState属性をHAVE_METADATAに設定します。

      readyState属性を新しい値に設定する一部として、loadedmetadataDOMイベントが発火します。

    7. jumpedをfalseとします。

    8. メディア要素のデフォルトの再生開始位置がゼロより大きい場合、その時間にシークし、jumpedをtrueとします。

    9. メディア要素のデフォルトの再生開始位置をゼロとします。

    10. initial playback positionをゼロとします。

    11. メディアリソースまたはcurrent media resourceのURLが特定の開始時間を示している場合、initial playback positionをその時間に設定し、jumpedがまだfalseである場合は、その時間にシークします。

      たとえば、メディアフラグメント構文をサポートするメディア形式では、フラグメントを使用して開始位置を示すことができます。

    12. 有効なオーディオトラックがない場合、オーディオトラックを有効にします。これにより、changeイベントが発火します。

    13. 選択されたビデオトラックがない場合、ビデオトラックを選択します。これにより、changeイベントが発火します。

    readyState属性がHAVE_CURRENT_DATAに達したら、loadeddataイベントが発火した後、要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

    各メディアリソースのメタデータをまだフェッチしている間にネットワーク使用量を削減しようとしているユーザーエージェントは、この時点でバッファリングも停止し、以前に説明したルールに従います。これには、networkState属性がNETWORK_IDLE値に切り替わり、suspendイベントが発火することが含まれます。

    ユーザーエージェントは、メディアリソースの期間を決定し、再生前にこのステップを実行することが要求されます。

    メディアリソース全体がフェッチされたら（ただし、その一部がデコードされる前である可能性があります）

    メディア要素でprogressという名前のイベントを発火させます。

    networkStateをNETWORK_IDLEに設定し、メディア要素でsuspendという名前のイベントを発火させます。

    ユーザーエージェントがメディアデータを破棄し、それを再度取得するためにネットワークアクティビティを再開する必要がある場合、メディア要素を指定してメディア要素タスクをキューに入れ、networkStateをNETWORK_LOADINGに設定します。

    ユーザーエージェントがメディアリソースをロードしたままにできる場合、アルゴリズムは以下の最終ステップに進み、アルゴリズムを中止します。

    一部のメディアデータが受信された後に接続が中断され、ユーザーエージェントがリソースのフェッチをあきらめた場合

    ユーザーエージェントがcurrent media resourceが使用可能かどうかを確立した後（つまり、メディア要素のreadyState属性がもはやHAVE_NOTHINGでなくなった後）に発生する致命的なネットワークエラーは、ユーザーエージェントに次のステップを実行させる必要があります：

    1. ユーザーエージェントはフェッチプロセスをキャンセルする必要があります。

    2. MEDIA_ERR_NETWORKでMediaErrorを作成した結果にerror属性を設定します。

    3. 要素のnetworkState属性をNETWORK_IDLE値に設定します。

    4. 要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

    5. メディア要素でerrorという名前のイベントを発火させます。

    6. 全体のリソース選択アルゴリズムを中止します。

    メディアデータが破損している場合

    メディアデータのデコードにおける致命的なエラーで、ユーザーエージェントがcurrent media resourceが使用可能かどうかを確立した後（つまり、メディア要素のreadyState属性がもはやHAVE_NOTHINGでなくなった後）に発生するものは、ユーザーエージェントに次のステップを実行させる必要があります：

    1. ユーザーエージェントはフェッチプロセスをキャンセルする必要があります。

    2. MEDIA_ERR_DECODEでMediaErrorを作成した結果にerror属性を設定します。

    3. 要素のnetworkState属性をNETWORK_IDLE値に設定します。

    4. 要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

    5. メディア要素でerrorという名前のイベントを発火させます。

    6. 全体のリソース選択アルゴリズムを中止します。

    メディアデータのフェッチプロセスがユーザーによって中止された場合

    フェッチプロセスがユーザーによって中止された場合、たとえばユーザーが「停止」ボタンを押した場合、ユーザーエージェントは次のステップを実行する必要があります。これらのステップは、これらのステップの実行中にload()メソッド自体が呼び出された場合には従いません。上記の手順がその特定の種類の中止を処理するためです。

    1. ユーザーエージェントはフェッチプロセスをキャンセルする必要があります。

    2. MEDIA_ERR_ABORTEDでMediaErrorを作成した結果にerror属性を設定します。

    3. メディア要素でabortという名前のイベントを発火させます。

    4. メディア要素のreadyState属性の値がHAVE_NOTHINGと等しい場合、要素のnetworkState属性をNETWORK_EMPTY値に設定し、要素のポスター表示フラグをtrueに設定し、要素でemptiedという名前のイベントを発火させます。

      それ以外の場合、要素のnetworkState属性をNETWORK_IDLE値に設定します。

    5. 要素のロードイベント遅延フラグをfalseに設定します。これにより、ロードイベントの遅延が停止します。

    6. 全体のリソース選択アルゴリズムを中止します。

    メディアデータはフェッチできるが、致命的ではないエラーがあるか、一部でサポートされていないコーデックを使用しており、ユーザーエージェントがコンテンツを完全に正しくレンダリングできないが、再生を完全に妨げるわけではない場合

    部分的に使用可能であるが最適にレンダリングできないデータをサーバーが返した場合、ユーザーエージェントは処理できるビットのみをレンダリングし、残りは無視する必要があります。

    メディアリソースが、ユーザーエージェントがサポートするメディアリソース固有のテキストトラックを宣言していることが判明した場合

    メディアデータがCORS同一オリジンである場合、関連するデータでメディアリソース固有のテキストトラックを公開する手順を実行します。

    クロスオリジンビデオは字幕を公開しません。これは、悪意のあるサイトがユーザーのイントラネット上の機密ビデオから字幕を読み取るなどの攻撃を可能にするためです。

  6. 最終ステップ：ユーザーエージェントがこのステップに到達した場合（リソース全体がロードされ、利用可能な状態に保たれた場合にのみ発生する可能性があります）：全体のリソース選択アルゴリズムを中止します。

メディア要素がメディア要素のメディアリソース固有トラックを忘れる際に、ユーザーエージェントは、メディア要素のテキストトラックのリストからすべてのメディアリソース固有のテキストトラックを削除し、次にメディア要素のaudioTracks属性のAudioTrackListオブジェクトを空にし、次にメディア要素のvideoTracks属性のVideoTrackListオブジェクトを空にします。これに関連して、イベント(特にremovetrackイベント)は発生しません。代わりに、このアルゴリズムを呼び出すアルゴリズムによって発生するerrorおよびemptiedイベントを使用できます。

preload属性は、以下のキーワードと状態を持つ列挙型属性です。

キーワード 状態 簡単な説明
auto 自動 ユーザーエージェントに、サーバーへのリスクなしにユーザーのニーズを最優先にするように、楽観的にリソース全体をダウンロードすることも含めて、指示するヒントを与えます。
(空文字列)
none なし ユーザーエージェントに対し、著者がメディアリソースをユーザーが必要とするとは考えていないか、サーバーが不要なトラフィックを最小限に抑えたいと考えていることを示唆するヒントを与えます。この状態は、バッファリングが始まった場合（例: ユーザーが「再生」ボタンを押したとき）に、実際にメディアリソースをどれだけ積極的にダウンロードするかについてはヒントを提供しません。
metadata メタデータ ユーザーエージェントに、著者がメディアリソースをユーザーが必要とするとは考えていないが、リソースのメタデータ（寸法、トラックリスト、期間など）を取得すること、場合によっては最初の数フレームを取得することが合理的であると考えていることを示唆するヒントを与えます。ユーザーエージェントがメタデータ以上を正確に取得しない場合、メディア要素は、readyState属性がHAVE_METADATAに設定されますが、通常はいくつかのフレームも取得されるため、おそらくHAVE_CURRENT_DATAまたはHAVE_FUTURE_DATAになります。メディアリソースが再生されているときに、帯域幅を制限する必要があることをユーザーエージェントに示唆します。例えば、ダウンロード速度を可能な限り遅くし、安定した再生を維持するためにメディアデータを取得することを提案します。

属性の欠損値デフォルトと無効値デフォルトはどちらも実装依存ですが、メタデータ状態が、サーバー負荷を減らしながら最適なユーザー体験を提供する妥協案として推奨されています。

属性は、メディアリソースがバッファリングまたは再生されている間であっても変更可能です。上記の表の説明は、そのことを念頭に置いて解釈する必要があります。

著者は属性を「none」または「metadata」から「auto」にユーザーが再生を開始した後に動的に切り替えることがあります。例えば、多くのビデオがあるページでは、リクエストされるまでこれらのビデオがダウンロードされないように指定するが、一度リクエストされた場合は積極的にダウンロードすることを示すために使用されるかもしれません。

preload属性は、著者が最良のユーザー体験をもたらすと考えるものについて、ユーザーエージェントにヒントを提供することを目的としています。この属性は、例えば明示的なユーザー設定や利用可能な接続性に基づいて、完全に無視されることもあります。

preloadIDL属性は、同名の内容属性を反映し、既知の値のみに制限される必要があります。

autoplay属性は、preload属性をオーバーライドすることができます（メディアが再生される場合、それがpreload属性によって示唆されるヒントに関係なく、自然にバッファリングが必要であるため）。ただし、両方を含めることはエラーではありません。

media.buffered

HTMLMediaElement/buffered

現在のすべてのエンジンでサポートされています。

Firefox4+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

TimeRangesオブジェクトを返します。このオブジェクトは、ユーザーエージェントがバッファリングしたメディアリソースの範囲を表します。

buffered属性は、新しい静的な正規化されたTimeRangesオブジェクトを返しなければなりません。このオブジェクトは、ユーザーエージェントがバッファリングしたメディアリソースの範囲を表します。この属性が評価される時点で、ユーザーエージェントは、たとえそれが煩雑な検査によってしか判断できないものであっても、利用可能な範囲を正確に決定しなければなりません。

通常、これはゼロ点を基準とした単一の範囲になりますが、例えば、ユーザーエージェントがシークに応じてHTTPレンジリクエストを使用する場合、複数の範囲が存在する可能性があります。

ユーザーエージェントは、以前にバッファリングされたデータを破棄することがあります。

したがって、ある時点でbuffered属性によって返されるオブジェクトの範囲に含まれていた時間位置が、後の時点で同じ属性によって返されるオブジェクトの範囲に含まれなくなることがあります。

新しいオブジェクトを毎回返すことは、属性ゲッターにとって悪いパターンであり、変更にコストがかかるためここでのみ定められています。新しいAPIにはコピーされるべきではありません。

4.8.11.6 メディアリソース内のオフセット
media.duration

HTMLMediaElement/duration

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

メディアリソースの長さを秒単位で返します。このとき、メディアリソースの開始が時間ゼロに設定されていると仮定します。

期間が利用できない場合はNaNを返します。

無限ストリームの場合はInfinityを返します。

media.currentTime [ = value ]

HTMLMediaElement/currentTime

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

公式再生位置を秒単位で返します。

指定した時間にシークするように設定できます。

メディアリソースには、メディアタイムラインがあり、時間（秒単位）をメディアリソース内の位置にマッピングします。タイムラインの起点は、その最も早く定義された位置です。タイムラインの期間は、その最後に定義された位置です。

メディアタイムラインの確立: もしメディアリソースが、起点が負でない明示的なタイムライン（すなわち、各フレームに特定の時間オフセットを与え、最初のフレームにゼロまたは正のオフセットを与える）を何らかの形で指定する場合、メディアタイムラインはそのタイムラインであるべきです。（メディアリソースがタイムラインを指定できるかどうかは、メディアリソースの形式によります。）メディアリソースが明示的な開始時刻と日付を指定する場合、その時刻と日付はメディアタイムラインのゼロポイントと見なされるべきです。タイムラインオフセットは、時間と日付であり、getStartDate()メソッドを使用して公開されます。

もしメディアリソースが不連続のタイムラインを持っている場合、ユーザーエージェントは、リソースの開始時に使用されたタイムラインをリソース全体にわたって延長し、メディアタイムラインが最も早い可能な位置（以下に定義）の時点から直線的に増加するようにしなければなりません。これにより、基になるメディアデータに順序が狂ったタイムコードや重複するタイムコードが含まれていても、メディアリソースのタイムラインが一貫して線形に進むことが保証されます。

たとえば、2つのクリップを1つのビデオファイルに連結した場合、ビデオ形式は元のクリップの時間を公開しますが、ビデオデータは、たとえば、00:15..00:29、その後に00:05..00:38というタイムラインを公開するかもしれません。しかし、ユーザーエージェントはこれらの時間を公開せず、代わりに00:15..00:29、その後に00:29..01:02というタイムラインを単一のビデオとして公開します。

(これはトラッキングベクターです。) 明示的なタイムラインを持たないメディアリソースの稀なケースでは、メディアタイムライン上のゼロ時間は、メディアリソースの最初のフレームに対応する必要があります。さらに稀なケースとして、フレームの期間も含めた明示的なタイミング情報が一切ないメディアリソースの場合、ユーザーエージェントは各フレームの時間を実装定義の方法で決定しなければなりません。

明示的なタイムラインを持たないが、フレーム期間が明示されているファイル形式の例としては、アニメーションGIF形式があります。タイミングが一切明示されていないファイル形式の例としては、MJPEGストリームの形式としてよく使用されるJPEGプッシュ形式（multipart/x-mixed-replaceでJPEGフレームを含むもの）があります。

タイミング情報のないリソースの場合でも、ユーザーエージェントがサーバーから最初に提供されたフレームよりも早い時点にシークできる場合は、ゼロ時間はメディアリソースの最も早いシーク可能な時点に対応する必要があります。そうでない場合は、ユーザーエージェントがストリームを受信し始めたメディアリソースの最初のフレームに対応する必要があります。

執筆時点では、明示的なフレーム時間オフセットを持たないが、サーバーから送信された最初のフレームの前にシークできる形式は知られていません。

TV放送局からのストリームを考えてみましょう。これは10月の晴れた金曜日の午後にストリーミングを開始し、常に接続してくるユーザーエージェントに対して同じメディアタイムラインでメディアデータを送信し、そのゼロ時間をこのストリームの開始時に設定します。数ヶ月後、このストリームに接続するユーザーエージェントは、受信する最初のフレームの時間が何百万秒もあることに気づくでしょう。getStartDate()メソッドは、常に放送開始日を返し、これにより、コントローラーはスクラバーに相対時間（「8ヶ月4時間12分23秒」）ではなく実際の時間（例：「午後2時30分」）を表示できるようになります。

いくつかの連結されたフラグメントを含むビデオを配信するストリームを考えてみましょう。これは、ユーザーエージェントが特定の時間を要求できないサーバーによって配信され、代わりにビデオデータを決められた順序でストリーミングし、配信される最初のフレームが常にゼロ時間として識別されます。ユーザーエージェントがこのストリームに接続し、2010-03-20 23:15:00 UTCから2010-03-21 00:05:00 UTCまで、および2010-02-12 14:25:00 UTCから2010-02-12 14:35:00 UTCまでのタイムスタンプをカバーするフラグメントを受信した場合、これは0秒から3600秒（一時間）に延びるメディアタイムラインとして公開されます。ストリーミングサーバーが2番目のクリップの終わりで切断されたと仮定すると、duration属性は3600を返すことになります。この場合、getStartDate()メソッドは2010-03-20 23:15:00 UTCに対応するDateオブジェクトを返します。しかし、5分後に別のユーザーエージェントが接続した場合、そのユーザーエージェントはおそらく、2010-03-20 23:20:00 UTCから2010-03-21 00:05:00 UTCまで、2010-02-12 14:25:00 UTCから2010-02-12 14:35:00 UTCまでのタイムスタンプをカバーするフラグメントを受信し、0秒から3300秒（55分）に延びるメディアタイムラインとしてこれを公開することになります。この場合、getStartDate()メソッドは、2010-03-20 23:20:00 UTCに対応するDateオブジェクトを返します。

これらの両方の例において、seekable属性は、コントローラーが実際にUIで表示したい範囲を示します。通常、サーバーが任意の時間へのシークをサポートしていない場合、これはユーザーエージェントがストリームに接続した時点から最新のフレームまでの時間範囲を意味します。ただし、ユーザーエージェントが以前の情報を破棄し始めた場合、実際の範囲は短くなるかもしれません。

いずれの場合でも、ユーザーエージェントは、確立されたメディアタイムラインを使用して最も早い可能な位置（以下に定義）がゼロ以上であることを確認しなければなりません。

メディアタイムラインには、関連する時計もあります。どの時計が使用されるかはユーザーエージェントによって定義され、メディアリソースに依存することがありますが、ユーザーの壁時計に近いものにする必要があります。

メディア要素には現在の再生位置があり、これは最初（すなわちメディアデータがない場合）にはゼロ秒でなければなりません。現在の再生位置はメディアタイムライン上の時間です。

メディア要素には、正式な再生位置もあり、これも最初はゼロ秒に設定されていなければなりません。正式な再生位置は、スクリプトが実行されている間、安定して保たれる現在の再生位置の概算です。

メディア要素には、デフォルトの再生開始位置もあり、これも最初はゼロ秒に設定されていなければなりません。この時間は、メディアが読み込まれる前でも要素をシークできるようにするために使用されます。

各メディア要素にはポスターフラグを表示があり、メディア要素が作成されるとき、このフラグはtrueに設定されていなければなりません。このフラグは、ビデオ要素に対して、ビデオコンテンツの代わりにポスターフレームを表示するタイミングを制御するために使用されます。

currentTime属性は、取得時に、メディア要素のデフォルトの再生開始位置を返さなければなりません。ただし、それがゼロである場合は、要素の正式な再生位置を返さなければなりません。返される値は秒単位で表現されなければなりません。設定時には、メディア要素のreadyStateがHAVE_NOTHINGである場合、新しい値をメディア要素のデフォルトの再生開始位置に設定しなければなりません。それ以外の場合、新しい値を正式な再生位置に設定し、その後新しい値にシークしなければなりません。この新しい値は秒単位で解釈されなければなりません。

リソースがメディアリソースのストリーミングリソースである場合、ユーザーエージェントはそのリソースの特定の部分をバッファから消去された後に取得できなくなるかもしれません。同様に、いくつかのメディアリソースにはゼロから始まらないメディアタイムラインが存在するかもしれません。最も早い可能な位置は、ユーザーエージェントが再び取得できるストリームまたはリソース内の最も早い位置です。これはまた、メディアタイムライン上の時間でもあります。

最も早い可能な位置はAPIに明示的に公開されていません。それは、属性のseekableで返されるオブジェクトの最初の範囲の開始時点、またはそれがない場合は現在の再生位置に対応します。

最も早い可能な位置が変わると、次のようにします。現在の再生位置が最も早い可能な位置よりも前にある場合、ユーザーエージェントはシークしなければなりません。それ以外の場合、過去15～250ミリ秒の間に要素でtimeupdateイベントを発火していない場合、またそのようなイベントのイベントハンドラーがまだ実行中でない場合、ユーザーエージェントはメディア要素タスクをキューに追加し、そのメディア要素でtimeupdateイベントを発火しなければなりません。

上記の要件およびクリップのメタデータが判明したときに発生するリソースフェッチアルゴリズムの要件のために、現在の再生位置は最も早い可能な位置よりも小さくなることはありません。

任意の時点で、ユーザーエージェントがオーディオまたはビデオトラックが終了し、そのトラックに関連するすべてのメディアデータがメディアタイムラインの最も早い可能な位置よりも前に対応していると判断した場合、 ユーザーエージェントはメディア要素タスクをキューに追加することができます。 このメディア要素に対して以下の手順を実行します。

  1. トラックをaudioTracks属性のAudioTrackListオブジェクトから、またはvideoTracks属性のVideoTrackListオブジェクトから削除します。

  2. イベントを発火し、トラックを表すAudioTrackまたはVideoTrackオブジェクトを使用して、removetrackという名前のイベントをメディア要素のAudioTrackListまたはVideoTrackListオブジェクトで発火します。

duration属性は、メディアリソースの終了時点の時間を秒単位で返さなければなりません。もしメディアデータが利用できない場合、この属性はNot-a-Number (NaN) 値を返さなければなりません。メディアリソースが境界のないもの（例: ストリーミングラジオや終了時刻が発表されていないライブイベントなど）であると知られている場合、この属性は正の無限大 (Infinity) 値を返さなければなりません。

ユーザーエージェントは、メディアリソースの時間を、メディアデータのいずれかを再生する前に、また、readyStateをHAVE_METADATA以上の値に設定する前に、複数のリソースの部分を取得する必要がある場合でも、決定しなければなりません。

メディアリソースの長さが既知の値に変わったとき（例: 不明から既知に変わった場合、または以前に確立された長さから新しい長さに変更された場合）、ユーザーエージェントはメディア要素にメディア要素タスクをキューに追加して、イベントを発火し、durationchangeという名前のイベントをメディア要素に対して発火しなければなりません。（新しいメディアリソースの読み込みの一環として持続時間がリセットされた場合、このイベントは発火されません。）持続時間が変更され、現在の再生位置がメディアリソースの終了時点よりも大きくなる場合、ユーザーエージェントはまた、メディアリソースの終了時点にシークしなければなりません。

何らかの理由で「無限」のストリームが終了した場合、持続時間は正の無限大からストリーム内の最後のフレームまたはサンプルの時間に変わり、durationchangeイベントが発火します。同様に、ユーザーエージェントが最初にメディアリソースの持続時間を正確に決定せずに推定し、その後、新しい情報に基づいて推定を修正した場合、持続時間は変更され、durationchangeイベントが発火します。

いくつかのビデオファイルには、メディアタイムラインのゼロ時間に対応する明示的な日付と時刻があり、タイムラインオフセットとして知られています。初期状態では、タイムラインオフセットはNot-a-Number (NaN)に設定される必要があります。

getStartDate()メソッドは、現在のタイムラインオフセットを表す新しいDateオブジェクトを返さなければなりません。

loop属性は、指定されている場合、メディア要素がメディアリソースの終了時点に到達した際にリソースの開始位置に戻って再生を続けるようにするブール属性です。

HTMLMediaElement/loop

すべての現行エンジンでサポートされています。

Firefox11+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

loopIDL属性は、同名のコンテンツ属性を反映しなければなりません。

4.8.11.7 レディ状態
media.readyState

HTMLMediaElement/readyState

すべての現行エンジンでサポートされています。

Firefox3.5+ Safari3.1+ Chrome3+
Opera12.1+ Edge79+
Edge (レガシー)12+ Internet Explorer5.5+
Firefox Android? Safari iOS3+ Chrome Android? WebView Android37+ Samsung Internet? Opera Android12.1+

下記のリストにあるコードから、現在の再生位置に関して、要素の現在の状態を示す値を返します。

メディア要素には、レディ状態があり、これは現在の再生位置でレンダリングする準備がどの程度整っているかを示します。可能な値は次の通りです。特定の時点でのメディア要素のレディ状態は、要素の状態を表す最大の値です。

HAVE_NOTHING（数値値 0）

メディアリソースに関する情報は何も利用できません。現在の再生位置に関するデータはありません。メディア要素のnetworkState属性がNETWORK_EMPTYに設定されている場合、常にHAVE_NOTHING状態になります。

HAVE_METADATA（数値値 1）

リソースの持続時間が利用可能であることを示すのに十分なリソースが取得されました。ビデオ要素の場合、ビデオの寸法も利用可能です。メディアデータは現在の再生位置に関しては利用できません。

HAVE_CURRENT_DATA（数値値 2）

現在の再生位置に関するデータは利用可能ですが、ユーザーエージェントが再生方向にHAVE_METADATA状態に戻らずに現在の再生位置を進められるほどのデータが不足しているか、再生方向にさらに取得できるデータがないかのいずれかです。例えば、ビデオの場合、現在のフレームのデータはあるが、次のフレームのデータがない場合や、再生が終了した場合がこれに該当します。

HAVE_FUTURE_DATA（数値値 3）

現在の再生位置に関するデータが利用可能であり、HAVE_METADATA状態に戻らずに、再生方向に現在の再生位置を少し進めるのに十分なデータも利用可能です。また、テキストトラックが準備完了していることも条件に含まれます。

HAVE_ENOUGH_DATA（数値値 4）

状態HAVE_FUTURE_DATAに記載されたすべての条件が満たされており、さらに次のいずれかの条件が当てはまります：

実際には、HAVE_METADATAとHAVE_CURRENT_DATAの違いはほとんどありません。主に、ビデオ要素をキャンバスに描画する場合に、何かが描かれる状態（HAVE_CURRENT_DATA以上）と、何も描かれない状態（HAVE_METADATA以下）を区別する場合に意味があります。

メディア要素のnetworkStateがNETWORK_EMPTYでない場合に、そのレディ状態が変わると、ユーザーエージェントは次のステップに従う必要があります。

  1. 次のリストから最初に該当するサブステップのセットを適用します：

    以前のレディ状態がHAVE_NOTHINGであり、新しいレディ状態がHAVE_METADATAの場合

    メディア要素タスクをキューに追加するを実行し、メディア要素に対して、要素にloadedmetadataという名前のイベントを発火します。

    このタスクが実行される前に、イベントループのメカニズムの一環として、適切であればビデオ要素のリサイズがレンダリングに反映されます。

    以前のレディ状態がHAVE_METADATAであり、新しいレディ状態がHAVE_CURRENT_DATA以上である場合

    これはメディア要素に対してload()アルゴリズムが最後に実行されて以来、初めてのことである場合、ユーザーエージェントはメディア要素タスクをキューに追加するを実行し、要素にloadeddataという名前のイベントを発火します。

    新しいレディ状態がHAVE_FUTURE_DATAまたはHAVE_ENOUGH_DATAである場合、次に関連するステップが実行されます。

    以前のレディ状態がHAVE_FUTURE_DATA以上であり、新しいレディ状態がHAVE_CURRENT_DATA以下である場合

    要素がそのreadyState属性がHAVE_FUTURE_DATA未満に変更される前に潜在的に再生していた場合、そして要素が再生が終了していない場合、またエラーにより停止したり、ユーザーの操作によって一時停止したり、インバンドコンテンツのために一時停止したりしていない場合、ユーザーエージェントはメディア要素タスクをキューに追加するを実行し、要素にtimeupdateという名前のイベントを発火し、メディア要素タスクをキューに追加するを実行し、要素にwaitingという名前のイベントを発火します。

    以前のレディ状態がHAVE_CURRENT_DATA以下であり、新しいレディ状態がHAVE_FUTURE_DATAである場合

    ユーザーエージェントはメディア要素タスクをキューに追加するを実行し、要素にcanplayという名前のイベントを発火します。

    要素のpaused属性がfalseである場合、ユーザーエージェントは要素の再生について通知する必要があります。

    新しいレディ状態がHAVE_ENOUGH_DATAである場合

    以前のレディ状態がHAVE_CURRENT_DATA以下であった場合、ユーザーエージェントはメディア要素タスクをキューに追加するを実行し、要素にcanplayという名前のイベントを発火し、要素のpaused属性がfalseである場合、要素の再生について通知する必要があります。

    ユーザーエージェントはメディア要素タスクをキューに追加するを実行し、要素にcanplaythroughという名前のイベントを発火します。

    要素が自動再生の対象でない場合、ユーザーエージェントはこれらのサブステップを中止する必要があります。

    ユーザーエージェントは以下のサブステップを実行できます：

    1. paused属性をfalseに設定します。
    2. 要素のポスターを表示するフラグがtrueである場合、それをfalseに設定し、時間が進むステップを実行します。
    3. メディア要素タスクをキューに追加するを実行し、要素にplayという名前のイベントを発火します。
    4. 要素の再生について通知を実行します。

    または、要素がビデオ要素である場合、ユーザーエージェントは、要素がビューポートと交差するかどうかを監視し始めることができます。要素がビューポートと交差し始めたとき、要素がまだ自動再生の対象である場合、上記のサブステップを実行します。オプションとして、要素がビューポートと交差しなくなったとき、自動再生可能フラグがまだtrueであり、自動再生属性がまだ指定されている場合、次のサブステップを実行します：

    1. 内部の一時停止手順を実行し、自動再生可能フラグをtrueに設定します。
    2. メディア要素タスクをキューに追加するを実行し、要素にpauseという名前のイベントを発火します。

    再生と一時停止のサブステップは、自動再生可能フラグがtrueである限り、要素がビューポートと交差し始めたりやめたりするたびに、何度でも実行される可能性があります。

    ユーザーエージェントは自動再生をサポートする必要はなく、ユーザーの好みを尊重することが推奨されています。作成者はスクリプトを使用してビデオの再生を強制するのではなく、自動再生属性を使用することを推奨されており、ユーザーが望まない場合に動作を上書きできるようにすることが推奨されています。

メディア要素のレディ状態がこれらの状態の間で不連続に移動する可能性があります。たとえば、メディア要素の状態が、HAVE_METADATAからHAVE_ENOUGH_DATAへと一気にジャンプし、HAVE_CURRENT_DATAおよびHAVE_FUTURE_DATAの状態を通過しない場合があります。

readyStateIDL属性は、取得時に、メディア要素の現在のレディ状態を表す上記の値を返す必要があります。

autoplay属性は、ブール属性です。存在する場合、ユーザーエージェントは（ここで説明するアルゴリズムに従って）、中断することなくできるだけ早くメディアリソースの再生を自動的に開始します。

作成者はスクリプトを使用して自動再生をトリガーするのではなく、自動再生属性を使用することが推奨されます。これにより、ユーザーが自動再生を望まない場合、たとえばスクリーンリーダーを使用しているときに、動作を上書きすることができます。また、作成者は自動再生の動作をまったく使用せず、ユーザーエージェントがユーザーに再生を明示的に開始させるのを待つことを検討することも推奨されます。

HTMLMediaElement/autoplay

すべての現行エンジンでサポートされています。

Firefox3.5+ Safari3.1+ Chrome3+
Opera12.1+ Edge79+
Edge (レガシー)12+ Internet Explorer9+
Firefox Android? Safari iOS3+ Chrome Android? WebView Android37+ Samsung Internet? Opera Android12.1+

autoplayIDL属性は、同じ名前のコンテンツ属性を反映する必要があります。

4.8.11.8 メディアリソースの再生
media.paused

HTMLMediaElement/paused

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

再生が一時停止されている場合はtrueを返し、そうでない場合はfalseを返します。

media.ended

HTMLMediaElement/ended

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

メディアリソースの再生が終了した場合はtrueを返します。

media.defaultPlaybackRate [ = value ]

HTMLMediaElement/defaultPlaybackRate

すべての現行エンジンでサポートされています。

Firefox20+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

ユーザーがメディアリソースを早送りや逆再生していないときのデフォルトの再生速度を返します。

デフォルトの再生速度を変更するために設定することができます。

デフォルトの速度は再生には直接影響しませんが、ユーザーが早送りモードに切り替えた場合、通常の再生モードに戻るときには再生速度がデフォルトの再生速度に戻ることが期待されます。

media.playbackRate [ = value ]

HTMLMediaElement/playbackRate

すべての現行エンジンでサポートされています。

Firefox20+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在の再生速度を返し、1.0は通常の速度を示します。

再生速度を変更するために設定することができます。

media.preservesPitch

HTMLMediaElement/preservesPitch

Firefox101+🔰 4+Chrome86+
Opera?Edge86+
Edge (レガシー)?Internet Explorer対応していません
Firefox Android?Safari iOS🔰 4+Chrome Android?WebView Android?Samsung Internet?Opera Android?

playbackRateが1.0でない場合にピッチ補正アルゴリズムが使用されている場合はtrueを返します。デフォルト値はtrueです。

音声のピッチを変更するためにfalseに設定することができます。これにより、メディアリソースの音声のピッチが、playbackRateに応じて上下に変化します。これは、美的およびパフォーマンス上の理由で有用です。

media.played

TimeRangesオブジェクトを返し、ユーザーエージェントが再生したメディアリソースの範囲を表します。

media.play()

HTMLMediaElement/play

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

paused属性をfalseに設定し、メディアリソースを読み込み、必要に応じて再生を開始します。再生が終了していた場合、最初から再開します。

media.pause()

HTMLMediaElement/pause

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

paused属性をtrueに設定し、メディアリソースを必要に応じて読み込みます。

paused 属性は、メディア要素 が一時停止しているかどうかを表します。この属性は、初期状態でtrueでなければなりません。

メディア要素 は、readyState 属性が HAVE_NOTHING 状態、HAVE_METADATA 状態、または HAVE_CURRENT_DATA 状態にある場合、または要素が ユーザー操作のために一時停止 している場合、ブロックされたメディア要素 です。

メディア要素 が 潜在的に再生中 であると言われるのは、その paused 属性がfalseであり、要素が 再生を終了していない、再生が エラーで停止していない など、ブロックされたメディア要素 ではない場合です。

waiting DOMイベントが、潜在的に再生中の要素が readyState 属性が HAVE_FUTURE_DATA より低い値に変更されるために再生を停止する結果として発生する可能性があります。

メディア要素 が 自動再生が可能 であると言われるのは、次のすべてが真である場合です。

メディア要素は、ユーザーエージェントとシステムが現在のコンテキストでメディア再生を許可している場合、再生が許可されているとされます。

例えば、ユーザーエージェントは、メディア要素のWindowオブジェクトが一時的なアクティベーションを持つ場合にのみ再生を許可することがありますが、ミュートされている間に再生を許可する例外を設けることもあります。

メディア要素は、次の条件を満たしたときに再生が終了したとされます:

ended属性は、最後にイベントループがステップ1に到達したときに、メディア要素が再生を終了しており、再生の方向が前方であった場合にtrueを返し、それ以外の場合はfalseを返さなければなりません。

メディア要素は、次の条件を満たしたときにエラーによって停止したとされます: 要素のreadyState属性がHAVE_METADATA以上であり、ユーザーエージェントが処理中に非致命的なエラーに遭遇し、そのエラーのために現在の再生位置でコンテンツを再生できなくなった場合。

メディア要素は、次の条件を満たしたときにユーザー操作のために一時停止したとされます: paused属性がfalseであり、readyState属性がHAVE_FUTURE_DATAまたはHAVE_ENOUGH_DATAのいずれかであり、ユーザーエージェントがメディアリソース内でリソースを継続するためにユーザーが選択を行う必要がある地点に到達したとき。

メディア要素が再生を終了し、ユーザー操作のために一時停止している場合、同時にそれが可能です。

メディア要素が潜在的に再生中で、ユーザー操作のために一時停止したために再生を停止した場合、ユーザーエージェントはメディア要素タスクをキューに入れ、そのメディア要素でイベントを発火させ、timeupdateという名前のイベントを要素に発生させる必要があります。

メディア要素がインバンドコンテンツのために一時停止したとされるのは、paused属性がfalseであり、readyState属性がHAVE_FUTURE_DATAまたはHAVE_ENOUGH_DATAのいずれかであり、ユーザーエージェントがメディアリソースを再生するのを一時停止して、そのメディアリソースに一時的にアンカーされているがゼロ以外の長さを持つコンテンツを再生する場合、またはメディアリソースのセグメントに一時的にアンカーされているがそのセグメントよりも長い長さを持つコンテンツを再生する場合です。

メディア要素がインバンドコンテンツのために一時停止される例の一つは、ユーザーエージェントが外部のWebVTTファイルから音声説明を再生しているときで、キューのために生成された合成音声がテキストトラックキューの開始時間とテキストトラックキューの終了時間の間の時間よりも長い場合です。

現在の再生位置がメディアリソースの終端に達し、再生の方向が前方の場合、ユーザーエージェントは次の手順に従う必要があります:

  1. メディア要素にループ属性が指定されている場合、シークして、最も早い位置のメディアリソースに戻り、終了します。

  2. 上記の定義に従って、endedIDL属性は、イベントループがステップ1に戻ると、trueを返し始めます。

  3. メディア要素タスクをキューに入れる際に、メディア要素に対して次の手順を行います:

    1. イベントを発火し、timeupdateという名前のイベントをメディア要素に発生させます。

    2. メディア要素が再生を終了し、再生の方向が前方であり、pausedがfalseである場合、次の手順を実行します:

      1. paused属性をtrueに設定します。

      2. イベントを発火し、pauseという名前のイベントをメディア要素に発生させます。

      3. 保留中の再生プロミスを取得し、保留中の再生プロミスを拒否し、結果と"AbortError"DOMExceptionを返します。

    3. イベントを発火し、endedという名前のイベントをメディア要素に発生させます。

現在の再生位置が最も早い位置に達し、メディアリソースの再生の方向が後方の場合、ユーザーエージェントはメディア要素タスクをキューに入れ、次にイベントを発火し、timeupdateという名前のイベントを要素に発生させる必要があります。

ここでの「到達」という言葉は、現在の再生位置が通常の再生中に変化する必要があることを意味するものではありません。例えばシークによって到達することもあります。

defaultPlaybackRate属性は、メディアリソースが再生される望ましい速度を、その固有の速度の倍数として示します。この属性は変更可能で、取得時には最後に設定された値を返すか、まだ設定されていない場合は1.0を返す必要があります。設定時には、新しい値に設定されなければなりません。

defaultPlaybackRateは、ユーザーエージェントがユーザーインターフェースをユーザーに公開する際に使用されます。

playbackRate属性は、実際の再生速度を、その固有の速度の倍数として示します。これがdefaultPlaybackRateと等しくない場合、ユーザーが早送りやスローモーション再生などの機能を使用していることを意味します。この属性は変更可能で、取得時には最後に設定された値を返すか、まだ設定されていない場合は1.0を返す必要があります。設定時には、ユーザーエージェントは次の手順に従う必要があります:

  1. 指定された値がユーザーエージェントでサポートされていない場合、"NotSupportedError" DOMExceptionをスローします。

  2. playbackRateを新しい値に設定し、要素が潜在的に再生中であれば、再生速度を変更します。

defaultPlaybackRateまたはplaybackRateの属性値が変更されたとき（スクリプトによって設定された場合や、ユーザー操作に応じてユーザーエージェントが直接変更した場合など）、ユーザーエージェントはメディア要素タスクをキューに入れ、メディア要素に対してイベントを発火させ、ratechangeという名前のイベントを発生させる必要があります。ユーザーエージェントは属性の変更をスムーズに処理し、再生において知覚可能なギャップやミュートを発生させてはなりません。

preservesPitchのgetterステップは、再生中にピッチを維持するアルゴリズムが有効である場合にtrueを返すことです。setterステップは、再生に知覚可能なギャップやミュートを発生させることなく、ピッチを維持するアルゴリズムをオンまたはオフに切り替えることです。デフォルトでは、そのようなピッチ維持アルゴリズムは有効でなければなりません（つまり、getterは初期状態でtrueを返します）。

played属性は、属性が評価される時点で、通常の再生中に現在の再生位置の単調な増加によって到達したメディアリソースのメディアタイムライン上の範囲を表す新しい静的な正規化されたTimeRangesオブジェクトを返さなければなりません。

毎回新しいオブジェクトを返すことは、属性ゲッターにとって悪いパターンであり、変更するにはコストがかかるため、ここに保存されています。新しいAPIにコピーしてはいけません。

各メディア要素には、保留中の再生プロミスのリストがあり、初期状態では空でなければなりません。

メディア要素の保留中の再生プロミスを取得するために、ユーザーエージェントは次の手順を実行する必要があります:

  1. promisesを空のプロミスリストとします。

  2. メディア要素の保留中の再生プロミスのリストをpromisesにコピーします。

  3. メディア要素の保留中の再生プロミスのリストをクリアします。

  4. promisesを返します。

メディア要素に対してプロミスのリストpromisesを持つ保留中の再生プロミスを解決するために、ユーザーエージェントはpromises内の各プロミスを未定義で解決する必要があります。

メディア要素に対してプロミスのリストpromisesと例外名errorを持つ保留中の再生プロミスを拒否するために、ユーザーエージェントはpromises内の各プロミスをerrorで拒否する必要があります。

メディア要素の再生について通知するために、ユーザーエージェントは次の手順を実行する必要があります:

  1. 保留中の再生プロミスを取得し、その結果をpromisesとします。

  2. 次の手順で要素に対してメディア要素タスクをキューに入れる:

    1. イベントを発火し、playingという名前のイベントを要素に発生させます。

    2. 保留中の再生プロミスを解決し、promisesを結果として返します。

メディア要素のplay()メソッドが呼び出されたとき、ユーザーエージェントは次の手順を実行する必要があります。

  1. メディア要素が再生が許可されていない場合、プロミスをNotAllowedErrorの"NotAllowedError"のDOMExceptionで拒否された状態で返します。

  2. メディア要素のerror属性がnullでなく、そのコードがMEDIA_ERR_SRC_NOT_SUPPORTEDである場合、プロミスをNotSupportedErrorの"NotSupportedError"のDOMExceptionで拒否された状態で返します。

    これは、専用のメディアソースエラー処理手順が実行されたことを意味します。メディア要素ロードアルゴリズムがerror属性をクリアするまで、再生はできません。

  3. promiseを新しいプロミスとし、保留中の再生プロミスのリストにpromiseを追加します。

  4. 内部再生手順をメディア要素に対して実行します。

  5. promiseを返します。

メディア要素に対する内部再生手順は次のとおりです:

  1. メディア要素のnetworkState属性の値がNETWORK_EMPTYの場合、メディア要素のリソース選択アルゴリズムを呼び出します。

  2. 再生が終了し、再生の方向が前方の場合、最も早い位置にメディアリソースをシークします。

    これは、ユーザーエージェントがメディア要素タスクをキューに入れ、メディア要素でtimeupdateという名前のイベントを発火する原因となります。

  3. メディア要素のpaused属性がtrueである場合:

    1. pausedの値をfalseに変更します。

    2. ポスター表示フラグがtrueの場合、要素のポスター表示フラグをfalseに設定し、時間の流れ手順を実行します。

    3. メディア要素タスクをキューに入れ、メディア要素でplayという名前のイベントを発火させます。

    4. メディア要素のreadyState属性の値がHAVE_NOTHING、HAVE_METADATA、またはHAVE_CURRENT_DATAの場合、メディア要素タスクをキューに入れ、waitingという名前のイベントを要素に発生させます。

      それ以外の場合、メディア要素のreadyState属性の値がHAVE_FUTURE_DATAまたはHAVE_ENOUGH_DATAである場合、要素に対して再生について通知を行います。

  4. それ以外の場合、メディア要素のreadyState属性の値がHAVE_FUTURE_DATAまたはHAVE_ENOUGH_DATAの場合、保留中の再生プロミスを取得し、メディア要素タスクをキューに入れ、保留中の再生プロミスを解決します。

    メディア要素は既に再生中です。ただし、プロミスはキューに入れられたタスクが実行される前に拒否される可能性があります。

  5. メディア要素の自動再生可能フラグをfalseに設定します。

pause()メソッドが呼び出されたとき、およびユーザーエージェントがメディア要素を一時停止する必要があるとき、ユーザーエージェントは次の手順を実行する必要があります:

  1. メディア要素のnetworkState属性の値がNETWORK_EMPTYの場合、メディア要素のリソース選択アルゴリズムを呼び出します。

  2. 内部一時停止手順をメディア要素に対して実行します。

メディア要素に対する内部一時停止手順は次のとおりです:

  1. メディア要素の自動再生可能フラグをfalseに設定します。

  2. メディア要素のpaused属性がfalseである場合、次の手順を実行します:

    1. pausedの値をtrueに変更します。

    2. 保留中の再生の約束を取得し、promisesをその結果として設定します。

    3. メディア要素タスクをキューに入れ、メディア要素に対して次の手順を実行します:

      1. イベントを発火し、要素に対してtimeupdateという名前のイベントを発生させます。

      2. イベントを発火し、要素に対してpauseという名前のイベントを発生させます。

      3. 保留中の再生プロミスをpromisesとerrorで拒否し、"AbortError" DOMExceptionを返します。

    4. 公式再生位置を現在の再生位置に設定します。

要素のplaybackRateが正またはゼロの場合、再生の方向は前方です。それ以外の場合、後方になります。

メディア要素が潜在的に再生中であり、そのドキュメントが完全にアクティブなドキュメントである場合、要素のplaybackRate単位のメディア時間でメディアタイムラインのクロックの1単位時間ごとに、現在の再生位置が単調に増加しなければなりません。（この仕様ではこれを常に「増加」と呼びますが、実際には要素のplaybackRateが負である場合、その増加は減少となることがあります。）

要素のplaybackRateは0.0である可能性があり、その場合現在の再生位置は動かず、再生が一時停止されていないにもかかわらず（pausedがtrueにならず、pauseイベントが発生しません）。

この仕様では、ユーザーエージェントが適切な再生速度をどのように達成するかを定義していません。プロトコルやメディアの状況に応じて、ユーザーエージェントがサーバーと交渉して、サーバーが適切な速度でメディアデータを提供するようにすることが考えられます。したがって、（速度が変更されてからサーバーがストリームの再生速度を更新するまでの期間を除いて）クライアントが実際にフレームを落としたり補間したりする必要はありません。

ユーザーエージェントが安定状態を提供するたびに、公式再生位置を現在の再生位置に設定する必要があります。

再生の方向が後方である間、対応するオーディオはミュートされなければなりません。要素のplaybackRateが非常に低いか高すぎて、ユーザーエージェントがオーディオを有効に再生できない場合も、対応するオーディオはミュートされなければなりません。要素のplaybackRateが1.0でなく、preservesPitchがtrueである場合、ユーザーエージェントは元の音声のピッチを維持するためにピッチ調整を適用する必要があります。それ以外の場合、ユーザーエージェントはピッチ調整なしで音声を速くまたは遅く再生する必要があります。

メディア要素が潜在的に再生中であるとき、その音声データは要素の実効メディア音量で現在の再生位置と同期して再生されなければなりません。ユーザーエージェントは、イベントループが最後にステップ1に到達したときに有効になっていたオーディオトラックから音声を再生しなければなりません。

メディア要素が潜在的に再生中でないとき、要素の音声は再生されてはなりません。

メディア要素が潜在的に再生中であり、ドキュメントに存在しない場合、ビデオは再生してはなりませんが、オーディオコンポーネントは再生する必要があります。すべての参照が削除されたためにメディア要素が再生を停止してはならず、そのメディア要素が今後音声を再生できなくなる状態になった場合にのみ、その要素はガベージコレクションされる可能性があります。

明示的な参照が存在しない要素が音声を再生することは可能です。そのような要素がまだ積極的に再生されていない場合でも、たとえば、一時停止解除されているがコンテンツのバッファリングを待っているか、まだバッファリング中であるが、suspendイベントリスナーが再生を開始する可能性があります。たとえメディアリソースに音声トラックが存在しないメディア要素でも、イベントリスナーがメディアリソースを変更する場合は、再び音声を再生する可能性があります。

各メディア要素には、最初は空である必要がある新しく導入されたキューのリストがあります。テキストトラックキューがキューのリストに追加されるたびに、テキストトラックがメディア要素のテキストトラックのリストに含まれている場合、そのキューはメディア要素の新しく導入されたキューのリストに追加される必要があります。テキストトラックがメディア要素のテキストトラックのリストに追加されるたびに、そのテキストトラックのキューのリストにあるすべてのキューがメディア要素の新しく導入されたキューのリストに追加される必要があります。メディア要素の新しく導入されたキューのリストに新しいキューが追加されたときに、メディア要素のポスター表示フラグが設定されていない場合、ユーザーエージェントは時は進む手順を実行する必要があります。

テキストトラックキューがメディア要素のキューのリストから削除されるとき、またはテキストトラックがメディア要素のテキストトラックのリストから削除されるたびに、メディア要素のポスター表示フラグが設定されていない場合、ユーザーエージェントは時は進む手順を実行する必要があります。

メディア要素の現在の再生位置が変更されるとき（例: 再生やシークによって）、ユーザーエージェントは時は進む手順を実行する必要があります。キューイベントの発火タイミングの精度に依存するユースケース（例: 字幕をビデオのシーン変更と同期させるなど）をサポートするために、ユーザーエージェントはキューイベントをメディアタイムライン上の位置にできるだけ近づけて発火する必要があり、理想的には20ミリ秒以内に発火する必要があります。手順の実行中に現在の再生位置が変更された場合、ユーザーエージェントは手順の完了を待ち、直ちに手順を再実行する必要があります。これらの手順は可能な限り頻繁に、または必要に応じて実行されます。

1回のイテレーションに長い時間がかかると、ユーザーエージェントが「追いつく」ために急いで短時間のキューをスキップすることがあり、そのキューはactiveCuesリストに表示されません。

時は進む手順は次のとおりです:

  1. current cuesをhiddenまたはshowing状態のすべてのテキストトラックのすべてのキューを含むように初期化されたリストとし、これには無効なものは含まれません。これらのキューの開始時刻が現在の再生位置以下であり、終了時刻が現在の再生位置よりも大きい場合に限ります。

  2. other cuesをhiddenおよびshowing状態のすべてのテキストトラックのすべてのキューを含むように初期化されたリストとし、これにはcurrent cuesには存在しないものを含みます。

  3. last timeを、このアルゴリズムが最後にこのメディア要素のために実行されたときの現在の再生位置とし、これが初めて実行される場合は何も行いません。

  4. 通常の再生中に現在の再生位置が通常の単調な増加によってのみ変更された場合、missed cuesを、other cuesに含まれ、開始時刻がlast time以上であり、終了時刻が現在の再生位置以下であるキューのリストとします。それ以外の場合、missed cuesを空のリストとします。

  5. missed cuesに含まれるすべてのキューを削除し、それらがメディア要素の新しく導入されたキューのリストに含まれている場合、そのリストを空にします。

  6. 通常の再生中に通常の単調な増加によって時間が達した場合、過去15〜250ミリ秒以内に要素に対してtimeupdateイベントが発生しておらず、そのようなイベントのイベントハンドラがまだ実行中でない場合、ユーザーエージェントはメディア要素タスクをキューに追加し、要素でイベントを発生させ、名前をtimeupdateとします。（他のケース、例えば明示的なシークでは、関連するイベントが現在の再生位置の変更の全体的なプロセスの一部として発生します。）

    イベントはこのようにして約66Hz以上または4Hz以下で発生させないようにします（イベントハンドラが250ミリ秒以上かからないことを前提とします）。ユーザーエージェントは、システム負荷や各イベント処理の平均コストに基づいてイベントの発生頻度を調整し、ビデオのデコード中にユーザーエージェントが快適に処理できる頻度を超えないようにすることを推奨します。

  7. current cuesのすべてのキューがテキストトラックキューアクティブフラグを設定されており、other cuesのいずれのキューもテキストトラックキューアクティブフラグを設定されておらず、missed cuesが空である場合、手順を終了します。

  8. 通常の再生中に通常の単調な増加によって時間が達し、other cuesにキューが含まれており、それらがテキストトラックキュー一時停止フラグを設定されており、またはそのキューがテキストトラックキューアクティブフラグを設定されている場合、またはmissed cuesに含まれている場合は、即座にメディア要素を一時停止します。

    他のケース、例えば明示的なシークでは、キューの終了時刻を超えるときに再生が一時停止されることはありませんが、そのキューがテキストトラックキュー一時停止フラグを設定されている場合でも同様です。

  9. eventsをタスクのリストとして初期化し、最初は空にします。このリスト内の各タスクは、テキストトラック、テキストトラックキュー、および時間に関連付けられ、タスクがキューに追加される前にリストを並べ替えるために使用されます。

    affected tracksをテキストトラックのリストとして初期化し、最初は空にします。

    以下の手順で、イベントを準備するように指定されたときは、テキストトラックキューのtargetと時間timeに基づいて、ユーザーエージェントは以下の手順を実行する必要があります。

    1. trackをテキストトラックとし、テキストトラックキュー targetが関連付けられているものとします。
    2. タスクを作成し、イベントを発生させ、名前をeventとしてtargetに対して実行します。
    3. 作成したタスクをeventsに追加し、時間time、テキストトラック track、およびテキストトラックキュー targetに関連付けます。
    4. trackをaffected tracksに追加します。
  10. missed cuesに含まれる各テキストトラックキューに対して、イベントを準備し、名前をenterとし、TextTrackCueオブジェクトの開始時刻とします。
  11. other cuesに含まれ、テキストトラックキューアクティブフラグが設定されているか、またはmissed cuesに含まれている各テキストトラックキューに対して、イベントを準備し、名前をexitとし、TextTrackCueオブジェクトの終了時刻および開始時刻の遅い方とします。
  12. current cuesに含まれ、テキストトラックキューアクティブフラグが設定されていない各テキストトラックキューに対して、イベントを準備し、名前をenterとし、TextTrackCueオブジェクトの開始時刻とします。

  13. eventsのタスクを、時間順に昇順で並べ替えます（タスクのうち、時間が早いものを先にします）。

    さらに、同じ時間を持つタスクを、そのテキストトラックキューの順序に従って並べ替えます。

    最後に、同じ時間と同じテキストトラックキューの順序を持つタスクを、enterイベントを発生させるものを、exitイベントを発生させるものの前に配置します。

  14. メディア要素タスクをキューに追加し、メディア要素に対して、events内の各タスクをリストの順に実行します。

  15. affected tracksを、テキストトラックのリスト内でメディア要素が現れる順序で並べ替え、重複を削除します。

  16. affected tracks内の各テキストトラックに対して、リストの順番に、メディア要素タスクをキューに追加し、メディア要素に対して、イベントを発生させ、cuechangeという名前でTextTrackオブジェクトに対して実行します。また、テキストトラックに対応するtrack要素がある場合は、イベントを発生させ、cuechangeという名前でそのtrack要素にも実行します。

  17. current cues内のすべてのキューのテキストトラックキューアクティブフラグを設定し、other cues内のすべてのキューのテキストトラックキューアクティブフラグを解除します。

  18. affected tracks内でshowing状態にある各テキストトラックのテキストトラックレンダリングを更新するためのルールを実行し、テキストトラックのテキストトラック言語が空でない限り、フォールバック言語として提供します。たとえば、WebVTTに基づくテキストトラックの場合、WebVTTテキストトラックの表示を更新するためのルールを使用します。[WEBVTT]

上記のアルゴリズムにおいて、テキストトラックキューは、単にテキストトラックに関連付けられているだけでなく、テキストトラックのキューリストにリストされている場合にのみ、そのテキストトラックの一部と見なされます。

もしメディア要素のノードドキュメントが完全にアクティブなドキュメントでなくなった場合、ドキュメントが再びアクティブになるまで、再生が停止します。

メディア要素がドキュメントから削除された場合、ユーザーエージェントは次のステップを実行する必要があります:

  1. 安定した状態を待つことにより、タスクがメディア要素をドキュメントから削除することを続行させます。このアルゴリズムの残りのステップはすべて同期セクションで構成されます。（同期セクション内のステップは⌛で示されます。）

  2. ⌛ メディア要素がドキュメント内にある場合、リターンします。

  3. ⌛ メディア要素の内部の一時停止手順を実行します。

4.8.11.9 シーク
media.seeking

ユーザーエージェントが現在シーク中の場合、trueを返します。

media.seekable

HTMLMediaElement/seekable

すべての現行エンジンでサポートされています。

Firefox8+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

ユーザーエージェントがシーク可能なメディアリソースの範囲を表すTimeRangesオブジェクトを返します。

media.fastSeek(time)

HTMLMediaElement/fastSeek

Firefox31+Safari8+Chromeサポートされていません
Opera?Edgeサポートされていません
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

できるだけ早く、新しいtimeにシークし、精度をスピードに交換します。（正確な時間にシークするには、currentTime属性を使用してください。）

メディアリソースが読み込まれていない場合は、何も行いません。

seeking属性の初期値はfalseでなければなりません。

fastSeek(time)メソッドは、timeで与えられた時間にシークし、 approximate-for-speedフラグが設定されます。

ユーザーエージェントが特定のnew playback positionにシークする必要がある場合、 任意でapproximate-for-speedフラグが設定されている場合、ユーザーエージェントは次の手順を実行しなければなりません。 このアルゴリズムは、イベントループメカニズムと密接に関係しています。特に、同期セクション（イベントループ アルゴリズムの一部としてトリガーされる）を含んでいます。このセクションのステップは、⌛でマークされています。

  1. メディア要素のポスター表示フラグをfalseに設定します。

  2. 要素のreadyStateがHAVE_NOTHINGである場合、戻ります。

  3. 要素のseekingIDL属性がtrueである場合、 このアルゴリズムの他のインスタンスがすでに実行されています。そのインスタンスを、実行中のステップを完了するのを待たずに中止します。

  4. seekingIDL属性をtrueに設定します。

  5. シークがDOMメソッド呼び出しまたはIDL属性の設定に応じて行われた場合、スクリプトの実行を続行します。これらのステップの残りは並行して実行されなければなりません。⌛でマークされたステップを除いて、このアルゴリズムの別のインスタンスが呼び出された場合、いつでも中止される可能性があります。

  6. new playback positionがメディアリソースの終わりより後である場合、 それをメディアリソースの終わりにします。

  7. new playback positionが最も早い位置より前である場合、 それをその位置に設定します。

  8. （おそらく変更された）new playback positionがseekable属性で示される範囲内にない場合、 それをseekable属性で示される範囲内の new playback positionに最も近い位置にします。この条件を満たす2つの位置がある場合（つまり、new playback positionがseekable属性の2つの範囲のちょうど中間にある場合）、 現在の再生位置に最も近い位置を使用します。seekable属性に範囲がない場合、seekingIDL属性をfalseに設定し、戻ります。

  9. approximate-for-speedフラグが設定されている場合、new playback positionを再生がすぐに再開できるような値に調整します。new playback positionがこのステップの前に現在の再生位置より前である場合、調整されたnew playback positionも現在の再生位置より前でなければなりません。同様に、new playback positionがこのステップの前に現在の再生位置より後である場合、調整されたnew playback positionも現在の再生位置より後でなければなりません。

    例えば、ユーザーエージェントは、再生を再開する前に中間フレームをデコードして破棄する時間を省くために、近くのキーフレームにスナップすることができます。

  10. メディア要素タスクをキューに追加する メディア要素に対して、イベントを発生させる名seekingを発火させます。

  11. 現在の再生位置をnew playback positionに設定します。

    メディア要素が潜在的に再生中だったが、シークによってそのreadyState属性がHAVE_FUTURE_DATAより低い値に変更された場合、waitingイベントが要素に対して発火されます。

    このステップは現在の再生位置を設定します。したがって、ユーザーエージェントが実際にその位置のメディアデータをレンダリングできるかどうかにかかわらず、（次のステップで決定されるように）他の条件、たとえば再生が「メディアリソースの終わりに達する」に関するルールなどが直ちにトリガーされる可能性があります（ループ処理のロジックの一部として）。

    currentTime属性は公式の再生位置を返し、現在の再生位置を返すわけではありません。そのため、このアルゴリズムとは別に、スクリプトの実行前に更新されます。

  12. ユーザーエージェントがnew playback positionのメディアデータが利用可能かどうかを確認し、利用可能であれば、その位置を再生するのに十分なデータがデコードされるまで待機します。

  13. 安定した状態を待機します。同期セクションはこのアルゴリズムの残りのすべてのステップで構成されます。（同期セクションのステップは⌛でマークされています。）

  14. ⌛seekingIDL属性をfalseに設定します。

  15. ⌛時間は進み続けるステップを実行します。

  16. ⌛メディア要素タスクをキューに追加する メディア要素に対して、イベントを発生させる名timeupdateを発火させます。

  17. ⌛メディア要素タスクをキューに追加する メディア要素に対して、イベントを発生させる名seekedを発火させます。

seekable属性は、新しい静的な正規化TimeRangesオブジェクトを返さなければなりません。これは、ユーザーエージェントがシークできるメディアリソースの範囲を表します。この属性が評価される時点で存在する場合に限ります。

ユーザーエージェントがメディアリソースのどこにでもシークできる場合、例えば、単純な映画ファイルであり、ユーザーエージェントとサーバーがHTTP Rangeリクエストをサポートしている場合、この属性は1つの範囲を持つオブジェクトを返します。その開始は最初のフレームの時間（通常はゼロである最も早い位置）であり、その終了は最初のフレームの時間にduration属性の値を加えたものと等しく（最終フレームの時間に等しく、正の無限大である可能性もあります）。

範囲は連続して変化することがあります。例えば、ユーザーエージェントが無限ストリームでスライディングウィンドウをバッファリングしている場合です。これは、DVRがライブTVを視聴する際に見られる動作です。

毎回新しいオブジェクトを返すことは、属性ゲッターにとって悪いパターンであり、ここでのみ、それを変更するのにコストがかかるために記載されています。新しいAPIにコピーするべきではありません。

ユーザーエージェントは、シーク可能な範囲に対して非常に寛容で楽観的な見方を採用するべきです。ユーザーエージェントは、可能な限りシークを迅速に行うために、最近のコンテンツをバッファリングするべきです。

例えば、HTTP RangeリクエストをサポートしないHTTPサーバーで提供される大きなビデオファイルを考えてみてください。ブラウザは、現在のフレームとその後のフレームのデータだけをバッファリングし、シークを許可しない（再生の最初に戻るシークを除く）ことによってこれを実装できます。しかし、これは質の低い実装です。質の高い実装では、ユーザーが何か驚くべきことを再視聴するために即座に戻ることができるように、（または十分なストレージがあればもっと長く）コンテンツの最後の数分をバッファリングし、必要に応じてファイルを再読み込みすることで任意の場所にシークすることを可能にするべきです。これにより速度が遅くなる可能性がありますが、ビデオを最初から再開し、再生されていない部分に到達するためだけに全体を視聴し直すよりも、はるかに便利です。

メディアリソースは内部でスクリプト化されているか、インタラクティブな場合があります。このため、メディア要素は非線形的に再生される可能性があります。この場合、ユーザーエージェントは、シークアルゴリズムが使用されたかのように動作しなければならず、現在の再生位置が不連続に変更されるたびに関連するイベントが発火します。

4.8.11.10 複数のメディアトラックを持つメディアリソース

メディアリソースには、複数の埋め込みオーディオおよびビデオトラックが含まれる場合があります。たとえば、主要なビデオおよびオーディオトラックに加えて、メディアリソースには、外国語の吹き替え、監督のコメント、音声説明、別のアングル、または手話のオーバーレイが含まれる場合があります。

media.audioTracks

HTMLMediaElement/audioTracks

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

AudioTrackListオブジェクトを返します。このオブジェクトは、メディアリソースで利用可能なオーディオトラックを表します。

media.videoTracks

HTMLMediaElement/videoTracks

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

VideoTrackListオブジェクトを返します。このオブジェクトは、メディアリソースで利用可能なビデオトラックを表します。

メディア要素のaudioTracks属性は、ライブのAudioTrackListオブジェクトを返さなければなりません。このオブジェクトは、メディア要素のメディアリソースで利用可能なオーディオトラックを表します。

メディア要素のvideoTracks属性は、ライブのVideoTrackListオブジェクトを返さなければなりません。このオブジェクトは、メディア要素のメディアリソースで利用可能なビデオトラックを表します。

1つのメディア要素につき、1つのAudioTrackListオブジェクトと1つのVideoTrackListオブジェクトのみが存在します。別のメディアリソースが要素にロードされた場合でも、オブジェクトは再利用されます。（ただし、AudioTrackオブジェクトやVideoTrackオブジェクトは再利用されません。）

4.8.11.10.1 AudioTrackList および VideoTrackList オブジェクト

AudioTrackList

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

VideoTrackList

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

AudioTrackList およびVideoTrackList インターフェースは、前のセクションで定義された属性によって使用されます。

AudioTrack

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari8+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

VideoTrack

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android? 
[Exposed=Window]
 interface AudioTrackList : EventTarget {
   readonly attribute unsigned long length;
   getter AudioTrack (unsigned long index);
   AudioTrack? getTrackById(DOMString id);
 
   attribute EventHandler onchange;
   attribute EventHandler onaddtrack;
   attribute EventHandler onremovetrack;
 };
 
 [Exposed=Window]
 interface AudioTrack {
   readonly attribute DOMString id;
   readonly attribute DOMString kind;
   readonly attribute DOMString label;
   readonly attribute DOMString language;
   attribute boolean enabled;
 };
 
 [Exposed=Window]
 interface VideoTrackList : EventTarget {
   readonly attribute unsigned long length;
   getter VideoTrack (unsigned long index);
   VideoTrack? getTrackById(DOMString id);
   readonly attribute long selectedIndex;
 
   attribute EventHandler onchange;
   attribute EventHandler onaddtrack;
   attribute EventHandler onremovetrack;
 };
 
 [Exposed=Window]
 interface VideoTrack {
   readonly attribute DOMString id;
   readonly attribute DOMString kind;
   readonly attribute DOMString label;
   readonly attribute DOMString language;
   attribute boolean selected;
 };
media.audioTracks.length

AudioTrackList/length

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
media.videoTracks.length

VideoTrackList/length

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

リスト内のトラックの数を返します。

audioTrack = media.audioTracks[index]
videoTrack = media.videoTracks[index]

指定されたAudioTrack またはVideoTrackオブジェクトを返します。

audioTrack = media.audioTracks.getTrackById(id)

AudioTrackList/getTrackById

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
videoTrack = media.videoTracks.getTrackById(id)

VideoTrackList/getTrackById

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたIDを持つAudioTrack またはVideoTrackオブジェクトを返します。トラックにそのIDがない場合はnullを返します。

audioTrack.id

AudioTrack/id

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari8+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
videoTrack.id

VideoTrack/id

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックのIDを返します。これは、フォーマットがメディアフラグメント構文をサポートしている場合にフラグメントに使用でき、getTrackById()メソッドで使用できます。

audioTrack.kind

AudioTrack/kind

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari8+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
videoTrack.kind

VideoTrack/kind

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックのカテゴリを返します。考えられるトラックカテゴリは下記に示されています。

audioTrack.label

AudioTrack/label

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari8+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
videoTrack.label

VideoTrack/label

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックのラベルが既知の場合はラベルを、そうでない場合は空文字列を返します。

audioTrack.language

AudioTrack/language

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari8+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
videoTrack.language

VideoTrack/language

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックの言語を返します。既知の場合は言語を、そうでない場合は空文字列を返します。

audioTrack.enabled [ = value ]

AudioTrack/enabled

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari8+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックがアクティブであればtrueを返し、そうでなければfalseを返します。

設定することにより、トラックが有効かどうかを変更できます。複数のオーディオトラックが同時に有効になっている場合、それらはミックスされます。

media.videoTracks.selectedIndex

VideoTrackList/selectedIndex

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

現在選択されているトラックのインデックスを返し、そうでなければ−1を返します。

videoTrack.selected [ = value ]

VideoTrack/selected

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (レガシー)サポートされていませんInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックがアクティブであればtrueを返し、そうでなければfalseを返します。

設定することにより、トラックが選択されているかどうかを変更できます。選択されたトラックが1つだけであり、前のトラックが選択されている場合、新しいトラックを選択すると前のトラックが選択解除されます。

AudioTrackList オブジェクトは、ゼロまたはそれ以上のオーディオトラックの動的リストを表し、そのうちゼロまたは複数が同時に有効にできます。各オーディオトラックは、AudioTrackオブジェクトで表されます。

VideoTrackList オブジェクトは、ゼロまたはそれ以上のビデオトラックの動的リストを表し、そのうちゼロまたは1つが同時に選択できます。各ビデオトラックは、VideoTrackオブジェクトで表されます。

AudioTrackListとVideoTrackListオブジェクト内のトラックは、一貫して順序付けられている必要があります。メディアリソースが順序を定義する形式である場合は、その順序を使用しなければなりません。そうでない場合は、トラックがメディアリソース内で宣言された相対的な順序が使用されなければなりません。使用される順序は、リストの自然順序と呼ばれます。

これらのオブジェクト内の各トラックにはインデックスが付与され、最初のトラックはインデックス0を持ち、次の各トラックは前のものよりも1つ高い番号が付けられます。メディアリソースが動的にオーディオまたはビデオトラックを追加または削除すると、トラックのインデックスは動的に変更されます。メディアリソースが完全に変更される場合、以前のすべてのトラックが削除され、新しいトラックに置き換えられます。

AudioTrackListとVideoTrackListのlength属性ゲッターは、取得時にそのオブジェクトが表すトラックの数を返す必要があります。

サポートされているプロパティインデックスは、その瞬間にAudioTrackListとVideoTrackListオブジェクトが表すトラックの数から1を引いた数までの数字です。もしAudioTrackListまたはVideoTrackListオブジェクトがトラックを表していない場合、それはサポートされているプロパティインデックスを持っていません。

インデックスプロパティの値を決定するには、指定されたindexに対してAudioTrackListまたはVideoTrackListオブジェクト内のトラックをlistから取得する必要があります。ユーザーエージェントは、そのindexに対応するAudioTrackまたはVideoTrackオブジェクトを返す必要があります。

AudioTrackListとVideoTrackListのgetTrackById(id)メソッドは、id引数の値と一致する最初のAudioTrackまたはVideoTrackオブジェクト（それぞれ）を返す必要があります。引数に一致するトラックがない場合、メソッドはnullを返す必要があります。

AudioTrackおよびVideoTrackオブジェクトは、メディアリソースの特定のトラックを表します。各トラックには、識別子、カテゴリ、ラベル、言語が付与されることがあります。これらのトラックの特性は、トラックの存続期間中は変わりません。たとえトラックがAudioTrackListまたはVideoTrackListオブジェクトから削除されても、これらの特性は変更されません。

また、AudioTrackオブジェクトは、それぞれ有効または無効にできます。これはオーディオトラックの有効状態です。AudioTrackが作成されると、その有効状態はfalse（無効）に設定される必要があります。リソースフェッチアルゴリズムがこれを上書きすることができます。

同様に、VideoTrackオブジェクトはVideoTrackListオブジェクト内で一つだけ選択されることができます。これはビデオトラックの選択状態です。VideoTrackが作成されると、その選択状態はfalse（未選択）に設定される必要があります。リソースフェッチアルゴリズムがこれを上書きすることができます。

AudioTrackのid属性およびVideoTrackのid属性は、トラックに識別子がある場合はその識別子を、ない場合は空の文字列を返さなければなりません。メディアリソースがメディアフラグメント構文をサポートしている形式の場合、特定のトラックに対して返される識別子は、そのようなフラグメントのトラック次元におけるトラック名として使用された場合に、そのトラックを有効にするのと同じ識別子でなければなりません。[INBAND]

例えば、Oggファイルでは、これはトラックのNameヘッダーフィールドになります。[OGGSKELETONHEADERS]

AudioTrackとVideoTrackのkind属性は、そのトラックのカテゴリを返す必要があり、そうでない場合は空の文字列を返す必要があります。

トラックのカテゴリは、以下の表の最初の列にある文字列で、そのトラックに最も適しているものです。表の第2および第3列の定義に基づいて判断され、メディアリソースに含まれるメタデータによって決定されます。表の第3列にあるセルは、その列の最初の列にあるカテゴリがどのトラックに適用されるかを示します。カテゴリは、オーディオトラックに適用される場合にのみオーディオトラックに適しており、ビデオトラックに適用される場合にのみビデオトラックに適しています。カテゴリは、AudioTrackオブジェクトに適している場合にのみ返されるべきであり、VideoTrackオブジェクトに適している場合にのみ返されるべきです。

Oggファイルの場合、トラックのRoleヘッダーフィールドが関連するメタデータを提供します。DASHメディアリソースの場合、Role要素が情報を伝えます。WebMの場合、現在はFlagDefault要素のみが値にマッピングされます。HTMLへのメディアコンテナからのインバンドメディアリソーストラックのソーシングには詳細が記載されています。[OGGSKELETONHEADERS] [DASH] [WEBMCG] [INBAND]

AudioTrack のkind とVideoTrack のkind の返り値
カテゴリ 定義 適用範囲 例
"alternative" メイントラックの代替可能なトラック、例: 別テイクの曲（オーディオ）や別の角度（ビデオ）。 オーディオおよびビデオ。 Ogg: "audio/alternate" または "video/alternate"；DASH: "main" および "commentary" 役割がない "alternate"、およびオーディオの場合は "dub" 役割がないもの（他の役割は無視）。
"captions" 字幕が焼き付けられたメインビデオトラックのバージョン。（レガシーコンテンツ用；新しいコンテンツはテキストトラックを使用する）。 ビデオのみ。 DASH: "caption" および "main" 役割が一緒に（他の役割は無視）。
"descriptions" ビデオトラックのオーディオディスクリプション。 オーディオのみ。 Ogg: "audio/audiodesc"。
"main" 主要なオーディオまたはビデオトラック。 オーディオおよびビデオ。 Ogg: "audio/main" または "video/main"；WebM: "FlagDefault" 要素が設定されている；DASH: "caption"、"subtitle"、および "dub" 役割がない "main" 役割（他の役割は無視）。
"main-desc" オーディオディスクリプションが混ざった主要なオーディオトラック。 オーディオのみ。 MPEG-2 TS のAC3オーディオ: bsmod=2 および full_svc=1。
"sign" オーディオトラックの手話通訳。 ビデオのみ。 Ogg: "video/sign"。
"subtitles" 字幕が焼き付けられたメインビデオトラックのバージョン。（レガシーコンテンツ用；新しいコンテンツはテキストトラックを使用する）。 ビデオのみ。 DASH: "subtitle" および "main" 役割が一緒に（他の役割は無視）。
"translation" 主要なオーディオトラックの翻訳版。 オーディオのみ。 Ogg: "audio/dub"。DASH: "dub" および "main" 役割が一緒に（他の役割は無視）。
"commentary" 主要なオーディオまたはビデオトラックの解説、例: 監督の解説。 オーディオおよびビデオ。 DASH: "main" 役割がない "commentary" 役割（他の役割は無視）。
""（空文字列） 明示的な種類がないか、トラックのメタデータで指定された種類がユーザーエージェントによって認識されない。 オーディオおよびビデオ。

AudioTrackとVideoTrackのlabelおよびlabel属性は、トラックにラベルがある場合はそのラベルを返し、そうでない場合は空の文字列を返す必要があります。[INBAND]

AudioTrackとVideoTrackのlanguageおよびlanguage属性は、トラックの言語がある場合はその言語のBCP 47言語タグを返し、そうでない場合は空の文字列を返す必要があります。ユーザーエージェントがその言語をBCP 47言語タグとして表現できない場合（例えば、メディアリソースの形式内の言語情報が解釈が定義されていない自由形式の文字列である場合など）、そのメソッドは、トラックに言語がないかのように空の文字列を返す必要があります。[INBAND]

AudioTrackのenabled属性は、取得時にトラックが現在有効であればtrueを返し、そうでなければfalseを返す必要があります。設定時には、新しい値がtrueであればトラックを有効にし、それ以外の場合は無効にする必要があります。（トラックがAudioTrackListオブジェクトにもう存在しない場合、トラックが有効または無効になってもAudioTrackオブジェクトの属性値を変更すること以外には影響がありません。）

AudioTrackList内のオーディオトラックが無効から有効になった場合、または有効から無効になった場合、ユーザーエージェントはメディア要素タスクをキューに追加する必要があり、AudioTrackListオブジェクトでchangeという名前のイベントを発火する必要があります。

特定の位置にデータが存在しないか、その位置に存在しないオーディオトラックは、そのタイムラインのポイントで無音と見なされる必要があります。

VideoTrackListのselectedIndex属性は、現在選択されているトラックのインデックスを返す必要があります。VideoTrackListオブジェクトが現在トラックを表していない場合、またはトラックが選択されていない場合、代わりに−1を返す必要があります。

VideoTrackのselected属性は、取得時にトラックが現在選択されている場合はtrueを返し、そうでない場合はfalseを返す必要があります。設定時には、新しい値がtrueであればトラックを選択し、それ以外の場合は選択を解除する必要があります。トラックがVideoTrackListに含まれている場合、そのリスト内の他のすべてのVideoTrackオブジェクトは選択解除される必要があります。（トラックがVideoTrackListオブジェクトにもう存在しない場合、トラックが選択または非選択になってもVideoTrackオブジェクトの属性値を変更すること以外には影響がありません。）

VideoTrackList内の以前選択されていなかったトラックが選択された場合、およびVideoTrackList内の選択されたトラックが、新しいトラックが代わりに選択されないまま非選択になった場合、ユーザーエージェントはメディア要素タスクをキューに追加する必要があり、VideoTrackListオブジェクトでchangeという名前のイベントを発火する必要があります。このタスクは、resizeイベントを発火させるタスクの前にキューに追加される必要があります。

特定の位置にデータが存在しないビデオトラックは、そのタイムラインのポイントで透明な黒として解釈される必要があり、その位置の直前のフレームと同じ寸法、またはその位置がそのトラックのすべてのデータよりも前である場合はそのトラックの最初のフレームと同じ寸法を持つ必要があります。現在の位置にまったく存在しないトラックは、存在するがデータがないかのように扱われる必要があります。

例えば、ビデオに再生開始から1時間後にのみ導入されるトラックがあり、ユーザーがそのトラックを選択してから開始時点に戻ると、ユーザーエージェントはそのトラックがメディアリソースの開始時点から始まっていたかのように振る舞い、1時間経過するまで単に透明であったかのように扱います。

次に示すのは、イベントハンドラー（およびそれに対応するイベントハンドラーイベントタイプ）であり、イベントハンドラーIDL属性として、AudioTrackListおよびVideoTrackListインターフェースを実装するすべてのオブジェクトによってサポートされなければなりません：

イベントハンドラー イベントハンドラーイベントタイプ
onchange

AudioTrackList/change_event

すべての現在のエンジンでサポートされています。

Firefox🔰 33+ Safari7+ Chrome🔰 37+
Opera? Edge🔰 79+
Edge (Legacy)No Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

TextTrackList/change_event

すべての現在のエンジンでサポートされています。

Firefox31+ Safari7+ Chrome33+
Opera? Edge79+
Edge (Legacy)18 Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android4.4+ Samsung Internet? Opera Android?

VideoTrackList/change_event

すべての現在のエンジンでサポートされています。

Firefox🔰 33+ Safari7+ Chrome🔰 37+
Opera? Edge🔰 79+
Edge (Legacy)No Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
change
onaddtrack

AudioTrackList/addtrack_event

すべての現在のエンジンでサポートされています。

Firefox🔰 33+ Safari7+ Chrome🔰 37+
Opera? Edge🔰 79+
Edge (Legacy)No Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

TextTrackList/addtrack_event

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer11
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

VideoTrackList/addtrack_event

すべての現在のエンジンでサポートされています。

Firefox🔰 33+ Safari7+ Chrome🔰 37+
Opera? Edge🔰 79+
Edge (Legacy)No Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
addtrack
onremovetrack

AudioTrackList/removetrack_event

すべての現在のエンジンでサポートされています。

Firefox🔰 33+ Safari7+ Chrome🔰 37+
Opera? Edge🔰 79+
Edge (Legacy)No Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

TextTrackList/removetrack_event

すべての現在のエンジンでサポートされています。

Firefox31+ Safari7+ Chrome33+
Opera20+ Edge79+
Edge (Legacy)18 Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android4.4+ Samsung Internet? Opera Android20+

VideoTrackList/removetrack_event

すべての現在のエンジンでサポートされています。

Firefox🔰 33+ Safari7+ Chrome🔰 37+
Opera? Edge🔰 79+
Edge (Legacy)No Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
removetrack
4.8.11.10.2 特定のオーディオおよびビデオトラックを宣言的に選択する

audioTracksおよびvideoTracks属性を使用して、スクリプトで再生するトラックを選択できますが、フラグメントを指定することで、URLのメディアリソースの特定のトラックを宣言的に選択することも可能です。フラグメントの形式は、MIMEタイプによって異なります。メディアリソース。[RFC2046] [URL]

この例では、メディアフラグメント構文をサポートする形式を使用するビデオが埋め込まれており、デフォルトのビデオトラックの代わりに「Alternative」とラベル付けされた別のアングルが有効になっています。

<video src="myvideo#track=Alternative"></video>
4.8.11.11 タイムドテキストトラック
4.8.11.11.1 テキストトラックモデル

メディア要素には、テキストトラックと呼ばれる関連するテキストトラックのグループが含まれることがあります。これらはメディア要素のテキストトラックのリストとして知られています。テキストトラックは次のように並べ替えられます:

  1. テキストトラックは、track要素がメディア要素の子要素として存在し、ツリー順で並べ替えられます。

  2. テキストトラックは、addTextTrack()メソッドを使用して追加され、追加された順に古いものから新しいものへと並べ替えられます。

  3. メディアリソース固有のテキストトラック（テキストトラックはメディアリソース内のデータに対応するもの）で、メディアリソースのフォーマット仕様によって定義された順序で並べ替えられます。

テキストトラックは以下の要素で構成されます:

テキストトラックの種類

この要素はユーザーエージェントがトラックをどのように処理するかを決定します。種類は文字列で表され、可能な文字列は次のとおりです:

トラックの種類は、テキストトラックがtrack要素に対応する場合、動的に変更されることがあります。

ラベル

これは、ユーザーがトラックを識別するための人間が読みやすい文字列です。

トラックのラベルは、テキストトラックがtrack要素に対応する場合、動的に変更されることがあります。

テキストトラックのラベルが空文字列である場合、ユーザーエージェントは、テキストトラックの他のプロパティ（例: テキストトラックの種類や言語）から自動的に適切なラベルを生成して、ユーザーインターフェースで使用する必要があります。この自動生成されたラベルはAPIに公開されません。

インバンドメタデータトラックディスパッチタイプ

これは、インバンドメタデータトラック用にメディアリソースから抽出された文字列で、これにより、これらのトラックがドキュメント内の異なるスクリプトにディスパッチされるようになります。

例えば、ウェブでストリーミングされる従来のテレビ局の放送に、ウェブ固有のインタラクティブな機能が追加されている場合、メタデータを含むテキストトラックには、広告ターゲティング、ゲームショー中のトリビアゲームデータ、スポーツゲーム中のプレイヤーの状態、料理番組中のレシピ情報などが含まれることがあります。各プログラムが開始および終了すると、新しいトラックがストリームに追加されたり削除されたりする可能性があり、それらが追加されると、ユーザーエージェントはこの属性の値を使用して、専用のスクリプトモジュールにバインドすることができます。

インバンドメタデータテキストトラック以外の場合、インバンドメタデータトラックディスパッチタイプは空文字列です。さまざまなメディア形式に対してこの値がどのように設定されるかについては、メディアリソース固有のテキストトラックを公開する手順で説明されています。

言語

これは、テキストトラックのキューの言語を表す文字列（BCP 47言語タグ）です。[BCP47]

テキストトラックの言語は、テキストトラックがtrack要素に対応する場合、動的に変更されることがあります。

準備状態

次のいずれかです:

未ロード

テキストトラックのキューが取得されていないことを示します。

ロード中

テキストトラックがロード中であり、これまでに致命的なエラーは発生していないことを示します。トラックには、パーサーによってさらにキューが追加される可能性があります。

ロード済み

テキストトラックが致命的なエラーなしでロードされたことを示します。

ロードに失敗

テキストトラックが有効化されたが、ユーザーエージェントがこれを取得しようとした際に何らかの方法で失敗したことを示します（例：URLが解析できなかった、ネットワークエラー、不明なテキストトラック形式など）。キューの一部または全体が欠落しており、取得されることはありません。

テキストトラックの準備状態は、トラックの取得に伴い動的に変化します。

モード

次のいずれかです:

無効

テキストトラックがアクティブでないことを示します。トラックをDOMに公開する目的以外では、ユーザーエージェントはテキストトラックを無視します。キューはアクティブにならず、イベントも発生せず、ユーザーエージェントはトラックのキューを取得しようとしません。

非表示

テキストトラックがアクティブであるが、ユーザーエージェントがキューを積極的に表示していないことを示します。トラックのキューを取得しようとしたことがない場合、ユーザーエージェントは間もなくその試みを行います。ユーザーエージェントはアクティブなキューのリストを維持しており、イベントが適切に発生します。

表示中

テキストトラックがアクティブであることを示します。トラックのキューを取得しようとしたことがない場合、ユーザーエージェントは間もなくその試みを行います。ユーザーエージェントはアクティブなキューのリストを維持しており、イベントが適切に発生します。さらに、トラックの種類がsubtitlesまたはcaptionsであるテキストトラックの場合、キューは適切にビデオにオーバーレイされます。トラックの種類がdescriptionsであるテキストトラックの場合、ユーザーエージェントはキューを視覚的でない方法でユーザーに提供します。トラックの種類がchaptersであるテキストトラックの場合、ユーザーエージェントはユーザーがキューを選択してメディアリソース内の任意のポイントに移動できるメカニズムを提供します。

ゼロまたはそれ以上のキューのリスト

これは、テキストトラックキューのリストであり、テキストトラックレンダリングの更新ルールも含まれます。例えば、WebVTTでは、WebVTTテキストトラックの表示を更新するためのルールなどです。[WEBVTT]

テキストトラックのキューのリストは動的に変化することがあります。例えば、テキストトラックがまだロードされていない場合や、ロード中である場合、またはDOM操作による場合です。

各テキストトラックには、対応するTextTrackオブジェクトがあります。

各メディア要素には、保留中のテキストトラックのリストが含まれており、最初は空である必要があります。また、パーサーによってブロックされたフラグも含まれており、最初はfalseに設定されている必要があります。さらに、自動トラック選択を実行したかどうかのフラグも含まれており、これも最初はfalseに設定されている必要があります。

ユーザーエージェントが保留中のテキストトラックのリストを設定する必要があるとき、ユーザーエージェントは、メディア要素の保留中のテキストトラックのリストに、その要素のテキストトラックのリストに含まれる各テキストトラックを追加しなければなりません。その際、テキストトラックモードが無効でなく、テキストトラックの準備状態が読み込み中である必要があります。

要素の親ノードが変更されるたびに、ユーザーエージェントは、対応するテキストトラックを、含まれている保留中のテキストトラックのリストから削除する必要があります。

テキストトラックのテキストトラックの準備状態がロード済みまたはロードに失敗のいずれかに変更されるたびに、ユーザーエージェントはそのトラックを含まれている保留中のテキストトラックのリストから削除する必要があります。

メディア要素がHTMLパーサーまたはXMLパーサーによって作成されると、ユーザーエージェントはその要素のパーサーによってブロックされたフラグをtrueに設定する必要があります。メディア要素がHTMLパーサーまたはXMLパーサーのスタックからポップオフされると、ユーザーエージェントはユーザーの自動テキストトラック選択に関する設定を尊重し、保留中のテキストトラックのリストを埋める必要があり、要素のパーサーによってブロックされたフラグをfalseに設定する必要があります。

テキストトラックがメディア要素の準備が整っている状態になるのは、要素の保留中のテキストトラックのリストが空であり、要素のパーサーによってブロックされたフラグがfalseである場合です。

各メディア要素には、保留中のテキストトラック変更通知フラグが含まれており、最初はリセットされている必要があります。

テキストトラックがメディア要素のテキストトラックのリストに含まれている場合、そのテキストトラックモードが変更された場合、ユーザーエージェントは次の手順を実行する必要があります:

  1. メディア要素の保留中のテキストトラック変更通知フラグが設定されている場合、リターンします。

  2. メディア要素の保留中のテキストトラック変更通知フラグを設定します。

  3. メディア要素タスクをキューに追加し、次の手順を実行します:

    1. メディア要素の保留中のテキストトラック変更通知フラグをリセットします。

    2. イベントを発生させる、イベント名はchangeで、メディア要素のtextTracks属性のTextTrackListオブジェクトで発生します。

  4. メディア要素のポスターフラグを表示するが設定されていない場合、時間が進行する手順を実行します。

このセクションに記載されているタスクのタスクソースは、DOM操作タスクソースです。

テキストトラックキューは、テキストトラック内の時間に敏感なデータの単位であり、たとえば、字幕やキャプションにおいて、特定の時間に表示され、別の時間に消えるテキストに対応します。

各テキストトラックキューは以下で構成されます:

識別子

任意の文字列です。

開始時間

メディアデータのどの範囲にキューが適用されるかを示す時間（秒および秒の小数部）です。

終了時間

メディアデータのどの範囲にキューが適用されるかを示す時間（秒および秒の小数部）です。ただし、無制限のテキストトラックキューの場合は正の無限大になります。

終了時に一時停止フラグ

キューが適用される範囲の終了時にメディアリソースの再生を一時停止するかどうかを示すブール値です。

追加のフォーマット固有データ

フォーマットに必要な追加フィールド、およびキューの実際のデータが含まれます。たとえば、WebVTTにはテキストトラックキューの書字方向などがあります。[WEBVTT]

無制限のテキストトラックキューは、終了時間が正の無限大に設定されたテキストトラックキューです。アクティブな無制限のテキストトラックキューは、通常の再生中に現在の再生位置の単調な増加によって非アクティブになることはありません（例: 終了時間が発表されていないライブイベントのチャプター用のメタデータキュー）。

テキストトラックキューの開始時間およびテキストトラックキューの終了時間は負の値である場合があります。（ただし、現在の再生位置は負の値になることはないため、ゼロ時点前のキューはアクティブにはなりません。）

各テキストトラックキューには、対応するTextTrackCueオブジェクト（または、TextTrackCueから継承されたオブジェクト、例えばWebVTTキューはVTTCueインターフェースを使用）があります。テキストトラックキューのメモリ内表現は、このTextTrackCueAPIを介して動的に変更することができます。[WEBVTT]

テキストトラックキューは、特定の種類のテキストトラックキューに対して仕様で定義されたテキストトラックレンダリングを更新するためのルールに関連付けられています。これらのルールは、キューを表すオブジェクトがTextTrackオブジェクトにaddCue()メソッドを使用して追加されたときに特に使用されます。

さらに、各テキストトラックキューには、2つの動的な情報があります:

アクティブフラグ

このフラグは最初はリセットされています。フラグは、キューがアクティブまたは非アクティブになったときに適切にイベントが発生するようにし、適切なキューがレンダリングされるようにするために使用されます。

ユーザーエージェントは、このフラグを次のタイミングで同期的にリセットする必要があります: テキストトラックキューがそのテキストトラックのテキストトラックのキューリストから削除された場合、テキストトラック自体がそのメディア要素のテキストトラックリストから削除された場合、またはテキストトラックモードが無効に変更された場合、さらに、メディア要素のreadyStateが再度HAVE_NOTHINGに変更された場合です。この方法でフラグが1つ以上のテキストトラックのキューに対してリセットされた場合、ユーザーエージェントは、影響を受けたすべてのキューのフラグをリセットした後、それらのテキストトラックのテキストトラックレンダリングを更新するためのルールを適用する必要があります。たとえば、WebVTTベースのテキストトラックの場合、WebVTTテキストトラックの表示を更新するためのルールなどです。[WEBVTT]

表示状態

これはレンダリングモデルの一部として使用され、キューを一貫した位置に保ちます。最初は空です。テキストトラックキューアクティブフラグがリセットされるたびに、ユーザーエージェントはテキストトラックキュー表示状態を空にする必要があります。

テキストトラックキューは、メディア要素のテキストトラックに属しており、これらのキューはテキストトラックキューの順序で相互に並べ替えられます。この順序は次のように決定されます: 最初にキューをテキストトラックごとにグループ化し、グループはそのテキストトラックがメディア要素のテキストトラックのリストに現れる順序で並べ替えられます。その後、各グループ内でキューは、その開始時間に従って並べ替えられ、最も早いものが最初に並べ替えられます。その後、同じ開始時間を持つキューは、その終了時間に従って並べ替えられ、最も遅いものが最初に並べ替えられます。最後に、同じ終了時間を持つキューは、それぞれが最後にテキストトラックのキューリストに追加された順序で並べ替えられ、最も古いものが最初になります（たとえば、WebVTTファイルからのキューの場合、最初はファイルに記載された順序になります）。[WEBVTT]

4.8.11.11.2 インバンドテキストトラックの取得

メディアリソース固有のテキストトラックは、テキストトラックであり、 メディアリソースに含まれるデータに対応します。

そのようなデータの処理とレンダリングのルールは、関連する仕様、例えばメディアリソースがビデオである場合にはビデオフォーマットの仕様によって定義されます。 いくつかのレガシーフォーマットの詳細は、HTMLへのメディアコンテナからのインバンドメディアリソーストラックの取得で確認できます。[INBAND]

メディアリソースが ユーザーエージェントが認識し、テキストトラック として同等とみなされるデータを含む場合、ユーザーエージェントはその関連データでメディアリソース固有のテキストトラックを公開する手順を実行します。

  1. 関連するデータを新しいテキストトラックおよび対応する新しい TextTrackオブジェクトに関連付けます。 テキストトラックは、メディアリソース固有のテキストトラックです。

  2. 新しいテキストトラックの種別、ラベル、および言語を、関連データの意味に基づいて設定します。 そのデータにラベルがない場合は、ラベルを空文字列に設定しなければなりません。

  3. テキストトラックのキューリストを そのフォーマットに適したテキストトラックレンダリングの更新ルールと関連付けます。

  4. 新しいテキストトラックの種別がchapters またはmetadataである場合は、インバンドメタデータトラックのディスパッチタイプ を次のように設定します。

    メディアリソースがOggファイルの場合
    インバンドメタデータトラックのディスパッチタイプは、Nameヘッダーフィールドの値に設定されなければなりません。[OGGSKELETONHEADERS]
    メディアリソースがWebMファイルの場合
    インバンドメタデータトラックのディスパッチタイプは、CodecID要素の値に設定されなければなりません。[WEBMCG]
    メディアリソースがMPEG-2ファイルの場合
    stream typeは、プログラムマップセクション内のファイルのテキストトラックのタイプを記述する"stream_type"フィールドの値で、8ビットの符号なし整数として解釈されます。 lengthは、同じ部分のプログラムマップセクション内のトラックの"ES_info_length"フィールドの値で、動画像および関連音声情報の一般的なコーディングによって定義された整数として解釈されます。 descriptor bytesは、"ES_info_length"フィールドの後に続くlengthバイトです。 インバンドメタデータトラックのディスパッチタイプは、stream typeバイトとゼロまたはそれ以上のdescriptor bytesバイトを連結したものであり、16進数でASCII上位16進桁を使用して表現されます。 [MPEG2]
    メディアリソースがMPEG-4ファイルの場合
    ファイルの最初のmoovボックスの trakボックス内の最初のmdiaボックスの 最初のminfボックスの 最初のstblボックスの 最初のstsdボックスをstsdボックスとします（存在する場合）。 ファイルにstsdボックスがない場合、またはstsdボックスにmettボックスもmetxボックスもない場合、インバンドメタデータトラックのディスパッチタイプは空の文字列に設定されなければなりません。 それ以外の場合、stsdボックスにmettボックスがある場合は、インバンドメタデータトラックのディスパッチタイプは、文字列"mett"、U+0020スペース文字、および最初のmettボックスの最初のmime_formatフィールドの値の連結したものに設定されなければなりません。 そのボックスにそのフィールドがない場合は、空の文字列に設定されなければなりません。 それ以外の場合、stsdボックスにmettボックスはなく、metxボックスがある場合は、インバンドメタデータトラックのディスパッチタイプ は、文字列"metx"、U+0020スペース文字、および最初のmetxボックスの最初のnamespaceフィールドの値の連結したものに設定されなければなりません。 そのボックスにそのフィールドがない場合は、空の文字列に設定されなければなりません。 [MPEG4]

  5. 新しいテキストトラックのキューリストをこれまでに解析されたキューで埋め、キューの公開に関するガイドラインに従い、それを動的に更新し始めます。

  6. 新しいテキストトラックの準備状態を読み込み済みに設定します。

  7. 新しいテキストトラックのモードを、ユーザーの好みや関連する仕様の要求に一致するモードに設定します。

    例えば、他にアクティブな字幕がなく、これが強制字幕トラック（音声トラックの主要な言語で字幕を提供するが、実際に他の言語での音声にのみ字幕を提供する）である場合、ここでその字幕がアクティブになるかもしれません。

  8. 新しいテキストトラックをメディア要素のテキストトラックのリストに追加します。

  9. イベントをaddtrack という名前でメディア要素のtextTracks 属性のTextTrackList オブジェクトに対して発生させ、TrackEventを使用して、 track属性をテキストトラックのTextTrackオブジェクトに初期化します。

4.8.11.11.3 アウトバンドテキストトラックの取得

track要素が作成されると、新しいテキストトラック（以下で定義される値が設定されたもの）および対応する新しい TextTrackオブジェクトと関連付けられなければなりません。

テキストトラックの種別は、要素のkind属性の状態に基づき、次の表に従って決定されます。 最初の列に記載されている状態に対して、種別は2列目に示される文字列です。

状態 文字列
字幕 subtitles
キャプション captions
説明 descriptions
チャプターメタデータ chapters
メタデータ metadata

テキストトラックのラベルは、この要素のトラックラベルです。

テキストトラックの言語は、要素のトラックの言語（存在する場合）であり、存在しない場合は空文字列です。

kind、label、およびsrclang属性が設定、変更、または削除されると、テキストトラックは、上記の定義に従って更新されなければなりません。

トラックURLの変更は、以下のアルゴリズムで処理されます。

テキストトラックの準備状態は初期状態では未ロードであり、テキストトラックのモードは初期状態では無効です。

テキストトラックのキューリストは初期状態では空です。参照されたファイルが解析されると動的に変更されます。このリストに関連するのは、該当するフォーマットに適したテキストトラックのレンダリングを更新するためのルールであり、WebVTTの場合、これはWebVTTテキストトラックの表示を更新するためのルールです。[WEBVTT]

track要素の親要素が変更され、新しい親がメディア要素の場合、ユーザーエージェントはそのtrack要素に対応するテキストトラックをメディア要素のテキストトラックのリストに追加し、メディア要素タスクをキューに入れ、そのメディア要素に対してイベントをaddtrackという名前で発生させなければなりません。 これは、メディア要素のtextTracks属性のTextTrackListオブジェクトを使用して行われ、TrackEventを使用して、track属性がテキストトラックのTextTrackオブジェクトに初期化されます。

track要素の親要素が変更され、古い親がメディア要素であった場合、ユーザーエージェントはそのtrack要素に対応するテキストトラックをメディア要素のテキストトラックのリストから削除し、メディア要素タスクをキューに入れ、そのメディア要素に対してイベントをremovetrackという名前で発生させなければなりません。 これは、メディア要素のtextTracks属性のTextTrackListオブジェクトを使用して行われ、TrackEventを使用して、track属性がテキストトラックのTextTrackオブジェクトに初期化されます。

テキストトラックが、track要素に対応してメディア要素のテキストトラックのリストに追加されると、ユーザーエージェントは、そのメディア要素に対して次の手順を実行するためにメディア要素タスクをキューに入れなければなりません。

  1. 要素のparserによるブロックフラグがtrueの場合、戻ります。

  2. 要素の自動トラック選択を実行したフラグがtrueの場合、戻ります。

  3. この要素に対して自動テキストトラック選択のユーザープリファレンスを尊重します。

ユーザーエージェントがメディア要素に対して自動テキストトラック選択のユーザープリファレンスを尊重する必要がある場合、次の手順を実行します。

  1. 自動テキストトラック選択を実行し、subtitlesおよびcaptionsを選択します。

  2. 自動テキストトラック選択を実行し、descriptionsを選択します。

  3. メディア要素のテキストトラックのリストに、テキストトラックが含まれており、そのテキストトラックの種別がchaptersまたはmetadataに対応するtrack要素があり、そのdefault属性が設定され、テキストトラックのモードが無効に設定されている場合、これらすべてのトラックのテキストトラックのモードを隠しに設定します。

  4. 要素の自動トラック選択を実行したフラグをtrueに設定します。

上記の手順でテキストトラックの種別に対して自動テキストトラック選択を実行すると言われた場合、それは次の手順を実行することを意味します。

  1. アルゴリズムに渡された種別のいずれかに対応するテキストトラックで構成されたリストを、メディア要素のテキストトラックのリストから取得し、そのリストを候補とします。

  2. 候補が空の場合、戻ります。

  3. 候補の中に、テキストトラックのテキストトラックのモードが表示中に設定されているものがある場合、戻ります。

  4. ユーザーが候補のトラックの中から、そのテキストトラックの種別、テキストトラックの言語、およびテキストトラックのラベルに基づいてトラックを有効にしたいという意向を示している場合、そのトラックのテキストトラックのモードを表示中に設定します。

    例えば、ユーザーが「可能であればフランス語のキャプションを表示したい」、「タイトルに『コメント』が含まれている字幕トラックがあれば、それを有効にしたい」、「オーディオディスクリプショントラックが利用可能であれば、有効にする。できればスイスドイツ語で、無理なら標準スイスドイツ語か標準ドイツ語でもよい」というブラウザの設定を行っている可能性があります。

    それ以外の場合、候補の中にテキストトラックがあり、それがtrack要素に対応し、default属性が設定され、テキストトラックのモードが無効に設定されている場合、その最初のトラックのテキストトラックのモードを表示中に設定します。

テキストトラックがtrack要素に対応しており、次のいずれかの状況に遭遇した場合、ユーザーエージェントはそのテキストトラックおよびtrack要素に対してtrack処理モデルを開始しなければなりません。

ユーザーエージェントがテキストトラックおよびtrack要素に対してtrack処理モデルを開始する場合、次のアルゴリズムを実行しなければなりません。このアルゴリズムは、イベントループメカニズムと密接に連携しており、特に同期セクションを持っています（これはイベントループアルゴリズムの一部としてトリガーされます）。そのセクション内の手順は⌛でマークされています。

  1. このアルゴリズムの別の実行が、このテキストトラックおよびtrack要素に対してすでに進行中である場合、戻り、その他のアルゴリズムにこの要素の処理を任せます。

  2. テキストトラックのテキストトラックのモードが隠しまたは表示中のいずれかに設定されていない場合、戻ります。

  3. テキストトラックのtrack要素の親がメディア要素でない場合、戻ります。

  4. これらの手順の残りの部分を並列で実行し、これらの手順を実行させた原因が引き続き進行できるようにします。

  5. トップ: 安定状態を待ちます。同期セクションは以下の手順で構成されています。（同期セクションの手順は⌛でマークされています。）

  6. ⌛ テキストトラックの準備状態を読み込み中に設定します。

  7. ⌛ URLをtrack要素のトラックURLとします。

  8. ⌛ track要素の親がメディア要素である場合、corsAttributeStateをその親であるメディア要素のcrossoriginコンテンツ属性の状態とします。それ以外の場合は、corsAttributeStateをNo CORSとします。

  9. 同期セクションを終了し、残りの手順を並列で続行します。

  10. URLが空文字列でない場合、次の手順を実行します。

    1. requestを、URL、"track"、およびcorsAttributeStateを用いて潜在的なCORSリクエストの作成の結果とし、同一オリジンのフォールバックフラグを設定します。

    2. requestのクライアントを、track要素のノードドキュメントの関連する設定オブジェクトに設定します。

    3. requestのイニシエータータイプを"track"に設定します。

    4. requestをフェッチします。

    フェッチングアルゴリズムによってネットワーキングタスクソースでキューに入れられたタスクは、データがフェッチされている間にリソースのタイプを判定する必要があります。リソースのタイプがサポートされているテキストトラック形式でない場合、ロードは失敗し、以下で説明されるように失敗します。そうでなければ、リソースのデータは、適切なパーサー（例：WebVTTパーサー）に受信時に渡され、その出力にテキストトラックのキューリストが使用されます。[WEBVTT]

    適切なパーサーは、これらのネットワーキングタスクソースのタスクの実行中に、受信したデータを用いてテキストトラックのキューリストを段階的に更新します。

    この仕様では、テキストトラックのMIMEタイプをチェックする方法や、それを行うかどうか、または実際のファイルデータを使用してファイルタイプのスニッフィングを行う方法やそれを行うかどうかについて、現在は記載されていません。この問題に関して実装者の意図が異なるため、適切な解決策が不明確です。この点に関する要件がない場合、HTTP仕様の厳格な要件であるContent-Typeヘッダーに従う必要があります（"Content-Typeは基礎となるデータのメディアタイプを指定します。" ... "メディアタイプがContent-Typeフィールドによって与えられていない場合に限り、受信者はそのコンテンツおよび/またはリソースを識別するために使用されるURIの名前拡張子を検査してメディアタイプを推測することができます。"）。

    フェッチが何らかの理由で失敗した場合（ネットワークエラー、サーバーがエラーコードを返す、CORSが失敗するなど）、またはURLが空文字列である場合は、要素タスクをキューに入れ、DOM操作タスクソースを使用してメディア要素に対して最初にテキストトラックの準備状態をロードに失敗に変更し、次にエラーという名前のイベントを発生させます。

    フェッチが失敗せず、リソースのタイプがサポートされているテキストトラック形式でないか、ファイルが正常に処理されなかった場合（例えば、その形式がXML形式であり、ファイルにXMLが要求する整形式エラーが含まれていて、アプリケーションに報告される必要がある場合）、上記の問題が見つかった場合にネットワーキングタスクソースでキューに入れられたタスクは、テキストトラックの準備状態をロードに失敗に変更し、エラーという名前のイベントを発生させます。

    フェッチが失敗せず、ファイルが正常に処理された場合、データの解析が終了した後に、ネットワーキングタスクソースでキューに入れられた最終的なタスクは、テキストトラックの準備状態を読み込み済みに変更し、ロードという名前のイベントを発生させます。

    フェッチが進行中に、次のいずれかの事象が発生した場合:

    ...その場合、ユーザーエージェントはフェッチを中止し、そのアルゴリズムによって生成された保留中のタスクを破棄しなければなりません（特に、URLが変更された後にキューを追加しないようにします）。その後、track要素に対してDOM操作タスクソースで要素タスクをキューに入れ、テキストトラックの準備状態をロードに失敗に変更し、エラーという名前のイベントを発生させます。

  11. テキストトラックの準備状態が読み込み中でなくなるまで待ちます。

  12. トラックURLがURLと一致しなくなるまで待ちます。その際にテキストトラックのモードが隠しまたは表示中に設定されています。

  13. トップに戻ります。

track要素のsrc属性が設定、変更、または削除されると、ユーザーエージェントはその要素のテキストトラックのテキストトラックのキューリストを直ちに空にしなければなりません。（これにより、以前に指定されたURLを使用して取得されたリソースからのキューの追加が停止されます。）

4.8.11.11.4 さまざまな形式でキューを公開するためのガイドラインをテキストトラックキューとして公開します

特定の形式のテキストトラックキューがHTMLユーザーエージェントによる処理のためにどのように解釈されるかは、その形式によって定義されます。そのような仕様がない場合、このセクションは、実装が一貫してそのような形式を公開しようとする際のいくつかの制約を提供します。

HTMLのテキストトラックモデルをサポートするために、タイムデータの各単位はテキストトラックキューに変換されます。この仕様で定義されているように、形式の機能をテキストトラックキューの側面にマッピングする方法が定義されていない場合、実装は、上記のテキストトラックキューの側面の定義に一致するマッピングであること、および以下の制約に一致することを確保しなければなりません：

テキストトラックキュー識別子

形式に対する明確なアナログがない場合は、空の文字列に設定する必要があります。

テキストトラックキューパスオンエグジットフラグ

偽に設定する必要があります。

4.8.11.11.5 テキストトラックAPI

TextTrackList

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+ 
[Exposed=Window]
 interface TextTrackList : EventTarget {
   readonly attribute unsigned long length;
   getter TextTrack (unsigned long index);
   TextTrack? getTrackById(DOMString id);
 
   attribute EventHandler onchange;
   attribute EventHandler onaddtrack;
   attribute EventHandler onremovetrack;
 };
media.textTracks.length

HTMLMediaElement/textTracks

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet1.0+Opera Android12.1+

メディア要素（例：track要素）に関連付けられているテキストトラックの数を返します。 これは、メディア要素内のテキストトラックのリスト内のテキストトラックの数です。

media.textTracks[ n ]

n番目のテキストトラックを表すTextTrackオブジェクトを返します。

textTrack = media.textTracks.getTrackById(id)

TextTrackList/getTrackById

すべての現行エンジンでサポートされています。

Firefox31+Safari8+Chrome33+
Opera?Edge79+
Edge (レガシー)18Internet Explorer対応なし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定された識別子を持つTextTrackオブジェクトを返しますが、その識別子を持つトラックがない場合は null を返します。

TextTrackListオブジェクトは、指定された順序でテキストトラックの動的に更新されるリストを表します。

メディア要素のtextTracks属性は、テキストトラックのリスト内のTextTrackオブジェクトを表すTextTrackListオブジェクトを返さなければなりません。同じ順序でなければなりません。

TextTrackList/length

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

TextTrackListオブジェクトのlength属性は、そのリスト内のテキストトラックの数を返さなければなりません。

サポートされているプロパティインデックスは、TextTrackListオブジェクト内のテキストトラックの数から1を引いた数です。リストにテキストトラックがない場合、サポートされているプロパティインデックスは存在しません。

インデックスプロパティの値を決定するには、TextTrackListオブジェクトで与えられたインデックスindexの値を決定し、TextTrackListオブジェクトで表されるリスト内のindex番目のテキストトラックを返さなければなりません。

TextTrackListオブジェクト内のTextTrackオブジェクトを最初にid属性の値と一致するトラックを見つけ、引数idに指定された値と一致する値を持つ最初のトラックを返さなければなりません。指定された引数に一致するトラックがない場合は、null を返さなければなりません。

TextTrack

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android31+Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+ 
enum TextTrackMode { "disabled",  "hidden",  "showing" };
 enum TextTrackKind { "subtitles",  "captions",  "descriptions",  "chapters",  "metadata" };
 
 [Exposed=Window]
 interface TextTrack : EventTarget {
   readonly attribute TextTrackKind kind;
   readonly attribute DOMString label;
   readonly attribute DOMString language;
 
   readonly attribute DOMString id;
   readonly attribute DOMString inBandMetadataTrackDispatchType;
 
   attribute TextTrackMode mode;
 
   readonly attribute TextTrackCueList? cues;
   readonly attribute TextTrackCueList? activeCues;
 
   undefined addCue(TextTrackCue cue);
   undefined removeCue(TextTrackCue cue);
 
   attribute EventHandler oncuechange;
 };
textTrack = media.addTextTrack(kind [, label [, language ] ])

新しいTextTrackオブジェクトを作成し、返します。また、メディア要素のテキストトラックのリストにも追加されます。

textTrack.kind

TextTrack/kind

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テキストトラックの種類文字列を返します。

textTrack.label

TextTrack/label

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テキストトラックのラベルが存在する場合はそのラベルを返し、そうでない場合は空の文字列を返します（オブジェクトがユーザーに公開される場合、他の属性からカスタムラベルを生成する必要があることを示します）。

textTrack.language

TextTrack/language

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テキストトラックの言語文字列を返します。

textTrack.id

TextTrack/id

すべての現行エンジンでサポートされています。

Firefox31+Safari8+Chrome33+
Opera?Edge79+
Edge (レガシー)18Internet Explorer対応なし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたトラックのIDを返します。

インバンドトラックの場合、これはフォーマットがメディアフラグメント構文をサポートしている場合に、フラグメントで使用できるIDであり、getTrackById()メソッドでも使用できます。

TextTrackオブジェクトがtrack要素に対応している場合、これはtrack要素のIDです。

textTrack.inBandMetadataTrackDispatchType

TextTrack/inBandMetadataTrackDispatchType

Firefox31+Safari8+Chrome対応なし
Opera?Edge対応なし
Edge (レガシー)対応なしInternet Explorer対応なし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

テキストトラックインバンドメタデータトラックディスパッチタイプ文字列を返します。

textTrack.mode [ = value ]

TextTrack/mode

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android31+Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

次のリストから、文字列としてテキストトラックモードを返します。

"disabled"

テキストトラック無効モード。

"hidden"

テキストトラック非表示モード。

"showing"

テキストトラック表示モード。

設定可能で、モードを変更するために使用されます。

textTrack.cues

TextTrack/cues

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android31+Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テキストトラックのすべてのキューのリストを、TextTrackCueListオブジェクトとして返します。

textTrack.activeCues

TextTrack/activeCues

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android31+Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在アクティブなテキストトラックのキューを、TextTrackCueListオブジェクトとして返します。このキューは、現在の再生位置の前に開始し、その後に終了するものです。

textTrack.addCue(cue)

TextTrack/addCue

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

指定されたキューをtextTrackのテキストトラックのキューのリストに追加します。

textTrack.removeCue(cue)

TextTrack/removeCue

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

指定されたキューをtextTrackのテキストトラックのキューのリストから削除します。

メディア要素のaddTextTrack(kind, label, language)メソッドが呼び出されたとき、次の手順を実行する必要があります:

  1. 新しいTextTrackオブジェクトを作成します。

  2. 新しいオブジェクトに対応するテキストトラックを作成し、そのテキストトラックの種類をkindに、テキストトラックのラベルをlabelに、テキストトラックの言語をlanguageに設定し、テキストトラックの準備状態をテキストトラックの読み込み状態に、テキストトラックのモードをテキストトラック非表示モードに設定し、テキストトラックのキューのリストを空のリストに設定します。

    初めは、テキストトラックのキューのリストは、テキストトラックのレンダリングを更新するルールには関連付けられていません。テキストトラックのキューが追加されると、そのテキストトラックのキューのリストは、それに応じてルールが恒久的に設定されます。

  3. 新しいテキストトラックをメディア要素のテキストトラックのリストに追加します。

  4. メディア要素タスクをキューに入れ、メディア要素でイベントを発火させ、メディア要素のtextTracks属性のTextTrackListオブジェクトに、新しいテキストトラックのTextTrackオブジェクトで初期化されたTrackEventを使用して、addtrackという名前のイベントを発生させます。

  5. 新しいTextTrackオブジェクトを返します。

kind 属性は、TextTrackオブジェクトが表すテキストトラックのテキストトラックの種類を返さなければなりません。

label 属性は、TextTrackオブジェクトが表すテキストトラックのテキストトラックのラベルを返さなければなりません。

language 属性は、TextTrackオブジェクトが表すテキストトラックのテキストトラックの言語を返さなければなりません。

id 属性は、トラックの識別子を返します。識別子がない場合は空の文字列を返します。track要素に対応するトラックの場合、トラックの識別子はその要素のid属性の値です。インバンドトラックの場合、トラックの識別子はメディアリソースによって指定されます。メディアリソースがメディアフラグメント構文をサポートしている形式である場合、特定のトラックに対して返される識別子は、そのフラグメントのトラック次元の名前として使用された場合にトラックを有効にするのと同じ識別子でなければなりません。

inBandMetadataTrackDispatchType 属性は、TextTrackオブジェクトが表すテキストトラックのテキストトラックのインバンドメタデータトラックディスパッチタイプを返さなければなりません。

mode 属性の取得時には、TextTrackオブジェクトが表すテキストトラックのテキストトラックモードに対応する文字列を、以下のリストで定義されているように返さなければなりません:

"disabled"
テキストトラック無効モード。
"hidden"
テキストトラック非表示モード。
"showing"
テキストトラック表示モード。

設定時、新しい値が現在の属性の返り値と等しくない場合、新しい値は次のように処理されなければなりません:

新しい値が"disabled"の場合

TextTrackオブジェクトが表すテキストトラックのテキストトラックモードをテキストトラック無効モードに設定します。

新しい値が"hidden"の場合

TextTrackオブジェクトが表すテキストトラックのテキストトラックモードをテキストトラック非表示モードに設定します。

新しい値が"showing"の場合

TextTrackオブジェクトが表すテキストトラックのテキストトラックモードをテキストトラック表示モードに設定します。

TextTrackオブジェクトが表すテキストトラックのテキストトラックモードがテキストトラック無効モードでない場合、cues属性は、TextTrackCueListオブジェクトのライブであり、TextTrackオブジェクトが表すテキストトラックのテキストトラックのキューのリストのうち、終了時間がスクリプトが開始したときの最も早い可能な位置に発生するか、それ以降に発生する部分をテキストトラックのキュー順序に従って表すものでなければなりません。それ以外の場合はnullを返さなければなりません。各TextTrackオブジェクトに対して、オブジェクトが返される場合は、毎回同じTextTrackCueListオブジェクトを返さなければなりません。

スクリプトが開始したときの最も早い可能な位置は、前回イベントループがステップ1に到達したときの最も早い可能な位置です。

TextTrackオブジェクトが表すテキストトラックのテキストトラックモードがテキストトラック無効モードでない場合、activeCues属性は、TextTrackCueListオブジェクトのライブであり、TextTrackオブジェクトが表すテキストトラックのテキストトラックのキューのリストのうち、スクリプトが開始したときにアクティブフラグが設定されていた部分をテキストトラックのキュー順序に従って表すものでなければなりません。それ以外の場合はnullを返さなければなりません。各TextTrackオブジェクトに対して、オブジェクトが返される場合は、毎回同じTextTrackCueListオブジェクトを返さなければなりません。

テキストトラックのキューのスクリプトが開始したときにアクティブフラグが設定されていた場合、そのテキストトラックキューアクティブフラグは、前回イベントループがステップ1に到達したときに設定されていました。

addCue(cue) メソッドは、 TextTrack オブジェクトに対して呼び出されたとき、次の手順を実行する必要があります:

  1. テキストトラックのキューのリスト がまだ関連する テキストトラックレンダリングの更新ルール を持っていない場合は、 テキストトラックのキューのリスト を cue に適したテキストトラックレンダリングの更新ルール に関連付けます。

  2. テキストトラックのキューのリスト に関連付けられた テキストトラックレンダリングの更新ルール が、 cue に適した テキストトラックレンダリングの更新ルール と同じでない場合は、 "InvalidStateError" を投げます。

  3. 指定された cue が テキストトラックのキューのリスト に含まれている場合、その テキストトラックのキューのリスト から cue を削除します。

  4. cue を TextTrack オブジェクトの テキストトラック の テキストトラックのキューのリスト に追加します。

removeCue(cue) メソッドは、 TextTrack オブジェクトに対して呼び出されたとき、次の手順を実行する必要があります:

  1. 指定された cue が TextTrack オブジェクトの テキストトラック の テキストトラックのキューのリスト に含まれていない場合、 "NotFoundError" を投げます。

  2. cue を TextTrack オブジェクトの テキストトラック の テキストトラックのキューのリスト から削除します。

この例では、 audio 要素を使用して、複数のサウンドエフェクトを含む音声ファイルから特定のサウンドエフェクトを再生します。ブラウザがスクリプトを実行中でも、オーディオがクリップの終わりで正確に停止するように、キューを使用してオーディオを一時停止します。スクリプトに頼ってオーディオを一時停止していた場合、ブラウザが指定された時間にスクリプトを実行できなかった場合、次のクリップの開始が聞こえる可能性があります。 

var sfx = new Audio('sfx.wav');
 var sounds = sfx.addTextTrack('metadata');>
 
 // 追加するサウンドエフェクト
 function addFX(start, end, name) {
   var cue = new VTTCue(start, end, '');>
   cue.id = name;
   cue.pauseOnExit = true;
   sounds.addCue(cue);>
 }>
 addFX(12.783, 13.612, 'dog bark');>
 addFX(13.612, 15.091, 'kitten mew');>
 
 function playSound(id) {
   sfx.currentTime = sounds.getCueById(id).startTime;
   sfx.play();>
 }>
 
 // 準備が整ったらすぐに鳴らす
 sfx.oncanplaythrough = function () {>
   playSound('dog bark');>
 }>
 // ユーザーがページを離れようとしたときにニャーと鳴き、ブラウザに確認を求める
 window.onbeforeunload = function (e) {
   playSound('kitten mew');>
   e.preventDefault();>
 }

TextTrackCueList

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+ 
[Exposed=Window]
 interface TextTrackCueList {
   readonly attribute unsigned long length;
   getter TextTrackCue (unsigned long index);
   TextTrackCue? getCueById(DOMString id);
 };
cuelist.length

リスト内の キュー の数を返します。

cuelist[index]

リスト内の index 番目の テキストトラックキュー を返します。キューは テキストトラックキューの順序 で並べられています。

cuelist.getCueById(id)

id に一致する最初の テキストトラックキュー を返します（テキストトラックキューの順序 で）。

指定された識別子を持つキューがない場合、または引数が空の文字列である場合、null を返します。

TextTrackCueList オブジェクトは、指定された順序で テキストトラックキュー の動的に更新されるリストを表します。

TextTrackCueList/length

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

length 属性は、TextTrackCueList オブジェクトによって表されるリスト内の キュー の数を返さなければなりません。

サポートされているプロパティのインデックス は、TextTrackCueList オブジェクトによって表されるリスト内の キュー の数から 0 を引いた数までの範囲の数字です。リストにキューがない場合、サポートされているプロパティのインデックスはありません。

特定のインデックス index のプロパティ値を決定するには、ユーザーエージェントは TextTrackCueList オブジェクトによって表されるリスト内の index 番目の テキストトラックキュー を返さなければなりません。

TextTrackCueList/getCueById

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

getCueById(id) メソッドは、空の文字列以外の引数で呼び出された場合、TextTrackCueList オブジェクトによって表されるリスト内で、テキストトラックキュー の 識別子 が id と一致する最初のキューを返さなければなりません。存在しない場合は null を返します。引数が空の文字列の場合、メソッドは null を返さなければなりません。

TextTrackCue

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+ 
[Exposed=Window]
 interface TextTrackCue : EventTarget {
   readonly attribute TextTrack? track;
 
   attribute DOMString id;
   attribute double startTime;
   attribute unrestricted double endTime;
   attribute boolean pauseOnExit;
 
   attribute EventHandler onenter;
   attribute EventHandler onexit;
 };
cue.track

TextTrack オブジェクトにこの テキストトラックキュー が属している場合はそのオブジェクトを返し、それ以外の場合は null を返します。

cue.id [ = value ]

テキストトラックキュー識別子を返します。

設定することもできます。

cue.startTime [ = value ]

テキストトラックキューの開始時間を秒単位で返します。

設定することもできます。

cue.endTime [ = value ]

テキストトラックキューの終了時間を秒単位で返します。

無制限のテキストトラックキューの場合は、正の無限大を返します。

設定することもできます。

cue.pauseOnExit [ = value ]

テキストトラックキューの終了時に一時停止フラグが設定されている場合は true を返し、そうでない場合は false を返します。

設定することもできます。

TextTrackCue/track

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

track 属性は、取得時に、TextTrack オブジェクトが属する テキストトラック の キューのリスト に、テキストトラックキュー が含まれている場合、そのオブジェクトを返します。そうでない場合は null を返します。

TextTrackCue/id

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

id 属性は、取得時に、テキストトラックキュー識別子を返します。設定時には、新しい値に設定されます。

TextTrackCue/startTime

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

startTime 属性は、取得時に、テキストトラックキューの開始時間を秒単位で返します。設定時には、新しい値に設定され、秒単位で解釈されます。その後、TextTrackCue オブジェクトが テキストトラック の キューのリスト に含まれ、その テキストトラック が メディア要素 の テキストトラックのリスト に含まれ、かつその メディア要素 の ポスターフラグ が設定されていない場合は、その メディア要素 に対して 時間進行 ステップを実行します。

TextTrackCue/endTime

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

endTime 属性は、取得時に、テキストトラックキューの終了時間を秒単位で返します。設定時には、もし新しい値が負の無限大または NaN（非数）であれば、TypeError 例外をスローします。それ以外の場合、新しい値に設定されます。その後、TextTrackCue オブジェクトが テキストトラック の キューのリスト に含まれ、その テキストトラック が メディア要素 の テキストトラックのリスト に含まれ、かつその メディア要素 の ポスターフラグ が設定されていない場合は、その メディア要素 に対して 時間進行 ステップを実行します。

TextTrackCue/pauseOnExit

すべての現在のエンジンでサポートされています。

Firefox31+ Safari6+ Chrome23+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS7+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

pauseOnExit 属性は、取得時に、テキストトラックキューの終了時に一時停止フラグが設定されている場合は true を返し、そうでない場合は false を返します。設定時には、新しい値が true の場合はフラグを設定し、それ以外の場合はフラグを解除します。

4.8.11.11.6 テキストトラックAPIオブジェクトのイベントハンドラー

以下は、イベントハンドラーと、その対応するイベントハンドラーイベントタイプであり、すべてのTextTrackListインターフェイスを実装するオブジェクトが、イベントハンドラーIDL属性としてサポートしなければならないものです。

イベントハンドラー イベントハンドラーイベントタイプ
onchange change
onaddtrack addtrack
onremovetrack removetrack

以下は、イベントハンドラーと、その対応するイベントハンドラーイベントタイプであり、すべてのTextTrackインターフェイスを実装するオブジェクトが、イベントハンドラーIDL属性としてサポートしなければならないものです。

イベントハンドラー イベントハンドラーイベントタイプ
oncuechange

TextTrack/cuechange_event

すべての現在のエンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
cuechange

以下は、イベントハンドラーと、その対応するイベントハンドラーイベントタイプであり、すべてのTextTrackCueインターフェイスを実装するオブジェクトが、イベントハンドラーIDL属性としてサポートしなければならないものです。

イベントハンドラー イベントハンドラーイベントタイプ
onenter

TextTrackCue/enter_event

すべての現在のエンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
enter
onexit

TextTrackCue/exit_event

すべての現在のエンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
exit
4.8.11.11.7 メタデータテキストトラックのベストプラクティス

このセクションは規範的ではありません。

テキストトラックは、インタラクティブまたは拡張されたビューのために、メディアデータに関連するデータを保存するために使用できます。

例えば、スポーツ放送を表示するページには、現在のスコアに関する情報が含まれる可能性があります。たとえば、ロボットコンペティションがライブ配信されているとします。画像にスコアをオーバーレイすることができます。以下のように表示されます。

ユーザーがビデオの任意のポイントにシークする際に、スコア表示を正しくレンダリングするためには、メタデータテキストトラックのキューはスコアに適した長さである必要があります。例えば、上記のフレームでは、試合番号を示すキューが試合の長さに対応して存在し、青チームのスコアが変わるまで続くキューが1つ、赤チームのスコアが変わるまで続くキューが1つ存在する可能性があります。ビデオがライブイベントのストリームである場合、右下の時間は通常、キューに基づくのではなく、現在のビデオ時間から自動的に導出されると考えられます。しかし、ビデオがハイライトだけである場合、その時間もキューに含まれる可能性があります。

次に示すのは、WebVTTファイルの断片がどのように見えるかを示しています。

WEBVTT
 
 ...
 
 05:10:00.000 --> 05:12:15.000
 matchtype:qual
 matchnumber:37
 
 ...
 
 05:11:02.251 --> 05:11:17.198
 red:78
 
 05:11:03.672 --> 05:11:54.198
 blue:66
 
 05:11:17.198 --> 05:11:25.912
 red:80
 
 05:11:25.912 --> 05:11:26.522
 red:83
 
 05:11:26.522 --> 05:11:26.982
 red:86
 
 05:11:26.982 --> 05:11:27.499
 red:89
 
 ...

ここでのポイントは、情報が関連するイベントに適用される時間の長さにまたがるキューで提供されていることに注意することです。代わりに、スコアがゼロ長（またはほぼゼロ長）のキューとして提供される場合、例えば05:11:17.198の「red+2」、05:11:25.912の「red+3」など、問題が発生します。主に、シークの実装が非常に難しくなり、スクリプトはすべてのキューのリストを調べて、通知が見逃されていないか確認する必要があります。また、キューが短い場合、スクリプトがそれらがアクティブであることを認識できない可能性があり、それを特別に監視しない限り、見逃す可能性があります。

このような方法でキューを使用する場合、著者は現在の注釈を更新するために、cuechangeイベントを使用することを推奨します。（特に、timeupdateイベントを使用するのはあまり適切ではありません。なぜなら、キューが変更されていない場合でも作業を行う必要があり、さらに重要なことに、メタデータキューがアクティブになる時点と表示が更新される時点の間に、高い遅延が発生するためです。timeupdateイベントはレート制限されています。）

4.8.11.12 URLを介してトラックの種類を識別する

URLを使用して、AudioTrackのkind IDL属性や、VideoTrackのkind IDL属性の戻り値、またはテキストトラックの種類を識別する必要がある他の仕様や形式は、about:html-kind URLを使用しなければなりません。

4.8.11.13 ユーザーインターフェース

controls属性は、ブール属性です。指定されている場合、作成者がスクリプト化されたコントローラーを提供しておらず、ユーザーエージェントに独自のコントロールセットを提供してほしいことを示します。

この属性が指定されている場合、またはスクリプトが無効化されている場合、メディア要素に対して、ユーザーエージェントはユーザーにユーザーインターフェースを提供する必要があります。このユーザーインターフェースには、再生の開始、再生の一時停止、コンテンツの任意の位置へのシーク（コンテンツが任意のシークをサポートしている場合）、音量の変更、クローズドキャプションや埋め込まれた手話トラックの表示の変更、異なるオーディオトラックの選択または音声説明のオンにすること、ユーザーに適した方法でのメディアコンテンツの表示（例：全画面ビデオや独立したリサイズ可能なウィンドウ）などの機能が含まれているべきです。他のコントロールも提供される場合があります。

ただし、この属性が指定されていない場合でも、ユーザーエージェントはメディアリソースの再生に影響を与えるコントロール（例：再生、一時停止、シーク、トラック選択、音量コントロール）を提供することができますが、そのような機能はページの通常のレンダリングを妨げるべきではありません。たとえば、そのような機能は、メディア要素のコンテキストメニュー、プラットフォームメディアキー、またはリモートコントロールで公開される可能性があります。ユーザーエージェントは、上記で説明したように、ユーザーにユーザーインターフェースを提供することによってこれを単純に実装することができます（まるでcontrols属性が指定されているかのように）。

ユーザーエージェントがユーザーにユーザーインターフェースを提供することにより、メディア要素上にコントロールを表示する場合、ユーザーエージェントがこのインターフェースと対話している間は、ユーザー操作イベントを抑制するべきです。（たとえば、ユーザーがビデオの再生コントロールをクリックした場合、mousedownイベントなどがページ上の要素に同時に発火されることはありません。）

可能であれば（具体的には、再生の開始、停止、一時停止、および再開、シーク、再生速度の変更、早送りまたは巻き戻し、テキストトラックのリスト化、有効化、無効化、およびオーディオのミュートや音量変更のために）、ユーザーエージェントによって公開されるユーザーインターフェース機能は、上記で説明したDOM APIの観点で実装されなければならないため、同じイベントがすべて発火します。

早送りや巻き戻しなどの機能は、playbackRate属性のみを変更することによって実装されなければなりません（defaultPlaybackRate属性は変更されません）。

シークは、シークして、メディア要素のメディアタイムラインの要求された位置に到達する観点で実装されなければなりません。任意の位置へのシークが遅くなるメディアリソースの場合、ユーザーがシークバーなどの近似位置インターフェースを操作したときに、ユーザーエージェントが速度優先の近似フラグを使用することが推奨されます。

HTMLMediaElement/controls

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

controls IDL属性は、同名のコンテンツ属性を反映しなければなりません。

media.volume [ = value ]

HTMLMediaElement/volume

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在の再生音量を、0.0から1.0の範囲の数値として返します。0.0が最も静かで、1.0が最も大きい音量です。

音量を変更するために設定することができます。

新しい値が0.0から1.0の範囲にない場合、"IndexSizeError" DOMExceptionがスローされます。

media.muted [ = value ]

HTMLMediaElement/muted

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

オーディオがミュートされている場合はtrueを返し、volume属性を無効にし、ミュートされていない場合はvolume属性が有効であることを示します。

オーディオがミュートされているかどうかを変更するために設定できます。

メディア要素には、0.0（無音）から1.0（最大音量）の範囲の分数である再生音量があります。初期状態では、音量は1.0であるべきですが、ユーザーエージェントはセッション間やサイトごとに、またはその他の方法で最後に設定された値を記憶している場合があるため、音量は他の値から開始する場合があります。

volume IDL属性は、再生音量をメディア要素のオーディオ部分に返さなければなりません。設定時に、新しい値が0.0から1.0の範囲内にある場合、メディア要素の再生音量は新しい値に設定されなければなりません。新しい値が0.0から1.0の範囲外にある場合、設定時に"IndexSizeError" DOMExceptionがスローされなければなりません。

メディア要素は、ミュートにすることもできます。何かが要素をミュートしている場合、その要素はミュートされています。（たとえば、再生方向が逆の場合、その要素はミュートされています。）

muted IDL属性は、最後に設定された値を返さなければなりません。メディア要素が作成されたとき、要素にmutedコンテンツ属性が指定されている場合は、muted IDL属性はtrueに設定されるべきです。そうでない場合、ユーザーエージェントはユーザーの好みの値に設定することがあります（例：セッション間やサイトごとに、またはその他の方法で最後に設定された値を記憶している場合など）。muted IDL属性がtrueに設定されている間、メディア要素はミュートされなければなりません。

volumeおよびmutedIDL属性によって返される値が変更された場合、ユーザーエージェントはメディア要素タスクをキューに追加し、メディア要素でvolumechangeという名前のイベントを発火しなければなりません。その後、メディア要素が再生を許可されていない場合、ユーザーエージェントは内部一時停止手順を実行しなければなりません。

ユーザーエージェントには、音量ロック（ブール値）があります。その値は実装依存であり、再生音量が反映されるかどうかを決定します。

要素の効果的なメディア音量は、次のように決定されます。

  1. ユーザーがユーザーエージェントに要素の音量を上書きするよう指示している場合、その音量を返します。

  2. ユーザーエージェントの音量ロックがtrueである場合、システムの音量を返します。

  3. 要素のオーディオ出力がミュートされている場合、0を返します。

  4. volumeを、再生音量とし、0.0（無音）から1.0（最大音量）の範囲で返します。

  5. volumeを返し、0.0から1.0の範囲内で解釈し、0.0が無音で、1.0が最も大きい設定で、間の値が大きさを増します。この範囲は線形である必要はありません。最大設定は、システムの最大可能設定よりも低くてもよいです。たとえば、ユーザーが最大音量を設定した場合などです。

メディア要素上のmutedコンテンツ属性は、ブール属性であり、ユーザーの好みを無視して、メディアリソースのオーディオ出力のデフォルト状態を制御します。

HTMLMediaElement/defaultMuted

すべての現在のエンジンでサポートされています。

Firefox11+Safari6+Chrome15+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

defaultMuted IDL属性は、mutedコンテンツ属性を反映しなければなりません。

この属性には動的な効果はありません（要素のデフォルト状態を制御するだけです）。

このビデオ（広告）は自動再生されますが、ユーザーを煩わせないために、音声なしで再生され、ユーザーが音声をオンにすることができます。ユーザーエージェントは、ユーザー操作なしにビデオがミュート解除されると、一時停止することができます。 

<video src="adverts.cgi?kind=video" controls autoplay loop muted></video>
4.8.11.14 時間範囲

TimeRanges

すべての現在のエンジンでサポートされています。

Firefox4+Safari3.1+Chrome6+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

TimeRangesインターフェースを実装するオブジェクトは、時間の範囲（期間）のリストを表します。 

[Exposed=Window]
 interface TimeRanges {
   readonly attribute unsigned long length;
   double start(unsigned long index);
   double end(unsigned long index);
 };
media.length

TimeRanges/length

すべての現在のエンジンでサポートされています。

Firefox4+Safari3.1+Chrome6+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

オブジェクト内の範囲の数を返します。

time = media.start(index)

TimeRanges/start

すべての現在のエンジンでサポートされています。

Firefox4+Safari3.1+Chrome6+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定されたインデックスを持つ範囲の開始時刻を返します。

インデックスが範囲外の場合、"IndexSizeError" DOMExceptionをスローします。

time = media.end(index)

TimeRanges/end

すべての現在のエンジンでサポートされています。

Firefox4+Safari3.1+Chrome6+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定されたインデックスを持つ範囲の終了時刻を返します。

インデックスが範囲外の場合、"IndexSizeError" DOMExceptionをスローします。

length IDL属性は、オブジェクトが表す範囲の数を返さなければなりません。

start(index)メソッドは、オブジェクトが表すindex番目の範囲の開始位置を、オブジェクトがカバーするタイムラインの開始から測定した秒数で返さなければなりません。

end(index)メソッドは、オブジェクトが表すindex番目の範囲の終了位置を、オブジェクトがカバーするタイムラインの開始から測定した秒数で返さなければなりません。

これらのメソッドは、オブジェクトが表す範囲の数以上のindex引数を指定して呼び出された場合、"IndexSizeError" DOMExceptionをスローしなければなりません。

TimeRangesオブジェクトが正規化されたTimeRangesオブジェクトとされる場合、それが表す範囲は次の基準を満たしていなければなりません。

言い換えれば、そのようなオブジェクトの範囲は順序付けられており、重複せず、接触していません（隣接する範囲は1つの大きな範囲に統合されます）。範囲は空であってもよい（時間の単一の瞬間を参照している）、たとえば、メディア要素が一時停止しているときに、ユーザーエージェントが現在のフレームを除くすべてのメディアリソースを破棄した場合などです。

TimeRangesオブジェクト内の範囲は、包含的でなければなりません。

したがって、範囲の終了は、次の隣接する（接触しているが重なっていない）範囲の開始と等しくなります。同様に、ゼロを基準にアンカーされたタイムライン全体をカバーする範囲は、開始がゼロで、終了がタイムラインの長さと等しくなります。

メディア要素のbuffered、seekable、およびplayedIDL属性によって返されるオブジェクトによって使用されるタイムラインは、その要素のメディアタイムラインでなければなりません。

4.8.11.15 TrackEventインターフェース

TrackEvent

すべての現在のエンジンでサポートされています。

Firefox27+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+ 
[Exposed=Window]
 interface TrackEvent : Event {
   constructor(DOMString type, optional TrackEventInit eventInitDict = {});
 
   readonly attribute (VideoTrack or AudioTrack or TextTrack)? track;
 };
 
 dictionary TrackEventInit : EventInit {
   (VideoTrack or AudioTrack or TextTrack)? track = null;
 };
event.track

TrackEvent/track

すべての現在のエンジンでサポートされています。

Firefox27+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

イベントが関連するトラックオブジェクト（TextTrack、AudioTrack、またはVideoTrack）を返します。

track属性は、初期化された値を返さなければなりません。これは、イベントのコンテキスト情報を表します。

4.8.11.16 イベントの概要

このセクションは規範的ではありません。

以下のイベントは、上記の処理モデルの一部としてメディア要素で発生します。

イベント名 インターフェース 発生条件 前提条件
loadstart

HTMLMediaElement/loadstart_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event ユーザーエージェントがメディアデータを探し始めたとき、リソース選択アルゴリズムの一部として発生します。 networkStateがNETWORK_LOADINGと等しいとき。
progress

HTMLMediaElement/progress_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event ユーザーエージェントがメディアデータを取得しているとき。 networkStateがNETWORK_LOADINGと等しいとき。
suspend

HTMLMediaElement/suspend_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event ユーザーエージェントが意図的に現在メディアデータを取得していないとき。 networkStateがNETWORK_IDLEと等しいとき。
abort

HTMLMediaElement/abort_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event ユーザーエージェントがメディアデータを完全にダウンロードする前に取得を停止したが、それがエラーによるものではないとき。 errorがMEDIA_ERR_ABORTEDコードを持つオブジェクトであるとき。networkStateがNETWORK_EMPTYまたはNETWORK_IDLEと等しい。
error

HTMLMediaElement/error_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12+
Event エラーが発生し、メディアデータが取得できなかったか、リソースのタイプがサポートされていないメディア形式であるとき。 errorがMEDIA_ERR_NETWORKまたはそれ以上のコードを持つオブジェクトであるとき。networkStateがNETWORK_EMPTYまたはNETWORK_IDLEと等しい。
emptied

HTMLMediaElement/emptied_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event 以前のnetworkStateがNETWORK_EMPTY状態ではなかったメディア要素が、その状態に切り替わったとき（致命的なエラーが発生し、報告される直前や、リソース選択アルゴリズムがすでに実行中のときにload()メソッドが呼び出された場合など）。 networkStateがNETWORK_EMPTYであり、すべてのIDL属性が初期状態にある。
stalled

HTMLMediaElement/stalled_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event ユーザーエージェントがメディアデータを取得しようとしているが、データが予期せず届かない場合に発生します。 networkStateがNETWORK_LOADINGと等しい。
loadedmetadata

HTMLMediaElement/loadedmetadata_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event ユーザーエージェントがメディアリソースの期間と寸法を判定し、テキストトラックが準備完了になったときに発生します。 readyStateが初めてHAVE_METADATA以上になったとき。
loadeddata

HTMLMediaElement/loadeddata_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event ユーザーエージェントがメディアデータを現在の再生位置で初めてレンダリングできるようになったときに発生します。 readyStateが初めてHAVE_CURRENT_DATA以上に増加したとき。
canplay

HTMLMediaElement/canplay_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event ユーザーエージェントがメディアデータを再生できるが、現在の再生レートでメディアリソースを終了まで再生するには、さらにバッファリングが必要だと推定されるときに発生します。 readyStateが初めてHAVE_FUTURE_DATA以上に増加したとき。
canplaythrough

HTMLMediaElement/canplaythrough_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event ユーザーエージェントが、現在の再生レートでメディアリソースを終了までバッファリングせずに再生できると推定されたときに発生します。 readyStateがHAVE_ENOUGH_DATAと等しい。
playing

HTMLMediaElement/playing_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event メディアデータの不足により一時停止または遅延した後に再生が準備できたときに発生します。 readyStateがHAVE_FUTURE_DATA以上になったとき、pausedがfalseであるか、pausedがfalseに変更され、readyStateがHAVE_FUTURE_DATA以上に増加したとき。たとえこのイベントが発生しても、潜在的な再生が開始されない可能性があります。例えば、ユーザー操作のために一時停止されている場合や、インバンドコンテンツのために一時停止されている場合です。
waiting

HTMLMediaElement/waiting_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
Event 次のフレームが利用できないために再生が停止したが、ユーザーエージェントはそのフレームがすぐに利用可能になると予測しているとき。 readyStateがHAVE_CURRENT_DATA以下であり、pausedがfalseである。seekingがtrueであるか、現在の再生位置がbufferedのいずれの範囲にも含まれていない。その他の理由で再生が停止することがあるが、pausedがfalseであってもこのイベントは発生しません（これらの状況が解決しても、別のplayingイベントが発生することはありません）。例えば、再生が終了した場合や、エラーのために再生が停止した場合、ユーザー操作のために一時停止された場合やインバンドコンテンツのために一時停止された場合です。
seeking

HTMLMediaElement/seeking_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event seeking IDL 属性が true に変更され、ユーザーエージェントが新しい位置のシークを開始したときに発生します。
seeked

HTMLMediaElement/seeked_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event seeking IDL 属性が false に変更され、現在の再生位置 が変更された後に発生します。
ended

HTMLMediaElement/ended_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event メディアリソースの終わりに到達したために再生が停止した場合に発生します。 currentTime が メディアリソース の終わりと等しくなり、ended が true になります。
durationchange

HTMLMediaElement/durationchange_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event duration 属性が更新されたときに発生します。
timeupdate

HTMLMediaElement/timeupdate_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event 現在の再生位置が、通常の再生の一環として、または特に興味深い方法で変更されたときに発生します。たとえば、不連続に変更された場合などです。
play

HTMLMediaElement/play_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event 要素が一時停止されなくなったときに発生します。 play() メソッドが戻った後、または autoplay 属性が再生を開始したときに発生します。 paused が新たに false になりました。
pause

HTMLMediaElement/pause_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event 要素が一時停止されたときに発生します。 pause() メソッドが戻った後に発生します。 paused が新たに true になりました。
ratechange

HTMLMediaElement/ratechange_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
Event defaultPlaybackRate または playbackRate 属性が更新されたときに発生します。
resize Event いずれか、または両方の videoWidth および videoHeight 属性が更新されたときに発生します。 メディア要素 が ビデオ 要素であり、readyState が HAVE_NOTHING でない場合。
volumechange

HTMLMediaElement/volumechange_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
Event volume 属性または muted 属性が変更されたときに発生します。該当する属性のセッターが戻った後に発生します。

次のイベントは、source要素に対して発生します：

イベント名 インターフェース 発生条件
error Event メディアデータの取得中にエラーが発生するか、リソースのタイプがサポートされていないメディアフォーマットである場合。

以下のイベントは、AudioTrackList、VideoTrackList、およびTextTrackListオブジェクトで発生します：

イベント名 インターフェース 発生するタイミング...
change

AudioTrackList/change_event

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (Legacy)いいえInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

TextTrackList/change_event

すべての現行エンジンでサポートされています。

Firefox31+Safari7+Chrome33+
Opera?Edge79+
Edge (Legacy)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android4.4+Samsung Internet?Opera Android?

VideoTrackList/change_event

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (Legacy)いいえInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event トラックリスト内の 1 つ以上のトラックが有効または無効になったとき。
addtrack

AudioTrackList/addtrack_event

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (Legacy)いいえInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

TextTrackList/addtrack_event

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

VideoTrackList/addtrack_event

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (Legacy)いいえInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
TrackEvent トラックリストにトラックが追加されたとき。
removetrack

AudioTrackList/removetrack_event

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (Legacy)いいえInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

TextTrackList/removetrack_event

すべての現行エンジンでサポートされています。

Firefox31+Safari7+Chrome33+
Opera20+Edge79+
Edge (Legacy)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android4.4+Samsung Internet?Opera Android20+

VideoTrackList/removetrack_event

すべての現行エンジンでサポートされています。

Firefox🔰 33+Safari7+Chrome🔰 37+
Opera?Edge🔰 79+
Edge (Legacy)いいえInternet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
TrackEvent トラックリストからトラックが削除されたとき。

以下のイベントは、TextTrackオブジェクトおよびtrack要素で発生します：

イベント名 インターフェース 発生するタイミング...
cuechange

HTMLTrackElement/cuechange_event

すべての現行エンジンでサポートされています。

Firefox68+Safari10+Chrome32+
Opera19+Edge79+
Edge (Legacy)14+Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android4.4.3+Samsung Internet?Opera Android19+

TextTrack/cuechange_event

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event トラック内の 1 つ以上のキューがアクティブになったか、アクティブでなくなったとき。

以下のイベントは、track要素で発生します：

イベント名 インターフェース 発生するタイミング...
error Event トラックデータの取得中にエラーが発生した場合、またはリソースのタイプがサポートされていないテキストトラック形式である場合。
load Event トラックデータが取得され、正常に処理された場合。

以下のイベントは、TextTrackCueオブジェクトで発生します：

イベント名 インターフェース 発生するタイミング...
enter

TextTrackCue/enter_event

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event キューがアクティブになったとき。
exit

TextTrackCue/exit_event

すべての現行エンジンでサポートされています。

Firefox31+Safari6+Chrome23+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event キューがアクティブでなくなったとき。
4.8.11.17 セキュリティとプライバシーに関する考慮事項

videoおよびaudio要素の主なセキュリティとプライバシーへの影響は、クロスオリジンでメディアを埋め込む機能に由来します。脅威が流れる方向は、悪意のあるコンテンツから被害者のページへのものと、悪意のあるページから被害者のコンテンツへのものの二方向です。

被害者のページが悪意のあるコンテンツを埋め込む場合、脅威はそのコンテンツに埋め込まれたスクリプトがDocumentに対して何らかの操作を試みる可能性があるということです。これを回避するために、ユーザーエージェントはコンテンツから埋め込んだページへのアクセスがないことを保証しなければなりません。DOMの概念を使用するメディアコンテンツの場合、埋め込まれたコンテンツは、独自の無関係なトップレベルのトラバース可能として扱わなければなりません。

例えば、SVGアニメーションがvideo要素に埋め込まれた場合、ユーザーエージェントは外側のページのDOMにアクセスさせません。SVGリソース内のスクリプトの視点から見ると、SVGファイルは親を持たない単独のトップレベルトラバース可能として表示されます。

悪意のあるページが被害者のコンテンツを埋め込む場合、脅威は埋め込みページがそれ以外ではアクセスできない情報をコンテンツから取得できることです。APIは、メディアの存在、その種類、継続時間、サイズ、およびホストのパフォーマンス特性などの情報を公開します。このような情報はすでに問題を引き起こす可能性がありますが、実際には同様の情報はimg要素を使用してもほぼ同様に取得できるため、許容されると考えられています。

しかし、ユーザーエージェントがコンテンツ内のメタデータ（字幕など）をさらに公開すると、はるかに機密性の高い情報が取得される可能性があります。そのため、この情報はビデオリソースがCORSを使用している場合にのみ公開されます。crossorigin属性は、CORSを有効にするために著者が使用できます。[FETCH]

この制限がなければ、攻撃者は企業ネットワーク内で実行中のユーザーをだまして、企業のイントラネット上の以前に漏洩した場所からビデオを読み込もうとするサイトにアクセスさせる可能性があります。そのようなビデオに新製品の機密計画が含まれていた場合、字幕を読むことができると深刻な機密情報の漏洩につながります。

4.8.11.18 メディア要素を使用する著者のためのベストプラクティス

このセクションは規範的ではありません。

セットトップボックスや携帯電話などの小型デバイスでオーディオおよびビデオリソースを再生する場合、デバイスのハードウェアリソースが限られていることが多いです。例えば、デバイスが同時にサポートできるビデオは3つだけかもしれません。このため、メディア要素が再生を終えたら、そのリソースを解放することが良いプラクティスです。これには、要素へのすべての参照を非常に慎重に削除し、ガベージコレクションが行われるようにするか、さらに良い方法として、要素のsrc属性を空の文字列に設定することが含まれます。srcObjectが設定されていた場合は、代わりにsrcObjectをnullに設定します。

同様に、再生速度が正確に1.0でない場合、ハードウェア、ソフトウェア、またはフォーマットの制限により、ビデオフレームがドロップしたり、音声が途切れたりミュートされたりする可能性があります。

4.8.11.19 メディア要素を実装する際のベストプラクティス

このセクションは規範的ではありません。

さまざまな側面でメディア要素APIがどれだけ正確に実装されているかは、実装の品質に関する問題と見なされます。

例えば、buffered属性を実装する際、バッファされた範囲をどれだけ正確に報告するかは、ユーザーエージェントがデータをどれだけ慎重に検査するかに依存します。APIは範囲を時間として報告しますが、データはバイトストリームで取得されるため、可変ビットレートストリームを受信するユーザーエージェントは、すべてのデータを実際にデコードすることでのみ正確な時間を決定できるかもしれません。ただし、ユーザーエージェントがこれを行う必要はなく、代わりに推定値を返すことができます（たとえば、これまでに見られた平均ビットレートに基づいて）、その後の情報が利用可能になると修正されます。

一般的なルールとして、ユーザーエージェントは楽観的ではなく慎重であることが推奨されます。例えば、すべてがバッファされたと報告したが実際にはそうでなかった場合、それは問題です。

もう一つの実装の品質に関する問題は、コーデックが前方向の再生専用に設計されている場合にビデオを逆方向に再生することです（たとえば、キーフレームが少なく、それらが離れており、間のフレームは前のフレームからのデルタしか持たない場合）。ユーザーエージェントは、キーフレームのみを表示するなど、低品質な処理を行うかもしれません。しかし、より良い実装では、前方にビデオの部分を実際にデコードし、完全なフレームを保存し、それを逆方向に再生するなど、より多くの作業を行い、結果としてより良い処理を行います。

同様に、実装はいつでもバッファされたデータを破棄することが許可されていますが（メディア要素のライフタイム中に取得されたすべてのメディアデータをユーザーエージェントが保持する必要はありません）、これも実装の品質に関する問題です。十分なリソースを持つユーザーエージェントは、すべてのデータを保持することが推奨されます。これにより、より良いユーザー体験が可能になります。例えば、ユーザーがライブストリームを視聴している場合、ユーザーエージェントはユーザーにライブビデオのみを表示させることができますが、より優れたユーザーエージェントはすべてをバッファし、ユーザーが以前の素材をシークしたり、一時停止したり、前後に再生したりできるようにします。

メディア要素が一時停止中にドキュメントから削除され、イベントループがステップ1に到達する前に再挿入されない場合、リソースに制約のある実装は、その機会を利用して、メディア要素が使用するすべてのハードウェアリソース（ビデオプレーン、ネットワークリソース、データバッファなど）を解放することが推奨されます。（ただし、後で再生が再開された場合に備えて、ユーザーエージェントは再生位置などを追跡し続ける必要があります。）

4.8.12 map 要素

Element/map

全てのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLMapElement

全てのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
パルパブルコンテンツ.
使用できるコンテキスト:
フレージングコンテンツが予期される場所。
コンテンツモデル:
透明.
text/htmlでのタグ省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
name — イメージマップの名前を指定し、usemap属性から参照されるようにする
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOMインターフェース: 
[Exposed=Window]
インターフェイス HTMLMapElement : HTMLElement {
    [HTMLConstructor] コンストラクター();
 
    [CEReactions] 属性 DOMString name;
    [SameObject] readonly 属性 HTMLCollection areas;
};

map要素は、img要素および任意のarea要素の子孫と組み合わせて、イメージマップを定義します。この要素はその子孫を表現します。

name属性は、マップに名前を与えて、参照できるようにします。この属性は必須であり、非空の値を持ち、ASCII空白文字を含まない必要があります。name属性の値は、同じツリー内の別のmap要素のname属性の値と一致してはなりません。id属性も指定されている場合、両方の属性は同じ値を持つ必要があります。

map.areas

HTMLCollectionを返します。area要素のmap。

areas属性は、HTMLCollectionを返さなければなりません。map要素をルートとし、フィルターがarea要素にのみ一致します。

ID属性nameは、同じ名前のコンテンツ属性を反映しなければなりません。

イメージマップは、ページ上の他のコンテンツと組み合わせて定義することができ、保守が容易です。この例は、ページの上部にイメージマップがあり、対応するテキストリンクがページの下部にあるページの例です。

<!DOCTYPE HTML>
<HTML LANG="EN">
<TITLE>Babies™: Toys</TITLE>
<HEADER>
    <H1>Toys</H1>
    <IMG SRC="/images/menu.gif"
    ALT="Babies™ navigation menu. Select a department to go to its page."
    USEMAP="#NAV">
</HEADER>
...
<FOOTER>
    <MAP NAME="NAV">
    <P>
    <A HREF="/clothes/">Clothes</A>
    <AREA ALT="Clothes" COORDS="0,0,100,50" HREF="/clothes/"> |
    <A HREF="/toys/">Toys</A>
    <AREA ALT="Toys" COORDS="100,0,200,50" HREF="/toys/"> |
    <A HREF="/food/">Food</A>
    <AREA ALT="Food" COORDS="200,0,300,50" HREF="/food/"> |
    <A HREF="/books/">Books</A>
    <AREA ALT="Books" COORDS="300,0,400,50" HREF="/books/">
    </P>
    </MAP>
</FOOTER>

4.8.13 area要素

要素/area

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLAreaElement

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
使用できるコンテキスト:
フレージングコンテンツが期待される場所ですが、map要素の祖先が存在する場合のみ。
コンテンツモデル:
なし。
text/htmlでのタグ省略:
終了タグなし。
コンテンツ属性:
グローバル属性
alt — 画像が利用できない場合の代替テキスト
coords — イメージマップに作成される形状の座標
shape — イメージマップに作成される形状の種類
href — ハイパーリンクのアドレス
target — ナビゲーブルのハイパーリンク ナビゲーション
download — リソースをナビゲートする代わりにダウンロードするかどうか、およびその場合のファイル名
ping — URLにpingを送信
rel — ハイパーリンクを含む文書の位置と宛先リソースの間の関係
referrerpolicy — 要素によって開始された参照ポリシー。
アクセシビリティの考慮事項:
要素にhref属性がある場合: 著者向け; 実装者向け。
それ以外の場合: 著者向け; 実装者向け。
DOMインターフェイス: 
[Exposed=Window]
 interface HTMLAreaElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString alt;
   [CEReactions] attribute DOMString coords;
   [CEReactions] attribute DOMString shape;
   [CEReactions] attribute DOMString target;
   [CEReactions] attribute DOMString download;
   [CEReactions] attribute USVString ping;
   [CEReactions] attribute DOMString rel;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList relList;
   [CEReactions] attribute DOMString referrerPolicy;
 
   // also has obsolete members
 };
 HTMLAreaElement includes HTMLHyperlinkElementUtils;

area要素は、テキストを伴ったハイパーリンクと画像マップ上の対応する領域、または画像マップ上の無効な領域のいずれかを表します。

親ノードを持つarea要素には、map要素の祖先が必要です。

もしarea要素にhref属性がある場合、そのarea要素はハイパーリンクを表します。この場合、alt属性が必要です。これはハイパーリンクのテキストを指定します。この値は、他のハイパーリンクのために指定されたテキストや、画像の代替テキストと共に提示されたときに、画像自体なしでハイパーリンクが提供するのと同じ種類の選択肢をユーザーに提供するテキストでなければなりません。もし同じ画像マップ内に同じリソースを指す別のarea要素があり、そのalt属性が空でない場合、alt属性は空白のままにすることができます。

もしarea要素にhref属性がない場合、その要素が表す領域は選択できず、alt属性は省略されなければなりません。

いずれの場合も、shapeおよびcoords属性はその領域を指定します。

shape属性は列挙属性であり、次のキーワードと状態を持ちます。

キーワード 準拠 状態 簡単な説明
circle 円状態 coords属性にちょうど3つの整数を使用して円を指定します。
circ いいえ
default デフォルト状態 このエリアは画像全体です。(coords属性は使用されません。)
poly 多角形状態 coords属性に少なくとも6つの整数を使用して多角形を指定します。
polygon いいえ
rect 矩形状態 coords属性にちょうど4つの整数を使用して矩形を指定します。
rectangle いいえ

属性の欠落値のデフォルトと無効値のデフォルトは、いずれも矩形状態です。

coords属性は、指定されている場合、有効な浮動小数点数のリストを含んでいる必要があります。この属性は、shape属性で記述された形状の座標を指定します。この属性の処理は画像マップの処理モデルの一部として説明されています。

円状態では、area要素はcoords属性を持つ必要があり、3つの整数が含まれている必要があります。最後の整数は非負でなければなりません。最初の整数は画像の左端から円の中心までの距離を表し、2番目の整数は画像の上端から円の中心までの距離を表し、3番目の整数は円の半径を表します。

デフォルト状態では、area要素はcoords属性を持つことができません。（エリアは画像全体です。）

多角形状態では、area要素はcoords属性を持ち、少なくとも6つの整数が含まれている必要があります。整数の数は偶数でなければなりません。各整数のペアは、画像の左端および上端からの距離を表し、すべての座標はポリゴンの頂点を順に表します。

矩形状態では、area要素はcoords属性を持ち、ちょうど4つの整数が含まれている必要があります。最初の整数は3番目の整数より小さく、2番目の整数は4番目の整数より小さくなければなりません。この4つの整数はそれぞれ、画像の左端から矩形の左側までの距離、上端から矩形の上端までの距離、左端から矩形の右側までの距離、および上端から矩形の下端までの距離を表します。

ユーザーエージェントがハイパーリンクのフォローやハイパーリンクのダウンロードを許可する場合、area要素を使用して作成されたリンクは、href、target、download、およびping属性によってリンクのフォロー方法が決定されます。rel属性は、リンクをフォローする前にターゲットリソースの性質をユーザーに示すために使用できます。

target、download、ping、rel、およびreferrerpolicy属性は、href属性が存在しない場合、省略しなければなりません。

itemprop属性がarea要素に指定されている場合、href属性も指定されなければなりません。

HTMLAreaElement/rel

すべての現行エンジンでサポートされています。

Firefox30+Safari9+Chrome54+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

IDL属性alt、coords、shape、target、 download、ping、およびrelは、それぞれ同名の対応するコンテンツ属性を反映しなければなりません。

HTMLAreaElement/relList

すべての現行エンジンでサポートされています。

Firefox30+Safari9+Chrome65+
Opera41+Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android41+

IDL属性relListは、relコンテンツ属性を反映しなければなりません。

HTMLAreaElement/referrerPolicy

すべての現行エンジンでサポートされています。

Firefox50+Safari14.1+Chrome52+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

IDL属性referrerPolicyは、referrerpolicyコンテンツ属性を反映し、既知の値のみに制限されなければなりません。

4.8.14 イメージマップ

4.8.14.1 オーサリング

イメージマップは、画像上の幾何学的な領域をハイパーリンクに関連付けることができます。

img要素の形式で画像が表示されている場合、map要素の形式でイメージマップに関連付けることができます。usemap属性が指定されている場合、img要素にusemap属性を指定することで、イメージマップに関連付けることができます。

次のような画像を考えてみてください：

四つの図形が等間隔に並んだ線：赤い空の四角形、緑の円、青い三角形、黄色の四方星形。

クリック可能な領域を色付きの部分に限定したい場合、次のように行うことができます：

<p>
  図形を選んでください：
  <img src="shapes.png" usemap="#shapes"
       alt="四つの図形が利用可能です：赤い空の四角形、緑の円、青い三角形、黄色の四方星形。">
  <map name="shapes">
   <area shape=rect coords="50,50,100,100"> <!-- 赤い箱の穴 -->
   <area shape=rect coords="25,25,125,125" href="red.html" alt="赤い箱。">
   <area shape=circle coords="200,75,50" href="green.html" alt="緑の円。">
   <area shape=poly coords="325,25,262,125,388,125" href="blue.html" alt="青い三角形。">
   <area shape=poly coords="450,25,435,60,400,75,435,90,450,125,465,90,500,75,465,60"
         href="yellow.html" alt="黄色の星形。">
  </map>
 </p>
4.8.14.2 処理モデル

もし、img要素に usemap属性が指定されている場合、ユーザーエージェントは以下のように処理する必要があります:

  1. 属性の値をハッシュ名参照の解析ルールを使用して、 map要素に解析し、 その要素をコンテキストノードとして使用します。これにより、要素（map）またはnullが返されます。

  2. nullが返された場合は、終了します。画像はイメージマップと関連付けられていません。

  3. それ以外の場合、ユーザーエージェントはarea要素をすべて収集し、 それらがareasとなります。

イメージマップを構成するarea要素のリストを取得した後、 インタラクティブなユーザーエージェントはそのリストを2つの方法のいずれかで処理する必要があります。

ユーザーエージェントがimg要素が表すテキストを表示するつもりである場合、 次の手順を使用する必要があります。

  1. areas内のarea要素で href属性が ないものをすべて削除します。

  2. areas内のarea要素で alt属性がないもの、または alt属性の値が空文字列であるものを、 同じ値を持つ別のarea要素が href属性にあり、 非空のalt属性を持っている場合に削除します。

  3. 残りのarea要素は ハイパーリンクを表します。これらのハイパーリンクはすべて、 imgのテキストに関連する形で ユーザーに提供されるべきです。

    この文脈では、ユーザーエージェントはareaおよび img要素に指定されていない alt属性や、alt属性が空文字列やその他の非表示テキストである場合に、 著者提供のテキストが不足していることを示すための 実装定義の方法でそれらを表現することができます。

ユーザーエージェントが画像を表示し、画像とのインタラクションを通じてハイパーリンクを選択できるようにするつもりである場合、 画像はareas内のarea要素から取得した レイヤー化された形状のセットと関連付けられる必要があります。これらの形状はツリー順序の逆順に 処理されます（つまり、map内で最後に指定されたarea要素が 最下層の形状となり、map内で最初に指定された要素が最上層の形状となります）。

areas内の各area要素は、 画像にレイヤーを追加するために以下のように処理される必要があります:

  1. 要素のshape属性が 表す状態を確認します。

  2. 要素のcoords属性が 存在する場合、浮動小数点数のリストを解析するルールを使用して解析し、 結果をcoordsリストとします。属性が存在しない場合は、coordsリストを空のリストとします。

  3. coordsリストの項目数が、area要素の現在の状態に対応する以下の表で示されている最小数に満たない場合、 形状は空であり、終了します。

    状態 最小項目数
    円形状態 3
    デフォルト状態 0
    多角形状態 6
    矩形状態 4

  4. 次のリストのエントリに従って、shape属性の状態に対応する coordsリスト内の過剰項目をチェックします：

    円形状態
    リストの3番目以降の項目を削除します。
    デフォルト状態
    リスト内のすべての項目を削除します。
    多角形状態
    項目数が奇数の場合、最後の項目を削除します。
    矩形状態
    リストの4番目以降の項目を削除します。

  5. shape属性が 矩形状態を表し、 リストの最初の数字がリストの3番目の数字よりも大きい場合は、その2つの数字を入れ替えます。

  6. shape属性が 矩形状態を表し、 リストの2番目の数字がリストの4番目の数字よりも大きい場合は、その2つの数字を入れ替えます。

  7. shape属性が 円形状態を表し、 リストの3番目の数字が0以下である場合、形状は空であり、終了します。

  8. 今、要素が表す形状は、以下のリストでshape属性の状態に対応する エントリに記述されたものです：

    円形状態

    xをcoordsの最初の数字とし、yを2番目の数字とし、 rを3番目の数字とします。

    形状は、xが左端からyが上端からそれぞれr離れた位置に中心を持ち、 rが半径の円です。

    デフォルト状態

    形状は、画像全体を覆う矩形です。

    多角形状態

    xiをcoordsの(2i)番目のエントリとし、 yiをcoordsの(2i+1)番目のエントリとします （coordsの最初のエントリがインデックス0のものとします）。

    the coordinatesを（xi, yi）とし、 これを画像の左上から測定した CSSピクセル で解釈します。 iの値は0から(N/2)-1までの整数値で、 Nはcoords内の項目数です。

    形状は頂点がthe coordinatesで与えられた多角形で、その内部は偶奇規則を使用して確立されます。 [GRAPHICS]

    矩形状態

    x1をcoordsの最初の数字とし、 y1を2番目の数字とし、 x2を3番目の数字とし、 y2を4番目の数字とします。

    形状は、左上隅の座標が（x1, y1）で、 右下隅の座標が（x2, y2）である矩形です。 これらの座標は画像の左上から測定した CSSピクセル で解釈されます。

    歴史的な理由から、座標はCSSの幅および 高さプロパティ（または、非CSSブラウザの場合はimg要素のwidthおよびheight属性）によって引き伸ばされた後の表示された画像に対して相対的に解釈される必要があります。

    ブラウザのズーム機能やCSSやSVGを使用して適用される変形は、座標には影響しません。

上記のアルゴリズムに従って一連のレイヤー化された形状に関連付けられた画像とのポインティングデバイスによるインタラクションは、ポインティングデバイスが指示したポイントを覆う最上位の形状があれば、まずその形状に対して、なければ画像要素自体に対して、関連するユーザーインタラクションイベントが最初に発火する必要があります。ユーザーエージェントはまた、area要素で表される ハイパーリンクを個別に選択およびアクティベートできるようにすることもできます（例：キーボードを使用して）。

map要素（およびその area要素）は、複数のimg要素に関連付けることができるため、area要素がドキュメント内の複数のフォーカス可能な領域に対応することが可能です。

イメージマップはライブであり、DOMが変更された場合、ユーザーエージェントはイメージマップのアルゴリズムを再実行したかのように動作する必要があります。

4.8.15 MathML

HTML/HTML5/HTML5_Parser#Inline_SVG_and_MathML_support

すべての現行エンジンでサポートされています。

Firefox4+Safari5.1+Chrome7+
Opera11.6+Edge79+
Edge (旧版)12+Internet Explorer9+
Firefox Android5+Safari iOS5+Chrome Android18+WebView Android3+Samsung Internet1.0+Opera Android12+

MathML math 要素は、この仕様書のコンテンツモデルにおいて 埋め込みコンテンツ、フレージングコンテンツ、フローコンテンツ、および 明示的コンテンツ カテゴリーに分類されます。

MathML annotation-xml 要素が HTML 名前空間 の要素を含む場合、これらの要素はすべて フローコンテンツ でなければなりません。

MathML トークン要素 (mi、mo、mn、ms、および mtext) が HTML 要素の子孫である場合、それらは フレージングコンテンツ の要素を HTML 名前空間 から含むことができます。

ユーザーエージェントは、MathML 要素のコンテンツモデルがストレートテキストを許可しない場合、その要素内の他のテキストを、MathML コンテンツモデル、レイアウト、およびレンダリングの目的で実際には MathML mtext 要素で囲まれているかのように扱わなければなりません。(ただし、そのようなテキストは準拠していません。)

ユーザーエージェントは、コンテンツがその要素のコンテンツモデルと一致しない MathML 要素があった場合、MathML レイアウトとレンダリングの目的で、それが適切なエラーメッセージを含む MathML merror 要素に置き換えられたかのように振る舞わなければなりません。

MathML 要素の意味論は MathML および その他の適用可能な仕様書 によって定義されています。[MATHML]

以下は、HTML ドキュメントで MathML を使用する例です。

<!DOCTYPE html>
 <html lang="en">
  <head>
   <title>The quadratic formula</title>
  </head>
  <body>
   <h1>The quadratic formula</h1>
   <p>
    <math>
     <mi>x</mi>
     <mo>=</mo>
     <mfrac>
      <mrow>
       <mo form="prefix">−</mo> <mi>b</mi> 
       <mo>±</mo> 
       <msqrt> 
        <msup> </mi>b</mi> </mn>2</mn> </msup> 
        </mo>−</mo> 
        </mn>4</mn> </mo>⁢</mo> </mi>a</mi> </mo>⁢</mo> </mi>c</mi> 
       </msqrt> 
      </mrow> 
      </mrow> 
       </mn>2</mn> </mo>⁢</mo> </mi>a</mi> 
      </mrow> 
     </mfrac> 
    </math> 
   </p> 
  </body> 
 </html>

4.8.16 SVG

HTML/HTML5/HTML5_Parser#Inline_SVG_and_MathML_support

すべての現行エンジンでサポートされています。

Firefox37+Safari11.1+Chrome7+
Opera15+Edge79+
Edge (旧版)12+Internet Explorer10+
Firefox Android37+Safari iOS11.3+Chrome Android18+WebView Android4.4+Samsung Internet4+Opera Android15+

SVG svg 要素は、この仕様書のコンテンツモデルにおいて 埋め込みコンテンツ、フレージングコンテンツ、フローコンテンツ、および 明示的コンテンツ カテゴリーに分類されます。

SVG foreignObject 要素が HTML 名前空間 の要素を含む場合、これらの要素はすべて フローコンテンツ でなければなりません。

SVG title 要素の HTML ドキュメント 内のコンテンツモデルは フレージングコンテンツ です。 (これは SVG 2 による要件をさらに制約します。)

SVG 要素の意味論は SVG 2 および その他の適用可能な 仕様書 によって定義されています。[SVG]

doc = iframe.getSVGDocument()
doc = embed.getSVGDocument()
doc = object.getSVGDocument()

Document オブジェクトを返します。対象となる要素が iframe、 embed、または object であり、これらが SVG を埋め込むために使用されている場合です。

getSVGDocument() メソッドの手順は次のとおりです。

  1. document を this の コンテンツドキュメント とします。

  2. もし document が null でなく、かつ XML ファイルのページ読み込み処理モデル によって作成されたものであり、かつ リソースの推定タイプ が image/svg+xml であった場合には、document を返します。

  3. null を返します。

4.8.17 次元属性

著者要件: img、iframe、 embed、object、 video、source要素に対して、 width属性と height属性が指定される場合、その親が picture要素であり、 type属性が 画像ボタン状態にある場合、 input要素に対して、視覚的なコンテンツの次元 （それぞれの幅と高さ）を、出力媒体の標準方向に対してCSSピクセルで指定することができます。これらの属性が指定される場合、その値は 有効な非負整数でなければなりません。

指定された次元は、リソース自体で指定された次元と異なる場合があります。これは、リソースがCSSピクセルの解像度と異なる解像度を持っている可能性があるためです。 （画面では、CSSピクセルは96ppiの解像度を持ちますが、一般的にCSSピクセルの解像度は閲覧距離に依存します。） 両方の属性が指定される場合、次のいずれかの条件が真でなければなりません：

target ratioとは、リソース内の 自然幅と自然高さ の比率です。specified widthとspecified heightは、それぞれ widthと height属性の値です。

対象リソースに自然幅と自然高さ が両方存在しない場合、これらの2つの属性は省略しなければなりません。

両方の属性が0である場合、それは要素がユーザー向けでないことを示しています（例：ページビューをカウントするサービスの一部かもしれません）。

次元属性は画像を引き伸ばすために使用されることを意図していません。

ユーザーエージェント要件: ユーザーエージェントは、レンダリングのヒントとして これらの属性を使用することが期待されています。

HTMLObjectElement/width

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLObjectElement/height

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

widthおよびheightIDL属性は、iframe、 embed、 object、 source、 およびvideo 要素に対して、それぞれ同名のコンテンツ属性を反映する必要があります。

iframe、 embed、 およびobject に対するIDL属性はDOMStringです。videoと sourceのIDL属性はunsigned longです。

imgおよび input要素に対する対応するIDL属性は、それぞれの要素の他の動作にやや特有であるため、それぞれの要素のセクションで定義されています。

4.9 表データ

4.9.1 table要素

Element/table

全ての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLTableElement

全ての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
パルパブルコンテンツ.
この要素が使用できるコンテキスト:
フローコンテンツが予想される場所。
コンテンツモデル:
この順序で: オプションでcaption要素が続き、ゼロまたは複数のcolgroup要素が続き、オプションでthead要素が続き、ゼロまたは複数のtbody要素または1つ以上のtr要素が続き、オプションでtfoot要素が続き、オプションで1つまたは複数のスクリプトサポート要素が混在します。
text/htmlでのタグ省略:
タグは省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け.
実装者向け.
DOMインターフェース: 
[Exposed=Window]
interface HTMLTableElement : HTMLElement {
[HTMLConstructor] constructor();

[CEReactions] attribute HTMLTableCaptionElement? caption;
HTMLTableCaptionElement createCaption();
[CEReactions] undefined deleteCaption();

[CEReactions] attribute HTMLTableSectionElement? tHead;
HTMLTableSectionElement createTHead();
[CEReactions] undefined deleteTHead();

[CEReactions] attribute HTMLTableSectionElement? tFoot;
HTMLTableSectionElement createTFoot();
[CEReactions] undefined deleteTFoot();

[SameObject] readonly attribute HTMLCollection tBodies;
HTMLTableSectionElement createTBody();

[SameObject] readonly attribute HTMLCollection rows;
HTMLTableRowElement insertRow(optional long index = -1);
[CEReactions] undefined deleteRow(long index);

// also has obsolete members
};

table要素は、表の形で複数次元のデータを表します。

table要素は、表モデルに参加します。表にはその子孫によって与えられる行、列、セルがあります。行と列はグリッドを形成し、表のセルはそのグリッドを完全にカバーし、重複は許されません。

この適合要件が満たされているかどうかを判断するための正確な規則は、表モデルの説明で説明されています。

著者は、複雑な表の解釈方法を説明する情報を提供することが推奨されます。そのような情報を提供する方法に関するガイダンスは以下に記載されています。

表はレイアウト補助として使用してはなりません。歴史的に、いくつかのウェブ著者はHTMLの表をページレイアウトを制御する手段として誤用してきました。この使用法は適合しません。なぜなら、そのようなドキュメントから表データを抽出しようとするツールは非常に混乱する結果を得るからです。特に、スクリーンリーダーなどのアクセシビリティツールのユーザーは、レイアウトに使用された表のページをナビゲートするのが非常に難しいと感じる可能性があります。

HTML表をレイアウトに使用する代替手段として、CSSグリッドレイアウト、CSSフレックスボックスレイアウト（"flexbox"）、CSSマルチカラムレイアウト、CSSポジショニング、CSSテーブルモデルなどがあります。[CSS]

表は理解しやすくナビゲートしやすくするために、セルを明確に区別するべきです。ユーザーエージェントが表を（非適合の）レイアウト表として分類していない限り、セルを明確に区別するべきです。

著者および実装者は、表をユーザーにとってナビゲートしやすくするために、表デザインの手法のいくつかを使用することを検討することが推奨されます。

特に任意のコンテンツで表分析を行うユーザーエージェントは、どの表が実際にデータを含み、どの表が単にレイアウトに使用されているかを判断するためのヒューリスティックを見つけることが推奨されます。この仕様は正確なヒューリスティックを定義していませんが、以下は可能な指標として提案されています。

特徴 示唆
role属性にpresentationの値が使用されている おそらくレイアウト表
border属性に0の非適合値が使用されている おそらくレイアウト表
cellspacingとcellpadding属性に0の非適合値が使用されている おそらくレイアウト表
caption、thead、またはth要素が使用されている おそらく非レイアウト表
headersおよびscope属性が使用されている おそらく非レイアウト表
border属性に0以外の値が使用されている おそらく非レイアウト表
CSSで設定された明示的な目に見えるボーダー おそらく非レイアウト表
summary属性が使用されている 良い指標ではありません（歴史的にレイアウト表と非レイアウト表の両方にこの属性が付与されています）

上記の提案が間違っている可能性は十分にあります。実装者は、レイアウト表の検出ヒューリスティックを作成しようとした際の経験に基づいてフィードバックを提供することが推奨されます。

table要素に（非適合の）summary属性があり、ユーザーエージェントが表をレイアウト表として分類していない場合、ユーザーエージェントはその属性の内容をユーザーに報告してもかまいません。

table.caption [ = value ]

HTMLTableElement/caption

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルのcaption要素を返します。

設定可能で、caption要素を置き換えます。

caption = table.createCaption()

HTMLTableElement/createCaption

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルにcaption要素があることを保証し、返します。

table.deleteCaption()

HTMLTableElement/deleteCaption

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルにcaption要素がないことを保証します。

table.tHead [ = value ]

HTMLTableElement/tHead

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルのthead要素を返します。

設定可能で、thead要素を置き換えます。新しい値がthead要素でない場合、"HierarchyRequestError" DOMExceptionをスローします。

thead = table.createTHead()

HTMLTableElement/createTHead

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルにthead要素があることを保証し、返します。

table.deleteTHead()

HTMLTableElement/deleteTHead

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルにthead要素がないことを保証します。

table.tFoot [ = value ]

HTMLTableElement/tFoot

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルのtfoot要素を返します。

設定可能で、tfoot要素を置き換えます。新しい値がtfoot要素でない場合、"HierarchyRequestError" DOMExceptionをスローします。

tfoot = table.createTFoot()

HTMLTableElement/createTFoot

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルにtfoot要素があることを保証し、返します。

table.deleteTFoot()

HTMLTableElement/deleteTFoot

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルにtfoot要素がないことを保証します。

table.tBodies

HTMLTableElement/tBodies

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルのHTMLCollectionを返します。

tbody要素の

tbody = table.createTBody()

HTMLTableElement/createTBody

すべての現在のエンジンでサポートされています。

Firefox25+Safari6+Chrome20+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

テーブルにtbody要素を作成し、挿入して返します。

table.rows

HTMLTableElement/rows

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブルのHTMLCollectionのtr要素を返します。

tr = table.insertRow([ index ])

HTMLTableElement/insertRow

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera10+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

必要に応じてtbodyとともにtr要素を作成し、それらをテーブルの引数で指定された位置に挿入し、trを返します。

位置はテーブル内の行に対して相対的です。引数が省略された場合のデフォルトであるインデックス−1は、テーブルの最後に挿入することと同等です。

指定された位置が−1より小さいか、行の数より大きい場合、"IndexSizeError" DOMExceptionをスローします。

table.deleteRow(index)

HTMLTableElement/deleteRow

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

テーブル内の指定された位置にあるtr要素を削除します。

位置はテーブル内の行に対して相対的です。インデックス−1はテーブルの最後の行を削除することに相当します。

指定された位置が−1より小さいか、最後の行のインデックスより大きい場合、または行がない場合、"IndexSizeError" DOMExceptionをスローします。

次のすべての属性およびメソッドの定義において、要素がテーブル作成される場合、それは要素を作成することを意味します。指定されたローカル名とノードドキュメント、およびHTML名前空間を使用して、table要素のノードを指定します。

captionIDL属性は、取得時にcaption要素を返さなければなりません。table要素の最初の子要素が存在する場合、それを返し、存在しない場合はnullを返します。設定時には、最初のcaption要素が削除され、新しい値がnullでない場合は、それをtable要素の最初のノードとして挿入しなければなりません。

createCaption()メソッドは、caption要素を返さなければなりません。table要素の最初の子要素が存在する場合、それを返し、存在しない場合は新しいcaption要素をテーブル作成し、table要素の最初のノードとして挿入し、それを返さなければなりません。

deleteCaption()メソッドは、caption要素を削除しなければなりません。table要素の最初の子要素が存在する場合、それを削除しなければなりません。

tHeadIDL属性は、取得時にthead要素を返さなければなりません。table要素の最初の子要素が存在する場合、それを返し、存在しない場合はnullを返します。設定時に新しい値がnullまたはthead要素の場合、最初のthead要素を削除し、新しい値がnullでない場合はtable要素の最初の要素の直前に挿入しなければなりません。それがcaption要素でもcolgroup要素でもない場合、もしくは該当する要素がない場合はテーブルの最後に挿入します。新しい値がnullでもthead要素でもない場合、"HierarchyRequestError" DOMExceptionがスローされなければなりません。

createTHead()メソッドは、table要素の最初のthead要素の子要素を返さなければなりません。もし存在しない場合は、新しいthead要素をtable-createdし、table要素内でcaption要素でもcolgroup要素でもない最初の要素の直前、またはそのような要素がない場合はテーブルの最後に挿入し、その新しい要素を返さなければなりません。

deleteTHead()メソッドは、thead要素を削除しなければなりません。table要素の最初の子要素が存在する場合、それを削除しなければなりません。

tFootIDL属性は、取得時にtfoot要素を返さなければなりません。table要素の最初の子要素が存在する場合、それを返し、存在しない場合はnullを返します。設定時に新しい値がnullまたはtfoot要素の場合、最初のtfoot要素を削除し、新しい値がnullでない場合はテーブルの最後に挿入しなければなりません。新しい値がnullでもtfoot要素でもない場合、"HierarchyRequestError" DOMExceptionがスローされなければなりません。

createTFoot()メソッドは、table要素の最初のtfoot要素の子要素を返さなければなりません。もし存在しない場合は、新しいtfoot要素をtable-createdし、テーブルの最後に挿入し、その新しい要素を返さなければなりません。

deleteTFoot()メソッドは、tfoot要素を削除しなければなりません。table要素の最初の子要素が存在する場合、それを削除しなければなりません。

tBodies属性は、HTMLCollectionを返さなければなりません。それは、tableノードにルートを持ち、フィルターはtbody要素のみを一致させ、それらはtable要素の子要素です。

createTBody()メソッドは、新しいtbody要素をテーブル作成し、それをtable要素内の最後のtbody要素の後に挿入するか、table要素がtbody要素を持たない場合はテーブルの最後に挿入し、新しいtbody要素を返さなければなりません。

rows属性は、HTMLCollectionを返さなければなりません。それは、tableノードにルートを持ち、フィルターはtr要素のみを一致させ、それらはtable要素の子要素、またはthead、tbody、またはtfoot要素の子要素です。コレクション内の要素は、theadの親が最初に含まれ、それがtbodyまたはtable要素の親が含まれ、最後にtfootの親が含まれ、それがツリー順に配置されます。

insertRow(index)メソッドの動作は、テーブルの状態によって異なります。呼び出されたとき、このメソッドは、以下の条件リストに記載されたテーブルの状態とindex引数を説明する最初の項目に従って動作しなければなりません。

indexが−1未満またはrowsコレクション内の要素数を超えている場合:
このメソッドは、"IndexSizeError"DOMExceptionをスローしなければなりません。
rowsコレクションに要素が一つもなく、かつtableにtbody要素が含まれていない場合:
このメソッドはtbody要素をテーブル作成し、次にtr要素をテーブル作成し、その後tr要素をtbody要素に追加し、次にtbody要素をtable要素に追加し、最終的にtr要素を返さなければなりません。
rowsコレクションに要素が一つもない場合:
このメソッドはtr要素をテーブル作成し、それをテーブル内の最後のtbody要素に追加し、そのtr要素を返さなければなりません。
indexが−1またはrowsコレクション内の項目数に等しい場合:
このメソッドはtr要素をテーブル作成し、次にrowsコレクション内の最後のtr要素の親に追加し、そして新たに作成されたtr要素を返さなければなりません。
その他の場合:
このメソッドはtr要素をテーブル作成し、それを同じ親内のrowsコレクション内のindex番目のtr要素の直前に挿入し、最終的に新たに作成されたtr要素を返さなければなりません。

deleteRow(index)メソッドが呼び出された場合、ユーザーエージェントは次の手順を実行しなければなりません。

  1. indexが−1未満またはrowsコレクション内の要素数以上の場合、"IndexSizeError"DOMExceptionをスローしなければなりません。
  2. indexが−1の場合、rowsコレクション内の最後の要素をその親から削除するか、rowsコレクションが空の場合は何もしません。
  3. その他の場合、rowsコレクション内のindex番目の要素をその親から削除しなければなりません。

以下は、数独パズルをマークアップするためにテーブルを使用した例です。このようなテーブルには見出しが必要ないことに注意してください。

<style>
  #sudoku { border-collapse: collapse; border: solid thick; }
  #sudoku colgroup, table#sudoku tbody { border: solid medium; }
  #sudoku td { border: solid thin; height: 1.4em; width: 1.4em; text-align: center; padding: 0; }
 </style>
 <h1>Today's Sudoku</h1>
 <table id="sudoku">
  <colgroup><col><col><col>
  <colgroup><col><col><col>
  <colgroup><col><col><col>
  <tbody>
   <tr> <td> 1 <td>   <td> 3 <td> 6 <td>   <td> 4 <td> 7 <td>   <td> 9
   <tr> <td>   <td> 2 <td>   <td>   <td> 9 <td>   <td>   <td> 1 <td>
   <tr> <td> 7 <td>   <td>   <td>   <td>   <td>   <td>   <td>   <td> 6
  <tbody>
   <tr> <td> 2 <td>   <td> 4 <td>   <td> 3 <td>   <td> 9 <td>   <td> 8
   <tr> <td>   <td>   <td>   <td>   <td>   <td>   <td>   <td>   <td>
   <tr> <td> 5 <td>   <td>   <td> 9 <td>   <td> 7 <td>   <td>   <td> 1
  <tbody>
   <tr> <td> 6 <td>   <td>   <td>   <td> 5 <td>   <td>   <td>   <td> 2
   <tr> <td>   <td>   <td>   <td>   <td> 7 <td>   <td>   <td>   <td>
   <tr> <td> 9 <td>   <td>   <td> 8 <td>   <td> 2 <td>   <td>   <td> 5
 </table>
4.9.1.1 テーブルを説明するための技術

最初の行にヘッダーがあり、最初の列にヘッダーがあるセルのグリッドだけで構成されているテーブルだけでなく、読者が内容を理解するのに苦労する可能性のある一般的なテーブルについても、著者はテーブルを紹介する説明情報を含めるべきです。この情報はすべてのユーザーにとって有用ですが、特にテーブルを見ることができないユーザー、たとえばスクリーンリーダーのユーザーにとって有用です。

このような説明情報は、テーブルの目的を紹介し、基本的なセル構造の概要を示し、傾向やパターンを強調し、一般的にユーザーがテーブルをどのように使用するかを教えるべきです。

例えば、次のテーブル:

肯定的および否定的な側面を持つ特徴
否定的 特徴 肯定的
悲しい 気分 幸せ
不合格 成績 合格

...は、テーブルの配置方法を説明するような説明があると役立つかもしれません。「特徴は第2列に示されており、左列に否定的な側面があり、右列に肯定的な側面があります。」のような説明です。

この情報を含める方法はいろいろあります。例えば:

テーブルの周囲にある文章で 
<p>以下のテーブルでは、特徴は第2列に示されており、左列に否定的な側面があり、右列に肯定的な側面があります。</p>
 <table>
  <caption>肯定的および否定的な側面を持つ特徴</caption>
  <thead>
   <tr>
    <th id="n"> 否定的
    <th> 特徴
    <th> 肯定的
  </thead>
   <tr>
    <td headers="n r1"> 悲しい
    <th id="r1"> 気分
    <td> 幸せ
   </tr>
    <td headers="n r2"> 不合格
    <th id="r2"> 成績
    </td> 合格
 </table>
テーブルのcaption内 
<table>
  <caption>
   <strong>肯定的および否定的な側面を持つ特徴。</strong>
   <p>特徴は第2列に示されており、左列に否定的な側面があり、右列に肯定的な側面があります。</p>
  </caption>
  </thead>
   <tr>
    <th id="n"> 否定的
    <th> 特徴
    <th> 肯定的
  </tbody>
   </tr>
    <td headers="n r1"> 悲しい
    <th id="r1"> 気分
    <td> 幸せ
   </tr>
    <td headers="n r2"> 不合格
    <th id="r2"> 成績
    </td> 合格
 </table>
テーブルのcaption内の details要素で 
<table>
  <caption>
   <strong>肯定的および否定的な側面を持つ特徴。</strong>
   <details>
    <summary>ヘルプ</summary>
    <p>特徴は第2列に示されており、左列に否定的な側面があり、右列に肯定的な側面があります。</p>
   </details>
  </caption>
  </thead>
   </tr>
    <th id="n"> 否定的
    <th> 特徴
    <th> 肯定的
  </tbody>
   </tr>
    <td headers="n r1"> 悲しい
    <th id="r1"> 気分
    <td> 幸せ
   </tr>
    <td headers="n r2"> 不合格
    <th id="r2"> 成績
    </td> 合格
 </table>
テーブルの横に、同じfigure内に 
<figure>
  <figcaption>肯定的および否定的な側面を持つ特徴</figcaption>
  <p>特徴は第2列に示されており、左列に否定的な側面があり、右列に肯定的な側面があります。</p>
  </table>
   </thead>
    <tr>
     <th id="n"> 否定的
     <th> 特徴
     <th> 肯定的
   </tbody>
    </tr>
     </td headers="n r1"> 悲しい
     <th id="r1"> 気分
     <td> 幸せ
    </tr>
     <td headers="n r2"> 不合格
     <th id="r2"> 成績
     </td> 合格
  </table>
 </figure>
テーブルの横に、figureの figcaption内に 
<figure>
  <figcaption>
   <strong>肯定的および否定的な側面を持つ特徴</strong>
   <p>特徴は第2列に示されており、左列に否定的な側面があり、右列に肯定的な側面があります。</p>
  </figcaption>
  </table>
   </thead>
    <tr>
     <th id="n"> 否定的
     <th> 特徴
     <th> 肯定的
   </tbody>
    </tr>
     </td headers="n r1"> 悲しい
     <th id="r1"> 気分
     <td> 幸せ
    </tr>
     <td headers="n r2"> 不合格
     <th id="r2"> 成績
     </td> 合格
  </table>
 </figure>

著者は、これらの技術の他にも、またはそれらの組み合わせを適切に使用することができます。

もちろん、テーブルのレイアウトを説明する記述を書くよりも、説明が不要になるようにテーブルを調整するのが最良の選択です。

上記の例で使用されているテーブルの場合、テーブルを簡単に再配置するだけで、説明が不要になると同時に、headers 属性を使用する必要もなくなります。

<table>
  <caption>肯定的および否定的な側面を持つ特徴</caption>
  <thead>
   <tr>
    <th> 特徴
    <th> 否定的
    <th> 肯定的
  </tbody>
   </tr>
    <th> 気分
    <td> 悲しい
    <td> 幸せ
   </tr>
    <th> 成績
    <td> 不合格
    <td> 合格
 </table>
4.9.1.2 テーブルデザインの技術

優れたテーブルデザインは、テーブルをより読みやすく、使いやすくするための重要な要素です。

視覚メディアでは、列と行の境界線を提供し、交互に行の背景色を変えることで、複雑なテーブルをより読みやすくすることが非常に効果的です。

数値の多いテーブルでは、等幅フォントを使用することで、特にユーザーエージェントが境界線をレンダリングしない状況で、ユーザーがパターンを見やすくすることができます。（残念ながら、歴史的な理由から、テーブルの境界線をレンダリングしないことが一般的なデフォルトとなっています。）

音声メディアでは、テーブルのセルを読み上げる前に対応するヘッダーを報告し、テーブルの内容をソース順に直列化するのではなく、グリッド形式でテーブルをナビゲートできるようにすることで、セルを区別することができます。

著者はこれらの効果を実現するためにCSSを使用することが推奨されます。

ユーザーエージェントは、ページがCSSを使用しておらず、テーブルがレイアウトテーブルとして分類されていない場合、これらの技術を使用してテーブルをレンダリングすることが推奨されます。

4.9.2 caption 要素

Element/caption

現在のすべてのエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLTableCaptionElement

現在のすべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる 文脈:
table 要素の最初の子要素として。
内容モデル:
フローコンテンツ、ただし子孫に table 要素を含まない。
text/html での タグ省略:
caption 要素の 終了タグは、 caption 要素が直後に ASCII ホワイトスペースや コメントが続かない場合、省略できます。
内容属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
[Exposed=Window]
 interface HTMLTableCaptionElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   // 廃止されたメンバーも含まれています
 };

caption 要素は、親が table 要素である場合、その タイトルを表します。

caption 要素は テーブルモデルに参加します。

table 要素が figure 要素の唯一のコンテンツであり、 それ以外に figcaption がある場合は、caption 要素は省略すべきです。

キャプションは、テーブルにコンテキストを提供し、理解を大幅に容易にすることができます。

例えば、次のテーブルを考えてみましょう:

1 2 3 4 5 6
1 2 3 4 5 6 7
2 3 4 5 6 7 8
3 4 5 6 7 8 9
4 5 6 7 8 9 10
5 6 7 8 9 10 11
6 7 8 9 10 11 12

抽象的には、このテーブルは明確ではありません。しかし、キャプションでテーブルの番号（メインの文章で参照するため）を示し、その使用方法を説明すると、より理解しやすくなります。

<caption>
 <p>Table 1.
 <p>このテーブルは、2つの6面ダイスを振ったときの合計点を示しています。最初の行は最初のダイスの値を表し、最初の列は2番目のダイスの値を表します。合計は、2つのダイスの値に対応するセルに表示されます。
 </caption>

これにより、ユーザーにより多くのコンテキストが提供されます:

Table 1.

このテーブルは、2つの6面ダイスを振ったときの合計点を示しています。最初の行は最初のダイスの値を表し、最初の列は2番目のダイスの値を表します。合計は、2つのダイスの値に対応するセルに表示されます。

1 2 3 4 5 6
1 2 3 4 5 6 7
2 3 4 5 6 7 8
3 4 5 6 7 8 9
4 5 6 7 8 9 10
5 6 7 8 9 10 11
6 7 8 9 10 11 12

4.9.3 colgroup 要素

Element/colgroup

現在のすべてのエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLTableColElement

現在のすべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
table 要素の子要素として、caption 要素の後、thead、 tbody、tfoot、tr 要素の前に配置されます。
内容モデル:
span 属性が存在する場合: なし。
span 属性が存在しない場合: 0個以上のcolおよびtemplate 要素を含みます。
text/html での タグ省略:
colgroup 要素の開始タグは、colgroup 要素内の最初の要素がcol 要素である場合、かつその要素が別のcolgroup 要素の直後にない場合は省略できます。（要素が空の場合、省略できません。）
colgroup 要素の終了タグは、colgroup 要素が直後にASCII ホワイトスペース やコメントが続かない場合、省略できます。
内容属性:
グローバル属性
span — 要素がまたがる列の数
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
[Exposed=Window]
 interface HTMLTableColElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute unsigned long span;
 
   // 廃止されたメンバーも含まれています
 };

colgroup要素は、親要素が存在し、かつそれがtable要素である場合、そのtable内の1つ以上の列のグループを表します。

colgroup 要素にcol 要素が含まれていない場合、この要素にはspan 内容属性が指定される場合があり、その値は0より大きく1000以下の有効な非負整数でなければなりません。

colgroup 要素とそのspan 属性はテーブルモデルに参加します。

span IDL 属性は同名の内容属性を反映しなければなりません。それは範囲[1, 1000]に制限され、そのデフォルト値は1です。

4.9.4 col 要素

Element/col

現在のすべてのエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
なし。
この要素が使用できる文脈:
colgroup 要素の子要素であり、span属性がない場合。
内容モデル:
なし。
text/html でのタグ省略:
終了タグはありません。
内容属性:
グローバル属性
span — 要素がまたがる列の数
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLTableColElement を使用します。これはcolgroup 要素に対して定義されています。

col要素が親を持ち、 その親がcolgroup 要素で、その親がtable 要素である場合、col 要素は、colgroup が表す列グループ内の 1つ以上の列を表します。

この要素にはspan内容属性が指定される場合があり、その値は 0より大きく1000以下の有効な非負整数でなければなりません。

col 要素とその span 属性はテーブルモデルに参加します。

4.9.5 tbody 要素

Element/tbody

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLTableSectionElement

現在のすべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
table要素の子要素として、caption、 colgroup、 およびthead要素の後に配置されますが、tr要素がその table要素の子でない場合に限ります。
内容モデル:
0個以上のtrおよび スクリプトサポート要素を含みます。
text/html でのタグ省略:
tbody要素の 開始タグは、tr要素が最初に含まれている場合、および tbody、thead、 またはtfoot要素が省略された終了タグで直前に続いていない場合、省略できます。（要素が空の場合、省略できません。）
tbody要素の 終了タグは、tbodyまたはtfoot要素が直後に続いている場合、 または親要素にそれ以上コンテンツがない場合、省略できます。
内容属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
[Exposed=Window]
 interface HTMLTableSectionElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [SameObject] readonly attribute HTMLCollection rows;
   HTMLTableRowElement insertRow(optional long index = -1);
   [CEReactions] undefined deleteRow(long index);
 
   // 廃止されたメンバーも含まれています
 };

HTMLTableSectionElementインターフェースは、 theadおよびtfoot要素にも使用されます。

tbody要素は、親がtable要素である場合、そのテーブルのデータ本体を構成する 行のブロックを表します。

tbody要素は テーブルモデルに参加します。

tbody.rows

このテーブルセクションのtr要素の HTMLCollectionを返します。

tr = tbody.insertRow([ index ])

tr要素を作成し、 引数で指定された位置にこのテーブルセクションに挿入し、trを返します。

位置はテーブルセクション内の行に対して相対的です。引数が省略された場合のデフォルトであるインデックス−1は、テーブルセクションの最後に挿入することと同等です。

指定された位置が−1より小さいか、行数を超えている場合、"IndexSizeError" DOMExceptionをスローします。

tbody.deleteRow(index)

このテーブルセクション内の指定された位置にあるtr要素を削除します。

位置はテーブルセクション内の行に対して相対的です。インデックス−1はテーブルセクションの最後の行を削除することと同等です。

指定された位置が−1より小さいか、最後の行のインデックスを超えている場合、または行が存在しない場合、"IndexSizeError" DOMExceptionをスローします。

rows属性は、この要素でルート化された HTMLCollectionを返さなければなりません。このフィルタは、この要素の子であるtr要素のみを一致させます。

insertRow(index)メソッドは以下のように動作しなければなりません:

  1. indexが−1より小さいか、rowsコレクション内の要素数を超えている場合、 "IndexSizeError" DOMExceptionをスローします。

  2. table row を、この要素のノードドキュメント、「tr」、およびHTML名前空間を指定して要素を作成した結果とします。

  3. indexが−1またはrowsコレクション内の項目数と等しい場合、 table rowをこの要素に追加します。

  4. それ以外の場合は、table rowをこの要素の子として、rowsコレクション内のindex番目のtr要素の直前に挿入します。

  5. table rowを返します。

deleteRow(index)メソッドは、呼び出されたとき、次のように動作しなければなりません:

  1. indexが−1より小さいか、rowsコレクション内の最後の行のインデックス以上である場合、 "IndexSizeError" DOMExceptionをスローします。

  2. indexが−1の場合、この要素からrowsコレクション内の最後の要素を削除するか、rowsコレクションが空である場合は何もしません。

  3. それ以外の場合、rowsコレクション内のindex番目の要素をこの要素から削除します。

4.9.6 thead 要素

Element/thead

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
table要素の子要素として、 caption要素および colgroup要素の後に、 そしてtbody、 tfoot、 およびtr要素の前に配置されますが、 そのtable要素の子である 他のthead要素がない場合に限ります。
内容モデル:
0個以上のtrおよび スクリプトサポート要素を含みます。
text/html でのタグ省略:
thead要素の 終了タグは、tbodyまたは tfoot要素が直後に続いている場合、省略できます。
内容属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLTableSectionElement を使用します。これはtbody要素に対して定義されています。

thead要素は、親がtable要素である場合、 そのテーブル要素の列ラベル（ヘッダ）と補助的な非ヘッダセルで構成される 行のブロックを表します。

thead要素は テーブルモデルに参加します。

この例は、thead要素の使用例を示しています。 th要素とtd要素の両方が thead要素内で使用されていることに注目してください。 最初の行はヘッダで、2番目の行はテーブルの記入方法を説明しています。 

<table>
  <caption> School auction sign-up sheet </caption>
  <thead>
   <tr>
    <th><label for=e1>Name</label>
    <th><label for=e2>Product</label>
    <th><label for=e3>Picture</label>
    <th><label for=e4>Price</label>
   </tr>
    <td>Your name here
    </td>
    <td>What are you selling?
    </td>
    <td>Link to a picture
    </td>
    <td>Your reserve price
  </tbody>
   <tr>
    </td>
    </td>
    </td>
    </td>
    </tr>
 </table>
 </form id=f action="/auction.cgi">
  </input type=button name=add value="Submit">
 </form>

4.9.7 tfoot 要素

Element/tfoot

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
table要素の子要素として、 caption、 colgroup、 thead、 tbody、 およびtr要素の後に配置されますが、 そのtable要素の子である 他のtfoot要素がない場合に限ります。
内容モデル:
0個以上のtrおよび スクリプトサポート要素を含みます。
text/html でのタグ省略:
親要素にこれ以上のコンテンツがない場合、tfoot要素の 終了タグを省略できます。
内容属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース:
HTMLTableSectionElement を使用します。これはtbody要素に対して定義されています。

tfoot要素は、 親がtable要素である場合、 そのテーブル要素の列の要約（フッタ）で構成される 行のブロックを表します。

tfoot要素は テーブルモデルに参加します。

4.9.8 tr 要素

Element/tr

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorerはい
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+

HTMLTableRowElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android？Safari iOS1+Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+
カテゴリ:
なし。
この要素が使用できる文脈:
thead 要素の子要素として。
tbody 要素の子要素として。
tfoot 要素の子要素として。
table 要素の子要素として、 caption、colgroup、および thead 要素の後に置きますが、 tbody 要素が table 要素の子要素でない場合に限ります。
内容モデル:
0個以上のtd、th、およびスクリプトサポート要素を含みます。
text/html でのタグ省略:
tr 要素の終了タグは、tr 要素がすぐ後に続く場合、または親要素内にそれ以上のコンテンツがない場合に省略できます。
内容属性:
グローバル属性
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
[Exposed=Window]
 interface HTMLTableRowElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   readonly attribute long rowIndex;
   readonly attribute long sectionRowIndex;
   [SameObject] readonly attribute HTMLCollection cells;
   HTMLTableCellElement insertCell(optional long index = -1);
   [CEReactions] undefined deleteCell(long index);
 
   // also has obsolete members
 };

tr 要素は 表します。 行 の セルを テーブル内に配置します。

tr 要素は テーブルモデルに参加します。

tr.rowIndex

HTMLTableRowElement/rowIndex

現在のすべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

行の位置を返します。この位置はテーブルの 行 リスト内の位置です。

要素がテーブル内にない場合、−1 を返します。

tr.sectionRowIndex

テーブルセクションの 行 リスト内の行の位置を返します。

要素がテーブルセクション内にない場合、−1 を返します。

tr.cells

HTMLCollection を返します。このコレクションは、行内の td および th 要素の集まりです。

cell = tr.insertCell([ index ])

HTMLTableRowElement/insertCell

現在のすべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

td 要素を作成し、 テーブル行の指定された位置に挿入し、その td を返します。

位置は行内のセルに対して相対的です。引数が省略された場合、デフォルトであるインデックス−1は、行の最後に挿入することと同等です。

指定された位置が−1より小さいか、セルの数より大きい場合、"IndexSizeError" DOMExceptionをスローします。

tr.deleteCell(index)

行内の指定された位置にある td または th 要素を削除します。

位置は行内のセルに対して相対的です。インデックス−1は、行の最後のセルを削除することと同等です。

指定された位置が−1より小さいか、最後のセルのインデックスより大きい場合、またはセルがない場合、"IndexSizeError" DOMExceptionをスローします。

rowIndex 属性は、この要素が親 table 要素を持っている場合、 または親 tbody、thead、または tfoot 要素と、その祖父母要素としての table 要素を持っている場合、 この tr 要素がその table 要素の 行 コレクション内でのインデックスを返す必要があります。 そのような table 要素がない場合、この属性は−1を返す必要があります。

sectionRowIndex 属性は、この要素が 親 table、tbody、thead、または tfoot 要素を持っている場合、 親要素の 行 コレクション内での tr 要素のインデックスを返す必要があります。 （テーブルの場合、それは HTMLTableElement の 行 コレクションです。テーブルセクションの場合、それは HTMLTableSectionElement の 行 コレクションです。）親要素が存在しない場合、この属性は−1を返す必要があります。

cells 属性は、この HTMLCollection を返す必要があります。 この tr 要素をルートとし、そのフィルターはこの tr 要素の子要素である td および th 要素に一致します。

insertCell(index) メソッドは、以下のように動作する必要があります。

  1. indexが-1未満であるか、cellsコレクション内の要素の数より大きい場合、「IndexSizeError」DOMExceptionをスローします。

  2. table cellを、このtr要素のノードドキュメント、「td」、およびHTML名前空間を指定して要素を作成した結果とします。

  3. indexが-1に等しいか、cellsコレクション内のアイテムの数に等しい場合、このtr要素にtable cellを追加します。

  4. それ以外の場合、このtr要素の子として、cellsコレクション内のindex番目のtd要素またはth要素の直前にtable cellを挿入します。

  5. table cellを返します。

deleteCell(index) メソッドは、呼び出されたときに以下のように動作する必要があります。

  1. index が −1 より小さいか、cells コレクション内の最後のセルのインデックスより大きい場合、または セルがない場合、"IndexSizeError" DOMException をスローする必要があります。

  2. index が −1 の場合、この cells コレクション内の最後の要素を 親要素から削除するか、cells コレクションが空の場合は何も行いません。

  3. それ以外の場合、この cells コレクション内の index 番目の要素を 親要素から削除します。

4.9.9 td 要素

Element/td

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorerはい
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+

HTMLTableCellElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android？Safari iOS1+Chrome Android？WebView Android？Samsung Internet？Opera Android12.1+
カテゴリ:
なし。
この要素が使用できるコンテキスト:
tr要素の子要素として。
コンテンツモデル:
フローコンテンツ。
text/htmlにおけるタグ省略:
td要素の終了タグは、 td要素が直後に別のtdまたは th要素に続く場合、または親要素にこれ以上コンテンツがない場合、省略することができます。
コンテンツ属性:
グローバル属性
colspan — セルがまたがる列数
rowspan — セルがまたがる行数
headers — このセルのヘッダーセル
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
interface HTMLTableCellElement : HTMLElement {
[HTMLConstructor] constructor();

[CEReactions] attribute unsigned long colSpan;
[CEReactions] attribute unsigned long rowSpan;
[CEReactions] attribute DOMString headers;
readonly attribute long cellIndex;

[CEReactions] attribute DOMString scope; // th要素にのみ準拠
[CEReactions] attribute DOMString abbr;  // th要素にのみ準拠

// 廃止されたメンバーも含まれます
};

このHTMLTableCellElementインターフェースは、 th要素にも使用されます。

td要素は、テーブル内のデータセルを 表現します。

td要素およびその colspan、 rowspan、 およびheaders属性は テーブルモデルに参加します。

ユーザーエージェントは、特に非視覚的な環境や、テーブルを2次元グリッドとして表示することが実際的でない環境において、セルの内容をレンダリングする際にセルのコンテキストをユーザーに提供する場合があります。 例えば、テーブルモデルにおけるセルの位置や、セルのヘッダーセルをリストアップするなどです（ ヘッダーセルの割り当てアルゴリズムによって決定されます）。 ヘッダーセルがリストアップされている場合、ユーザーエージェントは、ヘッダーセルそのものの内容の代わりに、それらのヘッダーセルに設定されている abbr属性の値を使用する場合があります。

この例では、編集可能なセルのグリッド（基本的にはシンプルなスプレッドシート）から成るウェブアプリケーションのスニペットを示しています。 セルの1つは、上記のセルの合計を表示するように構成されています。3つのセルはヘッダーとしてマークされており、 それらはth要素の代わりにtd要素を使用しています。 スクリプトがこれらの要素にイベントハンドラーをアタッチして、合計を維持します。 

<table>
  <tr>
   <th><input value="Name">
   <th><input value="Paid ($)">
  <tr>
   <td><input value="Jeff">
   <td><input value="14">
  <tr>
   <td><input value="Britta">
   <td><input value="9">
  <tr>
   <td><input value="Abed">
   <td><input value="25">
  <tr>
   <td><input value="Shirley">
   <td><input value="2">
  <tr>
   <td><input value="Annie">
   <td><input value="5">
  <tr>
   <td><input value="Troy">
   <td><input value="5">
  <tr>
   <td><input value="Pierce">
   <td><input value="1000">
  <tr>
   <th><input value="Total">
   <td><output value="1060">
</table>

4.9.10 th要素

Element/th

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用できるコンテキスト:
tr要素の子要素として。
コンテンツモデル:
フローコンテンツ、ただし、header、 footer、 セクショニングコンテンツ、 または見出しコンテンツの子孫を含まない。
text/htmlにおけるタグ省略:
th要素の終了タグは、 th要素が直後に別のtdまたはth要素に続く場合、 または親要素にこれ以上コンテンツがない場合、省略することができます。
コンテンツ属性:
グローバル属性
colspan — セルがまたがる列数
rowspan — セルがまたがる行数
headers — このセルのヘッダーセル
scope — このヘッダーセルが適用されるセルの範囲を指定
abbr — 別の文脈でセルを参照する際に使用する代替ラベル
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
HTMLTableCellElement を使用し、 td要素に対して定義された通りです。

th要素は、テーブル内のヘッダーセルを 表現します。

th要素には、scopeコンテンツ属性が指定されることがあります。

scope属性は、次のキーワードと状態を持つ列挙型属性です。

キーワード 状態 簡単な説明
row Row ヘッダーセルは、同じ行内のいくつかの後続のセルに適用されます。
col Column ヘッダーセルは、同じ列内のいくつかの後続のセルに適用されます。
rowgroup Row Group ヘッダーセルは、行グループ内の残りのすべてのセルに適用されます。
colgroup Column Group ヘッダーセルは、列グループ内の残りのすべてのセルに適用されます。

属性の欠損値デフォルトと無効値デフォルトは、 いずれもAuto状態です。（この状態では、ヘッダーセルは文脈に基づいて選択されたセルのセットに適用されます。）

th要素のscope属性は、 要素が行グループに固定されていない場合、 Row Group状態にすることはできません。 また、要素が列グループに固定されていない場合、 Column Group状態にすることはできません。

th要素には、 abbrコンテンツ属性が指定されることがあります。 その値は、別の文脈でヘッダーセルを参照する際に使用される代替ラベルでなければなりません （例：データセルに適用されるヘッダーセルを記述する場合）。通常は、フルヘッダーセルの省略形ですが、 拡張形や、単に異なる表現の場合もあります。

th要素とそのcolspan、rowspan、 headers、 およびscope属性は、 テーブルモデルに参加します。

次の例は、scope属性のrowgroup値が、ヘッダセルがどのデータセルに適用されるかにどのように影響するかを示しています。

以下は、テーブルを示すマークアップの断片です:

<table>
 <thead>
  <tr> <th> ID <th> Measurement <th> Average <th> Maximum
 <tbody>
  <tr> <td> <th scope=rowgroup> Cats <td> <td>
  <tr> <td> 93 <th> Legs <td> 3.5 <td> 4
  <tr> <td> 10 <th> Tails <td> 1 <td> 1
 <tbody>
  <tr> <td> <th scope=rowgroup> English speakers <td> <td>
  <tr> <td> 32 <th> Legs <td> 2.67 <td> 4
  <tr> <td> 35 <th> Tails <td> 0.33 <td> 1
</table>

これにより、次のようなテーブルが作成されます:

ID Measurement Average Maximum
Cats
93 Legs 3.5 4
10 Tails 1 1
English speakers
32 Legs 2.67 4
35 Tails 0.33 1

最初の行のヘッダはすべて、それぞれの列の行に直接適用されます。

scope属性がRow Group状態にあるヘッダは、最初の列以外のその行グループのすべてのセルに適用されます。

残りのヘッダは、それぞれの右側のセルにのみ適用されます。

4.9.11 tdおよび th 要素に共通する属性

td および th 要素には、colspan コンテンツ属性を指定でき、その値は0より大きく、1000以下の 有効な非負整数 でなければなりません。

td および th 要素には、rowspan コンテンツ属性も指定でき、その値は 有効な非負整数 で65534以下でなければなりません。この属性の値が0の場合、そのセルは行グループ内の残りのすべての行にまたがります。

これらの属性は、それぞれセルがまたがる列と行の数を指定します。これらの属性は、 表モデル の記述にあるように、セルを重ねるために使用してはなりません。

td および th 要素には、headers コンテンツ属性を指定できます。指定されている場合、 headers 属性には、空白で区切られた一意のトークンの順序なしセット からなる文字列を含めなければなりません。このトークンのどれも他のトークンと 同一であってはなりません。 また、各トークンの値は、 ID の値でなければならず、そのIDは、th 要素が、td 要素または th 要素とともに同じ 表 に属することを意味します（表モデル に定義されている通り）。

th 要素が ID属性を持つ場合、その id は、同じ 表 に属し、その属性値に ID idが含まれている td 要素および th 要素により 「直接ターゲット」にされているとされます。要素 Aは、要素 th またはtd 要素 Bにより「ターゲット」にされているとされる場合、 AがBに「直接ターゲット」されている場合、または要素 CがBによりターゲットされており、 AがCに「直接ターゲット」されている場合です。

th 要素は、それ自身を「ターゲット」としてはなりません。

colspan、 rowspan、 および headers 属性は、表モデル に参加します。

cell.cellIndex

セルの位置を、行のcells リスト内で返します。これは、必ずしも表内のセルのx位置に対応しているわけではありません。前のセルが複数の行または列にまたがっている可能性があるからです。

要素が行内にない場合は、−1を返します。

colSpan IDL属性は、colspan コンテンツ属性を反映する必要があります。それは範囲内に制限されています[1, 1000]、およびそのデフォルト値は1です。

rowSpan IDL属性は、rowspan コンテンツ属性を反映する必要があります。それは範囲内に制限されています[0, 65534]、およびそのデフォルト値は1です。

headers IDL属性は、同じ名前のコンテンツ属性を反映する必要があります。

cellIndex IDL属性は、要素に親tr要素がある場合、親要素のcellsコレクション内のセル要素のインデックスを返します。親要素がない場合は、属性は−1を返す必要があります。

scope IDL属性は、同じ名前のコンテンツ属性を反映する必要があります。既知の値のみに制限されます。

abbr IDL属性は、同じ名前のコンテンツ属性を反映する必要があります。

4.9.12 処理モデル

さまざまなテーブル要素とそのコンテンツ属性は、テーブルモデルを定義します。

テーブルは、(x, y) の座標を持つスロットの2次元グリッド上に配置されたセルで構成されます。グリッドは有限であり、空であるか、1つ以上のスロットを持っています。グリッドに1つ以上のスロットがある場合、x座標は常に0 ≤ x < xwidthの範囲内にあり、y座標は常に0 ≤ y < yheightの範囲内にあります。xwidthとyheightのいずれかまたは両方がゼロの場合、テーブルは空であり（スロットがありません）、テーブルはtable要素に対応します。

セルは、特定のwidthとheightを持ち、セルがx, y座標のすべてのスロットをカバーするように、スロット(cellx, celly)にアンカーされたスロットのセットです。cellx ≤ x < cellx+widthおよびcelly ≤ y < celly+heightの範囲で、セルはデータセルまたはヘッダーセルになることができます。データセルはtd要素に対応し、ヘッダーセルはth要素に対応します。両方のタイプのセルには、ゼロまたはそれ以上の関連ヘッダーセルがある場合があります。

エラーが発生する場合、2つのセルが同じスロットを占有することがあります。

行は、特定のy値に対してx=0からx=xwidth-1までのスロットの完全なセットです。行は通常、tr要素に対応しますが、行グループは、複数行にまたがるセルを含む場合に、一部の暗黙の行を末尾に持つことがあります。

列は、特定のx値に対してy=0からy=yheight-1までのスロットの完全なセットです。列はcol要素に対応することがありますが、col要素がない場合、列は暗黙的に存在します。

行グループは、スロット(0, groupy)にアンカーされた行のセットであり、特定のheightを持ち、x, y座標が0 ≤ x < xwidthおよびgroupy ≤ y < groupy+heightの範囲でカバーされる行グループです。行グループはtbody、thead、およびtfoot要素に対応します。すべての行が行グループに含まれているわけではありません。

列グループは、スロット(groupx, 0)にアンカーされた列のセットであり、特定のwidthを持ち、x, y座標がgroupx ≤ x < groupx+widthおよび0 ≤ y < yheightの範囲でカバーされる列グループです。列グループはcolgroup要素に対応します。すべての列が列グループに含まれているわけではありません。

行グループは互いに重ならないようにします。同様に、列グループも互いに重ならないようにします。

セルは、2つ以上の行グループにまたがるスロットをカバーすることはできません。ただし、セルが複数の列グループに含まれることは可能です。1つのセルを構成するすべてのスロットは、ゼロまたは1つの行グループおよびゼロまたは複数の列グループに属しています。

テーブルには、セル、列、行、行グループ、および列グループに加えて、見出しや説明を与えるcaption要素を持つことができます。

テーブルモデルエラーとは、table要素とその子孫によって表されるデータにエラーがあることを指します。文書にはテーブルモデルエラーがあってはなりません。

4.9.12.1 テーブルの形成

table要素に関連付けられたテーブルのスロットに対応する要素を決定し、テーブルの寸法 (xwidthおよびyheight) を決定し、テーブルモデルエラーが存在するかどうかを確認するために、ユーザーエージェントは次のアルゴリズムを使用する必要があります。

  1. xwidthをゼロに設定します。

  2. yheightをゼロに設定します。

  3. pending tfoot elements を、最初は空のリストとして設定します。

  4. the tableを、table要素によって表されるテーブルとします。xwidthとyheightの変数はthe tableの寸法を示します。the tableは最初は空です。

  5. もしtable要素に子要素がない場合、そのthe tableを返します (空のままです)。

  6. table要素の最初のcaption子要素をthe tableに関連付けます。該当する子要素がない場合、関連するcaption要素はありません。

  7. current elementをtable要素の最初の子要素に設定します。

    このアルゴリズムのステップでcurrent elementをtableの次の子要素に進めることが必要であり、そのような次の子要素が存在しない場合、ユーザーエージェントはこのアルゴリズムの終わり近くにある終了ラベルが付いたステップにジャンプしなければなりません。

  8. current elementが次の要素のいずれかでない限り、次の要素に進め、current elementをtableの次の子要素に進めます。

  9. もしcurrent elementがcolgroupの場合、以下のサブステップに従います。

    1. コラムグループ: current elementを以下の適切なケースに従って処理します。

      もしcurrent elementがcol子要素を持っている場合

      以下のステップに従います。

      1. xstartにxwidthの値を設定します。

      2. current columnをcolgroup要素の最初のcol子要素に設定します。

      3. コラム: もしcurrent columnがcol要素であり、span属性を持っている場合、その値を負でない整数の解析ルールを使用して解析します。

        もし値の解析結果がエラーやゼロでない場合、その値をspanに設定します。

        それ以外の場合、col要素がspan属性を持っていない場合、または属性の値の解析がエラーやゼロになった場合は、spanを1に設定します。

        もしspanが1000を超える場合、それを1000に設定します。

      4. xwidthをspan分増加させます。

      5. the table内の最後のspan個のコラムをcurrent columnに対応するcol要素に設定します。

      6. もしcurrent columnがcol要素の最後の子要素でない場合、current columnをcolgroup要素の次のcol子要素に設定し、コラムラベルが付いたステップに戻ります。

      7. xstartからxwidth-1までのthe table内のすべての最後のコラムが、新しいコラムグループを形成し、スロット(xstart, 0)にアンカーされ、幅xwidth-xstartでcolgroup要素に対応します。

      もしcurrent elementがcol要素を持っていない場合

      1. もしcolgroup要素がspan属性を持っている場合、その値を負でない整数の解析ルールを使用して解析します。

        もし値の解析結果がエラーやゼロでない場合、その値をspanに設定します。

        それ以外の場合、colgroup要素がspan属性を持っていない場合、または属性の値の解析がエラーやゼロになった場合は、spanを1に設定します。

        もしspanが1000を超える場合、それを1000に設定します。

      2. xwidthをspan分増加させます。

      3. the table内の最後のspan個のコラムが、新しいコラムグループを形成し、スロット(xwidth-span, 0)にアンカーされ、幅spanでcolgroup要素に対応します。

    2. 次の要素に進め、current elementをtableの次の子要素に進めます。

    3. current elementが次の要素のいずれかでない限り、次の要素に進め、current elementをtableの次の子要素に進めます。

    4. もしcurrent elementがcolgroup要素である場合、上記のコラムグループラベルが付いたステップにジャンプします。

  10. ycurrentをゼロに設定します。

  11. list of downward-growing cellsを空のリストに設定します。

  12. 行: current elementが次の要素のいずれかでない限り、次の要素に進め、current elementをtableの次の子要素に進めます。

  13. もしcurrent elementがtrである場合、行を処理するアルゴリズムを実行し、current elementをtableの次の子要素に進め、行ラベルが付いたステップに戻ります。

  14. 行グループを終了するアルゴリズムを実行します。

  15. もしcurrent elementがtfootである場合、その要素をpending tfoot elementsのリストに追加し、current elementをtableの次の子要素に進め、行ラベルが付いたステップに戻ります。

  16. current elementはtheadまたはtbodyのいずれかです。

    行グループを処理するアルゴリズムを実行します。

  17. 次の要素に進め、current elementをtableの次の子要素に進めます。

  18. 行ラベルが付いたステップに戻ります。

  19. 終了: tfoot 要素のリスト内の各 pending tfoot elements について、ツリー順で、行グループを処理するアルゴリズムを実行します。

  20. もしthe table内に、スロットのみを含む行または列が存在し、それにアンカーされたセルがない場合、これはテーブルモデルエラーです。

  21. the tableを返します。

行グループを処理するアルゴリズムは、thead、tbody、およびtfoot要素を処理するために上記の手順セットによって呼び出されるものです:

  1. ystartにyheightの値を設定する。

  2. 処理されている要素の子である各tr要素について、ツリー順で行を処理するためのアルゴリズムを実行する。

  3. もしyheightがystartより大きい場合、y=ystartからy=yheight-1までのthe table内の最後の行は、新しい行グループを形成し、(0, ystart)の座標でアンカーされ、高さはyheight-ystartで、処理されている要素に対応する。

  4. 行グループを終了するためのアルゴリズムを実行する。

行グループを終了するアルゴリズムは、上記の手順セットによって行ブロックの開始時および終了時に呼び出されます:

  1. ycurrentがyheightより小さい間、次のステップを実行します:

    1. 下方向に成長するセルを成長させるアルゴリズムを実行します。

    2. ycurrentを1増やします。

  2. list of downward-growing cellsを空にします。

行を処理するアルゴリズムは、tr要素を処理するために上記の手順セットによって呼び出されます:

  1. yheightがycurrentと等しい場合、yheightを1増やします。（ycurrentがyheightより大きくなることはありません。）

  2. xcurrentを0に設定します。

  3. 下方向に成長するセルを成長させるアルゴリズムを実行します。

  4. 処理対象のtr要素にtdまたはth要素の子がない場合、ycurrentを1増やし、この手順セットを中止して、上記のアルゴリズムに戻ります。

  5. 処理対象のtr要素の最初のtdまたはth要素をcurrent cellに設定します。

  6. Cells: xcurrentがxwidth未満であり、xcurrent、ycurrentの座標を持つスロットに既にセルが割り当てられている場合、xcurrentを1増やします。

  7. xcurrentがxwidthと等しい場合、xwidthを1増やします。（xcurrentがxwidthより大きくなることはありません。）

  8. もしcurrent cellがcolspan属性を持っている場合、その属性の値を解析し、その結果をcolspanとします。

    その値の解析が失敗した場合、またはゼロを返した場合、あるいは属性がない場合、代わりにcolspanを1に設定します。

    もしcolspanが1000を超える場合、それを1000に設定します。

  9. もしcurrent cellがrowspan属性を持っている場合、その属性の値を解析し、その結果をrowspanとします。

    その値の解析が失敗した場合、あるいは属性がない場合、代わりにrowspanを1に設定します。

    もしrowspanが65534を超える場合、それを65534に設定します。

  10. もしrowspanがゼロであり、table要素のノードドキュメントがクイークスモードに設定されていない場合、cell grows downwardをtrueに設定し、rowspanを1に設定します。そうでない場合、cell grows downwardをfalseに設定します。

  11. もしxwidthがxcurrent+colspanより小さい場合、xwidthをxcurrent+colspanに設定します。

  12. もしyheightがycurrent+rowspanより小さい場合、yheightをycurrent+rowspanに設定します。

  13. 座標(x, y)を持つスロットに、xcurrent ≤ x < xcurrent+colspanかつycurrent ≤ y < ycurrent+rowspanである場合、新しいセル cにカバーされるものとし、(xcurrent, ycurrent)に固定され、幅がcolspan、高さがrowspanであり、処理中のcurrent cell要素に対応します。

    もしcurrent cell要素がth要素である場合、この新しいセルcをヘッダセルとし、それ以外の場合はデータセルとします。

    現在のセル要素にどのヘッダセルが適用されるかを確立するには、次のセクションで説明されているヘッダセルを割り当てるアルゴリズムを使用します。

    もし関連するスロットのいずれかに既にセルがカバーされている場合、これはテーブルモデルエラーです。これらのスロットには現在、2つのセルが重なっています。

  14. もしcell grows downwardがtrueの場合、タプル{c, xcurrent, colspan}をlist of downward-growing cellsに追加します。

  15. xcurrentをcolspanだけ増やします。

  16. もしcurrent cellがtdまたはth要素の子であり、処理中のtr要素の最後のものである場合、ycurrentを1増やし、この手順セットを中止して、上記のアルゴリズムに戻ります。

  17. current cellを次のtdまたはth要素の子に設定します。

  18. Cellsとラベル付けされた手順に戻ります。

上記のアルゴリズムがユーザーエージェントに下方向に成長するセルを成長させるアルゴリズムを実行するように求める場合、ユーザーエージェントは、list of downward-growing cells内の各タプル{cell, cellx, width}に対して、セルcellをセルに拡張し、座標(x, ycurrent)をカバーするようにします。この場合、cellx ≤ x < cellx+widthとなります。

4.9.12.2 データセルとヘッダーセルの関係を形成する

各セルにはゼロ個以上のヘッダーセルを割り当てることができます。セルcurrent cell>にヘッダーセルを割り当てるためのアルゴリズムは次のとおりです。

  1. header listを空のセルリストとして設定します。

  2. (principalx, principaly) をcurrent cell>がアンカーされているスロットの座標として設定します。

  3. もしcurrent cell>がheaders属性を指定している場合

    1. current cell>のheaders属性の値を取得し、ASCII空白で分割して、idリストを得られたトークンのリストとして設定します。

    2. idリストの各トークンについて、そのトークンと同じIDを持つ最初のDocument内の要素が同じテーブル内のセルであり、そのセルがcurrent cell>でない場合、そのセルをheader listに追加します。

    もしcurrent cell>がheaders属性を指定していない場合

    1. principalwidthをcurrent cell>の幅として設定します。

    2. principalheightをcurrent cell>の高さとして設定します。

    3. principalyからprincipaly+principalheight-1までの各yの値について、ヘッダーセルをスキャンして割り当てるための内部アルゴリズムを、current cell>、header list、初期座標(principalx, y)、および増分Δx=−1とΔy=0で実行します。

    4. principalxからprincipalx+principalwidth-1までの各xの値について、ヘッダーセルをスキャンして割り当てるための内部アルゴリズムを、current cell>、header list、初期座標(x, principaly)、および増分Δx=0とΔy=−1で実行します。

    5. もしcurrent cell>が行グループにアンカーされている場合、同じ行グループにアンカーされ、かつprincipalx+principalwidth-1以下のx座標およびprincipaly+principalheight-1以下のy座標を持つすべての行グループヘッダーをheader listに追加します。

    6. もしcurrent cell>が列グループにアンカーされている場合、同じ列グループにアンカーされ、かつprincipalx+principalwidth-1以下のx座標およびprincipaly+principalheight-1以下のy座標を持つすべての列グループヘッダーをheader listに追加します。

  4. header listからすべての空セルを削除します。

  5. header listから重複を削除します。

  6. もしcurrent cell>がheader listに存在する場合、それを削除します。

  7. header listのヘッダーをcurrent cell>に割り当てます。

current cell>、header list、初期座標(initialx, initialy)、およびΔxとΔyの増分が与えられた場合のヘッダーセルをスキャンして割り当てるための内部アルゴリズムは次のとおりです。

  1. xをinitialxと等しく設定します。

  2. yをinitialyと等しく設定します。

  3. opaque headersを空のセルリストとして設定します。

  4. もしcurrent cell>がヘッダーセルである場合

    in header blockをtrueに設定し、headers from current header blockをcurrent cell>のみを含むセルリストとして設定します。

    それ以外の場合

    in header blockをfalseに設定し、headers from current header blockを空のセルリストとして設定します。

  5. ループ: Δxを用いてxを増加させ、Δyを用いてyを増加させます。

    このアルゴリズムの各呼び出しにおいて、ΔxとΔyのいずれかは-1であり、もう一方は0になります。

  6. もしxまたはyが0未満の場合、この内部アルゴリズムを中止します。

  7. もしスロット(x, y)をカバーするセルが存在しない場合、またはスロット(x, y)をカバーするセルが複数存在する場合、ループラベルが付いたサブステップに戻ります。

  8. current cellをスロット(x, y)をカバーするセルとして設定します。

  9. もしcurrent cellがヘッダーセルである場合

    1. in header blockをtrueに設定します。

    2. current cellをheaders from current header blockに追加します。

    3. blockedをfalseに設定します。

    4. もしΔxが0である場合

      もしopaque headersリスト内にcurrent cellと同じx座標でアンカーされ、かつcurrent cellと同じ幅を持つセルが存在する場合、blockedをtrueに設定します。

      もしcurrent cellがコラムヘッダーでない場合、blockedをtrueに設定します。

      もしΔyが0である場合

      もしopaque headersリスト内にcurrent cellと同じy座標でアンカーされ、かつcurrent cellと同じ高さを持つセルが存在する場合、blockedをtrueに設定します。

      もしcurrent cellが行ヘッダーでない場合、blockedをtrueに設定します。

    5. もしblockedがfalseである場合、current cellをheader listに追加します。

    もしcurrent cellがデータセルであり、かつin header blockがtrueである場合

    in header blockをfalseに設定します。headers from current header block内のすべてのセルをopaque headersリストに追加し、headers from current header blockリストを空にします。

  10. ループラベルが付いたステップに戻ります。

座標(x, y)にアンカーされ、幅width、高さheightを持つヘッダーセルは、次のいずれかが真である場合、コラムヘッダーであると見なされます。

座標(x, y)にアンカーされ、幅width、高さheightを持つヘッダーセルは、次のいずれかが真である場合、行ヘッダーであると見なされます。

ヘッダーセルは、そのscope属性がColumn Group状態にある場合、コラムグループヘッダーであると見なされます。

ヘッダーセルは、そのscope属性がRow Group状態にある場合、行グループヘッダーであると見なされます。

セルは、それが要素を含まず、またはその子テキストコンテンツ（もしあれば）がASCII空白のみで構成されている場合、空セルであると見なされます。

4.9.13 例

このセクションは規範的ではありません。

以下は、Smithsonian physical tables, Volume 71の表45の下部をどのようにマークアップするかを示したものです：

<table>
  <caption>仕様値: <b>鋼</b>, <b>鋳物</b>, Ann. A.S.T.M. A27-16, クラスB;* P最大0.06; S最大0.05.</caption>
  <thead>
   <tr>
    <th rowspan=2>グレード.</th>
    <th rowspan=2>降伏点.</th>
    <th colspan=2>引張強度</th>
    <th rowspan=2>伸び率 50.8&nbsp;mm または 2&nbsp;インチ.</th>
    <th rowspan=2>断面収縮率.</th>
   </tr>
   <tr>
    <th>kg/mm<sup>2</sup></th>
    <th>lb/in<sup>2</sup></th>
   </tr>
  </thead>
  <tbody>
   <tr>
    <td>硬</td>
    <td>0.45 極限</td>
    <td>56.2</td>
    <td>80,000</td>
    <td>15</td>
    <td>20</td>
   </tr>
   <tr>
    <td>中</td>
    <td>0.45 極限</td>
    <td>49.2</td>
    <td>70,000</td>
    <td>18</td>
    <td>25</td>
   </tr>
   <tr>
    <td>軟</td>
    <td>0.45 極限</td>
    <td>42.2</td>
    <td>60,000</td>
    <td>22</td>
    <td>30</td>
   </tr>
  </tbody>
 </table>

この表は次のように表示される可能性があります：

仕様値: 鋼, 鋳物, Ann. A.S.T.M. A27-16, クラスB;* P最大0.06; S最大0.05.
グレード. 降伏点. 引張強度 伸び率 50.8 mm または 2 in. 断面収縮率.
kg/mm2 lb/in2
硬 0.45 極限 56.2 80,000 15 20
中 0.45 極限 49.2 70,000 18 25
軟 0.45 極限 42.2 60,000 22 30

以下は、Apple, Incの2008会計年度の10-K報告書の46ページにある粗利益表をどのようにマークアップするかを示したものです：

<table>
  <thead>
   <tr>
    <th>
    <th>2008
    <th>2007
    <th>2006
  </tr>
  </thead>
  <tbody>
   <tr>
    <th>売上高
    <td>$ 32,479
    <td>$ 24,006
    <td>$ 19,315
   </tr>
   <tr>
    <th>売上原価
    <td>  21,334
    <td>  15,852
    <td>  13,717
   </tr>
   <tr>
    <th>粗利益
    <td>$ 11,145
    <td>$  8,154
    <td>$  5,598
   </tr>
  </tbody>
  </tfoot>
   <tr>
    <th>粗利益率
    <td>34.3%
    <td>34.0%
    <td>29.0%
 </table>

この表は次のように表示される可能性があります：

2008 2007 2006
売上高 $ 32,479 $ 24,006 $ 19,315
売上原価 21,334 15,852 13,717
粗利益 $ 11,145 $ 8,154 $ 5,598
粗利益率 34.3% 34.0% 29.0%

以下は、同じ文書の下部にある営業費用表をどのようにマークアップするかを示したものです：

<table>
 <colgroup> <col>
 <colgroup> <col> <col> <col>
 <thead>
  <tr> <th> <th>2008 <th>2007 <th>2006
 <tbody>
  <tr> <th scope=rowgroup> Research and development
       <td> $ 1,109 <td> $ 782 <td> $ 712
  <tr> <th scope=row> Percentage of net sales
       <td> 3.4% <td> 3.3% <td> 3.7%
 <tbody>
  <tr> <th scope=rowgroup> Selling, general, and administrative
       <td> $ 3,761 <td> $ 2,963 <td> $ 2,433
  <tr> <th scope=row> Percentage of net sales
       <td> 11.6% <td> 12.3% <td> 12.6%
</table>

この表は次のように表示される可能性があります：

2008 2007 2006
研究開発 $ 1,109 $ 782 $ 712
売上高に対する割合 3.4% 3.3% 3.7%
販売費および一般管理費 $ 3,761 $ 2,963 $ 2,433
売上高に対する割合 11.6% 12.3% 12.6%

4.10 フォーム

Element#Forms

すべての現行エンジンでサポートされています。

Firefox4+Safari4+Chrome61+
Opera52+Edge79+
Edge (Legacy)16+Internet Explorer10+
Firefox Android5+Safari iOS3.2+Chrome Android61+WebView Android61+Samsung Internet8.0+Opera Android47+

4.10.1 導入

このセクションは規範的ではありません。

フォームは、テキスト、ボタン、チェックボックス、範囲、またはカラーピッカーコントロールなどのフォームコントロールを持つWebページのコンポーネントです。ユーザーはこのようなフォームと対話し、データを提供し、それをサーバーに送信してさらなる処理を行うことができます（例：検索結果や計算結果の返送）。多くの場合、クライアントサイドスクリプトは必要ありませんが、スクリプトがユーザーエクスペリエンスを拡張したり、データをサーバーに送信する以外の目的でフォームを使用するためのAPIが利用可能です。

フォームの作成は、ユーザーインターフェースの記述、サーバー側処理の実装、ユーザーインターフェースをサーバーと通信させる設定など、任意の順序で実行できるいくつかのステップで構成されます。

4.10.1.1 フォームのユーザーインターフェースの記述

このセクションは規範的ではありません。

この簡単な紹介の目的のために、ピザ注文フォームを作成します。

どのフォームも、form 要素から始まり、その中にコントロールが配置されます。ほとんどの コントロールは、input 要素で表され、デフォルトではテキスト コントロールを提供します。コントロールにラベルを付けるには、label 要素が使用され、ラベルのテキストと コントロール自体は、label 要素内に配置されます。フォームの各部分は 段落と見なされ、通常は他の部分と区別するためにp 要素を使用して区切られます。 これをまとめると、顧客の名前を尋ねる方法は次のようになります： 

<form>
  <p><label>Customer name: <input></label></p>
 </form>

ユーザーがピザのサイズを選択できるように、ラジオボタンのセットを使用できます。ラジオボタンもinput 要素を使用し、今回はtype 属性を持つ 値 radioを使用します。 ラジオボタンをグループとして機能させるために、name属性を使用して共通の名前を付けます。 一連の コントロールをグループ化するには、たとえばこの場合、ラジオボタンなどのfieldset 要素を使用します。そのようなコントロールのグループのタイトルは、fieldset の最初の要素であるlegend 要素によって指定されます。 

<form>
  <p><label>Customer name: <input></label></p>
  <fieldset>
   <legend> ピザサイズ </legend>
   <p><label> <input type=radio name=size> Small </label></p>
   <p><label> <input type=radio name=size> Medium </label></p>
   <p><label> <input type=radio name=size> Large </label></p>
  </fieldset>
 </form>

前のステップからの変更点が強調表示されています。

トッピングを選択するには、チェックボックスを使用できます。これらはinput 要素 とtype 属性がチェックボックスに設定されている値 checkboxを使用します。 

<form>
  <p><label>Customer name: <input></label></p>
  <fieldset>
   <legend> ピザサイズ </legend>
   <p><label> <input type=radio name=size> Small </label></p>
   <p><label> <input type=radio name=size> Medium </label></p>
   <p><label> <input type=radio name=size> Large </label></p>
  </fieldset>
  <fieldset>
   <legend> ピザトッピング </legend>
   <p><label> <input type=checkbox> Bacon </label></p>
   <p><label> <input type=checkbox> Extra Cheese </label></p>
   <p><label> <input type=checkbox> Onion </label></p>
   <p><label> <input type=checkbox> Mushroom </label></p>
  </fieldset>
 </form>

このフォームが作成されているピッツェリアは常にミスを犯すため、顧客と連絡を取る方法が必要です。この目的のために、電話番号（input 要素とそのtype 属性をtelに設定） および電子メールアドレス （input 要素とそのtype 属性が emailに設定されています）を使用できます： 

<form>
 <p><label>Customer name: <input></label></p>
 <p><label>Telephone: <input type=tel></label></p>
 <p><label>Email address: <input type=email></label></p>
 <fieldset>
  <legend> Pizza Size </legend>
  <p><label> <input type=radio name=size> Small </label></p>
  <p><label> <input type=radio name=size> Medium </label></p>
  <p><label> <input type=radio name=size> Large </label></p>
 </fieldset>
 <fieldset>
  <legend> Pizza Toppings </legend>
  <p><label> <input type=checkbox> Bacon </label></p>
  <p><label> <input type=checkbox> Extra Cheese </label></p>
  <p><label> <input type=checkbox> Onion </label></p>
  <p><label> <input type=checkbox> Mushroom </label></p>
 </fieldset>
</form>

配達時間を尋ねるために、input 要素 とそのtype 属性をtime に設定して使用できます。多くの これらのフォームコントロールには、指定できる値を正確に制御する属性があります。この場合、特に関心のある属性は、min、max、および stepです。 これらは、最小時間、最大時間、および許可される値間の間隔（秒）を設定します。この ピッツェリアは午前11時から午後9時までしか配達せず、15分以上の間隔を保証していませんが、次のようにマークアップできます： 

<form>
 <p><label>Customer name: <input></label></p>
 <p><label>Telephone: <input type=tel></label></p>
 <p><label>Email address: <input type=email></label></p>
 <fieldset>
  <legend> Pizza Size </legend>
  <p><label> <input type=radio name=size> Small </label></p>
  <p><label> <input type=radio name=size> Medium </label></p>
  <p><label> <input type=radio name=size> Large </label></p>
 </fieldset>
 <fieldset>
  <legend> Pizza Toppings </legend>
  <p><label> <input type=checkbox> Bacon </label></p>
  <p><label> <input type=checkbox> Extra Cheese </label></p>
  <p><label> <input type=checkbox> Onion </label></p>
  <p><label> <input type=checkbox> Mushroom </label></p>
 </fieldset>
 <p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900"></label></p>
</form>

textarea 要素は、複数行のテキストコントロールを提供するために使用できます。この 場合、顧客に配達指示を提供するスペースを提供します：

<form>
 <p><label>Customer name: <input></label></p>
 <p><label>Telephone: <input type=tel></label></p>
 <p><label>Email address: <input type=email></label></p>
 <fieldset>
  <legend> Pizza Size </legend>
  <p><label> <input type=radio name=size> Small </label></p>
  <p><label> <input type=radio name=size> Medium </label></p>
  <p><label> <input type=radio name=size> Large </label></p>
 </fieldset>
 <fieldset>
  <legend> Pizza Toppings </legend>
  <p><label> <input type=checkbox> Bacon </label></p>
  <p><label> <input type=checkbox> Extra Cheese </label></p>
  <p><label> <input type=checkbox> Onion </label></p>
  <p><label> <input type=checkbox> Mushroom </label></p>
 </fieldset>
 <p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900"></label></p>
 <p><label>Delivery instructions: <textarea></textarea></label></p>
</form>

最後に、フォームを送信可能にするために、button 要素を使用します：

<form>
 <p><label>Customer name: <input></label></p>
 <p><label>Telephone: <input type=tel></label></p>
 <p><label>Email address: <input type=email></label></p>
 <fieldset>
  <legend> Pizza Size </legend>
  <p><label> <input type=radio name=size> Small </label></p>
  <p><label> <input type=radio name=size> Medium </label></p>
  <p><label> <input type=radio name=size> Large </label></p>
 </fieldset>
 <fieldset>
  <legend> Pizza Toppings </legend>
  <p><label> <input type=checkbox> Bacon </label></p>
  <p><label> <input type=checkbox> Extra Cheese </label></p>
  <p><label> <input type=checkbox> Onion </label></p>
  <p><label> <input type=checkbox> Mushroom </label></p>
 </fieldset>
 <p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900"></label></p>
 <p><label>Delivery instructions: <textarea></textarea></label></p>
 <p><button>Submit order</button></p>
</form>
4.10.1.2 フォームのサーバーサイド処理の実装

このセクションは規範的ではありません。

サーバーサイドプロセッサを作成するための正確な詳細は、この仕様の範囲外です。 この紹介の目的のために、https://pizza.example.com/order.cgi にあるスクリプトが、 application/x-www-form-urlencoded 形式を使用して送信を受け入れるように構成されており、 以下のパラメータがHTTP POST本文に送信されることを前提とします：

custname
顧客の名前
custtel
顧客の電話番号
custemail
顧客のメールアドレス
size
ピザのサイズ、small、medium、large のいずれか
topping
トッピング、選択された各トッピングごとに指定され、許可される値は bacon、 cheese、onion、およびmushroom
delivery
指定された配達時間
comments
配達指示
4.10.1.3 フォームをサーバーと通信するように設定する

このセクションは規範的ではありません。

フォームの送信は、サーバーに対してさまざまな方法で公開されますが、最も一般的なのはHTTP GETまたはPOSTリクエストです。使用する正確な方法を指定するには、method 属性をform 要素に指定します。ただし、これではフォームデータがどのようにエンコードされるかは指定されません。エンコードを指定するには、enctype 属性を使用します。また、送信されたデータを処理するサービスのURLを指定する必要があり、これはaction 属性を使用して指定します。

送信する各フォームコントロールには、送信データを参照するために使用される名前を指定する必要があります。ラジオボタンのグループには既に名前を指定しました。同じ属性(name) も送信名を指定します。 ラジオボタンは、value 属性を使用して、それぞれ異なる値を指定することで、送信時に区別されます。

複数のコントロールに同じ名前を指定することができます。たとえば、ここではすべてのチェックボックスに同じ名前を指定し、サーバーはその名前で送信された値を確認して、どのチェックボックスが選択されたかを区別します。ラジオボタンと同様に、value 属性で一意の値を指定します。

前のセクションで設定した内容を考慮すると、すべては次のようになります：

<form method="post"
      enctype="application/x-www-form-urlencoded"
      action="https://pizza.example.com/order.cgi">
 <p><label>Customer name: <input name="custname"></label></p>
 <p><label>Telephone: <input type=tel name="custtel"></label></p>
 <p><label>Email address: <input type=email name="custemail"></label></p>
 <fieldset>
  <legend> Pizza Size </legend>
  <p><label> <input type=radio name=size value="small"> Small </label></p>
  <p><label> <input type=radio name=size value="medium"> Medium </label></p>
  <p><label> <input type=radio name=size value="large"> Large </label></p>
 </fieldset>
 <fieldset>
  <legend> Pizza Toppings </legend>
  <p><label> <input type=checkbox name="topping" value="bacon"> Bacon </label></p>
  <p><label> <input type=checkbox name="topping" value="cheese"> Extra Cheese </label></p>
  <p><label> <input type=checkbox name="topping" value="onion"> Onion </label></p>
  <p><label> <input type=checkbox name="topping" value="mushroom"> Mushroom </label></p>
 </fieldset>
 <p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900" name="delivery"></label></p>
 <p><label>Delivery instructions: <textarea name="comments"></textarea></label></p>
 <p><button>Submit order</button></p>
</form>

一部の属性が値を引用符で囲んでいる理由とそうでない理由に特別な意味はありません。HTMLの構文では、属性を指定するためのさまざまな有効な方法が許可されています。この点については、構文セクションで説明されています。

たとえば、顧客が「Denise Lawrence」と名前を入力し、「555-321-8642」と電話番号を入力し、メールアドレスを指定せず、ミディアムサイズのピザを注文し、トッピングにExtra CheeseとMushroomを選び、配達時間を午後7時に指定し、配達指示テキストコントロールを空白のままにした場合、ユーザーエージェントは次の内容をオンラインウェブサービスに送信します：

custname=Denise+Lawrence&custtel=555-321-8642&custemail=&size=medium&topping=cheese&topping=mushroom&delivery=19%3A00&comments=
4.10.1.4 クライアント側のフォーム検証

Form_validation

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android≤37+Samsung Internet?Opera Android≤12.1+

このセクションは規範的ではありません。

フォームは、ユーザーエージェントがフォームを送信する前にユーザーの入力を確認するように注釈を付けることができます。サーバーは依然として入力が有効であることを確認する必要があります（悪意のあるユーザーは簡単にフォーム検証をバイパスできるため）が、サーバーが唯一の検査者であることによる待機時間を避けることができます。

最も簡単な注釈はrequired 属性であり、input 要素に指定すると、値が入力されるまでフォームを送信しないことを示します。この属性を顧客名、ピザサイズ、および配達時間のフィールドに追加することで、これらのフィールドが入力されていない場合にユーザーエージェントがユーザーに通知できるようにします。 

<form method="post"
       enctype="application/x-www-form-urlencoded"
       action="https://pizza.example.com/order.cgi">
  <p><label>Customer name: <input name="custname" required></label></p>
  <p><label>Telephone: <input type=tel name="custtel"></label></p>
  <p><label>Email address: <input type=email name="custemail"></label></p>
  <fieldset>
   <legend> ピザサイズ </legend>
   <p><label> <input type=radio name=size required value="small"> Small </label></p>
   <p><label> <input type=radio name=size required value="medium"> Medium </label></p>
   <p><label> <input type=radio name=size required value="large"> Large </label></p>
  </fieldset>
  <fieldset>
   <legend> ピザトッピング </legend>
   <p><label> <input type=checkbox name="topping" value="bacon"> Bacon </label></p>
   <p><label> <input type=checkbox name="topping" value="cheese"> Extra Cheese </label></p>
   <p><label> <input type=checkbox name="topping" value="onion"> Onion </label></p>
   <p><label> <input type=checkbox name="topping" value="mushroom"> Mushroom </label></p>
  </fieldset>
  <p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900" name="delivery" required></label></p>
  <p><label>Delivery instructions: <textarea name="comments" maxlength=1000></textarea></label></p>
  <p><button>Submit order</button></p>
 </form>

フォームが送信されると、invalid イベントが無効な各フォームコントロールで発生します。これは、フォームの問題点の概要を表示するのに役立ちます。通常、ブラウザ自体は一度に1つの問題しか報告しないためです。

4.10.1.5 フォームコントロールのクライアントサイド自動入力の有効化

このセクションは規範的ではありません。

一部のブラウザは、ユーザーが情報を再入力する手間を省くために、フォームコントロールを自動的に入力しようとします。例えば、ユーザーの電話番号を要求するフィールドにユーザーの電話番号が自動的に入力されることがあります。

ユーザーエージェントを支援するために、autocomplete属性を使用してフィールドの目的を説明できます。このフォームの場合、ピザの配達先に関する情報をこのように注釈を付けることが有用です。この情報を追加すると、次のようになります。 

<form method="post"
   enctype="application/x-www-form-urlencoded"
   action="https://pizza.example.com/order.cgi">
<p><label>顧客名: <input name="custname" required autocomplete="shipping name"></label></p>
<p><label>電話番号: <input type=tel name="custtel" autocomplete="shipping tel"></label></p>
<p><label>メールアドレス: <input type=email name="custemail" autocomplete="shipping email"></label></p>
<fieldset>
<legend> ピザのサイズ </legend>
<p><label> <input type=radio name=size required value="small"> 小 </label></p>
<p><label> <input type=radio name=size required value="medium"> 中 </label></p> 
<p><label> <input type=radio name=size required value="large"> 大 </label></p> 
</fieldset>
<fieldset>
<legend> ピザのトッピング </legend>
<p><label> <input type=checkbox name="topping" value="bacon"> ベーコン </label></p> 
<p><label> <input type=checkbox name="topping" value="cheese"> 追加チーズ </label></p> 
<p><label> <input type=checkbox name="topping" value="onion"> 玉ねぎ </label></p> 
<p><label> <input type=checkbox name="topping" value="mushroom"> マッシュルーム </label></p> 
</fieldset>
<p><label>配達希望時間: <input type=time min="11:00" max="21:00" step="900" name="delivery" required></label></p> 
<p><label>配達指示: <textarea name="comments" maxlength=1000></textarea></label></p> 
<p><button>注文を送信</button></p> 
</form>
4.10.1.6 モバイルデバイスでのユーザーエクスペリエンスの向上

このセクションは規範的ではありません。

一部のデバイス、特に仮想キーボードを使用するデバイスでは、ユーザーに複数の入力モードを提供することができます。例えば、クレジットカード番号を入力する際には0から9の数字キーのみを表示させたり、名前を入力する際には各単語が自動的に大文字で始まるようにすることができます。

inputmode 属性を使用することで、適切な入力モードを選択できます:

<form method="post"
       enctype="application/x-www-form-urlencoded"
       action="https://pizza.example.com/order.cgi">
  <p><label>Customer name: <input name="custname" required autocomplete="shipping name"></label></p>
  <p><label>Telephone: <input type=tel name="custtel" autocomplete="shipping tel"></label></p>
  <p><label>Buzzer code: <input name="custbuzz" inputmode="numeric"></label></p>
  <p><label>Email address: <input type=email name="custemail" autocomplete="shipping email"></label></p>
  <fieldset>
   <legend> Pizza Size </legend>
   <p><label> <input type=radio name=size required value="small"> Small </label></p>
   <p><label> <input type=radio name=size required value="medium"> Medium </label></p>
   <p><label> <input type=radio name=size required value="large"> Large </label></p>
  </fieldset>
  <fieldset>
   <legend> Pizza Toppings </legend>
   <p><label> <input type=checkbox name="topping" value="bacon"> Bacon </label></p>
   <p><label> <input type=checkbox name="topping" value="cheese"> Extra Cheese </label></p>
   <p><label> <input type=checkbox name="topping" value="onion"> Onion </label></p>
   <p><label> <input type=checkbox name="topping" value="mushroom"> Mushroom </label></p>
  </fieldset>
  <p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900" name="delivery" required></label></p>
  <p><label>Delivery instructions: <textarea name="comments" maxlength=1000></textarea></label></p>
  <p><button>Submit order</button></p>
 </form>
4.10.1.7 フィールドタイプ、オートフィルフィールド名、および入力モダリティの違い

このセクションは規範的ではありません。

type、autocomplete、およびinputmode属性は、混同しやすい場合があります。たとえば、これらの属性のすべてにおいて「email」という文字列は有効な値です。このセクションでは、これら3つの属性の違いを示し、それらを使用する際のアドバイスを提供します。

type属性は、input要素で使用されるコントロールの種類を決定します。この属性の値を選択することは、input要素、textarea要素、select要素などを使用するかどうかを選択することと同じです。

対照的に、autocomplete属性は、ユーザーが入力する値が実際に何を表しているかを説明します。この属性の値を選択することは、要素のラベルを選択することと同じです。

まず、電話番号について考えてみましょう。ページがユーザーに電話番号を尋ねる場合、適切なフォームコントロールは<input type=tel>です。しかし、どのautocompleteの値を使用するかは、そのページがどの電話番号を尋ねているのか、国際フォーマットの電話番号を期待しているのか、ローカルフォーマットの電話番号を期待しているのか、などによって異なります。

たとえば、eコマースサイトのチェックアウトプロセスの一環として、顧客が友人に贈り物を購入して配送する場合、購入者の電話番号（支払いの問題が発生した場合のため）と友人の電話番号（配送の問題が発生した場合のため）の両方が必要になるかもしれません。サイトが国際電話番号（国コード付き）を期待している場合、これらは次のように見えるかもしれません: 

<p><label>Your phone number: <input type=tel name=custtel autocomplete="billing tel"></label>
 <p><label>Recipient's phone number: <input type=tel name=shiptel autocomplete="shipping tel"></label>
 <p>Please enter complete phone numbers including the country code prefix, as in "+1 555 123 4567".

しかし、サイトがイギリスの顧客と受取人のみをサポートしている場合、次のように見えるかもしれません（tel-nationalを使用している点に注目してください。これは、telとは異なります）: 

<p><label>Your phone number: <input type=tel name=custtel autocomplete="billing tel-national"></label>
 <p><label>Recipient's phone number: <input type=tel name=shiptel autocomplete="shipping tel-national"></label>
 <p>Please enter complete UK phone numbers, as in "(01632) 960 123".

次に、個人の好みの言語を考えてみましょう。適切なautocomplete値はlanguageです。しかし、目的に応じて使用するフォームコントロールには、テキストコントロール(<input type=text>)、ドロップダウンリスト(<select>)、ラジオボタン(<input type=radio>)など、さまざまなものがあります。これらはすべて、どのようなインターフェースが望ましいかによります。

最後に、名前を考えてみましょう。ページがユーザーから名前を一つだけ求めている場合、関連するコントロールは<input type=text>です。ページがユーザーのフルネームを求めている場合、適切なautocomplete値はnameです。 

<p><label>Japanese name: <input name="j" type="text" autocomplete="section-jp name"></label>
<label>Romanized name: <input name="e" type="text" autocomplete="section-en name"></label>

この例では、section-*キーワードがautocomplete属性の値に含まれています。これにより、ユーザーエージェントは二つのフィールドが異なる名前を期待していることを理解します。これがない場合、ユーザーが最初のフィールドに値を入力した際に、二番目のフィールドにも同じ値が自動的に入力されてしまう可能性があります。

-jpと-enという部分は、ユーザーエージェントには不透明であり、それだけではそれぞれの名前が日本語と英語であることを推測することはできません。

typeやautocompleteの選択とは別に、inputmode属性は、テキストコントロールの場合、どのような入力方式(例えば、仮想キーボード)を使用するかを決定します。

クレジットカード番号を考えてみましょう。適切な入力タイプはではありません。<input type=number>、以下で説明されているようにです。代わりに<input type=text>を使用します。それでもユーザーエージェントに数値入力モダリティ(例えば、数字だけが表示される仮想キーボード)を使用させたい場合、ページには次のような手段を使用します。 

<p><label>Credit card number:
                 <input name="cc" type="text" inputmode="numeric" pattern="[0-9]{8,19}" autocomplete="cc-number">
 </label></p>
4.10.1.8 日付、時刻、および数値の形式

このセクションは規範的ではありません。

このピザ配達の例では、時間は「HH:MM」形式で指定されています。つまり、24時間制の2桁の時間と、2桁の分です。（秒を指定することも可能ですが、この例では必要ありません。）

しかし、いくつかの地域では、ユーザーに提示される際に時間の表現が異なることがあります。例えば、アメリカでは依然として「2pm」のように、午前/午後の表示を伴う12時間制が一般的です。フランスでは、時間と分を「14h00」のように「h」文字で区切るのが一般的です。

日付にも同様の問題があり、さらに複雑なことに、コンポーネントの順序が必ずしも一貫していない場合があります。例えば、キプロスでは2003年2月1日は通常「1/2/03」と書かれますが、日本では同じ日付が通常「2003年02月01日」と書かれます。数値に関しても、例えば小数点や千位の区切りに使用される句読点が地域によって異なるなどの違いがあります。

したがって、HTMLおよびフォーム送信で使用される時刻、日付、数値の形式（常にこの仕様で定義された形式であり、コンピュータが読み取り可能な日付と時刻の形式に関するISO 8601標準に基づく）と、ブラウザがユーザーに提示し、ユーザーから入力として受け取る際に使用される時刻、日付、数値の形式を区別することが重要です。

「オンザワイヤー」、つまりHTMLマークアップおよびフォーム送信で使用される形式は、ユーザーの地域設定に関係なく、一貫してコンピュータが読み取り可能であることを意図しています。例えば、日付は常に「YYYY-MM-DD」形式で書かれます。「2003-02-01」のようにです。一部のユーザーはこの形式を目にするかもしれませんが、他のユーザーは「01.02.2003」や「2003年2月1日」のように表示されることがあります。

ワイヤー形式でページに与えられた時刻、日付、または数値は、ユーザーの好みに基づいて（またはページ自体の地域設定に基づいて）、ユーザーに表示される前にユーザーの好みに合わせた形式に変換されます。同様に、ユーザーが好みの形式で時刻、日付、または数値を入力した後、ユーザーエージェントはそれをワイヤー形式に変換してからDOMに配置するか、送信します。

これにより、ページやサーバー上のスクリプトが、多様な形式に対応することなく、一貫した方法で時刻、日付、および数値を処理できるようになりながらも、ユーザーのニーズをサポートすることができます。

フォームコントロールのローカライズに関する実装ノートも参照してください。

4.10.2 カテゴリ

主に歴史的な理由から、このセクションの要素は、フローコンテンツ、フレージングコンテンツ、インタラクティブコンテンツのような通常のカテゴリに加えて、いくつかの重複する（ただし微妙に異なる）カテゴリに分類されています。

いくつかの要素はフォーム関連要素に分類され、これらはフォームオーナーを持つことができます。

フォーム関連要素は、いくつかのサブカテゴリに分類されます:

リストされた要素

これらは、form.elementsおよびfieldset.elementsAPIにリストされる要素を示します。これらの要素には、formコンテンツ属性と、それに対応するformIDL属性があり、作成者が明示的にフォームオーナーを指定できるようにします。

送信可能な要素

これらは、form要素が送信された際に、エントリリストを構築するために使用できる要素を示します。

いくつかの送信可能な要素は、その属性に応じてボタンとなる場合があります。以下の説明は、要素がボタンである場合を定義します。いくつかのボタンは特に送信ボタンです。

リセット可能な要素

これらは、form要素がリセットされた際に影響を受ける要素を示します。

オートキャピタライズおよびオートコレクトを継承する要素

これらの要素は、フォームオーナー から autocapitalize 属性と autocorrect 属性を継承します。

いくつかの要素は、すべてがフォーム関連要素であるわけではありませんが、ラベル可能な要素として分類されています。これらはlabel要素と関連付けることができる要素です。

4.10.3 form要素

Element/form

すべての最新エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLFormElement

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
カテゴリ:
フローコンテンツ。
感じられるコンテンツ。
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ、ただしform要素の子孫は含まない。
テキスト/HTMLでのタグ省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
accept-charset — フォーム送信に使用する文字エンコーディング
action — URL を使用して フォーム送信
autocomplete — フォーム内のコントロールの自動入力機能のデフォルト設定
enctype — エントリリストのエンコード形式をフォーム送信で使用
method — フォーム送信に使用するバリアント
name — document.formsAPI内でフォームの名前を使用
novalidate — フォーム送信時にフォームコントロールの検証をバイパス
target — ナビゲータブル をフォーム送信に使用
rel
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window,
  LegacyOverrideBuiltIns,
  LegacyUnenumerableNamedProperties]
 interface HTMLFormElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString acceptCharset;
   [CEReactions] attribute USVString action;
   [CEReactions] attribute DOMString autocomplete;
   [CEReactions] attribute DOMString enctype;
   [CEReactions] attribute DOMString encoding;
   [CEReactions] attribute DOMString method;
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute boolean noValidate;
   [CEReactions] attribute DOMString target;
   [CEReactions] attribute DOMString rel;
   [SameObject, PutForwards=value] readonly attribute DOMTokenList relList;
 
   [SameObject] readonly attribute HTMLFormControlsCollection elements;
   readonly attribute unsigned long length;
   getter Element (unsigned long index);
   getter (RadioNodeList or Element) (DOMString name);
 
   undefined submit();
   undefined requestSubmit(optional HTMLElement? submitter = null);
   [CEReactions] undefined reset();
   boolean checkValidity();
   boolean reportValidity();
 };

form要素は表します、ハイパーリンクを。 これらはフォーム関連要素のコレクションを介して操作可能です。一部はサーバーで処理するために送信できる編集可能な値を表すことができます。

accept-charset属性は、送信に使用する文字エンコーディングを指定します。指定された場合、値は「UTF-8」とASCII 大文字小文字を区別しないマッチでなければなりません。[ENCODING]

name属性は、formの名前をformsコレクション内で表します。値は空文字列であってはならず、同じコレクション内の他のform要素と一意でなければなりません。

autocomplete属性は列挙属性であり、以下のキーワードと状態を持ちます:

キーワード 状態 簡単な説明
on On フォームコントロールはデフォルトで「on」に設定されます。
off Off フォームコントロールはデフォルトで「off」に設定されます。

この属性の欠落値デフォルトおよび無効値デフォルトはどちらもOn状態です。

action、enctype、method、novalidate、およびtarget属性はフォーム送信のための属性です。

rel属性は、form要素が作成するリンクの種類を制御します。属性の値は順不同の一意なスペース区切りトークンのセットでなければなりません。許可されたキーワードとその意味は前のセクションで定義されています。

relのサポートされているトークンは、ユーザーエージェントによって処理モデルが実装されている限り、form要素で許可されているHTMLリンクタイプで定義されたキーワードです。可能なサポートされているトークンには、noreferrer、noopener、およびopenerが含まれます。relのサポートされているトークンには、このリストからユーザーエージェントが処理モデルを実装しているトークンのみが含まれなければなりません。

form.elements

HTMLFormElement/elements

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

フォーム内のフォームコントロール（歴史的な理由で画像ボタンを除く）のHTMLFormControlsCollectionを返します。

form.length

HTMLFormElement/length

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

フォーム内のフォームコントロールの数を返します（歴史的な理由で画像ボタンを除く）。

form[index]

フォーム内のindex番目の要素を返します（歴史的な理由で画像ボタンを除く）。

form[name]

指定されたIDまたはnameを持つフォーム内のフォームコントロール（または複数ある場合はRadioNodeList）を返します（歴史的な理由で画像ボタンを除く）。いずれも存在しない場合は、指定されたIDを持つimg要素を返します。

一度特定の名前で要素が参照されると、その要素がIDまたはnameを変更しても、その名前を使用してこのメソッドでその要素を参照し続けることができますが、要素がツリー内にある限り有効です。

複数の一致する項目がある場合は、それらの要素を含むRadioNodeListオブジェクトが返されます。

form.submit()

HTMLFormElement/submit

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

フォームを送信します。インタラクティブな制約検証をバイパスし、submitイベントを発生させません。

form.requestSubmit([ submitter ])

HTMLFormElement/requestSubmit

すべての最新エンジンでサポートされています。

Firefox75+Safari16+Chrome76+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

フォームの送信を要求します。submit()とは異なり、このメソッドにはインタラクティブな制約検証とsubmitイベントの発生が含まれ、どちらも送信をキャンセルすることができます。

submitter引数を使用して、特定の送信ボタンを指すことができます。そのformaction、formenctype、formmethod、formnovalidate、およびformtarget属性が送信に影響を与える可能性があります。さらに、通常は除外されるボタンも送信のためのエントリリストの構築に含まれます。

form.reset()

HTMLFormElement/reset

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

フォームをリセットします。

form.checkValidity()

フォームのコントロールがすべて有効であればtrueを返し、そうでなければfalseを返します。

form.reportValidity()

フォームのコントロールがすべて有効であればtrueを返し、そうでなければfalseを返し、ユーザーに通知します。

autocompleteIDL属性は、同じ名前のコンテンツ属性を反映しなければならず、既知の値のみが許可される。

HTMLFormElement/name

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

nameおよびrelIDL属性は、同じ名前のコンテンツ属性を反映しなければならない。

HTMLFormElement/acceptCharset

すべての最新エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

acceptCharsetIDL属性は、accept-charsetコンテンツ属性を反映しなければならない。

relListIDL属性は、relコンテンツ属性を反映しなければならない。

elementsIDL属性は、form要素のルートに根ざしたHTMLFormControlsCollectionを返さなければならない。そのフィルタは、列挙された要素で、フォームの所有者がform要素であるものに一致しなければならないが、input要素でそのtype属性がImage Button状態にあるものは、歴史的な理由からこのコレクションから除外されなければならない。

lengthIDL属性は、elementsコレクションによって表されるノードの数を返さなければならない。

サポートされているプロパティのインデックスは、その瞬間にelements属性によって返されたオブジェクトによってサポートされているインデックスです。

ユーザーエージェントがform要素のインデックス付きプロパティの値を決定するには、指定されたindexを引数として指定してitemメソッドをelementsコレクションで呼び出す際に返される値を返さなければならない。

各form要素は、過去の名前マップと呼ばれる名前から要素へのマッピングを持ちます。これは、名前が変更されてもコントロールの名前を保持するために使用されます。

サポートされているプロパティ名は、次のアルゴリズムから取得した名前で構成され、そのアルゴリズムから取得した順序で構成されます。

  1. sourced namesを、文字列、要素、ソース（ソースはid、name、またはpastのいずれか）、およびソースがpastの場合は年齢で構成されるタプルの順序付きリストとします（初期は空です）。

  2. form要素がinput要素で、そのtype属性がImage Button状態にあるものを除く、列挙された要素candidateごとに:

    1. candidateがid属性を持つ場合、そのid属性の値を文字列として、candidateを要素として、idをソースとしてsourced namesにエントリを追加します。

    2. candidateがname属性を持つ場合、そのname属性の値を文字列として、candidateを要素として、nameをソースとしてsourced namesにエントリを追加します。

  3. img要素で、フォームの所有者がform要素であるcandidateごとに:

    1. candidateがid属性を持つ場合、そのid属性の値を文字列として、candidateを要素として、idをソースとしてsourced namesにエントリを追加します。

    2. candidateがname属性を持つ場合、そのname属性の値を文字列として、candidateを要素として、nameをソースとしてsourced namesにエントリを追加します。

  4. 過去の名前マップ内の各エントリpast entryに対して、そのpast entryの名前を文字列として、past entryの要素を要素として、pastをソースとして、past entryが過去の名前マップに存在する時間の長さを年齢としてsourced namesにエントリを追加します。

  5. sourced namesを、各タプルの要素エントリのツリー順序で並べ替え、同じ要素を持つエントリを、ソースがidのエントリを最初に、次にソースがnameのエントリを、最後にソースがpastのエントリを並べ、同じ要素とソースを持つエントリを年齢で並べ替え、最も古いものを最初にします。

  6. 名前が空文字列であるsourced namesのエントリを削除します。

  7. マップ内の以前のエントリと同じ名前を持つsourced namesのエントリを削除します。

  8. sourced namesから名前のリストを返し、その相対的な順序を維持します。

ユーザーエージェントがform要素の名前付きプロパティの値を決定するには、次の手順を実行しなければならない。

  1. candidatesをライブのRadioNodeListオブジェクトとし、列挙された要素のすべてを含むものとし、そのフォームの所有者がform要素であり、nameに等しいid属性またはname属性を持つものとしますが、input要素でそのtype属性がImage Button状態にあるものを除きます。

  2. candidatesが空の場合、candidatesをライブのRadioNodeListオブジェクトとし、img要素のすべてを含むものとし、そのフォームの所有者がform要素であり、nameに等しいid属性またはname属性を持つものとします。

  3. candidatesが空の場合、nameがform要素の過去の名前マップ内のエントリの1つである場合、そのマップ内のnameに関連付けられたオブジェクトを返します。

  4. candidatesに複数のノードが含まれている場合、candidatesを返します。

  5. それ以外の場合、candidatesには正確に1つのノードが含まれています。このノードにnameからのマッピングを追加し、以前に同じ名前のエントリが存在する場合はそれを置き換えます。

  6. candidatesのノードを返します。

あるform要素の過去の名前マップにリストされている要素がフォームの所有者を変更した場合、そのエントリはそのマップから削除されなければなりません。

submit()メソッドのステップは、submitted from submit() methodをtrueに設定し、submitをthisから実行することです。

requestSubmit(submitter)メソッドが呼び出された場合、次のステップを実行しなければなりません:

  1. submitterがnullでない場合:

    1. submitterがsubmit buttonでない場合、TypeErrorをスローします。

    2. submitterのform ownerがこのform要素でない場合、"NotFoundError"DOMExceptionをスローします。

  2. そうでない場合、submitterをこのform要素に設定します。

  3. submitterからこのform要素をSubmitします。

reset()メソッドが呼び出された場合、次のステップを実行しなければなりません:

  1. form要素がリセットのためにロックされていますとマークされている場合、リターンします。

  2. form要素をリセットのためにロックされたとマークします。

  3. form要素をリセットします。

  4. form要素のリセットのためにロックされたマークを解除します。

checkValidity()メソッドが呼び出された場合、ユーザーエージェントはform要素の制約を静的に検証し、制約検証がpositiveな結果を返した場合はtrueを、negativeな結果を返した場合はfalseを返さなければなりません。

reportValidity()メソッドが呼び出された場合、ユーザーエージェントはform要素の制約をインタラクティブに検証し、制約検証がpositiveな結果を返した場合はtrueを、negativeな結果を返した場合はfalseを返さなければなりません。

この例は、2つの検索フォームを示しています:

<form action="https://www.google.com/search" method="get">
  <label>Google: <input type="search" name="q"></label> <input type="submit" value="Search...">
 </form>
 <form action="https://www.bing.com/search" method="get">
  <label>Bing: <input type="search" name="q"></label> <input type="submit" value="Search...">
 </form>

4.10.4 label要素

Element/label

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLLabelElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
インタラクティブコンテンツ.
パルパブルコンテンツ.
この要素を使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ、ただし子孫にラベル付け可能な要素を含まない（それがその要素のラベル付けされたコントロールである場合を除く）、また子孫にlabel要素を含まない。
タグ省略の可否:
タグの省略は不可です。
コンテンツ属性:
グローバル属性
for — ラベルをフォームコントロールに関連付けます
アクセシビリティに関する考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLLabelElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   readonly attribute HTMLFormElement? form;
   [CEReactions] attribute DOMString htmlFor;
   readonly attribute HTMLElement? control;
 };

label要素は、ユーザーインターフェースのキャプションを表します。このキャプションは、label要素のラベル付けされたコントロールと呼ばれる特定のフォームコントロールに関連付けることができます。for属性を使用するか、label要素の内部にフォームコントロールを配置することで、関連付けられます。

以下のルールで特に指定されていない限り、label要素には、ラベル付けされたコントロールはありません。

属性/for

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

for属性は、キャプションが関連付けられるフォームコントロールを示すために指定することができます。この属性が指定されている場合、その属性の値は、label要素と同じツリー内のIDでなければなりません。また、その属性が指定され、かつfor属性の値に等しいIDを持つ要素がlabel要素のラベル付けされたコントロールです。

for属性が指定されていないが、label要素にラベル付け可能な要素の子孫がある場合、ツリー順で最初のそのような子孫が、label要素のラベル付けされたコントロールです。

label要素の正確なデフォルトの表示と動作、特にプラットフォームのラベル動作と一致するはずです。label要素のイベントに対するアクティベーション動作は何であれ、label要素のインタラクティブなコンテンツの子孫、およびそのインタラクティブなコンテンツの子孫を対象とするイベントのアクティベーション動作は何も行わない必要があります。

フォーム関連のカスタム要素はラベル付け可能な要素であるため、label要素のアクティベーション動作がラベル付けされたコントロールに影響を与える場合、組み込み要素とカスタム要素の両方に影響を与えます。

例えば、ラベルをクリックするとフォームコントロールがアクティブになるプラットフォームでは、次のスニペットの labelをクリックすると、 ユーザーエージェントがinput要素にクリックイベントを発火させる可能性があります。 これは、ユーザーがその要素自体をトリガーしたかのような挙動です: 

<label><input type=checkbox name=lost> Lost</label>

同様に、my-checkboxがフォーム関連のカスタム要素として宣言されていると仮定すると、次のコードも同じ動作をします。 

<label><my-checkbox name=lost></my-checkbox> Lost</label>

この場合も、my-checkbox要素でクリックイベントが発火されます。

他のプラットフォームでは、どちらの場合もコントロールにフォーカスするか、何もしないかの挙動になるかもしれません。

次の例は、ラベル付きの3つのフォームコントロールを示しています。そのうち2つは、ユーザーが使用するための適切な形式を示す小さなテキストが含まれています。

<p><label>Full name: <input name=fn> <small>Format: First Last</small></label></p>
 <p><label>Age: <input name=age type=number min=0></label></p>
 <p><label>Post code: <input name=pc> <small>Format: AB12 3CD</small></label></p>
label.control

HTMLLabelElement/control

現在のすべてのエンジンでサポートされています。

Firefox4+Safari5.1+Chrome6+
Opera12.1+Edge79+
Edge (Legacy)18Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

この要素に関連付けられているフォームコントロールを返します。

label.form

HTMLLabelElement/form

現在のすべてのエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

この要素に関連付けられているフォームコントロールのフォームオーナーを返します。

関連付けられているフォームオーナーがない場合はnullを返します。

HTMLLabelElement/htmlFor

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

htmlFor IDL属性は、反映する必要があります for コンテンツ属性。

control IDL属性は、次のステップを実行する必要があります:

  1. label 要素にラベル付きコントロールがない場合、nullを返します。

  2. label 要素のラベル付きコントロールが フォーム関連要素でない場合は、nullを返します。

  3. label 要素のラベル付きコントロールの フォーム所有者 (それでもnullの可能性があります) を返します。

form label要素のIDL属性は、リストされた フォーム関連要素のIDL属性とは異なり、formコンテンツ属性を持ちません。

control.labels

HTMLButtonElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari5.1+Chrome6+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

HTMLInputElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari5+Chrome6+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

HTMLMeterElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari6+Chrome6+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLOutputElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari5.1+Chrome9+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

HTMLProgressElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari6+Chrome6+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLSelectElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari5.1+Chrome6+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

HTMLTextAreaElement/labels

すべての現行エンジンでサポートされています。

Firefox56+Safari5.1+Chrome6+
Opera12.1+Edge79+
Edge (旧版)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

フォームコントロールに関連付けられているすべての NodeList を返します。

ラベル可能な要素とすべての input 要素には、 ライブな NodeList オブジェクトが関連付けられており、これは label 要素のリストを 表します。このリストは、ツリー順であり、その ラベル付きコントロールが該当する要素です。 labels IDL 属性は、ラベル可能な要素であって、フォーム関連のカスタム要素ではないもの、および labels IDL 属性を持つ input 要素が取得されるとき、 その NodeList オブジェクトを返さなければなりません。そして、この値は常に返される必要がありますが、 該当する要素が input 要素で、その type 属性が 非表示 の状態にある場合は、代わりに null を返す必要があります。

ElementInternals/labels

すべての現行エンジンでサポートされています。

Firefox98+Safari16.4+Chrome77+
Opera?Edge79+
Edge (旧版)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

フォーム関連のカスタム要素には labels IDL 属性はありません。 代わりに、 その ElementInternals オブジェクト には labels IDL 属性があります。取得時に、"NotSupportedError" DOMException をスローしなければならないのは、ターゲット要素が フォーム関連のカスタム要素でない場合です。それ以外の場合、同じ NodeList オブジェクトを返す必要があり、常に同じ値を返さなければなりません。

この（非準拠の）例は、NodeList と labels がどのように変化するか、および input 要素が type 属性を変更されたときに何を返すかを示しています。 

<!doctype html>
 <p><label><input></label></p>
 <script>
  const input = document.querySelector('input');
  const labels = input.labels;
  console.assert(labels.length === 1);
 
  input.type = 'hidden';
  console.assert(labels.length === 0); // inputはもはやラベルのラベル付きコントロールではありません
  console.assert(input.labels === null);
 
  input.type = 'checkbox';
  console.assert(labels.length === 1); // inputは再びラベルのラベル付きコントロールです
  console.assert(input.labels === labels); // 最初に返された値と同じです
 </script>

4.10.5 input 要素

Element/input

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (旧版)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android1+Samsung Internet?Opera Android12.1+

Element/input

HTMLInputElement

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera8+Edge79+
Edge (旧版)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
type 属性が 隠し 状態にない場合: インタラクティブコンテンツ。
type 属性が 隠し 状態にない場合: リストされている, ラベル可能, 送信可能, リセット可能, および 大文字化および自動修正継承 フォーム関連要素。
type 属性が 隠し 状態の場合: リストされている, 送信可能, リセット可能, および 大文字化および自動修正継承 フォーム関連要素。
type 属性が 隠し 状態にない場合: 触知可能なコンテンツ。
この要素を使用できるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
なし.
text/html でのタグの省略:
終了タグなし。
コンテンツ属性:
グローバル属性
accept — ファイルアップロードコントロールで予想されるファイルタイプのヒント
alpha — 色のアルファ成分を設定できるようにする
alt — 画像が利用できない場合に使用する代替テキスト
autocomplete — フォームの自動入力機能のヒント
checked — コントロールがチェックされているかどうか
colorspace — シリアル化された色の色空間
dirname — フォーム送信時に要素の方向性を送信するために使用するフォームコントロールの名前
disabled — フォームコントロールが無効かどうか
form — 要素を フォーム要素に関連付ける
formaction — URL を フォーム送信に使用する
formenctype — エントリリストエンコーディングタイプを フォーム送信に使用する
formmethod — フォーム送信に使用するバリアント
formnovalidate — フォーム送信のためのフォームコントロール検証をバイパスする
formtarget — ナビゲーブル を フォーム送信のために使用する
height — 垂直次元
list — オートコンプリートオプションのリスト
max — 最大値
maxlength — 値の最大長さ
min — 最小値
minlength — 値の最小長さ
multiple — 複数の値を許可するかどうか
name — 要素の名前 フォーム送信 および form.elements API で使用する
pattern — フォームコントロールの値が一致するパターン
placeholder — フォームコントロール内に配置されるユーザーに見えるラベル
popovertarget — ポップオーバー要素をトグル、表示、または非表示にするターゲット
popovertargetaction — 対象のポップオーバー要素がトグルされるか、表示されるか、または非表示にされるかを示す
readonly — ユーザーによる値の編集を許可するかどうか
required — フォーム送信のためにコントロールが必要かどうか
size — コントロールのサイズ
src — リソースのアドレス
step — フォームコントロールの値が一致するグラニュラリティ
type — フォームコントロールのタイプ
value — フォームコントロールの値
width — 水平次元
また、この要素には title 属性もあります。: pattern 属性と一緒に使用された場合のパターンの説明
アクセシビリティの考慮事項:
type 属性が 非表示 状態の場合: 著者向け; 実装者向け。
type 属性が テキスト状態の場合: 著者向け; 実装者向け。
type 属性が 検索状態の場合: 著者向け; 実装者向け。
type 属性が 電話状態の場合: 著者向け; 実装者向け。
type 属性が URL状態の場合: 著者向け; 実装者向け。
type 属性が メール 状態の場合: 著者向け; 実装者向け。
type 属性が パスワード 状態の場合: 著者向け; 実装者向け。
type 属性が 日付状態の場合: 著者向け; 実装者向け。
type 属性が 月 状態の場合: 著者向け; 実装者向け。
type 属性が 週 状態の場合: 著者向け; 実装者向け。
type 属性が 時間 状態の場合: 著者向け; 実装者向け。
type 属性が ローカル日付および時刻状態の場合: 著者向け; 実装者向け。
type 属性が 数値状態の場合: 著者向け; 実装者向け。
type 属性が 範囲 状態の場合: 著者向け; 実装者向け。
type 属性が 色状態の場合: 著者向け; 実装者向け。
type 属性が チェックボックス状態の場合: 著者向け; 実装者向け。
type 属性が ラジオボタン状態の場合: 著者向け; 実装者向け。
type 属性が ファイルアップロード状態の場合: 著者向け; 実装者向け。
type 属性が サブミットボタン状態の場合: 著者向け; 実装者向け。
type 属性が イメージボタン状態の場合: 著者向け; 実装者向け。
type 属性が リセットボタン状態の場合: 著者向け; 実装者向け。
type 属性が ボタン状態の場合: 著者向け; 実装者向け。
DOMインターフェイス: 
[Exposed=Window]
interface HTMLInputElement : HTMLElement {
  [HTMLConstructor] constructor();

  [CEReactions] attribute DOMString accept;
  [CEReactions] attribute boolean alpha;
  [CEReactions] attribute DOMString alt;
  [CEReactions] attribute DOMString autocomplete;
  [CEReactions] attribute boolean defaultChecked;
  attribute boolean checked;
  [CEReactions] attribute DOMString colorSpace;
  [CEReactions] attribute DOMString dirName;
  [CEReactions] attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
  attribute FileList? files;
  [CEReactions] attribute USVString formAction;
  [CEReactions] attribute DOMString formEnctype;
  [CEReactions] attribute DOMString formMethod;
  [CEReactions] attribute boolean formNoValidate;
  [CEReactions] attribute DOMString formTarget;
  [CEReactions] attribute unsigned long height;
  attribute boolean indeterminate;
  readonly attribute HTMLDataListElement? list;
  [CEReactions] attribute DOMString max;
  [CEReactions] attribute long maxLength;
  [CEReactions] attribute DOMString min;
  [CEReactions] attribute long minLength;
  [CEReactions] attribute boolean multiple;
  [CEReactions] attribute DOMString name;
  [CEReactions] attribute DOMString pattern;
  [CEReactions] attribute DOMString placeholder;
  [CEReactions] attribute boolean readOnly;
  [CEReactions] attribute boolean required;
  [CEReactions] attribute unsigned long size;
  [CEReactions] attribute USVString src;
  [CEReactions] attribute DOMString step;
  [CEReactions] attribute DOMString type;
  [CEReactions] attribute DOMString defaultValue;
  [CEReactions] attribute [LegacyNullToEmptyString] DOMString value;
  attribute object? valueAsDate;
  attribute unrestricted double valueAsNumber;
  [CEReactions] attribute unsigned long width;

  undefined stepUp(optional long n = 1);
  undefined stepDown(optional long n = 1);

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  boolean reportValidity();
  undefined setCustomValidity(DOMString error);

  readonly attribute NodeList? labels;

  undefined select();
  attribute unsigned long? selectionStart;
  attribute unsigned long? selectionEnd;
  attribute DOMString? selectionDirection;
  undefined setRangeText(DOMString replacement);
  undefined setRangeText(DOMString replacement, unsigned long start, unsigned long end, optional SelectionMode selectionMode = "preserve");
  undefined setSelectionRange(unsigned long start, unsigned long end, optional DOMString direction);

  undefined showPicker();

  // also has obsolete members
};
HTMLInputElement includes PopoverInvokerElement;

input 要素は、通常、ユーザーがデータを編集できるフォームコントロールを伴う型付きデータフィールドを 表します。

type 属性は、要素のデータ型（および関連するコントロール）を制御します。これは、以下のキーワードと状態を持つ 列挙型属性 です:

キーワード 状態 データ型 コントロールタイプ
hidden 非表示 任意の文字列 n/a
text テキスト 改行なしのテキスト テキストコントロール
search 検索 改行なしのテキスト 検索コントロール
tel 電話 改行なしのテキスト テキストコントロール
url URL 絶対URL テキストコントロール
email メール メールアドレスまたはメールアドレスのリスト テキストコントロール
password パスワード 改行なしのテキスト（機密情報） データ入力を隠すテキストコントロール
date 日付 タイムゾーンなしの日付（年、月、日） 日付コントロール
month 月 タイムゾーンなしの年と月からなる日付 月コントロール
week 週 タイムゾーンなしの週年番号と週番号からなる日付 週コントロール
time 時間 タイムゾーンなしの時間（時、分、秒、秒の小数） 時間コントロール
datetime-local ローカル日付と時刻 タイムゾーンなしの日付と時刻（年、月、日、時、分、秒、秒の小数） 日付と時刻のコントロール
number 数値 数値 テキストコントロールまたはスピナーコントロール
range 範囲 数値（正確な値が重要でない追加の意味を持つ） スライダーコントロールまたは類似のもの
color 色 8ビットの赤、緑、青の成分を持つsRGBカラー カラーピッカー
checkbox チェックボックス 事前に定義されたリストからの0またはそれ以上の値のセット チェックボックス
radio ラジオボタン 列挙型の値 ラジオボタン
file ファイルアップロード 各々がMIMEタイプとオプションでファイル名を持つゼロまたはそれ以上のファイル ラベルとボタン
submit 送信ボタン 列挙型の値で、選択された最後の値でなければならず、フォーム送信を開始する追加の意味を持つ ボタン
image イメージボタン 特定の画像のサイズに対して相対的な座標で、選択された最後の値でなければならず、フォーム送信を開始する追加の意味を持つ クリック可能な画像またはボタン
reset リセットボタン n/a ボタン
button ボタン n/a ボタン

この属性の欠落値デフォルト と 無効値デフォルト はどちらも テキスト 状態です。

accept、 alpha、 alt、 autocomplete、 checked、 colorspace、 dirname、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 height、 list、 max、 maxlength、 min、 minlength、 multiple、 pattern、 placeholder、 readonly、 required、 size、 src、 step、 および width のコンテンツ属性、 checked、 files、 valueAsDate、 valueAsNumber、 list の IDL 属性、 select() メソッド、 selectionStart、 selectionEnd、 selectionDirection の IDL 属性、 setRangeText() および setSelectionRange() メソッド、 stepUp() および stepDown() メソッド、 input および change イベント が input 要素に適用されるかどうかは、 type 属性の状態によります。 各タイプを定義するサブセクションは、これらの機能が適用されるものと適用されないものを明確に定義しており、これらの機能の動作は、それが適用されるかどうかによって異なります（例を参照してください。コンテンツ属性、API、イベント）。

次の表は規範的ではなく、これらのコンテンツ属性、IDL属性、メソッド、およびイベントのうち、各状態に適用されるものを要約しています:

Hidden Text, Search Telephone, URL Email Password Date, Month, Week, Time Local Date and Time Number Range Color Checkbox, Radio Button File Upload Submit Button Image Button Reset Button, Button
コンテンツ属性
accept · · · · · · · · · · · はい · · ·
alpha · · · · · · · · · はい · · · · ·
alt · · · · · · · · · · · · · はい ·
autocomplete はい はい はい はい はい はい はい はい はい はい · · · · ·
checked · · · · · · · · · · はい · · · ·
colorspace · · · · · · · · · はい · · · · ·
dirname はい はい はい はい はい · · · · · · · はい · ·
formaction · · · · · · · · · · · · はい はい ·
formenctype · · · · · · · · · · · · はい はい ·
formmethod · · · · · · · · · · · · はい はい ·
formnovalidate · · · · · · · · · · · · はい はい ·
formtarget · · · · · · · · · · · · はい はい ·
height · · · · · · · · · · · · · はい ·
list · はい はい はい · はい はい はい はい はい · · · · ·
max · · · · · はい はい はい はい · · · · · ·
maxlength · はい はい はい はい · · · · · · · · · ·
min · · · · · はい はい はい はい · · · · · ·
minlength · はい はい はい はい · · · · · · · · · ·
multiple · · · はい · · · · · · · はい · · ·
pattern · はい はい はい はい · · · · · · · · · ·
placeholder · はい はい はい はい · · はい · · · · · · ·
popovertarget · · · · · · · · · · · · はい はい はい
popovertargetaction · · · · · · · · · · · · はい はい はい
readonly · はい はい はい はい はい はい はい · · · · · · ·
required · はい はい はい はい はい はい はい · · はい はい · · ·
size · はい はい はい はい · · · · · · · · · ·
src · · · · · · · · · · · · · はい ·
step · · · · · はい はい はい はい · · · · · ·
width · · · · · · · · · · · · · はい ·
IDL属性とメソッド
checked · · · · · · · · · · はい · · · ·
files · · · · · · · · · · · はい · · ·
value default value value value value value value value value value default/on filename default default default
valueAsDate · · · · · はい · · · · · · · · ·
valueAsNumber · · · · · はい はい はい はい · · · · · ·
list · はい はい はい · はい はい はい はい はい · · · · ·
select() · はい はい はい† はい はい† はい† はい† · はい† · はい† · · ·
selectionStart · はい はい · はい · · · · · · · · · ·
selectionEnd · はい はい · はい · · · · · · · · · ·
selectionDirection · はい はい · はい · · · · · · · · · ·
setRangeText() · はい はい · はい · · · · · · · · · ·
setSelectionRange() · はい はい · はい · · · · · · · · · ·
stepDown() · · · · · はい はい はい はい · · · · · ·
stepUp() · · · · · はい はい はい はい · · · · · ·
イベント
input イベント · はい はい はい はい はい はい はい はい はい はい はい · · ·
change イベント · はい はい はい はい はい はい はい はい はい はい はい · · ·

† コントロールに選択可能なテキストがない場合、select() メソッドはno-opとなり、"InvalidStateError" DOMExceptionは発生しません。

type 属性のいくつかの状態は、値の サニタイズアルゴリズムを定義しています。

各input要素には、 値があり、それは value IDL属性で公開されます。いくつかの状態は、 文字列を数値に変換するアルゴリズム、 数値を文字列に変換するアルゴリズム、 文字列をDateオブジェクトに変換するアルゴリズム、 及びDateオブジェクトを文字列に変換するアルゴリズムを定義しており、これらは max、 min、 step、 valueAsDate、 valueAsNumber、 及びstepUp()によって使用されます。

input要素の dirty valueフラグは、 ユーザーがコントロールを操作して値が変更されるたびにtrueに設定されなければなりません。(このフラグは、 valueIDL属性の定義に記述されているように、 値がプログラムによって変更されたときにもtrueに設定されます。)

value コンテンツ属性は、デフォルト値を与えます。 input 要素のデフォルト値です。 value コンテンツ属性が追加、設定、または削除された場合、コントロールのdirty valueフラグ がfalseであれば、ユーザーエージェントは、要素の値を valueコンテンツ属性の値に設定しなければならず、 それが存在しない場合は空文字列に設定しなければならず、定義されている場合は現在の値のサニタイズアルゴリズムを実行しなければなりません。

各input要素には、 checkednessがあり、 それはcheckedIDL属性で公開されます。

各input要素には boolean dirty checkednessフラグがあります。それがtrueの場合、 要素はdirty checkednessを持つと言われます。 dirty checkednessフラグは、 要素が作成されたときにfalseに初期設定され、ユーザーがコントロールを操作してcheckednessが変更されたときにtrueに設定されなければなりません。

Element/input#checked

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

checked コンテンツ属性はブール属性であり、 input要素のデフォルト checkednessを指定します。 checkedコンテンツ属性が追加された場合、 コントロールにdirty checkednessがない場合、 ユーザーエージェントは要素のcheckednessを trueに設定しなければならず、 checkedコンテンツ属性が削除された場合、 コントロールにdirty checkednessがない場合、 ユーザーエージェントは要素のcheckednessを falseに設定しなければなりません。

リセットアルゴリズムは、 input 要素のユーザーの妥当性、 dirty valueフラグ、 及びdirty checkednessフラグ をfalseに戻し、値を valueコンテンツ属性の値に設定し、 それが存在しない場合は空文字列に設定し、checkednessを trueに設定します。もし要素にcheckedコンテンツ属性があり、falseであれば、 選択されたファイルのリストを空にし、 値のサニタイズアルゴリズムを呼び出し、 type属性の現在の状態が一つを定義している場合に実行します。

各input要素は、 変更可能です。特に指定がない限り、 input要素は常に 変更可能です。同様に、 特に指定がない限り、ユーザーエージェントは要素の値またはcheckednessをユーザーが変更することを許可すべきではありません。

input 要素が無効にされた場合、それは 変更可能ではなくなります。

readonly 属性はまた、いくつかの 場合（例えば、Date 状態など）において、input要素が 変更可能であることを停止することがあります。

input要素はピッカーをサポートできます。ピッカーとは、エンドユーザーが値を選択できるようにするユーザーインターフェイス要素です。input要素がピッカーをサポートするかどうかは、type属性の状態と実装定義の動作に依存します。input要素は、そのtype属性がファイルアップロード状態の場合にピッカーをサポートしなければなりません。

これを書いている時点では、一般的なブラウザの実装では、次のような場合にピッカーUIが表示されます。

node、copy、およびsubtreeが与えられたinput要素のクローン作成ステップは、値、ダーティ値フラグ、チェック状態、およびダーティチェック状態フラグをnodeからcopyに伝播することです。

アクティベーションの挙動は、input要素 elementと eventが与えられた場合、次の手順で行われます:

  1. もしelementが変更可能でなく、かつelementのtype属性がチェックボックス状態でもラジオボタン状態でもない場合は、戻る。

  2. elementの入力アクティベーション動作を、もしあれば実行し、そうでなければ何もしない。

  3. もしelementがフォームオーナーを持ち、かつelementのtype属性がボタン状態でない場合は、戻る。

  4. elementとeventのターゲットを与えて、ポップオーバーターゲット属性アクティベーション動作を実行する。

要素のアクティベーションの挙動は、ユーザーが開始したアクティベーションおよび（el.click()のような）シンセティックなアクティベーションの両方で実行されます。 ユーザーエージェントは、ここでは指定されていない、特定のコントロールに対する動作も持つ場合がありますが、それらは本当にユーザーが開始したアクティベーションによってのみトリガーされます。一般的な選択肢は、コントロールに適用される場合は ピッカーを表示すること です。これに対し、入力アクティベーションの挙動は、特定の歴史的ケースにおいてのみピッカーを表示します（ファイルアップロードおよび カラー状態)。

レガシーな事前アクティベーションの挙動は、input要素の場合、次の手順で行われます:

  1. この要素のtype 属性がチェックボックス状態の場合、この要素の checkednessを反対の値（つまり、falseであればtrue、trueであればfalse）に設定し、 この要素のindeterminateIDL属性をfalseに設定します。

  2. この要素のtype 属性がラジオボタン状態の場合、この要素の ラジオボタングループ内で checkednessがtrueに設定されている要素への参照を取得し、それが存在する場合、この要素の checkednessをtrueに設定します。

レガシーなキャンセルされたアクティベーションの挙動は、 input要素の場合、次の手順で行われます:

  1. 要素のtype 属性がチェックボックス状態の場合、要素の checkednessおよび要素の indeterminateIDL属性を、 レガシーな事前アクティベーションの挙動が実行される前の値に戻します。

  2. この要素のtype属性がラジオボタン状態である場合、その場合、レガシー事前アクティベーション動作で参照が取得された要素が（もしあれば）、この要素がまだラジオボタングループを持っている場合にそのラジオボタングループ内に依然として存在し、かつそうであれば、その要素のチェック状態をtrueに設定する。そうでなければ、そのような要素が存在しなかった場合、またはその要素がもはやこの要素のラジオボタングループにない場合、またはこの要素がもはやラジオボタングループを持たない場合、この要素のチェック状態をfalseに設定する。

input要素が最初に作成されたとき、要素のレンダリングと動作は、type属性の状態に対して定義されたレンダリングと動作に設定されなければならず、type属性の状態に対して値のサニタイズアルゴリズムが定義されている場合は、それを呼び出さなければなりません。

input要素の type属性が 状態を変更した場合、ユーザーエージェントは次の手順を実行しなければなりません:

  1. 要素の以前のtype 属性の状態がvalue IDL属性をvalueモードにしており、要素の値が空文字列でない場合、そして要素の type 属性の新しい状態がvalue IDL属性をdefaultモードまたはdefault/onモードにする場合、要素の value コンテンツ属性を要素の値に設定します。

  2. それ以外の場合で、要素の以前のtype 属性の状態がvalue IDL属性をvalueモード以外のモードにしており、要素のtype 属性の新しい状態がvalue IDL属性をvalueモードにする場合、要素の値を value コンテンツ属性の値に設定し、それが存在しない場合は空文字列に設定し、その後コントロールのdirty valueフラグを falseに設定します。

  3. それ以外の場合で、要素の以前のtype 属性の状態がvalue IDL属性をfilenameモード以外のモードにしており、要素の type 属性の新しい状態がvalue IDL属性をfilenameモードにする場合、要素の値を 空文字列に設定します。

  4. 要素のレンダリングと動作を新しい状態に更新します。

  5. 要素のタイプ変更を通知します。(ラジオボタン状態がこれを特に使用します。)

  6. 値のサニタイズアルゴリズムを 呼び出します（type 属性の新しい状態に対して定義されている場合）。

  7. previouslySelectableを、setRangeText() が以前に要素に適用された場合はtrue、そうでない場合はfalseとします。

  8. nowSelectableを、setRangeText() が今適用された場合はtrue、そうでない場合はfalseとします。

  9. previouslySelectableがfalseでnowSelectableがtrueの場合、要素のテキストエントリーカーソルの位置を テキストコントロールの先頭に設定し、選択方向を「none」に設定します。

name属性は要素の名前を表します。 dirname属性は、 要素の書字方向が どのように送信されるかを制御します。 disabled 属性は、コントロールを非インタラクティブにし、その値が送信されないようにするために使用されます。 form属性は、 input要素を そのフォームオーナーと明示的に関連付けるために使用されます。 autocomplete 属性は、ユーザーエージェントがオートフィル機能をどのように提供するかを制御します。

HTMLInputElement#indeterminate

現在のすべてのエンジンでサポートされています。

Firefox3.6+Safari3+Chrome1+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android≤12.1+
caniuse.com table

indeterminateIDL属性は、初期設定でfalseに設定されなければなりません。取得時には、設定された最後の値を返さなければなりません。設定時には、新しい値に設定されなければなりません。チェックボックスコントロールの外観を変更する以外には効果はありません。

HTMLInputElement/multiple

現在のすべてのエンジンでサポートされています。

Firefox3.6+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

accept、alpha、alt、max、min、multiple、pattern、placeholder、required、size、src、およびstep IDL属性は、同じ名前のそれぞれのコンテンツ属性を反映しなければなりません。dirName IDL属性は、dirnameコンテンツ属性を反映しなければなりません。readOnly IDL属性は、readonlyコンテンツ属性を反映しなければなりません。defaultChecked IDL属性は、checkedコンテンツ属性を反映しなければなりません。defaultValue IDL属性は、valueコンテンツ属性を反映しなければなりません。

colorSpace IDL属性は、colorspaceコンテンツ属性を反映し、既知の値のみに制限されなければなりません。type IDL属性は、同じ名前のそれぞれのコンテンツ属性を反映し、既知の値のみに制限されなければなりません。maxLength IDL属性は、maxlengthコンテンツ属性を反映し、非負の数値のみに制限されなければなりません。minLength IDL属性は、minlengthコンテンツ属性を反映し、非負の数値のみに制限されなければなりません。

IDL属性widthおよびheightは、画像がレンダリングされている場合、CSSピクセル単位でレンダリングされた画像の幅と高さを返さなければなりません。それ以外の場合、画像が利用可能であるがレンダリングされていない場合、CSSピクセル単位で画像の自然な幅と高さを返さなければなりません。それ以外の場合、画像が利用可能でない場合は0を返さなければなりません。input要素のtype属性が画像ボタン状態でない場合、画像は利用可能ではありません。[CSS]

設定時には、同じ名前のそれぞれのコンテンツ属性を反映するかのように動作しなければなりません。

willValidate、 validity、およびvalidationMessage IDL属性、さらにcheckValidity()、 reportValidity()、 およびsetCustomValidity() メソッドは、 制約検証APIの一部です。labels IDL属性は、要素のラベルのリストを提供します。 select()、 selectionStart、 selectionEnd、 selectionDirection、 setRangeText()、 およびsetSelectionRange() メソッドとIDL属性は、要素のテキスト選択を公開します。 disabled、 form、およびnameIDL属性は、 要素のフォームAPIの一部です。

4.10.5.1 type属性の状態
4.10.5.1.1 Hidden状態 (type=hidden)

Element/input/hidden

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera2+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素のtype 属性が Hidden 状態にある場合、このセクションのルールが適用されます。

input 要素は ユーザーが確認または操作することを意図していない値を表します。

制約バリデーション: input 要素の type 属性が Hidden状態にある場合、制約バリデーションから除外されます。

name属性が 存在し、その値が"_charset_"と ASCII大文字小文字を区別しないマッチである場合、 要素のvalue 属性は 省略されなければなりません。

autocomplete および dirname コンテンツ属性がこの要素に適用されます。

value IDL属性がこの要素に適用され、 モードはdefaultです。

次のコンテンツ属性は指定されず、要素に適用されません: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, required, size, src, step, width。

次のIDL属性およびメソッドは要素に適用されません: checked, files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, valueAsNumber IDL属性; select(), setRangeText(), setSelectionRange(), stepDown(), stepUp() メソッド。

input およびchange イベントは適用されません。

4.10.5.1.2 Text (type=text)状態およびSearch状態 (type=search)

Element/input/search

現在のすべてのエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/input/text

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素のtype 属性が Text 状態またはSearch 状態にある場合、このセクションのルールが適用されます。

input 要素は、その要素のvalueのための1行のプレーンテキスト編集コントロールを表します。

Text 状態とSearch 状態の違いは主にスタイルに関するものです。検索コントロールが通常のテキストコントロールと区別されるプラットフォームでは、Search 状態では、通常のテキストコントロールとは異なる外観がプラットフォームの検索コントロールと一致する可能性があります。

要素がmutableである場合、そのvalueはユーザーによって編集可能であるべきです。ユーザーエージェントは、 ユーザーが要素のvalueにU+000A LINE FEED (LF)またはU+000D CARRIAGE RETURN (CR)文字を挿入することを許可してはなりません。

要素がmutableである場合、ユーザーエージェントはユーザーが要素の書字方向を変更し、左から右への書字方向または右から左への書字方向に設定できるようにするべきです。ユーザーがこれを行った場合、ユーザーエージェントは次のステップを実行しなければなりません。

  1. ユーザーが左から右への書字方向を選択した場合、要素のdir 属性を"ltr" に、ユーザーが右から左への書字方向を選択した場合は"rtl" に設定します。

  2. 要素のタスクをキューに入れる、 ユーザーインタラクションタスクソースに対して 要素を指定し、イベントを発火させる input と名付けられたイベントを要素に対して、bubbles およびcomposed 属性をtrueに初期化して発火させます。

value 属性が指定されている場合、その値にはU+000A LINE FEED (LF)またはU+000D CARRIAGE RETURN (CR)文字が含まれてはなりません。

値のサニタイズアルゴリズムは次のとおりです: 改行を削除する要素のvalueから。

次の共通のinput 要素の内容 属性、IDL属性、およびメソッドは要素に適用されます: autocomplete, dirname, list, maxlength, minlength, pattern, placeholder, readonly, required, および size 内容属性; list, selectionStart, selectionEnd, selectionDirection, および value IDL属性; select(), setRangeText(), および setSelectionRange() メソッド。

value IDL属性は valueモードで動作します。

input およびchange イベントは適用されます。

次の内容属性は指定してはならず、要素に適用されません: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, multiple, popovertarget, popovertargetaction, src, step, および width。

次のIDL属性およびメソッドは要素に適用されません: checked, files, valueAsDate, および valueAsNumber IDL属性; stepDown() および stepUp() メソッド。

4.10.5.1.3 電話 状態 (type=tel)

Element/input/tel

すべての現在のエンジンでサポートされています。

FirefoxはいSafari4+Chrome3+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS3+Chrome Android18+WebView Android37+Samsung Internet?Opera Android11+

input 要素の type 属性が 電話 状態にある場合、このセクションの規則が適用されます。

input 要素は、要素の 値 に与えられた電話番号を編集するためのコントロールを 表します。

要素が 変更可能 であれば、その 値 はユーザーによって編集可能であるべきです。ユーザーエージェントは、ユーザーが入力した 値 の間隔や、慎重に扱って句読点を変更する場合があります。ユーザーエージェントは、ユーザーが U+000A LINE FEED (LF) または U+000D CARRIAGE RETURN (CR) 文字を要素の 値 に挿入することを許可してはなりません。

value 属性が指定されている場合、その値には U+000A LINE FEED (LF) または U+000D CARRIAGE RETURN (CR) 文字が含まれてはなりません。

値の消毒アルゴリズム: 値から改行を削除 します。

URL 型および Email 型とは異なり、電話 型では特定の構文は強制されません。これは意図的なものであり、実際には電話番号フィールドは自由形式のフィールドであることが多いためです。特定の形式を強制する必要があるシステムには、pattern 属性や、クライアントサイドの検証メカニズムにフックするための setCustomValidity() メソッドを使用することを推奨します。

次の共通 input 要素のコンテンツ属性、IDL属性、およびメソッドが要素に適用されます: autocomplete, dirname, list, maxlength, minlength, pattern, placeholder, readonly, required, size コンテンツ属性; list, selectionStart, selectionEnd, selectionDirection, value IDL 属性; select(), setRangeText(), setSelectionRange() メソッド。

value IDL 属性は、値 モードにあります。

input および change イベントは、適用されます。

次のコンテンツ属性は指定されるべきではなく、要素に 適用されません: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, multiple, popovertarget, popovertargetaction, src, step, width。

次のIDL属性およびメソッドは要素に 適用されません: checked, files, valueAsDate, valueAsNumber IDL 属性; stepDown() stepUp() メソッド。

4.10.5.1.4 URL 状態 (type=url)

Element/input/url

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素の type 属性が URL 状態にある場合、このセクションの規則が適用されます。

input 要素は、要素の 値 に与えられた単一の 絶対URL を編集するためのコントロールを 表します。

要素が 変更可能 であれば、ユーザーエージェントは、ユーザーがその 値 で表されるURLを変更できるようにする必要があります。ユーザーエージェントは、ユーザーが 有効な 絶対URL でない文字列を 値 として設定することを許可する場合がありますが、代わりに、ユーザーが入力した文字を自動的にエスケープして、値 が常に 有効な 絶対URL となるようにすることもできます（たとえそれがユーザーインターフェイスでユーザーが実際に見て編集した値でなくても）。ユーザーエージェントは、ユーザーが 値 を空文字列に設定できるようにする必要があります。ユーザーエージェントは、ユーザーが U+000A LINE FEED (LF) または U+000D CARRIAGE RETURN (CR) 文字を 値 に挿入することを許可してはなりません。

value 属性が指定されており、かつ空でない場合、その値は、スペースで囲まれる可能性のある有効なURL であり、かつ 絶対URL でなければなりません。

値の消毒アルゴリズム: 値から改行を削除 し、次に 先頭および末尾のASCII空白を削除 します。

制約の検証: 要素の 値 が空文字列でなく、かつ 有効な 絶対URL でない間、要素は 型の不一致が発生 します。

次の共通 input 要素のコンテンツ属性、IDL属性、およびメソッドが要素に適用されます: autocomplete, dirname, list, maxlength, minlength, pattern, placeholder, readonly, required, および size コンテンツ属性; list, selectionStart, selectionEnd, selectionDirection, および value IDL 属性; select(), setRangeText(), および setSelectionRange() メソッド。

value IDL 属性は、値 モードにあります。

input および change イベントが 適用 されます。

次のコンテンツ属性は指定されるべきではなく、要素に 適用されません: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, multiple, popovertarget, popovertargetaction, src, step, および width。

次のIDL属性およびメソッドは要素に 適用されません: checked, files, valueAsDate, および valueAsNumber IDL 属性; stepDown() および stepUp() メソッド。

ドキュメントに次のマークアップが含まれていた場合:

<input type="url" name="location" list="urls">
 <datalist id="urls">
  <option label="MIME: Format of Internet Message Bodies" value="https://www.rfc-editor.org/rfc/rfc2045">
  <option label="HTML" value="https://html.spec.whatwg.org/">
  <option label="DOM" value="https://dom.spec.whatwg.org/">
  <option label="Fullscreen" value="https://fullscreen.spec.whatwg.org/">
  <option label="Media Session" value="https://mediasession.spec.whatwg.org/">
  <option label="The Single UNIX Specification, Version 3" value="http://www.unix.org/version3/">
 </datalist>

...そして、ユーザーが "spec.w" と入力し、ユーザーエージェントがユーザーが最近 https://url.spec.whatwg.org/#url-parsing および https://streams.spec.whatwg.org/ にアクセスしたことを見つけた場合、レンダリングは次のように見えるかもしれません:

左にアイコン、続いて "spec.w" のテキストとカーソル、右側にドロップダウンボタンがあるテキストボックス;その下には、左側に6つのURLが並び、最初の4つは右側に灰色のラベルがあるドロップダウンボックスと、さらに値があることを示すスクロールバーが表示されている。

このサンプルの最初の4つのURLは、ユーザーが入力したテキストに一致する、作成者指定のリスト内の4つのURLであり、実装定義の 方法でソートされています（おそらく、ユーザーがそのURLを参照する頻度によるものです）。UAがURLの値を使用して、ユーザーがスキーム部分を省略し、ドメイン名でインテリジェントなマッチングを行えることに注意してください。

このサンプルの最後の2つのURL（そしておそらく、スクロールバーのさらなる値の利用可能性の指示に基づいて、さらに多くのURLがあるでしょう）は、ユーザーエージェントのセッション履歴データからの一致です。このデータはページDOMには提供されません。この特定のケースでは、UAにはそれらの値に対応するタイトルが提供されていません。

4.10.5.1.5 メール状態 (type=email)

Element/input/email

すべての最新エンジンでサポートされています。

Firefox1+Safari5+Chrome5+
Opera11+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

input要素のtype属性がEmail状態である場合、このセクションのルールが適用されます。

Email状態の動作は、multiple属性が指定されているかどうかに依存します。

multiple属性が要素に指定されていない場合

input要素は、要素のvalueで指定されたメールアドレスを編集するためのコントロールを表します。

要素が変更可能な場合、ユーザーエージェントはユーザーにそのvalueで表されるメールアドレスを変更できるようにする必要があります。ユーザーエージェントは、valueを有効なメールアドレスではない文字列に設定できるようにすることがあります。ユーザーエージェントは、ユーザーが単一のメールアドレスを提供することを期待していると想定して動作するべきです。ユーザーエージェントは、ユーザーにvalueを空の文字列に設定させるべきです。ユーザーエージェントは、ユーザーがvalueにU+000Aラインフィード(LF)またはU+000Dキャリッジリターン(CR)文字を挿入することを許可してはいけません。ユーザーエージェントは表示と編集のためにvalueを変換することがあります。特に、ユーザーエージェントはvalueのドメインラベルにおけるPunycodeを表示においてIDNに変換し、逆も同様に行うべきです。

制約検証: ユーザーインターフェースがPunycodeに変換できない入力を表している場合、コントロールは無効な入力を受けていると見なされます。

value属性が指定されていて空でない場合、その値は有効なメールアドレスである必要があります。

値のサニタイズアルゴリズムは次の通りです: 改行を削除する 値から、次に先頭と末尾のASCII空白を削除します 値から。

制約検証: 要素の値が空の文字列でもなく、単一の有効なメールアドレスでもない場合、要素はタイプミスマッチを受けていると見なされます。

multiple属性が要素に指定されている場合

input要素は、要素の値に指定されたメールアドレスを追加、削除、および編集するためのコントロールを表します。

要素が変更可能な場合、ユーザーエージェントはユーザーにその値で表されるメールアドレスを追加、削除、および編集できるようにするべきです。ユーザーエージェントは、リスト内の任意の個別の値を有効なメールアドレスでない文字列に設定できるようにすることがありますが、ユーザーがU+002Cコンマ(,)やU+000Aラインフィード(LF)、U+000Dキャリッジリターン(CR)文字を含む文字列に設定することを許可してはいけません。ユーザーエージェントは、要素の値にあるすべてのアドレスを削除できるようにするべきです。ユーザーエージェントは表示と編集のために値を変換することがあります。特に、ユーザーエージェントは値のドメインラベルにおけるPunycodeを表示においてIDNに変換し、逆も同様に行うべきです。

制約検証: ユーザーインターフェースがU+002Cコンマ(,)を含む個別の値またはユーザーエージェントがPunycodeに変換できない入力を表している場合、コントロールは無効な入力を受けていると見なされます。

ユーザーが要素の値を変更するたびに、ユーザーエージェントは次の手順を実行する必要があります:

  1. latest valuesを要素の値のコピーにします。

  2. 先頭と末尾のASCII空白を削除します latest values内の各値から。

  3. 要素の値をlatest valuesのすべての値を単一のU+002Cコンマ文字(,)で区切って連結した結果にします。リストの順序を維持します。

value属性が指定されている場合、その値は有効なメールアドレスリストである必要があります。

値のサニタイズアルゴリズムは次の通りです:

  1. コンマで分割します 要素の値を、先頭と末尾のASCII空白を削除します 各結果のトークンから（存在する場合）、要素の値を（おそらく空の）トークンのリストにします。元の順序を維持します。

  2. 要素の値を、要素の値を単一のU+002Cコンマ文字(,)で区切って連結した結果にします。リストの順序を維持します。

制約検証: 要素の値が有効なメールアドレスリストでない場合、要素はタイプミスマッチを受けていると見なされます。

multiple属性が設定または削除されると、ユーザーエージェントは値のサニタイズアルゴリズムを実行する必要があります。

有効なメールアドレスとは、次のABNFのemail生成に一致する文字列であり、その文字セットはUnicodeです。このABNFは、RFC 1123で説明されている拡張機能を実装しています。 [ABNF] [RFC5322] [RFC1034] [RFC1123] 

email         = 1*( atext / "." ) "@" label *( "." label )
 label         = let-dig [ [ ldh-str ] let-dig ]  ; 限定されます 63文字までRFC 1034 セクション 3.5
 atext         = < as defined in RFC 5322 セクション 3.2.3 >
 let-dig       = < as defined in RFC 1034 セクション 3.5 >
 ldh-str       = < as defined in RFC 1034 セクション 3.5 >

この要件はRFC 5322の意図的な違反です。RFC 5322はメールアドレスの構文を定義していますが、その構文は、ここで実用的であるには、同時に（「@」文字の前では）厳しすぎ、（「@」文字の後では）曖昧すぎ、そして（ほとんどのユーザーには馴染みのない方法でコメント、空白文字、引用符付き文字列を許可するという点で）緩すぎます。

以下のJavaScriptおよびPerl互換の正規表現は、上記の定義を実装したものです。

/^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/

有効なメールアドレスリストとは、カンマ区切りのトークンの集合であり、各トークンがそれ自体が有効なメールアドレスである場合です。有効なメールアドレスリストからトークンのリストを取得するには、実装は文字列をカンマで分割します。

次の共通のinput要素のコンテンツ属性、IDL属性、およびメソッドが要素に適用されます: autocomplete, dirname, list, maxlength, minlength, multiple, pattern, placeholder, readonly, required, および sizeコンテンツ属性; listおよびvalueIDL属性; select() メソッド。

valueIDL属性は値モードです。

inputおよびchangeイベントが適用されます。

次のコンテンツ属性は指定されるべきではなく適用されません要素に: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, popovertarget, popovertargetaction, src, step, および width。

次のIDL属性およびメソッド適用されません要素に: checked, files, selectionStart, selectionEnd, selectionDirection, valueAsDate, および valueAsNumberIDL属性; stepDown() および stepUp()メソッド。

4.10.5.1.6 パスワード 状態 (type=password)

要素/input/password

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera2+Edge79+
Edge (レガシー)12+Internet Explorer2+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素の type 属性が パスワード 状態にある場合、このセクションのルールが適用されます。

input 要素は、要素の 値 のための一行のプレーンテキスト編集コントロールを表します。ユーザーエージェントは、ユーザー以外の人がそれを見られないように値を隠す必要があります。

要素が 可変 である場合、その 値 はユーザーが編集可能であるべきです。ユーザーエージェントは、ユーザーが U+000A LINE FEED (LF) や U+000D CARRIAGE RETURN (CR) 文字を 値 に挿入することを許可してはいけません。

指定されている場合、 value 属性には、U+000A LINE FEED (LF) や U+000D CARRIAGE RETURN (CR) 文字が含まれていない値を持つ必要があります。

値のサニタイズアルゴリズム は次の通りです: 改行を削除 して 値 を処理します。

次の一般的な input 要素のコンテンツ属性、IDL 属性、およびメソッドは、要素に 適用されます: autocomplete, dirname, maxlength, minlength, pattern, placeholder, readonly, required, size コンテンツ属性; selectionStart, selectionEnd, selectionDirection, value IDL 属性; select(), setRangeText(), setSelectionRange() メソッド。

value IDL 属性は、モード value にあります。

次の input および change イベントが 適用されます。

次のコンテンツ属性は指定されてはならず、要素に 適用されません: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, min, multiple, popovertarget, popovertargetaction, src, step, width。

次の IDL 属性およびメソッドは要素に 適用されません: checked, files, list, valueAsDate, valueAsNumber IDL 属性; stepDown() stepUp() メソッド。

4.10.5.1.7 日付 状態 (type=date)

要素/input/date

すべての現行エンジンでサポートされています。

Firefox57+Safari14.1+Chrome20+
Opera11+Edge79+
Edge (レガシー)12+Internet Explorerサポートなし
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

input 要素の type 属性が 日付 状態にある場合、このセクションのルールが適用されます。

input 要素は、要素の 値 を特定の 日付 を表す文字列に設定するためのコントロールを表します。

要素が 可変 である場合、ユーザーエージェントは、ユーザーがその 日付 を変更できるようにする必要があります。ユーザーエージェントは、 有効な日付文字列 ではない非空の文字列を 値 に設定することを許可してはいけません。ユーザーエージェントがユーザーが 日付 を選択するためのインターフェースを提供する場合、その 値 は、ユーザーの選択を表す 有効な日付文字列 に設定されなければなりません。ユーザーエージェントは、ユーザーが 値 を空の文字列に設定できるようにする必要があります。

制約の検証: ユーザーインターフェースが、ユーザーエージェントが 有効な日付文字列 に変換できない入力を記述している間、コントロールは 不正な入力 によって影響を受けています。

日付、時間、および数値フォームコントロールの入力形式と送信形式の違いについての議論や、フォームコントロールのローカライズに関する 導入セクション と 実装ノート を参照してください。

value 属性が指定されていて、かつ空でない場合、その値は 有効な日付文字列 でなければなりません。

値のサニタイズアルゴリズム は次の通りです: 要素の 値 が 有効な日付文字列 でない場合、それを空の文字列に設定します。

min 属性が指定されている場合、その値は 有効な日付文字列 でなければなりません。 max 属性が指定されている場合、その値は 有効な日付文字列 でなければなりません。

step 属性は日数で表されます。 ステップスケールファクター は 86,400,000 であり（他のアルゴリズムで使用されるミリ秒に日数を変換します）。 デフォルトステップ は 1 日です。

要素が ステップの不一致 によって影響を受けている場合、ユーザーエージェントは要素の 値 を最も近い 日付 に丸めることができます。

文字列を数値に変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 日付を解析する とエラーになる場合はエラーを返します。それ以外の場合は、1970-01-01 の朝の UTC の午前零時（値 "1970-01-01T00:00:00.0Z" で表される時刻）から解析された 日付 の午前零時 UTC までのミリ秒数を返します。うるう秒は無視します。

数値を文字列に変換するアルゴリズム は次の通りです: 数値 input が与えられたとき、1970-01-01 の朝の UTC の午前零時（値 "1970-01-01T00:00:00.0Z" で表される時刻）から現在の input ミリ秒後に UTC での時刻に相当する 有効な日付文字列 を返します。

文字列を Date オブジェクトに変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 日付を解析する とエラーになる場合はエラーを返します。それ以外の場合は、解析された 日付 の午前零時 UTC を表す新しい Date オブジェクト を返します。

Date オブジェクトを文字列に変換するアルゴリズム は次の通りです: Date オブジェクト input が与えられたとき、UTC タイムゾーンで input に相当する時刻の 日付 を表す 有効な日付文字列 を返します。

日付 状態（およびその後のセクションで説明される他の日付や時間に関連する状態）は、現代のカレンダーに対して正確な日付と時刻が確立できない値の入力を目的としたものではありません。例えば、「ビッグバンの1ミリ秒後」や「ジュラ紀の初期」、「紀元前250年頃の冬」などの時間の入力には不適切です。

グレゴリオ暦が導入される前の日付を入力する場合、著者は 日付 状態（およびその後のセクションで説明される他の日付や時間に関連する状態）を使用しないことをお勧めします。ユーザーエージェントは、以前の時代の日付や時間をグレゴリオ暦に変換することをサポートする必要はなく、ユーザーに手動でそれを行わせることはユーザーに過度の負担をかけます。（これは、グレゴリオ暦が異なる時期に異なる国で段階的に導入されたため、16世紀の途中から20世紀の初期にかけて異なります。）代わりに、著者は select 要素と input 要素を使用して、 数値 状態を使用してきめ細かい入力コントロールを提供することをお勧めします。

次の一般的な input 要素のコンテンツ属性、IDL 属性、およびメソッドは、要素に 適用されます: autocomplete, list, max, min, readonly, required, step コンテンツ属性; list, value, valueAsDate, valueAsNumber IDL 属性; select(), stepDown(), stepUp() メソッド。

value IDL 属性は、モード value にあります。

次の input および change イベントが 適用されます。

次のコンテンツ属性は指定されてはならず、要素に 適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src、 width。

次の IDL 属性およびメソッドは要素に 適用されません: checked, selectionStart, selectionEnd, selectionDirection IDL 属性; setRangeText(), setSelectionRange() メソッド。

4.10.5.1.8 月 状態 (type=month)

要素/input/month

すべての現行エンジンでサポートされています。

FirefoxサポートなしSafariサポートなしChrome20+
Opera11+Edge79+
Edge (レガシー)12+Internet Explorerサポートなし
Firefox Android18+Safari iOSサポートありChrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素の type 属性が 月 状態にある場合、このセクションのルールが適用されます。

input 要素は、要素の 値 を特定の 月 を表す文字列に設定するためのコントロールを表します。

要素が 可変 である場合、ユーザーエージェントは、ユーザーがその 月 を変更できるようにする必要があります。ユーザーエージェントは、 有効な月の文字列 ではない非空の文字列を 値 に設定することを許可してはいけません。ユーザーエージェントがユーザーが 月 を選択するためのインターフェースを提供する場合、その 値 は、ユーザーの選択を表す 有効な月の文字列 に設定されなければなりません。ユーザーエージェントは、ユーザーが 値 を空の文字列に設定できるようにする必要があります。

制約の検証: ユーザーインターフェースが、ユーザーエージェントが 有効な月の文字列 に変換できない入力を記述している間、コントロールは 不正な入力 によって影響を受けています。

日付、時間、および数値フォームコントロールの入力形式と送信形式の違いについての議論や、フォームコントロールのローカライズに関する 導入セクション と 実装ノート を参照してください。

value 属性が指定されていて、かつ空でない場合、その値は 有効な月の文字列 でなければなりません。

値のサニタイズアルゴリズム は次の通りです: 要素の 値 が 有効な月の文字列 でない場合、それを空の文字列に設定します。

min 属性が指定されている場合、その値は 有効な月の文字列 でなければなりません。 max 属性が指定されている場合、その値は 有効な月の文字列 でなければなりません。

step 属性は月単位で表されます。 ステップスケールファクター は 1 であり（アルゴリズムでは月を使用するため変換は不要です）。 デフォルトステップ は 1 ヶ月です。

要素が ステップの不一致 によって影響を受けている場合、ユーザーエージェントは要素の 値 を最も近い 月 に丸めることができます。

文字列を数値に変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 月を解析する とエラーになる場合はエラーを返します。それ以外の場合は、1970年1月から解析された 月 までの月数を返します。

数値を文字列に変換するアルゴリズム は次の通りです: 数値 input が与えられたとき、1970年1月から現在の input 月後に相当する 有効な月の文字列 を返します。

文字列を Date オブジェクトに変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 月を解析する とエラーになる場合はエラーを返します。それ以外の場合は、解析された 月 の最初の日の午前零時 UTC を表す新しい Date オブジェクト を返します。

Date オブジェクトを文字列に変換するアルゴリズム は次の通りです: Date オブジェクト input が与えられたとき、UTC タイムゾーンで input に相当する時刻の 月 を表す 有効な月の文字列 を返します。

次の一般的な input 要素のコンテンツ属性、IDL 属性、およびメソッドは、要素に 適用されます: autocomplete, list, max, min, readonly, required, step コンテンツ属性; list, value, valueAsDate, valueAsNumber IDL 属性; select(), stepDown(), stepUp() メソッド。

value IDL 属性は、モード value にあります。

次の input および change イベントが 適用されます。

次のコンテンツ属性は指定されてはならず、要素に 適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src、 width。

次の IDL 属性およびメソッドは要素に 適用されません: checked, files, selectionStart, selectionEnd, selectionDirection IDL 属性; setRangeText(), setSelectionRange() メソッド。

4.10.5.1.9 週 状態 (type=week)

要素/input/week

FirefoxサポートなしSafariサポートなしChrome20+
Opera11+Edge79+
Edge (レガシー)12+Internet Explorerサポートなし
Firefox Android18+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素の type 属性が 週 状態にある場合、このセクションのルールが適用されます。

input 要素は、要素の 値 を特定の 週 を表す文字列に設定するためのコントロールを表します。

要素が 可変 である場合、ユーザーエージェントは、ユーザーがその 週 を変更できるようにする必要があります。ユーザーエージェントは、 有効な週の文字列 ではない非空の文字列を 値 に設定することを許可してはいけません。ユーザーエージェントがユーザーが 週 を選択するためのインターフェースを提供する場合、その 値 は、ユーザーの選択を表す 有効な週の文字列 に設定されなければなりません。ユーザーエージェントは、ユーザーが 値 を空の文字列に設定できるようにする必要があります。

制約の検証: ユーザーインターフェースが、ユーザーエージェントが 有効な週の文字列 に変換できない入力を記述している間、コントロールは 不正な入力 によって影響を受けています。

日付、時間、および数値フォームコントロールの入力形式と送信形式の違いについての議論や、フォームコントロールのローカライズに関する 導入セクション と 実装ノート を参照してください。

value 属性が指定されていて、かつ空でない場合、その値は 有効な週の文字列 でなければなりません。

値のサニタイズアルゴリズム は次の通りです: 要素の 値 が 有効な週の文字列 でない場合、それを空の文字列に設定します。

min 属性が指定されている場合、その値は 有効な週の文字列 でなければなりません。 max 属性が指定されている場合、その値は 有効な週の文字列 でなければなりません。

step 属性は週単位で表されます。 ステップスケールファクター は 604,800,000 であり（他のアルゴリズムで使用されるミリ秒に週を変換します）。 デフォルトステップ は 1 週間です。 デフォルトステップベース は −259,200,000 です（1970-W01 の週の開始）。

要素が ステップの不一致 によって影響を受けている場合、ユーザーエージェントは要素の 値 を最も近い 週 に丸めることができます。

文字列を数値に変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 週を解析する とエラーになる場合はエラーを返します。それ以外の場合は、1970-01-01 の朝の UTC の午前零時（値 "1970-01-01T00:00:00.0Z" で表される時刻）から解析された週の月曜日の午前零時 UTC までのミリ秒数を返します。うるう秒は無視します。

数値を文字列に変換するアルゴリズム は次の通りです: 数値 input が与えられたとき、1970-01-01 の朝の UTC の午前零時（値 "1970-01-01T00:00:00.0Z" で表される時刻）から現在の input ミリ秒後に UTC での時刻に相当する 有効な週の文字列 を返します。

文字列を Date オブジェクトに変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 週を解析する とエラーになる場合はエラーを返します。それ以外の場合は、解析された週の月曜日の午前零時 UTC を表す新しい Date オブジェクト を返します。

Date オブジェクトを文字列に変換するアルゴリズム は次の通りです: Date オブジェクト input が与えられたとき、UTC タイムゾーンで input に相当する時刻の 週 を表す 有効な週の文字列 を返します。

次の一般的な input 要素のコンテンツ属性、IDL 属性、およびメソッドは、要素に 適用されます: autocomplete, list, max, min, readonly, required, step コンテンツ属性; list, value, valueAsDate, valueAsNumber IDL 属性; select(), stepDown(), stepUp() メソッド。

value IDL 属性は、モード value にあります。

次の input および change イベントが 適用されます。

次のコンテンツ属性は指定されてはならず、要素に 適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src、 width。

次の IDL 属性およびメソッドは要素に 適用されません: checked, files, selectionStart, selectionEnd, selectionDirection IDL 属性; setRangeText(), setSelectionRange() メソッド。

4.10.5.1.10 時間 状態 (type=time)

要素/input/time

すべての最新エンジンでサポートされています。

Firefox57+Safari14.1+Chrome20+
Opera10+Edge79+
Edge (レガシー)12+Internet Explorerサポートなし
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

input 要素の type 属性が 時間 状態にある場合、このセクションのルールが適用されます。

input 要素は、要素の 値 を特定の 時間 を表す文字列に設定するためのコントロールを表します。

要素が 可変 である場合、ユーザーエージェントは、ユーザーがその 時間 を変更できるようにする必要があります。ユーザーエージェントは、 有効な時間の文字列 ではない非空の文字列を 値 に設定することを許可してはいけません。ユーザーエージェントがユーザーが 時間 を選択するためのインターフェースを提供する場合、その 値 は、ユーザーの選択を表す 有効な時間の文字列 に設定されなければなりません。ユーザーエージェントは、ユーザーが 値 を空の文字列に設定できるようにする必要があります。

制約の検証: ユーザーインターフェースが、ユーザーエージェントが 有効な時間の文字列 に変換できない入力を記述している間、コントロールは 不正な入力 によって影響を受けています。

日付、時間、および数値フォームコントロールの入力形式と送信形式の違いについての議論や、フォームコントロールのローカライズに関する 導入セクション と 実装ノート を参照してください。

value 属性が指定されていて、かつ空でない場合、その値は 有効な時間の文字列 でなければなりません。

値のサニタイズアルゴリズム は次の通りです: 要素の 値 が 有効な時間の文字列 でない場合、それを空の文字列に設定します。

フォームコントロールには 周期的なドメインがあります。

min 属性が指定されている場合、その値は 有効な時間の文字列 でなければなりません。 max 属性が指定されている場合、その値は 有効な時間の文字列 でなければなりません。

step 属性は秒単位で表されます。 ステップスケールファクター は 1000 であり（他のアルゴリズムで使用されるミリ秒に秒を変換します）。 デフォルトステップ は 60 秒です。

要素が ステップの不一致 によって影響を受けている場合、ユーザーエージェントは要素の 値 を最も近い 時間 に丸めることができます。

文字列を数値に変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 時間を解析する とエラーになる場合はエラーを返します。それ以外の場合は、午前零時から解析された 時間 までのミリ秒数を返します。

数値を文字列に変換するアルゴリズム は次の通りです: 数値 input が与えられたとき、午前零時から現在の input ミリ秒後の 時間 に相当する 有効な時間の文字列 を返します。

文字列を Date オブジェクトに変換するアルゴリズム は次の通りです: 文字列 input が与えられたとき、 時間を解析する とエラーになる場合はエラーを返します。それ以外の場合は、1970-01-01 の UTC で解析された 時間 を表す新しい Date オブジェクト を返します。

Date オブジェクトを文字列に変換するアルゴリズム は次の通りです: Date オブジェクト input が与えられたとき、UTC タイムゾーンで input に相当する時刻の 時間 を表す 有効な時間の文字列 を返します。

次の一般的な input 要素のコンテンツ属性、IDL 属性、およびメソッドは、要素に 適用されます: autocomplete, list, max, min, readonly, required, step コンテンツ属性; list, value, valueAsDate, valueAsNumber IDL 属性; select(), stepDown(), stepUp() メソッド。

value IDL 属性は、モード value にあります。

次の input および change イベントが 適用されます。

次のコンテンツ属性は指定されてはならず、要素に 適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src、 width。

次の IDL 属性およびメソッドは要素に 適用されません: checked, files, selectionStart, selectionEnd, selectionDirection IDL 属性; setRangeText(), setSelectionRange() メソッド。

4.10.5.1.11 ローカル日時 状態 (type=datetime-local)

要素/input/datetime-local

すべての最新エンジンでサポートされています。

Firefox93+Safari14.1+Chrome20+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer非対応
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

input 要素のtype 属性がローカル日時状態の場合、このセクションのルールが適用されます。

input 要素は、要素の値を設定するためのコントロールを表し、ローカル日時を表す文字列であり、タイムゾーンのオフセット情報は含まれません。

要素が変更可能である場合、ユーザーエージェントはユーザーがその要素の日時を変更できるようにする必要があります。また、ユーザーエージェントは、ユーザーが有効な正規化されたローカル日時の文字列でない非空の文字列に値を設定できないようにしなければなりません。ユーザーエージェントがローカル日時を選択するためのユーザーインターフェースを提供する場合、値は、ユーザーの選択を表す有効な正規化されたローカル日時の文字列に設定されなければなりません。ユーザーが値を空の文字列に設定できるようにするべきです。

制約の検証: ユーザーインターフェースがユーザーエージェントが有効な正規化されたローカル日時の文字列に変換できない入力を示している場合、そのコントロールは不正な入力が行われている状態です。

日付、時刻、および数値の形式の入力形式と送信形式の違いについては、導入セクションおよびフォームコントロールのローカライズに関する実装メモを参照してください。

値 属性が指定され、かつ空でない場合、その値は有効なローカル日時の文字列でなければなりません。

値のサニタイズアルゴリズムは次の通りです: 要素の値が有効なローカル日時の文字列である場合、それを同じ日時を表す有効な正規化されたローカル日時の文字列に設定します。そうでない場合、空の文字列に設定します。

min 属性が指定されている場合、その値は有効なローカル日時の文字列でなければなりません。max 属性が指定されている場合、その値は有効なローカル日時の文字列でなければなりません。

step 属性は秒単位で表現されます。ステップスケールファクターは1000です (他のアルゴリズムで使用されるミリ秒に変換します)。デフォルトステップは60秒です。

要素がステップの不一致に苦しんでいる場合、ユーザーエージェントは要素の値を、その要素がステップの不一致に苦しまない最も近いローカル日時に丸めることができます。

文字列を数値に変換するアルゴリズムは次の通りです: 文字列inputを指定して、日時の解析がエラーとなる場合、エラーを返します。それ以外の場合は、1970-01-01の午前0時（値「1970-01-01T00:00:00.0」で表される時刻）から解析されたローカル日時まで経過したミリ秒数を返します。うるう秒は無視します。

数値を文字列に変換するアルゴリズムは次の通りです: 数値inputを指定して、1970-01-01の午前0時（値「1970-01-01T00:00:00.0」で表される時刻）のinputミリ秒後の日時を表す有効な正規化されたローカル日時の文字列を返します。

歴史的な日付に関する注記は、日付状態セクションにあります。

次の共通のinput要素のコンテンツ属性、IDL属性、およびメソッドが要素に適用されます: autocomplete, list, max, min, readonly, required, および step コンテンツ属性; list, value, および valueAsNumber IDL属性; select(), stepDown(), および stepUp() メソッド。

value IDL属性はvalueモードで動作します。

input およびchange イベントが適用されます。

次のコンテンツ属性は指定してはならず、要素に適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src, および width。

次のIDL属性およびメソッドは要素に適用されません: checked, files, selectionStart, selectionEnd, selectionDirection, および valueAsDate IDL属性; setRangeText(), および setSelectionRange() メソッド。

次の例は、フライト予約アプリケーションの一部を示しています。このアプリケーションでは、input 要素にそのtype 属性をdatetime-localに設定し、選択した空港のタイムゾーンで指定された日時を解釈します。 

<fieldset>
  <legend>目的地</legend>
  <p><label>空港: <input type=text name=to list=airports></label></p>
  <p><label>出発時刻: <input type=datetime-local name=totime step=3600></label></p>
 </fieldset>
 <datalist id=airports>
  <option value=ATL label="アトランタ">
  <option value=MEM label="メンフィス">
  <option value=LHR label="ロンドン・ヒースロー">
  <option value=LAX label="ロサンゼルス">
  <option value=FRA label="フランクフルト">
 </datalist>
4.10.5.1.12 数値 状態 (type=number)

要素/input/number

すべての最新エンジンでサポートされています。

Firefox29+Safari5.1+Chrome7+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input 要素のtype 属性が数値 状態の場合、このセクションのルールが適用されます。

input 要素は、その要素の値を数値を表す文字列に設定するためのコントロールを表します。

要素が変更可能である場合、ユーザーエージェントはユーザーがその要素の値で表される数値を変更できるようにすべきです。その数値は浮動小数点数の値を解析するルールを適用して取得されます。ユーザーエージェントは、値を有効な浮動小数点数ではない非空の文字列に設定することを許可してはなりません。ユーザーエージェントが数値を選択するためのユーザーインターフェースを提供する場合、値は、ユーザーの選択を表す浮動小数点数の最適な表現に設定されなければなりません。ユーザーが値を空の文字列に設定できるようにすべきです。

制約の検証: ユーザーインターフェースがユーザーエージェントが有効な浮動小数点数に変換できない入力を示している場合、そのコントロールは不正な入力が行われている状態です。

この仕様書では、ユーザーエージェントが使用するユーザーインターフェースを定義していません。ユーザーエージェントベンダーは、自社のユーザーのニーズに最も適した方法を考慮することをお勧めします。例えば、ペルシャ語やアラビア語市場のユーザーエージェントでは、ペルシャ語やアラビア語の数値入力に対応し（上記のように変換して送信形式に適合させます）、ローマ人向けのユーザーエージェントでは、値をローマ数字で表示する（または、より現実的には、フランス市場向けのユーザーエージェントでは、千単位のアポストロフィと小数点の前にコンマを使用して値を表示し、その方法で値を入力させることができ、内部的には上記の送信形式に変換します）などが考えられます。

値 属性が指定されており、かつ空でない場合、その値は有効な浮動小数点数でなければなりません。

値のサニタイズアルゴリズムは次の通りです: 要素の値が有効な浮動小数点数ではない場合、それを空の文字列に設定します。

min 属性が指定されている場合、その値は有効な浮動小数点数でなければなりません。max属性が指定されている場合、その値は有効な浮動小数点数でなければなりません。

ステップスケールファクターは1です。デフォルトステップは1です（ユーザーが整数のみを選択できるようにします。ただし、ステップベースに非整数値がある場合は除きます）。

要素がステップの不一致に苦しんでいる場合、ユーザーエージェントは要素の値を、その要素がステップの不一致に苦しまない最も近い数値に丸めることができます。そのような数値が2つある場合、ユーザーエージェントは無限大に最も近い方を選ぶことが推奨されます。

文字列を数値に変換するアルゴリズムは次の通りです: 文字列inputを指定して、浮動小数点数の値を解析するルールをinputに適用するとエラーが発生した場合、エラーを返します。それ以外の場合は、得られた数値を返します。

数値を文字列に変換するアルゴリズムは次の通りです: 数値inputを指定して、inputを表す有効な浮動小数点数を返します。

次の共通のinput 要素のコンテンツ属性、IDL属性、およびメソッドが要素に適用されます: autocomplete, list, max, min, placeholder, readonly, required, および step コンテンツ属性; list, value、 および valueAsNumber IDL属性; select(), stepDown()、 および stepUp() メソッド。

value IDL属性はvalueモードで動作します。

input およびchange イベントが適用されます。

次のコンテンツ属性は指定してはならず、要素に適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, popovertarget, popovertargetaction, size, src、 および width。

次のIDL属性およびメソッドは要素に適用されません: checked, files, selectionStart, selectionEnd, selectionDirection, および valueAsDate IDL属性; setRangeText()、 および setSelectionRange() メソッド。

次に、数値入力コントロールの使用例を示します:

<label>いくら請求しますか? $<input type=number min=0 step=0.01 name=price></label>

上記のように、ユーザーエージェントはユーザーのローカル形式での数値入力をサポートし、それを上記で説明した形式に変換して送信することができます。これには、グループ区切り文字（「872,000,000,000」のように）やさまざまな小数点区切り文字（「3,99」と「3.99」など）の処理、あるいはアラビア語、デーヴァナーガリー文字、ペルシャ語、タイ語などのローカル数字を使用することが含まれる場合があります。

type=number 状態は、入力内容がたまたま数値のみで構成されているが、厳密には数値ではない場合には適切ではありません。例えば、クレジットカード番号やアメリカの郵便番号には適していません。type=numberを使用するかどうかを判断する簡単な方法は、入力コントロールにスピンボックスインターフェース（例えば、"up"および"down"の矢印）があるのが理にかなっているかどうかを考えることです。クレジットカード番号の最後の桁を1つ間違えることは、わずかな間違いではなく、すべての桁が間違っているのと同じくらい不適切です。したがって、ユーザーが"up"および"down"のボタンを使用してクレジットカード番号を選択するのは理にかなっていません。スピンボックスインターフェースが適切でない場合は、type=textが適切な選択である可能性があります（inputmodeまたはpattern属性を使用することを検討してください）。

4.10.5.1.13 範囲 状態 (type=range)

要素/input/range

すべての最新エンジンでサポートされています。

Firefox23+Safari3.1+Chrome4+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android52+Safari iOS5+Chrome Android57+WebView Android4.4+Samsung Internet?Opera Android11+

input 要素のtype 属性が範囲 状態の場合、このセクションのルールが適用されます。

input 要素は、その要素の値を数値を表す文字列に設定するためのコントロールを表します。ただし、正確な値は重要ではなく、数値状態よりも簡単なインターフェースをユーザーエージェントに提供できます。

要素が変更可能である場合、ユーザーエージェントはユーザーがその要素の値で表される数値を変更できるようにすべきです。その数値は浮動小数点数の値を解析するルールを適用して取得されます。ユーザーエージェントは、値を有効な浮動小数点数でない文字列に設定することを許可してはなりません。ユーザーエージェントが数値を選択するためのユーザーインターフェースを提供する場合、値は、ユーザーの選択を表す浮動小数点数の最適な表現に設定されなければなりません。ユーザーエージェントは、値を空の文字列に設定することを許可してはなりません。

制約の検証: ユーザーインターフェースがユーザーエージェントが有効な浮動小数点数に変換できない入力を示している場合、そのコントロールは不正な入力が行われている状態です。

値 属性が指定されており、かつ空でない場合、その値は有効な浮動小数点数でなければなりません。

値のサニタイズアルゴリズムは次の通りです: 要素の値が有効な浮動小数点数ではない場合、浮動小数点数としての最適な表現に設定します。それはデフォルト値です。

デフォルト値は、最小値と最大値の差の半分を足したものです。ただし、最大値が最小値よりも小さい場合、デフォルト値は最小値になります。

要素が下限に達している場合、ユーザーエージェントは要素の値を浮動小数点数としての最適な表現である最小値に設定しなければなりません。

要素が上限に達している場合、最大値が最小値よりも小さくない限り、ユーザーエージェントは要素の値を有効な浮動小数点数として設定しなければなりません。それは最大値です。

要素がステップの不一致に苦しんでいる場合、ユーザーエージェントは要素の値をその要素がステップの不一致に苦しまない最も近い数値に丸め、その数値は最小値以上であり、最大値が最小値よりも小さくない限り、最大値以下であることが条件です。この条件に合致する数値が2つある場合、ユーザーエージェントは正の無限大に最も近い数値を使用しなければなりません。

例えば、次のマークアップ<input type="range" min=0 max=100 step=20 value=50>は、初期値が60の範囲コントロールを生成します。

次に、list属性を使用した自動補完リストを持つ範囲コントロールの例を示します。これは、コントロールの全範囲に沿って特に重要な値が存在する場合に役立つことがあります。例えば、事前設定された照明レベルや速度制御に使用される範囲コントロール内の典型的な速度制限などです。次のマークアップフラグメントでは: 

<input type="range" min="-100" max="100" value="0" step="10" name="power" list="powers">
 <datalist id="powers">
 <option value="0">
 <option value="-30">
 <option value="30">
  <option value="++50">
 </datalist>

...次のスタイルシートを適用した場合:

input { writing-mode: vertical-lr; height: 75px; width: 49px; background: #D5CCBB; color: black; }

...次のように表示される場合があります:

ベージュの背景に黒の縦型スライダーコントロール。スライダーには5つの目盛りがあり、両端に1つずつ、中央付近に3つの短い目盛りが配置されています。

ユーザーエージェントがスタイルシートで指定された高さと幅の比率からコントロールの向きを決定した点に注目してください。色も同様にスタイルシートから導出されました。ただし、目盛りはマークアップから導出されました。特に、step属性は目盛りの配置には影響を与えておらず、ユーザーエージェントは著者が指定した完了値のみを使用し、極端な位置に長い目盛りを追加することを決定しました。

無効な値++50が無視されたことにも注目してください。

別の例として、次のマークアップフラグメントを考えてみましょう:

<input name=x type=range min=100 max=700 step=9.09090909 value=509.090909>

ユーザーエージェントは、例えば次のようにさまざまな方法で表示できます:

ダイヤルとして表示。

または、次のように表示できます:

目盛り付きの長い水平スライダーとして表示。

ユーザーエージェントは、スタイルシートに指定された寸法に基づいて表示するものを選択できます。これにより、幅の違いにもかかわらず、目盛りの解像度を維持することができます。

最後に、2つのラベル付き値を持つ範囲コントロールの例を示します:

<input type="range" name="a" list="a-values">
 <datalist id="a-values">
 <option value="10" label="Low">
 <option value="90" label="High">
 </datalist>

コントロールが垂直に描画されるようにスタイルを適用すると、次のように表示される場合があります:

2つの目盛りが付いた縦型スライダーコントロール。上部付近に「High」、下部付近に「Low」とラベル付けされた目盛りがあります。

この状態では、範囲とステップの制約がユーザー入力中にも強制され、値を空の文字列に設定する方法はありません。

min属性が指定されている場合、その値は有効な浮動小数点数でなければなりません。デフォルトの最小値は0です。max属性が指定されている場合、その値は有効な浮動小数点数でなければなりません。デフォルトの最大値 は100です。

ステップスケールファクターは1です。デフォルトステップは1です（min 属性に非整数値がある場合を除き、整数のみが許可されます）。

文字列を数値に変換するアルゴリズムは次の通りです: 文字列inputを指定して、浮動小数点数の値を解析するルールをinputに適用するとエラーが発生した場合、エラーを返します。それ以外の場合は、得られた数値を返します。

数値を文字列に変換するアルゴリズムは次の通りです: 数値inputを指定して、inputを表す浮動小数点数としての最適な表現を返します。

次の共通のinput 要素のコンテンツ属性、IDL属性、およびメソッドが要素に適用されます: autocomplete, list, max, min、 および step コンテンツ属性; list、 value、 および valueAsNumber IDL属性; stepDown() および stepUp() メソッド。

value IDL属性はvalueモードで動作します。

input およびchange イベントが適用されます。

次のコンテンツ属性は指定してはならず、要素に適用されません: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength、 minlength、 multiple、 pattern、 placeholder、 popovertarget、 popovertargetaction、 readonly、 required、 size、 src、 および width。

次のIDL属性およびメソッドは要素に適用されません: checked、 files、 selectionStart、 selectionEnd、 selectionDirection、 および valueAsDate IDL属性; setRangeText()、 および setSelectionRange() メソッド。

4.10.5.1.14 カラー 状態 (type=color)

Element/input/color

すべての現行エンジンでサポートされています。

Firefox29+Safari12.1+Chrome20+
Opera12+Edge79+
Edge (レガシー)14+Internet Explorerサポートなし
Firefox Android🔰 27+Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android12+

要素の input 属性の type が カラー 状態 の場合、このセクションのルールが適用されます。

input要素は、要素の値をCSSカラーのシリアル化を表す文字列に設定するためのカラーウェルコントロールを表します。

この状態では、常にCSSカラーが選択されており、エンドユーザーが値を空文字列に設定する方法はありません。

alpha属性はブール属性です。存在する場合、CSSカラーのアルファ成分をエンドユーザーが操作でき、完全に不透明である必要がないことを示します。

colorspace属性は、シリアル化されたCSSカラーの色空間を示します。また、CSSカラーを選択するための望ましいユーザーインターフェイスも示唆します。これは、次のキーワードと状態を持つ列挙属性です。

キーワード 状態 簡単な説明
limited-srgb 限定sRGB CSSカラーは'srgb'色空間に変換され、コンポーネントあたり8ビットに制限されます。例：「#123456」または「color(srgb 0 1 0 )」。
display-p3 Display P3 CSSカラーは'display-p3'色空間に変換されます。例：「color(display-p3 1.84 -0.19 0.72 )」。

属性の欠損値のデフォルトと無効値のデフォルトは、どちらも限定sRGB状態です。

要素のalpha属性またはcolorspace属性が変更されるたびに、ユーザーエージェントは要素を指定してカラーウェルコントロールカラーを更新しなければなりません。

要素が変更可能である場合、ユーザーエージェントは、解析して得られた値によって表される色をユーザーが変更できるようにすべきです。ユーザーエージェントは、要素に対してカラーウェルコントロールカラーを更新しても設定されない文字列に値をユーザーが設定できないようにしなければなりません。ユーザーエージェントがCSSカラーを選択するためのユーザーインターフェイスを提供する場合、値は、要素とエンドユーザーの選択を指定してカラーウェルコントロールカラーをシリアル化する結果に設定されなければなりません。

このような要素elementの入力アクティベーション動作は、elementに対して該当する場合、ピッカーを表示することです。

制約検証：要素の値が空文字列ではなく、それを解析した結果が失敗を返す場合、コントロールは不正な入力に該当します。

value属性は、指定されていて空文字列でない場合、CSSカラーである値を持たなければなりません。

値のサニタイズアルゴリズムは次のとおりです：要素に対してカラーウェルコントロールカラーを更新します。

要素elementを指定して、カラーウェルコントロールカラーを更新するには：

  1. 表明：elementは、type属性がカラー状態にあるinput要素です。

  2. colorを、elementの値を解析した結果とします。

  3. colorが失敗の場合、colorを不透明な黒に設定します。

  4. elementとcolorを指定してカラーウェルコントロールカラーをシリアル化する結果に、elementの値を設定します。

要素elementとCSSカラーcolorを指定して、カラーウェルコントロールカラーをシリアル化するには：

  1. 表明：elementは、type属性がカラー状態にあるinput要素です。

  2. htmlCompatibleをfalseとします。

  3. elementのalpha属性が指定されていない場合、colorのアルファ成分を完全に不透明に設定します。

  4. elementのcolorspace属性が限定sRGB状態の場合：

    1. colorを、'srgb'色空間に変換されたcolorに設定します。

    2. colorの各成分を、0から255の範囲（両端を含む）になるように丸めます。成分は+∞方向に丸められます。

    3. elementのalpha属性が指定されていない場合、htmlCompatibleをtrueに設定します。

      これは、カラーウェルコントロールの以前のバージョンとの互換性のために、意図的に異なるシリアル化パスを使用します。

    4. それ以外の場合、colorを'color()'関数を使用して変換されたcolorに設定します。

  5. それ以外の場合：

    1. 表明：elementのcolorspace属性はDisplay P3状態です。

    2. colorを、'display-p3'色空間に変換されたcolorに設定します。

  6. colorをシリアル化する結果を返します。htmlCompatibleがtrueの場合、HTML互換シリアル化が要求された状態でそうします。

以下の共通のinput要素のコンテンツ属性とIDL属性が要素に適用されます： alpha、 autocomplete、 colorspace、 および listコンテンツ属性。 listおよび value IDL属性。 select()メソッド。

value IDL 属性は 値 モードで動作します。

input および change イベントが 適用されます。

次のコンテンツ属性は指定されるべきではなく、 適用されません： accept、 alt、 checked、 dirname、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 height、 max、 maxlength、 min、 minlength、 multiple、 pattern、 placeholder、 popovertarget、 popovertargetaction、 readonly、 required、 size、 src、 step、 width。

次の IDL 属性およびメソッドは要素に 適用されません： checked、 files、 selectionStart、 selectionEnd、 selectionDirection、 valueAsDate および、 valueAsNumber IDL 属性； setRangeText()、 setSelectionRange()、 stepDown()、 および stepUp() メソッド。

4.10.5.1.15 チェックボックスの状態 (type=checkbox)

Element/input/checkbox

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input要素のtype属性がチェックボックスの状態にある場合、このセクションのルールが適用されます。

input要素は、要素のチェック状態を表す2つの状態の制御を表します。要素のチェック状態がtrueである場合、制御は肯定的な選択を表し、falseである場合は否定的な選択を表します。要素の不確定IDL属性がtrueに設定されている場合、制御の選択は、第3の不確定な状態にあるかのように隠されるべきです。

要素の不確定IDL属性がtrueに設定されている場合でも、制御は決して真の三状態制御にはなりません。不確定IDL属性は、単に第3の状態のように見せるだけです。

inputアクティベーション動作は、以下の手順を実行することです:

  1. 要素が接続されていない場合、戻ります。

  2. イベントを発火し、inputという名前のイベントを、バブルおよび構成属性をtrueに初期化した状態で要素に対して発火します。

  3. イベントを発火し、changeという名前のイベントを、バブル属性をtrueに初期化した状態で要素に対して発火します。

制約検証: 要素が必須であり、そのチェック状態がfalseである場合、要素は欠落しています。

input.indeterminate [ = value ]

設定されると、現在の値が表示されないようにチェックボックスコントロールのレンダリングをオーバーライドします。

次の共通input要素のコンテンツ属性とIDL属性が要素に適用されます: checked, requiredコンテンツ属性、 checkedおよび valueIDL属性。

valueIDL属性は、デフォルト/オンモードです。

inputおよびchangeイベントが適用されます。

次のコンテンツ属性は指定されてはならず、適用されません: accept, alpha, alt, autocomplete, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, size, src, step, width。

次のIDL属性とメソッドは、要素には適用されません: files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, valueAsNumberIDL属性、 select(), setRangeText(), setSelectionRange(), stepDown(), stepUp()メソッド。

4.10.5.1.16 ラジオボタンの状態 (type=radio)

Element/input/radio

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (旧版)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input要素のtype属性がラジオボタンの状態にある場合、このセクションのルールが適用されます。

input要素は、他のinput要素と組み合わせて使用される場合、一つのコントロールだけがチェック状態をtrueにできるラジオボタングループを形成します。要素のチェック状態がtrueである場合、グループ内で選択されたコントロールを表し、falseである場合は選択されていないコントロールを示します。

ラジオボタングループに含まれるinput要素aには、次のすべての条件を満たす他のinput要素bも含まれます:

ツリーには、ラジオボタングループにその要素だけを含むinput要素を含めてはなりません。

次の現象のいずれかが発生した場合、その発生後に要素のチェック状態がtrueである場合、同じラジオボタングループ内の他のすべての要素のチェック状態をfalseに設定する必要があります:

inputアクティベーション動作は、次の手順を実行することです:

  1. 要素が接続されていない場合、戻ります。

  2. イベントを発火し、inputという名前のイベントを、バブルおよび構成属性をtrueに初期化した状態で要素に対して発火します。

  3. イベントを発火し、changeという名前のイベントを、バブル属性をtrueに初期化した状態で要素に対して発火します。

制約検証: ラジオボタングループ内の要素が必須であり、ラジオボタングループ内のすべてのinput要素のチェック状態がfalseである場合、その要素は欠落しています。

次の例では、何らかの理由で、プッパーが必須であり無効であることが指定されています:

<form>
  <p><label><input type="radio" name="dog-type" value="pupper" required disabled> Pupper</label>
  <p><label><input type="radio" name="dog-type" value="doggo"> Doggo</label>
  <p><button>Make your choice</button>
 </form>

ユーザーがこのフォームを「Doggo」を選択せずに送信しようとすると、input要素の両方が欠落していますとなります。これは、ラジオボタングループ内の要素が必須（最初の要素）、かつラジオボタングループ内のすべての要素がfalseのチェック状態を持つためです。

一方、ユーザーが「Doggo」を選択してフォームを送信した場合、input要素のいずれも欠落していないとなります。これは、それらのいずれかが必須でありながら、すべての要素がfalseのチェック状態を持っていないためです。

ラジオボタングループ内のラジオボタンのいずれもチェックされていない場合、インターフェースでは最初はすべて未チェックのままになりますが、いずれかがチェックされるまで（ユーザーによってまたはスクリプトによって）未チェックのままとなります。

次の共通input要素のコンテンツ属性とIDL属性が要素に適用されます: checkedおよび requiredコンテンツ属性、 checkedおよび valueIDL属性。

valueIDL属性は、デフォルト/オンモードです。

inputおよびchangeイベントが適用されます。

次のコンテンツ属性は指定されてはならず、適用されません: accept, alpha, alt, autocomplete, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, size, src, step, width。

次のIDL属性とメソッドは、要素には適用されません: files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, valueAsNumberIDL属性、 select(), setRangeText(), setSelectionRange(), stepDown(), stepUp()メソッド。

4.10.5.1.17 ファイルアップロードの状態 (type=file)

Element/input/file

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera11+Edge79+
Edge (旧版)12+Internet ExplorerYes
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

input要素のtype属性がファイルアップロードの状態にある場合、このセクションのルールが適用されます。

input要素は、ファイル名、ファイルタイプ、ファイルボディ（ファイルの内容）で構成される選択されたファイルのリストを表します。

ユーザーがディレクトリ階層全体や異なるディレクトリから同じ名前の複数のファイルを選択した場合でも、ファイル名にはパスコンポーネントを含めてはなりません。ファイルアップロードの状態におけるパスコンポーネントとは、ファイル名の部分で、U+005C REVERSE SOLIDUS 文字（\）で区切られた部分を指します。

multiple属性が設定されていない限り、選択されたファイルのリストには1つのファイルしか含めてはなりません。

このような要素elementのinputアクティベーション動作は、elementに対してピッカーを表示することです（該当する場合）。

要素が変更可能である場合、ユーザーエージェントはユーザーがドラッグアンドドロップなどの他の方法でもファイルを変更できるようにするべきです。ユーザーがそうした場合、ユーザーエージェントは要素のファイル選択を更新する必要があります。

要素が変更可能でない場合、ユーザーエージェントはユーザーが要素の選択を変更することを許可してはなりません。

要素elementのファイル選択を更新するには:

  1. 要素タスクをキューに追加する elementに対して、次のステップでユーザーインタラクションタスクソースを与える:

    1. ユーザーの選択を反映するように、elementの選択されたファイルを更新します。

    2. イベントを発火し、inputという名前のイベントを、バブルおよび構成属性をtrueに初期化した状態で要素に対して発火します。

    3. イベントを発火し、changeという名前のイベントを、バブル属性をtrueに初期化した状態で要素に対して発火します。

制約検証: 要素が必須であり、選択されたファイルのリストが空である場合、その要素は欠落しています。

Attributes/accept

すべての現在のエンジンでサポートされています。

Firefox1+Safari11.1+Chrome26+
Opera15+Edge79+
Edge (旧版)12+Internet Explorer10+
Firefox Android37+Safari iOS11.3+Chrome Android26+WebView Android4.4+Samsung Internet1.5+Opera Android15+

Element/input#attr-accept

すべての現在のエンジンでサポートされています。

Firefox37+Safari11.1+Chrome26+
Opera15+Edge79+
Edge (旧版)12+Internet Explorer10+
Firefox Android37+Safari iOS11.3+Chrome Android26+WebView Android4.4+Samsung Internet1.5+Opera Android15+

accept属性を指定して、ユーザーエージェントにどのファイルタイプを受け入れるかのヒントを提供することができます。

指定された場合、属性はカンマ区切りのトークンセットで構成される必要があります。各トークンは次のいずれかに対してASCII大文字小文字を区別しない一致である必要があります:

文字列"audio/*"
サウンドファイルが許可されます。
文字列"video/*"
ビデオファイルが許可されます。
文字列"image/*"
画像ファイルが許可されます。
パラメーターなしの有効なMIMEタイプ文字列
指定されたタイプのファイルが許可されます。
最初の文字がU+002E FULL STOP文字(.)である文字列
指定されたファイル拡張子のファイルが許可されます。

トークンは他のトークンに対してASCII大文字小文字を区別しない一致であってはなりません（すなわち、重複は許可されません）。ユーザーエージェントが属性からトークンのリストを取得するためには、属性値をカンマで分割する必要があります。

ユーザーエージェントは、この属性の値を使用して、より適切なユーザーインターフェースを表示することができます。たとえば、値image/*が指定されている場合、ユーザーエージェントはユーザーにローカルカメラを使用するか、写真コレクションから写真を選択するオプションを提供できます。値audio/*が指定されている場合、ユーザーエージェントはヘッドセットマイクを使用してクリップを録音するオプションを提供できます。

ユーザーエージェントは、これらのトークンの1つ（または複数）によって受け入れられないファイルをユーザーが選択することを防止するべきです。

著者は、特定のフォーマットのデータを探す際には、MIMEタイプと対応する拡張子の両方を指定することを推奨します。

たとえば、Microsoft WordドキュメントをOpen Document Formatファイルに変換するアプリケーションを考えてみましょう。Microsoft WordドキュメントはさまざまなMIMEタイプと拡張子で説明されるため、サイトはいくつかを次のようにリストすることができます:

<input type="file" accept=".doc,.docx,.xml,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document">

ファイルタイプをファイル拡張子でしか説明しないプラットフォームでは、ここにリストされた拡張子を使用して許可されたドキュメントをフィルタリングすることができます。一方、MIMEタイプを内部的に使用するシステムでは、MIMEタイプを使用して許可されたファイルを選択できます。拡張子は、システムで使用されるMIMEタイプに対応する既知の拡張子をマップする拡張子登録テーブルがある場合に使用できます。

拡張子は曖昧であることが多い（例: ".dat"拡張子を使用する形式は無数に存在し、ユーザーは通常、自分のファイルを簡単に".doc"拡張子にリネームできますが、実際にはMicrosoft Wordドキュメントではない場合もあります）、またMIMEタイプは信頼性に欠けることが多い（例: 多くの形式には正式に登録されたタイプがなく、多くの形式は実際には異なるMIMEタイプでラベル付けされています）。著者は、クライアントから受信したデータは、クライアントが敵対的でなく、ユーザーエージェントがaccept属性の要件を完全に遵守していた場合でも、期待される形式ではないかもしれないことを認識する必要があります。

Element/input/file

歴史的な理由により、valueIDL属性は、ファイル名に"C:\fakepath\"という文字列を付加します。一部のレガシーユーザーエージェントは実際にフルパスを含めていました（これはセキュリティ脆弱性でした）。その結果、valueIDL属性からファイル名を後方互換性のある方法で取得することは簡単ではありません。次の関数は、互換性のある方法でファイル名を抽出します: 

function extractFilename(path) {
   if (path.substr(0, 12) == "C:\\fakepath\\")
     return path.substr(12); // modern browser
   var x;
   x = path.lastIndexOf('/');
   if (x >= 0) // Unix-based path
     return path.substr(x+1);
   x = path.lastIndexOf('\\');
   if (x >= 0) // Windows-based path
     return path.substr(x+1);
   return path; // just the filename
 }

これを次のように使用できます:

<p><input type=file name=image onchange="updateFilename(this.value)"></p>
<p>The name of the file you picked is: <span id="filename">(none)</span></p>
<script>
 function updateFilename(path) {
   var name = extractFilename(path);
   document.getElementById('filename').textContent = name;
 }
</script>

次の共通input要素のコンテンツ属性とIDL属性が要素に適用されます: accept、 multiple、 requiredコンテンツ属性; files、 valueIDL属性; select()メソッド。

valueIDL属性はファイル名モードにあります。

inputおよびchangeイベントが適用されます。

次のコンテンツ属性は指定されてはならず、適用されません: alpha, alt, autocomplete, checked, colorspace, dirname、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 height、 list、 max、 maxlength、 min、 minlength、 pattern、 popovertarget、 popovertargetaction、 placeholder、 readonly、 size、 src、 step、 width。

要素のvalue属性は省略しなければなりません。

次のIDL属性とメソッドは、要素には適用されません: checked、 list、 selectionStart、 selectionEnd、 selectionDirection、 valueAsDate、 valueAsNumberIDL属性; setRangeText()、 setSelectionRange()、 stepDown()、 stepUp()メソッド。

4.10.5.1.18 送信ボタン状態 (type=submit)

Element/input/submit

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

あるinput 要素のtype 属性が 送信ボタン状態にある場合、このセクションのルールが適用されます。

(これはトラッキングベクトルです。) input 要素は、アクティブ化されるとフォームを送信するボタンを表します。要素にvalue 属性がある場合、ボタンのラベルはその属性の値でなければなりません。そうでない場合、ラベルは「送信」などの意味を持つ実装定義の文字列でなければなりません。要素は ボタンであり、特に送信ボタンです。

デフォルトのラベルが実装定義であるため、通常ボタンの幅はそのラベルに依存するため、ボタンの幅は少数の指紋情報を漏洩する可能性があります。この情報は、ユーザーエージェントの識別やユーザーのロケールと強く相関している可能性が高いです。

要素のオプションの値は、要素のvalue属性の値です。存在しない場合は null です。

次のeventが発生した場合、要素の入力アクティベーション動作は以下の通りです:

  1. 要素にフォームオーナーがない場合は、リターンします。

  2. 要素のノードドキュメントが完全にアクティブでない場合は、リターンします。

  3. 要素のフォームを送信し、 フォームオーナーから要素をリターンし、ユーザー関与が eventのユーザー ナビゲーション 関与に設定されている場合。

formaction、 formenctype、 formmethod、 formnovalidate、 およびformtarget属性はフォーム送信のための属性です。

formnovalidate 属性は、制約検証をトリガーしない送信ボタンを作成するために使用できます。

次の共通input 要素のコンテンツ属性とIDL属性が要素に適用されます: dirname、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 popovertarget、 および popovertargetaction コンテンツ属性;value IDL 属性。

value IDL属性は、デフォルトモードです。

次のコンテンツ属性は指定されてはならず、要素に適用されません: accept, alpha, alt, autocomplete, checked, colorspace, height、 list、 max、 maxlength、 min、 minlength、 multiple、 pattern、 placeholder、 readonly、 required、 size、 src、 step、 width。

次のIDL属性とメソッドは、要素には適用されません: checked、 files、 list、 selectionStart、 selectionEnd、 selectionDirection、 valueAsDate、 および valueAsNumber IDL属性; select()、 setRangeText()、 setSelectionRange()、 stepDown()、 および stepUp() メソッド。

inputおよびchangeイベントが適用されません。

4.10.5.1.19 画像ボタン 状態 (type=image)

Element/input/image

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input要素の type 属性が画像ボタンの状態である場合、このセクションのルールが適用されます。

input 要素は、ユーザーが座標を選択してフォームを送信できる画像、またはユーザーがフォームを送信できるボタンを表します。この要素はボタンであり、特に送信ボタンです。

座標は、フォーム送信時にフォームデータセットを構築する際に、コントロールの名前から派生した2つのエントリを送信し、名前に".x"および".y"を追加し、座標のそれぞれのxおよびyコンポーネントが追加されます。

Element/input#src

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

画像はsrc属性によって指定されます。src 属性は存在しなければならず、空でなく、スペースで囲まれている可能性のある有効なURLを含まなければなりません。これにより、ページやスクリプトがない、インタラクティブでない、オプションでアニメーションされた画像リソースを参照します。

次のいずれかのイベントが発生したとき

ユーザーエージェントが画像をサポートできない場合、または画像のサポートが無効になっている場合、またはユーザーエージェントが画像をオンデマンドでのみ取得する場合、またはsrc属性の値が空文字列である場合を除き、次の手順を実行します：

  1. 要素のsrc属性の値を、要素のノードドキュメントに対してURLをエンコーディングパースした結果としてurlとします。

  2. urlが失敗の場合、戻ります。

  3. requestは、新しいリクエストであり、URLがurlで、クライアントが要素のノードドキュメントの関連設定オブジェクトであり、デスティネーションが"image"で、イニシエータータイプが"input"で、クレデンシャルモードが"include"であり、URLクレデンシャルフラグが設定されているものとします。

  4. Fetch requestを使用し、processResponseEndOfBodyを次のステップに設定します レスポンス responseに基づいて：

    1. ダウンロードが成功し、画像が利用可能である場合、要素タスクをキューに入れ、input要素でloadイベントを発火します。

    2. それ以外の場合、リモートサーバーからの応答がない場合、または取得が完了しても画像が無効またはサポートされていない場合は、要素タスクをキューに入れinput要素でerrorイベントを発火します。

画像の取得は、要素のloadイベントを遅延させなければなりません。ノードドキュメントがタスクをキューに入れ、リソースが取得された後（以下に定義）に実行されるまで。

画像がネットワークエラーなく正常に取得され、画像のタイプがサポートされているタイプであり、そのタイプの有効な画像である場合、画像は利用可能と見なされます。画像が完全にダウンロードされる前にこれが真である場合、画像が取得されている間にキューに入れられた各タスクは、画像の表示を適切に更新する必要があります。

ユーザーエージェントは、画像のタイプを決定するために画像スニッフィングルールを適用する必要があります。画像の関連するContent-Typeヘッダーが公式なタイプを提供します。これらのルールが適用されない場合、画像のタイプは画像の関連するContent-Typeヘッダーによって与えられるタイプでなければなりません。

ユーザーエージェントは、input要素に対して非画像リソースをサポートしてはなりません。ユーザーエージェントは画像リソースに埋め込まれた実行可能コードを実行してはなりません。ユーザーエージェントは、マルチページリソースの最初のページのみを表示しなければなりません。ユーザーエージェントはリソースがインタラクティブに動作することを許可してはなりませんが、リソース内のアニメーションを尊重する必要があります。

Element/input#alt

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

alt属性は、画像を使用できないユーザーやユーザーエージェントに対してボタンのテキストラベルを提供します。alt属性は必須であり、画像が利用できない場合に相当するボタンに適切なラベルを与える非空の文字列を含んでいなければなりません。

input要素は寸法属性をサポートします。

もしsrc属性が設定されており、画像が利用可能で、ユーザーエージェントがその画像を表示するように設定されている場合、要素は制御を表し、座標を選択するための制御を行います。その場合、要素が可変であれば、ユーザーエージェントはユーザーがこの座標を選択できるようにする必要があります。

それ以外の場合、要素は送信ボタンを表し、そのラベルはalt属性の値によって与えられます。

要素のeventに対する入力アクティベーションの動作は次のとおりです:

  1. 要素にフォームの所有者がいない場合、終了します。

  2. 要素のノードドキュメントが完全にアクティブでない場合、終了します。

  3. ユーザーが座標を明示的に選択して制御をアクティベートした場合、要素の選択された座標をその座標に設定します。

    これは上記の条件下でのみ可能です。このとき、要素はそのような座標を選択するための制御を表します。しかし、その場合でも、ユーザーが座標を明示的に選択せずに制御をアクティベートすることがあります。

  4. 要素のフォームを送信し、eventのユーザーのナビゲーション関与が設定されている場合、要素からフォームの所有者を送信します。

要素の選択された座標は、x成分とy成分からなります。初期状態では(0, 0)です。この座標は、要素の画像の端に対する位置を表し、座標空間ではxの正の方向が右に、yの正の方向が下に向かっています。

x成分は、xが範囲−(borderleft+paddingleft) ≤ x ≤ width+borderright+paddingright内にある有効な整数でなければなりません。ここで、widthは画像の描画された幅、borderleftは画像の左側の境界線の幅、paddingleftは画像の左側のパディングの幅、borderrightは画像の右側の境界線の幅、paddingrightは画像の右側のパディングの幅です。すべての寸法はCSSピクセルで指定されます。

y成分は、yが範囲−(bordertop+paddingtop) ≤ y ≤ height+borderbottom+paddingbottom内にある有効な整数でなければなりません。ここで、heightは画像の描画された高さ、bordertopは画像の上側の境界線の幅、paddingtopは画像の上側のパディングの幅、borderbottomは画像の下側の境界線の幅、paddingbottomは画像の下側のパディングの幅です。すべての寸法はCSSピクセルで指定されます。

境界線やパディングがない場合、その幅はCSSピクセルでゼロです。

formaction、 formenctype、 formmethod、 formnovalidate、 およびformtarget属性は、フォーム送信用の属性です。

image.width [ = value ]
image.height [ = value ]

これらの属性は画像の実際の描画寸法を返します。寸法が不明な場合は0を返します。

これらは設定可能で、対応するコンテンツ属性を変更するために使用できます。

次の一般的なinput要素のコンテンツ属性とIDL属性が要素に適用されます: alt、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 height、 popovertarget、 popovertargetaction、 src、 およびwidthコンテンツ属性; valueIDL属性。

valueIDL属性は、デフォルトモードで動作します。

次のコンテンツ属性は指定されてはならず、適用されません: accept, alpha, autocomplete, checked, colorspace, dirname、 list、 max、 maxlength、 min、 minlength、 multiple、 pattern、 placeholder、 readonly、 required、 size、 およびstep。

要素のvalue属性は省略する必要があります。

次のIDL属性およびメソッドは、要素に適用されません: checked、 files、 list、 selectionStart、 selectionEnd、 selectionDirection、 valueAsDate、 およびvalueAsNumberIDL属性; select()、 setRangeText()、 setSelectionRange()、 stepDown()、 およびstepUp()メソッド。

inputおよびchangeイベントは適用されません。

この状態の動作の多くの側面は、img要素の動作と類似しています。読者はそのセクションを読むことを推奨します。同じ要件がより詳細に説明されています。

次のフォームを例にとります:

<form action="process.cgi">
  <input type=image src=map.png name=where alt="場所リストを表示">
 </form>

ユーザーが画像の座標(127,40)をクリックした場合、フォーム送信に使用されるURLは"process.cgi?where.x=127&where.y=40"になります。

(この例では、地図が表示されないユーザーには、「場所リストを表示」というラベルの付いたボタンが表示され、ボタンをクリックすると地図の代わりに選択可能な場所のリストが表示されると仮定します。)

4.10.5.1.20 リセットボタン 状態 (type=reset)

Element/input/reset

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input要素のtype属性がリセットボタン状態である場合、このセクションのルールが適用されます。

(これはトラッキングベクターです。) input要素は、アクティブ化されるとフォームをリセットするボタンを表します。要素にvalue属性がある場合、ボタンのラベルはその属性の値でなければなりません。そうでない場合、"リセット"などを意味する実装依存の文字列でなければなりません。この要素はボタンです。

デフォルトのラベルは実装依存であり、通常、ボタンの幅はラベルに依存するため、ボタンの幅は指紋可能な情報のビットをリークする可能性があります。これらのビットは、ユーザーエージェントの識別およびユーザーのロケールに強く関連している可能性が高いです。

要素の入力アクティベーション動作は次のとおりです:

  1. 要素にフォームの所有者がいない場合、終了します。

  2. 要素のノードドキュメントが完全にアクティブでない場合、終了します。

  3. 要素からフォームをリセットし、フォームの所有者をリセットします。

制約検証: 要素は制約検証から除外されています。

valueIDL属性は、この要素に適用され、デフォルトモードで動作します。

次の一般的なinput要素のコンテンツ属性が要素に適用されます: popovertargetおよびpopovertargetaction。

次のコンテンツ属性は指定されてはならず、要素に適用されません: accept, alpha, alt, autocomplete, checked, colorspace, dirname、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 height、 list、 max、 maxlength、 min、 minlength、 multiple、 pattern、 placeholder、 readonly、 required、 size、 src、 step、 およびwidth。

次のIDL属性およびメソッドは要素に適用されません: checked、 files、 list、 selectionStart、 selectionEnd、 selectionDirection、 valueAsDate、 およびvalueAsNumberIDL属性; select()、 setRangeText()、 setSelectionRange()、 stepDown()、 およびstepUp()メソッド。

inputおよびchangeイベントは適用されません。

4.10.5.1.21 ボタン 状態 (type=button)

Element/input/button

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

input要素のtype属性がボタン状態である場合、このセクションのルールが適用されます。

input要素は、デフォルトの動作を持たないボタンを表します。ボタンのラベルはvalue属性に指定する必要がありますが、空の文字列でもかまいません。要素にvalue属性がある場合、ボタンのラベルはその属性の値でなければなりません。そうでない場合、ラベルは空の文字列でなければなりません。この要素はボタンです。

要素には入力アクティベーション動作はありません。

制約検証: 要素は制約検証から除外されています。

valueIDL属性は、この要素に適用され、デフォルトモードで動作します。

次の一般的なinput要素のコンテンツ属性が要素に適用されます: popovertargetおよびpopovertargetaction。

次のコンテンツ属性は指定されてはならず、要素に適用されません: accept, alpha, alt, autocomplete, checked, colorspace, dirname、 formaction、 formenctype、 formmethod、 formnovalidate、 formtarget、 height、 list、 max、 maxlength、 min、 minlength、 multiple、 pattern、 placeholder、 readonly、 required、 size、 src、 step、およびwidth。

次のIDL属性およびメソッドは要素に適用されません: checked、 files、 list、 selectionStart、 selectionEnd、 selectionDirection、 valueAsDate、 およびvalueAsNumberIDL属性; select()、 setRangeText()、 setSelectionRange()、 stepDown()、 およびstepUp()メソッド。

inputおよびchangeイベントは適用されません。

4.10.5.2 フォームコントロールのローカリゼーションに関する実装上の注意事項

このセクションは規範的ではありません。

ユーザーに表示される日付、時刻、および数値のコントロールの形式は、フォーム送信に使用される形式とは無関係です。

ブラウザは、日付、時刻、および数値をページのロケールに従って、またはユーザーの優先するロケールに従って表示するユーザーインターフェースを使用することが推奨されます。ページのロケールを使用することで、ページで提供されるデータとの一貫性が確保されます。

たとえば、アメリカ英語のページが02/03にCirque De Soleilのショーがあると主張しているのに、ブラウザが英国英語のロケールを使用するように設定されている場合、チケット購入の日付ピッカーに03/02としか表示されないと、ユーザーは混乱するでしょう。ページのロケールを使用することで、少なくとも日付がどこでも同じ形式で表示されるようになります。（もちろん、ユーザーが1か月遅れて到着するリスクは依然としてありますが、文化的な違いについてはできることには限界があります...）

4.10.5.3 共通のinput要素の属性

これらの属性は、input要素のtype属性が、その属性が適用されると定義された状態である場合にのみ、適用されます。属性がinput要素に適用されない場合、ユーザーエージェントは、以下の要件や定義にかかわらず、その属性を無視しなければなりません。

4.10.5.3.1 maxlengthおよびminlength属性

Attributes/maxlength

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Attributes/minlength

すべての現在のエンジンでサポートされています。

Firefox51+Safari10.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Attributes/maxlength

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

Attributes/minlength

すべての現在のエンジンでサポートされています。

Firefox51+Safari10.1+Chrome40+
Opera27+Edge79+
Edge (Legacy)17+Internet Explorerいいえ
Firefox Android51+Safari iOS10.3+Chrome Android40+WebView Android40+Samsung Internet4.0+Opera Android27+
caniuse.comテーブル

Element/input#attr-maxlength

すべての現在のエンジンでサポートされています。

Firefox4+Safari5.1+Chrome4+
Opera15+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android5+Safari iOS9+Chrome Android18+WebView Android4.4+Samsung Internet1.5+Opera Android15+
caniuse.comテーブル

maxlength属性は、適用されると、フォームコントロールmaxlength属性です。

Element/input#attr-minlength

すべての現在のエンジンでサポートされています。

Firefox51+Safari10.1+Chrome40+
Opera27+Edge79+
Edge (Legacy)17+Internet Explorerいいえ
Firefox Android51+Safari iOS10.3+Chrome Android40+WebView Android40+Samsung Internet4.0+Opera Android27+
caniuse.comテーブル

minlength属性は、適用されると、フォームコントロールminlength属性です。

input要素に最大許容値長がある場合、要素のvalue属性の値の長さは、要素の最大許容値長以下でなければなりません。

次の抜粋は、メッセージングクライアントのテキスト入力を任意に固定された文字数に制限し、この手段による会話を簡潔に強制し、知的な議論を抑制する方法を示しています。

<label>何をしていますか? <input name=status maxlength=140></label>

ここでは、パスワードに最小長が設定されています:

<p><label>ユーザー名: <input name=u required></label>
 <p><label>パスワード: <input name=p required minlength=12></label>
4.10.5.3.2 size属性

size属性は、ビジュアルレンダリングにおいて、ユーザーが要素の値を編集している間にユーザーエージェントが表示するべき文字数を指定します。

size属性が指定されている場合、その値は有効な非負の整数であり、ゼロより大きくなければなりません。

属性が存在する場合、その値は非負整数を解析するためのルールを使用して解析され、その結果がゼロより大きい数値である場合、ユーザーエージェントは少なくともその文字数が表示されるようにするべきです。

sizeIDL属性は、ゼロより大きい非負の数値にのみ制限され、デフォルト値は20です。

4.10.5.3.3 readonly属性

Attributes/readonly

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Attributes/readonly

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Attributes/readonly

すべての現在のエンジンでサポートされています。

Firefox1+Safari≤4+Chrome1+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer≤6+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android≤12.1+

readonly属性は、ユーザーがフォームコントロールを編集できるかどうかを制御するブール属性です。指定された場合、要素は変更可能ではなくなります。

制約検証: readonly属性がinput要素に指定されている場合、要素は制約検証から除外されます。

disabledとreadonlyの違いは、読み取り専用のコントロールはまだ機能するのに対し、無効化されたコントロールは有効化されるまで一般に機能しないということです。これは、要素の無効化された概念に関連する規範的な要件により、この仕様の他の箇所でより詳細に記述されています（例えば、要素のアクティベーション動作、それがフォーカス可能な領域かどうか、またはエントリリストの構築時など）。無効化されたコントロールとのユーザーインタラクションに関連する他の動作、例えばテキストが選択またはコピーできるかどうかなどは、この標準では定義されていません。

テキストコントロールのみが読み取り専用に設定でき、他のコントロール（例えばチェックボックスやボタン）では読み取り専用と無効の間に有用な区別がないため、readonly属性は適用されません。

次の例では、既存の製品識別子は変更できませんが、新しい製品（まだ識別子が入力されていない行）を表す行と一貫性を保つために、フォームの一部として表示されます。

<form action="products.cgi" method="post" enctype="multipart/form-data">
  <table>
   <tr> <th> 製品ID <th> 製品名 <th> 価格 <th> 操作
   <tr>
    <td> <input readonly="readonly" name="1.pid" value="H412">
    <td> <input required="required" name="1.pname" value="フロアランプUlke">
    <td> ￥<input required="required" type="number" min="0" step="0.01" name="1.pprice" value="49.99">
    <td> <button formnovalidate="formnovalidate" name="action" value="delete:1">削除</button>
   <tr>
    <td> <input readonly="readonly" name="2.pid" value="FG28">
    <td> <input required="required" name="2.pname" value="テーブルランプUlke">
    <td> ￥<input required="required" type="number" min="0" step="0.01" name="2.pprice" value="24.99">
    <td> <button formnovalidate="formnovalidate" name="action" value="delete:2">削除</button>
   <tr>
    <td> <input required="required" name="3.pid" value="" pattern="[A-Z0-9]+">
    <td> <input required="required" name="3.pname" value="">
    <td> ￥<input required="required" type="number" min="0" step="0.01" name="3.pprice" value="">
    <td> <button formnovalidate="formnovalidate" name="action" value="delete:3">削除</button>
  </table>
  <p> <button formnovalidate="formnovalidate" name="action" value="add">追加</button> </p>
  <p> <button name="action" value="update">保存</button> </p>
 </form>
4.10.5.3.4 required属性

required属性はブール属性です。指定されている場合、要素は必須となります。

制約検証: 要素が必須であり、そのvalueIDL属性が適用され、モードがvalueであり、要素が変更可能であり、要素の値が空文字列である場合、要素は欠落している状態になります。

次のフォームには、メールアドレスとパスワードの2つの必須フィールドがあります。また、ユーザーがパスワードフィールドとこの3つ目のフィールドに同じパスワードを入力した場合にのみ有効と見なされる3番目のフィールドがあります。 

<h1>新しいアカウントを作成</h1>
 <form action="/newaccount" method=post oninput="up2.setCustomValidity(up2.value != up.value ? 'Passwords do not match.' : '')">
  <p>
   <label for="username">メールアドレス:</label>
   <input id="username" type=email required name=un>
  <p>
   <label for="password1">パスワード:</label>
   <input id="password1" type=password required name=up>
  <p>
   <label for="password2">パスワードの確認:</label>
   <input id="password2" type=password name=up2>
  <p>
   <input type=submit value="アカウント作成">
 </form>

ラジオボタンの場合、required属性は、グループ内のいずれかのラジオボタンが選択されていれば満たされます。したがって、次の例では、必須としてマークされたものだけでなく、任意のラジオボタンをチェックすることができます。 

<fieldset>
  <legend>その映画はベクデルテストを通過しましたか？</legend>
  <p><label><input type="radio" name="bechdel" value="no-characters"> いいえ、映画には女性キャラクターが2人もいません。</label>
  <p><label><input type="radio" name="bechdel" value="no-names"> いいえ、女性キャラクターは互いに話をしません。</label>
  <p><label><input type="radio" name="bechdel" value="no-topic"> いいえ、女性キャラクターが話をするときはいつも男性キャラクターについてです。</label>
  <p><label><input type="radio" name="bechdel" value="yes" required> はい。</label>
  <p><label><input type="radio" name="bechdel" value="unknown"> わかりません。</label>
 </fieldset>

ラジオボタングループが必須かどうかの混乱を避けるために、著者はグループ内のすべてのラジオボタンに属性を指定することをお勧めします。一般的に、初めからチェックされているコントロールがないラジオボタングループを避けることをお勧めします。この状態はユーザーが戻ることができない状態であり、一般的に貧弱なユーザーインターフェースと見なされます。

4.10.5.3.5 multiple属性

Attributes/multiple

全ての現在のエンジンでサポートされています。

Firefox3.6+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

Element/input#attr-multiple

全ての現在のエンジンでサポートされています。

Firefox3.6+Safari4+Chrome2+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android≤37+Samsung Internet?Opera Android≤12.1+

multiple属性はブール属性であり、ユーザーが複数の値を指定できるかどうかを示します。

次の例は、メールクライアントの「宛先」フィールドが複数のメールアドレスを受け入れる方法を示しています。

<label>宛先: <input type=email multiple name=to></label>

ユーザーがユーザー連絡先データベースに友達「スパイダーマン」（アドレス「spider@parker.example.net」）と「スカーレットウィッチ」（アドレス「scarlet@avengers.example.net」）を登録しており、sと入力した場合、ユーザーエージェントはこれら2つのメールアドレスをユーザーに提案するかもしれません。

ページは、ユーザーの連絡先データベースをサイトにリンクさせることもできます。

<label>宛先: <input type=email multiple name=to list=contacts></label>
 ...
 <datalist id="contacts">
  <option value="hedral@damowmow.com">
  <option value="pillar@example.com">
  <option value="astrophy@cute.example">
  <option value="astronomy@science.example.org">
 </datalist>

ユーザーがこのテキストコントロールに「bob@example.net」を入力し、次に2つ目のメールアドレスの先頭に「s」と入力し始めたとします。ユーザーエージェントは、前述の2人の友達だけでなく、datalist要素に含まれる「astrophy」や「astronomy」も表示するかもしれません。

次の例は、メールクライアントの「添付ファイル」フィールドが複数のファイルのアップロードを受け入れる方法を示しています。

<label>添付ファイル: <input type=file multiple name=att></label>
4.10.5.3.6 pattern属性

Attributes/pattern

全ての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android≤37+Samsung Internet?Opera Android≤12.1+

Attributes/pattern

全ての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

pattern属性は、コントロールの値、またはmultiple属性が適用され、設定されている場合はコントロールの値をチェックするための正規表現を指定します。

指定されている場合、属性の値はJavaScriptのPattern[+UnicodeSetsMode, +N]生成物と一致しなければなりません。

input要素のコンパイルされたパターン正規表現が存在する場合、それはJavaScriptのRegExpオブジェクトです。それは次のように決定されます：

  1. 要素にpattern属性が指定されていない場合は、何も返しません。要素にはコンパイルされたパターン正規表現がありません。
  2. patternを要素のpattern属性の値とします。
  3. regexpCompletionをRegExpCreate(pattern, "v") とします。

  4. もしregexpCompletionが異常終了の場合、何も返さないでください。要素にはコンパイル済みのパターン正規表現がありません。

    ユーザーエージェントは、このエラーを開発者コンソールにログとして記録し、デバッグを支援することが推奨されます。

  5. anchoredPatternを文字列"^(?:"、pattern、そして")$"の連結したものとします。
  6. ! RegExpCreate(anchoredPattern, "v") を返します。

これらの手順の理由は、単にpattern属性の値を直接使用するのではなく、二つの理由があります。第一に、文字列に対して一致させる際に、正規表現の開始が文字列の開始に固定され、終了が文字列の終了に固定されるようにしたいからです。第二に、正規表現が独立した形で有効であることを確認したいからです。つまり、"^(?:"と")$"のアンカーで囲まれた後に初めて有効になるのではなく、最初から有効である必要があります。

RegExpオブジェクトregexpが文字列inputと一致するのは、! RegExpBuiltinExec(regexp, input)がnullでない場合です。

制約検証: 要素の値が空文字列でなく、かつ要素のmultiple属性が指定されていないか、それが指定されていてもinput要素に適用されない状態であり、要素がコンパイルされたパターン正規表現を持っているが、その正規表現が要素の値と一致しない場合、要素はパターンの不一致に苦しんでいます。

制約検証: 要素の値が空文字列でなく、かつ要素のmultiple属性が指定され、input要素に適用され、要素がコンパイルされたパターン正規表現を持っているが、その正規表現が要素の各値と一致しない場合、要素はパターンの不一致に苦しんでいます。

input要素がpattern属性を指定している場合、作成者はパターンの説明を含むtitle属性を含めるべきです。ユーザーエージェントは、この属性が存在する場合に、パターンが一致しないことをユーザーに通知する際、またはフォーカスを得た時など、適切なタイミングでこの属性の内容を使用するかもしれません。

例えば、次のスニペットがあります:

<label> 部品番号:
  <input pattern="[0-9][A-Z]{3}" name="part" title="部品番号は、数字1桁の後に大文字のアルファベット3文字が続きます。"/> </label>

...は、ユーザーエージェントが次のような警告を表示する原因になる可能性があります:

部品番号は、数字1桁の後に大文字のアルファベット3文字が続きます。
 このフィールドが不正な場合、フォームを送信できません。

pattern属性がコントロールに存在する場合、使用されているtitle属性は、パターンを説明するものでなければなりません。ユーザーがコントロールに入力する際に役立つ限り、追加情報を含めることもできます。そうしないと、支援技術が損なわれる可能性があります。

たとえば、title 属性にコントロールのキャプションが含まれている場合、支援技術が次のように読み上げる可能性があります: 入力されたテキストが要求されるパターンと一致しません。誕生日。これは役に立ちません。

ユーザーエージェントは、エラーが発生していない状況でもtitleを表示する場合があります（たとえば、コントロールにマウスオーバーした時のツールチップとして）。そのため、作成者はtitleの文言を、必ずしもエラーが発生したとは限らないように注意すべきです。

4.10.5.3.7 min属性およびmax属性

Attributes/max

全ての現在のエンジンでサポートされています。

Firefox16+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

Attributes/min

全ての現在のエンジンでサポートされています。

Firefox16+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

いくつかのフォームコントロールには、ユーザーが提供できる値の範囲を制限する明示的な制約を適用できます。通常、そのような範囲は線形で連続的です。ただし、フォームコントロールが周期的なドメインを持つ場合、そのフォームコントロールの最も広い範囲は有限であり、作成者はその範囲内で境界をまたぐ明示的な範囲を指定できます。

具体的には、type=timeコントロールの最も広い範囲は、深夜から深夜まで（24時間）であり、作成者は連続した線形範囲（例えば、午後9時から午後11時まで）や、深夜をまたぐ非連続範囲（例えば、午後11時から午前1時まで）を設定できます。

min属性およびmax属性は、その要素に対して許可される値の範囲を示します。

それらの構文は、type属性の現在の状態を定義するセクションによって定義されます。

要素にmin属性があり、文字列を数値に変換するアルゴリズムをそのmin属性の値に適用した結果が数値である場合、その数値がその要素の最小値です。それ以外の場合、type属性の現在の状態がデフォルトの最小値を定義している場合、それが最小値です。それ以外の場合、要素には最小値はありません。

min属性はまた、ステップベースを定義します。

要素にmax属性があり、文字列を数値に変換するアルゴリズムをそのmax属性の値に適用した結果が数値である場合、その数値がその要素の最大値です。それ以外の場合、type属性の現在の状態がデフォルトの最大値を定義している場合、それが最大値です。それ以外の場合、要素には最大値はありません。

要素が周期的なドメインを持っていない場合、max属性の値（最大値）は、min属性の値（その最小値）よりも小さくてはなりません。

周期的なドメインを持たない要素が、最小値よりも小さい最大値を持っている場合、その要素が値を持っている限り、それはアンダーフローに苦しんでいるか、オーバーフローに苦しんでいる可能性があります。

要素が逆転した範囲を持つのは、それが周期的なドメインを持ち、その最大値がその最小値よりも小さい場合です。

要素が範囲制限を持つのは、定義された最小値または定義された最大値を持っている場合です。

制約検証: 要素が最小値を持ち、逆転した範囲を持たない場合、要素の値によって得られた数値が最小値より小さい場合、要素はアンダーフローに苦しんでいます。

制約検証: 要素が最大値を持ち、逆転した範囲を持たない場合、要素の値によって得られた数値が最大値を超える場合、要素はオーバーフローに苦しんでいます。

制約検証: 要素が逆転した範囲を持っている場合、要素の値によって得られた数値が最大値を超え、かつ最小値よりも小さい場合、その要素は同時にアンダーフローとオーバーフローに苦しんでいます。

以下の日付コントロールは、1980年代以前の日付に入力を制限します:

<input name=bday type=date max="1979-12-31">

以下の数値コントロールは、ゼロより大きい整数に入力を制限します:

<input name=quantity required="" type="number" min="1" value="1">

以下の時間コントロールは、午後9時から午前6時の間に発生する分に入力を制限し、デフォルトは午前0時です:

<input name="sleepStart" type=time min="21:00" max="06:00" step="60" value="00:00">
4.10.5.3.8 step属性

Attributes/step

全ての現在のエンジンでサポートされています。

Firefox16+Safari5+Chrome5+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

step属性は、許容される値を制限することで、期待される（および必要な）値または値の粒度を示します。type属性の現在の状態を定義するセクションも、以下で説明されるように、属性の処理に使用されるデフォルトのステップ、ステップのスケールファクター、および場合によってはデフォルトのステップベースを定義します。

step属性が指定されている場合、その値は、ゼロより大きい数に解析される、有効な浮動小数点数であるか、anyという文字列のASCII 大文字小文字を区別しない一致でなければなりません。

属性は次のように要素の許容される値のステップを提供します:

  1. 属性が適用されない場合、許容される値のステップはありません。

  2. それ以外の場合、属性が存在しない場合、許容される値のステップはデフォルトのステップにステップのスケールファクターを乗じたものです。

  3. それ以外の場合、属性の値がanyという文字列のASCII 大文字小文字を区別しない一致である場合、許容される値のステップはありません。

  4. それ以外の場合、浮動小数点数値の解析規則を属性の値に適用したときにエラー、ゼロ、またはゼロ未満の数が返された場合、許容される値のステップはデフォルトのステップにステップのスケールファクターを乗じたものです。

  5. それ以外の場合、浮動小数点数値の解析規則を属性の値に適用したときに返された数にステップのスケールファクターを乗じたものが許容される値のステップです。

ステップベースは、次のアルゴリズムによって返される値です:

  1. 要素にmin属性があり、そのmin属性の値に文字列を数値に変換するアルゴリズムを適用した結果がエラーでない場合、その結果を返します。

  2. 要素にvalue属性があり、そのvalue属性の値に文字列を数値に変換するアルゴリズムを適用した結果がエラーでない場合、その結果を返します。

  3. この要素に対してデフォルトのステップベースが定義されている場合、その値を返します。

  4. ゼロを返します。

制約検証: 要素に許容される値のステップがあり、要素の値に文字列を数値に変換するアルゴリズムを適用した結果が数値であり、その数値からステップベースを引いたものが許容される値のステップの整数倍でない場合、要素はステップの不一致に苦しんでいます。

次の範囲コントロールは、0から1の範囲内で256のステップを受け付けます:

<input name=opacity type=range min=0 max=1 step=0.00392156863>

次のコントロールは、日中の任意の時刻を任意の精度で選択できます（例：1000分の1秒単位の精度やそれ以上）:

<input name=favtime type=time step=any>

通常、時間コントロールの精度は1分単位に制限されています。

4.10.5.3.9 list 属性

Element/input#list

すべての現在のエンジンでサポートされています。

Firefox4+Safari12.1+Chrome20+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android4.4.3+Samsung Internet?Opera Android12.1+

list 属性は、ユーザーに提案する事前定義されたオプションをリストする要素を識別するために使用されます。

存在する場合、その値は同じツリー内のdatalist要素のIDでなければなりません。

提案ソース要素は、list属性の値と等しいIDを持つ、ツリー内でツリー順において最初の要素です。その要素がdatalist要素である場合に限ります。list属性が存在しない場合、またはそのIDを持つ要素が存在しない場合、または最初の要素がdatalist要素でない場合、提案ソース要素は存在しません。

提案ソース要素が存在する場合、ユーザーエージェントがユーザーに値を編集させているとき、ユーザーエージェントは、提案ソース要素で表される提案を、使用されているコントロールの種類に適した方法でユーザーに提供する必要があります。 適切であれば、ユーザーエージェントは、提案のラベルと値を使用して、ユーザーに提案を識別させるべきです。

提案が多い場合、提案ソース要素で表される提案をフィルタリングし、最も関連性の高いものだけを含めることが推奨されます（例：ユーザーの現在の入力に基づいて）。 明確な閾値は定義されていませんが、リストを4〜7つの値に制限するのが合理的です。 ユーザーの入力に基づいてフィルタリングする場合、ユーザーエージェントは、提案のラベルおよび値内を検索して一致を探すべきです。 ユーザーエージェントは、入力の変動が一致プロセスにどのように影響するかを考慮すべきです。異なるキーボードや入力特定のメカニズムによって引き起こされる異なるUnicodeコードポイントシーケンスが一致プロセスを妨げないように、Unicode正規化を適用すべきです。 大文字小文字の違いは無視するべきで、これは言語特有の大文字小文字のマッピングを必要とする場合があります。 これらの例については、World Wide Webの文字モデル：文字列の一致を参照してください。 ユーザーエージェントは他の一致機能も提供する場合があります：たとえば、異なる形式の仮名を互いに一致させる（または漢字に一致させる）、アクセントを無視する、スペル補正を適用するなどです。 [CHARMODNORM]

このテキストフィールドでは、JavaScript関数の種類を選択できます。

<input type="text" list="function-types">
 <datalist id="function-types">
   <option value="function">function</option>
   <option value="async function">async function</option>
   <option value="function*">generator function</option>
   <option value="=>">arrow function</option>
   <option value="async =>">async arrow function</option>
   <option value="async function*">async generator function</option>
 </datalist>

上記の提案に従うユーザーエージェントでは、ラベルおよび値の両方が表示されます:

右側にドロップダウンボタンが付いたテキストボックス;その下には、6つの値と6つのラベルを含むドロップダウンボックスが表示されています。

次に、「arrow」または「=>」と入力すると、「arrow function」および「async arrow function」というラベルのエントリにリストが絞り込まれます。「generator」または「*」と入力すると、「generator function」および「async generator function」というラベルのエントリにリストが絞り込まれます。

これまで通り、ユーザーエージェントは、特定の要件やユーザーの状況に応じて適切なユーザーインターフェイスの決定を自由に行うことができます。しかし、この分野はこれまで、実装者、Web開発者、およびユーザーの間で混乱を招いてきたため、上記に「すべき」という提案を提供しています。

ユーザーが提案を選択した場合の処理方法は、要素が単一の値のみを受け入れるコントロールであるか、複数の値を受け入れるかどうかによって異なります:

要素にmultiple属性が指定されていない場合、またはmultiple属性が適用されない場合

ユーザーが提案を選択したとき、input要素の値は、ユーザーがその値を書いたかのように、選択した提案の値に設定されなければなりません。

要素のtype属性がEmail状態にあり、要素にmultiple属性が指定されている場合

ユーザーが提案を選択したとき、ユーザーエージェントは、新しいエントリをinput要素の値に追加するか、既存のエントリを選択した提案の値に変更する必要があります。どちらの動作を適用するかは、実装定義の方法で行われます。

list属性が適用されない場合、提案ソース要素は存在しません。

このURLフィールドでは、いくつかの提案が表示されます。

<label>ホームページ: <input name=hp type=url list=hpurls></label>
 <datalist id=hpurls>
  <option value="https://www.google.com/" label="Google">
  <option value="https://www.reddit.com/" label="Reddit">
 </datalist>

ユーザーの履歴から他のURLが表示されることもあります。これはユーザーエージェント次第です。

この例は、オートコンプリートリスト機能を使用しながらも、レガシーユーザーエージェントで適切にデグレードするフォームを設計する方法を示しています。

オートコンプリートリストが単なる補助であり、コンテンツにとって重要でない場合は、単に子要素optionを持つdatalist要素を使用するだけで十分です。 レガシーユーザーエージェントでこれらの値が表示されないようにするには、それらをインラインではなく、value属性内に配置する必要があります。 

<p>
  <label>
   品種を入力してください:
   <input type="text" name="breed" list="breeds">
   <datalist id="breeds">
    <option value="アビシニアン">
    <option value="アルパカ">
    <!-- ... -->
   </datalist>
  </label>
 </p>

しかし、レガシーユーザーエージェントで値を表示する必要がある場合は、フォールバックコンテンツをdatalist要素内に配置することができます。以下のように: 

<p>
  <label>
   品種を入力してください:
   <input type="text" name="breed" list="breeds">
  </label>
  <datalist id="breeds">
   <label>
    またはリストから選択してください:
    <select name="breed">
     <option value=""> (選択なし)
     <option>アビシニアン
     <option>アルパカ
     <!-- ... -->
    </select>
   </label>
  </datalist>
 </p>

フォールバックコンテンツは、datalistをサポートしていないユーザーエージェントでのみ表示されます。 一方、オプションは、datalist要素の子でなくても、すべてのユーザーエージェントで検出されます。

option要素がdatalistで使用されている場合、それがselectedされていると、デフォルトでレガシーユーザーエージェントによって選択されます（select要素に影響を与えるためです）が、それはinput要素には影響を与えません。datalistをサポートしているユーザーエージェントでは効果がありません。

4.10.5.3.10 placeholder 属性

Element/input#placeholder

すべての現行エンジンでサポートされています。

Firefox4+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

Element/input#attr-placeholder

すべての現行エンジンでサポートされています。

Firefox4+Safari4+Chrome3+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android≤37+Samsung Internet?Opera Android≤12.1+

placeholder 属性は、コントロールに値が入力されていないときにユーザーのデータ入力を支援するための短いヒント（単語や短いフレーズ）を表します。ヒントは、サンプル値や期待されるフォーマットの簡単な説明である場合があります。この属性が指定されている場合、その値にはU+000A LINE FEED（LF）またはU+000D CARRIAGE RETURN（CR）文字を含めてはいけません。

placeholder 属性は、labelの代替として使用すべきではありません。より長いヒントやその他の助言テキストには、title属性の方が適しています。

これらのメカニズムは非常に似ていますが、微妙に異なります。コントロールのlabelによって提供されるヒントは常に表示されます。placeholder属性によって提供される短いヒントは、ユーザーが値を入力する前に表示されます。そして、title属性のヒントは、ユーザーがさらなるヘルプを求めたときに表示されます。

ユーザーエージェントは、このヒントをユーザーに提示すべきです。このとき、要素の値が空文字列であり、特にコントロールがフォーカスされていない場合には、改行を除去した後に提示することが推奨されます。

通常、ユーザーエージェントがコントロールがフォーカスされているときにこのヒントを表示しない場合でも、autofocus属性の結果としてコントロールがフォーカスされた場合は、このヒントを表示するべきです。これは、その場合、ユーザーがフォーカスする前にコントロールを確認する機会を持たないためです。

以下は、placeholder属性を使用したメール設定ユーザーインターフェースの例です: 

<fieldset>
  <legend>メールアカウント</legend>
  <p><label>名前: <input type="text" name="fullname" placeholder="山田 太郎"></label></p>
  <p><label>アドレス: <input type="email" name="address" placeholder="taro@example.com"></label></p>
  <p><label>パスワード: <input type="password" name="password"></label></p>
  <p><label>説明: <input type="text" name="desc" placeholder="私のメールアカウント"></label></p>
 </fieldset>

コントロールのコンテンツの方向性とプレースホルダーの方向性が異なる場合、Unicodeの双方向アルゴリズムの書式設定文字を属性値に使用できます:

<input name=t1 type=tel placeholder="&#x202B; رقم الهاتف 1 &#x202E;">
 <input name=t2 type=tel placeholder="&#x202B; رقم الهاتف 2 &#x202E;">

少しわかりやすくするために、同じ例をインラインのアラビア語の代わりに数値文字参照を使用して示します:

<input name=t1 type=tel placeholder="&#x202B;&#1585;&#1602;&#1605; &#1575;&#1604;&#1607;&#1575;&#1578;&#1601; 1&#x202E;">
 <input name=t2 type=tel placeholder="&#x202B;&#1585;&#1602;&#1605; &#1575;&#1604;&#1607;&#1575;&#1578;&#1601; 2&#x202E;">
4.10.5.4 共通の input 要素API
input.value [ = value ]

フォームコントロールの現在の値を返します。

値を変更するために設定することができます。

ファイルアップロードコントロールの場合、空文字列以外の値に設定すると、"InvalidStateError" DOMExceptionがスローされます。

input.checked [ = value ]

フォームコントロールの現在のチェック状態を返します。

チェック状態を変更するために設定することができます。

input.files [ = files ]

FileList

すべての現行エンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera11.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11.1+

HTMLInputElement/files

すべての現行エンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+🔰 10+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

フォームコントロールの選択されたファイルをリストしたFileListオブジェクトを返します。

コントロールがファイルコントロールでない場合は null を返します。

設定すると、フォームコントロールの選択されたファイルを変更できます。たとえば、ドラッグ＆ドロップ操作の結果として。

input.valueAsDate [ = value ]

フォームコントロールの値を表すDateオブジェクトを返します（該当する場合）。そうでない場合は null を返します。

値を変更するために設定することができます。

コントロールが日付または時刻に基づくものでない場合、"InvalidStateError" DOMExceptionをスローします。

input.valueAsNumber [ = value ]

フォームコントロールの値を表す数値を返します（該当する場合）。そうでない場合は NaN を返します。

値を変更するために設定することができます。これを NaN に設定すると、基礎となる値が空文字列に設定されます。

コントロールが日付または時刻に基づくものでないか、数値でない場合、"InvalidStateError" DOMExceptionをスローします。

input.stepUp([ n ])

HTMLInputElement/stepUp

Firefox🔰 16+Safari5+Chrome5+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
input.stepDown([ n ])

HTMLInputElement/stepDown

Firefox🔰 16+Safari5+Chrome5+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

フォームコントロールの値を、step属性で与えられた値にnを掛けた値だけ変更します。nのデフォルト値は 1 です。

コントロールが日付または時刻に基づくものでないか、数値でない場合、またはstep属性の値が"any"の場合、"InvalidStateError" DOMExceptionをスローします。

input.list

datalist属性で示される要素を返します。

input.showPicker()

input に適用可能なピッカーUIを表示し、ユーザーが値を選択できるようにします。

input がピッカーをサポートしない場合、このメソッドは何もしません。

フォームコントロールが変更可能でない場合、"InvalidStateError" DOMExceptionをスローします。

一時的なユーザーアクティベーションなしで呼び出された場合、"NotAllowedError" DOMExceptionをスローします。

フォームコントロールがファイルアップロード状態またはカラー状態でない限り、クロスオリジンのiframe内にある場合、"SecurityError" DOMExceptionをスローします。

value

取得時には、要素の現在のvalueを返します。

設定時には次の手順を行います:

  1. oldValueを要素のvalueとします。

  2. 要素のvalueを新しい値に設定します。

  3. 要素のダーティ値フラグをtrueに設定します。

  4. 要素の値のサニタイズアルゴリズムを、 そのtype属性の現在の状態が定義している場合に実行します。

  5. 要素のvalue（値のサニタイズアルゴリズムを適用した後）がoldValueと異なり、 要素にテキストエントリカーソルの位置がある場合は、 テキストエントリカーソルの位置をテキストコントロールの終わりに移動し、 選択されているテキストを選択解除し、選択方向を"none"にリセットします。

default

取得時には、要素にvalueコンテンツ属性がある場合はその属性の値を返し、そうでない場合は空の文字列を返します。

設定時には、要素のvalueコンテンツ属性の値を新しい値に設定します。

default/on

取得時には、要素にvalueコンテンツ属性がある場合はその属性の値を返し、そうでない場合は"on"という文字列を返します。

設定時には、要素のvalueコンテンツ属性の値を新しい値に設定します。

filename

取得時には、"C:\fakepath\"という文字列に、選択されたファイルのリストの最初のファイル名を続けて返し、リストが空の場合は空の文字列を返します。

設定時に新しい値が空の文字列であれば、選択されたファイルのリストを空にします。それ以外の場合は、 "InvalidStateError" DOMExceptionをスローします。

この "fakepath" の要件は歴史的な悲しい事故です。詳しくはファイルアップロード状態セクションの例を参照してください。

ファイル名のリストにはパスコンポーネントが含まれていないため、"\fakepath\"がパスコンポーネントと誤解されることはありません。

checked IDL属性は、スクリプトがcheckednessを操作するために使用される input要素です。 取得時には、要素の現在のcheckednessを返し、 設定時には、要素のcheckednessを新しい値に設定し、 要素のdirty checkedness flagをtrueに設定しなければなりません。

files IDL属性は、スクリプトが要素の選択されたファイルにアクセスするために使用されます。

取得時に、IDL属性が適用される場合は、現在の選択されたファイルを表す FileListオブジェクトを返さなければなりません。 同じオブジェクトは、選択されたファイルのリストが変更されるまで返され続けなければなりません。 IDL属性が適用されない場合は、代わりにnullを返さなければなりません。 [FILEAPI]

設定時には、以下の手順を実行する必要があります:

  1. IDL属性が適用されない場合や、与えられた値がnullである場合は、終了します。

  2. 要素の選択されたファイルを与えられた値に置き換えます。

valueAsDate IDL属性は、要素の値を、日付として解釈したものを表します。

取得時に、valueAsDate属性が適用されない場合、 その状態に定義されているように、input要素のtype属性の現在の状態が、 nullを返します。そうでない場合は、その状態に定義されている文字列からDateオブジェクトへの変換アルゴリズムを実行し、 そのアルゴリズムがDateオブジェクトを返した場合は、それを返し、 それ以外の場合はnullを返します。

設定時に、valueAsDate属性が適用されない場合、 その状態に定義されているように、input要素のtype属性の現在の状態に対して、 "InvalidStateError" DOMExceptionをスローします。 そうでない場合、新しい値がnullでなく、Dateオブジェクトでない場合は、TypeError例外をスローします。 そうでない場合、新しい値がnullであるか、NaN時間値を表すDateオブジェクトである場合は、 要素の値を空の文字列に設定します。 それ以外の場合は、新しい値に対してその状態に定義されている日付オブジェクトを文字列に変換するアルゴリズムを実行し、 要素の値を生成された文字列に設定します。

valueAsNumber IDL属性は、要素の値を、数値として解釈したものを表します。

取得時に、valueAsNumber属性が適用されない場合、 その状態に定義されているように、input要素のtype属性の現在の状態が、 Not-a-Number (NaN) 値を返します。そうでない場合は、その状態に定義されている文字列から数値への変換アルゴリズムを実行し、 そのアルゴリズムが数値を返した場合はそれを返し、それ以外の場合はNot-a-Number (NaN) 値を返します。

設定時に、新しい値が無限である場合は、TypeError例外をスローします。 そうでない場合、valueAsNumber属性が適用されない場合は、 input要素の現在の状態に対して、 "InvalidStateError" DOMExceptionをスローします。 そうでない場合、新しい値がNot-a-Number (NaN) 値である場合は、要素の値を空の文字列に設定します。 そうでない場合は、新しい値に対してその状態に定義されている数値を文字列に変換するアルゴリズムを実行し、 要素の値を生成された文字列に設定します。

stepDown(n) およびstepUp(n)メソッドは、 呼び出された際に次のアルゴリズムを実行しなければなりません:

  1. stepDown()およびstepUp()メソッドが適用されない場合、 その状態に定義されているように、input要素のtype属性の現在の状態が、 "InvalidStateError" DOMExceptionをスローします。

  2. 要素に許可された値のステップがない場合は、"InvalidStateError" DOMExceptionをスローします。

  3. 要素に最小値および最大値があり、 最小値が最大値よりも大きい場合は、終了します。

  4. 要素に最小値および最大値があり、 その最小値以上であり、 その最大値以下である値がない場合、 その値をステップ基準から引いたときに許可された値のステップの整数倍となり、 その値がなければ終了します。

  5. 文字列から数値への変換アルゴリズムを実行し、 要素の値を取得してエラーが発生しなかった場合は、 valueをそのアルゴリズムの結果に設定します。そうでない場合は、valueをゼロに設定します。

  6. valueBeforeSteppingをvalueに設定します。

  7. valueをステップ基準から引いた値が許可された値のステップの整数倍でない場合は、 valueを次のように設定します。 その値がstepDown()メソッドで呼び出された場合は、 value未満の最も近い値に設定し、そうでない場合はそれよりも大きい値に設定します。

    それ以外の場合、valueをステップ基準から引いた値が、 許可された値のステップの整数倍である場合:

    1. nを引数として設定します。

    2. deltaをnに許可された値のステップを掛けた値に設定します。

    3. stepDown()メソッドが呼び出された場合は、 deltaを否定します。

    4. valueにdeltaを加えた結果を設定します。

  8. 要素に最小値があり、valueがその最小値より小さい場合、valueを、ステップ基準値から引いたときに許可される値のステップの整数倍であり、かつその最小値以上である最小の値に設定します。

  9. 要素に最大値があり、valueがその最大値より大きい場合、valueを、ステップ基準値から引いたときに許可される値のステップの整数倍であり、かつその最大値以下である最大の値に設定します。

  10. stepDown()メソッドが呼び出され、 valueがvalueBeforeSteppingより大きい場合、またはstepUp()メソッドが呼び出され、 valueがvalueBeforeSteppingより小さい場合は、終了します。

    次の例では、stepUp()メソッドを input要素に対して呼び出しても、 その要素の値が変更されないことが保証されます: 

    <input type=number value=1 max=0>

  11. value as stringを次のアルゴリズムを実行して取得しなければなりません: 数値を文字列に変換するアルゴリズムを実行し、 input要素のtype属性の現在の状態に基づいて、 valueに設定します。

  12. 要素の値をvalue as stringに設定します。

listIDL属性は、現在の提案元要素を返すか、なければnullを返す必要があります。

HTMLInputElement/showPicker

すべての現在のエンジンでサポートされています。

Firefox101+ Safari16+ Chrome99+
Opera? Edge99+
Edge (Legacy)? Internet Explorerなし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HTMLInputElementのshowPicker()およびHTMLSelectElementのshowPicker()メソッドのステップは次の通りです:

  1. thisが変更可能でない場合、"InvalidStateError" DOMExceptionをスローします。

  2. thisの関連する設定オブジェクトのオリジンが同一オリジンでない場合、またはthisが関連する設定オブジェクトのトップレベルオリジンと異なる場合で、thisがselect要素であるか、thisのtype属性がファイルアップロード状態やカラー状態でない場合、"SecurityError" DOMExceptionをスローします。

    ファイルおよびカラー入力は、歴史的理由によりこのチェックから免除されています。これらの入力の入力アクティベーション動作は、そのピッカーも表示し、オリジンチェックにより保護されることはありませんでした。

  3. thisの関連するグローバルオブジェクトが一時的アクティベーションを持たない場合、"NotAllowedError"DOMExceptionをスローします。

  4. thisがselect要素であり、かつthisがレンダリングされていない場合、"NotSupportedError"DOMExceptionをスローします。

  5. 適用可能であればピッカーを表示をthisに対して行います。

input要素またはselect要素elementに対して適用可能であればピッカーを表示するには:

  1. elementの関連するグローバルオブジェクトが一時的なアクティベーションを持たない場合、戻ります。

  2. elementが変更可能でない場合、戻ります。

  3. ユーザーアクティベーションを消費する、elementの関連するグローバルオブジェクトを与えられて。

  4. elementがピッカーをサポートしない場合、戻ります。

  5. elementがinput要素であり、elementのtype属性がファイルアップロード状態である場合、これらのステップを並行して実行します：

    1. オプションで、このアルゴリズムの以前の実行が終了するまで待機します。

    2. dismissedを、elementを指定したWebDriver BiDiファイルダイアログが開かれた結果とします。

    3. dismissedがfalseの場合：

      1. ユーザーにいくつかのファイルを指定するように要求するプロンプトを表示します。elementにmultiple属性が設定されていない場合、選択できるファイルは1つ以下でなければなりません。それ以外の場合は、任意の数を選択できます。ファイルはファイルシステムから取得することも、その場で作成することもできます（例：ユーザーのデバイスに接続されたカメラで撮影した写真）。

      2. ユーザーが選択を行うのを待ちます。

    4. dismissedがtrueであるか、ユーザーが選択を変更せずにプロンプトを閉じた場合、elementを指定してユーザーインタラクションタスクソース上の要素タスクをキューに入れ、elementでbubbles属性をtrueに初期化してcancelという名前のイベントを発火させます。

    5. それ以外の場合、elementのファイル選択を更新します。

    すべてのユーザーインターフェイス仕様と同様に、ユーザーエージェントはこれらの要件をどのように解釈するかについてかなりの自由度を持っています。上記のテキストは、ユーザーがプロンプトを閉じるか、選択を変更するかのいずれかを行うことを意味します。これらのうち正確に1つが真になります。しかし、これらの可能性を特定のユーザーインターフェイス要素にマッピングすることは、標準では義務付けられていません。たとえば、ユーザーエージェントは、以前にファイルが選択されていたときに「キャンセル」ボタンをクリックすることを、選択をゼロファイルに変更することと解釈し、それによってinputイベントとchangeイベントを発火させるかもしれません。あるいは、そのようなクリックを選択を変更せずにプロンプトを閉じることと解釈し、それによってcancelイベントを発火させるかもしれません。同様に、以前に選択されたのと同じファイルを再選択することが、プロンプトを閉じることと見なされるか、選択の変更と見なされるかは、ユーザーエージェント次第です。

  6. それ以外の場合、ユーザーエージェントは、ユーザーがコントロールを操作するときに通常行う方法で、elementの値を選択するための関連するユーザーインターフェイスを表示する必要があります。

    そのようなユーザーインターフェイスを表示する場合、elementのtype属性の状態が与えられた場合のelementの動作に関する仕様の関連部分に記載されている要件を尊重しなければなりません。（たとえば、さまざまなセクションで、結果として得られるvalue文字列に関する制限が説明されています。）

    このステップには、このアルゴリズムによって以前に表示された他のピッカーを閉じるなどの副作用が発生する可能性があります。（これがファイル選択ピッカーを閉じる場合、上記に従って、inputイベントとchangeイベント、またはcancelイベントのいずれかが発火します。）

4.10.5.5 共通イベントの動作

input イベントおよびchange イベントが適用される場合（これは、inputコントロールのうち、ボタンおよびtype属性が隠し状態のもの以外が対象です）、これらのイベントは、ユーザーがコントロールと対話したことを示すために発火します。 input イベントは、ユーザーがコントロールのデータを変更するたびに発火します。change イベントは、値が確定されたとき（コントロールにとってそれが意味を持つ場合）や、コントロールがフォーカスを失ったときに発火します。すべてのケースで、inputイベントが対応するchangeイベント（もしあれば）より先に発生します。

input要素に定義された入力 活性化動作がある場合、これらのイベントが適用される場合のイベント発行ルールは、type属性の状態を定義する上記のセクションで指定されています。（これは、inputコントロールがチェックボックス状態、ラジオボタン状態、またはファイルアップロード状態のtype属性を持つ場合に適用されます。）

入力活性化動作が定義されていないが、これらのイベントが適用される要素であり、ユーザーインターフェースが対話的な操作と明示的な確定アクションの両方を含む場合、ユーザーが要素の値を変更するとき、ユーザーエージェントは、input要素に対して要素タスクをキューに入れる必要があります。そして、イベントを発火し、inputという名前のイベントを、input要素に対して発火します。このとき、bubbles属性とcomposed属性はtrueに設定されます。そして、ユーザーが変更を確定するたびに、ユーザーエージェントはinput要素に対して要素タスクをキューに入れる必要があります。

対話的な操作と確定アクションの両方を含むユーザーインターフェースの例として、スライダーを使用するレンジコントロールが挙げられます。ユーザーがポインティングデバイスを使用してコントロールのノブをドラッグしている間、inputイベントは位置が変わるたびに発生しますが、changeイベントはユーザーがノブを離して特定の値を確定したときにのみ発生します。

入力活性化動作が定義されていないが、これらのイベントが適用される要素であり、ユーザーインターフェースが明示的な確定アクションを含むが、中間操作を含まない場合、ユーザーが要素の値を変更するたびに、ユーザーエージェントは、input要素に対して要素タスクをキューに入れる必要があります。そして、イベントを発火し、inputという名前のイベントをinput要素に対して発火します。このとき、bubbles属性とcomposed属性はtrueに設定されます。そして、input要素に対して、changeという名前のイベントを発火します。

確定アクションを含むユーザーインターフェースの例としては、1つのボタンで構成され、カラーホイールを表示するカラーコントロールが挙げられます。値がダイアログが閉じられたときにのみ変更される場合、それが明示的な確定アクションとなります。反対に、操作中に色がインタラクティブに変更される場合、確定アクションは発生しないかもしれません。

確定アクションを含む他の例としては、テキストベースのユーザー入力とドロップダウンカレンダーからのユーザー選択の両方を許可する日付コントロールがあります。テキスト入力には明示的な確定ステップが含まれないかもしれませんが、ドロップダウンカレンダーから日付を選択し、その後ドロップダウンを閉じることは確定アクションとなります。

入力活性化動作が定義されていないが、これらのイベントが適用される要素であり、ユーザーが明示的な確定アクションなしに要素の値を変更するたびに、ユーザーエージェントは、input要素に対して要素タスクをキューに入れる必要があります。そして、イベントを発火し、inputという名前のイベントを、input要素に対して発火します。このとき、bubbles属性とcomposed属性はtrueに設定されます。対応するchangeイベント（もしあれば）は、コントロールがフォーカスを失ったときに発火します。

ユーザーが要素の値を変更する例としては、ユーザーがテキストコントロールに入力する、コントロールに新しい値をペーストする、またはそのコントロール内で編集を取り消すことが挙げられます。ユーザーの一部の操作は、値の変更を引き起こしません。例として、空のテキストコントロールで「削除」キーを押す、またはクリップボードから同じテキストをコントロール内のテキストに置き換える場合が挙げられます。

キーボードを使用して操作しているユーザーがフォーカスを当てた状態でスライダー形式のレンジコントロールを操作する例も、確定ステップを伴わずに要素の値を変更する例です。

タスクが単にinputイベントを発火させるだけの場合、ユーザーエージェントは、ユーザーの操作が一段落するまでタスクをキューに入れるのを待つことができます。たとえば、ユーザーがキーを100ms押さない場合にイベントを発火させるなど、各キーストロークごとに連続して発火させるのではなく、ユーザーが一時停止したときにのみ発火させることができます。

ユーザーエージェントがユーザーに代わってinput要素の値を変更する場合（例：フォームの自動入力機能の一環として）、ユーザーエージェントは、input要素を指定して要素タスクをキューに追加し、まず対応する値を更新し、その後、inputという名前のイベントをinput要素に対して発火し、bubblesおよびcomposed属性をtrueに初期化し、その後changeという名前のイベントをinput要素に対して発火し、bubbles属性をtrueに初期化します。

これらのイベントは、スクリプトによってフォームコントロールの値が変更された場合には発火しません（これは、ユーザーがコントロールを操作した結果としてフォームコントロールの値を更新し、その後スクリプト自身の変更をフィルタリングして無限ループを避けるのを容易にするためです）。

また、ブラウザがフォームコントロールの値を、ナビゲーション中の状態復元の一部として変更した場合も、これらのイベントは発火しません。

4.10.6 button要素

要素/button

すべての現行エンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera15+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

HTMLButtonElement

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ
フレージングコンテンツ
インタラクティブコンテンツ
リストされている, ラベル可能, 送信可能, および 大文字化および自動修正継承 フォーム関連要素。
有形コンテンツ
この要素が使用できる文脈:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツですが、インタラクティブコンテンツの子孫や、tabindex属性が指定された子孫が存在してはなりません。
text/htmlでのタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
command — 対象の要素に実行すべきアクションを示します。
commandfor — 呼び出す別の要素を対象とします。
disabled — フォームコントロールが無効化されているかどうか
form — この要素をフォーム要素と関連付けます
formaction — URLをフォーム送信に使用します
formenctype — エントリリストエンコードタイプをフォーム送信に使用します
formmethod — フォーム送信に使用するバリアント
formnovalidate — フォーム送信時にフォームコントロール検証をバイパスします
formtarget — ナビゲート可能をフォーム送信のために
name — フォーム送信およびform.elements APIで使用するこの要素の名前
popovertarget — トグル、表示、非表示にするポップオーバー要素をターゲットにします
popovertargetaction — ターゲットとするポップオーバー要素がトグル、表示、非表示のどれになるかを示します
type — ボタンの種類
value — フォーム送信に使用される値
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース:
[Exposed=Window]
interface HTMLButtonElement : HTMLElement {
  [HTMLConstructor] constructor();

  [CEReactions] attribute DOMString command;
  [CEReactions] attribute Element? commandForElement;
  [CEReactions] attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
  [CEReactions] attribute USVString formAction;
  [CEReactions] attribute DOMString formEnctype;
  [CEReactions] attribute DOMString formMethod;
  [CEReactions] attribute boolean formNoValidate;
  [CEReactions] attribute DOMString formTarget;
  [CEReactions] attribute DOMString name;
  [CEReactions] attribute DOMString type;
  [CEReactions] attribute DOMString value;

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  boolean reportValidity();
  undefined setCustomValidity(DOMString error);

  readonly attribute NodeList labels;
};
HTMLButtonElement includes PopoverInvokerElement;

button要素は、その内容によってラベル付けされるボタンを表します。

この要素はボタンです。

type属性は、ボタンがアクティブになったときの動作を制御します。これは列挙された属性で、次のキーワードと状態があります:

キーワード 状態 簡単な説明
submit 送信ボタン フォームを送信します。
reset リセットボタン フォームをリセットします。
button ボタン 何もしません。

属性の欠損値のデフォルトおよび無効値のデフォルトは、どちらも自動状態です。

button要素は、次のいずれかが真である場合、送信ボタンであると言われます。

制約検証：要素が送信ボタンでない場合、要素は制約検証から除外されます。

指定されている場合、commandfor属性値は、commandfor属性を持つボタンと同じツリー内の要素のIDでなければなりません。

command属性は、次のキーワードと状態を持つ列挙属性です。

キーワード 状態 簡単な説明
toggle-popover ポップオーバーの切り替え 対象のpopover要素を表示または非表示にします。
show-popover ポップオーバーの表示 対象のpopover要素を表示します。
hide-popover ポップオーバーの非表示 対象のpopover要素を非表示にします。
close 閉じる 対象のdialog要素を閉じます。
request-close クローズを要求 対象の dialog 要素を閉じるよう要求します。
show-modal モーダルの表示 対象のdialog要素をモーダルとして開きます。
カスタムコマンドキーワード カスタム 対象の要素に対してcommandイベントのみをディスパッチします。

属性の欠損値のデフォルトおよび無効値のデフォルトは、どちらも不明状態です。

カスタムコマンドキーワードは、「--」で始まる文字列です。

button要素elementのeventに与えられたアクティベーション動作は次の通りです:

  1. elementが無効化されている場合、戻ります。

  2. elementのノードドキュメントが完全にアクティブでない場合、戻ります。

  3. elementにフォームオーナーがある場合：

    1. elementが送信ボタンである場合、eventのユーザーナビゲーション関与にuserInvolvementを設定して、elementからelementのフォームオーナーを送信し、戻ります。

    2. elementのtype属性がリセットボタン状態である場合、elementのフォームオーナーをリセットし、戻ります。

    3. elementのtype属性が自動状態である場合、戻ります。

  4. targetを、elementのcommandfor-関連要素を取得するを実行した結果とします。

  5. targetがnullでない場合：

    1. commandをelementのcommand属性とします。

    2. commandが不明状態である場合、戻ります。

    3. targetのpopover属性がNo Popover状態でない場合はisPopoverをtrueとし、それ以外の場合はfalseとします。

    4. isPopoverがfalseであり、かつcommandがカスタム状態でない場合：

      1. 表明：targetの名前空間はHTML名前空間です。

      2. この標準がtargetのローカル名に対して有効なインボーカーコマンドステップであるを定義していない場合、戻ります。

      3. それ以外の場合、commandを指定してtargetの対応する有効なインボーカーコマンドステップであるを実行した結果がfalseである場合、戻ります。

    5. continueを、command属性をcommandに、source属性をelementに初期化し、cancelable属性とcomposed属性をtrueに初期化して、CommandEventを使用してtargetでcommandという名前のイベントを発火させた結果とします。

      DOM標準の問題#1328は、イベントで意味をなす方法で関連イベントデータをより適切に標準化する方法を追跡しています。現在、値に初期化されたイベント属性はゲッターを持つこともできないため、これを適切に指定するには内部スロット（または追加フィールドのマップ）が必要です。

    6. continueがfalseの場合、戻ります。

    7. targetが接続されていない場合、戻ります。

    8. commandがカスタム状態である場合、戻ります。

    9. commandがポップオーバー非表示状態である場合：

      1. target、true、false、およびnullを指定してpopoverの有効性を確認するを実行した結果がtrueである場合、target、true、true、およびfalseを指定してpopover非表示アルゴリズムを実行します。

    10. それ以外の場合、commandがポップオーバー切り替え状態である場合：

      1. target、false、false、および null を指定してポップオーバーの有効性を確認した結果が true の場合、target、false、およびthis を指定してポップオーバー表示アルゴリズムを実行します。

      2. それ以外の場合、target、true、false、およびnullを指定してpopoverの有効性を確認するを実行した結果がtrueである場合、target、true、true、およびfalseを指定してpopover非表示アルゴリズムを実行します。

    11. それ以外の場合、commandがポップオーバー表示状態である場合：

      1. target、false、false、および null を指定してポップオーバーの有効性を確認した結果が true の場合、target、false、およびthis を指定してポップオーバー表示アルゴリズムを実行します。

    12. それ以外の場合、この標準がtargetのローカル名に対してインボーカーコマンドステップを定義している場合、target、element、およびcommandを指定して対応するインボーカーコマンドステップを実行します。

  6. それ以外の場合、elementとeventのターゲットを指定して、popoverターゲット属性アクティベーション動作を実行します。

HTML要素は、要素のローカル名に対して定義された特定の呼び出し元コマンドステップが有効であるかおよび呼び出し元コマンドステップを持つことができます。

form属性は、button要素をそのフォームオーナーに明示的に関連付けるために使用されます。name属性は要素の名前を表します。disabled属性は、コントロールを非対話的にし、その値が送信されるのを防ぐために使用されます。formaction、formenctype、formmethod、formnovalidate、およびformtarget属性は、フォーム送信のための属性です。

formnovalidate属性は、制約検証をトリガーしない送信ボタンを作成するために使用できます。

formaction、formenctype、formmethod、formnovalidate、およびformtargetは、要素が送信ボタンでない場合は指定してはなりません。

commandForElement IDL属性は、要素のcommandforコンテンツ属性を反映しなければなりません。

commandゲッターのステップは次のとおりです。

  1. commandを、thisのcommand属性とします。

  2. commandがカスタム状態の場合、commandの値を返します。

  3. commandが不明状態の場合、空文字列を返します。

  4. commandの値に対応するキーワードを返します。

commandセッターのステップは、commandコンテンツ属性を指定された値に設定することです。

value 属性は、フォーム送信の目的で要素の値を与えます。要素の値は、要素のvalue属性の値です。存在しない場合は空の文字列です。 要素のオプションの値は、要素のvalue属性の値です。存在しない場合は null です。

ボタン（およびその値）は、ボタン自体がフォーム送信を開始するために使用された場合にのみ、フォーム送信に含まれます。

value IDL属性は、同じ名前のコンテンツ属性を反映しなければなりません。

type ゲッターのステップは次のとおりです。

  1. thisが送信ボタンである場合、「submit」を返します。

  2. stateを、thisのtype属性とします。

  3. 表明：stateは送信ボタン状態ではありません。

  4. stateが自動状態である場合、「button」を返します。

  5. stateに対応するキーワード値を返します。

typeセッターのステップは、typeコンテンツ属性を指定された値に設定することです。

willValidate、validity、およびvalidationMessageIDL属性、およびcheckValidity()、reportValidity()、setCustomValidity()メソッドは、制約検証APIの一部です。labelsIDL属性は、この要素のラベルのリストを提供します。disabled、form、およびnameIDL属性は、この要素のフォームAPIの一部です。

次のボタンは「ヒントを表示」とラベル付けされており、アクティブにするとダイアログボックスが表示されます:

<button type=button
     onclick="alert('この15〜20分の作品はジョージ・ガーシュウィンによって作曲されました。')">
Show hint
</button>

以下は、ボタンがアクティブ化されたときにcommandforを使用してpopover属性を持つ要素を表示および非表示にする方法を示しています。 

<button type=button
        commandfor="the-popover"
        command="show-popover">
 Show menu
</button>
<div popover
     id="the-popover">
 <button commandfor="the-popover"
         command="hide-popover">
  Hide menu
 </button>
</div>

以下は、ボタンが要素上のカスタムコマンドキーワードとともにcommandforを使用する方法を示しており、未指定の動作に対してカスタムコマンドを使用する方法を示しています。 

<button type=button
        commandfor="the-image"
        command="--rotate-landscape">
 Rotate Left
</button>
<button type=button
        commandfor="the-image"
        command="--rotate-portrait">
 Rotate Right
</button>
<img id="the-image"
     src="photo.jpg">
<script>
  const image = document.getElementById("the-image");
  image.addEventListener("command", (event) => {
   if ( event.command == "--rotate-landscape" ) {
    event.target.style.rotate = "-90deg"
   } else if ( event.command == "--rotate-portrait" ) {
    event.target.style.rotate = "0deg"
   }
  });
</script>

4.10.7 select要素

要素/select

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera2+ Edge79+
Edge (Legacy)12+ Internet ExplorerYes
Firefox Android4+ Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android10.1+

HTMLSelectElement

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera2+ Edge79+
Edge (Legacy)12+ Internet Explorer1+
Firefox Android4+ Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android10.1+
カテゴリ:
フローコンテンツ
フレージングコンテンツ
インタラクティブコンテンツ
リストされる、ラベル可能、送信可能、リセット可能、および自動大文字化を継承する フォーム関連要素。
感知可能なコンテンツ
この要素が使用される文脈:
フレージングコンテンツが期待される場所。
コンテンツモデル:
ゼロまたは複数のoption、optgroup、hr、およびスクリプトサポート要素。
text/htmlでのタグの省略:
タグは省略できません。
コンテンツ属性:
グローバル属性
autocomplete — フォームの自動入力機能のヒント
disabled — フォームコントロールが無効かどうか
form — 要素をform要素に関連付ける
multiple — 複数の値を許可するかどうか
name — フォーム送信で使用する要素の名前およびform.elementsAPIでの名前
required — フォーム送信に必要かどうか
size — コントロールのサイズ
アクセシビリティの考慮事項:
要素にmultiple属性またはsize属性があり、値が1より大きい場合: 作成者向け; 実装者向け。
それ以外の場合: 作成者向け; 実装者向け。
DOMインターフェース:
[Exposed=Window]
 interface HTMLSelectElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString autocomplete;
   [CEReactions] attribute boolean disabled;
   readonly attribute HTMLFormElement? form;
   [CEReactions] attribute boolean multiple;
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute boolean required;
   [CEReactions] attribute unsigned long size;
 
   readonly attribute DOMString type;
 
   [SameObject] readonly attribute HTMLOptionsCollection options;
   [CEReactions] attribute unsigned long length;
   getter HTMLOptionElement? item(unsigned long index);
   HTMLOptionElement? namedItem(DOMString name);
   [CEReactions] undefined add((HTMLOptionElement or HTMLOptGroupElement) element, optional (HTMLElement or long)? before = null);
   [CEReactions] undefined remove(); // ChildNode overload
   [CEReactions] undefined remove(long index);
   [CEReactions] setter undefined (unsigned long index, HTMLOptionElement? option);
 
   [SameObject] readonly attribute HTMLCollection selectedOptions;
   attribute long selectedIndex;
   attribute DOMString value;
 
   readonly attribute boolean willValidate;
   readonly attribute ValidityState validity;
   readonly attribute DOMString validationMessage;
   boolean checkValidity();
   boolean reportValidity();
   undefined setCustomValidity(DOMString error);
 
   undefined showPicker();
 
   readonly attribute NodeList labels;
 };

select 要素は、オプションのセットから選択するためのコントロールを表します。

Attributes/multiple

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

multiple 属性は ブール属性 です。この属性が存在する場合、select 要素は 0個以上のオプションを選択するためのコントロール です。この属性が存在しない場合、select 要素は 1つのオプションを選択するためのコントロール です。

Attributes/size

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

size 属性は、ユーザーに表示するオプションの数を指定します。size 属性が指定されている場合、その値は 有効な非負整数 でなければなりません。

表示サイズ とは、select 要素の size 属性の値に 非負整数の解析ルール を適用した結果です。これらのルールを適用して解析に失敗した場合、または size 属性が存在しない場合、要素の 表示サイズ は4になります。この要素の multiple 属性が存在する場合は4、存在しない場合は1です。

オプションのリスト は、select 要素のすべての option 要素の子、またはすべての optgroup 要素の子として select 要素の子として存在するすべての option 要素の子から構成され、ツリー順 で並べられています。

Attributes/required

すべての現在のエンジンでサポートされています。

Firefox4+Safari5.1+Chrome10+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

required 属性は ブール属性 です。指定された場合、フォームを送信する前に値を選択する必要があります。

select 要素に required 属性が指定され、multiple 属性が指定されておらず、表示サイズ が 1 であり、最初のオプション要素の値 が空文字列で、その option 要素の親ノードが select 要素 ( optgroup 要素ではなく) である場合、その option は select 要素の プレースホルダーラベルオプション です。

select 要素に required 属性が指定され、multiple 属性が指定されておらず、表示サイズ が 1 である場合、その select 要素には プレースホルダーラベルオプション が必要です。

実際には、上記の段落で述べられた要件は、select 要素に size 属性が指定されていない場合にのみ適用されます。

制約検証: この要素に required 属性が指定されていて、option 要素のいずれにも 選択されている 設定がない場合、または唯一の option 要素の 選択状態 が プレースホルダーラベルオプション である場合、この要素は 欠落している と見なされます。

multiple 属性が存在せず、要素が 無効 でない場合、ユーザーエージェントはユーザーが option 要素を選択できるようにする必要があります。オプションのリスト 内で、 無効 でないオプションを選択できるようにする必要があります。この option 要素が 選択される と、関連するユーザーインタラクションイベントがキューに入る前 (例: クリック イベントの前)、ユーザーエージェントは選択された option 要素の 選択状態 を true に設定し、その 不整合 を true に設定し、 更新通知 を送信する必要があります。

multiple 属性が存在せず、option 要素が オプションのリスト にあるとき、ユーザーエージェントは、他のすべての option 要素の 選択状態 を false に設定する必要があります。

multiple 属性が存在せず、要素の 表示サイズ が1を超える場合、ユーザーエージェントはユーザーが option の選択状態を false に設定する要求をすることができるようにする必要があります。この要求がユーザーエージェントに伝えられると、その option 要素の 選択状態 を false に設定し、その 不整合 を true に設定し、 更新通知 を送信する必要があります。

選択状態設定アルゴリズム は、select 要素 element に対して、以下の手順を実行します。

  1. element の multiple 属性が存在せず、element の 表示サイズ が 1 であり、element の オプションのリスト に 選択状態 が true に設定された option 要素が存在しない場合、無効 でない最初の option 要素の ツリー順 で、これを true に設定します。

  2. element の multiple 属性が存在せず、element の オプションのリスト に option 要素が 2 つ以上存在し、それらの 選択状態 が true に設定されている場合、選択状態 を設定して、最後の option 要素を除いて他のすべての ツリー順 で false に設定します。

option HTML 要素挿入手順 は、insertedNode を受け取ったとき、次のように実行します。

  1. insertedNode の親が select 要素である場合、またはその親が optgroup 要素であり、その親が select 要素である場合、その 選択状態設定アルゴリズム を実行します。

option HTML 要素削除手順 は、removedNode と oldParent を受け取ったとき、次のように実行します。

  1. oldParent が select 要素である場合、または oldParent が optgroup 要素であり、その親が select 要素である場合、その 選択状態設定アルゴリズム を実行します。

movedNodeとoldParentを指定した、option HTML要素移動ステップは次のとおりです。

  1. movedNodeとoldParentを指定して、option HTML要素削除ステップを実行します。

  2. movedNodeを指定して、option HTML要素挿入ステップを実行します。

removedNodeとoldParentを指定した、optgroup HTML要素削除ステップは次のとおりです。

  1. oldParentがselect要素であり、removedNodeがoptionの子を持つ場合、oldParentの選択状態設定アルゴリズムを実行します。

movedNodeとoldParentを指定した、optgroup HTML要素移動ステップは次のとおりです。

  1. movedNodeとoldParentを指定して、optgroup HTML要素削除ステップを実行します。

オプションのリスト内のoption要素がリセットを要求する場合、そのselect要素の選択状態設定アルゴリズムを実行します。

multiple属性が存在し、要素が無効になっていない場合、ユーザーエージェントは、それ自体が無効になっていないオプションのリスト内のoption要素の選択状態をユーザーが切り替えることを許可すべきです。そのような要素が（クリック、メニューコマンド、またはその他のメカニズムによって）切り替えられた場合、関連するユーザーインタラクションイベントがキューに入れられる前（たとえば、関連するclickイベントの前）に、option要素の選択状態を変更し（trueからfalseへ、またはfalseからtrueへ）、要素のダーティ状態をtrueに設定し、ユーザーエージェントはselect更新通知を送信しなければなりません。

ユーザーエージェントが select 更新通知 を送信する場合、エレメントタスクをキュー に配置し、ユーザーインタラクションタスクのソース を指定して次のステップを実行します。

  1. select 要素の ユーザー有効性 を true に設定します。

  2. イベントを発生 させ、input イベントを select 要素に対して バブル と 構成 属性を true に初期化します。

  3. イベントを発生 させ、change イベントを select 要素に対して バブル 属性を true に初期化します。

リセットアルゴリズム は select 要素 selectElement に対して実行されます。

  1. selectElement の ユーザー有効性 を false に設定します。

  2. 各 optionElement に対して selectElement の オプションのリスト を実行します。

    1. optionElement が 選択済み 属性を持つ場合、その 選択状態 を true に設定します。それ以外の場合は false に設定します。

    2. optionElement の 不整合 を false に設定します。

  3. 選択状態設定アルゴリズム を実行し、 selectElement に設定します。

form 属性は、 select 要素とその フォームオーナー を明示的に関連付けるために使用されます。name 属性は、要素の名前を表します。disabled 属性は、コントロールを非インタラクティブにし、その値が送信されるのを防ぐために使用されます。autocomplete 属性は、ユーザーエージェントがオートフィルの動作を提供する方法を制御します。

select要素が無効でない場合、変更可能です。

select.type

HTMLSelectElement/type

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera2+Edge79+
Edge (Legacy)12+Internet Explorer1+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

要素にmultiple属性がある場合は "select-multiple" を返し、それ以外の場合は "select-one" を返します。

select.options

HTMLSelectElement/options

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

オプションリストから HTMLOptionsCollection を返します。

select.length [ = value ]

オプションリスト内の要素の数を返します。

小さい数値を設定した場合、option要素の数を select 内で切り詰めます。

大きい数値を設定した場合、空のoption要素を select に追加します。

element = select.item(index)

HTMLSelectElement/item

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
select[index]

index番目の項目をオプションリストから返します。項目はツリー順序でソートされています。

element = select.namedItem(name)

HTMLSelectElement/namedItem

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

IDまたはname nameに一致する最初の項目をオプションリストから返します。

そのIDを持つ要素が見つからない場合、nullを返します。

select.add(element [, before ])

HTMLSelectElement/add

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

elementをbeforeで指定されたノードの前に挿入します。

before引数は数値にすることができ、その場合、elementはその番号の項目の前に挿入されます。またはオプションリストから要素を指定することもでき、その場合、elementはその要素の前に挿入されます。

beforeが省略された場合、nullの場合、または範囲外の数値の場合、elementはリストの最後に追加されます。

このメソッドは、elementが挿入先の要素の祖先である場合、"HierarchyRequestError" DOMExceptionをスローします。

select.selectedOptions

HTMLSelectElement/selectedOptions

すべての現在のエンジンでサポートされています。

Firefox26+Safari6+Chrome19+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

選択されているオプションリストのHTMLCollection を返します。

select.selectedIndex [ = value ]

HTMLSelectElement/selectedIndex

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

最初に選択されている項目のインデックスを返します。選択されている項目がない場合は -1 を返します。

設定することで、選択を変更できます。

select.value [ = value ]

最初に選択されている項目の値を返します。選択されている項目がない場合は空の文字列を返します。

設定することで、選択を変更できます。

select.showPicker()

selectに適用可能なピッカーUIを表示して、ユーザーが値を選択できるようにします。

selectが可変でない場合、"InvalidStateError" DOMExceptionがスローされます。

一時的なユーザーアクティベーションなしで呼び出された場合、"NotAllowedError" DOMExceptionがスローされます。

selectがクロスオリジンのiframe内にある場合、"SecurityError" DOMExceptionがスローされます。

selectが描画中でない場合、"NotSupportedError" DOMExceptionがスローされます。

type IDL属性の取得時、multiple 属性がない場合は文字列"select-one"を返し、multiple 属性がある場合は文字列"select-multiple"を返す必要があります。

options IDL属性は、 HTMLOptionsCollection を返す必要があり、それはselect ノードを基点とし、フィルターがオプションリスト内の要素に一致します。

options コレクションは HTMLSelectElement オブジェクトにも反映されます。 任意の瞬間におけるサポートされているプロパティインデックスは、その瞬間にoptions属性によって返されるオブジェクトによってサポートされるインデックスです。

length IDL属性は、コレクションにより表現されたノードの数を返す必要があります。 設定時には、options コレクション上の同名の属性と同じように動作する必要があります。

item(index)メソッドは、options コレクション上の同名のメソッドが、同じ引数で呼び出されたときに返す値を返す必要があります。

namedItem(name)メソッドは、options コレクション上の同名のメソッドが、同じ引数で呼び出されたときに返す値を返す必要があります。

ユーザーエージェントが新しいインデックスプロパティの値を設定するか既存のインデックスプロパティの値を設定するとき、それはselect要素の options コレクション上で対応するアルゴリズムを実行しなければなりません。

同様に、add(element, before)メソッドは、その同じoptions コレクション上の同名のメソッドのように動作する必要があります。

HTMLSelectElement/remove

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

remove() メソッドは、引数がある場合はその同じoptions コレクション上の同名のメソッドのように動作し、引数がない場合はその祖先インターフェースであるChildNode インターフェースを実装しているHTMLSelectElement 上の同名のメソッドのように動作する必要があります。

selectedOptions IDL属性は、 選択されている オプションリスト内の要素に一致するフィルターを持つHTMLCollection を返す必要があります。

selectedIndex IDL属性は、取得時に、オプションリスト内で、ツリー順序で、選択されている最初のoption要素のインデックスを返す必要があります。存在しない場合は-1を返す必要があります。

設定時に、selectedIndex 属性は、オプションリスト内のすべてのoption要素の選択状態をfalseに設定し、その後、新しい値に対応するインデックスを持つ、もしあれば、option要素の選択状態をtrueに設定し、その不完全状態をtrueに設定する必要があります。

これにより、select要素にmultiple属性がなく、表示サイズが1の場合でも、いずれの要素にも選択状態が設定されないことがあります。

value IDL属性は、取得時に、値を返す必要があります。 オプションリスト内でツリー順序で選択状態がtrueに設定されている最初のoption要素の値を返します。存在しない場合は空文字列を返す必要があります。

設定時に、value 属性は、オプションリスト内のすべてのoption要素の選択状態をfalseに設定し、その後、新しい値に等しい値を持つ最初のoption要素に選択状態をtrueに設定し、その不完全状態をtrueに設定する必要があります。

これにより、select要素にmultiple属性がなく、表示サイズが1の場合でも、いずれの要素にも選択状態が設定されないことがあります。

multiple、required、およびsize IDL属性は、それぞれ同名のコンテンツ属性を反映する必要があります。 sizeIDL属性にはデフォルト値が0です。

歴史的な理由により、sizeIDL属性のデフォルト値は、実際に使用されるサイズを返しません。これは、sizeコンテンツ属性がない場合、multiple属性の有無に応じて、サイズが1または4になるためです。

willValidate、 validity、およびvalidationMessage IDL属性、およびcheckValidity()、 reportValidity()、 およびsetCustomValidity() メソッドは、制約検証APIの一部です。labelsIDL属性は、要素のlabelのリストを提供します。disabled、form、および nameIDL属性は、要素のフォームAPIの一部です。

次の例は、select 要素を使用して、ユーザーに一連のオプションを提供し、そこからユーザーが単一のオプションを選択できる方法を示しています。デフォルトのオプションが事前に選択されています。

<p>
  <label for="unittype">ユニットタイプを選択:</label>
  <select id="unittype" name="unittype">
   <option value="1"> マイナー </option>
   <option value="2"> パファー </option>
   <option value="3" selected> スナイピー </option>
   <option value="4"> マックス </option>
   <option value="5"> ファイヤーボット </option>
  </select>
 </p>

デフォルトオプションがない場合、代わりにプレースホルダーを使用できます:

<select name="unittype" required>
  <option value=""> ユニットタイプを選択 </option>
  <option value="1"> マイナー </option>
  <option value="2"> パファー </option>
  <option value="3"> スナイピー </option>
  <option value="4"> マックス </option>
  <option value="5"> ファイヤーボット </option>
 </select>

ここでは、ユーザーは任意の数のオプションを選択できます。デフォルトでは、5つのオプションすべてが選択されています。

<p>
  <label for="allowedunits">このマップで有効にするユニットタイプを選択:</label>
  <select id="allowedunits" name="allowedunits" multiple>
   <option value="1" selected> マイナー </option>
   <option value="2" selected> パファー </option>
   <option value="3" selected> スナイピー </option> 
   <option value="4" selected> マックス </option>
   <option value="5" selected> ファイヤーボット </option>
  </select>
 </p>

時々、ユーザーは1つ以上の項目を選択する必要があります。この例では、そのようなインターフェースを示しています。

<label>
 Select the songs from that you would like on your Act II Mix Tape:
 <select multiple required name="act2">
  <option value="s1">It Sucks to Be Me (Reprise)
  <option value="s2">There is Life Outside Your Apartment
  <option value="s3">The More You Ruv Someone
  <option value="s4">Schadenfreude
  <option value="s5">I Wish I Could Go Back to College
  <option value="s6">The Money Song
  <option value="s7">School for Monsters
  <option value="s8">The Money Song (Reprise)
  <option value="s9">There's a Fine, Fine Line (Reprise)
  <option value="s10">What Do You Do With a B.A. in English? (Reprise)
  <option value="s11">For Now
 </select>
</label>

時々、セパレーターを持つことが役立つ場合があります: 

<label>
 Select the song to play next:
 <select required name="next">
  <option value="sr">Random
  <hr>
  <option value="s1">It Sucks to Be Me (Reprise)
  <option value="s2">There is Life Outside Your Apartment
  …

4.10.8 datalist要素

Element/datalist

Firefox🔰 4+Safari12.1+Chrome20+
Opera9.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android🔰 79+Safari iOS?Chrome Android33+WebView Android?Samsung Internet?Opera Android?

HTMLDataListElement

すべての現在のエンジンでサポートされています。

Firefox4+Safari12.1+Chrome20+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android4.4.3+Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
この要素が使用されるコンテキスト:
フレージングコンテンツ が期待される場所。
コンテンツモデル:
フレージングコンテンツのいずれか。
または、option要素およびスクリプトサポート要素が0個以上。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOMインターフェース: 
[Exposed=Window]
 interface HTMLDataListElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [SameObject] readonly attribute HTMLCollection options;
 };

datalist 要素は、他のコントロールのための事前定義されたオプションを表すoption要素のセットを表します。レンダリングでは、datalist 要素は何も表さず、その子要素とともに非表示にする必要があります。

datalist 要素は、2つの方法で使用できます。最も単純な場合、datalist 要素にはoption 要素の子が含まれます。 

<label>
  動物:
  <input name=animal list=animals>
  <datalist id=animals>
   <option value="猫">
   <option value="犬">
  </datalist>
 </label>

より複雑な場合、datalist 要素に、datalistをサポートしない下位レベルのクライアント向けに表示するコンテンツを与えることができます。この場合、option要素はselect要素内に提供され、datalist要素内に含まれます。 

<label>
 Animal:
 <input name=animal list=animals>
</label>
<datalist id=animals>
 <label>
  or select from the list:
  <select name=animal>
   <option value="">
   <option>Cat
   <option>Dog
  </select>
 </label>
</datalist>

datalist 要素は、input要素に、list属性を使用して接続されます。

option 要素は、datalist 要素の子孫であり、無効化されておらず、その値が空文字列でない文字列である場合、提案を表します。それぞれの提案には値とラベルがあります。

datalist.options

HTMLCollection を返し、そのコレクションには、option要素が含まれます。 これらの要素はdatalist要素の子孫です。

options IDL属性は、HTMLCollection を返し、それはdatalist ノードを基点とし、フィルターがoption 要素に一致します。

制約検証: 要素にdatalist 要素の祖先がある場合、それは制約検証から除外されます。

4.10.9 optgroup要素

Element/optgroup

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLOptGroupElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
この要素が使用されるコンテキスト:
select 要素の子要素として。
コンテンツモデル:
option およびスクリプトサポート要素が0個以上。
text/htmlでのタグ省略:
optgroup 要素の終了タグは、次に別のoptgroup 要素が続く場合、または次に hr要素が続く場合、もしくは親要素内にコンテンツが残っていない場合に省略できます。
コンテンツ属性:
グローバル属性
disabled — フォームコントロールが無効かどうか
label — ユーザーに表示されるラベル
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOMインターフェース: 
[Exposed=Window]
 interface HTMLOptGroupElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute boolean disabled;
   [CEReactions] attribute DOMString label;
 };

optgroup 要素は、共通のラベルを持つoption 要素のグループを表します。

要素のグループは、option要素で構成され、その要素はoptgroup要素の子要素です。

option 要素をselect 要素内に表示する際、ユーザーエージェントは、そのグループのoption 要素を他のoption 要素と区別して関連付けて表示する必要があります。

Attributes/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

disabled 属性はboolean 属性であり、無効な option 要素のグループを一緒に無効にするために使用できます。

label 属性は必ず指定されなければなりません。その値は、ユーザーインターフェースの目的で、グループの名前を示します。ユーザーエージェントは、この属性の値を使用して、 option 要素のグループにラベルを付ける必要があります。

disabled属性とlabel属性は、それぞれ同名のコンテンツ属性を反映しなければなりません。

optgroup 要素を選択する方法はありません。選択できるのはoption 要素のみです。 optgroup 要素は単にoption 要素のグループにラベルを提供するだけです。

以下のスニペットは、3つのコースからの一連のレッスンをselect ドロップダウンウィジェットで提供する方法を示しています: 

<form action="courseselector.dll" method="get">
  <p>どのコースを今日は視聴しますか？
  <p><label>コース:
   <select name="c">
    <optgroup label="8.01 物理学 I: 古典力学">
     <option value="8.01.1">レクチャー01： 10の冪
     <option value="8.01.2">レクチャー02： 1次元運動学
     <option value="8.01.3">レクチャー03： ベクトル
    <optgroup label="8.02 電気と磁気">
     <option value="8.02.1">レクチャー01： 我々の世界を支えているものは何か？
     <option value="8.02.2">レクチャー02： 電場
     <option value="8.02.3">レクチャー03： 電気束
    <optgroup label="8.03 物理学 III: 振動と波動">
     <option value="8.03.1">レクチャー01： 周期的現象
     <option value="8.03.2">レクチャー02： 拍
     <option value="8.03.3">レクチャー03： 減衰付き強制振動
   </select>
  </label>
  <p><input type=submit value="▶ 再生">
 </form>

4.10.10 option 要素

Element/option

すべての最新エンジンでサポート。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLOptionElement

すべての最新エンジンでサポート。

Firefox1+Safari1.2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし。
使用できる文脈:
select 要素の子として使用する場合。
datalist 要素の子として使用する場合。
optgroup 要素の子として使用する場合。
内容モデル:
要素が label 属性と value 属性を持つ場合: 内容なし。
要素が label 属性を持ち、value 属性を持たない場合: テキスト。
要素が label 属性を持たず、datalist 要素の子でない場合: テキスト（要素間の空白は含まれません）。
要素が label 属性を持たず、datalist 要素の子である場合: テキスト。
text/htmlにおけるタグの省略:
option 要素の 終了タグ は、option 要素が直後に続く場合、optgroup 要素が直後に続く場合、または親要素内にこれ以上コンテンツがない場合に省略可能です。
コンテンツ属性:
グローバル属性
disabled — フォームコントロールが無効かどうか
label — ユーザーが目にするラベル
selected — オプションがデフォルトで選択されているかどうか
value — フォーム送信に使用される値
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェイス: 
[Exposed=Window,
  LegacyFactoryFunction=Option(optional DOMString text = "", optional DOMString value, optional boolean defaultSelected = false, optional boolean selected = false)]
 interface HTMLOptionElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute boolean disabled;
   readonly attribute HTMLFormElement? form;
   [CEReactions] attribute DOMString label;
   [CEReactions] attribute boolean defaultSelected;
   attribute boolean selected;
   [CEReactions] attribute DOMString value;
 
   [CEReactions] attribute DOMString text;
   readonly attribute long index;
 };

option 要素は、select 要素のオプションまたは datalist 要素のサジェストリストの一部を表します。

select 要素の定義で説明されている特定の状況では、option 要素が select 要素の プレースホルダーラベルオプション になることがあります。プレースホルダーラベルオプション は、実際のオプションを表すのではなく、select コントロールのラベルを表します。

属性/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (旧バージョン)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

disabled 属性は Boolean 属性 です。option 要素が 無効 であるかどうかは、disabled 属性が存在するかどうか、または optgroup 要素の子要素で、その disabled 属性が存在するかどうかで決まります。

option 要素が 無効 な場合、その要素で click イベントが発生しないようにする必要があります。これにより、タスクをキューに追加 してから、その要素に対して ユーザーインタラクションタスクソース からタスクが発生することを防ぎます。

label 属性は要素のラベルを提供します。option 要素の ラベル は、label コンテンツ属性の値（存在し、その値が空でない場合）か、そうでない場合は、要素の text IDL 属性の値です。

label コンテンツ属性は、指定されている場合、空であってはなりません。

value 属性は、要素の値を提供します。option 要素の 値 は、value コンテンツ属性の値（存在する場合）か、そうでない場合は、要素の text IDL 属性の値です。

selected 属性は Boolean 属性 です。これは要素のデフォルトの 選択状態 を表します。

ダーティネス とは、option 要素の状態を示すブール値で、初期値は false です。これは、selected コンテンツ属性を追加または削除したときに影響を与えるかどうかを制御します。

選択状態 とは、option 要素の状態を示すブール値で、初期値は false です。特に指定がない限り、要素が作成されたとき、その 選択状態 は selected 属性が存在する場合 true に設定されます。

option 要素の selected 属性が追加された場合、ダーティネス が false の場合は、選択状態 を true に設定する必要があります。option 要素の selected 属性が削除された場合、ダーティネス が false なら、その 選択状態 を false に設定する必要があります。

Option() コンストラクターは、引数が3つ以下の場合、選択状態 の初期状態を上書きし、第三引数が true であっても常に false に設定します。これにより selected 属性が設定されます。第四引数を使用して、コンストラクターを使用するときに初期の 選択状態 を明示的に設定することができます。

select 要素に multiple 属性が指定されていない場合、その子孫の option 要素には、selected 属性が設定されている要素が一つだけでなければなりません。

option 要素の インデックス は、同じ オプションリスト にある他の option 要素のうち、ツリーの順序で前にあるものの数です。option 要素が オプションリスト に含まれていない場合、その option 要素の インデックス は 0 です。

option.selected

要素が選択されている場合は true を、そうでない場合は false を返します。

現在の状態を上書きするために設定することができます。

option.index

要素が属する select 要素の options リスト内のインデックスを返します。

option.form

要素が属する form 要素を返します。存在しない場合は null を返します。

option.text

textContent と同様ですが、スペースが圧縮され、script 要素がスキップされます。

option = new Option([ text [, value [, defaultSelected [, selected ] ] ] ])

HTMLOptionElement/Option

すべての現在のエンジンでサポートされています。

Firefox1+Safari1.2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

新しい option 要素を返します。

text 引数は要素の内容を設定します。

value 引数は value 属性を設定します。

defaultSelected 引数は selected 属性を設定します。

selected 引数は要素が選択されているかどうかを設定します。省略された場合、defaultSelected 引数が true であっても、要素は選択されません。

disabled IDL 属性は、同じ名前のコンテンツ属性を 反映 しなければなりません。defaultSelected IDL 属性も、selected コンテンツ属性を 反映 しなければなりません。

label IDL 属性は、取得時に label コンテンツ属性が存在する場合はその値を返さなければならず、そうでない場合は要素の ラベル を返さなければなりません。設定時には、要素の label コンテンツ属性を新しい値に設定しなければなりません。

value IDL 属性は、取得時には要素の 値 を返さなければならず、設定時には要素の value コンテンツ属性を新しい値に設定しなければなりません。

selected IDL 属性は、取得時に要素の 選択状態 が true であれば true を返し、そうでない場合は false を返さなければなりません。設定時には、要素の 選択状態 を新しい値に設定し、その要素の ダーティネス を true に設定し、その後、要素に リセットを依頼 させなければなりません。

index IDL 属性は、要素の インデックス を返さなければなりません。

text IDL 属性は、取得時には、ASCII スペース文字をストリップおよび圧縮 し、ツリー順で要素のすべての Text ノードの データ を連結した結果を返さなければならず、それらの子孫である script 要素または SVG script 要素の子孫を除外しなければなりません。

text 属性のセッターは、この要素内で指定された値で 文字列をすべて置換 しなければなりません。

form IDL 属性の動作は、option 要素が select 要素内にあるかどうかによって異なります。option 要素が親要素として select 要素を持っている場合、または optgroup 要素を親要素として持ち、その optgroup 要素が親要素として select 要素を持っている場合、その form IDL 属性は、その select 要素の form IDL 属性と同じ値を返さなければなりません。そうでない場合は、null を返さなければなりません。

レガシーのファクトリー関数が提供されており、HTMLOptionElement オブジェクトを作成するために使用されます（createElement() のような DOM のファクトリー メソッドに加えて使用されます）：Option(text, value, defaultSelected, selected)。呼び出されたとき、レガシーのファクトリー関数は以下の手順を実行する必要があります。

  1. document を 現在のグローバル オブジェクト の 関連付けられた Document とします。

  2. optionを、document、「option」、およびHTML名前空間を指定して要素を作成した結果とします。

  3. text が空文字列でない場合、option に Text ノードを追加し、そのデータを text とします。

  4. value が指定されている場合は、"value" を使用して option に 属性値を設定 します。

  5. defaultSelected が true の場合は、"selected" を使用して option に 属性値を設定 し、空の文字列を設定します。

  6. selected が true の場合、option の 選択状態 を true に設定します。それ以外の場合は、defaultSelected が true であっても、その 選択状態 を false に設定します。

  7. option を返します。

4.10.11 textarea要素

Element/textarea

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLTextAreaElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
インタラクティブコンテンツ.
リストされている, ラベル可能, 送信可能, リセット可能, および 大文字化および自動修正継承 フォーム関連要素。
知覚可能なコンテンツ.
この要素を使用できる文脈:
フレージングコンテンツが予期される場所。
コンテンツモデル:
テキスト.
text/htmlにおけるタグの省略:
タグを省略することはできません。
コンテンツ属性:
グローバル属性
autocomplete — フォームの自動入力機能のヒント
cols — 1行あたりの最大文字数
dirname — 要素の方向性をフォーム送信で送信するために使用するフォームコントロールの名前
disabled — フォームコントロールが無効であるかどうか
form — 要素をフォーム要素に関連付ける
maxlength — 値の最大長さ
minlength — 値の最小長さ
name — フォーム送信およびform.elementsAPIで使用する要素の名前
placeholder — フォームコントロール内に表示されるユーザー向けラベル
readonly — ユーザーが値を編集できるかどうか
required — フォーム送信にコントロールが必要かどうか
rows — 表示する行数
wrap — フォーム送信のためにフォームコントロールの値がどのようにラップされるか
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOMインターフェイス: 
[Exposed=Window]
 interface HTMLTextAreaElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString autocomplete;
   [CEReactions] attribute unsigned long cols;
   [CEReactions] attribute DOMString dirName;
   [CEReactions] attribute boolean disabled;
   readonly attribute HTMLFormElement? form;
   [CEReactions] attribute long maxLength;
   [CEReactions] attribute long minLength;
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute DOMString placeholder;
   [CEReactions] attribute boolean readOnly;
   [CEReactions] attribute boolean required;
   [CEReactions] attribute unsigned long rows;
   [CEReactions] attribute DOMString wrap;
 
   readonly attribute DOMString type;
   [CEReactions] attribute DOMString defaultValue;
   attribute [LegacyNullToEmptyString] DOMString value;
   readonly attribute unsigned long textLength;
 
   readonly attribute boolean willValidate;
   readonly attribute ValidityState validity;
   readonly attribute DOMString validationMessage;
   boolean checkValidity();
   boolean reportValidity();
   undefined setCustomValidity(DOMString error);
 
   readonly attribute NodeList labels;
 
   undefined select();
   attribute unsigned long selectionStart;
   attribute unsigned long selectionEnd;
   attribute DOMString selectionDirection;
   undefined setRangeText(DOMString replacement);
   undefined setRangeText(DOMString replacement, unsigned long start, unsigned long end, optional SelectionMode selectionMode = "preserve");
   undefined setSelectionRange(unsigned long start, unsigned long end, optional DOMString direction);
 };

textarea要素は、その要素の生の値のための複数行プレーンテキスト編集コントロールを表します。コントロールの内容はコントロールのデフォルト値を表します。

生の値は、textareaコントロールの初期値は空文字列でなければなりません。

この要素には、双方向アルゴリズムに関わるレンダリング要件があります。

readonly属性は、ユーザーがテキストを編集できるかどうかを制御するブール属性です。

この例では、テキストコントロールは読み取り専用としてマークされています。なぜなら、読み取り専用のファイルを表しているからです:

Filename: <code>/etc/bash.bashrc</code>
 <textarea name="buffer" readonly>
 # System-wide .bashrc file for interactive bash(1) shells.
 
 # To enable the settings / commands in this file for login shells as well,
 # this file has to be sourced in /etc/profile.
 
 # If not running interactively, don't do anything
 [ -z "$PS1" ] &amp;&amp; return
 
 ...</textarea>

制約のバリデーション: readonly属性がtextarea要素に指定されている場合、その要素は制約バリデーションから除外されます。

textarea要素は、変更可能である場合、無効でも、readonly属性が指定されてもいない場合。

textareaが変更可能である場合、その生の値はユーザーによって編集可能であるべきです。ユーザーエージェントは、ユーザーがテキストを編集、挿入、削除し、U+000A LINE FEED (LF) 文字の形で改行を挿入および削除できるようにする必要があります。ユーザーが要素の生の値を変更するたびに、ユーザーエージェントは要素タスクをキューに入れる必要があり、ユーザーインタラクションタスクソースに与えられたtextarea要素にイベントを発火させ、bubblesとcomposed属性をtrueに初期化します。ユーザーエージェントは、ユーザーのインタラクションが一時的に中断されるまで、タスクをキューに入れるのを待つことができます。例えば、ユーザーが100ms間キーを押さなかった場合にイベントを発火させることができ、これにより、各キー押下のたびにイベントを連続的に発火させるのではなく、ユーザーが一時停止したときにのみイベントを発火させます。

textarea要素の汚れ値フラグは、ユーザーがコントロールとインタラクションして生の値を変更したときにtrueに設定される必要があります。

node、copy、およびsubtreeを指定したtextarea要素のクローン作成ステップは、生の価とダーティ値フラグをnodeからcopyに伝播することです。

子供が変わった時の手順では、textarea要素の汚れ値フラグがfalseである場合、その要素の生の値をその要素の子供のテキストコンテンツに設定する必要があります。

textarea要素のリセットアルゴリズムは、ユーザーの有効性をfalseに設定し、ダーティ値フラグをfalseに戻し、生の値をその子テキストコンテンツに設定することです。

textarea要素がオープン要素のスタックからポップオフされたとき、ユーザーエージェントは要素のリセットアルゴリズムを実行する必要があります。

要素が変更可能である場合、ユーザーエージェントは要素の書字方向を左から右または右から左のいずれかに変更できるようにするべきです。ユーザーがこれを行った場合、ユーザーエージェントは次の手順を実行する必要があります:

  1. 要素のdir属性を、ユーザーが左から右の書字方向を選択した場合は"ltr"に、右から左の書字方向を選択した場合は"rtl"に設定します。

  2. 要素タスクをキューに入れる必要があり、ユーザーインタラクションタスクソースに与えられたtextarea要素にイベントを発火させる必要があります。イベント名はinputで、bubblesとcomposed属性がtrueに初期化されます。

cols属性は、1行あたりの最大文字数を指定します。cols属性が指定されている場合、その値は0より大きい有効な非負整数でなければなりません。属性値に対して非負整数の解析ルールを適用し、0より大きい数値が得られた場合、要素の文字幅はその値となります。そうでない場合は20です。

ユーザーエージェントは、要素のtextarea要素の文字幅を、ユーザーに1行あたりにサーバーが希望する文字数のヒントとして提供できます（例えば、視覚的なユーザーエージェントの場合、その幅をその文字数とすることができます）。視覚的なレンダリングでは、ユーザーエージェントはユーザーの入力をレンダリング内でラップし、各行がこの文字数を超えないようにするべきです。

rows属性は、表示する行数を指定します。rows属性が指定されている場合、その値は0より大きい有効な非負整数でなければなりません。属性値に対して非負整数の解析ルールを適用し、0より大きい数値が得られた場合、要素の文字高さはその値となります。そうでない場合は2です。

視覚的なユーザーエージェントは、コントロールの高さを文字高さによって設定するべきです。

wrap属性は、以下のキーワードと状態を持つ列挙属性です:

キーワード 状態 簡単な説明
soft ソフト テキストは送信時にはラップされません（レンダリング中にはラップされる場合があります）。
hard ハード テキストは、送信時にユーザーエージェントによってラップされるように改行が追加されます。

属性の欠落値のデフォルトと無効値のデフォルトはどちらもソフト状態です。

要素のwrap属性がハード状態にある場合、cols属性を指定する必要があります。

歴史的な理由から、要素の値は3つの異なる目的のために3つの異なる方法で正規化されます。生データの値は、最初に設定された値です。これは正規化されません。APIの値は、valueIDL属性、textLengthIDL属性、およびmaxlengthおよびminlengthコンテンツ属性で使用される値です。この値は、行区切りがU+000A LINE FEED (LF)文字に統一されるように正規化されます。最後に、値があり、これはこの仕様のフォーム送信や他の処理モデルで使用されます。これもAPIの値と同様に正規化されますが、さらに必要に応じて、要素のwrap属性に基づいて、テキストが指定された幅で折り返されるように追加の改行が挿入されます。

要素のAPI値を取得するためのアルゴリズムは、要素の生の値を返し、改行を正規化します。

要素の値は、要素のAPI値に定義されており、テキストエリアのラッピング変換を適用します。テキストエリアのラッピング変換は、文字列に適用される次のアルゴリズムです:

  1. 要素のwrap属性がハード状態にある場合、文字列にU+000A LINE FEED (LF) 文字を挿入し、各行に最大で文字幅の文字を持つようにします。この要件の目的のために、行は文字列の開始、終了、およびU+000A LINE FEED (LF) 文字によって区切られます。

maxlength属性はフォームコントロールのmaxlength属性です。

textarea要素が許容される最大値の長さを持つ場合、要素の子孫は次のようになります。要素の長さが、要素の許容される最大値の長さ以下でなければなりません。改行を正規化します。

minlength属性はフォームコントロールのminlength属性です。

required属性はブール属性です。指定されると、フォームを送信する前にユーザーが値を入力する必要があります。

制約のバリデーション: 要素にrequired属性が指定され、要素が変更可能であり、要素の値が空文字列である場合、その要素は欠落に苦しんでいます。

placeholder属性は、コントロールに値がない場合にユーザーのデータ入力を支援するために意図された短いヒント（単語または短いフレーズ）を表します。ヒントは、サンプル値や予想される形式の簡単な説明である場合があります。

placeholder属性は、labelの代替として使用されるべきではありません。より長いヒントや他のアドバイザリーテキストの場合は、title属性の方が適しています。

これらのメカニズムは非常に似ていますが、微妙に異なります。コントロールのlabelによって示されるヒントは常に表示されます。placeholder属性に指定された短いヒントは、ユーザーが値を入力する前に表示されます。そしてtitle属性に指定されたヒントは、ユーザーがさらにヘルプを求めたときに表示されます。

ユーザーエージェントは、このヒントをユーザーに対して、コントロールの値が空文字列であり、コントロールがフォーカスされていないときに表示するべきです（例：空の未フォーカスのコントロール内に表示する）。すべてのU+000D CARRIAGE RETURN U+000A LINE FEED文字のペア（CRLF）、およびヒント内のすべての他のU+000D CARRIAGE RETURN（CR）およびU+000A LINE FEED（LF）文字は、ヒントをレンダリングする際には改行として扱わなければなりません。

ユーザーエージェントが通常、コントロールがフォーカスされているときにこのヒントをユーザーに表示しない場合でも、autofocus属性の結果としてコントロールがフォーカスされた場合は、そのヒントを表示するべきです。なぜなら、その場合、ユーザーはコントロールをフォーカスする前に調べる機会がなかったためです。

name属性は要素の名前を表します。dirname属性は、要素の方向性がどのように送信されるかを制御します。disabled属性は、コントロールを非対話的にし、その値を送信できないようにするために使用されます。form属性は、textarea要素をそのフォーム所有者と明示的に関連付けるために使用されます。autocomplete属性は、ユーザーエージェントが自動入力動作を提供する方法を制御します。

textarea.type

文字列"textarea"を返します。

textarea.value

要素の現在の値を返します。

値を変更するために設定することができます。

cols、placeholder、required、rows、およびwrapIDL属性は、それぞれ同じ名前のコンテンツ属性を反映する必要があります。colsおよびrows属性は、ゼロより大きい正の数にのみ限定され、フォールバックがあります。colsIDL属性のデフォルト値は20です。rowsIDL属性のデフォルト値は2です。dirNameIDL属性は、dirnameコンテンツ属性を反映する必要があります。maxLengthIDL属性は、maxlengthコンテンツ属性を反映し、ゼロ以上の数値にのみ限定されます。minLengthIDL属性は、minlengthコンテンツ属性を反映し、ゼロ以上の数値にのみ限定されます。readOnlyIDL属性は、readonlyコンテンツ属性を反映する必要があります。

typeIDL属性は、"textarea"という値を返す必要があります。

defaultValue属性のgetterは、要素の子供のテキストコンテンツを返す必要があります。

defaultValue属性のsetterは、すべてを文字列置換し、この要素内に指定された値を設定する必要があります。

value IDL属性は、取得時に要素のAPI値を返す必要があります。設定時には、以下の手順を実行する必要があります。

  1. この要素のAPI値をoldAPIValueとして設定します。

  2. この要素の生の値を新しい値に設定します。

  3. この要素の汚れ値フラグをtrueに設定します。

  4. 新しいAPI値がoldAPIValueと異なる場合は、テキストコントロールの末尾にテキストエントリカーソル位置を移動し、選択されているテキストを選択解除し、選択方向をリセットして"none"に設定します。

textLength IDL属性は、要素の長さを返す必要があります。

willValidate、validity、およびvalidationMessageIDL属性、およびcheckValidity()、reportValidity()、およびsetCustomValidity()メソッドは、制約検証APIの一部です。ラベルIDL属性は、要素のラベルのリストを提供します。選択()、選択開始、選択終了、選択方向、範囲テキストを設定()、および選択範囲を設定()メソッドとIDL属性は、要素のテキスト選択を公開します。無効、フォーム、および名前IDL属性は、要素のフォームAPIの一部です。

ここでは、textarea要素が、フォーム内で自由形式のテキスト入力に使用される例を示します： 

<p>ご意見がございましたら、お知らせください： <textarea cols=80 name=comments></textarea></p>

コメントの最大長を指定するには、maxlength属性を使用します： 

<p>短いコメントがございましたら、お知らせください： <textarea cols=80 name=comments maxlength=200></textarea></p>

デフォルト値を指定するには、要素内にテキストを含めます：

<p>ご意見がございましたら、お知らせください： <textarea cols=80 name=comments>You rock!</textarea></p>

最低限の長さを指定することもできます。ここでは、ユーザーが手紙を記入する必要があり、テンプレート（最小長より短い）が提供されていますが、フォームを送信するには不十分です：

<textarea required minlength="500">Dear Madam Speaker,

Regarding your letter dated ...

...

Yours Sincerely,

...</textarea>

プレースホルダーを使用して、ユーザーに基本的な形式を示すこともできますが、明示的なテンプレートは提供しません：

<textarea placeholder="Dear Francine,

They closed the parks this week, so we won't be able to
meet your there. Should we just have dinner?

Love,
Daddy"></textarea>

要素のdirname属性を指定することで、ブラウザに要素の方向性を値と一緒に送信させることができます： 

<p>ご意見がございましたら、お知らせください（コメントには英語またはヘブライ語を使用できます）：
<textarea cols=80 name=comments dirname=comments.dir></textarea></p>

4.10.12 output要素

要素/output

すべての現在のエンジンでサポートされています。

Firefox4+Safari7+Chrome10+
Opera11+Edge79+
Edge (レガシー)18Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

HTMLOutputElement

すべての現在のエンジンでサポートされています。

Firefox4+Safari5.1+Chrome9+
Opera12.1+Edge79+
Edge (レガシー)14+Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
リストされている, ラベル可能, リセット可能, および 大文字化および自動修正継承 フォーム関連要素。
感覚的コンテンツ。
この要素が使用されるコンテキスト:
フレージングコンテンツが予想される場所。
コンテンツモデル:
フレージングコンテンツ。
text/htmlでのタグの省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
for — 出力が計算されたコントロールを指定
form — 要素をフォーム要素に関連付けます
name — form.elementsAPIで使用する要素の名前。
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
 interface HTMLOutputElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [SameObject, PutForwards=value] readonly attribute DOMTokenList htmlFor;
   readonly attribute HTMLFormElement? form;
   [CEReactions] attribute DOMString name;
 
   readonly attribute DOMString type;
   [CEReactions] attribute DOMString defaultValue;
   [CEReactions] attribute DOMString value;
 
   readonly attribute boolean willValidate;
   readonly attribute ValidityState validity;
   readonly attribute DOMString validationMessage;
   boolean checkValidity();
   boolean reportValidity();
   undefined setCustomValidity(DOMString error);
 
   readonly attribute NodeList labels;
 };

output 要素は、アプリケーションによって実行された計算の結果、またはユーザーの操作の結果を表します。

この要素は、以前に実行された他のプログラムの出力を引用するための適切な要素であるsamp 要素と対照をなします。

属性/for

すべての現在のエンジンでサポートされています。

Firefox4+Safari7+Chrome10+
Opera11+Edge79+
Edge (レガシー)18Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

for コンテンツ属性は、計算結果と計算に使用された値または計算に影響を与えた要素との間に明示的な関係を作成することを可能にします。指定されている場合、for 属性には、一意のスペースで区切られたトークンの無順序集合を含む文字列が含まれている必要があります。これらのトークンのいずれも、別のトークンと同一でない必要があり、各トークンは同じツリー内の要素のIDである必要があります。

form 属性は、output 要素をそのフォーム所有者と明示的に関連付けるために使用されます。name 属性は、要素の名前を表します。output 要素は、フォームのイベントハンドラから簡単に参照できるようにフォームに関連付けられますが、フォームが送信されるときに要素自体の値は送信されません。

この要素には、デフォルト値のオーバーライド (nullまたは文字列) があります。最初はnullに設定されます。

要素のデフォルト値は、次の手順によって決定されます。

  1. この要素のデフォルト値のオーバーライドがnullでない場合は、それを返します。

  2. この要素の子孫テキストコンテンツを返します。

output 要素のリセットアルゴリズムは、次の手順を実行します:

  1. この要素のすべて置換を、この要素のデフォルト値で実行します。

  2. この要素のデフォルト値のオーバーライドをnullに設定します。

output.value [ = value ]

要素の現在の値を返します。

設定して値を変更することができます。

output.defaultValue [ = value ]

要素の現在のデフォルト値を返します。

設定してデフォルト値を変更することができます。

output.type

"output" という文字列を返します。

value ゲッターステップでは、この要素の子孫テキストコンテンツを返します。

value セッターステップは次のとおりです:

  1. この要素のデフォルト値のオーバーライドをそのデフォルト値に設定します。

  2. すべて置換を、このこの要素内の指定された値で実行します。

defaultValue ゲッターステップは、この要素のデフォルト値を返します。

defaultValue セッターステップは次のとおりです:

  1. もしこの要素のデフォルト値のオーバーライドがnullであれば、指定された値ですべて置換を実行し、返します。

  2. この要素のデフォルト値のオーバーライドを指定された値に設定します。

type ゲッターステップは、"output" を返します。

htmlFor IDL属性は、for コンテンツ属性を反映する必要があります。

willValidate、validity、およびvalidationMessage IDL属性、およびcheckValidity()、reportValidity()、およびsetCustomValidity() メソッドは、制約検証APIの一部です。labels IDL属性は、要素のラベルのリストを提供します。form および name IDL属性は、要素のフォームAPIの一部です。

簡単な電卓では、計算結果を表示するために output を使用することができます: 

<form onsubmit="return false" oninput="o.value = a.valueAsNumber + b.valueAsNumber">
  <input id=a type=number step=any> +
  <input id=b type=number step=any> =
  <output id=o for="a b"></output>
 </form>

この例では、リモートサーバーで行われた計算の結果を受け取り次第、output 要素に表示しています:

<output id="result"></output>
 <script>
  var primeSource = new WebSocket('ws://primes.example.net/');
  primeSource.onmessage = function (event) {
    document.getElementById('result').value = event.data;
  }
 </script>

4.10.13 progress 要素

Element/progress

現在のすべてのエンジンでサポートされています。

Firefox6+Safari6+Chrome6+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

HTMLProgressElement

現在のすべてのエンジンでサポートされています。

Firefox6+Safari6+Chrome6+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
ラベル付け可能な要素。
明確なコンテンツ。
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
フレージングコンテンツ、ただしprogress 要素の子孫は存在してはならない。
text/htmlにおけるタグの省略:
タグは省略できない。
コンテンツ属性:
グローバル属性
value — 要素の現在の値
max — 範囲の上限
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェイス: 
[Exposed=Window]
インターフェイス HTMLProgressElement : HTMLElement {
 [HTMLConstructor] コンストラクター();
 
 [CEReactions] 属性 double value;
 [CEReactions] 属性 double max;
 readonly 属性 double position;
 readonly 属性 NodeList labels;
};

progress 要素はタスクの完了進捗を表します。進捗は不確定であり、進捗が進んでいるが、タスクが完了するまでにどれだけの作業が残っているかが明確でない（例：タスクがリモートホストの応答を待っているため）か、進捗がゼロから最大までの範囲の数値であり、これまでに完了した作業の割合を示します。

Attributes/max

現在のすべてのエンジンでサポートされています。

Firefox6+Safari6+Chrome6+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS7+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

要素が表す現在のタスク完了を決定する属性は 2 つあります。value 属性はタスクの完了度を指定し、max 属性はタスクに必要な作業量全体を指定します。単位は任意で指定されていません。

決定的な進捗バーを作成するには、現在の進捗（0.0 から 1.0 までの数値、または max 属性が指定されている場合はその値までの数値）を持つ value 属性を追加します。不確定な進捗バーを作成するには、value 属性を削除します。

著者には、進捗がレガシーユーザーエージェントのユーザーにも利用できるように、現在の値と最大値を要素内のテキストとしてインラインに含めることをお勧めします。

これは、ある自動タスクの進捗を表示する Web アプリケーションのスニペットです：

<section>
  <h2>タスクの進捗</h2>
  <p>進捗： <progress id=p max=100><span>0</span>%</progress></p>
  <script>
   var progressBar = document.getElementById('p');
   function updateProgress(newValue) {
     progressBar.value = newValue;
     progressBar.getElementsByTagName('span')[0].textContent = newValue;
   }
  </script>
 </section>

（この例のupdateProgress() メソッドは、タスクの進行に応じて実際の進捗バーを更新するために、ページ上の他のコードによって呼び出されます。）

valueおよびmax属性が存在する場合、その値は有効な浮動小数点数でなければなりません。value属性が存在する場合、その値は 0 以上で、かつmax属性の値以下（max 属性が存在しない場合は 1.0 以下）でなければなりません。max属性が存在する場合、その値は 0 より大きくなければなりません。

progress要素は、単なるゲージとして使用するには不適切です。たとえば、ディスクスペースの使用状況をprogress要素で示すのは不適切です。そのような使用ケースには、meter要素を使用できます。

ユーザーエージェントの要件：value属性が省略されている場合、進捗バーは不確定な進捗バーです。それ以外の場合、それは決定的な進捗バーです。

決定的な進捗バーであり、要素がmax属性を持っている場合、ユーザーエージェントはmax属性の値を浮動小数点数値の解析ルールに従って解析する必要があります。これがエラーにならない場合、および解析された値が 0 より大きい場合、進捗バーの最大値はその値です。そうでない場合、つまり要素にmax属性がない場合、またはそれがあっても解析がエラーとなった場合、または解析された値が 0 以下であった場合、進捗バーの最大値は 1.0 です。

決定的な進捗バーである場合、ユーザーエージェントはvalue属性の値を浮動小数点数値の解析ルールに従って解析する必要があります。これがエラーにならず、解析された値が 0 より大きい場合、進捗バーの値はその解析された値です。そうでない場合、つまりvalue属性の解析がエラーになったか、値が 0 以下であった場合、進捗バーの値は 0 です。

決定的な進捗バーである場合、現在の値は、値が最大値より大きい場合は最大値であり、そうでない場合は値です。

進捗バーを表示する際のユーザーエージェントの要件：progress要素をユーザーに表示する際、ユーザーエージェントはそれが決定的な進捗バーか不確定な進捗バーかを示すべきであり、前者の場合は、現在の値が最大値に対して相対的にどの位置にあるかを示すべきです。

progress.position

決定的な進捗バー（現在の値と最大値が既知の場合）では、現在の値を最大値で割った結果を返します。

不確定な進捗バーの場合、-1を返します。

進捗バーが不確定な進捗バーの場合、position IDL属性は-1を返さなければなりません。それ以外の場合、現在の値を最大値で割った結果を返さなければなりません。

進捗バーが不確定な進捗バーの場合、value IDL属性は取得時に0を返さなければなりません。それ以外の場合、現在の値を返さなければなりません。設定時には、与えられた値を浮動小数点数としての最良の表現に変換し、valueコンテンツ属性にその文字列を設定しなければなりません。

value IDL属性をそのまま自身に設定すると、対応するコンテンツ属性がない場合、進捗バーは不確定な状態から進捗のない決定的な進捗バーに変更されます。

max IDL属性は、同名のコンテンツ属性を反映し、正の数に限定されます。maxのデフォルト値は1.0です。

labels IDL属性は、この要素のlabelをリストとして提供します。

4.10.14 meter 要素

Element/meter

すべての現在のエンジンでサポートされています。

Firefox16+Safari6+Chrome6+
Opera11+Edge79+
Edge (Legacy)18Internet Explorer非対応
Firefox Android？Safari iOS10.3+Chrome Android？WebView Android非対応Samsung Internet？Opera Android11+

HTMLMeterElement

すべての現在のエンジンでサポートされています。

Firefox16+Safari6+Chrome6+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer非対応
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android11+
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
ラベル付け可能要素.
具体的なコンテンツ.
この要素を使用できるコンテキスト:
フレージングコンテンツが予期される場所。
コンテンツモデル:
フレージングコンテンツ、ただしmeter要素の子孫が存在してはなりません。
text/htmlでのタグ省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
value — 要素の現在の値
min — 範囲の下限
max — 範囲の上限
low — 低い範囲の上限
high — 高い範囲の下限
optimum — ゲージ内の最適値
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOMインターフェイス: 
[Exposed=Window]
 interface HTMLMeterElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute double value;
   [CEReactions] attribute double min;
   [CEReactions] attribute double max;
   [CEReactions] attribute double low;
   [CEReactions] attribute double high;
   [CEReactions] attribute double optimum;
   readonly attribute NodeList labels;
 };

meter要素は、既知の範囲内のスカラー測定値、または分数値を表します。例えば、ディスク使用量、クエリ結果の関連性、または特定の候補者を選択した投票者の割合などです。

これはゲージとも呼ばれます。

meter要素は、進行状況（進捗バーのような）を示すために使用してはなりません。その役割には、HTMLが別のprogress要素を提供します。

meter要素は、任意の範囲のスカラー値も表しません。たとえば、既知の最大値がない限り、体重や身長を報告するためにこれを使用するのは間違いです。

この要素が表すゲージの意味を決定する6つの属性があります。

Attributes/max

すべての現在のエンジンでサポートされています。

Firefox16+Safari6+Chrome6+
Opera11+Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS10.3+Chrome Android?WebView AndroidNoSamsung Internet?Opera Android11+

Attributes/min

すべての現在のエンジンでサポートされています。

Firefox16+Safari6+Chrome6+
Opera11+Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS10.3+Chrome Android?WebView AndroidNoSamsung Internet?Opera Android11+

min属性は範囲の下限を指定し、max属性は上限を指定します。value属性は、ゲージが「測定された」値として示す値を指定します。

他の3つの属性は、ゲージの範囲を「低」、「中」、「高」の部分に分割し、ゲージの「最適」部分がどこかを示すために使用できます。low属性は「低」部分と見なされる範囲を指定し、high属性は「高」部分と見なされる範囲を指定します。optimum属性は「最適」位置を示します。それが「高」値より高い場合は、値が高いほど良いことを示し、それが「低」マークより低い場合は、値が低いほど良いことを示し、自然にその間にある場合は、高い値も低い値も良くないことを示します。

作成要件: value属性は指定されなければなりません。value、min、low、high、max、およびoptimum属性が存在する場合、それらの値は有効な浮動小数点数でなければなりません。

さらに、属性の値には以下の制約があります:

valueをvalue属性の数値とします。

指定されている場合、min属性をminimumとし、それ以外の場合は0とします。

指定されている場合、max属性をmaximumとし、それ以外の場合は1.0とします。

以下の不等式が適用可能な場合に成り立つ必要があります:

最小値や最大値が指定されていない場合、範囲は0から1と仮定され、その範囲内に値がなければなりません。

著者は、meter要素をサポートしないユーザーエージェントのユーザーのために、要素の内容にゲージの状態をテキストで表現することを推奨します。

マイクロデータと一緒に使用する場合、meter要素のvalue属性は、その要素の機械可読値を提供します。

以下の例は、3つのゲージがいずれも3/4満たされていることを示しています：

ストレージスペースの使用量: <meter value=6 max=8>6ブロック使用（全8ブロック中）</meter>
投票率: <meter value=0.75><img alt="75%" src="graph75.png"></meter>
チケット販売数: <meter min="0" max="100" value="75"></meter>

次の例は、範囲を指定していないため、要素の誤った使用法です（デフォルトの最大値は1であるため、どちらのゲージも最大値として表示されます）：

<p>グレープフルーツパイの半径は<meter value=12>12cm</meter>で、高さは<meter value=2>2cm</meter>です。</p> <!-- BAD! -->

代わりに、meter要素を含めないか、他のパイと比較して次元を文脈化するために範囲を定義したmeter要素を使用します：

<p>グレープフルーツパイの半径は12cmで、高さは2cmです。</p>
 <dl>
  <dt>半径: <dd> <meter min=0 max=20 value=12>12cm</meter>
  <dt>高さ: <dd> <meter min=0 max=10 value=2>2cm</meter>
 </dl>

meter要素には、明示的に単位を指定する方法はありませんが、title属性で単位を自由形式のテキストで指定することができます。

上記の例は、単位を示すために拡張できます：

<dl>
  <dt>半径: <dd> <meter min=0 max=20 value=12 title="centimeters">12cm</meter>
  <dt>高さ: <dd> <meter min=0 max=10 value=2 title="centimeters">2cm</meter>
 </dl>

ユーザーエージェントの要件: ユーザーエージェントは、min、max、value、low、high、およびoptimum属性を、浮動小数点数値を解析するためのルールを使用して解析する必要があります。

ユーザーエージェントは次に、これらすべての数値を使用して、ゲージ上の6つのポイントの値を次のように取得する必要があります。（これらの評価の順序は重要です。一部の値は前の値を参照します。）

最小値

min属性が指定され、その値を解析できる場合、最小値はその値です。そうでない場合、最小値は0です。

最大値

max属性が指定され、その値を解析できる場合、候補最大値はその値です。そうでない場合、候補最大値は1.0です。

候補最大値が最小値以上の場合、最大値は候補最大値です。そうでない場合、最大値は最小値と同じです。

実際の値

value属性が指定され、その値を解析できる場合、その値が候補実際値です。そうでない場合、候補実際値は0です。

候補実際値が最小値より小さい場合、実際の値は最小値です。

それ以外の場合、候補実際値が最大値より大きい場合、実際の値は最大値です。

それ以外の場合、実際の値は候補実際値です。

低境界

low属性が指定され、その値を解析できる場合、候補低境界はその値です。そうでない場合、候補低境界は最小値と同じです。

候補低境界が最小値より小さい場合、低境界は最小値です。

それ以外の場合、候補低境界が最大値より大きい場合、低境界は最大値です。

それ以外の場合、低境界は候補低境界です。

高境界

high属性が指定され、その値を解析できる場合、候補高境界はその値です。そうでない場合、候補高境界は最大値と同じです。

候補高境界が低境界より小さい場合、高境界は低境界です。

それ以外の場合、候補高境界が最大値より大きい場合、高境界は最大値です。

それ以外の場合、高境界は候補高境界です。

最適点

optimum属性が指定され、その値を解析できる場合、候補最適点はその値です。そうでない場合、候補最適点は最小値と最大値の中間点です。

候補最適点が最小値より小さい場合、最適点は最小値です。

それ以外の場合、候補最適点が最大値より大きい場合、最適点は最大値です。

それ以外の場合、最適点は候補最適点です。

これにより、以下の不等式がすべて成り立つようになります：

ゲージ領域に関するUAの要件: 最適点が低境界または高境界、またはその間のどこかにある場合、ゲージの低境界と高境界の間の領域は最適領域と見なされ、低および高の部分（ある場合）はサブ最適と見なされます。それ以外の場合、最適点が低境界より低い場合、最小値と低境界の間の領域は最適領域と見なされ、低境界から高境界までの領域はサブ最適領域と見なされ、残りの領域はさらに良くない領域と見なされます。最後に、最適点が高境界より高い場合、状況は逆転し、高境界と最大値の間の領域は最適領域と見なされ、高境界から低境界までの領域はサブ最適領域と見なされ、残りの領域はさらに良くない領域と見なされます。

ゲージの表示に関するUAの要件: ユーザーにmeter要素を表示する際に、UAは実際の値の最小値および最大値に対する相対的な位置、およびゲージの3つの領域との関係を示す必要があります。

次のマークアップ：

<h3>Suggested groups</h3>
 <menu>
  <li><a href="?cmd=hsg" onclick="hideSuggestedGroups()">Hide suggested groups</a></li>
 </menu>
 <ul>
  <li>
   <p><a href="/group/comp.infosystems.www.authoring.stylesheets/view">comp.infosystems.www.authoring.stylesheets</a> -
      <a href="/group/comp.infosystems.www.authoring.stylesheets/subscribe">join</a></p>
   <p>Group description: <strong>Layout/presentation on the WWW.</strong></p>
   <p><meter value="0.5">Moderate activity,</meter> Usenet, 618 subscribers</p>
  </li>
  </li>
   <p><a href="/group/netscape.public.mozilla.xpinstall/view">netscape.public.mozilla.xpinstall</a> -
      <a href="/group/netscape.public.mozilla.xpinstall/subscribe">join</a></p>
   <p>Group description: <strong>Mozilla XPInstall discussion.</strong></p>
   <p><meter value="0.25">Low activity,</meter> Usenet, 22 subscribers</p>
  </li>
  </li>
   <p><a href="/group/mozilla.dev.general/view">mozilla.dev.general</a> -
      <a href="/group/mozilla.dev.general/subscribe">join</a></p>
   <p><meter value="0.25">Low activity,</meter> Usenet, 66 subscribers</p>
  </li>
 </ul>

次のようにレンダリングされる可能性があります：

異なる長さのインラインの緑色のバーとしてレンダリングされた<meter>要素。

ユーザーエージェントは、title属性の値と他の属性の値を組み合わせて、コンテキストに敏感なヘルプや実際の値の詳細を提供するインラインテキストを提供することができます。

例えば、次のスニペット：

<meter min=0 max=60 value=23.2 title=seconds></meter>

...は、ユーザーエージェントが次のようなツールチップを表示する可能性があります。「値：60中23.2。」という1行と、「秒」という2行目。

valueIDL属性は、取得時に実際の値を返さなければなりません。設定時に、指定された値は浮動小数点数としての数の最適な表現に変換され、valueコンテンツ属性にその文字列が設定されなければなりません。

minIDL属性は、取得時に最小値を返さなければなりません。設定時に、指定された値は浮動小数点数としての数の最適な表現に変換され、minコンテンツ属性にその文字列が設定されなければなりません。

maxIDL属性は、取得時に最大値を返さなければなりません。設定時に、指定された値は浮動小数点数としての数の最適な表現に変換され、maxコンテンツ属性にその文字列が設定されなければなりません。

lowIDL属性は、取得時に低境界を返さなければなりません。設定時に、指定された値は浮動小数点数としての数の最適な表現に変換され、lowコンテンツ属性にその文字列が設定されなければなりません。

highIDL属性は、取得時に高境界を返さなければなりません。設定時に、指定された値は浮動小数点数としての数の最適な表現に変換され、highコンテンツ属性にその文字列が設定されなければなりません。

optimumIDL属性は、取得時に最適値を返さなければなりません。設定時に、指定された値は浮動小数点数としての数の最適な表現に変換され、optimumコンテンツ属性にその文字列が設定されなければなりません。

labelsIDL属性は、要素のlabelのリストを提供します。

次の例は、ゲージがローカライズされたテキストや整形されたテキストにフォールバックする方法を示しています。

<p>ディスク使用量: <meter min=0 value=170261928 max=233257824>170 261 928バイト使用済み（全233 257 824バイト中）</meter></p>

4.10.15 fieldset 要素

Element/fieldset

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera15+Edge79+
Edge (レガシー)12+Internet Explorer対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

HTMLFieldSetElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
フローコンテンツ.
リストされている および 大文字化および自動修正継承 フォーム関連要素。
可触コンテンツ.
この要素を使用できるコンテキスト:
フローコンテンツが期待される場所。
コンテンツモデル:
オプションで legend 要素、続いてフローコンテンツ.
text/htmlにおけるタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
disabled — 後続のフォームコントロール（legend内を除く）が無効であるかどうか
form — この要素をform要素に関連付ける
name — APIにおいてform.elementsで使用されるこの要素の名前
アクセシビリティの考慮事項:
著者向け.
実装者向け.
DOM インターフェース: 
[Exposed=Window]
 interface HTMLFieldSetElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute boolean disabled;
   readonly attribute HTMLFormElement? form;
   [CEReactions] attribute DOMString name;
 
   readonly attribute DOMString type;
 
   [SameObject] readonly attribute HTMLCollection elements;
 
   readonly attribute boolean willValidate;
   [SameObject] readonly attribute ValidityState validity;
   readonly attribute DOMString validationMessage;
   boolean checkValidity();
   boolean reportValidity();
   undefined setCustomValidity(DOMString error);
 };

fieldset 要素は、フォームコントロール（またはその他のコンテンツ）をグループ化し、オプションでキャプションを付けるためのものです。キャプションは、このfieldset要素の最初のlegend要素によって提供されます（存在する場合）。残りの子孫はグループを形成します。

Element/fieldset#attr-disabled

すべての現在のエンジンでサポートされています。

Firefox4+Safari6+Chrome20+
Opera12+Edge79+
Edge (レガシー)12+Internet Explorer対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

disabled属性が指定されると、fieldset要素のすべてのフォームコントロールの子孫（ただし、legend要素の子孫を除く）が無効になります。

fieldset要素は、次の条件のいずれかを満たす場合に無効なフィールドセットとなります:

form属性は、このfieldset要素をそのフォーム所有者に明示的に関連付けるために使用されます。name属性は要素の名前を表します。

fieldset.type

文字列 "fieldset" を返します。

fieldset.elements

要素内のフォームコントロールのHTMLCollectionを返します。

disabledIDL属性は、同名のコンテンツ属性を反映しなければなりません。

typeIDL属性は、文字列 "fieldset" を返さなければなりません。

elementsIDL属性は、HTMLCollectionを返し、fieldset要素をルートとし、そのフィルターはリストされた要素に一致します。

willValidate、validity、validationMessage属性、およびcheckValidity()、reportValidity()、setCustomValidity()メソッドは、制約検証APIの一部です。formおよびnameIDL属性は、要素のフォームAPIの一部です。

この例では、関連するコントロールのセットをグループ化するためにfieldset要素が使用されています: 

<fieldset>
  <legend>表示</legend>
  <p><label><input type=radio name=c value=0 checked> 白地に黒</label>
  <p><label><input type=radio name=c value=1> 黒地に白</label>
  <p><label><input type=checkbox name=g> グレースケールを使用</label>
  <p><label>コントラストを強化 <input type=range name=e list=contrast min=0 max=100 value=0 step=1></label>
  <datalist id=contrast>
   <option label=Normal value=0>
   <option label=Maximum value=100>
  </datalist>
 </fieldset>

次のスニペットは、legend 内のチェックボックスが fieldset の有効・無効を制御するフィールドセットを示しています。fieldset の内容は、2つの必須テキストコントロールとオプションの年/月コントロールで構成されています。

<fieldset name="clubfields" disabled>
  <legend> <label>
   <input type=checkbox name=club onchange="form.clubfields.disabled = !checked">
   クラブカードを使用する
  </label> </legend>
  <p><label>カードの名前: <input name=clubname required></label></p>
  <p><label>カード番号: <input name=clubnum required pattern="[-0-9]+"></label></p>
  <p><label>有効期限: <input name=clubexp type=month></label></p>
 </fieldset>

また、fieldset要素をネストすることもできます。次の例では、前述の例を拡張し、それを示しています: 

<fieldset name="clubfields" disabled>
  <legend> <label>
   <input type=checkbox name=club onchange="form.clubfields.disabled = !checked">
   クラブカードを使用する
  </label> </legend>
  <p><label>カードの名前: <input name=clubname required></label></p>
  <fieldset name="numfields">
   <legend> <label>
    <input type=radio checked name=clubtype onchange="form.numfields.disabled = !checked">
    私のカードには数字が書かれています
   </label> </legend>
   <p><label>カード番号: <input name=clubnum required pattern="[-0-9]+"></label></p>
  </fieldset>
  <fieldset name="letfields" disabled>
   <legend> <label>
    <input type=radio name=clubtype onchange="form.letfields.disabled = !checked">
    私のカードには文字が書かれています
   </label> </legend>
   <p><label>カードコード: <input name=clublet required pattern="[A-Za-z]+"></label></p>
  </fieldset>
 </fieldset>

この例では、外側の「クラブカードを使用する」チェックボックスがチェックされていない場合、外側のfieldset内のすべて、つまり2つのネストされたfieldsetの legend 内の2つのラジオボタンを含め、すべてが無効になります。ただし、チェックボックスがチェックされている場合、ラジオボタンの両方が有効になり、どちらの内側のfieldsetを有効にするかを選択できるようになります。

この例では、legend要素がグループ化をラベル付けし、ネストされた見出し要素がドキュメントのアウトラインにグループ化を表示する方法を示しています: 

<fieldset>
  <legend> <h2>
   どの方法でご連絡するのが最適ですか？
  </h2> </legend>
  <p><label><input type=radio checked name=contact_pref> 電話</label> </p>
  <p><label> <input type=radio name=contact_pref> メール
  </label> </p>
  </p><label> <input type=radio name=contact_pref> テキスト
  </label> </p>
 </fieldset>

4.10.16 legend 要素

Element/legend

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLLegendElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
カテゴリ:
なし
この要素を使用できるコンテキスト:
fieldset 要素の最初の子として使用
コンテンツモデル:
フレージングコンテンツ、見出しコンテンツと混在可能
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け
実装者向け
DOM インターフェース: 
[Exposed=Window]
 interface HTMLLegendElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   readonly attribute HTMLFormElement? form;
 
   // also has obsolete members
 };

legend 要素は、legend 要素の親である fieldset 要素の残りの内容のキャプションを表します（もし存在する場合）。

legend.form

要素の form 要素を返します（もし存在する場合）、それ以外は null を返します。

form IDL 属性の動作は、legend 要素が fieldset 要素内にあるかどうかによって異なります。legend 要素が親として fieldset 要素を持つ場合、その form IDL 属性は、その form IDL 属性と同じ値を返す必要があります。それ以外の場合は null を返す必要があります。

4.10.17 フォームコントロールのインフラストラクチャ

4.10.17.1 フォームコントロールの値

ほとんどのフォームコントロールには、値とチェック状態があります。（後者は input 要素でのみ使用されます。）これらは、ユーザーがコントロールとどのようにやり取りするかを説明するために使用されます。

コントロールの 値 はその内部状態です。そのため、ユーザーの現在の入力と一致しない場合があります。

例えば、ユーザーが数字を期待している 数値フィールド に「three」という単語を入力した場合、ユーザーの入力は「three」という文字列ですが、コントロールの 値 は変更されません。また、ユーザーが「 awesome@example.com」（先頭に空白がある）というメールアドレスを メールフィールド に入力した場合、ユーザーの入力は「 awesome@example.com」という文字列になりますが、ブラウザのメールフィールドのUIでは、これが「awesome@example.com」（先頭の空白なし）という 値 に変換されることがあります。

input および textarea 要素には、汚れた値フラグがあります。これは、値 とデフォルト値の間のやり取りを追跡するために使用されます。このフラグが false の場合、値 はデフォルト値を反映します。true の場合、デフォルト値は無視されます。

一部のフォームコントロールにはオプションの値もあります。これは主に値を反映しますが、空の文字列には正規化されません。これは控えめに使用する必要があります。通常は値が必要です。

input、textarea、およびselect要素は、ユーザーの有効性ブール値を持っています。これは最初にfalseに設定されます。

input要素のmultiple属性に直面した場合の制約検証の動作を定義するために、input要素は、個別に定義された値sを持つこともできます。

maxlengthおよびminlength属性、およびtextarea要素に固有の他のAPIの動作を定義するために、値を持つすべてのフォームコントロールは、API値を取得するためのアルゴリズムも持っています。デフォルトでは、このアルゴリズムは単にコントロールの値を返すことです。

select要素は、値を持っていません。選択されたoption要素が代わりに使用されます。

4.10.17.2 変更可能性

フォームコントロールは変更可能と指定することができます。

これは、この仕様で定義される要件や定義を通じて、ユーザーがフォームコントロールの値やチェック状態を変更できるか、またはコントロールが自動的に事前入力されるかどうかを判断するものです。

4.10.17.3 コントロールとフォームの関連付け

フォーム関連要素は、フォーム要素と関係を持つことができ、これをその要素のフォーム所有者と呼びます。フォーム関連要素がフォーム要素と関連付けられていない場合、そのフォーム所有者はnullとされます。

フォーム関連要素には、関連するパーサー挿入フラグがあります。

Element/input#form

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Attributes#attr-form

すべての現行エンジンでサポートされています。

Firefox1+Safari≤4+Chrome1+
Opera≤12.1+Edge79+
Edge (Legacy)12+Internet Explorer≤6+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android≤12.1+

フォーム関連要素は、デフォルトでは最も近い祖先のフォーム要素と関連付けられます（以下で説明されます）が、リスト化された要素である場合は、form属性を指定することでこれを上書きすることができます。

この機能は、ネストされたフォーム要素のサポートがないことを補うために、著者が利用できるようにします。

リスト化されたリスト化されたフォーム関連要素にform属性が指定されている場合、その属性の値は、その要素のIDでなければなりません。その要素のツリー内にあるフォーム要素のIDです。

このセクションのルールは、準拠する文書やツリーにはネストされたフォーム要素が含まれないため複雑です。しかし、DOM操作を行うスクリプトを使用して、このようなネストされた要素を持つツリーを生成することは十分に可能です。また、歴史的な理由から、HTMLパーサーのルールによって、フォーム関連要素が祖先ではないフォーム要素と関連付けられることがあり、それも複雑さを増しています。

フォーム関連要素が作成されると、そのフォーム所有者はnull（所有者なし）に初期化される必要があります。

フォーム関連要素をフォームと関連付ける場合、そのフォーム所有者はそのフォームに設定される必要があります。

リスト化されたリスト化されたフォーム関連要素のform属性が設定、変更、または削除された場合、ユーザーエージェントはその要素のフォーム所有者をリセットしなければなりません。

リスト化されたリスト化されたフォーム関連要素がform属性を持ち、そのツリー内の任意の要素のIDが変更された場合、ユーザーエージェントはそのフォーム所有者をリセットしなければなりません。

リストされた フォーム関連要素がform 属性を持ち、ID を持つ要素がDocument に挿入されるか、または削除される場合、あるいはそのHTML 要素移動ステップが実行される場合、ユーザーエージェントはそのフォーム関連要素のフォーム所有者をリセットしなければなりません。

フォームオーナーは、HTML要素挿入ステップ、HTML要素削除ステップ、およびHTML要素移動ステップによってもリセットされます。

フォーム関連要素 element のフォームオーナーをリセットするには:

  1. element のパーサー挿入フラグを解除します。

  2. 以下のすべての条件が真である場合:

    その場合は何もしません。

  3. element のフォームオーナーをnullに設定します。

  4. もしelementがリストに含まれ、フォーム属性が存在し、接続されている場合:

    1. もしelement のツリー内の最初の要素が、そのフォーム属性値と同一の IDを持つ場合、その要素をフォーム要素に関連付けます。

  5. それ以外の場合、element が祖先にフォーム要素を持つ場合、そのelementを最も近いフォーム要素に関連付けます。

以下の非準拠スニペットでは

...
  <form id="a">
   <div id="b"></div>
  </form>
  <script>
   document.getElementById('b').innerHTML =
      '<table><tr><td></form><form id="c"><input id="d"></table>' +
      '<input id="e">';
  </script>
 ...

"d" のフォームオーナーは内側のネストされたフォーム "c" ですが、"e" のフォームオーナーは外側のフォーム "a" になります。

これは次のように起こります: 最初に、"e" ノードはHTMLパーサーで "c" に関連付けられます。次に、innerHTMLアルゴリズムがノードを一時的なドキュメントから "b" 要素に移動させます。この時点で、ノードはその祖先チェーンの変更を認識し、そのためパーサーによって行われたすべての "魔法のような" 関連付けが通常の祖先関連付けにリセットされます。

ただし、この例はコンテンツモデルに違反しており、フォーム要素をネストすることは不正です。また、</form>タグに解析エラーがあります。

element.form

HTMLObjectElement/form

すべての最新のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLSelectElement/form

すべての最新のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

要素のフォームオーナーを返します。

フォームオーナーが存在しない場合は null を返します。

リスト化された フォーム関連要素 は、フォーム関連カスタム要素 を除き、 form IDL属性を持ち、取得時にその要素のフォームオーナーを返すか、存在しない場合はnullを返します。

ElementInternals/form

すべての最新のエンジンでサポートされています。

Firefox98+Safari16.4+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

フォーム関連カスタム要素には form IDL属性がありません。 代わりに、その ElementInternals オブジェクトには、form IDL属性があります。取得時に、"NotSupportedError" DOMExceptionを投げなければならず、ターゲット要素がフォーム関連カスタム要素でない場合は投げる必要があります。そうでない場合は、その要素のフォームオーナーを返すか、存在しない場合はnullを返します。

4.10.18 フォームコントロールに共通する属性

4.10.18.1 フォームコントロールの命名: name 属性

Element/input#name

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

name コンテンツ属性は、フォームコントロールの名前を指定し、 フォーム送信 および form 要素の elements オブジェクトで使用されます。属性が指定されている場合、その値は空文字列や isindex であってはなりません。

多くのユーザーエージェントは、isindex という名前の最初のフォーム内のテキストコントロールに対して、特別なサポートを実装していました。この仕様では以前、このサポートに関連するユーザーエージェントの要件を定義していました。しかし、その後いくつかのユーザーエージェントがその特別なサポートを廃止し、それに関連する要件もこの仕様から削除されました。そのため、レガシーユーザーエージェントでの問題のある再解釈を避けるために、isindex という名前はもはや許可されていません。

isindex 以外の、name の任意の非空値は許可されています。ASCII 大文字と小文字を区別しない 名前 _charset_ は特別です。 Hidden コントロールの名前として使用され、value 属性が指定されていない場合、送信中に value 属性に送信文字エンコーディングが自動的に設定されます。

name IDL属性は、反映する必要があります。name コンテンツ属性を。

DOMのクロブリングはセキュリティ問題の一般的な原因です。組み込みのフォームプロパティ名を name コンテンツ属性に使用することは避けてください。

この例では、input 要素が組み込みの method プロパティを上書きします：

let form = document.createElement("form");
let input = document.createElement("input");
form.appendChild(input);

form.method;           // => "get"
input.name = "method"; // DOMのクロブリングがここで発生
form.method === input; // => true

入力名が組み込みフォームプロパティより優先されるため、JavaScriptリファレンス form.method は、組み込みの method プロパティではなく、「method」と名付けられた input 要素を指します。

4.10.18.2 要素の方向性の送信: dirname 属性

Element/input#dirname

すべての現在のエンジンでサポートされています。

Firefox116+Safari6+Chrome17+
Opera12.1+Edge79+
Edge (Legacy)?Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

dirname フォームコントロール要素の属性は、要素の方向性 を送信し、フォーム送信中に この値を含むコントロールの名前を指定します。このような属性が指定されている場合、その値は空文字列であってはなりません。

この例では、フォームにテキストコントロールと送信ボタンが含まれています:

<form action="addcomment.cgi" method=post>
  <p><label>コメント: <input type=text name="comment" dirname="comment.dir" required></label></p>
  <p><button name="mode" type=submit value="add">コメントを投稿</button></p>
 </form>

ユーザーがフォームを送信すると、ユーザーエージェントは "comment"、"comment.dir"、"mode" の3つのフィールドを含めます。したがって、ユーザーが "Hello" と入力すると、送信ボディは次のようになります:

comment=Hello&comment.dir=ltr&mode=add

ユーザーが手動で右から左への書字方向に切り替えて "مرحبا" と入力すると、送信ボディは次のようになる可能性があります:

comment=%D9%85%D8%B1%D8%AD%D8%A8%D8%A7&comment.dir=rtl&mode=add
4.10.18.3 ユーザー入力の長さの制限: maxlength 属性

フォームコントロールの maxlength 属性は、dirty value flag によって制御され、ユーザーが入力できる文字数の制限を宣言します。文字数は長さで測定され、textarea 要素の場合は、すべての改行が1文字に正規化されます（CRLFペアではなく）。

要素にフォームコントロールの maxlength 属性が指定されている場合、この属性の値は有効な非負整数でなければなりません。属性が指定されていて、その値に非負整数を解析するためのルール を適用すると数値になる場合、その数値が要素の許容される最大値の長さになります。属性が省略されている場合や、その値を解析してエラーが発生した場合、許容される最大値の長さ はありません。

制約検証: 要素に許容される最大値の長さ があり、そのdirty value flag がtrueで、値 が最後にユーザーの編集によって変更された場合（スクリプトによる変更ではなく）、その要素の長さが要素の許容される最大値の長さ を超える場合、要素は長すぎる状態になります。

ユーザーエージェントは、要素のAPI値 を、要素の長さが許容される最大値の長さ を超える値に設定することを防ぐ場合があります。

textarea 要素の場合、API値 と値 は異なります。特に、改行の正規化が適用されてから、許容される最大値の長さ がチェックされます（textarea の折り返し変換は適用されません）。

4.10.18.4 最小入力長の要件を設定: minlength 属性

フォームコントロールの minlength 属性は、dirty value flag によって制御され、ユーザーが入力できる文字数の下限を宣言します。「文字数」は長さで測定され、textarea 要素の場合、すべての改行が1文字に正規化されます（CRLFペアではなく）。

minlength 属性はrequired 属性を暗示しません。フォームコントロールにrequired 属性がない場合、値は省略可能です。minlength 属性は、ユーザーが値を入力した時点でのみ有効になります。空文字列を許可しない場合は、required 属性も設定する必要があります。

要素にフォームコントロールの minlength 属性が指定されている場合、この属性の値は有効な非負整数でなければなりません。属性が指定されていて、その値に非負整数を解析するためのルール を適用すると数値になる場合、その数値が要素の許容される最小値の長さになります。属性が省略されている場合や、その値を解析してエラーが発生した場合、許容される最小値の長さはありません。

要素に許容される最大値の長さ と許容される最小値の長さが両方指定されている場合、許容される最小値の長さ は許容される最大値の長さ以下でなければなりません。

制約検証: 要素に許容される最小値の長さ があり、そのdirty value flag が true で、値が 最後にユーザーの編集によって変更された場合（スクリプトによる変更ではなく）、その要素の長さが 要素の許容される最小値の長さ 未満である場合、要素は短すぎる状態になります。

この例では、4つのテキストコントロールがあります。1つ目は必須で、5文字以上である必要があります。残りの3つは任意ですが、ユーザーが入力を行った場合、少なくとも10文字以上入力する必要があります。

<form action="/events/menu.cgi" method="post">
  <p><label>イベント名: <input required minlength=5 maxlength=50 name=event></label></p>
  <p><label>朝食の希望があればお書きください:
     <textarea name="breakfast" minlength="10"></textarea></label></p>
  <p><label>昼食の希望があればお書きください:
     <textarea name="lunch" minlength="10"></textarea></label></p>
  <p><label>夕食の希望があればお書きください:
     <textarea name="dinner" minlength="10"></textarea></label></p>
  <p><input type=submit value="リクエストを送信"></p>
 </form>
4.10.18.5 フォームコントロールの有効化と無効化: disabled 属性

Attributes/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Attributes/disabled

すべての現在のエンジンでサポートされています。

Firefox4+Safari6+Chrome20+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

Attributes/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Attributes/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Attributes/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

disabled コンテンツ属性はブール属性です。

disabled 属性は、option要素と disabled 属性は、optgroup要素に対して別々に定義されています。

フォームコントロールが無効になるのは、次のいずれかの場合です:

無効になっているフォームコントロールは、disabledである場合、 タスクのキューにある ユーザー操作タスクソース からのclick イベントが要素に送信されるのを防止する必要があります。

制約検証: 要素がdisabledである場合、 それは制約検証から除外されます。

HTMLButtonElement/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLSelectElement/disabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

disabled IDL 属性は、反映する必要があります。disabled コンテンツ属性を。

4.10.18.6 フォーム送信属性

Element/form#Attributes_for_form_submission

すべての現在のエンジンでサポートされています。

Firefox4+Safari10.1+Chrome10+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?

フォーム送信用の属性は、form要素および送信ボタン (例: input 要素のtype属性がSubmit Button 状態であるもの) に指定できます。

フォーム送信用の属性は、form要素に指定できる属性は、action、enctype、method、novalidate、およびtargetです。

対応するフォーム送信用の属性は、送信ボタンに指定できる属性は、formaction、formenctype、formmethod、formnovalidate、およびformtargetです。省略された場合、form要素の対応する属性に設定されている値がデフォルトとして使用されます。

Element/input#formaction

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome9+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

action および formaction コンテンツ属性が指定されている場合、その値は 有効な非空の URL である必要があります。

要素のactionは、その要素が 送信ボタン であり、その属性がある場合、その要素のformaction属性の値、またはその フォームオーナー のaction属性の値がそれであり、ない場合は空の文字列です。

Element/input#formmethod

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome9+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

method および formmethod コンテンツ属性は、列挙された属性であり、次のキーワードと状態を持っています:

キーワード 状態 簡単な説明
get GET フォーム が HTTP GET メソッドを使用することを示します。
post POST フォーム が HTTP POST メソッドを使用することを示します。
dialog Dialog フォーム が、フォームが存在する ダイアログ ボックスを閉じることを目的としていることを示します。 フォームがダイアログにある場合は閉じ、それ以外の場合は送信しません。

method 属性の 欠落値のデフォルト および 無効な値のデフォルト は、GET 状態です。

formmethod 属性には 欠落値のデフォルト がなく、その 無効な値のデフォルト は GET 状態です。

要素の method は、これらの状態のいずれかです。要素が 送信ボタン であり、formmethod 属性がある場合、その要素の method はその属性の状態であり、そうでなければ、 フォームの所有者 の method 属性の状態です。

ここでは、method 属性を使用してデフォルト値 "get" を明示的に指定し、検索クエリが URL に送信されるようにします:

<form method="get" action="/search.cgi">
  <p><label>Search terms: <input type=search name=q></label></p>
  <p><input type=submit></p>
 </form>

一方、ここでは method 属性を使用して "post" の値を指定し、ユーザーのメッセージが HTTP リクエストの本文で送信されるようにします:

<form method="post" action="/post-message.cgi">
  <p><label>Message: <input type=text name=m></label></p>
  <p><input type=submit value="Submit message"></p>
 </form>

この例では、フォーム が ダイアログ と一緒に使用されています。 method 属性の "dialog" キーワードを使用して、フォームが送信されるとダイアログが自動的に閉じるようにしています。 

<dialog id="ship">
  <form method=dialog>
   <p>A ship has arrived in the harbour.</p>
   <button type=submit value="board">Board the ship</button>
   <button type=submit value="call">Call to the captain</button>
  </form>
 </dialog>
 <script>
  var ship = document.getElementById('ship');
  ship.showModal();
  ship.onclose = function (event) {
    if (ship.returnValue == 'board') {
      // ...
    } else {
      // ...
    }
  };
 </script>

Element/input#formenctype

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome9+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

enctype および formenctype コンテンツ属性は、列挙された属性であり、次のキーワードと状態を持っています:

属性の 欠落値のデフォルト および 無効な値のデフォルト は、application/x-www-form-urlencoded 状態です。

formenctype 属性には 欠落値のデフォルト がなく、その 無効な値のデフォルト は application/x-www-form-urlencoded 状態です。

要素の enctype は、これらの3つの状態のいずれかです。 要素が 送信ボタン であり、formenctype 属性がある場合、その要素の enctype はその属性の状態であり、そうでなければ、 フォームの所有者 の enctype 属性の状態です。

Element/input#formtarget

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome9+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android12.1+

target および formtarget コンテンツ属性は、指定されている場合、有効なナビゲーブルターゲット名またはキーワード である必要があります。

Element/input#formnovalidate

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

novalidate および formnovalidate コンテンツ属性は、ブール属性 です。存在する場合、 それらはフォームが送信時に検証されないことを示します。

要素の 検証しない状態 は、要素が 送信ボタン であり、要素の formnovalidate 属性が存在する場合、または要素の フォーム所有者 の novalidate 属性が存在する場合に真となり、その他の場合は偽になります。

この属性は、検証制約があるフォームに「保存」ボタンを含めるのに便利であり、 ユーザーがフォームに完全に入力していない場合でも、進捗状況を保存できるようにします。次の例は、2つの必須フィールドを持つシンプルなフォームを示しています。フォームを送信するためのボタンが1つあり、これは両方のフィールドに入力される必要があります。フォームを保存するためのボタンが1つあり、ユーザーが後で記入するためにフォームを保存できるようにします。そして、フォーム全体をキャンセルするためのボタンが1つあります。 

<form action="editor.cgi" method="post">
  <p><label>Name: <input required name=fn></label></p>
  <p><label>Essay: <textarea required name=essay></textarea></label></p>
  <p><input type=submit name=submit value="Submit essay"></p>
  <p><input type=submit formnovalidate name=save value="Save essay"></p>
  <p><input type=submit formnovalidate name=cancel value="Cancel"></p>
 </form>

HTMLFormElement/action

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLFormElement/target

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLFormElement/method

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLFormElement/enctype

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLFormElement/encoding

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

action IDL 属性は、同じ名前のコンテンツ属性を反映しなければならず、ただし、 取得時に、コンテンツ属性が欠落しているか、その値が空文字列の場合、要素の ノードドキュメントのURL が返されなければならない。 target IDL 属性は、同じ名前のコンテンツ属性を反映しなければならない。 methodおよびenctypeID 属性は、それぞれの同じ名前のコンテンツ属性を反映しなければならない。既知の値のみに制限される。 encodingID 属性は、反映されなければならない。enctypeコンテンツ属性は既知の値のみに制限される。 noValidateID 属性は、反映されなければならない novalidateコンテンツ属性。 formAction IDL 属性は、反映しなければならない。formaction コンテンツ属性は、取得時に、コンテンツ属性が欠落しているか、その値が空文字列の場合、要素の ノードドキュメントのURL が返されなければならない。 formEnctypeIDL 属性は、反映しなければならない formenctypeコンテンツ属性は、既知の値のみに制限される。 formMethodIDL 属性は、反映しなければならない。 formmethod コンテンツ属性は、既知の値のみに制限される。 formNoValidateIDL 属性は、反映 しなければならない。formnovalidateコンテンツ属性。 formTargetID 属性は、反映しなければならない。formtargetコンテンツ属性。

4.10.18.7 オートフィル
4.10.18.7.1 オートフィルによるフォームコントロールの自動入力: autocomplete 属性

Attributes/autocomplete

すべての現行エンジンでサポートされています。

Firefox4+Safari6+Chrome14+
Opera12.1+Edge79+
Edge（レガシー）サポートなしInternet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ユーザーエージェントには、ユーザーがフォームに入力するのを支援する機能がある場合があります。たとえば、以前のユーザー入力に基づいてユーザーの住所を事前入力する機能です。autocomplete 属性を使用して、ユーザーエージェントにこの機能の提供方法、または提供するかどうかを示唆できます。

この属性の使用には2つの方法があります。オートフィル期待マント を身に着けている場合、autocomplete 属性は、ユーザーから期待される入力内容を説明します。オートフィルアンカーマント を身に着けている場合、autocomplete 属性は、与えられた値の意味を説明します。

属性が input 要素であり、その type 属性が 隠し 状態にある場合、autocomplete 属性は オートフィルアンカーマント を身に着けます。他のすべての場合では、オートフィル期待マント を身に着けます。

オートフィル期待マント を身に着けている場合、指定されている場合は、autocomplete 属性には、次のいずれかのASCII大文字小文字を区別しない単一のトークンを含む順序付きの 空白で区切られたトークンのセット が値として指定されている必要があります。

オートフィルアンカーマント を身に着けている場合、指定されている場合は、autocomplete 属性には、次の順序で並べられた 空白で区切られたトークンのセット が値として指定されている必要があります。そのトークンは オートフィル詳細トークン でなければなりません。 （つまり、"on" と "off" キーワードは許可されていません）。

オートフィル詳細トークン は以下の順序で示されます：

  1. オプションとして、先頭の8文字が "section-" と ASCII 大文字と小文字を区別しない 文字列と一致するトークンを指定することができます。これは、フィールドが指定されたグループに属していることを意味します。

    例えば、フォームに2つの配送先住所がある場合、それらは次のようにマークアップされる可能性があります:

    <fieldset>
  <legend>Ship the blue gift to...</legend>
  <p> <label> Address:     <textarea name=ba autocomplete="section-blue shipping street-address"></textarea> </label>
  <p> <label> City:        <input name=bc autocomplete="section-blue shipping address-level2"> </label>
  <p> <label> Postal Code: <input name=bp autocomplete="section-blue shipping postal-code"> </label>
 </fieldset>
 <fieldset>
  <legend>Ship the red gift to...</legend>
  <p> <label> Address:     <textarea name=ra autocomplete="section-red shipping street-address"></textarea> </label>
  <p> <label> City:        <input name=rc autocomplete="section-red shipping address-level2"> </label>
  <p> <label> Postal Code: <input name=rp autocomplete="section-red shipping postal-code"> </label> 
</fieldset>

  2. オプションとして、次の文字列のいずれかに一致するトークンを指定することができます:

  3. 次の2つのオプションのいずれか:

  4. オプションとして、次の文字列 "webauthn" に ASCII 大文字と小文字を区別しない一致するトークンを指定することができます。 これは、ユーザーエージェントがフォームコントロールと対話する際に 公開鍵認証情報を 条件付き 仲介で表示することを意味します。webauthn は input および textarea 要素にのみ有効です。

前述のように、この属性とそのキーワードの意味は、その属性が身に着けているマントルに依存します。

自動入力期待マントルを身に着けている場合...

"off" キーワードは、コントロールの入力データが特に機密性の高いものである（例えば核兵器の起動コード）か、再利用されることがない（例えば銀行のログインに使用されるワンタイムキー）値であるか、またはドキュメントが独自の自動入力メカニズムを提供しており、ユーザーエージェントが自動入力値を提供することを望まないことを示します。

"on" キーワードは、ユーザーエージェントがユーザーに自動入力値を提供することを許可するが、ユーザーが入力することが期待されるデータの種類についての追加情報は提供しないことを示します。ユーザーエージェントは、どの自動入力値を提案するかを決定するためにヒューリスティックを使用する必要があります。

上記の自動入力フィールドは、ユーザーエージェントがユーザーに自動入力値を提供することを許可し、期待される値の種類を指定します。それぞれのキーワードの意味は、以下の表に記載されています。

autocomplete属性が省略された場合、要素のフォームオーナーのautocomplete属性の状態に対応するデフォルト値が使用されます（"on" または "off"）。フォームオーナーがない場合、"on"の値が使用されます。

自動入力アンカーマントルを身に着けている場合...

上記の自動入力フィールドは、指定された種類の値がこの要素に提供される値であることを示します。それぞれのキーワードの意味は、以下の表に記載されています。

この例では、ページがトランザクションの通貨と金額を明示的に指定しています。フォームはクレジットカードやその他の請求詳細を要求しています。ユーザーエージェントはこの情報を使用して、十分な残高があり、関連する通貨をサポートするクレジットカードを提案することができます。 

<form method=post action="step2.cgi">
  <input type=hidden autocomplete=transaction-currency value="CHF">
  <input type=hidden autocomplete=transaction-amount value="15.00">
  <p><label>クレジットカード番号: <input type=text inputmode=numeric autocomplete=cc-number></label>
  <p><label>有効期限: <input type=month autocomplete=cc-exp></label>
  <p><input type=submit value="Continue...">
 </form>

自動入力フィールドのキーワードは、以下の表に示されているように相互に関連しています。この表の各行にリストされているフィールド名は、「意味」という列に記載されている内容に対応しています。例えば、クレジットカードの有効期限は、月と年の両方を表す1つのフィールド「cc-exp」で表現することも、月「cc-exp-month」と年「cc-exp-year」の2つのフィールドで表現することもできます。このような場合、より広範なフィールド名が複数の行にわたっており、その中で狭いフィールドが定義されています。

一般的に、作成者は狭いフィールドよりも広いフィールドを使用することを推奨します。狭いフィールドは西洋のバイアスを露呈しがちです。例えば、いくつかの西洋文化では、名前と姓がその順で配置されるのが一般的ですが、多くの文化では姓が先で名前が後になりますし、他の多くの文化では単一の名前のみを持ちます。そのため、単一のフィールドを使用する方が柔軟です。

一部のフィールドは、特定のフォームコントロールにのみ適しています。ある自動入力フィールド名がコントロールに対して不適切であるのは、そのコントロールが表の最初の行の5列目でその自動入力フィールドにリストされているグループに属していない場合です。どのコントロールがどのグループに属するかは、表の下に記載されています。

フィールド名 意味 標準形式 標準形式の例 コントロールグループ
"name" フルネーム 自由形式のテキスト、改行なし Sir Timothy John Berners-Lee, OM, KBE, FRS, FREng, FRSA テキスト
"honorific-prefix" 敬称またはタイトル（例："Mr.", "Ms.", "Dr.", "Mlle"） 自由形式のテキスト、改行なし Sir テキスト
"given-name" 名前（いくつかの西洋文化ではファーストネームとしても知られている） 自由形式のテキスト、改行なし Timothy テキスト
"additional-name" 追加の名前（いくつかの西洋文化ではミドルネーム、ファーストネーム以外の他の名前としても知られている） 自由形式のテキスト、改行なし John テキスト
"family-name" 姓（いくつかの西洋文化ではラストネームまたは姓としても知られている） 自由形式のテキスト、改行なし Berners-Lee テキスト
"honorific-suffix" 敬称の後置（例："Jr.", "B.Sc.", "MBASW", "II"） 自由形式のテキスト、改行なし OM, KBE, FRS, FREng, FRSA テキスト
"nickname" ニックネーム、スクリーンネーム、ハンドル：フルネームの代わりに使用されることが多い短い名前 自由形式のテキスト、改行なし Tim テキスト
"organization-title" 職位（例："Software Engineer", "Senior Vice President", "Deputy Managing Director"） 自由形式のテキスト、改行なし 教授 テキスト
"username" ユーザー名 自由形式のテキスト、改行なし timbl ユーザー名
"new-password" 新しいパスワード（例：アカウント作成時またはパスワード変更時） 自由形式のテキスト、改行なし GUMFXbadyrS3 パスワード
"current-password" ユーザー名フィールドで識別されるアカウントの現在のパスワード（例：ログイン時） 自由形式のテキスト、改行なし qwerty パスワード
"one-time-code" ユーザーの身元を確認するためのワンタイムコード 自由形式のテキスト、改行なし 123456 パスワード
"organization" このフィールドに関連する他のフィールドに含まれる人物、住所、または連絡先情報に対応する会社名 自由形式のテキスト、改行なし World Wide Web Consortium Text
"street-address" 住所（複数行、改行保持） 自由形式のテキスト 32 Vassar Street
MIT Room 32-G524 		Multiline
"address-line1" 住所（各フィールドに1行） 自由形式のテキスト、改行なし 32 Vassar Street Text
"address-line2" 自由形式のテキスト、改行なし MIT Room 32-G524 Text
"address-line3" 自由形式のテキスト、改行なし Text
"address-level4" 最も細かい行政区分、4つの行政区分を持つ住所で 自由形式のテキスト、改行なし Text
"address-level3" 3番目の行政区分、3つ以上の行政区分を持つ住所で 自由形式のテキスト、改行なし Text
"address-level2" 2番目の行政区分、2つ以上の行政区分を持つ住所で；2つの行政区分を持つ国では、通常該当する住所が含まれる市町村や他の地域 自由形式のテキスト、改行なし Cambridge Text
"address-level1" 住所の最も広範な行政区分、つまり、該当する住所が含まれる州; スイスの場合はカントン; イギリスでは、郵便区 自由形式のテキスト、改行なし MA Text
"country" 国コード 有効なISO 3166-1-alpha-2 country code [ISO3166] US Text
"country-name" 国名 自由形式のテキスト、改行なし; countryから派生した場合もある US Text
"postal-code" 郵便番号、ZIPコード、CEDEXコード（CEDEXの場合、address-level2フィールドに"CEDEX"と関連するarrondissementを追加する） 自由形式のテキスト、改行なし 02139 Text
"cc-name" 支払手段に記載されているフルネーム 自由形式のテキスト、改行なし Tim Berners-Lee Text
"cc-given-name" 支払手段に記載されている名前（いくつかの西洋文化ではファーストネームとしても知られている） 自由形式のテキスト、改行なし Tim Text
"cc-additional-name" 支払手段に記載されている追加の名前（いくつかの西洋文化ではミドルネーム、ファーストネーム以外の他の名前としても知られている） 自由形式のテキスト、改行なし Text
"cc-family-name" 支払手段に記載されている姓（いくつかの西洋文化ではラストネームまたは姓としても知られている） 自由形式のテキスト、改行なし Berners-Lee Text
"cc-number" 支払手段を識別するコード（例：クレジットカード番号） ASCII数字 4114360123456785 Text
"cc-exp" 支払手段の有効期限 有効な月の文字列 2014-12 Month
"cc-exp-month" 支払手段の有効期限の月の部分 有効な整数 1..12の範囲 12 Numeric
"cc-exp-year" 支払手段の有効期限の年の部分 有効な整数 2014 Numeric
"cc-csc" 支払手段のセキュリティコード（カードセキュリティコード（CSC）、カード認証コード（CVC）、カード検証値（CVV）、署名パネルコード（SPC）、クレジットカードID（CCID）などとしても知られる） ASCII数字 419 Text
"cc-type" 支払手段の種類 自由形式のテキスト、改行なし Visa Text
"transaction-currency" ユーザーが希望する取引に使用する通貨 ISO 4217通貨コード [ISO4217] GBP Text
"transaction-amount" ユーザーが取引に希望する金額（例：入札や販売価格を入力する際） 有効な浮動小数点数 401.00 Numeric
"language" 希望する言語 有効なBCP 47言語タグ [BCP47] en Text
"bday" 誕生日 有効な日付文字列 1955-06-08 Date
"bday-day" 誕生日の曜日部分 有効な整数 1..31の範囲 8 Numeric
"bday-month" 誕生日の月の部分 有効な整数 1..12の範囲 6 Numeric
"bday-year" 誕生日の年の部分 有効な整数 0以上 1955 Numeric
"sex" 性別（例：女性、Fa'afafine） 自由形式のテキスト、改行なし Male Text
"url" このフィールドに関連する会社、人物、住所、または連絡先情報に対応するホームページや他のウェブページ 有効なURL文字列 https://www.w3.org/People/Berners-Lee/ URL
"photo" このフィールドに関連する会社、人物、住所、または連絡先情報に対応する写真、アイコン、その他の画像 有効なURL文字列 https://www.w3.org/Press/Stock/Berners-Lee/2001-europaeum-eighth.jpg URL
"tel" 国番号を含む完全な電話番号 ASCII数字とU+0020スペース文字、U+002Bプラス記号で始まる +1 617 253 5702 Tel
"tel-country-code" 電話番号の国番号部分 ASCII数字、U+002Bプラス記号で始まる +1 Text
"tel-national" 国内プレフィックスが適用される場合、国番号部分なしの電話番号 ASCII数字とU+0020スペース文字 617 253 5702 Text
"tel-area-code" 電話番号の市外局番部分、国内プレフィックスが適用される場合 ASCII数字 617 Text
"tel-local" 電話番号の市外局番なしの部分 ASCII数字 2535702 Text
"tel-local-prefix" 電話番号の市外局番の次にくる部分が2つに分かれている場合の前半部分 ASCII数字 253 Text
"tel-local-suffix" 電話番号の市外局番の次にくる部分が2つに分かれている場合の後半部分 ASCII数字 5702 Text
"tel-extension" 電話番号の内線番号 ASCII数字 1000 Text
"email" メールアドレス 有効なメールアドレス timbl@w3.org Username
"impp" インスタントメッセージングプロトコルのエンドポイントを表すURL（例："aim:goim?screenname=example"や"xmpp:fred@example.net"） 有効なURL文字列 irc://example.org/timbl,isuser URL

グループは次のようにコントロールに対応しています:

テキスト
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
textarea要素
select要素
マルチライン
input要素で、type属性がHidden状態のもの
textarea要素
select要素
パスワード
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がPassword状態のもの
textarea要素
select要素
URL
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がURL状態のもの
textarea要素
select要素
ユーザー名
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がEmail状態のもの
textarea要素
select要素
電話番号
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がTelephone状態のもの
textarea要素
select要素
数値
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がNumber状態のもの
textarea要素
select要素
月
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がMonth状態のもの
textarea要素
select要素
日付
input要素で、type属性がHidden状態のもの
input要素で、type属性がText状態のもの
input要素で、type属性がSearch状態のもの
input要素で、type属性がDate状態のもの
textarea要素
select要素

アドレスレベル: "address-level1" – "address-level4"フィールドは、住所の地域を記述するために使用されます。さまざまな地域で使用されるレベルの数は異なります。たとえば、米国では2つのレベル（州と町）が使用され、英国では住所に応じて1つまたは2つ（郵便町、および一部のケースでは地域）が使用され、中国では3つ（省、市、区）が使用されます。"address-level1"フィールドは、最も広範な行政区分を表します。さまざまな地域では、フィールドの順序が異なります。たとえば、米国では町（レベル2）が州（レベル1）の前にありますが、日本では都道府県（レベル1）が市（レベル2）の前にあり、その後に区（レベル3）が続きます。著者は、国の慣習に合わせてフォームを提供することを推奨します（ユーザーが国を変更する際にフィールドを非表示、表示、および再配置するなど）。

4.10.18.7.2 処理モデル

各input要素で、autocomplete属性が適用されるもの、および各select要素、およびtextarea要素は、自動入力ヒントセット、自動入力スコープ、自動入力フィールド名、非自動入力認証タイプ、およびIDLに公開された自動入力値を持ちます。

自動入力フィールド名は、そのフィールドで期待される特定のデータの種類を指定します。例としては、"street-address"や"cc-exp"などがあります。

自動入力ヒントセットは、ユーザーエージェントが参照すべき住所または連絡先情報の種類を識別します。例としては、"shippingfax"や"billing"などがあります。

非自動入力認証タイプは、ユーザーがフィールドと対話する際に、他の自動入力フィールド値と共にユーザーエージェントによって提供される可能性がある認証情報の種類を識別します。この値が"webauthn"であり、nullではない場合、そのタイプの認証情報を選択すると、条件付きメディエーションのnavigator.credentials.get()リクエストが解決され、自動入力が行われません。

例えば、サインインページがユーザーエージェントに保存されたパスワードを自動入力するか、公開鍵認証情報を表示して、navigator.credentials.get()リクエストを解決するよう指示することができます。ユーザーはどちらかを選択してサインインできます。 

<input name=password type=password autocomplete="current-password webauthn">

自動入力スコープは、同じ対象に関する情報を持つフィールドのグループを識別し、自動入力ヒントセットに、必要に応じて"section-*"プレフィックスを付けたものから構成されます。例としては、"billing"、"section-parent shipping"、"section-child shipping home"などがあります。

これらの値は、次のアルゴリズムを実行した結果として定義されます:

  1. 要素にautocomplete属性がない場合は、defaultとラベル付けされたステップに移動します。

  2. tokensを、属性の値をASCIIホワイトスペースで分割した結果とします。

  3. tokensが空の場合、defaultとラベル付けされたステップに移動します。

  4. indexをtokens内の最後のトークンのインデックスとします。

  5. fieldをtokensのindex番目のトークンとします。

  6. fieldを与えられたときにフィールドのカテゴリを決定する結果として、categoryとmaximum tokensのペアを設定します。

  7. categoryがnullである場合、defaultとラベル付けされたステップに移動します。

  8. tokensのトークン数がmaximum tokensを超える場合、defaultとラベル付けされたステップに移動します。

  9. categoryがOffまたはAutomaticであり、要素のautocomplete属性が自動入力アンカーマントルを身に着けている場合、defaultとラベル付けされたステップに移動します。

  10. categoryがOffである場合、要素の自動入力フィールド名を文字列"off"に設定し、その自動入力ヒントセットを空に設定し、そのIDLに公開された自動入力値を文字列"off"に設定します。その後、戻ります。

  11. categoryがAutomaticである場合、要素の自動入力フィールド名を文字列"on"に設定し、その自動入力ヒントセットを空に設定し、そのIDLに公開された自動入力値を文字列"on"に設定します。その後、戻ります。

  12. scope tokensを空のリストに設定します。

  13. hint tokensを空のセットに設定します。

  14. credential typeをnullに設定します。

  15. IDL valueをfieldと同じ値に設定します。

  16. categoryがCredentialであり、tokensのindex番目のトークンがwebauthnとASCII大文字小文字を区別しない形で一致する場合は、次のサブステップを実行します。

    1. credential typeを"webauthn"に設定します。

    2. トークンが最初のエントリである場合、doneとラベル付けされたステップに移動します。

    3. indexを1減らします。

    4. categoryとmaximum tokensのペアをindex番目のトークンに対してフィールドのカテゴリを決定する結果に設定します。

    5. categoryがNormalまたはContactでない場合、defaultとラベル付けされたステップに移動します。

    6. トークンの残りの数がmaximum tokensより多い場合、defaultとラベル付けされたステップに移動します。

    7. IDL valueをindex番目のトークン、U+0020スペース文字、および以前のIDL valueの値の連結に設定します。

  17. トークンが最初のエントリである場合、doneとラベル付けされたステップに移動します。

  18. indexを1減らします。

  19. categoryがContactであり、index番目のトークンが次の文字列の1つとASCII大文字小文字を区別しない形で一致する場合、次のサブステップを実行します。

    サブステップは次のとおりです。

    1. contactを上記のリストから一致する文字列に設定します。

    2. contactをscope tokensの先頭に挿入します。

    3. contactをhint tokensに追加します。

    4. IDL valueをcontact、U+0020スペース文字、および以前のIDL valueの値の連結に設定します。

    5. トークンが最初のエントリである場合、doneとラベル付けされたステップに移動します。

    6. indexを1減らします。

  20. トークンが次の文字列のいずれかとASCII大文字小文字を区別しない形で一致する場合、次のサブステップを実行します。

    サブステップは次のとおりです。

    1. modeを上記のリストから一致する文字列に設定します。

    2. modeをscope tokensの先頭に挿入します。

    3. modeをhint tokensに追加します。

    4. IDL valueをmode、U+0020スペース文字、および以前のIDL valueの値の連結に設定します。

    5. トークンが最初のエントリである場合、doneとラベル付けされたステップに移動します。

    6. indexを1減らします。

  21. トークンが最初のエントリでない場合、defaultとラベル付けされたステップに移動します。

  22. index番目のトークンの最初の8文字が、文字列"section-"とASCII大文字小文字を区別しない形で一致しない場合、defaultとラベル付けされたステップに移動します。

  23. sectionをindex番目のトークンに設定し、ASCII小文字に変換します。

  24. sectionをscope tokensの先頭に挿入します。

  25. IDL valueをsection、U+0020スペース文字、および以前のIDL valueの値の連結に設定します。

  26. 完了: 要素の自動入力ヒントセットをhint tokensに設定します。

  27. 要素の非自動入力認証タイプをcredential typeに設定します。

  28. 要素の自動入力スコープをscope tokensに設定します。

  29. 要素の自動入力フィールド名をfieldに設定します。

  30. 要素のIDLに公開された自動入力値をIDL valueに設定します。

  31. 戻ります。

  32. デフォルト: 要素のIDLに公開された自動入力値を空文字列に設定し、その自動入力ヒントセットおよび自動入力スコープを空に設定します。

  33. 要素のautocomplete属性が自動入力アンカーマントルを身に着けている場合、要素の自動入力フィールド名を空文字列に設定し、戻ります。

  34. formを、要素のフォーム所有者とし、存在しない場合はnullとします。

  35. formがnullでなく、そのautocomplete属性がOff状態である場合、要素の自動入力フィールド名を"off"に設定します。

    それ以外の場合、要素の自動入力フィールド名を"on"に設定します。

次のようにしてフィールドのカテゴリを決定します、与えられたfieldに基づいて：

  1. fieldが次の表の最初の列に記載されているトークンのいずれかとASCII大文字と小文字を区別しない一致を持たない場合、(null, null)のペアを返します。

    トークン 最大トークン数 カテゴリ
    "off" 1 オフ
    "on" 1 自動
    "name" 3 通常
    "honorific-prefix" 3 通常
    "given-name" 3 通常
    "additional-name" 3 通常
    "family-name" 3 通常
    "honorific-suffix" 3 通常
    "nickname" 3 通常
    "organization-title" 3 通常
    "username" 3 通常
    "new-password" 3 通常
    "current-password" 3 通常
    "one-time-code" 3 通常
    "organization" 3 通常
    "street-address" 3 通常
    "address-line1" 3 通常
    "address-line2" 3 通常
    "address-line3" 3 通常
    "address-level4" 3 通常
    "address-level3" 3 通常
    "address-level2" 3 通常
    "address-level1" 3 通常
    "country" 3 通常
    "country-name" 3 通常
    "postal-code" 3 通常
    "cc-name" 3 通常
    "cc-given-name" 3 通常
    "cc-additional-name" 3 通常
    "cc-family-name" 3 通常
    "cc-number" 3 通常
    "cc-exp" 3 通常
    "cc-exp-month" 3 通常
    "cc-exp-year" 3 通常
    "cc-csc" 3 通常
    "cc-type" 3 通常
    "transaction-currency" 3 通常
    "transaction-amount" 3 通常
    "language" 3 通常
    "bday" 3 通常
    "bday-day" 3 通常
    "bday-month" 3 通常
    "bday-year" 3 通常
    "sex" 3 通常
    "url" 3 通常
    "photo" 3 通常
    "tel" 4 連絡先
    "tel-country-code" 4 連絡先
    "tel-national" 4 連絡先
    "tel-area-code" 4 連絡先
    "tel-local" 4 連絡先
    "tel-local-prefix" 4 連絡先
    "tel-local-suffix" 4 連絡先
    "tel-extension" 4 連絡先
    "email" 4 連絡先
    "impp" 4 連絡先
    "webauthn" 5 資格情報

  2. それ以外の場合、maximum tokensおよびcategoryは、それぞれその行の第2列および第3列の値とします。

  3. ペア(category, maximum tokens)を返します。

オートフィルの目的において、コントロールのデータはコントロールの種類に依存します：

input要素で、type属性がEmail状態にあり、multiple属性が指定されている場合
要素の値s。
その他のinput要素
textarea要素
要素の値。
select要素で、multiple属性が指定されている場合
option要素のオプションリストで、選択状態がtrueに設定されているもの。
その他のselect要素
option要素のオプションリストで、選択状態がtrueに設定されているもの。

オートフィルの処理方法は、オートフィルヒントセット、オートフィルスコープ、およびオートフィルフィールド名の内容が、autocomplete属性がどのマントルを着ているかに依存します。

オートフィル期待マントルを着ている場合...

要素のオートフィルフィールド名が"off"である場合、ユーザーエージェントはコントロールのデータを記憶せず、過去の値をユーザーに提示することもありません。

さらに、要素のオートフィルフィールド名が"off"である場合、値はリセットされますがドキュメントを再アクティブ化するときに。

銀行は頻繁にユーザーエージェントがログイン情報を事前入力しないことを望んでいます：

<p><label>Account: <input type="text" name="ac" autocomplete="off"></label></p> 
 <p><label>PIN: <input type="password" name="pin" autocomplete="off"></label></p>

要素のオートフィルフィールド名が"off"でない場合、ユーザーエージェントはコントロールのデータを保存し、以前に保存された値をユーザーに提示することができます。

例えば、ユーザーが次のようなコントロールがあるページにアクセスしたとします：

<select name="country"> 
  <option>Afghanistan
  <option>Albania
  <option>Algeria
  <option>Andorra
  <option>Angola
  <option>Antigua and Barbuda
  <option>Argentina
  <option>Armenia
  <!-- ... --> 
  <option>Yemen
  <option>Zambia
  <option>Zimbabwe
 </select>

このコントロールは次のようにレンダリングされるかもしれません：

A drop-down control with a long alphabetical list of countries.

このページを初めて訪問したとき、ユーザーが「Zambia」を選択したと仮定します。2回目の訪問では、ユーザーエージェントは「Zambia」のエントリをリストの最上部に複製し、インターフェースは次のようになります：

The same drop-down control with the alphabetical list of countries, but with Zambia as an entry at the top.

要素のオートフィルフィールド名が"on"の場合、ユーザーエージェントはヒューリスティクスを使用して、要素のname値、要素が所属するフォームの他のフィールドなどに基づいて、ユーザーに提示する最も適切な値を決定しようとするべきです。

要素のオートフィルフィールド名がこのセクションの前述の表に記載されているオートフィルフィールドの名前の1つである場合、ユーザーエージェントはそのフィールド名の意味に一致する提案を提供するべきです。オートフィルヒントセットは複数の候補から選択するために使用されるべきです。

例えば、あるユーザーがかつて「shipping」キーワードを使用したフィールドに1つの住所を入力し、別の住所を「billing」キーワードを使用したフィールドに入力した場合、その後のフォームでは、オートフィルヒントセットに「shipping」キーワードが含まれるフォームコントロールには最初の住所だけが提案されるでしょう。ただし、住所関連のフォームコントロールでオートフィルヒントセットにどちらのキーワードも含まれない場合、両方の住所が提案されるかもしれません。

オートフィルアンカーマントルを着ている場合...

要素のオートフィルフィールド名が空文字列でない場合、ユーザーエージェントはユーザーが指定したものと同じように、コントロールのデータを指定されたオートフィルヒントセット、オートフィルスコープ、およびオートフィルフィールド名の組み合わせに基づいて処理しなければなりません。

ユーザーエージェントがフォームコントロールをオートフィルする際、同じフォームオーナーと同じオートフィルスコープを持つ要素は、同じ人、住所、支払い手段、および連絡先情報に関連するデータを使用しなければなりません。ユーザーエージェントが"country"フィールドと"country-name"フィールドを同じフォームオーナーおよびオートフィルスコープでオートフィルする際、ユーザーエージェントがcountryフィールドに値を持っている場合は、country-nameフィールドには同じ国の人間が読める名前で埋める必要があります。 ユーザーエージェントが複数のフィールドに同時に値を入力する場合、同じオートフィルフィールド名、フォームオーナー、およびオートフィルスコープを持つフィールドは、同じ値で埋められなければなりません。

例えば、ユーザーエージェントが2つの電話番号、+1 555 123 1234と+1 555 666 7777を知っていると仮定します。ユーザーエージェントが、autocomplete="shipping tel-local-prefix"であるフィールドに"123"の値を入力し、同じフォーム内の別のフィールドにautocomplete="shipping tel-local-suffix"で"7777"の値を入力するのは規定に準拠していません。上述の情報を考慮すると、有効な事前入力の値はそれぞれ"123"と"1234"、または"666"と"7777"のみです。

同様に、何らかの理由で"cc-exp"フィールドと"cc-exp-month"フィールドが含まれているフォームがあり、ユーザーエージェントがそのフォームを事前入力する場合、前者の月の要素は後者と一致しなければなりません。

この要件はオートフィルアンカーマントルにも影響します。次のマークアップスニペットを考えてみましょう： 

<form> 
  <input type=hidden autocomplete="nickname" value="TreePlate"> 
  <input type=text autocomplete="nickname"> 
 </form>

この場合、準拠するユーザーエージェントがテキストコントロールに提案できる唯一の値は、hidden input要素によって与えられた"TreePlate"です。

"section-*"トークンはオートフィルスコープ内で不透明です。ユーザーエージェントはこれらのトークンの正確な値から意味を導き出そうとしてはなりません。

例えば、ユーザーエージェントが"section-child"にユーザーの子供の住所を提案し、"section-spouse"にユーザーの配偶者の住所を提案するのは規定に準拠していません。

オートフィル機構は、ユーザーがコントロールのデータを変更したかのようにユーザーエージェントが動作することによって実装されなければならず、要素が変更可能な時点で行われなければなりません（例：要素がドキュメントに挿入された直後、またはユーザーエージェントが解析を停止するときなど）。ユーザーエージェントは、ユーザーが入力した可能性のある値を使用してのみ、コントロールを事前入力しなければなりません。

例えば、select要素にoption要素が"Steve"、"Rebecca"、"Jay"、"Bob"という値のみを持ち、オートフィルフィールド名が"given-name"である場合、ユーザーエージェントが事前入力する唯一のアイデアが"Evan"であると仮定します。その場合、ユーザーエージェントはフィールドを事前入力することはできません。select要素に"Evan"という値を設定することは準拠していません。ユーザーが自分でそのようにすることができないからです。

ユーザーエージェントがフォームコントロールを事前入力する際、ドキュメントツリー内にあるフォームコントロールと接続されているフォームコントロールを差別してはなりません。つまり、要素のルートがシャドウルートであるか、Documentであるかに基づいて、オートフィルを行うかどうかを決定するのは準拠していません。

ユーザーエージェントがフォームコントロールの値を自動入力する際、そのコントロールがタイプミスマッチの状態、長すぎる状態、短すぎる状態、アンダーフロー状態、オーバーフロー状態、またはステップミスマッチ状態に陥らせてはなりません。ユーザーエージェントがフォームコントロールの値を自動入力する際、そのコントロールがパターンミスマッチ状態に陥らせてもいけません。コントロールの制約に基づいて可能な場合、ユーザーエージェントは前述の表で規定された正規の形式を使用する必要があります。正規の形式を使用できない場合、ユーザーエージェントは値を使用できるように変換するためのヒューリスティックを試みるべきです。

たとえば、ユーザーエージェントがユーザーのミドルネームが「Ines」であることを知っており、次のようなフォームコントロールに事前入力しようとする場合：

<input name=middle-initial maxlength=1 autocomplete="additional-name">

...ユーザーエージェントは「Ines」を「I」に変換し、そのように事前入力することができます。

さらに複雑な例として、月の値があります。ユーザーエージェントがユーザーの誕生日が2012年7月27日であることを知っている場合、次のコントロールすべてに対して、この情報に基づいてわずかに異なる値を事前入力しようとする可能性があります： 

<input name=b type=month autocomplete="bday">
 2012-07 日付は削除されます。なぜなら、Month状態では月/年の組み合わせのみが受け入れられるためです。（この例は非準拠です。なぜなら、オートフィルフィールド名 bday は Month状態で許可されていません。） 
<select name=c autocomplete="bday">
  <option>Jan
  <option>Feb
  ...
  <option>Jul
  <option>Aug
  ...
 </select>
 July ユーザーエージェントは、12個のオプションがあり、7番目を選択するか、文字列（3文字の「Jul」、改行およびスペースで区切られたもの）がユーザーエージェントがサポートする言語の1つで月の名前（July）に近い一致であることを認識するなどのメカニズムを通じて、リストされたオプションから月を選択します。 
<input name=a type=number min=1 max=12 autocomplete="bday-month">
 7 ユーザーエージェントは「July」を1から12の範囲の月番号に変換します。 
<input name=a type=number min=0 max=11 autocomplete="bday-month">
 6 ユーザーエージェントは「July」を0から11の範囲の月番号に変換します。 
<input name=a type=number min=1 max=11 autocomplete="bday-month">
 ユーザーエージェントはフィールドに入力しません。なぜなら、フォームが何を期待しているのか良い推測ができないからです。

ユーザーエージェントは、要素のオートフィルフィールド名を上書きすることを許可する場合があります。たとえば、ページ作成者の反対にもかかわらず値を記憶し、事前入力できるようにするために、"off"を"on"に変更したり、常に"off"にして値を記憶しないようにするなどです。

より具体的には、ユーザーエージェントは、次の表の最初の列に記載されている説明に一致するフォームコントロールのオートフィルフィールド名を、オートフィルフィールド名が"on"または"off"である場合に、2番目のセルに示された値で置き換えることを考慮する場合があります。この表が使用される場合、置換はツリー順で行う必要があります。最初の行を除いてすべての行は、前の要素のオートフィルフィールド名を参照しているためです。 以下の説明で、フォームコントロールが他のフォームコントロールの前または後に配置されていることに言及する場合、それらは同じフォーム所有者を共有するリストされた要素のリストで意味します。

フォームコントロール 新しいオートフィルフィールド名
input 要素で、type 属性が テキスト状態にあり、その後に input 要素で、type 属性が パスワード状態にあるもの "username"
input 要素で、type 属性が パスワード状態にあり、その前に input 要素で、オートフィルフィールド名が"username"であるもの "current-password"
input 要素で、type 属性が パスワード状態にあり、その前に input 要素で、オートフィルフィールド名が"current-password"であるもの "new-password"
input 要素で、type 属性が パスワード状態にあり、その前に input 要素で、オートフィルフィールド名が"new-password"であるもの "new-password"

取得時に、autocompleteIDL属性は要素のIDL公開オートフィル値を返し、設定時には同じ名前のコンテンツ属性を反映する必要があります。

4.10.19 テキストコントロールの選択に関するAPI

input要素とtextarea要素は、それぞれの選択を処理するためのいくつかの属性とメソッドを定義しています。それらの共有アルゴリズムがここに定義されています。

element.select()

テキストコントロール内のすべてを選択します。

element.selectionStart [ = value ]

選択範囲の開始位置のオフセットを返します。

設定することで、選択範囲の開始位置を変更できます。

element.selectionEnd [ = value ]

選択範囲の終了位置のオフセットを返します。

設定することで、選択範囲の終了位置を変更できます。

element.selectionDirection [ = value ]

現在の選択の方向を返します。

設定することで、選択の方向を変更できます。

可能な値は「forward」、「backward」、および「none」です。

element.setSelectionRange(start, end [, direction])

HTMLInputElement/setSelectionRange

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

指定された方向で、指定された部分文字列を含むように選択範囲を変更します。方向が省略された場合、それはプラットフォームのデフォルト（noneまたはforward）にリセットされます。

element.setRangeText(replacement [, start, end [, selectionMode ] ])

HTMLInputElement/setRangeText

すべての現在のエンジンでサポートされています。

Firefox27+Safari7+Chrome24+
Opera?Edge79+
Edge (レガシー)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

テキストの範囲を新しいテキストで置き換えます。startとendの引数が指定されていない場合、範囲は選択範囲であると見なされます。

最後の引数は、テキストが置き換えられた後に選択がどのように設定されるかを決定します。可能な値は次のとおりです：

"select"
新しく挿入されたテキストを選択します。
"start"
選択範囲を挿入されたテキストの直前に移動します。
"end"
選択範囲を選択されたテキストの直後に移動します。
"preserve"
選択範囲を保持するよう試みます。これはデフォルトです。

すべてのinput要素にこれらのAPIが適用され、すべてのtextarea要素には、常に選択範囲またはテキスト入力カーソル位置が存在します（レンダリングされていない要素でも）。これは、コントロールのコード単位で測定され、初期状態ではコントロールの先頭にテキスト入力カーソルが配置されます。

input要素の場合、これらのAPIは要素の値に対して操作を行う必要があります。textarea要素の場合、これらのAPIは要素のAPI値に対して操作を行う必要があります。以下のアルゴリズムでは、操作対象の値文字列を関連値と呼びます。

API値を使用することは、textarea要素に対して、U+000D（CR）文字が正規化されることを意味します。例えば、 

<textarea id="demo"></textarea>
 <script>
  demo.value = "A\r\nB";
  demo.setRangeText("replaced", 0, 2);
  assert(demo.value === "replacedB");
 </script>

もし「A\r\nB」の生の値を操作していた場合、「A\r」という文字が置き換えられ、「replaced\nB」という結果になります。しかし、API値「A\nB」を使用したため、「A\n」の文字を置き換えて「replacedB」が得られました。

U+200D ゼロ幅結合子などの表示されない文字も、文字としてカウントされます。したがって、たとえば、選択範囲が目に見えない文字だけを含む場合や、テキスト挿入カーソルがそのような文字の片側に配置される場合があります。

これらのAPIが適用される要素の関連値が変更されるたびに、次の手順を実行します：

  1. 要素が選択範囲を持っている場合：

    1. 選択の開始位置が現在関連値の終了位置を超えている場合、それを関連値の終了位置に設定します。

    2. 選択の終了位置が現在関連値の終了位置を超えている場合、それを関連値の終了位置に設定します。

    3. ユーザーエージェントが空の選択をサポートしていない場合、かつ選択の開始位置と終了位置の両方が現在関連値の終了位置を指している場合は、代わりに要素のテキスト入力カーソル位置を関連値の終了位置に設定し、選択を削除します。

  2. それ以外の場合、要素はテキスト入力カーソル位置を持っている必要があります。これが現在関連値の終了位置を超えている場合、それを関連値の終了位置に設定します。

場合によっては、関連値が変更されると、他の仕様部分がカーソル位置を変更することもあります。たとえば、値セッターを参照してください。

可能な限り、inputおよびtextarea要素でのテキスト選択を変更するためのユーザーインターフェース機能は、同じイベントが発生するようにするために、選択範囲を設定するアルゴリズムを使用して実装される必要があります。

inputおよびtextarea要素の選択には、選択方向があります。これは「forward」、「backward」、または「none」のいずれかです。選択方向の正確な意味はプラットフォームによって異なります。この方向はユーザーが選択を操作する際に設定されます。初期の選択方向は、プラットフォームがその方向をサポートしている場合は「none」、そうでない場合は「forward」でなければなりません。

選択方向を設定するには、要素の選択方向を指定された方向に更新します。ただし、方向が「none」であり、プラットフォームがその方向をサポートしていない場合は、要素の選択方向を「forward」に更新します。

Windowsでは、方向は選択範囲に対するカーソルの位置を示します。「forward」の選択は、カーソルが選択範囲の終わりにあり、「backward」の選択は、カーソルが選択範囲の先頭にあります。Windowsには「none」方向はありません。

Macでは、方向はユーザーがShiftキーを使用して選択範囲を調整する際にどの端が影響を受けるかを示します。「forward」方向は選択範囲の終わりが変更され、「backward」方向は選択範囲の先頭が変更されます。Macでは「none」がデフォルトで、まだ特定の方向が選択されていないことを示します。ユーザーは、選択範囲を初めて調整するときに使用された矢印キーに基づいて、暗黙的に方向を設定します。

HTMLInputElement/select

すべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLInputElement/select

select()メソッドが呼び出されたとき、以下の手順を実行する必要があります。

  1. この要素がinput要素であり、select()がこの要素に適用されないか、対応するコントロールに選択可能なテキストがない場合、処理を終了します。

    たとえば、<input type=color>がカラーウェルとしてレンダリングされ、16進カラーコードを受け付けるテキストコントロールではないユーザーエージェントでは、このメソッドが呼び出されても無視されます。

  2. 選択範囲を設定します。開始位置は0、終了位置は無限大です。

selectionStart属性のゲッターは、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 selectionStart がこの要素に適用されない場合、nullを返します。

  2. 選択がない場合、selectionのすぐ後に続く文字の コード単位オフセットを返します。これにより、 関連する値の中で テキスト入力カーソルが位置する場所がわかります。

  3. コード単位のオフセットを返します。これにより、 関連する値の中で selectionの開始部分が位置する場所がわかります。

selectionStart 属性のセッターは、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 selectionStart がこの要素に適用されない場合、 "InvalidStateError" DOMExceptionをスローします。

  2. endを、この要素のselectionEnd 属性の値に設定します。

  3. endが与えられた値より小さい場合、endを与えられた値に設定します。

  4. 選択範囲を設定します。この範囲は、与えられた値、end、およびこの要素のselectionDirection 属性の値を使用して設定されます。

selectionEnd属性のゲッターは、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 selectionEnd がこの要素に適用されない場合、nullを返します。

  2. 選択がない場合、selectionのすぐ後に続く文字の コード単位オフセットを返します。これにより、 関連する値の中で テキスト入力カーソルが位置する場所がわかります。

  3. コード単位のオフセットを返します。これにより、 関連する値の中で selectionの終了部分が位置する場所がわかります。

selectionEnd 属性のセッターは、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 selectionEnd がこの要素に適用されない場合、 "InvalidStateError" DOMExceptionをスローします。

  2. 選択範囲を設定します。この範囲は、この要素のselectionStart 属性の値、与えられた値、および この要素のselectionDirection 属性の値を使用して設定されます。

selectionDirection属性のゲッターは、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 selectionDirection がこの要素に適用されない場合、 nullを返します。

  2. この要素の選択方向を返します。

selectionDirection 属性のセッターは、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 selectionDirection がこの要素に適用されない場合、 "InvalidStateError" DOMExceptionをスローします。

  2. 選択範囲を設定します。この範囲は、この要素のselectionStart 属性の値、selectionEnd 属性の値、および与えられた値を使用して設定されます。

setSelectionRange(start, end, direction)メソッドが呼び出されたとき、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 setSelectionRange() がこの要素に適用されない場合、 "InvalidStateError" DOMExceptionをスローします。

  2. 選択範囲を設定します。範囲は、start、end、およびdirectionを使用して設定されます。

選択範囲を設定するために、整数またはnullのstart、整数またはnullまたは特別な値infinityのend、およびオプションで文字列のdirectionを使用して、次の手順を実行します。

  1. startがnullの場合、startをゼロに設定します。

  2. endがnullの場合、endをゼロに設定します。

  3. テキストコントロールのselectionを、コード単位のシーケンスとして設定します。このシーケンスは、関連する値内のstart番目の位置（論理順序）から始まり、end番目の位置までのコード単位で構成されます。引数がテキストコントロールの長さ（特別な値infinityを含む）よりも大きい場合、テキストコントロールの末尾を指すものと見なされます。endがstartより小さいか等しい場合、選択範囲の開始位置と終了位置は、endに対応する文字の直前に設定されます。空の選択範囲の概念がないUAでは、カーソルはendに対応する文字の直前に設定されます。

  4. directionが"backward"または"forward"のどちらかと同一でない場合、またはdirection引数が与えられていない場合、directionを"none"に設定します。

  5. テキストコントロールの選択方向を設定します。この方向は、directionに基づき設定されます。

  6. 前の手順によってテキストコントロールのselectionが変更された場合（範囲や方向が変更された場合）、要素タスクをキューに入れる必要があります。このタスクは、ユーザーインタラクションタスクソースに基づいて、要素でイベントを発火させるものです。このイベントの名前はselectであり、bubbles属性はtrueに初期化されます。

setRangeText(replacement, start, end, selectMode)メソッドが呼び出されたとき、次の手順を実行する必要があります。

  1. この要素がinput要素であり、 setRangeText() がこの要素に適用されない場合、 "InvalidStateError" DOMExceptionをスローします。

  2. この要素の汚れた値フラグを trueに設定します。

  3. メソッドに引数が1つしかない場合、startおよびendの値をselectionStart 属性とselectionEnd 属性の値に設定します。

    それ以外の場合、startおよびendの値を2番目および3番目の引数の値に設定します。

  4. startがendより大きい場合、"IndexSizeError" DOMExceptionをスローします。

  5. startがテキストコントロールの長さよりも大きい場合、 テキストコントロールの関連する値の長さに設定します。

  6. endがテキストコントロールの長さよりも大きい場合、 テキストコントロールの関連する値の長さに設定します。

  7. selection startをselectionStart 属性の現在の値に設定します。

  8. selection endをselectionEnd 属性の現在の値に設定します。

  9. startがendより小さい場合、要素のコード単位のシーケンスを削除します。このシーケンスは、関連する値の中のstart番目の位置から始まり、end-1番目の位置で終わります。

  10. 最初の引数の値をテキストコントロールの関連する値に挿入し、start番目のコード単位の直前に配置します。

  11. new lengthを最初の引数の長さに設定します。

  12. new endをstartとnew lengthの和に設定します。

  13. 次のリストから適切なサブステップセットを実行します。

    4番目の引数の値が"select"の場合

    selection startをstartに設定します。

    selection endをnew endに設定します。

    4番目の引数の値が"start"の場合

    selection startとselection endをstartに設定します。

    4番目の引数の値が"end"の場合

    selection startとselection endをnew endに設定します。

    4番目の引数の値が"preserve"の場合
    メソッドに引数が1つしかない場合

    1. old lengthをendからstartを引いた値に設定します。

    2. deltaをnew lengthからold lengthを引いた値に設定します。

    3. selection startがendより大きい場合、それをdelta分だけ増やします。（deltaが負の場合、つまり新しいテキストが古いテキストより短い場合、selection startの値は減少します。）

      それ以外の場合：selection startがstartより大きい場合、それをstartに設定します。（これにより、選択の開始位置が置き換えられた新しいテキストの開始位置にスナップされます。）

    4. selection endがendより大きい場合、同じ方法でそれをdelta分だけ増やします。

      それ以外の場合：selection endがstartより大きい場合、それをnew endに設定します。（これにより、選択の終了位置が置き換えられた新しいテキストの終了位置にスナップされます。）

  14. 選択範囲を設定します。この範囲は、selection startおよびselection endで設定されます。

setRangeText() メソッドは次の列挙型を使用します。

enum SelectionMode {
   "select",
   "start",
   "end",
   "preserve" // デフォルト
 };

現在選択されているテキストを取得するには、次のJavaScriptで十分です。

var selectionText = control.value.substring(control.selectionStart, control.selectionEnd);

...ここで、controlはinputまたはtextarea要素です。

テキストコントロールの先頭にテキストを追加し、テキスト選択を維持するには、 次の3つの属性を保存する必要があります。

var oldStart = control.selectionStart;
 var oldEnd = control.selectionEnd;
 var oldDirection = control.selectionDirection;
 var prefix = "http://";
 control.value = prefix + control.value;
 control.setSelectionRange(oldStart + prefix.length, oldEnd + prefix.length, oldDirection);

...ここで、controlはinputまたはtextarea要素です。

4.10.20 制約

4.10.20.1 定義

送信可能な要素は、制約検証の候補ですが、条件によって制約検証から除外された場合を除きます。（たとえば、要素にdatalist要素の祖先がある場合、その要素は制約検証から除外されます。）

要素にはカスタム有効性エラーメッセージが定義されている場合があります。 初期状態では、要素のカスタム有効性エラーメッセージは空文字列に設定されている必要があります。値が空文字列でない場合、その要素はカスタムエラーが発生しているとみなされます。setCustomValidity()メソッドを使用して設定できますが、フォーム関連のカスタム要素を除きます。フォーム関連のカスタム要素には、そのElementInternalsオブジェクトのsetValidity()メソッドを介してカスタム有効性エラーメッセージを設定できます。 ユーザーエージェントは、コントロールの問題をユーザーに警告するときにカスタム有効性エラーメッセージを使用する必要があります。

要素はいくつかの方法で制約される可能性があります。以下は、フォームコントロールがある状態で、制約検証の目的でコントロールが無効になる有効性状態のリストです。（以下の定義は非規範的であり、各状態が適用されるかどうかをより正確に定義しているのは、この仕様書の他の部分です。）

欠落状態

コントロールが値を持たず、required属性を持っている場合（input required、textarea required）、またはラジオボタングループやselect要素においては、特定のセクションで指定されたより複雑なルールに従います。

setValidity()メソッドがvalueMissingフラグをtrueに設定した場合、フォーム関連のカスタム要素で発生します。

タイプミスマッチ状態

任意のユーザー入力を許可するコントロールの値が正しい構文ではない場合（メール、URL）。

setValidity() メソッドがtypeMismatchフラグをフォーム関連のカスタム要素に対してtrueに設定する場合。 フォーム関連カスタム要素

パターンミスマッチ状態

コントロールの値がpattern属性を満たしていない場合。

setValidity()メソッドが、フォーム関連のカスタム要素に対してpatternMismatchフラグをtrueに設定する場合。

長すぎる状態

コントロールの値が、フォームコントロールのmaxlength属性に対して長すぎる場合（input maxlength、textarea maxlength）。

setValidity()メソッドが、フォーム関連のカスタム要素に対してtooLongフラグをtrueに設定する場合。

短すぎる状態

コントロールの値が、フォームコントロールのminlength属性に対して短すぎる場合（input minlength、textarea minlength）。

setValidity()メソッドが、フォーム関連のカスタム要素に対してtooShortフラグをtrueに設定する場合。

アンダーフロー状態

コントロールの値が空文字列ではなく、min属性に対して低すぎる場合。

setValidity()メソッドが、フォーム関連のカスタム要素に対してrangeUnderflowフラグをtrueに設定する場合。

オーバーフロー状態

コントロールの値が空文字列ではなく、max属性に対して高すぎる場合。

setValidity()メソッドが、フォーム関連のカスタム要素に対してrangeOverflowフラグをtrueに設定する場合。

ステップミスマッチ状態

コントロールの値が、step属性によって規定されたルールに適合しない場合。

setValidity()メソッドが、フォーム関連のカスタム要素に対してstepMismatchフラグをtrueに設定する場合。

悪い入力状態

コントロールに不完全な入力があり、ユーザーエージェントが現在の状態でフォームを送信できるとは思わない場合。

setValidity()メソッドが、フォーム関連のカスタム要素に対してbadInputフラグをtrueに設定する場合。

カスタムエラー状態

コントロールのカスタム有効性エラーメッセージ（要素のsetCustomValidity()メソッドまたはElementInternalsのsetValidity()メソッドによって設定されたもの）が空文字列でない場合。

要素が無効化されている場合でも、これらの状態が発生することがあります。そのため、フォームの送信中に検証を行ってもユーザーに問題を示さない場合でも、これらの状態はDOMで表現される可能性があります。

要素が上記のいずれの有効性状態にも該当しない場合、その要素は制約を満たしているとみなされます。

4.10.20.2 制約の検証

ユーザーエージェントがフォーム要素formの 静的な制約の検証を行う必要がある場合、次の手順を実行する必要があります。 これにより、（フォーム内のすべてのコントロールが有効であることを示す）ポジティブな結果または（無効なコントロールが存在することを示す）ネガティブな結果と、スクリプトが責任を負っていない無効な要素のリスト（場合によっては空のリスト）が返されます。

  1. controlsを、formのフォーム所有者を持つすべての送信可能な要素のリストとし、 ツリー順で並べます。

  2. invalid controlsを、初期状態で空の要素リストとします。

  3. controls内の各要素fieldについて、ツリー順で次の処理を行います。

    1. fieldが制約検証の候補でない場合は、次の要素に進みます。

    2. そうでない場合、fieldが制約を満たしているなら、次の要素に進みます。

    3. それ以外の場合、fieldをinvalid controlsに追加します。

  4. もしinvalid controlsが空であれば、ポジティブな結果を返します。

  5. unhandled invalid controlsを、初期状態で空の要素リストとします。

  6. もしinvalid controlsに要素が存在する場合、その各要素fieldについて、ツリー順で次の処理を行います。

    1. notCanceledを、fieldでinvalidという名前のイベントを 発火する際に、キャンセル可能 属性がtrueに初期化された結果とします。

    2. もしnotCanceledがtrueであれば、fieldをunhandled invalid controlsに追加します。

  7. unhandled invalid controlsリスト内の要素のリストと共にネガティブな結果を返します。

ユーザーエージェントがフォーム要素formの インタラクティブな制約の検証を行う場合、次の手順を実行する必要があります。

  1. 静的な制約の検証をformに対して行い、 もし結果がネガティブであった場合、unhandled invalid controlsを返されたリストとします。

  2. もし結果がポジティブであれば、その結果を返します。

  3. unhandled invalid controlsに含まれる少なくとも1つの要素に関連する制約の問題をユーザーに報告します。

  4. ネガティブな結果を返します。

4.10.20.3 制約検証API
element.willValidate

HTMLObjectElement/willValidate

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

フォームが送信される際に要素が検証される場合はtrueを返し、それ以外の場合はfalseを返します。

element.setCustomValidity(message)

HTMLObjectElement/setCustomValidity

すべての現行エンジンでサポートされています。

Firefox4+Safari5.1+Chrome10+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

HTMLSelectElement/setCustomValidity

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

カスタムエラーを設定し、要素が検証に失敗するようにします。指定されたメッセージは、問題をユーザーに報告する際に表示されるメッセージです。

引数が空の文字列である場合、カスタムエラーをクリアします。

element.validity.valueMissing

ValidityState/valueMissing

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

要素に値がなく、必須フィールドである場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.typeMismatch

要素の値が正しい構文ではない場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.patternMismatch

要素の値が指定されたパターンと一致しない場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.tooLong

ValidityState/tooLong

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android64+Safari iOS5+Chrome Android?WebView Android4+Samsung Internet?Opera Android12.1+

要素の値が指定された最大長を超えている場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.tooShort

ValidityState/tooShort

すべての現行エンジンでサポートされています。

Firefox51+Safari10+Chrome40+
Opera?Edge79+
Edge (Legacy)17+Internet Explorerなし
Firefox Android64+Safari iOS?Chrome Android?WebView Android67+Samsung Internet?Opera Android?

要素の値が空文字列でない場合に、指定された最小長よりも短い場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.rangeUnderflow

要素の値が指定された最小値よりも低い場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.rangeOverflow

要素の値が指定された最大値よりも高い場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.stepMismatch

要素の値がstep属性によって指定されたルールに適合しない場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.badInput

ValidityState/badInput

すべての現行エンジンでサポートされています。

Firefox29+Safari7+Chrome25+
Opera？Edge79+
Edge (Legacy)12+Internet Explorerなし
Firefox Android64+Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

ユーザーインターフェイスでユーザーが入力した内容をユーザーエージェントが値に変換できない場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.customError

要素にカスタムエラーがある場合はtrueを返し、それ以外の場合はfalseを返します。

element.validity.valid

要素の値に検証の問題がない場合はtrueを返し、それ以外の場合はfalseを返します。

valid = element.checkValidity()

HTMLInputElement/checkValidity

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android？Safari iOS4+Chrome Android？WebView Android37+Samsung Internet？Opera Android12.1+

HTMLObjectElement/checkValidity

すべての現行エンジンでサポートされています。

Firefox4+Safari5.1+Chrome10+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android？Safari iOS？Chrome Android？WebView Android37+Samsung Internet？Opera Android12.1+

HTMLSelectElement/checkValidity

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android？Safari iOS4+Chrome Android？WebView Android37+Samsung Internet？Opera Android10.1+

要素の値に検証の問題がない場合はtrueを返し、それ以外の場合はfalseを返し、その場合は要素でinvalidイベントが発火し、（イベントがキャンセルされていない場合）問題がユーザーに報告されます。

valid = element.reportValidity()

HTMLFormElement/reportValidity

すべての現行エンジンでサポートされています。

Firefox49+Safari10.1+Chrome40+
Opera？Edge79+
Edge (Legacy)17+Internet Explorerなし
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

HTMLInputElement/reportValidity

すべての現行エンジンでサポートされています。

Firefox49+Safari10.1+Chrome40+
Opera？Edge79+
Edge (Legacy)17+Internet Explorerなし
Firefox Android64+Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

要素の値に検証の問題がない場合はtrueを返し、それ以外の場合はfalseを返し、その場合は要素でinvalidイベントが発火し、（イベントがキャンセルされていない場合）問題がユーザーに報告されます。

element.validationMessage

HTMLObjectElement/validationMessage

すべての現行エンジンでサポートされています。

Firefox4+Safari5.1+Chrome10+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android？Safari iOS？Chrome Android？WebView Android37+Samsung Internet？Opera Android12.1+

要素の検証が行われる場合にユーザーに表示されるエラーメッセージを返します。

属性willValidateのgetterは、この要素が制約検証の候補である場合にtrueを返し、それ以外の場合はfalseを返さなければなりません（つまり、制約検証から除外されている場合はfalseを返します）。

ElementInternals/willValidate

すべての現在のエンジンでサポートされています。

Firefox98+Safari16.4+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

属性willValidateのgetterは、ターゲット要素がフォーム関連カスタム要素でない場合、取得時に"NotSupportedError" DOMExceptionをスローしなければなりません。そうでない場合は、ターゲット要素が制約検証の候補である場合にtrueを返し、それ以外の場合はfalseを返さなければなりません。

HTMLInputElement/setCustomValidity

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

メソッドsetCustomValidity(error)のステップは次のとおりです:

  1. errorに与えられた改行を正規化する結果を設定します。

  2. カスタム有効性エラーメッセージにerrorを設定します。

次の例では、スクリプトがフォームコントロールの値を編集するたびにチェックし、無効な値の場合、setCustomValidity()メソッドを使用して適切なメッセージを設定します。 

<label>Feeling: <input name=f type="text" oninput="check(this)"></label>
 <script>
  function check(input) {
    if (input.value == "good" ||
        input.value == "fine" ||
        input.value == "tired") {
      input.setCustomValidity('"' + input.value + '" is not a feeling.');
    } else {
      // input is fine -- reset the error message
      input.setCustomValidity('');
    }
  }
 </script>

HTMLObjectElement/validity

すべての現在のエンジンでサポートされています。

Firefox4+Safari5.1+Chrome10+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

属性validityのgetterは、この要素のValidityStateオブジェクトを返さなければなりません。このオブジェクトはこの要素の有効性状態を表します。このオブジェクトはライブです。

ElementInternals/validity

すべての現在のエンジンでサポートされています。

Firefox98+Safari16.4+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

属性validityのgetterは、ターゲット要素がフォーム関連カスタム要素でない場合、取得時に"NotSupportedError" DOMExceptionをスローしなければなりません。そうでない場合は、ターゲット要素のValidityStateオブジェクトを返さなければなりません。このオブジェクトは有効性状態を表します。このオブジェクトはライブです。

[Exposed=Window]
 interface ValidityState {
   readonly attribute boolean valueMissing;
   readonly attribute boolean typeMismatch;
   readonly attribute boolean patternMismatch;
   readonly attribute boolean tooLong;
   readonly attribute boolean tooShort;
   readonly attribute boolean rangeUnderflow;
   readonly attribute boolean rangeOverflow;
   readonly attribute boolean stepMismatch;
   readonly attribute boolean badInput;
   readonly attribute boolean customError;
   readonly attribute boolean valid;
 };

ValidityStateオブジェクトには、次の属性があります。取得時には、以下のリストで示された対応する条件がtrueであればtrueを返し、それ以外の場合はfalseを返す必要があります。

valueMissing

コントロールが欠損している場合です。

typeMismatch

ValidityState/typeMismatch

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

コントロールが型不一致の問題がある場合です。

patternMismatch

ValidityState/patternMismatch

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

コントロールがパターン不一致の問題がある場合です。

tooLong

コントロールが長すぎる場合です。

tooShort

コントロールが短すぎる場合です。

rangeUnderflow

ValidityState/rangeUnderflow

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

コントロールがアンダーフローの問題がある場合です。

rangeOverflow

ValidityState/rangeOverflow

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

コントロールがオーバーフローの問題がある場合です。

stepMismatch

ValidityState/stepMismatch

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

コントロールがステップ不一致の問題がある場合です。

badInput

コントロールが入力エラーがある場合です。

customError

コントロールがカスタムエラーがある場合です。

valid

他の条件のいずれもtrueではない場合です。

要素elementの有効性をチェックする手順は次の通りです。

  1. もしelementが制約バリデーションの候補であり、その制約を満たしていない場合:

    1. イベントを発生させ、そのイベント名をinvalidとし、elementでcancelable属性をtrueに設定する（ただし、キャンセルしても効果はありません）。

    2. falseを返します。

  2. trueを返します。

checkValidity()メソッドは、呼び出されたとき、この要素に対して有効性をチェックする手順を実行しなければなりません。

ElementInternals/checkValidity

すべての現在のエンジンでサポートされています。

Firefox98+Safari16.4+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

checkValidity()メソッドは、ElementInternalsインターフェースの手順を実行しなければなりません。

  1. elementを、このElementInternalsの対象要素に設定します。

  2. もしelementがフォーム関連カスタム要素でない場合、"NotSupportedError"をスローし、DOMExceptionを生成します。

  3. elementに対して有効性をチェックする手順を実行します。

要素elementの有効性を報告する手順は次の通りです。

  1. もしelementが制約バリデーションの候補であり、その制約を満たしていない場合:

    1. reportを、イベントを発生させた結果として取得し、イベント名をinvalidとし、elementでcancelable属性をtrueに設定します。

    2. もしreportがtrueであれば、この要素の制約に関する問題をユーザーに報告します。制約に関する問題をユーザーに報告する際、ユーザーエージェントはelementに対してフォーカス手順を実行することができ、文書のスクロール位置を変更するか、またはelementをユーザーの注意を引くような形で表示するなどのアクションを実行することができます。もしelementが複数の問題を抱えている場合、ユーザーエージェントは複数の制約違反を報告することができます。

    3. falseを返します。

  2. trueを返します。

reportValidity()メソッドは、呼び出されたとき、この要素に対して有効性を報告する手順を実行しなければなりません。

ElementInternals/reportValidity

すべての現在のエンジンでサポートされています。

Firefox98+Safari16.4+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

reportValidity()メソッドは、ElementInternalsインターフェースの手順を実行しなければなりません。

  1. elementを、このElementInternalsの対象要素に設定します。

  2. もしelementがフォーム関連カスタム要素でない場合、"NotSupportedError"をスローし、DOMExceptionを生成します。

  3. elementに対して有効性を報告する手順を実行します。

validationMessage属性のゲッターは、次の手順を実行する必要があります。

  1. この要素が制約バリデーションの候補でない場合、またはこの要素がその制約を満たしている場合、空の文字列を返します。

  2. ユーザーエージェントが、制約違反がある唯一のフォームコントロールである場合にユーザーに表示する適切にローカライズされたメッセージを返します。ユーザーエージェントがそのような状況で実際にテキストメッセージを表示しない場合（例えば、グラフィカルなキューを表示する場合など）、コントロールが満たしていない制約を表す適切にローカライズされたメッセージを返します。要素が制約バリデーションの候補であり、カスタムエラーの問題がある場合、カスタムバリディティエラーメッセージが返される値に含まれている必要があります。

4.10.20.4 セキュリティ

サーバーはクライアントサイドのバリデーションに依存してはいけません。クライアントサイドのバリデーションは、悪意のあるユーザーによって意図的に無効化されたり、古いユーザーエージェントやこれらの機能を実装していない自動化ツールを使用するユーザーによって意図せず無効化される可能性があります。制約バリデーション機能は、あくまでユーザーエクスペリエンスを向上させるためのものであり、セキュリティメカニズムを提供するものではありません。

4.10.21 フォーム送信

4.10.21.1 はじめに

このセクションは規範的ではありません。

フォームが送信されると、フォーム内のデータはenctypeによって指定された構造に変換され、指定されたアクションに対して、指定されたメソッドを使用して送信されます。

たとえば、次のフォームを考えてみましょう。

<form action="/find.cgi" method=get>
  <input type=text name=t>
  <input type=search name=q>
  <input type=submit>
 </form>

ユーザーが最初のフィールドに「cats」、2番目のフィールドに「fur」と入力し、送信ボタンを押した場合、ユーザーエージェントは/find.cgi?t=cats&q=furを読み込みます。

一方、次のフォームを考えてみてください。

<form action="/find.cgi" method=post enctype="multipart/form-data">
  <input type=text name=t>
  <input type=search name=q>
  <input type=submit>
 </form>

同じユーザー入力を与えた場合、送信時の結果はかなり異なります。ユーザーエージェントは指定されたURLに対してHTTP POSTを実行し、エンティティボディには次のようなテキストが含まれます。

------kYFrd4jNJEgCervE
Content-Disposition: form-data; name="t"

cats
------kYFrd4jNJEgCervE
Content-Disposition: form-data; name="q"

fur
------kYFrd4jNJEgCervE--
4.10.21.2 暗黙の送信

フォーム要素のデフォルトボタンとは、そのフォーム所有者がそのフォーム要素である、送信ボタンのうち、ツリー順で最初のボタンを指します。

ユーザーエージェントがユーザーにフォームを暗黙的に送信させることをサポートしている場合（例えば、いくつかのプラットフォームでは、テキストコントロールがフォーカスされている間に「Enter」キーを押すと暗黙的にフォームが送信される場合があります）、デフォルトボタンがアクティベーション動作を持ち、無効でないフォームの場合、ユーザーエージェントはそのデフォルトボタンにクリックイベントを発火させなければなりません。

ウェブ上には、暗黙的にフォームを送信する方法がないと利用できないページが存在するため、ユーザーエージェントはこれをサポートすることが強く推奨されます。

フォームに送信ボタンがない場合、暗黙の送信メカニズムは次の手順を実行しなければなりません:

  1. フォームに複数の暗黙の送信をブロックするフィールドがある場合、終了します。

  2. フォーム要素自身からフォーム要素を送信し、ユーザー関与を"アクティベーション"に設定します。

前段の目的のために、ある要素がフォーム要素の暗黙の送信をブロックするフィールドである場合、それはそのフォーム所有者がそのフォーム要素であり、タイプ属性が以下のいずれかの状態にあるinput要素です: テキスト、検索、電話、URL、メール、パスワード、日付、月、週、時間、ローカル日付と時間、数値

4.10.21.3 フォーム送信アルゴリズム

各 form 要素には、エントリリストを構築中というブール値があり、初期値はfalseです。

各 form 要素には、送信イベントを発生させるというブール値があり、初期値はfalseです。

フォームを送信するには、form要素formを、オプションのブール値submitted from submit() method（デフォルトはfalse）およびオプションのユーザーのナビゲーション関与 userInvolvement（デフォルトは"none"）を与えられた状態で、要素submitter（通常はボタン）から送信します。

  1. もし form が ナビゲートできない 場合、リターンします。

  2. もし form の エントリリストを構築中 がtrueの場合、リターンします。

  3. form document を form の ノードドキュメントとします。

  4. もし form document の アクティブサンドボックスフラグセット が サンドボックスフォームブラウジングコンテキストフラグ を持っている場合、リターンします。

  5. もし submitted from submit() メソッド がfalseである場合は、以下の手順を実行します:

    1. もし form の 送信イベントを発生させる がtrueである場合、リターンします。

    2. form の 送信イベントを発生させる をtrueに設定します。

    3. form の フォーム所有者 が form である 送信可能な要素 のリスト内の各要素 field に対して、field の ユーザーの有効性 をtrueに設定します。

    4. もし submitter 要素の ノーバリデート状態 がfalseである場合、form の制約を対話的に検証するを実行し、結果を確認します。結果が負の場合（つまり、制約の検証で無効なフィールドがあると判断され、おそらくユーザーに通知された）、以下の手順を実行します:

      1. form の 送信イベントを発生させる をfalseに設定します。

      2. リターンします。

    5. submitterButton を submitter が form の場合はnullに設定します。それ以外の場合、submitterButton を submitter に設定します。

    6. shouldContinue を イベントを発火 させ、submit イベントを form で発火させ、SubmitEvent を使用し、submitter 属性を submitterButton に初期化し、bubbles 属性をtrueに、cancelable 属性をtrueに初期化します。

    7. form の 送信イベントを発生させる をfalseに設定します。

    8. もし shouldContinue がfalseであれば、リターンします。

    9. もし form が ナビゲートできない 場合、リターンします。

      ナビゲートできない が再度実行されるのは、submit イベントをディスパッチすることが結果を変えた可能性があるためです。

  6. encoding をフォームのエンコーディングを選択する の結果とします。

  7. entry list を エントリリストを構築する の結果とし、 form、submitter、および encoding を使用します。

  8. アサート: entry list がnullでないことを確認します。

  9. もし form が ナビゲートできない 場合、リターンします。

    ナビゲートできない が再度実行されるのは、formdata イベントを エントリリストを構築する ときにディスパッチすることで結果が変わった可能性があるためです。

  10. method を submitter 要素の メソッド とします。

  11. もし method が ダイアログ の場合は:

    1. form に先祖要素 ダイアログ がない場合、リターンします。

    2. subject を form の最も近い先祖要素 ダイアログ とします。

    3. result をnullとします。

    4. もし submitter が input 要素であり、その タイプ 属性が イメージボタン 状態であれば:

      1. (x, y) を 選択された座標 とします。

      2. result を x、","、および y の連結とします。

    5. それ以外の場合、submitter が送信ボタンの場合、result を submitter のオプションの値に設定します。

    6. ダイアログを閉じる subject と result で。

    7. リターンします。

  12. action を submitter 要素の アクション とします。

  13. もし action が空文字列であれば、action を URL とし、form document とします。

  14. parsed action をURLのエンコーディング解析 の結果とし、 action を submitter の ノードドキュメント に対して相対的に解析します。

  15. もし parsed action が失敗した場合、リターンします。

  16. scheme を スキーム とし、 parsed action を scheme とします。

  17. enctype を submitter 要素の エンコードタイプ とします。

  18. formTarget をnullとします。

  19. もし submitter 要素が 送信ボタン であり、その formtarget 属性を持っている場合、 formTarget にその formtarget 属性値を設定します。

  20. target を要素のターゲットを取得する の結果とし、 submitter の フォーム所有者 および formTarget を取得します。

  21. noopenerを、form、parsed action、およびtargetを指定して要素のnoopenerを取得した結果とする。

  22. targetNavigable を、 ナビゲーブルを選択するルール を適用し、target、form の ノードナビゲーブル で、 noopener とします。

  23. もし targetNavigable がnullであれば、リターンします。

  24. historyHandling を "auto" とします。

  25. もし form document が targetNavigable の アクティブドキュメント と等しく、 form document がまだ 完全に読み込まれていない 場合、 historyHandling を "置き換え" に設定します。

  26. 以下の表に基づいて scheme に該当する行を選択します。次に、その行に基づいて method を選択し、各列に基づいて適切なセルを選択します。その後、そのセルに名前が記載されている手順にジャンプし、下に定義されている手順に従います。

    GET POST
    http アクションURLを変更する エンティティボディとして送信する
    https アクションURLを変更する エンティティボディとして送信する
    ftp アクションURLを取得する アクションURLを取得する
    javascript アクションURLを取得する アクションURLを取得する
    data アクションURLを変更する アクションURLを取得する
    mailto ヘッダー付きで送信する 本文として送信する

    もし scheme がこの表に記載されていないものであれば、この仕様ではその動作は定義されていません。ユーザーエージェントは、別の仕様が定義されていない場合、類似のスキームに対してこの仕様で定義されたものと類似の方法で動作するべきです。

    各 form 要素には 計画されたナビゲーション があり、nullまたは タスク のどちらかです。form が最初に作成されたとき、その 計画されたナビゲーション はnullに設定されます。以下に示す動作では、ユーザーエージェントが指定されたURLに ナビゲートを計画する 必要がある場合には、次の手順を実行します。

    1. referrerPolicy を空の文字列に設定します。

    2. もし form 要素のリンクタイプに noreferrer キーワードが含まれている場合、referrerPolicy を "no-referrer" に設定します。

    3. もし form に非nullの 計画されたナビゲーション がある場合、それをその タスクキュー から削除します。

    4. 要素タスクをキューに追加する を DOM操作タスクソース に与え、form 要素および次の手順を実行します:

      1. form の計画されたナビゲーション をnullに設定します。

      2. historyHandlingをhistoryHandlingに設定し、userInvolvementをuserInvolvementに設定し、sourceElementをsubmitterに設定し、referrerPolicyをreferrerPolicyに設定し、documentResourceをpostResourceに設定し、formDataEntryListをentry listに設定して、form要素のノードドキュメントを使用して、targetNavigableをurlにナビゲートします。

    5. form の計画されたナビゲーション を、今追加された タスク に設定します。

    以下の動作は次の通りです:

    アクションURLを変更する

    pairs を名前と値のペアのリストに変換する の結果とし、entry list を使用します。

    query をapplication/x-www-form-urlencoded シリアライザー の結果とし、pairs と encoding を使用します。

    parsed action のクエリ コンポーネントを query に設定します。

    ナビゲートを計画する を parsed action に対して実行します。

    エンティティボディとして送信する

    アサート: method は POST であることを確認します。

    enctype に基づいて次の手順を実行します:

    application/x-www-form-urlencoded

    pairs を名前と値のペアのリストに変換する の結果とし、entry list を使用します。

    body をapplication/x-www-form-urlencoded シリアライザー の結果とし、pairs と encoding を使用します。

    body をエンコード の結果とし、body をエンコードします。

    mimeType を `application/x-www-form-urlencoded` に設定します。

    multipart/form-data

    body をmultipart/form-data エンコードアルゴリズム の結果とし、entry list と encoding を使用します。

    mimeType を等形エンコード の結果として "multipart/form-data; boundary=" を結合し、multipart/form-data 境界文字列 をmultipart/form-data エンコードアルゴリズム で生成します。

    text/plain

    pairs を名前と値のペアのリストに変換する の結果とし、entry list を使用します。

    body をtext/plain エンコードアルゴリズム の結果とし、pairs を使用します。

    body をエンコード の結果として、encoding を使用して body をエンコードします。

    mimeType を `text/plain` に設定します。

    ナビゲートを計画する を parsed action に対して実行し、POST リソース の リクエストボディ を body とし、リクエストコンテンツタイプ を mimeType に設定します。

    アクションURLを取得する

    ナビゲートを計画する を parsed action に対して実行します。

    entry list は破棄されます。

    ヘッダー付きで送信する

    pairs を名前と値のペアのリストに変換する の結果とし、entry list を使用します。

    headers をapplication/x-www-form-urlencoded シリアライザー の結果とし、pairs と encoding を使用します。

    headers 内の U+002B プラス記号（+）を "%20" という文字列に置き換えます。

    parsed action のクエリ を headers に設定します。

    ナビゲートを計画する を parsed action に対して実行します。

    本文として送信する

    pairs を名前と値のペアのリストに変換する の結果とし、entry list を使用します。

    enctype に基づいて次の手順を実行します:

    text/plain

    body をtext/plain エンコードアルゴリズム の結果とし、pairs を使用します。

    body をUTF-8パーセントエンコード の結果として実行し、body をデフォルトエンコードセット を使用してエンコードします。 [URL]

    その他

    body をapplication/x-www-form-urlencoded シリアライザー の結果とし、pairs と encoding を使用します。

    もし parsed action のクエリ がnullであれば、 空の文字列に設定します。

    もし parsed action のクエリ が空でない場合、単一のU+0026 アンパサンド文字（&）を追加します。

    parsed action のクエリ に "body=" を追加します。

    body を parsed action のクエリ に追加します。

    ナビゲートを計画する を parsed action に対して実行します。

4.10.21.4 エントリリストの構築

エントリリストは、通常フォームの内容を表すリストです。エントリは、名前（スカラー値文字列）と値（スカラー値文字列またはファイルオブジェクトのいずれか）のタプルで構成されます。

エントリを作成するには、文字列name、文字列またはBlobオブジェクトvalue、およびオプションでスカラー値文字列のfilenameを指定します。

  1. nameを、変換してnameをスカラー値文字列に変換します。

  2. valueが文字列である場合、valueを変換してvalueをスカラー値文字列に変換します。

  3. その他の場合:

    1. valueがファイルオブジェクトでない場合、valueを新しいファイルオブジェクトに設定し、同じバイトを表現し、名前属性値を「blob」にします。

    2. filenameが指定されている場合、valueを新しいファイルオブジェクトに設定し、同じバイトを表現し、名前属性をfilenameに設定します。

    これらの操作は、新しいファイルオブジェクトを作成します。filenameが指定されている場合、または渡されたBlobがファイルオブジェクトでない場合です。その場合、渡されたBlobオブジェクトの識別性は保持されません。

  4. エントリを返します。その名前はnameであり、値はvalueです。

エントリリストの構築は、form、オプションでsubmitter（デフォルトはnull）、およびオプションでencoding（デフォルトはUTF-8）を指定して実行します。

  1. formのエントリリストの構築がtrueである場合、nullを返します。

  2. formのエントリリストの構築をtrueに設定します。

  3. controlsを、formの送信可能な要素のリストに設定し、ツリー順序で並べます。

  4. entry listを新しい空のエントリリストに設定します。

  5. 各field要素について、controls内で、ツリー順序で:

    1. 以下のいずれかが真である場合:

      次に進みます(continue)。

    2. field要素がinput要素であり、そのtype属性がイメージボタン状態にある場合、次のようにします:

      1. field要素がsubmitterでない場合、次に進みます(continue)。

      2. field要素にname属性が指定されていて、その値が空でない場合、nameをその値に続けてU+002E (.)を追加したものとします。それ以外の場合、nameは空の文字列とします。

      3. namexをnameとU+0078 (x)の連結とします。

      4. nameyをnameとU+0079 (y)の連結とします。

      5. (x, y)を選択された座標とします。

      6. エントリを作成するにはnamexとxを使用し、それをentry listに追加します。

      7. エントリを作成するにはnameyとyを使用し、それをentry listに追加します。

      8. 次に進みます。

    3. fieldがフォーム関連カスタム要素の場合、fieldとentry listを指定してエントリ構築アルゴリズムを実行し、その後で次に進みます(continue)。

    4. field要素にname属性が指定されていない場合、またはそのname属性の値が空である場合、次に進みます(continue)。

    5. nameをfield要素のname属性の値に設定します。

    6. field要素がselect要素である場合、そのselect要素内のオプションリストの中で、選択されている状態であり、無効でないエントリを作成するにはnameとoption要素の値を使用し、それをentry listに追加します。

    7. それ以外の場合、field要素がinput要素であり、そのtype属性がチェックボックス状態またはラジオボタン状態にある場合:

      1. field要素にvalue属性が指定されている場合、valueをその属性の値に設定します。そうでない場合、valueを文字列「on」に設定します。

      2. エントリを作成するにはnameとvalueを使用し、それをentry listに追加します。

    8. それ以外の場合、field要素がinput要素であり、そのtype属性がファイルアップロード状態にある場合:

      1. 選択されたファイルがない場合、エントリを作成するにはnameと新しいファイルオブジェクトを使用し、空の名前、application/octet-streamとして型指定し、空の本体で、それをentry listに追加します。

      2. それ以外の場合、選択されたファイルの各ファイルについて、エントリを作成するにはnameとファイルを表すファイルオブジェクトを使用し、それをentry listに追加します。

    9. それ以外の場合、field要素がinput要素であり、そのtype属性が隠し状態にあり、nameがASCIIケース非感受性で「_charset_」と一致する場合:

      1. charsetをエンコーディングの名前に設定します。

      2. エントリを作成するにはnameとcharsetを使用し、それをentry listに追加します。

    10. それ以外の場合、エントリを作成するにはnameとfield要素の値を使用し、それをentry listに追加します。

    11. 要素にdirname属性があり、その属性の値が空でなく、要素が自動方向性フォーム関連要素である場合:

      1. dirnameを要素のdirname属性の値に設定します。

      2. dirを文字列「ltr」に設定します。要素の方向性が「ltr」の場合、そうでない場合は「rtl」に設定します（つまり、要素の方向性が「rtl」の場合）。

      3. エントリを作成するにはdirnameとdirを使用し、それをentry listに追加します。

  6. form dataを新しいFormDataオブジェクトに設定し、entry listに関連付けます。

  7. イベントをformdataとしてformに発生させ、FormDataEventを使用し、formData属性をform dataに初期化し、bubbles属性をtrueに初期化します。

  8. formのエントリリストの構築をfalseに設定します。

  9. entry listのクローンを返します。

4.10.21.5 フォーム送信エンコーディングの選択

ユーザーエージェントがフォームのエンコーディングを選択する場合、次の手順を実行しなければなりません:

  1. encodingを文書の文字エンコーディングに設定します。

  2. もしform要素がaccept-charset属性を持っている場合は、次のサブステップを実行しencodingを設定します:

    1. inputをform要素のaccept-charset属性の値に設定します。

    2. candidate encoding labelsを、inputをASCIIの空白文字で分割した結果に設定します。

    3. candidate encodingsを空の文字エンコーディングのリストとして設定します。

    4. candidate encoding labelsの各トークンについて順に（inputで見つかった順に）、そのトークンに対してエンコーディングを取得し、それが失敗しない場合はcandidate encodingsにエンコーディングを追加します。

    5. もしcandidate encodingsが空の場合は、UTF-8を返します。

    6. candidate encodingsの最初のエンコーディングを返します。

  3. 出力エンコーディングを取得してencodingを返します。

4.10.21.6 エントリーリストを名前と値のペアのリストに変換する

application/x-www-form-urlencodedやtext/plainエンコーディングアルゴリズムは、値が文字列である名前と値のペアのリストを取ります。これは、値がファイルオブジェクトである可能性のあるエントリーリストとは異なります。以下のアルゴリズムは、その変換を行います。

エントリーリストentry listを名前と値のペアのリストに変換するには、次の手順を実行します:

  1. listを空の名前と値のペアのリストとして設定します。

  2. 各entryについてentry listを次のように実行します:

    1. nameをentryのnameとし、U+000D (CR) が後に U+000A (LF) を伴わないすべての出現、およびU+000A (LF) が前に U+000D (CR) を伴わないすべての出現を、U+000D (CR) および U+000A (LF) からなる文字列に置き換えます。

    2. もしentryのvalueがファイルオブジェクトである場合、valueをentryのvalueの名前に設定します。それ以外の場合は、valueをentryのvalueに設定します。

    3. value内のU+000D (CR) が後に U+000A (LF) を伴わないすべての出現、およびU+000A (LF) が前に U+000D (CR) を伴わないすべての出現を、U+000D (CR) および U+000A (LF) からなる文字列に置き換えます。

    4. 新しい名前と値のペアをlistに追加し、その名前をname、値をvalueとします。

  3. listを返します。

4.10.21.7 URLエンコードされたフォームデータ

詳細はURLに記載されています。application/x-www-form-urlencodedに関する詳細は、[URL]を参照してください。

4.10.21.8 マルチパートフォームデータ

multipart/form-dataエンコーディングアルゴリズムは、エントリーリスト entry listとエンコーディング encodingを与えられた場合に、以下のように動作します:

  1. 各 entry について entry listを次のように実行します:

    1. entryの名前において、U+000D (CR) が後に U+000A (LF) を伴わないすべての出現、およびU+000A (LF) が前に U+000D (CR) を伴わないすべての出現を、U+000D (CR) および U+000A (LF) からなる文字列に置き換えます。

    2. もしentryの値がファイルオブジェクトでない場合、entryの値において、U+000D (CR) が後に U+000A (LF) を伴わないすべての出現、およびU+000A (LF) が前に U+000D (CR) を伴わないすべての出現を、U+000D (CR) および U+000A (LF) からなる文字列に置き換えます。

  2. このアルゴリズムの返り値を生成する際に使用されるバイト列は、RFC 7578に記載されている規則に従ってentry listをエンコードした結果のバイト列です。フォームからの値の返却: multipart/form-dataの条件を考慮して[RFC7578]を参照してください。

multipart/form-data ペイロードの解釈方法の詳細は、RFC 7578を参照してください。[RFC7578]

4.10.21.9 プレーンテキストのフォームデータ

text/plainエンコーディングアルゴリズムは、名前と値のペアpairsのリストを与えられた場合、次のように動作します:

  1. resultを空の文字列とします。

  2. pairs内の各pairについて:

    1. pairの名前をresultに追加します。

    2. 単一のU+003D等号（=）をresultに追加します。

    3. pairの値をresultに追加します。

    4. U+000D CARRIAGE RETURN (CR) U+000A LINE FEED (LF)の文字ペアをresultに追加します。

  3. resultを返します。

text/plainフォーマットを使用するペイロードは、人間が読めるように設計されています。しかし、フォーマットに曖昧さがあるため（たとえば、値の中のリテラルの改行と、値の終わりの改行を区別する方法がない）、コンピュータによって確実に解釈されることはありません。

4.10.21.10 SubmitEvent インターフェース

SubmitEvent

すべての最新エンジンでサポートされています。

Firefox75+Safari15+Chrome81+
Opera?Edge81+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

SubmitEvent/SubmitEvent

すべての最新エンジンでサポートされています。

Firefox75+Safari15+Chrome81+
Opera?Edge81+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android? 
[Exposed=Window]
 interface SubmitEvent : Event {
   constructor(DOMString type, optional SubmitEventInit eventInitDict = {});
 
   readonly attribute HTMLElement? submitter;
 };
 
 dictionary SubmitEventInit : EventInit {
   HTMLElement? submitter = null;
 };
event.submitter

送信ボタンを表す要素を返します。このボタンがフォーム送信をトリガーしたか、送信がボタンによってトリガーされなかった場合はnullを返します。

submitter属性は、初期化された値を返す必要があります。

4.10.21.11 FormDataEvent インターフェース

FormDataEvent/FormDataEvent

すべての最新エンジンでサポートされています。

Firefox72+Safari15+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

FormDataEvent

すべての最新エンジンでサポートされています。

Firefox72+Safari15+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android? 
[Exposed=Window]
 interface FormDataEvent : Event {
   constructor(DOMString type, FormDataEventInit eventInitDict);
 
   readonly attribute FormData formData;
 };
 
 dictionary FormDataEventInit : EventInit {
   required FormData formData;
 };
event.formData

FormData オブジェクトを返し、ターゲットの フォーム に関連付けられた要素の名前と値を表します。FormData オブジェクトに対する操作は、送信されるフォームデータに影響を与えます。

formData 属性は、初期化された値を返す必要があります。それは、FormData オブジェクトを表し、エントリーリストに関連付けられています。これは、フォームデータセットの構築が行われるときに構築され、フォーム が送信されるときに発生します。

4.10.22 フォームのリセット

フォーム要素 formがリセットされるとき、次の手順を実行します:

  1. resetを、formでresetという名前のイベントを発火させた結果とします。このイベントは、bubbles とcancelable 属性がtrueに初期化された状態で発火されます。

  2. もしresetがtrueであれば、formのフォームオーナーがformである各リセット可能な要素のリセットアルゴリズムを呼び出します。

各リセット可能な要素は、それぞれのリセットアルゴリズムを定義します。これらのアルゴリズムの一部としてフォームコントロールに加えられる変更は、ユーザーによる変更とは見なされません（たとえば、これによりinputイベントが発火することはありません）。

4.11 インタラクティブ要素

4.11.1 details 要素

要素/details

すべての現在のエンジンでサポートされています。

Firefox49+Safari6+Chrome12+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android49+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLDetailsElement

すべての現在のエンジンでサポートされています。

Firefox49+Safari6+Chrome10+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
インタラクティブコンテンツ。
明確なコンテンツ。
この要素が使用されるコンテキスト:
フローコンテンツが期待される場合。
コンテンツモデル:
1つのsummary要素が続くフローコンテンツ。
text/htmlでのタグ省略:
タグは省略できません。
コンテンツ属性:
グローバル属性
name — グループの名前。details要素
open — 詳細が表示されているかどうか
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
interface HTMLDetailsElement : HTMLElement {
[HTMLConstructor] constructor();

[CEReactions] attribute DOMString name;
[CEReactions] attribute boolean open;
};

details要素は、ユーザーが追加情報や操作を取得できるディスクロージャーウィジェットを表します。

すべてのHTML要素と同様に、details要素を使用して別の種類のコントロールを表すことは準拠していません。例えば、タブウィジェットやメニューウィジェットはディスクロージャーウィジェットではないため、details要素を使用してこれらのパターンを実装するのは誤りです。

details要素は脚注には適していません。脚注のマークアップについては脚注セクションを参照してください。

要素の最初のsummary要素の子が存在する場合は、その子要素が詳細の要約または説明を表します。子要素が存在しない場合、ユーザーエージェントは独自の説明（例："Details"）を提供するべきです。

要素の残りの内容は、追加情報またはコントロールを表します。

name属性は、関連するdetails要素のグループの名前を指定します。このグループの一つの要素が開くと、他の要素は閉じます。属性が指定されている場合、その値は空の文字列であってはなりません。

この機能を使用する前に、著者は関連するdetails要素を排他的アコーディオンにまとめることがユーザーにとって有益かどうかを検討する必要があります。排他的アコーディオンを使用することで、コンテンツセットが占める最大スペースを削減できる可能性がありますが、多くの項目を開く必要があるユーザーや、複数の項目の内容を同時に確認したいユーザーにとっては、苛立たしいものとなる可能性があります。

文書には、details要素が同じdetails名グループ内でopen属性を持つ要素が複数含まれていてはなりません。著者は、スクリプトを使用してdetails要素を文書に追加し、それによってdetails名グループにopen属性を持つ要素が複数含まれるようにしてはなりません。

共通のname属性によって作成される要素のグループは排他的であり、最大で1つのdetails要素しか開くことができません。この排他性はユーザーエージェントによって強制され、結果として強制がマークアップ内のopen属性を直ちに変更します。この著者に対する要件は、誤解を招くようなマークアップを禁止します。

文書には、同じdetails名グループ内に別のdetails要素が含まれているdetails要素が含まれていてはなりません。

name属性を使用して複数の関連するdetails要素をグループ化する文書は、これらの関連要素を1つの包含要素（section要素やarticle要素など）にまとめて配置する必要があります。グループに見出しを付けるのが適切な場合は、著者はその見出しを包含要素の先頭にある見出し要素に配置するべきです。

関連する要素を視覚的およびプログラム的にグループ化することは、アクセシブルなユーザー体験にとって重要な場合があります。これにより、ユーザーはこれらの要素間の関係を理解しやすくなります。関連する要素がウェブページの別々のセクションに配置されている場合、それらの要素間の関係は発見しにくく、理解しにくくなる可能性があります。

open属性はブール属性です。指定されている場合、要約と追加情報の両方がユーザーに表示されることを示します。属性が存在しない場合、要約のみが表示されます。

要素が作成されたときに、属性が存在しない場合は追加情報が非表示にされるべきです。属性が存在する場合、その情報が表示されるべきです。その後、属性が削除された場合は情報が非表示にされるべきであり、属性が追加された場合は情報が表示されるべきです。

ユーザーエージェントは、ユーザーが追加情報を表示または非表示にするよう要求できるようにするべきです。詳細を表示する要求を尊重するために、ユーザーエージェントは要素に対して設定を行い、open属性を空の文字列にします。情報を非表示にする要求を尊重するために、ユーザーエージェントは要素からopen属性を削除しなければなりません。

追加情報を表示または非表示にする機能は、適切なsummary要素が存在する場合、その要素のアクティベーション動作である可能性があります。しかし、そのような要素が存在しない場合でも、ユーザーエージェントは他のユーザーインターフェースの手段を通じてこの機能を提供できるでしょう。

details名グループにはdetails要素aが含まれており、その中には次のすべての条件を満たす他のdetails要素bも含まれています:

すべてのdetails要素にはdetailsトグルタスクトラッカーがあり、これはトグルタスクトラッカーまたはnullであり、最初はnullです。

次の属性変更手順は、element、localName、oldValue、value、およびnamespaceを考慮してすべてのdetails要素に対して使用されます:

  1. namespaceがnullでない場合は、終了します。

  2. localNameがnameである場合、elementを指定して必要に応じて指定された要素を閉じることによるdetailsの排他性を確保します。

  3. localNameがopenである場合:

    1. oldValueまたはvalueの一方がnullで、他方がnullでない場合、このdetails要素に対してdetails通知タスク手順として知られる次の手順を実行します:

      open属性が連続して切り替えられると、結果としてタスクが本質的に統合され、イベントが1つだけ発生します。

      1. oldValueがnullである場合、このdetails要素を指定してdetailsトグルイベントタスクをキューに追加し、"閉じた"と"開いた"を指定します。

      2. それ以外の場合、このdetails要素を指定してdetailsトグルイベントタスクをキューに追加し、"開いた"と"閉じた"を指定します。

    2. oldValueがnullであり、valueがnullでない場合、elementを指定して必要に応じて他の要素を閉じることによるdetailsの排他性を確保します。

detailsのHTML要素挿入手順は、insertedNodeを指定して次の通りです:

  1. insertedNodeを指定して、必要に応じて指定された要素を閉じることによるdetailsの排他性を確保します。

明確にするために、これらの属性変更と挿入手順は、パーサーを介して属性や要素が挿入された場合にも実行されます。

detailsトグルイベントタスクをキューに追加するには、details要素element、文字列oldState、および文字列newStateを指定します:

  1. elementのdetailsトグルタスクトラッカーがnullでない場合:

    1. oldStateをelementのdetailsトグルタスクトラッカーの旧状態に設定します。

    2. elementのdetailsトグルタスクトラッカーのタスクをタスクキューから削除します。

    3. elementのdetailsトグルタスクトラッカーをnullに設定します。

  2. elementを指定して、要素タスクをキューに追加し、DOM操作タスクソースを指定して次の手順を実行します:

    1. oldStateを初期化し、旧状態と新状態の属性を持つToggleEventを使用してelementでイベントを発火します。

    2. elementのdetailsトグルタスクトラッカーをnullに設定します。

  3. elementのdetailsトグルタスクトラッカーを、直前にキューに追加されたタスクを設定し、旧状態に設定された構造体に設定します。

必要に応じて他の要素を閉じることによるdetailsの排他性を確保するには、details要素elementを指定します:

  1. 確認: element が open 属性を持っていること。

  2. もし element が name 属性を持っていないか、またはその name 属性が空文字列である場合、 処理を終了する。

  3. groupMembers を element の details name group 内の element を除いたすべての要素を含むリストとし、ツリー順に並べる。

  4. それぞれの groupMembers 内の要素 otherElement について以下を行う:

    1. もし otherElement に open 属性が設定されている場合、次を実行する:

      1. 確認: otherElement が open 属性を設定されている groupMembers 内の唯一の要素であることを確認する。

      2. 削除する otherElement の open 属性を。

      3. 処理を中断する。

必要に応じて指定された要素を閉じることによるdetailsの排他性を確保するには、details要素elementを指定します:

  1. もし element が open 属性を持っていない場合、処理を終了する。

  2. もし element が name 属性を持っていないか、またはその name 属性が空文字列である場合、 処理を終了する。

  3. groupMembers を element の details name group 内の element を除いたすべての要素を含むリストとし、ツリー順に並べる。

  4. それぞれの groupMembers 内の要素 otherElement について以下を行う:

    1. もし otherElement に open 属性が設定されている場合、次を実行する:

      1. 削除する element の open 属性を。

      2. 処理を中断する。

HTMLDetailsElement/open

すべての現在のエンジンでサポートされています。

Firefox49+Safari6+Chrome10+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?

nameおよびopenIDL属性は、同名のそれぞれのコンテンツ属性を反映する必要があります。

祖先のdetailsを明らかにするアルゴリズムは、currentNodeに対して次の手順を実行します:

  1. currentNodeがフラットツリー内で親ノードを持つ間:

    1. currentNodeがdetails要素の2番目のスロットにスロットされている場合:

      1. currentNodeを、そのdetails要素に設定します。

      2. もしcurrentNodeにopen属性が設定されていない場合、open属性をcurrentNodeに空の文字列で設定します。

    2. それ以外の場合、currentNodeをフラットツリー内の親ノードに設定します。

次の例は、進行状況レポートで技術的な詳細を隠すためにdetails要素が使用される例を示しています。 

<section class="progress window">
  <h1>「本当にあなたの子供の夢を実現する」コピー</h1>
  <details>
   <summary>コピー中... <progress max="375505392" value="97543282"></progress> 25%</summary>
   <dl>
    <dt>転送速度:</dt> <dd>452KB/s</dd>
    <dt>ローカルファイル名:</dt> <dd>/home/rpausch/raycd.m4v</dd>
    <dt>リモートファイル名:</dt> <dd>/var/www/lectures/raycd.m4v</dd>
    <dt>所要時間:</dt> <dd>01:16:27</dd>
    <dt>カラープロファイル:</dt> <dd>SD (6-1-6)</dd>
    <dt>寸法:</dt> <dd>320×240</dd>
   </dl>
  </details>
 </section>

次の例は、details要素が、デフォルトで一部のコントロールを非表示にする方法を示しています: 

<details>
  <summary><label for=fn>名前と拡張子:</label></summary>
  <p><input type=text id=fn name=fn value="Pillar Magazine.pdf">
  </p>
  <p><label><input type=checkbox name=ext checked> 拡張子を隠す</label>
 </details>

これを他のdetails要素と組み合わせて使用し、リスト内の一連のフィールドを小さな見出しセットに折りたたみ、各フィールドを開くことができるようにすることができます。

これらの例では、要約は実際の値ではなく、コントロールが変更できる内容のみを要約しています。これは理想的ではありません。

次の例は、name属性を使用して、ユーザーが1つのdetails要素を開くアクションを実行すると、開いている他のdetails要素が閉じるようにする排他的アコーディオンを作成する例です。 

<section class="characteristics">
  <details name="frame-characteristics">
   <summary>材料</summary>
   額縁はオーク材の無垢材で作られています。
  </details>
  <details name="frame-characteristics">
   <summary>サイズ</summary>
   額縁は高さ40cm、幅30cmの写真が収まります。
   額縁の高さは45cm、幅35cm、厚さ2cmです。
  </details>
  </details name="frame-characteristics">
   <summary>色</summary>
   額縁はそのままの木の色、または黒染めで利用可能です。
  </details>
 </section>

次の例は、排他的アコーディオンを作成するためにname属性を使用している要素のセットの一部であるdetails要素にopen属性が設定されている場合に何が起こるかを示しています。

最初のマークアップが以下の場合:

<section class="characteristics">
  <details name="frame-characteristics" id="d1" open>...</details>
  <details name="frame-characteristics" id="d2">...</details>
  </details name="frame-characteristics" id="d3">...</details>
 </section>

スクリプトが次のように実行されると:

document.getElementById("d2").setAttribute("open", "");

スクリプトが実行された後のツリーは次のマークアップと同等になります:

<section class="characteristics">
  <details name="frame-characteristics" id="d1">...</details>
  <details name="frame-characteristics" id="d2" open>...</details>
  </details name="frame-characteristics" id="d3">...</details>
 </section>

なぜなら、open属性をd2に設定すると、それがd1から削除されるためです。

同じことが、d2内のsummary要素をユーザーがアクティブ化した場合にも発生します。

open属性は、ユーザーがコントロールと対話する際に自動的に追加および削除されるため、その状態に基づいて要素を異なるスタイルにするためにCSSで使用できます。ここでは、スタイルシートを使用して、要素が開かれたり閉じられたりしたときにsummaryの色をアニメーション化します: 

<style>
  details > summary { transition: color 1s; color: black; }
  details[open] > summary { color: red; }
 </style>
 <details>
  <summary>自動ステータス: 動作中</summary>
  <p>速度: 12m/s</p>
  </p>方向: 北</p>
 </details>

4.11.2 summary要素

要素/summary

すべての現在のエンジンでサポートされています。

Firefox49+Safari6+Chrome12+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android4+Samsung Internet?Opera Android?
カテゴリ:
なし。
この要素が使用されるコンテキスト:
最初の子として、details要素の一部として使用されます。
コンテンツモデル:
フレージングコンテンツと、必要に応じて見出しコンテンツが混在します。
text/htmlにおけるタグの省略:
タグは省略できません。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用します。

summary要素は、その親のdetails要素（存在する場合）内の他の内容の要約、キャプション、または凡例を表します。

summary要素は、次のアルゴリズムがtrueを返す場合に、親detailsの要約です:

  1. このsummary要素に親がいない場合、falseを返します。

  2. parentをこのsummary要素の親に設定します。

  3. parentがdetails要素でない場合、falseを返します。

  4. parentの最初のsummary要素の子がこのsummary要素でない場合、falseを返します。

  5. trueを返します。

summary要素のアクティベーション動作は、次の手順を実行します:

  1. このsummary要素が親detailsの要約でない場合、終了します。

  2. parentをこのsummary要素の親に設定します。

  3. もしparentにopen属性が存在する場合、それを削除します。それ以外の場合、parentのopen属性を空の文字列で設定します。

    これにより、details通知タスク手順が実行されます。

4.11.3 コマンド

4.11.3.1 ファセット

コマンドは、メニュー項目、ボタン、およびリンクの背後にある抽象概念です。コマンドが定義されると、インターフェイスの他の部分は同じコマンドを参照できるようになり、多くのアクセスポイントが無効状態などのファセットを共有できます。

コマンドには、次のファセットが定義されています:

ラベル
ユーザーに表示されるコマンドの名前。
アクセスキー
コマンドをトリガーするためにユーザーエージェントによって選択されたキーの組み合わせ。コマンドにはアクセスキーがない場合もあります。
非表示状態
コマンドが非表示かどうか（基本的にはメニューに表示されるかどうか）。
無効状態
コマンドが関連性があり、トリガーできるかどうか。
アクション
コマンドをトリガーした際の実際の効果。これには、スクリプトイベントハンドラ、URL、ナビゲート先、またはフォーム送信が含まれる可能性があります。

ユーザーエージェントは、次の条件を満たすコマンドをUIに公開する場合があります:

ユーザーエージェントは、特にアクセスキーを持つコマンドについて、これを実行し、そのキーをユーザーに宣伝することが奨励されています。

たとえば、このようなコマンドは、ユーザーエージェントのメニューバーに一覧表示される可能性があります。

4.11.3.2 a要素を使用してコマンドを定義する

a要素がhref属性を持つ場合、それはコマンドを定義します。

コマンドのラベルは、その要素の子孫テキストコンテンツです。

コマンドのアクセスキーは、その要素の割り当てられたアクセスキー（存在する場合）です。

コマンドの非表示状態は、その要素にhidden属性がある場合はtrue（非表示）、それ以外の場合はfalseです。

コマンドの無効状態ファセットは、その要素またはその祖先の一つがinertである場合はtrue、それ以外の場合はfalseです。

コマンドのアクションは、要素に対してclickイベントを発火させることです。

4.11.3.3 button要素を使用してコマンドを定義する

button要素は常にコマンドを定義します。

コマンドのラベル、アクセスキー、非表示状態、およびアクションファセットは、a要素の場合と同様に決定されます（前のセクションを参照）。

コマンドの無効状態は、その要素またはその祖先の一つがinertである場合、または要素の無効状態が設定されている場合にtrueとなり、それ以外の場合はfalseです。

4.11.3.4 input要素を使用してコマンドを定義する

input要素で、type属性が送信ボタン、リセットボタン、イメージボタン、ボタン、ラジオボタン、またはチェックボックスのいずれかの状態にある場合、コマンドを定義します。

コマンドのラベルは、次のように決定されます:

イメージボタン状態にあるvalue属性が準拠していない場合でも、属性が存在し、イメージボタンのalt属性が欠けている場合、その属性はラベルの決定に寄与する可能性があります。

コマンドのアクセスキーは、その要素の割り当てられたアクセスキーです（存在する場合）。

コマンドの非表示状態は、その要素にhidden属性がある場合にtrue（非表示）、それ以外の場合はfalseです。

コマンドの無効状態は、その要素またはその祖先の一つがinertである場合、または要素の無効状態が設定されている場合にtrue、それ以外の場合はfalseです。

コマンドのアクションは、要素に対してclickイベントを発火させることです。

4.11.3.5 option要素を使用してコマンドを定義する

option要素が、祖先にselect要素を持ち、かつvalue属性がないか、value属性が空文字列でない場合、コマンドを定義します。

コマンドのラベルは、その要素のoption要素のlabel属性の値があればその値で、なければoption要素の子孫テキストコンテンツをASCIIホワイトスペースを取り除き、折りたたんだものです。

コマンドのアクセスキーは、その要素の割り当てられたアクセスキー（存在する場合）です。

コマンドの非表示状態は、その要素にhidden属性がある場合にtrue（非表示）、それ以外の場合はfalseです。

コマンドの無効状態は、その要素が無効である場合、またはその最も近い祖先select要素が無効である場合、またはその要素またはその祖先の一つがinertである場合にtrueとなり、それ以外の場合はfalseです。

もしoption要素の最も近い祖先select要素がmultiple属性を持つ場合、コマンドのアクションは、そのoption要素をトグルすることです。それ以外の場合、アクションは、そのoption要素を選択することです。

4.11.3.6 legend要素でaccesskey属性を使用してコマンドを定義する

legend要素は、次のすべてが真である場合にコマンドを定義します:

コマンドのラベルは、その要素の子孫テキストコンテンツです。

コマンドのアクセスキーは、その要素の割り当てられたアクセスキーです。

コマンドの非表示状態、無効状態、およびアクションファセットは、このlegend要素のaccesskeyデリゲートのそれぞれのファセットと同じです。

この例では、legend要素がaccesskeyを指定しており、これがアクティブになると、input要素にデリゲートされます。 

<fieldset>
  <legend accesskey=p>
   <label>I want <input name=pizza type=number step=1 value=1 min=0>
    pizza(s) with these toppings</label>
  </legend>
  <label><input name=pizza-cheese type=checkbox checked> Cheese</label>
  <label><input name=pizza-ham type=checkbox checked> Ham</label>
  <label><input name=pizza-pineapple type=checkbox> Pineapple</label>
 </fieldset>
4.11.3.7 accesskey属性を使用して他の要素でコマンドを定義する

割り当てられたアクセスキーを持つ要素は、コマンドを定義します。

もし以前のセクションで定義された要素が、コマンドを定義すると定義されている場合、そのセクションがこの要素に適用され、このセクションは適用されません。それ以外の場合、このセクションがその要素に適用されます。

コマンドのラベルは要素によって異なります。要素がラベル付きコントロールである場合、最初のlabel要素の子孫テキストコンテンツがラベルになります（JavaScriptの用語では、これはelement.labels[0].textContentで表されます）。それ以外の場合、子孫テキストコンテンツがラベルになります。

コマンドのアクセスキーは、その要素の割り当てられたアクセスキーです。

コマンドの非表示状態は、要素にhidden属性がある場合にtrue（非表示）、それ以外の場合はfalseです。

コマンドの無効状態は、その要素またはその祖先の一つがinertである場合にtrueとなり、それ以外の場合はfalseです。

コマンドのアクションは、次のステップを実行することです:

  1. 要素のフォーカス手順を実行します。
  2. 要素にclickイベントを発生させます。

4.11.4 dialog要素

Element/dialog

すべての現行エンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge（レガシー）?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLDialogElement

すべての現行エンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge（レガシー）?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
この要素が使用される文脈:
フローコンテンツが期待される場所。
コンテンツモデル:
フローコンテンツ。
text/htmlにおけるタグの省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
closedby — どのユーザー操作がダイアログを閉じるか
open — ダイアログボックスが表示されているかどうか
アクセシビリティ考慮事項:
著者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
interface HTMLDialogElement : HTMLElement {
  [HTMLConstructor] constructor();

  [CEReactions] attribute boolean open;
  attribute DOMString returnValue;
  [CEReactions] attribute DOMString closedBy;
  [CEReactions] undefined show();
  [CEReactions] undefined showModal();
  [CEReactions] undefined close(optional DOMString returnValue);
  [CEReactions] undefined requestClose(optional DOMString returnValue);
};

dialog 要素は、小さなウィンドウ（「ダイアログボックス」）の形式で、アプリケーションの一時的な部分を表します。ユーザーは、タスクを実行したり、情報を収集したりするためにこのウィンドウと対話します。ユーザーが作業を完了すると、ダイアログはアプリケーションによって自動的に閉じられるか、ユーザーが手動で閉じることができます。

特にモーダルダイアログは、すべての種類のアプリケーションでおなじみのパターンであるため、著者は、Webアプリケーション内のダイアログが非Webアプリケーションのユーザーにとっても馴染みのある方法で動作するようにする必要があります。

すべてのHTML要素と同様に、dialog 要素を他の種類のコントロールを表現しようとする際に使用することは適合しません。たとえば、コンテキストメニュー、ツールチップ、およびポップアップリストボックスはダイアログボックスではないため、dialog 要素をこれらのパターンを実装するために乱用することは誤りです。

ユーザー向けダイアログの動作で重要な部分は、初期フォーカスの配置です。ダイアログフォーカス手順 は、ダイアログが表示されたときに初期フォーカスに適した候補を選択しようとしますが、特定のダイアログに対するユーザーの期待に一致する正しい選択を慎重に検討する著者に代わるものではないかもしれません。そのため、著者は、ダイアログが開かれた後にユーザーが直ちに対話することを期待されるダイアログの子孫要素にautofocus 属性を使用する必要があります。そのような要素がない場合、著者はdialog 要素自体にautofocus 属性を使用する必要があります。

次の例では、在庫管理ウェブアプリケーションで製品の詳細を編集するためにダイアログが使用されています。

<dialog>
  <label>製品番号 <input type="text" readonly></label>
  <label>製品名 <input type="text" autofocus></label>
</dialog>

autofocus属性が存在しない場合、製品番号フィールドはダイアログフォーカスステップによってフォーカスされます。これは妥当な動作ですが、作成者は、製品番号フィールドは読み取り専用でユーザー入力を期待しないため、フォーカスするのにより適切なフィールドは製品名フィールドであると判断しました。そのため、作成者はautofocusを使用してデフォルトを上書きしました。

作成者がデフォルトで製品番号フィールドにフォーカスしたい場合でも、そのinput要素でautofocusを使用して明示的に指定するのが最善です。これにより、コードの将来の読者にとって意図が明確になり、将来の更新に直面してもコードの堅牢性が維持されます。（たとえば、別の開発者が閉じるボタンを追加し、それを製品番号フィールドの前にノードツリーに配置した場合など）。

ユーザーの行動に関するもう1つの重要な側面は、ダイアログがスクロール可能かどうかです。場合によっては、オーバーフロー（およびそれによるスクロールの発生）は避けられません。たとえば、ユーザーのテキストズーム設定が高い場合などです。しかし、一般的に、ユーザーはスクロール可能なダイアログを期待していません。ダイアログ要素自体がオーバーフローを引き起こす可能性が高いため、ダイアログ要素に大きなテキストノードを直接追加することは特に悪いとされています。著者はそれらを避けるのが最善です。

以下の利用規約ダイアログは、上記の提案に従っています。

<dialog style="height: 80vh;">
   <div style="overflow: auto; height: 60vh;" autofocus>
     <p>By placing an order via this Web site on the first day of the fourth month of the year
     2010 Anno Domini, you agree to grant Us a non-transferable option to claim, for now and for
     ever more, your immortal soul.</p>
     <p>Should We wish to exercise this option, you agree to surrender your immortal soul,
     and any claim you may have on it, within 5 (five) working days of receiving written
     notification from  this site or one of its duly authorized minions.</p>
     <!-- ... etc., with many more <p> elements ... -->
   </div>
   <form method="dialog">
     <button type="submit" value="agree">Agree</button>
     <button type="submit" value="disagree">Disagree</button>
   </form>
 </dialog>

ダイアログフォーカス手順 がデフォルトでスクロール可能な div 要素を選択したかどうかに注意してください。しかし、前の例と同様に、div に autofocus を追加して、将来の変更に対しても明確かつ堅牢であるようにしました。

対照的に、利用規約を表現する p 要素にそのようなラッパー div 要素がない場合、dialog 自体がスクロール可能になり、上記のアドバイスに反することになります。さらに、autofocus 属性がない場合、そのようなマークアップパターンは上記のアドバイスに違反し、デフォルトの動作である ダイアログフォーカス手順 を妨げ、Agree button にフォーカスがジャンプし、悪いユーザー体験を引き起こす可能性があります。

このダイアログボックスには、いくつかの小さな注意書きがあります。strong要素は、より重要な部分にユーザーの注意を引くために使用されます。 

<dialog>
 <h1>ウォレットに追加</h1>
 <p><strong><label for=amt>ウォレットにいくつの金貨を追加しますか？</label></strong></p>
 <p><input id=amt name=amt type=number min=0 step=0.01 value=100></p>
 <p><small>コインの追加は自己責任でお願いします。</small></p>
 <p><label><input name=round type=checkbox> 完全に丸いコインのみを追加する</label></p>
 <p><input type=button onclick="submit()" value="Add Coins"></p>
</dialog>

open属性はブール属性です。指定された場合、dialog要素がアクティブであり、ユーザーがそれと対話できることを示します。

closedbyコンテンツ属性は、次のキーワードと状態を持つ列挙属性です。

キーワード 状態 簡単な説明
any 任意 クローズ要求または外部のクリックでダイアログを閉じます。
closerequest クローズ要求 クローズ要求でダイアログを閉じます。
none なし ユーザー操作ではダイアログを自動的に閉じません。

closedby属性の無効な値のデフォルトと欠損値のデフォルトは、どちらも自動状態です。

dialogがそのshowModal()メソッドを使用して表示された場合、自動状態はクローズ要求状態として動作します。それ以外の場合はなし状態です。

open属性が指定されていないdialog要素は、ユーザーに表示されるべきではありません。この要件は、スタイルレイヤーを介して間接的に実装される場合があります。たとえば、提案されたデフォルトレンダリングをサポートするユーザーエージェントは、レンダリングセクションで説明されているCSSルールを使用してこの要件を実装します。

open 属性を削除すると、通常はダイアログが非表示になります。ただし、それを行うと、いくつかの奇妙な追加の結果が発生します:

これらの理由から、通常はopen属性を手動で削除しない方が良いです。代わりに、ダイアログを閉じるにはrequestClose()またはclose()メソッドを使用するか、非表示にするにはhidden属性を使用します。

tabindex 属性は、dialog 要素に指定してはなりません。

dialog.show()

HTMLDialogElement/show

すべての現在のエンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

dialog 要素を表示します。

dialog.showModal()

HTMLDialogElement/showModal

すべての現在のエンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

dialog 要素を表示し、最上位のモーダルダイアログとして設定します。

このメソッドは、autofocus 属性を尊重します。

dialog.close([ result ])

HTMLDialogElement/close

すべての現在のエンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

dialog要素を閉じます。

引数が指定された場合、戻り値を提供します。

dialog.requestClose([ result ])

まずcancelイベントを発火させ、そのイベントがpreventDefault()でキャンセルされなかった場合、close()メソッドと同じ方法で（closeイベントの発火を含む）dialogを閉じることで、dialogをターゲットとするクローズ要求が送信されたかのように動作します。

これは、すべての非クローズ要求のクローズアフォーダンスにこのメソッドを呼び出させることにより、キャンセルおよびクローズロジックをcancelおよびcloseイベントハンドラーに統合するために使用できるヘルパーユーティリティです。

このメソッドはclosedby属性を無視することに注意してください。つまり、closedbyが「none」に設定されていても、同じ動作が適用されます。

引数が指定された場合、戻り値を提供します。

dialog.returnValue [ = result ]

HTMLDialogElement/returnValue

すべての現在のエンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

dialog の戻り値を返します。

セットすることができ、戻り値を更新します。

show() メソッドの手順は以下の通りです:

  1. thisにopen属性があり、thisのモーダルであるがfalseの場合、戻ります。

  2. thisにopen属性がある場合、"InvalidStateError" DOMExceptionをスローします。

  3. cancelable属性をtrueに、oldState属性を「closed」に、newState属性を「open」に初期化して、thisでToggleEventを使用してbeforetoggleという名前のイベントを発火させた結果がfalseの場合、戻ります。

  4. thisにopen属性がある場合、戻ります。

  5. this、「closed」、および「open」を指定して、ダイアログ切り替えイベントタスクをキューに入れます。

  6. 値が空文字列であるopen属性をthisに追加します。

  7. 表明：thisのノードドキュメントのオープンダイアログリストは、thisを含みません。

  8. thisをthisのノードドキュメントのオープンダイアログリストに追加します。

  9. thisを指定して、ダイアログクローズウォッチャーを設定します。

  10. thisの以前にフォーカスされた要素をフォーカスされた要素に設定します。

  11. documentをthisのノードドキュメントとします。

  12. hideUntilを、this、documentの表示中のヒントポップオーバーリスト、null、およびfalseを指定して最上位のポップオーバー祖先を実行した結果とします。

  13. hideUntilがnullの場合、hideUntilをthis、documentの表示中の自動ポップオーバーリスト、null、およびfalseを指定して最上位のポップオーバー祖先を実行した結果に設定します。

  14. hideUntilがnullの場合、hideUntilをdocumentに設定します。

  15. hideUntil、false、およびtrueを指定して、指定された要素まですべてのポップオーバーを非表示にするを実行します。

  16. thisを指定して、ダイアログフォーカスステップを実行します。

showModal()メソッドのステップは、this を指定してモーダルダイアログを表示することです。

close(returnValue)メソッドのステップは次のとおりです。

  1. returnValueが指定されていない場合は、nullに設定します。

  2. returnValueを指定して、thisのダイアログを閉じます。

requestClose(returnValue)メソッドのステップは次のとおりです。

  1. returnValue が指定されていない場合は、null に設定します。

  2. returnValue を使用して、これのダイアログを閉じるよう要求します。

dialog要素には、show/hideやopen/closeのような一般的に反意語と考えられる動詞のペアではなく、show/closeを動詞として使用します。これは、次の制約によるものです。

さらに、dialog要素の元の設計と同時代の他の多くのUIフレームワークの調査により、show/closeの動詞のペアがかなり一般的であることが明らかになりました。

要約すると、特定の動詞の意味合いと、それらがテクノロジーの文脈でどのように使用されるかによって、ダイアログの表示と終了などのペアのアクションが常に反意語として表現できるわけではないことがわかります。

returnValue IDL属性は、取得時には最後に設定された値を返さなければなりません。設定時には、新しい値に設定されなければなりません。要素が作成されるとき、空の文字列に設定されなければなりません。

closedByゲッターのステップは、thisを指定して計算されたclosed-by状態に対応するキーワードを返すことです。

closedByセッターのステップは、closedbyコンテンツ属性を指定された値に設定することです。

HTMLDialogElement/open

すべての現行エンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

open IDL属性は、openコンテンツ属性を反映しなければなりません。

各Documentには、ダイアログポインターダウンターゲットがあり、これはHTMLダイアログ要素またはnullであり、初期値はnullです。

各HTML要素には、nullまたは要素である以前にフォーカスされた要素があり、初期値はnullです。showModal()およびshow()が呼び出されると、ダイアログフォーカスステップを実行する前に、この要素は現在フォーカスされている要素に設定されます。popover属性を持つ要素は、ポップオーバー表示アルゴリズム中にこの要素を現在フォーカスされている要素に設定します。

各dialog要素には、ダイアログ切り替えタスクトラッカーがあり、これは切り替えタスクトラッカーまたはnullであり、初期値はnullです。

各dialog要素には、クローズウォッチャーがあり、これはクローズウォッチャーまたはnullであり、初期値はnullです。

各dialog要素には、文字列であるクローズ要求の戻り値があり、初期値はnullです。

各 dialog 要素には、リクエストクローズのためのクローズウォッチャーを有効にするブール値があり、初期値は false です。

dialog の リクエストクローズのためのクローズウォッチャーを有効にするは、それを閉じるよう要求している間、ダイアログの クローズウォッチャーを強制的に有効にするために使用されます。計算された closed-by 状態が None 状態であるダイアログは、そうでなければ無効化された クローズウォッチャーを持つことになります。

各 dialog 要素には、モーダルであるブール値があり、初期値は false です。

removedNodeとoldParentを指定した、dialog HTML要素削除ステップは次のとおりです。

  1. removedNodeのクローズウォッチャーがnullでない場合：

    1. removedNodeのクローズウォッチャーを破棄します。

    2. removedNodeのクローズウォッチャーをnullに設定します。

  2. removedNodeのノードドキュメントのトップレイヤーがremovedNodeを含む場合、removedNodeを指定してトップレイヤーから要素を直ちに削除します。

  3. removedNodeのモーダルであるをfalseに設定します。

  4. removedNodeをremovedNodeのノードドキュメントのオープンダイアログリストから削除します。

dialog要素subjectを指定してモーダルダイアログを表示するには：

  1. subjectにopen属性があり、subjectのモーダルであるがtrueの場合、戻ります。

  2. subjectにopen属性がある場合、"InvalidStateError" DOMExceptionをスローします。

  3. subjectのノードドキュメントが完全にアクティブでない場合、"InvalidStateError" DOMExceptionをスローします。

  4. subjectが接続されていない場合、"InvalidStateError" DOMExceptionをスローします。

  5. subjectがポップオーバー表示状態である場合、"InvalidStateError" DOMExceptionをスローします。

  6. cancelable属性をtrueに、oldState属性を「closed」に、newState属性を「open」に初期化して、subjectでToggleEventを使用してbeforetoggleという名前のイベントを発火させた結果がfalseの場合、戻ります。

  7. subjectにopen属性がある場合、戻ります。

  8. subjectが接続されていない場合、戻ります。

  9. subjectがポップオーバー表示状態である場合、戻ります。

  10. subject、「closed」、および「open」を指定して、ダイアログ切り替えイベントタスクをキューに入れます。

  11. 値が空文字列であるopen属性をsubjectに追加します。

  12. subjectのモーダルであるをtrueに設定します。

  13. 表明：subjectのノードドキュメントのオープンダイアログリストは、subjectを含みません。

  14. subjectをsubjectのノードドキュメントのオープンダイアログリストに追加します。

  15. subjectのノードドキュメントを、モーダルダイアログsubjectによってブロックされるようにします。

    これにより、ドキュメントのフォーカスされた領域が不活性になります（現在フォーカスされている領域がsubjectのシャドウ包含子孫でない限り）。そのような場合、ドキュメントのフォーカスされた領域はまもなくリセットされてビューポートになります。いくつかのステップで、フォーカスするより良い候補を見つけようとします。

  16. subjectのノードドキュメントのトップレイヤーがまだsubjectを含まない場合、subjectを指定してトップレイヤーに要素を追加します。

  17. subjectを指定して、ダイアログクローズウォッチャーを設定します。

  18. subjectの以前にフォーカスされた要素をフォーカスされた要素に設定します。

  19. documentをsubjectのノードドキュメントとします。

  20. hideUntilを、subject、documentの表示中のヒントポップオーバーリスト、null、およびfalseを指定して最上位のポップオーバー祖先を実行した結果とします。

  21. hideUntilがnullの場合、hideUntilをsubject、documentの表示中の自動ポップオーバーリスト、null、およびfalseを指定して最上位のポップオーバー祖先を実行した結果に設定します。

  22. hideUntilがnullの場合、hideUntilをdocumentに設定します。

  23. hideUntil、false、およびtrueを指定して、指定された要素まですべてのポップオーバーを非表示にするを実行します。

  24. subjectを指定して、ダイアログフォーカスステップを実行します。

dialog要素dialogを指定してダイアログクローズウォッチャーを設定するには：

  1. dialogのクローズウォッチャーを、dialogの関連するグローバルオブジェクトを指定してクローズウォッチャーを確立した結果に設定します。その際、次のようにします。

dialog 要素の有効なインボーカーコマンドステップは、command 属性 command を指定すると次のようになります。

  1. command が Close 状態、Request Close 状態、または Show Modal 状態の場合、true を返します。

  2. false を返します。

dialog 要素のインボーカーコマンドステップは、要素 element、要素 invoker、および command 属性 command を指定すると次のようになります。

  1. element が popover 表示状態の場合、戻ります。

  2. command が Close 状態であり、element に open 属性がある場合、invoker のオプションの値を使用して element のダイアログを閉じます。

  3. command が Request Close 状態であり、element に open 属性がある場合、invoker のオプションの値を使用して element のダイアログを閉じるよう要求します。

  4. command が Show Modal 状態であり、element に open 属性がない場合、element を指定してモーダルダイアログを表示します。

次のボタンは、アクティブ化されたときに「確認」dialogをモーダルとして開閉するためにcommandforを使用します。 

<button type=button
        commandfor="the-dialog"
        command="show-modal">
 削除
</button>
<dialog id="the-dialog">
 <form action="/delete" method="POST">
  <button type="submit">
   削除
  </button>
  <button commandfor="the-dialog"
          command="close">
   キャンセル
  </button>
 </form>
</dialog>

ダイアログ 要素 subject を 閉じる 必要がある場合、null または文字列 result と共に次の手順を実行します:

  1. subjectにopen属性がない場合、戻ります。

  2. oldState属性を「open」に、newState属性を「closed」に初期化して、subjectでToggleEventを使用してbeforetoggleという名前のイベントを発火させます。

  3. subjectにopen属性がない場合、戻ります。

  4. subject、「open」、および「closed」を指定して、ダイアログ切り替えイベントタスクをキューに入れます。

  5. subjectのopen属性を削除します。

  6. subjectのモーダルであるがtrueの場合、subjectを指定してトップレイヤーから要素を削除するよう要求します。

  7. wasModalをsubjectのモーダルであるフラグの値とします。

  8. subjectのモーダルであるをfalseに設定します。

  9. subjectをsubjectのノードドキュメントのオープンダイアログリストから削除します。

  10. resultがnullでない場合、returnValue属性をresultに設定します。

  11. リクエストクローズ戻り値をnullに設定します。

  12. subjectの以前にフォーカスされた要素がnullでない場合：

    1. elementをsubjectの以前にフォーカスされた要素とします。

    2. subjectの以前にフォーカスされた要素をnullに設定します。

    3. subjectのノードドキュメントのドキュメントのフォーカスされた領域のDOMアンカーがsubjectのシャドウ包含包括子孫であるか、またはwasModalがtrueである場合、elementのフォーカスステップを実行します。このステップを実行してもビューポートはスクロールされるべきではありません。

  13. subject要素を指定して、ユーザーインタラクションタスクソースで要素タスクをキューに入れます。これにより、subjectでcloseという名前のイベントが発火します。

  14. subjectのクローズウォッチャーがnullでない場合：

    1. subjectのクローズウォッチャーを破棄します。

    2. subjectのクローズウォッチャーをnullに設定します。

dialog 要素 subject を、null または文字列 returnValue を指定して閉じるよう要求するには：

  1. subject に open 属性がない場合は、戻ります。

  2. アサート：subject の クローズウォッチャーは null ではありません。

  3. subject の リクエストクローズのためのクローズウォッチャーを有効にするを true に設定します。

  4. subject の リクエストクローズの戻り値を returnValue に設定します。

  5. subject の クローズウォッチャーを false で閉じるよう要求します。

  6. subject の リクエストクローズのためのクローズウォッチャーを有効にするを false に設定します。

dialog 要素 element、文字列 oldState、および文字列 newState を指定して、ダイアログ切り替えイベントタスクをキューに入れるには：

  1. element の ダイアログ切り替えタスクトラッカーが null でない場合：

    1. oldState を element の ダイアログ切り替えタスクトラッカーの 古い状態に設定します。

    2. element の ダイアログ切り替えタスクトラッカーの タスクをその タスクキューから削除します。

    3. element の ダイアログ切り替えタスクトラッカーを null に設定します。

  2. DOM 操作タスクソースと element を指定して、次のステップを実行するために要素タスクをキューに入れます：

    1. oldState 属性を oldState に初期化し、newState 属性を newState に初期化して、ToggleEvent を使用して、element で toggle という名前のイベントを発火させます。

    2. element の ダイアログ切り替えタスクトラッカーを null に設定します。

  3. element の ダイアログ切り替えタスクトラッカーを、タスクをキューに入れられたばかりの タスクに設定し、古い状態を oldState に設定した構造体に設定します。

dialog dialog を指定して、ダイアログの 計算された closed-by 状態を取得するには：

  1. dialog の closedby 属性の状態が Auto の場合：

    1. dialog の is modal が true の場合、Close Request を返します。

    2. None を返します。

  2. dialog の closedby 属性の状態を返します。

dialog 要素 subject を指定した ダイアログフォーカスステップは次のとおりです：

  1. subject の ノードドキュメントを指定した フォーカス許可ステップが false を返す場合、戻ります。

  2. control を null にします。

  3. subject に autofocus 属性がある場合、control を subject に設定します。

  4. control が null の場合、control を subject の フォーカスデリゲートに設定します。

  5. control が null の場合、control を subject に設定します。

  6. control の フォーカスステップを実行します。

    control が フォーカス可能でない場合、これは何も行いません。これは、subject にフォーカスデリゲートがなく、ユーザーエージェントが dialog 要素が一般的にフォーカス可能ではないと判断した場合にのみ発生します。その場合、ドキュメントのフォーカスされた領域への以前の変更が適用されます。

  7. topDocument を control の ノードナビゲーション可能の トップレベルトラバーサブルの アクティブドキュメントにします。

  8. control の ノードドキュメントの オリジンが topDocument の オリジンと同じでない場合、戻ります。

  9. topDocument の オートフォーカス候補を空にします。

  10. topDocument の オートフォーカス処理済みフラグを true に設定します。

4.11.5 ダイアログのライトディスミス

「ライトディスミス」とは、closedby 属性が Any 状態である dialog 要素の外側をクリックすると、dialog 要素が閉じることを意味します。これは、そのような dialog が クローズ要求に応答する方法に加えて行われます。

PointerEvent event を指定して、開いているダイアログをライトディスミスするには：

  1. 表明：event の isTrusted 属性は true です。

  2. document を event の ターゲットの ノードドキュメントにします。

  3. document の 開いているダイアログリストが 空の場合、戻ります。

  4. ancestor を event を指定して 最も近いクリックされたダイアログを実行した結果にします。

  5. event の type が「pointerdown」の場合、document の ダイアログポインターダウンターゲットを ancestor に設定します。

  6. event の type が「pointerup」の場合：

    1. ancestor が document の ダイアログポインターダウンターゲットである場合、sameTarget を true にします。

    2. document の ダイアログポインターダウンターゲットを null に設定します。

    3. sameTarget が false の場合、戻ります。

    4. topmostDialog を document の 開いているダイアログリストの最後の要素にします。

    5. ancestor が topmostDialog の場合、戻ります。

    6. topmostDialog の 計算された closed-by 状態が Any でない場合、戻ります。

    7. 表明：topmostDialog の クローズウォッチャーは null ではありません。

    8. false を指定して、topmostDialog の クローズウォッチャーにクローズを要求します。

PointerEvent event を指定して、ライトディスミスアクティビティを実行するには：

  1. event を指定して 開いているポップオーバーをライトディスミスするを実行します。

  2. event を指定して 開いているダイアログをライトディスミスするを実行します。

ユーザーがページ上の任意の場所をクリックまたはタッチすると、Pointer Events 仕様によってライトディスミスアクティビティを実行するが呼び出されます。

PointerEvent event を指定して、最も近いクリックされたダイアログを見つけるには：

  1. target を event の ターゲットにします。

  2. target が dialog 要素であり、target に open 属性があり、target の is modal が true であり、event の clientX と clientY が target の境界の外側にある場合、null を返します。

    clientX と clientY のチェックは、ダイアログの ::backdrop 疑似要素にヒットしたポインターイベントが、event のターゲットをダイアログ要素自体にすることになるためです。

  3. currentNode を target にします。

  4. currentNode が null でない間：

    1. currentNode が dialog 要素であり、currentNode に open 属性がある場合、currentNode を返します。

    2. currentNode を フラットツリー内の currentNode の親に設定します。

  5. null を返します。

4.12 スクリプティング

スクリプトは、著者がドキュメントにインタラクティブ性を追加できるようにします。

可能な限り宣言型の代替手段を使用することが推奨されます。宣言型のメカニズムは、多くの場合、保守が容易であり、多くのユーザーがスクリプトを無効にしているためです。

たとえば、詳細を表示するためにセクションを表示または非表示にするスクリプトを使用する代わりに、details要素を使用することができます。

また、スクリプトのサポートがない場合でもアプリケーションが正常に機能するようにすることも推奨されます。

たとえば、著者がテーブルヘッダーにリンクを提供して動的にテーブルを並べ替える場合、そのリンクは、サーバーからソートされたテーブルを要求することで、スクリプトなしでも機能するようにすることができます。

4.12.1 script 要素

要素/script

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer対応
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLScriptElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
カテゴリ:
メタデータコンテンツ。
フローコンテンツ。
フレージングコンテンツ。
スクリプトサポート要素。
この要素を使用できるコンテキスト:
メタデータコンテンツが期待される場所。
フレージングコンテンツが期待される場所。
スクリプトサポート要素が期待される場所。
コンテンツモデル:
src属性がない場合、type属性の値に依存しますが、スクリプトコンテンツの制限に一致する必要があります。
もしsrc属性がある場合、要素は空であるか、スクリプトコンテンツの制限にも一致する外部スクリプトのインラインドキュメントのみを含む必要があります。
text/htmlでのタグ省略:
どちらのタグも省略できません。
コンテンツ属性:
グローバル属性
type — スクリプトの種類
src — リソースのアドレス
nomodule — モジュールスクリプトをサポートするユーザーエージェントでの実行を防止します
async — フェッチ中にブロックせずに、利用可能になったときにスクリプトを実行します
defer — スクリプトの実行を遅延させます
blocking — 要素が潜在的にレンダリングをブロックするかどうか
crossorigin — 要素がクロスオリジンリクエストを処理する方法
referrerpolicy — 要素によって開始されたフェッチのリファラーポリシー
integrity — サブリソースの整合性チェックで使用される整合性メタデータ [SRI]
fetchpriority — 要素によって開始されたフェッチの優先度を設定します
アクセシビリティに関する考慮事項:
作成者向け。
実装者向け。
DOMインターフェース: 
[Exposed=Window]
interface HTMLScriptElement : HTMLElement {
    [HTMLConstructor] constructor();

    [CEReactions] attribute DOMString type;
    [CEReactions] attribute USVString src;
    [CEReactions] attribute boolean noModule;
    [CEReactions] attribute boolean async;
    [CEReactions] attribute boolean defer;
    [SameObject, PutForwards=value] readonly attribute DOMTokenList blocking;
    [CEReactions] attribute DOMString? crossOrigin;
    [CEReactions] attribute DOMString referrerPolicy;
    [CEReactions] attribute DOMString integrity;
    [CEReactions] attribute DOMString fetchPriority;

    [CEReactions] attribute DOMString text;

    static boolean supports(DOMString type);

    // 廃止されたメンバーも持ちます
};

script要素を使用すると、作成者は動的スクリプト、ユーザーエージェントへの指示、およびデータブロックをドキュメントに含めることができます。この要素は、ユーザー向けのコンテンツを表すものではありません。

要素/script#attr-type

すべての現在のエンジンでサポートされています。

Firefox1+ Safari≤4+ Chrome1+
Opera? Edge79+
Edge (レガシー)12+ Internet Explorerはい
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

script要素には2つのコア属性があります。type属性は、表現されるスクリプトの種類をカスタマイズできます：

2番目のコア属性はsrc属性です。これはクラシックスクリプトとJavaScriptモジュールスクリプトに対してのみ指定する必要があり、要素の子テキストコンテンツをスクリプトコンテンツとして使用する代わりに、指定されたURLからスクリプトがフェッチされることを示します。srcが指定されている場合、それはスペースで囲まれる可能性のある有効な空でないURLでなければなりません。

特定のscript要素にどの他の属性を指定できるかは、次の表によって決定されます：

nomodule async defer blocking crossorigin referrerpolicy integrity fetchpriority
外部クラシックスクリプト はい はい はい はい はい はい はい はい
インラインクラシックスクリプト はい · · · はい* はい* · ·†
外部モジュールスクリプト · はい · はい はい はい はい はい
インラインモジュールスクリプト · はい · · はい* はい* · ·†
インポートマップ · · · · · · · ·
データブロック · · · · · · · ·

* インラインスクリプトには初期フェッチはありませんが、インラインスクリプトのcrossoriginおよびreferrerpolicy属性は、動的import()を含むモジュールインポートで使用される資格情報モードおよびリファラーポリシーに影響します。

† crossoriginおよびreferrerpolicyとは異なり、fetchpriorityはモジュールインポートに影響しません。イシュー #10276での議論を参照してください。

インラインのscript要素または外部スクリプトリソースの内容は、クラシックスクリプトおよびJavaScript モジュールスクリプトそれぞれに対して、JavaScript 仕様のスクリプトまたはモジュール生成の要件に従う必要があります。[JAVASCRIPT]

インポートマップのインラインscript要素の内容は、インポートマップ作成要件に従う必要があります。

データブロックを含めるために使用する場合、データはインラインで埋め込む必要があり、データの形式はtype属性を使用して指定する必要があり、script要素の内容は、使用される形式に対して定義された要件に準拠する必要があります。

nomodule属性は、モジュールスクリプトをサポートするユーザーエージェントでスクリプトが実行されるのを防ぐブール属性です。これにより、最新のユーザーエージェントではモジュールスクリプトを選択的に実行し、古いユーザーエージェントではクラシックスクリプトを選択的に実行できます。以下に示すように。

要素/script#attr-async

すべての現在のエンジンでサポートされています。

Firefox1+ Safari≤4+ Chrome1+
Opera? Edge79+
Edge (レガシー)12+ Internet Explorerはい
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

要素/script#attr-defer

すべての現在のエンジンでサポートされています。

Firefox3.5+ Safari3+ Chrome1+
Opera? Edge79+
Edge (レガシー)12+ Internet Explorer10+
Firefox Android4+ Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

async属性とdefer属性は、スクリプトをどのように評価すべきかを示すブール属性です。スクリプトの種類に応じて、これらの属性を使用して選択できるいくつかの可能なモードがあります。

外部クラシックスクリプトの場合、async属性が存在する場合、クラシックスクリプトは解析と並行してフェッチされ、利用可能になり次第（解析が完了する前に）評価されます。async属性が存在せず、defer属性が存在する場合、クラシックスクリプトは並行してフェッチされ、ページの解析が終了したときに評価されます。どちらの属性も存在しない場合、スクリプトはすぐにフェッチされて評価され、これらが両方完了するまで解析をブロックします。

モジュールスクリプトの場合、async属性が存在する場合、モジュールスクリプトとそのすべての依存関係は解析と並行してフェッチされ、モジュールスクリプトは利用可能になり次第（解析が完了する前に）評価されます。それ以外の場合、モジュールスクリプトとその依存関係は解析と並行してフェッチされ、ページの解析が終了したときに評価されます。（defer属性はモジュールスクリプトには影響しません。）

これはすべて、次の概略図にまとめられています：

With <script>, parsing is interrupted by fetching and execution. With <script defer>, fetching is parallel to parsing and execution takes place after all parsing has finished. And with <script async>, fetching is parallel to parsing but once it finishes parsing is interrupted to execute the script. The story for <script type="module"> is similar to <script defer>, but the dependencies will be fetched as well, and the story for <script type="module" async> is similar to <script async> with the extra dependency fetching.

これらの属性の正確な処理詳細は、主に歴史的な理由から、HTMLの多くの側面を含むため、やや複雑です。したがって、実装要件は必然的に仕様全体に分散しています。以下のアルゴリズムは、この処理の中核を説明していますが、これらのアルゴリズムは、HTMLのscript 開始タグと終了タグ、外部コンテンツ内、およびXML内の解析ルール、document.write()メソッドのルール、スクリプティングの処理などを参照し、またそれらから参照されます。

document.write()メソッドを使用して挿入された場合、script要素は通常実行されます（通常、さらなるスクリプト実行またはHTML解析をブロックします）。innerHTMLおよびouterHTML属性を使用して挿入された場合、それらはまったく実行されません。

defer属性は、async属性が指定されている場合でも指定でき、deferのみをサポートし（asyncはサポートしない）レガシーWebブラウザーが、デフォルトであるブロッキング動作の代わりにdefer動作にフォールバックするようにします。

blocking属性は、ブロッキング属性です。

crossorigin属性は、CORS設定属性です。外部クラシックスクリプトの場合、スクリプトが他のオリジンから取得されたときにエラー情報が公開されるかどうかを制御します。外部モジュールスクリプトの場合、クロスオリジンの場合、モジュールソースの初期フェッチに使用される資格情報モードを制御します。クラシックスクリプトとモジュールスクリプトの両方で、クロスオリジンモジュールインポートに使用される資格情報モードを制御します。

クラシックスクリプトとは異なり、モジュールスクリプトは、クロスオリジンフェッチにCORSプロトコルの使用を必要とします。

referrerpolicy属性は、リファラーポリシー属性です。外部スクリプトの初期フェッチ、およびインポートされたモジュールスクリプトのフェッチに使用されるリファラーポリシーを設定します。 [REFERRERPOLICY]

インポートされたスクリプトをフェッチする際に使用される、script要素のreferrerポリシーの例ですが、他のサブリソースには適用されません: 

<script referrerpolicy="origin">
   fetch('/api/data');    // <script>のreferrerポリシーでフェッチされていません
   import('./utils.mjs'); // <script>のreferrerポリシー("origin"の場合)でフェッチされます
 </script>

integrity属性は、外部スクリプトの初期フェッチに使用される整合性メタデータを設定します。値は、整合性属性の要件に一致する必要があります。[SRI]

fetchpriority属性は、フェッチ優先度属性です。外部スクリプトの初期フェッチに使用される優先度を設定します。

これらの属性を動的に変更しても直接的な効果はありません。これらの属性は、処理モデルで説明されている特定の時間にのみ使用されます。

IDL属性src、type、defer、integrity、およびblockingは、それぞれ同じ名前の対応するコンテンツ属性を反映する必要があります。

noModuleIDL属性は、nomoduleコンテンツ属性を反映する必要があります。

crossOriginIDL属性は、crossoriginコンテンツ属性を反映する必要があります。既知の値のみに限定されます。

HTMLScriptElement/referrerPolicy

すべての現在のエンジンでサポートされています。

Firefox65+ Safari14+ Chrome70+
Opera? Edge79+
Edge (レガシー)? Internet Explorerいいえ
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

referrerPolicy IDL属性は、referrerpolicyコンテンツ属性を反映する必要があります。既知の値のみに限定されます。

fetchPriority IDL属性は、fetchpriorityコンテンツ属性を反映する必要があります。既知の値のみに限定されます。

asyncゲッターのステップは次のとおりです：

  1. thisの強制非同期がtrueの場合、trueを返します。

  2. thisのasyncコンテンツ属性が存在する場合、trueを返します。

  3. falseを返します。

asyncセッターのステップは次のとおりです：

  1. thisの強制非同期をfalseに設定します。

  2. 指定された値がtrueの場合、thisのasyncコンテンツ属性を空の文字列に設定します。

  3. それ以外の場合は、thisのasyncコンテンツ属性を削除します。

script.text [ = value ]

要素の子テキストコンテンツを返します。

script.text = value

要素の子をvalueで与えられたテキストに置き換えます。

HTMLScriptElement.supports(type)

指定されたtypeがユーザーエージェントによってサポートされているスクリプトタイプである場合にtrueを返します。この仕様で可能なスクリプトタイプは「classic」、「module」、および「importmap」ですが、将来他のものが追加される可能性があります。

textゲッターのステップは、thisの子テキストコンテンツを返すことです。

textセッターのステップは、this内で指定された値を使用してすべて文字列置換することです。

HTMLScriptElement/supports_static

すべての現在のエンジンでサポートされています。

Firefox94+Safari16+Chrome96+
Opera?Edge96+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

静的なsupports(type)メソッドのステップは次のとおりです：

  1. もしtypeが"classic" であるなら、trueを返します。

  2. もしtypeが"module" であるなら、trueを返します。

  3. もしtypeが"importmap" であるなら、trueを返します。

  4. falseを返します。

type引数はこれらの値に完全に一致する必要があります。ASCII 大文字と小文字を区別しない一致は行いません。これはtypeコンテンツ属性の値が処理される方法や、 DOMTokenListの supports() メソッドの動作とは異なりますが、WorkerType 列挙型がWorker()コンストラクターで使用される方法と一致します。

この例では、2つのscript要素が使用されています。1つは外部のクラシックスクリプトを埋め込み、もう1つはデータブロックとしていくつかのデータを含みます。 

<script src="game-engine.js"></script>
 <script type="text/x-game-map">
 ........U.........e
 o............A....e
 .....A.....AAA....e
 .A..AAA...AAAAA...e
 </script>

この場合、データはスクリプトによってビデオゲームのマップを生成するために使用される可能性があります。ただし、データはそのように使用される必要はありません。マップデータがページの他の部分に埋め込まれており、ここでのデータブロックは、サイトの検索エンジンがゲームマップ内の特定の機能を探しているユーザーを支援するために使用されるだけかもしれません。

次のサンプルは、script要素を使用して、クラシックスクリプトの一部としてドキュメントの他の部分で使用される関数を定義する方法を示しています。また、script要素を使用して、ドキュメントの解析中にスクリプトを呼び出す方法も示しています。この場合、フォームの出力を初期化します。 

<script>
  function calculate(form) {
    var price = 52000;
    if (form.elements.brakes.checked)
      price += 1000;
    if (form.elements.radio.checked)
      price += 2500;
    if (form.elements.turbo.checked)
      price += 5000;
    if (form.elements.sticker.checked)
      price += 250;
    form.elements.result.value = price;
  }
 </script>
 <form name="pricecalc" onsubmit="return false" onchange="calculate(this)">
  <fieldset>
   <legend>車の価格を計算する</legend>
   <p>基本費用: £52000.</p>
   <p>追加オプションを選択:</p>
   <ul>
    <li><label><input type=checkbox name=brakes> セラミックブレーキ (£1000)</label></li>
    <li><label><input type=checkbox name=radio> 衛星ラジオ (£2500)</label></li>
    <li><label><input type=checkbox name=turbo> ターボチャージャー (£5000)</label></li>
    <li><label><input type=checkbox name=sticker> "XZ" ステッカー (£250)</label></li>
   </ul>
   <p>合計: £<output name=result></output></p>
  </fieldset>
  <script>
   calculate(document.forms.pricecalc);
  </script>
 </form>

次のサンプルは、script要素を使用して、外部のJavaScriptモジュールスクリプトを含める方法を示しています。

<script type="module" src="app.mjs"></script>

このモジュールおよびその依存関係（ソースファイル内のJavaScriptimport文を通じて表現されるもの）はすべてフェッチされます。結果として得られるモジュールグラフがすべてインポートされ、ドキュメントの解析が終了すると、app.mjsの内容が評価されます。

さらに、同じWindow内の別のscript要素のコードがapp.mjsからモジュールをインポートする場合（例：import "./app.mjs";経由）、その場合、前者script要素によって作成された同じJavaScriptモジュールスクリプトがインポートされます。

この例は、モダンなユーザーエージェント向けにJavaScriptモジュールスクリプトを、古いユーザーエージェント向けにクラシックスクリプトを含める方法を示しています。

<script type="module" src="app.mjs"></script>
 <script nomodule defer src="classic-app-bundle.js"></script>

JavaScriptモジュールスクリプトをサポートする最新のユーザーエージェントでは、nomodule属性を持つscript要素は無視され、typeが「module」のscript要素がフェッチされて評価されます（JavaScriptモジュールスクリプトとして）。逆に、古いユーザーエージェントは、typeが「module」のscript要素を無視します。これは、それらにとって未知のスクリプトタイプであるためです — しかし、nomodule属性を実装していないため、他のscript要素をフェッチして評価するのに問題はありません（クラシックスクリプトとして）。

次のサンプルは、script要素を使用して、ドキュメントのテキストにいくつかの置換を行い、より興味深い読書体験を提供するためのインラインJavaScriptモジュールスクリプトを書く方法を示しています（例：ニュースサイトでの使用）：[XKCD1288]

<script type="module">
  import { walkAllTextNodeDescendants } from "./dom-utils.mjs";
 
  const substitutions = new Map([
    ["witnesses", "these dudes I know"]
    ["allegedly", "kinda probably"]
    ["new study", "Tumblr post"]
    ["rebuild", "avenge"]
    ["space", "spaaace"]
    ["Google glass", "Virtual Boy"]
    ["smartphone", "Pokédex"]
    ["electric", "atomic"]
    ["Senator", "Elf-Lord"]
    ["car", "cat"]
    ["election", "eating contest"]
    ["Congressional leaders", "river spirits"]
    ["homeland security", "Homestar Runner"]
    ["could not be reached for comment", "is guilty and everyone knows it"]
  ]);
 
  function substitute(textNode) {
    for (const [before, after] of substitutions.entries()) {
      textNode.data = textNode.data.replace(new RegExp(`\\b${before}\\b`, "ig"), after);
    }
  }
 
  walkAllTextNodeDescendants(document.body, substitute);
 </script>

JavaScriptモジュールスクリプトを使用することで得られる主な機能には、他のJavaScriptモジュールから関数をインポートする機能、デフォルトで厳密モードが有効になること、そしてトップレベルの宣言がグローバルオブジェクトに新しいプロパティを導入しないことが含まれます。また、このscript要素がドキュメント内のどこに現れても、ドキュメントの解析が完了し、依存関係（dom-utils.mjs）がフェッチされ評価されるまで評価されないことに注意してください。

次のサンプルは、JavaScriptモジュールスクリプト内からJSONモジュールスクリプトをインポートする方法を示しています：

<script type="module">
  import peopleInSpace from "http://api.open-notify.org/astros.json" with { type: "json" };
 
  const list = document.querySelector("#people-in-space");
  for (const { craft, name } of peopleInSpace.people) {
    const li = document.createElement("li");
    li.textContent = `${name} / ${craft}`;
    list.append(li);
  }
 </script>

モジュールスクリプトのMIMEタイプのチェックは厳格です。JSONモジュールスクリプトのフェッチが成功するためには、HTTPレスポンスがJSON MIMEタイプを持っている必要があります。例えばContent-Type: text/jsonです。逆に、ステートメントのwith { type: "json" }部分が省略された場合、意図がJavaScriptモジュールスクリプトをインポートすることであるとみなされ、HTTPレスポンスがJavaScript MIMEタイプでない場合、フェッチは失敗します。

4.12.1.1 処理モデル

script要素には、いくつかの関連する状態があります。

script要素には、パーサードキュメントがあり、これはnullまたはDocumentであり、最初はnullです。これはHTMLパーサーとXMLパーサーによってscript要素に設定され、これらの要素の処理に影響を与えます。nullでないパーサードキュメントを持つscript要素はパーサー挿入済みとして知られています。

script要素には、準備時ドキュメントがあり、これはnullまたはDocumentであり、最初はnullです。これは、準備の間にドキュメント間を移動するスクリプトが実行されないようにするために使用されます。

script要素には、最初はtrueである非同期強制というブール値があります。これはHTMLパーサーとXMLパーサーによって、彼らが挿入するscript要素に設定され、要素にasync属性が追加されるとfalseになります。

script要素には、外部ファイルからのブール値があり、最初はfalseです。これは、その時点での要素のsrc属性に基づいて、スクリプトが準備されたときに決定されます。

script要素には、最初はfalseであるパーサー実行の準備ができているブール値があります。これは、パーサー挿入済みの要素のみが使用し、パーサーがスクリプトを実行するタイミングを知らせるために使用されます。

script要素には、最初はfalseであるすでに開始されたブール値があります。

script要素には、最初はfalseであるロードイベントを遅延させるブール値があります。

script要素には、null、"classic"、"module"、または"importmap"のいずれかであるタイプがあり、最初はnullです。これは、その時点での要素のtype属性に基づいて、要素が準備されたときに決定されます。

script要素には、"uninitialized"、null（エラーを表す）、スクリプト、またはインポートマップ解析結果のいずれかである結果があり、最初は"uninitialized"です。

script要素には、一連の手順またはnullである結果が準備できたときに実行する手順があり、最初はnullです。スクリプト、インポートマップ解析結果、またはnullのresultを指定して、script要素elを準備完了としてマークするには:

  1. elの結果をresultに設定します。

  2. もしelの結果が準備できたときに実行する手順がnullでない場合、それらを実行します。

  3. elの結果が準備できたときに実行する手順をnullに設定します。

  4. elのロードイベントの遅延をfalseに設定します。

script要素elがasync属性またはdefer属性を持たずに、タイプが"classic"であり、elがパーサー挿入済みの場合、elは暗黙的に潜在的なレンダーブロックになります。

node、copy、および subtree を指定した script 要素の クローン作成ステップは、copy の already started を node の already started に設定することです。

async属性がscript要素elに追加された場合、ユーザーエージェントはelの非同期強制をfalseに設定しなければなりません。

script要素elのロードイベントを遅延させるがtrueである場合、ユーザーエージェントはelの準備時ドキュメントのロードイベントを遅延させる必要があります。

script のHTML 要素接続後の手順は、insertedNodeが与えられた場合、次のように定義されています:

  1. もし insertedNode が 接続済み でない場合、処理を終了します。

    これは、以前に挿入された script が、後に挿入された別の script を削除した場合に発生します。例えば:

    <script>
const script1 = document.createElement('script');
script1.innerText = `
  document.querySelector('#script2').remove();
`;

const script2 = document.createElement('script');
script2.id = 'script2';
script2.textContent = `console.log('script#2 running')`;

document.body.append(script1, script2);
</script>

    この例では、コンソールには何も出力されません。最初の script が append() によって挿入された時点で、2つ目の script はすでに 接続済み であり、2つ目の script は削除され、接続後の手順は実行されません。

  2. もし insertedNode が パーサーによって挿入された ものであれば、処理を終了します。

  3. スクリプト要素を準備し、insertedNode に対して処理を行います。

script の子要素が変更された際の手順は次の通りです:

  1. script 要素に対して、HTML 要素接続後の手順を実行します。

el の script 要素が与えられた場合、スクリプト要素を準備する：

  1. もし、el の すでに開始されている が真であれば、処理を終了します。

  2. el の パーサー文書 を parser document とします。

  3. el の パーサー文書 を null に設定します。

    これは、パーサーによって挿入された script 要素が、例えば空であるか、サポートされていないスクリプト言語を指定しているために、パーサーが実行しようとして失敗した場合、別のスクリプトが後でそれらを変更し、再度実行させることができるようにするためです。

  4. もし parser document が null でなく、el が async 属性を持っていない場合、el の 強制非同期 を真に設定します。

    これは、パーサー挿入された スクリプト 要素が実行に失敗したが、その後スクリプトによって動的に更新されて実行される場合に、async 属性が設定されていなくても、非同期で実行されるようにするためです。

  5. el の 子テキスト内容 を source text とします。

  6. もし el が src 属性を持っておらず、source text が空文字列であれば、処理を終了します。

  7. もし el が 接続されていない 場合、処理を終了します。

  8. 以下のいずれかが真である場合:

    この場合、この スクリプト 要素の the script block's type string を "text/javascript" に設定します。

    それ以外の場合、el が type 属性を持っている場合、その属性の値から先頭および末尾のASCIIホワイトスペースを削除したものを the script block's type string に設定します。

    それ以外の場合、el が空でない language 属性を持っている場合、その属性の値と "text/" を連結したものを the script block's type string に設定します。

    language 属性は常に適合せず、type 属性が存在する場合は常に無視されます。

  9. もし the script block's type string が JavaScript MIMEタイプの本質的な一致 であれば、el の type を "classic" に設定します。

  10. それ以外の場合、the script block's type string が文字列 "module" と ASCII大文字小文字を区別しない 一致である場合、el の type を "module" に設定します。

  11. それ以外の場合、the script block's type string が文字列 "importmap" と ASCII大文字小文字を区別しない 一致である場合、el の type を "importmap" に設定します。

  12. それ以外の場合、処理を終了します。（スクリプトは実行されず、el の type は null のままです。）

  13. もし parser document が null でない場合、el の パーサー文書 を parser document に戻し、el の 強制非同期 を false に設定します。

  14. el の すでに開始されている を true に設定します。

  15. el の 準備時間文書 をその ノード文書 に設定します。

  16. もし parser document が null でなく、かつ parser document が el の 準備時間文書 と等しくない場合、処理を終了します。

  17. もし el に対して スクリプトが無効化 されている場合、処理を終了します。

    スクリプトが無効化 されている場合の定義には、次のスクリプトが含まれます: XMLHttpRequest の responseXML 文書内のスクリプト、DOMParser によって作成された文書内のスクリプト、XSLTProcessor の transformToDocument 機能によって作成された文書内のスクリプト、およびスクリプトが最初に挿入された文書内のスクリプト Document が createDocument() APIを使用して作成されたものである場合など。

  18. もし el が nomodule コンテンツ属性を持ち、かつその type が "classic" である場合、処理を終了します。

    これは、モジュールスクリプト に nomodule を指定しても効果がないことを意味します。アルゴリズムは引き続き処理を続行します。

  19. もし el が src コンテンツ属性を持っておらず、要素のインライン動作がコンテンツセキュリティポリシーによってブロックされるべきか? アルゴリズムが el、"script" および source text に対して "Blocked" を返した場合、処理を終了します。[CSP]

  20. もし el が event 属性および for 属性を持ち、かつ el の type が "classic" である場合、以下を行います:

    1. for を el の for 属性の値とします。

    2. event を el の event 属性の値とします。

    3. event と for の 先頭および末尾のASCIIホワイトスペースを削除 します。

    4. for が文字列 "window" と ASCII大文字小文字を区別しない 一致でない場合、処理を終了します。

    5. event が文字列 "onload" または "onload()" と ASCII大文字小文字を区別しない 一致でない場合、処理を終了します。

  21. もし el が charset 属性を持っている場合、その属性の値から エンコーディングを取得 した結果を encoding とします。

    もし el が charset 属性を持っていないか、または エンコーディングの取得 に失敗した場合、encoding を el の ノード文書 の エンコーディング に設定します。

    もし el の type が "module" である場合、このエンコーディングは無視されます。

  22. classic script CORS setting を、el の crossorigin コンテンツ属性の現在の状態に設定します。

  23. module script credentials mode を、el の crossorigin コンテンツ属性の CORS 設定属性のクレデンシャルモード に設定します。

  24. cryptographic nonce を el の [[CryptographicNonce]] 内部スロットの値に設定します。

  25. もし el が integrity 属性を持っている場合、その属性の値を integrity metadata に設定します。

    それ以外の場合、integrity metadata を空の文字列に設定します。

  26. referrer policy を、el の referrerpolicy コンテンツ属性の現在の状態に設定します。

  27. fetch priority を、el の fetchpriority コンテンツ属性の現在の状態に設定します。

  28. もし el が パーサー挿入された ものであれば、parser metadata を "parser-inserted" に設定し、それ以外の場合は "not-parser-inserted" に設定します。

  29. options を スクリプトフェッチオプション とし、その 暗号論的ナンス を cryptographic nonce、integrity metadata を integrity metadata、parser metadata を parser metadata、クレデンシャルモード を module script credentials mode、リファラーポリシー を referrer policy、フェッチ優先度 を fetch priority に設定します。

  30. settings object を el の ノード文書 の 関連設定オブジェクト に設定します。

  31. もし el が src コンテンツ属性を持っている場合、以下の処理を行います:

    1. もし el の type が "importmap" であれば、要素タスクをキューに追加 し、el に対して イベントを発火 させ、処理を終了します。

      外部インポートマップスクリプトは現在サポートされていません。サポートを追加するための議論については、WICG/import-maps issue #235 を参照してください。

    2. src を el の src 属性の値に設定します。

    3. もし src が空の文字列であれば、要素タスクをキューに追加 し、el に対して イベントを発火 させ、処理を終了します。

    4. el の 外部ファイルから を true に設定します。

    5. url を、src を相対パスとして el の ノード文書 に対して URLをエンコードして解析する の結果に設定します。

    6. もし url が失敗した場合、要素タスクをキューに追加 し、el に対して イベントを発火 させ、処理を終了します。

    7. もし el が レンダリングブロックの可能性がある ものであれば、レンダリングをブロック します。

    8. el の ロードイベントを遅延させる を true に設定します。

    9. もし el が現在 レンダリングブロック中 であれば、options の レンダリングブロック を true に設定します。

    10. 以下の手順を与えられた result に対する onComplete として設定します:

      1. result を与えて el を準備完了としてマーク します。

    11. el の type に基づいてスイッチします:

      "classic"

      url、settings object、options、classic script CORS setting、encoding、および onComplete を与えて クラシックスクリプトをフェッチ します。

      "module"

      もし el が integrity 属性を持っていない場合、url と settings object を使用して モジュールのインテグリティメタデータを解決する の結果を options の インテグリティメタデータ に設定します。

      url、settings object、options、および onComplete を与えて 外部モジュールスクリプトグラフをフェッチ します。

      パフォーマンス上の理由から、ユーザーエージェントは、el が接続される（その間に crossorigin 属性が変更されないと予想される）と期待して、src 属性が設定されるとすぐにクラシックスクリプトまたはモジュールグラフをフェッチを開始することがあります。いずれの場合も、el が 接続される と、ロードがこのステップで説明されるように開始される必要があります。UAがそのようなプリフェッチを行うが、el が接続されないか、src 属性が動的に変更されるか、crossorigin 属性が動的に変更されると、そのスクリプトは実行されず、フェッチプロセスは事実上無駄になります。

  32. もし el が src コンテンツ属性を持っていない場合:

    1. base URL を el の ノード文書 の 文書ベースURL に設定します。

    2. el の type に基づいてスイッチします:

      "classic"

      1. クラシックスクリプトを作成 の結果を使用して script を source text、settings object、base URL、および options と共に設定します。

      2. 準備完了としてマーク script を与えて el を設定します。

      "module"

      1. el の ロードイベントを遅延させる を true に設定します。

      2. もし el が レンダリングブロックの可能性がある ものであれば:

        1. レンダリングをブロック します。

        2. options の レンダリングブロック を true に設定します。

      3. source text、base URL、settings object、および options を与えて インラインモジュールスクリプトグラフをフェッチ し、result を指定して次の手順を実行します:

        1. 要素タスクをキューに追加 し、el に次のステップを実行させます:

          1. 準備完了としてマーク el を与えて result を設定します。

          ここでタスクをキューに追加することは、インラインモジュールスクリプトに依存関係がないか、構文エラーが同期的に発生した場合でも、スクリプト要素を実行 するプロセスが同期的に行われないことを意味します。

      "importmap"

      1. result を、source text および base URL を与えて インポートマップ解析結果を作成する の結果に設定します。

      2. 準備完了としてマーク result を与えて el を設定します。

  33. もし el の type が "classic" であり、かつ el が src 属性を持っている場合、または el の type が "module" である場合:

    1. 断言: el の 結果 が "uninitialized" であることを確認します。

    2. もし el が async 属性を持っている場合、または el の 強制非同期 が真である場合:

      1. scripts を、el の 準備時間文書 の できるだけ早く実行されるスクリプトのセット に設定します。

      2. 追加 el を scripts に追加します。

      3. el の 結果が準備完了したときに実行する手順 を以下に設定します:

        1. スクリプト要素を実行 します el を。

        2. 削除 el を scripts から。

    3. それ以外の場合、el が パーサー挿入された ものでない場合:

      1. scripts を、el の 準備時間文書 の できるだけ早く順番に実行されるスクリプトのリスト に設定します。

      2. 追加 el を scripts に。

      3. el の 結果が準備完了したときに実行する手順 を以下に設定します:

        1. もし scripts[0] が el でなければ、これらの手順を中止します。

        2. 次の条件を満たしている限り、scripts が空でなく、かつ scripts[0] の 結果 が "uninitialized" でない場合:

          1. スクリプト要素を実行 します scripts[0] を。

          2. 削除 scripts[0] を。

    4. それ以外の場合、el が defer 属性を持っている場合、または el の type が "module" である場合:

      1. 追加 el をその パーサー文書 の 文書の解析が終了したときに実行されるスクリプトのリスト に。

      2. el の 結果が準備完了したときに実行する手順 を以下に設定します: el の パーサー実行準備完了 を真に設定します。（パーサーがスクリプトの実行を処理します。）

    5. それ以外の場合:

      1. el の パーサー文書 の 解析ブロック中のスクリプトを保留 に設定します el を。

      2. レンダリングをブロック します el で。

      3. el の 結果が準備完了したときに実行する手順 を以下に設定します: el の パーサー実行準備完了 を真に設定します。（パーサーがスクリプトの実行を処理します。）

  34. それ以外の場合:

    1. 断言: el の 結果 が "uninitialized" ではないことを確認します。

    2. 次のすべての条件が真である場合:

      この場合、以下を実行します:

      1. el の パーサー文書 の 解析ブロック中のスクリプトを保留 に設定します。

      2. el の パーサー実行準備完了 を真に設定します。（パーサーがスクリプトの実行を処理します。）

    3. それ以外の場合、即座に スクリプト要素を実行 el を、他のスクリプトがすでに実行されている場合でも。

各 文書 には 解析をブロックしているスクリプトを保留中 があります。これは スクリプト 要素または null であり、初期値は null です。

各 文書 には 可能な限り早く実行されるスクリプトのセット があります。これは セット の スクリプト 要素であり、初期値は空です。

各 文書 には 可能な限り早く順番に実行されるスクリプトのリスト があります。これは リスト の スクリプト 要素であり、初期値は空です。

各 文書 には 文書の解析が終了したときに実行されるスクリプトのリスト があります。これは リスト の スクリプト 要素であり、初期値は空です。

もし、パーサーをブロックする スクリプト 要素が通常はそのパーサーのブロックを解除する前に他の 文書 に移動された場合でも、そのスクリプトがパーサーをブロックする条件がもはや適用されなくなるまで、そのパーサーを引き続きブロックします（例: そのスクリプトが 解析をブロックしているスクリプトを保留中 であるため、元の 文書 に スクリプトをブロックしているスタイルシートが存在 していたが、スクリプトがそのブロック中のスタイルシートが読み込まれる前に他の 文書 に移動された場合でも、そのスクリプトはスタイルシートがすべて読み込まれるまでパーサーをブロックし続け、その後スクリプトが実行され、パーサーがブロック解除されます）。

与えられた script 要素 el を 実行する:

  1. el の ノード文書 を document とします。

  2. el の 準備時間文書 が document と等しくない場合、処理を終了します。

  3. レンダリングのブロックを解除 します el で。

  4. もし el の 結果 が null であれば、イベントを発火 し、エラー を el で発生させ、処理を終了します。

  5. もし el が 外部ファイルから のものであるか、el の type が "module" である場合、document の 破壊的な書き込みを無視するカウンター を増やします。

  6. el の type に基づいてスイッチします:

    "classic"

    1. document の currentScript オブジェクトに最近設定された値を oldCurrentScript とします。

    2. もし el の root が シャドウルート でなければ、document の currentScript 属性を el に設定します。それ以外の場合は、null に設定します。

      これは 文書ツリー内 のチェックを使用しません。これは el が実行前に文書から削除される可能性があり、そのシナリオでは currentScript が依然としてそれを指す必要があるためです。

    3. クラシックスクリプトを実行 します el の 結果 に基づいて。

    4. document の currentScript 属性を oldCurrentScript に設定します。

    "module"

    1. 断言: document の currentScript 属性が null であることを確認します。

    2. モジュールスクリプトを実行 します el の 結果 に基づいて。

    "importmap"

    1. インポートマップを登録 します el の 関連するグローバルオブジェクト および el の 結果 に基づいて。

  7. 前のステップで増やされた場合は、document の 破壊的な書き込みを無視するカウンター を減らします。

  8. もし el が 外部ファイルから のものであれば、イベントを発火 し、ロード を el で発生させます。

4.12.1.2 スクリプト言語

ユーザーエージェントは JavaScript をサポートする必要はありません。JavaScript 以外の言語が登場し、ウェブブラウザによって同様に広く採用された場合、この標準を更新する必要があります。そのような時が来るまで、script 要素の処理モデルに基づいて、他の言語を実装することはこの標準と矛盾します。

サーバーは、JavaScript リソースに対して text/javascript を使用するべきです。Updates to ECMAScript Media Types に従って、他の JavaScript MIME タイプ を使用すべきではなく、非 JavaScript MIME タイプ を使用してはなりません。[RFC9239]

外部の JavaScript リソースに対して、`Content-Type` ヘッダー内の MIME タイプパラメータは一般的に無視されます。（一部のケースでは、`charset` パラメータが影響を与える場合があります。）ただし、script 要素の type 属性に対しては重要であり、JavaScript MIME タイプのエッセンス一致の概念を使用します。

例えば、type 属性が "text/javascript; charset=utf-8" に設定されたスクリプトは、パース時に有効な JavaScript MIME タイプ であっても評価されません。

さらに、再度外部の JavaScript リソースに対して、スクリプト要素を準備する アルゴリズムおよび Fetch に詳細に記載されているように、`Content-Type` ヘッダー処理に関して特別な考慮が必要です。[FETCH]

4.12.1.3 スクリプト要素の内容に対する制限

このセクションで説明されているかなり奇妙な制限を回避する最も簡単で安全な方法は、スクリプト内のリテラルにこれらのシーケンスが現れる場合に、"<!--" を "\x3C!--"、"<script" を "\x3Cscript"、および "</script" を "\x3C/script" としてエスケープし、そうした構文を式に使用するコードを書かないようにすることです。こうすることで、このセクションで制限されている問題、つまり、歴史的な理由により、HTMLでの script ブロックの解析が、これらのシーケンスに対して直感的でない動作をするという問題を完全に回避できます。

script 要素の 子孫テキスト内容 は、以下の ABNF の script 生成規則に一致する必要があります。その文字セットは Unicode です。[ABNF]

script        = outer *( comment-open inner comment-close outer )

 outer         = < any string that doesn't contain a substring that matches not-in-outer >
 not-in-outer  = comment-open
 inner         = < any string that doesn't contain a substring that matches not-in-inner >
 not-in-inner  = comment-close / script-open

 comment-open  = "<!--"
 comment-close = "-->"
 script-open   = "<" s c r i p t tag-end

 s             =  %x0053 ; U+0053 ラテン大文字 S
 s             =/ %x0073 ; U+0073 ラテン小文字 s
 c             =  %x0043 ; U+0043 ラテン大文字 C
 c             =/ %x0063 ; U+0063 ラテン小文字 c
 r             =  %x0052 ; U+0052 ラテン大文字 R
 r             =/ %x0072 ; U+0072 ラテン小文字 r
 i             =  %x0049 ; U+0049 ラテン大文字 I
 i             =/ %x0069 ; U+0069 ラテン小文字 i
 p             =  %x0050 ; U+0050 ラテン大文字 P
 p             =/ %x0070 ; U+0070 ラテン小文字 p
 t             =  %x0054 ; U+0054 ラテン大文字 T
 t             =/ %x0074 ; U+0074 ラテン小文字 t

 tag-end       =  %x0009 ; U+0009 キャラクタタブ (タブ)
 tag-end       =/ %x000A ; U+000A ラインフィード (LF)
 tag-end       =/ %x000C ; U+000C フォームフィード (FF)
 tag-end       =/ %x0020 ; U+0020 スペース
 tag-end       =/ %x002F ; U+002F ソリダス (/)
 tag-end       =/ %x003E ; U+003E 大なり記号 (>)

script 要素が スクリプトのドキュメント を含む場合、以下のセクションで説明するように、その要素の内容にさらに制限があります。

次のスクリプトはこの問題を示しています。たとえば、次のような文字列を含むスクリプトがあるとします:

const example = 'この文字列を考えてください: <!-- <script>';
 console.log(example);

この文字列を script ブロック内に直接配置すると、上記の制限に違反します:

<script>
   const example = 'この文字列を考えてください: <!-- <script>';
   console.log(example);
 </script>

しかし、より大きな問題は、これらの制限に違反する理由です。実際にはスクリプトが奇妙に解析されるということです。上記のスクリプトブロックは終了していません。つまり、このスニペットで "</script>" エンドタグのように見えるものは、実際にはまだ script ブロックの一部です。スクリプトは実行されません（終了していないため）。もし実行されるとすれば、マークアップが次のように見える場合、スクリプト（ここで強調表示されています）が有効な JavaScript ではないため、失敗します:

<script>
   const example = 'この文字列を考えてください: <!-- <script>';
   console.log(example);
 </script>
 <!-- 見かけによらず、これはまだスクリプトの一部です！ -->
 <script>
  ... // これはまだ同じスクリプトブロックです...
 </script>

ここで何が起こっているかというと、レガシーな理由から、HTML内の script 要素内の "<!--" と "<script" 文字列はバランスが取れていないと、パーサーがブロックを閉じることを考慮しないためです。

このセクションの冒頭で述べたように問題のある文字列をエスケープすることで、この問題を完全に回避できます:

<script>
   // 注意: `\x3C` は `<` のエスケープシーケンスです。
   const example = 'この文字列を考えてください: \x3C!-- \x3Cscript>';
   console.log(example);
 </script>
 <!-- これはスクリプトブロック間の単なるコメントです -->
 <script>
  ... // これは新しいスクリプトブロックです
 </script>

これらのシーケンスがスクリプト式に自然に現れることがあります。次の例のように:

if (x<!--y) { ... }
 if ( player<script ) { ... }

そのような場合、文字はエスケープできませんが、式を書き直してシーケンスが発生しないようにすることができます。次のように:

if (x < !--y) { ... }
 if (!--y > x) { ... }
 if (!(--y) > x) { ... }
 if (player < script) { ... }
 if (script > player) { ... }

これにより、別の落とし穴も回避できます。関連する歴史的な理由で、クラシックスクリプト内の文字列 "<!--" は実際には行コメントの開始として扱われます。まるで "//" のように。

4.12.1.4 外部スクリプトのインラインドキュメント

script 要素の src 属性が指定されている場合、その script 要素の内容がある場合、その内容から派生した text IDL 属性の値が、以下の ABNF に示す documentation 生成規則と一致する必要があります。文字セットは Unicode です。[ABNF] 

documentation = *( *( space / tab / comment ) [ line-comment ] newline )
 comment       = slash star *( not-star / star not-slash ) 1*star slash
 line-comment  = slash slash *not-newline
 
 ; characters
 tab           = %x0009 ; U+0009 キャラクタタブ (タブ)
 newline       = %x000A ; U+000A ラインフィード (LF)
 space         = %x0020 ; U+0020 スペース
 star          = %x002A ; U+002A アスタリスク (*)
 slash         = %x002F ; U+002F スラッシュ (/)
 not-newline   = %x0000-0009 / %x000B-10FFFF
                 ; U+000A ラインフィード (LF) 以外の スカラ値
 not-star      = %x0000-0029 / %x002B-10FFFF
                 ; U+002A アスタリスク (*) 以外の スカラ値
 not-slash     = %x0000-002E / %x0030-10FFFF
                 ; U+002F スラッシュ (/) 以外の スカラ値

これは、要素の内容を JavaScript コメントとして配置することに相当します。

この要件は、script 要素の内容に関する前述の構文制限に加えて適用されます。

これにより、著者はライセンス情報や API 情報などのドキュメントを、外部スクリプトファイルを参照しながらドキュメント内に含めることができます。構文は制約されていますが、著者が誤って有効なスクリプトのように見える内容を含めることを防ぎます。その場合でも src 属性が提供されます。 

<script src="cool-effects.js">
  // create new instances using:
  //    var e = new Effect();
  // start the effect using .play, stop using .stop:
  //    e.play();
  //    e.stop();
 </script>
4.12.1.5 script 要素と XSLT の相互作用

このセクションは規範的ではありません。

この仕様書では、script 要素と XSLT の相互作用について定義していません。しかし、これを実際に定義する他の仕様書がない場合、既存の実装に基づいて実装者向けにいくつかのガイドラインを示します。

最初の 2 つのケースと最後のケースの主な違いは、最初の 2 つが Document を操作するのに対し、最後のケースはフラグメントを操作する点です。

4.12.2 noscript 要素

要素/noscript

全ての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet ExplorerYes
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリー:
メタデータコンテンツ。
フローコンテンツ。
フレージングコンテンツ。
この要素が使用できる文脈:
head要素内の HTML文書で、先祖にnoscript要素が存在しない場合。
フレージングコンテンツが期待される HTML文書で、先祖にnoscript要素が存在しない場合。
コンテンツモデル:
スクリプトが無効な場合、head要素内において、 任意の順序で、0個以上のlink要素、0個以上のstyle要素、 および0個以上のmeta要素を含む。
スクリプトが無効で、head要素外の場合: 透過的であるが、子孫にnoscript要素を含んではならない。
その他の場合: プローズに示される要件に準拠するテキスト。
text/htmlにおけるタグ省略:
どちらのタグも省略不可。
コンテンツ属性:
グローバル属性
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOMインターフェイス:
HTMLElementを使用。

noscript要素は、スクリプトが有効な場合は何も表さず、スクリプトが無効な場合はその子要素を表します。 これは、スクリプトをサポートするユーザーエージェントとサポートしないユーザーエージェントに異なるマークアップを提供するために使用され、ドキュメントの解析方法に影響を与えます。

HTML文書で使用する場合、許可されるコンテンツモデルは次のとおりです:

head要素内で、スクリプトが無効な場合

noscript要素には、link、 style、 およびmeta要素のみを含める必要があります。

head要素内で、スクリプトが有効な場合

noscript要素にはテキストのみを含める必要があります。ただし、noscript要素をcontext要素として、テキストコンテンツをinputとして、HTMLフラグメント解析アルゴリズムを実行することによって、link、style、およびmeta要素のみを含むノードリストが生成される必要があります。また、解析エラーが発生しないようにする必要があります。

head要素外で、スクリプトが無効な場合

noscript要素のコンテンツモデルは、透過的です。ただし、noscript要素には、先祖要素としてnoscript要素を含めることはできません（つまり、noscriptはネストできません）。

head要素外で、スクリプトが有効な場合

noscript要素にはテキストのみを含める必要があります。ただし、そのテキストは、次のアルゴリズムを実行して、noscript要素およびscript要素がない準拠したドキュメントが得られるようにする必要があります。また、そのアルゴリズムの実行中に例外が発生せず、HTMLパーサーが解析エラーを警告しないようにする必要があります:

  1. ドキュメントからすべてのscript要素を削除します。
  2. ドキュメント内のすべてのnoscript要素のリストを作成します。そのリスト内のすべてのnoscript要素に対して、次の手順を実行します:
    1. sを、noscript要素の子テキストコンテンツとします。
    2. outerHTML属性を、sの値に設定します（これにより、副作用として、noscript要素がドキュメントから削除されます）。

これらの複雑な手順は、歴史的な理由から、noscript要素が、HTMLパーサーによって、スクリプトが有効か無効かに基づいて異なる方法で処理されるために必要です。

noscript 要素は、XML文書で使用してはなりません。

noscript 要素は、HTML構文でのみ有効であり、XML構文では効果がありません。 これは、スクリプトが有効な場合にパーサーを「オフ」にすることで、要素の内容が純粋なテキストとして扱われ、実際の要素として扱われないようにするためです。XMLにはこれを行うためのメカニズムが定義されていません。

noscript 要素には他の要件はありません。特に、noscript 要素の子要素は、スクリプトが有効な場合でも、フォーム送信、 スクリプト、およびその他の処理から免除されません。

次の例では、noscript 要素がスクリプトのフォールバックとして使用されています。

<form action="calcSquare.php">
  <p>
   <label for=x>Number</label>:
   <input id="x" name="x" type="number">
  </p>
  <script>
   var x = document.getElementById('x');
   var output = document.createElement('p');
   output.textContent = 'Type a number; it will be squared right then!';
   x.form.appendChild(output);
   x.form.onsubmit = function () { return false; }
   x.oninput = function () {
     var v = x.valueAsNumber;
     output.textContent = v + ' squared is ' + v * v;
   };
  </script>
  <noscript>
   <input type=submit value="Calculate Square">
  </noscript>
 </form>

スクリプトが無効な場合、サーバー側で計算を実行するボタンが表示されます。スクリプトが有効な場合、値はリアルタイムで計算されます。

noscript 要素は強力な手段ですが、スクリプトが有効であっても、ページのスクリプトが何らかの理由で失敗する可能性があります。 このため、noscriptの使用は避け、 代わりにスクリプトを設計して、スクリプトがないページからスクリプトがあるページに動的に変更する方法を採用する方が一般的に望ましいです。以下の例のように:

<form action="calcSquare.php">
  <p>
   <label for=x>Number</label>:
   <input id="x" name="x" type="number">
  </p>
  <input id="submit" type=submit value="Calculate Square">
  <script>
   var x = document.getElementById('x');
   var output = document.createElement('p');
   output.textContent = 'Type a number; it will be squared right then!';
   x.form.appendChild(output);
   x.form.onsubmit = function () { return false; }
   x.oninput = function () {
     var v = x.valueAsNumber;
     output.textContent = v + ' squared is ' + v * v;
   };
   var submit = document.getElementById('submit');
   submit.parentNode.removeChild(submit);
  </script>
 </form>

上記のテクニックは、XML文書でも有効です。 なぜならnoscript はXML文書では許可されていないからです。

4.12.3 template要素

Element/template

全ての現在のエンジンでサポートされています。

Firefox22+Safari8+Chrome26+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView AndroidYesSamsung Internet?Opera Android?

HTMLTemplateElement

全ての現在のエンジンでサポートされています。

Firefox22+Safari8+Chrome26+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
メタデータ内容。
フロー内容。
フレーズ内容。
スクリプトサポート要素。
この要素が使用されるコンテキスト:
メタデータ内容が予想される場所。
フレーズ内容が予想される場所。
スクリプトサポート要素が予想される場所。
colgroup要素の子として、span属性を持たないもの。
内容モデル:
なし（詳細については例を参照）。
text/htmlでのタグ省略:
どちらのタグも省略できません。
内容属性:
グローバル属性
shadowrootmode — ストリーミング宣言的シャドウルートを可能にします。
shadowrootdelegatesfocus — 宣言的シャドウルートにフォーカスを委任します。
shadowrootclonable — 宣言的シャドウルートをクローン可能にします。
shadowrootserializable — 宣言的シャドウルートをシリアライズ可能にします。
shadowrootcustomelementregistry — 宣言的なシャドウルートが、カスタム要素レジストリを使用することを示すことを可能にします
アクセシビリティ考慮事項:
作成者向け。
実装者向け。
DOMインターフェース:
[Exposed=Window]
interface HTMLTemplateElement : HTMLElement {
  [HTMLConstructor] constructor();

  readonly attribute DocumentFragment content;
  [CEReactions] attribute DOMString shadowRootMode;
  [CEReactions] attribute boolean shadowRootDelegatesFocus;
  [CEReactions] attribute boolean shadowRootClonable;
  [CEReactions] attribute boolean shadowRootSerializable;
  [CEReactions] attribute DOMString shadowRootCustomElementRegistry;
};

template要素は、スクリプトによってドキュメントにクローンして挿入できるHTMLフラグメントを宣言するために使用されます。

レンダリングにおいて、template要素は何も表しません。

shadowrootmode内容属性は、列挙型属性であり、次のキーワードと状態があります:

キーワード 状態 簡単な説明
open Open template要素は、開かれた宣言的シャドウルートを表します。
closed Closed template要素は、閉じた宣言的シャドウルートを表します。

shadowrootmode属性の無効な値のデフォルトおよび欠損値のデフォルトは、いずれもNone状態です。

shadowrootdelegatesfocus内容属性はブール属性です。

shadowrootclonable内容属性はブール属性です。

shadowrootserializable内容属性はブール属性です。

shadowrootcustomelementregistry コンテンツ属性はブーリアン属性です。

template要素のテンプレート内容は要素自体の子ではありません。

DOM操作の結果として、template要素がテキストノードや要素ノードを含むことも可能です。しかし、それを含むことはtemplate要素の内容モデルの違反となります。なぜなら、その内容モデルは何もないとして定義されているためです。

例えば、次のドキュメントを考えてみましょう:

<!doctype html>
 <html lang="en">
  <head>
   <title>Homework</title>
  <body>
   <template id="template"><p>Smile!</p></template>
   <script>
    let num = 3;
    const fragment = document.getElementById('template').content.cloneNode(true);
    while (num-- > 1) {
      fragment.firstChild.before(fragment.firstChild.cloneNode(true));
      fragment.firstChild.textContent += fragment.lastChild.textContent;
    }
    document.body.appendChild(fragment);
   </script>
 </html>

p要素は、template内にありますが、DOMではtemplateの子ではなく、DocumentFragmentの子として返されます。

スクリプトがappendChild()をtemplate要素で呼び出した場合、それは他の要素と同様にtemplate要素に子を追加しますが、これはtemplate要素の内容モデルの違反です。

template.content

HTMLTemplateElement/content

全ての現在のエンジンでサポートされています。

Firefox22+Safari8+Chrome26+
Opera?Edge79+
Edge (Legacy)13+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

テンプレート内容（DocumentFragment）を返します。

各template要素には、それに関連付けられたDocumentFragmentオブジェクトがあり、それがテンプレート内容となります。テンプレート内容には準拠要件はありません。template要素が作成されると、ユーザーエージェントはテンプレート内容を確立するために次の手順を実行しなければなりません:

  1. docをtemplate要素のノードドキュメントの適切なテンプレート内容の所有ドキュメントとします。

  2. docをDocumentFragmentオブジェクトとして作成し、そのノードドキュメントをdocとし、ホストをtemplate要素とします。

  3. 作成したばかりのDocumentFragmentオブジェクトを、template要素のテンプレート内容に設定します。

Documentdocの適切なテンプレート内容の所有ドキュメントは、次のアルゴリズムによって返されるDocumentです:

  1. docがこのアルゴリズムによって作成されたDocumentでない場合:

    1. docにまだ関連する無効なテンプレートドキュメントがない場合:

      1. new docを新しいDocumentとして作成し（ブラウジングコンテキストはnull）、このステップにおける「このアルゴリズムによって作成されたDocument」とします。

      2. docがHTMLドキュメントである場合、new docをHTMLドキュメントとしてもマークします。

      3. docの関連する無効なテンプレートドキュメントをnew docに設定します。

    2. docをdocの関連する無効なテンプレートドキュメントに設定します。

    このアルゴリズムによって作成されていない各Documentには、すべてのtemplate要素のテンプレート内容を所有するための単一のDocumentが与えられ、その内容がブラウジングコンテキスト内にないようにし、無効なままにします（例:スクリプトが実行されないようにする）。一方で、このアルゴリズムによって作成されたDocument内のtemplate要素は、同じDocument所有者をその内容に再利用します。

  2. docを返します。

採用ステップ（nodeとoldDocumentをパラメータとして）template要素の場合は次のとおりです:

  1. docをnodeのノードドキュメントの適切なテンプレート内容の所有ドキュメントとします。

    nodeのノードドキュメントは、nodeが採用されたばかりのDocumentオブジェクトです。

  2. 採用するnodeのテンプレート内容（DocumentFragmentオブジェクト）をdocに追加します。

contentゲッターステップは、テンプレート内容がShadowRootノードでない場合にtemplateのテンプレート内容を返します。それ以外の場合はnullを返します。

shadowRootMode IDL 属性は、既知の値のみに限定された shadowrootmode コンテンツ属性を反映しなければなりません。

shadowRootDelegatesFocus IDL 属性は、shadowrootdelegatesfocus コンテンツ属性を反映しなければなりません。

shadowRootClonable IDL 属性は、shadowrootclonable コンテンツ属性を反映しなければなりません。

shadowRootSerializable IDL 属性は、shadowrootserializable コンテンツ属性を反映しなければなりません。

shadowRootCustomElementRegistry IDL 属性は、shadowrootcustomelementregistry コンテンツ属性を反映しなければなりません。

IDL 属性は、拡張できるように意図的にブール型を持っていません。

node、copy、および subtree を指定した template 要素のクローン作成ステップは次のとおりです。

  1. subtree が false の場合、戻ります。

  2. node の テンプレートコンテンツの 子の各 child について、ツリー順で：child を指定し、document を copy の テンプレートコンテンツの ノードドキュメントに設定し、subtree を true に設定し、parent を copy の テンプレートコンテンツに設定して、ノードをクローンします。

この例では、スクリプトがデータ構造からのデータを使用して表を4列に埋めています。この際、マークアップから構造を手動で生成する代わりに、templateを使用して要素構造を提供しています。 

<!DOCTYPE html>
<html lang='en'>
<title>Cat data</title>
<script>
// データはここでハードコードされていますが、サーバーから提供されることもあります
var data = [
  { name: 'Pillar', color: 'Ticked Tabby', sex: 'Female (neutered)', legs: 3 },
  { name: 'Hedral', color: 'Tuxedo', sex: 'Male (neutered)', legs: 4 },
];
</script>
<table>
<thead>
<tr>
<th>Name <th>Color <th>Sex <th>Legs
</tbody>
<template id="row">
<tr><td><td><td><td>
</template>
</table>
<script>
var template = document.querySelector('#row');
for (var i = 0; i < data.length; i += 1) {
  var cat = data[i];
  var clone = template.content.cloneNode(true);
  var cells = clone.querySelectorAll('td');
  cells[0].textContent = cat.name;
  cells[1].textContent = cat.color;
  cells[2].textContent = cat.sex;
  cells[3].textContent = cat.legs;
  template.parentNode.appendChild(clone);
}</script>

この例では、cloneNode()を使用してtemplateの内容を複製していますが、同じことを行うdocument.importNode()を使用することもできます。この2つのAPIの違いは、ノードドキュメントが更新されるタイミングだけです。cloneNode()では、ノードがappendChild()によって追加されるときに更新され、document.importNode()では、ノードが複製されるときに更新されます。

4.12.3.1 template要素とXSLTおよびXPathの相互作用

このセクションは規範的ではありません。

この仕様書は、XSLTおよびXPathがtemplate要素とどのように相互作用するかを定義していません。ただし、これを実際に定義する他の仕様書がない場合には、以下に実装者向けのガイドラインを示します。これらは、この仕様書で説明されている他の処理と整合性を持つことを意図しています:

4.12.4slot要素

Element/slot

全ての現行エンジンでサポートされています。

Firefox63+Safari10+Chrome53+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLSlotElement

全ての現行エンジンでサポートされています。

Firefox63+Safari10+Chrome53+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
この要素を使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
透過
text/htmlでのタグ省略:
どちらのタグも省略可能ではありません。
内容属性:
グローバル属性
name — シャドウツリーのスロットの名前
アクセシビリティの考慮事項:
作成者向け。
実装者向け。
DOMインターフェイス: 
[Exposed=Window]
interface HTMLSlotElement : HTMLElement {
[HTMLConstructor] constructor();

[CEReactions] attribute DOMString name;
sequence<Node> assignedNodes(optional AssignedNodesOptions options = {});
sequence<Element> assignedElements(optional AssignedNodesOptions options = {});
undefined assign((Element or Text)... nodes);
};

dictionary AssignedNodesOptions {
boolean flatten = false;
};

slot要素はスロットを定義します。これは通常、シャドウツリーで使用されます。slot要素は、割り当てられたノードが存在する場合はそれらを表し、そうでない場合はその内容を表します。

name内容属性には任意の文字列値を含めることができます。これは、スロットの名前を表します。

name属性は他の要素にスロットを割り当てるために使用されます。slot要素がname属性を持つ場合、その値と一致するslot属性を持つ要素がそのスロットに割り当てられます。このslot要素がシャドウツリーの子であり、そのツリーのルートのホストが対応するslot属性値を持つ場合に限ります。

slot.name

HTMLSlotElement/name

全ての現行エンジンでサポートされています。

Firefox63+Safari10+Chrome53+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
このプロパティは、slotのnameを取得または設定するために使用されます。
slot.assignedNodes()

HTMLSlotElement/assignedNodes

全ての現行エンジンでサポートされています。

Firefox63+Safari10+Chrome53+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
このメソッドは、slotに割り当てられたノードを返します。
slot.assignedNodes({ flatten: true })
このメソッドは、slotに割り当てられたノード、およびスロットがない場合はその子要素を返し、その中で見つかったslot要素についても同様に処理します。それを再帰的に繰り返し、slot要素がなくなるまで続けます。
slot.assignedElements()

HTMLSlotElement/assignedElements

全ての現行エンジンでサポートされています。

Firefox66+Safari12.1+Chrome65+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
このメソッドは、slotに割り当てられたノードのうち、要素だけを返します。
slot.assignedElements({ flatten: true })
このメソッドは、assignedNodes({ flatten: true })と同じものを返しますが、要素に限定されます。
slot.assign(...nodes)
このメソッドは、指定されたnodesをslotの手動で割り当てられたノードに設定します。

nameIDL属性は同名の内容属性を反映する必要があります。

slot要素には手動で割り当てられたノードがあり、これはassign()によって設定された順序付けされたセットのスロッタブルです。このセットは最初は空です。

手動で割り当てられたノードセットは、弱参照を使ってスロッタブルを実装することができます。なぜなら、このセットはスクリプトから直接アクセスできないからです。

assignedNodes(options)メソッドの手順は以下の通りです：

  1. もしoptions["flatten"]がfalseであれば、thisの割り当てられたノードを返します。

  2. フラット化されたスロッタブルを見つける結果を返します。このときthisを使用します。

assignedElements(options)メソッドの手順は以下の通りです：

  1. もしoptions["flatten"]がfalseであれば、thisの割り当てられたノードを、Elementノードのみにフィルタリングして返します。

  2. フラット化されたスロッタブルを見つける結果を、Elementノードのみにフィルタリングして返します。このときthisを使用します。

HTMLSlotElement/assign

全ての現行エンジンでサポートされています。

Firefox92+Safari16.4+Chrome86+
Opera?Edge86+
Edge (Legacy)?サポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

assign(...nodes)メソッドの手順は以下の通りです：

  1. 各nodeについて、thisの手動で割り当てられたノードを、nodeの手動スロット割り当てをnullに設定します。

  2. nodesSetを新しい順序付けされたセットに設定します。

  3. 各nodeについて：

    1. もしnodeの手動スロット割り当てがslotに関連している場合、そのslotからnodeを削除します。

    2. nodeの手動スロット割り当てをthisに設定します。

    3. nodeをnodesSetに追加します。

  4. thisの手動で割り当てられたノードをnodesSetに設定します。

  5. ツリーのスロッタブル割り当てを、thisのルートに対して実行します。

4.12.5 canvas 要素

Element/canvas

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

HTMLCanvasElement

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カテゴリ:
フローコンテンツ.
フレージングコンテンツ.
埋め込みコンテンツ.
知覚可能なコンテンツ.
この要素が使用できるコンテキスト:
埋め込みコンテンツが予期される場所。
コンテンツモデル:
透明ですが、インタラクティブコンテンツを持つ子孫は含まれません。ただし、a要素、img要素（usemap属性を持つもの）、button要素、input要素（type属性がチェックボックス状態またはラジオボタン状態にあるもの）、input要素（ボタンであるもの）、およびselect要素（multiple属性または表示サイズが1を超えるもの）。
タグ省略:
どちらのタグも省略可能ではありません。
コンテンツ属性:
グローバル属性
width — 水平方向の寸法
height — 垂直方向の寸法
アクセシビリティの考慮事項:
著者向け。
実装者向け。
DOM インターフェース: 
typedef (CanvasRenderingContext2D or ImageBitmapRenderingContext or WebGLRenderingContext or WebGL2RenderingContext or GPUCanvasContext) RenderingContext;
 
 [Exposed=Window]
 interface HTMLCanvasElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute unsigned long width;
   [CEReactions] attribute unsigned long height;
 
   RenderingContext? getContext(DOMString contextId, optional any options = null);
 
   USVString toDataURL(optional DOMString type = "image/png", optional any quality);
   undefined toBlob(BlobCallback _callback, optional DOMString type = "image/png", optional any quality);
   OffscreenCanvas transferControlToOffscreen();
 };
 
 callback BlobCallback = undefined (Blob? blob);

canvas 要素は、解像度依存のビットマップキャンバスをスクリプトで提供し、グラフ、ゲームグラフィック、アート、その他のビジュアルイメージを動的に描画するために使用できます。

著者は、canvas 要素を、より適切な要素が利用可能な場合には使用しないようにすべきです。たとえば、ページの見出しを描画するために canvas 要素を使用するのは不適切です。見出しの希望する表示がグラフィカルに強調されたものである場合でも、それは通常 h1 のような適切な要素を使用してマークアップし、CSS や シャドウツリー のような補助技術を使用してスタイル設定を行うべきです。

著者が canvas 要素を使用する場合、canvas のビットマップと本質的に同じ機能または目的をユーザーに伝えるコンテンツも提供しなければなりません。このコンテンツは、canvas 要素の内容として配置されることがあります。canvas 要素の内容がある場合、それは要素のフォールバックコンテンツです。

インタラクティブな視覚メディアにおいて、canvas 要素で スクリプトが有効 であり、かつ canvas 要素のサポートが有効になっている場合、canvas 要素は、要素のビットマップである動的に作成された画像で構成される 埋め込みコンテンツ を 表します。

インタラクティブでない静的な視覚メディアにおいて、canvas 要素が以前にレンダリングコンテキストと関連付けられている場合（例: ページがインタラクティブな視覚メディアで表示され、その後印刷された場合、またはページレイアウトプロセス中に実行されたスクリプトが要素上に描画した場合）、canvas 要素は、要素の現在のビットマップとサイズを持つ 埋め込みコンテンツ を 表します。それ以外の場合、要素はその フォールバックコンテンツ を表します。

非視覚メディアおよび、視覚メディアで canvas 要素の スクリプトが無効 である場合、または canvas 要素のサポートが無効になっている場合、canvas 要素は代わりにその フォールバックコンテンツ を 表します。

canvas 要素が 埋め込みコンテンツ を表している場合でも、ユーザーは canvas 要素の子孫（フォールバックコンテンツ 内）にフォーカスを当てることができます。要素が フォーカスされる と、キーボードインタラクションイベントのターゲットとなります（ただし、要素自体は表示されていない場合でも）。これにより、著者はインタラクティブなキャンバスをキーボードでアクセス可能にすることができます。著者はインタラクティブな領域と フォーカス可能な領域 を フォールバックコンテンツ に一対一に対応させる必要があります。（フォーカスはマウスインタラクションイベントには影響しません。）[UIEVENTS]

最も近い canvas 要素の祖先が レンダリングされて いて、埋め込みコンテンツ を 表して いる場合、その要素は 関連するキャンバスフォールバックコンテンツとして使用されている 要素です。

canvas 要素には、要素のビットマップのサイズを制御するための 2 つの属性、width と height があります。これらの属性が指定されている場合、値は 有効な非負整数 でなければなりません。非負整数を解析するためのルール を使用して、その数値を 取得 します。属性が存在しない場合、またはその値の解析にエラーが発生した場合は、代わりにデフォルト値が使用されなければなりません。width 属性のデフォルト値は 300 であり、height 属性のデフォルト値は 150 です。

width または height 属性の値を設定する際、canvas 要素の コンテキストモード が プレースホルダー に設定されている場合、ユーザーエージェントは "InvalidStateError" DOMException をスローし、属性の値を変更せずにそのままにしておかなければなりません。

canvas 要素が 埋め込みコンテンツ を表しているときの 自然な寸法 は、要素のビットマップの寸法と等しくなります。

ユーザーエージェントは、canvas とそのレンダリングコンテキストのビットマップに対して、1 座標空間単位あたり 1 ピクセルの画像データで構成される正方形のピクセル密度を使用しなければなりません。

canvas 要素は、スタイルシートによって任意にサイズ変更が可能ですが、そのビットマップは 'object-fit' CSS プロパティの影響を受けます。

canvas 要素のビットマップ、ImageBitmap オブジェクトのビットマップ、および以下の CanvasRenderingContext2D、OffscreenCanvasRenderingContext2D、および ImageBitmapRenderingContext オブジェクトのセクションで説明されているものなど、一部のレンダリングコンテキストのビットマップには、origin-clean フラグがあり、true または false に設定できます。 最初に、canvas 要素または ImageBitmap オブジェクトが作成されるとき、そのビットマップの origin-clean フラグは true に設定されなければなりません。

canvas 要素には、レンダリングコンテキストがバインドされることがあります。最初は、レンダリングコンテキストはバインドされていません。レンダリングコンテキストがバインドされているかどうか、およびどの種類のレンダリングコンテキストであるかを追跡するために、canvas には、キャンバスコンテキストモード もあります。これにより、最初は なし に設定されますが、この仕様で定義されたアルゴリズムによって プレースホルダー、2d、ビットマップレンダラー、webgl、webgl2、または webgpu に変更できます。

そのキャンバスコンテキストモードがなしのとき、canvas要素にはレンダリングコンテキストがなく、そのビットマップは透明な黒であり、自然な幅は要素の幅属性の数値に等しく、自然な高さは要素の高さ属性の数値に等しく、これらの値はCSSピクセルで解釈され、属性が設定、変更、または削除されるたびに更新されます。

canvas 要素の キャンバスコンテキストモード が プレースホルダー の場合、その要素にはレンダリングコンテキストがありません。これは OffscreenCanvas オブジェクトのプレースホルダーとして機能し、OffscreenCanvas オブジェクトのレンダリングコンテキストによって canvas 要素の内容が更新されます。

canvas 要素が 埋め込みコンテンツ を表している場合、それは 塗装ソース を提供します。その幅は要素の 自然な幅 に等しく、高さは要素の 自然な高さ に等しく、その外観は要素のビットマップです。

width と height の内容属性が設定、削除、変更された場合、またはすでに持っている値に冗長に設定された場合、ユーザーエージェントは canvas 要素の コンテキストモード に対応する以下の表の行からアクションを実行しなければなりません。

Context Mode

Action

2d

ビットマップの寸法を 設定する手順 に従い、width および height コンテンツ属性の 数値 を取得します。

webgl または webgl2

WebGL の仕様に定義されている動作に従います。[WEBGL]

webgpu

WebGPU に定義されている動作に従います。[WEBGPU]

bitmaprenderer

コンテキストの ビットマップモード が ブランク に設定されている場合、ImageBitmapRenderingContext の出力ビットマップを 設定する手順 を実行し、canvas 要素のレンダリングコンテキストを渡します。

placeholder

何もしない。

none

何もしない。

HTMLCanvasElement/height

Support in all current engines.

Firefox1.5+ Safari3+ Chrome1+
Opera9+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS1+ Chrome Android? WebView Android? Samsung Internet? Opera Android10.1+

HTMLCanvasElement/width

Support in all current engines.

Firefox1.5+ Safari3+ Chrome1+
Opera9+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS1+ Chrome Android? WebView Android? Samsung Internet? Opera Android10.1+

width と height IDL 属性は、それぞれの同名のコンテンツ属性を 反映 しなければならず、同じデフォルトを持ちます。

context = canvas.getContext(contextId [, options ])

HTMLCanvasElement/getContext

Support in all current engines.

Firefox1.5+ Safari2+ Chrome1+
Opera9+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android10.1+

キャンバス上で描画するための API を公開するオブジェクトを返します。contextId は、希望する API を指定します。次のいずれかの値を指定します: "2d"、"bitmaprenderer"、"webgl"、"webgl2"、または "webgpu"。options は、その API によって処理されます。

この仕様では、"2d" と "bitmaprenderer" コンテキストが定義されています。WebGL の仕様では、"webgl" および "webgl2" コンテキストが定義されています。WebGPU は "webgpu" コンテキストを定義しています。[WEBGL] [WEBGPU]

サポートされていない contextId が指定された場合や、キャンバスが別のコンテキストタイプで既に初期化されている場合 (例えば、"2d" コンテキストを取得しようとした後で、"webgl" コンテキストを取得しようとする場合) には、null を返します。

getContext(contextId, options) メソッドを canvas 要素で呼び出すと、次のステップが実行されます:

  1. options が オブジェクト でない場合、options を null に設定します。

  2. options を JavaScript 値に変換 した結果に設定します。

  3. 次の表の列ヘッダーがこの canvas 要素の キャンバスコンテキストモード に一致し、行ヘッダーが contextId に一致するセルの手順を実行します。

    none 2d bitmaprenderer webgl または webgl2 webgpu placeholder
    "2d"

    1. context を 2D コンテキスト作成アルゴリズム に従って実行し、this および options を与えた結果とします。

    2. this の コンテキストモード を 2d に設定します。

    3. context を返します。

    このメソッドが同じ最初の引数で最後に呼び出されたときに返されたのと同じオブジェクトを返します。

    null を返します。

    null を返します。

    null を返します。

    "InvalidStateError" DOMException をスローします。

    "bitmaprenderer"

    1. context を ImageBitmapRenderingContext 作成アルゴリズム に従って実行し、this および options を与えた結果とします。

    2. this の コンテキストモード を bitmaprenderer に設定します。

    3. context を返します。

    null を返します。

    このメソッドが同じ最初の引数で最後に呼び出されたときに返されたのと同じオブジェクトを返します。

    null を返します。

    null を返します。

    "InvalidStateError" DOMException をスローします。

    "webgl" または "webgl2"、ユーザーエージェントが現在の構成で WebGL 機能をサポートしている場合

    1. context を WebGL 仕様の コンテキスト作成 セクションに従って実行した結果とします。[WEBGL]

    2. context が null の場合、null を返します。それ以外の場合、this の コンテキストモード を webgl または webgl2 に設定します。

    3. context を返します。

    null を返します。

    null を返します。

    このメソッドが同じ最初の引数で最後に呼び出されたときに返されたのと同じオブジェクトを返します。

    null を返します。

    "InvalidStateError" DOMException をスローします。

    "webgpu"、ユーザーエージェントが現在の構成で WebGPU 機能をサポートしている場合

    1. context を WebGPU の キャンバスレンダリング セクションに従って実行した結果とします。[WEBGPU]

    2. context が null の場合、null を返します。それ以外の場合、this の コンテキストモード を webgpu に設定します。

    3. context を返します。

    null を返します。

    null を返します。

    null を返します。

    このメソッドが同じ最初の引数で最後に呼び出されたときに返されたのと同じオブジェクトを返します。

    "InvalidStateError" DOMException をスローします。

    サポートされていない値*

    null を返します。

    null を返します。

    null を返します。

    null を返します。

    null を返します。

    "InvalidStateError" DOMException をスローします。

    * 例えば、ユーザーエージェントがグラフィックハードウェアの能力を使い果たし、ソフトウェアのフォールバック実装がない場合の "webgl" または "webgl2" 値など。

url = canvas.toDataURL([ type [, quality ] ])

HTMLCanvasElement/toDataURL

すべての現行エンジンでサポートされています。

Firefox2+Safari4+Chrome2+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

キャンバス内の画像の data: URL を返します。

最初の引数が指定されている場合、返される画像の形式 (例: PNG や JPEG) を制御します。デフォルトは "image/png" です。指定された形式がサポートされていない場合も、この形式が使用されます。第二引数は、品質が可変な画像形式 (例: "image/jpeg") の場合に適用され、0.0 から 1.0 までの範囲で結果の画像の品質レベルを示す数値です。

"image/png" 以外の形式を使用しようとする場合、返された文字列が "data:image/png," または "data:image/png;" のいずれかで始まるかどうかを確認することで、画像が本当に要求された形式で返されたかを確認できます。これが当てはまる場合、画像は PNG であり、要求された形式はサポートされていないことになります。(唯一の例外は、キャンバスの高さまたは幅がゼロの場合、結果が単に "data:," となることがあります。)

canvas.toBlob(callback [, type [, quality ] ])

HTMLCanvasElement/toBlob

すべての現行エンジンでサポートされています。

Firefox18+Safari11+Chrome50+
Opera?Edge79+
Edge (レガシー)非対応Internet Explorer🔰 10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

キャンバス内の画像を含むファイルを表す Blob オブジェクトを作成し、そのオブジェクトへのハンドルを持つコールバックを呼び出します。

第二引数が指定されている場合、返される画像の形式 (例: PNG や JPEG) を制御します。デフォルトは "image/png" です。指定された形式がサポートされていない場合も、この形式が使用されます。第三引数は、品質が可変な画像形式 (例: "image/jpeg") の場合に適用され、0.0 から 1.0 までの範囲で結果の画像の品質レベルを示す数値です。

canvas.transferControlToOffscreen()

HTMLCanvasElement/transferControlToOffscreen

すべての現行エンジンでサポートされています。

Firefox105+Safari16.4+Chrome69+
Opera?Edge79+
Edge (レガシー)?Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

新しく作成された OffscreenCanvas オブジェクトを返します。このオブジェクトは、canvas 要素をプレースホルダーとして使用します。いったん canvas 要素が OffscreenCanvas オブジェクトのプレースホルダーになると、その自然サイズは変更できなくなり、レンダリングコンテキストを持つことはできません。プレースホルダーキャンバスの内容は、OffscreenCanvas の 関連エージェント の イベントループ の レンダリングの更新 ステップで更新されます。

toDataURL(type, quality) メソッドは、呼び出されたとき、以下の手順を実行する必要があります：

  1. この canvas 要素のビットマップの origin-clean フラグが false に設定されている場合、"SecurityError" DOMException をスローします。

  2. このcanvas要素のビットマップにピクセルがない場合（つまり、水平方向の寸法または垂直方向の寸法のいずれかがゼロの場合）、文字列「data:,」を返します。（これは最短のdata: URLであり、text/plainリソースの空文字列を表します。）

  3. file を、この canvas 要素のビットマップのファイルとしてのシリアル化 によって取得し、type および quality が指定されていれば、それらを渡します。

  4. file が null の場合、"data:," を返します。

  5. file を表す data: URL を返します。[RFC2397]

toBlob(callback, type, quality) メソッドは、呼び出されたとき、以下の手順を実行する必要があります：

  1. この canvas 要素のビットマップの origin-clean フラグが false に設定されている場合、"SecurityError" DOMException をスローします。

  2. result を null に設定します。

  3. この canvas 要素のビットマップにピクセルがある場合 (すなわち、水平寸法も垂直寸法もゼロでない場合)、result にこの canvas 要素のビットマップのコピーを設定します。

  4. 以下の手順を並行して実行します：

    1. result が null でない場合、result を ファイルとしてのシリアル化 し、type および quality が指定されていれば、それらを使用します。

    2. 要素タスクをキューに入れ、キャンバスブロブシリアル化タスクソース に対して、canvas 要素を与え、以下の手順を実行します：

      1. result が null でない場合、result をこの canvas 要素の 関連レルム 内で作成された新しい Blob オブジェクトに設定し、result を表します。[FILEAPI]

      2. コールバック関数を呼び出し、« result » と "report" を渡します。

transferControlToOffscreen() メソッドは、呼び出されたとき、以下の手順を実行する必要があります：

  1. この canvas 要素の コンテキストモードが none に設定されていない場合は、"InvalidStateError" DOMException をスローします。

  2. offscreenCanvas を、その幅と高さがこの canvas 要素の width および height コンテンツ属性の値と等しい新しい OffscreenCanvas オブジェクトとします。

  3. offscreenCanvas の プレースホルダー canvas 要素を、この canvas 要素への弱い参照に設定します。

  4. この canvas 要素の コンテキストモードを placeholder に設定します。

  5. offscreenCanvas の 継承された言語を、この canvas 要素の 言語に設定します。

  6. offscreenCanvas の 継承された書字方向を、この canvas 要素の 書字方向に設定します。

  7. offscreenCanvas を返します。

4.12.5.1 2Dレンダリングコンテキスト

CanvasRenderingContext2D

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

CanvasImageSource

CanvasGradient

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

CanvasPattern

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

TextMetrics

すべての現行エンジンでサポートされています。

Firefox1.5+Safari4+Chrome2+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android31+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+ 
typedef (HTMLImageElement or
         SVGImageElement) HTMLOrSVGImageElement;

typedef (HTMLOrSVGImageElement or
         HTMLVideoElement or
         HTMLCanvasElement or
         ImageBitmap or
         OffscreenCanvas or
         VideoFrame) CanvasImageSource;

enum PredefinedColorSpace { "srgb", "display-p3" };

enum CanvasColorType { "unorm8", "float16" };

enum CanvasFillRule { "nonzero", "evenodd" };

dictionary CanvasRenderingContext2DSettings {
  boolean alpha = true;
  boolean desynchronized = false;
  PredefinedColorSpace colorSpace = "srgb";
  CanvasColorType colorType = "unorm8";
  boolean willReadFrequently = false;
};

enum ImageSmoothingQuality { "low", "medium", "high" };

[Exposed=Window]
interface CanvasRenderingContext2D {
  // back-reference to the canvas
  readonly attribute HTMLCanvasElement canvas;
};
CanvasRenderingContext2D includes CanvasSettings;
CanvasRenderingContext2D includes CanvasState;
CanvasRenderingContext2D includes CanvasTransform;
CanvasRenderingContext2D includes CanvasCompositing;
CanvasRenderingContext2D includes CanvasImageSmoothing;
CanvasRenderingContext2D includes CanvasFillStrokeStyles;
CanvasRenderingContext2D includes CanvasShadowStyles;
CanvasRenderingContext2D includes CanvasFilters;
CanvasRenderingContext2D includes CanvasRect;
CanvasRenderingContext2D includes CanvasDrawPath;
CanvasRenderingContext2D includes CanvasUserInterface;
CanvasRenderingContext2D includes CanvasText;
CanvasRenderingContext2D includes CanvasDrawImage;
CanvasRenderingContext2D includes CanvasImageData;
CanvasRenderingContext2D includes CanvasPathDrawingStyles;
CanvasRenderingContext2D includes CanvasTextDrawingStyles;
CanvasRenderingContext2D includes CanvasPath;

interface mixin CanvasSettings {
  // settings
  CanvasRenderingContext2DSettings getContextAttributes();
};

interface mixin CanvasState {
  // state
  undefined save(); // push state on state stack
  undefined restore(); // pop state stack and restore state
  undefined reset(); // reset the rendering context to its default state
  boolean isContextLost(); // return whether context is lost
};

interface mixin CanvasTransform {
  // transformations (default transform is the identity matrix)
  undefined scale(unrestricted double x, unrestricted double y);
  undefined rotate(unrestricted double angle);
  undefined translate(unrestricted double x, unrestricted double y);
  undefined transform(unrestricted double a, unrestricted double b, unrestricted double c, unrestricted double d, unrestricted double e, unrestricted double f);

  [NewObject] DOMMatrix getTransform();
  undefined setTransform(unrestricted double a, unrestricted double b, unrestricted double c, unrestricted double d, unrestricted double e, unrestricted double f);
  undefined setTransform(optional DOMMatrix2DInit transform = {});
  undefined resetTransform();

};

interface mixin CanvasCompositing {
  // compositing
  attribute unrestricted double globalAlpha; // (default 1.0)
  attribute DOMString globalCompositeOperation; // (default "source-over")
};

interface mixin CanvasImageSmoothing {
  // image smoothing
  attribute boolean imageSmoothingEnabled; // (default true)
  attribute ImageSmoothingQuality imageSmoothingQuality; // (default low)

};

interface mixin CanvasFillStrokeStyles {
  // colors and styles (see also the CanvasPathDrawingStyles and CanvasTextDrawingStyles interfaces)
  attribute (DOMString or CanvasGradient or CanvasPattern) strokeStyle; // (default black)
  attribute (DOMString or CanvasGradient or CanvasPattern) fillStyle; // (default black)
  CanvasGradient createLinearGradient(double x0, double y0, double x1, double y1);
  CanvasGradient createRadialGradient(double x0, double y0, double r0, double x1, double y1, double r1);
  CanvasGradient createConicGradient(double startAngle, double x, double y);
  CanvasPattern? createPattern(CanvasImageSource image, [LegacyNullToEmptyString] DOMString repetition);

};

interface mixin CanvasShadowStyles {
  // shadows
  attribute unrestricted double shadowOffsetX; // (default 0)
  attribute unrestricted double shadowOffsetY; // (default 0)
  attribute unrestricted double shadowBlur; // (default 0)
  attribute DOMString shadowColor; // (default transparent black)
};

interface mixin CanvasFilters {
  // filters
  attribute DOMString filter; // (default "none")
};

interface mixin CanvasRect {
  // rects
  undefined clearRect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h);
  undefined fillRect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h);
  undefined strokeRect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h);
};

interface mixin CanvasDrawPath {
  // path API (see also CanvasPath)
  undefined beginPath();
  undefined fill(optional CanvasFillRule fillRule = "nonzero");
  undefined fill(Path2D path, optional CanvasFillRule fillRule = "nonzero");
  undefined stroke();
  undefined stroke(Path2D path);
  undefined clip(optional CanvasFillRule fillRule = "nonzero");
  undefined clip(Path2D path, optional CanvasFillRule fillRule = "nonzero");
  boolean isPointInPath(unrestricted double x, unrestricted double y, optional CanvasFillRule fillRule = "nonzero");
  boolean isPointInPath(Path2D path, unrestricted double x, unrestricted double y, optional CanvasFillRule fillRule = "nonzero");
  boolean isPointInStroke(unrestricted double x, unrestricted double y);
  boolean isPointInStroke(Path2D path, unrestricted double x, unrestricted double y);
};

interface mixin CanvasUserInterface {
  undefined drawFocusIfNeeded(Element element);
  undefined drawFocusIfNeeded(Path2D path, Element element);
};

interface mixin CanvasText {
  // text (see also the CanvasPathDrawingStyles and CanvasTextDrawingStyles interfaces)
  undefined fillText(DOMString text, unrestricted double x, unrestricted double y, optional unrestricted double maxWidth);
  undefined strokeText(DOMString text, unrestricted double x, unrestricted double y, optional unrestricted double maxWidth);
  TextMetrics measureText(DOMString text);
};

interface mixin CanvasDrawImage {
  // drawing images
  undefined drawImage(CanvasImageSource image, unrestricted double dx, unrestricted double dy);
  undefined drawImage(CanvasImageSource image, unrestricted double dx, unrestricted double dy, unrestricted double dw, unrestricted double dh);
  undefined drawImage(CanvasImageSource image, unrestricted double sx, unrestricted double sy, unrestricted double sw, unrestricted double sh, unrestricted double dx, unrestricted double dy, unrestricted double dw, unrestricted double dh);
};

interface mixin CanvasImageData {
  // pixel manipulation
  ImageData createImageData([EnforceRange] long sw, [EnforceRange] long sh, optional ImageDataSettings settings = {});
  ImageData createImageData(ImageData imageData);
  ImageData getImageData([EnforceRange] long sx, [EnforceRange] long sy, [EnforceRange] long sw, [EnforceRange] long sh, optional ImageDataSettings settings = {});
  undefined putImageData(ImageData imageData, [EnforceRange] long dx, [EnforceRange] long dy);
  undefined putImageData(ImageData imageData, [EnforceRange] long dx, [EnforceRange] long dy, [EnforceRange] long dirtyX, [EnforceRange] long dirtyY, [EnforceRange] long dirtyWidth, [EnforceRange] long dirtyHeight);
};

enum CanvasLineCap { "butt", "round", "square" };
enum CanvasLineJoin { "round", "bevel", "miter" };
enum CanvasTextAlign { "start", "end", "left", "right", "center" };
enum CanvasTextBaseline { "top", "hanging", "middle", "alphabetic", "ideographic", "bottom" };
enum CanvasDirection { "ltr", "rtl", "inherit" };
enum CanvasFontKerning { "auto", "normal", "none" };
enum CanvasFontStretch { "ultra-condensed", "extra-condensed", "condensed", "semi-condensed", "normal", "semi-expanded", "expanded", "extra-expanded", "ultra-expanded" };
enum CanvasFontVariantCaps { "normal", "small-caps", "all-small-caps", "petite-caps", "all-petite-caps", "unicase", "titling-caps" };
enum CanvasTextRendering { "auto", "optimizeSpeed", "optimizeLegibility", "geometricPrecision" };

interface mixin CanvasPathDrawingStyles {
  // line caps/joins
  attribute unrestricted double lineWidth; // (default 1)
  attribute CanvasLineCap lineCap; // (default "butt")
  attribute CanvasLineJoin lineJoin; // (default "miter")
  attribute unrestricted double miterLimit; // (default 10)

  // dashed lines
  undefined setLineDash(sequence<unrestricted double> segments); // default empty
  sequence<unrestricted double> getLineDash();
  attribute unrestricted double lineDashOffset;
};

interface mixin CanvasTextDrawingStyles {
  // text
  attribute DOMString lang; // (default: "inherit")
  attribute DOMString font; // (default 10px sans-serif)
  attribute CanvasTextAlign textAlign; // (default: "start")
  attribute CanvasTextBaseline textBaseline; // (default: "alphabetic")
  attribute CanvasDirection direction; // (default: "inherit")
  attribute DOMString letterSpacing; // (default: "0px")
  attribute CanvasFontKerning fontKerning; // (default: "auto")
  attribute CanvasFontStretch fontStretch; // (default: "normal")
  attribute CanvasFontVariantCaps fontVariantCaps; // (default: "normal")
  attribute CanvasTextRendering textRendering; // (default: "auto")
  attribute DOMString wordSpacing; // (default: "0px")
};

interface mixin CanvasPath {
  // shared path API methods
  undefined closePath();
  undefined moveTo(unrestricted double x, unrestricted double y);
  undefined lineTo(unrestricted double x, unrestricted double y);
  undefined quadraticCurveTo(unrestricted double cpx, unrestricted double cpy, unrestricted double x, unrestricted double y);
  undefined bezierCurveTo(unrestricted double cp1x, unrestricted double cp1y, unrestricted double cp2x, unrestricted double cp2y, unrestricted double x, unrestricted double y);
  undefined arcTo(unrestricted double x1, unrestricted double y1, unrestricted double x2, unrestricted double y2, unrestricted double radius); 
  undefined rect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h);
  undefined roundRect(unrestricted double x, unrestricted double y, unrestricted double w, unrestricted double h, optional (unrestricted double or DOMPointInit or sequence<(unrestricted double or DOMPointInit)>) radii = 0);
  undefined arc(unrestricted double x, unrestricted double y, unrestricted double radius, unrestricted double startAngle, unrestricted double endAngle, optional boolean counterclockwise = false); 
  undefined ellipse(unrestricted double x, unrestricted double y, unrestricted double radiusX, unrestricted double radiusY, unrestricted double rotation, unrestricted double startAngle, unrestricted double endAngle, optional boolean counterclockwise = false); 
};

[Exposed=(Window,Worker)]
interface CanvasGradient {
  // opaque object
  undefined addColorStop(double offset, DOMString color);
};

[Exposed=(Window,Worker)]
interface CanvasPattern {
  // opaque object
  undefined setTransform(optional DOMMatrix2DInit transform = {});
};

[Exposed=(Window,Worker)]
interface TextMetrics {
  // x-direction
  readonly attribute double width; // advance width
  readonly attribute double actualBoundingBoxLeft;
  readonly attribute double actualBoundingBoxRight;

  // y-direction
  readonly attribute double fontBoundingBoxAscent;
  readonly attribute double fontBoundingBoxDescent;
  readonly attribute double actualBoundingBoxAscent;
  readonly attribute double actualBoundingBoxDescent;
  readonly attribute double emHeightAscent;
  readonly attribute double emHeightDescent;
  readonly attribute double hangingBaseline;
  readonly attribute double alphabeticBaseline;
  readonly attribute double ideographicBaseline;
};

[Exposed=(Window,Worker)]
interface Path2D {
  constructor(optional (Path2D or DOMString) path);

  undefined addPath(Path2D path, optional DOMMatrix2DInit transform = {});
};
Path2D includes CanvasPath;

既存のウェブコンテンツとの互換性を維持するために、ユーザーエージェントはCanvasUserInterfaceに定義されたメソッドをstroke()メソッドの直後にCanvasRenderingContext2Dオブジェクトに列挙する必要があります。

context = canvas.getContext('2d' [, { [ alpha: true ] [, desynchronized: false ] [, colorSpace: 'srgb'] [, willReadFrequently: false ]} ])

CanvasRenderingContext2Dオブジェクトを返し、それは特定のcanvas要素に永久にバインドされます。

もしalphaメンバーがfalseであれば、コンテキストは常に不透明になるように強制されます。

もしdesynchronizedメンバーがtrueであれば、コンテキストはdesynchronizedされる可能性があります。

colorSpaceメンバーは、レンダリングコンテキストの色空間を指定します。

colorType メンバーは、レンダリングコンテキストのカラータイプを指定します。

もしwillReadFrequentlyメンバーがtrueであれば、コンテキストは読み取り頻度の最適化のためにマークされます。

context.canvas

CanvasRenderingContext2D/canvas

すべての現行エンジンでサポートされています。

Firefox1.5+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

canvas要素を返します。

attributes = context.getContextAttributes()

次のメンバーを持つオブジェクトを返します：

CanvasRenderingContext2D の2Dレンダリングコンテキストは、原点 (0,0) が左上隅にある平坦な線形のデカルト面を表します。座標空間では、x 値は右に進むと増加し、y 値は下に進むと増加します。右端のエッジのx 座標はレンダリングコンテキストの 出力ビットマップ の幅に等しくなり、同様に、下端のエッジのy 座標はレンダリングコンテキストの 出力ビットマップ の高さに等しくなります。この計測はCSSピクセル単位で行われます。

座標空間のサイズは、ユーザーエージェントが内部で使用する実際のビットマップのサイズや、レンダリング中のサイズを必ずしも表すものではありません。例えば、高解像度のディスプレイでは、ユーザーエージェントは座標空間の1ユニットあたり4つのデバイスピクセルを持つビットマップを内部的に使用する場合があり、その結果、レンダリングが高品質に保たれます。同様に、アンチエイリアス処理は、表示される最終画像の解像度よりも高い解像度のビットマップを使用してオーバーサンプリングを行うことで実装されることがあります。

CSSピクセルを使用してレンダリングコンテキストの 出力ビットマップ のサイズを説明することは、キャンバスがレンダリングされたときにCSSピクセルで同等の領域をカバーすることを意味するものではありません。CSSピクセルは、テキストレイアウトなどのCSS機能との統合を容易にするために再利用されています。

言い換えれば、以下のcanvas要素のレンダリングコンテキストは、200x200の出力ビットマップ（内部的には統合を容易にするためにCSSピクセルを単位として使用）を持ち、100x100のCSSピクセルとしてレンダリングされます:

<canvas width=200 height=200 style=width:100px;height:100px>

2Dコンテキスト作成アルゴリズムは、target（canvas要素）およびoptionsを受け取り、以下のステップを実行します。

  1. settingsに、変換されたoptionsの辞書型であるCanvasRenderingContext2DSettingsの結果を設定します。（これは例外をスローする可能性があります）。

  2. contextに、新しいCanvasRenderingContext2Dオブジェクトを設定します。

  3. contextのcanvas属性をtargetに設定します。

  4. contextの出力ビットマップをtargetのビットマップと同じものに設定します（これにより、ビットマップが共有されます）。

  5. ビットマップの寸法を設定し、targetのwidthおよびheightコンテンツ属性の数値を取得します。

  6. context と settings を指定して、キャンバス設定出力ビットマップ初期化アルゴリズムを実行します。

  7. contextを返します。

ユーザーエージェントがビットマップの寸法をwidthおよびheightに設定する際は、次のステップを実行する必要があります:

  1. レンダリングコンテキストをデフォルトの状態にリセットします。

  2. 出力ビットマップのサイズを、新しいwidthおよびheightに変更します。

  3. canvasを、レンダリングコンテキストのcanvas属性に初期化されたcanvas要素に設定します。

  4. もしcanvasのwidthコンテンツ属性の数値がwidthと異なる場合は、canvasのwidthコンテンツ属性を、widthを有効な非負整数として表す最短の文字列に設定します。

  5. もしcanvasのheightコンテンツ属性の数値がheightと異なる場合は、canvasのheightコンテンツ属性を、heightを有効な非負整数として表す最短の文字列に設定します。

次の例では、1つの四角形のみが描画されているように見えます:

// canvas is a reference to a <canvas> element
 var context = canvas.getContext('2d');
 context.fillRect(0,0,50,50);
 canvas.setAttribute('width', '300'); // clears the canvas
 context.fillRect(0,100,50,50);
 canvas.width = canvas.width; // clears the canvas
 context.fillRect(100,0,50,50); // only this square remains

canvas属性は、オブジェクトが作成されたときに初期化された値を返さなければなりません。

PredefinedColorSpace列挙型は、キャンバスのバッキングストアのカラースペースを指定するために使用されます。

「srgb」の値は、"srgb"カラースペースを示します。

「display-p3」の値は、"display-p3"カラースペースを示します。

色空間の変換アルゴリズムは、 カラーの変換セクションに記載されています。CSS Colorの[CSSCOLOR]

CanvasColorType 列挙型は、キャンバスのバッキングストアのカラータイプを指定するために使用されます。

「unorm8」値は、すべてのカラーコンポーネントの型が 8 ビット符号なし正規化であることを示します。

「float16」値は、すべてのカラーコンポーネントの型が 16 ビット浮動小数点であることを示します。

CanvasFillRule列挙型は、点がパスの内側か外側かを判断するためのフィルルールアルゴリズムを選択するために使用されます。

「nonzero」値は非ゼロワインディングルールを示し、 ある点から引かれた半無限の直線が、ある方向に図形のパスを横切る回数と、反対方向にパスを横切る回数が等しい場合、その点は図形の外側にあると見なされます。

「evenodd」の値は、even-odd ruleを示します。このルールでは、ある点が形のパスを交差する回数が偶数の場合、その点は形の外側と見なされます。

点が形の外側でない場合、それは形の内側にあります。

ImageSmoothingQuality列挙型は、画像のスムージング時に使用する補間品質に対する好みを表現するために使用されます。

「low」の値は、低いレベルの画像補間品質を好むことを示します。低品質の画像補間は、より高い設定よりも計算効率が良い場合があります。

「medium」の値は、中程度のレベルの画像補間品質を好むことを示します。

「high」の値は、高いレベルの画像補間品質を好むことを示します。高品質の画像補間は、低い設定よりも計算コストが高くなる場合があります。

バイリニアスケーリングは、比較的高速な低品質の画像スムージングアルゴリズムの一例です。バイキュービックまたはランチョススケーリングは、より高品質の出力を生成する画像スムージングアルゴリズムの一例です。この仕様では、特定の補間アルゴリズムを使用することを義務付けていません。

4.12.5.1.1 Implementation notes

このセクションは規範的ではありません。

出力ビットマップがユーザーエージェントによって直接表示されない場合、実装はこのビットマップを更新する代わりに、このビットマップの実際のデータが必要になるまで（例えば、drawImage()やcreateImageBitmap()ファクトリメソッドの呼び出しなど）、それに適用された描画操作のシーケンスを記憶するだけで済ませることができます。多くの場合、これによりメモリ効率が向上します。

canvas要素のビットマップは、実際にはほとんど常に必要とされるビットマップです。レンダリングコンテキストがビットマップを持つ場合、その出力ビットマップは常にcanvas要素のビットマップのエイリアスに過ぎません。

追加のビットマップが必要になることがあります。例えば、キャンバスがその自然サイズとは異なるサイズで描画される場合に高速描画を可能にするため、またはキャンバス描画コマンドが実行されている間にページスクロールなどのグラフィックス更新を並行処理できるようにダブルバッファリングを可能にするためなどです。

4.12.5.1.2 キャンバス設定

CanvasSettings オブジェクトには、オブジェクトの作成時に初期化される 出力ビットマップがあります。

出力ビットマップには、true または false に設定できる オリジンクリーンフラグがあります。 最初に、これらのビットマップのいずれかが作成されると、その オリジンクリーンフラグは true に設定されなければなりません。

CanvasSettings オブジェクトには、アルファブール値もあります。CanvasSettings オブジェクトの アルファが false の場合、そのアルファコンポーネントはすべてのピクセルに対して 1.0 (完全に不透明) に固定されなければならず、任意のピクセルのアルファコンポーネントを変更しようとする試みはサイレントに無視されなければなりません。

したがって、そのようなコンテキストのビットマップは、透明な黒ではなく不透明な黒として開始されます。clearRect() は常に不透明な黒のピクセルになり、getImageData() からの 4 番目のバイトは常に 255 であり、putImageData() メソッドは、入力の 4 番目のバイトを効果的に無視します。ただし、キャンバスに描画されるスタイルと画像のアルファコンポーネントは、出力ビットマップのアルファコンポーネントに影響を与える時点まで尊重されます。たとえば、アルファが false に設定された新しく作成された出力ビットマップに 50% 透明な白い四角形を描画すると、完全に不透明な灰色の四角形になります。

CanvasSettings オブジェクトには、非同期化ブール値もあります。CanvasSettings オブジェクトの 非同期化が true の場合、ユーザーエージェントは、イベントループからキャンバスのペイントサイクルを非同期化したり、通常のユーザーエージェントレンダリングアルゴリズムをバイパスしたり、あるいはその両方を行うことによって、入力イベントからラスタライズまでのレイテンシを削減するためにキャンバスのレンダリングを最適化する場合があります。このモードが通常のペイントメカニズム、ラスタライズ、またはその両方をバイパスすることを含む限り、表示可能なティアリングアーティファクトが発生する可能性があります。

ユーザーエージェントは通常、表示されていないバッファにレンダリングし、それを表示用にスキャンアウトされているバッファとすばやく交換します。前者のバッファはバックバッファと呼ばれ、後者はフロントバッファと呼ばれます。レイテンシを削減するための一般的な手法は、フロントバッファレンダリングと呼ばれ、シングルバッファレンダリングとも呼ばれます。この手法では、レンダリングはスキャンアウトプロセスと並行して競合的に行われます。この手法は、ティアリングアーティファクトが発生する可能性を犠牲にしてレイテンシを削減し、非同期化ブール値の全部または一部を実装するために使用できます。 [MULTIPLEBUFFERING]

非同期化ブール値は、入力とラスタライズ間のレイテンシが重要な描画アプリケーションなど、特定の種類のアプリケーションを実装する場合に役立ちます。

CanvasSettings オブジェクトには、頻繁に読み取るブール値もあります。CanvasSettings オブジェクトの 頻繁に読み取るが true の場合、ユーザーエージェントは読み取り操作のためにキャンバスを最適化する場合があります。

ほとんどのデバイスでは、ユーザーエージェントはキャンバスの出力ビットマップを GPU (これは「ハードウェアアクセラレーション」とも呼ばれます) に保存するか、CPU (「ソフトウェア」とも呼ばれます) に保存するかを決定する必要があります。ほとんどのレンダリング操作はアクセラレーションされたキャンバスの方がパフォーマンスが高くなりますが、主な例外は getImageData()、toDataURL()、または toBlob() を使用した読み取りです。頻繁に読み取るが true に等しい CanvasSettings オブジェクトは、Web ページが多くの読み取り操作を実行する可能性が高く、ソフトウェアキャンバスを使用することが有利であることをユーザーエージェントに伝えます。

CanvasSettings オブジェクトには、PredefinedColorSpace 型の 色空間設定もあります。CanvasSettings オブジェクトの 色空間は、出力ビットマップの色空間を示します。

CanvasSettings オブジェクトには、CanvasColorType 型の カラータイプ設定もあります。CanvasSettings オブジェクトの カラータイプは、出力ビットマップのピクセルの色とアルファコンポーネントのデータ型を示します。

CanvasSettings context と CanvasRenderingContext2DSettings settings を指定して、CanvasSettings 出力ビットマップを初期化するには：

  1. context の アルファを settings["alpha"] に設定します。

  2. context の 非同期化を settings["desynchronized"] に設定します。

  3. context の 色空間を settings["colorSpace"] に設定します。

  4. context の カラータイプを settings["colorType"] に設定します。

  5. context の 頻繁に読み取るを settings["willReadFrequently"] に設定します。

getContextAttributes() メソッドのステップは、「[ "alpha" → this の アルファ, "desynchronized" → this の 非同期化, "colorSpace" → this の 色空間, "colorType" → this の カラータイプ, "willReadFrequently" → this の 頻繁に読み取る ]」を返すことです。

4.12.5.1.3 キャンバスの状態

CanvasStateインターフェースを実装するオブジェクトは、描画状態のスタックを管理します。描画状態は以下を含みます：

レンダリングコンテキストのビットマップは描画状態の一部ではありません。これは、レンダリングコンテキストがcanvas要素にどのようにバインドされているかに依存するためです。

CanvasStateミックスインを実装するオブジェクトには、作成時にfalseに初期化されるコンテキストが失われたというブール値があります。このコンテキストが失われた値は、コンテキストが失われたステップで更新されます。

context.save()

CanvasRenderingContext2D/save

現在のすべてのエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の状態をスタックにプッシュします。

context.restore()

CanvasRenderingContext2D/restore

現在のすべてのエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

スタック上の上部状態をポップし、その状態にコンテキストを復元します。

context.reset()

描画状態スタック、パス、スタイルなど、バッキングバッファを含むレンダリングコンテキストをリセットします。

context.isContextLost()

レンダリングコンテキストが失われたかどうかをtrueで返します。ドライバのクラッシュやメモリ不足などによりコンテキストが失われることがあります。このような場合、キャンバスはバッキングストレージを失い、レンダリングコンテキストをデフォルトの状態にリセットする手順を実行します。

save()メソッドの手順は、現在の描画状態のコピーを描画状態スタックにプッシュすることです。

restore()メソッドの手順は、描画状態スタックの上部エントリをポップし、それが示す描画状態にリセットすることです。保存された状態がない場合、このメソッドは何もしません。

CanvasRenderingContext2D/reset

Firefox113+SafariNoChrome99+
Opera?Edge99+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

OffscreenCanvasRenderingContext2D#canvasrenderingcontext2d.reset

Firefox113+SafariNoChrome99+
Opera?Edge99+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

reset()メソッドの手順は、レンダリングコンテキストをデフォルトの状態にリセットすることです。

レンダリングコンテキストをデフォルトの状態にリセットするには：

  1. キャンバスのビットマップを透明な黒にクリアします。

  2. コンテキストの現在のデフォルトパスのサブパスリストを空にします。

  3. コンテキストの描画状態スタックをクリアします。

  4. 描画状態が構成するすべてを初期値にリセットします。

CanvasRenderingContext2D/isContextLost

1つのエンジンのみでサポートされています。

FirefoxNoSafariNoChrome99+
Opera?Edge99+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

isContextLost()メソッドの手順は、thisのコンテキストが失われた状態を返すことです。

4.12.5.1.4 線のスタイル
context.lineWidth [ = value ]

CanvasRenderingContext2D/lineWidth

現在のすべてのエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
styles.lineWidth [ = value ]

現在の線の太さを返します。

設定すると、線の太さが変更されます。有限値より大きくない値は無視されます。

context.lineCap [ = value ]

CanvasRenderingContext2D/lineCap

現在のすべてのエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
styles.lineCap [ = value ]

現在の線の端点スタイルを返します。

設定すると、線の端点スタイルが変更されます。

使用可能な線の端点スタイルは "butt"、"round"、および "square" です。他の値は無視されます。

context.lineJoin [ = value ]

CanvasRenderingContext2D/lineJoin

現在のすべてのエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
styles.lineJoin [ = value ]

現在の線の接続スタイルを返します。

設定すると、線の接続スタイルが変更されます。

使用可能な線の接続スタイルは "bevel"、"round"、および "miter" です。他の値は無視されます。

context.miterLimit [ = value ]

CanvasRenderingContext2D/miterLimit

現在のすべてのエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
styles.miterLimit [ = value ]

現在のマイターリミット比を返します。

設定すると、マイターリミット比が変更されます。有限値より大きくない値は無視されます。

context.setLineDash(segments)

CanvasRenderingContext2D/setLineDash

現在のすべてのエンジンでサポートされています。

Firefox27+Safari7+Chrome23+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
styles.setLineDash(segments)

現在の線の破線パターン（ストロークに使用される）を設定します。引数は、線をオンにしてオフにする距離のリストです。

segments = context.getLineDash()

CanvasRenderingContext2D/getLineDash

現在のすべてのエンジンでサポートされています。

Firefox27+Safari7+Chrome23+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
segments = styles.getLineDash()

現在の線の破線パターンのコピーを返します。返される配列には、常に偶数のエントリがあります（つまり、パターンは正規化されます）。

context.lineDashOffset

CanvasRenderingContext2D/lineDashOffset

現在のすべてのエンジンでサポートされています。

Firefox27+Safari7+Chrome23+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
styles.lineDashOffset

（線の破線パターンと同じ単位での）位相オフセットを返します。

設定すると、位相オフセットが変更されます。有限値でない値は無視されます。

CanvasPathDrawingStyles インターフェースを実装するオブジェクトには、このセクションで定義された属性やメソッドがあり、オブジェクトによって線がどのように扱われるかを制御します。

lineWidth 属性は、線の幅を座標空間単位で指定します。取得時には現在の値を返さなければなりません。設定時には、ゼロ、負の値、無限、NaN の値は無視され、値は変更されません。その他の値は現在の値を新しい値に変更しなければなりません。

CanvasPathDrawingStyles インターフェースを実装するオブジェクトが作成されると、 lineWidth 属性は初期値 1.0 を持たなければなりません。

lineCap 属性は、ユーザーエージェントが線の終端に置くエンドポイントのタイプを定義します。 有効な3つの値は "butt"、"round"、および "square" です。

取得時には現在の値を返さなければなりません。設定時には現在の値を新しい値に変更しなければなりません。

CanvasPathDrawingStyles インターフェースを実装するオブジェクトが作成されると、 lineCap 属性は初期値 "butt" を持たなければなりません。

lineJoin 属性は、2つの線が交わる場所にユーザーエージェントが配置するコーナーのタイプを定義します。 有効な3つの値は "bevel"、"round"、および "miter" です。

取得時には現在の値を返さなければなりません。設定時には現在の値を新しい値に変更しなければなりません。

CanvasPathDrawingStyles インターフェースを実装するオブジェクトが作成されると、 lineJoin 属性は初期値 "miter" を持たなければなりません。

lineJoin 属性が "miter" の値を持つ場合、ストロークはマイターリミット比を使用してジョインの描画方法を決定します。 マイターリミット比は、miterLimit 属性を使用して明示的に設定できます。取得時には現在の値を返さなければなりません。設定時には、ゼロ、負の値、無限、NaN の値は無視され、値は変更されません。その他の値は現在の値を新しい値に変更しなければなりません。

CanvasPathDrawingStyles インターフェースを実装するオブジェクトが作成されると、 miterLimit 属性は初期値 10.0 を持たなければなりません。

各 CanvasPathDrawingStyles オブジェクトには ダッシュリスト があり、それは空であるか、正の数の偶数個の数字で構成されるものです。最初は ダッシュリスト が空でなければなりません。

setLineDash(segments) メソッドが呼び出されると、次の手順を実行しなければなりません:

  1. segments 内のいずれかの値が有限でない場合 (例えば無限や NaN 値) 、または値が負である場合 (0 未満の場合) 、終了しなければなりません（例外をスローせずに；デベロッパーコンソールにメッセージを表示することはデバッグに役立つため推奨されます）。

  2. segments の要素数が奇数の場合、segments を segments の2つのコピーで連結しなければなりません。

  3. オブジェクトの ダッシュリスト を segments に設定しなければなりません。

getLineDash() メソッドが呼び出されると、オブジェクトの ダッシュリスト の値を同じ順序で含む配列を返さなければなりません。

ダッシュパターンの「フェーズ」を変更することは、時々便利です。例えば、「行進するアリ」のような効果を達成するために。フェーズは、lineDashOffset 属性を使用して設定できます。取得時には現在の値を返さなければなりません。設定時には、無限および NaN 値は無視され、値は変更されません。その他の値は現在の値を新しい値に変更しなければなりません。

CanvasPathDrawingStyles インターフェースを実装するオブジェクトが作成されると、lineDashOffset 属性は初期値 0.0 を持たなければなりません。

ユーザーエージェントがパスをトレースする場合、CanvasPathDrawingStyles インターフェースを実装するオブジェクト style が与えられた場合、次のアルゴリズムを実行しなければなりません。このアルゴリズムは、新しい パス を返します。

  1. トレースされるパスのコピーをpath とします。

  2. path からすべてのゼロ長の 線分 を除去します。

  3. path から線を含まないすべてのサブパス（つまり、1つの点のみを持つサブパス）を削除します。

  4. path の各サブパスの最初の点と最後の点以外の各点を、それぞれの点から出ている線と、出ている線を結ぶ ジョイン に置き換えます。サブパスはすべて2つの点（それぞれ出発点と終点）と、それぞれの点を結ぶ線（またはジョイン）で構成されており、サブパスは一連の線とジョインで結ばれています。

  5. サブパスの最後の点と最初の点を結ぶ直線を追加し、最後の点をジョインに変更します（追加された閉じる線から出発する線に接続）。最初の点もジョインに変更します（追加された閉じる線と最初の線を結ぶジョインとして）。

  6. style の ダッシュリスト が空の場合、変換 というラベルが付いたステップにジャンプします。

  7. pattern width をstyle の ダッシュリスト のすべてのエントリの連結とします（座標空間単位で）。

  8. path の各サブパス subpath に対して、次のサブステップを実行します。これらのサブステップは path のサブパスを インビボ で変異させます。

    1. subpath width を、subpath のすべての線の長さとします（座標空間単位で）。

    2. offset をstyle の lineDashOffset の値とします（座標空間単位で）。

    3. offset が pattern width を超える場合、pattern width を減算します。

    4. offset が 0 未満の場合、pattern width を加算します。

    5. すべての線を含む subpath に沿った線形座標線 L を定義し、サブパスの最初の線の開始点を座標 0、サブパスの最後の線の終了点を subpath width として定義します。

    6. position を 0 からoffset 減じた値とします。

    7. index を 0 とします。

    8. current state を オフ （他の状態はオンとゼロオン）とします。

    9. ダッシュオン: segment length を style の ダッシュリスト の index 番目のエントリとします。

    10. position を segment length だけ増やします。

    11. position が subpath width を超える場合、このサブパスに対するサブステップを終了し、次のサブパスに対して再度開始します。サブパスがない場合、変換 というラベルが付いたステップにジャンプします。

    12. segment length がゼロでない場合、current state を オン にします。

    13. index を 1 増やします。

    14. ダッシュオフ: segment length を style の ダッシュリスト の index 番目のエントリとします。

    15. start を L 上の position のオフセットとします。

    16. position を segment length だけ増やします。

    17. position が 0 未満の場合、ポストカット というラベルが付いたステップにジャンプします。

    18. start が 0 未満の場合、start を 0 とします。

    19. position が subpath width を超える場合、end を L 上の subpath width のオフセットとします。それ以外の場合、end を L 上の position のオフセットとします。

    20. 次の適切なステップにジャンプします:

      segment length がゼロで current state が オフ の場合

      何もしません。そのまま次のステップに進みます。

      current state が オフ の場合

      end のある線を end で短く切り、そこで点を配置し、元のサブパスを2つに分割します。 start と end の間のすべての線分、ジョイン、点、およびサブパスを削除します。そして、最終的に start に単一の点を配置し、その点に接続する線はありません。

      その点は線の端点の描画に関して 方向性 を持っています（上記の L の定義時に）。

      その他の場合

      start のある線を2つに分割し、そこに点を配置します。元のサブパスを2つに分割し、同様に end のある線を end で短く切り、そこで点を配置します。元のサブパスを2つに分割し、そして start と end の間のすべての線分、ジョイン、点、およびサブパスを削除します。

      start と end が同じ点である場合、これにより線が2つに分割され、その点に2つの点が挿入されるだけで、何も削除されません。ただし、その点にジョインもある場合は、ジョインが削除されなければなりません。

    21. ポストカット: position が subpath width を超える場合、変換 というラベルが付いたステップにジャンプします。

    22. index を 1 増やします。 style の ダッシュリスト のエントリ数と等しい場合、index を 0 に設定します。

    23. ダッシュオン というラベルが付いたステップに戻ります。

  9. 変換: これは、パスを新しいパスに変換するステップです。

    新しい パス を作成します。これは path の各サブパスに沿って、style の lineWidth に等しい長さの直線が掃引され、その線がパスに対して直角に保たれるようにし、各点を満たすために必要なエンドキャップを追加し、各ジョインを満たすために必要なジョインを追加したパスを記述します。

    キャップ: 各点には、その点から出る線の方向に直角の平らな縁があります。これに style の lineCap の値に従って、さらに追加されます。 "butt" の値は、追加のラインキャップが追加されないことを意味します。 "round" の値は、 style の lineWidth の幅に等しい直径の半円を点から出る線に追加する必要があることを意味します。 "square" の値は、 style の lineWidth の幅の長さと、幅の半分の style の lineWidth 幅の長方形を追加する必要があり、それが点から出る線に直角に接するように配置されます。

    線が出ていない点には、その点が本当に2つの点で、点の方向性に向かって無限に短い直線で接続されているかのように、2つのキャップが背中合わせに配置されなければなりません。

    ジョイン: ジョインが発生する点に加えて、ジョインに関連する2つの追加の点があり、各線に1つずつあります。これらは、ジョイン点から各線に直角に、各線から最も遠い側にある2つの角です。

    この2つの角を直線で結び、三角形の第3の点をジョイン点とし、すべてのジョインでこの三角形を追加しなければなりません。 lineJoin 属性は、ジョインで他に何がレンダリングされるかを制御します。これらの3つの値は次の意味を持ちます:

    "bevel" の値は、ジョインでこれだけがレンダリングされることを意味します。

    "round" の値は、ジョインの2つの角を結ぶ弧を追加し、その弧は前述の三角形に接するものであり、直径が線の幅に等しく、ジョイン点を中心とするものでなければならないことを意味します。

    "miter" の値は、ジョインで2番目の三角形を（可能であれば）追加しなければならないことを意味します。この三角形の1つの辺は2つの角を結ぶ線であり、最初の三角形に接し、他の2つの辺は接続している2本の線の外側の縁を延長したものであり、必要に応じてミーターの長さを超えないようにする必要があります。

    ミーターの長さは、ジョインが発生する点からジョインの外側の線の縁の交点までの距離です。マイターリミット比は、ミーターの長さと線の幅の半分の比率の最大許容値です。ミーターの長さが style の miterLimit 属性によって設定されたマイターリミット比を超える場合、この2番目の三角形は追加されないようにしなければなりません。

    新しく作成されたパス内のサブパスは、任意の点に対して、その点から引かれる半無限直線がサブパスを交差する回数が偶数であり、その点から引かれる半無限直線がサブパスを一方向に交差する回数が他の方向に交差する回数と等しい場合に限り、そのサブパスの交差回数が偶数であるように配置しなければなりません。

  10. 新しく作成されたパスを返します。

4.12.5.1.5 テキストスタイル
context.lang [ = value ]
styles.lang [ = value ]

現在の言語設定を返します。

BCP 47 言語タグ、空の文字列、または「inherit」に設定して、フォントを解決するときに使用される言語を変更できます。「inherit」は、canvas 要素の言語、または canvas 要素がない場合は関連付けられた ドキュメント要素から言語を取得します。

デフォルトは「inherit」です。

context.font [ = value ]

CanvasRenderingContext2D/font

すべての現行エンジンでサポートされています。

Firefox3.5+ Safari4+ Chrome2+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android12.1+
styles.font [ = value ]

現在のフォント設定を返します。

フォントを変更するために設定できます。構文は CSS 'font' プロパティと同じです。CSS フォント値として解析できない値は無視されます。デフォルトは「10px sans-serif」です。

相対的なキーワードと長さは、canvas 要素のフォントを基準に計算されます。

context.textAlign [ = value ]

CanvasRenderingContext2D/textAlign

すべての現行エンジンでサポートされています。

Firefox3.5+ Safari4+ Chrome2+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android12.1+
styles.textAlign [ = value ]

現在のテキスト整列設定を返します。

設定すると、整列が変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「start」です。

context.textBaseline [ = value ]

CanvasRenderingContext2D/textBaseline

すべての現行エンジンでサポートされています。

Firefox3.5+ Safari4+ Chrome2+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android12.1+
styles.textBaseline [ = value ]

現在のベースライン整列設定を返します。

設定すると、ベースライン整列が変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「alphabetic」です。

context.direction [ = value ]

CanvasRenderingContext2D/direction

すべての現行エンジンでサポートされています。

Firefox101+ Safari9+ Chrome77+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?
styles.direction [ = value ]

現在の方向性を返します。

設定すると、方向性が変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「inherit」です。

context.letterSpacing [ = value ]
styles.letterSpacing [ = value ]

現在の文字間隔を返します。

設定すると、文字間隔が変更されます。CSS の <length> として解析できない値は無視されます。デフォルトは「0px」です。

context.fontKerning [ = value ]
styles.fontKerning [ = value ]

現在のフォントカーニング設定を返します。

設定すると、フォントカーニングが変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「auto」です。

context.fontStretch [ = value ]
styles.fontStretch [ = value ]

現在のフォントストレッチ設定を返します。

設定すると、フォントストレッチが変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「normal」です。

context.fontVariantCaps [ = value ]
styles.fontVariantCaps [ = value ]

現在のフォントバリアントキャップス設定を返します。

設定すると、フォントバリアントキャップスが変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「normal」です。

context.textRendering [ = value ]
styles.textRendering [ = value ]

現在のテキストレンダリング設定を返します。

設定すると、テキストレンダリングが変更されます。可能な値とその意味は以下に示されています。他の値は無視されます。デフォルトは「auto」です。

context.wordSpacing [ = value ]
styles.wordSpacing [ = value ]

現在の単語間隔を返します。

設定すると、単語間隔が変更されます。CSS の <length> として解析できない値は無視されます。デフォルトは「0px」です。

CanvasTextDrawingStyles インターフェースを実装するオブジェクトには、オブジェクトがテキストをどのようにレイアウトするか（ラスタライズまたはアウトライン化）を制御する属性（このセクションで定義されています）が備わっています。これらのオブジェクトには、フォントスタイルソースオブジェクトも持つことができます。CanvasRenderingContext2Dオブジェクトの場合、これはコンテキストのcanvas要素であり、コンテキストのcanvas属性の値によって指定されます。OffscreenCanvasRenderingContext2Dオブジェクトの場合、これは関連するOffscreenCanvasオブジェクトです。

フォントスタイルソースオブジェクトのフォント解像度には、フォントソースが必要です。これは、CanvasTextDrawingStylesを実装する特定のobjectに対して、次のステップで決定されます：[CSSFONTLOAD]

  1. objectのフォントスタイルソースオブジェクトがcanvas要素である場合、その要素のノードドキュメントを返します。

  2. それ以外の場合、objectのフォントスタイルソースオブジェクトはOffscreenCanvasオブジェクトです:

    1. globalをobjectの関連するグローバルオブジェクトに設定します。

    2. globalがWindowオブジェクトである場合、globalの関連するDocumentを返します。

    3. アサート: globalがWorkerGlobalScopeを実装していることを確認します。

    4. globalを返します。

これは、ID c1 を持つ通常の canvas 要素を使用したフォント解像度の例です。 

const font = new FontFace("MyCanvasFont", "url(mycanvasfont.ttf)");
 documents.fonts.add(font);

 const context = document.getElementById("c1").getContext("2d");
 document.fonts.ready.then(function() {
   context.font = "64px MyCanvasFont";
   context.fillText("hello", 0, 0);
 });

この例では、canvas はフォントとして mycanvasfont.ttf を使用してテキストを表示します。

これは、OffscreenCanvasを使用してフォント解像度がどのように行われるかの例です。 ID canvas 要素があり、 これを以下のようにワーカーに転送することを前提としています:

const offscreenCanvas = document.getElementById("c2").transferControlToOffscreen();
 worker.postMessage(offscreenCanvas, [offscreenCanvas]);

次に、ワーカー内で:

self.onmessage = function(ev) {
   const transferredCanvas = ev.data;
   const context = transferredCanvas.getContext("2d");
   const font = new FontFace("MyFont", "url(myfont.ttf)");
   self.fonts.add(font);
   self.fonts.ready.then(function() {
     context.font = "64px MyFont";
     context.fillText("hello", 0, 0);
   });
 };

この例では、canvas は myfont.ttf を使用してテキストを表示します。 フォントはドキュメントのコンテキストではなく、ワーカー内でのみロードされる点に注意してください。

font IDL 属性は、設定時にCSS <'font'> 値として解析 されなければならず（ただし、「inherit」のようなプロパティに依存しないスタイルシート構文はサポートしません）、その結果として得られるフォントはコンテキストに割り当てられ、'line-height' のコンポーネントは「normal」に強制され、 'font-size' のコンポーネントはCSS ピクセルに変換され、システムフォントは明示的な値に計算されます。新しい値が文法的に誤っている場合（「inherit」や「initial」のようなプロパティに依存しないスタイルシート構文を使用している場合を含む）、新しいフォント値を割り当てることなく無視しなければなりません。[CSS]

フォントファミリ名は、フォントが使用されるときにフォントスタイルソースオブジェクトのコンテキストで解釈される必要があります。そのため、@font-faceを使用して埋め込まれたフォントや、 フォントスタイルソースオブジェクト に表示されるFontFaceオブジェクトを使用してロードされたフォントは、ロードされると利用可能でなければなりません。（各フォントスタイルソースオブジェクトには、利用可能なフォントを決定するフォントソースがあります。）フォントが完全にロードされる前に使用された場合、またはそのフォントが使用される時点でフォントスタイルソースオブジェクトに範囲内にない場合は、それが未知のフォントとして扱われ、関連するCSS仕様書で説明されているように他のフォントにフォールバックしなければなりません。[CSSFONTS] [CSSFONTLOAD]

取得時には、font 属性は、コンテキストの現在のフォントのシリアライズされた形式 を返さなければなりません（'line-height' コンポーネントは含みません）。[CSSOM]

たとえば、次の文の後:

context.font = 'italic 400 12px/2 Unknown Font, sans-serif';

...この式 context.font は文字列 "italic 12px "Unknown Font", sans-serif" に評価されます。"400" フォントウェイトはデフォルト値であるため表示されません。行の高さは「normal」（デフォルト値）に強制されるため表示されません。

CanvasTextDrawingStyles インターフェイスを実装するオブジェクトが作成されたとき、コンテキストのフォントは10pxのsans-serifに設定されなければなりません。'font-size'コンポーネントがパーセンテージ、'em'または'ex'単位、または「larger」や「smaller」のキーワードを使用して長さが設定された場合、これらは計算値 に対して解釈される必要があります。 'font-size'プロパティの属性が設定された時点でのフォントスタイルソースオブジェクトの計算値が未定義の場合（例えば、フォントスタイルソースオブジェクトが 要素ではないか、レンダリングされていないため）、相対的なキーワードは10pxのsans-serifのデフォルトに対して解釈されなければなりません。

textAlign IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、textAlign属性は初期値としてstartの値を持たなければなりません。

textBaseline IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、textBaseline属性は初期値としてalphabeticの値を持たなければなりません。

CanvasTextDrawingStyles インターフェイスを実装するオブジェクトには、フォントレンダリングをローカライズするために使用される関連付けられた 言語値があります。有効な値は、BCP 47 言語タグ、空の文字列、または「inherit」です。ここで、言語は canvas 要素の言語、または canvas 要素がない場合は関連付けられた ドキュメント要素から取得されます。初期状態では、言語は「inherit」でなければなりません。

lang ゲッターのステップは、this の 言語を返すことです。

lang セッターのステップは、this の 言語を指定された値に設定することです。

direction IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、direction属性は初期値として"inherit"の値を持たなければなりません。

CanvasTextDrawingStylesインターフェイスを実装するオブジェクトには、文字と単語の間隔を制御する属性があります。このようなオブジェクトには、関連付けられた文字間隔および単語間隔の値があり、これらはCSSの<length>値です。初期値として、両方ともCSSの"0px"を解析した結果でなければなりません。

CanvasRenderingContext2D/letterSpacing

1つのエンジンでのみサポートされています。

FirefoxサポートなしSafariサポートなしChrome99+
Opera不明Edge99+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

letterSpacing ゲッターのステップは、this の レタースペーシングの直列化された形式を返すことです。

letterSpacingのsetterステップは以下の通りです:

  1. 指定された値をCSSの解析結果として、parsedにします。

  2. parsedが失敗の場合は、返します。

  3. thisの文字間隔をparsedに設定します。

CanvasRenderingContext2D/wordSpacing

1つのエンジンでのみサポートされています。

FirefoxサポートなしSafariサポートなしChrome99+
Opera不明Edge99+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

wordSpacing ゲッターのステップは、this の 単語間隔の直列化された形式を返すことです。

wordSpacingのsetterステップは以下の通りです:

  1. 指定された値をCSSの解析結果として、parsedにします。

  2. parsedが失敗の場合は、返します。

  3. thisの単語間隔をparsedに設定します。

CanvasRenderingContext2D/fontKerning

Firefox104+SafariサポートなしChrome99+
Opera不明Edge99+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

fontKerning IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、fontKerning属性は初期値として"auto"の値を持たなければなりません。

CanvasRenderingContext2D/fontStretch

1つのエンジンでのみサポートされています。

FirefoxサポートなしSafariサポートなしChrome99+
Opera不明Edge99+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

fontStretch IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、fontStretch属性は初期値として"normal"の値を持たなければなりません。

CanvasRenderingContext2D/fontVariantCaps

1つのエンジンでのみサポートされています。

FirefoxサポートなしSafariサポートなしChrome99+
Opera不明Edge99+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

fontVariantCaps IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、fontVariantCaps属性は初期値として"normal"の値を持たなければなりません。

CanvasRenderingContext2D/textRendering

1つのエンジンでのみサポートされています。

FirefoxサポートなしSafariサポートなしChrome99+
Opera不明Edge99+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

textRendering IDL 属性は、取得時に現在の値を返さなければなりません。設定時には、現在の値を新しい値に変更しなければなりません。CanvasTextDrawingStylesインターフェイスを実装するオブジェクトが作成されるとき、textRendering属性は初期値として"auto"の値を持たなければなりません。

textAlign属性で許可されるキーワードは以下の通りです:

start

テキストの開始端に揃えます（左から右のテキストでは左側、右から左のテキストでは右側）。

end

テキストの終了端に揃えます（左から右のテキストでは右側、右から左のテキストでは左側）。

left

左揃えにします。

right

右揃えにします。

center

中央揃えにします。

textBaseline属性で許可されるキーワードは、フォント内の整列ポイントに対応しています:

em-over ベースラインはフォント内のグリフのほぼ上部にあり、ハンギングベースラインは आ のような一部のグリフが固定される場所であり、ミドルは em-over と em-under ベースラインの中間にあり、アルファベットベースラインは Á、ÿ、f、Ω のような文字が固定される場所であり、表意文字アンダーベースラインは 私 や 達 のようなグリフが固定される場所であり、em-under ベースラインはフォント内のグリフのほぼ下部にあります。バウンディングボックスの上部と下部は、em-over および em-under ベースラインをはるかに超えて拡張するグリフのために、これらのベースラインから遠く離れている可能性があります。

キーワードは次のようにこれらの整列ポイントに対応します:

top
em-over ベースライン
hanging
ハンギングベースライン
middle
em-over ベースラインと em-under ベースラインの中間
alphabetic
アルファベットベースライン
ideographic
表意文字アンダーベースライン
bottom
em-under ベースライン

direction属性で許可されるキーワードは以下の通りです:

ltr

テキスト準備アルゴリズムへの入力を左から右のテキストとして扱います。

rtl

テキスト準備アルゴリズムへの入力を右から左のテキストとして扱います。

inherit

テキスト準備アルゴリズムのプロセスを使用して、canvas 要素、プレースホルダー canvas 要素、またはドキュメント要素からテキストの書字方向を取得します。

fontKerning属性で許可されるキーワードは以下の通りです:

auto

カーニングはユーザーエージェントの裁量で適用されます。

normal

カーニングが適用されます。

none

カーニングは適用されません。

fontStretch属性で許可されるキーワードは以下の通りです:

ultra-condensed

CSSの'font-stretch'設定である'ultra-condensed'と同じです。

extra-condensed

CSSの'font-stretch'設定である'extra-condensed'と同じです。

condensed

CSSの'font-stretch'設定である'condensed'と同じです。

semi-condensed

CSSの'font-stretch'設定である'semi-condensed'と同じです。

normal

デフォルトの設定で、グリフの幅は100%になります。

semi-expanded

CSSの'font-stretch'設定である'semi-expanded'と同じです。

expanded

CSSの'font-stretch'設定である'expanded'と同じです。

extra-expanded

CSSの'font-stretch'設定である'extra-expanded'と同じです。

ultra-expanded

CSSの'font-stretch'設定である'ultra-expanded'と同じです。

fontVariantCaps属性で許可されるキーワードは以下の通りです:

normal

以下に挙げる機能は有効化されません。

small-caps

CSSの'font-variant-caps'設定である'small-caps'と同じです。

all-small-caps

CSSの'font-variant-caps'設定である'all-small-caps'と同じです。

petite-caps

CSSの'font-variant-caps'設定である'petite-caps'と同じです。

all-petite-caps

CSSの'font-variant-caps'設定である'all-petite-caps'と同じです。

unicase

CSSの'font-variant-caps'設定である'unicase'と同じです。

titling-caps

CSSの'font-variant-caps'設定である'titling-caps'と同じです。

textRendering属性で許可されるキーワードは以下の通りです:

auto

SVGのテキストレンダリングプロパティにおける「auto」と同じです。

optimizeSpeed

SVGのテキストレンダリングプロパティにおける「optimizeSpeed」と同じです。

optimizeLegibility

SVGのテキストレンダリングプロパティにおける「optimizeLegibility」と同じです。

geometricPrecision

SVGのテキストレンダリングプロパティにおける「geometricPrecision」と同じです。

テキスト準備アルゴリズムは次の通りです。文字列text、CanvasTextDrawingStylesオブジェクトtarget、および任意の長さmaxWidthを入力として受け取り、グリフ形状の配列を共通の座標空間に配置し、left、right、centerのいずれかの値を持つphysical alignment、およびインラインボックスを返します。（このアルゴリズムを呼び出すほとんどのコール元は、physical alignmentとインラインボックスを無視します。）

  1. maxWidthが指定されており、0以下またはNaNである場合、空の配列を返します。

  2. text内のASCII空白をすべてU+0020 SPACE文字に置き換えます。

  3. targetオブジェクトのfont属性によって与えられる現在のフォントをfontとします。

  4. language を target の 言語とします。

  5. language が「inherit」の場合：

    1. sourceObject を object の フォントスタイルソースオブジェクトとします。

    2. sourceObject が canvas 要素の場合、language を sourceObject の 言語に設定します。

    3. それ以外の場合：

      1. 表明：sourceObject は OffscreenCanvas オブジェクトです。

      2. language を sourceObject の 継承された言語に設定します。

  6. language が空の文字列の場合、language を explicitly unknown に設定します。

  7. 次のリストから適切なステップを適用して、direction の値を決定します。

    target オブジェクトの direction 属性の値が「ltr」の場合
    direction を「ltr」とします。
    target オブジェクトの direction 属性の値が「rtl」の場合
    direction を「rtl」とします。
    target オブジェクトの direction 属性の値が「inherit」の場合

    1. sourceObject を object の フォントスタイルソースオブジェクトとします。

    2. sourceObject が canvas 要素の場合、direction を sourceObject の 書字方向とします。

    3. それ以外の場合：

      1. 表明：sourceObject は OffscreenCanvas オブジェクトです。

      2. direction を sourceObject の 継承された書字方向とします。

  8. テキスト text を含む単一の インラインボックスを含む、仮説上の無限幅の CSS ラインボックスを形成します。CSS コンテンツ言語は language に設定され、CSS プロパティは次のように設定されます。

    プロパティ ソース
    'direction' direction
    'font' font
    'font-kerning' targetのfontKerning
    'font-stretch' targetのfontStretch
    'font-variant-caps' targetのfontVariantCaps
    'letter-spacing' targetのletter spacing
    SVGテキストレンダリング targetのtextRendering
    'white-space' 'pre'
    'word-spacing' targetのword spacing

    その他のすべてのプロパティは初期値に設定します。

  9. maxWidthが指定されており、仮想的なインラインボックス内の仮想的なラインボックスの幅がmaxWidthのCSSピクセルを超える場合、フォントをより凝縮したものに変更する（使用可能な場合、または水平スケールファクターを適用して読みやすいものが合成できる場合）か、より小さいフォントに変更し、前のステップに戻ります。

  10. anchor pointはインラインボックス上のポイントであり、physical alignmentはleft、right、およびcenterの値のいずれかです。これらの変数はtextAlignおよびtextBaselineの値によって次のように決定されます:

    水平位置:

    もしtextAlignがleftである場合
    もしtextAlignがstartであり、directionが'ltr'である場合
    もしtextAlignがendであり、directionが'rtl'である場合
    anchor pointの水平位置をインラインボックスの左端にし、physical alignmentをleftにします。
    もしtextAlignがrightである場合
    もしtextAlignがendであり、directionが'ltr'である場合
    もしtextAlignがstartであり、directionが'rtl'である場合
    anchor pointの水平位置をインラインボックスの右端にし、physical alignmentをrightにします。
    もしtextAlignがcenterである場合
    anchor pointの水平位置をインラインボックスの左端と右端の中間にし、physical alignmentをcenterにします。

    垂直位置:

    もしtextBaselineがtopである場合
    anchor pointの垂直位置を最初に利用可能なフォントのエムボックスの上端にしますインラインボックス。
    もしtextBaselineがhangingである場合
    anchor pointの垂直位置をhangingベースラインにします。最初に利用可能なフォントのインラインボックス。
    もしtextBaselineがmiddleである場合
    anchor pointの垂直位置をエムボックスの下端と上端の中間にします。最初に利用可能なフォントのインラインボックス。
    もしtextBaselineがalphabeticである場合
    anchor pointの垂直位置をalphabeticベースラインにします。最初に利用可能なフォントのインラインボックス。
    もしtextBaselineがideographicである場合
    anchor pointの垂直位置をideographic-underベースラインにします。最初に利用可能なフォントのインラインボックス。
    もしtextBaselineがbottomである場合
    anchor pointの垂直位置を最初に利用可能なフォントのエムボックスの下端にしますインラインボックス。

  11. resultを配列として、左から右（存在する場合）にインラインボックス内の各グリフを反復し、各グリフの形状をanchor pointに原点を持つ座標空間に配置された状態で配列に追加することで構成します。

  12. result、physical alignment、およびインラインボックスを返します。

4.12.5.1.6 パスの構築

CanvasPathインターフェースを実装するオブジェクトは、パスを持ちます。パスは、0個以上のサブパスのリストを持ちます。各サブパスは、直線または曲線の線分で接続された1つ以上の点と、そのサブパスが閉じているかどうかを示すフラグで構成されます。サブパスが閉じている場合、サブパスの最後の点は、直線でサブパスの最初の点に接続されます。1つの点しか持たないサブパスは、パスを描画する際に無視されます。

パスには新しいサブパスが必要というフラグがあります。このフラグが設定されると、特定のAPIは前のサブパスを拡張するのではなく、新しいサブパスを作成します。パスが作成されるとき、その新しいサブパスが必要というフラグが設定されなければなりません。

CanvasPathインターフェースを実装するオブジェクトが作成されると、そのパスは0個のサブパスに初期化されなければなりません。

context.moveTo(x, y)

CanvasRenderingContext2D/moveTo

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された点で新しいサブパスを作成します。

context.closePath()

CanvasRenderingContext2D/closePath

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

現在のサブパスを閉じたものとしてマークし、新しく閉じられたサブパスの開始点と終了点が同じ点で新しいサブパスを開始します。

context.lineTo(x, y)

CanvasRenderingContext2D/lineTo

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された点を現在のサブパスに追加し、前の点と直線で接続します。

context.quadraticCurveTo(cpx, cpy, x, y)

CanvasRenderingContext2D/quadraticCurveTo

すべての現行エンジンでサポートされています。

Firefox1.5+Safari3+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された点を現在のサブパスに追加し、指定された制御点で二次ベジェ曲線で接続します。

context.bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y)

CanvasRenderingContext2D/bezierCurveTo

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された点を現在のサブパスに追加し、指定された制御点で三次ベジェ曲線で接続します。

context.arcTo(x1, y1, x2, y2, radius)

CanvasRenderingContext2D/arcTo

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された制御点と半径で現在のサブパスに円弧を追加し、前の点と直線で接続します。

指定された半径が負の場合、"IndexSizeError" DOMExceptionをスローします。

context.arc(x, y, radius, startAngle, endAngle [, counterclockwise ])

CanvasRenderingContext2D/arc

すべての現行エンジンでサポートされています。

Firefox1.5+Safari3+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された点、半径、開始角度、終了角度、方向に基づいて、円弧を現在のサブパスに追加します。

指定された半径が負の場合、"IndexSizeError" DOMExceptionをスローします。

context.ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle [, counterclockwise])

CanvasRenderingContext2D/ellipse

すべての現行エンジンでサポートされています。

Firefox48+Safari9+Chrome31+
Opera?Edge79+
Edge (Legacy)13+Internet Explorer不可
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定された点、x方向の半径、y方向の半径、回転角、開始角度、終了角度、方向に基づいて、楕円弧を現在のサブパスに追加します。

指定された半径が負の場合、"IndexSizeError" DOMExceptionをスローします。

context.rect(x, y, w, h)

CanvasRenderingContext2D/rect

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

指定された四角形を表す新しい閉じたサブパスをパスに追加します。

context.roundRect(x, y, w, h, radii)
path.roundRect(x, y, w, h, radii)

指定された角の半径を持つ四角形を表す新しい閉じたサブパスをパスに追加します。radiiは、四角形の角を表すピクセル単位の半径のリストか、1つの半径を表す単一の値のいずれかです。リストが提供された場合、これらの半径の数と順序はCSSの'border-radius'プロパティと同じように機能します。単一の半径は、1つの要素を持つリストと同じように機能します。

wとhの両方が0以上または両方が0未満の場合、パスは時計回りに描画されます。それ以外の場合、反時計回りに描画されます。

wが負の場合、角丸の四角形は水平に反転されます。これにより、通常は左の角に適用される半径の値が右に使用され、その逆も同様です。同様に、hが負の場合、角丸の四角形は垂直に反転されます。

radii内のrの値が数値である場合、対応する角は半径rの円弧として描かれます。

radii内のrの値が{ x, y }プロパティを持つオブジェクトである場合、対応する角は、それぞれr.xとr.yに等しいxとyの半径を持つ楕円弧として描かれます。

同じエッジの2つの角のradiiの合計がエッジの長さを超える場合、角丸の四角形のすべてのradiiは長さ/(r1 + r2)の係数でスケーリングされます。複数のエッジがこのプロパティを持つ場合、最小のスケール係数を持つエッジのスケール係数が使用されます。これはCSSの動作と一致します。

radiiが1つ、2つ、3つ、または4つでないリストである場合、RangeErrorをスローします。

radii内の値が負の数である場合、または{ x, y }オブジェクトでxまたはyプロパティが負の数である場合、RangeErrorをスローします。

次のメソッドを使用すると、著者は CanvasPath インターフェイスを実装するオブジェクトのパスを操作できます。

CanvasDrawPath および CanvasTransform インターフェイスを実装するオブジェクトの場合、メソッドに渡されるポイントおよびこれらのメソッドによって現在のデフォルトパスに追加される結果としてのラインは、パスに追加される前に現在の変換行列に従って変換される必要があります。

moveTo(x, y)メソッドが呼び出されたとき、次の手順を実行する必要があります:

  1. 引数のいずれかが無限大またはNaNである場合は、終了します。

  2. 指定されたポイントを最初の（および唯一の）ポイントとする新しいサブパスを作成します。

ユーザーエージェントが座標 (x, y) に対してサブパスが存在することを確認する必要がある場合、パスが新しいサブパスが必要フラグを持っているかどうかを確認する必要があります。もしフラグが設定されている場合、ユーザーエージェントは、moveTo()メソッドが呼び出されたかのように、座標 (x, y) を最初の（そして唯一の）点とする新しいサブパスを作成し、その後、パスの新しいサブパスが必要フラグを解除する必要があります。

closePath()メソッドが呼び出されたとき、オブジェクトのパスにサブパスがない場合は何も行わない必要があります。そうでない場合、最後のサブパスを閉じ、前のサブパスの最初のポイントと同じポイントを持つ新しいサブパスを作成し、この新しいサブパスをパスに追加する必要があります。

最後のサブパスにリスト内に複数のポイントがある場合、これは最後のサブパスの最後のポイントを最初のポイントに接続する直線を追加するのと同等であり、したがってサブパスを「閉じる」ことになります。

新しいポイントとそれらを接続するラインは、以下に記載されているメソッドを使用してサブパスに追加されます。すべての場合において、メソッドはオブジェクトのパス内の最後のサブパスのみを変更します。

lineTo(x, y)メソッドが呼び出されたとき、次の手順を実行する必要があります:

  1. 引数のいずれかが無限大またはNaNである場合は、終了します。

  2. オブジェクトのパスにサブパスが存在しない場合は、サブパスが存在することを確認する (x, y)。

  3. そうでない場合、最後のポイントを指定されたポイント(x, y)に直線で接続し、その後、指定されたポイント(x, y)をサブパスに追加します。

quadraticCurveTo(cpx, cpy, x, y)メソッドが呼び出されたとき、次の手順を実行する必要があります:

  1. 引数のいずれかが無限大またはNaNである場合は、終了します。

  2. サブパスがあることを確認します。指定された制御点(cpx, cpy)。

  3. 最後のポイントを指定されたポイント(x, y)に指定された制御点(cpx, cpy)でベジエ曲線を使用して接続し、指定されたポイント(x, y)をサブパスに追加します。

bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y)メソッドが呼び出されたとき、次の手順を実行する必要があります:

  1. 引数のいずれかが無限大またはNaNである場合は、終了します。

  2. サブパスがあることを確認します。指定された制御点(cp1x, cp1y)。

  3. 最後のポイントを指定されたポイント(x, y)に指定された制御点(cp1x, cp1y)および(cp2x, cp2y)でベジエ曲線を使用して接続し、指定されたポイント(x, y)をサブパスに追加します。

arcTo(x1, y1, x2, y2, radius)メソッドが呼び出されたとき、次の手順を実行する必要があります:

  1. 引数のいずれかが無限大またはNaNである場合は、終了します。

  2. サブパスがあることを確認します。指定されたポイント(x1, y1)。

  3. radiusが負の場合、"IndexSizeError"DOMExceptionをスローします。

  4. ポイント(x0, y0)を最後のサブパスのポイントとし、現在の変換行列の逆数で変換された座標系で、メソッドに渡されたポイントと同じ座標系にします。

  5. ポイント(x0, y0)がポイント(x1, y1)と等しい場合、またはポイント(x1, y1)がポイント(x2, y2)と等しい場合、またはradiusがゼロの場合、ポイント(x1, y1)をサブパスに追加し、そのポイントを前のポイント(x0, y0)と直線で接続します。

  6. それ以外の場合、ポイント(x0, y0)、(x1, y1)、(x2, y2)がすべて1つの直線上にある場合、ポイント(x1, y1)をサブパスに追加し、そのポイントを前のポイント(x0, y0)と直線で接続します。

  7. それ以外の場合、The Arcを円の周囲に沿った最も短い弧とし、radiusを持ち、ポイント(x0, y0)を通過する半無限直線に接するポイントを1つ持ち、ポイント(x1, y1)を通過する別の半無限直線に接するポイントを持つ円として定義します。この円がこれらの2つの直線に接するポイントは、それぞれ開始接点および終了接点と呼ばれます。ポイント(x0, y0)を開始接点に直線で接続し、開始接点をサブパスに追加し、その後、開始接点をThe Arcで終了接点に接続し、終了接点をサブパスに追加します。

arc(x, y, radius, startAngle, endAngle, counterclockwise)メソッドは、呼び出されると、this、x、y、radius、radius、0、startAngle、endAngle、およびcounterclockwiseを使用して楕円メソッドステップを実行する必要があります。

これにより、両方の半径が等しく、rotationが0であることを除いて、ellipse()と等価になります。

ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle, counterclockwise)メソッドは、呼び出されると、this、x、y、radiusX、radiusY、rotation、startAngle、endAngle、およびcounterclockwiseを使用して楕円メソッドステップを実行する必要があります。

楕円上のポイントを決定する手順は、与えられたellipseとangleに基づいて以下の手順で実行します:

  1. eccentricCircleを、ellipseと原点を共有し、ellipseの半長軸と等しい半径を持つ円とします。

  2. outerPointを、ellipseの半長軸から時計回りに測定したangleの位置にあるeccentricCircleの周囲のポイントとします。

  3. chordを、ellipseの長軸に垂直なラインで、長軸とouterPointの間のラインとします。

  4. chordがellipseの周囲を横切るポイントを返します。

楕円メソッドの手順は、与えられたcanvasPath, x, y, radiusX, radiusY, rotation, startAngle, endAngle, およびcounterclockwiseに基づいて以下の手順で実行します:

  1. 引数のいずれかが無限大またはNaNである場合は、終了します。

  2. radiusXまたはradiusYのいずれかが負の場合、"IndexSizeError"DOMExceptionをスローします。

  3. canvasPathのパスにサブパスがある場合、最後のポイントから弧の開始ポイントまで直線を追加します。

  4. 弧の開始点と終了点をサブパスに追加し、それらを弧で接続します。弧およびその開始点と終了点は次のように定義されます:

    (x, y)に原点を持ち、半長軸の半径がradiusX、半短軸の半径がradiusYである楕円を考え、この楕円はその原点を中心にして回転し、その半長軸がx軸からrotationラジアン時計回りに傾いているとします。

    counterclockwiseがfalseであり、endAngle − startAngleが2π以上の場合、またはcounterclockwiseがtrueであり、startAngle − endAngleが2π以上の場合、弧はこの楕円の全周であり、開始点および終了点は、この楕円とstartAngleで与えられた角度に基づいて楕円上のポイントを決定する手順を実行した結果です。

    そうでない場合、開始点はこの楕円とstartAngleに基づいて楕円上のポイントを決定する手順を実行した結果であり、終了点はこの楕円とendAngleに基づいて楕円上のポイントを決定する手順を実行した結果です。弧は開始点から終了点までの楕円の周囲のパスであり、counterclockwiseがtrueの場合は反時計回りに、そうでない場合は時計回りに移動します。ポイントが楕円上にあるため、角度は2πラジアンを超えることはありません。

    弧が楕円の全周をカバーし、サブパスに他のポイントがない場合でも、closePath()メソッドが適切に呼び出されない限り、パスは閉じられません。

rect(x, y, w, h) メソッドが呼び出されたとき、以下の手順を実行します:

  1. 引数のいずれかが無限大またはNaNである場合、終了します。

  2. 指定されたポイント (x, y), (x+w, y), (x+w, y+h), (x, y+h) を順に含む新しいサブパスを作成し、これらの4つのポイントを直線で接続します。

  3. サブパスを閉じたものとしてマークします。

  4. ポイント (x, y) を唯一のポイントとしてサブパスを新規作成します。

CanvasRenderingContext2D/roundRect

すべての最新エンジンでサポートされています。

Firefox112+Safari16+Chrome99+
Opera?Edge99+
Edge (レガシー)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

roundRect(x, y, w, h, radii) メソッドの手順は以下の通りです:

  1. x, y, w, または h が無限大またはNaNである場合、終了します。

  2. radii が unrestricted double または DOMPointInit の場合、radii を « radii » に設定します。

  3. radii がサイズ1、2、3、4のリストでない場合、RangeError をスローします。

  4. normalizedRadii を空のリストとして設定します。

  5. radii の各 radius に対して:

    1. radius が DOMPointInit の場合:

      1. radius["x"] または radius["y"] が無限大または NaN の場合、戻ります。

      2. radius["x"] または radius["y"] が負の場合、RangeError をスローします。

      3. それ以外の場合、radius を normalizedRadii に追加します。

    2. radius が unrestricted double の場合:

      1. radius が無限大または NaN の場合、戻ります。

      2. radius が負の場合、RangeError をスローします。

      3. それ以外の場合、«[ "x" → radius, "y" → radius ]» を normalizedRadii に追加します。

  6. upperLeft, upperRight, lowerRight, lowerLeft をnullに設定します。

  7. normalizedRadii のサイズが4の場合、upperLeft を normalizedRadii[0] に設定し、upperRight を normalizedRadii[1] に設定し、lowerRight を normalizedRadii[2] に設定し、lowerLeft を normalizedRadii[3] に設定します。

  8. normalizedRadii のサイズが3の場合、upperLeft を normalizedRadii[0] に設定し、upperRight と lowerLeft を normalizedRadii[1] に設定し、lowerRight を normalizedRadii[2] に設定します。

  9. normalizedRadii のサイズが2の場合、upperLeft と lowerRight を normalizedRadii[0] に設定し、upperRight と lowerLeft を normalizedRadii[1] に設定します。

  10. normalizedRadii のサイズが1の場合、upperLeft, upperRight, lowerRight, lowerLeft を normalizedRadii[0] に設定します。

  11. 角のカーブが重ならないようにするために、すべての半径を縮小します:

    1. top を upperLeft["x"] + upperRight["x"] とします。

    2. right を upperRight["y"] + lowerRight["y"] とします。

    3. bottom を lowerRight["x"] + lowerLeft["x"] とします。

    4. left を upperLeft["y"] + lowerLeft["y"] とします。

    5. scale を、比率 w / top、 h / right、w / bottom、h / left の最小値とします。

    6. scale が 1 未満の場合、upperLeft、 upperRight、lowerLeft、および lowerRight の x および y メンバーを、現在の値に scale を乗じた値に設定します。

  12. 新しいサブパスを作成します:

    1. 点 (x + upperLeft["x"], y) に移動します。

    2. 点 (x + w − upperRight["x"], y) に直線を引きます。

    3. 点 (x + w, y + upperRight["y"]) に円弧を引きます。

    4. 点 (x + w, y + h − lowerRight["y"]) に直線を引きます。

    5. 点 (x + w − lowerRight["x"], y + h) に円弧を引きます。

    6. 点 (x + lowerLeft["x"], y + h) に直線を引きます。

    7. 点 (x, y + h − lowerLeft["y"]) に円弧を引きます。

    8. 点 (x, y + upperLeft["y"]) に直線を引きます。

    9. 点 (x + upperLeft["x"], y) に円弧を引きます。

  13. サブパスを閉じたものとしてマークします。

  14. ポイント (x, y) を唯一のポイントとしてサブパスを新規作成します。

これは、CSSの'border-radius'プロパティと同様に機能するように設計されています。

4.12.5.1.7 Path2D オブジェクト

Path2D

すべての現在のエンジンでサポートされています。

Firefox31+Safari8+Chrome36+
Opera?Edge79+
Edge (レガシー)14+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Path2D オブジェクトは、次に使用されるパスを宣言するために使用されます。 オブジェクトを実装します。CanvasDrawPathインターフェースを実装するオブジェクトです。 先に説明された多くのAPIに加えて、Path2D オブジェクトには、パスを結合したり、パスにテキストを追加したりするためのメソッドがあります。

path = new Path2D()

Path2D/Path2D

すべての現在のエンジンでサポートされています。

Firefox31+Safari8+Chrome36+
Opera?Edge79+
Edge (レガシー)14+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

新しい空のPath2Dオブジェクトを作成します。

path = new Path2D(path)

pathがPath2D オブジェクトの場合、 コピーを返します。

pathが文字列の場合、引数で指定されたパスを作成し、SVGパスデータとして解釈します。[SVG]

path.addPath(path [, transform ])

Path2D/addPath

すべての現在のエンジンでサポートされています。

Firefox34+Safari9+Chrome68+
Opera?Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

引数で与えられたパスをパスに追加します。

Path2D(path) コンストラクターが呼び出されたとき、これらの手順を実行する必要があります:

  1. outputを新しいPath2D オブジェクトに設定します。

  2. pathが指定されていない場合、outputを返します。

  3. pathがPath2D オブジェクトの場合、 pathのすべてのサブパスをoutputに追加し、outputを返します。（つまり、引数のコピーを返します。）

  4. svgPathを、pathを解析して解釈した結果に設定します。SVG 2のパスデータに関する規則に従います。[SVG]

    結果のパスは空である可能性があります。SVGはパスデータの解析と適用に関するエラーハンドリングルールを定義しています。

  5. svgPathの最後のポイントをx、yに設定します。

  6. 存在する場合、svgPathのすべてのサブパスをoutputに追加します。

  7. outputに新しいサブパスを作成し、(x, y)をサブパスの唯一のポイントとして設定します。

  8. outputを返します。

addPath(path, transform) メソッドは、Path2D オブジェクト aに対して呼び出された場合、次の手順を実行する必要があります:

  1. Path2D オブジェクト path にサブパスがない場合、返します。

  2. matrixを、2D辞書からDOMMatrix を作成するの結果に設定します。 transform。

  3. 1つ以上のmatrixの要素が無限大またはNaNである場合、返します。

  4. path内のすべてのサブパスのコピーを作成します。このコピーをcと呼びます。

  5. c内のすべての座標と線を、変換行列matrixで変換します。

  6. cの最後のサブパスの最後のポイントを(x, y)に設定します。

  7. c内のすべてのサブパスをaに追加します。

  8. aに新しいサブパスを作成し、(x, y)をサブパスの唯一のポイントとして設定します。

4.12.5.1.8 変換

CanvasTransformインターフェースを実装するオブジェクトには、現在の変換行列があり、それを操作するためのメソッド（このセクションで説明）が備わっています。CanvasTransformインターフェースを実装するオブジェクトが作成されると、その変換行列は単位行列に初期化される必要があります。

現在の変換行列は、現在のデフォルトパスを作成するときや、テキスト、形状、およびPath2Dオブジェクトを描画するときに適用されます。これらのオブジェクトは、CanvasTransformインターフェースを実装します。

変換は逆順に実行する必要があります。

例えば、キャンバスに幅を2倍にするスケーリング変換を適用し、その後に描画操作を四分の一回転させる回転変換を適用し、最後に幅が高さの2倍の長方形をキャンバスに描画した場合、実際の結果は正方形になります。

context.scale(x, y)

CanvasRenderingContext2D/scale

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の変換行列を変更して、指定された特性を持つスケーリング変換を適用します。

context.rotate(angle)

CanvasRenderingContext2D/rotate

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の変換行列を変更して、指定された特性を持つ回転変換を適用します。角度はラジアンで指定されます。

context.translate(x, y)

CanvasRenderingContext2D/translate

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の変換行列を変更して、指定された特性を持つ平行移動変換を適用します。

context.transform(a, b, c, d, e, f)

CanvasRenderingContext2D/transform

すべての現在のエンジンでサポートされています。

Firefox3+Safari3.1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の変換行列を変更して、以下に説明するように引数で指定された行列を適用します。

matrix = context.getTransform()

CanvasRenderingContext2D/getTransform

すべての現在のエンジンでサポートされています。

Firefox70+Safari11.1+Chrome68+
Opera?Edge79+
Edge (レガシー)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

現在の変換行列のコピーを、新しく作成されたDOMMatrixオブジェクトとして返します。

context.setTransform(a, b, c, d, e, f)

CanvasRenderingContext2D/setTransform

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在の変換行列を以下に説明するように、引数で指定された行列に設定します。

context.setTransform(transform)

現在の変換行列を、指定されたDOMMatrix2DInit辞書が表す行列に設定します。

context.resetTransform()

CanvasRenderingContext2D/resetTransform

すべての現在のエンジンでサポートされています。

Firefox36+Safari10.1+Chrome31+
Opera?Edge79+
Edge (レガシー)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

現在の変換行列を単位行列にリセットします。

scale(x, y)メソッドが呼び出されると、次の手順が実行されます：

  1. 引数のいずれかが無限大またはNaNの場合、戻ります。

  2. 引数で指定されたスケーリング変換を現在の変換行列に追加します。x引数は水平方向のスケールファクターを表し、y引数は垂直方向のスケールファクターを表します。これらのファクターは倍数です。

rotate(angle)メソッドが呼び出されると、次の手順が実行されます：

  1. angleが無限大またはNaNの場合、戻ります。

  2. 引数で指定された回転変換を現在の変換行列に追加します。angle引数は時計回りの回転角をラジアンで表します。

translate(x, y)メソッドが呼び出されると、次の手順が実行されます：

  1. 引数のいずれかが無限大またはNaNの場合、戻ります。

  2. 引数で指定された平行移動変換を現在の変換行列に追加します。x引数は水平方向の移動距離を表し、y引数は垂直方向の移動距離を表します。これらの引数は座標空間の単位で指定されます。

transform(a, b, c, d, e, f)メソッドが呼び出されると、次の手順が実行されます：

  1. 引数のいずれかが無限大またはNaNの場合、戻ります。

  2. 現在の変換行列を次の行列と掛け合わせた結果に置き換えます：

    a c e
    b d f
    0 0 1

引数a、b、c、d、e、およびfは、時にはm11、m12、m21、m22、dx、およびdyと呼ばれることがあります。また、m12/m21やm21/m12などの表記がAPIによって異なることがあるため、特にbとcの順番には注意が必要です。

getTransform()メソッドが呼び出されると、コンテキストの現在の変換行列のコピーを表す新しく作成されたDOMMatrixを返します。

返されたオブジェクトはライブではないため、それを更新しても現在の変換行列には影響しませんし、現在の変換行列を更新しても、すでに返されたDOMMatrixには影響しません。

setTransform(a, b, c, d, e, f)メソッドが呼び出されると、次の手順が実行されます：

  1. 引数のいずれかが無限大またはNaNの場合、戻ります。

  2. 現在の変換行列を次の行列にリセットします：

    a c e
    b d f
    0 0 1

setTransform(transform)メソッドが呼び出されると、次の手順が実行されます：

  1. 2D辞書からDOMMatrixを作成する結果として、transformからmatrixを作成します。

  2. matrixのm11要素、m12要素、m21要素、m22要素、m41要素、またはm42要素のいずれかが無限大またはNaNの場合、戻ります。

  3. 現在の変換行列をmatrixにリセットします。

resetTransform()メソッドが呼び出されると、現在の変換行列を単位行列にリセットします。

transform()およびsetTransform()メソッドで作成された形式の行列が与えられた場合、

a c e
b d f
0 0 1

変換行列の掛け算後の変換された座標は次のようになります：

xnew = a x + c y + e
ynew = b x + d y + f

4.12.5.1.9 2Dレンダリングコンテキストの画像ソース

一部のメソッドでは、CanvasDrawImage および CanvasFillStrokeStyles インターフェイスが共用体型CanvasImageSource を引数として取ります。

この共用体型は、以下のインターフェイスを実装するオブジェクトを画像ソースとして使用することを可能にします：

正式には指定されていませんが、SVG image 要素は img 要素とほぼ同じように実装されると予想されます。つまり、SVG image 要素は img 要素の基本的な概念と機能を共有しています。

ImageBitmap インターフェイスは、ImageData などの他の画像表現型から作成することができます。

画像引数の使用可能性を確認するには、image が CanvasImageSource オブジェクトである場合、次の手順を実行します：

  1. image の種類に応じて以下を切り替えます：

    HTMLOrSVGImageElement

    もし image の 現在のリクエスト の 状態 が 壊れている ならば、"InvalidStateError" DOMException を投げます。

    もし image が 完全にデコード可能 でない場合、悪い を返します。

    もし image の 自然な幅 または 自然な高さ (またはその両方) がゼロである場合、悪い を返します。

    HTMLVideoElement

    もし image の readyState 属性が HAVE_NOTHING または HAVE_METADATA のいずれかである場合、悪い を返します。

    HTMLCanvasElement
    OffscreenCanvas

    もし image が水平方向または垂直方向のいずれかの寸法がゼロである場合、"InvalidStateError" DOMException を投げます。

    ImageBitmap
    VideoFrame

    もし image の [[Detached]] 内部スロット値がtrueに設定されている場合、"InvalidStateError" DOMException を投げます。

  2. 良い を返します。

ある CanvasImageSource オブジェクトが HTMLOrSVGImageElement を表す場合、要素の画像をソース画像として使用しなければなりません。

具体的には、CanvasImageSource オブジェクトがアニメーション画像を表す場合、ユーザーエージェントは、アニメーションがサポートされていない、または無効化されている場合に使用するようにフォーマットで定義されているデフォルト画像を使用する必要があります。そうでない場合、アニメーションの最初のフレームを使用して、CanvasRenderingContext2D APIで画像をレンダリングします。

ある CanvasImageSource オブジェクトが HTMLVideoElement を表す場合、メソッドが呼び出されたときの 現在の再生位置 でのフレームをソース画像として使用し、ソース画像の寸法は、自然な幅 および 自然な高さ でなければなりません。

ある CanvasImageSource オブジェクトが HTMLCanvasElement を表す場合、要素のビットマップをソース画像として使用しなければなりません。

ある CanvasImageSource オブジェクトが描画中の要素を表し、その要素がリサイズされている場合、ソース画像の元の画像データを使用しなければなりません。レンダリングされた画像ではなく (例：ソース要素の 幅 および 高さ 属性は、CanvasRenderingContext2D APIで画像をレンダリングする際に、オブジェクトの解釈に影響を与えません)。

ある CanvasImageSource オブジェクトが ImageBitmap を表す場合、そのオブジェクトのビットマップ画像データをソース画像として使用しなければなりません。

ある CanvasImageSource オブジェクトが OffscreenCanvas を表す場合、そのオブジェクトのビットマップをソース画像として使用しなければなりません。

ある CanvasImageSource オブジェクトが VideoFrame を表す場合、そのオブジェクトのピクセルデータをソース画像として使用し、ソース画像の寸法はオブジェクトの [[表示幅]] および [[表示高さ]] でなければなりません。

image というオブジェクトがオリジンがクリーンでない場合、image の種類に応じて：

HTMLOrSVGImageElement

image の 現在のリクエスト の 画像データ が CORS-クロスオリジン である。

HTMLVideoElement

image の メディアデータ が CORS-クロスオリジン である。

HTMLCanvasElement
ImageBitmap
OffscreenCanvas

image のビットマップの オリジンがクリーンである フラグが false である。

4.12.5.1.10 塗りつぶしとストロークスタイル
context.fillStyle [ = value ]

CanvasRenderingContext2D/fillStyle

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の塗りつぶしに使用されるスタイルを返します。

設定可能で、塗りつぶしスタイルを変更できます。

スタイルは、CSS カラーを含む文字列、CanvasGradient、または CanvasPattern オブジェクトのいずれかです。 無効な値は無視されます。

context.strokeStyle [ = value ]

CanvasRenderingContext2D/strokeStyle

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在の描画に使用されるスタイルを返します。

設定可能で、ストロークスタイルを変更できます。

スタイルは、CSS カラーを含む文字列、CanvasGradient、または CanvasPattern オブジェクトのいずれかです。 無効な値は無視されます。

CanvasFillStrokeStyles インターフェイスを実装するオブジェクトには、そのオブジェクトが図形をどのように処理するかを制御する属性とメソッドが定義されています。

このようなオブジェクトには、塗りつぶしスタイル と ストロークスタイル の値が関連付けられています。これらの値は、CSS カラー、CanvasPattern または CanvasGradient のいずれかです。最初は、どちらも 文字列 "#000000" の解析 の結果でなければなりません。

値が CSS カラーの場合、ビットマップに描画する際に変換行列の影響を受けてはなりません。

CanvasPattern または CanvasGradient オブジェクトに設定されると、割り当て後に行われた変更は、その後の図形の描画や塗りつぶしに影響します。

fillStyle のゲッターステップは次のとおりです。

  1. もしthisの 塗りつぶしスタイルがCSSカラーである場合、そのカラーのシリアライズ をHTML互換のシリアライズが要求される場合として返します。

  2. this の 塗りつぶしスタイル を返します。

fillStyle のセッターステップは次のとおりです。

  1. 指定された値が文字列である場合:

    1. context を this の canvas 属性の値（それが要素である場合）に設定します。それ以外の場合は null に設定します。

    2. parsedValue を、context が null でない場合に、指定された値を 解析 した結果に設定します。

    3. parsedValue が失敗した場合、返します。

    4. this の 塗りつぶしスタイル を parsedValue に設定します。

    5. 返します。

  2. 指定された値が CanvasPattern オブジェクトで、オリジンクリーンではない とマークされている場合、this の オリジンクリーン フラグを false に設定します。

  3. this の 塗りつぶしスタイル を指定された値に設定します。

strokeStyle のゲッターステップは次のとおりです。

  1. もしthisのストロークスタイルがCSSカラーである場合、そのカラーのシリアライズをHTML互換のシリアライズが要求される場合として返します。

  2. this の ストロークスタイル を返します。

strokeStyle のセッターステップは次のとおりです。

  1. 指定された値が文字列である場合:

    1. context を this の canvas 属性の値（それが要素である場合）に設定します。それ以外の場合は null に設定します。

    2. parsedValue を、context が null でない場合に、指定された値を 解析 した結果に設定します。

    3. parsedValue が失敗した場合、返します。

    4. this の ストロークスタイル を parsedValue に設定します。

    5. 返します。

  2. 指定された値が CanvasPattern オブジェクトで、オリジンクリーンではない とマークされている場合、this の オリジンクリーン フラグを false に設定します。

  3. this の ストロークスタイル を指定された値に設定します。

グラデーションには、線形グラデーション、放射状グラデーション、および円錐グラデーションの3種類があり、これらは不透明なCanvasGradientインターフェースを実装するオブジェクトによって表されます。

一度グラデーションが作成されると（以下参照）、ストップがその上に配置され、グラデーションに沿った色の分布が定義されます。各ストップでのグラデーションの色は、そのストップに指定された色です。各ストップの間では、アルファ値を事前に乗算せずに、RGBA空間で線形補間を行い、そのオフセットで使用する色を見つける必要があります。最初のストップの前では、色は最初のストップの色でなければなりません。最後のストップの後では、色は最後のストップの色でなければなりません。ストップがない場合、グラデーションは透明な黒になります。

gradient.addColorStop(offset, color)

CanvasGradient/addColorStop

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

指定されたオフセットで、指定された色を持つカラーストップをグラデーションに追加します。0.0 はグラデーションの片端のオフセットであり、1.0 はもう一方のオフセットです。

オフセットが範囲外の場合、"IndexSizeError" DOMExceptionをスローします。色が解析できない場合は、"SyntaxError" DOMExceptionをスローします。

gradient = context.createLinearGradient(x0, y0, x1, y1)

CanvasRenderingContext2D/createLinearGradient

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

引数で表される座標によって与えられる線に沿って描画する線形グラデーションを表すCanvasGradientオブジェクトを返します。

gradient = context.createRadialGradient(x0, y0, r0, x1, y1, r1)

CanvasRenderingContext2D/createRadialGradient

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

引数で表される円によって与えられる円錐に沿って描画する放射状グラデーションを表すCanvasGradientオブジェクトを返します。

半径のいずれかが負の場合、"IndexSizeError" DOMExceptionをスローします。

gradient = context.createConicGradient(startAngle, x, y)

CanvasRenderingContext2D/createConicGradient

すべての現在のエンジンでサポートされています。

Firefox112+Safari16.1+Chrome99+
Opera?Edge99+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

引数で表される中心の周りの回転に沿って時計回りに描画する円錐グラデーションを表すCanvasGradientオブジェクトを返します。

CanvasGradientのaddColorStop(offset, color)メソッドは、呼び出されたときに、次のステップを実行する必要があります:

  1. offsetが0より小さいか、または1より大きい場合は、"IndexSizeError" DOMExceptionをスローします。

  2. parsed colorをcolorの解析の結果として設定します。

    要素はパーサーに渡されません。これはCanvasGradientオブジェクトがcanvasに依存しないためです。あるCanvasGradientオブジェクトは別のcanvasによって使用される可能性があるため、色が指定された時点で「問題の要素」を知る方法がないのです。

  3. parsed colorが失敗した場合、"SyntaxError" DOMExceptionをスローします。

  4. グラデーション全体に対してoffsetの位置に、新しいストップを追加し、その色をparsed colorとします。

    同じオフセットに複数のストップが追加された場合、それらは追加された順序で配置される必要があり、最初のストップがグラデーションの開始に最も近く、次のストップが最初のストップに非常に近い位置に配置され、最初と最後のストップ以外は無視されることになります。

createLinearGradient(x0, y0, x1, y1)メソッドは、グラデーションの開始点（x0, y0）と終了点（x1, y1）を表す4つの引数を受け取ります。メソッドが呼び出されると、指定された線で初期化された線形CanvasGradientを返す必要があります。

線形グラデーションは、開始点と終了点を横切る線に垂直なすべての点が、これら2つの線が交差する点での色を持つように描画される必要があります（色は上記で説明した補間および外挿から取得されます）。線形グラデーションの点は、描画時に現在の変換行列によって説明されるように変換される必要があります。

もしx0 = x1 かつ y0 = y1 の場合、線形グラデーションは何も描画してはなりません。

createRadialGradient(x0, y0, r0, x1, y1, r1)メソッドは6つの引数を受け取り、最初の3つは開始円の原点（x0, y0）および半径r0を表し、最後の3つは終了円の原点（x1, y1）および半径r1を表します。値は座標空間の単位です。r0またはr1のいずれかが負の場合、"IndexSizeError" DOMExceptionをスローする必要があります。それ以外の場合、このメソッドが呼び出されると、指定された2つの円で初期化された放射CanvasGradientを返す必要があります。

放射状グラデーションは次の手順に従って描画する必要があります:

  1. x0 = x1かつy0 = y1かつr0 = r1の場合、放射状グラデーションは何も描画してはなりません。終了します。

  2. x(ω) = (x1-x0)ω + x0とします。

    y(ω) = (y1-y0)ω + y0とします。

    r(ω) = (r1-r0)ω + r0とします。

    ωでの色を、その位置でのグラデーションの色とします（色は上記で説明した補間および外挿から取得されます）。

  3. r(ω) > 0であるすべてのωの値について、正の無限大に最も近いωの値から始めて、負の無限大に最も近いωの値で終了し、半径r(ω)を持つ円の円周を、位置(x(ω), y(ω))に描画します。ただし、このグラデーションのレンダリングのこのステップで前に描画された円によってまだ描画されていないビットマップの部分だけを塗りつぶします。

これは事実上、グラデーションの作成時に定義された2つの円によって接触される円錐を作成し、開始円（0.0）の前の部分は最初のオフセットの色を使用し、終了円（1.0）の後の部分は最後のオフセットの色を使用し、グラデーションによって触れられていない領域は透明な黒になります。

その後、得られた放射状グラデーションは、描画時に現在の変換行列によって説明されるように変換される必要があります。

createConicGradient(startAngle, x, y)メソッドは3つの引数を受け取り、最初の引数であるstartAngleはグラデーションが始まる角度（ラジアン単位）を表し、最後の2つの引数（x, y）はCSSピクセルでのグラデーションの中心を表します。メソッドが呼び出されると、指定された中心と角度で初期化された円錐のCanvasGradientを返す必要があります。

これはCSS'conic-gradient'と同じ描画ルールに従い、CSS 'conic-gradient(from adjustedStartAnglerad at xpx ypx, angularColorStopList)'と等価です。ここでは:

グラデーションは、関連するストロークまたは塗りつぶしの効果がそれらを描画する必要がある場合にのみ描画される必要があります。

パターンは、透明なCanvasPatternインターフェースを実装するオブジェクトによって表されます。

pattern = context.createPattern(image, repetition)

CanvasRenderingContext2D/createPattern

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

指定された画像を使用し、repetition引数で指定された方向に繰り返されるCanvasPatternオブジェクトを返します。

repetitionの許可される値は、repeat（両方向）、repeat-x（水平のみ）、repeat-y（垂直のみ）、およびno-repeat（どちらでもない）です。repetition引数が空の場合、値repeatが使用されます。

画像がまだ完全にデコードされていない場合、何も描画されません。画像がデータのないキャンバスである場合、"InvalidStateError" DOMExceptionがスローされます。

pattern.setTransform(transform)

CanvasPattern/setTransform

すべての現行エンジンでサポートされています。

Firefox33+Safari11.1+Chrome68+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

塗りつぶしまたはストロークの描画操作中にパターンをレンダリングする際に使用される変換行列を設定します。

createPattern(image, repetition)メソッドは、呼び出されたときに、次のステップを実行する必要があります:

  1. usabilityを、imageの使用可能性を確認する結果として設定します。

  2. usabilityが悪い場合、nullを返します。

  3. アサート: usabilityが良いことを確認します。

  4. repetitionが空文字列である場合、"repeat"に設定します。

  5. repetitionが"repeat", "repeat-x", "repeat-y", "no-repeat"のいずれかと一致しない場合、"SyntaxError" DOMExceptionをスローします。

  6. imageとrepetitionによって指定された繰り返し動作を持つ新しいCanvasPatternオブジェクトをpatternとして設定します。

  7. imageがオリジンを保持していない場合、patternをオリジンを保持していないとしてマークします。

  8. patternを返します。

createPattern()メソッドを呼び出した後、CanvasPatternオブジェクトでレンダリングされたパターンに使用されるimageを変更しても、描画されるパターンに影響を与えてはいけません。

パターンには変換行列があり、パターンが描画される際の使用方法を制御します。初期状態では、パターンの変換行列は単位行列でなければなりません。

setTransform(transform)メソッドは、呼び出されたときに、次のステップを実行する必要があります:

  1. transformを使用して、2D辞書からDOMMatrixを作成する結果をmatrixとして設定します。

  2. matrixのm11要素、m12要素、m21要素、m22要素、m41要素、またはm42要素の1つ以上が無限大またはNaNである場合は、何も返さず終了します。

  3. パターンの変換行列をmatrixにリセットします。

パターンを領域内にレンダリングする場合、ユーザーエージェントは次の手順を実行してレンダリングされる内容を決定する必要があります:

  1. 無限の透明な黒ビットマップを作成します。

  2. 画像の左上隅が座標空間の原点に位置するようにビットマップに画像のコピーを配置し、画像の1つのCSSピクセルあたり1つの座標空間単位で、repeat-xの場合は左右に、repeat-yの場合は上下に、repeatの場合はビットマップ全体に画像の繰り返しコピーを配置します。

    元の画像データがビットマップ画像である場合、繰り返し領域内のポイントに描画される値は、元の画像データをフィルタリングすることで計算されます。拡大する場合、imageSmoothingEnabled属性がfalseに設定されている場合、画像は最近傍補間を使用してレンダリングされる必要があります。それ以外の場合、ユーザーエージェントは任意のフィルタリングアルゴリズム（たとえば、バイリニア補間や最近傍補間など）を使用できます。複数のフィルタリングアルゴリズムをサポートするユーザーエージェントは、imageSmoothingQuality属性の値を使用してフィルタリングアルゴリズムの選択をガイドすることができます。このようなフィルタリングアルゴリズムが元の画像データの外からピクセル値を必要とする場合、代わりにピクセルの座標を元の画像の寸法にラップして使用する必要があります。（つまり、パターンの繰り返し動作の値に関係なく、フィルタは「repeat」動作を使用します。）

  3. 結果のビットマップをパターンの変換行列に従って変換します。

  4. 次に、現在の変換行列に従って再度結果のビットマップを変換します。

  5. パターンが描画される領域の外部にある画像の部分を透明な黒に置き換えます。

  6. 結果のビットマップが、同じ原点と同じスケールで描画されるものになります。

変換行列が特異な場合に放射状グラデーションや繰り返しパターンが使用されると、結果のスタイルは透明な黒でなければなりません（そうでなければ、グラデーションやパターンが一点や線に縮小され、他のピクセルが未定義のままになる可能性があります）。線形グラデーションや単色は、特異な変換行列でも常にすべてのポイントを定義します。

4.12.5.1.11 ビットマップへの長方形の描画

CanvasRectインターフェースを実装するオブジェクトは、ビットマップに即座に長方形を描画するための次のメソッドを提供します。これらのメソッドはそれぞれ4つの引数を取り、最初の2つは長方形の左上のxおよびy座標を、残りの2つはそれぞれ長方形の幅wと高さhを指定します。

次に示す4つの座標に適用された現在の変換行列を使用してパスを形成し、その後閉じて指定された長方形を得る必要があります: (x, y), (x+w, y), (x+w, y+h), (x, y+h)。

シェイプは現在のデフォルトパスに影響を与えずに描画され、クリッピング領域の影響を受けます。また、clearRect()を除き、シャドウ効果、グローバルアルファ、および現在の合成およびブレンディングオペレーターの影響も受けます。

context.clearRect(x, y, w, h)

CanvasRenderingContext2D/clearRect

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

指定された長方形内のビットマップ上のすべてのピクセルを透明な黒にクリアします。

context.fillRect(x, y, w, h)

CanvasRenderingContext2D/fillRect

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

現在の塗りつぶしスタイルを使用して、ビットマップに指定された長方形を描画します。

context.strokeRect(x, y, w, h)

CanvasRenderingContext2D/strokeRect

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のストロークスタイルを使用して、指定された長方形をビットマップにアウトラインとして描画します。

clearRect(x, y, w, h)メソッドは、呼び出されたとき、次のステップを実行する必要があります。

  1. 引数のいずれかが無限大またはNaNである場合は、何もせずに戻ります。

  2. pixelsを、指定された長方形内で、現在のクリッピング領域と交差するピクセルのセットとして設定します。

  3. pixels内のピクセルを透明な黒にクリアし、以前の画像を消去します。

高さまたは幅のいずれかがゼロの場合、このメソッドには効果がありません。ピクセルのセットが空になるためです。

fillRect(x, y, w, h)メソッドは、呼び出されたとき、次のステップを実行する必要があります。

  1. 引数のいずれかが無限大またはNaNである場合は、何もせずに戻ります。

  2. wまたはhのいずれかがゼロである場合は、何もせずに戻ります。

  3. 指定された長方形の領域を、thisの塗りつぶしスタイルを使用して塗りつぶします。

strokeRect(x, y, w, h)メソッドは、呼び出されたとき、次のステップを実行する必要があります。

  1. 引数のいずれかが無限大またはNaNである場合は、何もせずに戻ります。

  2. 以下に説明するパスをトレースする結果を取得し、CanvasPathDrawingStylesインターフェースのラインスタイルを使用してそれを描画し、thisのストロークスタイルで塗りつぶします。

もしwとhの両方がゼロの場合、パスは(x, y)の1点だけを持つ単一のサブパスとなり、このメソッドには効果がありません（この場合、パスをトレースするアルゴリズムは空のパスを返します）。

もしwまたはhのいずれかがゼロの場合、パスは(x, y)と(x+w, y+h)の2点からなる単一のサブパスとなり、それらは直線で結ばれます。

それ以外の場合、パスは4つの点からなる単一のサブパスを持ち、その点は順に(x, y), (x+w, y), (x+w, y+h), および(x, y+h)で、それらは順に直線で結ばれます。

4.12.5.1.12 ビットマップにテキストを描画する

CanvasRenderingContext2D

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
context.fillText(text, x, y [, maxWidth ])

CanvasRenderingContext2D/fillText

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
context.strokeText(text, x, y [, maxWidth ])

CanvasRenderingContext2D/strokeText

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定された位置にテキストを描画または描きます。最大幅が指定されている場合、テキストはその幅に合わせてスケーリングされます。

metrics = context.measureText(text)

CanvasRenderingContext2D/measureText

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

TextMetrics オブジェクトを返し、現在のフォントでの指定されたテキストのメトリック情報を提供します。

metrics.width

TextMetrics/width

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari4+Chrome2+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android31+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
metrics.actualBoundingBoxLeft

TextMetrics/actualBoundingBoxLeft

すべての現在のエンジンでサポートされています。

Firefox74+Safari11.1+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.actualBoundingBoxRight

TextMetrics/actualBoundingBoxRight

すべての現在のエンジンでサポートされています。

Firefox74+Safari11.1+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.fontBoundingBoxAscent

TextMetrics/fontBoundingBoxAscent

すべての現在のエンジンでサポートされています。

Firefox116+Safari11.1+Chrome87+
Opera?Edge87+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.fontBoundingBoxDescent

TextMetrics/fontBoundingBoxDescent

すべての現在のエンジンでサポートされています。

Firefox116+Safari11.1+Chrome87+
Opera?Edge87+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.actualBoundingBoxAscent

TextMetrics/actualBoundingBoxAscent

すべての現在のエンジンでサポートされています。

Firefox74+Safari11.1+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.actualBoundingBoxDescent

TextMetrics/actualBoundingBoxDescent

すべての現在のエンジンでサポートされています。

Firefox74+Safari11.1+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.emHeightAscent

TextMetrics/emHeightAscent

すべての現在のエンジンでサポートされています。

Firefox🔰 74+Safari11.1+Chrome🔰 35+
Opera?Edge🔰 79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.emHeightDescent

TextMetrics/emHeightDescent

すべての現在のエンジンでサポートされています。

Firefox🔰 74+Safari11.1+Chrome🔰 35+
Opera?Edge🔰 79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.hangingBaseline

TextMetrics/hangingBaseline

Firefox🔰 74+Safari11.1+Chromeサポートなし
Opera?Edgeサポートなし
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.alphabeticBaseline

TextMetrics/alphabeticBaseline

Firefox🔰 74+Safari11.1+Chromeサポートなし
Opera?Edgeサポートなし
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
metrics.ideographicBaseline

TextMetrics/ideographicBaseline

Firefox🔰 74+Safari11.1+Chromeサポートなし
Opera?Edgeサポートなし
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

次の測定値を返します。

実装するオブジェクト CanvasText インターフェイスは、テキストをレンダリングするために次のメソッドを提供します。

fillText(text, x, y, maxWidth) および strokeText(text, x, y, maxWidth) メソッドは、指定された (x, y) 座標で text をレンダリングし、指定されている場合は maxWidth よりも幅が広くならないようにします。これには、現在の font、textAlign、および textBaseline の値が使用されます。具体的には、メソッドが呼び出されると、ユーザーエージェントは次のステップを実行しなければなりません：

  1. 引数のいずれかが無限大または NaN の場合は、処理を終了します。

  2. テキスト準備アルゴリズム を実行し、text、CanvasText インターフェイスを実装するオブジェクト、および maxWidth 引数が指定されている場合はその引数を渡します。glyphs を結果とします。

  3. glyphs 内のすべての形状を右に x CSS ピクセル だけ、下に y CSS ピクセル だけ移動させます。

  4. 現在の 変換行列 によって変形された glyphs 内の形状を描画します。各 CSS ピクセル は、glyphs の座標空間内で 1 つの座標空間単位にマッピングされます。

    fillText() の場合、this の 塗りつぶしスタイル が形状に適用され、this の ストロークスタイル は無視されます。strokeText() の場合はその逆です：this の ストロークスタイル が形状の トレース に適用され、this の 塗りつぶしスタイル は無視されます。

    これらの形状は現在のパスに影響を与えずに描画され、シャドウ効果、グローバルアルファ、クリッピング領域、および 現在の合成およびブレンド演算子 の影響を受けます。

(これはトラッキングベクターです。) measureText(text)メソッドのステップは、textとCanvasTextインターフェースを実装するオブジェクトを渡してテキスト準備アルゴリズムを実行し、その後、返されたインラインボックスを使用して、次のリストで説明されているように動作するメンバーを持つ新しいTextMetricsオブジェクトを返します。[CSS]

width 属性

その インラインボックス の幅で、 CSS ピクセル で表されます。 (テキストのアドバンス幅。)

actualBoundingBoxLeft 属性

基準線から textAlign 属性によって指定された整列点までの距離で、テキストのバウンディング ボックスの左側までの距離を CSS ピクセル で表します; 正の 数値は指定された整列点から左方向の距離を示します。

この値と次の値 (actualBoundingBoxRight) の合計は インラインボックス (width) よりも広くなる可能性があります。特に、スラントフォントでは文字がアドバンス幅を超えてはみ出すことがあります。

actualBoundingBoxRight 属性

基準線から textAlign 属性によって指定された整列点までの距離で、テキストのバウンディング ボックスの右側までの距離を CSS ピクセル で表します; 正の 数値は指定された整列点から右方向の距離を示します。

fontBoundingBoxAscent 属性

基準線から textBaseline 属性によって示された水平線までの距離で、アセント メトリック を 最初に利用可能なフォント で表したもので、CSS ピクセル で表されます; 正の数値は指定された基準線から上方向の距離を示します。

この値と次の値は、描画するテキストが変更されても背景の高さを一貫して保つ必要がある場合に役立ちます。actualBoundingBoxAscent 属性（およびそれに対応する降下の属性）は、特定のテキスト周りのバウンディングボックスを描画する際に役立ちます。

fontBoundingBoxDescent 属性

基準線から textBaseline 属性によって示された水平線までの距離で、降下 メトリック を 最初に利用可能なフォント で表したもので、CSS ピクセル で表されます; 正の数値は指定された基準線から下方向の距離を示します。

actualBoundingBoxAscent 属性

基準線から textBaseline 属性によって示された水平線までの距離で、テキストのバウンディング ボックスの上部までの距離を CSS ピクセル で表します; 正の 数値は指定された基準線から上方向の距離を示します。

この数値は入力テキストによって大きく変わる可能性があり、最初に指定されたフォントが入力内のすべての文字をカバーしていても変わることがあります。例えば、actualBoundingBoxAscent の小文字の "o" の場合、アルファベティック基準線 からの距離は大文字の "F" よりも小さいです。値は簡単に負になることがあります; 例えば、em ボックスの上部からの距離 (textBaseline 値 "top") が単一のコンマ "," のテキストの場合、バウンディングボックスの上部までの距離は負になる可能性が高いです。

actualBoundingBoxDescent 属性

基準線から textBaseline 属性によって示された水平線までの距離で、テキストのバウンディング ボックスの下部までの距離を CSS ピクセル で表します; 正の 数値は指定された基準線から下方向の距離を示します。

emHeightAscent 属性

textBaseline 属性で示される水平線から、インラインボックス内の em-over ベースラインまでの距離（CSS ピクセル単位）。 正の数は、指定されたベースラインが em-over ベースラインより下にあることを示します（したがって、この値は通常正になります）。指定されたベースラインが em-over ベースラインの場合はゼロ。指定されたベースラインが em-over ベースラインと em-under ベースラインの中間にある場合はフォントサイズの半分。

emHeightDescent 属性

textBaseline 属性で示される水平線から、インラインボックス内の em-under ベースラインまでの距離（CSS ピクセル単位）。 正の数は、指定されたベースラインが em-under ベースラインより上にあることを示します。 （指定されたベースラインが em-under ベースラインの場合はゼロ。）

hangingBaseline 属性

基準線から textBaseline 属性によって示された水平線までの距離で、ハンギング 基準線 までの距離を CSS ピクセル で表します; 正の数値は指定された基準線がその ハンギング 基準線 より下にあることを示します。（指定された基準線がその ハンギング 基準線 である場合はゼロです。）

alphabeticBaseline 属性

基準線から textBaseline 属性によって示された水平線までの距離で、アルファベティック 基準線 までの距離を CSS ピクセル で表します; 正の数値は指定された基準線がその アルファベティック 基準線 より下にあることを示します。（指定された基準線がその アルファベティック基準線 である場合はゼロです。）

ideographicBaseline 属性

基準線から textBaseline 属性によって示された水平線までの距離で、表意的下基準線 までの距離を CSS ピクセル で表します; 正の数値は指定された基準線がその 表意的下基準線 より下にあることを示します。（指定された基準線がその 表意的下基準線 である場合はゼロです。）

fillText() および strokeText() を使用してレンダリングされたグリフは、フォントサイズと measureText() によって返される幅（テキスト幅）によって指定されるボックスからはみ出す可能性があります。これが問題となる場合、作成者は上記で説明したバウンディングボックスの値を使用することが推奨されます。

将来の 2D コンテキスト API のバージョンでは、CSS を使用してレンダリングされたドキュメントの断片を直接キャンバスにレンダリングする方法が提供されるかもしれません。これは、専用のマルチラインレイアウト方法に優先されるでしょう。

4.12.5.1.13 キャンバスへのパスの描画

CanvasDrawPath インターフェイスを実装するオブジェクトには、現在のデフォルトパスがあります。描画状態の一部ではありませんが、現在のデフォルトパスは、上記で説明したパスです。

context.beginPath()

CanvasRenderingContext2D/beginPath

全ての最新エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のデフォルトパスをリセットします。

context.fill([ fillRule ])

CanvasRenderingContext2D/fill

全ての最新エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
context.fill(path [, fillRule ])

指定されたパスまたは現在のデフォルトパスのサブパスを現在の塗りつぶしスタイルで塗りつぶします。

context.stroke()

CanvasRenderingContext2D/stroke

全ての最新エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
context.stroke(path)

指定されたパスまたは現在のデフォルトパスのサブパスを現在のストロークスタイルで描画します。

context.clip([ fillRule ])

CanvasRenderingContext2D/clip

全ての最新エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
context.clip(path [, fillRule ])

指定されたパスまたは現在のデフォルトパスのクリッピング領域をさらに制約し、指定された塗りつぶしルールを使用してパス内の点を決定します。

context.isPointInPath(x, y [, fillRule ])

CanvasRenderingContext2D/isPointInPath

全ての最新エンジンでサポートされています。

Firefox2+Safari3.1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
context.isPointInPath(path, x, y [, fillRule ])

指定された点が、現在のストロークスタイルを考慮して、現在のデフォルトパスまたは指定されたパスのストロークで覆われた領域にある場合、trueを返します。

beginPath()メソッドのステップは、this の 現在のデフォルトパス のサブパスのリストをクリアして、再びサブパスがゼロになるようにします。

次のメソッド定義で 意図されたパス という用語が Path2Dまたはnullのpathを指す場合、それは Path2D オブジェクト自体か、そうでなければ 現在のデフォルトパス を意味します。

意図されたパスがPath2Dオブジェクトである場合、そのサブパスの座標と線は、CanvasTransformインターフェイスを実装するオブジェクト上の現在の変換行列に従って変換されます（Path2Dオブジェクト自体には影響を与えません）。意図されたパスが現在のデフォルトパスである場合、それは変換の影響を受けません（これは、変換が構築時にすでに現在のデフォルトパスに影響を与えるため、それが描画されるときに適用すると二重変換が発生するためです）。

fill(fillRule)メソッドのステップは、塗りつぶしのステップをthis、null、およびfillRuleを使用して実行することです。

fill(path, fillRule)メソッドのステップは、塗りつぶしのステップをthis、path、およびfillRuleを使用して実行することです。

塗りつぶしのステップは、CanvasDrawPathcontext、Path2Dまたはnullのpath、および塗りつぶしルールfillRuleを指定して、意図されたパスの全サブパスを、contextの塗りつぶしスタイルを使用して塗りつぶし、fillRuleで指定された塗りつぶしルールを使用して塗りつぶします。開いたサブパスは塗りつぶし時に暗黙的に閉じられる必要があります（実際のサブパスには影響を与えません）。

stroke()メソッドのステップは、ストロークのステップをthisとnullを使用して実行することです。

stroke(path)メソッドのステップは、ストロークのステップをthisとpathを使用して実行することです。

ストロークのステップは、CanvasDrawPathcontextとPath2Dまたはnullのpathを指定して、意図されたパスをpathに対してトレースし、その後、contextのストロークスタイルを使用して塗りつぶし、非ゼロ巻きルールを使用してストロークします。

パスをトレースするアルゴリズムの定義方法の結果として、1回のストローク操作でのパスの重複部分は、その合併が描画されたかのように扱われます。

ストロークのスタイルは、現在のデフォルトパスが使用されている場合でも、描画中に変換の影響を受けます。

パスは、塗りつぶされるかストロークされるとき、現在のデフォルトパスやPath2Dオブジェクトに影響を与えることなく、影の効果、グローバルアルファ、クリッピング領域、および現在の合成およびブレンドオペレーターの対象とされる必要があります。（変換の影響は上記に説明されており、使用するパスに基づいて異なります。）

clip(fillRule)メソッドのステップは、クリップのステップをthis、null、およびfillRuleを使用して実行することです。

clip(path, fillRule)メソッドのステップは、クリップのステップをthis、path、およびfillRuleを使用して実行することです。

クリップのステップは、CanvasDrawPathcontext、Path2Dまたはnullのpath、および塗りつぶしルールfillRuleを指定して、新しいクリッピング領域を作成し、意図されたパスが塗りつぶしルールに従ってパス内の点を決定し、その領域を交差させることで、contextの現在のクリッピング領域とpathのクリッピング領域を作成します。新しいクリッピング領域は、現在のクリッピング領域に置き換わります。

コンテキストが初期化されると、その現在のクリッピング領域は無限大の表面に設定されます（つまり、デフォルトではクリッピングは発生しません）。

isPointInPath(x, y, fillRule)メソッドの手順は、this、null、x、y、fillRuleを与えて、パス内にポイントがあるかを確認する手順の結果を返すことです。

isPointInPath(path, x, y, fillRule)メソッドの手順は、this、path、x、y、fillRuleを与えて、パス内にポイントがあるかを確認する手順の結果を返すことです。

パス内にポイントがあるかを確認する手順では、CanvasDrawPath context、Path2Dまたはnullのpath、二つの数値xおよびy、および塗りつぶしルール fillRuleを次の手順に従って処理します:

  1. xまたはyが無限大かNaNの場合、falseを返します。

  2. 現在の変換に影響されないキャンバス座標空間でのxおよびyの座標が、pathの意図されたパスの内部にある場合（fillRuleで示される塗りつぶしルールに従って判断される）、trueを返します。実際のサブパスに影響を与えずに、開いているサブパスは塗りつぶし時に暗黙的に閉じる必要があります。パス自体の上のポイントは、パスの内部にあるものと見なされます。

  3. falseを返します。

isPointInStroke(x, y)メソッドの手順は、this、null、x、およびyを与えて、ストローク内にポイントがあるかを確認する手順の結果を返すことです。

isPointInStroke(path, x, y)メソッドの手順は、this、path、x、およびyを与えて、ストローク内にポイントがあるかを確認する手順の結果を返すことです。

ストローク内にポイントがあるかを確認する手順では、CanvasDrawPath context、Path2Dまたはnullのpath、および二つの数値xおよびyを次の手順に従って処理します:

  1. xまたはyが無限大かNaNの場合、falseを返します。

  2. 現在の変換に影響されないキャンバス座標空間でのxおよびyの座標が、トレースした pathの意図されたパスから得られるパスの内部にある場合、かつ非ゼロワインディングルールを使用している場合、trueを返します。生成されたパス上のポイントは、パスの内部にあるものと見なされます。

  3. falseを返します。

このキャンバス要素には、いくつかのチェックボックスがあります。パス関連のコマンドが強調表示されています: 

<canvas height=400 width=750>
  <label><input type=checkbox id=showA> Show As</label>
  <label><input type=checkbox id=showB> Show Bs</label>
  <!-- ... -->
 </canvas>
 <script>
  function drawCheckbox(context, element, x, y, paint) {
    context.save();
    context.font = '10px sans-serif';
    context.textAlign = 'left';
    context.textBaseline = 'middle';
    var metrics = context.measureText(element.labels[0].textContent);
    if (paint) {
      context.beginPath();
      context.strokeStyle = 'black';
      context.rect(x-5, y-5, 10, 10);
      context.stroke();
      if (element.checked) {
        context.fillStyle = 'black';
        context.fill();
      }
      context.fillText(element.labels[0].textContent, x+5, y);
    }
    context.beginPath();
    context.rect(x-7, y-7, 12 + metrics.width+2, 14);
 
    context.drawFocusIfNeeded(element);
    context.restore();
  }
  function drawBase() { /* ... */ }
  function drawAs() { /* ... */ }
  function drawBs() { /* ... */ }
  function redraw() {
    var canvas = document.getElementsByTagName('canvas')[0];
    var context = canvas.getContext('2d');
    context.clearRect(0, 0, canvas.width, canvas.height);
    drawCheckbox(context, document.getElementById('showA'), 20, 40, true);
    drawCheckbox(context, document.getElementById('showB'), 20, 60, true);
    drawBase();
    if (document.getElementById('showA').checked)
      drawAs();
    if (document.getElementById('showB').checked)
      drawBs();
  }
  function processClick(event) {
    var canvas = document.getElementsByTagName('canvas')[0];
    var context = canvas.getContext('2d');
    var x = event.clientX;
    var y = event.clientY;
    var node = event.target;
    while (node) {
      x -= node.offsetLeft - node.scrollLeft;
      y -= node.offsetTop - node.scrollTop;
      node = node.offsetParent;
    }
    drawCheckbox(context, document.getElementById('showA'), 20, 40, false);
    if (context.isPointInPath(x, y))
      document.getElementById('showA').checked = !(document.getElementById('showA').checked);
    drawCheckbox(context, document.getElementById('showB'), 20, 60, false);
    if (context.isPointInPath(x, y))
      document.getElementById('showB').checked = !(document.getElementById('showB').checked);
    redraw();
  }
  document.getElementsByTagName('canvas')[0].addEventListener('focus', redraw, true);
  document.getElementsByTagName('canvas')[0].addEventListener('blur', redraw, true);
  document.getElementsByTagName('canvas')[0].addEventListener('change', redraw, true);
  document.getElementsByTagName('canvas')[0].addEventListener('click', processClick, false);
  redraw();
 </script>
4.12.5.1.14 フォーカスリングの描画
context.drawFocusIfNeeded(element)

CanvasRenderingContext2D/drawFocusIfNeeded

すべての現在のエンジンでサポートされています。

Firefox32+Safari8+Chrome37+
Opera?Edge79+
Edge (Legacy)14+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

もしelementがフォーカスされている場合、プラットフォームのフォーカスリングの規約に従って、 現在のデフォルトパスの周りにフォーカスリングを描画します。

context.drawFocusIfNeeded(path, element)

もしelementがフォーカスされている場合、プラットフォームのフォーカスリングの規約に従って pathの周りにフォーカスリングを描画します。

フォーカスリングを描画するために、CanvasUserInterfaceインターフェースを実装するオブジェクトは以下のメソッドを提供します。

drawFocusIfNeeded(element) メソッドのステップは、フォーカスが必要な場合に描画します。 thisを指定して、elementとthisの現在のデフォルトパスを用いて描画します。

drawFocusIfNeeded(path, element) メソッドのステップは、フォーカスが必要な場合に描画します。 this、element、およびpathを指定して描画します。

オブジェクトがCanvasUserInterfaceを実装している場合、 context、要素element、およびパス pathが指定されている時のフォーカスを描画します。

  1. もしelementがフォーカスされていないか、contextのcanvas要素の子孫ではない場合、何も行いません。

  2. プラットフォームの規約に従って、pathに沿って適切なスタイルのフォーカスリングを描画します。

    一部のプラットフォームでは、キーボードからフォーカスされた要素の周りにのみフォーカスリングを描画し、マウスからフォーカスされたものには描画しません。他のプラットフォームでは、関連するアクセシビリティ機能が有効でない限り、いくつかの要素の周りにはフォーカスリングを全く描画しないことがあります。このAPIはこれらの規約に従うことを意図しています。要素がフォーカスされる方法に基づいて区別を実装するユーザーエージェントは、focus()メソッドによってトリガーされたユーザーインタラクションイベントの種類に基づいてフォーカスを分類することが推奨されます。

    フォーカスリングは、シャドウ効果、 グローバルアルファ、 現在の合成およびブレンディングオペレータ、 塗りつぶしスタイル、 ストロークスタイル、 またはCanvasPathDrawingStyles、 CanvasTextDrawingStyles インターフェースのいずれのメンバーも対象とすべきではありませんが、クリッピング領域に従うべきです。(変換の影響は上記に記述されており、使用されるパスによって異なります。)

  3. ユーザーに通知し、意図したパスによって指定された場所にフォーカスがあることを知らせます。ユーザーエージェントは、次にイベントループがレンダリングの更新ステップに達するまで待って、オプションでユーザーに通知することができます。

フォーカスリングを描画する際に、ユーザーエージェントは意図したパス内の開いたサブパスを暗黙的に閉じるべきではありません。

これは、おそらく議論の余地がある点です。たとえば、フォーカスリングが意図したパス内の点の周りに軸に沿った境界ボックスとして描かれる場合、サブパスが閉じているかどうかは影響しません。この仕様では、フォーカスリングがどのように描かれるかを正確に指定していません。ユーザーエージェントは、プラットフォームのネイティブな規約を尊重することが求められます。

このセクションで使用される「ユーザーに通知する」という表現は、永続的な状態の変更を意味するものではありません。たとえば、システムのアクセシビリティAPIを呼び出して、ユーザーの拡大ツールなどの支援技術に通知し、ユーザーの拡大鏡がキャンバスの指定された領域に移動するようにすることを意味する可能性があります。しかし、それはパスを要素に関連付けたり、触覚フィードバック用の領域を提供したりするものではありません。

4.12.5.1.15 画像の描画

CanvasDrawImageインターフェースを実装するオブジェクトには、画像を描画するための drawImage()メソッドがあります。

このメソッドは、3つの異なる引数のセットで呼び出すことができます:

context.drawImage(image, dx, dy)

CanvasRenderingContext2D/drawImage

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
context.drawImage(image, dx, dy, dw, dh)
context.drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh)

指定された画像をキャンバスに描画します。引数は以下のように解釈されます:

sx と sy パラメータはソース矩形の x および y 座標を指定し、sw および sh 引数はソース矩形の幅と高さを指定します。dx および dy は目的地矩形の x および y 座標を指定し、dw および dh 引数は目的地矩形の幅と高さを指定します。

画像がまだ完全にデコードされていない場合、何も描画されません。画像がデータのないキャンバスである場合、"InvalidStateError" DOMExceptionがスローされます。

drawImage()メソッドが呼び出されると、 ユーザーエージェントは以下の手順を実行する必要があります:

  1. 引数のいずれかが無限大またはNaNである場合、何も返さない。

  2. usabilityをimage引数の有用性のチェックの結果として定義する。

  3. usabilityが悪い場合、何も描画せずに終了する。

  4. ソースと目的地の矩形を次のように設定します:

    dwとdhの引数が指定されていない場合、それらはswとshの値にデフォルト設定されるものとし、 画像の1CSSピクセルが 出力ビットマップの座標空間内の1単位として扱われるように解釈されるものとする。 sx、sy、sw、およびshの引数が省略された場合、それらは0、0、画像の自然な幅 （画像ピクセル単位）、および画像の自然な高さ （画像ピクセル単位）にデフォルト設定されるものとする。 画像に自然な寸法がない場合は、具体的なオブジェクトサイズが代わりに使用され、 それはCSS "具体的なオブジェクトサイズ解決"アルゴリズムを使用して決定されるものとする。 指定されたサイズに明確な幅も高さも、追加の制約もない場合、オブジェクトの自然なプロパティは image引数のものとし、デフォルトのオブジェクトサイズは 出力ビットマップのサイズとする。[CSSIMAGES]

    ソース矩形は、4つの点(sx, sy), (sx+sw, sy), (sx+sw, sy+sh), (sx, sy+sh)を持つ矩形です。

    目的地の矩形は、4つの点(dx, dy), (dx+dw, dy), (dx+dw, dy+dh), (dx, dy+dh)を持つ矩形です。

    ソース矩形がソース画像の外にある場合、ソース矩形はソース画像にクリップされ、目的地矩形も同じ比率でクリップされなければなりません。

    目的地の矩形が目的地画像（出力ビットマップ）の外にある場合、目的地矩形の外側に位置するピクセルは破棄されます。これは、目的地が無限キャンバスであり、そのレンダリングが出力ビットマップの寸法にクリップされたかのように扱われます。

  5. swまたはshのいずれかがゼロの場合、何も返さず終了します。何も描画されません。

  6. image引数で指定された領域を、レンダリングコンテキストの出力ビットマップの指定された領域に描画し、 現在の変換行列を目的地矩形に適用します。

    画像データは元の方向で処理されなければなりません。たとえ指定された寸法が負であっても。

    拡大する際、imageSmoothingEnabled属性がtrueに設定されている場合、 ユーザーエージェントは画像データがスケーリングされる際にスムージングアルゴリズムを適用しようとする必要があります。 複数のフィルタリングアルゴリズムをサポートしているユーザーエージェントは、 imageSmoothingQuality属性の値を使用して フィルタリングアルゴリズムの選択をガイドすることができます。 それ以外の場合は、画像はニアレストネイバー補間を使用してレンダリングされなければなりません。

    この仕様は、画像を縮小するとき、またはimageSmoothingEnabled 属性がtrueに設定されている場合に画像を拡大するときに使用する正確なアルゴリズムを定義していません。

    あるcanvas要素が 自分自身に描画される場合、描画モデルは画像が描画される前にソースがコピーされることを要求するため、 canvas要素の一部を 自分自身の重なり合う部分にコピーすることが可能です。

    元の画像データがビットマップ画像である場合、目的地矩形のポイントで描画される値は、元の画像データをフィルタリングすることで計算されます。 ユーザーエージェントは任意のフィルタリングアルゴリズム（例えばバイリニア補間やニアレストネイバー）を使用することができます。 フィルタリングアルゴリズムが元の画像データの外部からピクセル値を必要とする場合、 代わりに最も近いエッジピクセルの値を使用しなければなりません。（つまり、フィルタは「エッジにクランプ」動作を使用します。） フィルタリングアルゴリズムがソース矩形の外部だが元の画像データ内にあるピクセル値を必要とする場合、 元の画像データの値が使用されなければなりません。

    したがって、画像を部分的にまたは全体的にスケーリングすることは同じ効果を持ちます。 これにより、単一のスプライトシートからスプライトをスケーリングする場合、 スプライトシート内の隣接する画像が干渉する可能性があります。 これを回避するには、シート内の各スプライトが透明な黒の境界で囲まれていることを確認するか、 スケーリングするスプライトを一時的なcanvas要素にコピーし、 そこからスケーリングされたスプライトを描画することで回避できます。

    画像は現在のパスに影響を与えることなく描画され、影効果、 グローバルアルファ、 クリッピング領域、 現在の合成およびブレンディングオペレータの影響を受けます。

  7. imageがクリーンなオリジンでない場合、 CanvasRenderingContext2Dのオリジンクリーンフラグをfalseに設定します。

4.12.5.1.16 ピクセル操作
imageData = context.createImageData(imageData)

引数と同じ寸法と色空間を持つImageDataオブジェクトを返します。返されるオブジェクト内のすべてのピクセルは透明な黒です。

imageData = context.createImageData(sw, sh [, settings])

CanvasRenderingContext2D/createImageData

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定された寸法を持つImageDataオブジェクトを返します。返されるオブジェクトの色空間は、contextの色空間です（settingsで上書きされていない限り）。返されるオブジェクト内のすべてのピクセルは透明な黒です。

幅または高さのいずれかの引数がゼロの場合、"IndexSizeError" DOMExceptionをスローします。

imageData = context.getImageData(sx, sy, sw, sh [, settings])

CanvasRenderingContext2D/getImageData

すべての現在のエンジンでサポートされています。

Firefox2+Safari4+Chrome2+
Opera9.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

ビットマップの指定された矩形に対応するイメージデータを含むImageDataオブジェクトを返します。返されるオブジェクトの色空間は、contextの色空間です（settingsで上書きされていない限り）。

幅または高さのいずれかの引数がゼロの場合、"IndexSizeError" DOMExceptionをスローします。

context.putImageData(imageData, dx, dy [, dirtyX, dirtyY, dirtyWidth, dirtyHeight ])

CanvasRenderingContext2D/putImageData

すべての現在のエンジンでサポートされています。

Firefox2+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定されたImageDataオブジェクトからビットマップにデータを描画します。汚れた矩形が指定されている場合、その矩形のピクセルのみが描画されます。

このメソッド呼び出しに関して、globalAlphaとglobalCompositeOperationプロパティ、およびシャドウ属性は無視されます。キャンバス内のピクセルは、合成、アルファブレンディング、シャドウなどなしで完全に置き換えられます。

もしimageDataオブジェクトのdata属性値の[[ViewedArrayBuffer]]内部スロットが切り離されている場合、"InvalidStateError" DOMExceptionをスローします。

CanvasImageData インターフェイスを実装するオブジェクトは、ビットマップに対するピクセルデータの読み書きのために以下のメソッドを提供します。

createImageData(sw, sh, settings) メソッドの手順は次の通りです：

  1. sw と sh の一方または両方がゼロの場合、"IndexSizeError" DOMException をスローします。

  2. newImageData を新しい ImageData オブジェクトとします。

  3. sw の絶対値、sh の絶対値、settings、および this の 色空間に設定された defaultColorSpace を指定して、newImageData を初期化します。

  4. newImageData の画像データを透明な黒に初期化します。

  5. newImageData を返します。

createImageData(imageData) メソッドのステップは次のとおりです。

  1. newImageData を新しい ImageData オブジェクトとします。

  2. settings を ImageDataSettings オブジェクト «[ "colorSpace" → this の colorSpace, "pixelFormat" → this の pixelFormat ]» とします。

  3. imageData の width 属性の値、imageData の height 属性の値、および settings を指定して、newImageData を初期化します。

  4. newImageData の画像データを透明な黒に初期化します。

  5. newImageData を返します。

getImageData(sx, sy, sw, sh, settings) メソッドの手順は次の通りです：

  1. sw または sh 引数のいずれかがゼロの場合、"IndexSizeError" DOMException をスローします。

  2. CanvasRenderingContext2D の オリジンクリーンフラグが false に設定されている場合、"SecurityError" DOMException をスローします。

  3. imageData を新しい ImageData オブジェクトとします。

  4. sw、sh、settings、および this の 色空間に設定された defaultColorSpace を指定して、imageData を初期化します。

  5. ソース矩形を、角が 4 点 (sx, sy)、(sx+sw, sy)、(sx+sw, sy+sh)、(sx, sy+sh) である矩形とします。

  6. imageData のピクセル値を、this の 出力ビットマップの、ビットマップの座標空間単位でソース矩形によって指定された領域のピクセルに設定します。これは、'relative-colorimetric' レンダリングインテントを使用して、this の 色空間から imageData の colorSpace に変換されます。

  7. 出力ビットマップの外側にあるソース矩形の領域に対して、imageData のピクセル値を透明な黒に設定します。

  8. imageData を返します。

putImageData(imageData, dx, dy) メソッドのステップは、imageData、これの 出力ビットマップ、dx、dy、0、0、imageData の width、および imageData の height を指定して、ImageData からビットマップにピクセルを配置することです。

putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight) メソッドのステップは、imageData、これの 出力ビットマップ、dx、dy、dirtyX、dirtyY、dirtyWidth、および dirtyHeight を指定して、ImageData からビットマップにピクセルを配置することです。

ImageData imageData、出力ビットマップ bitmap、および数値 dx、dy、dirtyX、dirtyY、dirtyWidth、および dirtyHeight を指定して、ImageData からビットマップにピクセルを配置するには：

  1. buffer を imageData の data 属性値の [[ViewedArrayBuffer]] 内部スロットとします。

  2. IsDetachedBuffer(buffer) が true の場合、"InvalidStateError" DOMException をスローします。

  3. dirtyWidth が負の場合、dirtyX を dirtyX+dirtyWidth とし、dirtyWidth を dirtyWidth の絶対値と等しくします。

    dirtyHeight が負の場合、dirtyY を dirtyY+dirtyHeight とし、dirtyHeight を dirtyHeight の絶対値と等しくします。

  4. dirtyX が負の場合、dirtyWidth を dirtyWidth+dirtyX とし、dirtyX をゼロとします。

    dirtyY が負の場合、dirtyHeight を dirtyHeight+dirtyY とし、dirtyY をゼロとします。

  5. dirtyX+dirtyWidth が imageData 引数の width 属性より大きい場合、dirtyWidth をその width 属性の値から dirtyX の値を引いた値とします。

    dirtyY+dirtyHeight が imageData 引数の height 属性より大きい場合、dirtyHeight をその height 属性の値から dirtyY の値を引いた値とします。

  6. これらの変更後、dirtyWidth または dirtyHeight のいずれかが負またはゼロの場合、ビットマップに影響を与えずに戻ります。

  7. dirtyX ≤ x < dirtyX+dirtyWidth かつ dirtyY ≤ y < dirtyY+dirtyHeight であるすべての整数値 x および y について、bitmap 内の座標 (dx+x, dy+y) のピクセルを、imageData データ構造の ビットマップ内の座標 (x, y) のピクセルの色に設定します。これは、'relative-colorimetric' レンダリングインテントを使用して、imageData の colorSpace から bitmap の 色空間に変換されます。

色空間間の変換と プリマルチプライド・アルファ カラー値の変換の間の損失特性のため、 putImageData() を使用して設定されたばかりのピクセルが、完全に不透明でない場合、 getImageData() を介して取得されると、異なる値として返される可能性があります。

現在のパス、 変換行列、 影属性、 グローバル・アルファ、 クリッピング領域、および 現在の合成およびブレンド演算子 は、このセクションで説明されているメソッドに影響を与えてはなりません。

次の例では、スクリプトがImageDataオブジェクトを生成して描画できるようにしています。

// canvasは<canvas>要素への参照です
var context = canvas.getContext('2d');

// 空のキャンバスを作成します
var data = context.createImageData(canvas.width, canvas.height);

// プラズマを作成します
FillPlasma(data, 'green'); // 緑色のプラズマ

// プラズマに雲を追加します
AddCloud(data, data.width/2, data.height/2); // 中央に雲を追加

// プラズマ+雲をキャンバスに描画します
context.putImageData(data, 0, 0);

// サポートメソッド
function FillPlasma(data, color) { ... }
function AddCloud(data, x, y) { ... }

ここでは、エッジ検出フィルターを実装するために、getImageData()とputImageData()を使用する例を示します。 

<!DOCTYPE HTML>
<html lang="en">
<head>
<title>エッジ検出デモ</title>
<script>
var image = new Image();
function init() {
image.onload = demo;
image.src = "image.jpeg";
}
function demo() {
var canvas = document.getElementsByTagName('canvas')[0];
var context = canvas.getContext('2d');

// 画像をキャンバスに描画します
context.drawImage(image, 0, 0);

// 操作するために画像データを取得します
var input = context.getImageData(0, 0, canvas.width, canvas.height);

// データを入れるための空のキャンバスを取得します
var output = context.createImageData(canvas.width, canvas.height);

// 便利なようにいくつかの変数をエイリアスします
// この場合、input.widthとinput.heightは
// canvas.widthとcanvas.heightに一致します
// しかし、コードを汎用的に保つために前者を使用します。
var w = input.width, h = input.height;
var inputData = input.data;
var outputData = output.data;

// エッジ検出
for (var y = 1; y < h-1; y += 1) {
for (var x = 1; x < w-1; x += 1) {
for (var c = 0; c < 3; c += 1) {
var i = (y*w + x)*4 + c;
outputData[i] = 127 + -inputData[i - w*4 - 4] - inputData[i - w*4] - inputData[i - w*4 + 4] +
                                -inputData[i - 4]       + 8*inputData[i]       - inputData[i + 4] +
                                -inputData[i + w*4 - 4] - inputData[i + w*4] - inputData[i + w*4 + 4];
}
outputData[(y*w + x)*4 + 3] = 255; // アルファ
}
}

// 操作後に画像データを戻します
context.putImageData(output, 0, 0);
}
</script>
</head>
<body onload="init()">
<canvas></canvas>
</body>
</html>

次に、単色を描画して結果を読み戻す際に適用される色空間変換の例を示します。このときgetImageData()が使用されます。 

<!DOCTYPE HTML>
<html lang="en">
<title>色空間イメージデータデモ</title>

<canvas></canvas>

<script>
const canvas = document.querySelector('canvas');
const context = canvas.getContext('2d', {colorSpace:'display-p3'});

// 赤い長方形を描画します。なお、16進数の色表記は
// sRGBカラーを指定します。
context.fillStyle = "#FF0000";
context.fillRect(0, 0, 64, 64);

// 画像データを取得します。
const pixels = context.getImageData(0, 0, 1, 1);

// これは'display-p3'を出力します。これは、キャンバスの色空間で画像データが
// 返されるデフォルト動作を反映しています。
console.log(pixels.colorSpace);

// これは値234、51、および35を出力します。
// これは'display-p3'に変換された赤の塗りつぶし色を反映しています。
console.log(pixels.data[0]);
console.log(pixels.data[1]);
console.log(pixels.data[2]);
</script>
4.12.5.1.17 合成
context.globalAlpha [ = value ]

CanvasRenderingContext2D/globalAlpha

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のレンダリング操作に適用されるグローバルアルファ値を返します。

設定すると、グローバルアルファ値を変更できます。範囲外の値 (0.0 ～ 1.0) は無視されます。

context.globalCompositeOperation [ = value ]

CanvasRenderingContext2D/globalCompositeOperation

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

現在の合成およびブレンド操作を返します。これらの値は、Compositing and Blendingで定義されています。[COMPOSITE]

設定すると、現在の合成およびブレンド操作を変更できます。不明な値は無視されます。

CanvasCompositingインターフェースを実装するオブジェクトは、すべての描画操作に影響を与えるグローバルアルファ値と現在の合成およびブレンド操作値を持っています。

グローバルアルファ値は、出力ビットマップに合成される前に形状や画像に適用されるアルファ値を指定します。この値は、0.0（完全に透明）から1.0（追加の透明性なし）までの範囲で、初期値は1.0である必要があります。

globalAlphaゲッターステップは、thisのグローバルアルファを返すことです。

globalAlphaセッターステップは次のとおりです:

  1. 指定された値が無限大、NaN、または0.0から1.0の範囲外である場合、処理を終了します。

  2. それ以外の場合は、thisのグローバルアルファを指定された値に設定します。

現在の合成およびブレンド操作値は、出力ビットマップに描画される形状や画像の描画方法を制御します。これには、グローバルアルファおよび現在の変換行列が適用されます。初期設定では、「source-over」に設定されている必要があります。

globalCompositeOperationゲッターステップは、thisの現在の合成およびブレンド操作を返すことです。

globalCompositeOperationセッターステップは次のとおりです:

  1. 指定された値が完全に一致するいずれかの値ではない場合、処理を終了します。[COMPOSITE]

  2. それ以外の場合は、thisの現在の合成およびブレンド操作を指定された値に設定します。

4.12.5.1.18 画像のスムージング
context.imageSmoothingEnabled [ = value ]

CanvasRenderingContext2D/imageSmoothingEnabled

すべての現行エンジンでサポートされています。

Firefox51+Safari9.1+Chrome30+
Opera?Edge79+
Edge (Legacy)15+🔰 11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

パターンフィルと drawImage() メソッドが、画像のスケーリング時に、ピクセルが表示と正確に一致しない場合に画像をスムージングするかどうかを返します。

設定すると、画像がスムージングされるか（true）どうか（false）を変更できます。

context.imageSmoothingQuality [ = value ]

CanvasRenderingContext2D/imageSmoothingQuality

FirefoxなしSafari9.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

現在の画像スムージングの品質設定を返します。

設定すると、画像スムージングの優先品質を変更できます。利用可能な値は、"low"、"medium"、および"high"です。不明な値は無視されます。

CanvasImageSmoothingインターフェースを実装するオブジェクトには、画像スムージングの方法を制御する属性があります。

imageSmoothingEnabled属性は、取得時に最後に設定された値を返します。設定時には、新しい値に設定される必要があります。CanvasImageSmoothingインターフェースを実装するオブジェクトが作成されたとき、この属性は true に設定されている必要があります。

imageSmoothingQuality属性は、取得時に最後に設定された値を返します。設定時には、新しい値に設定される必要があります。CanvasImageSmoothingインターフェースを実装するオブジェクトが作成されたとき、この属性は"low"に設定されている必要があります。

4.12.5.1.19 シャドウ

CanvasShadowStyles インターフェースを実装するオブジェクトのすべての描画操作は、4つのグローバルシャドウ属性の影響を受けます。

context.shadowColor [ = value ]

CanvasRenderingContext2D/shadowColor

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のシャドウの色を返します。

設定することで、シャドウの色を変更できます。CSSカラーとして解析できない値は無視されます。

context.shadowOffsetX [ = value ]

CanvasRenderingContext2D/shadowOffsetX

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のシャドウのオフセットを返します。

設定することで、シャドウのオフセットを変更できます。有限の数値でない値は無視されます。

context.shadowOffsetY [ = value ]

CanvasRenderingContext2D/shadowOffsetY

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のシャドウのオフセットを返します。

設定することで、シャドウのオフセットを変更できます。有限の数値でない値は無視されます。

context.shadowBlur [ = value ]

CanvasRenderingContext2D/shadowBlur

すべての現行エンジンでサポートされています。

Firefox1.5+Safari2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のシャドウに適用されるぼかしのレベルを返します。

設定することで、ぼかしレベルを変更できます。有限でないか、ゼロ以上でない値は無視されます。

CanvasShadowStyles インターフェースを実装するオブジェクトには、CSSカラーである シャドウカラー が関連付けられています。初期状態では、この値は 透過黒 でなければなりません。

shadowColorのgetterの手順は、シリアライズをthisの影の色で行い、HTML互換のシリアライズが要求される場合として返します。

  1. context を this の canvas 属性の値に設定します（要素である場合）、それ以外の場合は null に設定します。

  2. parsedValue を CSSカラー値を解析 した結果に設定します（context が null でない場合）。

  3. parsedValue が失敗の場合、return します。

  4. this の シャドウカラー を parsedValue に設定します。

shadowOffsetX および shadowOffsetY 属性は、それぞれシャドウが正の水平方向および正の垂直方向にオフセットされる距離を指定します。これらの値は座標空間単位で指定され、現在の変換マトリックスの影響を受けません。

コンテキストが作成されると、シャドウオフセット属性の初期値は 0 に設定されている必要があります。

取得時には、現在の値を返します。設定時には、設定される属性は新しい値に設定される必要があります。ただし、その値が無限大または NaN の場合、新しい値は無視されなければなりません。

shadowBlur 属性は、ぼかし効果のレベルを指定します。（単位は座標空間単位に対応しておらず、現在の変換マトリックスの影響を受けません。）

コンテキストが作成されると、shadowBlur 属性は初期状態で 0 に設定されている必要があります。

取得時には、属性は現在の値を返す必要があります。設定時には、その属性は新しい値に設定される必要がありますが、その値が負の数、無限大、または NaN の場合、新しい値は無視されなければなりません。

シャドウが描画されるのは 、シャドウカラー のアルファコンポーネントの不透明度がゼロでなく、かつ shadowBlur がゼロでない場合、または shadowOffsetX がゼロでない場合、または shadowOffsetY がゼロでない場合に限られます。

シャドウが描画される 場合、以下のようにレンダリングされる必要があります:

  1. A を、シャドウが作成されるソース画像が描画された無限大の 透過黒 ビットマップに設定します。

  2. B を、座標空間と原点が A と同一である無限大の 透過黒 ビットマップに設定します。

  3. A のアルファ成分を、正の x 方向に shadowOffsetX、正の y 方向に shadowOffsetY オフセットして B にコピーします。

  4. shadowBlur が 0 より大きい場合:

    1. σ を shadowBlur の値の半分に設定します。

    2. B に対して 2D ガウスぼかしを実行し、標準偏差として σ を使用します。

    ユーザーエージェントは、ガウスぼかし操作中にハードウェアの制限を超えることを避けるために、σ の値を実装固有の最大値に制限することができます。

  5. B のすべてのピクセルの赤、緑、および青のコンポーネントを シャドウカラー の赤、緑、および青のコンポーネントに設定します。

  6. B のすべてのピクセルのアルファコンポーネントを シャドウカラー のアルファコンポーネントで乗算します。

  7. シャドウはビットマップ B にあり、以下で説明する 描画モデル の一部としてレンダリングされます。

現在の合成およびブレンドオペレーター が "コピー" である場合、シャドウは実際にはレンダリングされません（形状がシャドウを上書きするため）。

4.12.5.1.20 フィルター

CanvasFilters インターフェースを実装するオブジェクトに対するすべての描画操作は、グローバルな filter 属性の影響を受けます。

context.filter [ = value ]

CanvasRenderingContext2D/filter

Firefox49+SafariNoChrome52+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

現在のフィルターを返します。

設定することで、フィルターを変更できます。値は "none" という文字列、または <filter-value-list> として解析可能な文字列である必要があります。他の値は無視されます。

そのようなオブジェクトには、現在のフィルター と呼ばれる関連付けられた文字列があります。現在のフィルター は初期状態で "none" に設定されています。現在のフィルター の値が "none" であるとき、フィルターはコンテキストで無効になります。

filter の getter ステップは、this の 現在のフィルター を返します。

filter の setter ステップは次の通りです:

  1. 与えられた値が "none" である場合、this の 現在のフィルター を "none" に設定して終了します。

  2. parsedValue を、与えられた値を CSS 構文に従って解析 した結果に設定します。'inherit' や 'initial' などのプロパティに依存しないスタイルシートの構文が含まれている場合、この解析は失敗しなければなりません。

  3. parsedValue が失敗の場合、return します。

  4. this の 現在のフィルター を与えられた値に設定します。

context.filter = "none" はコンテキストのフィルターを無効にしますが、context.filter = ""、context.filter = null、およびcontext.filter = undefinedはすべて解析不可能な入力と見なされ、現在のフィルター の値は変更されません。

現在のフィルター の値に使用される座標は、1 ピクセルが 1 SVG ユーザースペース単位および 1 キャンバス座標空間単位に相当するように解釈されます。フィルターの座標は、現在の変換マトリックスの影響を受けません。現在の変換マトリックスはフィルターの入力のみに影響を与えます。フィルターは 出力ビットマップ の座標空間で適用されます。

現在のフィルター の値が、<filter-value-list> として解析可能な文字列で、長さをパーセンテージや 'em' または 'ex' 単位で定義する場合、これらは属性が設定された時点での計算値に対して相対的に解釈されなければなりません。これらの計算値が特定のケースで未定義の場合（例えば、フォントスタイルソースオブジェクトが要素でないか、レンダリングされていないため）、相対的なキーワードはフォント 属性のデフォルト値に対して解釈されなければなりません。'larger' および 'smaller' キーワードはサポートされていません。

現在のフィルター の値が、同じドキュメント内の SVG フィルターへの参照を含む<filter-value-list> として解析可能な文字列であり、その SVG フィルターが変更された場合、次の描画操作には変更されたフィルターが使用されます。

現在のフィルター の値が、外部リソースドキュメント内の SVG フィルターへの参照を含む<filter-value-list> として解析可能な文字列であり、そのドキュメントが描画操作の実行時に読み込まれていない場合、描画操作はフィルタリングなしで続行しなければなりません。

4.12.5.1.21 外部定義のSVGフィルターの使用

このセクションは規範的ではありません。

外部定義のフィルターが読み込み完了するまで描画はフィルタ値 "none" を使用して実行されるため、著者はこのようなフィルターが読み込み完了したかどうかを確認してから描画操作を続行することを検討するかもしれません。これを達成する一つの方法は、外部定義のフィルターを同じページ内の別の場所で、例えば load イベントを送信する要素（例：SVG use 要素）で読み込んで、load イベントが発生するのを待つことです。

4.12.5.1.22 描画モデル

シェイプや画像がペイントされる際、ユーザーエージェントは以下の手順に従って処理を行わなければなりません（あるいはそのように処理しているかのように振る舞わなければなりません）：

  1. 無限の透明な黒ビットマップにシェイプや画像をレンダリングし、イメージ A を作成します。これについては前述のセクションで説明されています。シェイプの場合、現在の塗りつぶし、ストローク、ラインスタイルが適用され、ストロークも現在の変換マトリックスの影響を受けなければなりません。

  2. A 内のすべてのピクセルのアルファ成分に グローバルアルファ を乗算します。

  3. 現在のフィルター が "none" 以外の値に設定され、参照される外部定義のフィルターがすべて読み込まれている場合、イメージ A を 現在のフィルター の入力として使用し、イメージ B を作成します。現在のフィルター が <filter-value-list> として解析可能な文字列である場合、SVG と同じ方法で 現在のフィルター を使用して描画を行います。

    それ以外の場合、B は A の別名として扱います。

  4. 影が描画されるとき、現在のシャドウスタイルを使用して画像 B から影をレンダリングし、画像 C を作成します。

  5. 影が描画されるとき、現在の合成およびブレンド演算子を使用して、クリッピング領域内に C を現在の 出力ビットマップの上に合成します。

  6. 現在の合成およびブレンド演算子を使用して、クリッピング領域内に B を現在の 出力ビットマップの上に合成します。

出力ビットマップ に合成する際、出力ビットマップ 外に出るピクセルは破棄しなければなりません。

4.12.5.1.23 ベストプラクティス

キャンバスがインタラクティブである場合、著者は、上記の例のように、キャンバスの各フォーカス可能な部分に対応するフォーカス可能な要素を要素のフォールバックコンテンツに含めるべきです。

フォーカスリングをレンダリングする際、フォーカスリングがネイティブのフォーカスリングの外観を持つようにするために、著者はリングが描かれる要素を渡してdrawFocusIfNeeded()メソッドを使用すべきです。このメソッドは、要素がフォーカスされている場合にのみフォーカスリングを描画するため、要素がフォーカスされているかどうかを事前に確認せずに、要素を描画するたびに単に呼び出すことができます。

著者は、canvas要素を使用してテキスト編集コントロールを実装することを避けるべきです。この方法には多くの欠点があります：

これは非常に大変な作業であり、著者は、代わりにinput要素、textarea要素、またはcontenteditable属性を使用することで、このような作業を避けることを強く推奨します。

4.12.5.1.24 例

このセクションは規範的ではありません。

ここでは、キャンバスを使用して美しい輝く線 を描画するスクリプトの例です。 

<canvas width="800" height="450"></canvas>
 <script>
 
  var context = document.getElementsByTagName('canvas')[0].getContext('2d');
 
  var lastX = context.canvas.width * Math.random();
  var lastY = context.canvas.height * Math.random();
  var hue = 0;
  function line() {
    context.save();
    context.translate(context.canvas.width/2, context.canvas.height/2);
    context.scale(0.9, 0.9);
    context.translate(-context.canvas.width/2, -context.canvas.height/2);
    context.beginPath();
    context.lineWidth = 5 + Math.random() * 10;
    context.moveTo(lastX, lastY);
    lastX = context.canvas.width * Math.random();
    lastY = context.canvas.height * Math.random();
    context.bezierCurveTo(context.canvas.width * Math.random(),
                          context.canvas.height * Math.random(),
                          context.canvas.width * Math.random(),
                          context.canvas.height * Math.random(),
                          lastX, lastY);
 
    hue = hue + 10 * Math.random();
    context.strokeStyle = 'hsl(' + hue + ', 50%, 50%)';
    context.shadowColor = 'white';
    context.shadowBlur = 10;
    context.stroke();
    context.restore();
  }
  setInterval(line, 50);
 
  function blank() {
    context.fillStyle = 'rgba(0,0,0,0.1)';
    context.fillRect(0, 0, context.canvas.width, context.canvas.height);
  }
  setInterval(blank, 40);
 
 </script>

キャンバスの2Dレンダリングコンテキストは、スプライトベースのゲームに頻繁に使用されます。次の例はそのデモンストレーションです。

この例のソースコードは次のとおりです:

<!DOCTYPE HTML>
 <html lang="en">
 <meta charset="utf-8">
 <title>Blue Robot Demo</title>
 <style>
   html { overflow: hidden; min-height: 200px; min-width: 380px; }
   body { height: 200px; position: relative; margin: 8px; }
   .buttons { position: absolute; bottom: 0px; left: 0px; margin: 4px; }
 </style>
 <canvas width="380" height="200"></canvas>
 <script>
  var Landscape = function (context, width, height) {
    this.offset = 0;
    this.width = width;
    this.advance = function (dx) {
      this.offset += dx;
    };
    this.horizon = height * 0.7;
    // This creates the sky gradient (from a darker blue to white at the bottom)
    this.sky = context.createLinearGradient(0, 0, 0, this.horizon);
    this.sky.addColorStop(0.0, 'rgb(55,121,179)');
    this.sky.addColorStop(0.7, 'rgb(121,194,245)');
    this.sky.addColorStop(1.0, 'rgb(164,200,214)');
    // this creates the grass gradient (from a darker green to a lighter green)
    this.earth = context.createLinearGradient(0, this.horizon, 0, height);
    this.earth.addColorStop(0.0, 'rgb(81,140,20)');
    this.earth.addColorStop(1.0, 'rgb(123,177,57)');
    this.paintBackground = function (context, width, height) {
      // first, paint the sky and grass rectangles
      context.fillStyle = this.sky;
      context.fillRect(0, 0, width, this.horizon);
      context.fillStyle = this.earth;
      context.fillRect(0, this.horizon, width, height-this.horizon);
      // then, draw the cloudy banner
      // we make it cloudy by having the draw text off the top of the
      // canvas, and just having the blurred shadow shown on the canvas
      context.save();
      context.translate(width-((this.offset+(this.width*3.2)) % (this.width*4.0))+0, 0);
      context.shadowColor = 'white';
      context.shadowOffsetY = 30+this.horizon/3; // offset down on canvas
      context.shadowBlur = '5';
      context.fillStyle = 'white';
      context.textAlign = 'left';
      context.textBaseline = 'top';
      context.font = '20px sans-serif';
      context.fillText('WHATWG ROCKS', 10, -30); // text up above canvas
      context.restore();
      // then, draw the background tree
      context.save();
      context.translate(width-((this.offset+(this.width*0.2)) % (this.width*1.5))+30, 0);
      context.beginPath();
      context.fillStyle = 'rgb(143,89,2)';
      context.lineStyle = 'rgb(10,10,10)';
      context.lineWidth = 2;
      context.rect(0, this.horizon+5, 10, -50); // trunk
      context.fill();
      context.stroke();
      context.beginPath();
      context.fillStyle = 'rgb(78,154,6)';
      context.arc(5, this.horizon-60, 30, 0, Math.PI*2); // leaves
      context.fill();
      context.stroke();
      context.restore();
    };
    this.paintForeground = function (context, width, height) {
      // draw the box that goes in front
      context.save();
      context.translate(width-((this.offset+(this.width*0.7)) % (this.width*1.1))+0, 0);
      context.beginPath();
      context.rect(0, this.horizon - 5, 25, 25);
      context.fillStyle = 'rgb(220,154,94)';
      context.lineStyle = 'rgb(10,10,10)';
      context.lineWidth = 2;
      context.fill();
      context.stroke();
      context.restore();
    };
  };
 </script>
 <script>
  var BlueRobot = function () {
    this.sprites = new Image();
    this.sprites.src = 'blue-robot.png'; // this sprite sheet has 8 cells
    this.targetMode = 'idle';
    this.walk = function () {
      this.targetMode = 'walk';
    };
    this.stop = function () {
      this.targetMode = 'idle';
    };
    this.frameIndex = {
      'idle': [0], // first cell is the idle frame
      'walk': [1,2,3,4,5,6], // the walking animation is cells 1-6
      'stop': [7], // last cell is the stopping animation
    };
    this.mode = 'idle';
    this.frame = 0; // index into frameIndex
    this.tick = function () {
      // this advances the frame and the robot
      // the return value is how many pixels the robot has moved
      this.frame += 1;
      if (this.frame >= this.frameIndex[this.mode].length) {
        // we've reached the end of this animation cycle
        this.frame = 0;
        if (this.mode != this.targetMode) {
          // switch to next cycle
          if (this.mode == 'walk') {
            // we need to stop walking before we decide what to do next
            this.mode = 'stop';
          } else if (this.mode == 'stop') {
            if (this.targetMode == 'walk')
              this.mode = 'walk';
            else
              this.mode = 'idle';
          } else if (this.mode == 'idle') {
            if (this.targetMode == 'walk')
              this.mode = 'walk';
          }
        }
      }
      if (this.mode == 'walk')
        return 8;
      return 0;
    },
    this.paint = function (context, x, y) {
      if (!this.sprites.complete) return;
      // draw the right frame out of the sprite sheet onto the canvas
      // we assume each frame is as high as the sprite sheet
      // the x,y coordinates give the position of the bottom center of the sprite
      context.drawImage(this.sprites,
                        this.frameIndex[this.mode][this.frame] * this.sprites.height, 0, this.sprites.height, this.sprites.height,
                        x-this.sprites.height/2, y-this.sprites.height, this.sprites.height, this.sprites.height);
    };
  };
 </script>
 <script>
  var canvas = document.getElementsByTagName('canvas')[0];
  var context = canvas.getContext('2d');
  var landscape = new Landscape(context, canvas.width, canvas.height);
  var blueRobot = new BlueRobot();
  // paint when the browser wants us to, using requestAnimationFrame()
  function paint() {
    context.clearRect(0, 0, canvas.width, canvas.height);
    landscape.paintBackground(context, canvas.width, canvas.height);
    blueRobot.paint(context, canvas.width/2, landscape.horizon*1.1);
    landscape.paintForeground(context, canvas.width, canvas.height);
    requestAnimationFrame(paint);
  }
  paint();
  // but tick every 100ms, so that we don't slow down when we don't paint
  setInterval(function () {
    var dx = blueRobot.tick();
    landscape.advance(dx);
  }, 100);
 </script>
 <p class="buttons">
  <input type=button value="Walk" onclick="blueRobot.walk()">
  <input type=button value="Stop" onclick="blueRobot.stop()">
 <footer>
  <small> Blue Robot Player Sprite by <a href="https://johncolburn.deviantart.com/">JohnColburn</a>.
  Licensed under the terms of the Creative Commons Attribution Share-Alike 3.0 Unported license.</small>
  <small> This work is itself licensed under a <a rel="license" href="https://creativecommons.org/licenses/by-sa/3.0/">Creative
  Commons Attribution-ShareAlike 3.0 Unported License</a>.</small>
 </footer>
4.12.5.2 ImageBitmap レンダリングコンテキスト
4.12.5.2.1 はじめに

ImageBitmapRenderingContextは、drawImage()メソッドとは異なり、中間合成を避けることで、全体のメモリ消費を抑え、パフォーマンスを向上させるための低オーバーヘッドな手法を提供する、パフォーマンス指向のインターフェイスです。

例えば、img要素をキャンバスに画像リソースを取得するための中間として使用すると、メモリ内にデコードされた画像のコピーが2つ存在することになります: img要素のコピーとキャンバスのバッキングストア内のものです。このメモリコストは、非常に大きな画像を扱う場合には負担が大きくなります。これを回避するためには、ImageBitmapRenderingContextを使用することができます。

ImageBitmapRenderingContextを使用して、メモリとCPUの効率を考慮した方法で画像をJPEGフォーマットにトランスコードする方法を以下に示します: 

createImageBitmap(inputImageBlob).then(image => {
   const canvas = document.createElement('canvas');
   const context = canvas.getContext('bitmaprenderer');
   context.transferFromImageBitmap(image);
 
   canvas.toBlob(outputJPEGBlob => {
     // Do something with outputJPEGBlob.
   }, 'image/jpeg');
 });
4.12.5.2.2 ImageBitmapRenderingContext インターフェース

ImageBitmapRenderingContext

すべての現在のエンジンでサポートされています。

Firefox46+Safari11.1+Chrome66+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android? 
[Exposed=(Window,Worker)]
 interface ImageBitmapRenderingContext {
   readonly attribute (HTMLCanvasElement or OffscreenCanvas) canvas;
   undefined transferFromImageBitmap(ImageBitmap? bitmap);
 };
 
 dictionary ImageBitmapRenderingContextSettings {
   boolean alpha = true;
 };
context = canvas.getContext('bitmaprenderer' [, { [ alpha: false ] } ])

ImageBitmapRenderingContext オブジェクトを返します。このオブジェクトは特定の canvas 要素に永久にバインドされます。

もし alpha 設定が提供され、false に設定されている場合、キャンバスは常に不透明であることが強制されます。

context.canvas

canvas 要素を返します。このコンテキストにバインドされています。

context.transferFromImageBitmap(imageBitmap)

ImageBitmapRenderingContext/transferFromImageBitmap

すべての現在のエンジンでサポートされています。

Firefox50+Safari11.1+Chrome66+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

imageBitmap から context へと ビットマップデータ を転送し、このビットマップが context にバインドされている canvas 要素の内容になります。

context.transferFromImageBitmap(null)

context にバインドされている canvas 要素の内容を、対応するサイズの 透明な黒 ビットマップに置き換えます。このサイズは、 幅 および 高さ コンテンツ属性に対応します。

canvas 属性は、オブジェクトが作成されたときに初期化された値を返さなければなりません。

ImageBitmapRenderingContext オブジェクトには、出力ビットマップがあります。これは、ビットマップデータへの参照です。

ImageBitmapRenderingContext オブジェクトには、ビットマップモードもあり、これは valid または blank に設定できます。valid の値は、コンテキストの 出力ビットマップ が、transferFromImageBitmap() を通じて取得されたビットマップデータを参照していることを示します。blank の値は、コンテキストの 出力ビットマップ がデフォルトの透明なビットマップであることを示します。

ImageBitmapRenderingContext オブジェクトには、alpha フラグもあり、これは true または false に設定できます。ImageBitmapRenderingContext オブジェクトの alpha フラグが false に設定されている場合、コンテキストがバインドされている canvas 要素の内容は、コンテキストの 出力ビットマップ を同じサイズの 不透明な黒 のビットマップに source-over 合成演算子を使用して合成することによって取得されます。alpha フラグが true に設定されている場合、出力ビットマップ がコンテキストにバインドされている canvas 要素の内容として使用されます。[COMPOSITE]

不透明な黒 のビットマップに対する合成のステップは、他の手段によってより効率的に同等の結果が得られる場合には省略されるべきです。

ユーザーエージェントが ImageBitmapRenderingContext の出力ビットマップを設定する ことが要求された場合、context 引数が ImageBitmapRenderingContext オブジェクトであり、オプションの引数 bitmap が ビットマップデータ を参照している場合、以下の手順を実行しなければなりません：

  1. もし bitmap 引数が提供されていない場合、次のようにします：

    1. context の ビットマップモード を blank に設定します。

    2. canvas を context がバインドされている canvas 要素とします。

    3. context の 出力ビットマップ を、自然の幅が canvas の 幅 属性の数値の値と等しく、自然の高さが canvas の 高さ 属性の数値の値と等しい 透明な黒 に設定します。これらの値は CSS ピクセル で解釈されます。

    4. 出力ビットマップ の origin-clean フラグを true に設定します。

  2. もし bitmap 引数が提供されている場合、次のようにします：

    1. context の ビットマップモード を valid に設定します。

    2. context の 出力ビットマップ を、bitmap と同じ基盤となるビットマップデータを参照するように設定します。コピーは行われません。

      origin-clean フラグは、bitmap のビットマップデータに含まれ、context の 出力ビットマップ に参照されます。

ImageBitmapRenderingContext 作成アルゴリズム は、target および options を引数として渡され、次の手順を実行します：

  1. settings を、options を辞書型 ImageBitmapRenderingContextSettings に変換した結果とします。（これにより例外が発生する可能性があります。）

  2. context を新しい ImageBitmapRenderingContext オブジェクトとします。

  3. context の canvas 属性を target を指すように初期化します。

  4. context の 出力ビットマップ を、target のビットマップと同じに設定します（つまり、共有される）。

  5. ImageBitmapRenderingContext の出力ビットマップを設定する ステップを実行し、context を渡します。

  6. context の alpha フラグを true に初期化します。

  7. settings の各メンバーを次のように処理します：

    alpha
    もし false の場合、context の alpha フラグを false に設定します。

  8. context を返します。

transferFromImageBitmap(bitmap) メソッドが呼び出されたとき、次の手順を実行しなければなりません：

  1. bitmapContext を ImageBitmapRenderingContext オブジェクトとします。このオブジェクト上で transferFromImageBitmap() メソッドが呼び出されました。

  2. もし bitmap が null である場合、ImageBitmapRenderingContext の出力ビットマップを設定する ステップを実行し、bitmapContext を context 引数とし、bitmap 引数を指定せずに返します。

  3. もし bitmap の [[Detached]] 内部スロットの値が true に設定されている場合、"InvalidStateError" DOMException をスローします。

  4. ImageBitmapRenderingContext の出力ビットマップを設定する ステップを実行し、context 引数に bitmapContext を、bitmap 引数には bitmap の基盤となる ビットマップデータ を指定します。

  5. bitmap の [[Detached]] 内部スロットの値を true に設定します。

  6. bitmap の ビットマップデータ を解除します。

4.12.5.3 OffscreenCanvas インターフェース

OffscreenCanvas

すべての現行エンジンでサポートされています。

Firefox105+ Safari16.4+ Chrome69+
Opera? Edge79+
Edge (Legacy)? Internet Explorer非対応
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android? 
typedef (OffscreenCanvasRenderingContext2D or ImageBitmapRenderingContext or WebGLRenderingContext or WebGL2RenderingContext or GPUCanvasContext) OffscreenRenderingContext;
 
 dictionary ImageEncodeOptions {
   DOMString type = "image/png";
   unrestricted double quality;
 };
 
 enum OffscreenRenderingContextId { "2d", "bitmaprenderer", "webgl", "webgl2", "webgpu" };
 
 [Exposed=(Window,Worker), Transferable]
 interface OffscreenCanvas : EventTarget {
   constructor([EnforceRange] unsigned long long width, [EnforceRange] unsigned long long height);
 
   attribute [EnforceRange] unsigned long long width;
   attribute [EnforceRange] unsigned long long height;
 
   OffscreenRenderingContext? getContext(OffscreenRenderingContextId contextId, optional any options = null);
   ImageBitmap transferToImageBitmap();
   Promise<Blob> convertToBlob(optional ImageEncodeOptions options = {});
 
   attribute EventHandler oncontextlost;
   attribute EventHandler oncontextrestored;
 };

OffscreenCanvas は EventTarget であり、OffscreenCanvasRenderingContext2D と WebGL の両方がイベントを発生させることができます。OffscreenCanvasRenderingContext2D は contextlost と contextrestored イベントを発生させ、WebGL は webglcontextlost と webglcontextrestored を発生させることができます。[WEBGL]

OffscreenCanvas オブジェクトは、HTMLCanvasElement と同様にレンダリングコンテキストを作成するために使用されますが、DOM との接続はありません。これにより、ワーカー内でキャンバスレンダリングコンテキストを使用することが可能になります。

OffscreenCanvas オブジェクトは、通常 DOM 内にある プレースホルダー canvas 要素への弱い参照を保持する場合があります。その埋め込まれたコンテンツは OffscreenCanvas オブジェクトによって提供されます。OffscreenCanvas オブジェクトのビットマップは、プレースホルダー canvas 要素に、その 関連するエージェントの イベントループの レンダリングの更新 の手順の一環としてプッシュされます。

offscreenCanvas = new OffscreenCanvas(width, height)

OffscreenCanvas/OffscreenCanvas

すべての現行エンジンでサポートされています。

Firefox105+ Safari16.4+ Chrome69+
Opera? Edge79+
Edge (Legacy)? Internet Explorer非対応
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

DOM に接続されていない、プレースホルダー canvas 要素にリンクされていない新しい OffscreenCanvas オブジェクトを返します。このビットマップのサイズは width および height 引数によって決定されます。

context = offscreenCanvas.getContext(contextId [, options ])

OffscreenCanvas/getContext

すべての現行エンジンでサポートされています。

Firefox105+ Safari16.4+ Chrome69+
Opera? Edge79+
Edge (Legacy)? Internet Explorer非対応
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

OffscreenCanvas オブジェクト上での描画用 API を公開するオブジェクトを返します。contextId は、希望する API を指定します: "2d"、"bitmaprenderer"、"webgl"、"webgl2"、または "webgpu" です。options はその API によって処理されます。

この仕様は、以下で定義されている "2d" コンテキストを定義していますが、これは 2d コンテキストと似ていますが異なります。WebGL 仕様は、"webgl" および "webgl2" コンテキストを定義しています。WebGPU は "webgpu" コンテキストを定義しています。[WEBGL][WEBGPU]

キャンバスがすでに別のコンテキストタイプで初期化されている場合 (例: "2d" コンテキストを取得した後に "webgl" コンテキストを取得しようとする場合など)、null を返します。

OffscreenCanvas オブジェクトには、作成時に初期化される内部 ビットマップ があります。ビットマップ の幅と高さは、width および height 属性の値と等しくなります。ビットマップのすべてのピクセルは、初期状態では 透明な黒 です。

OffscreenCanvas オブジェクトには、OffscreenCanvas が作成されるときに設定される内部の 継承言語と 継承方向があります。

OffscreenCanvas オブジェクトには、レンダリングコンテキストをバインドできます。最初は、バインドされたレンダリングコンテキストはありません。レンダリングコンテキストがあるかどうか、またそれがどのような種類のレンダリングコンテキストであるかを追跡するために、OffscreenCanvas オブジェクトには コンテキストモードもあり、最初は none ですが、この仕様で定義されているアルゴリズムによって 2d、bitmaprenderer、webgl、webgl2、webgpu、または detached のいずれかに変更できます。

new OffscreenCanvas(width, height) コンストラクターのステップは次のとおりです。

  1. this の ビットマップを、width と height で指定された寸法の 透明な黒ピクセルの矩形配列に初期化します。

  2. this の width を width に初期化します。

  3. this の height を height に初期化します。

  4. this の 継承言語を 明示的に不明に設定します。

  5. this の 継承方向を「ltr」に設定します。

  6. global を this の 関連するグローバルオブジェクトとします。

  7. global が Window オブジェクトの場合：

    1. element を global の 関連する Document の ドキュメント要素とします。

    2. element が null でない場合：

      1. this の 継承言語を element の 言語に設定します。

      2. this の 継承方向を element の 書字方向に設定します。

OffscreenCanvas オブジェクトは転送可能です。 value と dataHolder を指定した場合の転送ステップは次のとおりです。

  1. value の コンテキストモードが none と等しくない場合、"InvalidStateError" DOMException をスローします。

  2. value の コンテキストモードを detached に設定します。

  3. width と height を value の ビットマップの寸法とします。

  4. language と direction を value の 継承言語と 継承方向の値とします。

  5. value の ビットマップを解除します。

  6. dataHolder.[[Width]] を width に、 dataHolder.[[Height]] を height に設定します。

  7. dataHolder.[[Language]] を language に、 dataHolder.[[Direction]] を direction に設定します。

  8. value が プレースホルダー canvas 要素を持つ場合、dataHolder.[[PlaceholderCanvas]] をその要素への弱い参照に設定します。持たない場合は null に設定します。

dataHolder と value を指定した場合の転送受信ステップは次のとおりです。

  1. value の ビットマップを、dataHolder.[[Width]] で指定された幅と dataHolder.[[Height]] で指定された高さの 透明な黒ピクセルの矩形配列に初期化します。

  2. value の 継承言語を dataHolder.[[Language]] に、継承方向を dataHolder.[[Direction]] に設定します。

  3. dataHolder.[[PlaceholderCanvas]] が null でない場合、value の プレースホルダー canvas 要素を dataHolder.[[PlaceholderCanvas]] に設定します（弱い参照のセマンティクスを維持しながら）。

getContext(contextId, options) メソッドは、OffscreenCanvas オブジェクトが呼び出されたときに次の手順を実行しなければなりません。

  1. options が オブジェクト でない場合、options を null に設定します。

  2. options を JavaScript の値に変換 する結果として options を設定します。

  3. 以下の表の列ヘッダーがこの OffscreenCanvas オブジェクトの コンテキストモード に一致し、行ヘッダーが contextId に一致するセル内の手順を実行します。

    none 2d bitmaprenderer webgl または webgl2 webgpu detached
    "2d"

    1. context を、this と options を指定して オフスクリーン 2D コンテキスト作成アルゴリズムを実行した結果とします。

    2. this の コンテキストモードを 2d に設定します。

    3. context を返します。

    		同じ最初の引数でメソッドが呼び出された最後のときに返されたオブジェクトと同じオブジェクトを返します。 null を返します。 null を返します。 null を返します。 "InvalidStateError" DOMException をスローします。
    "bitmaprenderer"

    1. context を ImageBitmapRenderingContext 作成アルゴリズム を this および options を与えて実行した結果とします。

    2. this の コンテキストモード を bitmaprenderer に設定します。

    3. context を返します。

    		null を返します。 同じ最初の引数でメソッドが呼び出された最後のときに返されたオブジェクトと同じオブジェクトを返します。 null を返します。 null を返します。 "InvalidStateError" DOMException をスローします。
    "webgl" または "webgl2"

    1. context を WebGL 仕様の Context Creation セクションで指定された手順に従った結果とします。[WEBGL]

    2. もし context が null であれば、null を返します。そうでなければ、this の コンテキストモード を webgl または webgl2 に設定します。

    3. context を返します。

    		null を返します。 null を返します。 同じ最初の引数でメソッドが呼び出された最後のときに返された値と同じ値を返します。 null を返します。 "InvalidStateError" DOMException をスローします。
    "webgpu"

    1. context を WebGPU の キャンバスレンダリング セクションで指示された手順に従った結果とします。[WEBGPU]

    2. もし context が null であれば、null を返します。そうでなければ、this の コンテキストモード を webgpu に設定します。

    3. context を返します。

    		null を返します。 null を返します。 null を返します。 同じ最初の引数でメソッドが呼び出された最後のときに返された値と同じ値を返します。 "InvalidStateError" DOMException をスローします。
offscreenCanvas.width [ = value ]

OffscreenCanvas/width

すべての現在のエンジンでサポートされています。

Firefox105+Safari16.4+Chrome69+
Opera?Edge79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
offscreenCanvas.height [ = value ]

OffscreenCanvas/height

すべての現在のエンジンでサポートされています。

Firefox105+Safari16.4+Chrome69+
Opera?Edge79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

これらの属性は、OffscreenCanvas オブジェクトのビットマップの寸法を返します。

これらの値を設定することで、指定された寸法の新しいビットマップで 置き換えることができます（効果的にリサイズします）。新しいビットマップは、透明な黒です。

もし、OffscreenCanvas オブジェクトの width または height 属性が設定された場合（新しい値または以前と同じ値に設定）、OffscreenCanvas オブジェクトの コンテキストモード が 2d であれば、レンダリングコンテキストをデフォルトの状態にリセットし、OffscreenCanvas オブジェクトの ビットマップ を width および height 属性の新しい値にリサイズします。

"webgl" および "webgl2" コンテキストのリサイズ動作は、WebGL 仕様で定義されています。[WEBGL]

"webgpu" コンテキストのリサイズ動作は WebGPU で定義されています。[WEBGPU]

もし、OffscreenCanvas オブジェクトの寸法が変更された場合、 プレースホルダーcanvas要素が存在する場合、 プレースホルダーcanvas要素の 自然なサイズ は、 OffscreenCanvas の 関連エージェントの イベントループ の レンダリングの更新 ステップ中にのみ更新されます。

promise = offscreenCanvas.convertToBlob([options])

OffscreenCanvas/convertToBlob

すべての現在のエンジンでサポートされています。

Firefox105+Safari16.4+Chrome69+
Opera?Edge79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

このプロミスは、新しいBlobオブジェクトで解決され、OffscreenCanvasオブジェクト内の画像を含むファイルを表します。

引数としてオプションの辞書が提供される場合、その辞書は作成される画像ファイルのエンコードオプションを制御します。typeフィールドはファイル形式を指定し、デフォルト値は "image/png" です。このタイプは、要求されたタイプがサポートされていない場合にも使用されます。画像形式が可変品質をサポートしている場合（例えば、"image/jpeg"）、qualityフィールドは、生成される画像の希望品質レベルを示す 0.0 から 1.0 までの範囲の数値です。

canvas.transferToImageBitmap()

OffscreenCanvas/transferToImageBitmap

すべての現在のエンジンでサポートされています。

Firefox105+Safari16.4+Chrome69+
Opera?Edge79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

新しく作成されたImageBitmapオブジェクトを返し、OffscreenCanvasオブジェクト内の画像を保持します。OffscreenCanvasオブジェクト内の画像は、新しい空白の画像に置き換えられます。

convertToBlob(options) メソッドのステップは次のとおりです。

  1. this の [[Detached]] 内部スロットの値が true の場合、"InvalidStateError" DOMException で拒否されたプロミスを返します。

  2. this の コンテキストモードが 2d であり、レンダリングコンテキストの 出力ビットマップの オリジンクリーンフラグが false に設定されている場合、"SecurityError" DOMException で拒否されたプロミスを返します。

  3. this の ビットマップにピクセルがない場合（つまり、水平方向または垂直方向のいずれかの寸法がゼロの場合）、"IndexSizeError" DOMException で拒否されたプロミスを返します。

  4. bitmap を this の ビットマップのコピーとします。

  5. result を新しいプロミスオブジェクトとします。

  6. global を this の 関連するグローバルオブジェクトとします。

  7. これらのステップを並行して実行します。

    1. file を、options の type と quality（存在する場合）を使用して、bitmap のファイルとしてのシリアル化とします。

    2. global を指定して、canvas blob シリアル化タスクソースでグローバルタスクをキューに入れることで、これらのステップを実行します。

      1. file が null の場合、result を "EncodingError" DOMException で拒否します。

      2. それ以外の場合、global の 関連するレルムで作成された新しい Blob オブジェクトで result を解決します。これは file を表します。[FILEAPI]

  8. result を返します。

transferToImageBitmap()メソッドは、呼び出されると、次のステップを実行する必要があります。

  1. このOffscreenCanvasオブジェクトの[[Detached]]内部スロットの値がtrueに設定されている場合、"InvalidStateError"を発生させます。 DOMException。

  2. このOffscreenCanvasオブジェクトのコンテキストモードがnoneに設定されている場合、"InvalidStateError"を発生させます。DOMException。

  3. 新しく作成されたImageBitmapオブジェクトをimageに設定し、このOffscreenCanvasオブジェクトのビットマップを参照します。

  4. このOffscreenCanvasオブジェクトのビットマップを新しく作成されたビットマップに設定し、以前のビットマップと同じ寸法とカラースペースを持つものにし、そのピクセルを透明な黒、またはレンダリングコンテキストのalphaフラグがfalseに設定されている場合は不透明な黒に初期化します。

    これは、このOffscreenCanvasのレンダリングコンテキストがWebGLRenderingContextの場合、preserveDrawingBufferの値が影響を与えないことを意味します。 [WEBGL]

  5. imageを返します。

次のものは、サポートが必要なイベントハンドラー（および対応するイベントハンドラーイベントタイプ）です。イベントハンドラーIDL属性として、OffscreenCanvasインターフェイスを実装するすべてのオブジェクトによってサポートされる必要があります。

イベントハンドラー イベントハンドラーイベントタイプ
oncontextlost contextlost
oncontextrestored contextrestored
4.12.5.3.1 オフスクリーン2Dレンダリングコンテキスト

OffscreenCanvasRenderingContext2D

すべての現在のエンジンでサポートされています。

Firefox105+ Safari16.4+ Chrome69+
Opera? Edge79+
Edge (旧バージョン)? Internet Explorerサポートされていません
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android? 
[Exposed=(Window,Worker)]
interface OffscreenCanvasRenderingContext2D {
  readonly attribute OffscreenCanvas canvas;
};

OffscreenCanvasRenderingContext2D includes CanvasSettings;
OffscreenCanvasRenderingContext2D includes CanvasState;
OffscreenCanvasRenderingContext2D includes CanvasTransform;
OffscreenCanvasRenderingContext2D includes CanvasCompositing;
OffscreenCanvasRenderingContext2D includes CanvasImageSmoothing;
OffscreenCanvasRenderingContext2D includes CanvasFillStrokeStyles;
OffscreenCanvasRenderingContext2D includes CanvasShadowStyles;
OffscreenCanvasRenderingContext2D includes CanvasFilters;
OffscreenCanvasRenderingContext2D includes CanvasRect;
OffscreenCanvasRenderingContext2D includes CanvasDrawPath;
OffscreenCanvasRenderingContext2D includes CanvasText;
OffscreenCanvasRenderingContext2D includes CanvasDrawImage;
OffscreenCanvasRenderingContext2D includes CanvasImageData;
OffscreenCanvasRenderingContext2D includes CanvasPathDrawingStyles;
OffscreenCanvasRenderingContext2D includes CanvasTextDrawingStyles;
OffscreenCanvasRenderingContext2D includes CanvasPath;

OffscreenCanvasRenderingContext2D オブジェクトは、ビットマップに描画するためのレンダリングコンテキストです。これは、OffscreenCanvas オブジェクトのものであり、CanvasRenderingContext2D オブジェクトと似ていますが、以下の違いがあります:

OffscreenCanvasRenderingContext2D オブジェクトには、関連付けられた OffscreenCanvas オブジェクトがあります。これは、OffscreenCanvasRenderingContext2D オブジェクトが作成された OffscreenCanvas オブジェクトです。

offscreenCanvas = offscreenCanvasRenderingContext2D.canvas

関連する OffscreenCanvas オブジェクトを返します。

オフスクリーン 2D コンテキスト作成アルゴリズムは、target ( OffscreenCanvas オブジェクト) およびオプションの引数を渡され、次の手順を実行します:

  1. アルゴリズムに引数が渡された場合、arg を最初のそのような引数とします。それ以外の場合、arg を未定義とします。

  2. settings を、arg を辞書型 CanvasRenderingContext2DSettings に変換した結果とします。 （これは例外をスローする可能性があります。）

  3. context を新しい OffscreenCanvasRenderingContext2D オブジェクトとします。

  4. context の 関連付けられた OffscreenCanvas オブジェクトを target に設定します。

  5. context と settings を指定して、キャンバス設定出力ビットマップ初期化アルゴリズムを実行します。

  6. context の 出力ビットマップを、target の width および height 属性で指定された寸法で新しく作成されたビットマップに設定し、target のビットマップを同じビットマップに設定します（それらが共有されるように）。

  7. context の アルファフラグが true に設定されている場合、context の 出力ビットマップのすべてのピクセルを 透明な黒に初期化します。それ以外の場合、ピクセルを不透明な黒に初期化します。

  8. context を返します。

実装は、ウィンドウイベントループ のグラフィックス更新手順を短絡させ、プレースホルダー キャンバス エレメント の内容を表示に更新するためのショートカットを提供することが推奨されます。これにより、たとえば、ビットマップの内容が プレースホルダー キャンバス エレメント の物理的な表示位置にマッピングされたグラフィックスバッファに直接コピーされることがあります。このような短絡アプローチは、特に OffscreenCanvas が ワーカーループ から更新され、ウィンドウイベントループ がビジー状態の プレースホルダー キャンバス エレメント において、表示遅延を大幅に削減することができます。ただし、そのようなショートカットには、スクリプトによって観測可能な副作用があってはなりません。これは、ビットマップが プレースホルダー キャンバス エレメント に送信される必要があるためです。エレメントが CanvasImageSource や ImageBitmapSource として使用される場合、または toDataURL() や toBlob() が呼び出される場合に備えて、ビットマップを送信する必要があります。

canvas 属性は、取得時に、この OffscreenCanvasRenderingContext2D の 関連する OffscreenCanvas オブジェクト を返す必要があります。

4.12.5.4 色空間と色空間変換

キャンバス API は、キャンバスのバッキングストアの色空間を指定するためのメカニズムを提供します。すべてのキャンバス API のデフォルトのバッキングストアの色空間は 'srgb' です。

色空間の変換は、キャンバスを出力デバイスにレンダリングする際にキャンバスのバックアップストアに適用されなければなりません。この色空間の変換は、同じ色空間を指定するカラープロファイルを持つimg要素に適用される色空間の変換と同一でなければなりません。

2Dコンテキストにコンテンツを描画する際、すべての入力は描画前に変換され、コンテキストの色空間に合わせられる必要があります。グラデーションのカラーストップの補間は、コンテキストの色空間に変換された後の色値に対して行われなければなりません。アルファブレンディングは、コンテキストの色空間に変換された後の値で行われなければなりません。

2D コンテキストに対する入力で、色空間が未定義のものは存在しません。CSS の色の色空間はCSS Colorで定義されています。色プロファイル情報を指定していない画像の色空間は、'srgb'であると想定されます。これは、CSS Colorのタグ付けされていない色の色空間セクションで指定されています。[CSSCOLOR]

4.12.5.5 ビットマップのファイルへのシリアル化

ユーザーエージェントがtypeとオプションのqualityを指定して、ビットマップをファイルとしてシリアル化するときは、typeで指定された形式で画像ファイルを作成しなければなりません。画像ファイルの作成中にエラーが発生した場合（例：内部エンコーダーエラーなど）、シリアル化の結果はnullとなります。[PNG]

画像ファイルのピクセルデータは、ビットマップのピクセルデータを1座標空間単位あたり1画像ピクセルにスケーリングしたものでなければなりません。また、使用するファイル形式が解像度メタデータのエンコードをサポートしている場合、解像度は96dpi（1画像ピクセルあたりCSSピクセル）として指定しなければなりません。

typeが指定された場合、それは使用する形式を示すMIMEタイプとして解釈されなければなりません。タイプにパラメーターがある場合、それはサポートされていないものとして扱われなければなりません。

例えば、"image/png"という値はPNG画像を生成することを意味し、"image/jpeg"という値はJPEG画像を生成することを意味します。"image/svg+xml"という値はSVG画像を生成することを意味し（これはビットマップが生成された方法を追跡することをユーザーエージェントに要求し、実現は難しいですが可能性がある機能です）、おそらく非常に素晴らしい機能となるでしょう。

ユーザーエージェントはPNG ("image/png") をサポートしなければなりません。ユーザーエージェントは他のタイプをサポートしてもよいです。ユーザーエージェントが要求されたタイプをサポートしていない場合は、PNG形式を使用してファイルを作成しなければなりません。[PNG]

ユーザーエージェントは、指定されたタイプをサポートするかどうかを確認する前に、指定されたタイプをASCII小文字に変換しなければなりません。

アルファコンポーネントをサポートしない画像タイプの場合、シリアル化された画像は、source-over 合成演算子を使用して不透明な黒の背景に合成されたビットマップ画像でなければなりません。

カラープロファイルをサポートする画像タイプの場合、シリアライズされた画像には、基になるビットマップの色空間を示すカラープロファイルが含まれていなければなりません。カラープロファイルをサポートしない画像タイプの場合、シリアライズされた画像は変換され、'srgb'色空間に'relative-colorimetric'レンダリングインテントを使用して変換されなければなりません。

したがって、2D コンテキストでは、drawImage() メソッドを使用して toDataURL() または toBlob() メソッドの出力をキャンバスにレンダリングする場合、適切な寸法を指定すると、キャンバスの色がより狭いガマットにクリッピングされることを除けば、目に見える効果はありません。

複数のビット深度をサポートする画像タイプの場合、シリアル化された画像は、基になるビットマップのコンテンツを最もよく保持するビット深度を使用する必要があります。

たとえば、色タイプが float16 の 2D コンテキストを type 「image/png」にシリアル化する場合、結果の画像はサンプルあたり 16 ビットになります。 このシリアル化では、依然としてかなりの詳細が失われます（0.5/65535 未満のすべての値は 0 にクランプされ、1 より大きいすべての値は 1 にクランプされます）。

type が可変品質をサポートする画像形式（「image/jpeg」など）であり、quality が指定され、かつ type が 「image/png」でない場合、quality が 0.0 から 1.0（両端を含む）の範囲の数値である場合、ユーザーエージェントは quality を目的の品質レベルとして扱う必要があります。それ以外の場合、ユーザーエージェントは、quality 引数が指定されなかったかのように、デフォルトの品質値を使用する必要があります。

ここでのタイプテストの使用は、単にqualityをWeb IDLのdoubleとして宣言する代わりに、歴史的なアーティファクトです。

"品質"の解釈は、異なる実装によって若干異なる場合があります。品質が指定されていない場合は、圧縮率、画像品質、エンコード時間の間で合理的な妥協を表す実装固有のデフォルトが使用されます。

4.12.5.6 Canvas要素のセキュリティ

このセクションは規範的ではありません。

情報漏洩は、1つのオリジンのスクリプトが、別のオリジン（同一オリジンではない）からの画像情報（例：ピクセルの読み取り）にアクセスできる場合に発生する可能性があります。

これを緩和するために、Canvas要素、OffscreenCanvasオブジェクト、およびImageBitmapオブジェクトに使用されるビットマップには、それらがオリジンクリーンであるかどうかを示すフラグが定義されています。すべてのビットマップは、そのオリジンクリーンがtrueに設定された状態で開始されます。このフラグは、クロスオリジンの画像が使用されたときにfalseに設定されます。

toDataURL()、toBlob()、およびgetImageData()メソッドはこのフラグをチェックし、クロスオリジンデータが漏洩しないように"SecurityError" DOMExceptionをスローします。

オリジンクリーンフラグの値は、createImageBitmap()によって、ソースのビットマップから新しいImageBitmapオブジェクトに伝播されます。逆に、ソース画像がオリジンクリーンフラグがfalseに設定されたImageBitmapオブジェクトである場合、drawImageによって、キャンバス要素のビットマップのオリジンクリーンフラグがfalseに設定されます。

このフラグは、特定の状況でリセットされることがあります。例えば、widthまたはheight属性を変更すると、ビットマップがクリアされ、オリジンクリーンフラグがリセットされます。

ImageBitmapRenderingContextを使用する場合、オリジンクリーンフラグの値は、ImageBitmapオブジェクトからキャンバスへと伝播されます。

4.12.5.7 プリマルチプライドアルファと2Dレンダリングコンテキスト

乗算済みアルファとは、画像内の透明度を表す 1 つの方法を指し、もう 1 つは非乗算済みアルファです。

非乗算済みアルファでは、ピクセルの赤、緑、青の成分はそのピクセルの色を表し、そのアルファ成分はそのピクセルの不透明度を表します。

しかし、乗算済みアルファでは、ピクセルの赤、緑、青の成分はそのピクセルが画像に追加する色の量を表し、そのアルファ成分はそのピクセルが背後にあるものをどの程度隠すかを表します。

たとえば、色成分の範囲が 0 (オフ) から 255 (最大強度) であると仮定すると、これらのサンプル色は次のように表されます。

CSS色表現 プリマルチプライド表現 非プリマルチプライド表現 色の説明 他のコンテンツ上にブレンドされた色の画像
rgba(255, 127, 0, 1) 255, 127, 0, 255 255, 127, 0, 255 完全に不透明なオレンジ 背景の上に完全に不透明なオレンジの円
rgba(255, 255, 0, 0.5) 127, 127, 0, 127 255, 255, 0, 127 半透明の黄色 背景の上に半透明の黄色の円
表現不可 255, 127, 0, 127 表現不可 加算半透明のオレンジ 背景の上にやや明るくなったオレンジの円
表現不可 255, 127, 0, 0 表現不可 加算完全透明なオレンジ 背景の上に完全に明るくなったオレンジの円
rgba(255, 127, 0, 0) 0, 0, 0, 0 255, 127, 0, 0 完全に透明な（「見えない」）オレンジ 上に何もない背景
rgba(0, 127, 255, 0) 0, 0, 0, 0 255, 127, 0, 0 完全に透明な（「見えない」）ターコイズ 上に何もない背景

非乗算済み表現から乗算済み表現に色値を変換するには、色の赤、緑、青の成分にそのアルファ成分を乗算します（アルファ成分の範囲を再マッピングして、「完全に透明」が 0、「完全に不透明」が 1 になるようにします）。

乗算済み表現から非乗算済み表現に色値を変換するには、逆の操作を行います。つまり、色の赤、緑、青の成分をそのアルファ成分で除算します。

特定の色は乗算済みアルファでのみ表現でき（たとえば、加法混色の色）、他の色は非乗算済みアルファでのみ表現できるため（たとえば、不透明度がなくても特定の赤、緑、青の値を持つ「見えない」色）、有限精度を使用した除算と乗算は精度の低下を伴うため、乗算済みアルファと非乗算済みアルファの間の変換は、完全に不透明ではない色に対して損失の多い操作になります。

CanvasRenderingContext2D の 出力ビットマップと OffscreenCanvasRenderingContext2D の 出力ビットマップは、透明な色を表すために乗算済みアルファを使用する必要があります。

キャンバスのビットマップがプリマルチプライドアルファを使用して色を表現することは、表現可能な色の範囲に影響を与えるため重要です。加算色は、CSS色が非プリマルチプライドであり、それらを表現できないため、現在キャンバスに直接描画することはできませんが、WebGLキャンバスに加算色を描画し、そのWebGLキャンバスをdrawImage()を介して2Dキャンバスに描画することは可能です。

4.13 カスタム要素

Using_custom_elements

すべての現行エンジンでサポートされています。

Firefox63+Safari10.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

4.13.1 はじめに

このセクションは規範的ではありません。

カスタム要素は、著者が独自の完全な機能を持つDOM要素を構築する方法を提供します。著者は常に非標準の要素を文書内で使用し、スクリプトや類似の方法でアプリケーション固有の動作を追加することができましたが、そのような要素は歴史的に非準拠であり、あまり機能的ではありませんでした。カスタム要素を定義することによって、著者はパーサーに要素を適切に構築する方法と、そのクラスの要素が変更にどのように反応するべきかを知らせることができます。

カスタム要素は、「プラットフォームの合理化」の一環として、既存のプラットフォーム機能（HTMLの要素など）を、カスタム要素の定義のような低レベルの著者が利用できる拡張ポイントに基づいて説明することを目的としています。今日では、カスタム要素の機能的および意味的な制限が多く存在し、それがHTMLの既存要素の動作を完全に説明することを妨げていますが、将来的にはこのギャップを縮小することを目指しています。

4.13.1.1 独立したカスタム要素の作成

このセクションは規範的ではありません。

独立したカスタム要素を作成する方法を説明するために、小さな国旗アイコンをレンダリングするカスタム要素を定義しましょう。目標は、このように使えるようにすることです: 

<flag-icon country="nl"></flag-icon>

これを実現するために、まずカスタム要素のクラスを宣言し、HTMLElementを拡張します:

class FlagIcon extends HTMLElement {
   constructor() {
     super();
     this._countryCode = null;
   }

   static observedAttributes = ["country"];

   attributeChangedCallback(name, oldValue, newValue) {
     // nameは常に"country"になります observedAttributesのため
     this._countryCode = newValue;
     this._updateRendering();
   }

   connectedCallback() {
     this._updateRendering();
   }

   get country() {
     return this._countryCode; 
   }

   set country(v) {
     this.setAttribute("country", v); 
   }

   _updateRendering() {
     // これは読者の練習問題として残しておきますが、
     // this.ownerDocument.defaultViewを確認して
     // 閲覧コンテキストを持つドキュメントに挿入されたかどうかを確認し、
     // そうでなければ作業を行わないようにしてください。
   } 
 }

次に、このクラスを使用して要素を定義する必要があります:

customElements.define("flag-icon", FlagIcon);

ここまでで、上記のコードは機能するようになります！パーサーはflag-iconタグを見るたびに、新しいFlagIconクラスのインスタンスを構築し、country属性についてコードに通知します。これにより、要素の内部状態を設定し、適切なタイミングでレンダリングを更新します。

また、DOM APIを使用してflag-icon要素を作成することもできます:

const flagIcon = document.createElement("flag-icon")
 flagIcon.country = "jp"
 document.body.appendChild(flagIcon)

最後に、カスタム要素のコンストラクタ自体も使用できます。つまり、上記のコードは次のコードと同等です: 

const flagIcon = new FlagIcon()
 flagIcon.country = "jp"
 document.body.appendChild(flagIcon)
4.13.1.2 フォームに関連するカスタム要素の作成

このセクションは規範的ではありません。

静的な formAssociated プロパティに true の値を設定することで、独立型カスタム要素を フォームに関連するカスタム要素 に変えることができます。ElementInternals インターフェイスは、フォームコントロール要素に共通する機能やプロパティを実装するのに役立ちます。 

class MyCheckbox extends HTMLElement {
   static formAssociated = true;
   static observedAttributes = ['checked'];

   constructor() {
     super();
     this._internals = this.attachInternals();
     this.addEventListener('click', this._onClick.bind(this));
   }

   get form() { return this._internals.form; }
   get name() { return this.getAttribute('name'); }
   get type() { return this.localName; }

   get checked() { return this.hasAttribute('checked'); }
   set checked(flag) { this.toggleAttribute('checked', Boolean(flag)); }

   attributeChangedCallback(name, oldValue, newValue) {
     // name は observedAttributes によって常に "checked" になります
     this._internals.setFormValue(this.checked ? 'on' : null);
   }

   _onClick(event) {
     this.checked = !this.checked;
   }
 }
 customElements.define('my-checkbox', MyCheckbox);

カスタム要素 my-checkbox は、組み込みのフォームに関連する要素のように使用できます。例えば、フォーム または ラベル に配置することで、my-checkbox 要素をそれらに関連付けることができ、フォーム を送信すると、my-checkbox 実装によって提供されるデータが送信されます。 

<form action="..." method="...">
   <label><my-checkbox name="agreed"></my-checkbox> 規約を読みました。</label>
   <input type="submit">
</form>
4.13.1.3 デフォルトのアクセシブルなロール、状態、およびプロパティを持つカスタム要素の作成

このセクションは規範的ではありません。

ElementInternals の適切なプロパティを使用することで、カスタム要素にデフォルトのアクセシビリティセマンティクスを持たせることができます。次のコードは、前のセクションで紹介したフォームに関連するチェックボックスを拡張し、アクセシビリティ技術によって見られるデフォルトのロールとチェック状態を適切に設定します: 

class MyCheckbox extends HTMLElement {
  static formAssociated = true;
  static observedAttributes = ['checked'];

  constructor() {
    super();
    this._internals = this.attachInternals();
    this.addEventListener('click', this._onClick.bind(this));

    this._internals.role = 'checkbox';
    this._internals.ariaChecked = 'false'; 
  }

  get form() { return this._internals.form; }
  get name() { return this.getAttribute('name'); }
  get type() { return this.localName; }

  get checked() { return this.hasAttribute('checked'); }
  set checked(flag) { this.toggleAttribute('checked', Boolean(flag)); }

  attributeChangedCallback(name, oldValue, newValue) {
    // 観察属性によって、nameは常に「checked」になります
    this._internals.setFormValue(this.checked ? 'on' : null); 
    this._internals.ariaChecked = this.checked; 
  }

  _onClick(event) {
    this.checked = !this.checked;
  }
}
customElements.define('my-checkbox', MyCheckbox);

ビルトイン要素と同様に、これらはデフォルトの設定であり、ページ作成者が role や aria-* 属性を使用して上書きすることができます:

<!-- このマークアップは非準拠です -->
 <input type="checkbox" checked role="button" aria-checked="false">
<!-- このマークアップはおそらくカスタム要素の作成者が意図したものではありません -->
 <my-checkbox role="button" checked aria-checked="false">

カスタム要素の作成者は、アクセシビリティセマンティクスのどの側面が強力なネイティブセマンティクスであり、カスタム要素のユーザーによって上書きされるべきでないかを明示することが推奨されます。例として、my-checkbox 要素の作成者は、その role と aria-checked の値が強力なネイティブセマンティクスであると述べ、上記のようなコードを避けることを促します。

4.13.1.4 カスタマイズされたビルトイン要素の作成

このセクションは規範的ではありません。

カスタマイズされたビルトイン要素は、カスタム要素の一種であり、自律カスタム要素とは異なり、若干異なる方法で定義され、非常に異なる方法で使用されます。これらは、既存のHTML要素の動作を再利用し、それに新しいカスタム機能を追加するために存在します。これは、HTML要素の既存の動作の多くが、純粋に自律カスタム要素を使用して複製することができないという現実に対処するために重要です。代わりに、カスタマイズされたビルトイン要素は、既存の要素にカスタムの構築動作、ライフサイクルフック、およびプロトタイプチェーンをインストールし、これらの機能を既存の要素に「ミックスイン」することができます。

カスタマイズされたビルトイン要素には、自律カスタム要素とは異なる構文が必要です。これは、ユーザーエージェントや他のソフトウェアが要素のローカル名を基にして、その要素のセマンティクスや動作を識別するためです。つまり、カスタマイズされたビルトイン要素が既存の動作の上に構築されるという概念は、拡張された要素が元のローカル名を保持することに依存しています。

この例では、カスタマイズされたビルトイン要素であるplastic-buttonを作成します。これは通常のボタンのように動作しますが、クリックするたびに派手なアニメーション効果が追加されます。まずクラスを定義しますが、今回はHTMLButtonElementではなく、HTMLElementを拡張します： 

class PlasticButton extends HTMLButtonElement {
   constructor() {
     super();
 
     this.addEventListener("click", () => {
       // 派手なアニメーション効果を描画します！
     });
   }
 }

カスタム要素を定義する際には、extends オプションも指定する必要があります。

customElements.define("plastic-button", PlasticButton, { extends: "button" });

一般的に、拡張される要素の名前は、どの要素インターフェースを拡張しているかを見ただけでは決定できません。例えば、qとblockquoteの両方がHTMLQuoteElementを共有しているように、多くの要素が同じインターフェースを共有しています。

解析されたHTMLソーステキストからカスタマイズされたビルトイン要素を構築するには、is属性をbutton要素に使用します： 

<button is="plastic-button">Click Me!</button>

カスタマイズされたビルトイン要素を自律カスタム要素として使用しようとしても、うまくいきません。つまり、<plastic-button>Click me?</plastic-button>は、特別な動作のないHTMLElementを単に作成するだけです。

プログラムによってカスタマイズされたビルトイン要素を作成する必要がある場合は、次の形式のcreateElement()を使用できます： 

const plasticButton = document.createElement("button", { is: "plastic-button" });
plasticButton.textContent = "Click me!";

そして、前と同じように、コンストラクタも機能します：

const plasticButton2 = new PlasticButton();
console.log(plasticButton2.localName);  // 「button」と出力されます
console.assert(plasticButton2 instanceof PlasticButton);
console.assert(plasticButton2 instanceof HTMLButtonElement);

プログラムによってカスタマイズされたビルトイン要素を作成する場合、is属性はDOMには存在しませんが、明示的に設定されていないためです。しかし、シリアル化時に出力に追加されます：

console.assert(!plasticButton.hasAttribute("is"));
console.log(plasticButton.outerHTML); // 「<button is="plastic-button"></button>」と出力されます

作成方法に関係なく、buttonに特有のすべての方法は、このような「plastic buttons」にも適用されます。それらのフォーカス動作、フォーム送信への参加能力、無効属性などです。

カスタマイズされたビルトイン要素は、ユーザーエージェントによって提供される有用な動作やAPIを持つ既存のHTML要素を拡張することを目的としています。そのため、bgsound、blink、isindex、keygen、multicol、nextid、またはspacerなどのレガシー要素を拡張することはできません。これらはHTMLUnknownElementを要素インターフェースとして使用するように定義されています。

この要件の理由の1つは、将来の互換性です。たとえば、現在未知の要素であるcomboboxを拡張するカスタマイズされたビルトイン要素が定義されている場合、この仕様書が将来combobox要素を定義するのを妨げることになります。なぜなら、カスタマイズされたビルトイン要素の派生物の消費者は、基本要素が面白いユーザーエージェント提供の動作を持たないことに依存してしまうからです。

4.13.1.5 自律カスタム要素の欠点

このセクションは規範的ではありません。

以下に指定されているように、また上記で言及されたように、単にtaco-buttonという要素を定義して使用することは、その要素がボタンを表していることを意味しません。つまり、ウェブブラウザー、検索エンジン、アクセシビリティ技術などのツールは、定義された名前に基づいて自動的にその要素をボタンとして扱うわけではありません。

依然として自律カスタム要素を使用しながら、さまざまなユーザーにボタンのセマンティクスを伝えるためには、いくつかの技術を用いる必要があります：

これらの点を考慮して、ボタンのセマンティクス（無効にする機能を含む）を伝える責任を負う完全機能のtaco-buttonは、次のようなものになるかもしれません：

class TacoButton extends HTMLElement {
  static observedAttributes = ["disabled"];

  constructor() {
    super();
    this._internals = this.attachInternals();
    this._internals.role = "button";

    this.addEventListener("keydown", e => {
      if (e.code === "Enter" || e.code === "Space") {
        this.dispatchEvent(new PointerEvent("click", {
          bubbles: true,
          cancelable: true
        }));
      }
    });

    this.addEventListener("click", e => {
      if (this.disabled) {
        e.preventDefault();
        e.stopImmediatePropagation();
      }
    });

    this._observer = new MutationObserver(() => {
      this._internals.ariaLabel = this.textContent;
    });
  }

  connectedCallback() {
    this.setAttribute("tabindex", "0");

    this._observer.observe(this, {
      childList: true,
      characterData: true,
      subtree: true
    });
  }

  disconnectedCallback() {
    this._observer.disconnect();
  }

  get disabled() {
    return this.hasAttribute("disabled");
  }
  set disabled(flag) {
    this.toggleAttribute("disabled", Boolean(flag));
  }

  attributeChangedCallback(name, oldValue, newValue) {
    // name will always be "disabled" due to observedAttributes
    if (this.disabled) {
      this.removeAttribute("tabindex");
      this._internals.ariaDisabled = "true";
    } else {
      this.setAttribute("tabindex", "0");
      this._internals.ariaDisabled = "false";
    }
  }
}

このように、かなり複雑な要素の定義であっても、その要素は消費者にとっては使いやすいとは言えません。自らの意思でtabindex属性を「生やし続ける」ことになり、tabindex="0"のフォーカス可能性の動作が現在のプラットフォームのbuttonの動作に合わない場合があります。これは、現時点ではカスタム要素に対してデフォルトのフォーカス動作を指定する方法がなく、tabindex属性を使用することが強制されるためです（通常は、消費者がデフォルトの動作をオーバーライドできるようにするために予約されているにもかかわらず）。

対照的に、前のセクションで示したようなシンプルなカスタマイズされたビルトイン要素は、button要素のセマンティクスと動作を自動的に継承し、これらの動作を手動で実装する必要がありません。一般に、HTMLの既存要素に基づいて構築された、非自明な動作とセマンティクスを持つ要素にとって、カスタマイズされたビルトイン要素は、開発、保守、消費がより簡単になります。

4.13.1.6 要素の生成後のアップグレード

このセクションは規範的ではありません。

要素の定義はいつでも行うことができるため、カスタムでない要素が生成され、その後適切な定義が登録された後にカスタム要素になることがあります。このプロセスは、通常の要素をカスタム要素に「アップグレード」するものと呼ばれます。

アップグレードにより、たとえばパーサによって関連要素が最初に生成された後にカスタム要素定義を登録するのが好ましいシナリオを可能にします。これにより、カスタム要素のコンテンツを段階的に強化することができます。たとえば、次のHTMLドキュメントでは、img-viewer要素の定義が非同期で読み込まれます: 

<!DOCTYPE html>
 <html lang="en">
 <title>Image viewer example</title>
 
 <img-viewer filter="Kelvin">
   <img src="images/tree.jpg" alt="A beautiful tree towering over an empty savannah">
 </img-viewer>
 
 <script src="js/elements/img-viewer.js" async></script>

ここでは、img-viewer要素の定義がscript要素を使用して非同期で読み込まれており、async属性が指定されており、マークアップ内の<img-viewer>タグの後に配置されています。スクリプトが読み込まれるまで、img-viewer要素は定義されていない要素として扱われ、spanと同様に処理されます。スクリプトが読み込まれると、img-viewer要素が定義され、ページ上の既存のimg-viewer要素がアップグレードされ、カスタム要素の定義が適用されます（おそらく、「Kelvin」という文字列で指定された画像フィルターを適用し、画像の視覚的な外観を強化します）。

アップグレードは、ドキュメントツリー内の要素にのみ適用されることに注意してください。（正式には、接続された要素。）ドキュメントに挿入されていない要素はアップグレードされません。次の例は、このポイントを説明しています:

<!DOCTYPE html>
 <html lang="en">
 <title>Upgrade edge-cases example</title>
 
 <example-element></example-element>

 <script> 
   "use strict";
 
   const inDocument = document.querySelector("example-element");
   const outOfDocument = document.createElement("example-element");

   // 要素の定義前は、どちらもHTMLElementです:
   console.assert(inDocument instanceof HTMLElement);
   console.assert(outOfDocument instanceof HTMLElement);

   class ExampleElement extends HTMLElement {} 
   customElements.define("example-element", ExampleElement);

   // 要素の定義後、ドキュメント内の要素はアップグレードされました:
   console.assert(inDocument instanceof ExampleElement);
   console.assert(!(outOfDocument instanceof ExampleElement));

   document.body.appendChild(outOfDocument);

   // ドキュメント内に移動したので、こちらもアップグレードされました:
   console.assert(outOfDocument instanceof ExampleElement); 
 </script>
4.13.1.7 カスタム要素の状態の公開

ユーザーエージェントによって提供される組み込み要素には、ユーザーの操作やその他の要因に応じて時間とともに変化する特定の状態があり、疑似クラスを通じてウェブ作者に公開されています。例えば、いくつかのフォームコントロールには「invalid」状態があり、これは:invalid疑似クラスで公開されています。

組み込み要素と同様に、カスタム要素もさまざまな状態を持つことができ、カスタム要素の作者は、これらの状態を組み込み要素と同様の方法で公開したいと考えています。

これは:state()疑似クラスを介して行われます。カスタム要素の作者は、statesプロパティを使用して、ElementInternalsのカスタム状態を追加および削除し、それらが:state()疑似クラスの引数として公開されるようにします。

次の例は、:state()を使用してカスタムチェックボックス要素をスタイリングする方法を示しています。LabeledCheckboxが「checked」状態をコンテンツ属性で公開しないと仮定します。 

<script>
class LabeledCheckbox extends HTMLElement {
   constructor() {
     super();
     this._internals = this.attachInternals();
     this.addEventListener('click', this._onClick.bind(this));

     const shadowRoot = this.attachShadow({mode: 'closed'});
     shadowRoot.innerHTML =
       `<style>
       :host::before {
         content: '[ ]';
         white-space: pre;
         font-family: monospace;
       }
       :host(:state(checked))::before { content: '[x]' }
       </style>`;
   }

   get checked() { return this._internals.states.has('checked'); }

   set checked(flag) { 
     if (flag)
       this._internals.states.add('checked'); 
     else
       this._internals.states.delete('checked'); 
   }

   _onClick(event) { 
     this.checked = !this.checked; 
   }
 }

 customElements.define('labeled-checkbox', LabeledCheckbox);
</script>

<style> 
labeled-checkbox { border: dashed red; } 
labeled-checkbox:state(checked) { border: solid; } 
</style>

<labeled-checkbox>You need to check this</labeled-checkbox>

カスタム疑似クラスはシャドウパーツをターゲットにすることもできます。上記の例を拡張したものがこれです:

<script> 
class QuestionBox extends HTMLElement { 
   constructor() { 
     super(); 
     const shadowRoot = this.attachShadow({mode: 'closed'}); 
     shadowRoot.innerHTML = 
       `<div><slot>Question</slot></div> 
       <labeled-checkbox part='checkbox'>Yes</labeled-checkbox>`; 
   } 
} 
customElements.define('question-box', QuestionBox); 
</script>

<style> 
question-box::part(checkbox) { color: red; } 
question-box::part(checkbox):state(checked) { color: green; } 
</style>

<question-box>Continue?</question-box>

4.13.2 カスタム要素のコンストラクターと反応の要件

カスタム要素のコンストラクターを作成する際、著者は次の適合要件に従う必要があります。

これらの要件のいくつかは、要素作成の過程で直接または間接的にチェックされ、それに従わないと、パーサーやDOM APIによってインスタンス化できないカスタム要素が作成されます。これは、マイクロタスク内で作業が行われた場合でも同様であり、マイクロタスクチェックポイントが構築直後に発生する可能性があるためです。

カスタム要素の反応を作成する際、著者はノードツリーの操作を避けるべきです。これにより予期しない結果が生じる可能性があるためです。

要素のconnectedCallbackが切断される前にキューに入れられることがありますが、コールバックキューがまだ処理されているため、接続されていない要素のconnectedCallbackが結果として生じることがあります： 

class CParent extends HTMLElement {
   connectedCallback() {
     this.firstChild.remove();
   }
 }
 customElements.define("c-parent", CParent);
 
 class CChild extends HTMLElement {
   connectedCallback() {
     console.log("CChild connectedCallback: isConnected =", this.isConnected);
   }
 }
 customElements.define("c-child", CChild);
 
 const parent = new CParent(),
       child = new CChild();
 parent.append(child);
 document.body.append(parent);
 
 // Logs:
 // CChild connectedCallback: isConnected = false
4.13.2.1 移動時のカスタム要素の状態の保持

このセクションは参考情報です。

DOM ツリーを操作する際、要素は接続された状態でツリー内で移動されることがあります。これはカスタム要素にも当てはまります。デフォルトでは、要素に対して「disconnectedCallback」と「connectedCallback」が順に呼び出されます。これは、moveBefore() メソッド以前の既存のカスタム要素との互換性を維持するために行われます。つまり、デフォルトでは、カスタム要素は削除されて再挿入されたかのように状態をリセットします。上記の例では、オブザーバーが切断されて再接続され、タブインデックスがリセットされるという影響があります。

移動中に状態を保持する動作をオプトインするには、作成者は「connectedMoveCallback」を実装できます。このコールバックが存在する場合、空であっても、「disconnectedCallback」と「connectedCallback」を呼び出すデフォルトの動作よりも優先されます。「connectedMoveCallback」は、要素の祖先に依存するロジックを実行するのに適切な場所でもあります。例： 

class TacoButton extends HTMLElement {
  static observedAttributes = ["disabled"];

  constructor() {
    super();
    this._internals = this.attachInternals();
    this._internals.role = "button";

    this._observer = new MutationObserver(() => {
      this._internals.ariaLabel = this.textContent;
    });
  }

  _notifyMain() {
    if (this.parentElement.tagName === "MAIN") {
      // 祖先に依存するロジックを実行します。
    }
  }

  connectedCallback() {
    this.setAttribute("tabindex", "0");

    this._observer.observe(this, {
      childList: true,
      characterData: true,
      subtree: true
    });

    this._notifyMain();
  }

  disconnectedCallback() {
    this._observer.disconnect();
  }

  // この関数を実装すると、この要素が切断されずに DOM 内で移動されたときに、
  // タブインデックスのリセットやミューテーションオブザーバーの再登録を回避できます。
  connectedMoveCallback() {
    // 状態を保持する移動中に親が変更される可能性があります。
    this._notifyMain();
  }
}

4.13.3 カスタム要素の基本概念

カスタム要素とは、カスタムされた要素です。非公式には、これはそのコンストラクタとプロトタイプがユーザーエージェントではなく、著者によって定義されることを意味します。この著者によって提供されたコンストラクタ関数は、カスタム要素コンストラクタと呼ばれます。

2つの異なる種類のカスタム要素を定義できます:

Global_attributes/is

Firefox63+SafariNoChrome67+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

  1. extends オプションなしで定義される自律カスタム要素。これらのタイプのカスタム要素は、その定義された名前と等しいローカル名を持ちます。

  2. extends オプションで定義されるカスタマイズされた組み込み要素。これらのタイプのカスタム要素は、そのextends オプションで渡された値と等しいローカル名を持ち、その定義された名前は is 属性の値として使用されます。したがって、これは有効なカスタム要素名でなければなりません。

カスタム要素が作成された後、is属性の値を変更しても、その要素の動作は変わりません。これは、要素のis値として保存されているためです。

独立カスタム要素は、次の要素定義を持ちます:

カテゴリ:
フローコンテンツ。
フレージングコンテンツ。
感覚的コンテンツ。
フォーム関連カスタム要素に対して: リスト化された、ラベル付け可能な、送信可能な、およびリセット可能な フォーム関連要素。
この要素が使用できるコンテキスト:
フレージングコンテンツが期待される場所。
コンテンツモデル:
透過的。
コンテンツ属性:
グローバル属性、ただしis属性を除く
form、フォーム関連カスタム要素に対して—form要素に関連付けます。
disabled、フォーム関連カスタム要素に対して—フォームコントロールが無効であるかどうか。
readonly、フォーム関連カスタム要素に対して—willValidateに影響します。さらに、カスタム要素著者によって追加された動作。
name、フォーム関連カスタム要素に対して—フォーム送信およびform.elementsAPIで使用する要素の名前。
名前空間を持たないその他の属性（本文を参照）。
アクセシビリティに関する考慮事項:
フォーム関連カスタム要素に対して: 著者向け; 実装者向け。
それ以外の場合: 著者向け; 実装者向け。
DOMインターフェース:
要素の著者によって提供される（HTMLElementから継承される）

独立カスタム要素には特別な意味はありません。それは子要素を表現します。カスタマイズされた組み込み要素は、それが拡張する要素のセマンティクスを継承します。

名前空間を持たない、要素の機能に関連するすべての属性は、要素の著者によって指定される限り、独立カスタム要素に指定できます。ただし、属性名がXML互換であり、ASCII大文字を含まない場合に限ります。例外はis属性であり、独立カスタム要素に指定してはいけません（指定しても効果はありません）。

カスタマイズされた組み込み要素は、拡張する要素に基づいて属性に関する通常の要件に従います。カスタムの属性ベースの動作を追加するには、data-*属性を使用します。

独立カスタム要素は、要素がカスタム要素定義に関連付けられていて、そのフォーム関連フィールドがtrueに設定されている場合、フォーム関連カスタム要素と呼ばれます。

name属性は、フォーム関連カスタム要素の名前を表します。disabled属性は、フォーム関連カスタム要素を非インタラクティブにし、その送信値が送信されるのを防ぐために使用されます。form属性は、フォーム関連カスタム要素をそのフォーム所有者と明示的に関連付けるために使用されます。

readonly属性は、フォーム関連カスタム要素の制約検証から除外されることを指定します。ユーザーエージェントは、この属性に対して他の動作を提供しませんが、カスタム要素の著者は、そのコントロールを内蔵フォームコントロールのreadonly属性の動作に似た適切な方法で編集不可にするために、この属性の存在を利用すべきです。

制約検証: readonly属性がフォーム関連カスタム要素に指定されている場合、その要素は制約検証から除外されます。

フォーム関連カスタム要素のリセットアルゴリズムは、要素、コールバック名「formResetCallback」、および « » を用いてカスタム要素コールバックリアクションをエンキューすることです。

有効なカスタム要素名とは、以下のすべての要件を満たす文字列nameです:

これらの要件は、有効なカスタム要素名のいくつかの目標を確保します:

これらの制限を除いて、<math-α>や<emotion-😍>のようなユースケースに最大の柔軟性を持たせるために、幅広い名前が許可されています。

カスタム要素定義は、カスタム要素を記述し、以下で構成されます。

名前
有効なカスタム要素名
ローカル名
ローカル名
コンストラクタ
Web IDL CustomElementConstructorコールバック関数タイプ値でカスタム要素コンストラクタをラップします。
監視される属性
sequence<DOMString>
ライフサイクルコールバック
キーが文字列「connectedCallback」、「disconnectedCallback」、「adoptedCallback」、「connectedMoveCallback」、「attributeChangedCallback」、「formAssociatedCallback」、「formDisabledCallback」、「formResetCallback」、および「formStateRestoreCallback」であるマップ。対応する値は、Web IDL Function コールバック関数型の値、または null のいずれかです。デフォルトでは、各エントリの値は null です。
構築スタック
最初は空のリストで、要素をアップグレードするアルゴリズムとHTML要素のコンストラクタによって操作されます。リスト内の各エントリは、要素またはすでに構築済みマーカーのいずれかです。
フォーム関連のブール値
これがtrueの場合、ユーザーエージェントはこのカスタム要素定義に関連付けられた要素をフォーム関連カスタム要素として扱います。
内部機能無効化のブール値
attachInternals()を制御します。
シャドウ無効化のブール値
attachShadow()を制御します。

null または CustomElementRegistry オブジェクト registry、文字列または null の namespace、文字列 localName、および文字列または null の is を指定して、カスタム要素定義を検索するには、次の手順を実行します。これらは、カスタム要素定義または null のいずれかを返します。

  1. registry が null の場合、null を返します。

  2. namespace が HTML 名前空間でない場合、null を返します。

  3. registry の カスタム要素定義セットに、名前とローカル名の両方が localName と等しい項目が含まれている場合、その項目を返します。

  4. registry の カスタム要素定義セットに、名前が is と等しく、ローカル名が localName と等しい項目が含まれている場合、その項目を返します。

  5. null を返します。

4.13.4 CustomElementRegistryインターフェース

CustomElementRegistry

すべての現在のエンジンでサポートされています。

Firefox63+Safari10.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

各同一オリジンウィンドウエージェントには、関連付けられたアクティブなカスタム要素コンストラクターマップがあります。これは、コンストラクターから CustomElementRegistry オブジェクトへのマップです。

Window/customElements

すべての現在のエンジンでサポートされています。

Firefox63+Safari10.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Window の customElements ゲッターのステップは次のとおりです。

  1. アサート： this の 関連付けられた Document の カスタム要素レジストリは CustomElementRegistry オブジェクトです。

    Window の 関連付けられた Document は常に新しい CustomElementRegistry オブジェクトで作成されます。

  2. this の 関連付けられた Document の カスタム要素レジストリを返します。 

[Exposed=Window]
interface CustomElementRegistry {
  constructor();

  [CEReactions] undefined define(DOMString name, CustomElementConstructor constructor, optional ElementDefinitionOptions options = {});
  (CustomElementConstructor or undefined) get(DOMString name);
  DOMString? getName(CustomElementConstructor constructor);
  Promise<CustomElementConstructor> whenDefined(DOMString name);
  [CEReactions] undefined upgrade(Node root);
  undefined initialize(Node root);
};

callback CustomElementConstructor = HTMLElement ();

dictionary ElementDefinitionOptions {
  DOMString extends;
};

各CustomElementRegistry は、初期値が false のブール値である is scoped を持ちます。

各CustomElementRegistry は、初期値が « » の Document オブジェクトの セットである scoped document set を持ちます。

各CustomElementRegistry は、初期値が « » の カスタム要素定義の セットである カスタム要素定義セットを持ちます。この セット内のアイテムの検索では、それらの名前、ローカル名、またはコンストラクターを使用します。

各CustomElementRegistry は、要素定義の再入可能な呼び出しを防ぐために使用される 要素定義が実行中 ブール値も持ちます。初期値は false です。

各CustomElementRegistry は、有効なカスタム要素名からプロミスへの マップである when-defined プロミスマップも持ちます。これは whenDefined() メソッドを実装するために使用されます。

Node オブジェクト node を指定して、カスタム要素レジストリを検索するには：

  1. node が Element オブジェクトの場合、node の カスタム要素レジストリを返します。

  2. node が ShadowRoot オブジェクトの場合、node の カスタム要素レジストリを返します。

  3. node が Document オブジェクトの場合、 node の カスタム要素レジストリを返します。

  4. null を返します。

registry = window.customElements
グローバルの関連付けられた Document の CustomElementRegistry オブジェクトを返します。
registry = new CustomElementRegistry()
スコープ指定された使用のために、新しい CustomElementRegistry オブジェクトを構築します。
registry.define(name, constructor)

CustomElementRegistry/define

すべての現在のエンジンでサポートされています。

Firefox63+Safari10.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
新しいカスタム要素を定義し、指定された名前を指定されたコンストラクターに自律カスタム要素としてマッピングします。
registry.define(name, constructor, { extends: baseLocalName })
新しいカスタム要素を定義し、指定された名前を指定されたコンストラクターに、指定された baseLocalName によって識別される要素タイプのカスタマイズされた組み込み要素としてマッピングします。カスタム要素または不明な要素を拡張しようとした場合、または registry がグローバルな CustomElementRegistry オブジェクトでない場合、"NotSupportedError" DOMException がスローされます。
registry.get(name)

CustomElementRegistry/get

すべての現在のエンジンでサポートされています。

Firefox63+Safari10.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
指定された名前に対して定義されたカスタム要素コンストラクターを取得します。指定された名前を持つカスタム要素定義がない場合は undefined を返します。
registry.getName(constructor)
指定されたコンストラクターに対して定義されたカスタム要素の指定された名前を取得します。指定されたコンストラクターを持つカスタム要素定義がない場合は null を返します。
registry.whenDefined(name)

CustomElementRegistry/whenDefined

すべての現在のエンジンでサポートされています。

Firefox63+Safari10.1+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
カスタム要素が指定された名前で定義されたときに、カスタム要素のコンストラクターで解決されるプロミスを返します。（そのようなカスタム要素が既に定義されている場合、返されたプロミスはすぐに解決されます。）有効なカスタム要素名が指定されていない場合、"SyntaxError" DOMException で拒否されたプロミスを返します。
registry.upgrade(root)

CustomElementRegistry/upgrade

すべての現在のエンジンでサポートされています。

Firefox63+Safari12.1+Chrome68+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
root のすべてのシャドウを含む包括的な子孫要素を、接続されていなくてもアップグレードしようとします。
registry.initialize(root)
null レジストリを持つ root の各包括的な子孫は、この CustomElementRegistry オブジェクトに更新されます。

new CustomElementRegistry() コンストラクターのステップは、this の is scoped を true に設定することです。

要素定義は、カスタム要素定義を CustomElementRegistry に追加するプロセスです。これは define() メソッドによって達成されます。define(name, constructor, options) メソッドのステップは次のとおりです。

  1. IsConstructor(constructor) が false の場合、TypeError をスローします。

  2. name が有効なカスタム要素名でない場合、"SyntaxError" DOMException をスローします。

  3. this の カスタム要素定義セットに、名前 name を持つ項目が含まれている場合、"NotSupportedError" DOMException をスローします。

  4. this の カスタム要素定義セットに、コンストラクター constructor を持つ項目が含まれている場合、"NotSupportedError" DOMException をスローします。

  5. localName を name とします。

  6. extends を、存在する場合は options["extends"] とし、それ以外の場合は null とします。

  7. extends が null でない場合：

    1. this の is scoped が true の場合、"NotSupportedError" DOMException をスローします。

    2. extends が有効なカスタム要素名の場合、"NotSupportedError" DOMException をスローします。

    3. extends と HTML 名前空間の要素インターフェイスが HTMLUnknownElement の場合（たとえば、extends がこの仕様の要素定義を示していない場合）、"NotSupportedError" DOMException をスローします。

    4. localName を extends に設定します。

  8. this の 要素定義が実行中が true の場合、"NotSupportedError" DOMException をスローします。

  9. this の 要素定義が実行中を true に設定します。

  10. formAssociated を false とします。

  11. disableInternals を false とします。

  12. disableShadow を false とします。

  13. observedAttributes を空の sequence<DOMString> とします。

  14. 例外をキャッチしながら、次のステップを実行します。

    1. prototype を ? Get(constructor, "prototype") とします。

    2. prototype がオブジェクトでない場合、TypeError 例外をスローします。

    3. lifecycleCallbacks を順序付きマップ «[ "connectedCallback" → null, "disconnectedCallback" → null, "adoptedCallback" → null, "connectedMoveCallback" → null, "attributeChangedCallback" → null ]» とします。

    4. lifecycleCallbacks のキーの各 callbackName について：

      1. callbackValue を ? Get(prototype, callbackName) とします。

      2. callbackValue が undefined でない場合、lifecycleCallbacks[callbackName] を、callbackValue を Web IDL Function コールバック型に変換した結果に設定します。

    5. lifecycleCallbacks["attributeChangedCallback"] が null でない場合：

      1. observedAttributesIterable を ? Get(constructor, "observedAttributes") とします。

      2. observedAttributesIterable が undefined でない場合、observedAttributes を、observedAttributesIterable を sequence<DOMString> に変換した結果に設定します。変換からの例外を再スローします。

    6. disabledFeatures を空の sequence<DOMString> とします。

    7. disabledFeaturesIterable を ? Get(constructor, "disabledFeatures") とします。

    8. disabledFeaturesIterable が undefined でない場合、disabledFeatures を、disabledFeaturesIterable を sequence<DOMString> に変換した結果に設定します。変換からの例外を再スローします。

    9. disabledFeatures が "internals" を含む場合、disableInternals を true に設定します。

    10. disabledFeatures が "shadow" を含む場合、disableShadow を true に設定します。

    11. formAssociatedValue を ? Get( constructor, "formAssociated") とします。

    12. formAssociated を、formAssociatedValue を boolean に変換した結果に設定します。

    13. formAssociated が true の場合、« "formAssociatedCallback", "formResetCallback", "formDisabledCallback", "formStateRestoreCallback" » の各 callbackName について：

      1. callbackValue を ? Get(prototype, callbackName) とします。

      2. callbackValue が undefined でない場合、lifecycleCallbacks[callbackName] を、callbackValue を Web IDL Function コールバック型に変換した結果に設定します。

    次に、上記のステップで例外がスローされたかどうかに関係なく、this の 要素定義が実行中を false に設定します。

    最後に、ステップで例外がスローされた場合は、その例外を再スローします。

  15. definition を、名前 name、ローカル名 localName、コンストラクター constructor、監視される属性 observedAttributes、ライフサイクルコールバック lifecycleCallbacks、フォーム関連 formAssociated、内部無効化 disableInternals、およびシャドウ無効化 disableShadow を持つ新しいカスタム要素定義とします。

  16. this の カスタム要素定義セットに definition を追加します。

  17. this の is scoped が true の場合、this の スコープ指定されたドキュメントセットの各 document について：this、document、definition、および localName を指定して、ドキュメント内の特定の要素をアップグレードします。

  18. それ以外の場合、this、this の 関連するグローバルオブジェクトの 関連付けられた Document、definition、localName、および name を指定して、ドキュメント内の特定の要素をアップグレードします。

  19. this の when-defined プロミスマップ[name] が存在する場合：

    1. this の when-defined プロミスマップ[name] を constructor で解決します。

    2. this の when-defined プロミスマップ[name] を削除します。

CustomElementRegistry オブジェクト registry、Document オブジェクト document、カスタム要素定義 definition、文字列 localName、およびオプションで文字列 name (デフォルトは localName) を指定して、ドキュメント内の特定の要素をアップグレードするには：

  1. upgradeCandidates を、document のシャドウを含む子孫であり、そのカスタム要素レジストリが registry であり、名前空間が HTML 名前空間であり、ローカル名が localName であるすべての要素を、シャドウを含むツリー順で取得したものとします。さらに、name が localName でない場合は、その is 値が name と等しい要素のみを含めます。

  2. upgradeCandidates の各要素 element について：element と definition を指定して、カスタム要素アップグレードリアクションをエンキューします。

get(name) メソッドのステップは次のとおりです。

  1. this の カスタム要素定義セットに、名前 name を持つ項目が含まれている場合、その項目のコンストラクターを返します。

  2. undefined を返します。

CustomElementRegistry/getName

Firefox116+ Safari🔰 プレビュー+ Chrome117+
Opera? Edge117+
Edge (Legacy)? Internet Explorer対応なし
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

getName(constructor) メソッドのステップは次のとおりです。

  1. this の カスタム要素定義セットに、コンストラクター constructor を持つ項目が含まれている場合、その項目の名前を返します。

  2. null を返します。

whenDefined(name) メソッドのステップは次のとおりです。

  1. name が有効なカスタム要素名でない場合、"SyntaxError" DOMException で拒否されたプロミスを返します。

  2. this の カスタム要素定義セットに、名前 name を持つ項目が含まれている場合、その項目のコンストラクターで解決されたプロミスを返します。

  3. this の when-defined プロミスマップ[name] が存在しない場合、this の when-defined プロミスマップ[name] を新しいプロミスに設定します。

  4. this の when-defined プロミスマップ[name] を返します。

whenDefined()メソッドは、適切なカスタム要素が定義されるまでアクションの実行を避けるために使用できます。この例では、:defined疑似クラスと組み合わせて、使用されるすべての自律カスタム要素が定義されるまで、動的に読み込まれる記事の内容を非表示にします。

articleContainer.hidden = true;
 
 fetch(articleURL)
   .then(response => response.text())
   .then(text => {
     articleContainer.innerHTML = text;
 
     return Promise.all(
       [...articleContainer.querySelectorAll(":not(:defined)")]
         .map(el => customElements.whenDefined(el.localName))
     );
   })
   .then(() => {
     articleContainer.hidden = false;
   });

upgrade(root) メソッドのステップは次のとおりです。

  1. candidatesをrootのシャドウを含むすべての包含子孫要素のシャドウを含む木の順序で並べたリストに設定します。

  2. 各 candidatesのcandidateに対して、アップグレードを試みます。

upgrade()メソッドは、要素を任意にアップグレードすることを可能にします。通常、要素は接続されると自動的にアップグレードされますが、このメソッドは要素を接続する準備ができる前にアップグレードする必要がある場合に使用できます。

const el = document.createElement("spider-man");

class SpiderMan extends HTMLElement {}

customElements.define("spider-man", SpiderMan);

console.assert(!(el instanceof SpiderMan)); // not yet upgraded

customElements.upgrade(el);

console.assert(el instanceof SpiderMan); // upgraded!

initialize(root) メソッドのステップは次のとおりです。

  1. root が Document ノードであり、その カスタム要素レジストリが null の場合、root の カスタム要素レジストリを this に設定します。

  2. それ以外の場合、root が ShadowRoot ノードであり、その カスタム要素レジストリが null の場合、root の カスタム要素レジストリを this に設定します。

  3. root の各包括的な子孫 inclusiveDescendant について：inclusiveDescendant が Element ノードであり、その カスタム要素レジストリが null の場合：

    1. inclusiveDescendant の カスタム要素レジストリを this に設定します。

    2. this の is scoped が true の場合、inclusiveDescendant の ノードドキュメントを this の スコープ指定されたドキュメントセットに追加します。

ノードのカスタム要素レジストリが CustomElementRegistry オブジェクトに初期化されると、意図的にそれ以上変更することはできません。これにより、コードに関する推論が簡素化され、実装が最適化できるようになります。

4.13.5 アップグレード

definitionと要素elementを入力として与えられた場合、要素をアップグレードするために、次の手順を実行します:

  1. elementのカスタム要素状態が「undefined」または「uncustomized」でない場合は、処理を終了します。

    これは、このアルゴリズムが再入可能な呼び出しにより発生する場合があります。例えば、次のような例があります:

    <!DOCTYPE html>
<x-foo id="a"></x-foo>
<x-foo id="b"></x-foo>

<script>
// 定義は、「a」と「b」の両方に対してアップグレードのリアクションをキューに追加します
customElements.define("x-foo", class extends HTMLElement {
  constructor() {
    super();

    const b = document.querySelector("#b");
    b.remove();

    // このコンストラクタが「a」のために実行されている間、「b」はまだ
    // undefined であるため、ドキュメントに挿入すると、
    // x-foo を定義することによってキューに追加されたものとは別に、「b」のための二番目のアップグレードリアクションがキューに追加されます。
    document.body.appendChild(b);
  }
})
</script>

    この手順により、「b」が二度目に呼び出された際に、要素のアップグレードが早期にアルゴリズムを終了します。

  2. elementのカスタム要素定義をdefinitionに設定します。

  3. elementのカスタム要素状態を「failed」に設定します。

    アップグレードが成功した後に「custom」に設定されます。現在のところ、「failed」に設定することで、再入可能な呼び出しが上記の早期終了ステップに到達するようになります。

  4. element の 属性リスト内の各 attribute について、順番に、element、コールバック名 "attributeChangedCallback"、および « attribute のローカル名、null、attribute の値、attribute の名前空間 » を用いてカスタム要素コールバックリアクションをエンキューします。

  5. element が接続されている場合、element、コールバック名 "connectedCallback"、および « » を用いてカスタム要素コールバックリアクションをエンキューします。

  6. element を definition の 構築スタックの末尾に追加します。

  7. C を definition の コンストラクターとします。

  8. 周囲のエージェントの アクティブなカスタム要素コンストラクターマップ[C] を element の カスタム要素レジストリに設定します。

  9. 例外をキャッチしながら、次のステップを実行します。

    1. definitionのシャドウを無効にするがtrueであり、elementのシャドウルートがnullでない場合、"NotSupportedError"のDOMExceptionを投げます。

      これは、attachShadow()がカスタム要素定義の検索を使用しないために必要です。一方、attachInternals()は使用します。

    2. elementのカスタム要素状態を「precustomized」に設定します。

    3. Cを引数なしで構築した結果をconstructResultに設定します。

      もしCが[CEReactions]拡張属性で装飾されたAPIを不適合に使用している場合、このアルゴリズムの開始時にキューに追加されたリアクションは、このステップ中にCが終了し、制御がこのアルゴリズムに戻る前に実行されます。そうでない場合、Cとアップグレードプロセスの残りが終了した後に実行されます。

    4. もしSameValue(constructResult, element)がfalseの場合、TypeErrorを投げます。

      これは、Cがsuper()を呼び出す前に同じカスタム要素の別のインスタンスを構築するか、CがJavaScriptのreturn-override機能を使用してコンストラクタから任意のHTMLElementオブジェクトを返す場合に発生します。

    次に、上記のステップで例外がスローされたかどうかに関係なく、次のステップを実行します。

    1. 周囲のエージェントの アクティブなカスタム要素コンストラクターマップ[C] を削除します。

      これは、C が行うべきであるようにすぐに super() を呼び出す場合、no-op です。

    2. definition の 構築スタックの末尾から最後のエントリを削除します。

      C が super() を呼び出し（適合している場合）、その呼び出しが成功すると仮定すると、これはこのアルゴリズムの最初にプッシュした element を置き換えた既に構築済みマーカーになります。（HTML 要素コンストラクターがこの置換を実行します。）

      C が super() を呼び出さない場合（つまり、適合していない場合）、または HTML 要素コンストラクターのいずれかのステップでスローされた場合、このエントリは引き続き element になります。

    最後に、上記のステップが例外を投げた場合、次のサブステップを実行します:

    1. elementのカスタム要素定義をnullに設定します。

    2. elementのカスタム要素リアクションキューを空にします。

    3. 例外を再スローします（このアルゴリズムを終了します）。

    上記のステップが例外を投げた場合、elementのカスタム要素状態は「failed」または「precustomized」のままになります。

  10. elementがフォーム関連カスタム要素である場合、次のサブステップを実行します:

    1. elementのフォームオーナーをリセットします。elementがフォーム要素に関連付けられている場合、element、コールバック名「formAssociatedCallback」および「関連するフォーム」を含む引数リストを用いてカスタム要素コールバックリアクションをキューに追加します。

    2. element が無効化されている場合、element、コールバック名 "formDisabledCallback"、および « true » を用いてカスタム要素コールバックリアクションをエンキューします。

  11. elementのカスタム要素状態を「custom」に設定します。

要素 element を指定して要素のアップグレードを試行するには：

  1. definition を、element の カスタム要素レジストリ、element の 名前空間、element の ローカル名、および element の is 値を指定してカスタム要素定義を検索した結果とします。

  2. definition が null でない場合、element と definition を指定してカスタム要素アップグレードリアクションをエンキューします。

4.13.6 カスタム要素のリアクション

カスタム要素は、特定の出来事に反応して 作者のコードを実行する能力を持っています:

これらの反応をまとめて、カスタム要素のリアクションと呼びます。

カスタム要素のリアクション が呼び出される方法は、繊細な操作の最中に作成者のコードを実行しないよう特別に配慮されています。実際には、「ユーザースクリプトに戻る直前まで」遅延されます。これにより、ほとんどの場合、同期的に実行されるように見えますが、複雑な複合操作（例：クローンや範囲操作など）の場合、すべての関連するユーザーエージェント処理ステップが完了した後に遅延され、バッチとして一緒に実行されます。

さらに、これらの反応の正確な順序は、以下に説明するやや複雑なキューのスタックシステムを介して管理されます。このシステムの意図は、カスタム要素のリアクションが常に それらのトリガーとなるアクションと同じ順序で呼び出されることを保証することです。少なくとも、単一のカスタム要素のローカルコンテキスト内ではそうなります。（ただし、カスタム要素のリアクションコードが独自の変異を行う可能性があるため、複数の要素間でのグローバルな順序保証を提供することはできません。）

各同一オリジンのウィンドウエージェントは、カスタム要素リアクションスタックを持ち、初期状態では空です。同一オリジンのウィンドウエージェントの現在の要素キューは、その要素キューがカスタム要素リアクションスタックの一番上にあるものです。スタックの各項目は、要素キューであり、これも初期状態では空です。要素キューの各項目は要素です。（これらの要素は、必ずしもカスタム要素であるとは限りません。このキューはアップグレードにも使用されるためです。）

すべてのカスタム要素のリアクションスタックには、関連付けられたバックアップ要素キューがあり、最初は空の要素キューです。要素は、バックアップ要素キューに対して、 DOMに影響を与える操作の際に[CEReactions]で装飾されたAPIや、パーサーの トークン用の要素を作成するアルゴリズムを経由せずに、プッシュされます。これの例は、ユーザーが開始した編集操作で、編集可能な要素の子孫や属性を変更する場合です。バックアップ要素キューを処理する際の再入を防ぐために、すべてのカスタム要素のリアクションスタックにはバックアップ要素キューを処理する フラグがあり、初期状態では設定されていません。

すべての要素には、カスタム要素のリアクションキューが関連付けられており、最初は空です。カスタム要素のリアクションキュー内の各項目は、次の2つのタイプのいずれかです:

これらは次の模式図でまとめられています:

カスタム要素のリアクションスタックは要素キューのスタックで構成されています。特定のキューを拡大すると、いくつかの要素が含まれていることがわかります（この例では、<x-a>、<x-b>、<x-c>）。キュー内の特定の要素には、カスタム要素のリアクションキューがあり、リアクションキュー内にはさまざまなリアクション（この例では、アップグレード、属性変更、さらに別の属性変更、接続）がキューに入っています。

適切な要素キューに要素をエンキューするには、要素 elementを指定して、次の手順を実行します:

  1. reactionsStackをelementの関連エージェントの カスタム要素のリアクションスタックに設定します。

  2. reactionsStackが空の場合、次を実行します:

    1. elementをreactionsStackのバックアップ要素キューに追加します。

    2. reactionsStackのバックアップ要素キューを処理するフラグが設定されている場合は、戻ります。

    3. reactionsStackのバックアップ要素キューを処理する フラグを設定します。

    4. マイクロタスクをキューに入れ、次の手順を実行します:

      1. カスタム要素のリアクションを呼び出します、reactionsStackの バックアップ要素キュー内で。

      2. reactionsStackのバックアップ要素キューを処理する フラグを解除します。

  3. それ以外の場合、elementをelementの関連エージェントの 現在の要素キューに追加します。

カスタム要素のコールバックリアクションをエンキューするには、カスタム要素であるelement、コールバック名callbackName、および引数のリストargsを指定して、次の手順を実行します:

  1. definitionをelementのカスタム要素の定義に設定します。

  2. callbackをdefinitionのライフサイクルコールバックの callbackNameキーに対応する値に設定します。

  3. callbackName が "connectedMoveCallback" であり、callback が null の場合：

    1. disconnectedCallback を、definition の ライフサイクルコールバックのキー "disconnectedCallback" を持つエントリの値とします。

    2. connectedCallback を、definition の ライフサイクルコールバックのキー "connectedCallback" を持つエントリの値とします。

    3. connectedCallback と disconnectedCallback が null の場合、戻ります。

    4. callback を次のステップに設定します。

      1. disconnectedCallback が null でない場合、引数なしで disconnectedCallback を呼び出します。

      2. connectedCallback が null でない場合、引数なしで connectedCallback を呼び出します。

  4. callbackがnullの場合、戻ります。

  5. callbackNameが「attributeChangedCallback」の場合、次を実行します:

    1. attributeNameをargsの最初の要素に設定します。

    2. definitionの監視される属性に attributeNameが含まれていない場合、戻ります。

  6. elementのカスタム要素のリアクションキューに新しいコールバックリアクションを追加します。コールバック関数はcallback、引数はargsです。

  7. 適切な要素キューに要素をエンキューするを、elementを指定して実行します。

カスタム要素のアップグレードリアクションをエンキューするには、要素 elementとカスタム要素の定義 definitionを指定して、次の手順を実行します:

  1. elementのカスタム要素のリアクションキューに新しいアップグレードリアクションを追加し、カスタム要素の定義をdefinitionに設定します。

  2. 適切な要素キューに要素をエンキューするを、elementを指定して実行します。

カスタム要素のリアクションを呼び出すには、要素キュー queue内で次の手順を実行します:

  1. queueが空ではない間、次を実行します:

    1. elementをqueueからデキューした結果に設定します。

    2. reactionsをelementのカスタム要素のリアクションキューに設定します。

    3. reactionsが空でない限り、次を繰り返します:

      1. reactionsの最初の要素を削除し、その要素をreactionに設定します。reactionのタイプに応じて次を実行します:

        アップグレードリアクション

        カスタム要素をアップグレードするを、 reactionのカスタム要素の定義を使用して実行します。

        これにより例外がスローされた場合、その例外をキャッチし、例外を報告し、reactionのカスタム要素の定義に対応する JavaScriptオブジェクトの関連するレルムのグローバルオブジェクトに対して例外を報告します。

        コールバックリアクション

        コールバック関数を引数とともに呼び出します、reactionの "報告"とreactionの引数を指定し、thisをelementに設定して実行します。

カスタム要素のリアクションが適切にトリガーされることを保証するために、[CEReactions]というIDLの拡張属性を導入します。これにより、関連するアルゴリズムに追加のステップを補完して、カスタム要素のリアクションを適切に追跡し、呼び出すよう指示します。

[CEReactions]拡張属性は、引数を取らず、操作、属性、セッター、またはデリーター以外のものには現れてはなりません。また、読み取り専用属性には現れてはなりません。

[CEReactions]拡張属性で注釈された操作、属性、セッター、またはデリーターは、記述されたものに代わって次のステップを実行しなければなりません。

  1. 新しい要素キューを、このオブジェクトの関連エージェントのカスタム要素のリアクションスタックにプッシュします。

  2. この構造のために元々指定されていたステップを実行し、例外が発生した場合はキャッチします。ステップが値を返す場合は、valueに返された値を設定します。例外をスローした場合は、exceptionにスローされた例外を設定します。

  3. queueを、このオブジェクトの関連エージェントのカスタム要素のリアクションスタックからポップした結果に設定します。

  4. queue内のカスタム要素のリアクションを呼び出します。

  5. 元のステップでexceptionがスローされた場合は、exceptionを再スローします。

  6. 元のステップでvalueが返された場合は、valueを返します。

この拡張属性の意図はやや微妙です。これを達成する一つの方法は、プラットフォーム上のすべての操作、属性、セッター、デリーターにこれらのステップを挿入し、必要のないケース（カスタム要素のリアクションが発生する可能性のあるDOMの変更がない場合）を最適化することを許可することです。

しかし、実際には、この不正確さがカスタム要素のリアクションの非互換実装につながる可能性があり、いくつかのケースでこれらのステップを呼び出すことを忘れる可能性があります。その代わりに、すべての関連するIDL構造を明示的に注釈するアプローチを選び、互換性のある動作を保証し、実装がこれらのステップが必要なすべてのケースを容易に特定できるようにしました。

ユーザーエージェントによって導入された非標準のAPIで、たとえば属性や子要素を変更することで、カスタム要素のコールバックリアクションをエンキューしたり、カスタム要素のアップグレードリアクションをエンキューするようなDOMの変更を引き起こす可能性がある場合、そのAPIも[CEReactions]属性で装飾する必要があります。

この執筆時点では、次の非標準またはまだ標準化されていないAPIがこのカテゴリに該当することが知られています:

4.13.7 要素内部機能

特定の機能はカスタム要素の作成者にのみ提供され、カスタム要素の利用者には提供されません。これらの機能は、element.attachInternals()メソッドによって提供され、ElementInternalsのインスタンスを返します。ElementInternalsのプロパティおよびメソッドにより、ユーザーエージェントがすべての要素に提供する内部機能を制御できます。

element.attachInternals()

カスタム要素elementを対象としたElementInternalsオブジェクトを返します。elementがカスタム要素でない場合、"internals"機能が要素定義の一部として無効化されている場合、または同じ要素に対して2回呼び出された場合は、例外がスローされます。

各HTMLElementには付属内部機能（nullまたはElementInternalsオブジェクト）があり、初期値はnullです。

HTMLElement/attachInternals

すべての現在のエンジンでサポートされています。

Firefox93+ Safari16.4+ Chrome77+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

attachInternals()メソッドの手順は次の通りです。

  1. thisのis値がnullでない場合、"NotSupportedError" DOMExceptionをスローします。

  2. definition を、this の カスタム要素レジストリ、this の 名前空間、this の ローカル名、および null を指定してカスタム要素定義を検索した結果とします。

  3. definitionがnullである場合、"NotSupportedError" DOMExceptionをスローします。

  4. definitionの内部機能の無効化がtrueである場合、"NotSupportedError" DOMExceptionをスローします。

  5. thisの付属内部機能がnullでない場合、"NotSupportedError" DOMExceptionをスローします。

  6. thisのカスタム要素の状態が"precustomized"または"custom"でない場合、"NotSupportedError" DOMExceptionをスローします。

  7. this の アタッチされた内部を、ターゲット要素が this である新しい ElementInternals インスタンスに設定します。

  8. thisの付属内部機能を返します。

4.13.7.1 ElementInternals インターフェース

ElementInternals

すべての現在のエンジンでサポートされています。

Firefox93+ Safari16.4+ Chrome77+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

ElementInternals インターフェースの IDL は以下の通りで、各操作や属性は次のセクションで定義されています。

[Exposed=Window]
interface ElementInternals {
// シャドウルートのアクセス
readonly attribute ShadowRoot? shadowRoot;

// フォーム関連カスタム要素
undefined setFormValue((File or USVString or FormData)? value,
                      optional (File or USVString or FormData)? state);

readonly attribute HTMLFormElement? form;

undefined setValidity(optional ValidityStateFlags flags = {},
                     optional DOMString message,
                     optional HTMLElement anchor);
readonly attribute boolean willValidate;
readonly attribute ValidityState validity;
readonly attribute DOMString validationMessage;
boolean checkValidity();
boolean reportValidity();

readonly attribute NodeList labels;

// カスタム状態疑似クラス
[SameObject] readonly attribute CustomStateSet states;
};

// アクセシビリティセマンティクス
ElementInternals includes ARIAMixin;

dictionary ValidityStateFlags {
   boolean valueMissing = false;
   boolean typeMismatch = false;
   boolean patternMismatch = false;
   boolean tooLong = false;
   boolean tooShort = false;
   boolean rangeUnderflow = false;
   boolean rangeOverflow = false;
   boolean stepMismatch = false;
   boolean badInput = false;
   boolean customError = false;
};

各 ElementInternals には ターゲット要素 があり、それは カスタム要素 です。

4.13.7.2 シャドウルートへのアクセス
internals.shadowRoot

internals の ターゲット要素 が シャドウホスト である場合、その ShadowRoot を返します。それ以外の場合は null を返します。

ElementInternals/shadowRoot

すべての現在のエンジンでサポートされています。

Firefox93+ Safari16.4+ Chrome88+
Opera? Edge88+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

shadowRoot ゲッターステップは以下の通りです:

  1. target を this の ターゲット要素 とします。

  2. もし target が シャドウホスト でない場合、null を返します。

  3. shadow を target の シャドウルート とします。

  4. もし shadow の 要素内部に利用可能 が false である場合、null を返します。

  5. shadow を返します。

4.13.7.3 フォーム関連カスタム要素
internals.setFormValue(value)

internals の ターゲット要素 の 状態 と 送信値 の両方を value に設定します。

value が null の場合、その要素はフォーム送信に参加しません。

internals.setFormValue(value, state)

internals の ターゲット要素 の 送信値 を value に設定し、その 状態 を state に設定します。

value が null の場合、その要素はフォーム送信に参加しません。

internals.form

internals の ターゲット要素 の フォームオーナー を返します。

internals.setValidity(flags, message [, anchor ])

internals の ターゲット要素 が flags 引数で示された制約に違反しているとマークし、要素の検証メッセージを message に設定します。anchor が指定されている場合、ユーザーエージェントは、インタラクティブにフォームオーナーの検証が行われた際や reportValidity() が呼び出された際に、internals の ターゲット要素 の制約の問題を示すためにそれを使用するかもしれません。

internals.setValidity({})

internals の ターゲット要素 が その制約を満たしている とマークします。

internals.willValidate

フォームが送信されるときに internals の ターゲット要素 が検証される場合は true を、それ以外の場合は false を返します。

internals.validity

internals の ターゲット要素 の ValidityState オブジェクトを返します。

internals.validationMessage

もし internals の ターゲット要素 が検証された場合にユーザーに表示されるエラーメッセージを返します。

valid = internals.checkValidity()

internals の ターゲット要素 が有効性の問題を持たない場合は true を、そうでない場合は false を返します。その後者の場合、invalid イベントがその要素に発生します。

valid = internals.reportValidity()

internals の ターゲット要素 が有効性の問題を持たない場合は true を、それ以外の場合は false を返し、invalid イベントがその要素に発生し、（イベントがキャンセルされない限り）問題がユーザーに報告されます。

internals.labels

internals の ターゲット要素 が関連付けられているすべての NodeList の label 要素を返します。

各 フォーム関連カスタム要素 は 送信値 を持っています。これは、フォーム送信時に一つ以上の エントリ を提供するために使用されます。送信値 の初期値は null であり、送信値 は null、文字列、File、または リスト のいずれかであることができます。

各 フォーム関連カスタム要素 は 状態 を持っています。これは、ユーザーエージェントが要素のユーザー入力を復元するための情報です。状態 の初期値は null であり、状態 は null、文字列、File、または リスト のいずれかであることができます。

setFormValue() メソッドは、カスタム要素の作成者が要素の 送信値 と 状態 を設定し、それらをユーザーエージェントに伝えるために使用します。

ユーザーエージェントがフォーム関連カスタム要素の状態を復元するのが適切であると判断した場合、たとえばナビゲーション後やユーザーエージェントの再起動後など、その要素、コールバック名 "formStateRestoreCallback"、および « 復元する状態, "restore" » を用いてカスタム要素コールバックリアクションをエンキューすることができます。

ユーザーエージェントにフォーム入力支援機能がある場合、その機能が呼び出されると、フォーム関連カスタム要素、コールバック名 "formStateRestoreCallback"、および « 状態値の履歴といくつかのヒューリスティックによって決定された状態値, "autocomplete" » を用いてカスタム要素コールバックリアクションをエンキューすることができます。

一般的に、状態 はユーザーによって指定された情報であり、送信値 は正規化やサニタイズの後にサーバーに送信するのに適した値です。以下の例でこれを具体化します:

たとえば、日付を指定するためにユーザーに尋ねる フォーム関連カスタム要素 があるとします。ユーザーが "3/15/2019" と指定したが、コントロールは "2019-03-15" をサーバーに送信したいとします。"3/15/2019" は要素の 状態 であり、"2019-03-15" は 送信値 となります。

たとえば、既存の チェックボックス input タイプの動作をエミュレートするカスタム要素を開発する場合、その 送信値 はその value コンテンツ属性の値、または文字列 "on" となります。その 状態 は "checked"、"unchecked"、"checked/indeterminate"、または "unchecked/indeterminate" のいずれかになります。

ElementInternals/setFormValue

すべての現在のエンジンでサポートされています。

Firefox98+ Safari16.4+ Chrome77+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

setFormValue(value, state) メソッドのステップは次のとおりです:

  1. element を this の ターゲット要素 とします。

  2. もし element が フォーム関連カスタム要素 でない場合、"NotSupportedError" DOMException をスローします。

  3. valueがFormDataオブジェクトでない場合はelementの送信値をvalueに設定し、そうでない場合はvalueのエントリリストのクローンに設定します。

  4. もし state 引数が省略された場合、element の 状態 を element の 送信値 に設定します。

  5. それ以外の場合、もし state が FormData オブジェクトである場合、element の 状態 を state の エントリリスト の クローン に設定します。

  6. それ以外の場合、element の 状態 を state に設定します。

各フォーム関連カスタム要素には、valueMissing、typeMismatch、patternMismatch、tooLong、tooShort、rangeUnderflow、rangeOverflow、stepMismatch、およびcustomErrorという有効性フラグがあります。これらは初期状態ではfalseです。

各フォーム関連カスタム要素には、検証メッセージ文字列があります。これの初期値は空の文字列です。

各フォーム関連カスタム要素には、検証アンカー要素があります。これの初期値はnullです。

ElementInternals/setValidity

すべての現在のエンジンでサポートされています。

Firefox98+ Safari16.4+ Chrome77+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

setValidity(flags, message, anchor)メソッドの手順は次のとおりです:

  1. element を this の ターゲット要素 とします。

  2. もし element が フォーム関連カスタム要素 でない場合、"NotSupportedError" DOMException をスローします。

  3. もし flags が1つ以上のtrue値を含んでおり、message が指定されていないか空文字列である場合、TypeErrorをスローします。

  4. 各flag → valueのエントリに対して、element の同名の有効性フラグを value に設定します。

  5. もし message が指定されていないか、すべてのelement の有効性フラグがfalseである場合、element の検証メッセージ を空文字列に設定し、そうでない場合は message に設定します。

  6. もし element のcustomError有効性フラグがtrueである場合、element のカスタム有効性エラーメッセージ を element の検証メッセージ に設定します。そうでない場合、element のカスタム有効性エラーメッセージ を空文字列に設定します。

  7. もし anchor が指定されていない場合、element の検証アンカー をnullに設定します。それ以外の場合、もしanchorが element のシャドウを含む子孫 でない場合、"NotFoundError" DOMException をスローします。それ以外の場合、element の検証アンカー を anchor に設定します。

ElementInternals/validationMessage

すべての現在のエンジンでサポートされています。

Firefox98+ Safari16.4+ Chrome77+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

validationMessageのgetter手順は次のとおりです:

  1. element をthis のターゲット要素とします。

  2. もし element がフォーム関連カスタム要素でない場合、"NotSupportedError" DOMException をスローします。

  3. elementの検証メッセージを返します。

エントリ構築アルゴリズムは、フォーム関連カスタム要素に対して、要素elementとエントリリストentry listが与えられた場合に、次の手順を実行します:

  1. もしelementの送信値がエントリのリストである場合、elementの送信値の各項目をentry listに追加し、終了します。

    この場合、ユーザーエージェントはnameコンテンツ属性の値を参照しません。フォーム関連カスタム要素の実装は、エントリの名前を決定する責任があります。これらの名前は、nameコンテンツ属性値に基づく文字列である場合や、nameコンテンツ属性に関連しない場合があります。

  2. もし要素がname属性を指定していないか、そのname属性の値が空文字列である場合、終了します。

  3. もし要素の送信値がnullでない場合、name属性の値と送信値を使用してエントリを作成し、それをentry listに追加します。

4.13.7.4 アクセシビリティセマンティクス
internals.role [ = value ]

internals の ターゲット要素のデフォルトの ARIA ロールを設定または取得します。これは、ページ作成者が role 属性を使用して上書きしない限り使用されます。

internals.aria* [ = value ]

internals の ターゲット要素のさまざまなデフォルトの ARIA 状態またはプロパティ値を設定または取得します。これらは、ページ作成者が aria-* 属性を使用して上書きしない限り使用されます。

各カスタム要素には、内部コンテンツ属性マップがあります。これはマップであり、初期状態では空です。これがプラットフォームのアクセシビリティAPIにどのように影響するかについては、ARIAおよびプラットフォームアクセシビリティAPIに関連する要件セクションを参照してください。

4.13.7.5 カスタム状態擬似クラス
internals.states.add(value)

valueという文字列を要素の状態セットに追加して、擬似クラスとして公開します。

internals.states.has(value)

valueが要素の状態セットに含まれている場合はtrueを返し、そうでない場合はfalseを返します。

internals.states.delete(value)

要素の状態セットにvalueが存在する場合は、それを削除してtrueを返します。そうでない場合はfalseを返します。

internals.states.clear()

要素の状態セットからすべての値を削除します。

for (const stateName of internals.states)
for (const stateName of internals.states.entries())
for (const stateName of internals.states.keys())
for (const stateName of internals.states.values())

要素の状態セット内のすべての値を反復処理します。

internals.states.forEach(callback)

callbackを使用して、要素の状態セット内のすべての値を反復処理します。

internals.states.size

要素の状態セット内の値の数を返します。

各カスタム要素には、状態セットがあり、それは最初は空のCustomStateSetです。

[Exposed=Window]
interface CustomStateSet {
  setlike<DOMString>;
};

states ゲッターのステップは、this の ターゲット要素の 状態セットを返すことです。

状態セットは、文字列の存在/非存在によって表されるブール値の状態を公開できます。作成者が3つの値を持つ状態を公開したい場合、それは3つの排他的なブール状態に変換できます。例えば、readyStateという状態が"loading"、"interactive"、および"complete"の値を持つ場合、それを3つの排他的なブール状態"loading"、"interactive"、および"complete"にマッピングできます: 

// readyState を他の値から "complete" に変更する。
 this._readyState = "complete";
 this._internals.states.delete("loading");
 this._internals.states.delete("interactive");
 this._internals.states.add("complete");

4.14 専用の要素がない一般的な慣用表現

4.14.1 パンくずリストナビゲーション

この仕様では、パンくずリストナビゲーションメニューを機械で読み取れる形で記述する方法を提供していません。著者は、段落内にリンクを並べるだけで良いとされています。nav要素を使用して、これらの段落を含むセクションをナビゲーションブロックとしてマークすることができます。

次の例では、現在のページに2つのパスからアクセスできます。

<nav>
  <p>
   <a href="/">メイン</a> ▸
   <a href="/products/">製品</a> ▸
   <a href="/products/dishwashers/">食器洗い機</a> ▸
   <a>中古</a>
  </p>
  <p>
   <a href="/">メイン</a> ▸
   <a href="/second-hand/">中古</a> ▸
   <a>食器洗い機</a>
  </p>
 </nav>

4.14.2 タグクラウド

この仕様では、ページグループに適用されるキーワードのリスト（タグクラウドとしても知られています）をマークアップするための専用のマークアップは定義されていません。一般的に、著者はul要素を使用して、このようなリストを明示的なインラインカウントでマークアップし、その後それを非表示にしてスタイルシートを使用して表示効果に変換するか、SVGを使用することが推奨されます。

ここでは、3つのタグが短いタグクラウドに含まれています。

<style>
 .tag-cloud > li > span { display: none; }
 .tag-cloud > li { display: inline; }
 .tag-cloud-1 { font-size: 0.7em; }
 .tag-cloud-2 { font-size: 0.9em; }
 .tag-cloud-3 { font-size: 1.1em; }
 .tag-cloud-4 { font-size: 1.3em; }
 .tag-cloud-5 { font-size: 1.5em; }
 
 @media speech {
   .tag-cloud > li > span { display:inline }
 }
 </style>
 ...
 <ul class="tag-cloud">
  <li class="tag-cloud-4"><a title="28 instances" href="/t/apple">apple</a> <span>(popular)</span>
  <li class="tag-cloud-2"><a title="6 instances"  href="/t/kiwi">kiwi</a> <span>(rare)</span>
  <li class="tag-cloud-5"><a title="41 instances" href="/t/pear">pear</a> <span>(very popular)</span>
 </ul>

各タグの実際の頻度は、title属性を使用して示されます。CSSスタイルシートが提供されており、このマークアップを異なるサイズの単語で構成されたクラウドに変換しますが、CSSをサポートしていない、または視覚的でないユーザーエージェントの場合、マークアップには "(popular)" や "(rare)" などの注釈が含まれており、タグの頻度によってさまざまなタグを分類します。これにより、すべてのユーザーがこの情報を利用できるようになります。

ul要素が使用されるのは、順序が特に重要ではないためです。実際にはリストがアルファベット順に並んでいますが、タグの長さなどで順序が変更されても同じ情報を伝えることができます。

これらのa要素には、ページ自体に適用されるタグを表しているわけではないため、tag relキーワードは使用されません。これらはタグ自体を一覧表示するインデックスの一部に過ぎません。

4.14.3 会話

この仕様では、会話、会議の議事録、チャットの記録、脚本の対話、インスタントメッセージのログ、その他の異なるプレイヤーが順番に発言する場面をマークアップするための特定の要素を定義していません。

代わりに、著者にはp要素と句読点を使用して会話をマークアップすることが推奨されます。スタイル設定のために話者をマークする必要がある場合は、spanまたはbを使用することが推奨されます。i要素でテキストを囲んだ段落は、舞台指示をマークアップするために使用できます。

この例では、アボットとコステロの有名なスケッチ「誰が一塁か」の抜粋を使用してこれを示しています。

<p> Costello: Look, you gotta first baseman?
 <p> Abbott: Certainly.
 <p> Costello: Who's playing first?
 <p> Abbott: That's right.
 <p> Costello becomes exasperated.
 <p> Costello: When you pay off the first baseman every month, who gets the money?
 <p> Abbott: Every dollar of it.

以下の抜粋は、IM（インスタントメッセージ）会話ログがどのようにマークアップされるかを示しており、各行にUnixタイムスタンプを提供するためにdata要素を使用しています。タイムスタンプがtime要素がサポートしていない形式で提供されていることに注意してください。そのため、Unix time_tタイムスタンプとしてdata要素が使用されています。もし著者がtime要素でサポートされている日時形式のいずれかを使用してデータをマークアップしたいと考えた場合、その要素をdataの代わりに使用することができました。これは、ページ著者との調整なしにデータ解析ツールがタイムスタンプを明確に検出できるという利点をもたらす可能性があります。 

<p> <data value="1319898155">14:22</data> <b>egof</b> I'm not that nerdy, I've only seen 30% of the star trek episodes
 <p> <data value="1319898192">14:23</data> <b>kaj</b> if you know what percentage of the star trek episodes you have seen, you are inarguably nerdy
 <p> <data value="1319898200">14:23</data> <b>egof</b> it's unarguably
 <p> <data value="1319898228">14:23</data> <i>* kaj blinks</i>
 <p> <data value="1319898260">14:24</data> <b>kaj</b> you are not helping your case

HTMLにはグラフをマークアップするための適切な方法がないため、ゲームのインタラクティブな会話の説明をマークアップするのが難しくなっています。この例は、会話の各ポイントで可能な応答をリストするためにdl要素を使用する一つの可能な慣習を示しています。また、会話をDOTファイルの形式で記述し、その結果をSVG画像として出力し、ドキュメント内に配置するというオプションも考慮する価値があります。[DOT]

<p> Next, you meet a fisher. You can say one of several greetings:
 <dl>
  <dt> "Hello there!"
  <dd>
   <p> She responds with "Hello, how may I help you?"; you can respond with:
   <dl>
    <dt> "I would like to buy a fish."
    <dd> <p> She sells you a fish and the conversation finishes.
    <dt> "Can I borrow your boat?"
    <dd>
     <p> She is surprised and asks "What are you offering in return?".
     <dl>
      <dt> "Five gold." (if you have enough)
      <dt> "Ten gold." (if you have enough)
      <dt> "Fifteen gold." (if you have enough)
      <dd> <p> She lends you her boat. The conversation ends.
      <dt> "A fish." (if you have one)
      <dt> "A newspaper." (if you have one)
      <dt> "A pebble." (if you have one)
      <dd> <p> "No thanks", she replies. Your conversation options
      at this point are the same as they were after asking to borrow
      her boat, minus any options you've suggested before.
     </dl>
    </dd>
   </dl>
  </dd>
  <dt> "Vote for me in the next election!"
  <dd> <p> She turns away. The conversation finishes.
  <dt> "Madam, are you aware that your fish are running away?"
  <dd>
   <p> She looks at you skeptically and says "Fish cannot run, miss".
   <dl>
    <dt> "You got me!"
    <dd> <p> The fisher sighs and the conversation ends.
    <dt> "Only kidding."
    <dd> <p> "Good one!" she retorts. Your conversation options at this
    point are the same as those following "Hello there!" above.
    <dt> "Oh, then what are they doing?"
    <dd> <p> She looks at her fish, giving you an opportunity to steal
    her boat, which you do. The conversation ends.
   </dl>
  </dd>
 </dl>

一部のゲームでは、会話がより簡単で、各キャラクターが言う固定されたセリフのセットを持つだけです。この例では、ゲームのFAQ/ウォークスルーが各キャラクターの既知の可能な応答のいくつかをリストしています:

<section>
  <h1>Dialogue</h1>
  <p><small>Some characters repeat their lines in order each time you interact
  with them, others randomly pick from amongst their lines. Those who respond in
  order have numbered entries in the lists below.</small>
  <h2>The Shopkeeper</h2>
  <ul>
   <li>How may I help you?
   <li>Fresh apples!
   <li>A loaf of bread for madam?
  </ul>
  <h2>The pilot</h2>
  <p>Before the accident:
  <ul>
   <li>I'm about to fly out, sorry!
   <li>Sorry, I'm just waiting for flight clearance and then I'll be off!
  </ul>
  <p>After the accident:
  <ol>
   <li>I'm about to fly out, sorry!
   <li>Ok, I'm not leaving right now, my plane is being cleaned.
   <li>Ok, it's not being cleaned, it needs a minor repair first.
   <li>Ok, ok, stop bothering me! Truth is, I had a crash.
  </ol>
  <h2>Clan Leader</h2>
  <p>During the first clan meeting:
  <ul>
   <li>Hey, have you seen my daughter? I bet she's up to something nefarious again...
   <li>Nice weather we're having today, eh?
   <li>The name is Bailey, Jeff Bailey. How can I help you today?
   <li>A glass of water? Fresh from the well!
  </ul>
  <p>After the earthquake:
  <ol>
   <li>Everyone is safe in the shelter, we just have to put out the fire!
   <li>I'll go and tell the fire brigade, you keep hosing it down!
  </ol>
 </section>

4.14.4 脚注

HTMLには、脚注をマークアップするための専用の仕組みがありません。ここでは、推奨される代替手段を紹介します。

短いインライン注釈には、title属性を使用することができます。

この例では、対話の2つの部分に対して、title属性を使用して脚注のような内容が注釈されています。

<p> <b>顧客</b>: こんにちは！クレームを申し立てたいのですが。こんにちは。お嬢さん？
<p> <b>店員</b>: <span title="What do you" の口語的発音
>「Watcha」</span> どうしましたか？
<p> <b>顧客</b>: ええと、すみません、風邪をひいているんです。クレームを申し立てたいのですが。
<p> <b>店員</b>: すみませんが、<span title="これはもちろん嘘です。">昼食のために閉店します</span>。

残念ながら、title属性に頼ることは、現在では推奨されていません。多くのユーザーエージェントが、この仕様に必要とされるようにアクセシブルな方法で属性を表示していないからです（例えば、マウスなどのポインティングデバイスが必要で、ツールチップが表示される必要があり、キーボードのみのユーザーや現代の携帯電話やタブレットを持つタッチスクリーンユーザーを除外してしまいます）。

もしtitle属性が使用される場合は、CSSを使用して、その属性を持つ要素に読者の注意を引くことができます。

例えば、次のCSSは、title属性を持つ要素の下に破線を引きます。

[title] { border-bottom: thin dashed; }

長い注釈には、a要素を使用し、文書内の後の要素にリンクする必要があります。慣例として、リンクの内容は四角括弧内の数字とします。

この例では、対話の中で脚注がダイアログの下の段落にリンクしています。その段落は対話に戻るリンクを相互に含んでおり、ユーザーが脚注の場所に戻ることができるようにしています。

<p> アナウンサー: ナンバー16: <i>手</i>.
<p> インタビュアー: こんばんは。本日はスタジオに、ここ数年間、人々に反対意見を述べ続けているノーマン・セント・ジョン・ポールヴォールター氏をお迎えしています。ポールヴォールターさん、なぜ<em>そう</em>しているのですか？
<p> ノーマン: していません。<sup><a href="#fn1" id="r1">[1]</a></sup>
<p> インタビュアー: あなたは私にそう言いました！
...
<section>
 <p id="fn1"><a href="#r1">[1]</a> これは当然ながら嘘ですが、逆説的に言えば、もしそれが真実であれば、彼はインタビュアーに反論することなくそれを言うことはできず、それによってそれが偽であることを意味します。</p>
</section>

サイドノート、テキスト全体に適用される長い注釈には、aside要素を使用する必要があります。

この例では、対話の後にサイドバーが表示され、そのコンテキストが示されています。

<p> <span class="speaker">顧客</span>: このレコードは傷があるので買いません。
<p> <span class="speaker">店員</span>: すみません？
<p> <span class="speaker">顧客</span>: このレコードは傷があるので買いません。
<p> <span class="speaker">店員</span>: いやいや、これはタバコ屋です。
<aside>
<p>1970年、イギリス帝国は滅び、その街には多くの外国人が歩いていました — その多くはハンガリー人です
(街ではなく — 外国人です)。残念ながら、アレクサンダー・ヤルトが無能なフレーズブックを出版していました。
</aside>

図や表には、脚注を対応するfigcaptionやcaption要素、または周囲の文章に含めることができます。

この例では、表に脚注があり、それが文章で示されています。figure要素が使用され、表と脚注の組み合わせに単一の説明文を与えています。 

<figure>
<figcaption>表1. 騎士のための代替活動。</figcaption>
<table>
<tr>
<th> 活動
<th> 場所
<th> 費用
</tr>
<tr>
<td> ダンス
<td> 可能な限りどこでも
<td> £0<sup><a href="#fn1">1</a></sup>
</tr>
<tr>
<td> ルーチン、コーラスシーン</sup><a href="#fn2">2</a></sup>
<td> 公表されていない
<td> 公表されていない
</tr>
<tr>
<td> 食事</sup><a href="#fn3">3</a></sup>
<td> キャメロット
<td> ハム、ジャム、スパムの費用</sup><a href="#fn4">4</a></sup>
</tr>
</table>
<p id="fn1">1. 推定。</p>
<p id="fn2">2. 足技が見事。</p>
<p id="fn3">3. 品質は「良い」と評価されています。</p>
<p id="fn4">4. 非常に多い。</p>
</figure>

4.15 無効化された要素

次のいずれかに該当する場合、要素は実際に無効化されたと見なされます。

この定義は、どの要素がフォーカス可能であるか、またどの要素が :enabled や :disabled 疑似クラスに該当するかを判断するために使用されます。

4.16 セレクターとCSSを使用したHTML要素のマッチング

4.16.1 CSS `attr()` 関数の大文字小文字の区別

CSS Values and Unitsは、`attr()`関数の属性名の大文字小文字の区別について、ホスト言語で定義することを残しています。[CSSVALUES]

CSSの`attr()`関数の属性名部分をHTML文書内のHTML要素の名前空間のない属性名と比較する場合、CSS `attr()` 関数の名前部分は、まずASCII小文字に変換する必要があります。他の属性と比較する場合、元の大文字小文字を維持して比較します。いずれの場合も、マッチするためには値が互いに同一である必要があり（したがって、比較は大文字小文字を区別します）。

これは、次のセクションで指定されたCSSの属性セレクターの名前部分と比較するのと同じです。

4.16.2 セレクターの大文字小文字の区別

Selectorsは、要素名、属性名、および属性値の大文字小文字の区別をホスト言語で定義することを残しています。[SELECTORS]

CSS要素型セレクターをHTML文書内のHTML要素名と比較する場合、まずそのCSS要素型セレクターをASCII小文字に変換する必要があります。同じセレクターを他の要素と比較する場合は、元の大文字小文字を維持して比較します。いずれの場合も、比較対象は大文字小文字を区別して一致させる必要があります。

CSS属性セレクターの名前部分をHTML文書内のHTML要素の属性名と比較する場合、まずそのCSS属性セレクターの名前部分をASCII小文字に変換する必要があります。同じセレクターを他の属性と比較する場合は、元の大文字小文字を維持して比較します。いずれの場合も、比較は大文字小文字を区別して行われます。

HTML文書内のHTML要素に対する属性セレクターは、以下の名前を持つ属性の値をASCII大文字小文字を区別しないものとして扱う必要があります:

例えば、セレクター [bgcolor="#ffffff"] は、bgcolor 属性が #ffffff、#FFFFFF、#fffFFF のいずれかの値を持つHTML要素と一致します。これには、bgcolor が特定の要素（例：div）に効果がない場合も含まれます。

セレクター [type=a s] は、type 属性の値が a のHTML要素と一致しますが、A の場合は一致しません。これは、s フラグによるものです。

他のすべての属性値および他のすべてのものは、セレクターのマッチングの目的では完全に同一であると扱う必要があります。これには以下が含まれます:

Selectorsは、IDおよびクラスセレクター（例：#foo および .bar）が クイークモードの文書の要素に対して一致する場合、大文字小文字を区別しないASCIIで一致させることを定義しています。ただし、id や class を名前部分とする属性セレクターには、これが適用されません。セレクター [class="foobar"] は、その値をクイークモードであっても大文字小文字を区別して扱います。

4.16.3 疑似クラス

疑似クラス

HTMLで使用できる動的なセレクターがいくつかあります。このセクションでは、これらのセレクターがHTML要素に一致する条件を定義します。[SELECTORS] [CSSUI]

:defined

:defined

すべての現在のエンジンでサポートされています。

Firefox63+Safari10+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

:defined pseudo-classは、 定義された任意の要素にマッチする必要があります。

:link

:link

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3.5+Edge79+
Edge (Legacy)12+Internet Explorer3+
Firefox Android?Safari iOS3.2+Chrome Android?WebView Android1.5+Samsung Internet?Opera Android?
:visited

:visited

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3.5+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

すべての a 要素が href 属性を持ち、すべての area 要素が href 属性を持つ場合、それらは :link および :visited のいずれかに一致しなければなりません。

その他の仕様は、この要素がこれらの pseudo-classにどのようにマッチするかに関する、より具体的なルールを適用する可能性があります。この要件の直接的な実装に伴ういくつかのプライバシー問題を軽減するためです。

:active

:active

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera5+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

:active pseudo-classは、ユーザーが アクティブ化している間の要素に マッチするように定義されています。

特定の要素が アクティブ化されているかどうかを判断するために、 :active 擬似クラス を定義するためだけに、HTMLユーザーエージェントは次のリストの最初の関連エントリを使用する必要があります。

要素が ボタン 要素である場合
要素が、input 要素であり、その type 属性が Submit Button, Image Button, Reset Button, または Button 状態のいずれかにある場合
要素が a 要素であり、 href 属性を持っている場合
要素が area 要素であり、 href 属性を持っている場合
要素が フォーカス可能である場合

その要素は、正式なアクティベーション状態にある場合、アクティブ化されていると見なされます。

たとえば、ユーザーがキーボードを使用してスペースバーを押すことで ボタン 要素を押している場合、その要素は pseudo-class に一致します。このイベントは、要素が keydown イベントを受信した時点から、keyup イベントを受信した時点までの間に発生します。

要素が アクティブに指されている場合

その要素は、アクティブ化されていると見なされます。

要素は、ユーザーがその要素の アクティベーション動作 をトリガーする意図を示し始めた時点から、ユーザーがその要素の アクティベーション動作 をトリガーする意図を示すのを停止した時点、またはその要素の アクティベーション動作 が終了した時点のいずれか早い時点までの間、「正式なアクティベーション状態」にあると見なされます。

要素は、ユーザーがポインティングデバイスを使用して要素を指し示している間、そのポインティングデバイスが「ダウン」状態にある間（例：マウスの場合、マウスボタンが押されている時点からそれが離される時点まで。マルチタッチ環境での指の場合、指がディスプレイ面に触れている間）、「アクティブに指されている」と見なされます。

セレクタで定義されているように、:active は、アクティブ化されている要素のフラットツリーの先祖要素にも一致します。[SELECTORS]

さらに、ラベル付けされたコントロール要素であり、現在 :active に一致している要素の label 要素も、:active に一致します。ただし、それは アクティブ化されているとは見なされません。

:hover

:hover

すべての現在のエンジンでサポートされています。

Firefox1+Safari2+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

:hover 疑似クラスは、ユーザーがポインティングデバイスで要素を指定する間に、その要素に一致するように定義されています。

Selectors の定義によると、:hover は、フラットツリー内の先祖要素にも一致します。

さらに、現在 :hover に一致している label 要素の ラベル付きコントロール である任意の要素も、:hover に一致します。しかし、それは指定されたとは見なされません。

特に次のようなフラグメントを考えてみましょう。

<p> <label for=c> <input id=a> </label> <span id=b> <input id=c> </span> </p>

ユーザーがポインティングデバイスで ID "a" の要素を指定すると、p 要素（上記のスニペットには表示されていないすべての先祖要素）、label 要素、ID "a" の要素、および ID "c" の要素が :hover 疑似クラスに一致します。ID "a" の要素は指定されたことで一致し、label および p 要素はフラットツリーの先祖要素に関する条件によって一致し、ID "c" の要素はラベル付きコントロールに関する上記の追加条件を通じて一致します（つまり、その label 要素が :hover に一致しているため）。しかし、ID "b" の要素は :hover には一致しません。そのフラットツリーの子孫が指定されていないためです。

:focus

:focus

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera7+Edge79+
Edge (レガシー)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

CSS の :focus 疑似クラスに関して、要素がフォーカスを受けている 状態は次の場合です:

:target

:target

すべての現行エンジンでサポートされています。

Firefox1+Safari1.3+Chrome1+
Opera9.5+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS2+Chrome Android?WebView Android2+Samsung Internet?Opera Android10.1+

CSS の :target 疑似クラスに関して、ドキュメントのターゲット要素は、 ドキュメントの ターゲット要素が null でない場合はその要素のリストであり、 それが null の場合は要素を含まないリストです。[SELECTORS]

:popover-open

:popover-open

すべての現行エンジンでサポートされています。

Firefox🔰 114+Safariプレビュー+Chrome114+
Opera?Edge114+
Edge (レガシー)?Internet Explorer対応なし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

:popover-open 疑似クラスは、HTML 要素の popover属性が No Popover Stateでなく、 ポップオーバー表示状態が 表示されているものに一致するように定義されています。

:enabled

:enabled

すべての現行エンジンでサポートされています。

Firefox1+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android2+Samsung Internet?Opera Android10.1+

:enabled 疑似クラスは、ボタン、 入力、セレクト、テキストエリア、 optgroup、 オプション、fieldset要素、または フォーム関連のカスタム要素で、 実際には無効化されていないものに一致しなければなりません。

:disabled

:disabled

すべての現行エンジンでサポートされています。

Firefox1+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android2+Samsung Internet?Opera Android10.1+

:disabled 疑似クラスは、実際に無効化されているすべての要素に一致しなければなりません。

:checked

:checked

すべての現行エンジンでサポートされています。

Firefox1+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android4+Safari iOS?Chrome Android18+WebView Android2+Samsung Internet?Opera Android10.1+

:checked 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:indeterminate

:indeterminate

すべての現行エンジンでサポートされています。

Firefox2+Safari3+Chrome1+
Opera9+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

:indeterminate 疑似クラス は、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:default

:default

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome10+
Opera10+Edge79+
Edge (レガシー)?Internet Explorerなし
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

:default 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:placeholder-shown

:placeholder-shown 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:valid

:valid

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome10+
Opera10+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

:valid 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:invalid

:invalid

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome10+
Opera10+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

:invalid 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:user-valid

:user-valid 疑似クラスは、次の要素に一致しなければなりません:

:user-invalid

:user-invalid 疑似クラスは、次の要素に一致しなければなりません:

:in-range

:in-range

すべての現行エンジンでサポートされています。

Firefox29+Safari5.1+Chrome10+
Opera11+Edge79+
Edge (レガシー)13+Internet Explorerなし
Firefox Android16+Safari iOS?Chrome Android?WebView Android2.2+Samsung Internet1.0+Opera Android11+

:in-range 疑似クラスは、制約の検証候補であり、範囲制限を持つ要素で、かつ アンダーフローまたは オーバーフロー のいずれでもないものに一致しなければなりません。

:out-of-range

:out-of-range

すべての現行エンジンでサポートされています。

Firefox29+Safari5.1+Chrome10+
Opera11+Edge79+
Edge (レガシー)13+Internet Explorerなし
Firefox Android16+Safari iOS?Chrome Android?WebView Android2.2+Samsung Internet?Opera Android11+

:out-of-range 疑似クラスは、制約の検証候補であり、範囲制限を持つ要素で、かつ アンダーフローまたは オーバーフロー のいずれかであるものに一致しなければなりません。

:required

:required

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome10+
Opera10+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android4.4.3+Samsung Internet?Opera Android10.1+

:required 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:optional

:optional

すべての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome10+
Opera10+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

:optional 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:autofill

:autofill

Firefox86+Safari15+Chrome🔰 1+
Opera?Edge🔰 79+
Edge (レガシー)?Internet Explorerなし
Firefox Android?Safari iOS15+Chrome Android?WebView Android?Samsung Internet?Opera Android?
:-webkit-autofill

:autofillおよび:-webkit-autofill 疑似クラスは、ユーザーエージェントによって自動入力されたinput要素に一致しなければなりません。 これらの疑似クラスは、ユーザーが自動入力されたフィールドを編集すると一致しなくなります。

このような自動入力が発生する一つの方法は、autocomplete 属性を使用することですが、ユーザーエージェントはその属性が関与していなくても自動入力を行うことがあります。

:read-only

:read-only

すべての現行エンジンでサポートされています。

Firefox78+Safari4+Chrome1+
Opera9+Edge79+
Edge (レガシー)13+Internet Explorerなし
Firefox Android🔰 4+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+
:read-write

:read-write

すべての現行エンジンでサポートされています。

Firefox78+Safari4+Chrome1+
Opera9+Edge79+
Edge (レガシー)13+Internet Explorerなし
Firefox Android🔰 4+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

:read-write 疑似クラスは、セレクターの目的上、次のカテゴリのいずれかに該当するものとして ユーザーが変更可能と見なされる要素に一致しなければなりません。 [SELECTORS]

:read-only 疑似クラスは、その他のすべてのHTML要素に一致しなければなりません。

:modal

:modal 疑似クラスは、次のいずれかのカテゴリに該当する要素に一致しなければなりません:

:dir(ltr)

:dir

Firefox49+Safari16.4+Chromeなし
Opera?Edgeなし
Edge (レガシー)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

:dir(ltr) 疑似クラスは、方向性が'ltr'であるすべての要素に一致しなければなりません。

:dir(rtl)

:dir(rtl) 疑似クラスは、方向性が'rtl'であるすべての要素に一致しなければなりません。

カスタム状態疑似クラス

:state(identifier) 疑似クラスは、カスタム要素の状態セットのセットエントリにidentifierが含まれているすべての要素に一致しなければなりません。

:playing

:playing 疑似クラスは、メディア要素のpaused属性がfalseであるすべての要素に一致しなければなりません。

:paused

:paused 疑似クラスは、メディア要素のpaused属性がtrueであるすべての要素に一致しなければなりません。

:seeking

:seeking 疑似クラスは、メディア要素のseeking属性がtrueであるすべての要素に一致しなければなりません。

:buffering

:buffering 疑似クラスは、メディア要素のpaused属性がfalseであり、 networkState属性がNETWORK_LOADINGであり、 レディ状態がHAVE_CURRENT_DATA以下であるすべての要素に一致しなければなりません。

:stalled

:stalled 疑似クラスは、:buffering 疑似クラスに一致し、現在停止しているがtrueであるすべての要素に一致しなければなりません。

:muted

:muted 疑似クラスは、メディア要素であり、 ミュートされているすべての要素に一致しなければなりません。

:volume-locked

:volume-locked 疑似クラスは、ユーザーエージェントのボリュームロックがtrueであるときに、すべてのメディア要素に一致しなければなりません。

:open

:open pseudo-classは、次のカテゴリのいずれかに該当するすべての要素に一致する必要があります。

この仕様書では、:lang()動的疑似クラスが要素に一致するタイミングについて定義していません。これは言語に依存しない方法でSelectorsにおいて十分に詳細に定義されています。 [SELECTORS]

5 マイクロデータ

5.1 はじめに

5.1.1 概要

このセクションは規範的ではありません。

時々、特定の機械可読ラベルでコンテンツに注釈を付けることが望ましい場合があります。例えば、汎用スクリプトがページにカスタマイズされたサービスを提供できるようにしたり、複数の協力している著者からのコンテンツを一つのスクリプトで一貫した方法で処理できるようにしたりするためです。

この目的のために、著者はこのセクションで説明されているマイクロデータ機能を使用できます。マイクロデータを使用すると、既存のコンテンツと並行して、名前と値のペアのネストされたグループをドキュメントに追加できます。

5.1.2 基本構文

このセクションは規範的ではありません。

高レベルでは、マイクロデータは名前と値のペアのグループで構成されています。これらのグループはアイテムと呼ばれ、それぞれの名前と値のペアはプロパティです。アイテムとプロパティは通常の要素で表されます。

アイテムを作成するには、itemscope属性を使用します。

アイテムにプロパティを追加するには、アイテムの子孫要素にitemprop属性を使用します。

ここには2つのアイテムがあり、それぞれが「name」というプロパティを持っています:

<div itemscope>
  <p>私の名前は <span itemprop="name">エリザベス</span>.</p>
 </div>

 <div itemscope>
  <p>私の名前は <span itemprop="name">ダニエル</span>.</p>
 </div>

マイクロデータ関連の属性を持たないマークアップは、マイクロデータモデルに何の影響も与えません。

次の2つの例は、それぞれ前の2つの例とマイクロデータのレベルではまったく同等です:

<div itemscope>
  <p>私の <em>名前</em>は <span itemprop="name">エ<strong>リザベス</strong>ベス</span>.</p>
 </div>

 <section>
  <div itemscope>
   <aside>
    <p>私の名前は <span itemprop="name"><a href="/?user=daniel">ダニエル</a></span>.</p>
   </aside>
  </div>
 </section>

プロパティには、一般的に文字列の値が含まれます。

ここでは、アイテムには3つのプロパティがあります:

<div itemscope>
  <p>私の名前は <span itemprop="name">ニール</span>.</p>
  <p>私のバンドの名前は <span itemprop="band">Four Parts Water</span>.</p>
  <p>私は <span itemprop="nationality">英国人</span>.</p>
 </div>

文字列の値がURLである場合、それはa要素とそのhref属性、img要素とそのsrc属性、または外部リソースへのリンクまたは埋め込みを行うその他の要素を使用して表現されます。

この例では、アイテムには「image」というプロパティが1つあり、その値はURLです:

<div itemscope>
  <img itemprop="image" src="google-logo.png" alt="Google">
 </div>

文字列の値が人間にとって適していない機械可読形式である場合、それはvalue属性を持つdata要素を使用して表現され、その人間が読み取れるバージョンが要素の内容として提供されます。

ここでは、プロパティの値が製品IDであるアイテムがあります。IDは人間向けではないので、製品の名前が人間に見えるテキストとして使用されています:

<h1 itemscope>
  <data itemprop="product-id" value="9678AOU879">インスティゲーター 2000</data>
 </h1>

数値データの場合、meter要素とそのvalue属性を使用することができます。

ここでは、meter要素を使用して評価が行われています。 

<div itemscope itemtype="http://schema.org/Product">
  <span itemprop="name">パナソニック ホワイト 60L 冷蔵庫</span>
  <img src="panasonic-fridge-60l-white.jpg" alt="">
   <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
    <meter itemprop="ratingValue" min=0 value=3.5 max=5>評価 3.5/5</meter>
    (基づく <span itemprop="reviewCount">11</span> 顧客レビュー)
   </div>
 </div>

同様に、日付や時間に関連するデータには、time要素とそのdatetime属性を使用することができます。

この例では、アイテムには「birthday」というプロパティが1つあり、その値は日付です:

<div itemscope>
  私は <time itemprop="birthday" datetime="2009-05-10">2009年5月10日</time>に生まれました。
 </div>

プロパティ自体が名前と値のペアのグループである場合、プロパティを宣言する要素にitemscope属性を付けることで実現できます。

他のアイテムの一部ではないアイテムはトップレベルのマイクロデータアイテムと呼ばれます。

この例では、外側のアイテムは人物を表し、内側のアイテムはバンドを表しています:

<div itemscope>
  <p>名前: <span itemprop="name">アマンダ</span></p>
  <p>バンド: <span itemprop="band" itemscope> <span itemprop="name">ジャズバンド</span> (<span itemprop="size">12</span> 人のプレイヤー)</span></p>
 </div>

ここで、外側のアイテムには「name」と「band」の2つのプロパティがあります。「name」は「アマンダ」、そして「band」はそれ自体がアイテムで、「name」と「size」の2つのプロパティを持っています。バンドの「name」は「ジャズバンド」、そして「size」は「12」です。

この例の外側のアイテムは、トップレベルのマイクロデータアイテムです。

itemscope属性を持つ要素の子孫ではないプロパティは、itemref属性を使用してアイテムに関連付けることができます。この属性は、itemscope属性を持つ要素の子孫に加えて、クロールする要素のIDリストを指定します。

この例は前の例と同じですが、すべてのプロパティがアイテムから分離されています:

<div itemscope id="amanda" itemref="a b"></div>
 <p id="a">名前: <span itemprop="name">アマンダ</span></p>
 <div id="b" itemprop="band" itemscope itemref="c"></div>
 <div id="c">
  <p>バンド: <span itemprop="name">ジャズバンド</span></p>
  <p>サイズ: <span itemprop="size">12</span>人のプレイヤー</p>
 </div>

これは前の例と同じ結果をもたらします。最初のアイテムには2つのプロパティ、「name」が「アマンダ」に設定され、「band」が別のアイテムに設定されています。2番目のアイテムにはさらに2つのプロパティ、「name」が「ジャズバンド」に、「size」が「12」に設定されています。

アイテムには、同じ名前で異なる値を持つ複数のプロパティを持たせることができます。

この例は、2つのフレーバーを持つアイスクリームを説明しています:

<div itemscope>
  <p>私のお気に入りのアイスクリームのフレーバー:</p>
  <ul>
   <li itemprop="flavor">レモンシャーベット</li>
   <li itemprop="flavor">アプリコットシャーベット</li>
  </ul>
 </div>

これにより、「flavor」という2つのプロパティを持ち、それぞれ「レモンシャーベット」と「アプリコットシャーベット」という値を持つアイテムが作成されます。

プロパティを導入する要素は、重複を避けるために、同じ値を持つプロパティがある場合、一度に複数のプロパティを導入することもできます。

ここでは、2つのプロパティ「favorite-color」と「favorite-fruit」を持つアイテムがあり、どちらも値は「オレンジ」に設定されています:

<div itemscope>
  <span itemprop="favorite-color favorite-fruit">オレンジ</span>
 </div>

マイクロデータと、それがマークアップされているドキュメントのコンテンツとの間には、関連性がないことに注意することが重要です。

例えば、次の2つの例には意味的な違いはありません:

<figure>
  <img src="castle.jpeg">
  <figcaption><span itemscope><span itemprop="name">ザ・キャッスル</span></span> (1986)</figcaption>
 </figure>
<span itemscope><meta itemprop="name" content="ザ・キャッスル"></span>
 <figure>
  <img src="castle.jpeg">
  <figcaption>ザ・キャッスル (1986)</figcaption>
 </figure>

どちらもキャプション付きの図を持ち、どちらも図とは無関係に「name」という名前と「ザ・キャッスル」という値を持つアイテムを持っています。違いは、キャプションがドキュメントからドラッグアウトされた場合、前者の場合にはアイテムがドラッグ＆ドロップデータに含まれることです。どちらの場合も、画像はアイテムと何の関連性もありません。

5.1.3 タイプ付きアイテム

このセクションは規範的ではありません。

前のセクションの例では、マイクロデータが再利用されることを想定していないページにどのように情報をマークアップできるかを示しました。しかし、マイクロデータは、他の著者や読者が協力してマークアップの新しい使用方法を作成できるコンテキストで使用される場合に最も有用です。

この目的のために、各アイテムに「https://example.com/person」や「https://example.org/cat」、「https://band.example.net/」のようなタイプを指定する必要があります。タイプはURLとして識別されます。

アイテムのタイプは、itemtype属性の値として、itemscope属性と同じ要素に指定されます。

ここでは、アイテムのタイプが「https://example.org/animals#cat」となっています:

<section itemscope itemtype="https://example.org/animals#cat">
  <h1 itemprop="name">Hedral</h1>
  <p itemprop="desc">Hedral is a male american domestic
  shorthair, with a fluffy black fur with white paws and belly.</p>
  <img itemprop="img" src="hedral.jpeg" alt="" title="Hedral, age 18 months">
 </section>

この例では、「https://example.org/animals#cat」アイテムには、「name」(「Hedral」)、「desc」(「Hedral is...」)、「img」(「hedral.jpeg」)の3つのプロパティがあります。

タイプはプロパティにコンテキストを提供し、したがって語彙を選択します。「https://census.example/person」というタイプのアイテムに指定された「class」というプロパティは、個人の経済的階級を指すかもしれませんが、「https://example.com/school/teacher」というタイプのアイテムに指定された「class」というプロパティは、教師が割り当てられた教室を指すかもしれません。いくつかのタイプは語彙を共有することができます。たとえば、「https://example.org/people/teacher」と「https://example.org/people/engineer」のタイプは、同じ語彙を使用するように定義できます(ただし、いくつかのプロパティは両方のケースでは特に有用ではないかもしれません。たとえば、「https://example.org/people/engineer」タイプは通常、「classroom」プロパティと一緒に使用されないかもしれません)。同じ語彙を使用するように定義された複数のタイプは、属性の値にスペースで区切られたリストとしてURLを列挙することで、1つのアイテムに与えることができます。ただし、異なる語彙を使用しないタイプを1つのアイテムに与えることはできません。

5.1.4 アイテムのグローバル識別子

このセクションは規範的ではありません。

時折、アイテムが、ISBN番号のようなグローバル識別子を持つトピックについての情報を提供することがあります。

itemtype属性によって識別される語彙は、itemid属性に指定されたURLとしてグローバル識別子を表現することで、アイテムがそのグローバル識別子と明確に関連付けられるように設計されることがあります。

itemid属性に指定されたURLの正確な意味は、使用される語彙によって異なります。

ここでは、特定の本について説明するアイテムの例です:

<dl itemscope
     itemtype="https://vocab.example.net/book"
     itemid="urn:isbn:0-330-34032-8">
  <dt>タイトル
  <dd itemprop="title">The Reality Dysfunction
  <dt>著者
  <dd itemprop="author">Peter F. Hamilton
  <dt>出版日
  <dd><time itemprop="pubdate" datetime="1996-01-26">1996年1月26日</time>
 </dl>

この例では、「https://vocab.example.net/book」という語彙は、itemid属性が書籍のISBNを指すurn:形式のURLを受け取ることを定義しています。

5.1.5 語彙を定義する際の名前の選択

このセクションは規範的ではありません。

マイクロデータを使用するということは、語彙を使用することを意味します。ある目的のためには、即席の語彙で十分です。別の目的では、語彙を設計する必要があります。可能な限り、既存の語彙を再利用することが推奨されます。これにより、コンテンツの再利用が容易になります。

新しい語彙を設計する際には、識別子はURLを使用して作成するか、プロパティの場合はプレーンな単語（ドットやコロンを含まない）として作成できます。URLの場合、著者が管理するページに対応する識別子のみを使用することで、他の語彙との競合を避けることができます。

たとえば、JonとAdamがそれぞれexample.comのhttps://example.com/~jon/...とhttps://example.com/~adam/...でコンテンツを書いている場合、それぞれ「https://example.com/~jon/name」と「https://example.com/~adam/name」という形式の識別子を選択することができます。

名前がプレーンな単語であるプロパティは、それらが意図されているタイプのコンテキスト内でのみ使用できます。URLを使用して名前が付けられたプロパティは、任意のタイプのアイテムで再利用することができます。アイテムにタイプがない場合、または別のアイテムの一部でない場合、そのプロパティの名前がプレーンな単語であれば、それはグローバルに一意であることを意図していないため、限定された用途のみに意図されています。一般的に、著者はグローバルに一意の名前（URL）を持つプロパティを使用するか、アイテムがタイプ付きであることを確認することが推奨されます。

ここでは、アイテムは「https://example.org/animals#cat」であり、プロパティの大部分はそのタイプのコンテキスト内で定義された単語として名前が付けられています。さらに、他の語彙から来た名前を持ついくつかの追加のプロパティもあります。 

<section itemscope itemtype="https://example.org/animals#cat">
  <h1 itemprop="name https://example.com/fn">Hedral</h1>
  <p itemprop="desc">Hedral is a male American domestic
  shorthair, with a fluffy <spanitemprop="https://example.com/color">black</span> fur with <spanitemprop="https://example.com/color">white</span> paws and belly.</p>
  <img itemprop="img" src="hedral.jpeg" alt="" title="Hedral, age 18 months">
 </section>

この例では、1つのアイテムが「https://example.org/animals#cat」というタイプを持ち、次のプロパティを持っています。

プロパティ 値
name Hedral
https://example.com/fn Hedral
desc Hedral is a male American domestic shorthair, with a fluffy black fur with white paws and belly.
https://example.com/color black
https://example.com/color white
img .../hedral.jpeg

5.2 マイクロデータのエンコーディング

5.2.1 マイクロデータモデル

マイクロデータモデルは、アイテムと呼ばれる名前と値のペアのグループで構成されています。

各グループはアイテムと呼ばれます。各アイテムは、アイテムタイプ、グローバル識別子（アイテムタイプによって指定された語彙がグローバル識別子をサポートする場合）、および名前と値のペアのリストを持つことができます。名前と値のペアの各名前はプロパティと呼ばれ、各プロパティには1つ以上の値があります。各値は文字列であるか、それ自体が名前と値のペアのグループ（アイテム）です。名前は互いに順序付けられていませんが、特定の名前に複数の値がある場合、それらには相対的な順序があります。

5.2.2 アイテム

Global_attributes/itemscope

すべての最新エンジンでサポートされています。

FirefoxはいSafariはいChromeはい
Opera?Edgeはい
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

すべてのHTML要素には、itemscope属性を指定することができます。 itemscope属性はブール属性です。

itemscope属性が指定された要素は、新しいアイテム、つまり名前と値のペアのグループを作成します。

Global_attributes/itemtype

すべての最新エンジンでサポートされています。

FirefoxはいSafariはいChromeはい
Opera?Edgeはい
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

itemscope属性を持つ要素には、itemtype属性を指定して、アイテムタイプを指定することができます。

指定された場合、itemtype属性の値は一意なスペース区切りトークンの順不同セットでなければならず、そのいずれもが他のトークンと同一であってはならず、各トークンは有効なURL文字列であり、絶対URLである必要があります。また、すべて同じ語彙を使用するように定義されている必要があります。属性の値には、少なくとも1つのトークンが含まれている必要があります。

アイテムのアイテムタイプは、要素のitemtype属性の値をASCII空白で分割して取得されたトークンです。itemtype属性が存在しないか、この方法で解析してもトークンが見つからない場合、そのアイテムにはアイテムタイプがないとされます。

アイテムタイプはすべて適用可能な仕様で定義されたタイプでなければならず、すべて同じ語彙を使用するように定義されていなければなりません。

その仕様で別途指定されていない限り、URLがアイテムタイプとして指定されている場合、自動的に参照されるべきではありません。

仕様によっては、アイテムタイプを参照して、ユーザーにヘルプ情報を提供するなどの定義がされている場合があります。実際、語彙の著者は指定されたURLに役立つ情報を提供することが奨励されています。

アイテムタイプは不透明な識別子であり、ユーザーエージェントは、未知のアイテムタイプを参照したり、それを分解したりして、それを使用するアイテムを処理する方法を決定することはできません。

itemtype属性は、itemscope属性が指定されていない要素には指定してはなりません。

アイテムは、アイテムタイプを持っているか、あるいは、型付きアイテムのプロパティの値である場合、型付きアイテムと呼ばれます。型付きアイテムに対する関連するタイプは、そのアイテムのアイテムタイプであり、もしアイテムタイプがなければ、それがプロパティの値であるアイテムの関連するタイプになります。

Global_attributes/itemid

すべての最新エンジンでサポートされています。

FirefoxはいSafariはいChromeはい
Opera?Edgeはい
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

itemscope属性と、アイテムのグローバル識別子をサポートすると定義された語彙を参照するitemtype属性を持つ要素には、itemid属性を指定して、そのアイテムのグローバル識別子を指定することができます。これにより、他のウェブページにあるアイテムと関連付けることができます。

指定された場合、itemid属性の値はスペースで囲まれる可能性のある有効なURLでなければなりません。

アイテムのグローバル識別子は、その要素のitemid属性の値であり、指定されている場合、その属性が指定されている要素のURLとして解析され、ノードドキュメントに関連付けられます。itemid属性が存在しない場合、または解析に失敗した場合、それにはグローバル識別子がないとされます。

itemid属性は、itemscope属性およびitemtype属性の両方が指定されていない要素には指定してはならず、また、語彙の仕様でアイテムのグローバル識別子をサポートしないと定義されているitemscope属性の要素には指定してはなりません。

グローバル識別子の正確な意味は、語彙の仕様によって決定されます。このような仕様は、同じグローバル識別子を持つ複数のアイテムが（同じページ上または異なるページ上で）存在することが許可されているかどうか、および同じIDを持つ複数のアイテムに関する処理ルールを規定する責任を負います。

Global_attributes/itemref

すべての最新エンジンでサポートされています。

FirefoxはいSafariはいChromeはい
Opera?Edgeはい
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

itemscope属性を持つ要素には、itemref属性を指定して、アイテムの名前と値のペアを見つけるためにクロールする追加の要素のリストを指定できます。

指定された場合、itemref属性の値は一意なスペース区切りトークンの順不同セットでなければならず、そのいずれもが他のトークンと同一であってはならず、同じツリー内の要素のIDで構成されている必要があります。

itemref属性は、itemscope属性が指定されていない要素には指定してはなりません。

itemref属性はマイクロデータモデルの一部ではありません。これは単に、データを注釈付けする際に、データが便利なツリー構造に従っていない場合に、著者を支援するための構文構造です。たとえば、各列が別個のアイテムを定義し、セルにプロパティを保持するように、テーブル内のデータにマークアップを付けることができます。

この例は、鉄道模型メーカーの製品を記述するために使用される簡単な語彙を示しています。この語彙には、次の5つのプロパティ名があります:

product-code
メーカーのカタログで製品を識別する整数。
name
製品の簡単な説明。
scale
製品のスケールを示す "HO"、"1"、または "Z" のいずれか（先頭または末尾にスペースを含む可能性あり）。
digital
製品に搭載されているデジタルデコーダの種類を示す "Digital"、"Delta"、または "Systems" のいずれか（先頭または末尾にスペースを含む可能性あり）。
track-type
線路に関連する製品の場合、その製品が意図されている線路の種類を示す "K"、"M"、または "C" のいずれか（先頭または末尾にスペースを含む可能性あり）。

この語彙には、次の4つの定義されたアイテムタイプがあります:

https://md.example.com/loco
エンジン付きの車両
https://md.example.com/passengers
旅客車両
https://md.example.com/track
線路の部品
https://md.example.com/lighting
照明機器

この語彙を使用するアイテムには、製品が何であるかに応じて、これらのタイプのいずれかまたは複数を指定できます。

したがって、機関車は次のようにマークアップされる可能性があります:

<dl itemscope itemtype="https://md.example.com/loco
                        https://md.example.com/lighting">
<dt>Name:
<dd itemprop="name">Tank Locomotive (DB 80)
<dt>Product code:
<dd itemprop="product-code">33041
<dt>Scale:
<dd itemprop="scale">HO
<dt>Digital:
<dd itemprop="digital">Delta
</dl>

ポイントランタンの後付けキットは次のようにマークアップされる可能性があります:

<dl itemscope itemtype="https://md.example.com/track
                        https://md.example.com/lighting">
<dt>Name:
<dd itemprop="name">Turnout Lantern Kit
<dt>Product code:
<dd itemprop="product-code">74470
<dt>Purpose:
<dd>For retrofitting 2 <span itemprop="track-type">C</span> Track
turnouts. <meta itemprop="scale" content="HO">
</dl>

照明のない客車は次のようにマークアップされる可能性があります:

<dl itemscope itemtype="https://md.example.com/passengers">
<dt>Name:
<dd itemprop="name">Express Train Passenger Car (DB Am 203)
<dt>Product code:
<dd itemprop="product-code">8710
<dt>Scale:
<dd itemprop="scale">Z
</dl>

新しい語彙を作成する際には細心の注意が必要です。多くの場合、タイプに対して階層的なアプローチを取ることで、各アイテムが単一のタイプしか持たない語彙を作成することができ、これが管理するのに非常に簡単です。

5.2.3 名前: itemprop 属性

Global_attributes/itemprop

すべての現在のエンジンでサポートされています。

FirefoxはいSafariはいChromeはい
Opera不明Edgeはい
Edge (レガシー)12+Internet Explorerはい
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

すべての HTML 要素 は、itemprop 属性を指定できます。これにより、1つ以上の プロパティ が 1つ以上の アイテム に追加されます（以下で定義）。

指定されている場合、itemprop 属性の値は、一意のスペースで区切られたトークンの順不同セットであり、そのどれもが他のトークンと 同一ではなく、追加される名前と値のペアの名前を表します。属性の値には少なくとも1つのトークンが必要です。

各トークンは次のいずれかでなければなりません:

定義されたプロパティ名 を導入する仕様は、そのようなプロパティ名が U+002E FULL STOP 文字（.）、U+003A COLON 文字（:）、および ASCII スペース を含まないことを保証する必要があります。

上記のルールは、URL以外の値に U+003A COLON 文字（:）を許可しないため、そうでなければ URL と区別できなくなるためです。U+002E FULL STOP 文字（.）を含む値は将来の拡張のために予約されています。 ASCII スペース は、そうでなければ値が複数のトークンとして解析されるため、禁止されています。

プロパティ が複数の アイテム に追加される場合、上記のトークンに関する要件は、個々の アイテム に個別に適用されます。

要素の プロパティ名 は、要素の itemprop 属性の値が ASCII スペースで分割された ときに含まれるトークンであり、順序が保持され、重複は削除されます（各名前の最初の出現のみが残ります）。

アイテム 内では、同じ名前のプロパティを除いて、プロパティは互いに順序付けられていません。同じ名前のプロパティは、アイテムの プロパティを定義するアルゴリズム によって与えられた順序で順序付けられています。

次の例では、「a」プロパティには「1」と「2」の値があり、その順序で です。ただし、「a」プロパティが「b」プロパティの前にあるかどうかは重要ではありません:

<div itemscope>
  <p itemprop="a">1</p>
  <p itemprop="a">2</p>
  <p itemprop="b">テスト</p>
 </div>

したがって、次のものと同等です:

<div itemscope>
  <p itemprop="b">テスト</p>
  <p itemprop="a">1</p>
  <p itemprop="a">2</p>
 </div>

次のものも同様です:

<div itemscope>
  <p itemprop="a">1</p>
  <p itemprop="b">テスト</p>
  <p itemprop="a">2</p>
 </div>

さらに次のものも同様です:

<div id="x">
  <p itemprop="a">1</p>
 </div>
 <div itemscope itemref="x">
  <p itemprop="b">テスト</p>
  <p itemprop="a">2</p>
 </div>

5.2.4 値

itemprop 属性を持つ要素によって追加される名前と値のペアのプロパティ値は、以下のリストの最初に一致するケースに基づいて決定されます。

要素がitemscope属性も持つ場合

値は、要素によって作成されたアイテムです。

要素がmeta要素である場合

値は、要素のcontent属性の値です。属性がない場合は空の文字列となります。

要素がaudio、embed、iframe、img、source、track、またはvideo要素である場合

値は、要素のsrc属性の値に基づいて、要素のノード文書に対してURLを エンコード、パース、およびシリアライズした結果です。属性がない場合や結果が失敗した場合は空の文字列となります。

要素がa、area、またはlink要素である場合

値は、要素のhref属性の値に基づいて、要素のノード文書に対してURLを エンコード、パース、およびシリアライズした結果です。属性がない場合や結果が失敗した場合は空の文字列となります。

要素がobject要素である場合

値は、要素のdata属性の値に基づいて、要素のノード文書に対してURLを エンコード、パース、およびシリアライズした結果です。属性がない場合や結果が失敗した場合は空の文字列となります。

要素がdata要素である場合

値は、要素のvalue属性の値です。属性がない場合は空の文字列となります。

要素がmeter要素である場合

値は、要素のvalue属性の値です。属性がない場合は空の文字列となります。

要素がtime要素である場合

値は要素のdatetime 値です。

その他の場合

値は要素の子孫テキストコンテンツです。

URL プロパティ要素は、a、area、 audio、embed、iframe、 img、link、 object、source、 track、およびvideo要素です。

プロパティの値が、その定義によって絶対 URLである場合、プロパティはURL プロパティ要素を使用して指定する必要があります。

これらの要件は、プロパティ値がたまたま URL の構文に一致するだけで適用されるわけではありません。プロパティが明示的にそのような値を取ると定義されている場合にのみ適用されます。

例えば、最初の月面着陸についての本が「mission:moon」と呼ばれることがあります。タイトルが文字列として定義されている語彙の「タイトル」プロパティは、たとえそれが URL のように見えても、 a 要素で指定されることを期待しません。一方、「URLのように見えるタイトルを持つ本」に関する（非常に限定された！）語彙があり、URL を取るように定義された「タイトル」プロパティがある場合、プロパティはa 要素（または他の URL プロパティ要素 のいずれか）で指定されることを期待します。

5.2.5 アイテムに名前を関連付ける

root要素によって定義されるアイテムのプロパティを見つけるために、ユーザーエージェントは以下の手順を実行する必要があります。これらの手順は、マイクロデータエラーをフラグするためにも使用されます。

  1. results、memory、およびpendingという空の要素リストを作成します。

  2. root要素をmemoryに追加します。

  3. もしrootに子要素があれば、それらをpendingに追加します。

  4. もしrootがitemref属性を持っている場合、そのitemref属性の値をASCII空白文字で分割します。その結果得られる各トークンIDに対して、rootのツリーにIDというIDを持つ要素が存在する場合、その最初の要素をpendingに追加します。

  5. pendingが空でない間:

    1. pendingから要素を取り出し、その要素をcurrentとします。

    2. もしcurrentが既にmemoryに含まれている場合、マイクロデータエラーが発生し、続行します。

    3. currentをmemoryに追加します。

    4. もしcurrentがitemscope属性を持っていない場合、その子要素をすべてpendingに追加します。

    5. もしcurrentがitemprop属性を持ち、かつ一つ以上のプロパティ名を持っている場合、currentをresultsに追加します。

  6. resultsをツリー順で並べ替えます。

  7. resultsを返します。

ドキュメントには、アルゴリズムによってマイクロデータエラーが見つかるアイテムが含まれていてはなりません。

アイテムは、その要素にitemprop属性が指定されていない場合、トップレベルのマイクロデータアイテムと呼ばれます。

itemref属性は、ドキュメント内のアイテムがサイクルを形成しないように設定されている必要があります。グラフを構成する際に、ドキュメント内の各アイテムをノードとして表し、アイテムのプロパティの値が別のアイテムである場合、そのプロパティを接続するエッジとして表します。

ドキュメントには、itemprop属性を持つ要素が含まれていてはなりません。それらがドキュメント内のいずれかのアイテムのプロパティとして見つからない場合です。

この例では、単一のライセンス文が2つの作品に適用されており、作品を表すアイテムからitemrefを使用しています:

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>Photo gallery</title>
  </head>
  <body>
   <h1>My photos</h1>
   <figure itemscope itemtype="http://n.whatwg.org/work" itemref="licenses">
    <img itemprop="work" src="images/house.jpeg" alt="A white house, boarded up, sits in a forest.">
    <figcaption itemprop="title">The house I found.</figcaption>
   </figure>
   <figure itemscope itemtype="http://n.whatwg.org/work" itemref="licenses">
    <img itemprop="work" src="images/mailbox.jpeg" alt="Outside the house is a mailbox. It has a leaflet inside.">
    <figcaption itemprop="title">The mailbox.</figcaption>
   </figure>
   <footer>
    <p id="licenses">All images licensed under the <a itemprop="license"
    href="http://www.opensource.org/licenses/mit-license.php">MIT
    license</a>.</p>
   </footer>
  </body>
 </html>

上記の結果、次のタイプ "http://n.whatwg.org/work" を持つ2つのアイテムが生成されます:

work
images/house.jpeg
title
The house I found.
license
http://www.opensource.org/licenses/mit-license.php

...そして、次のアイテム:

work
images/mailbox.jpeg
title
The mailbox.
license
http://www.opensource.org/licenses/mit-license.php

5.2.6 マイクロデータと他の名前空間

現在、itemscope、itemprop、および他のマイクロデータ属性は、HTML要素のためにのみ定義されています。つまり、"itemscope"、"itemprop"などのリテラル名を持つ属性は、SVGなどの他の名前空間の要素ではマイクロデータの処理を引き起こしません。

したがって、次の例ではアイテムは1つだけで、2つではありません。

<p itemscope></p> <!-- これはアイテムです（プロパティもタイプもなし） -->
 <svg itemscope></svg> <!-- これはアイテムではなく、単に無効な未知の属性を持つSVG svg要素です -->

5.3 マイクロデータ語彙のサンプル

このセクションの語彙は主に語彙がどのように指定されるかを示すことを目的としていますが、それ自体でも使用可能です。

5.3.1 vCard

項目タイプが http://microformats.org/profile/hcardであるアイテムは、個人または組織の連絡先情報を表します。

この語彙はアイテムのグローバル識別子をサポートしません。

以下は、このタイプの定義されたプロパティ名です。それらは、vCard Format Specification（vCard）およびその拡張機能で定義された語彙に基づいており、値の解釈方法に関する詳細はそこに記載されています。[RFC6350]

kind

アイテムが表す連絡先の種類を説明します。

値は、次のいずれかに一致するテキストである必要があります。種類の文字列。

kindという名前の単一のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に存在する場合があります。

fn

個人または組織の名前に対応する書式化されたテキストを提供します。

値はテキストである必要があります。

fnという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に正確に1つ存在する必要があります。

n

個人または組織の構造化された名前を提供します。

値は、family-name、given-name、additional-name、honorific-prefix、およびhonorific-suffixプロパティのそれぞれを0個以上持つアイテムである必要があります。

nという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に正確に1つ存在する必要があります。

family-name（n内）

個人の姓、または組織のフルネームを提供します。

値はテキストである必要があります。

アイテムが値を形成するnプロパティ内に、family-nameという名前のプロパティが任意の数存在することができます。

given-name（n内）

個人の名を提供します。

値はテキストである必要があります。

アイテムが値を形成するnプロパティ内に、given-nameという名前のプロパティが任意の数存在することができます。

additional-name（n内）

個人の追加名を提供します。

値はテキストである必要があります。

アイテムが値を形成するnプロパティ内に、additional-nameという名前のプロパティが任意の数存在することができます。

honorific-prefix（n内）

個人の敬称を提供します。

値はテキストである必要があります。

アイテムが値を形成するnプロパティ内に、honorific-prefixという名前のプロパティが任意の数存在することができます。

honorific-suffix（n内）

個人の敬称を提供します。

値はテキストである必要があります。

アイテムが値を形成するnプロパティ内に、honorific-suffixという名前のプロパティが任意の数存在することができます。

nickname

個人または組織のニックネームを提供します。

ニックネームとは、人、場所、物に属するものの代わりに、または追加して与えられる記述的な名前です。また、fnまたはnプロパティによって指定された正式な名前の親しみやすい形式を指定するためにも使用できます。

値はテキストである必要があります。

nicknameという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

photo

個人または組織の写真を提供します。

値は絶対URLである必要があります。

photoという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

bday

個人または組織の生年月日を提供します。

値は有効な日付文字列である必要があります。

bdayという名前の単一のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に存在する場合があります。

anniversary

個人または組織の記念日を提供します。

値は有効な日付文字列である必要があります。

anniversaryという名前の単一のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に存在する場合があります。

sex

個人の生物学的性別を提供します。

値は、F（"女性"）、M（"男性"）、N（"なしまたは該当なし"）、O（"その他"）、またはU（"不明"）のいずれかである必要があります。

sexという名前の単一のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に存在する場合があります。

gender-identity

個人の性自認を提供します。

値はテキストである必要があります。

gender-identityという名前の単一のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に存在する場合があります。

adr

個人または組織の配達先住所を提供します。

値はアイテムであり、0個以上のtype、post-office-box、extended-address、street-addressプロパティ、およびオプションでlocalityプロパティ、オプションでregionプロパティ、オプションでpostal-codeプロパティ、およびオプションでcountry-nameプロパティを持つ必要があります。

もし、typeプロパティが、アイテム内に存在せず、そのアイテムが値を形成するadrプロパティが、http://microformats.org/profile/hcardタイプのアイテム内に存在する場合、住所タイプ文字列としてworkが暗黙的に適用されます。

adrという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

type（adr内）

配達先住所の種類を提供します。

値は、次のいずれかに一致するテキストである必要があります。アドレスタイプ文字列。

アイテムが値を形成するadrプロパティ内に、typeという名前のプロパティが任意の数存在することができますが、各adrプロパティ内のアイテムには、異なる値ごとに1つだけtypeプロパティが存在する必要があります。

post-office-box（adr内）

個人または組織の配達先住所の郵便私書箱部分を提供します。

値はテキストである必要があります。

アイテムが値を形成するadrプロパティ内に、post-office-boxという名前のプロパティが任意の数存在することができます。

vCardは著者にこのフィールドを使用しないよう強く勧めています。

extended-address（adr内）

個人または組織の配達先住所の追加コンポーネントを提供します。

値はテキストである必要があります。

アイテムが値を形成するadrプロパティ内に、extended-addressという名前のプロパティが任意の数存在することができます。

vCardは著者にこのフィールドを使用しないよう強く勧めています。

street-address（adr内）

個人または組織の配達先住所の街区部分を提供します。

値はテキストである必要があります。

アイテムが値を形成するadrプロパティ内に、street-addressという名前のプロパティが任意の数存在することができます。

locality（adr内）

個人または組織の配達先住所の地域部分（例：市）を提供します。

値はテキストである必要があります。

localityという名前のプロパティが、http://microformats.org/profile/hcardタイプのアイテムが値を形成するadrプロパティ内に存在する場合があります。

region（adr内）

個人または組織の配達先住所の地域部分（例：州または県）を提供します。

値はテキストである必要があります。

regionという名前のプロパティが、http://microformats.org/profile/hcardタイプのアイテムが値を形成するadrプロパティ内に存在する場合があります。

postal-code（adr内）

個人または組織の配達先住所の郵便番号部分を提供します。

値はテキストである必要があります。

postal-codeという名前のプロパティが、http://microformats.org/profile/hcardタイプのアイテムが値を形成するadrプロパティ内に存在する場合があります。

country-name（adr内）

個人または組織の配達先住所の国名部分を提供します。

値はテキストである必要があります。

country-nameという名前のプロパティが、http://microformats.org/profile/hcardタイプのアイテムが値を形成するadrプロパティ内に存在する場合があります。

tel

個人または組織の電話番号を提供します。

値は、テキストであり、CCITTの仕様E.163およびX.121で定義された電話番号として解釈できるか、アイテムであり、0個以上のtypeプロパティと正確に1つのvalueプロパティを持つ必要があります。[E163] [X121]

もしtypeプロパティがhttp://microformats.org/profile/hcardタイプのアイテムの値を構成するtelプロパティ内に存在しない場合、またはその値がテキストである場合、電話タイプ文字列のvoiceが暗示されます。

telという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

type（tel内）

電話番号の種類を提供します。

値は、次のいずれかに一致するテキストである必要があります。電話タイプ文字列。

アイテムが値を形成するtelプロパティ内に、typeという名前のプロパティが任意の数存在することができますが、各telプロパティ内のアイテムには、異なる値ごとに1つだけtypeプロパティが存在する必要があります。

value（tel内）

個人または組織の実際の電話番号を提供します。

値はテキストであり、CCITTの仕様E.163およびX.121で定義された電話番号として解釈できる必要があります。[E163][X121]

valueという名前のプロパティが、アイテムが値を形成するtelプロパティ内に正確に1つ存在する必要があります。

email

個人または組織のメールアドレスを提供します。

値はテキストである必要があります。

emailという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

impp

個人または組織とのインスタントメッセージングおよびプレゼンスプロトコル通信のためのURLを提供します。

値は絶対URLである必要があります。

imppという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

lang

個人または組織が理解する言語を提供します。

値は有効なBCP 47言語タグである必要があります。[BCP47]

langという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

tz

個人または組織のタイムゾーンを提供します。

値はテキストであり、次の構文に一致する必要があります:

  1. U+002B プラス記号（+）または U+002D ハイフンマイナス記号（-）のいずれか。
  2. 正確に2桁であり、範囲が00..23の数字を表す有効な非負整数。
  3. U+003A コロン記号（:）。
  4. 正確に2桁であり、範囲が00..59の数字を表す有効な非負整数。

tzという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

geo

個人または組織の地理的位置を提供します。

値はテキストであり、次の構文に一致する必要があります:

  1. オプションで、U+002B プラス記号（+）または U+002D ハイフンマイナス記号（-）のいずれか。
  2. 1つ以上のASCII 数字。
  3. オプションで、U+002E ピリオド（.）と、それに続く1つ以上のASCII 数字。
  4. U+003B セミコロン（;）。
  5. オプションで、U+002B プラス記号（+）または U+002D ハイフンマイナス記号（-）のいずれか。
  6. 1つ以上のASCII 数字。
  7. オプションで、U+002E ピリオド（.）と、それに続く1つ以上のASCII 数字。

アスタリスク（*）でマークされたオプションのコンポーネントは含める必要があり、それぞれ6桁である必要があります。

値は緯度と経度をその順序で指定します（すなわち「LAT LON」の順序）。経度は、グリニッジ子午線から東西に位置する場所をそれぞれ正または負の実数として表します。緯度は、赤道から南北に位置する場所をそれぞれ正または負の実数として表します。

geoという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

title

個人または組織の役職、機能的位置または職務を提供します。

値はテキストである必要があります。

titleという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

role

個人または組織の役割、職業、またはビジネスカテゴリを提供します。

値はテキストである必要があります。

roleという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

個人または組織のロゴを提供します。

値は絶対URLである必要があります。

という名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

agent

個人または組織を代表して行動する別の人物の連絡先情報を提供します。

値は、アイテムであり、タイプhttp://microformats.org/profile/hcardを持つか、または絶対URLであるか、テキストである必要があります。

agentという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

org

組織の名称および単位を提供します。

値は、テキストであるか、またはorganization-nameプロパティを1つ持ち、0個以上のorganization-unitプロパティを持つアイテムである必要があります。

orgという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

organization-name（org内）

組織の名称を提供します。

値はテキストである必要があります。

organization-nameという名前のプロパティが、アイテムが値を形成するorgプロパティ内に正確に1つ存在する必要があります。

organization-unit（org内）

組織の単位名称を提供します。

値はテキストである必要があります。

organization-unitという名前のプロパティが、アイテムが値を形成するorgプロパティ内に任意の数存在することができます。

member

URLを提供し、グループのメンバーを表します。

値は絶対URLである必要があります。

memberという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができますが、アイテムにkindという名前のプロパティが存在し、その値が"group"である場合に限ります。

related

他のエンティティとの関係を提供します。

値は1つのurlプロパティと1つのrelプロパティを持つアイテムである必要があります。

relatedという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

url（related内）

URLを提供し、関連するエンティティを表します。

値は絶対URLである必要があります。

urlという名前のプロパティが、アイテムが値を形成するrelatedプロパティ内に正確に1つ存在する必要があります。

rel（related内）

エンティティと関連するエンティティとの関係を提供します。

値は、次のいずれかに一致するテキストである必要があります。関係文字列。

relという名前のプロパティが、アイテムが値を形成するrelatedプロパティ内に正確に1つ存在する必要があります。

categories

個人または組織が分類されうるカテゴリまたはタグの名前を提供します。

値はテキストである必要があります。

categoriesという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

note

個人または組織に関する補足情報やコメントを提供します。

値はテキストである必要があります。

noteという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

rev

連絡先情報の修正日と時間を提供します。

値はテキストであり、有効なグローバル日付時刻文字列である必要があります。

値は、情報の他のバージョンに対して現在の情報の修正を区別します。

revという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

sound

個人または組織に関連するサウンドファイルを提供します。

値は絶対URLである必要があります。

soundという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

uid

個人または組織に対応するグローバルに一意の識別子を提供します。

値はテキストである必要があります。

uidという名前の単一のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に存在する場合があります。

url

個人または組織に関連するURLを提供します。

値は絶対URLである必要があります。

urlという名前のプロパティが、http://microformats.org/profile/hcardタイプの各アイテム内に任意の数存在することができます。

種類文字列は以下の通りです：

individual

単一のエンティティを示します（例：個人）。

group

複数のエンティティを示します（例：メーリングリスト）。

org

個人以外の単一のエンティティを示します（例：会社）。

location

地理的な場所を示します（例：オフィスビル）。

住所タイプ文字列は以下の通りです：

home

居住地の配送先住所を示します。

work

勤務先の配送先住所を示します。

電話タイプ文字列は以下の通りです：

home

居住用電話番号を示します。

work

勤務先の電話番号を示します。

text

テキストメッセージ（SMS）をサポートする電話番号を示します。

voice

音声通話用の電話番号を示します。

fax

ファクシミリ電話番号を示します。

cell

携帯電話番号を示します。

video

ビデオ会議用の電話番号を示します。

pager

ポケベルデバイス用の電話番号を示します。

textphone

聴覚または発話に障害のある人向けの通信デバイスを示します。

関係性文字列は以下の通りです：

emergency

緊急連絡先。

agent

このエンティティに代わって行動する別のエンティティ。

contact
acquaintance
friend
met
worker
colleague
resident
neighbor
child
parent
sibling
spouse
kin
muse
crush
date
sweetheart
me

XFNで定義されている意味を持ちます。[XFN]

5.3.1.1 vCardへの変換

ユーザーエージェントは、Document内のノードのリストnodesが与えられた場合、以下のアルゴリズムを実行して、これらのノードによって表されるvCardデータを抽出する必要があります（最初のvCardのみが返されます）：

  1. nodes内のノードのいずれも、アイテムであり、アイテムタイプがhttp://microformats.org/profile/hcardでない場合、vCardは存在しません。アルゴリズムを中止し、何も返さない。

  2. nodeを、nodes内の最初のノードで、アイテムであり、アイテムタイプがhttp://microformats.org/profile/hcardであるものとします。

  3. outputを空の文字列とします。

  4. タイプが「BEGIN」で値が「VCARD」のvCardラインを追加して、outputに追加します。

  5. タイプが「PROFILE」で値が「VCARD」のvCardラインを追加して、outputに追加します。

  6. タイプが「VERSION」で値が「4.0」のvCardラインを追加して、outputに追加します。

  7. タイプが「SOURCE」で、vCardテキスト文字列をエスケープした結果であるドキュメントのURLを値としてoutputに追加します。

  8. title要素がnullでない場合、タイプが「NAME」で、vCardテキスト文字列をエスケープして得られた結果を値として、title要素の子孫テキストコンテンツからoutputに追加します。

  9. sexを空の文字列とします。

  10. gender-identityを空の文字列とします。

  11. nodeのアイテムのプロパティである各要素elementについて、elementのプロパティ名にある各名前nameに対して、次のサブステップを実行します：

    1. parametersを名前と値のペアの空のセットとします。

    2. 以下のリストから適切なサブステップのセットを実行します。これらのステップでvalueという変数が設定され、次のステップで使用されます。

      プロパティの値がアイテムであり、nameがnである場合

      1. valueを空の文字列とします。

      2. subitem内の最初のvCardサブプロパティを収集し、名前がfamily-nameである結果をvalueに追加します。

      3. U+003B セミコロン文字（;）をvalueに追加します。

      4. subitem内の最初のvCardサブプロパティを収集し、名前がgiven-nameである結果をvalueに追加します。

      5. U+003B セミコロン文字（;）をvalueに追加します。

      6. subitem内の最初のvCardサブプロパティを収集し、名前がadditional-nameである結果をvalueに追加します。

      7. U+003B セミコロン文字（;）をvalueに追加します。

      8. subitem内の最初のvCardサブプロパティを収集し、名前がhonorific-prefixである結果をvalueに追加します。

      9. U+003B セミコロン文字（;）をvalueに追加します。

      10. subitem内の最初のvCardサブプロパティを収集し、名前がhonorific-suffixである結果をvalueに追加します。

      プロパティの値がアイテムであり、nameがadrである場合

      1. valueを空の文字列とします。

      2. subitem内のvCardサブプロパティを収集し、名前がpost-office-boxである結果をvalueに追加します。

      3. U+003B セミコロン文字（;）をvalueに追加します。

      4. subitem内のvCardサブプロパティを収集し、名前がextended-addressである結果をvalueに追加します。

      5. U+003B セミコロン文字（;）をvalueに追加します。

      6. subitem内のvCardサブプロパティを収集し、名前がstreet-addressである結果をvalueに追加します。

      7. U+003B セミコロン文字（;）をvalueに追加します。

      8. subitem内の最初のvCardサブプロパティを収集し、名前がlocalityである結果をvalueに追加します。

      9. U+003B セミコロン文字（;）をvalueに追加します。

      10. subitem内の最初のvCardサブプロパティを収集し、名前がregionである結果をvalueに追加します。

      11. U+003B セミコロン文字（;）をvalueに追加します。

      12. subitem内の最初のvCardサブプロパティを収集し、名前がpostal-codeである結果をvalueに追加します。

      13. U+003B セミコロン文字（;）をvalueに追加します。

      14. subitem内の最初のvCardサブプロパティを収集し、名前がcountry-nameである結果をvalueに追加します。

      15. subitemに「type」という名前のプロパティが存在し、その最初のプロパティが値を持ち、かつその値がアイテムでなく、その値がASCII英数字のみで構成されている場合、そのプロパティのvalueを値として「TYPE」という名前のパラメータをparametersに追加します。

      プロパティの値がアイテムであり、nameがorgである場合

      1. valueを空の文字列とします。

      2. subitem内の最初のvCardサブプロパティを収集し、名前がorganization-nameである結果をvalueに追加します。

      3. subitemに「organization-unit」という名前のプロパティが存在する場合、以下の手順を実行します：

        1. プロパティの値がアイテムである場合、そのプロパティをスキップします。

        2. U+003B セミコロン文字（;）をvalueに追加します。

        3. プロパティの値によって与えられるvCardテキスト文字列をエスケープした結果をvalueに追加します。

      プロパティの値がアイテムであり、アイテムタイプがhttp://microformats.org/profile/hcardであり、nameがrelatedである場合

      1. valueを空の文字列とします。

      2. subitemに「url」という名前のプロパティが存在し、その要素がURLプロパティ要素である場合、最初のプロパティの値によって与えられるvCardテキスト文字列をエスケープした結果をvalueに追加し、「VALUE」という名前のパラメータを「URI」という値でparametersに追加します。

      3. subitemに「rel」という名前のプロパティが存在し、その最初のプロパティが値を持ち、かつその値がアイテムでなく、その値がASCII英数字のみで構成されている場合、そのプロパティのvalueを値として「RELATION」という名前のパラメータをparametersに追加します。

      プロパティの値がアイテムであり、nameが上記のどれでもない場合

      1. valueを、subitem内の最初のvCardサブプロパティを収集し、名前がvalueである結果とします。

      2. subitemに「type」という名前のプロパティが存在し、その最初のプロパティが値を持ち、かつその値がアイテムでなく、その値がASCII英数字のみで構成されている場合、そのプロパティのvalueを値として「TYPE」という名前のパラメータをparametersに追加します。

      プロパティの値がアイテムでなく、nameがsexである場合

      これが最初に見つかったプロパティである場合、プロパティの値をsexに設定します。

      プロパティの値がアイテムでなく、nameがgender-identityである場合

      これが最初に見つかったプロパティである場合、プロパティの値をgender-identityに設定します。

      それ以外の場合（プロパティの値がアイテムでない場合）

      1. プロパティの値をvalueとします。

      2. elementがURLプロパティ要素のいずれかである場合、「VALUE」という名前のパラメータと「URI」という値をparametersに追加します。

      3. それ以外の場合、nameがbdayまたはanniversaryであり、valueが有効な日付文字列である場合、「VALUE」という名前のパラメータと「DATE」という値をparametersに追加します。

      4. それ以外の場合、nameがrevであり、valueが有効なグローバル日付と時間文字列である場合、「VALUE」という名前のパラメータと「DATE-TIME」という値をparametersに追加します。

      5. value内のすべてのU+005C リバースソリッドス（\）文字の前に、もう一つのU+005C リバースソリッドス（\）文字を追加します。

      6. value内のすべてのU+002C コンマ（,）文字の前にU+005C リバースソリッドス（\）文字を追加します。

      7. nameがgeoでない場合、value内のすべてのU+003B セミコロン文字（;）の前にU+005C リバースソリッドス（\）文字を追加します。

      8. value内のすべてのU+000D キャリッジリターンU+000A ラインフィード文字ペア（CRLF）を、U+005C リバースソリッドス（\）文字とU+006E ラテン小文字（n）で置き換えます。

      9. value内の残りのU+000D キャリッジリターン（CR）またはU+000A ラインフィード（LF）文字を、U+005C リバースソリッドス（\）文字とU+006E ラテン小文字（n）で置き換えます。

    3. vCardラインを追加し、nameというタイプ、parametersというパラメータ、およびvalueという値をoutputに追加します。

  12. sexまたはgender-identityのいずれかに空でない値が含まれている場合、vCardラインを追加し、タイプ「GENDER」と値をsex、U+003B セミコロン文字（;）、およびgender-identityの連結で構成されたものをoutputに追加します。

  13. タイプが「END」で値が「VCARD」のvCardラインを追加して、outputに追加します。

上記のアルゴリズムで、ユーザーエージェントがtypeと、必要に応じていくつかのパラメータ、およびvalueから成るvCardラインを文字列outputに追加するよう指示された場合、次の手順を実行する必要があります：

  1. lineを空の文字列にします。

  2. typeを、ASCII大文字に変換した上でlineに追加します。

  3. パラメータが存在する場合、それらが追加された順に次のサブステップを実行します：

    1. lineにU+003B セミコロン文字（;）を追加します。

    2. パラメータの名前をlineに追加します。

    3. lineにU+003D イコール記号（=）を追加します。

    4. パラメータの値をlineに追加します。

  4. lineにU+003A コロン文字（:）を追加します。

  5. valueをlineに追加します。

  6. maximum lengthを75に設定します。

  7. lineのコードポイント長がmaximum lengthを超える場合、次の手順を実行します：

    1. lineの最初のmaximum lengthコードポイントをoutputに追加します。

    2. lineの最初のmaximum lengthコードポイントを削除します。

    3. outputにU+000D キャリッジリターン（CR）文字を追加します。

    4. outputにU+000A ラインフィード（LF）文字を追加します。

    5. outputにU+0020 スペース文字を追加します。

    6. maximum lengthを74に設定します。

  8. line（の残りの部分）をoutputに追加します。

  9. outputにU+000D キャリッジリターン（CR）文字を追加します。

  10. outputにU+000A ラインフィード（LF）文字を追加します。

上記の手順で、ユーザーエージェントがsubitem内のsubnameという名前のvCardサブプロパティを収集する結果を得るよう指示された場合、次の手順を実行する必要があります：

  1. valueを空の文字列とします。

  2. subitem内のsubnameという名前のプロパティごとに、次のサブステップを実行します：

    1. プロパティの値がアイテムである場合、そのプロパティをスキップします。

    2. このプロパティがsubitem内で最初のsubnameという名前のプロパティでない場合（前のステップでスキップされたものは無視）、valueにU+002C コンマ文字（,）を追加します。

    3. プロパティの値によって与えられるvCardテキスト文字列をエスケープした結果をvalueに追加します。

  3. valueを返します。

上記の手順で、ユーザーエージェントがsubitem内のsubnameという名前の最初のvCardサブプロパティを収集する結果を取得するよう指示された場合、次の手順を実行する必要があります：

  1. subitem内にsubnameという名前のプロパティが存在しない場合、空の文字列を返します。

  2. subitem内の最初のsubnameという名前のプロパティの値がアイテムである場合、空の文字列を返します。

  3. subitem内の最初のsubnameという名前のプロパティの値によって与えられるvCardテキスト文字列をエスケープした結果を返します。

上記のアルゴリズムで、ユーザーエージェントがvalueをvCardテキスト文字列をエスケープするよう指示された場合、ユーザーエージェントは次の手順を実行する必要があります：

  1. value内のすべてのU+005C リバースソリッドス（\）文字の前に、もう一つのU+005C リバースソリッドス（\）文字を追加します。

  2. value内のすべてのU+002C コンマ（,）文字の前にU+005C リバースソリッドス（\）文字を追加します。

  3. value内のすべてのU+003B セミコロン（;）文字の前にU+005C リバースソリッドス（\）文字を追加します。

  4. value内のすべてのU+000D キャリッジリターンとU+000A ラインフィードの文字ペア（CRLF）を、U+005C リバースソリッドス（\）文字とU+006E ラテン小文字n（n）に置き換えます。

  5. value内の残りのすべてのU+000D キャリッジリターン（CR）またはU+000A ラインフィード（LF）文字を、U+005C リバースソリッドス（\）文字とU+006E ラテン小文字n（n）に置き換えます。

  6. 変更されたvalueを返します。

このアルゴリズムは、入力がhttp://microformats.org/profile/hcardのアイテムタイプおよび定義されたプロパティ名に記載されたルールに準拠していない場合、無効なvCard出力を生成する可能性があります。

5.3.1.2 例

このセクションは規範的ではありません。

以下は、架空のキャラクター「ジャック・バウアー」の長い例のvCardです：

<section id="jack" itemscope itemtype="http://microformats.org/profile/hcard">
<h1 itemprop="fn">
 <span itemprop="n" itemscope>
  <span itemprop="given-name">Jack</span>
  <span itemprop="family-name">Bauer</span>
 </span>
</h1>
<img itemprop="photo" alt="" src="jack-bauer.jpg">
<p itemprop="org" itemscope>
 <span itemprop="organization-name">Counter-Terrorist Unit</span>
 (<span itemprop="organization-unit">Los Angeles Division</span>)
</p>
<p>
 <span itemprop="adr" itemscope>
  <span itemprop="street-address">10201 W. Pico Blvd.</span><br>
  <span itemprop="locality">Los Angeles</span>,
  <span itemprop="region">CA</span>
  <span itemprop="postal-code">90064</span><br>
  <span itemprop="country-name">United States</span><br>
 </span>
 <span itemprop="geo">34.052339;-118.410623</span>
</p>
<h2>様々な連絡方法</h2>
<ul>
 <li itemprop="tel" itemscope>
  <span itemprop="value">+1 (310) 597 3781</span> <span itemprop="type">work</span>
  <meta itemprop="type" content="voice">
 </li>
 <li><a itemprop="url" href="https://en.wikipedia.org/wiki/Jack_Bauer">私はウィキペディアにいます</a> 
 ウィキペディアのユーザー会話ページにメッセージを残せます。</li>
 <li><a itemprop="url" href="http://www.jackbauerfacts.com/">Jack Bauer Facts</a></li>
 <li itemprop="email"><a href="mailto:j.bauer@la.ctu.gov.invalid">j.bauer@la.ctu.gov.invalid</a></li>
 <li itemprop="tel" itemscope>
  <span itemprop="value">+1 (310) 555 3781</span> <span>
  <meta itemprop="type" content="cell">携帯電話</span>
 </li>
</ul>
<ins datetime="2008-07-20 21:00:00+01:00">
 <meta itemprop="rev" content="2008-07-20 21:00:00+01:00">
 <p itemprop="tel" itemscope><strong>更新！</strong>
 私の新しい<span itemprop="type">自宅</span>の電話番号は
 <span itemprop="value">01632 960 123</span>。</p>
</ins>
</section>

不思議な行の折り返しは、マイクロデータでは改行が意味を持つためです。例えば、vCard形式に変換する際には、改行が保持されます。

この例は、住所の2つの街区部分を含むサイトの連絡先詳細（address要素を使用）を示しています：

<address itemscope itemtype="http://microformats.org/profile/hcard">
<strong itemprop="fn"><span itemprop="n" itemscope><span itemprop="given-name">Alfred</span>
<span itemprop="family-name">Person</span></span></strong> <br>
<span itemprop="adr" itemscope>
 <span itemprop="street-address">1600 Amphitheatre Parkway</span> <br>
 <span itemprop="street-address">Building 43, Second Floor</span> <br>
 <span itemprop="locality">Mountain View</span>,
  <span itemprop="region">CA</span> <span itemprop="postal-code">94043</span>
</span>
</address>

vCard語彙を使用して、人々の名前のみをマークアップすることもできます：

<span itemscope itemtype="http://microformats.org/profile/hcard"
><span itemprop=fn><span itemprop="n" itemscope><span itemprop="given-name"
>George</span> <span itemprop="family-name">Washington</span></span
></span></span>

これにより、「fn」という名前と「ジョージ・ワシントン」という値を持つ1つのアイテムと、「n」という名前とその値として2番目のアイテムを持つ2つの名前-値ペアが作成されます。2番目のアイテムには、「given-name」と「family-name」という名前と「ジョージ」と「ワシントン」という値を持つ2つの名前-値ペアがあります。これは、次のvCardにマップされるように定義されています： 

BEGIN:VCARD
PROFILE:VCARD
VERSION:4.0
SOURCE:document's address
FN:George Washington
N:Washington;George;;;
END:VCARD

5.3.2 vEvent

アイテムタイプ http://microformats.org/profile/hcalendar#vevent を持つアイテムは、イベントを表します。

この語彙はアイテムに対するグローバル識別子をサポートしていません。

以下は、このタイプの定義済みのプロパティ名です。それらは、インターネットカレンダーおよびスケジューリングコアオブジェクト仕様（iCalendar）で定義された語彙に基づいており、値の解釈方法に関する詳細はそこで確認できます。[RFC5545]

ここで使用されるのは、iCalendar 語彙のうちイベントに関連する部分のみです。この語彙は完全なiCalendarインスタンスを表現することはできません。

attach

イベントに関連するドキュメントのアドレスを示します。

値は絶対URLでなければなりません。

attachという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

categories

イベントが分類されるカテゴリやタグの名前を示します。

値はテキストでなければなりません。

categoriesという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

class

イベントに関する情報のアクセス分類を示します。

値は次のいずれかのテキストでなければなりません:

これは単なる助言であり、機密保持の手段としては考慮されません。

classという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

comment

イベントに関するコメントを示します。

値はテキストでなければなりません。

commentという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

description

イベントの詳細な説明を示します。

値はテキストでなければなりません。

descriptionという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

geo

イベントの地理的位置を示します。

値はテキストでなければならず、次の構文に一致する必要があります:

  1. オプションで、U+002B PLUS SIGN 文字 (+) または U+002D HYPHEN-MINUS 文字 (-) のいずれかを指定可能。
  2. 1つ以上のASCII数字。
  3. オプションで、U+002E FULL STOP 文字 (.) の後に1つ以上のASCII数字。
  4. U+003B SEMICOLON 文字 (;)。
  5. オプションで、U+002B PLUS SIGN 文字 (+) または U+002D HYPHEN-MINUS 文字 (-) のいずれかを指定可能。
  6. 1つ以上のASCII数字。
  7. オプションで、U+002E FULL STOP 文字 (.) の後に1つ以上のASCII数字。

アスタリスク(*)で示されたオプションの要素は含めるべきであり、各要素には6桁の数字が必要です。

値は、緯度と経度（つまり「LAT LON」の順序）を10進数度で指定します。経度は、グリニッジ子午線の東と西の位置を、それぞれ正または負の実数で表します。緯度は、赤道の北と南の位置を、それぞれ正または負の実数で表します。

geoという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

location

イベントの場所を示します。

値はテキストでなければなりません。

locationという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

resources

イベントに必要なリソースを示します。

値はテキストでなければなりません。

resourcesという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

status

イベントの確認状況を示します。

値は次のいずれかのテキストでなければなりません:

statusという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

summary

イベントの簡単な要約を示します。

値はテキストでなければなりません。

ユーザーエージェントは、値内のU+000A LINE FEED (LF)文字を使用時にU+0020 SPACE文字に置き換える必要があります。

summaryという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

dtend

イベントが終了する日時を示します。

dtendという名前のプロパティが、アイテム内に存在し、dtstartという名前のプロパティの値が有効な日付文字列である場合、値は、同様に有効な日付文字列でなければなりません。それ以外の場合、プロパティの値は、有効なグローバル日付と時刻文字列でなければなりません。

いずれの場合も、値は同じアイテムのdtstartプロパティの値よりも後の時刻でなければなりません。

dtendプロパティで示される時刻は、包括的なものではありません。したがって、1日だけのイベントの場合、dtendプロパティの値はイベント終了日の翌日になります。

dtendという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。ただし、そのhttp://microformats.org/profile/hcalendar#veventには、durationという名前のプロパティが存在しない限りです。

dtstart

イベントが開始される日時を示します。

値は、有効な日付文字列または有効なグローバル日付と時刻文字列のいずれかでなければなりません。

dtstartという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在しなければなりません。

duration

イベントの期間を示します。

値は、有効なvevent期間文字列でなければなりません。

表現される期間は、値内の整数によって表される全期間の合計です。

durationという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。ただし、そのhttp://microformats.org/profile/hcalendar#veventには、dtendという名前のプロパティが存在しない限りです。

transp

フリービジータイム検索の目的で、イベントがカレンダー上で時間を消費すると見なされるかどうかを示します。

値は、次のいずれかのテキストでなければなりません:

transpという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

contact

イベントの連絡先情報を示します。

値はテキストでなければなりません。

contactという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

url

イベントのURLを示します。

値は絶対URLでなければなりません。

urlという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

uid

イベントに対応するグローバルに一意の識別子を示します。

値はテキストでなければなりません。

uidという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

exdate

繰り返しルールにもかかわらず、イベントが発生しない日時を示します。

値は、有効な日付文字列または有効なグローバル日付と時刻文字列のいずれかでなければなりません。

exdateという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

rdate

イベントが繰り返される日時を示します。

値は、次のいずれかでなければなりません:

rdateという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に、任意の数だけ存在させることができます。

rrule

イベントが発生する日時を見つけるためのルールを示します。

値は、iCalendarで定義されたRECUR値タイプに一致するテキストでなければなりません。[RFC5545]

rruleという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

created

イベント情報が最初にカレンダーシステムに作成された日時を示します。

値は有効なグローバル日付と時刻文字列でなければなりません。

createdという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

last-modified

イベント情報が最後にカレンダーシステムで修正された日時を示します。

値は有効なグローバル日付と時刻文字列でなければなりません。

last-modifiedという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

sequence

イベント情報のリビジョン番号を示します。

値は有効な非負整数でなければなりません。

sequenceという名前のプロパティは、http://microformats.org/profile/hcalendar#veventというタイプのアイテム内に1つだけ存在させることができます。

文字列が次のパターンに一致する場合、その文字列は有効なvevent期間文字列です:

  1. U+0050 LATIN CAPITAL LETTER P 文字 (P)。

  2. 次のいずれか:

5.3.2.1 iCalendarへの変換

nodes内のノードのリストがドキュメントにある場合、ユーザーエージェントは以下のアルゴリズムを実行して、これらのノードによって表されるvEventデータを抽出しなければなりません:

  1. nodes内のいずれのノードもhttp://microformats.org/profile/hcalendar#veventタイプのアイテムでない場合、vEventデータはありません。アルゴリズムを中止し、何も返さないでください。

  2. outputを空の文字列とします。

  3. outputに「BEGIN」タイプと「VCALENDAR」値を持つiCalendar行を追加します。

  4. outputにユーザーエージェントを表すユーザーエージェント固有の文字列に等しい値を持つ「PRODID」タイプのiCalendar行を追加します。

  5. outputに「VERSION」タイプと「2.0」値を持つiCalendar行を追加します。

  6. nodes内で、http://microformats.org/profile/hcalendar#veventタイプのアイテムであるノードnodeごとに、次の手順を実行します:

    1. outputに「BEGIN」タイプと「VEVENT」値を持つiCalendar行を追加します。

    2. 現在の日付と時刻を表すiCalendar DATE-TIME文字列を持つ「DTSTAMP」タイプのiCalendar行を追加し、outputに「VALUE=DATE-TIME」という注釈を付けます。[RFC5545]

    3. nodeのプロパティである要素elementごとに: elementのプロパティ名にある名前nameごとに、次のリストから適切なサブステップセットを実行します。

      プロパティの値がアイテムである場合

      プロパティをスキップします。

      プロパティがdtendである場合
      プロパティがdtstartである場合
      プロパティがexdateである場合
      プロパティがrdateである場合
      プロパティがcreatedである場合
      プロパティがlast-modifiedである場合

      プロパティの値から、すべてのU+002D HYPHEN-MINUS (-)およびU+003A COLON (:)文字を取り除いた結果をvalueとします。

      プロパティの値が有効な日付文字列である場合、nameタイプとvalue値を持ち、「VALUE=DATE」という注釈を付けたiCalendar行をoutputに追加します。

      それ以外の場合、プロパティの値が有効なグローバル日付と時刻文字列である場合、nameタイプとvalue値を持ち、「VALUE=DATE-TIME」という注釈を付けたiCalendar行をoutputに追加します。

      それ以外の場合、プロパティをスキップします。

      それ以外の場合

      nameタイプとプロパティの値を持つiCalendar行をoutputに追加します。

    4. outputに「END」タイプと「VEVENT」値を持つiCalendar行を追加します。

  7. outputに「END」タイプと「VCALENDAR」値を持つiCalendar行を追加します。

上記のアルゴリズムで、ユーザーエージェントがiCalendar行を追加し、type、value、およびオプションの注釈で構成される行を文字列outputに追加する場合、次の手順を実行しなければなりません:

  1. lineを空の文字列とします。

  2. typeをASCII大文字に変換し、lineに追加します。

  3. 注釈がある場合:

    1. lineにU+003B SEMICOLON文字 (;)を追加します。

    2. 注釈をlineに追加します。

  4. lineにU+003A COLON文字 (:)を追加します。

  5. value内のすべてのU+005C REVERSE SOLIDUS文字 (\)の前に、もう1つのU+005C REVERSE SOLIDUS文字 (\)を追加します。

  6. value内のすべてのU+002C COMMA文字 (,)の前にU+005C REVERSE SOLIDUS文字 (\)を追加します。

  7. value内のすべてのU+003B SEMICOLON文字 (;)の前にU+005C REVERSE SOLIDUS文字 (\)を追加します。

  8. value内のすべてのU+000D CARRIAGE RETURN U+000A LINE FEED文字ペア (CRLF)を、U+005C REVERSE SOLIDUS文字 (\)とその後に続くU+006E LATIN SMALL LETTER N文字 (n)に置き換えます。

  9. value内の残りのU+000D CARRIAGE RETURN (CR)またはU+000A LINE FEED (LF)文字を、U+005C REVERSE SOLIDUS文字 (\)とその後に続くU+006E LATIN SMALL LETTER N文字 (n)に置き換えます。

  10. valueをlineに追加します。

  11. maximum lengthを75とします。

  12. lineのコードポイントの長さがmaximum lengthを超える間:

    1. lineの最初のmaximum lengthコードポイントをoutputに追加します。

    2. lineの最初のmaximum lengthコードポイントを削除します。

    3. outputにU+000D CARRIAGE RETURN文字 (CR)を追加します。

    4. outputにU+000A LINE FEED文字 (LF)を追加します。

    5. outputにU+0020 SPACE文字を追加します。

    6. maximum lengthを74に設定します。

  13. (残りの)lineをoutputに追加します。

  14. outputにU+000D CARRIAGE RETURN文字 (CR)を追加します。

  15. outputにU+000A LINE FEED文字 (LF)を追加します。

このアルゴリズムは、入力がhttp://microformats.org/profile/hcalendar#veventのアイテムタイプおよび定義済みプロパティ名のルールに準拠していない場合、無効なiCalendar出力を生成することがあります。

5.3.2.2 例

このセクションは規範的ではありません。

ここに、vEvent 語彙を使用してイベントをマークアップするページの例があります:

<body itemscope itemtype="http://microformats.org/profile/hcalendar#vevent">
...
<h1 itemprop="summary">ブルーズデイ・チューズデイ: マネー・ロード</h1>
...
<time itemprop="dtstart" datetime="2009-05-05T19:00:00Z">5月5日 @ 7pm</time>
(until <time itemprop="dtend" datetime="2009-05-05T21:00:00Z">9pm</time>)
...
<a href="http://livebrum.co.uk/2009/05/05/bluesday-tuesday-money-road" rel="bookmark" itemprop="url">このページへのリンク</a>
...
<p>場所: <span itemprop="location">The RoadHouse</span></p>
...
<p><input type=button value="カレンダーに追加" onclick="location = getCalendar(this)"></p>
...
<meta itemprop="description" content="via livebrum.co.uk">
</body>

getCalendar()関数は読者への練習問題として残しておきます。

同じページは、ブログにコピー＆ペーストするために次のようなマークアップを提供することもできます:

<div itemscope itemtype="http://microformats.org/profile/hcalendar#vevent">
<p>私は
<strong itemprop="summary">ブルーズデイ・チューズデイ: マネー・ロード</strong>に行きます,
<time itemprop="dtstart" datetime="2009-05-05T19:00:00Z">5月5日 @ 7pm</time>
から <time itemprop="dtend" datetime="2009-05-05T21:00:00Z">9pm</time>まで,
<span itemprop="location">The RoadHouse</span>で！</p>
<p><a href="http://livebrum.co.uk/2009/05/05/bluesday-tuesday-money-road" itemprop="url">このイベントをlivebrum.co.ukで見る</a>.</p>
<meta itemprop="description" content="via livebrum.co.uk">
</div>

5.3.3 ライセンス付与作品

アイテムタイプ http://n.whatwg.org/workを持つアイテムは、作品（例：記事、画像、ビデオ、曲など）を表します。このタイプは主に、著者が作品のライセンス情報を含めることを可能にするために意図されています。

以下は、このタイプの定義されたプロパティ名です。

work

説明されている作品を識別します。

値は、絶対URLでなければなりません。

「work」という名前のプロパティは、http://n.whatwg.org/workというタイプのアイテム内に正確に1つ存在しなければなりません。

title

作品の名前を指定します。

「title」という名前のプロパティは、http://n.whatwg.org/workというタイプのアイテム内に1つだけ存在させることができます。

author

作品の著者または作成者の名前または連絡先情報を指定します。

値は、http://microformats.org/profile/hcardというタイプのアイテムか、テキストでなければなりません。

「author」という名前のプロパティは、http://n.whatwg.org/workというタイプのアイテム内に任意の数だけ存在させることができます。

license

作品が利用可能なライセンスの1つを識別します。

値は、絶対URLでなければなりません。

「license」という名前のプロパティは、http://n.whatwg.org/workというタイプのアイテム内に任意の数だけ存在させることができます。

5.3.3.1 例

このセクションは規範的ではありません。

この例は、クリエイティブ・コモンズ 表示 - 継承 4.0 国際ライセンスとMITライセンスの両方でライセンスされているMy Pondというタイトルの埋め込み画像を示しています。

<figure itemscope itemtype="http://n.whatwg.org/work">
  <img itemprop="work" src="mypond.jpeg">
  <figcaption>
   <p><cite itemprop="title">My Pond</cite></p>
   <p><small>以下のライセンスに基づいてライセンスされています: <a itemprop="license"
   href="https://creativecommons.org/licenses/by-sa/4.0/">クリエイティブ・コモンズ 表示 - 継承 4.0 国際ライセンス</a>
   と <a itemprop="license"
   href="http://www.opensource.org/licenses/mit-license.php">MIT
   ライセンス</a>。</small>
  </figcaption>
 </figure>

5.4 HTMLを他のフォーマットに変換

5.4.1 JSON

ドキュメント内のnodesリストを前提として、ユーザーエージェントは次のアルゴリズムを実行して、それらのノードからマイクロデータを抽出してJSON形式に変換しなければなりません。

  1. resultを空のオブジェクトとします。

  2. itemsを空の配列とします。

  3. nodes内の各nodeについて、要素がトップレベルのマイクロデータアイテムであるかを確認し、そうであれば、その要素のオブジェクトを取得し、itemsに追加します。

  4. resultにitemsという名前のエントリを追加し、その値を配列itemsにします。

  5. 最も短い方法で（トークン間の空白をなくし、数値に不要なゼロを含めず、文字列の中で専用のエスケープシーケンスを持たない文字にのみUnicodeエスケープを使用する）resultをJSONにシリアル化して返します。また、適切な場合は、小文字の「e」を数値表現に使用します。[JSON]

このアルゴリズムは、配列を返す代わりに、単一のプロパティを持つオブジェクトを返すので、必要に応じて将来的にアルゴリズムを拡張することが可能です。

ユーザーエージェントがアイテムitemのためにオブジェクトを取得する場合、オプションでmemory要素のリストと共に、次のサブステップを実行しなければなりません。

  1. resultを空のオブジェクトとします。

  2. アルゴリズムにmemoryが渡されなかった場合、memoryを空のリストとします。

  3. itemをmemoryに追加します。

  4. itemにアイテムタイプがある場合、resultにtypeという名前のエントリを追加し、その値をitemのアイテムタイプの配列にします。

  5. itemにグローバル識別子がある場合、resultにidという名前のエントリを追加し、その値をitemのグローバル識別子にします。

  6. propertiesを空のオブジェクトとします。

  7. 1つ以上のプロパティ名を持ち、itemのプロパティの1つであるelementごとに、以下のサブステップを実行します。

    1. elementのプロパティ値をvalueとします。

    2. valueがアイテムの場合、valueがmemoryに含まれている場合、valueを「ERROR」という文字列にします。それ以外の場合は、memoryのコピーを渡してvalueのためにオブジェクトを取得し、それから返されたオブジェクトにvalueを置き換えます。

    3. elementのプロパティ名の各nameについて、以下のサブステップを実行します。

      1. propertiesにnameという名前のエントリがない場合、その名前のエントリをpropertiesに追加し、その値を空の配列とします。

      2. propertiesのnameという名前のエントリにvalueを追加します。

  8. resultにpropertiesという名前のエントリを追加し、その値をオブジェクトpropertiesにします。

  9. resultを返します。

例えば、次のようなマークアップがあります。

<!DOCTYPE HTML>
 <html lang="en">
 <title>My Blog</title>
 <article itemscope itemtype="http://schema.org/BlogPosting">
  <header>
   <h1 itemprop="headline">Progress report</h1>
   <p><time itemprop="datePublished" datetime="2013-08-29">today</time></p>
   <link itemprop="url" href="?comments=0">
  </header>
  <p>All in all, he's doing well with his swim lessons. The biggest thing was he had trouble
  putting his head in, but we got it down.</p>
  <section>
   <h1>Comments</h1>
   <article itemprop="comment" itemscope itemtype="http://schema.org/UserComments" id="c1">
    <link itemprop="url" href="#c1">
    <footer>
     <p>Posted by: <span itemprop="creator" itemscope itemtype="http://schema.org/Person">
      <span itemprop="name">Greg</span>
     </span></p>
     <p><time itemprop="commentTime" datetime="2013-08-29">15 minutes ago</time></p>
    </footer>
    <p>Ha!</p>
   </article>
   <article itemprop="comment" itemscope itemtype="http://schema.org/UserComments" id="c2">
    <link itemprop="url" href="#c2">
    <footer>
     <p>Posted by: <span itemprop="creator" itemscope itemtype="http://schema.org/Person">
      <span itemprop="name">Charlotte</span>
     </span></p>
     <p><time itemprop="commentTime" datetime="2013-08-29">5 minutes ago</time></p>
    </footer>
    <p>When you say "we got it down"...</p>
   </article>
  </section>
 </article>

上記のアルゴリズムにより、次のJSON形式に変換されます（ページのURLがhttps://blog.example.com/progress-reportであると仮定します）。

{
   "items": [
     {
       "type": [ "http://schema.org/BlogPosting" ],
       "properties": {
         "headline": [ "Progress report" ],
         "datePublished": [ "2013-08-29" ],
         "url": [ "https://blog.example.com/progress-report?comments=0" ],
         "comment": [
           {
             "type": [ "http://schema.org/UserComments" ],
             "properties": {
               "url": [ "https://blog.example.com/progress-report#c1" ],
               "creator": [
                 {
                   "type": [ "http://schema.org/Person" ],
                   "properties": {
                     "name": [ "Greg" ]
                   }
                 }
               ],
               "commentTime": [ "2013-08-29" ]
             }
           },
           {
             "type": [ "http://schema.org/UserComments" ],
             "properties": {
               "url": [ "https://blog.example.com/progress-report#c2" ],
               "creator": [
                 {
                   "type": [ "http://schema.org/Person" ],
                   "properties": {
                     "name": [ "Charlotte" ]
                   }
                 }
               ],
               "commentTime": [ "2013-08-29" ]
             }
           }
         ]
       }
     }
   ]
 }

6 ユーザーインタラクション

6.1 hidden属性

Global_attributes/hidden

1つのエンジンでのみサポート。

FirefoxサポートなしSafariサポートなしChrome102以上
OperaサポートなしEdge102以上
Edge（レガシー）不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

Global_attributes/hidden

全ての現在のエンジンでサポート。

Firefox4以上Safari5.1以上Chrome10以上
Opera不明Edge79以上
Edge（レガシー）12以上Internet Explorer11
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android4以上Samsung Internet不明Opera Android不明

すべてのHTML要素には、hiddenコンテンツ属性を設定することができます。hidden属性は列挙型属性であり、次のキーワードと状態があります:

キーワード 状態 簡単な説明
hidden Hidden レンダリングされません。
(空文字列)
until-found Hidden Until Found レンダリングされませんが、ページ内検索やフラグメントナビゲーションにアクセスできます。

この属性の欠落時のデフォルト値は、Not Hidden状態であり、無効な値のデフォルトは、Hidden状態です。

要素が Hidden 状態の hidden 属性を持つ場合、それは要素がまだ、またはもはやページの現在の状態に直接関連していないこと、あるいはユーザーが直接アクセスするのではなく、ページの他の部分で再利用されるコンテンツを宣言するために使用されていることを示します。ユーザーエージェントは、Hidden 状態にある要素をレンダリングすべきではありません。

Hidden 状態にある要素をレンダリングしないというユーザーエージェントの要件は、スタイルレイヤーを介して間接的に実装できます。たとえば、Web ブラウザーは、レンダリングセクションで提案されているルールを使用してこれらの要件を実装できます。

要素が Hidden Until Found 状態の hidden 属性を持つ場合、それは要素が Hidden 状態のように非表示になっているが、要素内のコンテンツはページ内検索およびフラグメントナビゲーションにアクセス可能であることを示します。これらの機能が要素のサブツリー内にあるターゲットにスクロールしようとすると、ユーザーエージェントは、ターゲットノードで祖先の hidden-until-found 表示アルゴリズムを実行することにより、スクロールする前にコンテンツを表示するために hidden 属性を削除します。

Web ブラウザーは、レンダリングセクションで指定されているように、hidden 属性が Hidden Until Found 状態の場合、「display: none」の代わりに「content-visibility: hidden」を使用します。

この属性は通常 CSS を使用して実装されるため、CSS を使用して上書きすることも可能です。たとえば、すべての要素に 'display: block' を適用するルールは、非表示状態の効果をキャンセルします。したがって、作成者は、属性が期待どおりにスタイル設定されていることを確認するために、スタイルシートを作成する際に注意する必要があります。さらに、検出されるまで非表示状態をサポートしていないレガシーユーザーエージェントは、'content-visibility: hidden' の代わりに 'display: none' を使用するため、作成者は、スタイルシートが検出されるまで非表示要素の 'display' または 'content-visibility' プロパティを変更しないようにすることをお勧めします。

検出されるまで非表示状態の hidden 属性を持つ要素は、'display: none' の代わりに 'content-visibility: hidden' を使用するため、検出されるまで非表示状態には、非表示状態とは異なる 2 つの注意点があります。

  1. ページ内検索で表示されるためには、要素がレイアウトコンテインメントの影響を受ける必要があります。これは、検出されるまで非表示状態の要素の 'display' 値が 'none'、'contents'、または 'inline' の場合、その要素はページ内検索で表示されないことを意味します。

  2. 検出されるまで非表示状態の場合でも、要素は生成されたボックスを持ちます。これは、境界線、マージン、パディングが要素の周りに引き続きレンダリングされることを意味します。

以下の簡単な例では、ユーザーがログインするまでウェブゲームのメイン画面を隠すために、この属性が使用されています:

  <h1>The Example Game</h1>
    <section id="login">
    <h2>Login</h2>
    <form>
     ...
     <!-- ユーザーの資格情報が確認された後、login()を呼び出します -->
    </form>
    <script>
     function login() {
       // 画面を切り替えます
       document.getElementById('login').hidden = true;
       document.getElementById('game').hidden = false;
     }
    </script>
    </section>
    <section id="game" hidden>
     ...
    </section>

hidden属性を使用して、他のプレゼンテーションで正当に表示されるコンテンツを隠してはいけません。例えば、タブ付きダイアログ内のパネルを隠すためにhiddenを使用するのは間違っています。タブ付きインターフェースはオーバーフロープレゼンテーションの一種に過ぎません。すべてのフォームコントロールをスクロールバー付きの大きなページで表示することもできます。同様に、この属性を使用してコンテンツを特定のプレゼンテーションからのみ隠すのは不適切です。hiddenとマークされたものは、すべてのプレゼンテーション（例えば、スクリーンリーダーを含む）から隠されます。

自分自身がhiddenではない要素は、hiddenである要素にハイパーリンクを作成してはいけません。自分自身がhiddenではないlabel要素やoutput要素のfor属性も同様にhiddenである要素を参照してはいけません。このような参照はユーザーに混乱を引き起こします。

要素やスクリプトは、しかしながら、他のコンテキストでは hidden 属性を持つ要素を参照することがあります。

例えば、href属性を使用して、hidden属性でマークされたセクションにリンクするのは誤りです。内容が適用されないか関連性がない場合、リンクする理由はありません。

しかし、ARIAのaria-describedby属性を使用して、hiddenである説明を参照するのは問題ありません。説明を隠すことは、それ自体が役に立たないことを意味しますが、記述される要素から参照された場合には役に立つように記述される可能性があります。

同様に、canvas要素にhidden属性を使用して、スクリプト化されたグラフィックスエンジンのオフスクリーンバッファとして使用することや、フォームコントロールがform要素をそのform属性で参照することも問題ありません。

hidden属性で隠されたセクション内の要素は依然としてアクティブであり、そのようなセクション内のスクリプトやフォームコントロールはそれぞれ実行され、送信されます。ユーザーへの表示だけが変わります。

HTMLElement/hidden

全ての現在のエンジンでサポート。

Firefox4以上Safari5.1以上Chrome6以上
Opera11.6以上Edge79以上
Edge（レガシー）12以上Internet Explorer11
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android3以上Samsung Internet不明Opera Android12以上

hiddenゲッターステップは次の通りです:

  1. hidden属性がHidden Until Found状態にある場合、「until-found」を返します。

  2. hidden属性が設定されている場合、trueを返します。

  3. falseを返します。

hiddenセッターステップは次の通りです:

  1. 指定された値が"until-found"に一致するASCII大文字小文字を区別しない文字列の場合、hidden属性を"until-found"に設定します。

  2. それ以外の場合、指定された値がfalseの場合、hidden属性を削除します。

  3. それ以外の場合、指定された値が空文字列である場合、hidden属性を削除します。

  4. それ以外の場合、指定された値がnullの場合、hidden属性を削除します。

  5. それ以外の場合、指定された値が0である場合、hidden属性を削除します。

  6. それ以外の場合、指定された値がNaNである場合、hidden属性を削除します。

  7. それ以外の場合、hidden属性を空文字列に設定します。

祖先 hidden-until-found 表示アルゴリズムは、currentNodeに対して次のステップを実行します:

  1. currentNodeがフラットツリー内で親ノードを持っている間:

    1. currentNodeがHidden Until Found状態のhidden属性を持っている場合:

      1. bubbles 属性を true に初期化して、currentNode で beforematch という名前のイベントを発火させます。

      2. currentNode から hidden 属性を削除します。

    2. currentNodeをcurrentNodeの親ノードに設定します。

6.2 ページの可視性

トラバーサブルナビゲーブルのシステム可視性状態は、その作成時の初期値を含めて、ユーザーエージェントによって決定されます。これは、例えばブラウザウィンドウが最小化されているか、ブラウザタブが現在バックグラウンドにあるか、タスクスイッチャーのようなシステム要素がページを隠しているかどうかを表します。

ユーザーエージェントがシステム可視性状態がトラバーサブルナビゲーブルのtraversableに対してnewStateに変更されたと判断した場合、次のステップを実行しなければなりません。

  1. navigablesをtraversableのアクティブドキュメントの包括的子孫ナビゲーブルに設定します。

  2. 次の順序で navigablesを繰り返します どの順序で？:

    1. documentをnavigableのアクティブドキュメントに設定します。

    2. documentのグローバルタスクをキューに入れ、documentの関連グローバルオブジェクトに対してnewStateで可視性状態を更新します。

Documentには可視性状態があります。それは "hidden" または "visible" のいずれかであり、初期設定は "hidden" です。

Document/visibilityState

全ての現在のエンジンでサポート。

Firefox18以上Safari7以上Chrome33以上
Opera20以上Edge79以上
Edge（レガシー）12以上Internet Explorer10以上
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android4.4.3以上Samsung Internet不明Opera Android20以上

visibilityStateゲッターステップは、thisの可視性状態を返すことです。

Document/hidden

全ての現在のエンジンでサポート。

Firefox18以上Safari7以上Chrome33以上
Opera12.1以上Edge79以上
Edge（レガシー）12以上Internet Explorer10以上
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android4.4.3以上Samsung Internet不明Opera Android12.1以上

hiddenゲッターステップは、thisの可視性状態が"hidden"である場合はtrueを、それ以外の場合はfalseを返すことです。

Document documentのvisibilityStateを更新するには、次の手順を実行します。

  1. documentの可視性状態がvisibilityStateと等しい場合、戻ります。

  2. documentの可視性状態をvisibilityStateに設定します。

  3. 新しい VisibilityStateEntryをキューに入れ、その 可視性状態がvisibilityStateであり、 タイムスタンプが documentの現在の高解像度時間であり、 documentの関連するグローバルオブジェクトを基にしたものです。

  4. documentで画面の向き変更ステップを実行します。[SCREENORIENTATION]

  5. documentでビュー遷移ページ可視性変更ステップを実行します。

  6. 他の仕様で定義されている可能性のあるページ可視性変更ステップをvisibilityStateおよびdocumentで実行します。

    仕様の著者がここからの呼び出しをその仕様に直接追加するプルリクエストを送る方が、ページ可視性変更ステップフックを使用するよりも、仕様間の呼び出し順序を明確にするために望ましいです。この記事を書いている時点では、次の仕様がページ可視性変更ステップを持つことが知られており、これらは未指定の順序で実行されます: デバイス姿勢APIおよびWeb NFC。[DEVICEPOSTURE] [WEBNFC]

  7. bubbles 属性を true に初期化して、document で visibilitychange という名前のイベントを発火させます。

6.2.1 VisibilityStateEntry インターフェイス

VisibilityStateEntry

1つのエンジンでのみサポート。

FirefoxサポートなしSafariサポートなしChrome115以上
Opera不明Edge115以上
Edge（レガシー）不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

VisibilityStateEntryインターフェイスは、ドキュメントがアクティブになった瞬間から、ドキュメントへの可視性の変化を公開します。

例えば、これによりページ内のJavaScriptコードが可視性の変化とペイントタイミングとの相関関係を調べることができます。 
function wasHiddenBeforeFirstContentfulPaint() {
 const fcpEntry = performance.getEntriesByName("first-contentful-paint")[0];
 const visibilityStateEntries = performance.getEntriesByType("visibility-state");
 return visibilityStateEntries.some(e =>
                                         e.startTime < fcpEntry.startTime &&
                                         e.name === "hidden");
}

ページを隠すことは、レンダリングや他のユーザーエージェント操作のスロットリングを引き起こす可能性があるため、このようなスロットリングが発生したことを示すために可視性の変化を使用することが一般的です。ただし、他の要因もブラウザによってスロットリングを引き起こす可能性があり、例えば長時間の非アクティブ期間などです。 

[Exposed=(Window)]
interface VisibilityStateEntry : PerformanceEntry {
   readonly attribute DOMString name;                 // 継承されたnameをシャドウする
   readonly attribute DOMString entryType;            // 継承されたentryTypeをシャドウする
   readonly attribute DOMHighResTimeStamp startTime;  // 継承されたstartTimeをシャドウする
   readonly attribute unsigned long duration;         // 継承されたdurationをシャドウする
 };

VisibilityStateEntryには、関連付けられたDOMHighResTimeStamp タイムスタンプがあります。

VisibilityStateEntry には、関連付けられた "visible" または "hidden" の 可視性状態があります。

name ゲッターのステップは、this の 可視性状態を返すことです。

entryType ゲッターのステップは、"visibility-state" を返すことです。

startTime ゲッターのステップは、this の タイムスタンプを返すことです。

duration ゲッターのステップは、ゼロを返すことです。

6.3 非活性サブツリー

inert属性についての説明は、こちらも参照してください。

ノード（特に要素やテキストノード）は非活性にすることができます。ノードが非活性の場合:

非活性ノードは通常フォーカスできず、ユーザーエージェントは非活性ノードをアクセシビリティAPIや支援技術に対して公開しません。非活性ノードがコマンドである場合、上記のようにユーザーには操作不能になります。

ただし、ユーザーエージェントは、ページ内検索やテキスト選択に関する制限をユーザーが上書きできるようにする場合があります。

デフォルトでは、ノードは非活性ではありません。

Document documentは、subjectがdocumentのトップレイヤー内の最上位のdialog要素である場合、モーダルダイアログによってブロックされているとされます。documentがこのようにブロックされている間、subject要素とそのフラットツリーの子孫を除く、documentに接続されているすべてのノードは非活性になる必要があります。

subjectは、inert属性を使用してさらに非活性にすることもできますが、それはsubject自体に指定されている場合のみです（つまり、subjectは祖先の非活性状態を逃れます）。subjectのフラットツリーの子孫も同様の方法で非活性になることがあります。

dialog要素のshowModal()メソッドは、このメカニズムをトリガーし、dialog要素をそのノードドキュメントのトップレイヤーに追加することで、このメカニズムを引き起こします。

6.3.2 inert 属性

Global_attributes/inert

すべての現在のエンジンでサポート。

Firefox112以上Safari15.5以上Chrome102以上
Opera不明Edge102以上
Edge（レガシー）不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

inert 属性は、存在することで要素とそのフラットツリーの子孫（モーダルダイアログなど）が他の方法で非活性状態から逃れない限り、ユーザーエージェントによって非活性にされることを示すブール属性です。

非活性サブツリーには、ページの理解や使用に重要なコンテンツやコントロールを含めるべきではありません。非活性サブツリー内のコンテンツは、すべてのユーザーに認識されず、インタラクティブではありません。著者は、表示が何らかの方法で視覚的に隠されていない限り、要素を非活性として指定すべきではありません。ほとんどの場合、著者は個々のフォームコントロールにinert属性を指定すべきではありません。このような場合、disabled属性の方が適切である可能性が高いです。

次の例は、「読み込み中」メッセージによって視覚的に隠された部分的に読み込まれたコンテンツを非活性としてマークする方法を示しています。

<section aria-labelledby=s1>
   <h3 id=s1>Population by City</h3>
   <div class=container>
     <div class=loading><p>Loading...</p></div>
     <div inert>
       <form>
         <fieldset>
           <legend>Date range</legend>
           <div>
             <label for=start>Start</label>
             <input type=date id=start>
           </div>
           <div>
             <label for=end>End</label>
             <input type=date id=end>
           </div>
           <div>
             <button>Apply</button>
           </div>
         </fieldset>
       </form>
       <table>
         <caption>From 20-- to 20--</caption>
         <thead>
           <tr>
             <th>City</th>
             <th>State</th>
             <th>20-- Population</th>
             <th>20-- Population</th>
             <th>Percentage change</th>
           </tr>
         </thead>
         <tbody>
           <!-- ... -->
         </tbody>
       </table>
     </div>
   </div>
 </section>
都市別人口のコンテンツに、まだ完全にレンダリングされていないフォームコントロールやデータテーブルを視覚的に隠す読み込みメッセージが重ねられ、それらが非活性状態であるスクリーンショット。

「読み込み中」オーバーレイは非活性コンテンツを隠しており、その非活性コンテンツが現在アクセスできないことを視覚的に明らかにしています。見出しと「読み込み中」テキストがinert属性を持つ要素の子孫でないことに注意してください。これにより、このテキストはすべてのユーザーにアクセス可能になりますが、非活性コンテンツは誰も操作できなくなります。

デフォルトでは、要素やそのサブツリーが非活性であることを示す永続的な視覚的インディケーターはありません。このようなコンテンツに適した視覚的スタイルは、しばしばコンテキストに依存します。たとえば、オフスクリーンにある非活性ナビゲーションパネルには、デフォルトのスタイルは必要ありません。なぜなら、そのオフスクリーン位置がコンテンツを視覚的に隠すからです。同様に、モーダルdialog要素の背景は、非活性コンテンツを特にスタイリングするのではなく、ウェブページの非活性コンテンツを視覚的に隠す手段として機能します。

しかし、多くの他の状況において、著者はドキュメントのどの部分がアクティブで、どの部分が非活性であるかを明確に示すことを強く推奨します。これにより、ユーザーの混乱を避けることができます。特に、すべてのユーザーがページのすべての部分を同時に見ることができるわけではないことを忘れないでください。たとえば、スクリーンリーダーを使用しているユーザー、小さなデバイスや拡大鏡を使用しているユーザー、または特に小さなウィンドウを使用しているユーザーは、ページのアクティブな部分を見ることができず、非活性なセクションが明らかに非活性でない場合、フラストレーションを感じるかもしれません。

HTMLElement/inert

すべての現在のエンジンでサポート。

Firefox112以上Safari15.5以上Chrome102以上
Opera不明Edge102以上
Edge（レガシー）不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

inert IDL 属性は、同じ名前のコンテンツ属性を反映しなければなりません。

6.4 ユーザーアクティベーションの追跡

ユーザーにとって迷惑な特定のAPI（例：ポップアップの表示や電話の振動）を乱用するのを防ぐため、ユーザーエージェントは、ユーザーがウェブページと積極的にやり取りしている場合、または少なくとも一度はページとやり取りした場合にのみ、これらのAPIを許可します。この「積極的なやり取り」状態は、このセクションで定義されたメカニズムによって維持されます。

6.4.1 データモデル

ユーザーアクティベーションの追跡の目的で、各Window Wには、次の2つの関連する値があります：

ユーザーエージェントはまた、一時的なアクティベーションの期間を定義します。これは、特定のユーザーアクティベーション制御API（例：ポップアップの表示）に対してユーザーアクティベーションが有効である期間を示す定数の数値です。

一時的なアクティベーションの期間は、ユーザーがページとのやり取りとアクティベーション制御APIの呼び出しとの関連性を認識できるようにするため、数秒程度に設定されることが予想されます。

次に、Wのための以下のブール値のユーザーアクティベーション状態があります：

永続的アクティベーション

Wに与えられた現在の高解像度時間が、Wの最後のアクティベーションタイムスタンプ以上である場合、Wは永続的アクティベーションを持つとされます。

これはWの履歴的なアクティベーション状態であり、ユーザーがWで一度でもやり取りしたかどうかを示します。最初はfalseから始まり、Wが最初のアクティベーション通知を受け取ったときにtrueに変わり、再びfalseになることはありません。

一時的アクティベーション

Wに与えられた現在の高解像度時間が、Wの最後のアクティベーションタイムスタンプ以上かつWの最後のアクティベーションタイムスタンプに一時的アクティベーションの期間を加えた値未満である場合、Wは一時的アクティベーションを持つとされます。

これはWの現在のアクティベーション状態であり、ユーザーがWで最近やり取りしたかどうかを示します。最初はfalseから始まり、Wがアクティベーション通知を受け取った後、一定期間trueのままになります。

一時的アクティベーション状態は、一時的アクティベーションの期間が経過してユーザーアクティベーションが発生してからの時間が経過したためにfalseになった場合、期限切れとみなされます。また、アクティベーションの消費によって期限切れ時間の前にfalseになることもあります。

履歴アクションアクティベーション

Wの最後の履歴アクションアクティベーションタイムスタンプがWの最後のアクティベーションタイムスタンプと等しくない場合、Wは履歴アクションアクティベーションを持つとされます。

これはユーザーアクティベーションの特別なバリアントであり、頻繁に使用するとブラウザーUIを使って戻るのが難しくなるセッション履歴APIへのアクセスを許可するために使用されます。最初はfalseから始まり、ユーザーがWとやり取りするたびにtrueになりますが、履歴アクションアクティベーションの消費を通じて再びfalseにリセットされます。これにより、介在するユーザーアクティベーションなしに連続して複数回このようなAPIを使用することができなくなります。ただし、一時的アクティベーションとは異なり、このようなAPIを使用するための時間制限はありません。

最後のアクティベーションタイムスタンプと最後の履歴アクションアクティベーションタイムスタンプは、Documentが完全にアクティブな状態を変更した後（例：Documentから離れた後、またはキャッシュされたDocumentに移動した後）も保持されます。これは、同じDocumentが再利用される限り、永続的アクティベーション状態が複数のナビゲーションにまたがって維持されることを意味します。一時的なアクティベーション状態については、元の有効期限時間が変更されないままです（つまり、元のアクティベーションを引き起こす入力イベントからの一時的アクティベーションの期間制限内で状態が期限切れになります）。永続的アクティベーションまたは一時的アクティベーションに基づいて特定の判断を下す際には、これを考慮することが重要です。

6.4.2 処理モデル

ユーザーの操作がDocument document内でアクティベーションを引き起こす入力イベントの発生を引き起こした場合、ユーザーエージェントはイベントをディスパッチする前に、以下のアクティベーション通知手順を実行する必要があります：

  1. 断言する: documentが完全にアクティブであること。

  2. windowsを« documentの関連するグローバルオブジェクト »に設定します。

  3. 拡張する: windowsを、documentの祖先ナビゲーブルの各アクティブウィンドウで拡張します。

  4. 拡張する: windowsを、documentの子孫ナビゲーブルの各アクティブウィンドウで拡張し、documentのオリジンと同一オリジンであるもののみを含むようにフィルタリングします。

  5. 各 windowについて：

    1. windowの最後のアクティベーションタイムスタンプを現在の高解像度時間に設定します。

    2. ユーザーアクティベーションについてクローズウォッチャーマネージャーに通知することを、windowを使って行います。

アクティベーションを引き起こす入力イベントとは、isTrusted属性がtrueであり、typeが以下のいずれかであるイベントを指します：

アクティベーション消費APIは、この仕様および他の仕様で定義されており、Window Wを与えられた場合、以下の手順を実行してユーザーアクティベーションを消費します：

  1. もしWのナビゲーブルがnullである場合、終了します。

  2. topをWのナビゲーブルのトップレベルのトラバーサブルに設定します。

  3. navigablesをtopのアクティブドキュメントの包括的な子孫ナビゲーブルに設定します。

  4. windowsを、navigables内の各項目のアクティブウィンドウを取得することによって構築されたWindowオブジェクトのリストに設定します。

  5. 各 windowについて、もしwindowの最後のアクティベーションタイムスタンプが正の無限大でない場合、windowの最後のアクティベーションタイムスタンプを負の無限大に設定します。

履歴アクションアクティベーション消費APIは、この仕様および他の仕様で定義されており、Window Wを与えられた場合、以下の手順を実行して履歴アクションユーザーアクティベーションを消費します：

  1. もしWのナビゲーブルがnullである場合、終了します。

  2. topをWのナビゲーブルのトップレベルのトラバーサブルに設定します。

  3. navigablesをtopのアクティブドキュメントの包括的な子孫ナビゲーブルに設定します。

  4. windowsを、navigables内の各項目のアクティブウィンドウを取得することによって構築されたWindowオブジェクトのリストに設定します。

  5. 各 windowについて、windowの最後の履歴アクションアクティベーションタイムスタンプをwindowの最後のアクティベーションタイムスタンプに設定します。

アクティベーション通知とアクティベーション消費によってページ内のブラウジングコンテキストに影響を与えるセットの非対称性に注意してください。アクティベーション消費は、ページ内のすべてのブラウジングコンテキストの一時的アクティベーション状態を変更しますが（falseに）、アクティベーション通知はこれらのブラウジングコンテキストのサブセットの状態のみを変更します（trueに）。ここでの消費の包括的な性質は意図的です：これは、悪意のあるサイトが単一のユーザーアクティベーションから複数のアクティベーション消費APIを呼び出すことを防ぎます（おそらくiframeの深い階層を利用して）。

6.4.3 ユーザーアクティベーションに依存するAPI

ユーザーアクティベーションに依存するAPIは、異なるレベルに分類されます：

永続的アクティベーション制御API

これらのAPIは永続的アクティベーション状態がtrueであることを必要とするため、最初のユーザーアクティベーションまでブロックされます。

一時的アクティベーション制御API

これらのAPIは一時的アクティベーション状態がtrueであることを必要としますが、それを消費しないため、一時的状態が期限切れになるまで、1つのユーザーアクティベーションにつき複数回の呼び出しが許可されます。

一時的アクティベーション消費API

これらのAPIは一時的アクティベーション状態がtrueであることを必要とし、各呼び出しでユーザーアクティベーションを消費することで、1つのユーザーアクティベーションにつき複数回の呼び出しを防ぎます。

履歴アクションアクティベーション消費API

これらのAPIは履歴アクションアクティベーション状態がtrueであることを必要とし、各呼び出しで履歴アクションユーザーアクティベーションを消費することで、1つのユーザーアクティベーションにつき複数回の呼び出しを防ぎます。

6.4.4 UserActivation インターフェース

UserActivation

Firefox対応なしSafari16.4+Chrome72+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorer対応なし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

各Windowには、関連付けられたUserActivationがあり、これはUserActivationオブジェクトです。Windowオブジェクトが作成されると、その関連付けられたUserActivationは、そのWindowオブジェクトの関連するレルムで作成された新しいUserActivationオブジェクトに設定されます。 

[Exposed=Window]
interface UserActivation {
  readonly attribute boolean hasBeenActive;
  readonly attribute boolean isActive;
};

partial interface Navigator {
  [SameObject] readonly attribute UserActivation userActivation;
};
navigator.userActivation.hasBeenActive

ウィンドウが永続的アクティベーションを持っているかどうかを返します。

navigator.userActivation.isActive

ウィンドウが一時的アクティベーションを持っているかどうかを返します。

Navigator/userActivation

Firefox対応なしSafari16.4+Chrome72+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorer対応なし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

userActivationのgetterステップは、thisの関連するグローバルオブジェクトの関連付けられたUserActivationを返すことです。

UserActivation/hasBeenActive

Firefox対応なしSafari16.4+Chrome72+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorer対応なし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

hasBeenActiveのgetterステップは、thisの関連するグローバルオブジェクトが永続的アクティベーションを持っている場合にtrueを返し、それ以外の場合はfalseを返すことです。

UserActivation/hasBeenActive

Firefox対応なしSafari16.4+Chrome72+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorer対応なし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

isActiveのgetterステップは、thisの関連するグローバルオブジェクトが一時的アクティベーションを持っている場合にtrueを返し、それ以外の場合はfalseを返すことです。

6.4.5 ユーザーエージェントの自動化

ユーザーエージェントの自動化およびアプリケーションテストの目的で、この仕様はWebDriver仕様のために以下の拡張コマンドを定義します。以下の拡張コマンドをサポートするかどうかは、ユーザーエージェントの任意です。[WEBDRIVER]

HTTP メソッド URI テンプレート
POST /session/{session id}/window/consume-user-activation

リモートエンドステップは以下の通りです:

  1. 現在のブラウジングコンテキストのアクティブウィンドウをwindowとします。

  2. windowが一時的アクティベーションを持っている場合は、consumeをtrueとし、それ以外の場合はfalseとします。

  3. もしconsumeがtrueであれば、windowのユーザーアクティベーションを消費します。

  4. データconsumeと共に成功を返します。

6.5 要素のアクティベーション動作

HTMLの特定の要素にはアクティベーション動作があり、ユーザーがそれらをアクティベートすることができます。これは常にclickイベントによって引き起こされます。

ユーザーエージェントは、アクティベーション動作を持つ要素を、キーボードや音声入力、マウスクリックなどを使用して手動でトリガーできるようにすべきです。ユーザーがクリック以外の方法で定義されたアクティベーション動作を持つ要素をトリガーした場合、そのインタラクションイベントのデフォルトアクションは、その要素でclickイベントを発火させることになります。

element.click()

HTMLElement/click

すべての現在のエンジンでサポートされています。

Firefox3+Safari6+Chrome9+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android4+Safari iOS?Chrome Android?WebView Android4.4+Samsung Internet1.0+Opera Android11+

要素がクリックされたかのように動作します。

各要素には、進行中のクリックフラグが関連付けられており、これは最初は未設定です。

click()メソッドは、次の手順を実行しなければなりません:

  1. この要素が無効化されたフォームコントロールである場合、終了します。

  2. この要素の進行中のクリックフラグが設定されている場合、終了します。

  3. この要素の進行中のクリックフラグを設定します。

  4. 合成ポインターイベントを発火させ、clickという名前のイベントを、この要素に対してnot trusted flagを設定して発火させます。

  5. この要素の進行中のクリックフラグを解除します。

6.5.1 ToggleEvent インターフェイス

ToggleEvent/ToggleEvent

すべての現在のエンジンでサポートされています。

🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ToggleEvent

すべての現在のエンジンでサポートされています。

🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android? 
[Exposed=Window]
interface ToggleEvent : Event {
  constructor(DOMString type, optional ToggleEventInit eventInitDict = {});
  readonly attribute DOMString oldState;
  readonly attribute DOMString newState;
};

dictionary ToggleEventInit : EventInit {
  DOMString oldState = "";
  DOMString newState = "";
};
event.oldState

閉から開へ遷移する場合は "closed" に設定され、開から閉へ遷移する場合は "open" に設定されます。

event.newState

閉から開へ遷移する場合は "open" に設定され、開から閉へ遷移する場合は "closed" に設定されます。

ToggleEvent/oldState

すべての現在のエンジンでサポートされています。

🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ToggleEvent/newState

すべての現在のエンジンでサポートされています。

🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

oldStateおよびnewState属性は、初期化された値を返さなければなりません。

トグルタスクトラッカーは、構造体で、次のものを持ちます:

タスク
ToggleEvent を発行するタスク。
古い状態
タスクのイベントの oldState 属性の値を表す文字列。

6.5.2 CommandEvent インターフェース

[Exposed=Window]
interface CommandEvent : Event {
  constructor(DOMString type, optional CommandEventInit eventInitDict = {});
  readonly attribute Element? source;
  readonly attribute DOMString command;
};

dictionary CommandEventInit : EventInit {
  Element? source = null;
  DOMString command = "";
};
event.command

要素が実行できるアクションを返します。

event.source

このイベントを引き起こすために操作された Element を返します。

command 属性は、初期化された値を返さなければなりません。

source ゲッターのステップは、this の currentTarget に対して source をリターゲットした結果を返すことです。

DOM 標準の問題 #1328 は、イベントで意味をなす方法で関連するイベントデータをより適切に標準化する方法を追跡しています。 現在、値に初期化されたイベント属性はゲッターを持つこともできないため、これを適切に指定するには内部スロット（または追加フィールドのマップ）が必要です。

6.6 フォーカス

6.6.1 序論

このセクションは規範的ではありません。

HTML ユーザーインターフェースは通常、フォームコントロール、スクロール可能な領域、リンク、ダイアログボックス、ブラウザタブなどの複数のインタラクティブなウィジェットで構成されます。これらのウィジェットは階層を形成しており、（例えばブラウザタブやダイアログボックスのように）他のウィジェット（リンクやフォームコントロールなど）を含んでいるものもあります。

キーボードを使用してインターフェースと対話する場合、キー入力はシステムからインタラクティブなウィジェットの階層を通じてアクティブなウィジェットにチャネリングされ、これがフォーカスされていると言われます。

グラフィカルな環境で動作するブラウザタブ内で実行されている HTML アプリケーションを考えてみましょう。このアプリケーションが、いくつかのテキストコントロールやリンクを持ち、モーダルダイアログを表示しており、そのダイアログ内にはテキストコントロールとボタンがあるとします。

このシナリオにおけるフォーカス可能なウィジェットの階層には、ブラウザウィンドウが含まれ、その子として HTML アプリケーションを含むブラウザタブがあります。タブ自体は、さまざまなリンクやテキストコントロール、ダイアログなどの子を持ちます。ダイアログ自体は、テキストコントロールとボタンを子として持ちます。

この例でフォーカスされているウィジェットがダイアログボックス内のテキストコントロールである場合、キー入力はグラフィカルシステムから①ウェブブラウザ、次に②タブ、次に③ダイアログ、そして最後に④テキストコントロールにチャネリングされます。

キーボードイベントは常にこのフォーカスされた要素をターゲットにします。

6.6.2 データモデル

トップレベルのトラバーサブルは、オペレーティングシステムからチャネルされるキーボード入力を受け取ることができる場合、その システムフォーカス を持ちます。これは、アクティブなドキュメント の 子孫ナビゲーブル のいずれかをターゲットにしている可能性があります。

トップレベルのトラバーサブルは、ユーザーの注目を持つとき、そのシステムの可視性状態が「visible」であり、かつ システムフォーカス を持つか、それに直接関連するユーザーエージェントのウィジェットがオペレーティングシステムからチャネルされるキーボード入力を受け取ることができる場合です。

ブラウザウィンドウがフォーカスを失うとユーザーの注目も失われますが、システムフォーカスはブラウザウィンドウ内の他のシステムウィジェット（例：ロケーションバー）に移ることもあります。

Document d は、d が 完全にアクティブであり、d の ノードナビゲーブル の トップレベルのトラバーサブル がユーザーの注目を持つ場合、ユーザーの注目を持つトップレベルのトラバーサブルの完全にアクティブな子孫です。

フォーカス可能エリアという用語は、そのようなキーボード入力のターゲットになる可能性があるインターフェイスの領域を指すために使用されます。フォーカス可能エリアは、要素、要素の一部、またはユーザーエージェントによって管理される他の領域である可能性があります。

各フォーカス可能エリアにはDOMアンカーがあり、これは Node オブジェクトで、DOM内のフォーカス可能エリアの位置を表します。（フォーカス可能エリアがそれ自体がNodeである場合、それ自体がDOMアンカーです。）DOMアンカーは、フォーカス可能エリアを表す他のDOMオブジェクトがない場合に、いくつかのAPIでその代わりに使用されます。

次の表は、フォーカス可能エリアになり得るオブジェクトについて説明しています。左側の列は フォーカス可能エリア になり得るオブジェクトを説明し、右側の列はそれらの要素の DOMアンカー を説明しています。（両方の列にまたがるセルは、規範的でない例です。）

フォーカス可能エリア DOMアンカー
例
次のすべての条件を満たす要素： 要素自体。

iframe、 dialog、 <input type=text>、 場合によっては <a href=""> （プラットフォームの慣習に依存します）。

エリア 要素の形状が、イメージマップ内で関連付けられた img 要素と共に レンダリングされている かつ 無効化されていない 場合の形状。 img要素。

次の例では、エリア要素が各画像上に2つの形状を作成します。最初の形状のDOMアンカーは最初のimg要素であり、2番目の形状のDOMアンカーは2番目のimg要素です。 

<map id=wallmap><area alt="Enter Door" coords="10,10,100,200" href="door.html"></map>
...
<img src="images/innerwall.jpeg" alt="There is a white wall here, with a door." usemap="#wallmap">
...
<img src="images/outerwall.jpeg" alt="There is a red wall here, with a door." usemap="#wallmap">
レンダリングされている、かつ実際に無効化されていないまたはイナートではない要素のユーザーエージェント提供のサブウィジェット。 フォーカス可能エリアがサブウィジェットである要素。

ユーザーインターフェースのコントロールが ビデオ要素、上下ボタンの <input type=number>スピンコントロールバージョン、詳細要素のレンダリング部分であり、キーボード入力を使用して開閉を可能にします。

レンダリングされている、かつイナートではない要素のスクロール可能な領域。 スクロール可能な領域がスクロールするボックスが作成された要素。

CSS の 'overflow' プロパティの 'scroll' 値は、通常、スクロール可能な領域を作成します。
Document の ブラウジングコンテキスト が null ではなく、イナートではない場合の ビューポート。 ビューポートが作成された Document。

iframe のコンテンツ。
特にアクセシビリティの向上やプラットフォームの慣習により良く一致させるために、ユーザーエージェントがフォーカス可能エリアと判断したその他の要素または要素の一部。 要素。

ユーザーエージェントは、ユーザーがリストをより簡単にナビゲートできるように、すべてのリスト項目の箇条書きを順次フォーカス可能にすることができます。

同様に、ユーザーエージェントは、title属性を持つすべての要素を順次フォーカス可能にして、それらの助言情報にアクセスできるようにすることもできます。

ナビゲーブルコンテナ（例：iframe）はフォーカス可能エリアですが、ナビゲーブルコンテナにルーティングされるキーイベントは、直ちにそのコンテンツナビゲーブルのアクティブドキュメントにルーティングされます。同様に、順次フォーカスナビゲーションでは、ナビゲーブルコンテナは基本的にそのコンテンツナビゲーブルのアクティブドキュメントのためのプレースホルダーとして機能します。

各 フォーカス可能エリア は Document の ドキュメントのフォーカスされたエリアに指定されます。このコントロールがいつそう指定されるかは、この仕様のアルゴリズムに基づいて時間と共に変化します。

ドキュメントが 完全にアクティブ ではなく、ユーザーに表示されていない場合でも、ドキュメントのフォーカスされたエリアを持つことができます。ドキュメントの完全にアクティブな状態が変わっても、そのフォーカスされたエリアは同じままです。

現在フォーカスされているトップレベルのトラバーサブルのフォーカスエリア traversable は、次のアルゴリズムによって返される フォーカス可能エリアまたはnullです：

  1. traversable が システムフォーカス を持っていない場合、null を返します。

  2. candidate を traversable の アクティブドキュメント に設定します。

  3. candidate の フォーカスされたエリアが非nullであり、かつ ナビゲーブルコンテナ であり、コンテンツナビゲーブル が非nullである場合は、その アクティブドキュメント をcandidateに設定します。

  4. もし candidate の フォーカスされたエリア が非nullである場合、candidate をそのフォーカスされたエリアに設定します。

  5. candidate を返します。

トップレベルのトラバーサブルの現在のフォーカスチェーン traversable は、非nullの場合は 現在フォーカスされているトップレベルのトラバーサブルのフォーカスエリアのフォーカスチェーン、そうでない場合は空のリストです。

ある要素が DOM アンカー として フォーカス可能な領域 に関連付けられている場合、その フォーカス可能な領域 が トップレベルのトラバーサブルの現在フォーカスされている領域 になるときに、その要素は フォーカスを得る と言います。ある要素が DOM アンカー として フォーカス可能な領域 に関連付けられている場合、その要素が トップレベルのトラバーサブルの現在フォーカスされている領域 であるとき、その要素は フォーカスされている と言います。

フォーカスチェーンは、フォーカス可能エリア subject に対して次のように構築された順序リストです：

  1. outputを空のリストとします。

  2. currentObjectをsubjectとします。

  3. 次のループを実行します：

    1. Append currentObjectをoutputに追加します。

    2. currentObjectがarea要素の形状である場合、そのarea要素をoutputに追加します。

      それ以外の場合、currentObjectのDOMアンカーがcurrentObject自体でない要素である場合、そのcurrentObjectのDOMアンカーをoutputに追加します。

    3. currentObjectがフォーカス可能エリアである場合、currentObjectをそのDOMアンカーのノードドキュメントに設定します。

      それ以外の場合、currentObjectがDocumentであり、かつそのノードナビゲーブルの親が非nullである場合、currentObjectをそのノードナビゲーブルの親に設定します。

      それ以外の場合、breakします。

  4. outputを返します。

    このチェーンはsubjectから始まり（subjectが現在フォーカスされているトップレベルのトラバーサブルのフォーカスエリアであるか、その可能性がある場合）、フォーカス階層の最上部にあるトップレベルのトラバーサブルのDocumentまで続きます。

すべてのフォーカス可能エリアは、フォーカス可能であるとされています。

フォーカス可能エリアには、次の2つの特別なフォーカス性のタイプがあります：

フォーカス可能でない要素はフォーカス可能エリアではなく、したがって順次フォーカス可能でもクリックフォーカス可能でもありません。

フォーカス可能であることは、要素がプログラムによってフォーカスできるかどうか、例えば focus() メソッドや autofocus 属性を介してフォーカスできるかどうかについての記述です。対照的に、順次フォーカス可能およびクリックフォーカス可能は、ユーザーエージェントがユーザーインタラクションにどのように応答するかを規定します。それぞれ、順次フォーカスナビゲーションおよびアクティベーション動作として応答します。

ユーザーエージェントは、要素がフォーカス可能であり、そのDocumentの順次フォーカスナビゲーションの順序に含まれていても、ユーザーの設定に応じて、順次フォーカス可能ではないと判断する場合があります。例えば、macOSのユーザーは、ユーザーエージェントに、順次フォーカスナビゲーションで非フォームコントロール要素をスキップするように設定できます。また、Tabキーだけを使った場合（OptionキーとTabキーを同時に使わない場合）には、リンクをスキップすることもできます。

同様に、ユーザーエージェントは、要素がクリックフォーカス可能であると判断しない場合もあります。例えば、いくつかのユーザーエージェントでは、編集不可能なフォームコントロールをクリックしても、それがフォーカスされない、つまり、そのようなコントロールはクリックフォーカス可能ではないと判断されます。

したがって、要素はフォーカス可能であっても、順次フォーカス可能でもクリックフォーカス可能でもない場合があります。例えば、いくつかのユーザーエージェントでは、負の整数のtabindex 値を持つ編集不可能なフォームコントロールは、ユーザー操作ではなく、プログラム的なAPIを介してのみフォーカス可能です。

ユーザーがアクティベーションをクリックフォーカス可能なフォーカス可能エリアに対して行ったとき、ユーザーエージェントはフォーカス処理手順をフォーカス可能エリアに対して実行し、focus triggerを「click」に設定します。

フォーカスすることは、アクティベーション動作ではありません。つまり、要素に対してclick()メソッドを呼び出したり、合成clickイベントをディスパッチしたりしても、要素がフォーカスされることはありません。

ノードは、それが Document、シャドウホスト、スロット、またはポップオーバー表示状態にある要素のポップオーバーインボーカーである要素である場合、フォーカスナビゲーションスコープオーナーです。

各 フォーカスナビゲーションスコープの所有者 には フォーカスナビゲーションスコープ があり、これは要素のリストです。その内容は次のように決定されます:

すべての要素 element には 関連フォーカスナビゲーション所有者 があり、それは null または フォーカスナビゲーションスコープの所有者 です。次のアルゴリズムで決定されます:

  1. element の親が null である場合、null を返します。

  2. element の親が シャドウホスト である場合、element の 割り当てられたスロット を返します。

  3. element の親が シャドウルート である場合、親の ホスト を返します。

  4. element の親が ドキュメント要素 である場合、親の ノードドキュメント を返します。

  5. element がポップオーバー表示状態にあり、かつポップオーバーインボーカーが設定されている場合、element のポップオーバーインボーカーを返します。

  6. element の親の 関連フォーカスナビゲーション所有者 を返します。

次に、特定の フォーカスナビゲーションスコープの所有者 owner の フォーカスナビゲーションスコープ の内容は、関連フォーカスナビゲーション所有者 が owner であるすべての要素です。

フォーカスナビゲーションスコープ 内の要素の順序は、この仕様のアルゴリズムには影響しません。順序は、次に定義される tabindex-順序フォーカスナビゲーションスコープ と 平坦化された tabindex-順序フォーカスナビゲーションスコープ の概念においてのみ重要になります。

tabindex-順序フォーカスナビゲーションスコープ は、フォーカス可能エリア と フォーカスナビゲーションスコープの所有者 のリストです。すべての フォーカスナビゲーションスコープの所有者 owner は tabindex-順序フォーカスナビゲーションスコープ を持っており、その内容は次のように決定されます:

tabindex-順序フォーカスナビゲーションスコープ 内の順序は、各要素の tabindex 値 によって決定されます。以下のセクションで説明されています。

ここでのルールは厳密な順序を示しているわけではなく、「すべき」文と相対的な順序が主に構成されています。

平坦化された tabindex-順序フォーカスナビゲーションスコープ は、フォーカス可能エリア のリストです。すべての フォーカスナビゲーションスコープの所有者 owner は、独自の 平坦化された tabindex-順序フォーカスナビゲーションスコープ を所有しており、その内容は次のアルゴリズムで決定されます:

  1. owner の クローン を result とします。これは owner の tabindex-順序フォーカスナビゲーションスコープ のクローンです。

  2. result の各 item について:

    1. item が フォーカスナビゲーションスコープの所有者 でない場合、続行 します。

    2. item が フォーカス可能エリア でない場合、item を item の 平坦化された tabindex-順序フォーカスナビゲーションスコープ のすべての項目に置き換えます。

    3. それ以外の場合、item の 平坦化された tabindex-順序フォーカスナビゲーションスコープ の内容を item の後に挿入します。

6.6.3 tabindex 属性

Global_attributes/tabindex

すべての現在のエンジンでサポートされています。

Firefox1.5+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

tabindex コンテンツ属性は、要素と、その要素を DOM アンカー として持つ領域を フォーカス可能エリア にし、それらが 順次フォーカス可能 かどうかを決定し、順次フォーカスナビゲーションの相対的な順序を決定するために使用されます。

"tab index" という名前は、フォーカス可能な要素を移動するために Tab キーを使用する一般的な使用法に由来しています。"tabbing" という用語は、順次フォーカス可能 な フォーカス可能エリア を進んでいくことを指します。

指定されている場合、tabindex 属性は、有効な整数 である必要があります。正の数値は、要素の フォーカス可能エリア の 順次フォーカスナビゲーションの順序 における相対的な位置を示し、負の数値は、そのコントロールが 順次フォーカス可能 ではないことを示します。

開発者は、自分の tabindex 属性に 0 や −1 以外の値を使用する際には注意が必要です。これは正しく行うのが複雑です。

次の内容は、tabindex 属性値の可能な動作の非規範的な概要を示しています。下記の処理モデルでは、より正確なルールが示されています。

省略された場合（または非整数値）
ユーザーエージェントは、要素が フォーカス可能 であるかどうかを決定し、もしフォーカス可能であれば、それが 順次フォーカス可能 であるか、クリックフォーカス可能 であるか（またはその両方）を決定します。
−1（またはその他の負の整数値）
この値は、要素を フォーカス可能 にし、要素が クリックフォーカス可能 であるが、順次フォーカス可能 ではないことを示します。ただし、ユーザーエージェントは、このクリックおよび順次フォーカス可能性に関する好みを無視することがあります。たとえば、プラットフォームの慣習に従って特定の要素タイプに対して、またはキーボードのみを使用するユーザーに対してです。
0
この値は、要素を フォーカス可能 にし、要素が クリックフォーカス可能 であり、順次フォーカス可能 であることを示します。ユーザーエージェントは、このクリックおよび順次フォーカス可能性に関する好みを無視することがあります。
正の整数値
0 と同様に動作しますが、さらに tabindex-順序フォーカスナビゲーションスコープ 内で相対的な順序を作成し、tabindex 属性値が大きい要素が後に来るようにします。

注意：tabindex 属性を使用して要素を非フォーカス可能にすることはできません。ページの作成者がそれを行う唯一の方法は、要素を 無効 にするか、非活性 にすることです。

要素の tabindex 値 は、その tabindex 属性の値です。整数を解析するためのルール を使用して解析されます。解析に失敗するか、属性が指定されていない場合、tabindex 値 は null になります。

tabindex 値は、フォーカス可能な領域のtabindex 値であり、そのDOM アンカーの tabindex 値を示します。

要素の tabindex 値 は次のように解釈されなければなりません:

値が null の場合

ユーザーエージェントは、プラットフォームの慣習に従って、要素が フォーカス可能エリア と見なされるべきかどうかを判断し、そうであれば、その要素と、その要素を DOM アンカー として持つ フォーカス可能エリア が 順次フォーカス可能 であるかどうかを判断し、そうであれば、tabindex-順序フォーカスナビゲーションスコープ 内での相対的な位置を決定します。要素が フォーカスナビゲーションスコープの所有者 である場合、それが フォーカス可能エリア でない場合でも、tabindex-順序フォーカスナビゲーションスコープ に含めなければなりません。

プラットフォームの慣習を除き、次の要素は フォーカス可能エリア と見なされ、順次フォーカス可能 と見なされるべきであることが推奨されます:

値が負の整数である場合

ユーザーエージェントは要素を フォーカス可能エリア と見なさなければなりませんが、tabindex-順序フォーカスナビゲーションスコープ からは要素を省略するべきです。

順次フォーカスナビゲーションが著者に要素への移動を許可する必要がないという要件を無視する正当な理由の一つは、ユーザーがフォーカスを移動する唯一の手段が順次フォーカスナビゲーションである場合です。例えば、キーボードのみを使用するユーザーは、負の tabindex を持つテキストコントロールをクリックできないため、そのユーザーのユーザーエージェントは、そのコントロールに移動することを許可するのが妥当でしょう。

値が 0 の場合

ユーザーエージェントは要素を フォーカス可能エリア と見なし、その要素を DOM アンカー とする フォーカス可能エリア を 順次フォーカス可能 と見なすべきです。

同じ フォーカスナビゲーションスコープ に属し、その tabindex 値 が 0 の要素および フォーカス可能エリア の tabindex-順序フォーカスナビゲーションスコープ 内での相対的な順序は、シャドウインクルーディングツリー順序 に従うべきです。

値が 0 より大きい場合

ユーザーエージェントは要素を フォーカス可能エリア と見なし、その要素を DOM アンカー とする フォーカス可能エリア を 順次フォーカス可能 と見なし、要素を含む tabindex-順序フォーカスナビゲーションスコープ 内に配置する必要があります。同じ フォーカスナビゲーションスコープ に属する他の要素および フォーカス可能エリア に対して、それらが次のようになるように配置されます:

HTMLElement/tabIndex

すべての現在のエンジンでサポートされています。

Firefox1+Safari3.1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)18Internet Explorer🔰 5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

tabIndex IDL 属性は 反映 される必要があり、tabindex コンテンツ属性の値を反映します。デフォルト値 は、要素が a、area、button、frame、iframe、input、object、select、textarea、または SVG a 要素である場合、または その親の詳細に関する概要 である要素 summary です。デフォルト値 は、それ以外の場合は −1 です。

要素タイプに基づく異なるデフォルト値は、歴史的な遺物です。

6.6.4 処理モデル

focus targetが、フォーカス可能エリアでない要素、またはナビゲイブルである場合に、オプションの文字列focus trigger（デフォルトは「other」）が与えられたときにフォーカス可能エリアを取得するには、次のリストから最初に一致する手順を実行します。

focus targetが、1つ以上の形状を持つarea要素で、それらがフォーカス可能エリアである場合

そのimg要素に対応する最初の形状を返します。ツリー順で画像マップを使用するarea要素に属します。

focus targetが、1つ以上のフォーカス可能エリアであるスクロール可能領域を持つ要素である場合

その要素の最初のスクロール可能領域を返します。フラットツリーの先行順で、深さ優先でツリーを走査します。[CSSSCOPING]

focus targetがその文書要素である場合

文書のビューポートを返します。

focus targetがナビゲイブルである場合

ナビゲイブルのアクティブ文書を返します。

focus targetが非nullのコンテンツナビゲイブルを持つナビゲイブルコンテナである場合

ナビゲイブルコンテナのコンテンツナビゲイブルのアクティブ文書を返します。

focus targetが、シャドウホストで、そのシャドウルートのフォーカス委譲がtrueである場合

  1. focusedElementを、トップレベルのトラバーサブルのDOMアンカーの現在フォーカスされているエリアとします。

  2. focus targetがfocusedElementのシャドウ含む包括的な祖先である場合は、focusedElementを返します。

  3. focus targetのfocus triggerに対してフォーカスデリゲートを返します。

順次フォーカス可能性については、シャドウホストとフォーカス委譲の処理は、順次フォーカスナビゲーション順序の構築時に行われます。つまり、順次フォーカスナビゲーションの一部としてフォーカス手順がこのようなシャドウホストに対して呼び出されることはありません。

その他の場合

nullを返します。

focusTargetのフォーカスデリゲートは、オプションの文字列focusTrigger（デフォルトは「other」）が与えられた場合に、以下の手順によって決定されます。

  1. focusTargetがシャドウホストであり、そのシャドウルートのフォーカス委譲がfalseである場合は、nullを返します。

  2. whereToLookをfocusTargetに設定します。

  3. whereToLookがシャドウホストである場合、whereToLookをそのシャドウルートに設定します。

  4. autofocusDelegateを、whereToLookのfocusTriggerに対するオートフォーカスデリゲートとして設定します。

  5. autofocusDelegateがnullでない場合、autofocusDelegateを返します。

  6. 各descendantに対して、whereToLookの子孫のツリー順で以下の処理を行います。

    1. focusableAreaをnullに設定します。

    2. focusTargetがdialog要素であり、descendantが順次フォーカス可能である場合、focusableAreaをdescendantに設定します。

    3. それ以外の場合、focusTargetがdialogでない場合で、descendantがフォーカス可能エリアである場合、focusableAreaをdescendantに設定します。

    4. それ以外の場合、focusableAreaをdescendantのフォーカス可能エリアを取得する結果に設定し、focusTriggerを与えます。

      このステップは再帰的になる可能性があり、フォーカス可能エリアを取得する手順は、descendantのフォーカスデリゲートを返すことがあります。

    5. focusableAreaがnullでない場合、focusableAreaを返します。

    ここではシャドウ含む子孫を見ていないことが重要です。代わりに、子孫だけを見ています。シャドウホストは、上記の再帰的なケースで処理されます。

  7. nullを返します。

上記のアルゴリズムは、フォーカス可能エリアの最初の適切なものを返し、そのDOMアンカーとfocusTargetの間のパスが、シャドウツリー境界でフォーカスを委譲します。

focus targetのオートフォーカスデリゲートは、focus triggerが与えられた場合に、以下の手順によって決定されます。

  1. 各子孫に対して、focus targetのツリー順で以下の処理を行います。

    1. descendantがautofocus属性を持っていない場合、続行します。

    2. focusable areaを、descendantがフォーカス可能エリアである場合にはdescendantに、そうでない場合には、descendantのフォーカス可能エリアを取得する結果に設定し、focus triggerを与えます。

    3. focusable areaがnullの場合は、続行します。

    4. focusable areaがクリックフォーカス可能でなく、focus triggerが「click」の場合は、続行します。

    5. focusable areaを返します。

  2. nullを返します。

new focus targetがフォーカス可能エリア、フォーカス可能エリアでない要素、またはナビゲイブルのいずれかである場合、次の手順を実行します。これらはオプションでfallback targetおよび文字列focus triggerとともに実行できます。

  1. new focus targetがフォーカス可能エリアでない場合、new focus targetをfocus triggerが与えられている場合には、new focus targetのフォーカス可能エリアを取得する結果に設定します。

  2. new focus targetがnullの場合は：

    1. fallback targetが指定されていない場合は、終了します。

    2. それ以外の場合は、new focus targetをfallback targetに設定します。

  3. new focus targetが非nullのコンテンツナビゲイブルを持つナビゲイブルコンテナである場合、new focus targetをコンテンツナビゲイブルのアクティブ文書に設定します。

  4. new focus targetがフォーカス可能エリアであり、そのDOMアンカーがインアートである場合、終了します。

  5. new focus targetがトップレベルのトラバーサブルの現在のフォーカス領域である場合、終了します。

  6. old chainを、new focus targetが見つかるトップレベルのトラバーサブルの現在のフォーカスチェーンとします。

  7. new chainを、new focus targetのフォーカスチェーンとします。

  8. old chain、new chain、およびnew focus targetをそれぞれ使用してフォーカス更新手順を実行します。

ユーザーエージェントは、candidateにフォーカスを移動しようとするときに、candidateのフォーカス可能エリアまたはナビゲイブルに対してフォーカス手順を即座に実行しなければなりません。

old focus targetがフォーカス可能エリアまたはフォーカス可能エリアでない要素のいずれかである場合、次の手順を実行します。

  1. old focus target が、その シャドウホスト の シャドウルート の フォーカス委譲 が true の場合、 かつ old focus target の シャドウルート が シャドウを含む包括的な祖先 であり、トップレベルのトラバーサブルの現在フォーカスされている領域 の DOM アンカー である場合、 old focus target を トップレベルのトラバーサブルの現在フォーカスされている領域 に設定します。

  2. old focus targetがインアートである場合、終了します。

  3. old focus targetがarea要素であり、その形状の1つが現在フォーカスされているエリアである場合、または、old focus targetが1つ以上のスクロール可能領域を持つ要素であり、そのうちの1つが現在フォーカスされているエリアである場合、old focus targetをその現在フォーカスされているエリアに設定します。

  4. old chainを、old focus targetが見つかる現在のフォーカスチェーンとします。

  5. old focus targetがold chainのエントリの1つでない場合、終了します。

  6. old focus targetがフォーカス可能エリアでない場合、終了します。

  7. topDocumentをold chainの最後のエントリとします。

  8. topDocumentのノードナビゲイブルがシステムフォーカスを持っている場合、topDocumentのビューポートに対してフォーカス手順を実行します。

    それ以外の場合、topDocumentのノードナビゲイブルからシステムフォーカスを取り除くための関連するプラットフォーム固有の規約を適用し、old chain、空のリスト、およびnullを与えてフォーカス更新手順を実行します。

アンフォーカス手順は、トップレベルのトラバーサブルの現在フォーカスされているエリアに適用された場合でも、必ずしもフォーカスが変わるわけではありません。例えば、トップレベルのトラバーサブルの現在フォーカスされているエリアがビューポートである場合、通常は他のフォーカス可能エリアがフォーカス手順で明示的にフォーカスされるまで、そのままフォーカスを保持します。

フォーカス更新手順は、old chain、new chain、およびnew focus targetが与えられた場合に、次のように実行されます:

  1. old chainの最後のエントリとnew chainの最後のエントリが同じ場合は、old chainとnew chainから最後のエントリをポップして、このステップをやり直します。

  2. old chainの各エントリentryに対して、順番に次のサブステップを実行します:

    1. entryがinput要素であり、changeイベントがその要素に適用され、要素が定義されたアクティベーション動作を持たず、ユーザーがそのコントロールにフォーカスが当たっている間に要素の値または選択されたファイルのリストを変更したが、その変更をコミットせず（つまり、コントロールが最初にフォーカスされたときと異なる状態である場合）、次のようにします:

      1. entryのユーザーの妥当性をtrueに設定します。

      2. イベントをchangeとして、その要素に発生させ、バブル属性をtrueに初期化します。

    2. entryが要素である場合、blur event targetをentryとします。

      entryがDocumentオブジェクトである場合、blur event targetをそのDocumentオブジェクトの関連グローバルオブジェクトとします。

      それ以外の場合、blur event targetをnullにします。

    3. entryがold chainの最後のエントリであり、かつentryがElementであり、new chainの最後のエントリもElementである場合、related blur targetをnew chainの最後のエントリとします。それ以外の場合、related blur targetをnullにします。

    4. blur event targetがnullでない場合、related blur targetを関連ターゲットとして、blurという名前のフォーカスイベントを発生させます。

      場合によっては、entryがarea要素の形状、スクロール可能な領域、またはビューポートである場合、イベントが発生しないことがあります。

  3. new focus targetにフォーカスを合わせるために、関連するプラットフォーム固有の規約を適用します。（例えば、いくつかのプラットフォームでは、テキストコントロールにフォーカスが当たると、そのコントロールの内容が選択されます。）

  4. new chainの各エントリentryに対して、逆順で次のサブステップを実行します:

    1. entryがフォーカス可能エリアであり、文書のフォーカス領域がentryでない場合:

      1. documentの関連グローバルオブジェクトのナビゲーションAPIの進行中のナビゲーション中にフォーカスが変更されたをtrueに設定します。

      2. entryを文書のフォーカス領域として指定します。

    2. entryが要素である場合、focus event targetをentryとします。

      entryがDocumentオブジェクトである場合、focus event targetをそのDocumentオブジェクトの関連グローバルオブジェクトとします。

      それ以外の場合、focus event targetをnullにします。

    3. entryがnew chainの最後のエントリであり、かつentryがElementであり、old chainの最後のエントリもElementである場合、related focus targetをold chainの最後のエントリとします。それ以外の場合、related focus targetをnullにします。

    4. focus event targetがnullでない場合、related focus targetを関連ターゲットとして、focusという名前のフォーカスイベントを発生させます。

      場合によっては、entryがarea要素の形状、スクロール可能な領域、またはビューポートである場合、イベントが発生しないことがあります。

フォーカスイベントを発生させるには、eという名前のイベントを、関連ターゲットrを指定して、要素tに発生させます。イベントを発生させ、FocusEventを使用し、relatedTarget属性をrに初期化し、view属性をtのノード文書の関連グローバルオブジェクトに初期化し、合成フラグを設定します。

キーイベントがトップレベルのトラバーサブルでルーティングされるとき、ユーザーエージェントは次の手順を実行しなければなりません:

  1. target areaをトップレベルのトラバーサブルの現在フォーカスされているエリアとします。

  2. アサート: target areaはnullではありません。キーイベントは、システムフォーカスを持つトップレベルのトラバーサブルにのみルーティングされるため、target areaはフォーカス可能エリアです。

  3. target nodeをtarget areaのDOMアンカーとします。

  4. target nodeがDocumentであり、本文要素を持っている場合、target nodeをそのDocumentの本文要素とします。

    それ以外の場合、target nodeがDocumentオブジェクトであり、非nullの文書要素を持っている場合、target nodeをその文書要素とします。

  5. target nodeがインアートでない場合は、次のようにします:

    1. canHandleをtarget nodeでキーイベントをディスパッチした結果とします。

    2. canHandleがtrueである場合、target areaがキーイベントを処理します。これには、target nodeでクリックイベントを発生させることが含まれるかもしれません。

フォーカスがあるかどうかの手順は、targetとしてDocumentオブジェクトが与えられた場合に、次のように実行されます:

  1. targetのナビゲイブルノードのトップレベルのトラバーサブルがシステムフォーカスを持っていない場合、falseを返します。

  2. candidateをtargetのナビゲイブルノードのトップレベルのトラバーサブルのアクティブ文書とします。

  3. 次の手順を繰り返します:

    1. candidateがtargetである場合、trueを返します。

    2. candidateの文書のフォーカス領域が非nullのコンテンツナビゲイブルを持つナビゲイブルコンテナである場合、candidateをそのナビゲイブルコンテナのコンテンツナビゲイブルのアクティブ文書に設定します。

    3. それ以外の場合、falseを返します。

6.6.5 順次フォーカスナビゲーション

各 Document はシーケンシャルフォーカスナビゲーション順序を持ち、これは Document 内のフォーカス可能領域の一部またはすべてを互いに相対的に順序付けます。その内容と順序は、Document のフラット化された tabindex 順序付きフォーカスナビゲーションスコープによって与えられます。

フラットなタブインデックス順のフォーカスナビゲーションスコープを定義するルールにより、この順序はDocumentのツリー順と必ずしも関連しているわけではありません。

フォーカス可能エリアがそのDocumentの順次フォーカスナビゲーション順序から除外されている場合、そのエリアは順次フォーカスナビゲーションを使用して到達することはできません。

順次フォーカスナビゲーションの開始点が存在する場合もあります。それは初めは設定されていません。ユーザーエージェントは、ユーザーが移動を指示したときにそれを設定することがあります。

たとえば、ユーザーが文書内容をクリックした場合、ユーザーエージェントはその位置に設定することがあります。

ユーザーエージェントは、フラグメントへのナビゲーション時に順次フォーカスナビゲーションの開始点をターゲット要素に設定する必要があります。

シーケンシャルフォーカス方向は、"forward" または "backward" の2つの可能な値のいずれかです。これらは、ユーザーの要求に応じてシーケンシャルフォーカスが移動する方向を記述するために、以下のアルゴリズムで使用されます。

選択メカニズムは、"DOM" または "sequential" の2つの可能な値のいずれかです。これらは、シーケンシャルナビゲーション検索アルゴリズムが返すフォーカス可能領域をどのように見つけるかを記述するために使用されます。

ユーザーがトップレベルトラバーサブルの現在フォーカスされている領域から次または前のフォーカス可能領域にフォーカスを移動するように要求した場合（たとえば、tab キーを押すデフォルトのアクションとして）、またはユーザーが最初にトップレベルトラバーサブルにシーケンシャルにフォーカスを移動するように要求した場合（たとえば、ブラウザーのロケーションバーから）、ユーザーエージェントは次のアルゴリズムを使用する必要があります。

  1. starting point を、ユーザーがそこからシーケンシャルにフォーカスを移動するように要求した場合はトップレベルトラバーサブルの現在フォーカスされている領域とし、そうでない場合は、ユーザーが代わりにトップレベルトラバーサブルの外部からフォーカスを移動するように要求した場合はトップレベルトラバーサブル自体とします。

  2. シーケンシャルフォーカスナビゲーション開始点が定義されており、それがstarting point の内部にある場合、starting point を代わりにシーケンシャルフォーカスナビゲーション開始点とします。

  3. direction を、ユーザーが次のコントロールを要求した場合は「forward」とし、ユーザーが前のコントロールを要求した場合は「backward」とします。

    通常、tab を押すと次のコントロールが要求され、shift + tab を押すと前のコントロールが要求されます。

  4. ループ：starting point がナビゲート可能であるか、またはstarting point がそのDocument のシーケンシャルフォーカスナビゲーション順序内にある場合、selection mechanism を「sequential」とします。

    それ以外の場合、starting point はそのDocument のシーケンシャルフォーカスナビゲーション順序内にありません。selection mechanism を「DOM」とします。

  5. candidate を、starting point、direction、およびselection mechanism を用いてシーケンシャルナビゲーション検索アルゴリズムを実行した結果とします。

  6. candidate が null でない場合、candidate のフォーカスステップを実行して戻ります。

  7. それ以外の場合、シーケンシャルフォーカスナビゲーション開始点の設定を解除します。

  8. starting point がトップレベルトラバーサブルであるか、またはトップレベルトラバーサブル内のフォーカス可能領域である場合、ユーザーエージェントはdirection を尊重して、適切に（もしあれば）自身のコントロールにフォーカスを移し、その後戻るべきです。

    たとえば、direction が後方の場合、ブラウザーのレンダリング領域の前の最後のシーケンシャルにフォーカス可能なコントロールがフォーカスするコントロールになります。

    ユーザーエージェントにシーケンシャルにフォーカス可能なコントロールがない場合（たとえば、キオスクモードのブラウザー）、ユーザーエージェントは代わりに、starting point をトップレベルトラバーサブル自体としてこれらのステップを再開することがあります。

  9. それ以外の場合、starting point は子ナビゲート可能オブジェクト内のフォーカス可能領域です。starting point をその子ナビゲート可能オブジェクトの親に設定し、ループとラベル付けされたステップに戻ります。

フォーカス可能領域 starting point、シーケンシャルフォーカス方向 direction、および選択メカニズム selection mechanism を指定したシーケンシャルナビゲーション検索アルゴリズムは、次のステップで構成されます。これらはフォーカス可能領域または null を返します。

  1. 次の表から適切なセルを選択し、そのセルの指示に従います。

    適切なセルとは、ヘッダーが direction を記述する列にあり、ヘッダーが starting point と selection mechanism を記述する最初の行にあるセルです。

    direction は "forward" direction は "backward"
    starting point はナビゲート可能 candidate を、starting point の アクティブなドキュメント内の最初の適切なシーケンシャルフォーカス可能領域（もしあれば）とし、なければ null とします。 candidate を、starting point の アクティブなドキュメント内の最後の適切なシーケンシャルフォーカス可能領域（もしあれば）とし、なければ null とします。
    selection mechanism は "DOM"

    candidate を、starting point の Document 内で starting point の直後にシャドウインクルーディングツリー順で現れる適切なシーケンシャルフォーカス可能領域（もしあれば）とし、なければ null とします。

    この場合、starting point は必ずしもその Document の シーケンシャルフォーカスナビゲーション順序に属しているとは限らないため、そのリストから starting point の後にシャドウインクルーディングツリー順で現れる適切な項目を選択します。

    		candidate を、starting point の Document 内で starting point の直前にシャドウインクルーディングツリー順で現れる適切なシーケンシャルフォーカス可能領域（もしあれば）とし、なければ null とします。
    selection mechanism は "sequential" candidate を、starting point の Document の シーケンシャルフォーカスナビゲーション順序で starting point の後の最初の適切なシーケンシャルフォーカス可能領域（もしあれば）とし、なければ null とします。 candidate を、starting point の Document の シーケンシャルフォーカスナビゲーション順序で starting point の前の最後の適切なシーケンシャルフォーカス可能領域（もしあれば）とし、なければ null とします。

    適切なシーケンシャルフォーカス可能領域とは、DOM アンカーがイナーシャでなく、かつシーケンシャルにフォーカス可能であるフォーカス可能領域です。

  2. candidate が null でないコンテンツナビゲート可能オブジェクトを持つナビゲート可能コンテナである場合：

    1. recursive candidate を、candidate の コンテンツナビゲート可能オブジェクト、direction、および "sequential" を用いてシーケンシャルナビゲーション検索アルゴリズムを実行した結果とします。

    2. recursive candidate が null の場合、candidate、direction、および selection mechanism を用いてシーケンシャルナビゲーション検索アルゴリズムを実行した結果を返します。

    3. それ以外の場合、candidate を recursive candidate に設定します。

  3. candidate を返します。

6.6.6 フォーカス管理API

dictionary FocusOptions {
   boolean preventScroll = false;
   boolean focusVisible;
 };
documentOrShadowRoot.activeElement

Document/activeElement

すべての現行エンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

ShadowRoot/activeElement

すべての現行エンジンでサポートされています。

Firefox63+Safari10+Chrome53+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

documentOrShadowRoot の中で、キーイベントがルーティングされている、またはルーティングされる先の最も深い要素を返します。これは、おおよそ、ドキュメント内でフォーカスされている要素です。

このAPIの目的では、子ナビゲイブルがフォーカスされている場合、そのコンテナがその親のアクティブ文書内でフォーカスされます。たとえば、ユーザーがiframe内のテキストコントロールにフォーカスを移動した場合、iframeがそのiframeのノード文書内でactiveElementAPIによって返される要素です。

同様に、フォーカスされている要素がdocumentOrShadowRootとは異なるノードツリー内にある場合、返される要素はdocumentOrShadowRootと同じノードツリーに位置するホストであり、documentOrShadowRootがそのフォーカスされた要素のシャドウを含む包括的祖先である場合に限りそうであり、そうでない場合はnullです。

document.hasFocus()

Document/hasFocus

すべての現行エンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?

キーイベントが document を通じて、または document にルーティングされている場合は true を返します。それ以外の場合は false を返します。おおよそ、これは document、または document 内にネストされたドキュメントがフォーカスされていることに対応します。

window.focus()

Window/focus

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android18+WebView Android?Samsung Internet?Opera Android12.1+

window の ナビゲート可能オブジェクトにフォーカスを移動します（もしあれば）。

element.focus()

HTMLElement/focus

すべての現行エンジンでサポートされています。

Firefox1.5+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
element.focus({ preventScroll, focusVisible })

フォーカスを element に移動します。

element がナビゲート可能コンテナである場合、代わりにそのコンテンツナビゲート可能オブジェクトにフォーカスを移動します。

デフォルトでは、このメソッドは element をビューにスクロールもします。preventScroll オプションを指定して true に設定すると、この動作を防ぎます。

デフォルトでは、ユーザーエージェントは実装定義のヒューリスティックを使用して、フォーカスリングを介してフォーカスを示すかどうかを決定します。focusVisible オプションを指定して true に設定すると、フォーカスリングが常に表示されるようになります。

element.blur()

HTMLElement/blur

すべての現行エンジンでサポートされています。

Firefox1.5+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

フォーカスをビューポートに移動します。このメソッドの使用は推奨されません。ビューポートにフォーカスを当てたい場合は、focus()メソッドをDocumentの文書要素に対して呼び出してください。

フォーカスリングが見苦しいと感じる場合に、このメソッドを使用してフォーカスリングを隠さないでください。代わりに、:focus-visible擬似クラスを使用して'アウトライン'プロパティを上書きし、フォーカスされている要素を示す別の方法を提供してください。代替のフォーカススタイルが提供されない場合、主にキーボードを使用してページをナビゲートする人々や、フォーカスアウトラインを使用してページをナビゲートする視覚障害のある人々にとって、ページは大幅に使いにくくなることに注意してください。

たとえば、textarea要素のアウトラインを非表示にし、代わりにフォーカスを示すために黄色の背景を使用するには、次のようにします: 

textarea:focus-visible { outline: none; background: yellow; color: black; }

DocumentOrShadowRoot の activeElement ゲッターのステップは次のとおりです。

  1. candidate を this の ノードドキュメントの フォーカスされた領域の DOM アンカーとします。

  2. candidate を this に対して candidate をリターゲットした結果に設定します。

  3. candidate の ルートが this でない場合、null を返します。

  4. candidate が Document オブジェクトでない場合、candidate を返します。

  5. candidate が body 要素を持つ場合、その body 要素を返します。

  6. candidate の ドキュメント要素が null でない場合、そのドキュメント要素を返します。

  7. null を返します。

Document の hasFocus() メソッドのステップは、this を指定してフォーカスを持つステップを実行した結果を返すことです。

Window の focus() メソッドのステップは次のとおりです。

  1. current を this の ナビゲート可能オブジェクトとします。

  2. current が null の場合、戻ります。

  3. current の アクティブなドキュメントを指定したフォーカス許可ステップが false を返す場合、戻ります。

  4. current を用いてフォーカスステップを実行します。

  5. current がトップレベルトラバーサブルである場合、ユーザーエージェントは、ページがフォーカスを取得しようとしていることをユーザーに示すために、何らかの通知をトリガーすることが推奨されます。

Window/blur

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Window の blur() メソッドのステップは、何もしないことです。

歴史的に、focus() および blur() メソッドは、ナビゲート可能オブジェクトを含むシステムウィジェット（タブやウィンドウなど）のシステムレベルのフォーカスに実際に影響を与えていましたが、悪意のあるサイトがユーザーに不利益をもたらすためにこの動作を広範囲に悪用しました。

HTMLOrSVGElement の focus(options) メソッドのステップは次のとおりです。

  1. this の ノードドキュメントを指定したフォーカス許可ステップが false を返す場合、戻ります。

  2. this のフォーカスステップを実行します。

  3. options["focusVisible"] が true であるか、存在しないが実装定義の方法でユーザーエージェントがそうするのが最善であると判断した場合、フォーカスを示します。

  4. options["preventScroll"] が false の場合、this、"auto"、"center"、および "center" を指定してターゲットをビューにスクロールします。

HTMLOrSVGElement の blur() メソッドのステップは次のとおりです。

  1. ユーザーエージェントは、this を指定してフォーカス解除ステップを実行する必要があります。

    ユーザーエージェントは、ユーザビリティ上の理由から、代わりに選択的または一律に何もしない場合があります。

たとえば、blur() メソッドが美観上の理由からフォーカスリングを削除するために不用意に使用されている場合、ページはキーボードユーザーにとって使用できなくなります。したがって、このメソッドへの呼び出しを無視すると、キーボードユーザーがページを操作できるようになります。

Document オブジェクト target を指定したフォーカス許可ステップは次のとおりです。

  1. target が "focus-without-user-activation" 機能を使用することを許可されている場合、true を返します。

  2. target の 関連するグローバルオブジェクトが一時的なアクティベーションを持つ場合、true を返します。

  3. false を返します。

6.6.7 autofocus属性

autofocusコンテンツ属性は、ページが読み込まれるとすぐに要素にフォーカスを当て、ユーザーが手動で主要な要素にフォーカスを当てなくても、すぐに入力を開始できるようにすることを著者に許可します。

autofocus属性がdialog要素やpopover属性が設定されたHTML要素内の要素に指定されている場合、そのダイアログやポップオーバーが表示されたときにフォーカスが当てられます。

autofocus属性はブール属性です。

Elementelementが与えられた場合の最も近い祖先のautofocusスコープのルート要素を見つけるには:

  1. elementがdialog要素である場合、elementを返します。

  2. elementのpopover属性がNo Popover Stateでない場合、elementを返します。

  3. ancestorをelementに設定します。

  4. ancestorに親要素がある間:

    1. ancestorをancestorの親要素に設定します。

    2. ancestorがdialog要素である場合、ancestorを返します。

    3. ancestorのpopover属性がNo Popover Stateでない場合、ancestorを返します。

  5. ancestorを返します。

最も近い祖先のautofocusスコープのルート要素を持つ2つの要素が両方ともautofocus属性を指定していてはなりません。

各Documentには、最初は空のautofocus候補リストがあります。

各Documentには、最初はfalseのautofocus処理済みフラグブール値があります。

autofocus属性が指定された要素が文書に挿入されるとき、次の手順を実行します:

  1. ユーザーが（例えばフォームコントロールに入力を開始することで）フォーカスが変更されないことを望んでいることを示している場合は、任意で終了します。

  2. targetを要素のノード文書に設定します。

  3. targetが完全にアクティブでない場合、終了します。

  4. targetのアクティブサンドボックスフラグセットがサンドボックス化された自動機能のブラウジングコンテキストフラグを持つ場合、終了します。

  5. target を指定したフォーカス許可ステップが false を返す場合、戻ります。

  6. topDocumentをtargetのノードナビゲイブルのトップレベルトラバース可能のアクティブ文書に設定します。

  7. もしtopDocumentのautofocus処理済みフラグがfalseの場合、要素をtopDocumentのautofocus候補から削除し、要素をtopDocumentのautofocus候補に追加します。

要素がフォーカス可能領域であるかどうかは確認していません。これは、挿入時にはフォーカス可能領域でない場合でも、autofocus候補をフラッシュする際にフォーカス可能領域になる可能性があるためです。

文書topDocumentのautofocus候補をフラッシュするには、次の手順を実行します:

  1. topDocumentのautofocus処理済みフラグがtrueの場合、終了します。

  2. candidatesをtopDocumentのautofocus候補に設定します。

  3. もしcandidatesが空の場合、終了します。

  4. もしtopDocumentのフォーカスされた領域がtopDocument自体でないか、topDocumentが非nullのターゲット要素を持っている場合:

    1. candidatesを空にします。

    2. topDocumentのautofocus処理済みフラグをtrueに設定します。

    3. 終了します。

  5. candidatesが空でない間:

    1. elementをcandidates[0]に設定します。

    2. docをelementのノード文書に設定します。

    3. docが完全にアクティブでない場合、elementをcandidatesから削除し、続行します。

    4. docのノードナビゲイブルのトップレベルトラバース可能がtopDocumentのノードナビゲイブルと同じでない場合、elementをcandidatesから削除し、続行します。

    5. もしdocのスクリプトブロッキングスタイルシートセットが空でない場合、戻る。

      この場合、elementは現在の最良候補ですが、docは自動フォーカスの準備ができていません。autofocus候補をフラッシュが次に呼び出されたときに再試行します。

    6. elementをcandidatesから削除します。

    7. inclusiveAncestorDocumentsをdocの包括的祖先ナビゲイブルのアクティブ文書から成るリストに設定します。

    8. もしinclusiveAncestorDocumentsのいずれかのDocumentに非nullのターゲット要素がある場合、続行します。

    9. targetをelementに設定します。

    10. もしtargetがフォーカス可能領域でない場合、targetをフォーカス可能領域を取得する結果に設定します。

      autofocus候補には、フォーカス可能領域でない要素が含まれている場合があります。このような場合は、フォーカス可能領域を取得アルゴリズムで処理される特別なケースに加え、非フォーカス可能領域の要素が文書に挿入されたときに発生する可能性があり、それがフォーカス可能にならなかった場合、または要素がフォーカス可能であったがautofocus候補に保存されている間にステータスが変更されたためです。

    11. もしtargetがnullでない場合、次を実行します:

      1. candidatesを空にします。

      2. topDocumentのautofocus処理済みフラグをtrueに設定します。

      3. targetのフォーカスステップを実行します。

これは、文書の読み込み時に自動フォーカスを処理します。show()およびshowModal()のdialog要素も、autofocus属性を処理します。

要素にフォーカスを当てることは、ユーザーエージェントがブラウザウィンドウのフォーカスが失われた場合にフォーカスを当てる必要があることを意味しません。

Global_attributes/autofocus

一つのエンジンのみでサポートされています。

Firefox🔰 1+Safari🔰 4+Chrome79+
Opera66+Edge79+
Edge (Legacy)No🔰 10+
Firefox Android?Safari iOS?Chrome Android?WebView Android79+Samsung Internet?Opera Android57+

autofocusIDL属性は、同名のコンテンツ属性を反映しなければなりません。

次のスニペットでは、文書が読み込まれたときにテキストコントロールにフォーカスが当たります。

<input maxlength="256" name="q" value="" autofocus>
<input type="submit" value="Search">

autofocus属性は、フォームコントロールに限らず、すべての要素に適用されます。これにより、次のような例が可能になります: 

<div contenteditable autofocus>Edit <strong>me!</strong><div>

6.7 キーボードショートカットの割り当て

6.7.1 はじめに

このセクションは規範的ではありません。

アクティブ化またはフォーカスできる各要素には、accesskey 属性を使用して、それをアクティブ化するための単一のキーコンビネーションを割り当てることができます。

正確なショートカットは、ユーザーのキーボードに関する情報、プラットフォーム上で既に存在するキーボードショートカット、およびページ上で指定された他のショートカットに基づいて、ユーザーエージェントによって決定され、accesskey 属性で提供された情報をガイドとして使用します。

さまざまな入力デバイスで関連するキーボードショートカットが利用できるようにするために、著者はaccesskey 属性にいくつかの代替案を提供することができます。

各代替案は、文字や数字などの単一の文字で構成されます。

ユーザーエージェントはユーザーにキーボードショートカットのリストを提供することができますが、著者もそれを行うことが推奨されます。accessKeyLabel IDL 属性は、 ユーザーエージェントによって割り当てられた実際のキーコンビネーションを表す文字列を返します。

この例では、著者はショートカットキーを使用して呼び出すことができるボタンを提供しています。フルキーボードをサポートするために、著者は「C」を可能なキーとして提供しています。数字キーパッドのみを装備したデバイスをサポートするために、著者は「1」を別の可能なキーとして提供しています。 

<input type=button value=Collect onclick="collect()"
        accesskey="C 1" id=c>

ショートカットキーが何であるかをユーザーに知らせるために、著者はこのスクリプトでキーコンビネーションをボタンのラベルに明示的に追加することを選択しています：

function addShortcutKeyLabel(button) {
   if (button.accessKeyLabel != '')
     button.value += ' (' + button.accessKeyLabel + ')';
 }
 addShortcutKeyLabel(document.getElementById('c'));

異なるプラットフォームのブラウザでは、同じキーコンビネーションでも異なるラベルが表示されます。例えば、キーコンビネーションがControlキー、Shiftキー、Cキーの場合、Windowsブラウザでは"Ctrl+Shift+C"、Macブラウザでは"^⇧C"、Emacsブラウザでは"C-C"と表示されるかもしれません。同様に、キーコンビネーションがAltキーとEscapeキーの場合、Windowsでは"Alt+Esc"、Macでは"⌥⎋"、Emacsブラウザでは"M-ESC"または"ESC ESC"が表示されるかもしれません。

したがって、一般的には、accessKeyLabel IDL 属性から返される値を解析しようとすることは賢明ではありません。

6.7.2 accesskey 属性

Global_attributes/accesskey

現在のすべてのエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

すべての HTML 要素 は、accesskey コンテンツ属性を設定できます。この accesskey 属性の値は、ユーザーエージェントが要素をアクティブ化またはフォーカスするためのキーボードショートカットを作成するためのガイドとして使用されます。

指定されている場合、その値は一意のスペースで区切られたトークンの順序セットでなければならず、 いずれも別のトークンと同一であってはならず、それぞれが正確に1つの コードポイントの長さでなければなりません。

次の例では、サイトに精通しているキーボードユーザーが関連するページにより迅速に移動できるように、さまざまなリンクにアクセスキーが割り当てられています：

<nav>
  <p>
   <a title="Consortium Activities" accesskey="A" href="/Consortium/activities">Activities</a> |
   <a title="Technical Reports and Recommendations" accesskey="T" href="/TR/">Technical Reports</a> |
   <a title="Alphabetical Site Index" accesskey="S" href="/Consortium/siteindex">Site Index</a> |
   <a title="About This Site" accesskey="B" href="/Consortium/">About Consortium</a> |
   <a title="Contact Consortium" accesskey="C" href="/Consortium/contact">Contact</a>
  </p>
 </nav>

次の例では、検索フィールドに2つの可能なアクセスキー「s」と「0」が（この順序で）与えられています。フルキーボードを備えたデバイス上のユーザーエージェントは、ショートカットキーとしてCtrl + Alt + Sを選択するかもしれませんが、テンキーのみを備えた小型デバイス上のユーザーエージェントは、装飾のないプレーンなキー0を選択するかもしれません。 

<form action="/search">
  <label>Search: <input type="search" name="q" accesskey="s 0"></label>
  <input type="submit">
 </form>

次の例では、ボタンにアクセスキーが設定されています。次に、スクリプトがボタンのラベルを更新し、ユーザーエージェントが選択したキーコンビネーションを表示しようとします。

<input type=submit accesskey="N @ 1" value="Compose">
 ...
 <script>
  function labelButton(button) {
    if (button.accessKeyLabel)
      button.value += ' (' + button.accessKeyLabel + ')';
  }
  var inputs = document.getElementsByTagName('input');
  for (var i = 0; i < inputs.length; i += 1) {
    if (inputs[i].type == "submit")
      labelButton(inputs[i]);
  }
 </script>

あるユーザーエージェントでは、ボタンのラベルが「Compose (⌘N)」になるかもしれません。別のユーザーエージェントでは、「Compose (Alt+⇧+1)」になるかもしれません。ユーザーエージェントがキーを割り当てない場合は、単に「Compose」のままになります。正確な文字列は、割り当てられたアクセスキーと、ユーザーエージェントがそのキーコンビネーションをどのように表現するかに依存します。

6.7.3 処理モデル

要素の割り当てられたアクセスキーは、その要素のaccesskey コンテンツ属性から派生したキーコンビネーションです。初期状態では、要素には割り当てられたアクセスキーが存在してはなりません。

要素のaccesskey 属性が設定、変更、または削除されるたびに、ユーザーエージェントは以下の手順を実行して要素の割り当てられたアクセスキーを更新しなければなりません：

  1. 要素にaccesskey 属性がない場合は、以下のフォールバックステップに進みます。

  2. それ以外の場合は、属性の値をASCIIホワイトスペースで分割し、keysを得たトークンとします。

  3. keysの各値について、属性の値に表示された順序で次のサブステップを順に実行します：

    1. その値が正確に1コードポイントの長さでない場合、この値についての残りの手順をスキップします。

    2. その値がシステムのキーボード上のキーに対応しない場合、この値についての残りの手順をスキップします。

    3. (これはトラッキングベクターです。) ユーザーエージェントが、属性で指定された値に対応するキーと組み合わせて使用できる0個以上の修飾キーを見つけることができる場合、ユーザーエージェントはそのキーの組み合わせを要素の割り当てられたアクセスキーとして割り当てることができ、その時点で終了します。

  4. フォールバック: 任意で、ユーザーエージェントは自分で選択したキーコンビネーションを要素の割り当てられたアクセスキーとして割り当てることができ、その後終了します。

  5. このステップに到達した場合、要素には割り当てられたアクセスキーが存在しません。

ユーザーエージェントが要素にアクセスキーを選択して割り当てた後は、accesskey コンテンツ属性が変更されるか、要素が別のドキュメントに移動されない限り、ユーザーエージェントはその要素の割り当てられたアクセスキーを変更すべきではありません。

ユーザーが要素に対する割り当てられたアクセスキーに対応するキーコンビネーションを押すと、要素がコマンドを定義し、コマンドの非表示状態のファセットが偽（表示）であり、コマンドの無効状態のファセットも偽（有効）であり、要素がドキュメント内にあり、非nullのブラウジングコンテキストを持ち、要素自身およびその祖先のいずれにもhidden属性が指定されていない場合、ユーザーエージェントはコマンドのアクションをトリガーしなければなりません。

ユーザーエージェントは、accesskey属性を持つ要素を、特定のキーコンビネーションに応じて表示されるメニューなど、他の方法でも公開することがあります。

HTMLElement/accessKey

現在のすべてのエンジンでサポートされています。

Firefox5+Safari6+Chrome17+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

The accessKey IDL属性は、accesskey コンテンツ属性を反映しなければなりません。

HTMLElement/accessKeyLabel

Firefox8+Safari14+Chrome対応していません
Opera?Edge対応していません
Edge (Legacy)?Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

accessKeyLabel IDL属性は、要素に割り当てられたアクセスキーを表す文字列を返さなければなりません。要素にアクセスキーがない場合、このIDL属性は空の文字列を返さなければなりません。

6.8 編集

6.8.1 ドキュメント領域の編集可能化: contenteditable コンテンツ属性

HTMLElement/contentEditable

すべての現在のエンジンでサポートされています。

Firefox3+Safari3+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+ 
interface mixin ElementContentEditable {
   [CEReactions] attribute DOMString contentEditable;
   [CEReactions] attribute DOMString enterKeyHint;
   readonly attribute boolean isContentEditable;
   [CEReactions] attribute DOMString inputMode;
 };

Global_attributes/contenteditable

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

この contenteditable コンテンツ属性は、列挙属性であり、次のキーワードと状態を持ちます:

キーワード 状態 簡潔な説明
true True この要素は編集可能です。
(空の文字列)
false False この要素は編集不可です。
plaintext-only Plaintext-Only 要素の生テキストコンテンツのみが編集可能であり、リッチなフォーマットは無効です。

属性の 欠損値デフォルト と 無効値デフォルト はどちらも Inherit 状態です。
この inherit 状態は、親要素の状態に基づいて要素が編集可能かどうかを示します。

例えば、HTML を使用して記事を書いて新しい記事を公開することを想定して、フォーム と テキストエリア を含むページを考えてみます: 

<form method=POST>
  <fieldset>
   <legend>新しい記事</legend>
   <textarea name=article>&lt;p>こんにちは、世界。&lt;/p></textarea>
  </fieldset>
  <p><button>公開</button></p>
 </form>

スクリプトが有効になっている場合、テキストエリア 要素 は、contenteditable 属性を使用して、リッチテキストコントロールに置き換えることができます:

<form method=POST>
  <fieldset>
   <legend>新しい記事</legend>
   <textarea id=textarea name=article>&lt;p>こんにちは、世界。&lt;/p></textarea>
   <div id=div style="white-space: pre-wrap" hidden><p>こんにちは、世界。</p></div>
   <script>
    let textarea = document.getElementById("textarea");
    let div = document.getElementById("div");
    textarea.hidden = true;
    div.hidden = false;
    div.contentEditable = "true";
    div.oninput = (e) => {
      textarea.value = div.innerHTML;
    };
   </script>
  </fieldset>
  <p><button>公開</button></p>
 </form>

リンク挿入などの機能を有効にすることは、document.execCommand() API、または Selection API とその他の DOM API を使用して実装できます。[EXECCOMMAND] [SELECTION] [DOM]

この contenteditable 属性も効果的に使用できます:

<!doctype html>
 <html lang=en>
 <title>ライブCSS編集!</title>
 <style style=white-space:pre contenteditable>
 html { margin:.2em; font-size:2em; color:ライム; background:紫 }
 head, title, style { display:ブロック }
 body { display:なし }
 </style>
element.contentEditable [ = value ]

contenteditable 属性の状態に基づいて、"true"、"plaintext-only"、"false"、または "inherit" を返します。

この状態を変更するために設定できます。

新しい値がこれらの文字列のいずれかでない場合、"SyntaxError" DOMException をスローします。

element.isContentEditable

HTMLElement/isContentEditable

すべての現在のエンジンでサポートされています。

Firefox4+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

要素が編集可能である場合に true を返し、それ以外の場合は false を返します。

contentEditable IDL 属性は、取得時に、コンテンツ属性がTrue 状態に設定されている場合は文字列 "true" を、コンテンツ属性がPlaintext-Only 状態に設定されている場合は "plaintext-only" を、コンテンツ属性がFalse 状態に設定されている場合は "false" を、それ以外の場合は "inherit" を返さなければなりません。設定時に、新しい値が文字列 "inherit" とASCII 大文字小文字を区別しない一致である場合、コンテンツ属性は削除されなければなりません。新しい値が文字列 "true" とASCII 大文字小文字を区別しない一致である場合、コンテンツ属性は文字列 "true" に設定されなければなりません。新しい値が文字列 "plaintext-only" とASCII 大文字小文字を区別しない一致である場合、コンテンツ属性は文字列 "plaintext-only" に設定されなければなりません。新しい値が文字列 "false" とASCII 大文字小文字を区別しない一致である場合、コンテンツ属性は文字列 "false" に設定されなければなりません。それ以外の場合、属性セッターは"SyntaxError" DOMException をスローしなければなりません。

この isContentEditable IDL 属性は、取得時に、要素が 編集ホスト または 編集可能 である場合に true を返し、 それ以外の場合は false を返さなければなりません。

6.8.2 ドキュメント全体を編集可能にする: designMode getterおよびsetter

document.designMode [ = value ]

Document/designMode

すべての現在のエンジンでサポートされています。

Firefox1+Safari1.2+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

ドキュメントが編集可能な場合は "on" を返し、そうでない場合は "off" を返します。

設定することで、ドキュメントの現在の状態を変更できます。これにより、ドキュメントがフォーカスされ、そのドキュメント内の選択がリセットされます。

Document オブジェクトには、デザインモードが有効 という関連付けられたブール値があります。初期状態は false です。

designMode getter ステップは、this の デザインモードが有効 である場合は "on" を返し、そうでない場合は "off" を返します。

designMode setter ステップは次のとおりです:

  1. 与えられた値を ASCII 小文字に変換し、その値を value とします。

  2. もし value が "on" であり、this の デザインモードが有効 が false である場合は:

    1. this の デザインモードが有効 を true に設定します。

    2. this の アクティブ範囲 の開始および終了境界点を this の開始位置にリセットします。

    3. フォーカスステップ を、非nullの場合、this の ドキュメント要素 に対して実行します。

  3. もし value が "off" である場合は、this の デザインモードが有効 を false に設定します。

6.8.3 インページエディタのベストプラクティス

著者は、'white-space' プロパティを編集ホストおよびこれらの編集メカニズムを通じて作成されたマークアップに 'pre-wrap' の値を設定することが推奨されます。デフォルトのHTML空白処理はWYSIWYG編集に適しておらず、'white-space' をデフォルト値のままにしておくと、いくつかのコーナーケースでは行の折り返しが正しく機能しない場合があります。

デフォルトの 'normal' 値が使用された場合に発生する問題の例として、ユーザーが「yellow␣␣ball」と入力したケースを考えてみます。ここでは、単語間に2つのスペース（"␣" で表現）があるとします。'white-space' ('normal') のデフォルト値に基づく編集ルールでは、生成されるマークアップは "yellow&nbsp; ball" または "yellow &nbsp;ball" のいずれかになります。つまり、通常のスペースに加えて、2つの単語の間にノンブレーキングスペースが追加されます。これは、'white-space' の 'normal' 値が、隣接する通常のスペースを一緒に折り畳むことを要求するためです。

前者の場合、"yellow⍽" は次の行に折り返される可能性があります（ここでは "⍽" がノンブレーキングスペースを表しています）が、"yellow" だけであれば行末に収まる可能性があります。後者の場合、"⍽ball" が行の先頭に折り返された場合、ノンブレーキングスペースによる目に見えるインデントが残ります。

しかし、'white-space' が 'pre-wrap' に設定されている場合、編集ルールは代わりに単語間に2つの通常のスペースを配置し、もし2つの単語が行末で分割された場合、そのスペースはレンダリングからきれいに除去されます。

6.8.4 編集API

編集ホストとは、contenteditable属性がtrueまたはplaintext-onlyの状態にあるHTML要素、または子のHTML要素で、そのデザインモードが有効なDocumentを指します。

用語の定義については、アクティブ範囲、編集ホストの、および編集可能、編集ホストまたは編集可能な要素のユーザーインターフェース要件、execCommand()、queryCommandEnabled()、queryCommandIndeterm()、queryCommandState()、queryCommandSupported()、およびqueryCommandValue()のメソッド、テキスト選択、および選択を削除するアルゴリズムについてはexecCommandに定義されています。[EXECCOMMAND]

6.8.5 スペルと文法のチェック

ユーザーエージェントは、フォームコントロール内のテキスト（例えば、textarea要素の値）や、編集ホスト内の要素におけるテキストのスペルおよび文法のチェックをサポートすることができます（例：contenteditableを使用）。

各要素に対して、ユーザーエージェントはデフォルトの動作を確立しなければなりません。これはデフォルト値またはユーザーによって設定された好みを通じて表現されます。各要素には次の3つのデフォルトの動作が考えられます。

デフォルトでtrue
要素の内容が編集可能であり、spellcheck属性によってスペルチェックが明示的に無効化されていない場合、その要素のスペルと文法はチェックされます。
デフォルトでfalse
要素のスペルおよび文法は、spellcheck属性を通じて明示的に有効化されない限り、チェックされません。
デフォルトで継承
要素のデフォルト動作は親要素の動作と同じになります。親要素がない要素には、この動作がデフォルトとして設定されることはありません。

Global_attributes/spellcheck

すべての現在のエンジンでサポートされています。

FirefoxYesSafariYesChrome9+
OperaYesEdge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android57+Safari iOS9.3+Chrome Android47+WebView Android?Samsung Internet?Opera Android37+

spellcheck属性は、次のキーワードと状態を持つ列挙型属性です。

キーワード 状態 簡潔な説明
true True スペルおよび文法がチェックされます。
(空の文字列)
false False スペルおよび文法はチェックされません。

この属性の欠落値のデフォルトおよび無効値のデフォルトはどちらもDefault状態です。デフォルト状態は、要素が親要素のspellcheck状態に基づいて動作することを示します。

element.spellcheck [ = value ]

要素のスペルおよび文法がチェックされる場合はtrueを返し、それ以外の場合はfalseを返します。

設定すると、デフォルトを無効にし、spellcheckコンテンツ属性を設定します。

spellcheckIDL属性は、取得時に、要素のspellcheckコンテンツ属性がTrue状態にある場合、または要素のspellcheckコンテンツ属性がDefault状態にあり、要素のデフォルト動作がtrue-by-defaultである場合、または要素のspellcheckコンテンツ属性がDefault状態にあり、要素のデフォルト動作がinherit-by-defaultであり、親要素のspellcheckIDL属性がtrueを返す場合にtrueを返さなければなりません。それ以外の場合、この属性はfalseを返す必要があります。

spellcheckIDL属性は、ユーザーの設定によってspellcheckコンテンツ属性を上書きした場合には影響を受けないため、実際のスペルチェック状態を反映していない場合があります。

設定する場合、新しい値がtrueであれば、要素のspellcheckコンテンツ属性は「true」に設定され、そうでない場合は「false」に設定されなければなりません。

ユーザーエージェントは、この機能の目的で次のテキストのみをチェック可能とみなすべきです。

Textノードに含まれるテキストの場合、そのテキストが関連付けられている要素は、単語、文、またはその他のテキストの最初の文字の直近の親要素です。属性内のテキストの場合、それは属性の要素です。inputおよびtextarea要素の値については、それは要素自体です。

適用可能な要素内（上記で定義）の単語、文、またはその他のテキストのスペルおよび文法のチェックを有効にするかどうかを判断するには、UAは次のアルゴリズムを使用しなければなりません。

  1. ユーザーがこのテキストに対するチェックを無効にしている場合、チェックは無効になります。
  2. それ以外の場合、ユーザーがこのテキストに対するチェックを常に有効にするよう強制している場合、チェックは有効になります。
  3. それ以外の場合、そのテキストが関連付けられている要素にspellcheckコンテンツ属性がある場合、その属性がTrue状態であればチェックは有効になり、それ以外の場合、その属性がFalse状態であればチェックは無効になります。
  4. それ以外の場合、Default状態ではないspellcheckコンテンツ属性を持つ祖先要素がある場合、最も近いそのような祖先のspellcheckコンテンツ属性がTrue状態であればチェックは有効になり、それ以外の場合、チェックは無効になります。
  5. それ以外の場合、要素のデフォルト動作がtrue-by-defaultである場合、チェックは有効になります。
  6. それ以外の場合、要素のデフォルト動作がfalse-by-defaultである場合、チェックは無効になります。
  7. それ以外の場合、要素の親要素のチェックが有効になっている場合、チェックは有効になります。
  8. それ以外の場合、チェックは無効になります。

チェックが単語/文/テキストに対して有効である場合、ユーザーエージェントはそのテキストにスペルおよび文法エラーを示すべきです。ユーザーエージェントは、スペルおよび文法修正を提案する際に、文書に指定された他のセマンティクスを考慮に入れるべきです。ユーザーエージェントは、要素の言語を使用して適用すべきスペルおよび文法ルールを決定するか、ユーザーの好みの言語設定を使用するかもしれません。UAは、input要素のpatternなどの属性を使用して、可能な限り結果として得られる値が有効であることを確認すべきです。

チェックが無効になっている場合、ユーザーエージェントはそのテキストに対してスペルまたは文法エラーを示すべきではありません。

次の例で「a」のIDを持つ要素は、「Hello」という単語のスペルエラーをチェックするかどうかを決定するために使用されます。この例では、チェックはされません。

<div contenteditable="true">
  <span spellcheck="false" id="a">Hell</span><em>o!</em>
 </div>

次の例で「b」のIDを持つ要素にはチェックが有効になります（input要素の属性値の先頭にある空白文字が属性を無効にするため、デフォルトに関係なく祖先の値が代わりに使用されます）。 

<p spellcheck="true">
  <label>Name: <input spellcheck=" false" id="b"></label>
 </p>

この仕様は、スペルおよび文法チェックのためのユーザーインターフェイスを定義していません。ユーザーエージェントは、必要に応じてチェックを提供するか、チェックが有効になっている場合には継続的にチェックを実行するか、または他のインターフェイスを使用することができます。

6.8.6 書き込み提案

ユーザーエージェントは、フォームコントロール（例：textarea要素）や編集ホスト内の要素に対して、ユーザーが編集可能な領域に入力する際に書き込み提案を提供します。

writingsuggestionsコンテンツ属性は、以下のキーワードと状態を持つ列挙属性です。

キーワード 状態 簡潔な説明
true True この要素に書き込み提案を提供するべきです。
(空文字列)
false False この要素に書き込み提案を提供しないべきです。

属性の欠落値のデフォルトはDefault状態です。このデフォルト状態は、要素が、以下に定義されるように、親要素のwritingsuggestions状態に基づいてデフォルトの動作に従うことを示します。

属性の無効な値のデフォルトは、True状態です。

element.writingSuggestions [ = value ]

ユーザーエージェントが要素の範囲内で書き込み提案を提供する場合、"true"を返し、それ以外の場合、"false"を返します。

デフォルトを上書きしてwritingsuggestionsコンテンツ属性を設定することができます。

指定されたelementの計算された書き込み提案値は、次の手順を実行することで決定されます。

  1. もしelementのwritingsuggestionsコンテンツ属性がFalse状態にある場合、"false"を返します。

  2. もしelementのwritingsuggestionsコンテンツ属性がDefault状態にあり、elementに親要素があり、親要素の計算された書き込み提案値が"false"である場合、"false"を返します。

  3. "true"を返します。

writingSuggestionsのgetterの手順は次のとおりです。

  1. この要素の計算された書き込み提案値を返します。

writingSuggestionsIDL属性は、writingsuggestionsコンテンツ属性を上書きするユーザーの設定によって影響を受けず、実際の書き込み提案状態を反映していない場合があります。

writingSuggestionsのsetterの手順は次のとおりです。

  1. この要素のwritingsuggestionsコンテンツ属性に指定された値を設定します。

ユーザーエージェントは、次のアルゴリズムを実行した結果がtrueを返す場合にのみ、要素の範囲内で提案を提供すべきです。

  1. ユーザーが書き込み提案を無効にしている場合、falseを返します。

  2. 次の条件がいずれもtrueでない場合:

    falseを返します。

  3. もしelementに包括祖先があり、そのwritingsuggestionsコンテンツ属性がDefaultではなく、最も近いその祖先のwritingsuggestionsコンテンツ属性がFalse状態である場合、falseを返します。

  4. それ以外の場合、trueを返します。

この仕様は、書き込み提案のためのユーザーインターフェイスを定義していません。ユーザーエージェントは、必要に応じて提案を提供するか、ユーザーが入力するたびに継続的に提案を行うか、インライン提案やポップアップでの自動入力のような提案を行うか、または他のインターフェイスを使用することができます。

6.8.7 自動大文字化

一部のテキスト入力方法、例えばモバイルデバイスの仮想キーボードや音声入力は、しばしばユーザーを支援するために、文の最初の文字を自動的に大文字にします（この習慣のある言語でテキストを作成する場合）。自動大文字化を実装した仮想キーボードは、大文字にすべき文字が入力される直前に、自動的に大文字を表示するように切り替えるかもしれません（ただし、ユーザーはこれを小文字に戻すこともできます）。他のタイプの入力、例えば音声入力では、ユーザーが介入するオプションを提供せずに自動大文字化を実行することがあります。autocapitalize属性は、著者がそのような動作を制御するために使用できます。

autocapitalize属性は、通常、物理キーボードでの入力時には動作に影響を与えません。（このため、およびユーザーが一部のケースで自動大文字化の動作を上書きしたり、初期入力後にテキストを編集する可能性があるため、この属性に基づいて入力の検証を行うべきではありません。）

autocapitalize 属性は、編集ホスト上でホストされている編集可能な領域の自動大文字化の挙動を制御するために使用できます。また、input や textarea 要素に対しては、その要素にテキストを入力する際の挙動を制御します。さらに、form 要素に対しては、自動大文字化および自動修正を継承する要素に関連する全てのデフォルトの挙動を制御します。

autocapitalize属性は、input要素のtype属性がURL、Email、またはPasswordのいずれかの状態にある場合、決して自動大文字化を有効にしません。（この動作は、以下の使用される自動大文字化ヒントアルゴリズムに含まれています。）

自動大文字化処理モデルは、以下の5つの自動大文字化ヒントの中から選択することに基づいています:

デフォルト

ユーザーエージェントおよび入力方法は、自動大文字化を有効にするかどうかを独自に判断すべきです。

なし

自動大文字化は適用されないべきです（すべての文字は小文字をデフォルトにすべきです）。

文

各文の最初の文字は大文字をデフォルトにし、その他の文字は小文字をデフォルトにすべきです。

単語

各単語の最初の文字は大文字をデフォルトにし、その他の文字は小文字をデフォルトにすべきです。

文字

すべての文字は大文字をデフォルトにすべきです。

Global_attributes/autocapitalize

すべての現行エンジンでサポートされています。

Firefox111+SafariいいえChrome43+
Opera？Edge79+
Edge (Legacy)？Internet Explorer？
Firefox Android？Safari iOS5+Chrome Android？WebView Android？Samsung Internet？Opera Android？

autocapitalize属性は、次の自動大文字化ヒントの状態を持つ列挙属性です。属性の状態によって指定された自動大文字化ヒントは、その他の考慮事項と組み合わさって使用される自動大文字化ヒントを形成し、ユーザーエージェントの動作に影響を与えます。以下に、この属性のキーワードとその状態のマッピングを示します:

キーワード 状態
off なし
none
on 文
sentences
words 単語
characters 文字

この属性の欠損値デフォルトはデフォルト状態であり、無効値デフォルトは文状態です。

element.autocapitalize [ = value ]

要素の現在の自動大文字化状態を返します。設定されていない場合は空の文字列を返します。input要素およびtextarea要素がその状態をフォーム要素から継承する場合、これはフォーム要素の自動大文字化状態を返しますが、編集可能な領域の要素の場合、これは編集ホストの自動大文字化状態を返しません（この要素が実際には編集ホストでない限り）。

設定すると、autocapitalizeコンテンツ属性を設定し（その結果、要素の自動大文字化動作が変更されます）。

要素elementの独自の自動大文字化ヒントを計算するには、次のステップを実行します:

  1. もしautocapitalizeコンテンツ属性がelementに存在し、その値が空文字列でない場合、その属性の状態を返します。

  2. もし element が 自動大文字化および自動修正を継承する要素 であり、かつ フォーム所有者 が null でない場合、element の フォーム所有者 の 独自の自動大文字化ヒント を返します。

  3. デフォルトを返します。

autocapitalizeゲッターステップは次の通りです:

  1. stateを独自の自動大文字化ヒントとし、thisの値とします。

  2. stateがデフォルトである場合、空の文字列を返します。

  3. stateがなしである場合、"none"を返します。

  4. stateが文である場合、"sentences"を返します。

  5. stateに対応するキーワード値を返します。

autocapitalizeセッターステップは、autocapitalizeコンテンツ属性に指定された値を設定します。

テキスト入力方法に対してカスタマイズ可能な自動大文字化動作をサポートし、Web開発者がこの機能を制御できるようにしたいユーザーエージェントは、要素へのテキスト入力中にその要素の使用される自動大文字化ヒントを計算する必要があります。これは、要素にテキストを入力する際の推奨される自動大文字化動作を説明する自動大文字化ヒントです。

ユーザーエージェントや入力方法は、特定の状況で使用される自動大文字化ヒントを無視または上書きすることを選択できます。

要素elementの使用される自動大文字化ヒントは、次のアルゴリズムを使用して計算されます:

  1. もしelementがinput要素であり、そのtype属性がURL、Email、またはPasswordのいずれかの状態にある場合、デフォルトを返します。

  2. もしelementがinput要素またはtextarea要素である場合、elementの独自の自動大文字化ヒントを返します。

  3. もしelementが編集ホストまたは編集可能要素である場合、その要素の独自の自動大文字化ヒントを返します。

  4. アサート:このステップには決して到達しません。なぜなら、テキスト入力は上記の基準のいずれかを満たす要素にのみ発生するからです。

6.8.8 自動修正

一部のテキスト入力方法では、入力中に誤字を自動的に修正することでユーザーを支援します。このプロセスは、自動修正とも呼ばれます。ユーザーエージェントは、フォームコントロール（例: textarea 要素の値）や、編集ホスト内の要素（例: contenteditable を使用する場合）で、編集可能なテキストの自動修正をサポートできます。自動修正は、誤字の後に句読点、スペース、または新しい段落を挿入するときに一般的に行われます。autocorrect 属性を使用して、このような挙動を制御できます。

autocorrect 属性は、編集ホストでホストされている編集可能な領域の自動修正挙動を制御するために使用でき、input または textarea 要素に対しては、その要素にテキストを入力する際の挙動を制御します。また、form 要素に対しては、自動大文字化および自動修正を継承する要素 に関連するデフォルトの挙動を制御します。

autocorrect 属性は、input 要素で type 属性が URL、Email、または Password 状態にある場合、自動修正を有効にすることはありません。この挙動は、以下の 使用される自動修正状態 アルゴリズムに含まれています。

autocorrect 属性は、次のキーワードと状態を持つ列挙型属性です:

キーワード 状態 簡単な説明
on on ユーザーエージェントは、ユーザーが入力中に自動的にスペルミスを修正することが許可されます。スペルが自動的に修正されるかどうかは、ユーザーエージェントが決定し、要素やユーザーの設定に依存する場合があります。
（空文字列）
off off ユーザーエージェントは、ユーザーが入力中に自動的にスペルを修正することが許可されていません。

属性の無効な値のデフォルトと欠損値のデフォルトは、どちらもオン状態です。

autocorrect ゲッターのステップは次のとおりです。要素の使用される自動修正状態がオンの場合は true を返し、要素の使用される自動修正状態がオフの場合は false を返します。セッターのステップは次のとおりです。指定された値が true の場合、要素の autocorrect 属性を "on" に設定する必要があります。それ以外の場合は "off" に設定する必要があります。

要素 element の使用される自動修正状態を計算するには、次のステップを実行します。

  1. element が type 属性がURL、Email、またはPassword状態のいずれかである input 要素である場合、オフを返します。

  2. autocorrect コンテンツ属性が element に存在する場合、属性の状態を返します。

  3. element が自動大文字化および自動修正を継承する要素であり、null でないフォームオーナーを持つ場合、element のフォームオーナーの autocorrect 属性の状態を返します。

  4. オンを返します。

element . autocorrect

要素の自動修正動作を返します。自動大文字化および自動修正を継承する要素で、form 要素から状態を継承する場合、これは form 要素の自動修正動作を返しますが、編集可能な領域内の要素の場合、これは編集ホストの自動修正動作を返しません（この要素が実際には編集ホストである場合を除く）。

element . autocorrect = value

autocorrect コンテンツ属性を更新します（これにより、要素の自動修正動作が変更されます）。

次の例の input 要素は、autocorrect コンテンツ属性を持たず、したがって "off" の属性を持つ form 要素から継承するため、自動修正を許可しません。ただし、textarea 要素は、"on" の値を持つ autocorrect コンテンツ属性を持つため、自動修正を許可します。

<form autocorrect="off">
    <input type="search">
    <textarea autocorrect="on"></textarea>
</form>

6.8.9 入力モダリティ: inputmode 属性

ユーザーエージェントは、フォームコントロール（例えば、textarea 要素の値）や、編集ホスト内の要素（例: contenteditable を使用する場合）で inputmode 属性をサポートできます。

inputmode コンテンツ属性は、ユーザーがコンテンツを入力する際に最も役立つ入力メカニズムを指定する 列挙型属性 です。

キーワード 説明
none ユーザーエージェントは仮想キーボードを表示すべきではありません。このキーワードは、独自のキーボードコントロールをレンダリングするコンテンツに役立ちます。
text ユーザーエージェントは、ユーザーのロケールでのテキスト入力に対応する仮想キーボードを表示するべきです。
tel ユーザーエージェントは電話番号の入力に対応する仮想キーボードを表示するべきです。これには、0から9の数字キー、"#"および"*"キーが含まれます。いくつかのロケールでは、アルファベットのニモニックラベル（例: 米国では「2」キーが A、B、C と一緒にラベルされていることがあります）が含まれる場合もあります。
url ユーザーエージェントは、URLの入力を支援する仮想キーボード（"/"や"."などの文字や、"www."や".com"などの文字列のクイック入力用キーを含む）を表示するべきです。
email ユーザーエージェントは、メールアドレスの入力を支援する仮想キーボード（"@"や"."などの文字を含む）を表示するべきです。
numeric ユーザーエージェントは、数値入力に対応する仮想キーボードを表示するべきです。このキーワードは PIN エントリに役立ちます。
decimal ユーザーエージェントは、小数を含む数値入力に対応する仮想キーボードを表示するべきです。数値キーと、そのロケールのフォーマット区切り記号を表示します。
search ユーザーエージェントは、検索に最適化された仮想キーボードを表示するべきです。

inputMode IDL 属性は、反映する必要があります。inputmode コンテンツ属性は、既知の値に限定されています。

inputmode が指定されていない場合（またはユーザーエージェントがサポートしていない状態にある場合）、ユーザーエージェントは表示するデフォルトの仮想キーボードを決定する必要があります。入力 type や pattern 属性などのコンテキスト情報を使用して、どのタイプの仮想キーボードを提示するかを決定するべきです。

6.8.10 入力モダリティ: enterkeyhint 属性

ユーザーエージェントは、フォームコントロール（textarea 要素など）のenterkeyhint 属性、または編集ホスト内の要素（例: contenteditableを使用して）をサポートできます。

Global_attributes/enterkeyhint

すべての現在のエンジンでサポートされています。

Firefox94+Safari13.1+Chrome77+
Opera66+Edge79+
Edge (レガシー)？Internet Explorerいいえ
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android57+

enterkeyhintコンテンツ属性は、仮想キーボードのエンターキーに提示するアクションラベル（またはアイコン）を指定する列挙型属性です。これにより、エンターキーの表示をカスタマイズし、ユーザーにとってより役立つものにすることができます。

キーワード 説明
enter ユーザーエージェントは、「enter」の操作のためのキューを提示する必要があります。通常、新しい行を挿入します。
done ユーザーエージェントは、「done」の操作のためのキューを提示する必要があります。通常、入力するものがなく、入力方法エディタ（IME）が閉じられることを意味します。
go ユーザーエージェントは、「go」の操作のためのキューを提示する必要があります。通常、ユーザーを入力したテキストのターゲットに連れて行くことを意味します。
next ユーザーエージェントは、「next」の操作のためのキューを提示する必要があります。通常、ユーザーを次のテキストを受け入れるフィールドに移動させます。
previous ユーザーエージェントは、「previous」の操作のためのキューを提示する必要があります。通常、ユーザーを前のテキストを受け入れるフィールドに移動させます。
search ユーザーエージェントは、「search」の操作のためのキューを提示する必要があります。通常、ユーザーを入力したテキストの検索結果に連れて行きます。
send ユーザーエージェントは、「send」の操作のためのキューを提示する必要があります。通常、テキストをそのターゲットに送信します。

HTMLElement/enterKeyHint

すべての現在のエンジンでサポートされています。

Firefox94+Safari13.1+Chrome77+
Opera？Edge79+
Edge (レガシー)？Internet Explorerいいえ
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

enterKeyHint IDL属性は、enterkeyhint コンテンツ属性を反映し、既知の値のみに制限されます。

enterkeyhint が指定されていない場合（またはユーザーエージェントでサポートされていない状態の場合）、ユーザーエージェントは提示するデフォルトのアクションラベル（またはアイコン）を決定する必要があります。inputmode、 type、 またはpattern 属性などのコンテキスト情報を使用して、仮想キーボードに提示するアクションラベル（またはアイコン）を決定する必要があります。

6.9 ページ内検索

6.9.1 はじめに

このセクションでは、ページ内検索について定義します。これは、ユーザーが特定の情報を探すために、ページの内容を検索できる一般的なユーザーエージェントのメカニズムです。

ページ内検索機能へのアクセスは、ページ内検索インターフェースを介して提供されます。これは、ユーザーが入力と検索のパラメータを指定できるユーザーエージェントが提供するユーザーインターフェースです。このインターフェースは、ショートカットやメニュー選択の結果として表示されることがあります。

ページ内検索インターフェースでのテキスト入力と設定の組み合わせが、ユーザーのクエリを表します。これには通常、ユーザーが検索したいテキストと、検索を単語全体のみに制限するオプション設定などが含まれます。

ユーザーエージェントは、与えられたクエリに対してページ内容を処理し、ユーザーのクエリを満たす0個以上の一致を特定します。

これらの一致のうちの1つが、ユーザーにアクティブ一致として識別されます。これは強調表示され、表示領域にスクロールされます。ユーザーはページ内検索インターフェースを使用して、アクティブ一致を進めることで、一致をナビゲートできます。

Issue #3539は、現在未定義のwindow.find() APIの基盤としてページ内検索が標準化されるかどうかを追跡しています。

6.9.2 details と hidden=until-found との相互作用

ページ内検索が一致する項目を検索し始めるとき、ページ内のすべてのdetails要素で、 open属性が設定されていないものは、 スキップされた内容の第2スロットがアクセス可能になるべきです。ただし、open属性は変更されず、 これによりページ内検索がその内容を検索できるようにします。同様に、Hidden Until Found状態の hidden属性を持つすべてのHTML要素も、 スキップされた内容がアクセス可能になり、ページ内検索がそれらを検索できるようになります。ページ内検索が一致する項目の検索を終了すると、 details 要素と、Hidden Until Found 状態のhidden属性を持つ要素の内容は再びスキップされるべきです。このプロセス全体は同期的に行われる必要があり（したがって、ユーザーや著者コードには観察されません）。[CSSCONTAIN]

ページ内検索が新しいアクティブ一致を選択すると、次の手順を実行します。

  1. nodeをアクティブ一致の最初のノードに設定します。

  2. グローバルタスクをキューに追加し、 ユーザーインタラクションタスクソース に基づいて、nodeの関連するグローバルオブジェクトに次の手順を実行するようにします。

    1. nodeに対して祖先の詳細を明らかにするアルゴリズムを実行します。

    2. nodeに対して祖先が見つかるまで隠された状態を明らかにするアルゴリズムを実行します。

(これは追跡ベクターです。)ページ内検索がこのようにdetails要素を自動的に展開すると、 toggleイベントが発生します。 ページ内検索が発生する別のscrollイベントと同様に、このイベントは ページがユーザーがページ内検索ダイアログに入力している内容を検出するために使用される可能性があります。ページが現在の検索語とユーザーが入力する可能性のあるすべての次の文字を小さなスクロール可能領域に表示し、どれがブラウザによってスクロールされたかを観察することで、その文字を検索語に追加し、検索語を段階的に構築するためにスクロール可能な領域を更新できます。次の一致をそれぞれ閉じたdetails要素でラップすることで、ページはtoggleイベントを使用してscrollイベントの代わりにイベントをリッスンできます。この攻撃は、ユーザーがページ内検索ダイアログに入力するすべての文字に対して動作しないようにすることで、両方のイベントに対処できる可能性があります。

6.9.3 選択との相互作用

ページ内検索プロセスはドキュメントのコンテキストで呼び出され、そのドキュメントの選択に影響を与える可能性があります。具体的には、アクティブ一致を定義する範囲が現在の選択を決定する場合があります。ただし、これらの選択更新はページ内検索プロセスの異なるタイミング（例：ページ内検索インターフェースの解除時や、アクティブ一致範囲の変更時）に発生することがあります。

6.10 閉じるリクエストと閉じるウォッチャー

6.10.1 閉じるリクエスト

実装依存（おそらくデバイス固有の方法）で、 ユーザーは 閉じるリクエストをユーザーエージェントに送信できます。これは、 ユーザーが現在画面に表示されているもの（ポップオーバー、メニュー、ダイアログ、ピッカー、または表示モードなど）を閉じたいことを示します。

いくつかの例としては、以下のような閉じるリクエストがあります：

ユーザーエージェントが Document document に対する潜在的な閉じるリクエストを受信した場合、グローバルタスクをキューイングする必要があります。 ユーザーインタラクションタスクソースの document の 関連グローバルオブジェクトで、以下の 閉じるリクエスト手順 を実行します：

  1. document の 全画面要素 が null でない場合、次のようにします：

    1. 全画面を完全に終了します document の ノードナビゲーブル の 最上位 トラバース可能 の アクティブな ドキュメント に対して。

    2. 戻ります。

    この操作は、keydown などの関連イベントを発火させることはありません。 ただし、fullscreenchange イベントが最終的に発火することがあります。

  2. オプションとして、代替処理 のステップにスキップします。

    例えば、ユーザーエージェントが現在のウェブページによる繰り返しの閉じるリクエストの干渉に対するユーザーのフラストレーションを検出した場合、こちらの処理に進むかもしれません。

  3. UI Events またはその他の関連仕様に従って、関連するイベントを発火させます。 [UIEVENTS]

    例えば、UI Events モデルでは、ユーザーがキーボードの Esc キーを押したときに発火するイベントとして keydown が考えられます。ほとんどのキーボードプラットフォームでは、これは 閉じるリクエスト として扱われ、これらの 閉じるリクエスト手順 をトリガーします。

    UI Events モデル外の関連イベントの例としては、支援技術がユーザーが閉じるジェスチャーを使用して 閉じるリクエスト を送信した際に、Esc keydown イベントを合成することが含まれます。

  4. event が発火したイベントのうち、もし発火したイベントが複数あれば、どれが選ばれるかは 実装依存です。

  5. event が null でない場合、その キャンセルフラグ が 設定されている場合は、 戻ります。

  6. document が 完全にアクティブ でない場合は 戻ります。

    このステップは、もし event が null でない場合、イベントリスナーが document をもはや 完全にアクティブ ではない状態にさせる可能性があるため、必要です。

  7. closedSomething を 閉じるウォッチャーの処理 の結果として設定します document の 関連グローバルオブジェクト で。

  8. closedSomething が true の場合は、戻ります。

  9. 代替処理: それ以外の場合は、閉じるリクエスト を監視しているものはありませんでした。ユーザーエージェントは、これを閉じるリクエストとして解釈せず、別のアクションとして解釈するかもしれません。

Esc キーが 閉じるリクエスト として解釈されるプラットフォームでは、ユーザーエージェントはキーが押された状態を閉じるリクエストとして解釈する必要があります。 したがって、上記のアルゴリズムでは、「関連イベント」として発火するのは単一の keydown イベントです。

Esc が 閉じるリクエスト として扱われるプラットフォームでは、ユーザーエージェントは最初に適切に初期化された keydown イベントを発火させます。もしウェブ開発者が preventDefault() を呼び出してイベントをキャンセルした場合、何も起こりません。しかし、 イベントがキャンセルされずに発火した場合、ユーザーエージェントは 閉じるウォッチャーの処理 に進みます。

戻るボタンが潜在的な 閉じるリクエスト であるプラットフォームでは、イベントは関与しないため、戻るボタンが押されると、ユーザーエージェントは直接 閉じるウォッチャーの処理 に進みます。 アクティブな 閉じるウォッチャー があれば、それがトリガーされます。そうでない場合、ユーザーエージェントは戻るボタンの押下を別の方法で解釈することができます。例えば、−1 のデルタで履歴を 移動 する要求として解釈することができます。

6.10.2 閉じる監視器のインフラ

各 Window には 閉じる監視器マネージャー があり、これは以下の 構造体 で、 次の アイテム を持ちます：

閉じる監視器マネージャーの複雑さの多くは、ユーザーの歴史遍歴機能を無効にすることを防ぐための反 abuse 保護から来ており、特に 閉じるリクエスト の フォールバックアクション が歴史遍歴の主要なメカニズムであるプラットフォームにおいて重要です。特に：

閉じる監視器のグループ化は、複数の閉じる監視器が 歴史アクションのアクティベーション なしに作成されると、それらがグループ化され、ユーザーがトリガーした 閉じるリクエスト により、グループ内のすべての閉じる監視器が閉じられるように設計されています。これにより、ウェブ開発者は無限の数の閉じるリクエストを傍受することができず、代わりに、最大で 1 + ページのユーザーアクティベーションの回数まで作成できます。

次のユーザーインタラクションは、新しいグループを許可します というブール値は、ウェブ開発者がクローズウォッチャーを個々のユーザーアクティベーションに結びつけて作成することを奨励します。これがなければ、各ユーザーアクティベーションが許可されるグループの数を増加させてしまい、ウェブ開発者がそれらのユーザーアクティベーションを使用してクローズウォッチャーを作成していない場合でも増加してしまいます。簡単に言えば:

この保護は、(1 + ページのユーザーアクティベーションの回数) グループを作成するという目標を守るためには 重要ではありません。悪意のある者は、各ユーザーインタラクションごとに 1 つの閉じる監視器を作成し、将来の悪用のために「蓄積」することができます。しかし、このシステムは通常のケースでより予測可能な動作を生み出し、非悪意のある開発者にユーザーインタラクションに直接応じて閉じる監視器を作成するよう奨励します。

ユーザーアクティベーションについて閉じる監視器マネージャーに通知する ために Window window がある場合：

  1. manager を window の 閉じる監視器マネージャー に設定します。

  2. もし manager の 次のユーザーインタラクションで新しいグループを許可する が true であれば、manager の 許可されるグループ数 を増加させます。

  3. manager の 次のユーザーインタラクションで新しいグループを許可する を false に設定します。

「close watcher」は、次の構造体を持つ項目を持つ構造体です：

「close watcher」 closeWatcher が closeWatcher の ウィンドウ の close watcher manager 含まれている すべてのリストが 含む ならば、closeWatcher。

Window window、ステップのリスト cancelAction、ステップのリスト closeAction、およびブール値を返すアルゴリズム getEnabledState を指定して、クローズウォッチャーを確立するには：

  1. 確認: window の 関連付けられた Document が 完全にアクティブ であることを確認します。

  2. closeWatcher を新しい close watcher として設定します。

    ウィンドウ
    window
    キャンセルアクション
    cancelAction
    閉じるアクション
    closeAction
    キャンセルアクションが実行中
    false
    有効状態取得
    getEnabledState

  3. manager を window の close watcher manager とします。

  4. もし manager の グループ の サイズ が manager の 許可された グループ数 より少ない場合、追加 « closeWatcher » を manager の グループ に追加します。

  5. そうでない場合：

    1. 確認: manager の グループ の サイズ がこのブランチで少なくとも 1 であることを確認します、 これは manager の 許可された グループ数 が常に 1 以上であるためです。

    2. 追加 closeWatcher を manager の グループ の最後の 項目 に追加します。

  6. manager の 次のユーザー操作により新しいグループを許可 を true に設定します。

  7. closeWatcher を返します。

クローズウォッチャー closeWatcher に、ブール値 requireHistoryActionActivation を用いて閉じるよう要求するには：

  1. もし closeWatcher アクティブでない の場合、 true を返します。

  2. closeWatcher の 有効状態取得を実行した結果が false の場合、true を返します。

  3. もし closeWatcher の キャンセルアクションが実行中 が true の場合、true を返します。

  4. window を closeWatcher の ウィンドウ とします。

  5. もし window の 関連付けられた Document が 完全にアクティブでない の場合、true を返します。

  6. canPreventClose を、requireHistoryActionActivation が false である場合、または window の クローズウォッチャーマネージャーの グループの サイズが window の クローズウォッチャーマネージャーの 許可されるグループ数より小さく、かつ window が 履歴アクションアクティベーションを持つ場合は true とし、それ以外の場合は false とします。

  7. closeWatcher の キャンセルアクションが実行中 を true に設定します。

  8. shouldContinue を、closeWatcher の キャンセルアクション を canPreventClose で実行した結果とします。

  9. closeWatcher の キャンセルアクションが実行中 を false に設定します。

  10. もし shouldContinue が false の場合：

    1. 確認: canPreventClose が true であることを確認します。

    2. 履歴アクションユーザーアクティベーションの消費 を window に対して行います。

    3. false を返します。

    これらのサブステップが 履歴アクションユーザーアクティベーションを消費する ため、close watcher の閉じる要求 を 2 回実行すると、間に ユーザーアクティベーション がないと、2 回目の実行では canPreventClose が false になります。

  11. 閉じる closeWatcher を実行します。

  12. true を返します。

閉じる ために、close watcher closeWatcher：

  1. もし closeWatcher アクティブでない の場合、 戻ります。

  2. closeWatcher の 有効状態取得を実行した結果が false の場合、戻ります。

  3. もし closeWatcher の ウィンドウ の 関連付けられた Document が 完全にアクティブでない の場合、戻ります。

  4. 破棄する closeWatcher を実行します。

  5. closeWatcher の 閉じるアクション を実行します。

破棄する ために、close watcher closeWatcher：

  1. manager を closeWatcher の ウィンドウ の close watcher manager とします。

  2. 各 group を manager の グループ から 削除 します。

  3. 削除 します。manager の グループ から 空 なアイテムを削除します。

クローズウォッチャーを処理する ために、Window window：

  1. processedACloseWatcher を false に設定します。

  2. もし window の close watcher manager の グループ が空でない場合：

    1. group を window の close watcher manager の グループ の最後の アイテム とします。

    2. 各 closeWatcher を group の逆順で：

      1. closeWatcher の 有効状態取得を実行した結果が true の場合、processedACloseWatcher を true に設定します。

      2. shouldProceed を、true を用いて closeWatcher に閉じるよう要求した結果とします。

      3. shouldProceed が false の場合、中断します。

  3. もし window の close watcher manager の 許可されているグループの数 が 1 より大きい場合、1 減らします。

  4. processedACloseWatcher を返します。

6.10.3 CloseWatcher インターフェイス

[Exposed=Window]
interface CloseWatcher : EventTarget {
  constructor(optional CloseWatcherOptions options = {});

  undefined requestClose();
  undefined close();
  undefined destroy();

  attribute EventHandler oncancel;
  attribute EventHandler onclose;
};

dictionary CloseWatcherOptions {
  AbortSignal signal;
};
watcher = new CloseWatcher()
watcher = new CloseWatcher({ signal })

新しい CloseWatcher インスタンスを作成します。

もし signal オプションが指定されている場合、watcher は watcher.destroy() のように、指定された AbortSignal によって破棄できます。

もし既にアクティブな close watcher があり、かつ Window が history-action activation を持たない場合、結果として CloseWatcher は、既にアクティブな close watcher と共に、任意の close request に応じて閉じられます。(この 既にアクティブな close watcher は必ずしも CloseWatcher オブジェクトである必要はありません; モーダルな dialog 要素や、popover 属性を持つ要素によって生成されるポップオーバーである可能性もあります。)

watcher.requestClose()

あたかも close request が watcher をターゲットに送信されたかのように動作します。まず cancel イベントを発火させ、もしそのイベントが preventDefault() でキャンセルされなかった場合は、次に close イベントを発火させて、watcher.destroy() が呼ばれたかのように close watcher を非アクティブにします。

これは、cancel と close イベントハンドラーにキャンセルとクローズのロジックを統合するためのヘルパー ユーティリティです。すべての非 close request クローズの便宜がこのメソッドを呼び出します。

watcher.close()

即座に close イベントを発火させ、その後 watcher.destroy() が呼ばれたかのように close watcher を非アクティブにします。

これは、close イベントハンドラー内のクローズ ロジックをトリガーするためのヘルパー ユーティリティです。cancel イベントハンドラー内のロジックはスキップされます。

watcher.destroy()

watcher を非アクティブにして、もはや close イベントを受け取らず、新しい独立した CloseWatcher インスタンスを構築できるようにします。

これは、関連する UI 要素が閉じられる以外の方法で破棄される場合に呼び出されることを意図しています。

各 CloseWatcher インスタンスには、内部クロースウォッチャー があり、 これは クロースウォッチャー です。

new CloseWatcher(options) コンストラクタの手順は次のとおりです：

  1. もし this の 関連するグローバルオブジェクト の 関連付けられた Document が 完全にアクティブ でない場合、「InvalidStateError」 DOMException をスローします。

  2. closeWatcher を、クロースウォッチャーを確立する の結果として設定します、this の 関連するグローバルオブジェクト を使用して、次の条件で：

  3. もし options["signal"] 存在する ならば：

    1. もし options["signal"] が 中止された ならば、破棄する closeWatcher 。

    2. 追加する 次の手順を options["signal"] に追加します：

      1. 破棄する closeWatcher。

  4. this の 内部クロースウォッチャー を closeWatcher に設定します。

requestClose() メソッドのステップは、false を用いて this の 内部クローズウォッチャーに閉じるよう要求することです。

close() メソッドの手順は、閉じる this の 内部クロースウォッチャー に対して行います。

destroy() メソッドの手順は、破棄する this の 内部クロースウォッチャー に対して行います。

以下は、すべての CloseWatcher インターフェイスを実装するオブジェクトがサポートしなければならない イベントハンドラー （および対応する イベントハンドラーイベントタイプ）です：

イベントハンドラー イベント ハンドラーイベントタイプ
oncancel cancel
onclose close

カスタムピッカーコントロールを実装したい場合、ユーザー提供の クローズリクエストや クローズボタンが押されたときに自動的に閉じるようにする方法を示す以下のコードは、 CloseWatcher APIを 使用してクローズリクエストを処理する方法を示しています： 

const watcher = new CloseWatcher();
 const picker = setUpAndShowPickerDOMElement();
 
 let chosenValue = null;
 
 watcher.onclose = () => {
   chosenValue = picker.querySelector('input').value;
   picker.remove();
 };
 
 picker.querySelector('.close-button').onclick = () => watcher.requestClose();

選択された値を収集するロジックが CloseWatcher オブジェクトの close イベントハンドラに集約されている点に注目してください。また、クローズボタンの click イベントハンドラが、そのロジックを委任し requestClose() を呼び出します。

cancel イベントは、 CloseWatcher オブジェクトで close イベントを防ぐために使用でき、CloseWatcher が破壊されるのを防ぐことができます。典型的な使用例は以下の通りです： 

watcher.oncancel = async (e) => {
  if (hasUnsavedData && e.cancelable) {
    e.preventDefault();

    const userReallyWantsToClose = await askForConfirmation("Are you sure you want to close?");
    if (userReallyWantsToClose) {
      hasUnsavedData = false;
      watcher.close();
    }
  }
};

悪用防止のため、このイベントはページに 履歴アクションのアクティベーション が なければ キャンセル可能 ではありません。このため、ユーザーが連続して2回クローズリクエストを送信しても、 いずれのリクエストも確実に成功します。2回目のリクエストは cancel イベントハンドラが preventDefault() を呼び出そうとする試みを無視し、CloseWatcher を閉じます。

上記の2つの例を組み合わせると、requestClose() と close() がどのように異なるかがわかります。クローズボタンの click イベントハンドラで requestClose() を使用したため、そのボタンをクリックすると CloseWatcher の cancel イベントが トリガーされ、未保存のデータがある場合はユーザーに確認を求めます。もし close() を使用していた場合、このチェックはスキップされます。場合によってはそれが適切ですが、 通常は requestClose() の方がユーザーによってトリガーされたクローズリクエストにはより適しています。

ユーザーアクティベーション 制限に加えて、 cancel イベントの より微妙なユーザーアクティベーションゲーティングがあります。CloseWatcher の コンストラクションでは、ユーザーアクティベーションなしで複数の CloseWatcher を作成すると、新しく作成されたものが最近作成された クローズウォッチャー と グループ化されるため、単一の クローズリクエスト で両方が閉じます： 

window.onload = () => {
   // これは通常通りに動作します：ユーザーアクティベーションなしで作成された最初のクローズウォッチャーです。
   (new CloseWatcher()).onclose = () => {
   /* ... */
   };
 };
 
 button1.onclick = () => {
   // これは通常通りに動作します：ボタンクリックがユーザーアクティベーションと見なされます。
   (new CloseWatcher()).onclose = () => {
   /* ... */
   };
 
 button2.onclick = () => {
   // これらはグループ化され、単一のクローズリクエストに応じて両方が閉じます。
   (new CloseWatcher()).onclose = () => {
   /* ... */
   };
   (new CloseWatcher()).onclose = () => {
   /* ... */
   };
 };

これにより、destroy()、 close()、 または requestClose() を適切に呼び出すことが重要です。これを行うことで「フリー」なグループ化されていないクローズウォッチャースロットを 取り戻すことができます。このようなユーザーアクティベーションなしで作成されたクローズウォッチャーは、ユーザーの アクティベーションに応じて生成されないセッションの非アクティブタイムアウトダイアログやサーバーによってトリガーされる 緊急通知などのケースで便利です。

6.11 ドラッグアンドドロップ

HTML_Drag_and_Drop_API

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome4+
Opera12+Edge79+
Edge（レガシー）18Internet Explorer5.5+
Firefox Android4+Safari iOS2+Chrome Android18+WebView Android4.4+Samsung Internet1.5+Opera Android14+

このセクションでは、イベントベースのドラッグアンドドロップメカニズムを定義します。

この仕様では、ドラッグアンドドロップ操作が実際に何であるかは正確には定義されていません。

視覚的なメディアでポインティングデバイスを使用する場合、ドラッグ操作はデフォルトアクションとしてのmousedown イベントに続いて、一連のmousemove イベントが続き、ドロップはマウスボタンが解放されることでトリガーされる可能性があります。

ポインティングデバイス以外の入力モダリティを使用する場合、ユーザーはドラッグアンドドロップ操作を実行する意図を明示的に示し、何をドラッグするか、どこにドロップするかをそれぞれ示す必要があるでしょう。

実装方法にかかわらず、ドラッグアンドドロップ操作には開始点（例：マウスがクリックされた場所、またはドラッグのために選択された選択または要素）、任意の数の中間ステップ（ドラッグ中にマウスが移動する要素、またはユーザーが選択肢を循環させる際に選ぶ可能性のあるドロップポイント）、および終了点（マウスボタンが解放された要素、または最終的に選択された要素）またはキャンセルが必要です。終了点は、ドロップが発生する前に最後に選択された可能性のあるドロップポイントでなければなりません（したがって、操作がキャンセルされていない場合は、中間ステップに少なくとも1つの要素が存在する必要があります）。

6.11.1 はじめに

このセクションは非公式です。

要素をドラッグ可能にするには、その要素に draggable 属性を設定し、dragstart イベントのリスナーを設定して、 ドラッグされているデータを保存します。

イベントハンドラーは通常、ドラッグされているのがテキスト選択でないことを確認する必要があり、 次に、データを DataTransfer オブジェクトに保存し、 許可される効果（コピー、移動、リンク、またはその組み合わせ）を設定する必要があります。

例えば：

<p>あなたはどの果物が好きですか？</p>
 <ol ondragstart="dragStartHandler(event)">
  <li draggable="true" data-value="fruit-apple">リンゴ</li>
  <li draggable="true" data-value="fruit-orange">オレンジ</li>
  <li draggable="true" data-value="fruit-pear">梨</li>
 </ol>
 <script>
   var internalDNDType = 'text/x-example'; // この値をあなたのサイトに特有のものに設定します
   function dragStartHandler(event) {
     if (event.target instanceof HTMLLIElement) {
       // 要素の data-value="" 属性を移動する値として使用します：
       event.dataTransfer.setData(internalDNDType, event.target.dataset.value);
       event.dataTransfer.effectAllowed = 'move'; // 移動のみを許可します
     } else {
       event.preventDefault(); // 選択をドラッグできないようにします
     }
   }
 </script>

ドロップを受け入れるには、ドロップターゲットが次のイベントをリッスンする必要があります：

  1. dragenter イベント ハンドラーは、ドロップターゲットがドロップを受け入れる可能性があるかどうかを、イベントをキャンセルすることで報告します。
  2. dragover イベント ハンドラーは、ユーザーに表示されるフィードバックを指定します。dropEffect 属性を設定して、イベントに関連付けられた DataTransfer オブジェクトに設定します。 このイベントもキャンセルする必要があります。
  3. drop イベントハンドラーは、 最終的にドロップを受け入れるか拒否する機会があります。ドロップが受け入れられた場合、イベントハンドラーは ターゲットでドロップ操作を実行する必要があります。このイベントはキャンセルする必要があり、dropEffect 属性の値がソースによって使用されるようにします。そうしないと、ドロップ操作は拒否されます。

例えば：

<p>好きな果物を下にドロップしてください：</p>
 <ol ondragenter="dragEnterHandler(event)" ondragover="dragOverHandler(event)"
     ondrop="dropHandler(event)">
 </ol>
 <script>
   var internalDNDType = 'text/x-example'; // この値をあなたのサイトに特有のものに設定します
   function dragEnterHandler(event) {
     var items = event.dataTransfer.items;
     for (var i = 0; i < items.length; ++i) {
       var item = items[i];
       if (item.kind == 'string' && item.type == internalDNDType) {
         event.preventDefault();
         return;
       }
     }
   }
   function dragOverHandler(event) {
     event.dataTransfer.dropEffect = 'move';
     event.preventDefault();
   }
   function dropHandler(event) {
     var li = document.createElement('li');
     var data = event.dataTransfer.getData(internalDNDType);
     if (data == 'fruit-apple')
       {
       li.textContent = 'リンゴ';
     }
     else if (data == 'fruit-orange')
       {
       li.textContent = 'オレンジ';
     }
     else if (data == 'fruit-pear')
       {
       li.textContent = '梨';
     }
     else {
       li.textContent = '不明な果物';
     }
     event.target.appendChild(li);
   }
 </script>

元の要素（ドラッグされた要素）を表示から削除するには、dragend イベントを使用できます。

ここでの例では、元のマークアップを更新してそのイベントを処理する必要があります：

<p>どの果物が好きですか？</p>
 <ol ondragstart="dragStartHandler(event)" ondragend="dragEndHandler(event)"
  ...以前と同じように...
 </ol>
 <script>
   function dragStartHandler(event) {
     // ...以前と同じように...
   }
   function dragEndHandler(event) {
     if (event.dataTransfer.dropEffect == 'move')
       {
       // ドラッグされた要素を削除
       event.target.parentNode.removeChild(event.target);
     }
   }
 </script>

6.11.2 ドラッグデータストア

ドラッグ＆ドロップ操作の基礎データ、つまり ドラッグデータストア は、以下の情報で構成されています：

ドラッグデータストア が 作成される ときは、以下のように初期化する必要があります：ドラッグデータストア項目リスト が空であり、ドラッグデータストアデフォルトフィードバック がなく、ドラッグデータストアビットマップ および ドラッグデータストアホットスポット座標 がなく、ドラッグデータストアモード が 保護モード であり、ドラッグデータストア許可された効果状態 が文字列 "uninitialized" であること。

6.11.3 DataTransfer インターフェース

DataTransfer

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12+

DataTransfer オブジェクトは、ドラッグ＆ドロップ操作の基礎となる ドラッグデータストア を公開するために使用されます。

[Exposed=Window]
 interface DataTransfer {
   constructor();
 
   attribute DOMString dropEffect;
   attribute DOMString effectAllowed;
 
   [SameObject] readonly attribute DataTransferItemList items;
 
   undefined setDragImage(Element image, long x, long y);
 
   /* old interface */
   readonly attribute FrozenArray<DOMString> types;
   DOMString getData(DOMString format);
   undefined setData(DOMString format, DOMString data);
   undefined clearData(optional DOMString format);
   [SameObject] readonly attribute FileList files;
 };
dataTransfer = new DataTransfer()

DataTransfer/DataTransfer

全ての現在のエンジンでサポートされています。

Firefox62+Safari14.1+Chrome59+
Opera?Edge79+
Edge (Legacy)17+Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet8.0+Opera Android44+

新しい DataTransfer オブジェクトを作成し、空の ドラッグデータストア を持ちます。

dataTransfer.dropEffect [ = value ]

DataTransfer/dropEffect

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

現在選択されている操作の種類を返します。操作の種類が effectAllowed 属性で許可されているものでない場合、操作は失敗します。

選択された操作を変更するために設定できます。

可能な値は "none"、 "copy"、 "link"、 および "move" です。

dataTransfer.effectAllowed [ = value ]

DataTransfer/effectAllowed

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

許可される操作の種類を返します。

（dragstart イベント中に）設定でき、許可される操作を変更できます。

可能な値は "none"、 "copy"、 "copyLink"、 "copyMove"、 "link"、 "linkMove"、 "move"、 "all"、 および "uninitialized" です。

dataTransfer.items

DataTransfer/items

全ての現在のエンジンでサポートされています。

Firefox50+Safari11.1+Chrome3+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer対応なし
Firefox Android52+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12+

DataTransferItemList オブジェクトを返し、ドラッグデータを含みます。

dataTransfer.setDragImage(element, x, y)

DataTransfer/setDragImage

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)18Internet Explorer対応なし
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定した要素を使用してドラッグフィードバックを更新し、以前に指定されたフィードバックを置き換えます。

dataTransfer.types

DataTransfer/types

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

フローズン 配列 を返し、dragstart イベントで設定されたフォーマットをリストします。さらに、ファイルがドラッグされている場合は、タイプの1つが "Files" になります。

data = dataTransfer.getData(format)

DataTransfer/getData

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定されたデータを返します。データが存在しない場合は、空の文字列を返します。

dataTransfer.setData(format, data)

DataTransfer/setData

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari5+Chrome3+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android12+

指定されたデータを追加します。

dataTransfer.clearData([ format ])

DataTransfer/clearData

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

指定されたフォーマットのデータを削除します。引数が省略された場合は、すべてのデータが削除されます。

dataTransfer.files

DataTransfer/files

全ての現在のエンジンでサポートされています。

Firefox3.6+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

ドラッグされているファイルの FileList を返します。ファイルがない場合は空です。

DataTransfer オブジェクトは、ドラッグアンドドロップイベント の一部として作成されるもので、これらのイベントが発火している間のみ有効です。

DataTransfer オブジェクトは、その有効な間、ドラッグデータストア に関連付けられています。

DataTransfer オブジェクトには、関連付けられた types 配列 があり、これは FrozenArray<DOMString> で、初期状態では空です。DataTransfer オブジェクトの ドラッグデータストアアイテムリスト が変更された場合、または DataTransfer オブジェクトが ドラッグデータストア との関連付けが解除された場合、次の手順を実行します。

  1. L を空のシーケンスとして設定します。

  2. もし DataTransfer オブジェクトがまだ ドラッグデータストア に関連付けられている場合は、次のようにします：

    1. DataTransfer オブジェクトの ドラッグデータストアアイテムリスト の各アイテムで、その kind が text であるものについて、アイテムの type string からのエントリを L に追加します。

    2. もし DataTransfer オブジェクトの ドラッグデータストアアイテムリスト に、kind が File であるアイテムがある場合、"Files" という文字列のエントリを L に追加します。（この値は他の値と区別できます。なぜなら、他の値は小文字であるからです。）

  3. DataTransfer オブジェクトの types 配列 を、L から フローズン配列 を作成する結果に設定します。

DataTransfer() コンストラクタが呼び出されると、新しく作成された DataTransfer オブジェクトが次のように初期化されます。

  1. ドラッグデータストア の アイテムリスト を空のリストに設定します。

  2. ドラッグデータストア の モード を 読み書きモード に設定します。

  3. dropEffect と effectAllowed を "none" に設定します。

dropEffect 属性は、ドラッグアンドドロップ操作中にユーザーに与えられるフィードバックを制御します。DataTransfer オブジェクトが作成されると、dropEffect 属性は文字列値に設定されます。取得時には現在の値を返す必要があります。設定時には、新しい値が "none"、"copy"、"link"、または "move" のいずれかであれば、属性の現在の値は新しい値に設定されなければなりません。他の値は無視されなければなりません。

effectAllowed 属性は、ドラッグアンドドロップ処理モデルで dropEffect 属性を dragenter および dragover イベント中に初期化するために使用されます。DataTransfer オブジェクトが作成されると、effectAllowed 属性は文字列値に設定されます。取得時には現在の値を返す必要があります。設定時には、ドラッグデータストア の モード が 読み書きモード であり、新しい値が "none"、"copy"、"copyLink"、"copyMove"、"link"、"linkMove"、"move"、"all"、または "uninitialized" のいずれかであれば、属性の現在の値は新しい値に設定されなければなりません。それ以外の場合は、変更されることなくそのままにされなければなりません。

items 属性は、DataTransferItemList オブジェクトを返さなければなりません。このオブジェクトは DataTransfer オブジェクトに関連付けられています。

setDragImage(image, x, y) メソッドは次の手順を実行しなければなりません：

  1. DataTransfer オブジェクトがもはや ドラッグデータストア に関連付けられていない場合、処理を終了します。何も起こりません。

  2. ドラッグデータストア の モード が 読み書きモード でない場合、処理を終了します。何も起こりません。

  3. image が img 要素である場合、その要素の画像を (その 自然サイズ で) ドラッグデータストアビットマップ に設定します。そうでない場合は、指定された要素から生成された画像を ドラッグデータストアビットマップ に設定します (この方法の詳細は現在指定されていません)。

  4. ドラッグデータストアホットスポット座標 を指定された x、y 座標に設定します。

types 属性は、この DataTransfer オブジェクトの types array を返さなければなりません。

getData(format) メソッドは次の手順を実行しなければなりません：

  1. DataTransfer オブジェクトがもはや ドラッグデータストア に関連付けられていない場合、空文字列を返します。

  2. ドラッグデータストア の モード が 保護モード である場合、空文字列を返します。

  3. format を最初の引数として、ASCII小文字に変換 します。

  4. convert-to-URL を false に設定します。

  5. format が "text" の場合、"text/plain" に変更します。

  6. format が "url" の場合、"text/uri-list" に変更し、convert-to-URL を true に設定します。

  7. ドラッグデータストアアイテムリスト に、kind が text で、type string が format に等しいアイテムがない場合、空文字列を返します。

  8. result を ドラッグデータストアアイテムリスト で、kind が Plain Unicode string で、type string が format に等しいアイテムのデータに設定します。

  9. convert-to-URL が true の場合、result を text/uri-list データに適切にパースし、その後、リストから最初の URL を設定します (存在する場合)。存在しない場合は空文字列にします。 [RFC2483]

  10. result を返します。

setData(format, data) メソッドは次の手順を実行しなければなりません：

  1. DataTransfer オブジェクトがもはや ドラッグデータストア に関連付けられていない場合、処理を終了します。何も起こりません。

  2. ドラッグデータストア の モード が 読み書きモード でない場合、処理を終了します。何も起こりません。

  3. format を最初の引数として、ASCII小文字に変換 します。

  4. format が "text" の場合、"text/plain" に変更します。

    format が "url" の場合、"text/uri-list" に変更します。

  5. ドラッグデータストアアイテムリスト から、kind が text で、type string が format に等しいアイテムを削除します (存在する場合)。

  6. ドラッグデータストアアイテムリスト に、kind が text で、type string が format に等しく、データがメソッドの第二引数で与えられた文字列であるアイテムを追加します。

clearData(format) メソッドは次の手順を実行しなければなりません：

  1. DataTransfer オブジェクトがもはや ドラッグデータストア に関連付けられていない場合、処理を終了します。何も起こりません。

  2. ドラッグデータストア の モード が 読み書きモード でない場合、処理を終了します。何も起こりません。

  3. もしメソッドが引数なしで呼び出された場合、ドラッグデータストアアイテムリスト から、kind が Plain Unicode string であるアイテムを削除し、処理を終了します。

  4. format を format に設定し、ASCII小文字に変換 します。

  5. format が "text" の場合、"text/plain" に変更します。

    format が "url" の場合、"text/uri-list" に変更します。

  6. ドラッグデータストアアイテムリスト から、kind が text で、type string が format に等しいアイテムを削除します (存在する場合)。

clearData() メソッドは、ドラッグにファイルが含まれていたかどうかには影響しません。したがって、types 属性のリストは、clearData() を呼び出した後でも空でない可能性があります（ドラッグにファイルが含まれていた場合、リストには "Files" という文字列が含まれるままです）。

files 属性は、次の手順によって見つかったファイルを表す ライブ FileList シーケンスを返さなければなりません。さらに、指定された FileList オブジェクトと指定された基になるファイルについて、同じ File オブジェクトを毎回使用しなければなりません。

  1. 空のリスト L で始めます。

  2. DataTransfer オブジェクトがもはや ドラッグデータストア に関連付けられていない場合、FileList は空です。空のリスト L を返します。

  3. ドラッグデータストア の モード が 保護モード の場合、空のリスト L を返します。

  4. ドラッグデータストアアイテムリスト の中で、kind が File であるアイテムについて、そのデータ（ファイル、特にその名前と内容、および type）をリスト L に追加します。

  5. これらの手順によって見つかったファイルは、リスト L に含まれるものです。

このバージョンのAPIは、ドラッグ中にファイルの種類を公開しません。

6.11.3.1 DataTransferItemList インターフェース

DataTransferItemList

すべての現在のエンジンでサポートされています。

Firefox50+Safari6+Chrome13+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

各DataTransferオブジェクトは、DataTransferItemListオブジェクトに関連付けられています。 

[Exposed=Window]
interface DataTransferItemList {
  readonly attribute unsigned long length;
  getter DataTransferItem (unsigned long index);
  DataTransferItem? add(DOMString data, DOMString type);
  DataTransferItem? add(File data);
  undefined remove(unsigned long index);
  undefined clear();
};
items.length

DataTransferItemList/length

すべての現在のエンジンでサポートされています。

Firefox50+Safari6+Chrome13+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

ドラッグデータストア内のアイテムの数を返します。

items[index]

ドラッグデータストア内のindex番目のエントリを表すDataTransferItemオブジェクトを返します。

items.remove(index)

DataTransferItemList/remove

すべての現在のエンジンでサポートされています。

Firefox50+Safari6+Chrome31+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

ドラッグデータストア内のindex番目のエントリを削除します。

items.clear()

DataTransferItemList/clear

すべての現在のエンジンでサポートされています。

Firefox50+Safari6+Chrome13+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+

ドラッグデータストア内のすべてのエントリを削除します。

items.add(data)

DataTransferItemList/add

すべての現在のエンジンでサポートされています。

Firefox50+Safari6+Chrome13+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android14+
items.add(data, type)

指定されたデータに対して新しいエントリをドラッグデータストアに追加します。データがプレーンテキストの場合は、type文字列も指定する必要があります。

DataTransferItemListオブジェクトのDataTransferオブジェクトがドラッグデータストアに関連付けられている場合、DataTransferItemListオブジェクトのモードは、ドラッグデータストアモードと同じです。DataTransferItemListオブジェクトのDataTransferオブジェクトがドラッグデータストアに関連付けられていない場合、DataTransferItemListオブジェクトのモードは無効モードです。このセクションで参照されているドラッグデータストア（これは、DataTransferItemListオブジェクトが無効モードでない場合にのみ使用されます）は、DataTransferItemListオブジェクトのDataTransferオブジェクトに関連付けられているドラッグデータストアです。

length属性は、オブジェクトが無効モードの場合はゼロを返さなければなりません。それ以外の場合は、ドラッグデータストアアイテムリスト内のアイテム数を返さなければなりません。

DataTransferItemListオブジェクトが無効モードでない場合、そのサポートされているプロパティインデックスは、インデックスです。ドラッグデータストアアイテムリストの。

インデックス付きプロパティの値を決定するために、DataTransferItemListオブジェクトのiについて、ユーザーエージェントはDataTransferItemオブジェクトを返さなければなりません。これは、i番目のアイテムを表します。ドラッグデータストア。特定のアイテムがこのDataTransferItemListオブジェクトから取得されるたびに、同じオブジェクトが返されなければなりません。DataTransferItemオブジェクトは、最初に作成されたときにDataTransferオブジェクトと同じDataTransferItemListオブジェクトに関連付けられていなければなりません。

add()メソッドは、次の手順を実行する必要があります:

  1. もしDataTransferItemListオブジェクトが読み取り/書き込みモードでない場合、nullを返します。

  2. 次のリストから適切な手順セットにジャンプします:

    メソッドの最初の引数が文字列である場合

    すでにテキストの種類を持ち、メソッドの第2引数の値に等しい型文字列を持つアイテムがドラッグデータストアアイテムリストにすでに存在する場合、ASCII小文字に変換されて、"NotSupportedError" DOMExceptionをスローします。

    それ以外の場合は、ドラッグデータストアアイテムリストに、メソッドの第2引数の値に等しい型文字列を持ち、ASCII小文字に変換され、メソッドの第1引数で与えられた文字列をデータとするアイテムを追加します。

    メソッドの最初の引数がFileである場合

    ドラッグデータストアアイテムリストに、Fileの種類を持ち、型がFileと同じで、ASCII小文字に変換されたアイテムを追加します。

  3. 新しく追加されたアイテムに対応するインデックス付きプロパティの値を決定し、その値（新しく作成されたDataTransferItemオブジェクト）を返します。

remove(index)メソッドは次の手順を実行する必要があります:

  1. もしDataTransferItemListオブジェクトが読み取り/書き込みモードでない場合、"InvalidStateError" DOMExceptionをスローします。

  2. ドラッグデータストアにindex番目のアイテムが含まれていない場合、何もせずに終了します。

  3. ドラッグデータストアからindex番目のアイテムを削除します。

clear()メソッドは、DataTransferItemListオブジェクトが読み取り/書き込みモードである場合、ドラッグデータストアからすべてのアイテムを削除しなければなりません。それ以外の場合は、何もしてはなりません。

6.11.3.2 DataTransferItem インターフェース

DataTransferItem

すべての現在のエンジンでサポートされています。

Firefox50+Safari5.1+Chrome11+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android4+Samsung Internet?Opera Android14+

各DataTransferItemオブジェクトは、DataTransferオブジェクトに関連付けられています。 

[Exposed=Window]
interface DataTransferItem {
  readonly attribute DOMString kind;
  readonly attribute DOMString type;
  undefined getAsString(FunctionStringCallback? _callback);
  File? getAsFile();
};

callback FunctionStringCallback = undefined (DOMString data);
item.kind

DataTransferItem/kind

すべての現在のエンジンでサポートされています。

Firefox50+Safari5.1+Chrome11+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android4+Samsung Internet?Opera Android14+

ドラッグデータアイテムの種類を返します。次のいずれかです: "string", "file"。

item.type

DataTransferItem/type

すべての現在のエンジンでサポートされています。

Firefox50+Safari5.1+Chrome11+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android4+Samsung Internet?Opera Android14+

ドラッグデータアイテム型文字列を返します。

item.getAsString(callback)

DataTransferItem/getAsString

すべての現在のエンジンでサポートされています。

Firefox50+Safari5.1+Chrome11+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android4+Samsung Internet?Opera Android14+

コールバックを、ドラッグデータアイテムの種類がテキストである場合に、文字列データを引数として呼び出します。

file = item.getAsFile()

DataTransferItem/getAsFile

すべての現在のエンジンでサポートされています。

Firefox50+Safari5.1+Chrome11+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android4+Samsung Internet?Opera Android14+

ドラッグデータアイテムの種類がFileである場合、Fileオブジェクトを返します。

次の条件に該当する場合、DataTransferItemオブジェクトのモードは、ドラッグデータストアモードと同じです。DataTransferオブジェクトがドラッグデータストアに関連付けられており、そのドラッグデータストアアイテムリストに、DataTransferItemオブジェクトが表すアイテムがまだ含まれている場合です。DataTransferItemオブジェクトのDataTransferオブジェクトがドラッグデータストアに関連付けられていない場合、またはDataTransferItemオブジェクトが表すアイテムが該当するドラッグデータストアアイテムリストから削除された場合、DataTransferItemオブジェクトのモードは無効モードとなります。このセクションで参照されているドラッグデータストア（これはDataTransferItemオブジェクトが無効モードでない場合にのみ使用されます）は、DataTransferItemオブジェクトのDataTransferオブジェクトに関連付けられているドラッグデータストアです。

kind 属性は、DataTransferItem オブジェクトが無効モードにある場合、空文字列を返さなければなりません。それ以外の場合は、次の表の第1列のセルにドラッグデータアイテムの種類が含まれる行の第2列のセルに記載されている文字列を返さなければなりません。オブジェクトが表す項目のDataTransferItemに基づきます。

種類 文字列
テキスト "string"
ファイル "file"

type属性は、DataTransferItemオブジェクトが無効モードである場合は空文字列を返さなければなりません。それ以外の場合は、DataTransferItemオブジェクトが表すアイテムのドラッグデータアイテム型文字列を返さなければなりません。

getAsString(callback)メソッドは、次の手順を実行する必要があります。

  1. callbackがnullである場合、終了します。

  2. DataTransferItemオブジェクトが読み取り/書き込みモードまたは読み取り専用モードでない場合、終了します。この場合、コールバックは実行されません。

  3. ドラッグデータアイテムの種類がテキストでない場合、終了します。この場合も、コールバックは実行されません。

  4. それ以外の場合は、タスクをキューに追加し、DataTransferItemオブジェクトが表すアイテムの実際のデータを引数としてコールバックを実行します。

getAsFile()メソッドは、次の手順を実行する必要があります。

  1. DataTransferItemオブジェクトが読み取り/書き込みモードまたは読み取り専用モードでない場合、nullを返します。

  2. ドラッグデータアイテムの種類がファイルでない場合、nullを返します。

  3. 新しいFileオブジェクトを返し、DataTransferItemオブジェクトが表すアイテムの実際のデータを表します。

6.11.4 DragEventインターフェース

DragEvent/DragEvent

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari14+Chrome46+
Opera12+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOSNoChrome AndroidNoWebView Android?Samsung Internet?Opera Android?

DragEvent

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari14+Chrome46+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOSNoChrome AndroidNoWebView Android?Samsung Internet?Opera Android?

ドラッグアンドドロップの処理モデルには、いくつかのイベントが含まれます。それらはすべて、DragEventインターフェースを使用します。

[Exposed=Window]
 interface DragEvent : MouseEvent {
   constructor(DOMString type, optional DragEventInit eventInitDict = {});
 
   readonly attribute DataTransfer? dataTransfer;
 };
 
 dictionary DragEventInit : MouseEventInit {
   DataTransfer? dataTransfer = null;
 };
event.dataTransfer

DragEvent/dataTransfer

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari14+Chrome46+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer🔰10+
Firefox Android?Safari iOSNoChrome AndroidNoWebView Android?Samsung Internet?Opera Android?

イベントのDataTransferオブジェクトを返します。

他のイベントインターフェースとの一貫性のために、DragEventインターフェースにはコンストラクターがありますが、特に役立つものではありません。特に、スクリプトから有用なDataTransferオブジェクトを作成する方法はありません。なぜなら、DataTransferオブジェクトは、ドラッグアンドドロップ中にブラウザによって調整される処理およびセキュリティモデルを持っているからです。

DragEventインターフェースのdataTransfer属性は、初期化された値を返す必要があります。それはイベントのコンテキスト情報を表します。

ユーザーエージェントが特定のeという名前のDNDイベントを発火し、特定のドラッグデータストアを使用し、必要に応じて特定のrelated targetと共に要素に対して行う必要がある場合、ユーザーエージェントは次の手順を実行する必要があります:

  1. dataDragStoreWasChangedをfalseに設定します。

  2. 特定のrelated targetが提供されていない場合、related targetをnullに設定します。

  3. windowを、指定されたターゲット要素のDocumentオブジェクトの関連するグローバルオブジェクトに設定します。

  4. eがdragstartの場合、ドラッグデータストアモードを読み取り/書き込みモードに設定し、dataDragStoreWasChangedをtrueに設定します。

  5. eがドロップの場合、ドラッグデータストアモードを読み取り専用モードに設定します。

  6. 与えられたドラッグデータストアに関連する新しいDataTransferオブジェクトを作成します。

  7. effectAllowed属性を、ドラッグデータストアのドラッグデータストア許可効果状態に設定します。

  8. eがdragstart、ドラッグ、またはドラッグリーブの場合、dropEffect属性を"なし"に設定します。それ以外の場合は、次の表に示されているように、effectAllowed属性の値とドラッグアンドドロップのソースに基づいて値を設定します（すなわち、eがdragenterまたはdragoverの場合）。

    effectAllowed dropEffect
    "なし" "なし"
    "コピー" "コピー"
    "コピーリンク" "コピー", または、適切な場合に"リンク"
    "コピー移動" "コピー", または、適切な場合に"移動"
    "すべて" "コピー", または、適切な場合に"リンク"または"移動"
    "リンク" "リンク"
    "リンク移動" "リンク", または、適切な場合に"移動"
    "移動" "移動"
    "未初期化"（テキストコントロールから選択されたものをドラッグする場合） "移動", または、適切な場合に"コピー"または"リンク"
    "未初期化"（選択されたものをドラッグする場合） "コピー", または、適切な場合に"リンク"または"移動"
    "未初期化"（a要素をドラッグし、href属性がある場合） "リンク", または、適切な場合に"コピー"または"移動"
    その他のケース "コピー", または、適切な場合に"リンク"または"移動"

    上記の表に可能な適切な代替案が提供されている場合、ユーザーエージェントは、プラットフォームの規約に従い、ユーザーがこれらの代替効果を要求した場合に、リストされている代替値を使用することができます。

    たとえば、Windowsプラットフォームの規約では、「alt」キーを押しながらドラッグすると、データのリンクを移動やコピーよりも優先して示すことになります。そのため、Windowsシステムでは、上記の表に基づいて「リンク」がオプションであり、「alt」キーが押されている場合、ユーザーエージェントは「コピー」または「移動」の代わりにこれを選択することができます。

  9. イベントの作成の結果としてeventを取得し、DragEventを使用します。

  10. eventのtype属性をeに、bubbles属性をtrueに、view属性をwindowに、relatedTarget属性をrelated targetに設定し、dataTransfer属性をdataTransferに設定します。

  11. eがdragleaveまたはdragendでない場合、eventのcancelable属性をtrueに設定します。

  12. ユーザーインタラクションイベントの場合と同様に、入力デバイスの状態に応じて event のマウスおよびキー属性を初期化します。

    関連するポインティングデバイスがない場合、event の screenX、screenY、clientX、clientY、および button 属性を 0 に初期化します。

  13. 指定されたターゲット要素にeventをディスパッチします。

  14. ドラッグデータストア許可効果状態をdataTransferのeffectAllowed属性の現在の値に設定します。（これは、eがdragstartの場合にのみ値を変更することができます。）

  15. dataDragStoreWasChangedがtrueの場合、ドラッグデータストアモードを保護モードに戻します。

  16. dataTransferとドラッグデータストアの関連を解除します。

6.11.5 処理モデル

ユーザーがドラッグ操作を開始しようとした場合、ユーザーエージェントは以下の手順を実行しなければなりません。 ドラッグが他のドキュメントやアプリケーションで開始され、ユーザーエージェントがそのドラッグが発生していることに気づかなかった場合でも、ユーザーエージェントはこれらの手順が実行されたかのように振る舞わなければなりません。

  1. 次のようにして、ドラッグされているものを決定します:

    ドラッグ操作が選択範囲に対して起動された場合、ドラッグされているのは選択範囲です。

    それ以外の場合、ドラッグ操作がDocumentに対して起動された場合、ユーザーがドラッグしようとしたノードから始まり、上位の要素まで登っていく最初の要素が IDL属性draggable が true に設定されているかどうかを確認します。もしそのような要素がなければ、何もドラッグされていません。ドラッグアンドドロップ操作は開始されません。

    それ以外の場合、ドラッグ操作はユーザーエージェントの管理範囲外で起動されました。ドラッグされているものは、ドラッグが開始されたドキュメントやアプリケーションで定義されます。

    img 要素およびa 要素でhref 属性を持つものは、デフォルトでdraggable 属性が true に設定されています。

  2. ドラッグデータストアを作成します。以降の手順で発生するすべてのDNDイベントは、このドラッグデータストアを使用しなければなりません。

  3. ソースノードとなるDOMノードを確定します:

    ドラッグされているのが選択範囲の場合、ソースノードは、ユーザーがドラッグを開始したText ノードです（通常は、ユーザーが最初にクリックしたText ノード）。ユーザーが特定のノードを指定しなかった場合、例えば「選択範囲をドラッグする」とユーザーが指定した場合、ソースノードは、選択範囲の一部を含む最初のText ノードです。

    それ以外の場合、ドラッグされているのが要素の場合、ソースノードは ドラッグされている要素です。

    それ以外の場合、ソースノードは 他のドキュメントやアプリケーションの一部です。この場合、イベントをソースノードで発生させる必要がある場合、ユーザーエージェントはその状況に関連するプラットフォーム固有の慣習に従わなければなりません。

    ドラッグアンドドロップ操作の過程でソースノードに対して複数のイベントが発生します。

  4. ドラッグされたノードのリストを次のように決定します:

    ドラッグされているのが選択範囲の場合、ドラッグされたノードのリスト には、ツリー順 で選択範囲に部分的または完全に含まれるすべてのノード（その祖先も含む）が含まれます。

    それ以外の場合、 ドラッグされたノードのリストには ソースノードのみが含まれます。

  5. ドラッグされているのが選択範囲の場合、 ドラッグデータストアアイテムリストにアイテムを追加し、そのプロパティを次のように設定します:

    ドラッグデータアイテムタイプ文字列
    "text/plain"
    ドラッグデータアイテム種別
    テキスト
    実際のデータ
    選択範囲のテキスト

    それ以外の場合、ファイルがドラッグされている場合は、 ドラッグデータストアアイテムリストにファイルごとに1つのアイテムを追加し、そのプロパティを次のように設定します:

    ドラッグデータアイテムタイプ文字列
    ファイルのMIMEタイプ（既知の場合）または "application/octet-stream" （それ以外の場合）。
    ドラッグデータアイテム種別
    ファイル
    実際のデータ
    ファイルの内容と名前。

    ファイルをドラッグすることは、現在、ナビゲーブル外でのみ行うことができます。 例: ファイルシステムマネージャーアプリケーションなどから。

    ドラッグがアプリケーション外で開始された場合、ユーザーエージェントは、ドラッグされているデータに適したアイテムを ドラッグデータストアアイテムリストに追加し、適切な場合はプラットフォームの慣習に従います。ただし、プラットフォームの慣習がドラッグされたデータをラベル付けするためにMIMEタイプを使用しない場合、ユーザーエージェントは、MIMEタイプにマッピングするために最善の努力をしなければならず、いずれの場合も、ドラッグデータアイテムタイプ文字列はすべて、ASCII小文字に変換する必要があります。

    ユーザーエージェントは、選択範囲またはドラッグされた要素を他の形式、例: HTML などで表現するアイテムを1つ以上追加することもできます。

  6. ドラッグされたノードのリストが空でない場合は、それらのノードからマイクロデータをJSON形式に抽出し、そのプロパティを次のように設定してドラッグデータストアアイテムリストにアイテムを1つ追加します:

    ドラッグデータアイテムタイプ文字列
    application/microdata+json
    ドラッグデータアイテム種別
    テキスト
    実際のデータ
    生成されたJSON文字列。

  7. 次のサブステップを実行します:

    1. urls を「」とします。

    2. ドラッグされたノードのリスト内の各nodeに対して以下を行います:

      ノードが a 要素で、href 属性を持つ場合
      urls にURLのエンコーディング、パース、シリアル化 の結果を追加します。その要素のhref 内容属性の値を基に、その要素のノードドキュメントに対して相対的に行います。
      ノードが img 要素で、src 属性を持つ場合
      urls にURLのエンコーディング、パース、シリアル化 の結果を追加します。その要素のsrc 内容属性の値を基に、その要素のノードドキュメントに対して相対的に行います。

    3. urls が空のままである場合、終了します。

    4. url string をurls内の文字列を結合した結果とし、それらを追加された順にU+000DキャリッジリターンU+000Aラインフィード文字の組み合わせ（CRLF）で区切ります。

    5. 次のプロパティで ドラッグデータストアアイテムリストにアイテムを1つ追加します:

      ドラッグデータアイテムタイプ文字列
      text/uri-list
      ドラッグデータアイテム種別
      テキスト
      実際のデータ
      url string

  8. ユーザーエージェントに適した方法でドラッグデータストアデフォルトフィードバックを更新します （ユーザーが選択範囲をドラッグしている場合は、その選択範囲がこのフィードバックの基礎となる可能性があり、要素をドラッグしている場合は、その要素のレンダリングが使用されます。ドラッグがユーザーエージェント外で開始された場合は、ドラッグフィードバックを決定するためのプラットフォームの慣習が使用されるべきです）。

  9. DNDイベントを発生させる。イベント名は dragstart で、ソースノードで発生させます。

    イベントがキャンセルされた場合、ドラッグアンドドロップ操作は行われません。終了します。

    イベントリスナーが登録されていないイベントは、ほとんど定義上キャンセルされることがないため、著者が特に防止しない限り、ユーザーに対してドラッグアンドドロップが常に利用可能です。

  10. ポインターイベントを発生させる。ソースノードでpointercancelという名前で発生させ、 Pointer Eventsにより必要な他のフォローアップイベントも発生させます。[POINTEREVENTS]

  11. プラットフォームの慣習に従い、以下に記述されているように、ドラッグアンドドロップ操作を開始します。

    ドラッグアンドドロップのフィードバックは、以下の最初の利用可能なソースから生成されなければなりません:

    1. ドラッグデータストアビットマップがある場合。この場合、ドラッグデータストアホットスポット座標が この画像に対してカーソルをどこに配置するかのヒントとして使用されるべきです。値は、画像の左側と上側からの距離をCSSピクセルで表現します。[CSS]
    2. ドラッグデータストアデフォルトフィードバック。

ユーザーエージェントがドラッグアンドドロップ操作を開始する瞬間から、ドラッグアンドドロップ操作の終了まで、デバイス入力イベント（例：マウスやキーボードのイベント）は抑制されなければなりません。

ドラッグ操作中、ユーザーがドロップターゲットとして直接指示した要素は即時ユーザー選択と呼ばれます（ユーザーは要素しか選択できません。他の ノードはドロップターゲットとして利用可能にしてはいけません）。しかし、即時ユーザー選択が必ずしも現在のターゲット要素であるとは限りません。 それは、ドラッグアンドドロップ操作のドロップ部分に現在選択されている要素です。

即時ユーザー選択は、ユーザーが異なる要素を選択するにつれて （ポインティングデバイスで指したり、他の方法で選択したりすることで）変わります。現在のターゲット要素は、以下に説明されているように、ドキュメント内のイベントリスナーの結果に基づいて、即時ユーザー選択 が変わると変化します。

現在のターゲット要素と即時ユーザー選択の両方が null である可能性があり、これはターゲット要素が選択されていないことを意味します。両方が他の（DOMベースの）ドキュメントや、全く別の（ウェブではない）プログラムの要素である可能性もあります（例: ユーザーがテキストをワードプロセッサにドラッグする場合）。現在のターゲット要素は初めはnullです。

また、現在のドラッグ操作があり、これは "none", "copy", "link", および "move" の値を取ることができます。最初は、"none" の値を持ちます。 それは、以下の手順で説明されているように、ユーザーエージェントによって更新されます。

ユーザーエージェントは、ドラッグ操作が 開始されるとすぐに、そしてドラッグ操作が続いている限り、毎回350ms（±200ms）後にタスクをキューに追加して 次の手順を順に実行しなければなりません。

  1. ユーザーエージェントが前回のシーケンスのイテレーションを実行している間に次のイテレーションが発生した場合、このイテレーションをスキップして戻ります（実質的にはドラッグ＆ドロップ操作の「フレームを飛ばす」）。

  2. ドラッグ＆ドロップイベントを発火し、名前はドラッグ、ソースノードで発火します。このイベントがキャンセルされた場合、ユーザーエージェントは現在のドラッグ操作を「なし」（ドラッグ操作なし）に設定しなければなりません。

  3. イベントがキャンセルされず、ユーザーがドラッグ＆ドロップ操作を終了していない場合、次のようにドラッグ＆ドロップ操作の状態を確認します。

    1. ユーザーが前回のイテレーション（または最初のイテレーションの場合）と異なる即時ユーザー選択を示している場合、そしてこの即時ユーザー選択が現在のターゲット要素と同じでない場合、次のようにして現在のターゲット要素を更新します。

      新しい即時ユーザー選択がnullの場合

      現在のターゲット要素もnullに設定します。

      新しい即時ユーザー選択が非DOMドキュメントまたはアプリケーション内の場合

      現在のターゲット要素を即時ユーザー選択に設定します。

      その他の場合

      ドラッグ＆ドロップイベントを発火し、名前はドラッグエンター、即時ユーザー選択で発火します。

      イベントがキャンセルされた場合、現在のターゲット要素を即時ユーザー選択に設定します。

      それ以外の場合、次のリストから適切なステップを実行します。

      もし即時ユーザー選択がテキストコントロール（例：textareaや、input要素であり、type属性がテキスト状態にあるもの）、編集ホストまたは編集可能要素であり、ドラッグデータストアアイテムリストにドラッグデータアイテムタイプ文字列 "text/plain" と ドラッグデータアイテム種別 テキストを含むアイテムがある場合

      現在のターゲット要素を即時ユーザー選択に設定します。

      もし即時ユーザー選択がbody要素である場合

      現在のターゲット要素は変更しません。

      その他の場合

      ドラッグ＆ドロップイベントを発火し、名前はドラッグエンター、body要素（存在する場合）またはDocumentオブジェクト（存在しない場合）で発火します。その後、イベントがキャンセルされたかどうかに関わらず、現在のターゲット要素をbody要素に設定します。

    2. 前のステップで現在のターゲット要素が変更され、前のターゲット要素がnullでないか非DOMドキュメントの一部であった場合、ドラッグ＆ドロップイベントを発火し、名前はドラッグリーブ、新しい現在のターゲット要素を特定のrelated targetとして、前のターゲット要素で発火します。

    3. もし現在のターゲット要素がDOM要素である場合、ドラッグ＆ドロップイベントを発火し、名前はドラッグオーバー、この現在のターゲット要素で発火します。

      もしドラッグオーバーイベントがキャンセルされていない場合、次のリストから適切なステップを実行します。

      もし現在のターゲット要素がテキストコントロール（例：textarea、またはinput要素であり、type属性がテキスト状態にあるもの）、編集ホストまたは編集可能要素であり、ドラッグデータストアアイテムリストにドラッグデータアイテムタイプ文字列 "text/plain" と ドラッグデータアイテム種別 テキストを含むアイテムがある場合

      現在のドラッグ操作を、プラットフォームの慣例に従って「コピー」または「移動」に設定します。

      その他の場合

      現在のドラッグ操作を「なし」にリセットします。

      それ以外の場合（dragover イベントがキャンセルされた場合）、以下の表に従って、イベントのディスパッチが完了した後のDragEventオブジェクトのdataTransferオブジェクトのeffectAllowed属性とdropEffect属性の値に基づいて、現在のドラッグ操作を設定します。

      effectAllowed dropEffect ドラッグ操作
      "未初期化","コピー","コピーリンク","コピー移動","すべて" "コピー" "コピー"
      "未初期化","リンク","コピーリンク","リンク移動","すべて" "リンク" "リンク"
      "未初期化","移動","コピー移動","リンク移動","すべて" "移動" "移動"
      その他のケース "なし"

    4. それ以外の場合、現在のターゲット要素がDOM要素でない場合、プラットフォーム固有のメカニズムを使用して、実行されているドラッグ操作（なし、コピー、リンク、または移動）を判断し、現在のドラッグ操作を適切に設定します。

    5. ドラッグのフィードバック（例：マウスカーソル）を現在のドラッグ操作に一致させるように更新します。

      ドラッグ操作 フィードバック
      "コピー" ここにドロップするとデータがコピーされます。
      "リンク" ここにドロップするとデータがリンクされます。
      "移動" ここにドロップするとデータが移動されます。
      "なし" 操作は許可されておらず、ここにドロップするとドラッグ＆ドロップ操作がキャンセルされます。

  4. それ以外の場合、ユーザーがドラッグアンドドロップ操作を終了した場合（例：マウス操作のドラッグアンドドロップインターフェースでマウスボタンを放した場合）、またはdragイベントがキャンセルされた場合、これが最後のイテレーションになります。次の手順を実行し、ドラッグアンドドロップ操作を停止します：

    1. 現在のドラッグ操作が「none」（ドラッグ操作なし）である場合、またはユーザーがドラッグアンドドロップ操作をキャンセルして終了した場合（例：Escapeキーを押した場合）、または現在のターゲット要素がnullである場合、ドラッグ操作は失敗しました。次のサブステップを実行します:

      1. droppedをfalseに設定します。

      2. 現在のターゲット要素がDOM要素である場合、DNDイベント「dragleave」をその要素で発火させます。それ以外の場合は、nullでなければ、ドラッグキャンセルのためにプラットフォーム固有の規約を使用します。

      3. 現在のドラッグ操作を「none」に設定します。

      それ以外の場合、ドラッグ操作が成功する可能性があります。次のサブステップを実行します:

      1. droppedをtrueに設定します。

      2. 現在のターゲット要素がDOM要素である場合、DNDイベント「drop」をその要素で発火させます。それ以外の場合は、ドロップを示すためにプラットフォーム固有の規約を使用します。

      3. イベントがキャンセルされた場合、イベントのディスパッチが完了した後のDragEventオブジェクトのdataTransferオブジェクトのdropEffect属性の値に現在のドラッグ操作を設定します。

        それ以外の場合、イベントはキャンセルされません。次のように、正確なターゲットに応じてイベントのデフォルトアクションを実行します:

        現在のターゲット要素がテキストコントロール（例：textarea、またはinput要素で、type属性がText状態にあるもの）または編集ホストまたは編集可能な要素であり、ドラッグデータストアアイテムリストに「text/plain」というドラッグデータアイテムタイプ文字列を持つアイテムが含まれている場合

        ドラッグデータストアアイテムリストの最初のアイテムの実際のデータを、編集ホストまたは編集可能な要素に、プラットフォーム固有の規約（例：現在のマウスカーソル位置に挿入、またはフィールドの末尾に挿入）に従って挿入します。

        それ以外の場合

        現在のドラッグ操作を「none」にリセットします。

    2. DNDイベント「dragend」をソースノードで発火させます。

    3. イベント「dragend」のデフォルトアクションとして、次のリストから適切な手順を実行します:

      droppedがtrueであり、現在のターゲット要素がテキストコントロールであり、現在のドラッグ操作が「move」であり、ドラッグアンドドロップ操作のソースが編集ホスト内に完全に含まれているDOM内の選択である場合

      選択を削除します。

      droppedがtrueであり、現在のターゲット要素がテキストコントロールであり、現在のドラッグ操作が「move」であり、ドラッグアンドドロップ操作のソースがテキストコントロール内の選択である場合

      ユーザーエージェントは、該当するテキストコントロールからドラッグされた選択を削除する必要があります。

      droppedがfalseであるか、現在のドラッグ操作が「none」である場合

      ドラッグはキャンセルされました。プラットフォームの規約によりこれがユーザーに対して表現される場合（例：ドラッグされた選択がドラッグアンドドロップ操作のソースに戻るアニメーションが表示される場合）、そのようにします。

      それ以外の場合

      イベントにはデフォルトのアクションがありません。

      このステップの目的で、テキストコントロールとは、textarea要素またはinput要素であり、そのtype属性がText、Search、Tel、URL、Email、Password、またはNumber状態にあるものを指します。

ユーザーエージェントは、スクロール可能な領域の端付近でドラッグが発生した場合にどのように反応するかを検討することが推奨されます。例えば、ユーザーが長いページの下部にリンクをドラッグした場合、ページをスクロールして、ユーザーがそのリンクをページの下部にドロップできるようにすることが理にかなっているかもしれません。

このモデルは、関与するノードがどのDocumentオブジェクトから来たかに依存しません。イベントは上記の通りに発火し、処理モデルの残りも、操作に関与するドキュメントの数に関係なく、上記の通りに実行されます。

6.11.6 イベントの概要

このセクションは規範的ではありません。

以下のイベントは、ドラッグアンドドロップモデルに関連しています。

イベント名 ターゲット キャンセル可能か? ドラッグデータストアモード dropEffect デフォルトアクション
dragstart

HTMLElement/dragstart_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
ソースノード ✓ キャンセル可能 読み書きモード "none" ドラッグアンドドロップ操作の開始
drag

HTMLElement/drag_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
ソースノード ✓ キャンセル可能 保護モード "none" ドラッグアンドドロップ操作の継続
dragenter

HTMLElement/dragenter_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
即時ユーザー選択 またはbody 要素 ✓ キャンセル可能 保護モード effectAllowed 値に基づく 即時ユーザー選択 をターゲット要素として拒否する
dragleave

HTMLElement/dragleave_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
前のターゲット要素 — 保護モード "none" なし
dragover

HTMLElement/dragover_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
現在のターゲット要素 ✓ キャンセル可能 保護モード effectAllowed 値に基づく 現在のドラッグ操作を"none"にリセット
drop

HTMLElement/drop_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
現在のターゲット要素 ✓ キャンセル可能 読み取り専用モード 現在のドラッグ操作 様々
dragend

HTMLElement/dragend_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari3.1+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
ソースノード — 保護モード 現在のドラッグ操作 様々

これらすべてのイベントはバブルし、構成され、effectAllowed属性は、dragstartイベント後の値を常に持ち、デフォルトは未初期化です。

6.11.7 draggable 属性

Global_attributes/draggable

すべての現在のエンジンでサポートされています。

Firefox2+Safari5+Chrome4+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorerはい
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

すべてのHTML 要素には、draggableコンテンツ属性を設定できます。draggable属性は、次のキーワードと状態を持つ列挙型属性です:

キーワード 状態 簡単な説明
true True 要素はドラッグ可能です。
false False 要素はドラッグできません。

属性の欠落値のデフォルトおよび無効値のデフォルトはどちらもAuto状態です。auto状態はユーザーエージェントのデフォルトの動作を使用します。

draggable属性を持つ要素には、非視覚的な操作を目的として、要素の名前を示すtitle属性も持つべきです。

element.draggable [ = value ]

要素がドラッグ可能な場合は true を返します。それ以外の場合は false を返します。

デフォルトを上書きしてdraggableコンテンツ属性を設定することができます。

draggableIDL属性は、その値が以下で説明する方法でコンテンツ属性に依存しており、要素がドラッグ可能かどうかを制御します。一般的に、テキスト選択のみがドラッグ可能ですが、draggableIDL属性が true の要素もドラッグ可能になります。

要素のdraggableコンテンツ属性が状態Trueを持つ場合、draggableIDL属性はtrueを返さなければなりません。

それ以外の場合、要素のdraggableコンテンツ属性が状態Falseを持つ場合、draggableIDL属性はfalseを返さなければなりません。

それ以外の場合、要素のdraggableコンテンツ属性が状態Autoを持つ場合、要素がimg要素、画像を表すobject要素、またはa要素であり、hrefコンテンツ属性を持つ場合、draggableIDL属性はtrueを返さなければなりません。それ以外の場合、draggableIDL属性はfalseを返さなければなりません。

draggableIDL属性がfalseに設定されている場合、draggableコンテンツ属性はリテラル値 "false" に設定されなければなりません。draggableIDL属性がtrueに設定されている場合、draggableコンテンツ属性はリテラル値 "true" に設定されなければなりません。

6.11.8 ドラッグアンドドロップモデルにおけるセキュリティリスク

ユーザーエージェントは、DataTransferオブジェクトにdragstartイベント中に追加されたデータを、dropイベントまでスクリプトに利用可能にしてはなりません。さもないと、ユーザーが機密情報をあるドキュメントから別のドキュメントにドラッグする際、途中で敵対的な第三のドキュメントを通過すると、その敵対的なドキュメントがデータを傍受する可能性があるからです。

同じ理由から、ユーザーエージェントはユーザーが明示的にドラッグ操作を終了した場合にのみドロップを成功と見なすべきです。スクリプトがドラッグ操作を終了した場合は、ドロップは失敗（キャンセル）と見なされ、dropイベントは発生してはなりません。

ユーザーエージェントは、スクリプトのアクションに応じてドラッグアンドドロップ操作を開始しないよう注意する必要があります。たとえば、マウスとウィンドウの環境で、スクリプトがユーザーがマウスボタンを押している間にウィンドウを移動させた場合、UAはそれをドラッグの開始とは見なしません。これは、そうしないとUAが機密ソースからデータを敵対的なドキュメントにユーザーの同意なしにドラッグさせる可能性があるため、重要です。

ユーザーエージェントは、ドラッグおよびドロップ時に、潜在的にアクティブな（スクリプト化された）コンテンツ（例：HTML）を、既知の安全な機能の安全リストを使用してフィルタリングする必要があります。同様に、相対URLは、予期しない方法で参照が変更されるのを避けるために、絶対URLに変換されるべきです。本仕様は、これがどのように行われるかを指定していません。

敵対的なページがコンテンツを提供し、ユーザーにそのコンテンツを選択してドラッグアンドドロップ（または実際にコピーアンドペースト）させ、被害者ページのcontenteditable領域に移動させることを考えてみてください。ブラウザが安全なコンテンツのみがドラッグされることを保証しない場合、選択範囲内のスクリプトやイベントハンドラなどの潜在的に安全でないコンテンツが被害者サイトにドロップ（またはペースト）されると、被害者サイトの権限を取得します。これにより、クロスサイトスクリプティング攻撃が可能になります。

6.12 popover属性

Global_attributes/popover

すべての現在のエンジンでサポートされています。

Firefox🔰 114+Safariプレビュー版+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

すべてのHTML要素にはpopoverコンテンツ属性を設定できます。指定された場合、要素は表示されるまでレンダリングされず、その時点で他のページコンテンツの上にレンダリングされます。

popover属性は、著者が最も関連するセマンティクスを持つ要素にポップオーバー機能を適用できるようにするグローバル属性です。

次の例は、ウェブサイトのグローバルナビゲーション内にポップオーバーサブナビゲーションリンクのリストを作成する方法を示しています。

<ul>
   <li>
     <a href=...>All Products</a>
     <button popovertarget=sub-nav>
      <img src=down-arrow.png alt="Product pages">
     </button>
     <ul popover id=sub-nav>
      <li><a href=...>Shirts</a>
      <li><a href=...>Shoes</a>
      <li><a href=...>Hats etc.</a>
     </ul>
   </li>
   <!-- 他のリストアイテムやリンクがここにあります -->
 </ul>

popoverをアクセシビリティのセマンティクスを持たない要素、例えばdiv要素に使用する場合、著者はポップオーバーがアクセス可能であることを確保するために適切なARIA属性を使用する必要があります。

次の例は、カスタムメニューポップオーバーを作成するための基本的なマークアップを示しています。ポップオーバーが起動されると、autofocus属性の使用により最初のメニュー項目がキーボードフォーカスを受け取ります。矢印キーによるメニュー項目のナビゲーションとアクティベーション動作は、引き続き著者のスクリプトが必要です。カスタムメニューウィジェットを構築するための追加の要件は、WAI-ARIA仕様に定義されています。 

<button popovertarget=m>Actions</button>
 <div role=menu id=m popover>
   <button role=menuitem tabindex=-1 autofocus>Edit</button>
   <button role=menuitem tabindex=-1>Hide</button>
   <button role=menuitem tabindex=-1>Delete</button>
 </div>

ポップオーバーは、ユーザーが実行したアクションを確認するためにステータスメッセージを表示するのに便利です。次の例は、output要素でポップオーバーを表示する方法を示しています。 

<button id=submit>Submit</button>
 <p><output><span popover=manual></span></output></p>
 
 <script>
  const sBtn = document.getElementById("submit");
  const outSpan = document.querySelector("output [popover=manual]");
  let successMessage;
  let errorMessage;
 
  /* アクションの成功を判定するロジックと、使用する適切な成功またはエラーメッセージを定義する */
 
  sBtn.addEventListener("click", ()=> {
   if ( success ) {
    outSpan.textContent = successMessage;
   }
   else {
    outSpan.textContent = errorMessage;
   }
   outSpan.showPopover();
 
   setTimeout(function () {
    outSpan.hidePopover();
   }, 10000);
  });
 </script>

output要素にポップオーバー要素を挿入すると、一般的にそのコンテンツが表示されるときにスクリーンリーダーがそれをアナウンスします。コンテンツの複雑さや頻度によっては、これがこれらの支援技術のユーザーにとって有用であるか、煩わしいかもしれません。output要素やその他のARIAライブリージョンを使用する際には、最良のユーザー体験を確保するためにこの点に留意してください。

popover属性は、次のキーワードと状態を持つ列挙型属性です。

キーワード 状態 簡単な説明
auto Auto 開いたときに他のポップオーバーを閉じます。ライトディスミスを持ち、閉じるリクエストに応答します。
(空文字列)
manual Manual 他のポップオーバーを閉じません。ライトディスミスや閉じるリクエストには応答しません。
hint Hint 開くと他のヒントポップオーバーを閉じますが、他の自動ポップオーバーは閉じません。ライトディスミスがあり、クローズリクエストに応答します。

属性の欠落値のデフォルトはNo Popover状態であり、無効値のデフォルトはManual状態です。

HTMLElement/popover

すべての現在のエンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

popoverIDL属性は、反映され、popover属性を持ち、既知の値に限定されます。

すべてのHTML要素には、ポップオーバー表示状態があり、初期状態は非表示です。状態の値は以下の通りです:

すべての Document はポップオーバーポインターダウンターゲットを持ちます。これはHTML 要素または null で、初期値は null です。

すべてのHTML要素には、ポップオーバー呼び出し元があり、それはHTML要素またはnullで、初期状態はnullです。

すべてのHTML要素には、ポップオーバー表示または非表示があり、それはブール値で、初期状態はfalseです。

すべてのHTML要素には、ポップオーバー切り替えタスクトラッカーがあり、それは切り替えタスクトラッカーまたはnullで、初期状態はnullです。

すべてのHTML要素には、ポップオーバー閉じるウォッチャーがあり、それは閉じるウォッチャーまたはnullで、初期状態はnullです。

すべてのHTML 要素は、ポップオーバーモードで開かれた状態を持ちます。これは文字列または null で、初期値は null です。

次の属性変更ステップは、element、localName、oldValue、value、および namespace が与えられた場合、すべてのHTML 要素に使用されます。

  1. namespaceがnullでない場合、戻ります。

  2. localNameがpopoverでない場合、戻ります。

  3. elementのポップオーバー表示状態が表示中の状態にあり、oldValueとvalueが異なる状態にある場合、element、true、true、およびfalseが与えられたポップオーバー非表示アルゴリズムを実行します。

element.showPopover()
elementを最上層に追加することでポップオーバーを表示します。elementのpopover属性がAuto状態にある場合、Auto状態の他のポップオーバーをすべて閉じます。ただし、それらがelementの最上位ポップオーバー祖先アルゴリズムによって祖先とみなされる場合を除きます。
element.hidePopover()
elementを最上層から削除し、display: noneを適用することでポップオーバーを非表示にします。
element.togglePopover()
ポップオーバーelementが表示されていない場合、このメソッドはそれを表示します。そうでない場合、このメソッドはそれを非表示にします。このメソッドは、ポップオーバーが呼び出し後に開いている場合はtrueを返し、そうでない場合はfalseを返します。

HTMLElement/showPopover

すべての現在のエンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

showPopover(options) メソッドのステップは次のとおりです。

  1. invoker を、options["source"] が存在する場合はそれとし、それ以外の場合は null とします。

  2. this、true、および invoker を指定してポップオーバーを表示します。

HTML 要素 element、ブール値 throwExceptions、およびHTML 要素または null invoker を指定してポップオーバーを表示するには：

  1. element、false、throwExceptions、およびnullを指定してポップオーバーの有効性を確認を実行し、その結果がfalseであれば、処理を終了します。

  2. documentをelementのノードドキュメントとして設定します。

  3. 確認: elementのポップオーバー呼び出し元がnullであることを確認します。

  4. 確認: elementがdocumentの最上層に含まれていないことを確認します。

  5. nestedShowをelementのポップオーバー表示または非表示状態として設定します。

  6. fireEvents を nestedShow のブール否定とします。

  7. elementのポップオーバー表示または非表示状態をtrueに設定します。

  8. 次のステップをcleanupShowingFlagとして設定します:

    1. もしnestedShowがfalseであれば、elementのポップオーバー表示または非表示状態をfalseに設定します。

  9. 次のイベントを発火させた結果がfalseであれば、cleanupShowingFlagを実行し、終了します。

  10. ポップオーバーの有効性を確認を再度実行し、結果がfalseであればcleanupShowingFlagを実行して終了します。

    ポップオーバーの有効性確認は、beforetoggleイベントの発火によってこの要素が切断されたり、popover属性が変更されたりした可能性があるため、再度実行されます。

  11. shouldRestoreFocusをfalseに設定します。

  12. originalType を element の popover 属性の現在の状態とします。

  13. stackToAppendTo を null とします。

  14. autoAncestor を、element、document の 表示中の自動ポップオーバーリスト、invoker、および true を指定して最上位のポップオーバー祖先アルゴリズムを実行した結果とします。

  15. hintAncestor を、element、document の 表示中のヒントポップオーバーリスト、invoker、および true を指定して最上位のポップオーバー祖先アルゴリズムを実行した結果とします。

  16. originalType がAuto状態の場合：

    1. document の 表示中のヒントポップオーバーリスト、shouldRestoreFocus、および fireEvents を指定して、ポップオーバーリスト全体を閉じるを実行します。

    2. ancestor を、element、document の 表示中の自動ポップオーバーリスト、invoker、および true を指定して最上位のポップオーバー祖先アルゴリズムを実行した結果とします。

    3. ancestor が null の場合、ancestor を document に設定します。

    4. ancestor、shouldRestoreFocus、および fireEvents を指定して、指定された要素まですべてのポップオーバーを非表示にするを実行します。

    5. stackToAppendTo を "auto" に設定します。

  17. originalType がHint状態の場合：

    1. hintAncestor が null でない場合：

      1. hintAncestor、shouldRestoreFocus、および fireEvents を指定して、指定された要素まですべてのポップオーバーを非表示にするを実行します。

      2. stackToAppendTo を "hint" に設定します。

    2. それ以外の場合：

      1. document の 表示中のヒントポップオーバーリスト、shouldRestoreFocus、および fireEvents を指定して、ポップオーバーリスト全体を閉じるを実行します。

      2. autoAncestor が null でない場合：

        1. autoAncestor、shouldRestoreFocus、および fireEvents を指定して、指定された要素まですべてのポップオーバーを非表示にするを実行します。

        2. stackToAppendTo を "auto" に設定します。

      3. それ以外の場合、stackToAppendTo を "hint" に設定します。

  18. originalType がAutoまたはHintの場合：

    1. アサート：stackToAppendTo は null ではありません。

    2. originalType が element の popover 属性の値と等しくない場合：

      1. throwExceptions が true の場合、"InvalidStateError" DOMException をスローします。

      2. 戻ります。

    3. element、false、throwExceptions、および document を指定してポップオーバーの有効性を確認した結果が false の場合、cleanupShowingFlag を実行して戻ります。

      上記の指定された要素まですべてのポップオーバーを非表示にするを実行すると beforetoggle イベントが発生し、イベントハンドラーがこの要素を切断したり、その popover 属性を変更したりする可能性があるため、ポップオーバーの有効性を確認が再度呼び出されます。

    4. document で最上位の自動またはヒントポップオーバーを実行した結果が null の場合、shouldRestoreFocus を true に設定します。

      これにより、スタック内の最初のポップオーバーに対してのみ、以前にフォーカスされていた要素にフォーカスが戻されるようになります。

    5. stackToAppendTo が "auto" の場合：

      1. アサート：document の 表示中の自動ポップオーバーリストには element が含まれていません。

      2. element のポップオーバーモードで開かれた状態を "auto" に設定します。

      それ以外の場合：

      1. アサート：stackToAppendTo は "hint" です。

      2. アサート：document の 表示中のヒントポップオーバーリストには element が含まれていません。

      3. element のポップオーバーモードで開かれた状態を "hint" に設定します。

    6. element のポップオーバークローズウォッチャーを、element の関連するグローバルオブジェクトを指定してクローズウォッチャーを確立した結果に設定します。その際、以下を指定します。

  19. element の以前にフォーカスされていた要素を null に設定します。

  20. originallyFocusedElement を document のドキュメントのフォーカスされた領域のDOM アンカーとします。

  21. element を指定して要素を最上位レイヤーに追加します。

  22. element のポップオーバーの可視性状態を表示中に設定します。

  23. element のポップオーバーインボーカーを invoker に設定します。

  24. element の暗黙のアンカー要素を invoker に設定します。

  25. element を指定してポップオーバーフォーカスステップを実行します。

  26. shouldRestoreFocus が true であり、かつ element の popover 属性がNo Popover状態でない場合、element の以前にフォーカスされていた要素を originallyFocusedElement に設定します。

  27. element、"closed"、および "open" を指定してポップオーバートグルイベントタスクをキューに入れます。

  28. cleanupShowingFlag を実行します。

ポップオーバートグルイベントタスクをキューに追加するには、要素element、文字列oldState、および文字列newStateを指定して実行します:

  1. もしelementのポップオーバートグルタスクトラッカーがnullでない場合、次の処理を行います:

    1. oldStateをelementのポップオーバートグルタスクトラッカーの以前の状態に設定します。

    2. elementのポップオーバートグルタスクトラッカーのタスクをタスクキューから削除します。

    3. elementのポップオーバートグルタスクトラッカーをnullに設定します。

  2. 要素タスクをキューに追加し、DOM操作タスクソースとelementを指定して、以下のステップを実行します:

    1. イベントを発火させ、elementでtoggleイベントを、ToggleEventを使用して、oldState属性にoldStateを、newState属性にnewStateを設定します。

    2. elementのポップオーバートグルタスクトラッカーをnullに設定します。

  3. elementのポップオーバートグルタスクトラッカーを、直前にキューに追加されたタスクを含む構造体に設定し、タスクを設定し、以前の状態をoldStateに設定します。

HTMLElement/hidePopover

Support in all current engines.

Firefox🔰114+ Safari17+ Chrome114+
Opera? Edge114+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

The hidePopover()メソッドの手順は次のとおりです:

  1. ポップオーバー非表示アルゴリズムを実行し、this、true、true、およびtrueを指定します。

ポップオーバーを非表示にするためには、指定されたHTML要素 element、booleanの focusPreviousElement、booleanのfireEvents、およびbooleanの throwExceptionsを使用して次の手順を実行します。

  1. element、true、throwExceptions、およびnullを指定してポップオーバーの有効性を確認を実行し、その結果がfalseであれば、処理を終了します。

  2. documentをelementのノードドキュメントとして設定します。

  3. nestedHideをelementのポップオーバーの表示または非表示状態として設定します。

  4. elementのポップオーバーの表示または非表示状態をtrueに設定します。

  5. もしnestedHideがtrueであれば、fireEventsをfalseに設定します。

  6. cleanupStepsを以下の手順として設定します。

    1. もしnestedHideがfalseであれば、elementのポップオーバーの表示または非表示状態をfalseに設定します。

    2. もしelementのポップオーバーの閉じるウォッチャーがnullでない場合、次の処理を行います。

      1. 破棄 elementのポップオーバーの閉じるウォッチャー

      2. elementのポップオーバーの閉じるウォッチャーをnullに設定します。

  7. element の ポップオーバーモードで開かれた状態が "auto" または "hint" の場合：

    1. element、focusPreviousElement、および fireEvents を指定して、指定された要素まですべてのポップオーバーを非表示にするを実行します。

    2. element、true、および throwExceptions を指定してポップオーバーの有効性を確認した結果が false の場合、cleanupSteps を実行して戻ります。

      指定された要素まですべてのポップオーバーを非表示にするを実行すると element が切断されたり、その popover 属性が変更されたりする可能性があるため、ポップオーバーの有効性を確認が再度呼び出されます。

  8. autoPopoverListContainsElement を、document の 表示中の自動ポップオーバーリストの最後の項目が element の場合は true とし、それ以外の場合は false とします。

  9. fireEvents が true の場合：

    1. element で oldState 属性を "open" に、newState 属性を "closed" に初期化して、ToggleEvent を使用して beforetoggle という名前のイベントを発生させます。

    2. autoPopoverListContainsElement が true であり、かつ document の 表示中の自動ポップオーバーリストの最後の項目が element でない場合、element、focusPreviousElement、および false を指定して指定された要素まですべてのポップオーバーを非表示にするを実行します。

    3. element、true、throwExceptions、および null を指定してポップオーバーの有効性を確認した結果が false の場合、cleanupSteps を実行して戻ります。

      beforetoggle イベントを発生させると element が切断されたり、その popover 属性が変更されたりする可能性があるため、ポップオーバーの有効性を確認が再度呼び出されます。

    4. element を指定して要素を最上位レイヤーから削除するよう要求します。

    5. element の 暗黙のアンカー要素を null に設定します。

  10. それ以外の場合、element を指定して要素を最上位レイヤーから直ちに削除します。

  11. element の popover invoker を null に設定します。

  12. element の ポップオーバーモードで開かれた状態を null に設定します。

  13. element の ポップオーバーの可視性状態を非表示に設定します。

  14. fireEvents が true の場合、element、"open"、および "closed" を指定してポップオーバートグルイベントタスクをキューに入れます。

  15. previouslyFocusedElement を element の 以前にフォーカスされていた要素とします。

  16. previouslyFocusedElement が null でない場合：

    1. element の 以前にフォーカスされていた要素を null に設定します。

    2. focusPreviousElement が true であり、かつ document の ドキュメントのフォーカスされた領域の DOM アンカーが element のシャドウインクルーシブ包括的子孫である場合、previouslyFocusedElement のフォーカスステップを実行します。このステップによってビューポートがスクロールされるべきではありません。

  17. cleanupSteps を実行します。

HTMLElement/togglePopover

すべての現行エンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

togglePopover(options) メソッドのステップは次のとおりです。

  1. force を null とします。

  2. options がブール値の場合、force を options に設定します。

  3. それ以外の場合で、options["force"] が存在する場合、force を options["force"] に設定します。

  4. invoker を、options["source"] が存在する場合はそれとし、それ以外の場合は null とします。

  5. this の ポップオーバーの可視性状態が表示中であり、かつ force が null または false の場合、this、true、true、および true を指定してポップオーバー非表示アルゴリズムを実行します。

  6. それ以外の場合で、force が null または true の場合、this、true、および invoker を指定してポップオーバーを表示します。

  7. それ以外の場合：

    1. expectedToBeShowing を、this の ポップオーバーの可視性状態が表示中の場合は true とし、それ以外の場合は false とします。

    2. expectedToBeShowing、true、および null を指定してポップオーバーの有効性を確認します。

  8. this の ポップオーバーの可視性状態が表示中の場合は true を返し、それ以外の場合は false を返します。

指定された要素に到達するまで、すべてのポップオーバーを非表示にしますには、HTML要素またはDocument endpoint、booleanの focusPreviousElement、およびbooleanのfireEventsを指定して実行します。

  1. endpoint がHTML 要素であり、かつendpoint がポップオーバー表示状態にない場合、戻ります。

  2. document を endpoint の ノードドキュメントとします。

  3. アサート：endpoint はDocument であるか、またはendpoint のポップオーバー可視性状態が表示中です。

  4. アサート：endpoint はDocument であるか、またはendpoint の popover 属性がAuto状態であるか、または endpoint の popover 属性がHint状態です。

  5. endpoint がDocument の場合：

    1. document の表示中のヒントポップオーバーリスト、focusPreviousElement、および fireEvents を指定して、ポップオーバーリスト全体を閉じるを実行します。

    2. document の表示中の自動ポップオーバーリスト、focusPreviousElement、および fireEvents を指定して、ポップオーバーリスト全体を閉じるを実行します。

    3. 戻ります。

  6. document の表示中のヒントポップオーバーリストに endpoint が含まれる場合：

    1. アサート：endpoint の popover 属性はHint状態です。

    2. endpoint、document の表示中のヒントポップオーバーリスト、focusPreviousElement、および fireEvents を指定して、指定された要素までポップオーバースタックを非表示にするを実行します。

    3. 戻ります。

  7. document の表示中のヒントポップオーバーリスト、focusPreviousElement、および fireEvents を指定して、ポップオーバーリスト全体を閉じるを実行します。

  8. document の表示中の自動ポップオーバーリストに endpoint が含まれない場合、戻ります。

  9. endpoint、document の表示中の自動ポップオーバーリスト、focusPreviousElement、および fireEvents を指定して、指定された要素までポップオーバースタックを非表示にするを実行します。

HTML 要素 endpoint、リスト popoverList、ブール値 focusPreviousElement、およびブール値 fireEvents を指定して、指定された要素までポップオーバースタックを非表示にするには：

  1. repeatingHide を false とします。

  2. 次のステップを少なくとも1回実行します。

    1. lastToHide を null とします。

    2. popoverList 内の各 popover について：

      1. popover が endpoint の場合、中断します。

      2. lastToHide を popover に設定します。

    3. lastToHide が null の場合、戻ります。

    4. lastToHide のポップオーバー可視性状態が表示中である間：

      1. アサート：popoverList は空ではありません。

      2. popoverList の最後の項目、focusPreviousElement、fireEvents、および false を指定して、ポップオーバー非表示アルゴリズムを実行します。

    5. アサート：repeatingHide が false であるか、または popoverList の最後の項目が endpoint です。

    6. popoverList に endpoint が含まれ、かつ popoverList の最後の項目が endpoint でない場合は repeatingHide を true に設定し、それ以外の場合は false に設定します。

    7. repeatingHide が true の場合、fireEvents を false に設定します。

    そして、repeatingHide が true である間、それらを実行し続けます。

指定された要素に到達するまで、すべてのポップオーバーを非表示にしますアルゴリズムは、 何かが発生したときに開いたままにしないポップオーバーを非表示にするためにいくつかのケースで使用されます。例えば、ポップオーバーのライトディスマス中に、このアルゴリズムはユーザーがクリックしたノードと関係のないポップオーバーのみを閉じることを保証します。

Node newPopoverOrTopLayerElement、リスト popoverList、HTML 要素または null invoker、およびブール値 isPopover を指定して、最上位のポップオーバー祖先を見つけるには、次のステップを実行します。これらはHTML 要素または null を返します。

最上位のポップオーバー祖先アルゴリズムは、提供されたポップオーバーまたはトップレイヤー要素の表示中の自動ポップオーバーリスト内で最上位（最新）の祖先ポップオーバーを返します。ポップオーバーはいくつかの方法で相互に関連付けられ、ポップオーバーのツリーを作成できます。あるポップオーバー（「子」ポップオーバーと呼びます）が最上位の祖先ポップオーバー（「親」ポップオーバーと呼びます）を持つことができるパスは2つあります。

  1. ポップオーバーはノードツリー内で相互にネストされています。この場合、子孫ポップオーバーが「子」であり、その最上位の祖先ポップオーバーが「親」です。

  2. 呼び出し要素（例：button）が、ポップオーバーを指す popovertarget 属性を持っています。この場合、ポップオーバーが「子」であり、呼び出し要素が含まれるポップオーバーサブツリーが「親」です。呼び出し元はポップオーバー内にあり、開いているポップオーバーを参照する必要があります。

上記で形成された各関係において、親ポップオーバーは、子ポップオーバーよりも表示中の自動ポップオーバーリスト内で厳密に前になければならず、そうでない場合は有効な祖先関係を形成しません。これにより、表示されていないポップオーバーや自己ポインター（例：包含ポップオーバーを指す呼び出し要素を含むポップオーバー）が排除され、（循環的な可能性がある）接続グラフから整形式のツリーを構築できます。Autoポップオーバーのみが考慮されます。

提供された要素が、ポップオーバーとして表示されていないdialogなどのトップレイヤー要素である場合、最上位のポップオーバー祖先は、最初のポップオーバーを見つけるためにノードツリーのみを検索します。

  1. isPopoverがtrueの場合:

    1. 確認: newPopoverOrTopLayerElementがHTML要素であること。

    2. 確認: newPopoverOrTopLayerElementの ポップオーバー属性が、 No Popover Stateや Manual状態ではないこと。

    3. 確認: newPopoverOrTopLayerElementの ポップオーバーの可視状態が、 表示中の状態ではないこと。

  2. それ以外の場合:

    1. 確認: invokerがnullであること。

  3. popoverPositionsを空の順序付きマップとして設定します。

  4. indexを0に設定します。

  5. popoverList の各 popover について：

    1. 設定 popoverPositions[popover]にindexを設定します。

    2. indexを1増やします。

  6. isPopoverがtrueの場合、設定 popoverPositions[newPopoverOrTopLayerElement]にindexを設定します。

  7. indexを1増やします。

  8. topmostPopoverAncestorをnullに設定します。

  9. checkAncestorを次の手順を実行するアルゴリズムとして設定します:

    1. candidate が null の場合、戻ります。

    2. okNesting を false とします。

    3. candidateAncestor を null とします。

    4. okNesting が false である間：

      1. candidateAncestor を、candidate を指定して最も近い包括的な開いているポップオーバーを実行した結果に設定します。

      2. candidateAncestor が null であるか、または popoverPositions に candidateAncestor が含まれていない場合、戻ります。

      3. アサート：candidateAncestor の popover 属性は、ManualまたはNone状態ではありません。

      4. newPopoverOrTopLayerElement の popover 属性がHint状態であるか、または candidateAncestor の popover 属性がAuto状態である場合、okNesting を true に設定します。

      5. okNesting が false の場合、candidate をフラットツリー内の candidateAncestor の親に設定します。

    5. candidatePosition を popoverPositions[candidateAncestor] とします。

    6. topmostPopoverAncestor が null であるか、または popoverPositions[topmostPopoverAncestor] が candidatePosition より小さい場合、topmostPopoverAncestor を candidateAncestor に設定します。

  10. newPopoverOrTopLayerElementの親ノードを指定してcheckAncestorを実行します。この親ノードはフラットツリー内に存在します。

  11. invokerを指定してcheckAncestorを実行します。

  12. topmostPopoverAncestorを返します。

与えられたノードnodeに対して、最も近い包括的な開いているポップオーバーを見つけるために、次の手順を実行します。これらの手順はHTML要素またはnullを返します。

  1. currentNode を node とします。

  2. currentNode が null でない間：

    1. currentNode の popover 属性がAuto状態であり、かつcurrentNode の ポップオーバーの可視性状態が表示中である場合、currentNode を返します。

    2. currentNode をフラットツリー内の currentNode の親に設定します。

  3. null を返します。

Document document を指定して最上位の自動またはヒントポップオーバーを見つけるには、次のステップを実行します。これらはHTML 要素または null を返します。

  1. document の表示中のヒントポップオーバーリストが空でない場合、document の表示中のヒントポップオーバーリストの最後の要素を返します。

  2. document の表示中の自動ポップオーバーリストが空でない場合、document の表示中の自動ポップオーバーリストの最後の要素を返します。

  3. null を返します。

HTML 要素 subject のポップオーバーフォーカスステップを実行するには：

  1. subject のノードドキュメントを指定してフォーカスを許可するステップを実行した結果が false の場合、戻ります。

  2. subject がdialog 要素の場合、subject を指定してダイアログフォーカスステップを実行して戻ります。

  3. subject が autofocus 属性を持つ場合、control を subject とします。

  4. それ以外の場合、control を、"other" を指定して subject のオートフォーカスデリゲートとします。

  5. control が null の場合、戻ります。

  6. control を指定してフォーカスステップを実行します。

  7. topDocument を control のノードナビゲブルのトップレベルトラバーサブルのアクティブドキュメントとします。

  8. control のノードドキュメントのオリジンが topDocument のオリジンと同じでない場合、戻ります。

  9. topDocument のオートフォーカス候補を空にします。

  10. topDocument のオートフォーカス処理済みフラグを true に設定します。

HTML 要素 element のポップオーバーの有効性を確認するには、ブール値 expectedToBeShowing、ブール値 throwExceptions、およびDocument または null expectedDocument を指定して、次のステップを実行します。これらは例外をスローするか、ブール値を返します。

  1. element の popover 属性がNo Popoverの場合：

    1. throwExceptions が true の場合、"NotSupportedError" DOMException をスローします。

    2. false を返します。

  2. 次のいずれかが true の場合：

    その場合は false を返します。

  3. 次のいずれかが true の場合：

    その場合は：

    1. throwExceptions が true の場合、"InvalidStateError" DOMException をスローします。

    2. false を返します。

  4. true を返します。

与えられたDocumentdocumentに対して、表示中の自動ポップオーバーリストを取得するために:

  1. popovers を « » とします。

  2. document の最上位レイヤー内の各Element element について反復処理を行います：

    1. 次のすべてが true の場合：

      その場合、element を popovers に追加します。

  3. popovers を返します。

Document document の表示中のヒントポップオーバーリストを取得するには：

  1. popovers を « » とします。

  2. document の最上位レイヤー内の各Element element について反復処理を行います：

    1. 次のすべてが true の場合：

      その場合、element を popovers に追加します。

  3. popovers を返します。

リスト popoverList、ブール値 focusPreviousElement、およびブール値 fireEvents を指定してポップオーバーリスト全体を閉じるには：

  1. popoverList が空でない間：

    1. popoverList の最後の項目、focusPreviousElement、fireEvents、および false を指定して、ポップオーバー非表示アルゴリズムを実行します。

6.12.1 ポップオーバーターゲット属性

ボタンには、次のコンテンツ属性があります:

指定された場合、popovertarget属性の値は、同じツリー内で、ポップオーバー属性を持つ要素のIDでなければなりません。

popovertargetaction属性は、次のキーワードと状態を持つ列挙型属性です:

キーワード 状態 簡潔な説明
toggle Toggle ターゲットとなるポップオーバー要素を表示または非表示にします。
show Show ターゲットとなるポップオーバー要素を表示します。
hide Hide ターゲットとなるポップオーバー要素を非表示にします。

この属性の省略時の値と無効な値のデフォルトは、どちらもToggle状態です。

可能な限り、ポップオーバー要素をDOM内でトリガーとなる要素の直後に配置することをお勧めします。これにより、スクリーンリーダーなどの支援技術を使用するユーザーに対して、論理的なプログラム読み取り順序でポップオーバーが公開されるのを確実にするのに役立ちます。

popovertarget属性とpopovertargetaction属性を組み合わせて、ポップオーバーを表示および閉じる方法を次に示します: 

<button popovertarget="foo" popovertargetaction="show">ポップオーバーを表示</button>

<article popover="auto" id="foo">これはポップオーバーの記事です！<button popovertarget="foo" popovertargetaction="hide">閉じる</button></article>

もしpopovertargetaction属性が指定されていない場合、デフォルトのアクションは関連するポップオーバーをトグルすることになります。次に示すのは、手動ポップオーバーを開閉状態にトグルするために、呼び出しボタンにpopovertarget属性だけを指定する方法です。手動ポップオーバーは、ライトディスミスや閉じるリクエストに反応しません:

<input type="button" popovertarget="foo" value="ポップオーバーをトグル">

<div popover=manual id="foo">これはポップオーバーです！</div>
DOMインターフェイス: 
インターフェイス mixin PopoverInvokerElement {
[CEReactions] 属性 Element? popoverTargetElement;
[CEReactions] 属性 DOMString popoverTargetAction;
};

HTMLButtonElement/popoverTargetElement

全ての現行エンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLInputElement/popoverTargetElement

全ての現行エンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

popoverTargetElementIDL属性は、popovertarget属性を反映する必要があります。

HTMLButtonElement/popoverTargetAction

全ての現行エンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLInputElement/popoverTargetAction

全ての現行エンジンでサポートされています。

Firefox🔰 114+Safari17+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

popoverTargetActionIDL属性は、popovertargetaction属性を反映する必要があります。

Node node と Node eventTarget を指定して、ポップオーバーターゲット属性アクティベーション動作を実行するには：

  1. popover を node の ポップオーバーターゲット要素とします。

  2. popover が null の場合、戻ります。

  3. eventTarget が popover のシャドウインクルーシブ包括的子孫であり、かつ popover が node のシャドウインクルーシブ子孫である場合、戻ります。

  4. node の popovertargetaction 属性が表示状態であり、かつ popover のポップオーバーの可視性状態が表示中である場合、戻ります。

  5. node の popovertargetaction 属性が非表示状態であり、かつ popover のポップオーバーの可視性状態が非表示である場合、戻ります。

  6. popover のポップオーバーの可視性状態が表示中である場合、popover、true、true、および false を指定してポップオーバー非表示アルゴリズムを実行します。

  7. それ以外の場合で、popover のポップオーバーの可視性状態が非表示であり、かつ popover、false、false、および null を指定してポップオーバーの有効性を確認した結果が true である場合、popover、false、および node を指定してポップオーバーを表示します。

ポップオーバーターゲット要素をNode nodeに対して取得するには、次の手順を実行する。それはHTML要素またはnullを返す。

  1. nodeがボタンでない場合、nullを返す。

  2. nodeが無効化されている場合、nullを返す。

  3. nodeがフォーム所有者を持ち、nodeが送信ボタンである場合、nullを返す。

  4. popoverElementをnodeのpopovertarget関連要素を取得の実行結果とする。

  5. popoverElementがnullの場合、nullを返す。

  6. popoverElementのpopover属性がNo Popover状態にある場合、nullを返す。

  7. popoverElementを返す。

6.12.2 ポップオーバーライトディスミス

「ライトディスミス」とは、popover属性が Auto状態にあるポップオーバーの外側をクリックすると、そのポップオーバーが閉じられることを意味します。これは、 クローズリクエストに対する反応に加えて行われます。

PointerEvent event を指定して、開いているポップオーバーをライトディスミスするには：

  1. アサート：event の isTrusted 属性は true です。

  2. target を event の ターゲットとします。

  3. document を target の ノードドキュメントとします。

  4. topmostPopover を、document を指定して最上位の自動ポップオーバーを実行した結果とします。

  5. topmostPopover が null の場合、戻ります。

  6. event の type が "pointerdown" の場合：document の ポップオーバーポインターダウンターゲットを、target を指定して最上位のクリックされたポップオーバーを実行した結果に設定します。

  7. event の type が "pointerup" の場合：

    1. ancestor を、target を指定して最上位のクリックされたポップオーバーを実行した結果とします。

    2. ancestor が document のポップオーバーポインターダウンターゲットである場合、sameTarget を true とします。

    3. document のポップオーバーポインターダウンターゲットを null に設定します。

    4. ancestor が null の場合、ancestor を document に設定します。

    5. sameTarget が true の場合、ancestor、false、および true を指定して指定された要素まですべてのポップオーバーを非表示にするを実行します。

最も上にあるクリックされたポップオーバーを、次の手順に従ってノード nodeを引数として取得します。

  1. clickedPopover を、node を指定して最も近い包括的な開いているポップオーバーを実行した結果とします。

  2. invokerPopover を、node を指定してインボーカーの最も近い包括的なターゲットポップオーバーを実行した結果とします。

  3. clickedPopover を指定してポップオーバースタックの位置を取得する結果が、invokerPopover を指定してポップオーバースタックの位置を取得する結果よりも大きい場合、clickedPopover を返します。

  4. invokerPopover を返します。

HTML 要素 popover を指定して、ポップオーバースタックの位置を取得するには：

  1. hintList を popover のノードドキュメントの表示中のヒントポップオーバーリストとします。

  2. autoList を popover のノードドキュメントの表示中の自動ポップオーバーリストとします。

  3. popover が hintList にある場合、hintList 内の popover のインデックス + autoList のサイズ + 1 を返します。

  4. popover が autoList にある場合、autoList 内の popover のインデックス + 1 を返します。

  5. 0 を返します。

インボーカー用の最も近い包括的なターゲットポップオーバーを、次の手順に従って取得します。引数としてノード nodeが与えられます。

  1. currentNodeをnodeとします。

  2. currentNodeがnullでない間、次を実行します：

    1. targetPopoverをcurrentNodeのポップオーバーターゲット要素とします。

    2. targetPopoverがnullでなく、targetPopoverのpopover属性がAuto状態にあり、targetPopoverのポップオーバー可視性状態が表示である場合、targetPopoverを返します。

    3. currentNodeをcurrentNodeのフラットツリー内の祖先に設定します。

7 ウェブページの読み込み

このセクションでは、主にウェブブラウザーに直接適用される機能について説明します。ただし、特に指定がない限り、このセクションで定義された要件は、ウェブブラウザーに限らずすべてのユーザーエージェントに適用されます。

7.1 サポートする概念

7.1.1 オリジン

オリジンはウェブのセキュリティモデルの基本的な通貨です。同じオリジンを共有するウェブプラットフォーム上の二つのアクターは、互いに信頼し、同じ権限を持っていると見なされます。異なるオリジンを持つアクターは互いに潜在的に敵対的であると見なされ、さまざまな程度で隔離されます。

例えば、bank.example.comでホストされているExample Bankのウェブサイトが、charity.example.orgでホストされているExample CharityのウェブサイトのDOMを調べようとすると、"SecurityError"が発生し、DOMExceptionが発生します。

オリジンは次のいずれかです：

不透明なオリジン

内部値であり、再作成できるシリアル化がなく、オリジンのシリアル化に基づいて"null"としてシリアル化されます。そのため、意味のある操作は等価性のテストのみです。

タプルオリジン

以下で構成されるタプル：

オリジンは、複数のDocumentオブジェクト間で共有されることがあります。さらに、オリジンは通常不変です。ドメインだけがタプルオリジンを通じて変更でき、document.domainAPIを通じてのみ変更できます。

実効ドメインは、オリジン originを次のように計算します：

  1. originが不透明なオリジンの場合、nullを返します。

  2. originのドメインがnullでない場合、originのドメインを返します。

  3. originのホストを返します。

オリジンのシリアル化は、次のアルゴリズムを適用して得られる文字列です：

  1. originが不透明なオリジンの場合、"null"を返します。

  2. それ以外の場合、resultをoriginのスキームに設定します。

  3. resultに"://"を追加します。

  4. originのホストをresultに追加します。シリアライズされたものを追加します。

  5. originのポートがnullでない場合、U+003Aコロン文字（:）とoriginのポートをresultに追加します。シリアライズされたものを追加します。

  6. resultを返します。

シリアル化された("https", "xn--maraa-rta.example", null, null)は"https://xn--maraa-rta.example"です。

かつてはオリジンのUnicodeシリアル化もありましたが、広く採用されることはありませんでした。

二つのオリジン、AとBが同一オリジンであると言われるのは、次のアルゴリズムがtrueを返す場合です：

  1. AとBが同じ不透明なオリジンである場合、trueを返します。

  2. AとBがどちらもタプルオリジンであり、それらのスキーム、ホスト、およびポートが同一である場合、trueを返します。

  3. falseを返します。

二つのオリジン、AとBが同一オリジンドメインであると言われるのは、次のアルゴリズムがtrueを返す場合です：

  1. AとBが同じ不透明なオリジンである場合、trueを返します。

  2. AとBがどちらもタプルオリジンの場合：

    1. AとBのスキームが同一であり、それらのドメインが同一であり、かつnullでない場合、trueを返します。

    2. それ以外の場合、AとBが同一オリジンであり、かつそれらのドメインが共にnullである場合、trueを返します。

  3. falseを返します。

A B 同一オリジン 同一オリジンドメイン
("https", "example.org", null, null) ("https", "example.org", null, null) ✅ ✅
("https", "example.org", 314, null) ("https", "example.org", 420, null) ❌ ❌
("https", "example.org", 314, "example.org") ("https", "example.org", 420, "example.org") ❌ ✅
("https", "example.org", null, null) ("https", "example.org", null, "example.org") ✅ ❌
("https", "example.org", null, "example.org") ("http", "example.org", null, "example.org") ❌ ❌
7.1.1.1 サイト

スキームとホストとは、タプルの一つで、スキーム（ASCII文字列）とホスト（ホスト）から構成されます。

サイトとは、不透明なオリジンまたはスキームとホストのことです。

サイトを取得するには、オリジンoriginが与えられたとき、次の手順を実行します：

  1. originが不透明なオリジンである場合、originを返します。

  2. originのホストの登録可能ドメインがnullである場合、(originのスキーム, originのホスト)を返します。

  3. (originのスキーム, originのホストの登録可能ドメイン)を返します。

二つのサイト、AとBが同一サイトであると言われるのは、次のアルゴリズムがtrueを返す場合です：

  1. AとBが同じ不透明なオリジンである場合、trueを返します。

  2. AまたはBが不透明なオリジンである場合、falseを返します。

  3. AとBのスキームが異なる場合、falseを返します。

  4. AとBのホストが等しくない場合、falseを返します。

  5. trueを返します。

サイトのシリアル化は、次のアルゴリズムを適用して得られる文字列です：

  1. siteが不透明なオリジンである場合、"null"を返します。

  2. resultをsite[0]に設定します。

  3. resultに"://"を追加します。

  4. site[1]をシリアライズされたものとしてresultに追加します。

  5. resultを返します。

シリアル化された値がサイトであることを文脈から明確にする必要があります。例えば、オリジン("https", "shop.example", null, null)とサイト("https", "shop.example")は、同じシリアル化を持つ可能性があります："https://shop.example"。

二つのオリジン、AとBがスキームなしで同一サイトであると言われるのは、次のアルゴリズムがtrueを返す場合です：

  1. AとBが同じ不透明なオリジンである場合、trueを返します。

  2. AとBが両方ともタプルオリジンである場合：

    1. hostAをAのホストとし、hostBをBのホストとします。

    2. hostAがhostBと等しく、hostAの登録可能ドメインがnullである場合、trueを返します。

    3. hostAの登録可能ドメインがhostBの登録可能ドメインと等しく、かつnullでない場合、trueを返します。

  3. falseを返します。

二つのオリジン、AとBが同一サイトであると言われるのは、次のアルゴリズムがtrueを返す場合です：

  1. siteAをAを使ってサイトを取得した結果とします。

  2. siteBをBを使ってサイトを取得した結果とします。

  3. siteAがsiteBと同一サイトである場合、trueを返します。

  4. falseを返します。

同一オリジンおよび同一オリジンドメインの概念とは異なり、スキームなしで同一サイトおよび同一サイトでは、ポートとドメインの要素は無視されます。

URLで説明されている理由により、同一サイトおよびスキームなしで同一サイトの概念は、可能な限り避け、代わりに同一オリジンのチェックを使用することを推奨します。

wildlife.museum、museum、およびcomがパブリックサフィックスであり、example.comがそうでないことを前提とします：

A B スキームなしで同一サイト 同一サイト
("https", "example.com") ("https", "sub.example.com") ✅ ✅
("https", "example.com") ("https", "sub.other.example.com") ✅ ✅
("https", "example.com") ("http", "non-secure.example.com") ✅ ❌
("https", "r.wildlife.museum") ("https", "sub.r.wildlife.museum") ✅ ✅
("https", "r.wildlife.museum") ("https", "sub.other.r.wildlife.museum") ✅ ✅
("https", "r.wildlife.museum") ("https", "other.wildlife.museum") ❌ ❌
("https", "r.wildlife.museum") ("https", "wildlife.museum") ❌ ❌
("https", "wildlife.museum") ("https", "wildlife.museum") ✅ ✅
("https", "example.com") ("https", "example.com.") ❌ ❌

(ここでは、ポートとドメインの要素は考慮されないため、省略されています。)

7.1.1.2 同一オリジン制約の緩和
document.domain [ = domain ]

セキュリティチェックに使用される現在のドメインを返します。

サブドメインを削除する値に設定して、オリジンのドメインを変更し、同じドメインの他のサブドメインのページが互いにアクセスできるようにすることができます（同じことをする場合）。これにより、同じドメインの異なるホスト上のページが、互いのDOMに同期的にアクセスできるようになります。

サンドボックス化されたiframe、不透明なオリジンを持つDocument、およびブラウジングコンテキストを持たないDocumentでは、セッターが"SecurityError"例外をスローします。また、crossOriginIsolatedまたはoriginAgentClusterがtrueを返す場合、セッターは何もしません。

document.domainセッターの使用は避けてください。これは同一オリジンポリシーが提供するセキュリティ保護を損なうものです。特に、共有ホスティングを使用している場合には重大です。例えば、信頼できない第三者が同じIPアドレスで異なるポートにHTTPサーバーをホストできる場合、document.domainセッターが使用された後にオリジンを比較するときにポートが無視されるため、通常は同じホスト上の異なるサイトを保護する同一オリジン保護が機能しなくなります。

これらのセキュリティリスクのため、この機能はウェブプラットフォームから削除されつつあります。（これは何年もかかる長いプロセスです。）

代わりに、postMessage()やMessageChannelオブジェクトを使用して、安全にオリジン間の通信を行ってください。

domainゲッターの手順は次の通りです：

  1. effectiveDomainをthisのオリジンの実効ドメインとします。

  2. effectiveDomainがnullである場合、空の文字列を返します。

  3. effectiveDomainをシリアライズして返します。

domainセッターの手順は次の通りです：

  1. thisのブラウジングコンテキストがnullである場合、"SecurityError" DOMExceptionをスローします。

  2. thisのアクティブなサンドボックスフラグセットにサンドボックス化されたdocument.domainブラウジングコンテキストフラグが設定されている場合、"SecurityError" DOMExceptionをスローします。

  3. effectiveDomainをthisのオリジンの実効ドメインとします。

  4. effectiveDomainがnullである場合、"SecurityError" DOMExceptionをスローします。

  5. 与えられた値がeffectiveDomainの登録可能なドメイン接尾辞でないか、等しくない場合、"SecurityError" DOMExceptionをスローします。

  6. 周囲のエージェントのエージェントクラスタのオリジンキー設定が trueである場合、何もしません。

  7. this の オリジンの ドメインを、指定された値を解析した結果に設定します。

スカラー値文字列 hostSuffixStringが、ホスト originalHostの登録可能なドメイン接尾辞であるか、等しいかどうかを判断するために：

  1. hostSuffixStringが空文字列の場合、falseを返します。

  2. hostSuffixをhostSuffixStringを解析した結果とします。

  3. hostSuffixが失敗した場合、falseを返します。

  4. hostSuffixがoriginalHostと等しくない場合：

    1. hostSuffixまたはoriginalHostがドメインでない場合、falseを返します。

      これは、ホストがIPアドレスであるものを除外します。

    2. hostSuffixがU+002E (.)で始まり、originalHostの末尾と一致しない場合、falseを返します。

    3. 以下のいずれかがtrueである場合：

      falseを返します。[URL]

    4. アサート：originalHostのパブリックサフィックスがU+002E (.)で始まり、hostSuffixの末尾と一致します。

  5. trueを返します。

hostSuffixString originalHost 登録可能なドメイン接尾辞であるか、等しいかの結果 メモ
"0.0.0.0" 0.0.0.0 ✅
"0x10203" 0.1.2.3 ✅
"[0::1]" ::1 ✅
"example.com" example.com ✅
"example.com" example.com. ❌ 末尾のドットは重要です。
"example.com." example.com ❌
"example.com" www.example.com ✅
"com" example.com ❌ 執筆時点では、comはパブリックサフィックスです。
"example" example ✅
"compute.amazonaws.com" example.compute.amazonaws.com ❌ 執筆時点では、*.compute.amazonaws.comはパブリックサフィックスです。
"example.compute.amazonaws.com" www.example.compute.amazonaws.com ❌
"amazonaws.com" www.example.compute.amazonaws.com ❌
"amazonaws.com" test.amazonaws.com ✅ 執筆時点では、amazonaws.comは登録可能なドメインです。

7.1.2 オリジンキー付きエージェントクラスタ

window.originAgentCluster

このWindowが、オリジンキー付きのエージェントクラスタに属している場合にtrueを返します。このセクションで説明されている方法に従います。

セキュアなコンテキストで提供されるDocumentは、`Origin-Agent-Cluster` HTTPレスポンスヘッダーを使用して、オリジンキー付きのエージェントクラスタに配置するよう要求できます。このヘッダーは構造化されたヘッダーであり、その値はブール値でなければなりません。[STRUCTURED-FIELDS]

新しいDocumentオブジェクトを作成し初期化する処理モデルに従って、構造化されたヘッダーブール値のtrue値（つまり、`?1`）以外の値は無視されます。

このヘッダーを使用する結果として、生成されたDocumentのオリジンがエージェントクラスタキーとして設定され、対応するサイトではなくなります。観察可能な効果としては、document.domainを使用して同一オリジン制約を緩和することを試みても何も起こらず、同一サイトであってもクロスオリジンのDocumentにWebAssembly.Moduleオブジェクトを送信することはできません。この隔離により、ユーザーエージェントがプロセスやスレッドなど、エージェントクラスタに対応する実装固有のリソースをより効率的に割り当てることができる場合があります。

ブラウジングコンテキストグループ内では、`Origin-Agent-Cluster`ヘッダーを使用しても、同一オリジンのDocumentオブジェクトが異なるエージェントクラスタに入ることはありません。一方がヘッダーを送信し、他方が送信しなかったとしても、これは防止されます。歴史的エージェントクラスタキーのマップによって防止されます。

これは、以前に同一オリジンページでヘッダーが省略された場合、ヘッダーが設定されていても、originAgentClusterゲッターがfalseを返すことがあることを意味します。同様に、ヘッダーが設定されていなくてもtrueを返すことができます。

originAgentClusterゲッターの手順は、周囲のエージェントのエージェントクラスタがオリジンキー付きであるかを返すことです。

不透明なオリジンを持つDocumentは、無条件にオリジンキー付きと見なされます。これらのドキュメントに対してヘッダーは効果がなく、originAgentClusterゲッターは常にtrueを返します。

同様に、エージェントクラスタのクロスオリジン隔離モードが"none"でないDocumentも自動的にオリジンキー付きとなります。`Origin-Agent-Cluster`ヘッダーは、リソース割り当てに関する追加のヒントとして実装に有用な場合がありますが、`Cross-Origin-Opener-Policy`および`Cross-Origin-Embedder-Policy`ヘッダーを使用してクロスオリジン隔離を実現する場合、同じアドレス空間内のすべてがそこに参加することを保証するためのものであり、それを追加しても著者コードには追加の観察可能な効果はありません。

7.1.3 クロスオリジンオープナーポリシー

クロスオリジンオープナーポリシーの値により、トップレベルのブラウジングコンテキストでナビゲートされるドキュメントが、新しいトップレベルのブラウジングコンテキストと対応するグループを作成するよう強制することができます。可能な値は以下の通りです：

"unsafe-none"

これは現在のデフォルトであり、ドキュメントは前のドキュメントと同じトップレベルのブラウジングコンテキストを占有します。ただし、そのドキュメントが異なるクロスオリジンオープナーポリシーを指定していない限り。

"same-origin-allow-popups"

これにより、ドキュメントに対して新しいトップレベルのブラウジングコンテキストの作成が強制されます。ただし、前のドキュメントが同じクロスオリジンオープナーポリシーを指定しており、それらが同一オリジンである場合を除きます。

"same-origin"

これは"same-origin-allow-popups"と同じ動作をしますが、追加で、作成される補助的なブラウジングコンテキストが、同じ同一オリジンのドキュメントを含み、かつ同じクロスオリジンオープナーポリシーを持つ必要があります。そうでない場合、オープナーに閉じた状態として表示されます。

"same-origin-plus-COEP"

これは"same-origin"と同じ動作をしますが、新しいトップレベルのブラウジングコンテキストのグループのクロスオリジン隔離モードを"logical"または"concrete"のいずれかに設定します。

"same-origin-plus-COEP"は、`Cross-Origin-Opener-Policy`ヘッダーで直接設定することはできませんが、`Cross-Origin-Opener-Policy: same-origin`と、Cross-Origin-Embedder-Policy`ヘッダーを一緒に設定した結果として生じます。`クロスオリジン隔離と互換性がある`値が必要です。

"noopener-allow-popups"

これは、先行するコンテキストに関係なく、ドキュメントの新しいトップレベルブラウジングコンテキストの作成を強制します。

noopener-allow-popups 値を含めると、それが適用されるドキュメントとそのオープナー間のオープナー関係は切断されますが、それらの同一オリジンドキュメント間に堅牢なセキュリティ境界は作成されません。

同一オリジンアプリケーションからのその他のリスクは次のとおりです。

  • ドキュメントのコンテンツを取得する同一オリジンリクエスト — フェッチメタデータフィルタリングによって軽減できます。[FETCHMETADATA]

  • 同一オリジンフレーミング - X-Frame-Options または CSP frame-ancestors によって軽減できます。

  • JavaScript でアクセス可能な Cookie - すべての Cookie が httponly であることを確認することで軽減できます。

  • 機密データへの localStorage アクセス。

  • Service Worker のインストール。

  • Cache API の操作または機密データへのアクセス。[SW]

  • 機密情報を公開する postMessage または BroadcastChannel メッセージング。

  • 同一オリジンドキュメントに対してユーザー操作を必要としない可能性のある自動入力。

noopener-allow-popups を使用する開発者は、機密性の高いアプリケーションが、localStorage やその他のクライアント側ストレージ API、BroadcastChannel および関連する同一オリジン通信メカニズムなど、他の同一オリジンドキュメントからアクセス可能なクライアント側機能に依存していないことを確認する必要があります。また、サーバー側のエンドポイントが、応答コンテンツが同一オリジンドキュメントからアクセス可能な非ナビゲーションリクエストに機密データを返さないようにする必要もあります。

クロスオリジンオープナーポリシーは以下で構成されます：

オープナーポリシー値 documentCOOP、オリジン documentOrigin、オープナーポリシー値 responseCOOP、およびオリジン responseOrigin を指定して、オープナーポリシー値を照合するには：

  1. documentCOOP が "unsafe-none" であり、かつ responseCOOP が "unsafe-none" である場合、true を返します。

  2. documentCOOP が "unsafe-none" であるか、または responseCOOP が "unsafe-none" である場合、false を返します。

  3. documentCOOP が responseCOOP であり、かつ documentOrigin が responseOrigin と同一オリジンである場合、true を返します。

  4. false を返します。

7.1.3.1 ヘッダー

Headers/Cross-Origin-Opener-Policy

すべての現行エンジンでサポートされています。

Firefox79+Safari15.2+Chrome83+
OperaいいえEdge83+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView AndroidいいえSamsung Internet?Opera Androidいいえ

Documentのオープナーポリシーは、`Cross-Origin-Opener-Policy` および `Cross-Origin-Opener-Policy-Report-Only` HTTPレスポンスヘッダーから派生します。これらのヘッダーは構造化されたヘッダーであり、その値はトークンでなければなりません。[STRUCTURED-FIELDS]

有効なトークンの値は、オープナーポリシーの値です。また、トークンにはパラメーターが付与される場合もあります。これらの中で、"report-to"パラメーターには、適切なレポートエンドポイントを指定する有効なURL文字列が含まれることがあります。[REPORTING]

以下に説明する処理モデルに従い、ユーザーエージェントはこのヘッダーが無効な値を含む場合、このヘッダーを無視します。同様に、値がトークンとして解析できない場合、ユーザーエージェントはこのヘッダーを無視します。

クロスオリジンオープナーポリシーを取得するには、レスポンス responseと環境 reservedEnvironmentを指定します：

  1. policyを新しいクロスオリジンオープナーポリシーとして設定します。

  2. reservedEnvironmentが非セキュアなコンテキストである場合、policyを返します。

  3. parsedItemを、responseのヘッダーリストから`Cross-Origin-Opener-Policy`および"item"を指定して構造化されたフィールド値を取得する結果として設定します。

  4. parsedItemがnullでない場合、次の処理を行います：

    1. parsedItem[0]が"same-origin"である場合、次の処理を行います：

      1. coepをresponseおよびreservedEnvironmentからクロスオリジンエンベッダーポリシーを取得する結果として設定します。

      2. coepの値がクロスオリジン隔離と互換性がある場合、policyの値を"same-origin-plus-COEP"に設定します。

      3. それ以外の場合は、policyの値を"same-origin"に設定します。

    2. parsedItem[0]が"same-origin-allow-popups"である場合、policyの値を"same-origin-allow-popups"に設定します。

    3. parsedItem[0] が "noopener-allow-popups" の場合、policy の 値を "noopener-allow-popups" に設定します。

    4. parsedItem[1]["report-to"]が存在し、それが文字列である場合、policyのレポートエンドポイントをparsedItem[1]["report-to"]に設定します。

  5. parsedItemを、responseのヘッダーリストから`Cross-Origin-Opener-Policy-Report-Only`および"item"を指定して構造化されたフィールド値を取得する結果として設定します。

  6. parsedItemがnullでない場合、次の処理を行います：

    1. parsedItem[0]が"same-origin"である場合、次の処理を行います：

      1. coepをresponseおよびreservedEnvironmentからクロスオリジンエンベッダーポリシーを取得する結果として設定します。

      2. coepの値がクロスオリジン隔離と互換性があるまたはcoepのレポートオンリーの値がクロスオリジン隔離と互換性がある場合、policyのレポートオンリーの値を"same-origin-plus-COEP"に設定します。

        レポートオンリーのCOOPは、特別な"same-origin-plus-COEP"値を割り当てるために、レポートオンリーのCOEPも考慮します。これにより、開発者はCOOPとCOEPの展開順序により柔軟性を持つことができます。

      3. それ以外の場合は、policyのレポートオンリーの値を"same-origin"に設定します。

    2. parsedItem[0]が"same-origin-allow-popups"である場合、policyのレポートオンリーの値を"same-origin-allow-popups"に設定します。

    3. parsedItem[1]["report-to"]が存在し、それが文字列である場合、policyのレポートオンリーのレポートエンドポイントをparsedItem[1]["report-to"]に設定します。

  7. policyを返します。

7.1.3.2 クロスオリジンオープナーポリシーによるブラウジングコンテキストグループの切り替え

2つのオリジン responseOrigin および activeDocumentNavigationOrigin、そして2つのオープナーポリシー値 responseCOOPValue および activeDocumentCOOPValue を指定して、ポップアップCOOP値がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認するには：

  1. responseCOOPValue が "noopener-allow-popups" の場合、true を返します。

  2. 次のすべてが true の場合：

    その場合は false を返します。

  3. activeDocumentCOOPValue、activeDocumentNavigationOrigin、responseCOOPValue、および responseOrigin を照合した結果が true の場合、false を返します。

  4. true を返します。

ブール値 isInitialAboutBlank、2つのオリジン responseOrigin および activeDocumentNavigationOrigin、そして2つのオープナーポリシー値 responseCOOPValue および activeDocumentCOOPValue を指定して、COOP値がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認するには：

  1. isInitialAboutBlank が true の場合、responseOrigin、activeDocumentNavigationOrigin、responseCOOPValue、および activeDocumentCOOPValue を使用してポップアップCOOP値がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認した結果を返します。

  2. ここでは、ポップアップ以外のナビゲーションを扱っています。

    activeDocumentCOOPValue、activeDocumentNavigationOrigin、responseCOOPValue、および responseOrigin を照合した結果が true の場合、false を返します。

  3. true を返します。

ブール値 isInitialAboutBlank、2つのオリジン responseOrigin、activeDocumentNavigationOrigin、および2つのオープナーポリシー responseCOOP および activeDocumentCOOP を指定して、レポート専用COOPの強制がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認するには：

  1. isInitialAboutBlank、responseOrigin、activeDocumentNavigationOrigin、responseCOOP の レポート専用値、および activeDocumentCOOPReportOnly の レポート専用値を指定してCOOP値がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認した結果が false の場合、false を返します。

    レポート専用ポリシーを照合すると、ウェブサイトはすべてのページで同じレポート専用オープナーポリシーを指定でき、これらのページ間のナビゲーションで違反レポートを受信しなくなります。

  2. isInitialAboutBlank、responseOrigin、activeDocumentNavigationOrigin、responseCOOP の 値、および activeDocumentCOOPReportOnly の レポート専用値を指定してCOOP値がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認した結果が true の場合、true を返します。

  3. isInitialAboutBlank、responseOrigin、activeDocumentNavigationOrigin、responseCOOP の レポート専用値、および activeDocumentCOOPReportOnly の 値を指定してCOOP値がブラウジングコンテキストグループの切り替えを必要とするかどうかを確認した結果が true の場合、true を返します。

  4. false を返します。

クロスオリジンオープナーポリシーの施行結果は、次の構造体の項目を持つ構造体です：

レスポンスのクロスオリジンオープナーポリシーを適用するには、以下を実行します： ブラウジングコンテキスト browsingContext、 URL responseURL、 オリジン responseOrigin、 クロスオリジンオープナーポリシー responseCOOP、 クロスオリジンオープナーポリシーの適用結果 currentCOOPEnforcementResult、 リファラー referrer:

  1. newCOOPEnforcementResultを新しいクロスオリジンオープナーポリシー施行結果として作成し、次の属性を持たせます：

    ブラウジングコンテキストグループの切り替えが必要
    currentCOOPEnforcementResultのブラウジングコンテキストグループの切り替えが必要
    レポートオンリーによるブラウジングコンテキストグループの切り替えが必要
    currentCOOPEnforcementResultのレポートオンリーによるブラウジングコンテキストグループの切り替えが必要
    URL
    responseURL
    オリジン
    responseOrigin
    クロスオリジンオープナーポリシー
    responseCOOP
    現在のコンテキストがナビゲーションソース
    true

  2. isInitialAboutBlankをbrowsingContextのアクティブドキュメントの初期about:blankかどうかに設定します。

  3. isInitialAboutBlankがtrueであり、browsingContextの初期URLがnullの場合、browsingContextの初期URLをresponseURLに設定します。

  4. COOP値がブラウジングコンテキストグループの切り替えを必要とするかを確認するの結果、isInitialAboutBlank、currentCOOPEnforcementResultのクロスオリジンオープナーポリシーの値、currentCOOPEnforcementResultのオリジン、responseCOOPの値、およびresponseOriginがtrueの場合、次を実行します：

    1. newCOOPEnforcementResultのブラウジングコンテキストグループの切り替えが必要をtrueに設定します。

    2. browsingContextのグループのブラウジングコンテキストセットのサイズが1より大きい場合、次を実行します：

      1. COOPレスポンスへのナビゲーション時のブラウジングコンテキストグループ切り替え違反レポートをキューに追加する responseCOOP、"施行"、responseURL、currentCOOPEnforcementResultのURL、currentCOOPEnforcementResultのオリジン、responseOrigin、およびreferrerを使用して。

      2. COOPレスポンスからのナビゲーション時のブラウジングコンテキストグループ切り替え違反レポートをキューに追加する currentCOOPEnforcementResultのクロスオリジンオープナーポリシー、"施行"、currentCOOPEnforcementResultのURL、responseURL、currentCOOPEnforcementResultのオリジン、responseOrigin、およびcurrentCOOPEnforcementResultの現在のコンテキストがナビゲーションソースを使用して。

  5. レポートオンリーCOOPを施行するとブラウジングコンテキストグループの切り替えが必要かどうかを確認するの結果、isInitialAboutBlank、responseOrigin、currentCOOPEnforcementResultのオリジン、responseCOOP、およびcurrentCOOPEnforcementResultのクロスオリジンオープナーポリシーがtrueの場合、次を実行します：

    1. newCOOPEnforcementResult の レポート専用のためブラウジングコンテキストグループの切り替えが必要になる を true に設定します。

    2. もしbrowsingContextのグループのブラウジングコンテキストセットのサイズが1より大きい場合、次の操作を実行します:

      1. COOPレスポンスへのナビゲーション時のブラウジングコンテキストグループ切り替え違反レポートをキューに追加する responseCOOP、"報告"、responseURL、currentCOOPEnforcementResultのURL、currentCOOPEnforcementResultのオリジン、responseOrigin、およびreferrerを使用して。

      2. COOPレスポンスからのナビゲーション時のブラウジングコンテキストグループ切り替え違反レポートをキューに追加する currentCOOPEnforcementResultのクロスオリジンオープナーポリシー、"報告"、currentCOOPEnforcementResultのURL、responseURL、currentCOOPEnforcementResultのオリジン、responseOrigin、およびcurrentCOOPEnforcementResultの現在のコンテキストがナビゲーションソースを使用して。

  6. それ以外の場合、newCOOPEnforcementResultを返します。

ナビゲーションパラメータ navigationParams を指定して、ナビゲーション応答に使用するブラウジングコンテキストを取得するには：

  1. browsingContext を navigationParams の ナビゲブルの アクティブなブラウジングコンテキストとする。

  2. browsingContext がトップレベルブラウジングコンテキストでない場合、browsingContext を返す。

  3. coopEnforcementResult を navigationParams の COOP 強制結果とする。

  4. swapGroup を coopEnforcementResult の ブラウジングコンテキストグループの切り替えが必要とする。

  5. sourceOrigin を browsingContext の アクティブドキュメントの オリジンとする。

  6. destinationOrigin を navigationParams の オリジンとする。

  7. sourceOrigin が destinationOrigin と同一サイトでない場合：

    1. sourceOrigin または destinationOrigin のいずれかがHTTP(S) スキームではないスキームを持ち、かつユーザーエージェントが sourceOrigin と destinationOrigin を互いに分離する必要があると見なす場合（実装定義の理由により）、オプションで swapGroup を true に設定する。

      たとえば、ユーザーが about:settings から https://example.com にナビゲートする場合、ユーザーエージェントはスワップを強制する可能性があります。

      課題 #10842 は、これをオプションにするのではなく、ここで相互運用可能な動作を決定することを追跡しています。

    2. navigationParams の ユーザー関与が "browser UI" の場合、オプションで swapGroup を true に設定する。

      課題 #6356 は、これをオプションにするのではなく、ここで相互運用可能な動作を決定することを追跡しています。

  8. browsingContext の グループの ブラウジングコンテキストセットの サイズが 1 の場合、オプションで swapGroup を true に設定する。

    一部の実装では、パフォーマンス上の理由からここでブラウジングコンテキストグループをスワップします。

    これをスクリプト化できる他のコンテキストのチェックは、Web ページに影響を与える可能性のある動作の違いを防ぐのに十分ではありません。現在他のコンテキストがない場合でも、宛先ページがウィンドウを開き、ユーザーが戻るナビゲーションを行うと、前のページが開かれたウィンドウをスクリプト化できると期待する可能性があります。ここでスワップを行うと、そのユースケースが壊れます。

  9. swapGroup が false の場合：

    1. coopEnforcementResult の レポート専用のためブラウジングコンテキストグループの切り替えが必要になるが true の場合、browsingContext の 仮想ブラウジングコンテキストグループ ID を新しい一意の識別子に設定する。

    2. browsingContext を返す。

  10. newBrowsingContext を 新しいトップレベルブラウジングコンテキストとドキュメントの作成の最初の戻り値とする。

    この場合、ブラウジングコンテキストグループのスワップを実行します。 browsingContext は、これから作成する新しい Document では使用されません。 他の Document（戻る/進むキャッシュ内のものなど）でも使用されない場合、ユーザーエージェントはこの時点でそれを破棄する可能性があります。

  11. navigationCOOP を navigationParams の クロスオリジンオープナーポリシーとする。

  12. navigationCOOP の 値が "same-origin-plus-COEP" の場合、newBrowsingContext の グループの クロスオリジン分離モードを "logical" または "concrete" のいずれかに設定する。 どちらを選択するかは 実装定義です。

    一部のプラットフォームでは、クロスオリジン分離機能に必要なセキュリティプロパティを提供することが困難です。 "concrete" はそれにアクセスを許可し、"logical" は許可しません。

  13. sandboxFlags を クローンの navigationParams の 最終サンドボックス化フラグセットとする。

  14. sandboxFlags が空でない場合：

    1. アサート：navigationCOOP の 値は "unsafe-none" である。

    2. アサート： newBrowsingContext の ポップアップサンドボックス化フラグセットは空である。

    3. newBrowsingContext の ポップアップサンドボックス化フラグセットを sandboxFlags に設定する。

  15. newBrowsingContext を返す。

7.1.3.3 レポート

アクセサーとアクセス先の関係は、アクセスが発生した2つのブラウジングコンテキスト間の関係を説明する列挙型です。次の値を取ることができます：

アクセサーがオープナー

アクセサーのブラウジングコンテキストまたはそのいずれかの祖先が、アクセス先のオープナーブラウジングコンテキストの最上位ブラウジングコンテキストである場合。

アクセサーがオープンされた側

アクセス先のブラウジングコンテキストまたはそのいずれかの祖先が、アクセサーのオープナーブラウジングコンテキストの最上位ブラウジングコンテキストである場合。

なし

アクセサーのブラウジングコンテキストと、アクセス先のブラウジングコンテキストの間にオープナー関係がない場合。

2つのブラウジングコンテキスト間のアクセスが報告されるべきかを確認するために、2つのブラウジングコンテキスト accessor および accessed、JavaScriptプロパティ名P、および環境設定オブジェクト environmentが与えられたとします：

  1. P が クロスオリジンでアクセス可能なウィンドウプロパティ名でない場合、処理を終了します。

  2. 断言します：accessor のアクティブなドキュメントとaccessed のアクティブなドキュメントが両方とも完全にアクティブであることを。

  3. accessorTopDocument を、accessor の最上位ブラウジングコンテキストのアクティブなドキュメントとします。

  4. accessorInclusiveAncestorOrigins を、accessor のアクティブなドキュメントの各包括的祖先ナビゲーブルの起源を取得して得られたリストとします。

  5. accessedTopDocument を、accessed の最上位ブラウジングコンテキストのアクティブなドキュメントとします。

  6. accessedInclusiveAncestorOrigins を、accessed のアクティブなドキュメントの各包括的祖先ナビゲーブルの起源を取得して得られたリストとします。

  7. いずれかのaccessorInclusiveAncestorOriginsが、accessorTopDocumentの起源と同じ起源でない場合、または、いずれかのaccessedInclusiveAncestorOriginsがaccessedTopDocumentの起源と同じ起源でない場合、処理を終了します。

    これにより、クロスオリジンのインラインフレームに関する情報が、クロスオリジンオープナーポリシーレポートを持つ最上位フレームに漏れるのを防ぎます。

  8. accessor の最上位ブラウジングコンテキストの仮想ブラウジングコンテキストグループIDが、accessed の最上位ブラウジングコンテキストの仮想ブラウジングコンテキストグループIDと一致する場合、処理を終了します。

  9. accessorAccessedRelationship を新しいアクセサーとアクセス先の関係として、値をなしとします。

  10. もし、accessed の最上位ブラウジングコンテキストのオープナーブラウジングコンテキストがaccessorであるか、accessorの祖先である場合、accessorAccessedRelationshipをアクセサーがオープナーに設定します。

  11. もし、accessor の最上位ブラウジングコンテキストのオープナーブラウジングコンテキストがaccessedであるか、accessedの祖先である場合、accessorAccessedRelationshipをアクセサーがオープンされた側に設定します。

  12. 違反レポートをキューに入れる：accessorAccessedRelationship、accessorTopDocumentのオープナーポリシー、accessedTopDocumentのオープナーポリシー、accessor のアクティブなドキュメントのURL、accessedのアクティブなドキュメントのURL、accessor の最上位ブラウジングコンテキストの初期URL、accessed の最上位ブラウジングコンテキストの初期URL、accessor のアクティブなドキュメントの起源、accessed のアクティブなドキュメントの起源、accessor の最上位ブラウジングコンテキストの作成時のオープナーの起源、accessed の最上位ブラウジングコンテキストの作成時のオープナーの起源、accessorTopDocumentのリファラー、accessedTopDocumentのリファラー、P、およびenvironment。

レポートで送信するURLをサニタイズするには、URL urlが与えられた場合：

  1. sanitizedURL を url のコピーとします。

  2. ユーザー名を設定し、sanitizedURL に空文字列を設定します。

  3. パスワードを設定し、sanitizedURL に空文字列を設定します。

  4. シリアル化された sanitizedURL を返します。このとき、フラグメントを除外が true に設定されています。

COOPレスポンスにナビゲートする際のブラウジングコンテキストグループの切り替えに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、文字列disposition、URL coopURL、URL previousResponseURL、2つの起源 coopOrigin と previousResponseOrigin、およびリファラー referrerが与えられた場合：

  1. もしcoop のレポートエンドポイントが null である場合、処理を終了します。

  2. coopValue を coop の値とします。

  3. もしdisposition が "reporting" である場合、coopValue を coop のレポート専用の値に設定します。

  4. serializedReferrer を空文字列とします。

  5. もしreferrer が URLである場合、serializedReferrer を referrer のシリアル化に設定します。

  6. body を以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition disposition
    effectivePolicy coopValue
    previousResponseURL もし coopOrigin と previousResponseOrigin が同じ起源である場合、これはpreviousResponseURL のサニタイズであり、そうでない場合はnullです。
    referrer serializedReferrer
    type "navigation-to-response"

  7. レポートをキューに入れる：body を "coop" として、coop のレポートエンドポイントにcoopURLと共に送信します。

COOPレスポンスからのナビゲーション時にブラウジングコンテキストグループの切り替えが発生した場合の違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、文字列disposition、URL coopURL、URL nextResponseURL、2つの起源 coopOrigin と nextResponseOrigin、およびブール値isCOOPResponseNavigationSourceが与えられた場合：

  1. もしcoop のレポートエンドポイントが null である場合、処理を終了します。

  2. coopValue を coop の値とします。

  3. もしdisposition が "reporting" である場合、coopValue を coop のレポート専用の値に設定します。

  4. body を以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition disposition
    effectivePolicy coopValue
    nextResponseURL coopOrigin と nextResponseOrigin が同一オリジンであるか、または isCOOPResponseNavigationSource が true の場合、これは nextResponseURL のサニタイズであり、それ以外の場合は null です。
    type "navigation-from-response"

  5. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLと共に送信します。

アクセスに関する違反レポートをキューに入れるには、アクセサーとアクセスされた要素の関係 accessorAccessedRelationship、2つのクロスオリジンオープナーポリシー accessorCOOP および accessedCOOP、4つのURL accessorURL、accessedURL、accessorInitialURL、accessedInitialURL、4つの起源 accessorOrigin、accessedOrigin、accessorCreatorOrigin および accessedCreatorOrigin、2つのリファラー accessorReferrer および accessedReferrer、文字列propertyName、および環境設定オブジェクト environmentが与えられた場合：

  1. もしcoop のレポートエンドポイントが null である場合、処理を終了します。

  2. coopValue を coop の値とします。

  3. もしdisposition が "reporting" である場合、coopValue を coop のレポート専用の値に設定します。

  4. もしaccessorAccessedRelationship が アクセサーがオープナーである場合：

    1. 開かれたウィンドウへのアクセスに関する違反レポートをキューに入れる：accessorCOOP、accessorURL、accessedURL、accessedInitialURL、accessorOrigin、accessedOrigin、accessedCreatorOrigin、propertyName、およびenvironmentが与えられた場合。

    2. オープナーからのアクセスに関する違反レポートをキューに入れる：accessedCOOP、accessedURL、accessorURL、accessedOrigin、accessorOrigin、propertyName、およびaccessedReferrerが与えられた場合。

  5. それ以外の場合、もしaccessorAccessedRelationship が アクセサーがオペニーである場合：

    1. オープナーへのアクセスに関する違反レポートをキューに入れる：accessorCOOP、accessorURL、accessedURL、accessorOrigin、accessedOrigin、propertyName、accessorReferrer、およびenvironmentが与えられた場合。

    2. 開かれたウィンドウからのアクセスに関する違反レポートをキューに入れる：accessedCOOP、accessedURL、accessorURL、accessorInitialURL、accessedOrigin、accessorOrigin、accessorCreatorOrigin、およびpropertyNameが与えられた場合。

  6. それ以外の場合：

    1. 他のウィンドウへのアクセスに関する違反レポートをキューに入れる：accessorCOOP、accessorURL、accessedURL、accessorOrigin、accessedOrigin、propertyName、およびenvironmentが与えられた場合。

    2. 他のウィンドウからのアクセスに関する違反レポートをキューに入れる：accessedCOOP、accessedURL、accessorURL、accessedOrigin、accessorOrigin、およびpropertyNameが与えられた場合。

オープナーへのアクセスに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、2つのURL coopURL および openerURL、2つの起源 coopOrigin および openerOrigin、文字列propertyName、リファラー referrer、および環境設定オブジェクト environmentが与えられた場合：

  1. sourceFile、lineNumber、およびcolumnNumberは、このレポートを引き起こした関連するスクリプトのURLおよび問題のある位置とします。

  2. serializedReferrerを空の文字列とします。

  3. もしreferrerがURLである場合、serializedReferrerをreferrerのシリアライゼーションに設定します。

  4. bodyを以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition "reporting"
    effectivePolicy coop のレポート専用の値
    property propertyName
    openerURL もしcoopOrigin と openerOrigin が同じ起源である場合、これはopenerURL のサニタイズであり、そうでない場合はnullです。
    referrer serializedReferrer
    sourceFile sourceFile
    lineNumber lineNumber
    columnNumber columnNumber
    type "access-to-opener"

  5. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLとenvironmentと共に送信します。

開かれたウィンドウへのアクセスに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、3つのURL coopURL、openedWindowURL および initialWindowURL、3つの起源 coopOrigin、openedWindowOrigin、およびopenerInitialOrigin、文字列propertyName、および環境設定オブジェクト environmentが与えられた場合：

  1. sourceFile、lineNumber、およびcolumnNumberは、このレポートを引き起こした関連するスクリプトのURLおよび問題のある位置とします。

  2. bodyを以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition "reporting"
    effectivePolicy coop のレポート専用の値
    property propertyName
    openedWindowURL もしcoopOrigin と openedWindowOrigin が同じ起源である場合、これはopenedWindowURL のサニタイズであり、そうでない場合はnullです。
    openedWindowInitialURL もしcoopOrigin と openerInitialOrigin が同じ起源である場合、これはinitialWindowURL のサニタイズであり、そうでない場合はnullです。
    sourceFile sourceFile
    lineNumber lineNumber
    columnNumber columnNumber
    type "access-to-opener"

  3. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLとenvironmentと共に送信します。

他のウィンドウへのアクセスに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、2つのURL coopURL および otherURL、2つの起源 coopOrigin および otherOrigin、文字列propertyName、および環境設定オブジェクト environmentが与えられた場合：

  1. sourceFile、lineNumber、およびcolumnNumberは、このレポートを引き起こした関連するスクリプトのURLおよび問題のある位置とします。

  2. bodyを以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition "reporting"
    effectivePolicy coop のレポート専用の値
    property propertyName
    otherURL もしcoopOrigin と otherOrigin が同じ起源である場合、これはotherURL のサニタイズであり、そうでない場合はnullです。
    sourceFile sourceFile
    lineNumber lineNumber
    columnNumber columnNumber
    type "access-to-opener"

  3. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLとenvironmentと共に送信します。

オープナーからのアクセスに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、2つのURL coopURL および openerURL、2つの起源 coopOrigin および openerOrigin、文字列propertyName、およびリファラー referrerが与えられた場合：

  1. もしcoop のレポートエンドポイントがnullである場合、リターンします。

  2. serializedReferrerを空の文字列とします。

  3. もしreferrerがURLである場合、serializedReferrerをreferrerのシリアライゼーションに設定します。

  4. bodyを以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition "reporting"
    effectivePolicy coop のレポート専用の値
    property propertyName
    openerURL もしcoopOrigin と openerOrigin が同じ起源である場合、これはopenerURL のサニタイズであり、そうでない場合はnullです。
    referrer serializedReferrer
    type "access-to-opener"

  5. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLと共に送信します。

開かれたウィンドウからのアクセスに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、3つのURL coopURL、openedWindowURL および initialWindowURL、3つの起源 coopOrigin、openedWindowOrigin、およびopenerInitialOrigin、文字列propertyNameが与えられた場合：

  1. もしcoop のレポートエンドポイントがnullである場合、リターンします。

  2. bodyを以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition "reporting"
    effectivePolicy coopValue
    property coop のレポート専用の値
    openedWindowURL もしcoopOrigin と openedWindowOrigin が同じ起源である場合、これはopenedWindowURL のサニタイズであり、そうでない場合はnullです。
    openedWindowInitialURL もしcoopOrigin と openerInitialOrigin が同じ起源である場合、これはinitialWindowURL のサニタイズであり、そうでない場合はnullです。
    type "access-to-opener"

  3. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLとenvironmentと共に送信します。

他のウィンドウからのアクセスに関する違反レポートをキューに入れるには、クロスオリジンオープナーポリシー coop、2つのURL coopURL および otherURL、2つの起源 coopOrigin および otherOrigin、文字列propertyNameが与えられた場合：

  1. もしcoop のレポートエンドポイントがnullである場合、リターンします。

  2. bodyを以下のプロパティを含む新しいオブジェクトとします：

    キー 値
    disposition "reporting"
    effectivePolicy coop のレポート専用の値
    property propertyName
    otherURL もしcoopOrigin と otherOrigin が同じ起源である場合、これはotherURL のサニタイズであり、そうでない場合はnullです。
    type "access-to-opener"

  3. レポートをキューに入れる：bodyを"coop"として、coopのレポートエンドポイントにcoopURLと共に送信します。

7.1.4 クロスオリジン埋め込みポリシー

Headers/Cross-Origin-Embedder-Policy

すべての現在のエンジンでサポートされています。

Firefox79+Safari15.2+Chrome83+
Opera?Edge83+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android86+Samsung Internet?Opera Android?

埋め込みポリシー値は、リソース所有者からの明示的な許可なしにクロスオリジンリソースの取得を制御する3つの文字列の1つです。

"unsafe-none"

これがデフォルト値です。この値が使用されている場合、クロスオリジンリソースは、CORSプロトコルまたは `クロスオリジンリソースポリシー` ヘッダーを通じて明示的な許可を与えずに取得できます。

"require-corp"

この値が使用されている場合、クロスオリジンリソースの取得には、サーバーのCORSプロトコルまたは `クロスオリジンリソースポリシー` ヘッダーを通じての明示的な許可が必要です。

"credentialless"

この値が使用されている場合、クロスオリジンのno-CORSリソースの取得時にクレデンシャルが省略されます。その代わりに、明示的な`クロスオリジンリソースポリシー` ヘッダーは必要ありません。クレデンシャルを伴うその他のリクエストには、サーバーのCORSプロトコルまたは`クロスオリジンリソースポリシー` ヘッダーを通じての明示的な許可が必要です。

"credentialless"をサポートする前に、 実装者は以下の両方をサポートすることを強く推奨します:

そうでなければ、攻撃者がクライアントのネットワーク位置を利用して、クロスオリジン分離機能を使用して非公開リソースを読み取ることができる可能性があります。

埋め込みポリシー値は、 "credentialless"または "require-corp"である場合、クロスオリジン分離と互換性があると見なされます。

埋め込みポリシーは以下で構成されます:

"coep"レポートタイプは、その値が"coep"であるレポートタイプです。 これはReportingObserverから見えるものです。

7.1.4.1 ヘッダー

`Cross-Origin-Embedder-Policy`および`Cross-Origin-Embedder-Policy-Report-Only` HTTPレスポンスヘッダーは、埋め込みポリシーを環境設定オブジェクトに対して宣言するためにサーバーが使用できるものです。これらのヘッダーは構造化ヘッダーであり、その値はトークンでなければなりません。 [STRUCTURED-FIELDS]

有効なトークンの値は埋め込みポリシー値です。このトークンにはパラメータを付けることもできます。その中でも`report-to`パラメータは、適切なレポートエンドポイントを識別する有効なURL文字列を持つことができます。[REPORTING]

処理モデルは、トークンとして解析できないヘッダーが存在する場合に、"unsafe-none"をデフォルトとして「オープンに失敗」します。これは、特定のレスポンスに含まれる複数の`Cross-Origin-Embedder-Policy`ヘッダーが組み合わさって意図しないリストが作成された場合を含みます:

`Cross-Origin-Embedder-Policy` 最終的な埋め込みポリシー値
ヘッダーが提供されない場合 "unsafe-none"
`require-corp` "require-corp"
`unknown-value` "unsafe-none"
`require-corp, unknown-value` "unsafe-none"
`unknown-value, unknown-value` "unsafe-none"
`unknown-value, require-corp` "unsafe-none"
`require-corp, require-corp` "unsafe-none"

(同じことが`Cross-Origin-Embedder-Policy-Report-Only`にも当てはまります。)

埋め込みポリシーを取得するには、レスポンス responseおよび環境 environmentから以下を実行します:

  1. policyを新しい埋め込みポリシーとします。

  2. environmentが非セキュアコンテキストである場合、policyを返します。

  3. parsedItemを、`Cross-Origin-Embedder-Policy`および"item"を使用して構造化フィールド値を取得する結果とします。 responseのヘッダーリストから取得します。

  4. もしparsedItemがnullでなく、かつparsedItem[0]がクロスオリジン分離と互換性がある場合:

    1. policyの値をparsedItem[0]に設定します。

    2. もしparsedItem[1]["report-to"] が存在する場合、policyのエンドポイントを parsedItem[1]["report-to"]に設定します。

  5. parsedItemを、`Cross-Origin-Embedder-Policy-Report-Only`および"item" を使用して構造化フィールド値を取得する結果とします。 responseのヘッダーリストから取得します。

  6. もしparsedItemがnullでなく、かつparsedItem[0]がクロスオリジン分離と互換性がある場合:

    1. policyのレポート専用の値を parsedItem[0]に設定します。

    2. もしparsedItem[1]["report-to"] が存在する場合、 policyのエンドポイントを parsedItem[1]["report-to"]に設定します。

  7. policyを返します。

7.1.4.2 埋め込みポリシーのチェック

レスポンス response、ナビゲーション可能 navigable、および埋め込みポリシー responsePolicyが与えられた場合、ナビゲーションレスポンスの埋め込みポリシー遵守状況をチェックするには:

  1. navigableが子ナビゲーション可能でない場合、trueを返します。

  2. parentPolicyをnavigableのコンテナドキュメントのポリシーコンテナの埋め込みポリシーとします。

  3. もしparentPolicyのレポート専用の値がクロスオリジン分離と互換性があるが、responsePolicyの値が互換性がない場合、クロスオリジン埋め込みポリシー継承違反をキューに入れ、response、"navigation"、parentPolicyのレポート専用の報告エンドポイント、"reporting"、およびnavigableのコンテナドキュメントの関連する設定オブジェクトを指定します。

  4. もしparentPolicyの値がクロスオリジン分離と互換性がない、またはresponsePolicyの値がクロスオリジン分離と互換性がある場合、trueを返します。

  5. クロスオリジン埋め込みポリシー継承違反をキューに入れ、response、"navigation"、parentPolicyの報告エンドポイント、"enforce"、およびnavigableのコンテナドキュメントの関連する設定オブジェクトを指定します。

  6. falseを返します。

グローバルオブジェクトの埋め込みポリシーをチェックするには、WorkerGlobalScope workerGlobalScope、環境設定オブジェクト owner、およびレスポンス responseが与えられた場合:

  1. workerGlobalScopeがDedicatedWorkerGlobalScopeオブジェクトでない場合、trueを返します。

  2. policyをworkerGlobalScopeの埋め込みポリシーとします。

  3. ownerPolicyをownerのポリシーコンテナの埋め込みポリシーとします。

  4. もしownerPolicyのレポート専用の値がクロスオリジン分離と互換性があるが、policyの値が互換性がない場合、クロスオリジン埋め込みポリシー継承違反をキューに入れ、response、"worker initialization"、ownerPolicyのレポート専用の報告エンドポイント、"reporting"、およびownerを指定します。

  5. もしownerPolicyの値がクロスオリジン分離と互換性がない、またはpolicyの値がクロスオリジン分離と互換性がある場合、trueを返します。

  6. クロスオリジン埋め込みポリシー継承違反をキューに入れ、response、"worker initialization"、ownerPolicyの報告エンドポイント、"enforce"、およびownerを指定します。

  7. falseを返します。

レスポンス response、文字列type、文字列endpoint、文字列disposition、および環境設定オブジェクト settingsが与えられた場合、クロスオリジン埋め込みポリシー継承違反をキューに入れるには:

  1. レポート用にレスポンスURLをシリアル化する結果をresponseに対してserializedとします。

  2. 以下のプロパティを含む新しいオブジェクトをbodyとします:

    key value
    type type
    blockedURL serialized
    disposition disposition

  3. キューに追加 bodyを"coep" レポートタイプとして、settingsのendpointに対して。

7.1.5 サンドボックス

サンドボックス化フラグセットは、以下のいずれか、または複数のフラグを持つセットであり、信頼できない可能性のあるリソースの機能を制限するために使用されます:

サンドボックス化されたナビゲーションブラウジングコンテキストフラグ

このフラグは、サンドボックス化されたブラウジングコンテキスト自体以外のブラウジングコンテキスト（またはその中にさらにネストされたブラウジングコンテキスト）、補助ブラウジングコンテキスト（次に定義されるサンドボックス化された補助ナビゲーションブラウジングコンテキストフラグによって保護されています）、およびトップレベルのブラウジングコンテキスト（以下で定義されるユーザーアクティベーションなしでのサンドボックス化されたトップレベルナビゲーションブラウジングコンテキストフラグおよびユーザーアクティベーションありでのサンドボックス化されたトップレベルナビゲーションブラウジングコンテキストフラグによって保護されています）へのナビゲーションを防ぎます。

もしサンドボックス化された補助ナビゲーションブラウジングコンテキストフラグが設定されていない場合でも、特定のケースではポップアップ（新しいトップレベルブラウジングコンテキスト）を開くことが許可されます。これらのブラウジングコンテキストには、作成時に設定される1つの許可されたサンドボックス化されたナビゲータがあり、それによって作成したブラウジングコンテキストが実際にナビゲートできるようになります。（そうでなければ、サンドボックス化されたナビゲーションブラウジングコンテキストフラグが、それらが開かれたとしてもナビゲートを防ぐことになります。）

サンドボックス化された補助ナビゲーションブラウジングコンテキストフラグ

このフラグは、新しい補助ブラウジングコンテキストを作成することを防ぎます。例えば、target属性やwindow.open()メソッドを使用することです。

ユーザーアクティベーションなしでのサンドボックス化されたトップレベルナビゲーションブラウジングコンテキストフラグ

このフラグは、トップレベルブラウジングコンテキストをナビゲートすることを防ぎます。また、トップレベルブラウジングコンテキストを閉じることを防ぎます。これは、サンドボックス化されたブラウジングコンテキストのアクティブウィンドウが一時的なアクティベーションを持たない場合にのみ参照されます。

ユーザーアクティベーションなしでのサンドボックス化されたトップレベルナビゲーションブラウジングコンテキストフラグが設定されていない場合、コンテンツはトップレベルブラウジングコンテキストをナビゲートできますが、他のブラウジングコンテキストは引き続きサンドボックス化されたナビゲーションブラウジングコンテキストフラグやおそらくサンドボックス化された補助ナビゲーションブラウジングコンテキストフラグによって保護されます。

ユーザーアクティベーションありでのサンドボックス化されたトップレベルナビゲーションブラウジングコンテキストフラグ

このフラグは、トップレベルブラウジングコンテキストをナビゲートすることを防ぎます。また、トップレベルブラウジングコンテキストを閉じることを防ぎます。これは、サンドボックス化されたブラウジングコンテキストのアクティブウィンドウが一時的なアクティベーションを持つ場合にのみ参照されます。

ユーザーアクティベーションなしでのサンドボックス化されたトップレベルナビゲーションブラウジングコンテキストフラグと同様に、このフラグはトップレベルブラウジングコンテキストのみに影響します。設定されていない場合、他のブラウジングコンテキストは他のフラグによって保護されている可能性があります。

サンドボックス化されたオリジンブラウジングコンテキストフラグ

このフラグは、コンテンツを不透明なオリジンに強制し、同じオリジンの他のコンテンツへのアクセスを防ぎます。

このフラグはまた、スクリプトがdocument.cookieのIDL属性を読み書きすることを防ぎ、localStorageへのアクセスをブロックします。

サンドボックス化されたフォームブラウジングコンテキストフラグ

このフラグはフォームの送信をブロックします。

サンドボックス化されたポインターロックブラウジングコンテキストフラグ

このフラグはポインターロックAPIを無効にします。[POINTERLOCK]

サンドボックス化されたスクリプトブラウジングコンテキストフラグ

このフラグはスクリプトの実行をブロックします。

サンドボックス化された自動機能ブラウジングコンテキストフラグ

このフラグは、ビデオの自動再生やフォームコントロールの自動フォーカスなど、自動的にトリガーされる機能をブロックします。

サンドボックス化されたdocument.domainブラウジングコンテキストフラグ

このフラグは、document.domainセッターの使用を防ぎます。

サンドボックスは補助ブラウジングコンテキストにも伝播するフラグ

このフラグは、作成した補助ブラウジングコンテキストがコンテンツのアクティブなサンドボックス化フラグセットを継承することを保証することで、サンドボックスから逃れることを防ぎます。

サンドボックス化されたモーダルフラグ

このフラグは、次の機能を使用してモーダルダイアログを作成することを防ぎます:

サンドボックス化された画面の向きロックブラウジングコンテキストフラグ

このフラグは、画面の向きのロック機能を無効にします。[SCREENORIENTATION]

サンドボックス化されたプレゼンテーションブラウジングコンテキストフラグ

このフラグは、プレゼンテーションAPIを無効にします。[PRESENTATION]

サンドボックス化されたダウンロードブラウジングコンテキストフラグ

このフラグは、コンテンツがダウンロードハイパーリンクを介してか、またはダウンロードとして処理されるナビゲーションを介してか、ダウンロードを開始またはインスタンス化するのを防ぎます。

サンドボックス化されたカスタムプロトコルナビゲーションブラウジングコンテキストフラグ

このフラグは、非fetchスキームへのナビゲーションが外部ソフトウェアに引き渡されることを防ぎます。

ユーザーエージェントが文字列input、およびサンドボックス化フラグセット outputが与えられたときにサンドボックス化ディレクティブを解析するために実行するステップ:

  1. ASCIIホワイトスペースでinputを分割してtokensを取得します。

  2. outputを空にします。

  3. 次のフラグをoutputに追加します:

各トップレベルブラウジングコンテキストには、ポップアップサンドボックス化フラグセットがあり、これはサンドボックス化フラグセットです。ブラウジングコンテキストが作成されると、そのポップアップサンドボックス化フラグセットは空でなければなりません。これはナビゲート可能なものを選択するためのルールとナビゲーション応答に使用するブラウジングコンテキストを取得するアルゴリズムによって設定されます。

各iframe要素には、iframeサンドボックス化フラグセットがあり、これはサンドボックス化フラグセットです。任意の時点で設定されているiframeサンドボックス化フラグセット内のフラグは、iframe要素のsandbox属性によって決定されます。

各Documentには、アクティブなサンドボックス化フラグセットがあり、これはサンドボックス化フラグセットです。Documentが作成されるとき、そのアクティブなサンドボックス化フラグセットは空でなければなりません。これはナビゲーションアルゴリズムによって設定されます。

各CSPリストcspListには、CSP由来のサンドボックス化フラグがあり、これはサンドボックス化フラグセットです。これは以下のアルゴリズムの戻り値です:

  1. directivesを空の順序付けられたセットにします。

  2. 各cspList内のポリシーに対して:

    1. もしpolicyのディスポジションが"enforce"でない場合、続行します。

    2. もしpolicyのディレクティブセットが、名前が"サンドボックス"であるディレクティブを含む場合、そのディレクティブをdirectivesに追加します。

  3. もしdirectivesが空である場合、空のサンドボックス化フラグセットを返します。

  4. directiveをdirectives[directivesのサイズ − 1]に設定します。

  5. directiveに対してサンドボックス化ディレクティブを解析する結果を返します。

作成サンドボックス化フラグを決定するために、ブラウジングコンテキストbrowsing contextに対して、nullまたは要素embedderが与えられたとき、以下のサンドボックス化フラグセットに存在するフラグの和を返します:

7.1.6 ポリシーコンテナ

ポリシーコンテナとは、構造体であり、Document、WorkerGlobalScope、またはWorkletGlobalScopeに適用されるポリシーを含んでいます。これは以下の項目を持ちます。

他のポリシーをポリシーコンテナに移動します。

ポリシーコンテナをクローンするには、ポリシーコンテナpolicyContainerを指定します。

  1. 新しいポリシーコンテナをcloneとします。

  2. 各 policyをpolicyContainerのCSPリストに追加し、cloneのCSPリストにそのコピーを追加します。

  3. cloneの埋め込みポリシーを、policyContainerの埋め込みポリシーのコピーに設定します。

  4. cloneのリファラーポリシーを、policyContainerのリファラーポリシーに設定します。

  5. cloneを返します。

URL urlが履歴にポリシーコンテナを保存する必要があるかどうかを判断するには：

  1. もしurlのスキームが「blob」である場合、falseを返します。

  2. もしurlがローカルであれば、trueを返します。

  3. falseを返します。

フェッチレスポンスからポリシーコンテナを作成するには、レスポンスresponseと環境またはnullenvironmentを指定します。

  1. もしresponseのURLのスキームが「blob」である場合、クローンを返します。 responseのURLのBlob URLエントリの環境のポリシーコンテナの。

  2. 新しいポリシーコンテナをresultとします。

  3. resultのCSPリストを、responseを指定してレスポンスのコンテンツセキュリティポリシーを解析する結果に設定します。

  4. もしenvironmentがnullでない場合、resultの埋め込みポリシーをresponseとenvironmentを指定して埋め込みポリシーを取得する結果に設定します。そうでなければ、「unsafe-none」に設定します。

  5. resultのリファラーポリシーを、responseを指定して「Referrer-Policy」ヘッダーを解析する結果に設定します。 [REFERRERPOLICY]

  6. resultを返します。

ナビゲーションパラメータポリシーコンテナを決定するには、URLresponseURLと、4つのポリシーコンテナまたはnullのhistoryPolicyContainer、initiatorPolicyContainer、parentPolicyContainer、およびresponsePolicyContainerを指定します。

  1. もしhistoryPolicyContainerがnullでない場合:

    1. アサート：responseURLが履歴にポリシーコンテナを保存する必要があることを確認します。

    2. historyPolicyContainerのクローンを返します。

  2. もしresponseURLがabout:srcdocである場合:

    1. アサート：parentPolicyContainerがnullでないことを確認します。

    2. parentPolicyContainerのクローンを返します。

  3. もしresponseURLがローカルであり、initiatorPolicyContainerがnullでない場合、initiatorPolicyContainerのクローンを返します。

  4. もしresponsePolicyContainerがnullでない場合、それを返します。

  5. 新しいポリシーコンテナを返します。

ワーカーグローバルスコープのポリシーコンテナを初期化するには、WorkerGlobalScopeworkerGlobalScope、レスポンスresponse、および環境environmentを指定します。

  1. もしworkerGlobalScopeのURLがローカルであるが、そのスキームが「blob」でない場合：

    1. アサート：workerGlobalScopeの所有者セットのサイズが1であることを確認します。

    2. workerGlobalScopeのポリシーコンテナを、workerGlobalScopeの所有者セット[0]の関連する設定オブジェクトのポリシーコンテナのクローンに設定します。

  2. それ以外の場合、workerGlobalScopeのポリシーコンテナをresponseとenvironmentを指定してフェッチレスポンスからポリシーコンテナを作成する結果に設定します。

7.2.1 セキュリティインフラストラクチャー: Window, WindowProxy, およびLocationオブジェクト

通常、オブジェクトはオリジンをまたいでアクセスすることはできませんが、ウェブプラットフォームが依存しているそのルールに対する一部のレガシー例外が存在しないと、ウェブプラットフォームは本来の姿ではないでしょう。

このセクションでは、JavaScript仕様からの用語と書式設定の慣例を使用しています。[JAVASCRIPT]

7.2.1.1 IDLとの統合

セキュリティチェックを実行するがplatformObject、identifier、およびtypeと共に呼び出された場合、次のステップを実行します。

  1. もしplatformObjectがWindowまたはLocationオブジェクトでない場合、終了します。

  2. 各eに対して、CrossOriginProperties(platformObject)を実行します。

    1. もしSameValue(e.[[Property]], identifier)がtrueであれば、次のステップを実行します。

      1. もしtypeが「method」であり、eが[[NeedsGet]]または[[NeedsSet]]を持っていない場合、終了します。

      2. それ以外で、typeが「getter」であり、e.[[NeedsGet]]がtrueである場合、終了します。

      3. それ以外で、typeが「setter」であり、e.[[NeedsSet]]がtrueである場合、終了します。

  3. もしIsPlatformObjectSameOrigin(platformObject)がfalseであれば、"SecurityError" DOMExceptionをスローします。

7.2.1.2 共有内部スロット: [[CrossOriginPropertyDescriptorMap]]

WindowおよびLocationオブジェクトには、値が初期状態で空のマップである[[CrossOriginPropertyDescriptorMap]]内部スロットが含まれています。

[[CrossOriginPropertyDescriptorMap]]内部スロットには、currentGlobalがobjectGlobalからWindowまたはLocationオブジェクトを検査するときに、スクリプトに見える内容をメモ化するために、currentGlobal、objectGlobal、およびpropertyKeyをキーとし、プロパティディスクリプタを値とするエントリを持つマップが含まれています。このマップはCrossOriginGetOwnPropertyHelperによって遅延的に埋められ、将来の検索で参照されます。

ユーザーエージェントは、値のいかなる部分にも参照が保持されていないとき、対応するキーと共にマップ内の値をガベージコレクトできるようにする必要があります。つまり、ガベージコレクションが観察可能でない限りです。

例えば、const href = Object.getOwnPropertyDescriptor(crossOriginLocation, "href").setのように、値とそれに対応するキーは、ガベージコレクトすると観察可能になるため、ガベージコレクトできません。

ユーザーエージェントは、document.domainが設定されたときに、マップからキーと値のペアを削除する最適化を持つことができます。これは、document.domainが以前の値に戻ることができないため、観察可能ではありません。

例えば、document.domainをwww.example.comで"example.com"に設定する場合、ユーザーエージェントは、キーの一部がwww.example.comであるすべてのキーと値のペアをマップから削除できます。これは、www.example.comが再びオリジンの一部になることはなく、したがって対応する値がマップから再取得されることはないためです。

7.2.1.3 共通の抽象操作
7.2.1.3.1 CrossOriginProperties (O)

  1. Assert: OがLocationオブジェクトまたはWindowオブジェクトであることを確認します。

  2. もしOがLocationオブジェクトであるならば、以下を返します：

    « { [[Property]]: "href", [[NeedsGet]]: false, [[NeedsSet]]: true }, { [[Property]]: "replace" } »

  3. 以下を返します：

    « { [[Property]]: "window", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "self", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "location", [[NeedsGet]]: true, [[NeedsSet]]: true }, { [[Property]]: "close" }, { [[Property]]: "closed", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "focus" }, { [[Property]]: "blur" }, { [[Property]]: "frames", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "length", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "top", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "opener", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "parent", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "postMessage" } »

この抽象操作は、Completion Recordを返しません。

インデックス付きプロパティは、このアルゴリズムで安全リストに追加する必要はありません。これらは直接WindowProxyオブジェクトによって処理されます。

JavaScriptのプロパティ名Pが「クロスオリジンアクセス可能なウィンドウプロパティ名」であるためには、それが「window」、「self」、「location」、「close」、「closed」、「focus」、「blur」、「frames」、「length」、「top」、「opener」、「parent」、「postMessage」、または配列インデックスプロパティ名のいずれかである必要があります。

7.2.1.3.2 CrossOriginPropertyFallback (P)

  1. もしPが「then」、%Symbol.toStringTag%、%Symbol.hasInstance%、または%Symbol.isConcatSpreadable%である場合、以下を返します：

    PropertyDescriptor{ [[Value]]: undefined, [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true }.

  2. "SecurityError" DOMExceptionをスローします。

7.2.1.3.3 IsPlatformObjectSameOrigin (O)

  1. 現在の設定オブジェクトのオリジンがOの関連する設定オブジェクトのオリジンと同一オリジンドメインである場合にtrueを返し、それ以外の場合はfalseを返します。

この抽象操作は、Completion Recordを返しません。

ここでの現在の設定オブジェクトは概ね「呼び出し元」に対応します。このチェックは、対象となるゲッター/セッター/メソッドのための実行コンテキストがJavaScript実行コンテキストスタックに入る前に行われます。例えば、コードw.documentでは、このステップはdocumentゲッターに到達する前に[[Get]]アルゴリズムの一部として呼び出されます。

7.2.1.3.4 CrossOriginGetOwnPropertyHelper (O, P)

この抽象操作がundefinedを返し、カスタム動作がない場合、呼び出し元は"SecurityError" DOMExceptionをスローする必要があります。実際には、これは呼び出し元がCrossOriginPropertyFallbackを呼び出すことで処理されます。

  1. crossOriginKeyを、現在の設定オブジェクト、Oの関連する設定オブジェクト、およびPから成るタプルとします。

  2. CrossOriginProperties(O)の各eについて:

    1. もしSameValue(e.[[Property]], P)がtrueである場合、次のステップを実行します:

      1. もしOの[[CrossOriginPropertyDescriptorMap]]内部スロットの値がcrossOriginKeyをキーとするエントリを含む場合、そのエントリの値を返します。

      2. originalDescをOrdinaryGetOwnProperty(O, P)とします。

      3. crossOriginDescをundefinedとします。

      4. もしe.[[NeedsGet]]および[[NeedsSet]]が存在しない場合:

        1. valueをoriginalDesc.[[Value]]とします。

        2. もしIsCallable(value)がtrueである場合、valueを、現在の領域で作成された、O上のIDL操作Pと同じステップを実行する匿名組み込み関数に設定します。

        3. crossOriginDescをPropertyDescriptor{ [[Value]]: value, [[Enumerable]]: false, [[Writable]]: false, [[Configurable]]: true }に設定します。

      5. それ以外の場合:

        1. crossOriginGetをundefinedとします。

        2. もしe.[[NeedsGet]]がtrueである場合、crossOriginGetを、現在の領域で作成され、O上のIDL属性Pのゲッターと同じステップを実行する匿名組み込み関数に設定します。

        3. crossOriginSetをundefinedとします。

        4. もしe.[[NeedsSet]]がtrueである場合、crossOriginSetを、現在の領域で作成され、O上のIDL属性Pのセッターと同じステップを実行する匿名組み込み関数に設定します。

        5. crossOriginDescをPropertyDescriptor{ [[Get]]: crossOriginGet, [[Set]]: crossOriginSet, [[Enumerable]]: false, [[Configurable]]: true }に設定します。

      6. Oの[[CrossOriginPropertyDescriptorMap]]内部スロットの値に、キーcrossOriginKeyと値crossOriginDescを持つエントリを作成します。

      7. crossOriginDescを返します。

  3. undefinedを返します。

この抽象操作はCompletion Recordを返しません。

ここで生成されたプロパティ記述子が設定可能である理由は、JavaScript仕様書で求められる基本内部メソッドの不変条件を維持するためです。特に、プロパティの値がナビゲーションの結果として変更される可能性があるため、そのプロパティは設定可能である必要があります。（ただし、既存のWebコンテンツとの互換性のために、これらの不変条件を維持できないケースについては、tc39/ecma262 issue #672およびこの仕様書の他の部分を参照してください。）[JAVASCRIPT]

プロパティ記述子が列挙可能でない理由は、これが同一オリジンの動作と一致しないにもかかわらず、既存のWebコンテンツとの互換性のためです。詳細はissue #3183を参照してください。

7.2.1.3.5 CrossOriginGet (O, P, Receiver)

  1. descを? O.[[GetOwnProperty]](P)とします。

  2. Assert: descはundefinedではありません。

  3. もしIsDataDescriptor(desc)がtrueである場合、desc.[[Value]]を返します。

  4. Assert: IsAccessorDescriptor(desc)がtrueであることを確認します。

  5. getterをdesc.[[Get]]とします。

  6. もしgetterがundefinedである場合、"SecurityError" DOMExceptionをスローします。

  7. ? Call(getter, Receiver)を返します。

7.2.1.3.6 CrossOriginSet (O, P, V, Receiver)

  1. descを? O.[[GetOwnProperty]](P)とします。

  2. Assert: descはundefinedではありません。

  3. もしdesc.[[Set]]が存在し、その値がundefinedでない場合、次を実行します:

    1. ? Call(desc.[[Set]], Receiver, « V ») を実行します。

    2. true を返します。

  4. "SecurityError" DOMExceptionをスローします。

7.2.1.3.7 CrossOriginOwnPropertyKeys (O)

  1. keysを新しい空のリストに設定します。

  2. CrossOriginProperties(O)の各eについて、リストに追加e.[[Property]]をkeysに設定します。

  3. keysの結合を返します: « "then", %Symbol.toStringTag%, %Symbol.hasInstance%, %Symbol.isConcatSpreadable% ».

この抽象操作はCompletion Recordを返しません。

7.2.2 The Window object

Window

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera3+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android37+ Samsung Internet? Opera Android10.1+ 
[Global=Window,
  Exposed=Window,
  LegacyUnenumerableNamedProperties]
 interface Window : EventTarget {
   // the current browsing context
   [LegacyUnforgeable] readonly attribute WindowProxy window;
   [Replaceable] readonly attribute WindowProxy self;
   [LegacyUnforgeable] readonly attribute Document document;
   attribute DOMString name; 
   [PutForwards=href, LegacyUnforgeable] readonly attribute Location location;
   readonly attribute History history;
   readonly attribute Navigation navigation;
   readonly attribute CustomElementRegistry customElements;
   [Replaceable] readonly attribute BarProp locationbar;
   [Replaceable] readonly attribute BarProp menubar;
   [Replaceable] readonly attribute BarProp personalbar;
   [Replaceable] readonly attribute BarProp scrollbars;
   [Replaceable] readonly attribute BarProp statusbar;
   [Replaceable] readonly attribute BarProp toolbar;
   attribute DOMString status;
   undefined close();
   readonly attribute boolean closed;
   undefined stop();
   undefined focus();
   undefined blur();
 
   // other browsing contexts
   [Replaceable] readonly attribute WindowProxy frames;
   [Replaceable] readonly attribute unsigned long length;
   [LegacyUnforgeable] readonly attribute WindowProxy? top;
   attribute any opener;
   [Replaceable] readonly attribute WindowProxy? parent;
   readonly attribute Element? frameElement;
   WindowProxy? open(optional USVString url = "", optional DOMString target = "_blank", optional [LegacyNullToEmptyString] DOMString features = "");
 
   // Since this is the global object, the IDL named getter adds a NamedPropertiesObject exotic
   // object on the prototype chain. Indeed, this does not make the global object an exotic object.
   // Indexed access is taken care of by the WindowProxy exotic object.
   getter object (DOMString name);
 
   // the user agent
   readonly attribute Navigator navigator;
   [Replaceable] readonly attribute Navigator clientInformation; // legacy alias of .navigator
   readonly attribute boolean originAgentCluster;
 
   // user prompts
   undefined alert();
   undefined alert(DOMString message);
   boolean confirm(optional DOMString message = "");
   DOMString? prompt(optional DOMString message = "", optional DOMString default = "");
   undefined print();
 
   undefined postMessage(any message, USVString targetOrigin, optional sequence<object> transfer = []);
   undefined postMessage(any message, optional WindowPostMessageOptions options = {});
 
   // also has obsolete members
 };
 Window includes GlobalEventHandlers;
 Window includes WindowEventHandlers;
 
 dictionary WindowPostMessageOptions : StructuredSerializeOptions {
   USVString targetOrigin = "/";
 };
window.window

Window/window

すべての現在のエンジンでサポートされています。

Firefox1+ Safari3+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS1+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+
window.frames

Window/frames

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+
window.self

Window/self

すべての現在のエンジンでサポートされています。

Firefox1+ Safari3+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS1+ Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

これらの属性はすべてwindowを返します。

window.document

Window/document

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

windowに関連付けられたDocumentを返します。

document.defaultView

Document/defaultView

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

documentに関連付けられたWindowを返します。関連付けがない場合はnullを返します。

The Window object has an associated Document, which is a Document object. It is set when the Window object is created, and only ever changed during navigation from the initial about:blank Document.

A Window's browsing context is its associated Document's browsing context. It is either null or a browsing context.

A Window's navigable is the navigable whose active document is the Window's associated Document's, or null if there is no such navigable.

The window, frames, and self getter steps are to return this's relevant realm.[[GlobalEnv]].[[GlobalThisValue]].

The document getter steps are to return this's associated Document.

The Document object associated with a Window object can change in exactly one case: when the navigate algorithm creates a new Document object for the first page loaded in a browsing context. In that specific case, the Window object of the initial about:blank page is reused and gets a new Document object.

The defaultView getter steps are:

  1. If this's browsing context is null, then return null.

  2. Return this's browsing context's WindowProxy object.

HTMLDocument

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

歴史的理由により、Windowオブジェクトには、名前がHTMLDocumentで、値がDocumentのインターフェイスオブジェクトである、書き込み可能で、設定可能で、列挙不可能なプロパティも存在しなければなりません。

7.2.2.1 ウィンドウの開閉
window = window.open([ url [, target [, features ] ] ])

Window/open

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge（レガシー）12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

urlを表示するためのウィンドウを開き（デフォルトは"about:blank"）、それを返します。target（デフォルトは"_blank"）は新しいウィンドウの名前を指定します。その名前のウィンドウが既に存在する場合、それが再利用されます。features引数には、コンマ区切りのトークンのセットが含まれることがあります：

"noopener"
"noreferrer"

これらは、ハイパーリンクのnoopenerおよびnoreferrerリンクタイプと同様に動作します。

"popup"

ユーザーエージェントに対し、新しいウィンドウに対して最小限のWebブラウザーインターフェイスを提供することを促します。（すべてのBarPropオブジェクトのvisibleゲッターに影響を与えます。） 

globalThis.open("https://email.example/message/CAOOOkFcWW97r8yg=SsWg7GgCmp4suVX9o85y8BvNRqMjuc5PXg", undefined, "noopener,popup");
window.name [ = value ]

Window/name

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge（レガシー）12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ウィンドウの名前を返します。

設定することで、名前を変更できます。

window.close()

Window/close

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge（レガシー）12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

ウィンドウを閉じます。

window.closed

Window/closed

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge（レガシー）12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ウィンドウが閉じられている場合はtrueを返し、そうでない場合はfalseを返します。

window.stop()

Window/stop

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge（レガシー）14+Internet Explorerいいえ
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ドキュメントの読み込みをキャンセルします。

Document sourceDocument、順序付きマップ tokenizedFeatures、および URL レコードまたは null url を指定して、ウィンドウを開くための noopener を取得するには、次の手順を実行します。これらはブール値を返します。

  1. url が null ではなく、かつ url の BLOB URL エントリが null でない場合：

    1. blobOrigin を url の BLOB URL エントリの 環境の オリジンとします。

    2. topLevelOrigin を sourceDocument の 関連する設定オブジェクトの トップレベルオリジンとします。

    3. blobOrigin が topLevelOrigin と同一サイトでない場合、true を返します。

  2. noopener を false とします。

  3. tokenizedFeatures["noopener"] が存在する場合、noopener をtokenizedFeatures["noopener"] をブール値の特徴として解析した結果に設定します。

  4. noopener を返します。

ウィンドウを開く手順は、文字列url、文字列target、および文字列featuresを指定して次の手順で実行されます：

  1. イベントループの終了ネストレベルがゼロでない場合、null を返します。

  2. sourceDocument をエントリグローバルオブジェクトの関連付けられたDocumentとします。

  3. urlRecord を null とします。

  4. url が空の文字列でない場合：

    1. sourceDocument を基準として、url を指定してURL のエンコード解析の結果を urlRecord に設定します。

    2. urlRecord が失敗の場合、"SyntaxError" DOMException をスローします。

  5. target が空の文字列の場合、target を "_blank" に設定します。

  6. tokenizedFeatures を features をトークン化した結果とします。

  7. noreferrer を false とします。

  8. tokenizedFeatures["noreferrer"] が存在する場合、noreferrer をtokenizedFeatures["noreferrer"] をブール値の特徴として解析した結果に設定します。

  9. noopener を、sourceDocument、tokenizedFeatures、および urlRecord を使用してウィンドウを開くための noopener を取得した結果とします。

  10. tokenizedFeatures["noopener"] と tokenizedFeatures["noreferrer"] を削除します。

  11. referrerPolicy を空の文字列とします。

  12. noreferrer が true の場合、noopener を true に設定し、referrerPolicy を "no-referrer" に設定します。

  13. targetNavigable と windowType を、target、sourceDocument のノードナビゲブル、および noopener を指定してナビゲブルを選択するためのルールを適用した結果とします。

    リンクをコントロールクリックして新しいタブで開くことをサポートするユーザーエージェントがあり、ユーザーがonclickハンドラーがwindow.open() API を使用してiframe要素でページを開く要素をコントロールクリックした場合、ユーザーエージェントはターゲットブラウジングコンテキストの選択をオーバーライドして、代わりに新しいタブをターゲットにする可能性があります。

  14. targetNavigable が null の場合、null を返します。

  15. windowType が "new and unrestricted" または "new with no opener" のいずれかである場合：

    1. targetNavigable のアクティブなブラウジングコンテキストのポップアップであるかを、tokenizedFeatures を指定してポップアップウィンドウが要求されているかどうかを確認した結果に設定します。

    2. tokenizedFeatures を指定して、targetNavigable のアクティブなブラウジングコンテキストのブラウジングコンテキストの機能を設定します。[CSSOMVIEW]

    3. urlRecord が null の場合、urlRecord をabout:blankを表すURL レコードに設定します。

    4. urlRecord がabout:blank に一致する場合、targetNavigable のアクティブなドキュメントと urlRecord を指定してURL と履歴の更新手順を実行します。

      これは、url が about:blank?foo のようなものである場合に必要です。url が単なる about:blank の場合、これは何もしません。

    5. それ以外の場合、sourceDocument を使用して targetNavigable を urlRecord にナビゲートし、referrerPolicy を referrerPolicy に設定し、exceptionsEnabled を true に設定します。

  16. それ以外の場合：

    1. urlRecord が null でない場合、sourceDocument を使用して targetNavigable を urlRecord にナビゲートし、referrerPolicy を referrerPolicy に設定し、exceptionsEnabled を true に設定します。

    2. noopener が false の場合、targetNavigable のアクティブなブラウジングコンテキストのオープナーブラウジングコンテキストを sourceDocument のブラウジングコンテキストに設定します。

  17. noopener が true または windowType が "new with no opener" の場合、null を返します。

  18. targetNavigable のアクティブなWindowProxyを返します。

open(url, target, features)メソッドの手順は、ウィンドウを開く手順をurl、target、およびfeaturesと共に実行します。

このメソッドは、既存のブラウジングコンテキストをナビゲートするか、補助ブラウジングコンテキストを開いてナビゲートするためのメカニズムを提供します。

features引数をトークン化するには：

  1. tokenizedFeaturesを順序付きマップとして新規作成します。

  2. positionをfeaturesの最初のコードポイントに設定します。

  3. 次のpositionがfeaturesの末尾を超えていない間：

    1. nameを空文字列に設定します。

    2. valueを空文字列に設定します。

    3. コードポイントのシーケンスを収集し、featuresからpositionに基づいて機能セパレーターを設定します。これにより、名前の前にある先頭のセパレーターがスキップされます。

    4. コードポイントのシーケンスを収集し、featuresからpositionに基づいて機能セパレーターでないものを収集します。収集された文字をnameに設定し、ASCII小文字に変換します。

    5. nameを機能名を正規化の結果として設定します。

    6. 次のpositionがfeaturesの末尾を超えておらず、featuresのpositionにあるコードポイントがU+003D (=)でない間：

      1. もしfeaturesのpositionにあるコードポイントがU+002C (,)である場合、または機能セパレーターでない場合、ブレイクします。

      2. positionを1進めます。

      これにより、最初のU+003D (=)までスキップされますが、U+002C (,)または非セパレーターを超えません。

    7. もしfeaturesのpositionにあるコードポイントが機能セパレーターである場合：

      1. positionがfeaturesの末尾を超えておらず、featuresのpositionにあるコードポイントが機能セパレーターである間：

        1. もしfeaturesのpositionにあるコードポイントがU+002C (,)である場合、ブレイクします。

        2. positionを1進めます。

        これにより、最初の非セパレーターまでスキップされますが、U+002C (,)を超えません。

      2. コードポイントのシーケンスを収集し、featuresからpositionに基づいて機能セパレーターでないコードポイントを収集します。収集されたコードポイントをvalueに設定し、ASCII小文字に変換します。

    8. もしnameが空文字列でない場合、tokenizedFeatures[name]をvalueに設定します。

  4. tokenizedFeaturesを返します。

ウィンドウ機能が設定されているかどうかを確認するには、tokenizedFeatures、featureName、およびdefaultValueを指定して次の手順で実行します：

  1. もしtokenizedFeatures[featureName]が存在する場合、tokenizedFeatures[featureName]をブール機能として解析した結果を返します。

  2. defaultValueを返します。

ポップアップウィンドウが要求されているかどうかを確認するには、tokenizedFeaturesを指定して次の手順で実行します：

  1. もしtokenizedFeaturesが空の場合、falseを返します。

  2. もしtokenizedFeatures["popup"]が存在する場合、tokenizedFeatures["popup"]をブール機能として解析した結果を返します。

  3. locationを、ウィンドウ機能が設定されているかどうかを確認した結果とし、tokenizedFeatures、"location"、およびfalseを使用して確認します。

  4. toolbarを、ウィンドウ機能が設定されているかどうかを確認した結果とし、tokenizedFeatures、"toolbar"、およびfalseを使用して確認します。

  5. もしlocationとtoolbarの両方がfalseの場合、trueを返します。

  6. menubarを、ウィンドウ機能が設定されているかどうかを確認した結果とし、tokenizedFeatures、"menubar"、およびfalseを使用して確認します。

  7. もしmenubarがfalseの場合、trueを返します。

  8. resizableを、ウィンドウ機能が設定されているかどうかを確認した結果とし、tokenizedFeatures、"resizable"、およびtrueを使用して確認します。

  9. もしresizableがfalseの場合、trueを返します。

  10. scrollbarsを、ウィンドウ機能が設定されているかどうかを確認した結果とし、tokenizedFeatures、"scrollbars"、およびfalseを使用して確認します。

  11. もしscrollbarsがfalseの場合、trueを返します。

  12. statusを、ウィンドウ機能が設定されているかどうかを確認した結果とし、tokenizedFeatures、"status"、およびfalseを使用して確認します。

  13. もしstatusがfalseの場合、trueを返します。

  14. falseを返します。

コードポイントがフィーチャーセパレーターである場合、それがASCIIホワイトスペース、U+003D（=）、またはU+002C（,）である。

レガシーの理由により、一部の機能名にはいくつかの別名があります。nameを指定して機能名を正規化するには、nameに応じて切り替えます：

"screenx"
"left"を返します。
"screeny"
"top"を返します。
"innerwidth"
"width"を返します。
"innerheight"
"height"を返します。
それ以外
nameを返します。

valueを指定して、ブール機能を解析するには：

  1. もしvalueが空文字列である場合、trueを返します。

  2. もしvalueが"yes"である場合、trueを返します。

  3. もしvalueが"true"である場合、trueを返します。

  4. parsedを、整数として解析した結果として設定します。

  5. もしparsedがエラーの場合、それを0に設定します。

  6. もしparsedが0である場合、falseを返します。それ以外の場合はtrueを返します。

namegetterの手順は、次のとおりです：

  1. もしthisのナビゲーブルがnullである場合、空文字列を返します。

  2. thisのナビゲーブルのターゲット名を返します。

name setterの手順は、次のとおりです：

  1. もしthisのナビゲーブルがnullである場合、終了します。

  2. thisのナビゲーブルのアクティブなセッション履歴エントリのドキュメント状態のナビゲーブルターゲット名を指定された値に設定します。

ナビゲーブルが別のオリジンにナビゲートされたとき、名前はリセットされます。

close()メソッドの手順は、次のとおりです：

  1. thisTraversableをthisのナビゲーブルに設定します。

  2. もしthisTraversableがトップレベルのトラバーサブルでない場合、終了します。

  3. もしthisTraversableのクローズ中がtrueである場合、終了します。

  4. browsingContextをthisTraversableのアクティブなブラウジングコンテキストに設定します。

  5. sourceSnapshotParamsを、スナップショットのソーススナップショットパラメーターのスナップショットとして設定し、thisTraversableのアクティブなドキュメントを指定して実行します。

  6. 次のすべてがtrueである場合：

    次の手順を実行します：

    1. thisTraversable の 閉じているかを true に設定します。

    2. DOM 操作タスクソースでタスクをキューに入れ、thisTraversable を確実に閉じます。

ナビゲブルがスクリプトで閉じることができるのは、それがトップレベルのトラバーサブルであり、かつ次のいずれかが true の場合です：

closedgetterの手順は、thisのブラウジングコンテキストがnullであるか、クローズ中がtrueである場合、trueを返します。それ以外の場合はfalseを返します。

stop()メソッドの手順は、次のとおりです：

  1. もしthisのナビゲーブルがnullである場合、終了します。

  2. 読み込みを停止し、thisのナビゲーブルを指定します。

7.2.2.2 Windowオブジェクトにおけるインデックスアクセス
window.length

Window/length

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ドキュメントツリーの子ナビゲーブルの数を返します。

window[index]

指定されたドキュメントツリーの子ナビゲーブルに対応するWindowProxyを返します。

lengthgetterの手順は、次のとおりです：

thisの関連付けられたDocumentのドキュメントツリーの子ナビゲーブルのサイズを返します。

ドキュメントツリーの子ナビゲーブルへのインデックスアクセスは、WindowProxyオブジェクトの[[GetOwnProperty]]内部メソッドによって定義されています。

7.2.2.3 Window オブジェクトでの名前付きアクセス
window[name]

指定された要素または要素のコレクションを返します。

一般的に、これに依存すると脆弱なコードにつながる可能性があります。Webプラットフォームに新機能が追加されると、このAPIにマッピングされるIDが時間とともに変わる可能性があります。代わりに、document.getElementById()またはdocument.querySelector()を使用してください。

Window オブジェクト window のドキュメントツリー子ナビゲーブルターゲット名プロパティセットは、次の手順を実行することで返されます。

  1. children を window の 関連付けられた Document の ドキュメントツリー子ナビゲーブル に設定します。

  2. firstNamedChildren を空の 順序付きセット に設定します。

  3. 各 children の navigable について、次の操作を行います。

    1. name を navigable の ターゲット名 に設定します。

    2. name が空の文字列である場合、続行します。

    3. firstNamedChildren が、name を持つ ナビゲーブル を含んでいる場合、続行します。

    4. ナビゲーブル を firstNamedChildren に追加します。

  4. names を空の 順序付きセット に設定します。

  5. 各 firstNamedChildren の navigable について、次の操作を行います。

    1. name を navigable の ターゲット名 に設定します。

    2. navigable の アクティブドキュメント の オリジン が、window の 関連設定オブジェクト の オリジン と同じオリジンである場合、 name を names に追加します。

  6. names を返します。

2つの個別の反復により、次の例では、https://example.org/ でホストされているとして、 https://elsewhere.example/ が window.name に "spices" を設定した場合、すべてが読み込まれた後に window.spices を評価すると、未定義が返されます: 

<iframe src=https://elsewhere.example.com/></iframe>
<iframe name=spices></iframe>

Window オブジェクトは名前付きプロパティをサポートします。Window オブジェクト window のサポートされているプロパティ名は、要素によって提供された順に、重複を無視して、ツリー順で次のように構成されます:

名前付きプロパティの値を決定する には、Window オブジェクト window で次の手順を実行する必要があります。

  1. objects を、名前が name の window の 名前付きオブジェクト のリストに設定します。

    このアルゴリズムが Web IDL によって呼び出されない のであれば、そのようなオブジェクトが少なくとも1つは存在します。

  2. objects に ナビゲーブル が含まれている場合は、次の操作を行います。

    1. container を、window の 関連付けられた Document の 子孫 の中で、 objects に コンテンツナビゲーブル が含まれている最初の ナビゲーブルコンテナ に設定します。

    2. container の コンテンツナビゲーブル の アクティブな WindowProxy を返します。

  3. それ以外の場合、objects に要素が1つしかない場合は、その要素を返します。

  4. それ以外の場合、window の 関連付けられた Document をルートとし、そのフィルタが window の名前が name の 名前付きオブジェクト のみを一致させる HTMLCollection を返します。（定義により、これらはすべて要素になります。）

名前付きオブジェクトは、Window オブジェクト window の名前 name の、上記のアルゴリズムの目的のための次のものを含みます:

Window インターフェイスには、[Global] 拡張属性があるため、その名前付きプロパティは、 名前付きプロパティオブジェクト の規則に従い、 レガシープラットフォームオブジェクト の規則には従いません。

window.top

Window/top

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android4+Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

最上位のトラバーサブルのためのWindowProxyを返します。

window.opener [ = value ]

Window/opener

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

opener ブラウジングコンテキストのためのWindowProxyを返します。

存在しない場合、または null に設定されている場合は null を返します。

null に設定することができます。

window.parent

Window/parent

すべての現在のエンジンでサポートされています。

Firefox1+Safari1.3+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

親ナビゲーブルのためのWindowProxyを返します。

window.frameElement

Window/frameElement

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

ナビゲーブルコンテナ要素を返します。

存在しない場合、およびクロスオリジンの状況では null を返します。

topの getter 手順は以下の通りです:

  1. もしthisのナビゲーブルが null であれば、null を返します。

  2. thisのナビゲーブルの最上位トラバーサブルのアクティブなWindowProxyを返します。

openerの getter 手順は以下の通りです:

  1. current をthisのブラウジングコンテキストとします。

  2. もしcurrent が null であれば、null を返します。

  3. もしcurrent のopener ブラウジングコンテキスト が null であれば、null を返します。

  4. current のopener ブラウジングコンテキストのWindowProxyオブジェクトを返します。

openerの setter 手順は以下の通りです:

  1. 指定された値が null であり、thisのブラウジングコンテキストが null でない場合、thisのブラウジングコンテキストのopener ブラウジングコンテキストを null に設定します。

  2. 指定された値が null でない場合、DefinePropertyOrThrow(this, "opener", { [[Value]]: 指定された値, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true })を実行します。

window.opener を null に設定すると、opener ブラウジングコンテキストの参照がクリアされます。実際には、これにより将来のスクリプトが自身のopener ブラウジングコンテキストのWindowオブジェクトにアクセスできなくなります。

デフォルトでは、スクリプトは自身のopener ブラウジングコンテキストのWindowオブジェクトにアクセスできます。例えば、スクリプトはwindow.opener.locationを設定し、opener ブラウジングコンテキストをナビゲートさせることができます。

parentの getter 手順は以下の通りです:

  1. navigable をthisのナビゲーブルとします。

  2. もしnavigable が null であれば、null を返します。

  3. もしnavigable の親が null でなければ、navigable をnavigableの親に設定します。

  4. navigable のアクティブなWindowProxyを返します。

frameElementの getter 手順は以下の通りです:

  1. current をthisのノードナビゲーブルとします。

  2. もしcurrent が null であれば、null を返します。

  3. container をcurrentのコンテナとします。

  4. もしcontainer が null であれば、null を返します。

  5. もしcontainer のノードドキュメントのオリジンが同一オリジンドメインと一致しない場合、null を返します。

  6. container を返します。

これらのプロパティが null を返す場合の例は次のとおりです:

<!DOCTYPE html>
 <iframe></iframe>
 
 <script>
 "use strict";
 const element = document.querySelector("iframe");
 const iframeWindow = element.contentWindow;
 element.remove();
 
 console.assert(iframeWindow.top === null);
 console.assert(iframeWindow.parent === null);
 console.assert(iframeWindow.frameElement === null);
 </script>

ここで、iframeWindowに対応するブラウジングコンテキストは、elementがドキュメントから削除されたときにnulled outされました。

7.2.2.5 歴史的なブラウザーインターフェース 要素のAPI

歴史的な理由から、Window インターフェースには、特定のウェブブラウザーインターフェース要素の可視性を表すプロパティが含まれていました。

プライバシーと互換性の理由から、これらのプロパティは現在、 Windowの ブラウジングコンテキストの is popupプロパティが真であるか 偽であるかを表す値を返します。

各インターフェース要素はBarPropオブジェクトで表されます：

BarProp

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android? 
[Exposed=Window]
 interface BarProp {
   readonly attribute boolean visible;
 };
window.locationbar.visible

Window/locationbar

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android?
window.menubar.visible

Window/menubar

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android?
window.personalbar.visible

Window/personalbar

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
window.scrollbars.visible

Window/scrollbars

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
window.statusbar.visible

Window/statusbar

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
window.toolbar.visible

Window/toolbar

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (Legacy)12+Internet ExplorerNo
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android?

Windowがポップアップでない場合は true を返し、それ以外の場合は false を返します。

BarProp/visible

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera?Edge79+
Edge (レガシー)12+Internet Explorerなし
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android?

visible ゲッターの手順は次のとおりです:

  1. browsingContext を this の 関連するグローバルオブジェクト の ブラウジングコンテキスト に設定します。

  2. browsingContext が null である場合、true を返します。

  3. browsingContext の トップレベルブラウジングコンテキスト の ポップアップ であるかどうかの否定を返します。

次の BarProp オブジェクトは、各 Window オブジェクトに対して存在する必要があります:

ロケーションバー BarProp オブジェクト
歴史的に、ブラウザのロケーションバーを表示するコントロールを含むユーザーインターフェイス要素を表していました。
メニューバー BarProp オブジェクト
歴史的に、メニュー形式のコマンドリスト、または類似のインターフェイス概念を含むユーザーインターフェイス要素を表していました。
パーソナルバー BarProp オブジェクト
歴史的に、ユーザーのお気に入りのページへのリンク、または類似のインターフェイス概念を含むユーザーインターフェイス要素を表していました。
スクロールバー BarProp オブジェクト
歴史的に、スクロール機構、または類似のインターフェイス概念を含むユーザーインターフェイス要素を表していました。
ステータスバー BarProp オブジェクト
歴史的に、ドキュメントの直下または後に見つかるユーザーインターフェイス要素で、通常は進行中のネットワークアクティビティや、ユーザーのポインティングデバイスが現在示している要素に関する情報を提供するものを表していました。
ツールバー BarProp オブジェクト
歴史的に、ドキュメントの直前または上に見つかるユーザーインターフェイス要素で、通常はセッション履歴の移動（戻るボタンや進むボタン、再読み込みボタンなど）を提供するものを表していました。

locationbar 属性は、ロケーションバー BarProp オブジェクト を返す必要があります。

menubar 属性は、メニューバー BarProp オブジェクト を返す必要があります。

personalbar 属性は、パーソナルバー BarProp オブジェクト を返す必要があります。

scrollbars 属性は、スクロールバー BarProp オブジェクト を返す必要があります。

statusbar 属性は、ステータスバー BarProp オブジェクト を返す必要があります。

toolbar 属性は、ツールバー BarProp オブジェクト を返す必要があります。

歴史的な理由から、status 属性は、Window オブジェクトで、取得時には設定された最後の文字列を返し、設定時には新しい値に設定されます。Window オブジェクトが作成されると、属性は空文字列に設定される必要があります。それ以外のことは行いません。

7.2.2.6 Window オブジェクトのスクリプト設定

ウィンドウ環境設定オブジェクトを設定するために、URL creationURL、JavaScript実行コンテキスト execution context、nullまたは環境 reservedEnvironment、URL topLevelCreationURL、およびオリジン topLevelOriginが与えられた場合、次の手順を実行します。

  1. realm を execution context の Realm コンポーネントの値に設定します。

  2. window を realm の グローバルオブジェクト に設定します。

  3. settings object を新しい環境設定オブジェクトに設定し、そのアルゴリズムを次のように定義します。

    Realm実行コンテキスト

    execution context を返します。

    モジュールマップ

    window に関連付けられた Document のモジュールマップを返します。

    APIベースURL

    window に関連付けられた Document の現在のベースURLを返します。

    オリジン

    window に関連付けられた Document のオリジンを返します。

    ポリシーコンテナ

    window に関連付けられた Document のポリシーコンテナを返します。

    クロスオリジン孤立機能

    次の2つの条件を満たす場合は true を、それ以外の場合は false を返します。

    時間起源

    window に関連付けられた Document の読み込みタイミング情報のナビゲーション開始時間を返します。

  4. もし reservedEnvironment が null でない場合は、次の手順を実行します。

    1. settings object のid を reservedEnvironment のid に設定し、ターゲットブラウジングコンテキストを reservedEnvironment のターゲットブラウジングコンテキストに設定し、アクティブサービスワーカーを reservedEnvironment のアクティブサービスワーカーに設定します。

    2. reservedEnvironment のid を空の文字列に設定します。

      予約された環境の識別情報は、作成された環境設定オブジェクトに完全に転送されたと見なされます。この時点から、予約された環境はそのidによって検索されることはありません。

  5. それ以外の場合は、settings object のid を新しい一意の不透明な文字列に設定し、settings object のターゲットブラウジングコンテキストを null に設定し、settings object のアクティブサービスワーカーを null に設定します。

  6. settings object の作成URL を creationURL に設定し、settings object の最上位作成URL を topLevelCreationURL に設定し、settings object の最上位オリジン を topLevelOrigin に設定します。

  7. realm の [[HostDefined]] フィールドを settings object に設定します。

7.2.3 WindowProxy エキゾチックオブジェクト

WindowProxy は、Window 通常オブジェクトをラップするエキゾチックオブジェクトであり、ほとんどの操作をラップされたオブジェクトに間接的に行います。各ブラウジングコンテキストには、関連付けられたWindowProxyオブジェクトがあります。ブラウジングコンテキストがナビゲートされると、ブラウジングコンテキストに関連付けられたWindowProxyオブジェクトによってラップされているWindowオブジェクトが変更されます。

WindowProxyエキゾチックオブジェクトは、以下で明示的に指定されている場合を除き、通常の内部メソッドを使用しなければなりません。

WindowProxyインターフェースオブジェクトは存在しません。

すべてのWindowProxyオブジェクトには、ラップされたWindowオブジェクトを表す[[Window]]内部スロットがあります。

WindowProxyは「プロキシ」と名付けられていますが、実際のプロキシのようにターゲットの内部メソッドで多態性ディスパッチを行うことはありません。これは、WindowProxyオブジェクトとLocationオブジェクトの間でメカニズムを再利用するためです。Windowオブジェクトが通常オブジェクトである限り、これは観測不可能であり、どちらの方法でも実装できます。

7.2.3.1 [[GetPrototypeOf]] ( )

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. IsPlatformObjectSameOrigin(W) が true である場合、! OrdinaryGetPrototypeOf(W) を返す。

  3. null を返す。

7.2.3.2 [[SetPrototypeOf]] ( V )

  1. ! SetImmutablePrototype(this, V) を返す。

7.2.3.3 [[IsExtensible]] ( )

  1. true を返す。

7.2.3.4 [[PreventExtensions]] ( )

  1. false を返す。

7.2.3.5 [[GetOwnProperty]] ( P )

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. P が 配列インデックスプロパティ名 である場合、以下を行う。

    1. index を ! ToUint32(P) とする。

    2. children を、W の関連するDocument の ドキュメントツリーの子ナビゲーブル とする。

    3. value を undefined とする。

    4. index が children の サイズ 未満である場合、以下を行う。

      1. children を昇順にソートし、navigableA が navigableB よりも小さいと見なす。navigableA の コンテナ が、navigableB の コンテナ よりも先に W の 関連するDocument に挿入された場合。

      2. value を children[index] の アクティブなWindowProxy に設定する。

    5. value が undefined の場合、以下を行う。

      1. IsPlatformObjectSameOrigin(W) が true である場合、undefined を返す。

      2. "SecurityError" DOMException をスローする。

    6. PropertyDescriptor{ [[Value]]: value, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: true } を返す。

  3. IsPlatformObjectSameOrigin(W) が true である場合、! OrdinaryGetOwnProperty(W, P) を返す。

    これは、既存のウェブコンテンツとの互換性を維持するための、JavaScript 仕様の必須内部メソッドの不変条件に対する意図的な違反です。詳細については、tc39/ecma262 issue #672 を参照してください。[JAVASCRIPT]

  4. property を、CrossOriginGetOwnPropertyHelper(W, P) とする。

  5. property が undefined でない場合、それを返す。

  6. property が undefined であり、P が W のドキュメントツリーの子ナビゲーブルターゲット名プロパティセットに存在する場合、以下を行う。

    1. value を、P の名前を持つ W の名前付きオブジェクト のアクティブなWindowProxy に設定する。

    2. PropertyDescriptor{ [[Value]]: value, [[Enumerable]]: false, [[Writable]]: false, [[Configurable]]: true } を返す。

      プロパティディスクリプタが列挙可能でない理由は、既存のウェブコンテンツとの互換性のためです。この点については、issue #3183 を参照してください。

  7. ? CrossOriginPropertyFallback(P) を返す。

7.2.3.6 [[DefineOwnProperty]] (P, Desc)

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. IsPlatformObjectSameOrigin(W) が true である場合、以下を行う。

    1. P が 配列インデックスプロパティ名 である場合、false を返す。

    2. ? OrdinaryDefineOwnProperty(W, P, Desc) を返す。

      これは、既存のウェブコンテンツとの互換性を維持するための、JavaScript 仕様の必須内部メソッドの不変条件に対する意図的な違反です。詳細については、tc39/ecma262 issue #672 を参照してください。[JAVASCRIPT]

  3. "SecurityError" DOMException をスローする。

7.2.3.7 [[Get]] (P, Receiver)

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. 2つのブラウジングコンテキスト間のアクセスを報告する必要があるかを確認する、現在のグローバルオブジェクトのブラウジングコンテキスト、W のブラウジングコンテキスト、P、および 現在の設定オブジェクト を指定して。

  3. IsPlatformObjectSameOrigin(W) が true である場合、? OrdinaryGet(this, P, Receiver) を返す。

  4. ? CrossOriginGet(this, P, Receiver) を返す。

this が渡されるのは、W ではなく、OrdinaryGet とCrossOriginGet が [[GetOwnProperty]] 内部メソッドを呼び出すためです。

7.2.3.8 [[Set]] (P, V, Receiver)

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. 2つのブラウジングコンテキスト間のアクセスを報告する必要があるかを確認する、現在のグローバルオブジェクトのブラウジングコンテキスト、W のブラウジングコンテキスト、P、および 現在の設定オブジェクト を指定して。

  3. IsPlatformObjectSameOrigin(W) が true である場合、以下を行う。

    1. P が 配列インデックスプロパティ名 である場合、false を返す。

    2. ? OrdinarySet(W, P, V, Receiver) を返す。

  4. ? CrossOriginSet(this, P, V, Receiver) を返す。

    this が渡されるのは、W ではなく、CrossOriginSet が [[GetOwnProperty]] 内部メソッドを呼び出すためです。

7.2.3.9 [[Delete]] (P)

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. IsPlatformObjectSameOrigin(W) が true である場合、以下を行う。

    1. P が 配列インデックスプロパティ名 である場合、以下を行う。

      1. desc を ! this.[[GetOwnProperty]](P) に設定する。

      2. desc が未定義である場合、true を返す。

      3. false を返す。

    2. ? OrdinaryDelete(W, P) を返す。

  3. "SecurityError" DOMException をスローする。

7.2.3.10 [[OwnPropertyKeys]] ( )

  1. W を、this の [[Window]] 内部スロットの値とする。

  2. maxProperties を、W の関連付けられたDocumentの文書ツリーの子ナビゲーブルのサイズとする。

  3. keys を排他的範囲 0 から maxProperties まで（maxProperties を除く）の範囲に設定する。

  4. IsPlatformObjectSameOrigin(W) が true である場合、keys と OrdinaryOwnPropertyKeys(W) を連結して返す。

  5. keys と ! CrossOriginOwnPropertyKeys(W) を連結して返す。

7.2.4 Location インターフェース

Document/location

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (レガシー)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

Location

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

Window/location

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (レガシー)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

各 Window オブジェクトには、そのオブジェクトが作成されるときに割り当てられる Location オブジェクトの一意のインスタンスが関連付けられます。

Location エキゾチックオブジェクトは、IDL の寄せ集め、作成後の JavaScript 内部メソッドの呼び出し、および JavaScript 内部メソッドのオーバーライドを通じて定義されています。その厳しいセキュリティ ポリシーと相まって、このような奇怪なオブジェクトを実装する際には、特に注意を払ってください。

Location オブジェクトを作成するには、次の手順を実行します。

  1. location を新しい Location プラットフォームオブジェクト にします。

  2. valueOf を location の 関連する realm の [[Intrinsics]] に設定します。[[%Object.prototype.valueOf%]]。

  3. ! location.[[DefineOwnProperty]]("valueOf", { [[Value]]: valueOf, [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }) を実行します。

  4. ! location.[[DefineOwnProperty]](%Symbol.toPrimitive%, { [[Value]]: undefined, [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }) を実行します。

  5. [[DefaultProperties]] 内部スロットの値を location の [[OwnPropertyKeys]]() に設定します。

  6. location を返します。

valueOf と %Symbol.toPrimitive% の独自データ プロパティの追加、およびすべての Location の IDL 属性が [LegacyUnforgeable] としてマークされているという事実は、Location インターフェースを参照するレガシー コードが必要とするものです。または、それを文字列化して、ドキュメント URL を決定し、それをセキュリティ上重要な方法で使用するためです。特に、valueOf、%Symbol.toPrimitive%、および [LegacyUnforgeable] の文字列化対策により、foo[location] = bar や location + "" などのコードが誤って誘導されないようにしています。

document.location [ = value ]
window.location [ = value ]

現在のページの場所を持つ Location オブジェクトを返します。

別のページに移動するために設定できます。

Document オブジェクトの location ゲッターの手順は、次のとおりです。this の 関連するグローバルオブジェクト の Location オブジェクトを返します。this が 完全にアクティブ である場合、そうでない場合は null を返します。

Window オブジェクトの location ゲッター手順は、次のとおりです。this の Location オブジェクトを返します。

Location オブジェクトは、関連する Document の URL の表現と、関連するナビゲーション および再読み込みのメソッドを提供します。

[Exposed=Window]
 interface Location { // but see also additional creation steps and overridden internal methods
   [LegacyUnforgeable] stringifier attribute USVString href;
   [LegacyUnforgeable] readonly attribute USVString origin;
   [LegacyUnforgeable] attribute USVString protocol;
   [LegacyUnforgeable] attribute USVString host;
   [LegacyUnforgeable] attribute USVString hostname;
   [LegacyUnforgeable] attribute USVString port;
   [LegacyUnforgeable] attribute USVString pathname;
   [LegacyUnforgeable] attribute USVString search;
   [LegacyUnforgeable] attribute USVString hash;
 
   [LegacyUnforgeable] undefined assign(USVString url);
   [LegacyUnforgeable] undefined replace(USVString url);
   [LegacyUnforgeable] undefined reload();
 
   [LegacyUnforgeable, SameObject] readonly attribute DOMStringList ancestorOrigins;
 };
location.toString()
location.href

Location/href

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location/toString

すべての現行エンジンでサポートされています。

Firefox22+Safari1+Chrome52+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Location オブジェクトの URL を返します。

設定すると、指定された URL へナビゲートします。

location.origin

Location/origin

すべての現行エンジンでサポートされています。

Firefox21+Safari5.1+Chrome8+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android3+Samsung Internet?Opera Android?

Location オブジェクトの URL のオリジンを返します。

location.protocol

Location/protocol

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のスキームを返します。

設定すると、スキームが変更された同じ URL へナビゲートします。

location.host

Location/host

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のホストおよびポート (スキームのデフォルト ポートとは異なる場合)。

設定すると、ホストおよびポートが変更された同じ URL へナビゲートします。

location.hostname

Location/hostname

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のホストを返します。

設定すると、ホストが変更された同じ URL へナビゲートします。

location.port

Location/port

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のポートを返します。

設定すると、ポートが変更された同じ URL へナビゲートします。

location.pathname

Location/pathname

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のパスを返します。

設定すると、パスが変更された同じ URL へナビゲートします。

location.search

Location/search

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のクエリ (非空の場合、先頭の「?」を含む) を返します。

設定すると、クエリが変更された同じ URL へナビゲートします (先頭の「?」は無視されます)。

location.hash

Location/hash

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer3+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Location オブジェクトの URL のフラグメント (非空の場合、先頭の「#」を含む) を返します。

設定すると、フラグメントが変更された同じ URL へナビゲートします (先頭の「#」は無視されます)。

location.assign(url)

Location/assign

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera3+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

指定された URL へナビゲートします。

location.replace(url)

Location/replace

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

現在のページをセッション履歴から削除し、指定された URL へナビゲートします。

location.reload()

Location/reload

すべての現行エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (レガシー)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

現在のページを再読み込みします。

location.ancestorOrigins

Location/ancestorOrigins

FirefoxサポートなしSafari6+Chrome20+
Opera不明Edge79+
Edge (レガシー)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS不明Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

DOMStringList オブジェクトを返します。これは、祖先ナビゲーブルの アクティブ ドキュメントのオリジンをリストします。

Location オブジェクトには関連付けられた 関連する Document があり、これはこの Location オブジェクトの 関連するグローバルオブジェクト の ブラウジングコンテキスト の アクティブドキュメント であり、このオブジェクトの 関連するグローバルオブジェクト の browsing context が null でない場合に適用されます。そうでない場合は null です。

Location オブジェクトには関連付けられた URL があり、これはこの Location オブジェクトの 関連する Document の URL であり、この Location オブジェクトの 関連する Document が null でない場合に適用されます。そうでない場合は about:blank です。

Location オブジェクトには関連付けられた 祖先オリジンリスト があり、Location オブジェクトが作成されたとき、その 祖先オリジンリスト は次の手順によって生成される文字列の リスト に基づく DOMStringList オブジェクトに設定されます。

  1. output を新しい文字列の リスト として設定します。

  2. current を Location オブジェクトの 関連する Document として設定します。

  3. current の コンテナドキュメント が null でない限り次を実行します。

    1. current を current の コンテナドキュメント に設定します。

    2. current の オリジン の シリアライゼーション を output に 追加 します。

  4. output を返します。

Location オブジェクト location を URL url にナビゲートするには、オプションで NavigationHistoryBehavior historyHandling (デフォルトは "auto") を指定して次の手順を実行します。

  1. navigable を location の 関連するグローバルオブジェクト の ナビゲーブル として設定します。

  2. sourceDocument を 現職グローバルオブジェクト の 関連する Document として設定します。

  3. location の 関連する Document がまだ 完全にロードされていない 場合、および 現職グローバルオブジェクト が 一時的なアクティベーション を持たない場合は、historyHandling を "replace" に設定します。

  4. sourceDocument を使用して navigable を url に ナビゲート し、exceptionsEnabled を true に設定し、historyHandling を historyHandling に設定します。

href セッターには意図的にセキュリティチェックがありません。

origin ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same-origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. シリアライゼーション を返します。

protocol ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same-origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. this の url の スキーム に続いて ":" を返します。

protocol セッターステップは次のとおりです。

  1. this の 関連する Document が null である場合は、何も行いません。

  2. this の 関連する Document の origin が same-origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. 基本的なURL解析 の結果を、copyURL として url として、与えられた値に続けて ":" とし、スキーム開始状態 を 状態オーバーライド として設定します。

    URLパーサは複数の連続するコロンを無視するため、"https:"（または "https::::"） の値を提供することは、"https" の値を提供することと同じです。

  5. possibleFailure が失敗した場合、"SyntaxError" DOMException をスローします。

  6. copyURL の スキーム が HTTP(S)スキーム でない場合、これらのステップを終了します。

  7. Location-object navigate this を copyURL にナビゲートします。

host ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. url を this の url として設定します。

  3. url の host が null の場合、空文字列を返します。

  4. url の port が null の場合、url の host を シリアライズして 返します。

  5. url の host を シリアライズして 返し、それに ":" と url の port を シリアライズして 追加します。

host セッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. copyURL に 不透明なパス がある場合、何も行いません。

  5. 与えられた値に対して、copyURL を 基本的な URL 解析 し、copyURL を url とし、host state を state override として設定します。

  6. Location-object navigate this を copyURL にナビゲートします。

hostname ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. this の url の host が null の場合、空文字列を返します。

  3. this の url の host を シリアライズして 返します。

hostname セッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. copyURL に 不透明なパス がある場合、何も行いません。

  5. 与えられた値に対して、copyURL を 基本的な URL 解析 し、copyURL を url とし、hostname state を state override として設定します。

  6. Location-object navigate this を copyURL にナビゲートします。

port ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. this の url の port が null の場合、空文字列を返します。

  3. this の url の port を シリアライズして 返します。

port セッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. copyURL が ユーザー名、パスワード、ポートを持つことができない場合、何も行いません。

  5. 与えられた値が空文字列である場合、copyURL の port を null に設定します。

  6. それ以外の場合、基本的な URL 解析 を行い、copyURL を url とし、port state を state override として設定します。

  7. Location-object navigate this を copyURL にナビゲートします。

pathname ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. この Location オブジェクトの url を URL パスのシリアライズを行った結果 を返します。

pathname セッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. copyURL に 不透明なパス がある場合、何も行いません。

  5. copyURL の path を空リストに設定します。

  6. 与えられた値に対して、copyURL を 基本的な URL 解析 し、copyURL を url とし、path start state を state override として設定します。

  7. Location-object navigate this を copyURL にナビゲートします。

search ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. this の url の query が null もしくは空文字列である場合、空文字列を返します。

  3. "?" を返し、続いて this の url の query を返します。

search セッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. 与えられた値が空文字列の場合、copyURL の query を null に設定します。

  5. それ以外の場合、次のサブステップを実行します。

    1. 与えられた値から先頭の "?" を 1 つ削除したものを input とします。

    2. copyURL の query を空文字列に設定します。

    3. 基本的な URL 解析 を input に対して実行し、null、関連する Document の ドキュメントの文字エンコーディング、copyURL を url として、query state を state override として設定します。

  6. Location-object navigate this を copyURL にナビゲートします。

hash ゲッターステップは次のとおりです。

  1. this の 関連する Document が null でなく、その origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  2. this の url の fragment が null もしくは空文字列である場合、空文字列を返します。

  3. "#" を返し、続いて this の url の fragment を返します。

hash セッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. copyURL を this の url のコピーとして設定します。

  4. thisURLFragment を、copyURL のフラグメント（null でない場合）、それ以外の場合は空文字列とします。

  5. 与えられた値から先頭の "#" を 1 つ削除したものを input とします。

  6. copyURL の fragment を空文字列に設定します。

  7. 基本的な URL 解析 を input に対して実行し、copyURL を url とし、fragment state を state override として設定します。

  8. copyURL のフラグメントが thisURLFragment の場合、戻ります。

    このベイルアウトは、スクロール時に冗長に location.hash を設定する 配備済みコンテンツとの互換性のために必要です。他のフラグメントナビゲーションメカニズム、例えば location.href セッターや location.assign() には適用されません。

  9. Location-object navigate this を copyURL にナビゲートします。

a 要素および area 要素の同等の API とは異なり、hash セッターは空文字列を特別扱いしません。これは、配備済みスクリプトとの互換性を維持するためです。

assign(url) メソッドステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. urlRecord を URL のエンコーディングと解析 の結果として、url に基づき、エントリー設定オブジェクト に相対的に設定します。

  4. urlRecord が失敗の場合、"SyntaxError" DOMException をスローします。

  5. Location-object navigate this を urlRecord にナビゲートします。

replace(url) メソッドステップは次のとおりです。

  1. this の 関連する Document が null の場合、何も行いません。

  2. urlRecord を URL のエンコーディングと解析 の結果として、url に基づき、エントリー設定オブジェクト に相対的に設定します。

  3. urlRecord が失敗の場合、"SyntaxError" DOMException をスローします。

  4. Location-object navigate this を urlRecord にナビゲートし、"replace" を指定します。

replace() メソッドには意図的にセキュリティチェックがありません。

reload() メソッドステップは次のとおりです。

  1. document を this の 関連する Document として設定します。

  2. document が null の場合、何も行いません。

  3. document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  4. リロード を document の ノードナビゲーブル に対して行います。

ancestorOrigins ゲッターステップは次のとおりです。

  1. this の 関連する Document が null の場合、空の リスト を返します。

  2. this の 関連する Document の origin が same origin-domain と一致しない場合、"SecurityError" DOMException をスローします。

  3. それ以外の場合、this の ancestor origins list を返します。

ancestorOrigins 属性の動作の詳細はまだ議論の余地があり、変更される可能性があります。詳細については issue #1918 を参照してください。

以前説明したように、Location エキゾチックオブジェクトは、セキュリティ目的のために IDL 以上の追加ロジックを必要とします。Location オブジェクトは、以下に明示的に指定されている場合を除き、通常の内部メソッドを使用する必要があります。

また、すべての Location オブジェクトには、作成時のプロパティを表す [[DefaultProperties]] 内部スロットがあります。

7.2.4.1 [[GetPrototypeOf]] ( )

  1. IsPlatformObjectSameOrigin(this) が true の場合、! OrdinaryGetPrototypeOf(this) を返します。

  2. null を返します。

7.2.4.2 [[SetPrototypeOf]] ( V )

  1. ! SetImmutablePrototype(this, V) を返します。

7.2.4.3 [[IsExtensible]] ( )

  1. true を返します。

7.2.4.4 [[PreventExtensions]] ( )

  1. false を返します。

7.2.4.5 [[GetOwnProperty]] ( P )

  1. IsPlatformObjectSameOrigin(this) が true の場合：

    1. desc を OrdinaryGetOwnProperty(this, P) として設定します。

    2. this の [[DefaultProperties]] 内部スロットの値が P を含む場合、desc.[[Configurable]] を true に設定します。

    3. desc を返します。

  2. property を CrossOriginGetOwnPropertyHelper(this, P) として設定します。

  3. property が undefined でない場合、property を返します。

  4. CrossOriginPropertyFallback(P) を返します。

7.2.4.6 [[DefineOwnProperty]] ( P, Desc )

  1. IsPlatformObjectSameOrigin(this) が true の場合：

    1. this の [[DefaultProperties]] 内部スロットの値が P を含む場合、false を返します。

    2. ? OrdinaryDefineOwnProperty(this, P, Desc) を返します。

  2. "SecurityError" DOMException をスローします。

7.2.4.7 [[Get]] ( P, Receiver )

  1. IsPlatformObjectSameOrigin(this) が true の場合、? OrdinaryGet(this, P, Receiver) を返します。

  2. ? CrossOriginGet(this, P, Receiver) を返します。

7.2.4.8 [[Set]] ( P, V, Receiver )

  1. IsPlatformObjectSameOrigin(this) が true の場合、? OrdinarySet(this, P, V, Receiver) を返します。

  2. ? CrossOriginSet(this, P, V, Receiver) を返します。

7.2.4.9 [[Delete]] ( P )

  1. IsPlatformObjectSameOrigin(this) が true の場合、? OrdinaryDelete(this, P) を返します。

  2. "SecurityError" DOMException をスローします。

7.2.4.10 [[OwnPropertyKeys]] ( )

  1. IsPlatformObjectSameOrigin(this) が true の場合、OrdinaryOwnPropertyKeys(this) を返します。

  2. CrossOriginOwnPropertyKeys(this) を返します。

7.2.5 History インターフェース

History

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

Window/history

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+ 
enum ScrollRestoration { "auto", "manual" };
 
 [Exposed=Window]
 interface History {
   readonly attribute unsigned long length;
   attribute ScrollRestoration scrollRestoration;
   readonly attribute any state;
   undefined go(optional long delta = 0);
   undefined back();
   undefined forward();
   undefined pushState(any data, DOMString unused, optional USVString? url = null);
   undefined replaceState(any data, DOMString unused, optional USVString? url = null);
 };
history.length

History/length

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のセッション履歴エントリの総数を返します。 現在のナビゲーション対象のためのものです。

history.scrollRestoration

History/scrollRestoration

すべての最新エンジンでサポートされています。

Firefox46+Safari11+Chrome46+
Opera?Edge79+
Edge (Legacy)?Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

現在のアクティブな セッション履歴エントリのスクロール復元モードを返します。

history.scrollRestoration = value

現在のアクティブな セッション履歴エントリのスクロール復元モードを valueに設定します。

history.state

History/state

すべての最新エンジンでサポートされています。

Firefox4+Safari6+Chrome19+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のアクティブな セッション履歴エントリのクラシックな履歴API状態を JavaScriptの値にデシリアライズして返します。

history.go()

現在のページを再読み込みします。

history.go(delta)

History/go

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のセッション履歴エントリの リストで指定された数だけ前後に移動します。

デルタがゼロの場合、現在のページを再読み込みします。

デルタが範囲外の場合、何も起こりません。

history.back()

History/back

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のセッション履歴エントリ リストで 1 つ前に戻ります。

前のページがない場合、何も起こりません。

history.forward()

History/forward

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

現在のセッション履歴エントリ リストで 1 つ前に進みます。

次のページがない場合、何も起こりません。

history.pushState(data, "")

History/pushState

すべての最新エンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+

dataのシリアライズされた内容でクラシックな履歴API状態が設定された新しいエントリをセッション履歴に追加します。 新しいエントリの URL としてURLが使用されます。

(2 番目のパラメーターは歴史的な理由で存在しており、省略できません。空文字列を渡すことが伝統的です。)

history.pushState(data, "", url)

dataのシリアライズされた内容でクラシックな履歴API状態が設定され、urlに設定された新しいエントリをセッション履歴に追加します。

現在のドキュメントが urlに書き換えられない場合、"SecurityError" DOMExceptionがスローされます。

(2 番目のパラメーターは歴史的な理由で存在しており、省略できません。空文字列を渡すことが伝統的です。)

history.replaceState(data, "")

History/replaceState

すべての最新エンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+

現在のアクティブな セッション履歴エントリのクラシックな履歴API状態を dataの構造化クローンに更新します。

(2 番目のパラメーターは歴史的な理由で存在しており、省略できません。空文字列を渡すことが伝統的です。)

history.replaceState(data, "", url)

現在のアクティブな セッション履歴エントリのクラシックな履歴API状態を dataの構造化クローンに更新し、そのURLを urlに設定します。

現在のドキュメントが urlに書き換えられない場合、"SecurityError" DOMExceptionがスローされます。

(2 番目のパラメーターは歴史的な理由で存在しており、省略できません。空文字列を渡すことが伝統的です。)

Documentには、履歴オブジェクト、すなわちHistoryオブジェクトがあります。

historyのgetter手順は、thisの関連するDocumentの履歴オブジェクトを返すことです。

各Historyオブジェクトには、最初はnullである状態があります。

各Historyオブジェクトには、非負の整数で初期値が0の長さがあります。

各Historyオブジェクトには、非負の整数で初期値が0のインデックスがあります。

インデックスは直接公開されませんが、同期ナビゲーション中に長さの変化から推測することができます。実際、それがその用途です。

lengthのgetter手順は以下の通りです：

  1. thisの関連するグローバルオブジェクトの関連するDocumentが完全にアクティブでない場合、"セキュリティエラー"のDOMExceptionを投げます。

  2. thisの長さを返します。

scrollRestorationのgetter手順は以下の通りです：

  1. thisの関連するグローバルオブジェクトの関連するDocumentが完全にアクティブでない場合、"セキュリティエラー"のDOMExceptionを投げます。

  2. this の 関連するグローバルオブジェクトの ナビゲブルの アクティブなセッション履歴エントリの スクロール復元モードを返します。

scrollRestorationのsetter手順は以下の通りです：

  1. thisの関連するグローバルオブジェクトの関連するDocumentが完全にアクティブでない場合、"セキュリティエラー"のDOMExceptionを投げます。

  2. this の 関連するグローバルオブジェクトの ナビゲブルの アクティブなセッション履歴エントリの スクロール復元モードを、指定された値に設定します。

stateのgetter手順は以下の通りです：

  1. thisの関連するグローバルオブジェクトの関連するDocumentが完全にアクティブでない場合、"セキュリティエラー"のDOMExceptionを投げます。

  2. thisの状態を返します。

go(delta)のメソッド手順は、delta traverseを実行し、deltaを指定してthisを渡します。

back()のメソッド手順は、delta traverseを実行し、-1を指定してthisを渡します。

forward()のメソッド手順は、delta traverseを実行し、+1を指定してthisを渡します。

delta traverseをdeltaを指定してHistoryオブジェクトhistoryに対して行うための手順は以下の通りです：

  1. documentをhistoryの関連するグローバルオブジェクトの関連するDocumentとします。

  2. documentが完全にアクティブでない場合、"セキュリティエラー"のDOMExceptionを投げます。

  3. deltaが0の場合、documentのナビゲーブルノードをリロードし、終了します。

  4. 履歴をdeltaでトラバースし、documentのナビゲーブルノードのトラバーサブルナビゲーブルをdeltaを指定して実行し、ソースドキュメントをdocumentに設定します。

pushState(data, unused, url)のメソッド手順は、共有履歴のpush/replace state手順を実行し、this、data、url、および"push"を指定します。

replaceState(data, unused, url)のメソッド手順は、共有履歴のpush/replace state手順を実行し、this、data、url、および"replace"を指定します。

共有履歴のpush/replace state手順は、History、dataの値、スカラー値文字列またはnull、url、および履歴処理の動作であるhistoryHandlingを指定して次の手順を実行します：

  1. document を history の 関連するグローバルオブジェクトの 関連付けられた Document とします。

  2. document が完全にアクティブでない場合、 "SecurityError" DOMException をスローします。

  3. オプションで、"SecurityError" DOMException をスローします。 （たとえば、ユーザーエージェントは、タイマーで呼び出されるこれらのメソッドの呼び出し、明確なユーザーアクションに応答してトリガーされないイベントリスナーからの呼び出し、または連続して呼び出される呼び出しを許可しない場合があります。）

  4. serializedData を StructuredSerializeForStorage(data) とします。 例外を再スローします。

  5. newURL を document の URL とします。

  6. url が null または空の文字列でない場合：

    1. newURL を、history の関連する設定オブジェクトを基準として、url を指定してURL のエンコード解析の結果に設定します。

    2. newURL が失敗の場合、"SecurityError" DOMException をスローします。

    3. document の URL を newURL に書き換えることができない場合、"SecurityError" DOMException をスローします。

    ここでの空文字列の特殊なケースは歴史的なものであり、location.href = ""（空文字列で URL 解析を実行する）のようなコードと history.pushState(null, "", "")（それをバイパスする）のようなコードを比較すると、結果の URL が異なります。

  7. navigation を history の 関連するグローバルオブジェクトの ナビゲーション API とします。

  8. continue を、navigationType を historyHandling に設定し、isSameDocument を true に設定し、destinationURL を newURL に設定し、classicHistoryAPIState を serializedData に設定して、navigation でプッシュ/置換/リロード navigate イベントを発行した結果とします。

  9. continue が false の場合、戻ります。

  10. document と newURL を指定し、serializedData を serializedData に設定し、historyHandling を historyHandling に設定して、URL と履歴の更新手順を実行します。

ユーザーエージェントは、ページごとにセッション履歴に追加される状態オブジェクトの数を制限することができます。ページが実装定義の制限に達した場合、ユーザーエージェントは、新しいエントリを追加した後、セッション履歴内のそのDocumentオブジェクトに対する最初のエントリの直後にエントリを削除する必要があります。（したがって、状態履歴は削除に対してFIFOバッファとして動作し、ナビゲーションに対してLIFOバッファとして動作します。）

Documentがdocumentであり、次のアルゴリズムがtrueを返す場合、URLを書き換えることができます。

  1. documentURLをdocumentのURLとします。

  2. もしtargetURLとdocumentURLが、そのスキーム、ユーザー名、パスワード、ホスト、またはポートが異なる場合、falseを返します。

  3. もしtargetURLのスキームがHTTP(S)スキームである場合、trueを返します。

    パス、クエリ、およびフラグメントの違いは、http:およびhttps: URLに対して許容されます。

  4. もしtargetURLのスキームが"file"である場合：

    1. もしtargetURLとdocumentURLが、そのパスコンポーネントが異なる場合、falseを返します。

    2. trueを返します。

    クエリおよびフラグメントの違いはfile: URLに対して許容されます。

  5. もしtargetURLとdocumentURLが、そのパスコンポーネントまたはクエリコンポーネントが異なる場合、falseを返します。

    他の種類のURLでは、フラグメントの違いのみが許容されます。

  6. trueを返します。

documentのURL targetURL URLを書き換えることができるか
https://example.com/home https://example.com/home#about ✅
https://example.com/home https://example.com/home?page=shop ✅
https://example.com/home https://example.com/shop ✅
https://example.com/home https://user:pass@example.com/home ❌
https://example.com/home http://example.com/home ❌
file:///path/to/x file:///path/to/x#hash ✅
file:///path/to/x file:///path/to/x?search ✅
file:///path/to/x file:///path/to/y ❌
about:blank about:blank#hash ✅
about:blank about:blank?search ❌
about:blank about:srcdoc ❌
data:text/html,foo data:text/html,foo#hash ✅
data:text/html,foo data:text/html,foo?search ❌
data:text/html,foo data:text/html,bar ❌
data:text/html,foo data:bar ❌
blob:https://example.com/77becafe-657b-4fdc-8bd3-e83aaa5e8f43 blob:https://example.com/77becafe-657b-4fdc-8bd3-e83aaa5e8f43#hash ✅
blob:https://example.com/77becafe-657b-4fdc-8bd3-e83aaa5e8f43 blob:https://example.com/77becafe-657b-4fdc-8bd3-e83aaa5e8f43?search ❌
blob:https://example.com/77becafe-657b-4fdc-8bd3-e83aaa5e8f43 blob:https://example.com/anything ❌
blob:https://example.com/77becafe-657b-4fdc-8bd3-e83aaa5e8f43 blob:path ❌

Document のURL のみが重要であり、そのオリジンは重要ではないことに注意してください。これらは、継承されたオリジンを持つ about:blank Document、サンドボックス化された iframe、または document.domain セッターが使用された場合などに不一致になる可能性があります。

ユーザーが座標に沿って移動できるゲームを考えてみましょう。ユーザーは常にどこかの座標にいて、その座標に対応するページをブックマークして後で戻ることができます。

そのようなゲームでx=5の位置を実装する静的ページは、次のようになります：

<!DOCTYPE HTML>
<!-- このページは https://example.com/line?x=5 です -->
<html lang="ja">
<title>ラインゲーム - 5</title>
<p>あなたはラインの座標5にいます。</p>
<p>
<a href="?x=6">6に進む</a>か、<a href="?x=4">4に戻る</a>?
</p>

このようなシステムの問題は、ユーザーがクリックするたびに、ページ全体がリロードされることです。代わりに、スクリプトを使用してこれを解決する方法を以下に示します：

<!DOCTYPE HTML>
<!-- このページは https://example.com/line?x=5 です -->
<html lang="ja">

<title>ラインゲーム - 5</title>

<p>あなたはラインの座標 <span id="coord">5</span> にいます。</p>

<p>

<a href="?x=6" onclick="go(1); return false;">6に進む</a>か、<a href="?x=4" onclick="go(-1); return false;">4に戻る</a>?
</p>

<script>

var currentPage = 5; // サーバーによって事前入力されています

function go(d) {

setupPage(currentPage + d);

history.pushState(currentPage, "", '?x=' + currentPage);

}

onpopstate = function(event) {

setupPage(event.state);

}

function setupPage(page) {

currentPage = page;

document.title = 'ラインゲーム - ' + currentPage;

document.getElementById('coord').textContent = currentPage;

document.links[0].href = '?x=' + (currentPage+1);

document.links[0].textContent = '6に進む' + (currentPage+1);

document.links[1].href = '?x=' + (currentPage-1);

document.links[1].textContent = '4に戻る' + (currentPage-1);

}

</script>

スクリプトのないシステムでは、これも前の例と同じように機能します。しかし、スクリプトをサポートしているユーザーは、同じ体験をするためにネットワークアクセスが不要になるため、はるかに高速に移動できます。さらに、単にナイーブなスクリプトベースのアプローチを使用した場合とは対照的に、ブックマークやセッション履歴のナビゲーションが引き続き機能します。

上記の例では、pushState()メソッドのdata引数は、ユーザーが移動するたびにスクリプトがURLを解析しなくても済むように、サーバーに送信される情報と同じですが、より便利な形式になっています。

ほとんどのアプリケーションは、すべての履歴エントリに同じスクロール復元モード値を使用したいと考えています。これを実現するために、scrollRestoration属性をできるだけ早く（たとえば、最初のscript要素の中で）設定し、履歴セッションに追加されるエントリが、希望するスクロール復元モードを確実に取得するようにします。 

<head>
<script>

    if ('scrollRestoration' in history)

         history.scrollRestoration = 'manual';

</script>

</head>

このセクションは規範的ではありません。

ナビゲーションAPIは、グローバルnavigationプロパティによって提供され、ナビゲーションと履歴エントリを管理するためのモダンでウェブアプリケーションに焦点を当てた方法を提供します。これは、従来のlocationおよびhistoryAPIの後継です。

このAPIが提供する機能の1つは、セッション履歴エントリを検査することです。例えば、次のコードはエントリのURLを順序付きリストに表示します:

const ol = document.createElement("ol");
ol.start = 0; // 項目番号がエントリインデックスと一致するように
 
for (const entry of navigation.entries()) {
  const li = document.createElement("li");
 
  if (entry.index < navigation.currentEntry.index) {
    li.className = "backward";
  } else if (entry.index > navigation.currentEntry.index) {
    li.className = "forward";
  } else {
    li.className = "current";
  }
 
  li.textContent = entry.url;
  ol.append(li);
}

navigation.entries()配列には、NavigationHistoryEntryインスタンスが含まれており、ここで示されているurlおよびindexプロパティに加えて他の有用なプロパティを持っています。配列には、現在のナビゲーブルを表すNavigationHistoryEntryオブジェクトのみが含まれているため、その内容はiframeなどのナビゲーブルコンテナ内でのナビゲーションや、iframe内でナビゲーションAPI自体が使用されている場合の親ナビゲーブルのナビゲーションによって影響を受けません。また、同一オリジンのセッション履歴エントリを表すNavigationHistoryEntryオブジェクトのみを含むため、ユーザーが現在のオリジンの前後に他のオリジンを訪問していた場合、それに対応するNavigationHistoryEntryは含まれません。

ナビゲーションAPIは、ナビゲート、リロード、または履歴の移動にも使用できます:

<button onclick="navigation.reload()">Reload</button>
 
 <input type="url" id="navigationURL">
 <button onclick="navigation.navigate(navigationURL.value)">Navigate</button>
 
 <button id="backButton" onclick="navigation.back()">Back</button>
 <button id="forwardButton" onclick="navigation.forward()">Forward</button>
 
 <select id="traversalDestinations"></select>
 <button id="goButton" onclick="navigation.traverseTo(traversalDestinations.value)">Traverse To</button>
 
 <script>
 backButton.disabled = !navigation.canGoBack;
 forwardButton.disabled = !navigation.canGoForward;
 
 for (const entry of navigation.entries()) {
   traversalDestinations.append(new Option(entry.url, entry.key));
 }
 </script>

トラバースは再び同一オリジンの目的地に制限されることに注意してください。つまり、例えば前のセッション履歴エントリが別のオリジンのページである場合、navigation.canGoBackはfalseになります。

ナビゲーションAPIの最も強力な部分は、現在のナビゲーブルでほとんどのナビゲーションやトラバースが発生するたびに発火するnavigateイベントです。

navigation.onnavigate = event => {
  console.log(event.navigationType); // "push", "replace", "reload", "traverse" のいずれか
  console.log(event.destination.url);
  console.log(event.userInitiated);
  // その他の便利なプロパティも参照
};

（このイベントは、ロケーションバーでのナビゲーションの開始や、他のウィンドウから開始されたナビゲーションで、ナビゲーションの目的地が新しいドキュメントである場合には発火しません。）

多くの場合、このイベントのcancelableプロパティはtrueになります。つまり、このイベントはpreventDefault()を使用してキャンセルできます。 

navigation.onnavigate = event => {
  if (event.cancelable && isDisallowedURL(event.destination.url)) {
    alert(`Please don't go to ${event.destination.url}!`);
    event.preventDefault();
  }

あるトラバースナビゲーション、例えば子ナビゲーブル内でのナビゲーションや、他のオリジンへの移行、またはユーザーが前回のpreventDefault()の呼び出し直後に再度トラバースしようとする場合には、cancelableプロパティはfalseになります。

NavigateEventのintercept()メソッドは、ナビゲーションを同一ドキュメントナビゲーションに変換するためにインターセプトすることを可能にします。 

navigation.addEventListener("navigate", e => {
  // いくつかのナビゲーション、例えばオリジンを跨ぐナビゲーションなどはインターセプトできません。
  // それらは通常どおりブラウザに処理させます。
  if (!e.canIntercept) {
    return;
  }
 
  // 同様に、フラグメントナビゲーションやダウンロードリクエストもインターセプトしません。
  if (e.hashChange || e.downloadRequest !== null) {
    return;
  }
 
  const url = new URL(event.destination.url);

  if (url.pathname.startsWith("/articles/")) {
    e.intercept({
      async handler() {

        // URLはすでに変更されているため、新しいコンテンツをフェッチしている間にプレースホルダーを表示します。例えばスピナーやロード画面など。
        renderArticlePagePlaceholder();

        // 新しいコンテンツをフェッチし、準備が整い次第表示します。
        const articleContent = await getArticleContent(url.pathname, { signal: e.signal });
        renderArticlePage(articleContent);
      }
    });
  }
});

handler関数は、ナビゲーションの非同期処理の進行状況と成功または失敗を表すためにPromiseを返すことができます。Promiseがまだ保留中の場合、ブラウザUIはナビゲーションが進行中として扱うことができます（例えば、ローディングスピナーを表示するなど）。ナビゲーションAPIの他の部分もこれらのPromiseに敏感であり、例えばnavigation.navigate()の戻り値にも影響を与えます。 

const { committed, finished } = await navigation.navigate("/articles/the-navigation-api-is-cool");

// committedプロミスは、URLが変更された後に解決します。これは、NavigateEventがキャンセルされていない限り、即座に発生します。
await committed;

// finishedプロミスは、handler()によって返されたPromiseが解決されると解決します。これは、記事がダウンロードされてレンダリングされると完了します。（または、handler()が途中で失敗した場合は拒否されます）。
await finished;
[Exposed=Window]
 interface Navigation : EventTarget {
   sequence<NavigationHistoryEntry> entries();
   readonly attribute NavigationHistoryEntry? currentEntry;
   undefined updateCurrentEntry(NavigationUpdateCurrentEntryOptions options);
   readonly attribute NavigationTransition? transition;
   readonly attribute NavigationActivation? activation;
 
   readonly attribute boolean canGoBack;
   readonly attribute boolean canGoForward;
 
   NavigationResult navigate(USVString url, optional NavigationNavigateOptions options = {});
   NavigationResult reload(optional NavigationReloadOptions options = {});
 
   NavigationResult traverseTo(DOMString key, optional NavigationOptions options = {});
   NavigationResult back(optional NavigationOptions options = {});
   NavigationResult forward(optional NavigationOptions options = {});
 
   attribute EventHandler onnavigate;
   attribute EventHandler onnavigatesuccess;
   attribute EventHandler onnavigateerror;
   attribute EventHandler oncurrententrychange;
 };
 
 dictionary NavigationUpdateCurrentEntryOptions {
   required any state;
 };
 
 dictionary NavigationOptions {
   any info;
 };
 
 dictionary NavigationNavigateOptions : NavigationOptions {
   any state;
   NavigationHistoryBehavior history = "auto";
 };
 
 dictionary NavigationReloadOptions : NavigationOptions {
   any state;
 };
 
 dictionary NavigationResult {
   Promise<NavigationHistoryEntry> committed;
   Promise<NavigationHistoryEntry> finished;
 };
 
 enum NavigationHistoryBehavior {
   "auto",
   "push",
   "replace"
 };

各Windowには、ナビゲーションAPIが関連付けられており、これはNavigationオブジェクトです。Windowオブジェクトが作成されると、そのナビゲーションAPIは、そのWindowオブジェクトの関連レルムで作成された新しいNavigationオブジェクトに設定される必要があります。

navigationゲッターの手順は、thisのナビゲーションAPIを返すことです。

以下は、イベントハンドラー（およびそれに対応するイベントハンドラーイベントタイプ）であり、イベントハンドラーIDL属性として、Navigationインターフェースを実装するすべてのオブジェクトによってサポートされる必要があります。

イベントハンドラー イベントハンドラーイベントタイプ
onnavigate navigate
onnavigatesuccess navigatesuccess
onnavigateerror navigateerror
oncurrententrychange currententrychange

各Navigationには、関連する エントリリスト、リストがあり、それは最初は空のNavigationHistoryEntry オブジェクトのリストです。

各Navigationには、関連する現在のエントリインデックスがあり、それは最初は-1の整数です。

Navigation navigationの現在のエントリは、次のステップを実行した結果です:

  1. navigationがエントリとイベントが無効になっている場合、 nullを返します。

  2. アサート: navigationの現在のエントリインデックスは-1ではありません。

  3. navigationのエントリリスト[navigationの現在のエントリインデックス]を返します。

Navigation navigationがエントリとイベントが無効である場合、それは次のステップがtrueを返す場合です:

  1. documentをnavigationの関連するグローバルオブジェクトの関連するDocumentに設定します。

  2. documentが完全にアクティブでない場合、trueを返します。

  3. documentの初期about:blankがtrueの場合、trueを返します。

  4. documentのオリジンが不透明の場合、trueを返します。

  5. falseを返します。

セッション履歴エントリ sheのNavigation navigationのナビゲーションAPIエントリインデックスを取得するには、次のステップを実行します:

  1. indexを0に設定します。

  2. 各 nheのnavigationのエントリリストを次のステップで繰り返します:

    1. nheのセッション履歴エントリがsheと等しい場合、indexを返します。

    2. indexを1増やします。

  3. -1を返します。

ナビゲーションAPI全体で使用される主要な型の1つは、NavigationType列挙型です:

enum NavigationType {
  "push",
  "replace",
  "reload",
  "traverse"
 };

これは主にウェブ開発者に見える「ナビゲーション」のタイプを捉えたもので、（他の場所で説明されているように）この標準の単一のナビゲートアルゴリズムとは正確には一致しません。各値の意味は次のとおりです:

"push"
navigateへの呼び出しに対応し、その履歴処理の挙動が「push」として終了するか、history.pushState()への呼び出しに対応します。
"replace"
navigateへの呼び出しに対応し、その履歴処理の挙動が「replace」として終了するか、history.replaceState()への呼び出しに対応します。
"reload"
リロードへの呼び出しに対応します。
"traverse"
履歴をデルタでトラバースする呼び出しに対応します。

NavigationType列挙型の値の空間は、仕様内部の履歴処理の挙動型の値の空間のスーパーセットです。この標準のいくつかの部分は、この重複を利用して、NavigationTypeを期待するアルゴリズムに履歴処理の挙動を渡すことがあります。

7.2.6.4 エントリリストの初期化と更新

新しいドキュメントのためにナビゲーションAPIエントリを初期化するには、 Navigation navigation、リストとしてのセッション履歴エントリ newSHEs、 およびセッション履歴エントリ initialSHEを指定します。

  1. アサート: navigationのエントリリストが空であることを確認します。

  2. アサート: navigationの現在のエントリインデックスが -1であることを確認します。

  3. もしnavigationがエントリとイベントが無効である場合、 そのまま終了します。

  4. 各 newSHEについてnewSHEsを次のように処理します:

    1. newNHEをnavigationの新しい NavigationHistoryEntryとして作成します。

    2. newNHEのセッション履歴エントリを newSHEに設定します。

    3. Append newNHEをnavigationのエントリリストに追加します。

    newSHEsはもともとナビゲーションAPIのためのセッション履歴エントリを取得から来たものであり、各newSHEはinitialSHEと同じオリジンで連続しています。

  5. navigationの現在のエントリインデックスを、 initialSHEのnavigation内でのナビゲーションAPIエントリインデックスの取得結果に設定します。

再アクティベーションのためにナビゲーションAPIエントリを更新するには、 Navigation navigation、リストとしてのセッション履歴エントリ newSHEs、 およびセッション履歴エントリ reactivatedSHEを指定します。

  1. もしnavigationがエントリとイベントが無効である場合、 そのまま終了します。

  2. newNHEsを新しい空のリストとして設定します。

  3. oldNHEsをnavigationのエントリリストのクローンとして設定します。

  4. 各 newSHEについてnewSHEsを次のように処理します:

    1. newNHEをnullに設定します。

    2. もしoldNHEsが含む場合、 セッション履歴エントリが newSHEであるNavigationHistoryEntry matchingOldNHEを次のように処理します:

      1. newNHEをmatchingOldNHEに設定します。

      2. Remove matchingOldNHEをoldNHEsから削除します。

    3. それ以外の場合:

      1. newNHEをnavigationの新しいNavigationHistoryEntryとして作成します。

      2. newNHEのセッション履歴エントリをnewSHEに設定します。

    4. Append newNHEをnewNHEsに追加します。

    newSHEsはもともとナビゲーションAPIのためのセッション履歴エントリを取得から来たものであり、各newSHEはreactivatedSHEと同じオリジンで連続しています。

    このループの終わりまでに、oldNHEsに残っているすべてのNavigationHistoryEntryは、 セッション履歴エントリであり、Documentがbfcache内にあったときに破棄されたものを表しています。

  5. navigationのエントリリストをnewNHEsに設定します。

  6. navigationの現在のエントリインデックスを、reactivatedSHEのnavigation内でのナビゲーションAPIエントリインデックスの取得結果に設定します。

  7. グローバルタスクをキューに追加し、 navigationの関連するグローバルオブジェクトで次のステップを実行します:

    1. 各 disposedNHEについてoldNHEsを次のように処理します:

      1. 「dispose」イベントを発火し、disposedNHEに送信します。

    これらのステップをタスクで遅延させるのは、dispose イベントがpageshow イベントの後に発火されることを保証するためです。これにより、pageshow が再アクティベーション後にページが受け取る最初のイベントになります。

    （ただし、このアルゴリズムの残りは、pageshow イベントが発火する前に実行されます。これにより、navigation.entries() およびnavigation.currentEntry の値が正しく更新され、pageshow イベントハンドラ内で使用できるようになります。）

同一ドキュメントナビゲーションのためにナビゲーションAPIエントリを更新するには、 Navigation navigation、セッション履歴エントリ destinationSHE、 およびNavigationType navigationTypeを指定します:

  1. もしnavigationがエントリとイベントが無効である場合、 そのまま終了します。

  2. oldCurrentNHEをnavigationの現在のエントリとして設定します。

  3. disposedNHEsを新しい空のリストとして設定します。

  4. もしnavigationTypeが「traverse」である場合:

    1. navigationの現在のエントリインデックスを、 destinationSHEのnavigation内でのナビゲーションAPIエントリインデックスの取得結果に設定します。

    2. アサート: navigationの現在のエントリインデックスが -1ではないことを確認します。

    このアルゴリズムは同一ドキュメントのトラバーサルにのみ呼び出されます。クロスドキュメントのトラバーサルは、代わりに新しいドキュメントのためにナビゲーションAPIエントリを初期化するか、 再アクティベーションのためにナビゲーションAPIエントリを更新します。

  5. それ以外の場合、もしnavigationTypeが「push」である場合:

    1. navigationの現在のエントリインデックスをnavigationの現在のエントリインデックス + 1に設定します。

    2. iをnavigationの現在のエントリインデックスに設定します。

    3. i < navigationのエントリリストのサイズ:

      1. Append navigationのエントリリスト[i] をdisposedNHEsに追加します。

      2. iをi + 1に設定します。

    4. Removeすべての項目をdisposedNHEsからnavigationのエントリリストから削除します。

  6. それ以外の場合、もしnavigationTypeが「replace」である場合:

    1. Append oldCurrentNHEをdisposedNHEsに追加します。

  7. もしnavigationTypeが「push」 または 「replace」 である場合:

    1. newNHEをnavigationの新しいNavigationHistoryEntryとして作成します。

    2. newNHEのセッション履歴エントリをdestinationSHEに設定します。

    3. navigationのエントリリスト[navigationの現在のエントリインデックス]をnewNHEに設定します。

  8. もしnavigationの進行中のAPIメソッドトラッカーがnullでない場合、 コミットされたエントリについて通知し、 navigationの進行中のAPIメソッドトラッカーとnavigationの現在のエントリを指定します。

    これは、disposeまたはcurrententrychangeイベントを発火する前に行うことが重要です。イベントハンドラが別のナビゲーションを開始したり、navigationの進行中のAPIメソッドトラッカーの値を変更する可能性があるためです。

  9. スクリプトの実行準備を行う、 navigationの関連する設定オブジェクトを指定します。

    なぜこれを行うかについては、他のナビゲーションAPIイベントに関する議論を参照してください。

  10. 「currententrychange」イベントを発火し、 navigationでNavigationCurrentEntryChangeEvent を使用し、そのnavigationType 属性をnavigationTypeに初期化し、from属性をoldCurrentNHEに初期化します。

  11. 各 disposedNHEについてdisposedNHEsを次のように処理します:

    1. 「dispose」イベントを発火し、 disposedNHEに送信します。

  12. スクリプト実行後のクリーンアップを行い、 navigationの関連する設定オブジェクトを指定します。

実装において、同一ドキュメントのナビゲーションは、セッション履歴エントリがセッション履歴エントリリストの後ろから消えて破棄される原因となることがあります。これは上記のアルゴリズム（またはこの標準の他の部分）ではまだ対処されていません。このような場合の正しい動作を定義する進捗状況については、issue #8620を参照してください。

7.2.6.5 NavigationHistoryEntry インターフェース
[Exposed=Window]
 interface NavigationHistoryEntry : EventTarget {
   readonly attribute USVString? url;
   readonly attribute DOMString key;
   readonly attribute DOMString id;
   readonly attribute long long index;
   readonly attribute boolean sameDocument;
 
   any getState();
 
   attribute EventHandler ondispose;
 };
entry.url

このナビゲーション履歴エントリのURL。

このエントリが現在のDocument と異なるsameDocument （falseの場合）に対応している場合、この値はnullを返すことがあります。また、そのDocument が「no-referrer」または「origin」のリファラーポリシーで取得された場合、該当するDocument は、同一オリジンの他のページからでもURLを隠していることを示しています。

entry.key

このナビゲーション履歴エントリのナビゲーション履歴リスト内での位置を表す、ユーザーエージェント生成のランダムなUUID文字列。この値は、「replace」 ナビゲーションのためにこのエントリを置き換える他のNavigationHistoryEntryインスタンスによって再利用され、リロードやセッションの復元でも維持されます。

これは、navigation.traverseTo(key) を使用して、ナビゲーション履歴リスト内のこのエントリに戻るために役立ちます。

entry.id

この特定のナビゲーション履歴エントリを表す、ユーザーエージェント生成のランダムなUUID文字列。この値は、他のNavigationHistoryEntry インスタンスによって再利用されることはありません。この値はリロードやセッションの復元でも維持されます。

これは、他のストレージAPIを使用して、このナビゲーション履歴エントリにデータを関連付けるのに役立ちます。

entry.index

このNavigationHistoryEntry がnavigation.entries() 内のどの位置にあるかを示します。ナビゲーション履歴エントリリストにない場合は−1を返します。

entry.sameDocument

このナビゲーション履歴エントリが現在のDocument と同じかどうかを示します。このエントリがフラグメントナビゲーションやシングルページアプリのナビゲーションを表す場合、これはtrueになります。

entry.getState()

このエントリに保存された状態のデシリアライズを返します。これはnavigation.navigate() またはnavigation.updateCurrentEntry() を使用してエントリに追加されたものです。この状態はリロードやセッションの復元でも維持されます。

一般的に、状態値がプリミティブでない限り、entry.getState() !== entry.getState()であることに注意してください。なぜなら、毎回新しいデシリアライズが返されるためです。

この状態は、従来の履歴APIのhistory.state とは無関係です。

各NavigationHistoryEntry には、関連するセッション履歴エントリがあり、これはセッション履歴エントリです。

NavigationHistoryEntry nheのキーは、次のアルゴリズムの戻り値によって決まります:

  1. nheの関連するグローバルオブジェクトの関連するDocument が完全にアクティブでない場合、空の文字列を返します。

  2. nheのセッション履歴エントリのナビゲーションAPIキー を返します。

NavigationHistoryEntry nheのIDは、次のアルゴリズムの戻り値によって決まります:

  1. nheの関連するグローバルオブジェクトの関連するDocument が完全にアクティブでない場合、空の文字列を返します。

  2. nheのセッション履歴エントリのナビゲーションAPI ID を返します。

NavigationHistoryEntry nheのインデックスは、次のアルゴリズムの戻り値によって決まります:

  1. nheの関連するグローバルオブジェクトの関連するDocument が完全にアクティブでない場合、−1を返します。

  2. ナビゲーションAPIエントリインデックスの取得の結果を返します。 これは、thisのセッション履歴エントリ のnavigation内での結果です。

urlのゲッターステップは次のとおりです:

  1. documentをthisの関連するグローバルオブジェクト の関連するDocumentに設定します。

  2. documentが完全にアクティブでない場合、空の文字列を返します。

  3. sheをthisのセッション履歴エントリに設定します。

  4. もしsheのドキュメントがdocumentと等しくない場合、またsheのドキュメント状態のリファラーポリシー が「no-referrer」または「origin」である場合、nullを返します。

  5. sheのURLをシリアライズされたものとして返します。

keyのゲッターステップは、thisのキーを返すことです。

idのゲッターステップは、thisのIDを返すことです。

indexのゲッターステップは、thisのインデックスを返すことです。

sameDocumentのゲッターステップは次のとおりです:

  1. documentをthisの関連するグローバルオブジェクト の関連するDocumentに設定します。

  2. documentが完全にアクティブでない場合、falseを返します。

  3. thisのセッション履歴エントリのドキュメントがdocumentと等しい場合はtrueを返し、それ以外の場合はfalseを返します。

getState()メソッドステップは次のとおりです:

  1. thisの関連するグローバルオブジェクトの関連するDocument が完全にアクティブでない場合、undefinedを返します。

  2. StructuredDeserialize(thisのセッション履歴エントリのナビゲーションAPIステート)を返します。 例外が発生した場合は再スローします。

    これは理論的には、十分なメモリが利用できない場合に大きなArrayBufferをデシリアライズしようとした場合に、例外をスローする可能性があります。

次に示すのは、すべてのNavigationHistoryEntry インターフェースを実装するオブジェクトが、イベントハンドラーIDL属性としてサポートしなければならないイベントハンドラーとその対応するイベントハンドラーイベントタイプです:

イベントハンドラー イベントハンドラーイベントタイプ
ondispose dispose
7.2.6.6 履歴エントリリスト
entries = navigation.entries()

NavigationHistoryEntry インスタンスの配列を返します。これらは現在のナビゲーション履歴エントリリスト、すなわち、このナビゲーブルのためのすべてのセッション履歴エントリを表し、 それらは同一オリジンであり、現在のセッション履歴エントリに連続しています。

navigation.currentEntry

現在のセッション履歴エントリに対応するNavigationHistoryEntry を返します。

navigation.updateCurrentEntry({ state })

現在のセッション履歴エントリのナビゲーションAPIステート を更新しますが、navigation.reload() のようにナビゲーションは行いません。

このメソッドは、すでに行われたページの更新をナビゲーションAPIステートに反映させるために使用するのが最適です。ステートの更新がページの更新を駆動することを意図している場合は、代わりにnavigation.navigate() またはnavigation.reload()を使用します。これによりnavigate イベントがトリガーされます。

navigation.canGoBack

現在の現在のセッション履歴エントリ（すなわち、currentEntry） がナビゲーション履歴エントリリスト（すなわち、entries()） の最初のものではない場合、trueを返します。これは、このナビゲーブルの以前のセッション履歴エントリ が存在し、そのドキュメント状態のオリジン が現在のDocumentのオリジン と同一オリジンであることを意味します。

navigation.canGoForward

現在の現在のセッション履歴エントリ（すなわち、currentEntry） がナビゲーション履歴エントリリスト（すなわち、entries()） の最後のものではない場合、trueを返します。これは、このナビゲーブルの次のセッション履歴エントリ が存在し、そのドキュメント状態のオリジン が現在のDocumentのオリジン と同一オリジンであることを意味します。

entries() メソッドの手順は次のとおりです:

  1. もしthisがエントリとイベントが無効である場合、空のリストを返します。

  2. thisのエントリリストを返します。

    Web IDLのシーケンスタイプ変換ルールにより、これにより各呼び出しで新しいJavaScript配列オブジェクトが作成されることを思い出してください。つまり、navigation.entries() !== navigation.entries()となります。

currentEntryのゲッターステップは、現在のエントリをthisから返すことです。

updateCurrentEntry(options) メソッドの手順は次のとおりです:

  1. 現在のエントリをcurrentとしてthisから取得します。

  2. もしcurrentがnullである場合、"InvalidStateError" DOMExceptionをスローします。

  3. serializedStateを、StructuredSerializeForStorage(options["state"])として取得し、例外を再スローします。

  4. currentのセッション履歴エントリのナビゲーションAPIステートをserializedStateに設定します。

  5. イベントを発火し、thisでNavigationCurrentEntryChangeEventを使用し、そのnavigationType属性をnullに初期化し、そのfrom属性をcurrentに初期化します。

canGoBackのゲッターステップは次のとおりです:

  1. もしthisがエントリとイベントが無効である場合、falseを返します。

  2. アサート: thisの現在のエントリインデックスが-1でないことを確認します。

  3. もしthisの現在のエントリインデックスが0である場合、falseを返します。

  4. trueを返します。

canGoForwardのゲッターステップは次のとおりです:

  1. もしthisがエントリとイベントが無効である場合、falseを返します。

  2. アサート: thisの現在のエントリインデックスが-1でないことを確認します。

  3. もしthisの現在のエントリインデックスがthisのエントリリストのサイズ-1と等しい場合、falseを返します。

  4. trueを返します。

{ committed, finished } = navigation.navigate(url)
{ committed, finished } = navigation.navigate(url, options)

現在のページを指定されたurlにナビゲートします。optionsには次の値を含めることができます:

デフォルトでは、これにより完全なナビゲーション（つまり、現在のURLとフラグメントだけが異なる場合を除き、クロスドキュメントナビゲーション）が実行されます。navigateEvent.intercept()メソッドを使用して、これを同一ドキュメントナビゲーションに変換することができます。

返されるプロミスの挙動は次のとおりです:

いずれの場合も、返されたプロミスが解決されると、それはナビゲート先のNavigationHistoryEntryになります。

{ committed, finished } = navigation.reload(options)

現在のページをリロードします。optionsには、infoとstateを含めることができ、これらは上記の説明に従います。

デフォルトの動作である、ネットワークまたはキャッシュからの現在のページのリロードは、navigateEvent.intercept()メソッドを使用してオーバーライドできます。これを行うと、この呼び出しは状態の更新または適切なinfoの伝達のみを行い、navigateイベントハンドラーが実行するアクションを引き継ぎます。

返されたプロミスの挙動は次のとおりです:

{ committed, finished } = navigation.traverseTo(key)
{ committed, finished } = navigation.traverseTo(key, { info })

最も近い セッション履歴エントリ に NavigationHistoryEntry の指定された key に一致するエントリまで遡る。info は任意の値に設定することができ、それは対応する info プロパティに入力される。対応する NavigateEvent のプロパティに入力される。

そのセッション履歴エントリへの遷移が既に進行中である場合、このメソッドはその元の遷移のプロミスを返し、infoは無視されます。

返されたプロミスの挙動は次のとおりです:

{ committed, finished } = navigation.back(key)
{ committed, finished } = navigation.back(key, { info })

ナビゲーブルが最も近い前のセッション履歴エントリに遷移し、異なるNavigationHistoryEntryに対応してnavigation.currentEntryが変更されるようにします。infoは任意の値に設定でき、対応するinfoプロパティが設定されます。

そのセッション履歴エントリへの遷移が既に進行中である場合、このメソッドはその元の遷移のプロミスを返し、infoは無視されます。

返されたプロミスは、traverseTo()で返されたものと同等の挙動を示します。

{ committed, finished } = navigation.forward(key)
{ committed, finished } = navigation.forward(key, { info })

ナビゲーブルが最も近い前方のセッション履歴エントリに遷移し、異なるNavigationHistoryEntryに対応してnavigation.currentEntryが変更されるようにします。infoは任意の値に設定でき、対応するinfoプロパティが設定されます。

そのセッション履歴エントリへの遷移が既に進行中である場合、このメソッドはその元の遷移のプロミスを返し、infoは無視されます。

返されたプロミスは、traverseTo()で返されたものと同等の挙動を示します。

navigate(url, options) メソッドの手順は次のとおりです:

  1. urlRecord を、url とthis の 関連設定オブジェクト に基づいて URL を解析 した結果とする。

  2. もし urlRecord が失敗した場合、早期エラー結果 を、"SyntaxError" DOMException のエラーとして返す。

  3. document を、this の 関連するグローバルオブジェクト の 関連付けられた Document とする。

  4. もし options["history"] が "push" に設定されていて、urlRecord と document に基づいて ナビゲーションが置き換えである必要がある と判断された場合、早期エラー結果 を、"NotSupportedError" DOMException のエラーとして返す。

  5. state を、options["state"] に設定されたものとし、それが 存在する 場合はそのまま、存在しない場合は undefined とする。

  6. serializedState を StructuredSerializeForStorage(state) とする。これが例外をスローした場合、その例外の 早期エラー結果 を返す。

    この手順は早期に実行されるべきである。なぜならシリアライズはウェブ開発者のコードを呼び出すことがあり、それが後続の手順でチェックされるさまざまなものを変更する可能性があるからである。

  7. document が 完全にアクティブでない 場合、早期エラー結果 を、"InvalidStateError" DOMException のエラーとして返す。

  8. document の アンロードカウンタ が 0 より大きい場合、早期エラー結果 を、"InvalidStateError" DOMException のエラーとして返す。

  9. info を options["info"] に設定されたものとし、それが 存在する 場合はそのまま、存在しない場合は undefined とする。

  10. apiMethodTracker を、info と serializedState を基に 非トラバース API メソッドトラッカーの設定を行うかどうかを決定する の結果とする。

  11. document の ノードナビゲーブル を urlRecord にナビゲートし、document を使用して、履歴ハンドリング を options["history"] に設定し、ナビゲーション API 状態 を serializedState に設定する。

    location.assign() などと異なり、オリジンドメイン 境界を超えて公開されるものでなく、navigation.navigate() は、この window.navigation プロパティへの直接同期アクセスを持つコードのみがアクセスできる。そのため、ナビゲーションのソースドキュメントの帰属についての複雑な問題を回避でき、サンドボックスによってナビゲートが許可されているか のチェックやその付随する 例外有効フラグ の処理は不要となる。我々は、すべてのナビゲーションがこの Navigation オブジェクト自体に対応する Document から来るものとして扱うだけでよい（すなわち document から）。

  12. もし this の 非トラバース API メソッドトラッカー が apiMethodTracker である場合は:

    非トラバース API メソッドトラッカー がまだ apiMethodTracker である場合、これは ナビゲート アルゴリズムが 内部 navigate イベント発火アルゴリズム に到達する前に中止されたことを意味する。それにより、この非トラバース API メソッドトラッカーを進行中に昇格するプロセスが行われなかった。

    1. this の 非トラバース API メソッドトラッカー を null に設定する。

    2. 早期エラー結果 を、"AbortError" DOMException のエラーとして返す。

  13. apiMethodTracker の ナビゲーション API メソッドトラッカーに基づく結果 を返す。

reload(options) メソッドの手順は以下の通りです：

  1. document を this の 関連するグローバルオブジェクト の 関連 Document とします。

  2. serializedState を StructuredSerializeForStorage(undefined) に設定します。

  3. もし options["state"] が存在する場合は、serializedState を StructuredSerializeForStorage(options["state"]) に設定します。もし例外が発生した場合は、その例外に対する 早期エラー結果 を返します。

    この手順を早期に実行することが重要です。シリアライズはウェブ開発者のコードを呼び出す可能性があり、それにより後のステップで確認するさまざまなことが変更されるかもしれません。

  4. その他の場合：

    1. current を 現在のエントリ に設定します。

    2. もし current が null でない場合、serializedState を current の セッション履歴エントリ の ナビゲーションAPIの状態 に設定します。

  5. もし document が 完全にアクティブ でない場合は、早期エラー結果 を返します。

  6. もし document の アンロードカウンター が 0 より大きい場合は、早期エラー結果 を返します。

  7. info を options["info"] に設定します。それが存在しない場合は undefined に設定します。

  8. apiMethodTracker を設定する結果を APIメソッドトラッカーの設定を試みる に基づいて返します。

  9. リロード を document の ナビゲーション可能なノード に対して実行します。

  10. APIメソッドトラッカーから派生した結果 を返します。

traverseTo(key, options) メソッドの手順は以下の通りです：

  1. もし this の 現在のエントリインデックス が −1 である場合、早期エラー結果 を "InvalidStateError" DOMException で返します。

  2. もし this の エントリリスト に、含まれる セッション履歴エントリ の ナビゲーションAPIキー が key に等しい NavigationHistoryEntry が存在しない場合、早期エラー結果 を "InvalidStateError" DOMException で返します。

  3. ナビゲーションAPIトラバーサルを実行 の結果を、this と key および options を使って返します。

back(options) メソッドの手順は以下の通りです：

  1. もし this の 現在のエントリインデックス が −1 または 0 である場合、早期エラー結果 を "InvalidStateError" DOMException で返します。

  2. key を、this の エントリリスト[this の 現在のエントリインデックス − 1] の セッション履歴エントリ の ナビゲーションAPIキー に設定します。

  3. ナビゲーションAPIトラバーサルを実行 の結果を、this と key および options を使って返します。

forward(options) メソッドの手順は以下の通りです：

  1. もし this の 現在のエントリインデックス が −1 または this の エントリリスト の サイズ − 1 に等しい場合、早期エラー結果 を "InvalidStateError" DOMException で返します。

  2. key を this の エントリリスト[this の 現在のエントリインデックス + 1] の セッション履歴エントリ の ナビゲーションAPIキー に設定します。

  3. ナビゲーションAPIトラバーサルを実行 の結果を、this と key および options を使って返します。

ナビゲーションAPIトラバーサルを実行する には、ナビゲーション navigation、文字列 key、および ナビゲーションオプション options を使用します：

  1. document を navigation の 関連グローバルオブジェクト の 関連する Document に設定します。

  2. もし document が 完全にアクティブ でない場合、早期エラー結果 を "InvalidStateError" DOMException で返します。

  3. もし document の アンロードカウンター が 0 より大きい場合、早期エラー結果 を "InvalidStateError" DOMException で返します。

  4. current を navigation の 現在のエントリ に設定します。

  5. もし key が current の セッション履歴エントリ の ナビゲーションAPIキー と等しい場合、次のように返します：
    «[ "コミット済み" → 解決済みの約束 current, "終了済み" → 解決済みの約束 current ]».

  6. もし navigation の 予定のトラバースAPIメソッドトラッカー[key] が 存在する 場合、ナビゲーションAPIメソッドトラッカー派生結果 を navigation の 予定のトラバースAPIメソッドトラッカー[key] から返します。

  7. info を options["info"] に設定します。存在する場合；そうでなければ、undefined に設定します。

  8. apiMethodTracker を 予定のトラバースAPIメソッドトラッカーを追加する の結果から、navigation と key および info を使って設定します。

  9. navigable を document の ナビゲーブルノード に設定します。

  10. traversable を navigable の トラバーサブルナビゲーブル に設定します。

  11. sourceSnapshotParams を ソーススナップショットパラメータのスナップショットを撮る の結果から、document に対して設定します。

  12. traversable に次のセッション履歴トラバース手順を 追加 します：

    1. navigableSHEs を navigable に対して セッション履歴エントリを取得する の結果から設定します。

    2. targetSHE を navigableSHEs の中で、key に等しい ナビゲーションAPIキー を持つ セッション履歴エントリ に設定します。もしそのようなエントリが存在しない場合、次を実行します：

      1. グローバルタスクをキューに追加 し、navigation の 関連グローバルオブジェクト に対して 終了したプロミスを拒否 し、apiMethodTracker に対して "InvalidStateError" DOMException で作成します。

      2. これらの手順を中止します。

      このパスは、navigation の エントリリスト が navigableSHEs に対して同期される間、履歴の変更に反応してスレッドやプロセスが同期される短期間の間に発生することがあります。

    3. もし targetSHE が navigable の アクティブセッション履歴エントリ である場合、これらの手順を中止します。

      これが発生するのは、以前に キューに追加された トラバースがすでにこの セッション履歴エントリ に到達した場合です。その場合、以前のトラバースがすでに apiMethodTracker を処理済みです。

    4. result を、targetSHE の 手順 によって traversable に対して トラバース履歴手順を適用する の結果から、sourceSnapshotParams、navigable、および "none" を使って設定します。

    5. もし result が "canceled-by-beforeunload" である場合、グローバルタスクをキューに追加 し、navigation の 関連グローバルオブジェクト に対して 終了したプロミスを拒否 し、apiMethodTracker に対して "AbortError" DOMException で作成します。

    6. もし result が "initiator-disallowed" である場合、グローバルタスクをキューに追加 し、navigation の 関連グローバルオブジェクト に対して 終了したプロミスを拒否 し、apiMethodTracker に対して "SecurityError" DOMException で作成します。

      結果が "canceled-by-beforeunload" または "initiator-disallowed" である場合、navigate イベントは発生しません。進行中のナビゲーションを中止する は正しくありません。それにより、navigateerror イベントが発生し、事前の navigate イベントが存在しません。

      "canceled-by-navigate" の場合、navigate は発生しますが、内部 navigate イベント発火アルゴリズム が 進行中のナビゲーションを中止する の処理を行います。

  13. apiMethodTracker に対する ナビゲーションAPIメソッドトラッカー派生結果 を返します。

例外 e の早期エラー結果 は、NavigationResult 辞書インスタンスであり、次のように表されます: «[ "committed" → 拒否されたプロミス e、 "finished" → 拒否されたプロミス e ]»。

ナビゲーションAPIメソッドトラッカー派生結果 は、ナビゲーションAPIメソッドトラッカー に対するものであり、NavigationResult 辞書インスタンスとして次のように表されます: «[ "committed" → apiMethodTracker の コミット済みプロミス、 "finished" → apiMethodTracker の 終了済みプロミス ]»。

7.2.6.8 進行中のナビゲーショントラッキング

任意のナビゲーション（広義の意味で）中、Navigationオブジェクトは、次の事項を追跡する必要があります:

すべてのナビゲーションにおいて
状態 期間 説明
NavigateEvent イベント発火期間中 ナビゲーションがイベント発火中にキャンセルされた場合、イベントをキャンセルできるようにするため
イベントの中止コントローラー ハンドラから返されるすべてのプロミスが完了するまで ナビゲーションがキャンセルされた場合に、中止を通知できるようにするため
新しい要素がフォーカスされたかどうか ハンドラから返されるすべてのプロミスが完了するまで もしフォーカスがあった場合、フォーカスがリセットされないようにするため
ナビゲート先のNavigationHistoryEntry ナビゲート先が決定された時から、ハンドラから返されるすべてのプロミスが完了するまで どのcommittedおよびfinishedプロミスを解決するかを判断するため
返されたfinishedプロミス ハンドラから返されるすべてのプロミスが完了するまで 適切に解決または拒否できるようにするため
"traverse"ナビゲーションではない場合
状態 期間 説明
任意のstate イベント発火期間中 イベントがキャンセルされずに発火が終了した場合、現在のエントリのナビゲーションAPIステートを更新できるようにするため
"traverse"ナビゲーションの場合
状態 期間 説明
任意のinfo タスクがnavigateイベントを発火するためにキューに入れられるまで navigateイベントをセッション履歴トラバーサルキューを経て発火するために使用できるようにするため
返されたcommittedプロミス セッション履歴が更新されるまで（同じタスク内で） 適切に解決または拒否できるようにするため
intercept()が呼び出されたかどうか セッション履歴が更新されるまで（同じタスク内で） 通常のスクロール復元ロジックを抑制し、scrollオプションで指定された動作に置き換えるため

この他にも、次のようなWeb開発者コードが原因で、任意の時点で一度に1つのナビゲーションだけが要求されるとは限りません:

const p1 = navigation.navigate(url1).finished;
    const p2 = navigation.navigate(url2).finished;

つまり、このシナリオでは、url2にナビゲートする間もp1のプロミスを保持しておく必要があります。2回目のnavigate()呼び出しが発生した時点で、進行中のナビゲーションプロミスをすぐに削除することはできません。

これを達成するために、各Navigationに次の事項を関連付けます:

ここで示されている状態は、ナビゲーションAPIメソッドトラッカーに保存されていないものですが、ナビゲーションAPIメソッドを介して開始されないナビゲーションについても追跡する必要がある状態です。

ナビゲーションAPIメソッドトラッカーとは、次の項目を持つ構造体です:

この状態は、以下のアルゴリズムによって管理されます。

今後の非「traverse」APIメソッドトラッカーを設定するかどうかを決定するには、Navigation navigation、JavaScriptの値info、およびシリアライズされた状態またはnullserializedStateを使用します:

  1. committedPromiseおよびfinishedPromiseを、navigationの関連するrealmで新たに作成します。

  2. 処理済みとしてマークする finishedPromise。

    Web開発者がfinishedPromiseの拒否に関心を持たない可能性があります:

    • 彼らはcommittedPromiseのみに関心があるかもしれません。

    • 彼らは同じタスク内で複数の同期ナビゲーションを行っている可能性があり、その場合、最後のものを除いてすべてが中止され（その結果、finishedPromiseが拒否されます）、これはアプリケーションのバグである可能性がありますが、アプリケーションの異なる部分が互いのアクションを上書きすることによって発生する可能性もあります。

    • 彼らはfinishedPromiseよりも他のトランジション失敗シグナル（例: navigateerrorイベント、またはnavigation.transition.finishedプロミス）を好むかもしれません。

    そのため、これがunhandledrejectionイベントをトリガーしないように処理済みとしてマークします。

  3. apiMethodTrackerを新しいナビゲーションAPIメソッドトラッカーとして作成し、以下の項目を設定します:

    ナビゲーションオブジェクト
    navigation
    キー
    null
    情報
    info
    シリアライズされた状態
    serializedState
    コミットされたエントリ
    null
    コミットされたプロミス
    committedPromise
    終了したプロミス
    finishedPromise

  4. アサート: navigationの今後の非「traverse」APIメソッドトラッカーがnullであること。

  5. もしnavigationがエントリとイベントが無効になっていない場合は、navigationの今後の非「traverse」APIメソッドトラッカーをapiMethodTrackerに設定します。

    もしnavigationがエントリとイベントが無効になっている場合、committedPromiseとfinishedPromiseは決して完了しません（NavigationHistoryEntryオブジェクトがこれらのDocumentに対して作成されないため、これを解決するものが何もないためです）。したがって、このAPIメソッド呼び出しを追跡する必要はありません。

  6. apiMethodTrackerを返します。

次のtraverse APIメソッドトラッカーを追加するには、Navigation navigation、文字列destinationKeyおよびJavaScriptの値infoを使用します:

  1. committedPromiseおよびfinishedPromiseを、navigationの関連するrealmで新たに作成します。

  2. 処理済みとしてマークする finishedPromise。

    これが行われる理由については、前述の議論を参照してください。

  3. apiMethodTrackerを新しいナビゲーションAPIメソッドトラッカーとして作成し、以下の項目を設定します:

    ナビゲーションオブジェクト
    navigation
    キー
    destinationKey
    情報
    info
    シリアライズされた状態
    null
    コミットされたエントリ
    null
    コミットされたプロミス
    committedPromise
    終了したプロミス
    finishedPromise

  4. navigation の 今後のトラバース API メソッドトラッカー[destinationKey] を apiMethodTracker に設定します。

  5. apiMethodTrackerを返します。

次のAPIメソッドトラッカーを進行中に昇格するには、Navigation navigationと文字列またはnullのdestinationKeyを使用します:

  1. アサート: navigationの進行中のAPIメソッドトラッカーがnullであること。

  2. もしdestinationKeyがnullでない場合:

    1. アサート: navigationの次の非traverse APIメソッドトラッカーがnullであること。

    2. もしnavigationの次のtraverse APIメソッドトラッカー[destinationKey]が存在する場合:

      1. navigationの進行中のAPIメソッドトラッカーを、navigationの次のtraverse APIメソッドトラッカー[destinationKey]に設定します。

      2. 削除navigationの次のtraverse APIメソッドトラッカー[destinationKey]。

  3. それ以外の場合:

    1. navigationの進行中のAPIメソッドトラッカーを、navigationの次の非traverse APIメソッドトラッカーに設定します。

    2. navigationの次の非traverse APIメソッドトラッカーをnullに設定します。

クリーンアップするには、ナビゲーションAPIメソッドトラッカー apiMethodTrackerを使用します:

  1. navigationをapiMethodTrackerのナビゲーションオブジェクトとして設定します。

  2. もしnavigationの進行中のAPIメソッドトラッカーがapiMethodTrackerである場合は、navigationの進行中のAPIメソッドトラッカーをnullに設定します。

  3. それ以外の場合:

    1. keyをapiMethodTrackerのキーとして設定します。

    2. アサート: keyがnullでないこと。

    3. アサート: navigationの次のtraverse APIメソッドトラッカー[key]が存在すること。

    4. 削除 navigationの次のtraverse APIメソッドトラッカー[key]。

コミットされたエントリについて通知するには、ナビゲーションAPIメソッドトラッカー apiMethodTrackerとNavigationHistoryEntry nheを使用します:

  1. apiMethodTrackerのコミットされたエントリをnheに設定します。

  2. もしapiMethodTrackerのシリアライズされた状態がnullでない場合は、nheのセッション履歴エントリのナビゲーションAPI状態をapiMethodTrackerのシリアライズされた状態に設定します。

    もしnullであれば、navigation.traverseTo()を介してnheに移動しているため、状態を変更することは許可されません。

    この時点で、apiMethodTrackerのシリアライズされた状態は不要となります。実装者は、ナビゲーションAPIメソッドトラッカーの存続期間にわたって保持することを避けるために、それをクリアすることを検討するかもしれません。

  3. apiMethodTrackerのコミットされたプロミスをnheで解決します。

    この時点で、apiMethodTrackerのコミットされたプロミスは、著者のコードにまだ返されていない場合のみ必要です。実装者は、ナビゲーションAPIメソッドトラッカーの存続期間にわたって保持することを避けるために、それをクリアすることを検討するかもしれません。

終了したプロミスを解決するには、ナビゲーションAPIメソッドトラッカー apiMethodTrackerを使用します:

  1. アサート：apiMethodTracker の コミットされたエントリは null ではありません。

  2. apiMethodTracker の 完了したプロミスを、その コミットされたエントリで解決します。

  3. apiMethodTracker をクリーンアップします。

終了したプロミスを拒否するには、ナビゲーションAPIメソッドトラッカー apiMethodTrackerとJavaScriptの値exceptionを使用します:

  1. apiMethodTrackerのコミットされたプロミスをexceptionで拒否します。

    これは、apiMethodTrackerのコミットされたプロミスが以前にコミットされたエントリについて通知するによって解決された場合、何も行いません。

  2. apiMethodTrackerの終了したプロミスをexceptionで拒否します。

  3. クリーンアップする apiMethodTracker。

進行中のナビゲーションを中止するには、Navigation navigationおよびオプションのDOMException errorを使用します:

  1. eventをnavigationの進行中のnavigateイベントとして設定します。

  2. アサート: eventがnullでないこと。

  3. navigationの進行中のナビゲーション中にフォーカスが変更されたをfalseに設定します。

  4. navigationの進行中のナビゲーション中に通常のスクロール復元を抑制するをfalseに設定します。

  5. もしerrorが指定されていない場合、errorを新しい"AbortError" DOMExceptionとして、navigationの関連するrealmで作成します。

  6. もしeventのディスパッチフラグが設定されている場合、eventのキャンセルフラグをtrueに設定します。

  7. 中止をシグナルする eventの中止コントローラに対して、errorを与えます。

  8. navigationの進行中のnavigateイベントをnullに設定します。

  9. errorInfoをerrorからエラー情報を抽出する結果として設定します。

    例えば、このアルゴリズムがwindow.stop()の呼び出しによって到達した場合、これらのプロパティはおそらくwindow.stop()を呼び出したスクリプトの行に基づいて初期化されるでしょう。しかし、ユーザーがストップボタンをクリックした場合、これらのプロパティはおそらく空の文字列や0などのデフォルト値で初期化されるでしょう。

  10. イベントを発火する、名前付きnavigateerrorでnavigationに対してErrorEventを使用し、追加属性はerrorInfoに従って初期化されます。

  11. もしnavigationの進行中のAPIメソッドトラッカーがnullでない場合、apiMethodTrackerに対してerrorで終了したプロミスを拒否するを行います。

  12. もしnavigationのトランジションがnullでない場合:

    1. navigationのトランジションの終了したプロミスをerrorで拒否します。

    2. navigationのトランジションをnullに設定します。

ナビゲーションAPIにナビゲーション中止を通知するには、ナビゲーション可能オブジェクト navigableで行います:

  1. このアルゴリズムがnavigableのアクティブウィンドウの関連エージェントのイベントループで実行されている場合は、次のステップに進みます。それ以外の場合は、グローバルタスクをキューに追加し、navigableのアクティブウィンドウで次のステップを実行します。

  2. navigationをnavigableのアクティブウィンドウのナビゲーションAPIとして設定します。

  3. もしnavigationの進行中のnavigateイベントがnullである場合、終了します。

  4. 進行中のナビゲーションを中止する、navigationを指定して。

ナビゲーションAPIに子ナビゲーション可能オブジェクトの破壊を通知するには、ナビゲーション可能オブジェクト navigableを指定します:

  1. ナビゲーションAPIにナビゲーション中止を通知する、navigableで。

  2. navigationをnavigableのアクティブウィンドウのナビゲーションAPIとして設定します。

  3. traversalAPIMethodTrackersをnavigationの今後のトラバースAPIメソッドトラッカーのクローンとして設定します。

  4. 各 apiMethodTrackerのtraversalAPIMethodTrackersについて、終了したプロミスを拒否する、apiMethodTrackerに対して、"AbortError"をnavigationの関連するrealmで新たに作成したDOMExceptionで拒否します。

進行中のナビゲーションコンセプトは、最も直接的には、navigation.transitionプロパティを通じてWeb開発者に公開されます。これは、NavigationTransitionインターフェースのインスタンスです: 

[Exposed=Window]
 interface NavigationTransition {
   readonly attribute NavigationType navigationType;
   readonly attribute NavigationHistoryEntry from;
   readonly attribute Promise<undefined> finished;
 };
navigation.transition

NavigationTransitionで、まだnavigatesuccessやnavigateerrorステージに到達していない進行中のナビゲーションを表します。もし進行中のトランジションがない場合は、nullを返します。

navigation.currentEntry（およびlocation.hrefなどの他のプロパティ）がナビゲーション直後に即座に更新されるため、このnavigation.transitionプロパティは、navigateEvent.intercept()に渡されたハンドラに従って、ナビゲーションが完全に完了していない場合を判断するのに役立ちます。

navigation.transition.navigationType

このトランジションが何のためのナビゲーションであるかを示す、"push"、"replace"、"reload"、または"traverse"のいずれか。

navigation.transition.from

このトランジションが来ているNavigationHistoryEntry。これをnavigation.currentEntryと比較するのに役立ちます。

navigation.transition.finished

navigatesuccessが発火した時点で、またはnavigateerrorイベントが発火した時点で拒否されるプロミス。

各Navigationには、トランジションがあり、これはNavigationTransitionまたはnullであり、最初はnullです。

transitionのゲッターステップは、こののトランジションを返します。

各NavigationTransitionには、ナビゲーションタイプが関連付けられており、これはNavigationTypeです。

各NavigationTransitionには、元のエントリーが関連付けられており、これはNavigationHistoryEntryです。

各NavigationTransitionには、関連する終了したプロミスがあり、これはプロミスです。

navigationTypeのゲッターステップは、こののナビゲーションタイプを返します。

fromのゲッターステップは、このの元のエントリーを返します。

finishedのゲッターステップは、このの終了したプロミスを返します。

[Exposed=Window]
 interface NavigationActivation {
   readonly attribute NavigationHistoryEntry? from;
   readonly attribute NavigationHistoryEntry entry;
   readonly attribute NavigationType navigationType;
 };
navigation.activation

NavigationActivation は、最も最近のクロスドキュメントナビゲーションに関する情報を含みます。これは、このDocumentを「アクティベート」したナビゲーションです。

navigation.currentEntryおよびDocumentのURLは、同一ドキュメントナビゲーションにより定期的に更新される可能性がありますが、navigation.activationは固定されており、そのプロパティはDocumentが履歴から再アクティベートされた場合のみ更新されます。

navigation.activation.entry

NavigationHistoryEntryは、navigation.currentEntryプロパティの値と等価であり、Documentがアクティベートされた時点のものです。

navigation.activation.from

NavigationHistoryEntryは、現在のDocumentの直前にアクティブだったDocumentを表します。これがnullの値を持つのは、以前のDocumentがこのドキュメントと同一オリジンでなかった場合、またはそれが最初のabout:blankのDocumentであった場合です。

いくつかのケースでは、fromまたはentryのNavigationHistoryEntryオブジェクトが、traverseTo()メソッドの有効なターゲットではない場合があります。これらは履歴に保持されていないかもしれません。例えば、Documentはlocation.replace()を使用してアクティベートされるか、初期エントリがhistory.replaceState()によって置き換えられた可能性があります。しかし、これらのエントリのurlプロパティとgetState()メソッドは依然としてアクセス可能です。

navigation.activation.navigationType

このDocumentをアクティベートしたナビゲーションの種類を示す、"push"、"replace"、"reload"、または"traverse"のいずれかです。

各Navigationには、関連するアクティベーションがあり、それはnullまたはNavigationActivationオブジェクトであり、最初はnullです。

各NavigationActivationには以下のものがあります：

activationのゲッターステップは、こののアクティベーションを返します。

fromのゲッターステップは、このの古いエントリーを返します。

entryのゲッターステップは、このの新しいエントリーを返します。

navigationTypeのゲッターステップは、こののナビゲーションタイプを返します。

7.2.6.10 navigate イベント

ナビゲーションAPIの主要な機能の一つは、navigate イベントです。このイベントは、広義の意味でのあらゆるナビゲーションに対して発生し、Web開発者がそのような発信ナビゲーションを監視できるようにします。多くの場合、このイベントはキャンセル可能であり、ナビゲーションが実行されるのを防ぐことができます。また、他の場合では、ナビゲーションをインターセプトし、intercept() メソッドを使用して、同一ドキュメントナビゲーションに置き換えることができます。

7.2.6.10.1 NavigateEvent インターフェース
[Exposed=Window]
interface NavigateEvent : Event {
  constructor(DOMString type, NavigateEventInit eventInitDict);

  readonly attribute NavigationType navigationType;
  readonly attribute NavigationDestination destination;
  readonly attribute boolean canIntercept;
  readonly attribute boolean userInitiated;
  readonly attribute boolean hashChange;
  readonly attribute AbortSignal signal;
  readonly attribute FormData? formData;
  readonly attribute DOMString? downloadRequest;
  readonly attribute any info;
  readonly attribute boolean hasUAVisualTransition;
  readonly attribute Element? sourceElement;

  undefined intercept(optional NavigationInterceptOptions options = {});
  undefined scroll();
};

dictionary NavigateEventInit : EventInit {
  NavigationType navigationType = "push";
  required NavigationDestination destination;
  boolean canIntercept = false;
  boolean userInitiated = false;
  boolean hashChange = false;
  required AbortSignal signal;
  FormData? formData = null;
  DOMString? downloadRequest = null;
  any info;
  boolean hasUAVisualTransition = false;
  Element? sourceElement = null;
};

dictionary NavigationInterceptOptions {
  NavigationInterceptHandler handler;
  NavigationFocusReset focusReset;
  NavigationScrollBehavior scroll;
};

enum NavigationFocusReset {
  "after-transition",
  "manual"
};

enum NavigationScrollBehavior {
  "after-transition",
  "manual"
};

callback NavigationInterceptHandler = Promise<undefined> ();
event.navigationType

次のいずれか: "push", "replace", "reload", または "traverse", これがどのタイプのナビゲーションであるかを示します。

event.destination

ナビゲーションの目的地を表す NavigationDestination です。

event.canIntercept

このナビゲーションをインターセプトし、通常の動作を置き換えて同一ドキュメント内のナビゲーションに変換できる場合は true、それ以外の場合は false です。

一般的に、現在の Document が目的地のURLに書き換え可能であれば true ですが、クロスドキュメントの "traverse" ナビゲーションの場合は常に false となります。

event.userInitiated

このナビゲーションがユーザーが a 要素をクリックしたり、form 要素を送信したり、ブラウザーのUI を使ってナビゲートした結果である場合は true、それ以外の場合は false です。

event.hashChange

フラグメントナビゲーションであれば true、そうでなければ false です。

event.signal

ナビゲーションがキャンセルされた場合、たとえばユーザーがブラウザの「停止」ボタンを押した場合や、別のナビゲーションがこのナビゲーションを中断した場合に中止される AbortSignal です。

期待されるパターンは、これを開発者が fetch() などの非同期操作に渡すことです。

event.formData

このナビゲーションが "push" または "replace" ナビゲーションであり、フォームの送信を表している場合、このナビゲーションの送信されたフォームエントリを表す FormData です。それ以外の場合は null です。

（特に、"reload" または "traverse" ナビゲーションが、元々フォームの送信から作成された セッション履歴エントリ を再訪している場合でも、これは null です。）

event.downloadRequest

このナビゲーションが a または area 要素の download 属性を使用して、ダウンロードとして要求されたかどうかを表します。

注意すべき点は、ダウンロードが要求されたからといって、必ずしもダウンロードが発生するわけではないことです。たとえば、ダウンロードはブラウザのセキュリティポリシーによってブロックされることがありますし、push ナビゲーションとして扱われることもあります。

同様に、ダウンロードが要求されていなくても、Content-Disposition: attachment ヘッダーを持つサーバーの応答によってダウンロードが発生することがあります。

最後に、右クリックしてリンクのターゲットを保存するなどのブラウザUI機能を使用して開始されたダウンロードの場合、navigate イベントはまったく発生しません。

event.info

このナビゲーションを開始した ナビゲーションAPIメソッド のいずれかを通じて渡された任意のJavaScript値、またはナビゲーションがユーザーまたは他のAPIによって開始された場合は未定義です。

event.hasUAVisualTransition

ユーザーエージェントがこのナビゲーションのために視覚的な遷移を行った場合に true を返します。 true の場合、著者がDOMをポストナビゲーションの状態に同期的に更新することで、最高のユーザーエクスペリエンスが得られます。

event.sourceElement

このナビゲーションの原因となったElement を返します。これは、a または area 要素、送信ボタン、または送信された form 要素のいずれかです。

event.intercept({ handler, focusReset, scroll })

このナビゲーションをインターセプトし、通常の処理を防ぎ、その代わりに目的地のURLへの同一ドキュメントナビゲーションに変換します。

handler オプションは、promiseを返す関数にすることができます。handler関数は、navigate イベントが発生した後に実行され、navigation.currentEntry プロパティが同期的に更新された後に実行されます。この返されたpromiseは、ナビゲーションの期間、成功、または失敗を示すために使用されます。promiseが解決された後、ブラウザはユーザーにナビゲーションが完了したことを通知します（例: ローディングスピナーUIや支援技術を通じて）。さらに、アプリケーションの他の部分が応答できるように、適切に navigatesuccess または navigateerror イベントが発生します。

デフォルトでは、このメソッドを使用すると、handlerの返されたpromiseが解決されたときにフォーカスがリセットされます。フォーカスは、autofocus 属性が設定された最初の要素、または属性が存在しない場合は body要素 にリセットされます。focusReset オプションを "manual" に設定することで、この動作を回避できます。

デフォルトでは、このメソッドを使用すると、"traverse" または "reload" ナビゲーションに対するブラウザのスクロール復元ロジック、または "push" または "replace" ナビゲーションに対するスクロールリセット/フラグメントへのスクロールロジックを、handlerの返されたpromiseが解決されるまで遅らせます。scroll オプションを "manual" に設定して、ブラウザがこのナビゲーションのために行うスクロール動作を完全にオフにするか、promiseが解決される前に scroll() を呼び出して、この動作を早期にトリガーすることができます。

このメソッドは、"SecurityError" DOMException をスローします。canIntercept が false の場合、または isTrusted が false の場合にスローされます。また、同期的に呼び出されなかった場合、イベントディスパッチ中に呼び出されなかった場合には、"InvalidStateError" DOMException をスローします。

event.scroll()

"traverse" または "reload" ナビゲーションの場合、ブラウザの通常のスクロール復元ロジックを使用してスクロール位置を復元します。

"push" または "replace" ナビゲーションの場合、ドキュメントの上部にスクロール位置をリセットするか、destination.url で指定されたフラグメントにスクロールします。

複数回呼び出された場合、またはhandlerの返されたpromiseが解決された後に自動的にポストトランジションスクロール処理が行われた場合や、ナビゲーションがコミットされる前に呼び出された場合、このメソッドは"InvalidStateError" DOMException をスローします。

それぞれの NavigateEvent は、"none"、"intercepted"、"committed"、"scrolled"、または "finished" のいずれかである インターセプション状態 を持ち、初期状態は "none" です。

それぞれの NavigateEvent は、ナビゲーションハンドラーリストを持ち、これは リストであり、NavigationInterceptHandler コールバックが含まれ、初期状態は空です。

それぞれの NavigateEvent は、フォーカスリセットの動作を持ち、これは NavigationFocusReset-or-null であり、初期状態は null です。

それぞれの NavigateEvent は、スクロールの動作を持ち、これは NavigationScrollBehavior-or-null であり、初期状態は null です。

それぞれの NavigateEvent は、アボートコントローラーを持ち、これは AbortController-or-null であり、初期状態は null です。

それぞれの NavigateEvent は、クラシックヒストリーAPI状態を持ち、これは シリアライズされた状態または null です。これは、イベントの navigationType が "push" または "replace" である場合のみに使用され、イベントが 発生したときに適切に設定されます。

navigationType、destination、canIntercept、userInitiated、 hashChange、signal、formData、downloadRequest、info、hasUAVisualTransition、および sourceElement 属性は、初期化された値を返さなければなりません。

intercept(options) メソッドの手順は次のとおりです:

  1. 共通のチェックを実行します thisに対して。

  2. もし this の canIntercept 属性が false に初期化されていた場合、"SecurityError" DOMException をスローします。

  3. もし this の ディスパッチフラグ が未設定の場合、"InvalidStateError" DOMException をスローします。

  4. アサート: this の インターセプション状態 が "none" または "intercepted" であることを確認します。

  5. this の インターセプション状態 を "intercepted" に設定します。

  6. もし options["handler"] が 存在する場合、それを this の ナビゲーションハンドラーリスト に 追加します。

  7. もし options["focusReset"] が 存在する場合、以下を実行します:

    1. もし this の フォーカスリセットの動作 が null ではなく、かつそれが options["focusReset"] と等しくない場合、ユーザーエージェントは前回の呼び出しにおける focusReset オプションの値がこの新しい値によって上書きされたことをコンソールに警告として表示することができます。そして、前回の値は無視されます。

    2. this の フォーカスリセットの動作 を options["focusReset"] に設定します。

  8. もし options["scroll"] が 存在する場合、以下を実行します:

    1. もし this の スクロールの動作 が null ではなく、かつそれが options["scroll"] と等しくない場合、ユーザーエージェントは前回の呼び出しにおける scroll オプションの値がこの新しい値によって上書きされたことをコンソールに警告として表示することができます。そして、前回の値は無視されます。

    2. this の スクロールの動作 を options["scroll"] に設定します。

scroll() メソッドの手順は次のとおりです:

  1. 共通のチェックを実行します thisに対して。

  2. もし this の インターセプション状態 が "committed" でない場合、"InvalidStateError" DOMException をスローします。

  3. スクロール動作を処理します thisに対して。

次の手順を使用して、NavigateEvent eventに対して共通のチェックを実行します:

  1. もし event の 関連するグローバルオブジェクト の 関連するDocument が 完全にアクティブでない場合、"InvalidStateError" DOMException をスローします。

  2. もし event の isTrusted 属性が false に初期化されていた場合、"SecurityError" DOMException をスローします。

  3. もし event の キャンセルフラグ が設定されている場合、"InvalidStateError" DOMException をスローします。

7.2.6.10.2 NavigationDestination インターフェース
[Exposed=Window]
 interface NavigationDestination {
   readonly attribute USVString url;
   readonly attribute DOMString key;
   readonly attribute DOMString id;
   readonly attribute long long index;
   readonly attribute boolean sameDocument;
 
   any getState();
 };
event.destination.url

ナビゲート先のURL。

event.destination.key

ナビゲーションが"traverse"の場合は、目的地のNavigationHistoryEntryのkeyプロパティの値、そうでない場合は空の文字列。

event.destination.id

ナビゲーションが"traverse"の場合は、目的地のNavigationHistoryEntryのidプロパティの値、そうでない場合は空の文字列。

event.destination.index

ナビゲーションが"traverse"の場合は、目的地のNavigationHistoryEntryのindexプロパティの値、そうでない場合は-1。

event.destination.sameDocument

このナビゲーションが現在のDocumentと同じものであるかどうかを示します。これは、例えばフラグメントナビゲーションやhistory.pushState()ナビゲーションの場合にtrueになります。

このプロパティはナビゲーションの元々の性質を示します。クロスドキュメントナビゲーションがnavigateEvent.intercept()を使用して同じドキュメント内のナビゲーションに変換された場合でも、このプロパティの値は変わりません。

event.destination.getState()

"traverse"ナビゲーションの場合、目的地のセッション履歴エントリに保存されている状態をデシリアライズしたものを返します。

"push"または"replace"ナビゲーションの場合、そのナビゲーションがnavigation.navigate()メソッドによって開始されたものであれば、そこに渡された状態のデシリアライズを返し、そうでなければ未定義の値を返します。

"reload"ナビゲーションの場合、そのリロードがnavigation.reload()メソッドによって開始されたものであれば、そこに渡された状態のデシリアライズを返し、そうでなければ未定義の値を返します。

各 NavigationDestination には URL があり、これは URL です。

各 NavigationDestination には entry があり、これは NavigationHistoryEntry か、nullです。

この NavigationDestination が "traverse" ナビゲーションに対応する場合に限り、nullではありません。

各 NavigationDestination には state があり、これは serialized state です。

各 NavigationDestination には is same document があり、これは boolean です。

url の getter 手順は、this の URL を serialized して返します。

key の getter 手順は次のとおりです:

  1. this の entry が null の場合、空の文字列を返します。

  2. this の entry の key を返します。

id の getter 手順は次のとおりです:

  1. this の entry が null の場合、空の文字列を返します。

  2. this の entry の ID を返します。

index の getter 手順は次のとおりです:

  1. this の entry が null の場合、−1 を返します。

  2. this の entry の index を返します。

sameDocument の getter 手順は、this の is same document を返します。

getState() メソッドの手順は、StructuredDeserialize(this の state) を返します。

標準の他の部分は、このセクションで示される一連のラッパーアルゴリズムを通じて、navigate イベントを発火します。

セッション履歴エントリ destinationSHE と、任意の ユーザーのナビゲーション関与度 userInvolvement （デフォルトは "none"）が与えられた場合に、traverse navigate イベントを発火するには、次の手順を実行します。

  1. event を イベント作成 の結果として生成します。NavigateEvent、navigation の 関連する領域 で作成されます。

  2. event の クラシック履歴 API 状態 を null に設定します。

  3. destination を 新しい NavigationDestination として navigation の 関連する領域 で作成します。

  4. destination の URL を destinationSHE の URL に設定します。

  5. destinationNHE を navigation の エントリリスト の中の NavigationHistoryEntry に設定し、destinationSHE の セッション履歴エントリ に関連付けます。関連がない場合は null を設定します。

  6. もし destinationNHE が null でなければ:

    1. destination の エントリ を destinationNHE に設定します。

    2. destination の 状態 を destinationSHE の ナビゲーション API 状態 に設定します。

  7. そうでない場合、

    1. destination の エントリ を null に設定します。

    2. destination の 状態 を StructuredSerializeForStorage(null) に設定します。

  8. destination の is same document を true に設定します。もし destinationSHE の document が navigation の 関連するグローバルオブジェクト の 関連する Document に等しい場合、そうでない場合は false に設定します。

  9. navigation、"traverse"、event、destination、userInvolvement、null、null、および null を指定して、内部 navigate イベント発行アルゴリズムを実行した結果を返します。

Navigation navigation で プッシュ/置換/リロード navigate イベントを発行するには、NavigationType navigationType、URL destinationURL、ブール値 isSameDocument、オプションの ユーザーナビゲーション関与 userInvolvement（デフォルトは "none"）、オプションの Element または null の sourceElement（デフォルトは null）、オプションの エントリリストまたは null の formDataEntryList（デフォルトは null）、オプションの シリアル化された状態 navigationAPIState（デフォルトは StructuredSerializeForStorage(null)）、およびオプションの シリアル化された状態または null の classicHistoryAPIState（デフォルトは null）を指定します：

  1. event を イベント作成 の結果として生成します。NavigateEvent、navigation の 関連する領域 で作成されます。

  2. event の クラシック履歴 API 状態 を classicHistoryAPIState に設定します。

  3. destination を 新しい NavigationDestination として navigation の 関連する領域 で作成します。

  4. destination の URL を destinationURL に設定します。

  5. destination の エントリ を null に設定します。

  6. destination の 状態 を navigationAPIState に設定します。

  7. destination の is same document を isSameDocument に設定します。

  8. navigation、navigationType、event、destination、userInvolvement、sourceElement、formDataEntryList、および null を指定して、内部 navigate イベント発行アルゴリズムを実行した結果を返します。

Navigation navigation で、URL destinationURL、ユーザーナビゲーションの関与 userInvolvement、Element または null の sourceElement、および文字列 filename を指定して、ダウンロード要求 navigate イベントを発行するには：

  1. event を イベント作成 の結果として生成します。NavigateEvent、navigation の 関連する領域 で作成されます。

  2. event の クラシック履歴 API 状態 を null に設定します。

  3. destination を 新しい NavigationDestination として navigation の 関連する領域 で作成します。

  4. destination の URL を destinationURL に設定します。

  5. destination の エントリ を null に設定します。

  6. destination の 状態 を StructuredSerializeForStorage(null) に設定します。

  7. destination の is same document を false に設定します。

  8. navigation、"push"、event、destination、userInvolvement、sourceElement、null、および filename を指定して、内部 navigate イベント発行アルゴリズムを実行した結果を返します。

内部 navigate イベント発行アルゴリズムは、Navigation navigation、NavigationType navigationType、NavigateEvent event、NavigationDestination destination、ユーザーナビゲーションの関与 userInvolvement、Element または null の sourceElement、エントリリストまたは null の formDataEntryList、および文字列または null の downloadRequestFilename を指定して、次のステップで構成されます。

  1. もしnavigationがエントリおよびイベントを無効にしているならば、次の手順を実行します。

    1. 確認します: navigationの進行中のAPIメソッドトラッカーはnullであること。

    2. 確認します: navigationの今後の非トラバースAPIメソッドトラッカーはnullであること。

    3. 確認します: navigationの今後のトラバースAPIメソッドトラッカーは空であること。

    4. 真を返します。

    これらの確認は、traverseTo()、back()、およびforward()が、エントリおよびイベントが無効な場合（トラバースするエントリがないため）即座に失敗すること、そしてnavigate()またはreload()が開始地点である場合、設定を避けたためです。

  2. destinationKeyをnullに設定します。

  3. もしdestinationのエントリがnullでない場合は、destinationKeyをdestinationのエントリのキーに設定します。

  4. 確認します: destinationKeyが空文字列ではないこと。

  5. 今後のAPIメソッドトラッカーを進行中に昇格させます。navigationとdestinationKeyを指定します。

  6. apiMethodTrackerをnavigationの進行中のAPIメソッドトラッカーに設定します。

  7. navigableをnavigationの関連するグローバルオブジェクトのナビゲーション可能に設定します。

  8. documentをnavigationの関連するグローバルオブジェクトの関連付けられたDocumentに設定します。

  9. もしdocumentがそのURLをdestinationのURLに書き換えることができ、かつdestinationの同一ドキュメントが真であるか、navigationTypeが"traverse"でない場合、eventのcanInterceptを真に初期化します。それ以外の場合は偽に初期化します。

  10. 次のいずれかの場合:

    その場合、eventのcancelableを真に初期化します。それ以外の場合は偽に初期化します。

  11. eventのtypeを"navigate"に初期化します。

  12. eventのnavigationTypeをnavigationTypeに初期化します。

  13. eventのdestinationをdestinationに初期化します。

  14. eventのdownloadRequestをdownloadRequestFilenameに初期化します。

  15. もしapiMethodTrackerがnullでない場合、eventのinfoをapiMethodTrackerの情報に初期化します。それ以外の場合は、undefinedに初期化します。

    この時点でapiMethodTrackerの情報はもはや必要なく、ナビゲーションAPIメソッドトラッカーのライフタイム全体で保持せずにクリアできます。

  16. ユーザーエージェントによってdocumentの最新のエントリのキャッシュされたレンダリング状態を表示するためのビジュアル遷移が行われた場合、eventのhasUAVisualTransitionを真に初期化します。それ以外の場合は偽に初期化します。

  17. event の sourceElement を sourceElement に初期化します。

  18. eventの中止コントローラーを、navigationの関連する領域で作成された新しいAbortControllerに設定します。

  19. eventのsignalをeventの中止コントローラーのシグナルに初期化します。

  20. currentURLをdocumentのURLに設定します。

  21. 次のすべてが真である場合:

    その場合、eventのhashChangeを真に初期化します。それ以外の場合は偽に初期化します。

    ここでの最初の条件は、hashChangeがフラグメントナビゲーションの場合には真であるが、history.pushState(undefined, "", "#fragment")のようなケースでは偽であることを意味します。

  22. もしuserInvolvementが"none"でない場合、eventのuserInitiatedを真に初期化します。それ以外の場合は偽に初期化します。

  23. もしformDataEntryListがnullでない場合、eventのformDataを、navigationの関連する領域で作成され、formDataEntryListに関連付けられた新しいFormDataに初期化します。それ以外の場合はnullに初期化します。

  24. 確認します: navigationの進行中のnavigateイベントはnullであること。

  25. navigationの進行中のnavigateイベントをeventに設定します。

  26. navigationの進行中のナビゲーション中にフォーカスが変更されたを偽に設定します。

  27. navigationの進行中のナビゲーション中の通常のスクロール復元を抑制を偽に設定します。

  28. dispatchResultを、イベントをディスパッチする結果として、eventをnavigationにディスパッチすることによって取得します。

  29. もしdispatchResultが偽の場合:

    1. もしnavigationTypeが"traverse"であるなら、navigationの関連するグローバルオブジェクトを指定して履歴アクションのユーザーアクティベーションを消費する。

    2. もしeventの中止コントローラーのシグナルが中止されていない場合、navigationを指定して進行中のナビゲーションを中止する。

    3. 偽を返します。

  30. endResultIsSameDocumentが真である場合、eventのインターセプション状態が"none"でないか、eventのdestinationの同一ドキュメントが真である場合、真に設定します。

  31. スクリプトを実行する準備をします。navigationの関連設定オブジェクトを指定します。

    これは、JavaScript実行コンテキストスタックが空になることを避けるために行われます。これは、currententrychangeイベントハンドラーが、URLおよび履歴の更新ステップに続いてすぐに実行される結果として発生する可能性があります。このステップは、プロミスハンドラーの順序とイベントハンドラーの順序、およびnavigateEvent.intercept()ハンドラーの順序が、ナビゲーションが空のJavaScript実行コンテキストスタック（例えば、ユーザーが起動した場合）で発生するか、空でない場合（例えば、JavaScript API呼び出しによってナビゲーションが引き起こされた場合）で依存することを意味します。

    この手順でスタックに本来不要なJavaScript実行コンテキストを挿入することで、後で実行されるようにプロミスハンドラーマイクロタスクを抑制し、常に次の順序を保証します: currententrychangeイベントハンドラー、intercept()ハンドラー、プロミスハンドラーの順序。

  32. もしeventのインターセプション状態が"none"でない場合:

    1. eventのインターセプション状態を"committed"に設定します。

    2. fromNHEをnavigationの現在のエントリに設定します。

    3. 確認します: fromNHEがnullでないこと。

    4. navigationの遷移を、navigationの関連する領域で作成された新しいNavigationTransitionに設定します。このNavigationTransitionのナビゲーションタイプはnavigationTypeに設定され、fromエントリはfromNHEに設定され、終了したプロミスはnavigationの関連する領域で作成された新しいプロミスに設定されます。

    5. ハンドル済みとしてマークされたnavigationの遷移の終了したプロミス。

      他の終了したプロミスに関する議論を参照してください。

    6. もしnavigationTypeが"traverse"であるなら、navigationの進行中のナビゲーション中の通常のスクロール復元を抑制に設定します。

      もしeventのスクロール動作が"after-transition"に設定されていた場合、スクロール復元は関連するNavigateEventの完了の一部として行われます。それ以外の場合、スクロール復元は行われません。すなわち、intercept()でインターセプトされたナビゲーションは、通常のスクロール復元プロセスを経ることはありません。このようなナビゲーションのスクロール復元は、手動でウェブ開発者が行うか、遷移後に行われます。

    7. もしnavigationTypeが"push"または"replace"である場合、documentとeventのdestinationのURLを指定してURLおよび履歴の更新ステップを実行します。serializedDataはeventのクラシック履歴API状態に設定され、historyHandlingはnavigationTypeに設定されます。

    8. それ以外の場合、navigationType が "reload" の場合、navigation、navigable の アクティブなセッション履歴エントリ、および "reload" を指定して、同一ドキュメントナビゲーションのナビゲーション API エントリを更新します。

      navigationType が "traverse" の場合、このイベント発行はトラバーサルプロセスの一部として発生しており、そのプロセスが適切なセッション履歴エントリの更新を実行します。

  33. もしendResultIsSameDocumentが真である場合:

    1. promisesListを空のリストに設定します。

    2. 各handlerに対して、eventのナビゲーションハンドラーリストの:

      1. 結果を追加します: コールバック関数を呼び出します。空の引数リストでhandlerをpromisesListに追加します。

    3. もしpromisesListのサイズが0である場合、promisesListを「undefinedで解決されたプロミス」に設定します。

      このAPIでは、非常に多くのイベントやプロミスハンドラーがほぼ同時に発生するため、このタイミングの違いは容易に観察できます: それはイベント/プロミスハンドラーの順序を変動させる可能性があります。関与するイベントやプロミスには、navigatesuccess/navigateerror、currententrychange、dispose、apiMethodTrackerのプロミス、およびnavigation.transition.finishedプロミスなどが含まれます。

    4. 全てを待機: promisesListの成功ステップとして:

      1. event の 関連するグローバルオブジェクトの 関連付けられた Document が完全にアクティブでない場合、これらのステップを中止します。

      2. もしeventの中止コントローラーのシグナルが中止されている場合、これらのステップを中止します。

      3. 確認します: eventがnavigationの進行中のnavigateイベントと等しいこと。

      4. navigationの進行中のnavigateイベントをnullに設定します。

      5. 完了: eventを真として完了します。

      6. イベントを発火します: navigationでnavigatesuccessという名前のイベントを発火します。

      7. もしapiMethodTrackerがnullでない場合、終了プロミスを解決します: apiMethodTrackerに対して。

      8. もしnavigationの遷移がnullでない場合、navigationの遷移の終了プロミスを未定義で解決します。

      9. navigationの遷移をnullに設定します。

      そして、次の失敗ステップをrejectionReasonを理由にして実行します:

      1. event の 関連するグローバルオブジェクトの 関連付けられた Document が完全にアクティブでない場合、これらのステップを中止します

      2. もしeventの中止コントローラーのシグナルが中止されている場合、これらのステップを中止します。

      3. 確認します: eventがnavigationの進行中のnavigateイベントと等しいこと。

      4. navigationの進行中のnavigateイベントをnullに設定します。

      5. 完了: eventを偽として完了します。

      6. errorInfoを、エラー情報を抽出: rejectionReasonから得た結果として設定します。

      7. イベントを発火します: navigationでnavigateerrorという名前のイベントを発火します。追加の属性はerrorInfoに従って初期化します。

      8. もしapiMethodTrackerがnullでない場合、終了プロミスを拒否: rejectionReasonを理由にしてapiMethodTrackerに対して行います。

      9. もしnavigationの遷移がnullでない場合、navigationの遷移の終了プロミスをrejectionReasonで拒否します。

      10. navigationの遷移をnullに設定します。

  34. それ以外の場合、もしapiMethodTrackerがnullでない場合、クリーンアップします: apiMethodTracker。

  35. スクリプト実行後のクリーンアップ: navigationの関連する設定オブジェクトを指定します。

    前述のノートに従い、これによりプロミスハンドラーマイクロタスクを抑制することが終了し、それらがこの時点または後で実行されることになります。

  36. もしeventのインターセプション状態が"none"である場合、真を返します。

  37. 偽を返します。

navigateEvent.intercept()を呼び出すことで、Web 開発者は同一ドキュメントナビゲーションの通常のスクロールおよびフォーカス動作を抑制し、代わりに後でクロスドキュメントナビゲーションのような動作を実行できます。このセクションのアルゴリズムは、その後適切なタイミングで呼び出されます。

ブール値didFulfillを指定して、NavigateEventをeventとして終了するには、次の手順に従います:

  1. 確認: eventのインターセプション状態が "intercepted" または "finished" でないことを確認します。

  2. もしeventのインターセプション状態が "none" である場合、終了します。

  3. フォーカスをリセットする可能性をeventに対して実行します。

  4. もしdidFulfillが真であれば、スクロール動作を処理する可能性をeventに対して実行します。

  5. eventのインターセプション状態を "finished" に設定します。

フォーカスをリセットする可能性を、NavigateEventをeventとして実行するには:

  1. 確認: eventのインターセプション状態が "committed" または "scrolled" であることを確認します。

  2. navigationをeventの関連グローバルオブジェクトのナビゲーションAPIとして設定します。

  3. focusChangedを、navigationの進行中のナビゲーション中にフォーカスが変更されたかとして設定します。

  4. navigationの進行中のナビゲーション中にフォーカスが変更されたかをfalseに設定します。

  5. もしfocusChangedがtrueであれば、終了します。

  6. もしeventのフォーカスリセット動作が "manual" であれば、終了します。

    もしそれがnullのままであれば、それを"after-transition"として扱い、処理を続行します。

  7. documentをeventの関連グローバルオブジェクトの関連ドキュメントとして設定します。

  8. focusTargetをオートフォーカスデリゲートとしてdocumentに設定します。

  9. もしfocusTargetがnullであれば、focusTargetをdocumentのボディ要素に設定します。

  10. もしfocusTargetがnullであれば、focusTargetをdocumentのドキュメント要素に設定します。

  11. フォーカシングステップをfocusTargetに対して実行し、documentのビューポートをフォールバックターゲットとして設定します。

  12. シーケンシャルフォーカスナビゲーション開始点をfocusTargetに移動します。

スクロール動作を処理する可能性を、NavigateEventをeventとして実行するには:

  1. 確認: eventのインターセプション状態が "committed" または "scrolled" であることを確認します。

  2. もしeventのインターセプション状態が "scrolled" である場合、終了します。

  3. もしeventのスクロール動作が "manual" である場合、終了します。

    もしそれがnullのままであれば、それを"after-transition"として扱い、処理を続行します。

  4. スクロール動作を処理をeventに対して実行します。

スクロール動作を処理を、NavigateEventをeventとして実行するには:

  1. 確認: eventのインターセプション状態が "committed" であることを確認します。

  2. eventのインターセプション状態を "scrolled" に設定します。

  3. もしeventのナビゲーションタイプが "traverse" または "reload" に初期化されている場合、スクロール位置データを復元し、eventの関連グローバルオブジェクトのナビゲーブルのアクティブセッション履歴エントリを復元します。

  4. それ以外の場合:

    1. documentをeventの関連グローバルオブジェクトの関連ドキュメントとして設定します。

    2. もしdocumentの指定された部分がnullであれば、ドキュメントの先頭にスクロールし、documentに適用します。[CSSOMVIEW]

    3. それ以外の場合、フラグメントにスクロールします。

NavigateEvent インターフェイスは、その複雑さのため、専用のセクションを持っています。

7.2.7.1 NavigationCurrentEntryChangeEvent インターフェイス
[Exposed=Window]
 interface NavigationCurrentEntryChangeEvent : Event {
   constructor(DOMString type, NavigationCurrentEntryChangeEventInit eventInitDict);
 
   readonly attribute NavigationType? navigationType;
   readonly attribute NavigationHistoryEntry from;
 };
 
 dictionary NavigationCurrentEntryChangeEventInit : EventInit {
   NavigationType? navigationType = null;
   required NavigationHistoryEntry from;
 };
event.navigationType

現在のエントリが変更された原因となったナビゲーションの種類を返します。変更がnavigation.updateCurrentEntry()による場合はnullを返します。

event.from

現在のエントリが変更される前のnavigation.currentEntryの以前の値を返します。

もしnavigationType がnullであるか、"reload"である場合、この値はnavigation.currentEntryと同じになります。 この場合、エントリが新しいエントリに移動したり、現在のエントリが置き換えられたりしなくても、エントリの内容が変更されたことを示します。

navigationType およびfrom属性は、初期化された値を返す必要があります。

7.2.7.2 PopStateEvent インターフェイス

PopStateEvent/PopStateEvent

現在のすべてのエンジンでサポートされています。

Firefox11+Safari6+Chrome16+
Opera?Edge79+
Edge (Legacy)14+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

PopStateEvent

現在のすべてのエンジンでサポートされています。

Firefox4+Safari6+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+ 
[Exposed=Window]
 interface PopStateEvent : Event {
   constructor(DOMString type, optional PopStateEventInit eventInitDict = {});
 
   readonly attribute any state;
   readonly attribute boolean hasUAVisualTransition;
 };
 
 dictionary PopStateEventInit : EventInit {
   any state = null;
   boolean hasUAVisualTransition = false;
 };
event.state

PopStateEvent/state

すべての現行エンジンでサポートされています。

Firefox4+ Safari6+ Chrome4+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

pushState() または replaceState() に提供された情報のコピーを返します。

event.hasUAVisualTransition

ユーザーエージェントがこのナビゲーションのためにビジュアルトランジションを実行した場合、trueを返します。trueの場合、作成者がナビゲーション後の状態に同期的にDOMを更新することで、最良のユーザーエクスペリエンスが得られます。

state 属性は、それが初期化された値を返さなければなりません。これはイベントのコンテキスト情報を表すか、状態が Document の初期状態を表す場合はnullを返します。

hasUAVisualTransition 属性も、初期化された値を返さなければなりません。

7.2.7.3 The HashChangeEvent interface

HashChangeEvent/HashChangeEvent

すべての現行エンジンでサポートされています。

Firefox11+ Safari6+ Chrome16+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorerサポートされていません
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

HashChangeEvent

すべての現行エンジンでサポートされています。

Firefox3.6+ Safari5+ Chrome8+
Opera10.6+ Edge79+
Edge (Legacy)12+ Internet Explorer8+
Firefox Android? Safari iOS5+ Chrome Android? WebView Android? Samsung Internet? Opera Android11+ 
[Exposed=Window]
 interface HashChangeEvent : Event {
   constructor(DOMString type, optional HashChangeEventInit eventInitDict = {});
 
   readonly attribute USVString oldURL;
   readonly attribute USVString newURL;
 };
 
 dictionary HashChangeEventInit : EventInit {
   USVString oldURL = "";
   USVString newURL = "";
 };
event.oldURL

HashChangeEvent/oldURL

すべての現行エンジンでサポートされています。

Firefox6+ Safari5.1+ Chrome8+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorerサポートされていません
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

ウィンドウが以前に移動していたURLを返します。

event.newURL

HashChangeEvent/newURL

すべての現行エンジンでサポートされています。

Firefox6+ Safari5.1+ Chrome8+
Opera12.1+ Edge79+
Edge (Legacy)12+ Internet Explorerサポートされていません
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12.1+

ウィンドウが移動している新しいURLを返します。

oldURL 属性は、初期化された値を返さなければなりません。これはイベントのコンテキスト情報を表し、特に以前に移動していた セッション履歴エントリの URL を表します。

newURL 属性は、初期化された値を返さなければなりません。これはイベントのコンテキスト情報を表し、特に現在移動している セッション履歴エントリの URL を表します。

7.2.7.4 PageSwapEvent インターフェース 
[Exposed=Window]
 interface PageSwapEvent : Event {
   constructor(DOMString type, optional PageSwapEventInit eventInitDict = {});
   readonly attribute NavigationActivation? activation;
   readonly attribute ViewTransition? viewTransition;
 };
 
 dictionary PageSwapEventInit : EventInit {
   NavigationActivation? activation = null;
   ViewTransition? viewTransition = null;
 };
event.activation

ナビゲーションアクティベーションオブジェクトは、クロスドキュメントナビゲーションの行き先とタイプを表します。クロスオリジンナビゲーションの場合、この値はnullとなります。

event.activation.entry

ナビゲーション履歴エントリーは、アクティブになろうとしているドキュメントを表します。

event.activation.from

ナビゲーション履歴エントリーは、イベントが発生した瞬間のnavigation.currentEntryプロパティの値と同等です。

event.activation.navigationType

ページスワップを引き起こそうとしているナビゲーションのタイプを示す"プッシュ","リプレイス", "リロード", または"トラバース"のいずれかです。

event.viewTransition

イベントが発生したときにアクティブなクロスドキュメントビュー遷移がある場合、アウトバウンドクロスドキュメントビュー遷移を表すViewTransitionオブジェクトを返します。そうでない場合、nullを返します。

activation属性とviewTransition属性は、初期化された値を返す必要があります。

7.2.7.5 PageRevealEventインターフェース
[Exposed=Window]
 interface PageRevealEvent : Event {
   constructor(DOMString type, optional PageRevealEventInit eventInitDict = {});
   readonly attribute ViewTransition? viewTransition;
 };
 
 dictionary PageRevealEventInit : EventInit {
   ViewTransition? viewTransition = null;
 };
event.viewTransition

イベントが発生したときにアクティブなインバウンドクロスドキュメントビュー遷移がある場合、ViewTransitionオブジェクトを返します。そうでない場合、nullを返します。

viewTransition属性は初期化された値を返す必要があります。

7.2.7.6 PageTransitionEventインターフェース

PageTransitionEvent/PageTransitionEvent

現在のすべてのエンジンでサポートされています。

Firefox11+ Safari6+ Chrome16+
Opera? Edge79+
Edge (Legacy)? Internet ExplorerNo
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android?

PageTransitionEvent

現在のすべてのエンジンでサポートされています。

Firefox1.5+ Safari5+ Chrome4+
Opera? Edge79+
Edge (Legacy)12+ Internet Explorer11
Firefox Android? Safari iOS4+ Chrome Android? WebView Android37+ Samsung Internet? Opera Android? 
[Exposed=Window]
 interface PageTransitionEvent : Event {
   constructor(DOMString type, optional PageTransitionEventInit eventInitDict = {});
 
   readonly attribute boolean persisted;
 };
 
 dictionary PageTransitionEventInit : EventInit {
   boolean persisted = false;
 };
event.persisted

PageTransitionEvent/persisted

すべての現行エンジンでサポートされています。

Firefox11+Safari5+Chrome4+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android?

pageshow イベントでは、ページが新たに読み込まれている場合は false を返します (その場合は load イベントが発生します)。それ以外の場合は true を返します。

pagehide イベントでは、ページが最後に削除される場合は false を返します。それ以外の場合は true を返し、ユーザーがこのページに戻った場合にページが再利用される可能性があることを示します (もし Document の salvageable 状態が true のままであれば)。

ページが再利用できなくなる要因には次のものがあります：

persisted属性は、初期化された値を返す必要があります。これはイベントのコンテキスト情報を表します。

eventNameという名前のページ遷移イベントを発生させるためには、Window windowに対してpersistedというブール値を持つイベントを発生させます。使用するイベントはPageTransitionEventで、persisted属性をpersistedで初期化し、cancelable属性をtrueに、bubbles属性をtrueに初期化し、legacy target override flagをセットします。

cancelableおよびbubblesの値は意味を持ちません。イベントのキャンセルは何も行わず、Windowオブジェクトを超えてバブルすることはできないからです。これらは歴史的な理由でtrueに設定されています。

7.2.7.7 BeforeUnloadEvent インターフェイス

BeforeUnloadEvent

現在のすべてのエンジンでサポートされています。

Firefox1.5+ Safari7+ Chrome30+
Opera? Edge79+
Edge (Legacy)? Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android37+ Samsung Internet3.0+ Opera Android? 
[Exposed=Window]
 interface BeforeUnloadEvent : Event {
   attribute DOMString returnValue;
 };

BeforeUnloadEventに特有の初期化メソッドはありません。

BeforeUnloadEventインターフェイスはレガシーインターフェイスであり、イベントのキャンセルだけでなく、returnValue属性に空文字列以外の値を設定することによっても、アンロードがキャンセルされたかどうかの確認を制御できます。著者はpreventDefault()メソッドや他のイベントキャンセル手段を使用するべきであり、returnValueの使用は避けるべきです。

returnValue属性は、アンロードがキャンセルされたかどうかの確認のプロセスを制御します。イベントが作成されるとき、この属性は空文字列に設定されなければなりません。取得時には最後に設定された値を返し、設定時には新しい値に設定されなければなりません。

この属性は歴史的な理由でDOMStringになっています。空文字列以外の値はすべて、ユーザーに確認を求めるリクエストとして扱われます。

7.2.8 NotRestoredReasonsインターフェイス

[Exposed=Window]
interface NotRestoredReasonDetails {
  readonly attribute DOMString reason;
  [Default] object toJSON();
};

[Exposed=Window]
interface NotRestoredReasons {
  readonly attribute USVString? src;
  readonly attribute DOMString? id;
  readonly attribute DOMString? name;
  readonly attribute USVString? url;
  readonly attribute FrozenArray<NotRestoredReasonDetails>? reasons;
  readonly attribute FrozenArray<NotRestoredReasons>? children;
  [Default] object toJSON();
};
notRestoredReasonDetails.reason

文書が前進/後退キャッシュから提供されなかった理由を説明する文字列を返します。可能な文字列値については、bfcacheブロッキングの詳細の定義を参照してください。

notRestoredReasons.src

文書のノードナビゲーブルのコンテナのsrc属性を返します（それがiframe要素である場合）。設定されていないか、またはそれがiframe要素でない場合、nullを返します。

notRestoredReasons.id

文書のノードナビゲーブルのコンテナのid属性を返します（それがiframe要素である場合）。設定されていないか、またはそれがiframe要素でない場合、nullを返します。

notRestoredReasons.name

文書のノードナビゲーブルのコンテナのname属性を返します（それがiframe要素である場合）。設定されていないか、またはそれがiframe要素でない場合、nullを返します。

notRestoredReasons.url

文書のURLを返します。ただし、文書がクロスオリジンのiframe内にある場合はnullを返します。これは、元のsrcが設定されて以来、iframeがナビゲートされた可能性があるため、srcに加えて報告されます。

notRestoredReasons.reasons

文書に関するNotRestoredReasonDetailsの配列を返します。文書がクロスオリジンのiframe内にある場合は、nullを返します。

notRestoredReasons.children

文書の子に関するNotRestoredReasonsの配列を返します。文書がクロスオリジンのiframe内にある場合は、nullを返します。

NotRestoredReasonDetailsオブジェクトには、バック構造があり、最初はnullで、not restored reason detailsまたはnullが格納されます。

reasonのゲッターステップは、thisのバック構造のreasonを返します。

NotRestoredReasonDetailsオブジェクトを作成するには、not restored reason detailsのbackingStructとrealmのrealmを使用します:

  1. notRestoredReasonDetailsを新しいNotRestoredReasonDetailsオブジェクトとしてrealm内で作成します。

  2. notRestoredReasonDetailsのバック構造をbackingStructに設定します。

  3. notRestoredReasonDetailsを返します。

not restored reason detailsは、次の項目を持つ構造体です:

理由は、ページが前進/後退キャッシュから復元されなかった理由を表す文字列です。文字列は以下のいずれかです。

"fetch"
アンロード中、この Document によって開始されたフェッチがまだ進行中でキャンセルされたため、ページは戻る/進むキャッシュに保存できる状態ではありませんでした。
"navigation-failure"
この Document を作成した元のナビゲーションでエラーが発生したため、結果のエラードキュメントを戻る/進むキャッシュに保存できませんでした。
"parser-aborted"
Document は最初の HTML 解析を完了しなかったため、未完了のドキュメントを戻る/進むキャッシュに保存できませんでした。
"websocket"
アンロード中、開いている WebSocket 接続がシャットダウンされたため、ページは戻る/進むキャッシュに保存できる状態ではありませんでした。[WEBSOCKETS]
"lock"
アンロード中、保持されていた ロックと ロック要求が終了したため、ページは戻る/進むキャッシュに保存できる状態ではありませんでした。[WEBLOCKS]
"masked"
この Document には、クロスオリジンの iframe 内にある子があり、それらが戻る/進むキャッシュを妨げました。または、この Document はユーザーエージェント固有の理由で戻る/進むキャッシュできず、ユーザーエージェントはユーザーエージェント固有のブロック理由のリストからより具体的な理由のいずれかを使用しないことを選択しました。

上記のリストに加えて、ユーザーエージェントは、ユーザーエージェント固有のブロック理由により、ページが戻る/進むキャッシュから復元されるのを妨げた理由を公開することを選択する場合があります。これらは次の文字列のいずれかです。

"audio-capture"
Document は、Media Capture and Streams の getUserMedia() を音声で使用して音声キャプチャ許可を要求しました。[MEDIASTREAM]
"background-work"
Document は、SyncManager の register() メソッド、 PeriodicSyncManager の register() メソッド、または BackgroundFetchManager の fetch() メソッドを呼び出してバックグラウンド作業を要求しました。
"broadcastchannel-message"
ページが戻る/進むキャッシュに保存されている間に、ページ上の BroadcastChannel 接続がメッセージを受信し、message イベントが発生しました。
"idbversionchangeevent"
Document には、アンロード中に保留中の IDBVersionChangeEvent がありました。[INDEXEDDB]
"idledetector"
Document には、アンロード中にアクティブな IdleDetector がありました。
"keyboardlock"
アンロード中、Keyboard の lock() メソッドが呼び出されたため、キーボードロックはまだアクティブでした。
"mediastream"
MediaStreamTrack は、アンロード時にライブ状態でした。[MEDIASTREAM]
"midi"
Document は、navigator.requestMIDIAccess() を呼び出して MIDI 許可を要求しました。
"modals"
ユーザープロンプトは アンロード中に表示されました。
"navigating"
アンロード中、読み込みがまだ進行中だったため、 Document は戻る/進むキャッシュに保存できる状態ではありませんでした。
"navigation-canceled"
ナビゲーション要求は window.stop() を呼び出すことによってキャンセルされ、ページは戻る/進むキャッシュに保存できる状態ではありませんでした。
"non-trivial-browsing-context-group"
この Document のブラウジングコンテキストグループには、複数の トップレベルブラウジングコンテキストがありました。
"otpcredential"
Document は OTPCredential を作成しました。
"outstanding-network-request"
アンロード中、 Document には未処理のネットワーク要求があり、戻る/進むキャッシュに保存できる状態ではありませんでした。
"paymentrequest"
Document には、アンロード中にアクティブな PaymentRequest がありました。[PAYMENTREQUEST]
"pictureinpicturewindow"
Document には、アンロード中にアクティブな PictureInPictureWindow がありました。[PICTUREINPICTURE]
"plugins"
Document にはプラグインが含まれていました。
"request-method-not-get"
Document は、メソッドが `GET` ではない HTTP 要求から作成されました。 [FETCH]
"response-auth-required"
Document は、HTTP 認証を必要とする HTTP 応答から作成されました。
"response-cache-control-no-store"
Document は、`Cache-Control` ヘッダーに "no-store" トークンが含まれている HTTP 応答から作成されました。[HTTP]
"response-cache-control-no-cache"
Document は、`Cache-Control` ヘッダーに "no-cache" トークンが含まれている HTTP 応答から作成されました。[HTTP]
"response-keep-alive"
Document は、`Keep-Alive` ヘッダーを含む HTTP 応答から作成されました。
"response-scheme-not-http-or-https"
Document は、URL の スキームがHTTP(S) スキームではない応答から作成されました。[FETCH]
"response-status-not-ok"
Document は、ステータスがOK ステータスではない HTTP 応答から作成されました。 [FETCH]
"rtc"
アンロード中、RTCPeerConnection または RTCDataChannel がシャットダウンされたため、ページは戻る/進むキャッシュに保存できる状態ではありませんでした。[WEBRTC]
"sensors"
Document はセンサーアクセスを要求しました。
"serviceworker-added"
Document の サービスワーカークライアントが、ページが戻る/進むキャッシュにある間に ServiceWorker によって制御されるようになりました。[SW]
"serviceworker-claimed"
Document の サービスワーカークライアントの アクティブなサービスワーカーが、ページが戻る/進むキャッシュにある間に要求されました。[SW]
"serviceworker-postmessage"
Document の サービスワーカークライアントの アクティブなサービスワーカーが、ページが戻る/進むキャッシュにある間にメッセージを受信しました。[SW]
"serviceworker-version-activated"
Document の サービスワーカークライアントの アクティブなサービスワーカーのバージョンが、ページが戻る/進むキャッシュにある間にアクティブ化されました。 [SW]
"serviceworker-unregistered"
Document の サービスワーカークライアントの アクティブなサービスワーカーの サービスワーカー登録が、ページが戻る/進むキャッシュにある間に登録解除されました。[SW]
"sharedworker"
この Document は、SharedWorkerGlobalScope の所有者セットにありました。
"smartcardconnection"
Document には、アンロード中にアクティブな SmartCardConnection がありました。
"speechrecognition"
Document には、アンロード中にアクティブな SpeechRecognition がありました。
"storageaccess"
Document は、Storage Access API を使用してストレージアクセス許可を要求しました。
"unload-listener"
Document は、unload イベントのイベントリスナーを登録しました。
"video-capture"
Document は、Media Capture and Streams の getUserMedia() をビデオで使用してビデオキャプチャ許可を要求しました。[MEDIASTREAM]
"webhid"
Document は、WebHID API の requestDevice() メソッドを呼び出しました。
"webshare"
Document は、Web Share API の navigator.share() メソッドを使用しました。
"webtransport"
アンロード中、開いている WebTransport 接続がシャットダウンされたため、ページは戻る/進むキャッシュに保存できる状態ではありませんでした。[WEBTRANSPORT]
"webxrdevice"
Document は XRSystem を作成しました。

NotRestoredReasons オブジェクトはバックアップ構造体、未復元の理由またはnullを持ち、初期値はnullです。

NotRestoredReasons オブジェクトは理由の配列、FrozenArray<NotRestoredReasonDetails>またはnullを持ち、初期値はnullです。

NotRestoredReasons オブジェクトは子供の配列、FrozenArray<NotRestoredReasons>またはnullを持ち、初期値はnullです。

srcのgetterのステップは、thisのバックアップ構造体のsrcを返します。

idのgetterのステップは、thisのバックアップ構造体のidを返します。

nameのgetterのステップは、thisのバックアップ構造体のnameを返します。

urlのgetterのステップは次のとおりです：

  1. もしthisのバックアップ構造体のURLがnullなら、nullを返します。

  2. thisのバックアップ構造体のURLを返します。シリアライズされたURLです。

reasonsのgetterのステップは、thisの理由の配列を返します。

childrenのgetterのステップは、thisの子供の配列を返します。

NotRestoredReasonsオブジェクトを作成するには、未復元の理由のbackingStructとrealmを指定します。

  1. notRestoredReasonsを新しいNotRestoredReasonsオブジェクトとしてrealmで作成します。

  2. notRestoredReasonsのバックアップ構造体をbackingStructに設定します。

  3. もしbackingStructの理由がnullなら、notRestoredReasonsの理由の配列をnullに設定します。

  4. それ以外の場合：

    1. reasonsArrayを空のリストとして設定します。

    2. それぞれのreasonに対して、backingStructの理由を反復します：

      1. NotRestoredReasonDetailsオブジェクトを作成するには、reasonとrealmを指定し、それをreasonsArrayに追加します。

    3. notRestoredReasonsの理由の配列を、frozen arrayを作成することによって得られた結果に設定します。

  5. もしbackingStructの子供がnullなら、notRestoredReasonsの子供の配列をnullに設定します。

  6. それ以外の場合：

    1. childrenArrayを空のリストとして設定します。

    2. それぞれのchildに対して、backingStructの子供を反復します：

      1. NotRestoredReasonsオブジェクトを作成するには、childとrealmを指定し、それをchildrenArrayに追加します。

    3. notRestoredReasonsの子供の配列を、frozen arrayを作成することによって得られた結果に設定します。

  7. notRestoredReasonsを返します。

未復元の理由は、次の構造体である：

Document の復元されなかった理由は、Document の ノードナビゲブルがトップレベルのトラバーサブルである場合、その ノードナビゲブルの アクティブなセッション履歴エントリの ドキュメント状態の 復元されなかった理由であり、それ以外の場合は null です。

7.3 ドキュメントのシーケンスのためのインフラストラクチャ

この標準には、ドキュメントのシーケンスをグループ化するためのいくつかの関連する概念が含まれています。簡潔で非規範的な要約として：

この標準の大部分はナビゲーブルの言語で動作しますが、特定のAPIはブラウジングコンテキストの切り替えを明らかにし、そのため標準の一部はブラウジングコンテキストの用語で動作する必要があります。

ナビゲーブルは、アクティブなセッション履歴エントリを介して、ユーザーにDocumentを提示します。各ナビゲーブルには以下のものがあります：

現在のセッション履歴エントリとアクティブなセッション履歴エントリは通常同じですが、以下の状況で同期が取れなくなります：

ナビゲーブルのアクティブなドキュメントは、アクティブなセッション履歴エントリのドキュメントです。

これは、ナビゲーブルの最上位のトラバース可能のセッション履歴トラバーサルキュー内で安全に読み取ることができます。ナビゲーブルのアクティブな履歴エントリは同期的に変更されることがありますが、新しいエントリは常に同じDocumentを持つことになります。

ナビゲーブルのアクティブなブラウジングコンテキストは、そのアクティブなドキュメントのブラウジングコンテキストです。このナビゲーブルがトラバース可能なナビゲーブルである場合、そのアクティブなブラウジングコンテキストは最上位のブラウジングコンテキストになります。

ナビゲーブルのアクティブなWindowProxyは、そのアクティブなブラウジングコンテキストに関連付けられたWindowProxyです。

ナビゲーブルのアクティブなウィンドウは、そのアクティブなWindowProxyの[[Window]]です。

これは常にナビゲーブルのアクティブなドキュメントの関連グローバルオブジェクトと等しくなります。これはアクティブ化アルゴリズムによって同期されます。

ナビゲーブルのターゲット名は、そのアクティブなセッション履歴エントリのドキュメント状態のナビゲーブルターゲット名です。

nodeのノードナビゲーブルを取得するには、nodeのノードに関連するナビゲーブルで、アクティブなドキュメントが nodeのノードドキュメントであるものを返します。該当する ナビゲーブルがない場合はnullを返します。

ナビゲーブルを初期化するには、navigable、ドキュメント状態、およびオプションでparent（デフォルトはnull）を指定します：

  1. アサート：documentStateのドキュメントがnullでないことを確認します。

  2. entryを新しいセッション履歴エントリとして設定します：

    URL
    documentStateのドキュメントのURL
    ドキュメント状態
    documentState

    このアルゴリズムの呼び出し元は、entryのステップを初期化する責任があります。完了するまで「pending」のままになります。

  3. navigableの現在のセッション履歴エントリをentryに設定します。

  4. navigableのアクティブなセッション履歴エントリをentryに設定します。

  5. navigableの親をparentに設定します。

7.3.1.1 トラバース可能なナビゲーブル

トラバース可能なナビゲーブルは、ナビゲーブルであり、セッション履歴エントリの中から、現在のセッション履歴エントリとアクティブなセッション履歴エントリとして自分自身およびその子孫ナビゲーブルに対してどれを選ぶべきかを制御します。

ナビゲーブルのプロパティに加えて、トラバース可能なナビゲーブルは次のものを持ちます：

ナビゲーブルinputNavigableのトラバース可能なナビゲーブルを取得するには：

  1. navigableをinputNavigableに設定します。

  2. navigableがトラバース可能なナビゲーブルでない限り、navigableをnavigableの親に設定します。

  3. navigableを返します。

7.3.1.2 最上位のトラバース可能なナビゲーブル

最上位のトラバース可能なナビゲーブルは、トラバース可能なナビゲーブルであり、親がnullです。

現在、すべてのトラバース可能なナビゲーブルは最上位のトラバース可能なナビゲーブルです。将来の提案では、最上位でないトラバース可能なナビゲーブルの導入が検討されています。

ユーザーエージェントは、トップレベルのトラバーサブルセット（トップレベルのトラバーサブルのセット）を保持します。これらは通常、ブラウザウィンドウまたはブラウザタブの形式でユーザーに提示されます。

ナビゲーブルinputNavigableの最上位のトラバース可能なナビゲーブルを取得するには：

  1. navigableをinputNavigableに設定します。

  2. navigableの親がnullでない限り、navigableをnavigableの親に設定します。

  3. navigableを返します。

新しい最上位のトラバース可能なナビゲーブルを作成するには、ブラウジングコンテキストまたはnullのopener、文字列のtargetName、およびオプションのナビゲーブルopenerNavigableForWebDriverを指定します：

  1. documentをnullに設定します。

  2. もしopenerがnullであれば、documentを新しい最上位のブラウジングコンテキストとドキュメントを作成するの第2の戻り値に設定します。

  3. それ以外の場合は、documentを新しい補助ブラウジングコンテキストとドキュメントを作成するの第2の戻り値に設定します。

  4. documentStateを新しいドキュメント状態に設定し、次のプロパティを持たせます：

    ドキュメント
    document
    イニシエータオリジン
    openerがnullであればnull、それ以外の場合はdocumentのオリジン
    オリジン
    documentのオリジン
    ナビゲーブルターゲット名
    targetName
    about ベースURL
    documentのabout ベースURL

  5. traversableを新しいトラバース可能なナビゲーブルとして設定します。

  6. ナビゲーブルを初期化する traversableにdocumentStateを指定して初期化します。

  7. initialHistoryEntryをtraversableのアクティブなセッション履歴エントリとして設定します。

  8. initialHistoryEntryのステップを0に設定します。

  9. 追加します initialHistoryEntryをtraversableのセッション履歴エントリに。

  10. もしopenerがnullでない場合、トラバース可能なストレージシェッドをレガシークローンするをopenerの最上位のトラバース可能なナビゲーブルおよびtraversableに対して行います。[STORAGE]

  11. 追加しますtraversableをユーザーエージェントの最上位のトラバース可能なナビゲーブルセットに。

  12. WebDriver BiDiナビゲーブルが作成されましたをtraversableとopenerNavigableForWebDriverで呼び出します。

  13. traversableを返します。

新しい最上位のトラバース可能なナビゲーブルを作成するには、URL initialNavigationURLおよびオプションのPOSTリソースまたはnullのinitialNavigationPostResource（デフォルトはnull）を指定します：

  1. traversableを新しい最上位のトラバース可能なナビゲーブルを作成するの結果として設定し、nullおよび空の文字列を指定します。

  2. ナビゲート traversableにinitialNavigationURLを使用して、traversableのアクティブなドキュメントに対して行い、documentResourceをinitialNavigationPostResourceに設定します。

    これらの初期ナビゲーションは、すべての関連するセキュリティチェックが通過することを確実にするために、traversable自体をナビゲートするものとして扱います。

  3. traversableを返します。

7.3.1.3 子ナビゲーブル

特定の要素（例えば、iframe要素）は、ユーザーにナビゲーブルを提示することができます。これらの要素はナビゲーブルコンテナと呼ばれます。

各ナビゲーブルコンテナには、コンテンツナビゲーブルがあり、それはナビゲーブルまたはnullのいずれかです。初期値はnullです。

ナビゲーブルnavigableのコンテナは、そのナビゲーブルコンテナのコンテンツナビゲーブルがnavigableである要素、またはそのような要素がない場合はnullです。

ナビゲーブルnavigableのコンテナドキュメントを取得するには、以下の手順を実行します：

  1. もしnavigableのコンテナがnullであれば、nullを返します。

  2. navigableのコンテナのノードドキュメントを返します。

    これは、navigableのコンテナがシャドウを含むルートと等しいことになります。なぜなら、navigableのコンテナは接続された状態でなければならないからです。

Documentdocumentのコンテナドキュメントを取得するには、以下の手順を実行します：

  1. もしdocumentのノードナビゲーブルがnullであれば、nullを返します。

  2. documentのノードナビゲーブルのコンテナドキュメントを返します。

ナビゲーブルnavigableが別のナビゲーブルpotentialParentの子ナビゲーブルである場合、navigableの親がpotentialParentです。また、ナビゲーブルが「子ナビゲーブルである」と言うこともでき、それはその親がnullでないことを意味します。

すべての子ナビゲーブルは、そのコンテナのコンテンツナビゲーブルです。

ナビゲーブルコンテナcontainerのコンテンツドキュメントを取得するには、以下の手順を実行します：

  1. もしcontainerのコンテンツナビゲーブルがnullであれば、nullを返します。

  2. documentをcontainerのコンテンツナビゲーブルのアクティブなドキュメントとして設定します。

  3. もしdocumentのオリジンと、containerのノードドキュメントのオリジンが同一オリジンドメインでない場合、nullを返します。

  4. documentを返します。

ナビゲーブルコンテナcontainerのコンテンツウィンドウを取得するには、以下の手順を実行します：

  1. もしcontainerのコンテンツナビゲーブルがnullであれば、nullを返します。

  2. containerのコンテンツナビゲーブルのアクティブなWindowProxyのオブジェクトを返します。

要素elementを指定して新しい子ナビゲーブルを作成するには：

  1. parentNavigableをelementのノードナビゲーブルに設定します。

  2. groupをelementのノードドキュメントのブラウジングコンテキストの最上位ブラウジングコンテキストのグループに設定します。

  3. browsingContextとdocumentを、elementのノードドキュメント、element、およびgroupを指定して新しいブラウジングコンテキストとドキュメントを作成するの結果に設定します。

  4. targetNameをnullに設定します。

  5. もしelementがnameコンテンツ属性を持つ場合、targetNameをその属性の値に設定します。

  6. documentStateを新しいドキュメント状態に設定し、次のプロパティを持たせます：

    ドキュメント
    document
    イニシエータオリジン
    documentのオリジン
    オリジン
    documentのオリジン
    ナビゲーブルターゲット名
    targetName
    about ベースURL
    documentのabout ベースURL

  7. navigableを新しいナビゲーブルに設定します。

  8. ナビゲーブルを初期化する navigableにdocumentStateとparentNavigableを指定して初期化します。

  9. elementのコンテンツナビゲーブルをnavigableに設定します。

  10. historyEntryをnavigableのアクティブなセッション履歴エントリに設定します。

  11. traversableをparentNavigableのトラバース可能なナビゲーブルに設定します。

  12. 次のセッション履歴トラバーサルステップを追加するをtraversableに対して実行します：

    1. parentDocStateをparentNavigableのアクティブなセッション履歴エントリのドキュメント状態に設定します。

    2. parentNavigableEntriesをparentNavigableに対してセッション履歴エントリを取得する結果に設定します。

    3. targetStepSHEをparentNavigableEntriesの中で最初のセッション履歴エントリで、parentDocStateと等しいドキュメント状態を持つものに設定します。

    4. historyEntryのステップをtargetStepSHEのステップに設定します。

    5. nestedHistoryを新しいネストされた履歴として設定し、そのIDをnavigableのIDに、エントリリストを « historyEntry » に設定します。

    6. 追加する nestedHistoryをparentDocStateのネストされた履歴に。

    7. ナビゲーブルの作成/破棄のための更新をtraversableに対して実行します。

  13. WebDriver BiDiナビゲーブルが作成されましたをtraversableで呼び出します。

7.3.1.4 Jake ダイアグラム

ナビゲーブルやそのセッション履歴エントリのシーケンスを視覚化するための便利な方法が、Jake ダイアグラムです。典型的なJake ダイアグラムは以下のようになります：

0 1 2 3 4
top /t-a /t-a#foo /t-b
frames[0] /i-0-a /i-0-b
frames[1] /i-1-a /i-1-b

ここで、各番号付きの列はトラバース可能なナビゲーブルのセッション履歴ステップの可能な値を示しています。各ラベル付きの行は、異なるURLやドキュメント間を移行するナビゲーブルを描写しています。最初の行にラベルが付いているtopは最上位のトラバース可能なナビゲーブルであり、その他の行は子ナビゲーブルです。各セルの背景色は、そのナビゲーブルにおける新しいドキュメントを示しており、新しい背景色が新しいドキュメントを示します。URLはセルのテキスト内容で示されており、通常、簡潔さのために相対URLとして示されますが、特にクロスオリジンのケースが調査されている場合を除きます。特定のナビゲーブルが特定のステップで存在しない場合、そのセルは空になります。太字斜体のステップ番号は、トラバース可能なナビゲーブルの現在のセッション履歴ステップを示しており、太字斜体のURLを持つすべてのセルは、その行のナビゲーブルの現在のセッション履歴エントリを表します。

したがって、上記のJake ダイアグラムは以下の一連のイベントを示しています：

  1. 最上位のトラバース可能なナビゲーブルが作成され、URL /t-a で開始され、2つの子ナビゲーブルがそれぞれ /i-0-a および /i-1-a で開始されます。

  2. 最初の子ナビゲーブルが別のドキュメントにナビゲートされ、URL /i-0-b が設定されます。

  3. 2番目の子ナビゲーブルが別のドキュメントにナビゲートされ、URL /i-1-b が設定されます。

  4. 最上位のトラバース可能なナビゲーブルが同じドキュメントにナビゲートされ、URL が /t-a#foo に更新されます。

  5. 最上位のトラバース可能なナビゲーブルが別のドキュメントにナビゲートされ、URL が /t-b に設定されます。（このドキュメントには、当然、古いドキュメントの子ナビゲーブルは引き継がれません。）

  6. トラバース可能なナビゲーブルがデルタで履歴をトラバースし、ステップ1に戻ります。

Jake ダイアグラムは、複数のナビゲーブル、ナビゲーション、およびトラバースの相互作用を視覚化するための強力なツールです。すべての相互作用を捉えることはできませんが（たとえば、ネストのレベルが1つしかない）、この標準のいくつかの複雑な状況を説明するために使用する機会があります。

Jake ダイアグラムは、その創作者である比類なきJake Archibaldにちなんで名付けられました。

ナビゲーブルのコレクションを、特定のDocumentから開始して確認することは、この標準のアルゴリズムにおいて役立つことがよくあります。このセクションでは、これらのナビゲーブルを収集するための厳選されたアルゴリズムが含まれています。

これらのアルゴリズムの戻り値は、親が子の前に表示されるように順序付けられています。呼び出し元はこの順序に依存しています。

Documentから開始することは、ナビゲーブルから開始するよりも一般的には良いことであり、呼び出し元が完全にアクティブなDocumentから開始するかどうかを認識できるようにします。非完全にアクティブなDocumentも親や子孫のナビゲーブルを持つことがありますが、それらはしばしば存在しないかのように振る舞います（例えば、window.parentゲッターにおいて）。

Documentdocumentの祖先ナビゲーブルは、以下の手順で取得します：

  1. navigableをdocumentのノードナビゲーブルの親に設定します。

  2. ancestorsを空のリストに設定します。

  3. navigableがnullでない限り：

    1. リストの先頭に追加するnavigableをancestorsに。

    2. navigableをnavigableの親に設定します。

  4. ancestorsを返します。

Documentdocumentの包含する祖先ナビゲーブルは、以下の手順で取得します：

  1. navigablesをdocumentの祖先ナビゲーブルに設定します。

  2. 追加する documentのノードナビゲーブルをnavigablesに。

  3. navigablesを返します。

Documentdocumentの子孫ナビゲーブルは、以下の手順で取得します：

  1. navigablesを新しいリストに設定します。

  2. navigableContainersをdocumentのすべてのシャドウを含む子孫のナビゲーブルコンテナのリストに設定し、シャドウを含むツリー順序で並べ替えます。

  3. それぞれに対して実行するnavigableContainerをnavigableContainersに含まれる：

    1. もしnavigableContainerのコンテンツナビゲーブルがnullであれば、続行します。

    2. 拡張するnavigablesをnavigableContainerのコンテンツナビゲーブルのアクティブなドキュメントの包含する子孫ナビゲーブルで。

  4. navigablesを返します。

Documentdocumentの包含する子孫ナビゲーブルは、以下の手順で取得します：

  1. navigablesを « documentのノードナビゲーブル » に設定します。

  2. 拡張するnavigablesをdocumentの子孫ナビゲーブルで。

  3. navigablesを返します。

これらの子孫収集アルゴリズムは、子孫のDocumentオブジェクトのDOMツリーを調べるものとして記述されています。実際には、アルゴリズムの呼び出し元が別のプロセスにある場合、これを実行するのはしばしば不可能です。その代わりに、実装では通常、適切なツリーをプロセス間でレプリケートします。

Documentdocumentのドキュメントツリー子ナビゲーブルは、以下の手順で取得します：

  1. もしdocumentのノードナビゲーブルがnullであれば、空のリストを返します。

  2. navigablesを新しいリストに設定します。

  3. navigableContainersをdocumentのすべての子孫のナビゲーブルコンテナのリストに設定し、ツリー順序で並べ替えます。

  4. それぞれに対して実行するnavigableContainerをnavigableContainersに含まれる：

    1. もしnavigableContainerのコンテンツナビゲーブルがnullであれば、続行します。

    2. 追加するnavigableContainerのコンテンツナビゲーブルをnavigablesに。

  5. navigablesを返します。

7.3.1.6 ナビゲーブルの破棄

子ナビゲーブルを破棄するには、ナビゲーブルコンテナcontainerを指定して次の手順を実行します：

  1. navigableをcontainerのコンテンツナビゲーブルに設定します。

  2. もしnavigableがnullであれば、終了します。

  3. containerのコンテンツナビゲーブルをnullに設定します。

  4. ナビゲーションAPIに子ナビゲーブルの破棄を通知するをnavigableを指定して実行します。

  5. ドキュメントとその子孫を破棄するをnavigableのアクティブなドキュメントを指定して実行します。

  6. parentDocStateをcontainerのノードナビゲーブルのアクティブなセッション履歴エントリのドキュメント状態に設定します。

  7. 削除するparentDocStateのネストされた履歴から、ネストされた履歴のIDがnavigableのIDと等しいものを。

  8. traversableをcontainerのノードナビゲーブルのトラバース可能なナビゲーブルに設定します。

  9. 次のセッション履歴トラバーサルステップを追加するをtraversableに対して実行します：

    1. ナビゲーブルの作成/破棄のための更新をtraversableを指定して実行します。

  10. WebDriver BiDiナビゲーブルが破棄されましたをnavigableで呼び出します。

トップレベルのトラバーサブル traversable を破棄するには：

  1. browsingContextをtraversableのアクティブなブラウジングコンテキストに設定します。

  2. それぞれに対して実行するtraversableのセッション履歴エントリに含まれるhistoryEntryをどの順序で？：

    1. documentをhistoryEntryのドキュメントに設定します。

    2. もしdocumentがnullでなければ、ドキュメントとその子孫を破棄するをdocumentを指定して実行します。

  3. 削除するbrowsingContextを。

  4. traversableをユーザーインターフェースから削除します（例：タブブラウザーのタブを閉じるまたは非表示にする）。

  5. 削除するtraversableをユーザーエージェントのトップレベルのトラバース可能なナビゲーブルセットから。

  6. WebDriver BiDiナビゲーブルが破棄されましたをtraversableで呼び出します。

ユーザーエージェントは、いつでもトップレベルのトラバーサブルを破棄することができます（通常、ユーザーの要求に応じて）。

トップレベルのトラバーサブル traversable を閉じるには：

  1. traversable の 閉じているかが true の場合、戻ります。

  2. traversable を確実に閉じます。

トップレベルのトラバーサブル traversable を確実に閉じるには：

  1. toUnload を traversable の アクティブなドキュメントの 包括的な子孫ナビゲブルとします。

  2. toUnload のアンロードがキャンセルされたかどうかを確認した結果が true の場合、戻ります。

  3. traversable に次のセッション履歴トラバーサルステップを追加します：

    1. afterAllUnloads を、traversable を破棄するアルゴリズムステップとします。

    2. traversable の アクティブなドキュメント、null、および afterAllUnloads を指定して、ドキュメントとその子孫をアンロードします。

閉じると確実に閉じるの分離により、他の仕様は閉じるを呼び出すことができ、JavaScript コードが window.close() を呼び出したためにトップレベルのトラバーサブルが既に閉じている場合は、何もしません。

ナビゲーブルには、ターゲット名を設定できます。これは、window.open()やa要素のtarget属性など、特定のAPIがそのナビゲーブルをターゲットにしてナビゲーションを行えるようにする文字列です。

有効なナビゲーブルターゲット名とは、ASCIIタブまたは改行の両方とU+003C (<)を含まない、かつU+005F (_)で始まらない文字列です。U+005F (_)で始まる名前は特別なキーワードのために予約されています。

有効なナビゲーブルターゲット名またはキーワードとは、有効なナビゲーブルターゲット名であるか、またはASCII大文字小文字を区別しない一致で次のいずれかの文字列です：_blank、_self、_parent、または_top。

これらの値は、ページがサンドボックス化されているかどうかによって異なる意味を持ちます。以下の（規範的でない）表にその概要が示されています。この表で「現在」とはリンクやスクリプトが存在するナビゲーブルを、「親」とはリンクやスクリプトが存在するナビゲーブルの親を、「トップ」とはリンクやスクリプトが存在するナビゲーブルのトップレベルのトラバース可能なナビゲーブルを、「新規」とは親がnullである新しいトラバース可能なナビゲーブルを指します（これにはさまざまなユーザー設定やユーザーエージェントのポリシーに基づいて、補助ブラウジングコンテキストが使用される場合があります）。「なし」とは何も起こらないことを、「おそらく新規」とは、「allow-popups」キーワードがsandbox属性で指定されている場合には「新規」と同じであり、そうでない場合は「なし」と同じであることを意味します。

キーワード 通常の効果 次のiframeでの効果...
sandbox="" sandbox="allow-top-navigation"
指定なし（リンクおよびフォーム送信の場合） 現在 現在 現在
空文字列 現在 現在 現在
_blank 新規 おそらく新規 おそらく新規
_self 現在 現在 現在
_parent（親がいない場合） 現在 現在 現在
_parent（親がトップの場合） 親/トップ なし 親/トップ
_parent（親がトップでない場合） 親 なし なし
_top（トップが現在の場合） 現在 現在 現在
_top（トップが現在でない場合） トップ なし トップ
存在しない名前 新規 おそらく新規 おそらく新規
存在する名前で子孫の場合 指定された子孫 指定された子孫 指定された子孫
存在する名前で現在の場合 現在 現在 現在
存在する名前でトップが祖先の場合 指定された祖先 なし 指定された祖先/トップ
存在する名前でトップが祖先でない場合 指定された祖先 なし なし
共通のトップを持つその他の存在する名前 指定されたもの なし なし
異なるトップを持ち、馴染みがあり、許可されたサンドボックス化されたナビゲータが1つの場合の名前 指定されたもの 指定されたもの 指定されたもの
異なるトップを持ち、馴染みがあるが、許可されたサンドボックス化されたナビゲータが1つでない場合の名前 指定されたもの なし なし
馴染みがない異なるトップを持つ名前 新規 おそらく新規 おそらく新規

サンドボックス化されたブラウジングコンテキストに対するほとんどの制限は、ナビゲーションアルゴリズムなど他のアルゴリズムによって適用されますが、以下に示すナビゲーブルを選択するためのルールでは適用されません。

文字列 name とナビゲブル currentNavigable を指定して、ターゲット名でナビゲブルを検索するには：

  1. currentDocument を currentNavigable の アクティブなドキュメントとします。

  2. sourceSnapshotParams を、currentDocument を指定してソーススナップショットパラメータをスナップショットする結果とします。

  3. subtreesToSearch を、次のいずれかの実装定義の選択肢とします：

    課題 #10848 は、相互運用性を達成するために、これらの2つの可能性のいずれかに決定することを追跡します。

  4. subtreesToSearch の各 subtreeToSearch について、逆順で反復処理します：

    1. documentToSearch を subtreeToSearch の アクティブなドキュメントとします。

    2. documentToSearch の包括的な子孫ナビゲブルの各 navigable について反復処理します：

      1. sourceSnapshotParams を指定して、currentNavigable が navigable をサンドボックス化によってナビゲートすることが許可されていない場合、オプションで続行します。

        課題 #10849 は、相互運用性を達成するために、このチェックを必須にすることを追跡します。

      2. navigable の ターゲット名が name の場合、navigable を返します。

  5. currentTopLevelBrowsingContext を currentNavigable の アクティブなブラウジングコンテキストの トップレベルブラウジングコンテキストとします。

  6. group を currentTopLevelBrowsingContext の グループとします。

  7. group の ブラウジングコンテキストセットの各 topLevelBrowsingContext について、実装定義の順序で（ユーザーエージェントは、最後に開いたもの、最後にフォーカスされたもの、またはより密接に関連するものなど、一貫した順序を選択する必要があります）反復処理します：

    課題 #10850 は、相互運用性を達成するために、特定の順序を選択することを追跡します。

    1. currentTopLevelBrowsingContext が topLevelBrowsingContext の場合、続行します。

    2. documentToSearch を topLevelBrowsingContext の アクティブなドキュメントとします。

    3. documentToSearch の包括的な子孫ナビゲブルの各 navigable について反復処理します：

      1. currentNavigable の アクティブなブラウジングコンテキストが navigable の アクティブなブラウジングコンテキストに精通していない場合、続行します。

      2. sourceSnapshotParams を指定して、currentNavigable が navigable をサンドボックス化によってナビゲートすることが許可されていない場合、オプションで続行します。

        課題 #10849 は、相互運用性を達成するために、このチェックを必須にすることを追跡します。

      3. navigable の ターゲット名が name の場合、navigable を返します。

  8. null を返します。

ナビゲーブルを選択するためのルール、文字列name、ナビゲーブル currentNavigable、およびブール値noopenerが次のように与えられた場合:

  1. chosenをnullに設定します。

  2. windowTypeを"既存またはなし"に設定します。

  3. sandboxingFlagSetをcurrentNavigableのアクティブなドキュメントのアクティブなサンドボックスフラグセットに設定します。

  4. もしnameが空文字列であるか、またはASCIIケースインセンシティブで "_self"と一致する場合、chosenを currentNavigableに設定します。

  5. それ以外の場合、nameがASCIIケースインセンシティブで "_parent"と一致する場合、 chosenをcurrentNavigableの親に設定し、もし存在しない場合は currentNavigableに設定します。

  6. それ以外の場合、nameがASCIIケースインセンシティブで "_top"と一致する場合、chosenをcurrentNavigableのトラバーサブルナビゲーブルに設定します。

  7. それ以外の場合で、name が "_blank" とASCII 大文字小文字を区別しない一致ではなく、かつ noopener が false の場合、chosen を name と currentNavigable を指定してターゲット名でナビゲート可能を検索した結果に設定します。

  8. chosen が null の場合、新しいトップレベルトラバーサブルが要求されており、何が起こるかはユーザーエージェントの設定と機能に依存します。これは、次のリストの最初に適用可能なオプションに対して与えられたルールによって決定されます。

    ユーザーエージェントはポップアップがブロックされたことをユーザーに通知することができます。

    もしsandboxingFlagSetにサンドボックス化された補助ナビゲーションブラウジングコンテキストフラグが設定されている場合

    ユーザーエージェントはポップアップがブロックされたことを開発者コンソールに報告することができます。

    もしユーザーエージェントがこのインスタンスで新しいトップレベルのトラバーサブルを作成するように設定されている場合

    1. currentNavigable の アクティブウィンドウのユーザーアクティベーションを消費します。

    2. windowTypeを"新規および無制限"に設定します。

    3. currentDocumentをcurrentNavigableのアクティブなドキュメントに設定します。

    4. もしcurrentDocumentのオープナーポリシーの値が"同一オリジン" または"同一オリジンプラスCOEP"であり、 そしてcurrentDocumentのオリジンがcurrentDocumentの関連する設定オブジェクトのトップレベルオリジンと 同一オリジンでない場合:

      1. noopenerをtrueに設定します。

      2. nameを"_blank"に設定します。

      3. windowTypeを"新規でオープナーなし"に設定します。

      オープナーポリシーが存在する場合、トップレベルのブラウジングコンテキストのアクティブなドキュメントとクロスオリジンであるネストされたドキュメントは、常に noopener を true に設定します。

    5. targetNameを空文字列に設定します。

    6. もしnameがASCIIケースインセンシティブで "_blank"と一致しない場合は、targetNameをnameに設定します。

    7. もしnoopenerがtrueである場合、chosenを新しいトップレベルのトラバーサブルを作成するの結果に、 null、targetName、およびcurrentNavigableを与えて設定します。

    8. それ以外の場合:

      1. chosenを新しいトップレベルのトラバーサブルを作成するの結果に、 currentNavigableのアクティブなブラウジングコンテキスト、 targetName、およびcurrentNavigableを与えて設定します。

      2. もしsandboxingFlagSetのサンドボックス化されたナビゲーションブラウジングコンテキストフラグが設定されている場合は、 chosenのアクティブなブラウジングコンテキストの1つの許可されたサンドボックス化されたナビゲーターに、 currentNavigableのアクティブなブラウジングコンテキストを設定します。

    9. もしsandboxingFlagSetのサンドボックスが補助ブラウジングコンテキストに伝播するフラグが設定されている場合、 sandboxingFlagSetで設定されているすべてのフラグがchosenのアクティブなブラウジングコンテキストのポップアップサンドボックスフラグセットに設定される必要があります。

    10. chosen のウェブコンテンツによって作成されたを true に設定します。

    新しく作成されたナビゲーブル chosenがすぐにナビゲートされる場合、そのナビゲーションは"置き換え"ナビゲーションとして行われます。

    もしユーザーエージェントがこのインスタンスでcurrentNavigableを選択するように設定されている場合

    chosenをcurrentNavigableに設定します。

    もしユーザーエージェントがこのインスタンスでナビゲーブルを見つけないように設定されている場合

    何もしません。

    ユーザーエージェントは常にcurrentNavigableを選択するようにユーザーがユーザーエージェントを設定できるようにすることを推奨します。

  9. chosenとwindowTypeを返します。

7.3.2 ブラウジングコンテキスト

ブラウジングコンテキストは、一連のドキュメントのプログラムによる表現であり、複数のドキュメントが単一のナビゲーブル内に存在することができます。各ブラウジングコンテキストには、対応するWindowProxyオブジェクトがあり、以下のものも含まれます:

ブラウジングコンテキストのアクティブウィンドウは、そのWindowProxyオブジェクトの[[Window]]内部スロットの値です。ブラウジングコンテキストのアクティブドキュメントは、そのアクティブウィンドウの関連するDocumentです。

ブラウジングコンテキストのトップレベルトラバーサブルは、そのアクティブドキュメントのノードナビゲーブルのトップレベルトラバーサブルです。

ブラウジングコンテキストの補助的であるかがtrueであるものは、補助的ブラウジングコンテキストとして知られています。補助的ブラウジングコンテキストは常にトップレベルのブラウジングコンテキストです。

別の補助的であるかという概念が必要かどうかは不明です。issue #5680では、オープナーブラウジングコンテキストがnullであるかどうかを使用することで、これを簡略化できる可能性があることが示されています。

現代の仕様では、ほとんどのケースでブラウジングコンテキストの概念を使用することを避けるべきです。代わりに、クロスオリジンオープナーポリシーによるブラウジングコンテキストグループの切り替えやエージェントクラスターの割り当ての微妙な点を扱っている場合を除いて、Documentやナビゲーブルの概念が通常はより適切です。

Documentのブラウジングコンテキストは、ブラウジングコンテキストまたはnullであり、初期値はnullです。

Documentは必ずしも非nullのブラウジングコンテキストを持つわけではありません。特に、データマイニングツールはブラウジングコンテキストをインスタンス化しないことが多いです。Documentが、createDocument()のようなAPIを使用して作成された場合、非nullのブラウジングコンテキストを持つことはありません。また、Documentは、かつてiframe要素のために作成され、その後ドキュメントから削除されたものであり、そのブラウジングコンテキストはnullになったため、関連するブラウジングコンテキストを持たない。

一般的には、WindowオブジェクトとDocumentオブジェクトの間には1対1の対応があります。ただし、Documentオブジェクトが非nullのブラウジングコンテキストを持つ限り、例外が1つあります。それは、同じブラウジングコンテキスト内で、最初のDocumentから次のDocumentにナビゲートされた場合、最初のabout:blankドキュメントから次のものに置き換えによって行われるときです。

7.3.2.1 ブラウジングコンテキストの作成

nullまたはDocumentオブジェクトcreator、nullまたは要素embedder、およびブラウジングコンテキストグループ groupが与えられた場合に、新しいブラウジングコンテキストとドキュメントを作成するには、次の手順を実行します:

  1. browsingContextを新しいブラウジングコンテキストに設定します。

  2. unsafeContextCreationTimeをunsafe shared current timeに設定します。

  3. creatorOriginをnullに設定します。

  4. creatorBaseURLをnullに設定します。

  5. もしcreatorがnullでない場合:

    1. creatorOriginをcreatorのオリジンに設定します。

    2. creatorBaseURLをcreatorのドキュメントベースURLに設定します。

    3. browsingContextの仮想ブラウジングコンテキストグループIDを creatorのブラウジングコンテキストのトップレベルブラウジングコンテキストの 仮想ブラウジングコンテキストグループIDに設定します。

  6. sandboxFlagsを、browsingContextおよびembedderを与えて作成サンドボックスフラグを決定する結果に設定します。

  7. originを、about:blank、sandboxFlags、およびcreatorOriginを与えてオリジンを決定する結果に設定します。

  8. permissionsPolicyを、embedderおよびoriginを与えてパーミッションポリシーを作成する結果に設定します。[PERMISSIONSPOLICY]

  9. agentを、origin、group、およびfalseを与えて類似オリジンウィンドウエージェントを取得する結果に設定します。

  10. realm execution contextを、agentおよび以下のカスタマイズを与えて新しいJavaScriptレルムを作成する結果に設定します:

  11. topLevelCreationURLを、embedderがnullであればabout:blankに、そうでなければembedderの関連する設定オブジェクトのトップレベル作成URLに設定します。

  12. topLevelOriginを、embedderがnullであればoriginに、そうでなければembedderの関連する設定オブジェクトのトップレベルオリジンに設定します。

  13. ウィンドウ環境設定オブジェクトを設定するをabout:blank、realm execution context、null、topLevelCreationURL、およびtopLevelOriginを使用して実行します。

  14. loadTimingInfoを新しいドキュメントロードタイミング情報に設定し、そのナビゲーション開始時間をunsafeContextCreationTimeおよび新しい環境設定オブジェクトのクロスオリジン隔離機能を使用して呼び出した時間の粗さ調整の結果に設定します。

  15. documentを新しいDocumentに設定し、以下の属性を持たせます:

    タイプ
    "html"
    コンテンツタイプ
    "text/html"
    モード
    "quirks"
    オリジン
    origin
    ブラウジングコンテキスト
    browsingContext
    パーミッションポリシー
    permissionsPolicy
    アクティブサンドボックスフラグセット
    sandboxFlags
    ロードタイミング情報
    loadTimingInfo
    初期about:blankである
    true
    aboutベースURL
    creatorBaseURL
    宣言型シャドウルートを許可
    true
    カスタム要素レジストリ
    新しい CustomElementRegistry オブジェクト。

  16. もしcreatorがnullでない場合:

    1. documentのリファラーをcreatorのシリアライゼーションに設定します。creatorのURLのシリアライゼーション。

    2. documentのポリシーコンテナを、creatorのポリシーコンテナのクローンに設定します。

    3. もしcreatorのオリジンがcreatorの関連する設定オブジェクトのトップレベルオリジンと同一オリジンである場合、documentのオープナーポリシーをcreatorのブラウジングコンテキストのトップレベルブラウジングコンテキストのアクティブドキュメントのオープナーポリシーに設定します。

  17. アサート: documentのURLおよびdocumentの関連する設定オブジェクトの作成URLがabout:blankであることを確認します。

  18. documentをポストロードタスクの準備ができたとしてマークします。

  19. html/head/bodyで埋めるをdocumentに与えて実行します。

  20. documentをアクティブにするを実行します。

  21. documentの読み込みを完全に終了するを実行します。

  22. browsingContextとdocumentを返します。

新しいトップレベルのブラウジングコンテキストとドキュメントを作成するには、次の手順を実行します:

  1. groupおよびdocumentを新しいブラウジングコンテキストグループとドキュメントを作成するの結果に設定します。

  2. groupのブラウジングコンテキストセット[0]とdocumentを返します。

新しい補助的なブラウジングコンテキストとドキュメントを作成するには、次の手順を実行します:

  1. openerTopLevelBrowsingContextをopenerのトップレベルトラバーサブルのアクティブブラウジングコンテキストに設定します。

  2. groupをopenerTopLevelBrowsingContextのグループに設定します。

  3. アサート: groupはnullではありません。これはナビゲートが直接呼び出すからです。

  4. browsingContextおよびdocumentを、openerのアクティブドキュメント、null、およびgroupを与えて新しいブラウジングコンテキストとドキュメントを作成するの結果に設定します。

  5. browsingContextの補助的であるをtrueに設定します。

  6. browsingContextをgroupに追加するを実行します。

  7. browsingContextのオープナーブラウジングコンテキストをopenerに設定します。

  8. browsingContextの仮想ブラウジングコンテキストグループIDをopenerTopLevelBrowsingContextの仮想ブラウジングコンテキストグループIDに設定します。

  9. browsingContextの作成時のオープナーオリジンをopenerのアクティブドキュメントのオリジンに設定します。

  10. browsingContextとdocumentを返します。

オリジンを決定するには、次の手順を実行します:

  1. もしsandboxFlagsがサンドボックス化されたオリジンブラウジングコンテキストフラグを設定している場合、新しい不透明オリジンを返します。

  2. もしurlがnullであれば、新しい不透明オリジンを返します。

  3. もしurlがabout:srcdocである場合:

    1. アサート: sourceOriginはnullではありません。

    2. sourceOriginを返します。

  4. もしurlがabout:blankに一致する場合、sourceOriginがnullでなければsourceOriginを返します。

  5. urlのオリジンを返します。

sourceOriginを返すケースでは、同じオリジンを持つ2つのDocumentが結果として得られ、document.domainが両方に影響を与えることになります。

7.3.2.2 関連するブラウジングコンテキスト

ブラウジングコンテキストpotentialDescendantは、次のアルゴリズムがtrueを返す場合、ブラウジングコンテキストpotentialAncestorの先祖であると言われます:

  1. potentialDescendantDocumentをpotentialDescendantのアクティブドキュメントに設定します。

  2. もしpotentialDescendantDocumentが完全にアクティブでない場合、falseを返します。

  3. ancestorBCsを、potentialDescendantDocumentの先祖ナビゲーブルの各メンバーのアクティブドキュメントのブラウジングコンテキストを取得することによって得られるリストに設定します。

  4. もしancestorBCsが含むpotentialAncestorを含む場合、trueを返します。

  5. falseを返します。

トップレベルブラウジングコンテキストとは、そのアクティブドキュメントのノードナビゲーブルがトラバーサブルナビゲーブルであるブラウジングコンテキストを指します。

それはトップレベルトラバーサブルである必要はありません。

ブラウジングコンテキストstartのトップレベルブラウジングコンテキストは、次のアルゴリズムの結果です:

  1. もしstartのアクティブドキュメントが完全にアクティブでない場合、nullを返します。

  2. navigableをstartのアクティブドキュメントのノードナビゲーブルに設定します。

  3. navigableの親がnullでない間、navigableをnavigableの親に設定します。

  4. navigableのアクティブブラウジングコンテキストを返します。

ブラウジングコンテキスト Aは、次のアルゴリズムがtrueを返す場合、2番目のブラウジングコンテキスト Bと親しいと言われます:

  1. もしAのアクティブドキュメントのオリジンがBのアクティブドキュメントのオリジンと同一オリジンである場合、trueを返します。

  2. もしAのトップレベルブラウジングコンテキストがBである場合、trueを返します。

  3. もしBが補助的ブラウジングコンテキストであり、AがBのオープナーブラウジングコンテキストと親しい場合、trueを返します。

  4. もしBの先祖ブラウジングコンテキストのいずれかが、Aのアクティブドキュメントと同じオリジンを持つ場合、trueを返します。

    これは、AがBの先祖ブラウジングコンテキストである場合を含みます。

  5. falseを返します。

7.3.2.3 ブラウジングコンテキストのグループ

トップレベルブラウジングコンテキストには、関連するグループ（nullまたはブラウジングコンテキストグループ）があります。これは最初はnullです。

ユーザーエージェントは、ブラウジングコンテキストグループセット（セットのブラウジングコンテキストグループを持ちます）。

ブラウジングコンテキストグループは、ブラウジングコンテキストセット（セットのトップレベルブラウジングコンテキストを保持します）。

トップレベルブラウジングコンテキストは、グループが作成されたときにそのグループに追加されます。その後に追加されるすべてのトップレベルブラウジングコンテキストは、補助的ブラウジングコンテキストとなります。

ブラウジングコンテキストグループには、関連するエージェントクラスターマップがあります（マップのエージェントクラスタキーからエージェントクラスタまで）。ユーザーエージェントは、何もアクセスできなくなったと判断されたときに、エージェントクラスタを収集する責任があります。

ブラウジングコンテキストグループには、関連する歴史的エージェントクラスタキーのマップがあり、これはマップのオリジンからエージェントクラスタキーまでです。このマップは、特定のオリジンに以前使用されたエージェントクラスタキーを記録することで、オリジンキー付きエージェントクラスタ機能の一貫性を確保するために使用されます。

歴史的エージェントクラスタキーのマップは、ブラウジングコンテキストグループの存続期間中にのみエントリを獲得します。

ブラウジングコンテキストグループには、クロスオリジン隔離モードがあり、これはクロスオリジン隔離モードです。これは最初は"none"です。

クロスオリジン隔離モードは、3つの可能な値のいずれかです: "none"、"logical"、または"concrete"。

"logical"および"concrete"は類似しています。これらは両方とも、以下の条件を満たすブラウジングコンテキストグループで使用されます:

一部のプラットフォームでは、クロスオリジン隔離によって課されるさまざまな制限が適用されますが、クロスオリジン隔離機能を提供するために必要なセキュリティプロパティを提供するのが難しい場合があります。その結果、"concrete"のみがその機能にアクセスすることができます。"logical"は、この機能をサポートしていないプラットフォームで使用され、クロスオリジン隔離によって課されるさまざまな制限が適用されますが、機能は付与されません。

新しいブラウジングコンテキストグループとドキュメントを作成するには、次の手順を実行します:

  1. groupを新しいブラウジングコンテキストグループに設定します。

  2. 追加してgroupをユーザーエージェントのブラウジングコンテキストグループセットに追加します。

  3. browsingContextおよびdocumentを、null、null、およびgroupを指定して新しいブラウジングコンテキストとドキュメントを作成する結果に設定します。

  4. 追加してbrowsingContextをgroupに追加します。

  5. groupとdocumentを返します。

追加してトップレベルブラウジングコンテキストbrowsingContextをブラウジングコンテキストグループgroupに追加します:

  1. 追加してbrowsingContextをgroupのブラウジングコンテキストセットに追加します。

  2. browsingContextのグループをgroupに設定します。

削除してトップレベルブラウジングコンテキストbrowsingContextを削除します:

  1. アサート: browsingContextのグループはnullではありません。

  2. groupをbrowsingContextのグループに設定します。

  3. browsingContextのグループをnullに設定します。

  4. 削除してbrowsingContextをgroupのブラウジングコンテキストセットから削除します。

  5. もしgroupのブラウジングコンテキストセットが空であれば、削除してgroupをユーザーエージェントのブラウジングコンテキストグループセットから削除します。

追加と削除は、ブラウジングコンテキストグループの寿命を定義するための基本操作です。これらは、Documentおよびブラウジングコンテキストの高レベルの作成および破棄操作によって呼び出されます。

Documentオブジェクトがブラウジングコンテキストと等しい場合、そのブラウジングコンテキスト（すべてのDocumentが破棄された場合）であり、そのブラウジングコンテキストのWindowProxyがガベージコレクションの対象となっている場合、そのブラウジングコンテキストには二度とアクセスされることはありません。それがトップレベルブラウジングコンテキストである場合、この時点でユーザーエージェントはそれを削除する必要があります。

7.3.3 完全にアクティブなドキュメント

Document dが、dがアクティブドキュメントであり、かつnavigableがトップレベルトラバーサブルであるか、navigableのコンテナドキュメントが完全にアクティブである場合、完全にアクティブであると言います。

要素に関連付けられているため、子ナビゲーブルは常に特定のDocument、つまりそのコンテナドキュメントに結びついています。ユーザーエージェントは、子ナビゲーブルのコンテナドキュメントが完全にアクティブでない場合、ユーザーがそれと対話することを許可してはなりません。

次の例は、Documentがアクティブドキュメントであるが、完全にアクティブではない場合を示しています。ここでは、a.htmlがブラウザウィンドウに読み込まれ、b-1.htmlがiframeに読み込まれ、b-2.htmlとc.htmlが省略されています（それらは単に空のドキュメントでもかまいません）。 

<!-- a.html -->
<!DOCTYPE html>
<html lang="en">
<title>Navigable A</title>

<iframe src="b-1.html"></iframe>
<button onclick="frames[0].location.href = 'b-2.html'">Click me</button>

<!-- b-1.html -->
<!DOCTYPE html>
<html lang="en">
<title>Navigable B</title>

<iframe src="c.html"></iframe>

この時点で、a.html、b-1.html、およびc.htmlによって与えられるドキュメントはすべて、それぞれのアクティブドキュメントです。それらはすべて完全にアクティブです。

ボタンをクリックし、b-2.htmlから新しいDocumentをナビゲーブルBに読み込んだ後、次の結果が得られます:

ドラゴンの口へようこそ。ナビゲーション、セッション履歴、およびそのセッション履歴の移動は、この標準の中でも最も複雑な部分の一つです。

基本的な概念はそれほど難しくないかもしれません：

ここで見られるように、移動がナビゲーション（すなわち保存されたURLへのネットワークフェッチ）を引き起こす方法や、ナビゲーションがセッション履歴リストとインターフェースを必要とし、終了時にユーザーが適切なものを見ていることを確認する必要があることから、いくつかの複雑な絡み合いが表れています。しかし、実際の問題は、さまざまなエッジケースやWebプラットフォーム機能の相互作用によって発生します：

以下では、これらの複雑さを適切にラベル付けされたセクションとアルゴリズムに区切り、可能な限り適切な導入文を提供することで、読者を案内することを試みました。それにもかかわらず、ナビゲーションとセッション履歴を真に理解したい場合は、通常のアドバイスが非常に役立つでしょう。

7.4.1 セッション履歴

7.4.1.1 セッション履歴エントリ

セッション履歴エントリとは、次の構造体を持つ項目です。

セッション履歴エントリのドキュメントを取得するには、そのドキュメント状態のドキュメントを返します。

シリアライズされた状態とは、StructuredSerializeForStorageによってシリアライズされたユーザーインターフェイス状態を表すオブジェクトです。時々、「状態オブジェクト」と非公式に呼ぶことがありますが、これは著者によって提供されたユーザーインターフェイス状態を表すオブジェクト、またはシリアライズされた状態をStructuredDeserializeによって逆シリアライズして作成されたオブジェクトです。

ページは追加されたシリアライズされた状態をセッション履歴に保存できます。これらは逆シリアライズされ、ユーザー（またはスクリプト）が履歴を戻ったときにスクリプトに返されます。これにより、著者はワンページアプリケーションでも「ナビゲーション」というメタファーを使用できるようになります。

シリアライズされた状態は、主に二つの目的で使用されます。まず、簡単な場合に作成者が解析を行わなくても済むように、状態の事前解析された説明をURLに保存するためです（ただし、ユーザーによって渡されるURLの処理には解析が必要なので、これはあくまで小さな最適化に過ぎません）。第二に、作成者がURLには保存しない状態を保存できるようにするためです。なぜなら、その状態は現在のドキュメントインスタンスにのみ適用され、新しいドキュメントが開かれた場合には再構築する必要があるからです。

後者の例としては、ポップアップがアニメーションを開始する正確な座標を追跡することが挙げられます。これにより、ユーザーが戻った場合、同じ場所にアニメーションさせることができます。または、URLに基づいてサーバーから取得されるデータのキャッシュへのポインタを保持するために使用される可能性があります。これにより、前後に移動する際に情報を再取得する必要がなくなります。

スクロール復元モードは、エージェントがエントリに移動するときに、保存されたスクロール位置（存在する場合）を復元するかどうかを示します。スクロール復元モードは次のいずれかです。

"auto"
エージェントがナビゲーション時にスクロール位置を復元する責任を負います。
"manual"
ページがスクロール位置を復元する責任を負い、エージェントは自動的にそれを行おうとしません。
7.4.1.2 ドキュメント状態

ドキュメント状態は、セッション履歴エントリ内に、Documentをどのように表示し、必要に応じて再作成するかに関する状態を保持します。これには次のものがあります。

ユーザーエージェントは、ドキュメント状態のドキュメントがnullでない場合、ドキュメントおよびその子孫を破棄することができますが、そのドキュメントが完全にアクティブではない場合に限ります。

この制約を除いて、本標準では、ユーザーエージェントがドキュメント状態に保存されているドキュメントを破棄するタイミングと、それをキャッシュとして保持するタイミングについては指定していません。

POSTリソースには以下のものがあります。

ネストされた履歴には以下のものがあります。

これは後で、子ナビゲーブルをリロードの間に識別する方法を含むことになります。

セッション履歴のいくつかの連続するエントリは、同じドキュメント状態を共有することがあります。これは、通常のナビゲーションを経て最初のエントリに到達し、次のエントリがhistory.pushState()によって追加された場合に発生することがあります。また、フラグメントへのナビゲーションによっても発生することがあります。

同じドキュメント状態を共有するすべてのエントリ（したがって、単に特定のドキュメントの異なる状態にすぎないエントリ）は、構造上連続しています。

Documentには、最新エントリがあり、それはセッション履歴エントリまたはnullです。

これは、特定のDocumentによって最後に表現されたエントリです。単一のDocumentは、時間の経過とともに多くのセッション履歴エントリを表すことができ、多くの連続するセッション履歴エントリが上記で説明したように同じドキュメント状態を共有することがあります。

7.4.1.3 セッション履歴の集中管理による変更

単一の信頼できる情報源を維持するために、トラバース可能なナビゲーブルのセッション履歴エントリに対するすべての変更は同期する必要があります。これは、セッション履歴がすべての子孫ナビゲーブルおよび複数のイベントループによって影響を受ける方法のために特に重要です。これを達成するために、セッション履歴トラバース並列キュー構造を使用します。

セッション履歴トラバース並列キューは、並列キューに非常に似ています。これは、順序付きセットであるアルゴリズムセットを持ちます。

項目は、セッション履歴トラバース並列キューのアルゴリズムセット内にあり、アルゴリズムステップまたは同期ナビゲーションステップのどちらかです。これらは、特定のナビゲーブルに関わるアルゴリズムステップです。

セッション履歴トラバースステップを追加するには、トラバース可能なナビゲーブルに対して、アルゴリズムステップstepsを与え、appendでstepsをtraversableのセッション履歴トラバースキューのアルゴリズムセットに追加します。

セッション履歴同期ナビゲーションステップを追加するには、ナビゲーブルtargetNavigableに関わるアルゴリズムステップstepsを与え、appendでstepsをsynchronous navigation stepsとしてtargetNavigableをターゲットとするtraversableのセッション履歴トラバースキューのアルゴリズムセットに追加します。

新しいセッション履歴トラバース並列キューを開始するには:

  1. sessionHistoryTraversalQueueを新しいセッション履歴トラバース並列キューに設定します。

  2. 次のステップを並列で実行します:

    1. 以下を繰り返し実行します:

      1. もしsessionHistoryTraversalQueueのアルゴリズムセットが空であれば、continueします。

      2. stepsをsessionHistoryTraversalQueueのアルゴリズムセットからdequeuingした結果に設定します。

      3. stepsを実行します。

  3. sessionHistoryTraversalQueueを返します。

同期ナビゲーションステップは、アルゴリズムセット内でタグ付けされ、条件付きで「キューを飛ばす」ことができるようにします。これは履歴ステップの適用内で処理されます。

次のJakeダイアグラムに示される結合セッション履歴を考えてみましょう:

0 1
top /a /b

そして、次のコードがトップレベルで実行されます:

history.back();
location.href = '#foo';

期待される結果は:

0 1 2
top /a /b /b#foo

これは簡単ではありません。同期ナビゲーションは観察可能な点で競争に勝ちますが、トラバースはセッション履歴トラバース並列キューにステップをキューイングする点で競争に勝ちます。この結果を達成するために、次のようなことが起こります:

  1. history.back()は、−1のデルタで移動することを意図してステップを追加します。

  2. location.href = '#foo'は、同期的にアクティブなセッション履歴エントリを、新しく作成されたURL /b#foo を持つエントリに変更し、その新しいエントリについて中央の信頼ソースに通知するための同期ステップを追加します。これは、現在のセッション履歴エントリ、現在のセッション履歴ステップ、またはセッション履歴エントリリストをまだ更新していないことに注意してください。これらの更新は同期的には行えず、代わりにキューに入れられたステップの一部として行う必要があります。

  3. セッション履歴トラバース並列キューで、history.back()によってキューに登録されたステップが実行されます:

    1. ターゲット履歴ステップは0と判断されます。現在のセッション履歴ステップ（つまり、1）と意図されたデルタの−1を加えたものです。

    2. 主要な履歴ステップの適用アルゴリズムに入ります。

      ステップ0のエントリ（/aのURL）には、そのドキュメントが入力されます。

      同時に、キューは同期ナビゲーションステップがないかチェックされます。location.hrefセッターによってキューに登録されたステップが実行され、ドキュメントの入力以外の影響（ドキュメントのアンロードやアクティブ履歴エントリの切り替えなど）が完了するまで、トラバースがこれ以上の効果を実行しないようにブロックします。それらのステップは次のことを引き起こします:

      1. URL/b#fooを持つエントリが追加され、そのステップが2と判断されます。現在のセッション履歴ステップ（つまり1）に1を加えたものです。

      2. その新しく追加されたエントリに完全に切り替え、履歴ステップの適用へのネストされた呼び出しを含みます。これにより、ドキュメントの更新が最終的に行われ、hashchangeのようなイベントがディスパッチされます。

      すべてが完了し、/aの履歴エントリがドキュメントで完全に入力された後で初めて、ターゲット履歴ステップ0に履歴ステップの適用を続行します。

      この時点で、URL /b#foo のドキュメントがアンロードされ、ターゲットの履歴ステップ0に移動を完了します。これにより、URL /a のエントリがアクティブなセッション履歴エントリとなり、0が現在のセッション履歴ステップになります。

ここで、2つの異なるiframeの入力と、それらのiframeの1つが読み込まれた後の同期ナビゲーション間の競合を含む、より複雑な例を示します。このセットアップから始めます:

0 1 2
top /t
frames[0] /i-0-a /i-0-b
frames[1] /i-1-a /i-1-b

そして、history.go(-2)を呼び出します。次のようなことが起こります:

  1. history.go(-2)は、−2のデルタで移動することを意図してステップを追加します。これらのステップが実行されたら:

    1. ターゲットステップは2 + (−2) = 0と判断されます。

    2. 並行して、2つのiframeを入力するためのフェッチが実行され、それぞれ/i-0-aと/i-1-aがフェッチされます。

      同時に、キューは同期ナビゲーションステップがないかチェックされます。現時点ではありません。

    3. フェッチ競争では、/i-0-aのフェッチが勝ちます。トラバースがframes[0] ナビゲーブルにどのように影響するかについてのすべての作業を完了するために、履歴ステップの適用apply the history stepを続行し、URL/i-0-aを持つエントリにアクティブなセッション履歴エントリを更新する作業を含みます。

    4. /i-1-aのフェッチが完了する前に、frames[0] ナビゲーブルの新しく作成されたドキュメントに対してスクリプトが実行される可能性があるポイントに到達します。あるスクリプトが実際に実行されます: 

      location.href = '#foo'

      これにより、同期的にframes[0]ナビゲーブルのアクティブなセッション履歴エントリが、URL/i-0-a#fooを持つ新しく作成されたものに変更され、その新しいエントリについて中央の信頼できる情報源に通知する同期ステップが追加されます。

      前の例とは異なり、これらの同期ステップは「キューを飛ばして」、/i-1-aのフェッチを完了する前にトラバースの更新を行うことはありません。これは、対象のナビゲーブルframes[0]がすでにトラバースの一部として変更されているためです。したがって、現在のセッション履歴ステップが2であるため、新しいエントリをステップ3として追加することは意味がありません。

    5. 最終的に/i-1-aのフェッチが完了したら、frames[1]のナビゲーブルを更新する作業を続行し、URL/i-1-aを持つアクティブなセッション履歴エントリに更新します。

    6. 両方のナビゲーブルがトラバースの処理を完了したら、ターゲットステップ0に現在のセッション履歴ステップを更新します。

  2. これで、同期ナビゲーションのためにキューに登録されたステップを処理できます:

    1. /i-0-a#fooのエントリが追加され、そのステップが1と判断されます。現在のセッション履歴ステップ（つまり、0）に1を加えたものです。これにより、既存のフォワード履歴がクリアされます。

    2. その新しく追加されたエントリに完全に切り替え、履歴ステップの適用を呼び出します。これにより最終的には、ドキュメントの更新が行われ、hashchangeのようなイベントがディスパッチされるとともに、ターゲットステップ1に現在のセッション履歴ステップが更新されます。

最終的な結果は:

0 1
top /t
frames[0] /i-0-a /i-0-a#foo
frames[1] /i-1-a
7.4.1.4 セッション履歴に対する低レベルの操作

このセクションでは、セッション履歴を操作する際に標準全体で実行するさまざまな操作をまとめています。これらの操作が何をするかを理解する最良の方法は、それらが呼び出される箇所を確認することです。

ナビゲーブルのセッション履歴エントリを取得するには:

  1. navigableのトラバース可能なナビゲーブルをtraversableに設定します。

  2. アサート: これがtraversableのセッション履歴トラバースキュー内で実行されていることを確認します。

  3. もしnavigableがtraversableであるなら、traversableのセッション履歴エントリを返します。

  4. docStatesを空の順序付きセットに設定します。これはドキュメント状態を格納します。

  5. traversableのセッション履歴エントリの各entryについて、entryのドキュメント状態をdocStatesに追加します。

  6. 各docStateについて、docStatesの中で次の操作を行います:

    1. 各nestedHistoryについて、docStateのネストされた履歴の中で次の操作を行います:

      1. もしnestedHistoryの識別子がnavigableの識別子と一致するなら、nestedHistoryのエントリを返します。

      2. nestedHistoryのエントリの各entryについて、entryのドキュメント状態をdocStatesに追加します。

  7. アサート: このステップには到達しないことを確認します。

整数targetStepを与えて、ナビゲーブルのナビゲーションAPIのためのセッション履歴エントリを取得するには:

  1. rawEntriesをセッション履歴エントリを取得した結果に設定します。

  2. entriesForNavigationAPIを新しい空のリストに設定します。

  3. startingIndexを、rawEntriesの中で、targetStep以下の最大のステップを持つセッション履歴エントリのインデックスに設定します。

    なぜそれがtargetStep以下の最大のステップであるかを理解するために、この例を参照してください。

  4. rawEntries[startingIndex]をentriesForNavigationAPIに追加します。

  5. startingOriginをrawEntries[startingIndex]のドキュメント状態のオリジンに設定します。

  6. iをstartingIndex − 1に設定します。

  7. iが0より大きい間、次の操作を行います:

    1. もしrawEntries[i]のドキュメント状態のオリジンがstartingOriginと同一オリジンでないなら、中断します。

    2. rawEntries[i]をentriesForNavigationAPIに先頭に追加します。

    3. iをi − 1に設定します。

  8. iをstartingIndex + 1に設定します。

  9. iがrawEntriesのサイズより小さい間、次の操作を行います:

    1. もしrawEntries[i]のドキュメント状態のオリジンがstartingOriginと同一オリジンでないなら、中断します。

    2. rawEntries[i]をentriesForNavigationAPIに追加します。

    3. iをi + 1に設定します。

  10. entriesForNavigationAPIを返します。

トラバース可能なナビゲーブルのフォワードセッション履歴をクリアするには:

  1. アサート: これがnavigableのセッション履歴トラバースキュー内で実行されていることを確認します。

  2. stepをnavigableの現在のセッション履歴ステップに設定します。

  3. entryListsをnavigableのセッション履歴エントリからなる順序付きセットに設定します。

  4. 各entryListについて、entryListsの中で次の操作を行います:

    1. 削除します。entryListの中でstepよりも大きいステップを持つすべてのセッション履歴エントリを削除します。

    2. 各entryについて、entryListの中で次の操作を行います:

      1. 各nestedHistoryについて、entryのドキュメント状態のネストされた履歴の中で、nestedHistoryのエントリリストをentryListsに追加します。

トラバース可能なナビゲーブルの一部であるすべての使用済み履歴ステップを取得するには:

  1. アサート: これがtraversableのセッション履歴トラバースキュー内で実行されていることを確認します。

  2. stepsを非負の整数の空の順序付きセットに設定します。

  3. entryListsをtraversableのセッション履歴エントリからなる順序付きセットに設定します。

  4. 各entryListについて、entryListsの中で次の操作を行います:

    1. 各entryについて、entryListの中で次の操作を行います:

      1. entryのステップをstepsに追加します。

      2. 各nestedHistoryについて、entryのドキュメント状態のネストされた履歴の中で、nestedHistoryのエントリリストをentryListsに追加します。

  5. stepsを返し、昇順にソートします。

特定のアクションによって、ナビゲーブルが新しいリソースにナビゲートされることがあります。

例えば、ハイパーリンクのフォロー、フォーム送信、およびwindow.open()やlocation.assign()メソッドは、すべてナビゲーションを引き起こす可能性があります。

この標準では「ナビゲーション」という言葉は特にナビゲートアルゴリズムを指しますが、これがウェブ開発者やユーザーの認識と必ずしも一致するわけではありません。例えば:

ナビゲートアルゴリズム自体に入る前に、それが使用するいくつかの重要な構造を確立する必要があります。

ソーススナップショットパラメータ 構造体は、ナビゲーションを開始するDocumentからデータをキャプチャするために使用されます。これは、ナビゲーションの開始時にスナップショットされ、ナビゲーションのライフタイム全体で使用されます。次の項目があります:

一時的なアクティベーションを持つ
ブール値
サンドボックスフラグ
サンドボックスフラグセット
ダウンロードを許可する
ブール値
フェッチクライアント
環境設定オブジェクトまたは null（リクエストクライアントとしてのみ使用）
ソースポリシーコンテナ
ポリシーコンテナ

Document または null の sourceDocument を指定して、ソーススナップショットパラメータをスナップショットするには：

  1. sourceDocument が null の場合、次の新しいソーススナップショットパラメータを返します。

    一時的なアクティベーションを持つ
    true
    サンドボックスフラグ
    空のサンドボックスフラグセット
    ダウンロードを許可する
    true
    フェッチクライアント
    null
    ソースポリシーコンテナ
    新しいポリシーコンテナ

    これは、ブラウザ UI によって開始されたナビゲーションの場合にのみ発生します。

  2. 次の新しいソーススナップショットパラメータを返します。

    一時的なアクティベーションを持つ
    sourceDocument の関連するグローバルオブジェクトが一時的なアクティベーションを持つ場合は true、それ以外の場合は false
    サンドボックスフラグ
    sourceDocument のアクティブなサンドボックスフラグセット
    ダウンロードを許可する
    sourceDocument のアクティブなサンドボックスフラグセットにサンドボックス化されたダウンロード閲覧コンテキストフラグが設定されている場合は false、それ以外の場合は true
    フェッチクライアント
    sourceDocument の関連する設定オブジェクト
    ソースポリシーコンテナ
    sourceDocument のポリシーコンテナのクローン

ターゲットスナップショットパラメータ 構造体は、ナビゲートされるナビゲーブルからデータをキャプチャするために使用されます。ソーススナップショットパラメータと同様に、ナビゲーションの開始時にスナップショットされ、ナビゲーションのライフタイム全体で使用されます。次の項目があります:

サンドボックスフラグ
サンドボックスフラグセット

targetNavigableとしてナビゲーブルを与えたときにターゲットスナップショットパラメータをスナップショットするには、次のようにして返します:サンドボックスフラグを、targetNavigableのアクティブブラウジングコンテキストおよびtargetNavigableのコンテナを与えた場合のサンドボックスフラグの決定の結果として設定します。

ナビゲーションプロセスの多くは、新しいドキュメントをどのように作成するかを決定することに関係しており、最終的にはDocumentオブジェクトを作成および初期化するアルゴリズムで行われます。そのアルゴリズムへのパラメーターは、次の項目を持つナビゲーションパラメーター 構造体を通じて追跡されます:

id
nullまたはナビゲーションID
ナビゲーブル
ナビゲートされるナビゲーブル
リクエスト
nullまたはナビゲーションを開始したリクエスト
レスポンス
最終的にナビゲートされたレスポンス（ネットワークエラーである可能性もあります）
フェッチコントローラ
nullまたはフェッチコントローラ
初期ヒントをコミットする
nullまたはDocumentが作成された後に受け取るアルゴリズム
COOPエンフォースメント結果
報告およびブラウジングコンテキストグループの切り替えを引き起こす可能性があるクロスオリジンオープナーポリシーエンフォースメント結果
予約された環境
nullまたは新しいDocument用に予約された環境
オリジン
新しいDocumentに使用するオリジン
ポリシーコンテナ
新しいDocumentに使用するポリシーコンテナ
最終的なサンドボックスフラグセット
新しいDocumentに課すサンドボックスフラグセット
クロスオリジンオープナーポリシー
新しいDocumentに使用するクロスオリジンオープナーポリシー
ナビゲーションタイミングタイプ
新しいDocumentのためにナビゲーションタイミングエントリを作成するために使用されるNavigationTimingType
aboutベースURL
新しいDocumentのaboutベースURLを設定するために使用されるURLまたはnull
ユーザーの関与
新しい Document のブラウジングコンテキストを取得する際に使用されるユーザーナビゲーションの関与

一度ナビゲーションパラメータ構造体が作成されると、この標準はその項目を変更しません。これらは他のアルゴリズムに渡されるだけです。

ナビゲーションIDは、ナビゲーション中に生成されるUUID文字列です。これは、WebDriver BiDi仕様とのインターフェースや進行中のナビゲーションを追跡するために使用されます。[WEBDRIVERBIDI]

Document作成後、関連するトラバーサブルナビゲーブルのセッション履歴が更新されます。NavigationHistoryBehavior列挙型は、ナビゲートアルゴリズムにセッション履歴の更新タイプを指定するために使用されます。それは次のいずれかです:

"push"
新しいセッション履歴エントリを追加し、フォワードセッション履歴をクリアする通常のナビゲーション
"replace"
アクティブなセッション履歴エントリを置き換えるナビゲーション
"auto"
デフォルト値であり、ナビゲートアルゴリズムの非常に早い段階で"push"または"replace"に変換されます。通常は"push"になりますが、特定の状況では"replace"になることがあります。

履歴処理の挙動は、"push"または"replace"であり、初期の"auto"値から解決されたものです。

urlがDocumentのdocumentである場合に、ナビゲーションは必ず置き換えになります:

他のケースでは、"replace"ナビゲーションがしばしば（ただし常にではない）強制されます:

プラットフォームのさまざまな部分では、ユーザーがナビゲーションに関与しているかどうかを追跡します。ユーザーのナビゲーション関与は、次のいずれかです:

"ブラウザUI"
ナビゲーションはブラウザUIのメカニズムを介してユーザーによって開始されました
"アクティベーション"
ナビゲーションは要素のアクティベーション動作を介してユーザーによって開始されました
"なし"
ナビゲーションはユーザーによって開始されませんでした

特定の呼び出しサイトでの便宜のために、eventがイベントである場合のユーザーのナビゲーション関与は次のように定義されます:

  1. 確認:このアルゴリズムはアクティベーション動作の定義の一部として呼び出されています。

  2. 確認:eventのタイプが"クリック"であること。

  3. eventのisTrustedがtrueに初期化されている場合、"アクティベーション"を返します。

  4. "なし"を返します。

7.4.2.2 ナビゲーションの開始

ナビゲート可能 navigable を Document sourceDocument を使用して URL url へナビゲートするには、オプションのPOST リソース、文字列、または null の documentResource（デフォルトは null）、オプションのレスポンスまたは null の response（デフォルトは null）、オプションのブール値 exceptionsEnabled（デフォルトは false）、オプションの NavigationHistoryBehavior historyHandling（デフォルトは "auto"）、オプションのシリアル化された状態または null の navigationAPIState（デフォルトは null）、オプションのエントリリストまたは null の formDataEntryList（デフォルトは null）、オプションのリファラーポリシー referrerPolicy（デフォルトは空文字列）、オプションのユーザーナビゲーション関与 userInvolvement（デフォルトは "none"）、オプションの Element sourceElement（デフォルトは null）、およびオプションのブール値 initialInsertion（デフォルトは false）を指定して：

  1. もしformDataEntryListがnullでなければ、cspNavigationTypeを"form-submission"とする。そうでなければ"other"とする。

  2. sourceSnapshotParamsを、sourceDocumentを与えてスナップショットソーススナップショットパラメータの結果とする。

  3. initiatorOriginSnapshotを新しい不透明なオリジンとする。

  4. initiatorBaseURLSnapshotをabout:blankとする。

  5. もしsourceDocumentがnullの場合:

    1. Assert: userInvolvementは"browser UI"である。

    2. もしurlのスキームが"javascript"の場合、initiatorOriginSnapshotをnavigableのアクティブなドキュメントのオリジンに設定する。

  6. そうでなければ:

    1. Assert: userInvolvementは"browser UI"ではない。

    2. initiatorOriginSnapshotをsourceDocumentのオリジンに設定する。

    3. initiatorBaseURLSnapshotをsourceDocumentのドキュメントベースURLに設定する。

  7. navigationId を、ランダムUUID生成の結果とします。 [WEBCRYPTO]

  8. もし周辺エージェントがnavigableのアクティブドキュメントの関連エージェントと等しい場合は、これらの手順を続行します。そうでない場合は、navigableのアクティブウィンドウに基づいてグローバルタスクをキューに追加し、これらの手順を続行します。

    これは、navigableのアクティブドキュメントの多くのプロパティを調べようとしているためです。これらのプロパティは理論的には適切なイベントループでのみアクセス可能です。（ただし、同じイベントループ内でフラグメントナビゲーションが同期的に有効になる必要があるため、タスクを無条件にキューに追加することは望ましくありません。）

    もう一つの実装戦略としては、関連情報をイベントループ間で複製するか、または正規の「ブラウザプロセス」に複製して、タスクをキューに追加せずに参照できるようにする方法があります。この方法は、エッジケースでは、ターゲットイベントループで関連プロパティが変更されましたが、まだ複製されていない場合、ここで指定するものとは異なる結果を生む可能性があります。どの戦略がブラウザの動作に最も適しているかを確認するために、さらなるテストが必要です。

  9. navigable の アクティブなドキュメントの アンロードカウンターが 0 より大きい場合、navigable と、その id が navigationId、status が "canceled"、および url が url である WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーション失敗を呼び出し、戻ります。

  10. containerをnavigableのコンテナとします。

  11. もしcontainerがiframeエレメントであり、containerが遅延読み込み要素のステップを実行するとtrueを返す場合、遅延読み込み要素の交差観測を停止し、containerの遅延読み込み再開ステップをnullに設定します。

  12. もしナビゲーションが置換でなければならない場合、urlとnavigableのアクティブドキュメントに基づいて、historyHandlingを"置換"に設定します。

  13. navigable の 親が null でない場合、navigable の load イベントを遅延させているかを true に設定します。

  14. targetSnapshotParams を、navigable を指定してターゲットスナップショットパラメータをスナップショットする結果とします。

  15. navigable と、その id が navigationId、status が "pending"、および url が url である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーション開始を呼び出します。

  16. navigable の 進行中のナビゲーションが "traversal" の場合：

    1. navigable と、その id が navigationId、status が "canceled"、および url が url である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーション失敗を呼び出します。

    2. 戻ります。

    現在トラバース中のナビゲブルをナビゲートしようとする試みは無視されます。

  17. navigable の進行中のナビゲーションを設定します。値を navigationId にします。

    これにより、navigable の他の進行中のナビゲーションが中止されます。なぜなら、ナビゲーション中の特定の時点で進行中のナビゲーションへの変更により、さらなる作業が破棄されるためです。

  18. url の スキームが "javascript" の場合：

    1. navigable の アクティブウィンドウで、ナビゲーションおよびトラバーサルタスクソースにグローバルタスクをキューに入れ、navigable、url、historyHandling、sourceSnapshotParams、initiatorOriginSnapshot、userInvolvement、cspNavigationType、および initialInsertion を指定して javascript: URL へナビゲートします。

    2. 戻ります。

  19. 次のすべてが true の場合：

    その場合：

    1. navigation を navigable の アクティブウィンドウの ナビゲーション API とします。

    2. documentResource が POST リソースの場合、entryListForFiring を formDataEntryList とします。それ以外の場合は null とします。

    3. navigationAPIState が null でない場合、navigationAPIStateForFiring を navigationAPIState とします。それ以外の場合は、StructuredSerializeForStorage(undefined) とします。

    4. continue を、navigation で navigationType を historyHandling に、isSameDocument を false に、userInvolvement を userInvolvement に、sourceElement を sourceElement に、formDataEntryList を entryListForFiring に、destinationURL を url に、navigationAPIState を navigationAPIStateForFiring に設定して、プッシュ/置換/リロード navigate イベントを発行した結果とします。

    5. continue が false の場合、戻ります。

    userInvolvement が "browser UI" のナビゲーション、またはクロスオリジンドメインの sourceDocument によって開始されたナビゲーションが、以前のフラグメントへのナビゲートパスを経由する場合、navigate イベントを発行する可能性があります。

  20. 並行して、これらのステップを実行します：

    1. unloadPromptCanceled を、navigable の アクティブなドキュメントの 包括的な子孫ナビゲブルについてアンロードがキャンセルされたかどうかを確認した結果とします。

    2. unloadPromptCanceled が true の場合、または navigable の 進行中のナビゲーションがもはや navigationId ではない場合：

      1. navigable と、その id が navigationId、status が "canceled"、および url が url である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーション失敗を呼び出します。

      2. これらのステップを中止します。

    3. navigable の アクティブウィンドウを指定して、ナビゲーションとトラバーサルのタスクソースでグローバルタスクをキューに入れます。そのタスクは、navigable の アクティブなドキュメントを指定して、ドキュメントとその子孫を中止します。

    4. url が about:blank に一致するか、または about:srcdoc の場合：

      1. documentState の オリジンを initiatorOriginSnapshot に設定します。

      2. documentState の about ベース URLを initiatorBaseURLSnapshot に設定します。

    5. historyEntry を、その URL を url に、その ドキュメント状態を documentState に設定した、新しいセッション履歴エントリとします。

    6. navigationParams を null とします。

    7. response が null でない場合：

      ナビゲートアルゴリズムは、object および embed 処理モデルの一部として、または初期応答後のmultipart/x-mixed-replace 応答の一部を処理するためにのみ、レスポンスが提供されます。

      1. sourcePolicyContainerを、もしsourceDocumentがnullでなければ、sourceDocumentのポリシコンテナのクローンとする。そうでなければnullとする。

      2. policyContainerを、responseのURL、null、sourcePolicyContainer、navigableのコンテナドキュメントのポリシコンテナ、およびnullを与えてナビゲーションパラメータポリシコンテナの決定の結果とする。

      3. finalSandboxFlagsを、targetSnapshotParamsのサンドボックスフラグとpolicyContainerのCSPリストのCSP由来サンドボックスフラグの和集合とする。

      4. responseOriginを、responseのURL、finalSandboxFlags、およびdocumentStateのイニシエータオリジンを与えてオリジンを決定の結果とする。

      5. coopを新しいオープナーポリシーとする。

      6. coopEnforcementResultを、以下のオープナーポリシーエンフォースメント結果とする。

        url
        responseのURL
        origin
        responseOrigin
        opener policy
        coop

      7. navigationParamsを、以下の新しいナビゲーションパラメータに設定する。

        id
        navigationId
        navigable
        navigable
        request
        null
        response
        response
        fetch controller
        null
        commit early hints
        null
        COOP enforcement result
        coopEnforcementResult
        reserved environment
        null
        origin
        responseOrigin
        policy container
        policyContainer
        final sandboxing flag set
        finalSandboxFlags
        opener policy
        coop
        navigation timing type
        "navigate"
        about base URL
        documentStateのabout base URL
        user involvement
        userInvolvement

    8. historyEntry について、navigable、"navigate"、 sourceSnapshotParams、 targetSnapshotParams、userInvolvement、navigationId、 navigationParams、cspNavigationType を指定して、allowPOST を true に、completionSteps を次のステップに設定して、履歴エントリのドキュメントへの入力試行を行います。

      1. navigable、historyHandling、userInvolvement、および historyEntry を指定して、navigable の トラバーサブルにセッション履歴トラバーサルステップを追加し、クロスドキュメントナビゲーションを確定します。

7.4.2.3 ナビゲーションの終了

通常のクロスドキュメントナビゲーションの場合、まずセッション履歴エントリの作成に進み、 Documentを使用しますが、途中で中止されなかったナビゲーションは、最終的に以下のいずれかのアルゴリズムを呼び出すことになります。

7.4.2.3.1 通常のクロスドキュメントナビゲーションの場合

ナビゲブル navigable、履歴処理動作 historyHandling、ユーザーナビゲーションの関与 userInvolvement、およびセッション履歴エントリ historyEntry を指定して、クロスドキュメントナビゲーションを確定するには：

  1. アサートします： これはnavigableのトラバース可能なnavigableの セッション履歴トラバーサルキューで実行されています。

  2. navigableのロードイベントの遅延をfalseに設定します。

  3. もしhistoryEntryのドキュメントがnullである場合、リターンします。

    これは履歴エントリのドキュメントを入力しようとする試みが、ナビゲーションのキャンセルや204 No Contentレスポンスなどの結果としてドキュメントを作成しなかったことを意味します。

  4. 次のすべてがtrueである場合：

    その場合、historyEntryのドキュメント状態の navigableターゲット名を空文字列に設定します。

  5. もしhistoryHandlingが"replace"である場合、 navigableのアクティブなセッション履歴エントリをentryToReplaceとします。 そうでない場合はnullに設定します。

  6. navigableのトラバース可能なnavigableをtraversableとします。

  7. targetStepをnullに設定します。

  8. セッション履歴エントリの取得の結果を navigableのためにtargetEntriesとします。

  9. もしentryToReplaceがnullである場合、次を実行します：

    1. 順方向のセッション履歴をクリアし、 traversableのものとします。

    2. traversableの現在のセッション履歴ステップ + 1を targetStepに設定します。

    3. historyEntryのステップをtargetStepに設定します。

    4. 追加します。 historyEntryをtargetEntriesに追加します。

    そうでない場合：

    1. 置換します。 entryToReplaceをhistoryEntryにtargetEntries内で置き換えます。

    2. historyEntryのステップを entryToReplaceのステップに設定します。

    3. もしhistoryEntryのドキュメント状態の オリジンが entryToReplaceのドキュメント状態の オリジンと 同一オリジンである場合、 historyEntryのナビゲーションAPIキーを entryToReplaceのナビゲーションAPIキーに設定します。

    4. traversableの現在のセッション履歴ステップを targetStepに設定します。

  10. historyHandling と userInvolvement を指定して、traversable にプッシュ/置換履歴ステップを適用します targetStep。

7.4.2.3.2 javascript: URLの特別なケース

javascript: URLには、仕様に関するさまざまな問題を記録した専用のラベルがあります。

ナビゲート可能 targetNavigable、URL url、履歴処理動作 historyHandling、ソーススナップショットパラメータ sourceSnapshotParams、オリジン initiatorOrigin、ユーザーナビゲーション関与 userInvolvement、文字列 cspNavigationType、およびブール値 initialInsertion を指定して、javascript: URL へナビゲートするには：

  1. アサートします：historyHandlingが"replace"であることを確認します。

  2. 現在のナビゲーションを設定し、targetNavigableをnullにします。

  3. もしinitiatorOriginが、targetNavigableのアクティブドキュメントのoriginと同一オリジンドメインでない場合、リターンします。

  4. request を、そのURL が url であり、そのポリシーコンテナが sourceSnapshotParams の ソースポリシーコンテナである新しいリクエストとします。

    これは次のステップに進むための合成されたリクエストであり、ネットワークには到達しません。

  5. もし、コンテンツセキュリティポリシーによってナビゲーションリクエストをブロックすべきかをrequestとcspNavigationTypeを与えて実行した結果が"Blocked"である場合、リターンします。[CSP]

  6. newDocument を、targetNavigable、url、initiatorOrigin、および userInvolvement を指定してjavascript: URL を評価した結果とします。

  7. newDocument が null の場合：

    1. initialInsertion が true であり、かつ targetNavigable の アクティブドキュメントの 初期 about:blank であるが true の場合、targetNavigable の コンテナを指定して iframe ロードイベントステップを実行します。

    2. 戻ります。

    この場合、JavaScriptコードは実行されましたが、新しいDocumentは作成されていないため、ナビゲーションは実行されません。

  8. アサートします：initiatorOriginがnewDocumentのoriginであることを確認します。

  9. entryToReplaceをtargetNavigableのアクティブなセッション履歴エントリとして設定します。

  10. oldDocStateをentryToReplaceのドキュメント状態として設定します。

  11. documentStateを新しいドキュメント状態として以下のプロパティを設定します：

    document
    newDocument
    履歴ポリシーコンテナ
    非nullの場合、oldDocStateの履歴ポリシーコンテナのクローン、そうでなければnull
    リクエスト参照元
    oldDocStateのリクエスト参照元
    リクエスト参照ポリシー
    oldDocStateのリクエスト参照ポリシーまたはこれはreferrerPolicyであるべきですか？navigateに渡された値ですか？
    発信者オリジン
    initiatorOrigin
    オリジン
    initiatorOrigin
    about: ベースURL
    oldDocStateのベースURL
    リソース
    null
    一度でも設定されたか
    true
    ナビゲーブルターゲット名
    oldDocStateのナビゲーブルターゲット名

  12. historyEntryを新しいセッション履歴エントリとして以下のプロパティを設定します：

    URL
    entryToReplaceのURL
    ドキュメント状態
    documentState

    このURLでは、実際にナビゲーションアルゴリズムに渡されたjavascript: URLは使用されません。これにより、javascript: URLがセッション履歴に保存されることはなく、そのためセッション履歴に遡ることはできません。

  13. targetNavigable の トラバーサブルにセッション履歴トラバーサルステップを追加し、targetNavigable、historyHandling、userInvolvement、および historyEntry を使用してクロスドキュメントナビゲーションを確定します。

ナビゲブル targetNavigable、URL url、オリジン newDocumentOrigin、およびユーザーナビゲーションの関与 userInvolvement を指定して、javascript: URL を評価するには：

  1. urlStringをURLシリアライザをurlに対して実行した結果とします。

  2. encodedScriptSourceをurlStringから先頭の"javascript:"を取り除いた結果とします。

  3. scriptSourceをUTF-8デコードを行い、 パーセントデコードされたencodedScriptSourceを設定します。

  4. settingsをtargetNavigableのアクティブドキュメントの関連設定オブジェクトに設定します。

  5. baseURLをsettingsのAPIベースURLに設定します。

  6. scriptをクラシックスクリプトを作成し、scriptSource、settings、baseURLを指定し、デフォルトスクリプトフェッチオプションで設定します。

  7. evaluationStatusをクラシックスクリプトを実行した結果とします。

  8. resultをnullに設定します。

  9. もしevaluationStatusが正常終了であり、evaluationStatus.[[Value]]が文字列である場合、resultにevaluationStatus.[[Value]]を設定します。

  10. それ以外の場合はnullをリターンします。

  11. responseを新しいレスポンスとして以下のプロパティを設定します：

    URL
    targetNavigableのアクティブドキュメントのURL
    ヘッダーリスト
    « (`Content-Type`, `text/html;charset=utf-8`) »
    ボディ
    resultのUTF-8エンコード、ボディとして設定します。

    UTF-8へのエンコードにより、サロゲートペアが失われる可能性があります。

  12. policyContainerをtargetNavigableのアクティブドキュメントのポリシーコンテナに設定します。

  13. finalSandboxFlagsをpolicyContainerのCSPリストのCSP派生のサンドボックスフラグに設定します。

  14. coopをtargetNavigableのアクティブドキュメントのオープナーポリシーに設定します。

  15. coopEnforcementResultを新しいクロスオリジンオープナーポリシー実施結果として以下のプロパティを設定します：

    url
    url
    origin
    newDocumentOrigin
    クロスオリジンオープナーポリシー
    coop

  16. navigationParamsを新しいナビゲーションパラメータとして以下のプロパティを設定します：

    id
    navigationId
    navigable
    targetNavigable
    リクエスト
    nullこれにより、結果のDocumentの参照元がnullになります。これは正しいですか？
    レスポンス
    response
    フェッチコントローラ
    null
    初期ヒントをコミット
    null
    COOP実施結果
    coopEnforcementResult
    予約された環境
    null
    origin
    newDocumentOrigin
    ポリシーコンテナ
    policyContainer
    最終サンドボックスフラグセット
    finalSandboxFlags
    クロスオリジンオープナーポリシー
    coop
    ナビゲーションタイミングタイプ
    "navigate"
    about: ベースURL
    targetNavigableのアクティブドキュメントのabout ベースURL
    ユーザーの関与
    userInvolvement

  17. HTMLドキュメントを読み込む結果をnavigationParamsに従って返します。

7.4.2.3.3 フラグメントナビゲーション

ナビゲブル navigable、URL url、履歴処理の動作 historyHandling、ユーザーナビゲーションの関与 userInvolvement、Element または null の sourceElement、シリアル化された状態または null の navigationAPIState、およびナビゲーション ID navigationId を指定して、フラグメントにナビゲートするには：

  1. navigationをnavigableのアクティブウィンドウのナビゲーションAPI とします。

  2. destinationNavigationAPIStateをnavigableのアクティブセッション履歴エントリのナビゲーションAPI状態 とします。

  3. もしnavigationAPIStateがnullでない場合は、destinationNavigationAPIState にnavigationAPIStateを設定します。

  4. continue を、navigation で navigationType を historyHandling に、isSameDocument を true に、userInvolvement を userInvolvement に、sourceElement を sourceElement に、destinationURL を url に、そして navigationAPIState を destinationNavigationAPIState に設定して、プッシュ/置換/リロード navigate イベントを発行した結果とします。

  5. もしcontinueがfalseの場合は、終了します。

  6. historyEntryを新しいセッション履歴エントリとして、以下を持つものとします:

    URL
    url
    ドキュメントの状態
    navigableのアクティブセッション履歴エントリのドキュメントの状態
    ナビゲーションAPI状態
    destinationNavigationAPIState
    スクロール復元モード
    navigableのアクティブセッション履歴エントリのスクロール復元モード

    navigation.navigate()を使用したナビゲーションでは、新しいナビゲーションAPI状態に、stateオプションで提供された値が使用されます。（このオプションに値が提供されていない場合は未定義のシリアライズに設定されます。）他のフラグメントナビゲーション、特にユーザーが発生させたものでは、ナビゲーションAPI状態は前のエントリから引き継がれます。

    クラシック履歴API状態は決して引き継がれません。

  7. entryToReplaceを、navigableのアクティブセッション履歴エントリとし、 もしhistoryHandlingが"置換"の場合はnullとします。

  8. historyを、navigableのアクティブドキュメントの履歴オブジェクト とします。

  9. scriptHistoryIndexをhistoryのインデックスとします。

  10. scriptHistoryLengthをhistoryの長さとします。

  11. もしhistoryHandlingが"プッシュ"の場合は:

    1. historyの状態をnullに設定します。

    2. scriptHistoryIndexをインクリメントします。

    3. scriptHistoryLengthをscriptHistoryIndex + 1に設定します。

  12. navigableのアクティブドキュメントのURLをurlに設定します。

  13. navigableのアクティブセッション履歴エントリをhistoryEntry に設定します。

  14. 履歴ステップ適用のためのドキュメントを更新を、navigableのアクティブドキュメント、 historyEntry、true、scriptHistoryIndex、scriptHistoryLength、およびhistoryHandling を与えて実行します。

    このアルゴリズムは、単一のフラグメントナビゲーションの結果として2回呼び出されます。1回目は同期的に呼び出され、scriptHistoryIndexとscriptHistoryLengthの推測値が設定され、history.stateがnullに設定され、さまざまなイベントが発生します。2回目は非同期的に呼び出され、インデックスと長さの最終値が設定され、history.stateは変更されず、イベントも発生しません。

  15. navigableのアクティブドキュメントを与えて、フラグメントにスクロールします。

    スクロールが失敗する場合、それはドキュメントが新しいものであり、関連するIDがまだパースされていないためです。その場合、履歴ステップ適用のためのドキュメントを更新の2回目の非同期呼び出しがスクロール処理を行います。

  16. navigableのトラバース可能なナビゲーブル をtraversableとします。

  17. navigableを含むセッション履歴同期ナビゲーションステップを追加 をtraversableに追加します。

    1. traversable、navigable、historyEntry、entryToReplace、historyHandling、および userInvolvement を指定して、同一ドキュメントナビゲーションを確定します。

    2. navigable と、その id が navigationId、url が url、そして status が "complete" である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi フラグメントナビゲートを呼び出します。

トラバーサブルナビゲブル traversable、ナビゲブル targetNavigable、セッション履歴エントリ targetEntry、セッション履歴エントリまたは null の entryToReplace、履歴処理の動作 historyHandling、およびユーザーナビゲーションの関与 userInvolvement を指定して、同一ドキュメントナビゲーションを確定するには：

これは、フラグメントナビゲーションおよびURLおよび履歴更新ステップによって使用されます。これらはセッション履歴の唯一の同期的な更新です。同期的であることから、これらのアルゴリズムはトップレベルのトラバース可能なナビゲーブルのセッション履歴トラバースキューの外部で実行されます。これにより、トップレベルのトラバース可能なナビゲーブルの現在のセッション履歴ステップと同期が取れなくなります。このアルゴリズムは、競合状態による競合を解決するために使用されます。

  1. アサート: これはtraversableのセッション履歴トラバースキューで実行されています。

  2. もしtargetNavigableのアクティブセッション履歴エントリがtargetEntryでない場合は、終了します。

  3. targetStepをnullに設定します。

  4. targetEntriesをtargetNavigableのためにセッション履歴エントリを取得する結果とします。

  5. もしentryToReplaceがnullの場合は:

    1. traversableのフォワードセッション履歴をクリア します。

    2. targetStepをtraversableの現在のセッション履歴ステップ + 1に設定します。

    3. targetEntryのステップをtargetStepに設定します。

    4. targetEntryをtargetEntriesに追加 します。

    それ以外の場合:

    1. entryToReplaceをtargetEntriesの中でtargetEntryと置換します。

    2. targetEntryのステップをentryToReplaceのステップに設定します。

    3. targetStepをtraversableの現在のセッション履歴ステップに設定します。

  6. historyHandling と userInvolvement を指定して、traversable にプッシュ/置換履歴ステップを適用します targetStep。

    これは、"置換"ナビゲーションでも行われます。これは複数の同期ナビゲーション間の競合状態を解決します。

7.4.2.3.4 非フェッチスキームと外部ソフトウェア

非フェッチスキームドキュメントを作成しようとする 入力は非フェッチスキームナビゲーションパラメータであり、構造体です。これは、非フェッチスキームナビゲーションケースに関連するパラメータのみを保持する軽量バージョンです。次の項目を持ちます:

id
nullまたはナビゲーションID
ナビゲーブル
ナビゲーションを行うナビゲーブル
URL
URL
ターゲットスナップショットのサンドボックスフラグ
ターゲットスナップショットパラメータのサンドボックスフラグ
ソーススナップショットに一時的なアクティベーションがある
ソーススナップショットパラメータの 一時的なアクティベーションがあるブール値
イニシエーターのオリジン

外部ソフトウェアパッケージの起動を確認するためのユーザー向けプロンプトで使用される可能性のあるオリジン

これは、ドキュメントの状態のイニシエーターのオリジンとは少し異なり、非フェッチスキームナビゲーションパラメータのイニシエーターのオリジンは、リダイレクトチェーンで最後に非フェッチスキームURLにリダイレクトされるまでリダイレクトを追跡します。

ナビゲーションタイミングタイプ
新しい Document（作成された場合）のナビゲーションタイミングエントリを作成するために使用される NavigationTimingType
ユーザーの関与
新しい Document（作成された場合）のブラウジングコンテキストを取得する際に使用されるユーザーナビゲーションの関与

非フェッチスキームドキュメントを作成しようとするためには、非フェッチスキームナビゲーションパラメータ navigationParamsを与えます:

  1. navigationParamsのURLをurlとします。
  2. navigationParamsのナビゲーブルをnavigableとします。

  3. もしurlがnavigableに影響を与えないメカニズムで処理されるべき場合、例としてurlのスキームが外部で処理される場合は:

    1. url、navigable、navigationParamsのターゲットスナップショットサンドボックスフラグ、 navigationParamsのソーススナップショットに一時的なアクティベーションがある、 navigationParamsのイニシエーターのオリジン を指定して、外部ソフトウェアに引き渡します。

    2. nullを返します。

  4. url を、何らかのインラインコンテンツ（例えば、指定されたスキームがサポートされているプロトコルの一つではないためエラーメッセージを表示したり、指定されたスキームに対して登録されたハンドラをユーザーが選択できるようにするためのインラインプロンプトを表示したりするなど）を表示することで処理します。navigable、navigationParams の id、navigationParams の ナビゲーションタイミングタイプ、および navigationParams の ユーザーの関与を指定して、インラインコンテンツを表示した結果を返します。

    登録されたハンドラーが使用される場合、新しいURLでnavigateが呼び出されます。

与えられたURLまたはレスポンス resource、ナビゲーブル navigable、サンドボックスフラグセット sandboxFlags、ブール値 hasTransientActivation、およびオリジン initiatorOriginが与えられた場合、外部ソフトウェアに引き渡すためには、ユーザーエージェントは次を行うべきです:

  1. 次のすべてが真である場合:

    この場合、外部ソフトウェアパッケージを起動せずに戻ります。

    iframe内の外部ソフトウェアへのナビゲーションは、ユーザーに新しいポップアップまたは新しいトップレベルナビゲーションとして見える場合があります。そのため、iframe では、次のいずれかが指定されている場合にのみ許可されます: allow-popups、 allow-top-navigation、 allow-top-navigation-by-user-activation、 またはallow-top-navigation-to-custom-protocols。

  2. resourceの適切な引き渡しを行い、ターゲットソフトウェアを悪用しようとする試みであるリスクを軽減するよう努めます。例えば、ユーザーエージェントは、initiatorOriginが対象の外部ソフトウェアを起動することを許可するかどうかを確認するためにユーザーにプロンプトを表示することができます。特に、hasTransientActivationが偽である場合、ユーザーの事前確認なしに外部ソフトウェアパッケージを起動すべきではありません。

    例えば、ターゲットソフトウェアのURLハンドラーに脆弱性があり、悪意のあるページがユーザーをリンククリックに誘導してその脆弱性を悪用しようとする可能性があります。

7.4.2.4 ナビゲーションの防止

ナビゲーションプロセスの早い段階で介入し、全体を停止させるシナリオがいくつかあります。これは、セッション履歴のトラバースによって、複数のナビゲーブルが同時にナビゲートしている場合に特に興味深いものです。

ナビゲーブル sourceが、ソーススナップショットパラメータ sourceSnapshotParamsが与えられた場合に、2番目のナビゲーブル targetをサンドボックスによってナビゲートすることが許可されているかどうかを確認するためには、次のステップがtrueを返す必要があります:

  1. もしsourceがtargetである場合は、trueを返します。

  2. もしsourceがtargetの祖先である場合は、trueを返します。

  3. もしtargetがsourceの祖先である場合は:

    1. もしtargetがトップレベルのトラバース可能なものでない場合は、trueを返します。

    2. もしsourceSnapshotParamsの一時的なアクティベーションがあるがtrueであり、sourceSnapshotParamsのサンドボックスフラグのユーザーアクティベーション付きトップレベルナビゲーションブラウジングコンテキストフラグが設定されている場合は、falseを返します。

    3. もしsourceSnapshotParamsの一時的なアクティベーションがあるがfalseであり、sourceSnapshotParamsのサンドボックスフラグのユーザーアクティベーションなしトップレベルナビゲーションブラウジングコンテキストフラグが設定されている場合は、falseを返します。

    4. trueを返します。

  4. もしtargetがトップレベルのトラバース可能なものである場合:

    1. もしsourceがtargetの許可された1つのサンドボックス化されたナビゲーターである場合は、trueを返します。

    2. もしsourceSnapshotParamsのサンドボックスフラグのサンドボックス化されたナビゲーションブラウジングコンテキストフラグが設定されている場合は、falseを返します。

    3. trueを返します。

  5. もしsourceSnapshotParamsのサンドボックスフラグのサンドボックス化されたナビゲーションブラウジングコンテキストフラグが設定されている場合は、falseを返します。

  6. trueを返します。

ドキュメントのアンロードがキャンセルされたかどうかを確認するために、オプションのトラバース可能なナビゲーブル traversable、オプションの整数targetStep、およびオプションのユーザーのナビゲーション関与 userInvolvementForNavigateEventが与えられたリストのナビゲーブル navigablesThatNeedBeforeUnloadについて、次の手順を実行します。これらは、"canceled-by-beforeunload"、"canceled-by-navigate"、または"continue"を返します。

  1. navigablesThatNeedBeforeUnload内の各項目のアクティブなドキュメントをdocumentsToFireBeforeunloadとします。

  2. unloadPromptShownをfalseに設定します。

  3. finalStatusを"continue"に設定します。

  4. もしtraversableが与えられた場合は:

    1. アサート: targetStepおよびuserInvolvementForNavigateEventが与えられた。

    2. traversableおよびtargetStepを指定してターゲット履歴エントリを取得する結果をtargetEntryとします。

    3. もしtargetEntryがtraversableの現在のセッション履歴エントリでなく、targetEntryのドキュメント状態のオリジンがtraversableの現在のセッション履歴エントリのドキュメント状態のオリジンと同じである場合は:

      この場合、ここでtraversableのnavigateイベントを発生させるつもりです。ある状況下ではキャンセルされる可能性があるため、これは他のトラバースnavigateイベントとは別に行う必要があります。

      さらに、beforeunloadイベントをnavigateイベントの前に発生させたいので、traversableに対して(該当する場合)ここでbeforeunloadを発生させる必要があります。これをdocumentsToFireBeforeunloadに対する以下のループの一部として行うのではなく。

      1. eventsFiredをfalseに設定します。

      2. もしnavigablesThatNeedBeforeUnloadがtraversableを含んでいる場合、needsBeforeunloadをtrueに設定し、それ以外の場合はfalseに設定します。

      3. もしneedsBeforeunloadがtrueである場合は、traversableのアクティブドキュメントをdocumentsToFireBeforeunloadから削除します。

      4. traversableのアクティブウィンドウに対して、次の手順を実行するために、グローバルタスクをキューに入れます:

        1. もしneedsBeforeunloadがtrueである場合は:

          1. (unloadPromptShownForThisDocument、unloadPromptCanceledByThisDocument)をtraversableのアクティブドキュメントを与えて、beforeunloadを発生させる手順を実行した結果とします。

          2. もしunloadPromptShownForThisDocumentがtrueである場合は、unloadPromptShownをtrueに設定します。

          3. もしunloadPromptCanceledByThisDocumentがtrueである場合は、finalStatusを"canceled-by-beforeunload"に設定します。

        2. もしfinalStatusが"canceled-by-beforeunload"である場合は、これらの手順を中止します。

        3. traversableのアクティブウィンドウのナビゲーションAPIをnavigationとします。

        4. targetEntryおよびuserInvolvementForNavigateEventを指定して、navigationでトラバースnavigateイベントを発生させる結果をnavigateEventResultとします。

        5. もしnavigateEventResultがfalseである場合は、finalStatusを"canceled-by-navigate"に設定します。

        6. eventsFiredをtrueに設定します。

      5. eventsFiredがtrueになるまで待機します。

      6. もしfinalStatusが"continue"でない場合は、finalStatusを返します。

  5. documentsToFireBeforeunloadのサイズをtotalTasksとします。

  6. completedTasksを0に設定します。

  7. documentsToFireBeforeunloadの各documentについて、documentの関連するグローバルオブジェクトに対して、次の手順を実行するために、グローバルタスクをキューに入れます:

    1. (unloadPromptShownForThisDocument、unloadPromptCanceledByThisDocument)をdocumentおよびunloadPromptShownを与えて、beforeunloadを発生させる手順を実行した結果とします。

    2. もしunloadPromptShownForThisDocumentがtrueである場合は、unloadPromptShownをtrueに設定します。

    3. もしunloadPromptCanceledByThisDocumentがtrueである場合は、finalStatusを"canceled-by-beforeunload"に設定します。

    4. completedTasksを1増加させます。

  8. completedTasksがtotalTasksになるまで待機します。

  9. finalStatusを返します。

beforeunloadを発生させる手順は、Document documentおよびブール値unloadPromptShownを与えて、次の通りです:

  1. unloadPromptCanceledをfalseに設定します。

  2. documentのアンロードカウンターを1増加させます。

  3. documentの関連するエージェントのイベントループの終了ネスティングレベルを1増加させます。

  4. documentの関連するグローバルオブジェクトで、キャンセル可能属性がtrueに初期化されたBeforeUnloadEventを使用して、beforeunloadという名前のイベントを発生させる結果をeventFiringResultとします。

  5. documentの関連するエージェントのイベントループの終了ネスティングレベルを1減少させます。

  6. 次のすべてが真である場合:

    次のことを行います:

    1. unloadPromptShown を true に設定します。

    2. userPromptHandler を、document の 関連するグローバルオブジェクト、「beforeunload」、および「」を指定して WebDriver BiDi ユーザープロンプトを開いた結果とします。

    3. userPromptHandler が「dismiss」の場合、unloadPromptCanceled を true に設定します。

    4. userPromptHandler が「none」の場合：

      1. ドキュメントをアンロードするかどうかをユーザーに確認し、ユーザーの応答を待っている間一時停止します。

        ユーザーに表示されるメッセージはカスタマイズできませんが、代わりにユーザーエージェントによって決定されます。特に、returnValue 属性の実際の値は無視されます。

      2. ユーザーがページナビゲーションを確認しなかった場合、unloadPromptCanceled を true に設定します。

    5. unloadPromptCanceled が false の場合は true、それ以外の場合は false を指定して、document の 関連するグローバルオブジェクト、「beforeunload」を指定して WebDriver BiDi ユーザープロンプトを閉じたを呼び出します。

  7. documentのアンロードカウンターを1減少させます。

  8. (unloadPromptShown、unloadPromptCanceled)を返します。

7.4.2.5 ナビゲーションの中止

各ナビゲーブルには進行中のナビゲーションがあり、これはナビゲーションID、"traversal"、またはnullで、初期値はnullです。これはナビゲーションの中止を追跡し、トラバース中にナビゲーションが行われるのを防ぐために使用されます。

進行中のナビゲーションを設定するためには、ナビゲーブル navigableにnewValueを設定します:

  1. もしnavigableの進行中のナビゲーションがnewValueと等しい場合は、終了します。

  2. ナビゲーションの中止についてナビゲーションAPIに通知をnavigableに対して実行します。

  3. navigableの進行中のナビゲーションをnewValueに設定します。

7.4.3 リロードとトラバース

リロードするためには、オプションのシリアライズされた状態またはnull navigationAPIState（デフォルトはnull）およびオプションのユーザーのナビゲーション関与 userInvolvement（デフォルトは"none"）が与えられたナビゲーブル navigableをリロードします:

  1. もしuserInvolvementが"browser UI"でない場合は:

    1. navigableのアクティブウィンドウのナビゲーションAPIをnavigationとします。

    2. navigableのアクティブなセッション履歴エントリのナビゲーションAPI状態をdestinationNavigationAPIStateとします。

    3. もしnavigationAPIStateがnullでない場合は、destinationNavigationAPIStateをnavigationAPIStateに設定します。

    4. navigationでpush/replace/reload navigateイベントを発生させる結果をcontinueとします。その際、navigationTypeを"reload"、isSameDocumentをfalse、userInvolvementをuserInvolvement、destinationURLをnavigableのアクティブなセッション履歴エントリのURL、およびnavigationAPIStateをdestinationNavigationAPIStateに設定します。

    5. もしcontinueがfalseである場合は、終了します。

  2. navigableのアクティブなセッション履歴エントリのドキュメント状態のリロード保留中をtrueに設定します。

  3. navigableのトラバース可能なナビゲーブルをtraversableとします。

  4. traversableに次のセッション履歴トラバースステップを追加します:

    1. userInvolvement を指定して、traversable にリロード履歴ステップを適用します。

履歴をデルタでトラバースするためには、トラバース可能なナビゲーブル traversable、整数delta、およびオプションのDocument sourceDocumentが与えられた場合に次を行います:

  1. sourceSnapshotParamsおよびinitiatorToCheckをnullとします。

  2. userInvolvementを"ブラウザUI"とします。

  3. もしsourceDocumentが与えられた場合は:

    1. sourceDocumentを与えてソーススナップショットパラメータをスナップショットする結果をsourceSnapshotParamsとします。

    2. sourceDocumentのノードナビゲーブルをinitiatorToCheckとします。

    3. userInvolvementを"none"とします。

  4. traversableに次のセッション履歴トラバースステップを追加します:

    1. traversableに対して使用されたすべての履歴ステップを取得する結果をallStepsとします。

    2. traversableの現在のセッション履歴ステップのインデックスをallSteps内のcurrentStepIndexとします。

    3. currentStepIndexにdeltaを加えたものをtargetStepIndexとします。

    4. もしallSteps[targetStepIndex]が存在しない場合は、これらのステップを中止します。

    5. sourceSnapshotParams、initiatorToCheck、およびuserInvolvementを指定して、traversableにallSteps[targetStepIndex]にトラバース履歴ステップを適用します。

ナビゲートアルゴリズムとは別に、セッション履歴エントリはもう一つのメカニズムでプッシュまたは置換されることがあり、それがURLおよび履歴更新ステップです。これらのステップの最もよく知られている呼び出し元は、history.replaceState()およびhistory.pushState()APIですが、標準のさまざまな他の部分もアクティブな履歴エントリの更新を行う必要があり、それらはこれらのステップを使用してそれを行います。

URLおよび履歴更新ステップでは、Document document、URL newURL、オプションのシリアライズされた状態またはnull serializedData（デフォルトはnull）、およびオプションの履歴処理動作 historyHandling（デフォルトは"replace"）が与えられます:

  1. documentのノードナビゲーブルをnavigableとします。

  2. navigableのアクティブなセッション履歴エントリをactiveEntryとします。

  3. newEntryを新しいセッション履歴エントリとして作成し、以下のプロパティを設定します。

    URL
    newURL
    シリアライズされた状態
    もしserializedDataがnullでない場合はserializedData、そうでない場合はactiveEntryのクラシック履歴API状態
    ドキュメント状態
    activeEntryのドキュメント状態
    スクロール復元モード
    activeEntryのスクロール復元モード
    永続化されたユーザー状態
    activeEntryの永続化されたユーザー状態

  4. もしdocumentの初期about:blankであるがtrueの場合は、historyHandlingを"replace"に設定します。

    これは、pushState()が初期about:blankDocumentで呼び出された場合、replaceState()の呼び出しとして動作することを意味します。

  5. historyHandlingが"replace"である場合はentryToReplaceをactiveEntryに設定し、それ以外の場合はnullとします。

  6. もしhistoryHandlingが"push"である場合は:

    1. documentの履歴オブジェクトのインデックスをインクリメントします。

    2. documentの履歴オブジェクトの長さをそのインデックス + 1に設定します。

    これらは、即時の同期アクセスのための一時的な推測値です。

  7. もしserializedDataがnullでない場合は、履歴オブジェクト状態を復元してdocumentとnewEntryを与えます。

  8. documentのURLをnewURLに設定します。

    これはナビゲーションでも履歴のトラバースでもないため、hashchangeイベントは発生しません。

  9. documentの最新のエントリをnewEntryに設定します。

  10. navigableのアクティブなセッション履歴エントリをnewEntryに設定します。

  11. 同じドキュメント内のナビゲーションのためにナビゲーションAPIエントリを更新しますを、documentの関連するグローバルオブジェクトのナビゲーションAPI、newEntry、およびhistoryHandlingに対して実行します。

  12. navigableのトラバース可能なナビゲーブルをtraversableとします。

  13. traversableに関連する次のセッション履歴同期ナビゲーションステップを追加し、navigableに適用します:

    1. traversable、navigable、newEntry、entryToReplace、historyHandling、および「none」を指定して、同一ドキュメントナビゲーションを確定します。

    2. navigable を指定して、WebDriver BiDi 履歴更新を呼び出します。

フラグメントナビゲーションとURLおよび履歴更新ステップの両方が同期履歴更新を行いますが、フラグメントナビゲーションのみが履歴ステップ適用のためのドキュメントを更新の同期呼び出しを含みます。URLおよび履歴更新ステップは、上記のアルゴリズム内でいくつかの選択された更新を実行し、他の更新を省略します。これは歴史的な不運な事故のようなものであり、一般的にウェブ開発者の悲しみを引き起こす一因となっています。例えば、これにより、popstateイベントはフラグメントナビゲーションでは発生しますが、history.pushState()呼び出しでは発生しません。

7.4.5 セッション履歴エントリの設定

概要で説明されているように、ナビゲーションとトラバースの両方が、セッション履歴エントリを作成し、その後ドキュメントメンバーを設定しようとします。これにより、ナビゲーブル内で表示できるようになります。

これは、既に与えられたレスポンスを使用する、srcdocリソースを使用する、またはフェッチすることが含まれます。このプロセスには、いくつかの失敗モードがあり、それらはナビゲーブルを現在のアクティブなDocumentに留めるか、セッション履歴エントリをエラードキュメントで設定することになります。

セッション履歴エントリ entry について、ナビゲブル navigable、NavigationTimingType navTimingType、ソーススナップショットパラメータ sourceSnapshotParams、ターゲットスナップショットパラメータ targetSnapshotParams、ユーザーナビゲーションの関与 userInvolvement、オプションのナビゲーション IDまたは null の navigationId （デフォルトは null）、オプションのナビゲーションパラメータまたは null の navigationParams （デフォルトは null）、オプションの文字列 cspNavigationType（デフォルトは "other"）、オプションのブール値 allowPOST（デフォルトは false）、およびオプションのアルゴリズムステップ completionSteps（デフォルトは空のアルゴリズム）を指定して、履歴エントリのドキュメントへの入力試行を行うには：

  1. 確認: これは並行して実行されています。

  2. 確認: navigationParamsがnullでない場合、navigationParamsのレスポンスもnullでないこと。

  3. documentResourceをentryのドキュメント状態のリソースとします。

  4. もしnavigationParamsがnullの場合:

    1. documentResource が文字列の場合、navigationParams を、entry、navigable、targetSnapshotParams、userInvolvement、navigationId、および navTimingType を指定してsrcdoc リソースからナビゲーションパラメータを作成した結果に設定します。

    2. それ以外の場合で、次のすべてが true の場合：

      その場合、navigationParams を、entry、navigable、sourceSnapshotParams、targetSnapshotParams、cspNavigationType、userInvolvement、navigationId、および navTimingType を指定してフェッチによってナビゲーションパラメータを作成した結果に設定します。

    3. それ以外の場合で、entry の URL の スキームがフェッチスキームではない場合、navigationParams を、次のプロパティを持つ新しい非フェッチスキームナビゲーションパラメータに設定します。

      id
      navigationId
      navigable
      navigable
      URL
      entry の URL
      ターゲットスナップショットサンドボックスフラグ
      targetSnapshotParams の サンドボックスフラグ
      ソーススナップショットに一時的なアクティベーションがあるか
      sourceSnapshotParams の 一時的なアクティベーションがあるか
      イニシエーターオリジン
      entry の ドキュメント状態の イニシエーターオリジン
      ナビゲーションタイミングタイプ
      navTimingType
      ユーザーの関与
      userInvolvement

  5. グローバルタスクをキューに入れる。navigableのアクティブウィンドウに対し、次のステップを実行するためにナビゲーションとトラバースタスクのソースでキューに入れます。

    1. もしnavigableの進行中のナビゲーションがnavigationIdと等しくなくなった場合、completionStepsを実行して、これらのステップを中止します。

    2. saveExtraDocumentStateをtrueに設定します。

      通常、entryのドキュメント状態のドキュメントを設定する場合、entryのためにその状態の一部を保存したいと思うでしょう。これは、entryへの将来のトラバースが、そのドキュメントが破棄された場合に、新しいDocumentを作成するときにその状態を使用できるようにするためです。

      ただし、特定のケースでは、その状態を保存することが役に立たない場合があります。そのため、そのような場合には、このアルゴリズムの後の部分でsaveExtraDocumentStateをfalseに設定します。

    3. もしnavigationParamsが非フェッチスキームナビゲーションパラメータの場合:

      1. entryのドキュメント状態のドキュメントを非フェッチスキームドキュメントを作成する試行の結果に設定します。

        これにより、例えば外部ソフトウェアへの引き継ぎの場合など、entryのドキュメント状態のドキュメントがnullに設定されることがあります。

      2. saveExtraDocumentStateをfalseに設定します。

    4. それ以外の場合、次のいずれかがtrueである場合:

      次に:

      1. entry の ドキュメント状態の ドキュメントを、navigable、null、navTimingType、および userInvolvement を指定してDOM を持たないインラインコンテンツ用のドキュメントを作成した結果に設定します。インラインコンテンツは、発生したエラーの種類をユーザーに示す必要があります。

      2. ドキュメントを回復不能にする。これにはentryのドキュメント状態のドキュメントと"navigation-failure"を指定します。

      3. saveExtraDocumentStateをfalseに設定します。

      4. もしnavigationParamsがnullでない場合:

        1. 環境の破棄ステップを実行します。これにはnavigationParamsの予約済み環境を指定します。

        2. navigable と、その id が navigationId、status が "canceled"、そして url が navigationParams の response の URL である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーション失敗を呼び出します。

    5. それ以外の場合、もしnavigationParamsのレスポンスのステータスが204でも205でもない場合、entryのドキュメント状態のドキュメントをドキュメントの読み込みの結果に設定します。これにはnavigationParams、sourceSnapshotParams、およびentryのドキュメント状態の起動者のオリジンを指定します。

      これにより、例えば外部ソフトウェアへの引き継ぎの場合など、entryのドキュメント状態のドキュメントがnullに設定されることがあります。

    6. もしentryのドキュメント状態のドキュメントがnullでない場合:

      1. entryのドキュメント状態のドキュメントが設定済みをtrueに設定します。

      2. もしsaveExtraDocumentStateがtrueである場合:

        1. documentをentryのドキュメント状態のドキュメントに設定します。

        2. entryのドキュメント状態のオリジンを、documentのオリジンに設定します。

        3. もしdocumentのURLが履歴にポリシーコンテナの保存を必要とする場合:

          1. 確認: navigationParamsがナビゲーションパラメータであること（すなわち、nullでも非フェッチスキームナビゲーションパラメータでもない）。

          2. entryのドキュメント状態の履歴ポリシーコンテナをnavigationParamsのポリシーコンテナに設定します。

      3. もしentryのドキュメント状態のリクエストリファラが"client"であり、navigationParamsがナビゲーションパラメータである場合（すなわち、nullでも非フェッチスキームナビゲーションパラメータでもない）:

        1. 確認: navigationParamsのリクエストがnullでないこと。

        2. entryのドキュメント状態のリクエストリファラを、navigationParamsのリクエストのリファラに設定します。

    7. completionStepsを実行します。

セッション履歴エントリ entry、ナビゲブル navigable、ターゲットスナップショットパラメータ targetSnapshotParams、ユーザーナビゲーションの関与 userInvolvement、ナビゲーション ID または null の navigationId、および NavigationTimingType navTimingType を指定して、srcdoc リソースからナビゲーションパラメータを作成するには：

  1. documentResource を entry の ドキュメント状態 の リソース に設定します。

  2. response を次のプロパティを持つ新しい レスポンス として設定します:

    URL
    about:srcdoc
    ヘッダーリスト
    « (`Content-Type`, `text/html`) »
    ボディ
    documentResource の UTF-8エンコード、ボディとして

  3. responseOrigin を response の URL、targetSnapshotParams の サンドボックスフラグ、および entry の ドキュメント状態 の オリジン を指定して オリジンを決定する の結果に設定します。

  4. coop を新しい クロスオリジンオープナーポリシー に設定します。

  5. coopEnforcementResult を次のプロパティを持つ新しい クロスオリジンオープナーポリシー執行結果 として設定します:

    url
    response の URL
    オリジン
    responseOrigin
    クロスオリジンオープナーポリシー
    coop

  6. policyContainer を response の URL、entry の ドキュメント状態 の 履歴ポリシーコンテナ、null、navigable の コンテナドキュメント の ポリシーコンテナ、およびnullを指定して ナビゲーションパラメータポリシーコンテナを決定する の結果に設定します。

  7. 次のプロパティを持つ新しい ナビゲーションパラメータ を返します:

    id
    navigationId
    ナビゲーブル
    navigable
    リクエスト
    null
    レスポンス
    response
    フェッチコントローラー
    null
    初期ヒントをコミットする
    null
    COOP 執行結果
    coopEnforcementResult
    予約済み環境
    null
    オリジン
    responseOrigin
    ポリシーコンテナ
    policyContainer
    最終的なサンドボックスフラグセット
    targetSnapshotParams の サンドボックスフラグ
    クロスオリジンオープナーポリシー
    coop
    ナビゲーションタイミングタイプ
    navTimingType
    aboutベースURL
    entry の ドキュメント状態 の aboutベースURL
    ユーザーの関与
    userInvolvement

セッション履歴エントリ entry、ナビゲブル navigable、ソーススナップショットパラメータ sourceSnapshotParams、ターゲットスナップショットパラメータ targetSnapshotParams、文字列 cspNavigationType、ユーザーナビゲーションの関与 userInvolvement、ナビゲーション ID または null の navigationId、および NavigationTimingType navTimingType を指定して、フェッチによってナビゲーションパラメータを作成するには、次のステップを実行します。これらはナビゲーションパラメータ、非フェッチスキームナビゲーションパラメータ、または null を返します。

このアルゴリズムは entry を変更します。

  1. アサート: これは 並行して実行されます。

  2. documentResource を entry の ドキュメント状態 の リソースに設定します。

  3. request を新しい リクエスト に設定します。その設定は次のとおりです：

    URL
    entry の URL
    クライアント
    sourceSnapshotParams の フェッチクライアント
    送信先
    "document" 宛先は、navigableがコンテナを持っている場合に、以下で更新されます。
    資格情報モード
    "include"
    URL資格情報フラグを使用する
    設定済み
    リダイレクトモード
    "manual"
    クライアントIDを置き換える
    navigable の アクティブドキュメント の 関連設定オブジェクト の ID
    モード
    "navigate"
    リファラー
    entry の ドキュメント状態 の リクエストリファラー
    リファラーポリシー
    entry の ドキュメント状態 の リクエストリファラーポリシー
    ポリシーコンテナ
    sourceSnapshotParams の ソースポリシーコンテナ
    ユーザプロンプトのためにトラバース可能
    navigableのトップレベルトラバース可能

  4. もしrequestのクライアントがnullの場合:

    このケースのみが発生 ブラウザUIによって開始されたナビゲーションの場合。

    1. requestのオリジンを新しい不透明なオリジンに設定する。

    2. requestのservice-workers modeを"all"に設定する。

    3. requestのリファラーを"no-referrer"に設定する。

  5. もし documentResource が POST リソース である場合は:

    1. request の メソッド を `POST` に設定します。

    2. request の 本文 を documentResource の リクエスト本文 に設定します。

    3. 設定 `Content-Type` を documentResource の リクエストコンテンツタイプ に、 request の ヘッダーリスト に設定します。

  6. もし entry の ドキュメント状態 の リロード保留 が true なら、request の リロードナビゲーションフラグ を設定します。

  7. その他の場合、もし entry の ドキュメント状態 の 以前にポピュレートされた が true なら、request の 履歴ナビゲーションフラグ を設定します。

  8. もし sourceSnapshotParams の 一時的なアクティベーションがある が true なら、request の ユーザーアクティベーション を true に設定します。

  9. もし navigable の コンテナ が null でないなら：

    1. もし navigable の コンテナ に 閲覧コンテキストスコープの起源 がある場合、request の 起源 をその 閲覧コンテキストスコープの起源 に設定します。

    2. request の 送信先 を navigable の コンテナ の ローカル名 に設定します。

    3. もし sourceSnapshotParams の フェッチクライアント が navigable の コンテナドキュメント の 関連設定オブジェクト なら、request の イニシエータタイプ を navigable の コンテナ の ローカル名 に設定します。

      これは、コンテナによって開始されたナビゲーションのみがリソースタイミングに報告されることを保証します。

  10. response を null に設定します。

  11. responseOrigin を null に設定します。

  12. fetchController を null に設定します。

  13. coopEnforcementResult を新しい クロスオリジンオープナーポリシー実施結果 に設定します。その設定は次のとおりです：

    URL
    navigable の アクティブドキュメント の URL
    起源
    navigable の アクティブドキュメント の 起源
    クロスオリジンオープナーポリシー
    navigable の アクティブドキュメント の オープナーポリシー
    現在のコンテキストはナビゲーションソースである
    もし navigable の アクティブドキュメント の 起源 が 同一オリジン で entry の ドキュメント状態 の イニシエータオリジン なら true、それ以外は false

  14. finalSandboxFlags を空の サンドボックスフラグセット に設定します。

  15. responsePolicyContainer を null に設定します。

  16. responseCOOP を新しい クロスオリジンオープナーポリシー に設定します。

  17. locationURL を null に設定します。

  18. currentURL を request の 現在のURL に設定します。

  19. commitEarlyHints を null に設定します。

  20. 「true」として繰り返し：

    1. もし request の 予約済みクライアント が null でなく、かつ currentURL の 起源 が request の 予約済みクライアント の 作成URL の 起源 と同一でないなら：

      1. 環境破棄手順 を request の 予約済みクライアント のために実行します。

      2. request の 予約済みクライアント を null に設定します。

      3. commitEarlyHints を null に設定します。

        早期ヒントヘッダー からプリロードされたリンクは、同一オリジン のリダイレクト後もプリロードキャッシュに残りますが、リダイレクトがクロスオリジンの場合には破棄されます。

    2. もし request の 予約済みクライアント が null なら：

      1. topLevelCreationURL を currentURL に設定します。

      2. topLevelOrigin を null に設定します。

      3. もし navigable が トップレベルトラバーサブル でないなら：

        1. parentEnvironment を navigable の 親 の アクティブドキュメント の 関連設定オブジェクト に設定します。

        2. topLevelCreationURL を parentEnvironment の トップレベル作成URL に設定します。

        3. topLevelOrigin を parentEnvironment の トップレベル起源 に設定します。

      4. request の 予約済みクライアント を、新しい 環境 に設定します。そのIDは一意な不透明な文字列であり、ターゲット閲覧コンテキストは navigable の アクティブな閲覧コンテキスト、作成URLは currentURL、トップレベル作成URLは topLevelCreationURL、そしてトップレベル起源は topLevelOrigin に設定されます。

        作成された環境の アクティブなサービスワーカー は、リクエストURLがサービスワーカー登録に一致する場合、フェッチの際に設定されます。[SW]

    3. もし この種類のナビゲーションリクエストがコンテンツセキュリティポリシーによってブロックされるべきか？ の結果が「Blocked」なら、response を ネットワークエラー に設定し、ループを終了します。 [CSP]

    4. response を null に設定します。

    5. もし fetchController が null なら、次の設定で フェッチ の結果として fetchController を設定します。プロセス早期ヒントレスポンス を processEarlyHintsResponse として以下で定義し、プロセスレスポンス を以下で定義された processResponse として設定し、並行キューを使用する を true に設定します。

      processEarlyHintsResponse を レスポンス の earlyResponse に対して次のアルゴリズムに設定します：

      1. もし commitEarlyHints が null なら、それを earlyResponse と request の 予約済みクライアント に与えられた 早期ヒントヘッダーを処理する の結果に設定します。

      processResponse を レスポンス の fetchedResponse に対して次のアルゴリズムに設定します：

      1. response を fetchedResponse に設定します。

    6. それ以外の場合、次の手動リダイレクトを処理します fetchController に対して。

      これにより、上記のループを最初に繰り返したときに提供した プロセスレスポンス が呼び出され、その結果として response が設定されます。

      ナビゲーションは mailto: URL などにリダイレクトされる唯一のウェブプラットフォームであるため、リダイレクトを手動で処理します。

    7. response が null であるか、または navigable の 進行中のナビゲーション が navigationId と異なる状態に変化するまで待ちます。

      後者の条件が発生した場合、フェッチを中止します fetchController をして、終了します。

      それ以外の場合は、続行します。

    8. もし request の 本文 が null なら、entry の ドキュメント状態 の リソース を null に設定します。

      フェッチは特定のリダイレクトに対して本文を解除します。

    9. responsePolicyContainer を、response および request の 予約済みクライアント に基づいて フェッチレスポンスからポリシーコンテナを作成する の結果に設定します。

    10. finalSandboxFlags を、targetSnapshotParams の サンドボックスフラグ と responsePolicyContainer の CSPリスト の CSP由来のサンドボックスフラグ の和に設定します。

    11. responseOrigin を response の URL、finalSandboxFlags、および entry の ドキュメント状態 の イニシエータオリジン に基づいて 起源を決定する の結果に設定します。

      もし response がリダイレクトである場合、response の URL はリダイレクト先の URL ではなく、リダイレクトに繋がった URL になります。

    12. もし navigable が トップレベルトラバーサブル なら：

      1. responseCOOP を、response および request の 予約済みクライアント に基づいて クロスオリジンオープナーポリシーを取得する の結果に設定します。

      2. coopEnforcementResult を、navigable の アクティブな閲覧コンテキスト、response の URL、responseOrigin、responseCOOP、coopEnforcementResult および request の リファラー に基づいて クロスオリジンオープナーポリシーを施行する の結果に設定します。

      3. もし finalSandboxFlags が空でなく、responseCOOP の 値 が「unsafe-none」でない場合、response を適切な ネットワークエラー に設定し、ループを終了します。

        これは、クロスオリジンオープナーポリシーを使用してレスポンスにクリーンスレートを提供し、そのレスポンスにナビゲートする結果をサンドボックス化できないため、ネットワークエラーとして扱われます。

    13. もし response が ネットワークエラー でなく、navigable が 子ナビゲーブル であり、navigable の コンテナドキュメント の 起源、navigable の コンテナドキュメント の 関連設定オブジェクト、request の 送信先、および response に基づく クロスオリジンリソースポリシーチェック の結果がブロックされた場合、response を ネットワークエラー に設定し、ループを終了します。

      ここでは、navigable 自身ではなく、親ナビゲーブルに対して クロスオリジンリソースポリシーチェック を実行しています。これは、埋め込まれたコンテンツの同一オリジン性がナビゲーションソースではなく親コンテキストに対して重要であるためです。

    14. locationURL を response の ロケーションURL の currentURL の フラグメント に基づいて設定します。

    15. もし locationURL が失敗または null なら、ループを終了します。

    16. 断言：locationURL が URL であること。

    17. entry の クラシック履歴API状態 を StructuredSerializeForStorage(null) に設定します。

    18. oldDocState を entry の ドキュメント状態 に設定します。

    19. entry の ドキュメント状態 を新しい ドキュメント状態 に設定し、その設定は次のとおりです：

      履歴ポリシーコンテナ
      もし非nullならoldDocState の 履歴ポリシーコンテナ の クローン、それ以外の場合はnull
      リファラー
      oldDocState の リファラー
      リファラーポリシー
      oldDocState の リファラーポリシー
      イニシエータオリジン
      oldDocState の イニシエータオリジン
      起源
      oldDocState の 起源
      aboutベースURL
      oldDocState の aboutベースURL
      リソース
      oldDocState の リソース
      一度でもポピュレートされた
      oldDocState の 一度でもポピュレートされた
      ナビゲーブルターゲット名
      oldDocState の ナビゲーブルターゲット名

      ナビゲーションの場合、oldDocState は、ナビゲートアルゴリズムの早い段階 で作成されたもので、entry のみが参照します。したがって、ナビゲーションの場合、これは実際には entry の ドキュメント状態 の更新に過ぎません。トラバーサルの場合、隣接する セッション履歴エントリ も oldDocState を参照している可能性があり、この場合、entry の ドキュメント状態 を更新した後も引き続き参照し続けます。

      トラバーサルの場合にのみ、oldDocState の 履歴ポリシーコンテナ は非nullであり、ナビゲーション中に履歴にポリシーコンテナを保存する必要があるURLにナビゲートした後でポピュレートされます。

      セットアップは次の ジェイク図 によって与えられます：

      0 1 2 3
      top /a /a#foo /a#bar /b

      また、ステップ0、1、2にあるエントリが共有する ドキュメント状態 の ドキュメント が nullであることを仮定します。すなわち、bfcache が適用されていません。

      次に、ステップ2に戻ってトラバースするシナリオを考えますが、今回は/a をフェッチする際、サーバーが /c を指す `Location` ヘッダーで応答します。つまり、locationURL が /c を指しており、このステップに到達しました。ループから 抜ける ことなく。

      この場合、ステップ2を占める ドキュメント状態 を置き換えますが、ステップ0および1を占めるエントリのドキュメント状態は置き換えません。結果の ジェイク図 は次のようになります：

      0 1 2 3
      top /a /a#foo /c#bar /b

      この置換は、/c 自体が /a を指す `Location` ヘッダーを持っていた場合など、元の URL にリダイレクトチェーンで戻る場合でも実行されます。このような場合、結果は次のようになります：

      0 1 2 3
      top /a /a#foo /a#bar /b

    20. もし locationURL の スキーム が HTTP(S) スキーム でないなら：

      1. entry の ドキュメント状態 の リソース を null に設定します。

      2. ループを終了します。

    21. currentURL を locationURL に設定します。

    22. entry の URL を currentURL に設定します。

    このループが終了するとき、次のシナリオのいずれかになります：

    • locationURL が失敗している、解析不能な `Location` ヘッダーのため。

    • locationURL が null である、 response が ネットワークエラー であるか、Location ヘッダーのない HTTP(S) レスポンスが正常にフェッチされたため。

    • locationURL が非 HTTP(S) URL である。

  21. もし locationURL が URL で、その スキーム が フェッチスキーム でないなら、新しい 非フェッチスキームナビゲーションパラメータ を次の設定で返します：

    id
    navigationId
    ナビゲーブル
    navigable
    URL
    locationURL
    ターゲットスナップショットサンドボックスフラグ
    targetSnapshotParams の サンドボックスフラグ
    ソーススナップショットが一時的なアクティベーションを持っている
    sourceSnapshotParams の 一時的なアクティベーションがある
    イニシエータオリジン
    responseOrigin
    ナビゲーションタイミングタイプ
    navTimingType
    ユーザーの関与
    userInvolvement

    この時点で、request の 現在の URL は、非 フェッチスキーム にリダイレクトされる前の、フェッチスキームを持つリダイレクトチェーンの最後の URL です。これが、非 フェッチスキーム の URL へのナビゲーションのために使用されるイニシエータオリジンになります。

  22. 次のいずれかが真の場合：

    その場合、null を返します。

    非 フェッチスキーム URL へのリダイレクトは許可されますが、非 HTTP(S) 以外の フェッチスキーム を持つ URL へのリダイレクトは、ネットワークエラーとして扱われます。

  23. 断言：locationURL が null で、 response が ネットワークエラー ではありません。

  24. resultPolicyContainer を、response の URL、entry の ドキュメント状態 の 履歴ポリシーコンテナ、sourceSnapshotParams の ソースポリシーコンテナ、null、および responsePolicyContainer を与えた結果として設定します。

  25. もしnavigableのコンテナがiframeであり、かつresponseのタイミング許可フラグが設定されている場合、navigableのコンテナの保留中のリソースタイミング開始時間をnullに設定します。

    もし iframe がリソースタイミングに報告することが許可されている場合、通常の報告が行われるため、フォールバックステップを実行する必要はありません。

  26. 新しい ナビゲーションパラメータ を次の設定で返します：

    id
    navigationId
    ナビゲーブル
    navigable
    リクエスト
    request
    レスポンス
    response
    フェッチコントローラー
    fetchController
    初期ヒントのコミット
    commitEarlyHints
    クロスオリジンオープナーポリシー
    responseCOOP
    予約された環境
    request の 予約されたクライアント
    起源
    responseOrigin
    ポリシーコンテナ
    resultPolicyContainer
    最終的なサンドボックスフラグセット
    finalSandboxFlags
    COOP施行結果
    coopEnforcementResult
    ナビゲーションタイミングタイプ
    navTimingType
    about ベース URL
    entry の ドキュメント状態 の about ベース URL
    ユーザーの関与
    userInvolvement

要素には、ブラウジングコンテキストスコープのオリジンがあり、その要素の Documentの ノードナビゲーブルが トップレベルトラバーサブルである場合、またはその要素の Documentの 祖先ナビゲーブルがすべて、 アクティブドキュメントを持ち、それらの オリジンが、 要素の ノードドキュメントの オリジンと 同一である場合です。要素が ブラウジングコンテキストスコープのオリジン を持っている場合、その値は要素の オリジン です。

この定義は壊れており、意図された内容を確認するために調査が必要です: issue #4703を参照してください。

ドキュメントの読み込みを行うには、 ナビゲーションパラメータ navigationParams、 ソーススナップショットパラメータ sourceSnapshotParams、 および オリジン initiatorOriginを指定して、次の手順を実行します。これにより、 Documentまたはnullが返されます。

  1. typeを、 navigationParamsの レスポンス の 計算されたタイプとします。

  2. ユーザーエージェントが指定されたtypeのリソースを処理するために、ナビゲーブル でコンテンツをレンダリングする以外のメカニズムを使用するように設定されている場合、このステップをスキップします。そうでない場合、typeが次のいずれかのタイプである場合:

    HTML MIMEタイプ
    HTMLドキュメントを読み込む結果を返します。 navigationParamsが指定されている場合。
    XML MIMEタイプであり、明示的にサポートされているXML MIMEタイプではない
    XMLドキュメントを読み込む結果を返します。 navigationParamsおよびtypeが指定されている場合。
    JavaScript MIMEタイプ
    JSON MIMEタイプであり、明示的にサポートされているJSON MIMEタイプではない
    "text/css"
    "text/plain"
    "text/vtt"
    テキストドキュメントを読み込む結果を返します。 navigationParamsおよびtypeが指定されている場合。
    "multipart/x-mixed-replace"
    multipart/x-mixed-replaceドキュメントを読み込む結果を返します。 navigationParams、sourceSnapshotParams、およびinitiatorOriginが指定されている場合。
    サポートされている画像、ビデオ、またはオーディオの種類
    メディアドキュメントを読み込む結果を返します。 navigationParamsおよびtypeが指定されている場合。
    "application/pdf"
    "text/pdf"
    ユーザーエージェントの PDF ビューアがサポートされている場合、navigationParams の navigable、navigationParams の id、navigationParams の ナビゲーションタイミングタイプ、およびnavigationParams の ユーザーの関与を指定して、DOM を持たないインラインコンテンツ用のドキュメントを作成した結果を返します。

    それ以外の場合は先に進みます。

    明示的にサポートされているXML MIMEタイプとは、 ユーザーエージェントがコンテンツをレンダリングするために外部アプリケーションを使用するように設定されているか、専用の処理ルールを持つ XML MIMEタイプ のことを指します。たとえば、Atomフィードビューアが組み込まれているWebブラウザは、 application/atom+xml MIMEタイプを明示的にサポートしていると言えます。

    明示的にサポートされているJSON MIMEタイプとは、 ユーザーエージェントがコンテンツをレンダリングするために外部アプリケーションを使用するように設定されているか、専用の処理ルールを持つ JSON MIMEタイプ のことを指します。

    両方の場合で、外部アプリケーションまたはユーザーエージェントは、navigationParamsのナビゲーブルに直接インラインでコンテンツを表示するか、外部ソフトウェアに引き渡すことになります。どちらも以下のステップで行われます。

  3. それ以外の場合、ドキュメントの type は、リソースが navigationParams の navigable に影響を与えないようなものです（例えば、リソースが外部アプリケーションに渡されるため、またはダウンロードとして処理される未知のタイプであるためなど）。navigationParams の レスポンス、navigationParams の navigable、navigationParams の 最終サンドボックスフラグセット、sourceSnapshotParams の 一時的なアクティベーションがあるか、および initiatorOrigin を指定して、外部ソフトウェアに引き渡します。

  4. nullを返します。

7.4.6 履歴ステップの適用

ナビゲーションとトラバーサルの両方において、セッション履歴で進むべき場所が決まったら、その概念をトラバーサブルナビゲーブルおよび関連するドキュメントに適用する作業が主となります。ナビゲーションの場合、この作業は通常プロセスの終わりに行われ、トラバーサルの場合はその始まりとなります。

7.4.6.1 トラバーサブルの更新

トラバーサブルが正しいセッション履歴ステップに到達することを保証するのは特に複雑です。これは、トラバーサブルの複数のナビゲーブルの子孫を調整し、並行してポピュレートし、その後結果が全員に同じように見えることを同期する必要があるためです。このプロセスは、同一ドキュメントの同期ナビゲーションとクロスドキュメントのナビゲーションが混在し、ウェブページが特定のタイミングに対して一定の期待を持つようになったことによってさらに複雑になります。

ナビゲーブルの連続状態を変更することは、履歴ステップの適用アルゴリズム中に情報を保持するために使用され、アルゴリズムの一部が他の部分が終了した後にのみ続行できるようにします。これは以下の要素を持つ構造体です:

表示されたドキュメント
ドキュメント
ターゲットエントリ
セッション履歴エントリ
ナビゲーブル
ナビゲーブル
更新のみ
ブール値

すべてのトラバーサブルナビゲーブルの更新は、同じ履歴ステップの適用アルゴリズムに終わりますが、各エントリポイントにはいくつかのカスタマイズが含まれます:

トラバーサブルナビゲーブルのtraversableが与えられたときのナビゲーブルの作成/破棄のための更新:

  1. step を traversable の 現在のセッション履歴ステップとします。

  2. false、null、null、「none」、および null を指定して、traversable に履歴ステップを適用した結果を返します。

非負整数 step をトラバーサブルナビゲブル traversable に、履歴処理の動作 historyHandling とユーザーナビゲーションの関与 userInvolvement を指定して、プッシュ/置換履歴ステップを適用するには：

  1. false、null、null、userInvolvement、および historyHandling を指定して、traversable に履歴ステップを適用した結果を返します。

プッシュ/置換履歴ステップを適用するは、ソーススナップショットパラメータまたはイニシエーターナビゲブルを履歴ステップを適用するに渡すことはありません。これは、これらのチェックがナビゲーションアルゴリズムの早い段階で行われるためです。

ユーザーナビゲーションの関与 userInvolvement を指定して、トラバーサブルナビゲブル traversable にリロード履歴ステップを適用するには：

  1. step を traversable の 現在のセッション履歴ステップとします。

  2. true、null、null、userInvolvement、および「reload」を指定して、traversable に履歴ステップを適用した結果を返します。

リロード履歴ステップを適用するは、ソーススナップショットパラメータまたはイニシエーターナビゲブルを履歴ステップを適用するに渡すことはありません。これは、parent.location.reload() のような場合でも、リロードは常にナビゲブル自体によって行われたかのように扱われるためです。

非負整数 step をトラバーサブルナビゲブル traversable に、ソーススナップショットパラメータ sourceSnapshotParams、ナビゲブル initiatorToCheck、およびユーザーナビゲーションの関与 userInvolvement を指定して、トラバース履歴ステップを適用するには：

  1. true、sourceSnapshotParams、initiatorToCheck、userInvolvement、および「traverse」を指定して、traversable に履歴ステップを適用した結果を返します。

では、アルゴリズム自体に進みましょう。

非負整数 step をトラバーサブルナビゲブル traversable に、ブール値 checkForCancelation、ソーススナップショットパラメータまたは null の sourceSnapshotParams、ナビゲブルまたは null の initiatorToCheck、ユーザーナビゲーションの関与 userInvolvement、および NavigationType または null の navigationType を指定して、履歴ステップを適用するには、次のステップを実行します。 これらは「initiator-disallowed」、「canceled-by-beforeunload」、「canceled-by-navigate」、または「applied」を返します。

  1. アサート：これはtraversableのセッション履歴トラバーサルキュー内で実行されています。

  2. targetStepを使用されるステップを取得する結果としてtraversableとstepに与える。

  3. もしinitiatorToCheckがnullでない場合、次のステップを実行する:

    1. アサート: sourceSnapshotParamsがnullでないこと。

    2. 各navigableについて現在のセッション履歴エントリが変更またはリロードされるすべてのナビゲーブルを取得するために:initiatorToCheckがサンドボックスによってナビゲートが許可されているかどうかをnavigableに対してsourceSnapshotParamsを与えて確認し、許可されていない場合、"initiator-disallowed"を返します。

  4. navigablesCrossingDocumentsをクロスドキュメントトラバースを経験する可能性のあるすべてのナビゲーブルを取得する結果としてtraversableとtargetStepに与える。

  5. checkForCancelation が true であり、かつ navigablesCrossingDocuments、traversable、targetStep、および userInvolvement を指定してアンロードがキャンセルされたかどうかを確認した結果が "continue" でない場合、その結果を返します。

  6. changingNavigablesを現在のセッション履歴エントリが変更またはリロードされるすべてのナビゲーブルを取得する結果としてtraversableとtargetStepに与える。

  7. nonchangingNavigablesThatStillNeedUpdatesを履歴オブジェクトの長さ/インデックス更新のみが必要なすべてのナビゲーブルを取得する結果としてtraversableとtargetStepに与える。

  8. 各navigableについて、changingNavigablesを:

    1. targetEntryをターゲット履歴エントリを取得する結果としてnavigableとtargetStepに与える。

    2. navigableの現在のセッション履歴エントリをtargetEntryに設定する。

    3. 進行中のナビゲーションを設定するをnavigableに対して"トラバース"に設定する。

  9. totalChangeJobsをサイズのchangingNavigablesに設定する。

  10. completedChangeJobsを0に設定する。

  11. changingNavigableContinuationsを空のキューとしてchangingNavigableContinuationsのナビゲーブルの連続状態を変更するに設定する。

    このキューはchangingNavigablesの操作を2つの部分に分割するために使用されます。特にchangingNavigableContinuationsは2番目の部分のデータを保持します。

  12. 各navigableについて、changingNavigablesを:グローバルタスクをキューに追加し、navigableのアクティブウィンドウのナビゲーションとトラバーサルのタスクソースで実行するステップとして設定する:

    この一連のステップは、ドキュメントがアンロードされる前に同期ナビゲーションを処理できるように2つの部分に分割されます。状態はchangingNavigableContinuationsに保存され、2番目の部分で使用されます。

    1. displayedEntryをnavigableのアクティブなセッション履歴エントリに設定する。

    2. targetEntryをnavigableの現在のセッション履歴エントリに設定する。

    3. changingNavigableContinuationをナビゲーブルの連続状態を変更するとして次の要素を持つように設定する:

      表示されたドキュメント
      displayedEntryのドキュメント
      ターゲットエントリ
      targetEntry
      ナビゲーブル
      navigable
      更新のみ
      false

    4. もしdisplayedEntryがtargetEntryであり、targetEntryのドキュメント状態のリロード保留中がfalseである場合:

      1. changingNavigableContinuationの更新のみをtrueに設定する。

      2. キューに追加するchangingNavigableContinuationをchangingNavigableContinuationsに。

      3. これらのステップを中止する。

      このケースは、同期ナビゲーションがすでにアクティブなセッション履歴エントリを更新した結果として発生します。

    5. navigationTypeに応じてスイッチ:

      "リロード"

      アサート: targetEntryのドキュメント状態のリロード保留中がtrueであること。

      "トラバース"

      アサート: targetEntryのドキュメント状態のポピュレートされたことがあるがtrueであること。

      "置換"

      アサート: targetEntryのステップがdisplayedEntryのステップと同じであり、targetEntryのドキュメント状態のポピュレートされたことがないがfalseであること。

      "プッシュ"

      アサート: targetEntryのステップがdisplayedEntryのステップ + 1であり、targetEntryのドキュメント状態のポピュレートされたことがないがfalseであること。

    6. oldOriginをtargetEntryのドキュメント状態のオリジンに設定する。

    7. 次のすべてがtrueである場合:

      次のステップを実行:

      1. navigation を navigable の アクティブウィンドウの ナビゲーション API とします。

      2. targetEntry と userInvolvement を指定して、navigation でトラバース navigate イベントを発行します。

    8. もしtargetEntryのドキュメントがnullである場合、またはtargetEntryのドキュメント状態のリロード保留中がtrueである場合、次のステップを実行:

      1. navTimingTypeを次のように設定する:戻る/進むがtargetEntryのドキュメントがnullの場合、それ以外の場合は"リロード"。

      2. targetSnapshotParamsをターゲットスナップショットパラメータのスナップショット結果としてnavigableに与える。

      3. potentiallyTargetSpecificSourceSnapshotParamsをsourceSnapshotParamsに設定する。

      4. もしpotentiallyTargetSpecificSourceSnapshotParamsがnullの場合、それをソーススナップショットパラメータのスナップショット結果としてnavigableのアクティブドキュメントに設定する。

        このケースでは、トラバース/リロードの明確なソースはありません。navigableが自分自身をナビゲートしたかのように扱いますが、targetEntryの元のイニシエーターの一部のプロパティはtargetEntryのドキュメント状態に保存され、イニシエーターのオリジンやリファラーなど、ナビゲーションに適切な影響を与えます。

      5. targetEntryのドキュメント状態のリロード保留中をfalseに設定する。

      6. allowPOSTをtargetEntryのドキュメント状態のリロード保留中に設定する。

      7. 並行して、targetEntry について、navigable、potentiallyTargetSpecificSourceSnapshotParams、targetSnapshotParams、userInvolvement を指定し、allowPOST を allowPOST に設定し、completionSteps を、navigable の アクティブウィンドウを指定してナビゲーションとトラバーサルのタスクソースでグローバルタスクをキューに入れて afterDocumentPopulated を実行するように設定して、履歴エントリのドキュメントへの入力試行を行います。

      それ以外の場合、即座にafterDocumentPopulatedを実行する。

      どちらの場合でも、afterDocumentPopulatedを以下のステップとして設定する:

      1. もしtargetEntryのドキュメントがnullである場合、changingNavigableContinuationの更新のみをtrueに設定する。

        これは、ドキュメントをポピュレートしようとしたが、例えばサーバーが204を返すなどして、それができなかったことを意味します。

        このようなナビゲーションやトラバーサルの失敗は、ナビゲーションAPIに通知されません（例えば、任意のナビゲーションAPIメソッドトラッカーのプロミスや、navigateerrorイベントを通じて）。これを行うと、クロスオリジンの場合に他のオリジンからのレスポンスのタイミングに関する情報が漏洩する可能性があり、クロスオリジンと同一オリジンの場合で異なる結果を提供することは混乱を招くと考えられました。

        しかし、この機会を利用して、navigation.transition.finishedプロミスのハンドラーをクリアすることができます。これらはこの時点で決して実行されないことが保証されています。また、ナビゲーションAPIのいずれかがこれらのナビゲーションを開始した場合、プロミスが決して解決されず、イベントが発生しない理由をウェブ開発者に明確にするために、コンソールに警告を報告することを検討するかもしれません。

      2. もしtargetEntryのドキュメントのオリジンがoldOriginと異なる場合、targetEntryのクラシック履歴API状態をStructuredSerializeForStorage(null)に設定します。

        これは、リダイレクトが発生しなかった場合に、targetEntryの以前のロードとオリジンが変更されたときに履歴状態をクリアします。これはCSPサンドボックスヘッダーの変更によって発生することがあります。

      3. 次のすべてがtrueである場合:

        その場合、targetEntryのドキュメント状態のナビゲーブルターゲット名を空文字列に設定する。

      4. キューに追加するchangingNavigableContinuationをchangingNavigableContinuationsに。

        このジョブの残りの部分は、このアルゴリズムの後の段階で実行されます。

  13. navigablesThatMustWaitBeforeHandlingSyncNavigationを空のセットとして設定する。

  14. completedChangeJobsがtotalChangeJobsと等しくなるまで:

    1. もしtraversableのネストされた履歴ステップの適用を実行中がfalseである場合:

      1. traversableのセッション履歴トラバーサルキューのアルゴリズムセットが一つ以上の同期ナビゲーションステップを含んでおり、ターゲットナビゲーブルがnavigablesThatMustWaitBeforeHandlingSyncNavigationに含まれていない場合:

        1. stepsをtraversableのセッション履歴トラバーサルキューのアルゴリズムセット内の最初の項目として設定する。

        2. 削除するstepsをtraversableのセッション履歴トラバーサルキューのアルゴリズムセットから。

        3. traversableのネストされた履歴ステップの適用を実行中をtrueに設定する。

        4. stepsを実行する。

        5. traversableのネストされた履歴ステップの適用を実行中をfalseに設定する。

        この時点で、同期ナビゲーションがこのトラバースの前に発生する意図がある場合、セッション履歴に適切に追加されるために、このキューを飛び越えます。詳細はこちらをご覧ください。

    2. changingNavigableContinuationをデキューする結果としてchangingNavigableContinuationsから設定する。

    3. もしchangingNavigableContinuationが何もない場合、続行する。

    4. displayedDocumentをchangingNavigableContinuationの表示されたドキュメントとして設定する。

    5. targetEntryをchangingNavigableContinuationのターゲットエントリとして設定する。

    6. navigableをchangingNavigableContinuationのナビゲーブルとして設定する。

    7. (scriptHistoryLength, scriptHistoryIndex)を履歴オブジェクトの長さとインデックスを取得する結果としてtraversableとtargetStepに与える。

      これらの値は最後に計算されたときから変わっているかもしれません。

    8. 追加するnavigableをnavigablesThatMustWaitBeforeHandlingSyncNavigationに。

      ナビゲーブルがトラバースのこの時点に到達したら、さらにキューに追加された同期ナビゲーションステップは、通常このトラバースの後に発生する意図があるため、キューを飛び越えなくなります。詳細はこちらをご覧ください。

    9. entriesForNavigationAPIをナビゲーションAPI用のセッション履歴エントリを取得する結果としてnavigableとtargetStepに与える。

    10. もしchangingNavigableContinuationの更新のみがtrueである場合、またはtargetEntryのドキュメントがdisplayedDocumentである場合:

      これは同一ドキュメントのナビゲーションです: アンロードせずに進行します。

      1. 進行中のナビゲーションを設定するをnavigableに対してnullに設定する。

        これにより、新しいナビゲーションがnavigableで開始できるようになり、トラバース中にブロックされていたものが解除されます。

      2. グローバルタスクをキューに追加し、navigableのアクティブウィンドウに対してナビゲーションとトラバーサルのタスクソースでafterPotentialUnloadsを実行する。

    11. それ以外の場合:

      1. アサート：navigationType は null ではありません。

      2. userInvolvement、targetEntry、navigationType、および afterPotentialUnloads を指定して、displayedDocument を非アクティブ化します。

    12. どちらの場合でも、afterPotentialUnloadsを以下のステップとして設定する:

      1. previousEntry を navigable の アクティブなセッション履歴エントリとします。

      2. もしchangingNavigableContinuationの更新のみがfalseである場合、履歴エントリをアクティブ化するをtargetEntryのnavigableに対して実行する。

      3. updateDocumentをtargetEntryのドキュメントに対して、targetEntry、changingNavigableContinuationの更新のみ、scriptHistoryLength、scriptHistoryIndex、navigationType、entriesForNavigationAPI、およびpreviousEntryを与えて実行するアルゴリズムステップとして設定する。

      4. もしtargetEntryのドキュメントがdisplayedDocumentと等しい場合、updateDocumentを実行する。

      5. それ以外の場合、グローバルタスクをキューに追加し、targetEntryのドキュメントの関連するグローバルオブジェクトに対してupdateDocumentを実行する。

      6. completedChangeJobsをインクリメントする。

  15. totalNonchangingJobsをサイズのnonchangingNavigablesThatStillNeedUpdatesに設定する。

    このステップ以降は、同期ナビゲーションの処理など、履歴の長さとインデックスを更新するタスクをポストするため、すべての前の操作が完了するのを待つように意図されています。

  16. completedNonchangingJobsを0に設定する。

  17. (scriptHistoryLength, scriptHistoryIndex)を履歴オブジェクトの長さとインデックスを取得する結果としてtraversableとtargetStepに与える。

  18. 各navigableについてnonchangingNavigablesThatStillNeedUpdatesを:グローバルタスクをキューに追加し、navigableのアクティブウィンドウのナビゲーションとトラバーサルのタスクソースに設定し、次のステップを実行する:

    1. documentをnavigableのアクティブドキュメントに設定する。

    2. documentの履歴オブジェクトのインデックスをscriptHistoryIndexに設定する。

    3. documentの履歴オブジェクトの長さをscriptHistoryLengthに設定する。

    4. completedNonchangingJobsをインクリメントする。

  19. completedNonchangingJobsがtotalNonchangingJobsと等しくなるのを待つ。

  20. traversableの現在のセッション履歴ステップをtargetStepに設定する。

  21. "適用済み"を返す。

次のdisplayedDocument、ユーザーのナビゲーション関与 userNavigationInvolvement、セッション履歴エントリ targetEntry、NavigationType navigationType および afterPotentialUnloads という引数を受け取らないアルゴリズムで、 ドキュメントを他のドキュメントへのナビゲーションのために非アクティブにする方法は次の通りです。

  1. navigable を displayedDocument の ノードナビゲーブル とします。

  2. potentiallyTriggerViewTransition を false とします。

  3. isBrowserUINavigation は userNavigationInvolvement が「ブラウザ UI」であれば true、それ以外は false とします。

  4. potentiallyTriggerViewTransition を次の引数を持つナビゲーションが他のドキュメントのビュー遷移をトリガーできるかの結果に設定します。 displayedDocument、targetEntry のドキュメント、navigationType、 およびisBrowserUINavigation。

  5. もしpotentiallyTriggerViewTransition が false であれば：

    1. firePageSwapBeforeUnload という手順を次のようにします：

      1. pageswap イベントを displayedDocument、targetEntry、 navigationType、 および null に対して発火します。

    2. 進行中のナビゲーションを null に設定します。

      これにより、navigable の新しいナビゲーションが開始されます。

    3. ドキュメントとその子孫をアンロードするには、 displayedDocument、targetEntry のドキュメント、 afterPotentialUnloads、 およびfirePageSwapBeforeUnloadを与えてください。

  6. そうでない場合は、グローバルタスクをキューに追加します navigable のアクティブウィンドウで次の手順を実行します：

    1. proceedWithNavigationAfterViewTransitionCapture という手順を次のようにします：

      1. セッション履歴のトラバーサル手順を追加します navigable の トラバーサブルナビゲーブル に対して次のようにします：

        1. 進行中のナビゲーションを null に設定します。

          これにより、navigable の新しいナビゲーションが開始されます。

        2. ドキュメントとその子孫をアンロードするには、 displayedDocument、targetEntry のドキュメント、 およびafterPotentialUnloadsを与えてください。

    2. ドキュメント間ビュー遷移のセットアップの結果をviewTransitionに設定します。 displayedDocument、targetEntry のドキュメント、 navigationType、 およびproceedWithNavigationAfterViewTransitionCaptureを与えてください。

    3. pageswap イベントを displayedDocument、targetEntry、navigationType、viewTransitionに対して発火します。

    4. もしviewTransitionが null の場合は、proceedWithNavigationAfterViewTransitionCaptureを実行します。

      ビュー遷移が開始された場合、ビュー遷移アルゴリズムはproceedWithNavigationAfterViewTransitionCaptureを呼び出す責任を負います。

pageswap イベントをdisplayedDocument、 セッション履歴エントリ targetEntry、NavigationType navigationType、およびViewTransition-または-null viewTransitionに基づいて発火するには:

  1. アサート: これはdisplayedDocumentのイベントループにキューされたタスクの一部として実行されています。

  2. navigationをdisplayedDocumentの関連グローバルオブジェクトのナビゲーションAPIに設定します。

  3. activationをnullに設定します。

  4. 以下のすべてが真であれば:

    次に:

    1. navigationTypeに基づいてdestinationEntryを決定します:

      "リロード"

      navigationの現在のエントリ

      "トラバース"

      navigationのエントリリストにあるNavigationHistoryEntryのtargetEntryのセッション履歴エントリ

      "プッシュ"
      "置換"

      displayedDocumentの関連するレルムに新しく作成されたNavigationHistoryEntryとし、そのセッション履歴エントリをtargetEntryに設定します。

    2. displayedDocumentの関連するレルムで作成されたNavigationActivationの新しいインスタンスにactivationを設定し、次のプロパティを持たせます。

      古いエントリ
      navigationの現在のエントリ
      新しいエントリ
      destinationEntry
      ナビゲーションタイプ
      navigationType

    これは、ナビゲーション中のクロスオリジンリダイレクトが、古いドキュメントのPageSwapEventでのactivationがnullになることを意味します。ただし、新しいドキュメントがbfcacheから復元されていない限り。

  5. イベントを発火させます。displayedDocumentの関連グローバルオブジェクトでpageswapという名前で、PageSwapEventを使用し、そのactivationをactivationに、viewTransitionをviewTransitionに設定します。

セッション履歴エントリのentryをナビゲーブルでnavigableとしてアクティブ化するには:

  1. 保存された状態を保存し、navigableのアクティブなセッション履歴エントリに追加します。

  2. newDocumentをentryのドキュメントに設定します。

  3. アサート: newDocumentの初期about:blankはfalseであること、すなわち、ドキュメントをナビゲートするときに常に置換されるため、初期about:blankに戻ることはありません。

  4. navigableのアクティブなセッション履歴エントリをentryに設定します。

  5. アクティブ化しますnewDocument。

traversableに対して非負整数のstepを指定してused stepを取得するには、次の手順を実行します。これらは非負整数を返します。

  1. traversable内のすべての使用された履歴ステップを取得した結果をstepsに設定します。

  2. step以下で最も大きなアイテムをstepsから返します。

    これは、ナビゲーブルの削除によりセッション履歴エントリがstepを持たない場合に対応します。

トラバーサブルナビゲーブルのtraversableと非負整数のstepを指定して、履歴オブジェクトの長さとインデックスを取得するには、次の手順を実行します。これらは、2つの非負整数からなるタプルを返します。

  1. traversable内のすべての使用された履歴ステップを取得した結果をstepsに設定します。

  2. stepsのサイズをscriptHistoryLengthに設定します。

  3. アサート: stepsにstepが含まれていることを確認します。

    これは、stepが使用されたステップを取得によって調整されたことが前提です。

  4. stepのstepsにおけるインデックスをscriptHistoryIndexに設定します。

  5. (scriptHistoryLength, scriptHistoryIndex)を返します。

トラバーサブルナビゲーブルのtraversableと非負整数のtargetStepを指定して、現在のセッション履歴エントリが変更またはリロードされるすべてのナビゲーブルを取得するには、次の手順を実行します。これらは、リストのナビゲーブルを返します。

  1. resultsを空のリストに設定します。

  2. navigablesToCheckを« traversable »に設定します。

    このリストは以下のループで拡張されます。

  3. それぞれのnavigableに対して、navigablesToCheckをチェックします。

    1. ターゲット履歴エントリを取得した結果をnavigableとtargetStepに基づいてtargetEntryに設定します。

    2. もしtargetEntryがnavigableの現在のセッション履歴エントリではなく、targetEntryのドキュメント状態のリロード保留が真である場合、navigableをresultsに追加します。

    3. もしtargetEntryのドキュメントがnavigableのドキュメントであり、targetEntryのドキュメント状態のリロード保留が偽である場合、navigableの子ナビゲーブルをnavigablesToCheckに拡張します。

      子ナビゲーブルをnavigablesToCheckに追加することで、これらのナビゲーブルもこのループによってチェックされます。子ナビゲーブルは、navigableのアクティブドキュメントがこのトラバーサルの一部として変更されない場合にのみチェックされます。

  4. resultsを返します。

トラバーサブルナビゲーブルのtraversableと非負整数のtargetStepを指定して、履歴オブジェクトの長さ/インデックスの更新のみが必要なすべてのナビゲーブルを取得するには、次の手順を実行します。これらは、リストのナビゲーブルを返します。

他のナビゲーブルは、このトラバーサルによって影響を受けない場合があります。たとえば、レスポンスが204の場合、現在アクティブなドキュメントはそのままになります。さらに、204の後に「戻る」と、現在のセッション履歴エントリは変更されますが、アクティブなセッション履歴エントリはすでに正しいです。

  1. resultsを空のリストに設定します。

  2. navigablesToCheckを« traversable »に設定します。

    このリストは以下のループで拡張されます。

  3. それぞれのnavigableに対して、navigablesToCheckをチェックします。

    1. ターゲット履歴エントリを取得した結果をnavigableとtargetStepに基づいてtargetEntryに設定します。

    2. もしtargetEntryがnavigableの現在のセッション履歴エントリであり、targetEntryのドキュメント状態のリロード保留が偽である場合:

      1. 追加navigableをresultsにします。

      2. 拡張navigablesToCheckをnavigableの子ナビゲーブルにします。

        子ナビゲーブルをnavigablesToCheckに追加することで、これらのナビゲーブルもこのループによってチェックされます。子ナビゲーブルは、navigableのアクティブドキュメントがこのトラバーサルの一部として変更されない場合にのみチェックされます。

  4. resultsを返します。

ナビゲーブルのnavigableと非負整数のstepを指定して、ターゲット履歴エントリを取得するには、次の手順を実行します。これらは、セッション履歴エントリを返します。

  1. navigableのセッション履歴エントリを取得した結果をentriesに設定します。

  2. entries内のstep以下の最大のアイテムを返します。

ターゲット履歴エントリを取得が入力step以下の最大のステップを持つエントリを返す理由を見るためには、次のJakeダイアグラムを考慮してください。

0 1 2 3
top /t /t#foo
frames[0] /i-0-a /i-0-b

入力ステップ1の場合、topナビゲーブルのターゲット履歴エントリはステップ0の/tエントリであり、frames[0]ナビゲーブルのターゲット履歴エントリはステップ1の/i-0-bエントリです。

0 1 2 3
top /t /t#foo
frames[0] /i-0-a /i-0-b

同様に、入力ステップ3の場合、ステップ3のtopエントリとステップ1のframes[0]エントリが得られます。

0 1 2 3
top /t /t#foo
frames[0] /i-0-a /i-0-b

トラバーサブルナビゲーブルのtraversableと非負整数のtargetStepを指定して、ドキュメント間トラバーサルを経験する可能性があるすべてのナビゲーブルを取得するには、次の手順を実行します。これらは、リストのナビゲーブルを返します。

traversableのセッション履歴トラバーサルキューの観点から見ると、これらのドキュメントはtargetStepで説明されるトラバーサル中にクロスドキュメント化する候補となります。ターゲットドキュメントのステータスコードがHTTP 204 No Contentである場合、それらはクロスドキュメントトラバーサルを経験しません。

特定のナビゲーブルがクロスドキュメントトラバーサルを経験する可能性がある場合、このアルゴリズムはナビゲーブルを返しますが、その子ナビゲーブルは返しません。それらはトラバーサルされず、アンロードされることになります。

  1. resultsを空のリストに設定します。

  2. navigablesToCheckを« traversable »に設定します。

    このリストは以下のループで拡張されます。

  3. それぞれのnavigableに対して、navigablesToCheckをチェックします。

    1. ターゲット履歴エントリを取得した結果をnavigableとtargetStepに基づいてtargetEntryに設定します。

    2. もしtargetEntryのドキュメントがnavigableのドキュメントでないか、targetEntryのドキュメント状態のリロード保留が真である場合、navigableをresultsに追加します。

      たとえnavigableのアクティブな履歴エントリが同期的に変更されたとしても、新しいエントリは常に同じドキュメントを持つため、navigableのドキュメントにアクセスすることは信頼できます。

    3. それ以外の場合は、navigableの子ナビゲーブルを使用してnavigablesToCheckを拡張します。

      子ナビゲーブルをnavigablesToCheckに追加することで、これらのナビゲーブルもこのループによってチェックされます。子ナビゲーブルは、navigableのアクティブドキュメントがこのトラバーサルの一部として変更されない場合にのみチェックされます。

  4. resultsを返します。

7.4.6.2 ドキュメントの更新

Document document、セッション履歴エントリ entry、ブール値のdoNotReactivate、整数のscriptHistoryLengthとscriptHistoryIndex、NavigationTypeまたはnullのnavigationType、任意のリストのセッション履歴エントリ entriesForNavigationAPI、および任意のセッション履歴エントリ previousEntryForActivationを指定して履歴ステップ適用のためにドキュメントを更新するには、次の手順を実行します。

  1. documentの最新エントリがnullの場合はdocumentIsNewをtrueに設定し、それ以外の場合はfalseに設定します。

  2. documentの最新エントリがentryでない場合はdocumentsEntryChangedをtrueに設定し、それ以外の場合はfalseに設定します。

  3. documentの履歴オブジェクトのインデックスをscriptHistoryIndexに設定します。

  4. documentの履歴オブジェクトの長さをscriptHistoryLengthに設定します。

  5. navigationをhistoryの関連グローバルオブジェクトのナビゲーションAPIに設定します。

  6. documentsEntryChangedがtrueの場合、次の手順を実行します。

    1. oldURLをdocumentの最新エントリのURLに設定します。

    2. documentの最新エントリをentryに設定します。

    3. 履歴オブジェクトの状態を復元するをdocumentおよびentryに対して実行します。

    4. documentIsNewがfalseの場合、次の手順を実行します。

      1. アサート: navigationTypeはnullでないこと。

      2. 同一ドキュメントナビゲーションのためのナビゲーションAPIエントリを更新するをnavigation、entry、およびnavigationTypeに対して実行します。

      3. イベントを発火する「popstate」と名付けたdocumentの関連グローバルオブジェクトに対して、PopStateEventを使用し、そのstate属性をdocumentの履歴オブジェクトのstateで初期化し、hasUAVisualTransition属性を、ユーザーエージェントによってキャッシュされたレンダリング状態を表示する視覚的な遷移が行われた場合はtrueで初期化します。

      4. 永続状態を復元するをentryに対して実行します。

      5. oldURLのフラグメントがentryのURLのフラグメントと等しくない場合、documentの関連グローバルオブジェクトに対してイベントを発火する「hashchange」と名付けて、HashChangeEventを使用し、そのoldURL属性をoldURLのシリアライゼーションで初期化し、newURL属性をentryのURLのシリアライゼーションで初期化します。

    5. それ以外の場合:

      1. アサート: entriesForNavigationAPIが与えられていること。

      2. 永続状態を復元するをentryに対して実行します。

      3. 新しいドキュメントのためのナビゲーションAPIエントリを初期化するをnavigation、entriesForNavigationAPI、およびentryに対して実行します。

  7. 以下のすべてがtrueである場合:

    次の手順を実行します。

    1. navigationのアクティベーションがnullである場合、それを新しいNavigationActivationオブジェクトに設定し、navigationの関連領域に設定します。

    2. previousEntryIndexをpreviousEntryForActivationのナビゲーションAPIエントリインデックスを取得するの結果としてnavigation内で設定します。

    3. previousEntryIndexが負でない場合、activationの古いエントリをnavigationのエントリリスト[previousEntryIndex]に設定します。

    4. それ以外の場合、以下のすべてがtrueである場合:

      次にactivationの古いエントリをnavigationの関連領域で新しいNavigationHistoryEntryに設定し、そのセッション履歴エントリをpreviousEntryForActivationに設定します。

    5. activationの新しいエントリをnavigationの現在のエントリに設定します。

    6. activationのナビゲーションタイプをnavigationTypeに設定します。

  8. documentIsNew が true の場合：

    1. アサート：document の WebDriver BiDi のロード中ナビゲーション ID は null ではありません。

    2. navigable と、その id が document の WebDriver BiDi のロード中ナビゲーション ID であり、 status が 「committed」であり、 そして url が document の URL である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーションコミット済みを呼び出します。

    3. document のフラグメントへのスクロールを試みます。

    4. この時点で 新しく作成されたドキュメントでスクリプトが実行される可能性があります document。

  9. それ以外の場合、documentsEntryChangedがfalseであり、doNotReactivateがfalseの場合、次の手順を実行します。

    1. アサート: entriesForNavigationAPIが与えられていること。

    2. 再活性化するをdocumentおよびentriesForNavigationAPIに対して実行します。

    documentsEntryChangedがfalseである理由は2つあります。1つは、bfcacheから復元しているか、または同期的にナビゲーションを完了しており、既に同期的にdocumentの最新エントリが設定されている場合です。doNotReactivate引数はこれら2つのケースを区別します。

Document documentおよびセッション履歴エントリ entryを指定して履歴オブジェクトの状態を復元するには、次の手順を実行します。

  1. targetRealmをdocumentの関連領域に設定します。

  2. stateをStructuredDeserialize(entryのクラシック履歴API状態, targetRealm)で設定し、例外が発生した場合はキャッチしてstateをnullに設定します。

  3. documentの履歴オブジェクトのstateをstateに設定します。

Document documentをアクティブにするには、次の手順を実行します。

  1. windowをdocumentの関連グローバルオブジェクトに設定します。

  2. documentのブラウジングコンテキストのWindowProxyの[[Window]]内部スロット値をwindowに設定します。

  3. documentの可視性状態をdocumentのノードナビゲーブルのトラバーサブルナビゲーブルのシステム可視性状態に設定します。

  4. 新しいVisibilityStateEntryをキューに入れ、その可視性状態をdocumentの可視性状態に設定し、そのタイムスタンプをゼロに設定します。

  5. windowの関連設定オブジェクトの実行準備フラグを設定します。

Document document、セッション履歴エントリ reactivatedEntry、およびリストのセッション履歴エントリ entriesForNavigationAPIを指定してドキュメントを再活性化するには、次の手順を実行します。

このアルゴリズムは、documentがbfcacheから出てきた後、つまり再び完全にアクティブになった後にdocumentを更新します。この変更を監視したい他の仕様は、このアルゴリズムにステップを追加することが奨励されており、変更の結果として発生するイベントの順序が明確になるようにしています。

  1. それぞれのformControlがdocument内にあり、その自動入力フィールド名が「off」である場合、formControlに対してリセットアルゴリズムを実行します。

  2. もしdocumentの一時停止されたタイマーハンドルが空でない場合：

    1. アサート: documentのサスペンション時間がゼロでないこと。

    2. suspendDurationを現在の高精度時間からdocumentのサスペンション時間を引いた値に設定します。

    3. activeTimersをdocumentの関連グローバルオブジェクトのアクティブタイマーのマップに設定します。

    4. それぞれのhandleに対して、documentのサスペンドされたタイマーハンドル内にあり、activeTimers[handle]が存在する場合、そのactiveTimers[handle]をsuspendDurationだけ増加させます。

  3. documentの関連グローバルオブジェクトのナビゲーションAPI、entriesForNavigationAPI、およびreactivatedEntryを指定して再活性化のためにナビゲーションAPIエントリを更新するを実行します。

  4. document の 現在のドキュメント準備状態が "complete" であり、かつ document の ページ表示が false の場合：

    1. document の ページ表示を true に設定します。

    2. document の 表示済みを false に設定します。

    3. document の可視性状態を更新し、"visible" にします。

    4. document の 関連するグローバルオブジェクトで、true を指定して pageshow という名前のページ遷移イベントを発行します。

Document documentのフラグメントへのスクロールを試みるには、次の手順を並列で実行します。

  1. 実装依存の時間を待ちます。（これは、パフォーマンスの問題に直面した場合にユーザーエージェントがユーザーエクスペリエンスを最適化することを意図しています。）

  2. documentの関連グローバルオブジェクトに対してグローバルタスクをキューに入れるを実行し、次の手順を実行します。

    1. documentがパーサーを持たないか、そのパーサーがパースを停止しているか、またはユーザーエージェントがユーザーがもはやフラグメントへのスクロールに興味がないと判断した場合、これらの手順を中止します。

    2. documentに対してフラグメントにスクロールするを実行します。

    3. documentの指示された部分が依然としてnullの場合、documentに対してフラグメントへのスクロールを再試行するを実行します。

Document documentおよび文字列reasonを指定してドキュメントを復旧不能にするには、次の手順を実行します。

  1. detailsを新しい復元されなかった理由の詳細に設定し、その理由をreasonに設定します。

  2. 詳細をdocumentのbfcacheブロッキングの詳細に追加します。

  3. documentの復旧可能状態をfalseに設定します。

Document documentを指定してドキュメント状態のために復元されなかった理由を構築するには、次の手順を実行します。

  1. notRestoredReasonsForDocument を新しい復元されなかった理由とします。

  2. notRestoredReasonsForDocument の URL を document の URL に設定します。

  3. container を document の ノードナビゲブルの コンテナとします。

  4. container が iframe 要素の場合：

    1. src を空の文字列とします。

    2. container が src 属性を持つ場合：

      1. src を、container の src 属性の値を、container の ノードドキュメントを基準としてURL をエンコード、解析、シリアル化した結果とします。

      2. src が失敗の場合、src を container の src 属性の値に設定します。

    3. notRestoredReasonsForDocument の src を src に設定します。

    4. notRestoredReasonsForDocument の id を container の id 属性の値に、またはそのような属性がない場合は空の文字列に設定します。

    5. notRestoredReasonsForDocument の name を container の name 属性の値に、またはそのような属性がない場合は空の文字列に設定します。

  5. notRestoredReasonsForDocument の reasons を document の bfcache ブロッキング詳細のクローンに設定します。

  6. document の ドキュメントツリーの子ナビゲブルの各 navigable について：

    1. childDocument を navigable の アクティブドキュメントとします。

    2. childDocument を指定してドキュメント状態の復元されなかった理由を構築します。

    3. childDocument の 復元されなかった理由を notRestoredReasonsForDocument の children に追加します。

  7. document の ノードナビゲブルの アクティブなセッション履歴エントリの ドキュメント状態の 復元されなかった理由を notRestoredReasonsForDocument に設定します。

最上位トラバーサブル topLevelTraversableおよびその子孫を指定して最上位トラバーサブルおよびその子孫のために復元されなかった理由を構築するには、次の手順を実行します。

  1. topLevelTraversableのアクティブドキュメントに対してドキュメント状態のために復元されなかった理由を構築するを実行します。

  2. crossOriginDescendantsを空のリストに設定します。

  3. topLevelTraversableのアクティブドキュメントの子孫ナビゲーブルのそれぞれに対して、次の手順を実行します。

    1. childNavigableのアクティブドキュメントのオリジンが、topLevelTraversableのアクティブドキュメントのオリジンと同一オリジンでない場合、childNavigableをcrossOriginDescendantsに追加します。

  4. crossOriginDescendantsPreventsBfcacheをfalseに設定します。

  5. crossOriginDescendantsのそれぞれに対して、次の手順を実行します。

    1. reasonsForCrossOriginChildをcrossOriginNavigableのアクティブドキュメントのドキュメント状態の復元されなかった理由に設定します。

    2. reasonsForCrossOriginChildの理由が空でない場合、crossOriginDescendantsPreventsBfcacheをtrueに設定します。

    3. reasonsForCrossOriginChildのURLをnullに設定します。

    4. reasonsForCrossOriginChildの理由をnullに設定します。

    5. reasonsForCrossOriginChildの子要素をnullに設定します。

  6. crossOriginDescendantsPreventsBfcacheがtrueの場合、topLevelTraversableのアクティブドキュメントおよび「masked」を指定してドキュメントを復旧不能にするを実行します。

7.4.6.3 ドキュメントの表示

Documentには、表示済みというブール値があり、初期値はfalseです。これは、pagerevealイベントがDocumentの各アクティベーションに対して一度だけ発火されることを保証するために使用されます（最初にレンダリングされたときと、各再アクティベーション時に一度ずつ）。

Document documentを表示するには、次の手順を実行します。

  1. もしdocumentの表示済みがtrueであるなら、終了します。

  2. documentの表示済みをtrueに設定します。

  3. documentに対して、インバウンドクロスドキュメントビュー遷移の解決の結果をtransitionとして設定します。

  4. documentの関連グローバルオブジェクトに対して、イベントを発火するを実行し、イベント名をpagereveal、イベントオブジェクトをPageRevealEvent、そのviewTransitionをtransitionに設定します。

  5. もしtransitionがnullでない場合、次の手順を実行します。

    1. スクリプトを実行する準備をする document の 関連設定オブジェクト を与えます。

    2. アクティベート transition。

    3. スクリプト実行後のクリーンアップを、document の 関連設定オブジェクト を与えて行います。

    ビュー遷移を有効化すると、Promiseが解決または拒否される可能性があるため、実行準備/クリーンアップでラップすることで、次のレンダリングステップの前にそれらのPromiseが処理されることを保証します。

pagerevealは、ページの最新バージョンを表示する最初のレンダリングの更新ステップ中に発火されることが保証されていますが、ユーザーエージェントはそれを発火する前にページのキャッシュフレームを表示することができます。これにより、pagerevealハンドラーの存在がそのようなキャッシュフレームの表示を遅らせるのを防ぎます。

7.4.6.4 フラグメントへのスクロール

Document documentを指定してフラグメントにスクロールするには、次の手順を実行します。

  1. もしdocumentの指定された部分がnullであるなら、documentのターゲット要素をnullに設定します。

  2. そうでなければ、もしdocumentの指定された部分がドキュメントの先頭であるなら、次の手順を実行します。

    1. documentのターゲット要素をnullに設定します。

    2. documentに対してドキュメントの最初にスクロールします。[CSSOMVIEW]

    3. 終了します。

  3. そうでなければ、次の手順を実行します。

    1. 確認します：documentの指定された部分が要素であること。

    2. documentの指定された部分をtargetに設定します。

    3. documentのターゲット要素をtargetに設定します。

    4. 先祖の詳細を明らかにするアルゴリズムをtargetに対して実行します。

    5. 先祖が見つかるまで隠れているアルゴリズムをtargetに対して実行します。

    6. targetを表示範囲にスクロールし、behaviorを"auto"に、blockを"start"に、inlineを"nearest"に設定します。[CSSOMVIEW]

    7. targetに対してフォーカスするステップを実行し、Documentのビューポートをfallback targetとして使用します。

    8. 順次フォーカスナビゲーションの開始点をtargetに移動します。

Documentの指定された部分は、そのURLのフラグメントが示す部分です。フラグメントが何も指定していない場合はnullです。ノードにマッピングするフラグメントのセマンティクスは、Documentで使用されるMIMEタイプを定義する仕様によって定義されます（例: フラグメントの処理は、XML MIMEタイプに関してはRFC7303が責任を負います）。[RFC7303]

また、各Documentにはターゲット要素があり、:target疑似クラスの定義に使用され、上記のアルゴリズムによって更新されます。それは最初はnullです。

HTMLドキュメントであるdocumentの場合、その指定された部分はdocumentとdocumentのURLを指定して指定された部分を選択する結果です。

Document documentとURL urlを指定して指定された部分を選択するには、次の手順を実行します。

  1. もしdocumentのURLがフラグメントを除外してurlと等しくないなら、nullを返します。

  2. urlのフラグメントをfragmentに設定します。

  3. もしfragmentが空文字列なら、特別な値ドキュメントの先頭を返します。

  4. documentとfragmentを指定して潜在的な指定要素を見つける結果をpotentialIndicatedElementに設定します。

  5. もしpotentialIndicatedElementがnullでないなら、それを返します。

  6. fragmentを指定してパーセントデコードの結果をfragmentBytesに設定します。

  7. fragmentBytesを指定してUTF-8 BOMなしデコードの結果をdecodedFragmentに設定します。

  8. documentとdecodedFragmentを指定して潜在的な指定要素を見つける結果をpotentialIndicatedElementに設定します。

  9. もしpotentialIndicatedElementがnullでないなら、それを返します。

  10. もしdecodedFragmentがtopとASCII大文字小文字を区別しない一致を持つなら、ドキュメントの先頭を返します。

  11. nullを返します。

Document documentと文字列fragmentを指定して潜在的な指定要素を見つけるには、次の手順を実行します。

  1. もしドキュメントツリー内で、そのルートがdocumentであり、かつそのIDがfragmentと等しい要素が存在するなら、ツリー順で最初のその要素を返します。

  2. もしa要素がドキュメントツリー内で、そのルートがdocumentであり、かつそのname属性の値がfragmentと等しいなら、ツリー順で最初のその要素を返します。

  3. nullを返します。

7.4.6.5 永続化された履歴エントリの状態

セッション履歴エントリ entryに永続化された状態を保存するには、次の手順を実行します。

  1. entryのスクロール位置データを、entryのドキュメントの復元可能なスクロール領域全体のスクロール位置を含むように設定します。

  2. 必要に応じて、entryの永続化されたユーザー状態を、ユーザーエージェントが保持したい状態（フォームフィールドの値など）を反映するように更新します。

セッション履歴エントリ entryから永続化された状態を復元するには、次の手順を実行します。

  1. もしentryのスクロール復元モードが「auto」であり、かつentryのドキュメントの関連グローバルオブジェクトのナビゲーションAPIの進行中のナビゲーション中に通常のスクロール復元を抑制が偽である場合、entryを指定してスクロール位置データを復元します。

    ユーザーエージェントがスクロール位置を復元しないことは、スクロール位置が特定の値（例えば (0,0)）に設定されることを意味しません。実際のスクロール位置はナビゲーションの種類やユーザーエージェントのキャッシュ戦略によって異なります。したがって、ウェブアプリケーションは特定のスクロール位置を想定するのではなく、自分が望む位置に設定することが推奨されます。

    もし進行中のナビゲーション中に通常のスクロール復元を抑制が真である場合でも、関連するNavigateEventを完了する一環として、またはnavigateEvent.scroll()メソッドの呼び出しによって、後でスクロール位置データが復元されることがあります。

  2. 必要に応じて、entryのドキュメントやそのレンダリングの他の側面を更新します。例えば、ユーザーエージェントが以前にentryの永続化されたユーザー状態に記録したフォームフィールドの値などです。

    これには、dir属性が設定されているtextarea要素やinput要素の、type属性がテキスト、検索、電話、URL、またはメールのいずれかの状態にある場合、入力コントロールの方向性を含む永続化された状態を更新することが含まれることもあります。

    このプロセスの一部としてフォームコントロールの値を復元することは、inputやchangeイベントを発生させることはありませんが、フォーム関連カスタム要素のformStateRestoreCallbackをトリガーすることがあります。

各Documentには、ユーザーによってスクロールされたというブール値があり、最初は偽です。ユーザーがドキュメントをスクロールすると、ユーザーエージェントはそのドキュメントのユーザーによってスクロールされたを真に設定する必要があります。

Document documentの復元可能なスクロール領域は、documentのビューポートと、documentのスクロール可能な領域のうち、ナビゲーブルコンテナを除いたすべてです。

子ナビゲーブルのスクロール復元は、それらのセッション履歴エントリの状態復元の一部として扱われます。

セッション履歴エントリ entryを指定してスクロール位置データを復元するには、次の手順を実行します。

  1. entryのドキュメントをdocumentとします。

  2. もしdocumentのユーザーによってスクロールされたが真である場合、ユーザーエージェントは終了します。

  3. ユーザーエージェントは、entryのスクロール位置データを使用して、entryのドキュメントの復元可能なスクロール領域のスクロール位置を復元しようとします。ユーザーエージェントは、documentのユーザーによってスクロールされたが真になるまで、定期的にこれを試みることがあります。

    これは、スクロール位置データで示された関連コンテンツがネットワークから読み込まれるのに時間がかかる可能性があるため、成功するまで、またはユーザーがスクロールするまで定期的に試みるという形で表現されています。

    スクロール復元は、スクロールアンカーリングの影響を受ける可能性があります。[CSSSCROLLANCHORING]

7.5 ドキュメントライフサイクル

7.5.1 共有ドキュメント作成インフラストラクチャ

以下のアルゴリズムを使用してドキュメントをロードする際には、タイプ type、コンテンツタイプ contentType、およびナビゲーションパラメータ navigationParamsを指定して、ドキュメントオブジェクトを作成および初期化するための次の手順を使用します。

ドキュメントオブジェクトは、新しいブラウジングコンテキストとドキュメントの作成時にも作成されますが、このアルゴリズムでは初期のabout:blank ドキュメントは決して作成されません。また、ブラウジングコンテキストを持たないドキュメントオブジェクトは、document.implementation.createHTMLDocument()などのさまざまなAPIを介して作成できます。

  1. browsingContext を、navigationParams を指定してナビゲーション応答に使用するブラウジングコンテキストを取得した結果とします。

    これにより、ブラウジングコンテキストグループの切り替えが発生する可能性があり、その場合 browsingContext は navigationParams の ナビゲブルの アクティブなブラウジングコンテキストではなく、新しく作成された ブラウジングコンテキストになります。そのような場合、作成された Window、Document、および エージェントは最終的に使用されません。なぜなら、作成された Document の オリジンは不透明であるため、新しい Document に合わせて、このアルゴリズムの後半で新しい エージェントと Window を作成することになるからです。

  2. permissionsPolicy を、navigationParams の ナビゲブルの コンテナ、navigationParams の オリジン、およびnavigationParams の レスポンスを指定して、レスポンスから権限ポリシーを作成した結果とします。[PERMISSIONSPOLICY]

    レスポンスから権限ポリシーを作成するアルゴリズムは、渡されたオリジンを利用します。document.domain が navigationParams の ナビゲブルの コンテナドキュメントに使用されている場合、そのオリジンは、渡されたオリジンと同一オリジンドメインになることはできません。なぜなら、これらのステップは document が作成される前に実行されるため、それ自体がまだ document.domain を使用していないからです。これは、権限ポリシーのチェックが、代わりに同一オリジンチェックを行う場合と比較して、より厳格であることを意味します。

    これの動作例については、以下を参照してください。

  3. creationURL を navigationParams の レスポンスの URL とします。

  4. navigationParams の リクエストが null でない場合、creationURL を navigationParams の リクエストの 現在の URL に設定します。

  5. window を null とします。

  6. browsingContext の アクティブドキュメントの 初期 about:blank であるかが true であり、かつ browsingContext の アクティブドキュメントの オリジンが navigationParams の オリジンと同一オリジンドメインである場合、window を browsingContext の アクティブウィンドウに設定します。

    これは、初期 about:blank Document と、これから作成される新しい Document の両方が、同じ Window オブジェクトを共有することを意味します。

  7. それ以外の場合：

    1. oacHeader を、navigationParams の レスポンスの ヘッダーリストから、`Origin-Agent-Cluster` と "item" を指定して構造化フィールド値を取得した結果とします。

    2. requestsOAC を、oacHeader が null でなく、かつ oacHeader[0] がブール値 true の場合は true、それ以外の場合は false とします。

    3. navigationParams の 予約済み環境が非セキュアコンテキストの場合、requestsOAC を false に設定します。

    4. agent を、navigationParams の オリジン、browsingContext の グループ、および requestsOAC を指定して類似オリジンウィンドウエージェントを取得した結果とします。

    5. realmExecutionContext を、agent と次のカスタマイズを指定して新しいレルムを作成した結果とします：

      • グローバルオブジェクトには、新しい Window オブジェクトを作成します。

      • グローバルな this バインディングには、browsingContext の WindowProxy オブジェクトを使用します。

    6. window を realmExecutionContext のレルムコンポーネントのグローバルオブジェクトに設定します。

    7. topLevelCreationURL を creationURL とします。

    8. topLevelOrigin を navigationParams の オリジンとします。

    9. navigable の コンテナが null でない場合：

      1. parentEnvironment を navigable の コンテナの 関連する設定オブジェクトとします。

      2. topLevelCreationURL を parentEnvironment の トップレベル作成 URL に設定します。

      3. topLevelOrigin を parentEnvironment の トップレベルオリジンに設定します。

    10. creationURL、realmExecutionContext、navigationParams の 予約済み環境、topLevelCreationURL、および topLevelOrigin を指定してウィンドウ環境設定オブジェクトを設定します。

    これは通常のケースであり、これから作成する新しい Document は、それに合わせて新しい Window を取得します。

  8. loadTimingInfo を、そのナビゲーション開始時刻を navigationParams の レスポンスの タイミング情報の 開始時刻に設定した新しいドキュメント読み込みタイミング情報とします。

  9. document を、次のプロパティを持つ新しい Document とします。

    type
    type
    content type
    contentType
    origin
    navigationParams の オリジン
    ブラウジングコンテキスト
    browsingContext
    ポリシーコンテナ
    navigationParams の ポリシーコンテナ
    権限ポリシー
    permissionsPolicy
    アクティブなサンドボックスフラグセット
    navigationParams の 最終的なサンドボックスフラグセット
    オープナーポリシー
    navigationParams の クロスオリジンオープナーポリシー
    読み込みタイミング情報
    loadTimingInfo
    クロスオリジンリダイレクト経由で作成されたか
    navigationParams の レスポンスの クロスオリジンリダイレクトがあるか
    WebDriver BiDi のロード中ナビゲーション ID
    navigationParams の id
    URL
    creationURL
    現在のドキュメント準備状態
    "loading"
    about ベース URL
    navigationParams の about ベース URL
    宣言的シャドウ ルートを許可する
    true
    カスタム要素レジストリ
    新しい CustomElementRegistry オブジェクト。

  10. window の 関連付けられた Document を document に設定します。

  11. document を指定して、Document の CSP 初期化を実行します。[CSP]

  12. navigationParams の リクエストが null でない場合：

    1. document の リファラーを 空の文字列に設定します。

    2. referrer を navigationParams の リクエストの リファラーとします。

    3. referrer が URL レコードの場合、document の リファラーを referrer のシリアル化に設定します。

      Fetch によると、この時点で referrer は URL レコードまたは "no-referrer" のいずれかになります。

  13. navigationParams の フェッチコントローラーが null でない場合：

    1. fullTimingInfo を、navigationParams の フェッチコントローラーから完全なタイミング情報を抽出した結果とします。

    2. redirectCount を、navigationParams の レスポンスの クロスオリジンリダイレクトがあるかが true の場合は 0、それ以外の場合は navigationParams の リクエストの リダイレクトカウントとします。

    3. fullTimingInfo、redirectCount、navigationTimingType、navigationParams の レスポンスの サービスワーカータイミング情報、および navigationParams の レスポンスの ボディ情報を指定して、document のナビゲーションタイミングエントリを作成します。

  14. navigationParams の レスポンスの タイミング情報、redirectCount、navigationParams の ナビゲーションタイミングタイプ、および navigationParams の レスポンスの サービスワーカータイミング情報を指定して、document のナビゲーションタイミングエントリを作成します。

  15. navigationParams の レスポンスが `Refresh` ヘッダーを持つ場合：

    1. value を、ヘッダーの値の同形デコードとします。

    2. document と value を指定して、共有宣言的リフレッシュステップを実行します。

    現在、複数の `Refresh` ヘッダーを処理する方法に関する仕様はありません。これは issue #2900 として追跡されています。

  16. navigationParams の 早期ヒントのコミットが null でない場合、document を指定して navigationParams の 早期ヒントのコミットを呼び出します。

  17. document、navigationParams の レスポンス、および "pre-media" を指定して、リンクヘッダーを処理します。

  18. document を返します。

この例では、子ドキュメントがそれを使用しようとした時点で同一オリジンドメインであるにもかかわらず、子ドキュメントは PaymentRequest を使用できません。子ドキュメントが初期化された時点では、親ドキュメントのみが document.domain を設定しており、子ドキュメントは設定していません。

<!-- https://foo.example.com/a.html -->
 <!doctype html>
 <script>
 document.domain = 'example.com';
 </script>
 <iframe src=b.html></iframe>
<!-- https://bar.example.com/b.html -->
 <!doctype html>
 <script>
 document.domain = 'example.com'; // ドキュメントが初期化された後にこれが発生します
 new PaymentRequest(…); // 使用が許可されていません
 </script>

この例では、子ドキュメントがそれを使用しようとした時点で同一オリジンドメインではないにもかかわらず、子ドキュメントは PaymentRequest を使用できます。子ドキュメントが初期化された時点では、どのドキュメントもまだ document.domain を設定していないため、同一オリジンドメインは通常の同一オリジンチェックにフォールバックします。 

<!-- https://example.com/a.html -->
 <!doctype html>
 <iframe src=b.html></iframe>
 <!-- 子ドキュメントが初期化され、以下のスクリプトが実行される前に -->
 <script>
 document.domain = 'example.com';
 </script>
<!-- https://example.com/b.html -->
 <!doctype html>
 <script>
 new PaymentRequest(…); // 使用が許可されています
 </script>

Document document を指定して、html/head/body で入力するには：

  1. html を、document、「html」、およびHTML 名前空間を指定して要素を作成した結果とします。

  2. head を、document、「head」、およびHTML 名前空間を指定して要素を作成した結果とします。

  3. body を、document、「body」、およびHTML 名前空間を指定して要素を作成した結果とします。

  4. html を document に追加します。

  5. head を html に追加します。

  6. body を html に追加します。

7.5.2 HTML文書の読み込み

HTML文書を読み込むには、ナビゲーションパラメータ navigationParamsが与えられた場合、次の手順を実行します。

  1. 「html」、「text/html」、およびnavigationParamsを指定して、Documentオブジェクトを作成および初期化する結果として、documentを取得します。

  2. もしdocumentのURLがabout:blankである場合、「html/head/body」で埋めるをdocumentに対して実行します。

    この特別なケースでは、非初期のabout:blank Documentでも、その要素ノードが同期的に与えられることが必要です。言い換えれば、代わりに「それ以外」の分岐に進んで空のバイトシーケンスをHTMLパーサーに渡して、非同期的にdocumentを埋めるのは互換性がありません。

  3. それ以外の場合、HTMLパーサーを作成し、documentに関連付けます。 フェッチ中にネットワーキングタスクソースがタスクキューに配置するタスクは、取得されたバイトをパーサーの入力バイトストリームに埋め、それがHTMLパーサーにストリームの適切な処理を実行させる必要があります。

    フェッチ中にネットワーキングタスクソースがタスクキューに配置する最初のタスクは、タスクがHTMLパーサーで処理された後、document、navigationParamsのレスポンス、および「media」を与えられて、リンクヘッダーを処理する必要があります。

    スクリプトの実行が発生する前に、ユーザーエージェントはdocumentに対して新しく作成されたドキュメントのためにスクリプトが実行される可能性があるを待つ必要があります。

    入力バイトストリームは、トークナイザで使用するためにバイトを文字に変換します。このプロセスは部分的に、リソースの実際のContent-Typeメタデータに見つかった文字エンコーディング情報に依存します。計算されたタイプはこの目的には使用されません。

    これ以上バイトが利用できない場合、ユーザーエージェントはdocumentの関連するグローバルオブジェクトを指定してグローバルタスクをキューに追加し、パーサーに暗黙のEOF文字を処理させ、最終的にloadイベントが発生するようにします。

  4. documentを返します。

7.5.3 XML文書の読み込み

XMLファイルをインラインで表示する場合、ナビゲーションパラメータ navigationParamsと文字列typeが与えられている場合、ユーザーエージェントは、XML、Namespaces in XML、XML Media Types、DOM、およびその他の関連仕様で定義された要件に従い、"xml"、type、およびnavigationParamsを指定してDocumentオブジェクトを作成および初期化する documentを作成し、それを返す必要があります。また、対応するXMLパーサーも作成する必要があります。[XML] [XMLNS] [RFC7303] [DOM]

執筆時点では、XML仕様コミュニティは、XMLとDOMの相互作用についてまだ正式に仕様化していませんでした。

タスクを実行中に、ネットワーキングタスクソースがタスクキューに配置する最初のタスクは、リンクヘッダーを処理する必要があります。document、navigationParamsのレスポンス、および"media"が与えられた後、このタスクはXMLパーサーによって処理されます。

実際のHTTPヘッダーやその他のメタデータ（この仕様で与えられたアルゴリズムによって変更されたり、暗示されたりしたヘッダーではない）を使用して、上記の仕様で定められたルールに従って文字エンコーディングを決定する必要があります。文字エンコーディングが確立されると、ドキュメントの文字エンコーディングをその文字エンコーディングに設定する必要があります。

スクリプトの実行が発生する前に、ユーザーエージェントは、新しく作成されたDocumentに対してスクリプトが実行される可能性があるを待つ必要があります。

解析が完了すると、ユーザーエージェントはdocumentのWebDriver BiDiの読み込み中のナビゲーションIDをnullに設定する必要があります。

HTML文書の場合、これは読み込みイベントが発生した後、解析が完了したときにリセットされます。

解析プロセスからのエラーメッセージ（例：XML名前空間の整形式エラーなど）は、Documentを変更することでインラインで報告される場合があります。

7.5.4 テキスト文書の読み込み

テキスト文書を読み込むには、ナビゲーションパラメータ navigationParamsと文字列typeが与えられた場合、次の手順を実行します。

  1. 「html」、type、およびnavigationParamsを指定してDocumentオブジェクトを作成および初期化する結果として、documentを取得します。

  2. documentのパーサーはモードを変更できないフラグをtrueに設定します。

  3. documentのモードを「no-quirks」に設定します。

  4. HTMLパーサーを作成し、documentに関連付けます。トークナイザがタグ名「pre」を持つ開始タグトークンを発行し、それに続く単一のU+000A LINE FEED (LF) 文字を発行したかのように振る舞い、HTMLパーサーのトークナイザをPLAINTEXT状態に切り替えます。フェッチ中にネットワーキングタスクソースがタスクキューに配置するタスクは、取得されたバイトを入力バイトストリームに埋め、それがHTMLパーサーにストリームの適切な処理を実行させる必要があります。

    documentの文字エンコーディングは、解析中にドキュメントをデコードするために使用された文字エンコーディングに設定される必要があります。

    フェッチ中にネットワーキングタスクソースがタスクキューに配置する最初のタスクは、タスクがHTMLパーサーで処理された後、document、navigationParamsのレスポンス、および「media」を与えられて、リンクヘッダーを処理する必要があります。

    スクリプトの実行が発生する前に、ユーザーエージェントはdocumentに対して新しく作成されたドキュメントのためにスクリプトが実行される可能性があるを待つ必要があります。

    これ以上バイトが利用できない場合、ユーザーエージェントはdocumentの関連するグローバルオブジェクトを指定してグローバルタスクをキューに追加し、パーサーに暗黙のEOF文字を処理させ、最終的にloadイベントが発生するようにします。

  5. ユーザーエージェントは、documentのhead要素にコンテンツを追加することができます。例えば、スタイルシートへのリンク、スクリプトの提供、ドキュメントにタイトルを与えるなどです。

    特に、ユーザーエージェントがRFC 3676のFormat=Flowed機能をサポートしている場合、テキストが正しく折り返されるようにし、引用機能を処理するために追加のスタイリングを適用する必要があります。これは例えば、CSS拡張を使用して行うことができます。

  6. documentを返します。

プレーンテキスト文書のバイトを実際の文字に変換する方法、およびテキストをユーザーに実際にレンダリングするルールは、リソースの計算されたMIMEタイプ（すなわち、type）の仕様で定義されています。

7.5.5 multipart/x-mixed-replace文書の読み込み

multipart/x-mixed-replace文書を読み込むには、ナビゲーションパラメータ navigationParams、ソーススナップショットパラメータ sourceSnapshotParams、およびオリジン initiatorOriginが与えられた場合、次の手順を実行します。

  1. navigationParamsのレスポンスの本文をマルチパートタイプのルールに従って解析します。[RFC2046]

  2. firstPartNavigationParamsをnavigationParamsのコピーとして作成します。

  3. firstPartNavigationParamsのレスポンスを、navigationParamsのレスポンスの本文のマルチパートストリームを表す新しいレスポンスに設定します。

  4. documentを取得するために、firstPartNavigationParams、sourceSnapshotParams、およびinitiatorOriginを指定して文書を読み込む結果を得ます。

    navigationParamsのレスポンスから取得された追加の本文パートごとに、ユーザーエージェントはdocumentのノードナビゲーブルを、documentを使用して、navigationParamsのリクエストのURLにナビゲートし、レスポンスをnavigationParamsのレスポンスに設定し、履歴処理を"置換"に設定します。

  5. documentを返します。

これらの本文パートを完全な独立したリソースとして処理するアルゴリズムの目的のために、ユーザーエージェントは、本文パートに続く境界に到達するたびに、これ以上そのリソースのバイトが存在しないかのように振る舞う必要があります。

したがって、loadイベント（およびunloadイベントも含む）は、読み込まれた各本文パートに対して発生します。

7.5.6 メディア文書の読み込み

メディア文書を読み込むには、navigationParamsと文字列typeが与えられた場合、次の手順を実行します。

  1. 「html」、type、およびnavigationParamsを指定してDocumentオブジェクトを作成および初期化する結果として、documentを取得します。

  2. documentのモードを「no-quirks」に設定します。

  3. 「html/head/body」で埋めるをdocumentに対して実行します。

  4. 以下に記述されているように、メディア用の要素host elementを作成し、それをbody要素に追加します。

  5. 以下に記述されているように、メディアのアドレスをhost elementの適切な属性に設定します。

  6. ユーザーエージェントは、documentのhead要素にコンテンツを追加したり、host elementに属性を追加したりすることができます。例えば、スタイルシートへのリンク、スクリプトの提供、ドキュメントにタイトルを与えたり、メディアを自動再生するようにしたりすることができます。

  7. document、navigationParamsのレスポンス、および"media"を与えられて、リンクヘッダーを処理する必要があります。

  8. ユーザーエージェントがdocumentの解析を停止したかのように振る舞います。

  9. documentを返します。

メディアのために作成する要素host elementは、下記の表の第1列にメディアが記載されている行の第2列に示されている要素です。設定すべき適切な属性は、その行の第3列に示されている属性です。

メディアの種類 メディアのための要素 適切な属性
画像 img src
動画 video src
音声 audio src

スクリプトの実行が発生する前に、ユーザーエージェントは、Documentに対して新しく作成されたドキュメントのためにスクリプトが実行される可能性があるを待つ必要があります。

7.5.7 DOMを持たないインラインコンテンツ用の文書の読み込み

ユーザーエージェントが、ユーザーエージェントページまたは PDF ビューアをインラインで表示するためのドキュメントを作成する場合、ナビゲブル navigable、ナビゲーション ID navigationId、NavigationTimingType navTimingType、および ユーザーナビゲーションの関与 userInvolvement が提供された場合、ユーザーエージェントは次のことを行う必要があります。

  1. originを新しい不透明なオリジンとして設定します。

  2. coopを新しいクロスオリジンオープナーポリシーとして設定します。

  3. coopEnforcementResultを新しいクロスオリジンオープナーポリシーの施行結果として、次のプロパティを設定して作成します。

    url
    responseのURL
    origin
    origin
    クロスオリジンオープナーポリシー
    coop

  4. navigationParamsを新しいナビゲーションパラメータとして、次のプロパティを設定して作成します。

    id
    navigationId
    navigable
    navigable
    リクエスト
    null
    レスポンス
    新しいレスポンス
    origin
    origin
    フェッチコントローラ
    null
    初期ヒントのコミット
    null
    COOP施行結果
    coopEnforcementResult
    予約された環境
    null
    ポリシーコンテナ
    新しいポリシーコンテナ
    最終的なサンドボックスフラグセット
    空のセット
    クロスオリジンオープナーポリシー
    coop
    ナビゲーションタイミングタイプ
    navTimingType
    aboutベースURL
    null
    ユーザーの関与
    userInvolvement

  5. documentを「html」、「text/html」、およびnavigationParamsを指定してDocumentオブジェクトを作成および初期化する結果として取得します。

  6. 通常のDocumentレンダリングルールを使用せずにレンダリングされるカスタムレンダリングにdocumentを関連付けるか、またはdocumentを変更して、ユーザーエージェントがレンダリングしたいコンテンツを表すようにします。

  7. documentを返します。

結果として得られるDocumentのオリジンが不透明であることを保証し、結果として得られるDocumentがDOMにアクセスできるスクリプトを実行できないため、このDocumentの存在やプロパティはウェブ開発者のコードに観察されることはありません。つまり、上記のほとんどの値、例えばtext/html タイプは重要ではありません。同様に、navigationParamsのほとんどの項目は、Document作成アルゴリズムが混乱しないようにすることを除いて、観察可能な効果はありません。そのため、デフォルト値に設定されています。

ページが設定されたら、ユーザーエージェントは解析を停止したかのように振る舞う必要があります。

7.5.8 読み込みプロセスの完了

Documentには、最初はnullである完全に読み込まれた時刻（時刻またはnull）が設定されています。

Documentは、その完全に読み込まれた時刻がnullでない場合、完全に読み込まれたと見なされます。

Document documentを完全に読み込み完了するには、次の手順を実行します。

  1. documentのブラウジングコンテキストがnullでないことを確認します。

  2. documentの完全に読み込まれた時刻を現在時刻に設定します。

  3. containerをdocumentのノードナビゲーブルのコンテナとして設定します。

    これは、documentが初期のabout:blank Documentである場合、つまりframeまたはiframeにおいて、このアルゴリズムを呼び出すブラウジングコンテキストの作成の時点でコンテナの関係がまだ確立されていないため、nullになります。（これは、新しい子ナビゲーブルの作成の後続のステップで発生します。）

    この結果として、以下の手順は何もしません。つまり、そのような場合にコンテナ要素に対して非同期のloadイベントは発生しません。代わりに、iframe属性の処理時に、特別な初期挿入ケースで同期的なloadイベントが発生します。

  4. もしcontainerがiframe要素である場合、containerを指定して要素タスクをキューに追加するをDOM操作タスクソースに対して実行し、containerを指定してiframe読み込みイベント手順を実行します。

  5. それ以外の場合、containerがnullでない場合は、containerを与えて、DOM操作タスクソース上で要素タスクをキューに入れ、containerでloadイベントを発火させます。

7.5.9 文書のアンロード

Document は、初期状態で true でなければならないsalvageable 状態と、初期状態で false であるページ表示ブーリアンを持ちます。ページ表示ブーリアンは、スクリプトが一貫した方法で pageshow および pagehide イベントを受信することを保証するために使用されます（例えば、間に pageshow を挟まずに2つの pagehide イベントを連続して受信したり、その逆になったりしないようにするため）。

Documentには、DOMHighResTimeStamp 一時停止時間があり、初期値は0です。

Documentには、最初は空である一時停止されたタイマーハンドルのリストがあります。

イベントループには、最初は0である終了ネスティングレベルカウンターがあります。

Documentオブジェクトには、以下のアルゴリズムが実行されている間に特定の操作を無視するために使用されるアンロードカウンターがあります。カウンターの初期値はゼロに設定されている必要があります。

Document oldDocumentをアンロードするには、オプションでDocument newDocumentを指定して、以下の手順を実行します。

  1. 確認: これはoldDocumentの関連するエージェントのイベントループにキューされたタスクの一部として実行されます。

  2. unloadTimingInfoを新しい文書アンロードタイミング情報として設定します。

  3. newDocumentが指定されていない場合、unloadTimingInfoをnullに設定します。

    この場合、oldDocumentのアンロードにかかった時間について新しい文書に通知する必要はありません。

  4. それ以外の場合、newDocumentのイベントループがoldDocumentのイベントループと異なる場合、ユーザーエージェントはoldDocumentをアンロードすることができます。並行してこの場合、ユーザーエージェントはunloadTimingInfoをnullに設定する必要があります。

    この場合、newDocumentの読み込みにoldDocumentのアンロードにかかった時間が影響しないため、そのタイミング情報を伝える意味はありません。

  5. ユーザーエージェントがoldDocumentをセッション履歴エントリで後で履歴の移動に使用されるように保持するつもりであれば、intendToKeepInBfcacheをtrueに設定します。

    これは、oldDocumentが救済可能でない場合、またはユーザーエージェントが同じ方法で保持するつもりのないoldDocumentの子孫が存在する場合（救済可能性の欠如などを含む）、falseに設定する必要があります。

  6. eventLoopをoldDocumentの関連するエージェントのイベントループとして設定します。

  7. eventLoopの終了ネスティングレベルを1増やします。

  8. oldDocumentのアンロードカウンターを1増やします。

  9. もしintendToKeepInBfcacheがfalseであれば、oldDocumentの救済可能状態をfalseに設定します。

  10. もしoldDocumentのページ表示中がtrueであれば：

    1. oldDocumentのページ表示中をfalseに設定します。

    2. oldDocumentの救済可能状態でoldDocumentの関連するグローバルオブジェクトにページ遷移イベントを発生させます。イベント名はpagehideです。

    3. oldDocumentの可視性状態を"hidden"に更新します。

  11. もしunloadTimingInfoがnullでない場合、unloadTimingInfoのアンロードイベント開始時間をnewDocumentの関連するグローバルオブジェクトに対して現在の高解像度時間で設定し、oldDocumentの関連する設定オブジェクトのクロスオリジン分離機能に応じて粗くしたものに設定します。

  12. もしoldDocumentの回復可能状態がfalseの場合、legacy target override flagを設定して、oldDocumentの関連グローバルオブジェクトでunloadイベントを発火させます。

  13. もしunloadTimingInfoがnullでない場合、unloadTimingInfoのアンロードイベント終了時間をnewDocumentの関連するグローバルオブジェクトに対して現在の高解像度時間で設定し、oldDocumentの関連する設定オブジェクトのクロスオリジン分離機能に応じて粗くしたものに設定します。

  14. eventLoopの終了ネスティングレベルを1減らします。

  15. oldDocumentの一時停止時間をdocumentの関連するグローバルオブジェクトに対して現在の高解像度時間に設定します。

  16. oldDocumentの一時停止されたタイマーハンドルをキーの取得で得たアクティブタイマーのマップの結果に設定します。

  17. oldDocumentのユーザーによってスクロールされたをfalseに設定します。

  18. この仕様とその他の適用可能な仕様によって定義されたoldDocumentに対する文書アンロードのクリーンアップ手順を実行します。

  19. もしoldDocumentのナビゲーブルノードがトップレベルトラバーサブルであれば、oldDocumentのナビゲーブルノードを指定してトップレベルトラバーサブルとその子孫の復元されなかった理由を構築します。

  20. もしoldDocumentの救済可能状態がfalseであれば、oldDocumentを破棄します。

  21. oldDocumentのアンロードカウンターを1減らします。

  22. もしnewDocumentが指定され、newDocumentのクロスオリジンリダイレクトによって作成されたがfalseであり、newDocumentのオリジンがoldDocumentのオリジンと同じであれば、newDocumentの前の文書アンロードタイミングをunloadTimingInfoに設定します。

document、オプションでnewDocumentをnull既定値として指定し、オプションでafterAllUnloadsおよびfirePageSwapStepsの手順を指定して、文書とその子孫をアンロードするには、以下の手順を実行します。

  1. 確認: これはdocumentのナビゲーブルノードのトラバーサブルナビゲーブルのセッション履歴移動キュー内で実行されています。

  2. childNavigablesをdocumentの子ナビゲーブルとして設定します。

  3. numberUnloadedを0に設定します。

  4. childNavigableのどの順序で？のchildNavigableごとに反復して、childNavigableのアクティブウィンドウにグローバルタスクをキューに追加して、以下の手順を実行します。

    1. incrementUnloadedをnumberUnloadedを増やすアルゴリズムステップとして設定します。

    2. childNavigableのアクティブ文書、null、およびincrementUnloadedを指定して文書とその子孫をアンロードします。

  5. numberUnloadedがchildNavigableのサイズと等しくなるまで待ちます。

  6. documentの関連するグローバルオブジェクトを指定してグローバルタスクをキューに追加して、以下の手順を実行します。

    1. もしfirePageSwapStepsが指定されていれば、firePageSwapStepsを実行します。

    2. newDocumentがnullでない場合にnewDocumentを渡してdocumentをアンロードします。

    3. もしafterAllUnloadsが指定されていれば、それを実行します。

この仕様は、以下の文書アンロードのクリーンアップ手順を定義しています。他の仕様はさらに定義することができます。Document documentを指定して：

  1. windowをdocumentの関連するグローバルオブジェクトとして設定します。

  2. windowを関連するグローバルオブジェクトとして持つWebSocketオブジェクトwebSocketごとに、webSocketを消失させます。

    もしこれがWebSocketオブジェクトに影響を与えた場合、documentを指定して"websocket"を与えて文書を救済不可能にします。

  3. windowを関連するグローバルオブジェクトとして持つWebTransportオブジェクトtransportごとに、transportを指定してコンテキストのクリーンアップ手順を実行します。

  4. もしdocumentの救済可能状態がfalseであれば：

    1. windowを関連するグローバルオブジェクトとして持つEventSourceオブジェクトeventSourceごとに、eventSourceを指定して強制的に閉じます。

    2. windowのアクティブタイマーのマップを指定してクリアします。

仕様の著者がこのフックを使用する代わりに、直接仕様に呼び出しを追加するプルリクエストを送信した方が、仕様間の呼び出し順序を明確にするためにより良いでしょう。この文書を書いている時点で、以下の仕様は未定義の順序で実行される文書アンロードのクリーンアップ手順を持っていることが知られています：Fullscreen API、Web NFC、WebDriver BiDi、Compute Pressure、File API、Media Capture and Streams、Picture-in-Picture、Screen Orientation、Service Workers、WebLocks API、WebAudio API、WebRTC。[FULLSCREEN] [WEBNFC] [WEBDRIVERBIDI] [COMPUTEPRESSURE] [FILEAPI] [MEDIASTREAM] [PICTUREINPICTURE] [SCREENORIENTATION] [SW] [WEBLOCKS] [WEBAUDIO] [WEBRTC]

Issue #8906では、これらの手順の順序を明確にする作業を追跡しています。

7.5.10 文書の破棄

ドキュメントdocumentを破棄するには:

  1. 確認: これはdocumentのタスクにキューされた関連エージェントのイベントループの一部として実行されます。

  2. 文書を中止します documentを。

  3. documentの救済可能な状態をfalseに設定します。

  4. portsを、documentを関連するグローバルオブジェクトとして持つMessagePortのリストとして設定します。

  5. ports内の各portについて、ポートを切り離します。

  6. この仕様とその他の適用可能な仕様によって定義されたdocumentの文書アンロードのクリーンアップ手順を実行します。

  7. documentが関連するタスクをタスクキューから（そのタスクを実行せずに）削除します。

  8. documentのブラウジングコンテキストをnullに設定します。

  9. documentのナビゲーブルノードのアクティブなセッション履歴エントリの文書状態の文書をnullに設定します。

  10. documentを各WorkerGlobalScopeオブジェクトの所有者セットから削除します。

  11. documentのワークレットグローバルスコープ内の各workletGlobalScopeについて、ワークレットグローバルスコープを終了します。

破棄後でも、文書オブジェクト自体は、子ナビゲーブルを破棄する場合にスクリプトからアクセス可能なままであるかもしれません。

文書 documentと、オプションの手順セットafterAllDestructionを指定して、文書とその子孫を破棄するには、以下の手順を並行して実行します：

  1. もしdocumentが完全にアクティブでない場合：

    1. reason をユーザーエージェント固有のブロック理由からの文字列とします。該当するものがない場合は、reason を「マスク済み」とします。

    2. document と reason を指定して、ドキュメントを回復不能にします。

    3. document の ノードナビゲブルがトップレベルトラバーサブルである場合、document の ノードナビゲブルを指定して、トップレベルトラバーサブルとその子孫に対して復元されなかった理由を構築します。

  2. childNavigablesをdocumentの子ナビゲーブルとして設定します。

  3. numberDestroyedを0に設定します。

  4. childNavigableのどの順序で？のchildNavigableごとに、childNavigableのアクティブウィンドウを指定して、グローバルタスクをキューに追加して、以下の手順を実行します：

    1. incrementDestroyedをnumberDestroyedを増やすアルゴリズムステップとして設定します。

    2. childNavigableのアクティブ文書とincrementDestroyedを指定して、文書とその子孫を破棄します。

  5. numberDestroyedがchildNavigableのサイズと等しくなるまで待ちます。

  6. documentの関連するグローバルオブジェクトを指定して、グローバルタスクをキューに追加して、以下の手順を実行します。

    1. 文書を破棄します。

    2. もしafterAllDestructionが指定されていれば、それを実行します。

7.5.11 ドキュメントの読み込みを中止する

中止するには ドキュメント document:

  1. 確認: これは、タスクの一部として実行されています documentの関連するエージェントのイベントループにキューイングされたものです。

  2. フェッチ アルゴリズムをキャンセルします documentの文脈内で、それらのためにタスクをキューイングし、さらに 受信したデータを破棄します。これにより、フェッチ アルゴリズムがキャンセルされたり、キューイングされたタスクやネットワークデータが破棄された場合、ドキュメントを救済不能にする documentと "フェッチ"が適用されます。

  3. もしdocumentのWebDriver BiDiのロード中のナビゲーションIDがnullでない場合:

    1. document の ノードナビゲブルと、その id が document の WebDriver BiDi のロード中ナビゲーション ID であり、 status が 「canceled」であり、 url が document の URL である新しい WebDriver BiDi ナビゲーションステータスを指定して、WebDriver BiDi ナビゲーション中止を呼び出します。

    2. document の WebDriver BiDi のロード中ナビゲーション ID を null に設定します。

  4. もしdocumentがアクティブなパーサーを持っている場合:

    1. documentのアクティブなパーサーが中止されたことを trueに設定します。

    2. そのパーサーを中止します。

    3. documentの救済可能を falseに設定します。

    4. ドキュメントを救済不能にします documentと "パーサーが中止された"が適用されます。

ドキュメントとその子孫を中止するには ドキュメント document:

  1. 確認: これは、タスクの一部として実行されています documentの関連するエージェントのイベントループにキューイングされたものです。

  2. descendantNavigablesをdocumentの子孫のナビゲイブルとして設定します。

  3. それぞれ descendantNavigableの descendantNavigablesのどの順序で?、グローバルタスクをキューイングします、ナビゲーションおよびトラバーサルタスクソースが descendantNavigableのアクティブなウィンドウに対して行う 次のステップ:

    1. 中止します descendantNavigableのアクティブなドキュメント。

    2. もしdescendantNavigableのアクティブな ドキュメントの救済可能がfalseであるなら、 documentの救済可能を falseに設定します。

  4. 中止します document。

を停止します ナビゲイブル navigable:

  1. documentをnavigableのアクティブな ドキュメントとして設定します。

  2. もしdocumentのアンロードカウンターが0であり、navigableの 進行中の ナビゲーションが ナビゲーションIDである場合、 進行中の ナビゲーションを設定します navigableのためにnullにします。

    これにより、navigableの進行中のナビゲーションが中止されます、なぜならナビゲーションの特定のポイントで、進行中のナビゲーションの 変更は、さらなる作業の中止を引き起こすからです。

  3. ドキュメントとその 子孫を中止します document。

彼らのユーザーインターフェースを通じて、ユーザーエージェントもトラバーサルの停止を許可します、つまり、進行中のナビゲーションが "トラバーサル"である場合です。 上記のアルゴリズムはこれを考慮していません。（一方、 ユーザーエージェントはwindow.stop() が トラバーサルを停止することを許可していません、 そのため上記のアルゴリズムはその呼び出しに対して正しいものです。）参照issue #6905。

7.6 `X-Frame-Options` ヘッダー

Headers/X-Frame-Options

すべての現行エンジンでサポートされています。

Firefox4+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android対応Safari iOS対応Chrome Android対応WebView Android不明Samsung Internet不明Opera Android不明

「X-Frame-Options」HTTP レスポンスヘッダーは、Document が 子ナビゲブル内にロードされるかどうか、またどのようにロードされるかを制御する方法です。CSP を使用するサイトの場合、frame-ancestors ディレクティブは、同じ状況に対してより詳細な制御を提供します。これは元々 HTTP Header Field X-Frame-Options で定義されていましたが、ここでの定義と処理モデルはそのドキュメントに取って代わります。 [CSP] [RFC7034]

特に、HTTP Header Field X-Frame-Optionsは、`ALLOW-FROM` ヘッダーのバリアントを指定しましたが、これは実装しないことになっています。

以下の処理モデルによると、CSPframe-ancestors ディレクティブと `X-Frame-Options` ヘッダーが同じレスポンス内で使用された場合、 `X-Frame-Options` は無視されます。

Web開発者および適合チェッカーのために、その値ABNFは次の通りです:

X-Frame-Options = "DENY" / "SAMEORIGIN"

ナビゲーションレスポンスの`X-Frame-Options`準拠性をチェックするには、 レスポンス response、ナビゲイブル navigable、CSPリスト cspList、およびオリジン destinationOriginを与えます:

  1. もしnavigableが子ナビゲイブルでない場合、trueを返します。

  2. それぞれ cspListの policyについて:

    1. もしpolicyの処置が "enforce"でない場合は、 続行します。

    2. もしpolicyのディレクティブセットが frame-ancestors ディレクティブを含む場合、trueを返します。

  3. rawXFrameOptionsを取得し、デコードし、分割した結果として `X-Frame-Options` をresponseのヘッダーリストから取得します。

  4. xFrameOptionsを新しいセットとして設定します。

  5. それぞれのrawXFrameOptionsのvalueについて、 追加 valueを ASCII小文字に変換して、 xFrameOptionsに追加します。

  6. もしxFrameOptionsのサイズが 1を超え、 xFrameOptionsが次のいずれかを含む場合、falseを返します: "deny", "allowall", または "sameorigin"。

    ここでの意図は、`X-Frame-Options` の有効な処理を試みていたが、混乱しているように見える試みをブロックすることです。

    これは、レガシーな`ALLOWALL`値の処理モデルに与える唯一の影響です。

  7. もしxFrameOptionsのサイズが 1を超える場合、trueを返します。

    これは、複数の無効な値が含まれていることを意味し、その場合、ヘッダーが完全に省略されたかのように処理されます。

  8. もしxFrameOptions[0]が"deny"である場合、falseを返します。

  9. もしxFrameOptions[0]が"sameorigin"である場合:

    1. containerDocumentをnavigableのコンテナドキュメントとして設定します。

    2. 次の間 containerDocumentがnullでない間:

      1. もしcontainerDocumentのオリジン がdestinationOriginと同一オリジン でない場合、falseを返します。

      2. containerDocumentをcontainerDocumentのコンテナドキュメントに設定します。

  10. trueを返します。

    ここまで到達した場合、単独の無効な値（レガシーな`ALLOWALL`または`ALLOW-FROM`形式の可能性があるもの）が含まれていることになります。これらは、ヘッダーが完全に省略されたかのように処理されます。

次の表は、ヘッダーのさまざまな値の処理を示しており、不適合なものも含まれます:

`X-Frame-Options` 有効 結果
`DENY` ✅ 埋め込み不可
`SAMEORIGIN` ✅ 同一オリジンの埋め込み許可
`INVALID` ❌ 埋め込み許可
`ALLOWALL` ❌ 埋め込み許可
`ALLOW-FROM=https://example.com/` ❌ 埋め込み許可（どこからでも）

次の表は、複数の値に関わる非準拠なケースがどのように処理されるかを示しています:

`X-Frame-Options` 結果
`SAMEORIGIN, SAMEORIGIN` 同一オリジンの埋め込み許可
`SAMEORIGIN, DENY` 埋め込み不可
`SAMEORIGIN,` 埋め込み不可
`SAMEORIGIN, ALLOWALL` 埋め込み不可
`SAMEORIGIN, INVALID` 埋め込み不可
`ALLOWALL, INVALID` 埋め込み不可
`ALLOWALL,` 埋め込み不可
`INVALID, INVALID` 埋め込み許可

値がコンマ区切りの単一ヘッダーで配信されるか、複数のヘッダーで配信されるかにかかわらず、結果は同じです。

7.7 `Refresh ` ヘッダー

`Refresh ` HTTPレスポンスヘッダーは、 meta要素の http-equiv 属性がRefresh 状態にある場合と同等です。 このヘッダーは同じ値を取り、大部分で同じように動作します。 その処理モデルの詳細はドキュメントオブジェクトの作成と初期化に記載されています。

ブラウザユーザーエージェントは、ナビゲート、リロード、 および読み込み停止を行う能力を提供する必要があります。 これらは、ユーザーの最上位のトラバーサブルを 最上位のトラバーサブルセットに含むものです。

例えば、ロケーションバーやリロード/停止ボタンのUIを介して。

ブラウザユーザーエージェントは、任意の最上位のトラバーサブルを デルタでトラバースする能力を提供する必要があります。 これらはユーザーの最上位のトラバーサブルセットに含まれるものです。

例えば、戻るボタンと進むボタンを介して、長押ししてデルタを変更する能力も含まれるかもしれません。

このようなユーザーエージェントは、デルタが1を超えるトラバースを許可することを提案します。これにより、セッション履歴に無意味なエントリーを詰め込むことでユーザーを「閉じ込める」ページを回避できます。（例えば、繰り返しhistory.pushState() を呼び出したり、フラグメントナビゲーションを利用したりすることによって。）

一部のユーザーエージェントには、単一の「戻る」または「進む」ボタンの押下を、特定の悪用を克服するためにより大きなデルタに変換するヒューリスティックがあります。これらのヒューリスティックをissue #7832で仕様化することを検討しています。

ブラウザユーザーエージェントは、ユーザーに与えられたか、ユーザーエージェントによって決定された初期URLに基づいて、新しい最上位のトラバーサブルを作成する能力を提供する必要があります。

例えば、「新しいタブ」または「新しいウィンドウ」ボタンを介して。

ブラウザユーザーエージェントは、任意の最上位のトラバーサブルを 任意に閉じる能力を提供する必要があります。 これらはユーザーの最上位のトラバーサブルセットに含まれるものです。

例えば、「タブを閉じる」ボタンをクリックすることで。

ブラウザユーザーエージェントは、ナビゲイブル（最上位のトラバーサブルだけでなく）を 明示的にナビゲート、リロード、または読み込み停止させる方法を提供するかもしれません。

例えば、コンテキストメニューを介して。

ブラウザユーザーエージェントは、ユーザーに最上位のトラバーサブルを破棄する能力を提供するかもしれません。

例えば、1つ以上の最上位のトラバーサブルを含むウィンドウを強制的に閉じることで。

ユーザーがナビゲイブルのリロードを要求したとき、そのアクティブなセッション履歴エントリーのドキュメント状態のリソースがPOSTリソースである場合、ユーザーエージェントは操作を確認するようユーザーにプロンプトを表示する必要があります。そうしないと、トランザクション（例：購入やデータベースの変更）が繰り返される可能性があるためです。

ユーザーがナビゲイブルのリロードを要求したとき、ユーザーエージェントはリロード時にキャッシュを無視するメカニズムを提供するかもしれません。

上記のメカニズムによって開始されたすべてのナビゲート呼び出しは、ユーザー関与引数を"ブラウザUI"に設定する必要があります。

上記のメカニズムによって開始されたすべてのリロード呼び出しは、ユーザー関与引数を"ブラウザUI"に設定する必要があります。

上記のメカニズムによって開始されたすべての履歴をデルタでトラバースする呼び出しは、ソースドキュメント引数に値を渡してはいけません。

上記の推奨事項やこの仕様書のデータ構造は、ユーザーエージェントがセッション履歴をユーザーにどのように表現するかに制限を設けることを意図したものではありません。

例えば、最上位のトラバーサブルのセッション履歴エントリーはリストとして保存・管理されており、ユーザーエージェントにはデルタでそのリストをトラバースするインターフェースを提供することが推奨されますが、革新的なユーザーエージェントは、代わりにまたは追加でツリー状のビューを提供し、各ページが複数の「進む」ページを持ち、ユーザーが選択できるようにすることができます。

同様に、すべての子孫ナビゲイブルのセッション履歴はトラバーサブルナビゲイブルに保存されますが、ユーザーエージェントはセッション履歴をより詳細に個別のナビゲイブルビューとして表示することもできます。

ブラウザユーザーエージェントは、最上位のブラウジングコンテキストのポップアップかどうかのブール値を次の目的で使用する場合があります:

どちらの場合でも、ユーザーエージェントはユーザーの好みを組み込んだり、ポップアップルートを進むかどうかを選択する選択肢を提示するかもしれません。

このようなポップアップに対して最小限のユーザーインターフェースを提供するユーザーエージェントは、ブラウザーのロケーションバーを隠さないことが推奨されます。

8 ウェブアプリケーションAPI

8.1 スクリプティング

8.1.1 はじめに

さまざまなメカニズムにより、著者が提供する実行可能なコードがドキュメントのコンテキストで実行されることがあります。これらのメカニズムには、次のものが含まれますが、それに限定されるわけではありません:

8.1.2 エージェントとエージェントクラスター

8.1.2.1 JavaScriptエージェント形式との統合

JavaScriptは、エージェントの概念を定義しています。このセクションでは、その言語レベルの概念をウェブプラットフォームにマッピングします。

概念的には、エージェントの概念は、JavaScriptコードが実行されるアーキテクチャに依存しない理想化された「スレッド」です。このようなコードは複数のグローバル/レルムを含む可能性があり、これらは同期的に相互にアクセスできるため、単一の実行スレッドで実行される必要があります。

同じエージェントを持つ二つのWindowオブジェクトは、お互いのレルム内で作成されたすべてのオブジェクトに直接アクセスできることを意味するわけではありません。それらは同一オリジンドメインである必要があります。詳細はIsPlatformObjectSameOriginを参照してください。

ウェブプラットフォームには、次の種類のエージェントが存在します:

類似オリジンウィンドウエージェント

さまざまなWindowオブジェクトを含んでおり、これらは直接またはdocument.domainを使用して相互にアクセスできる可能性があります。

包含されるエージェントクラスターのオリジンキー付きがtrueである場合、すべてのWindowオブジェクトは同一オリジンであり、直接相互にアクセスでき、document.domainは無効になります。

同一オリジンの二つのWindowオブジェクトは、それぞれが独自のブラウジングコンテキストグループ内にある場合、別の類似オリジンウィンドウエージェント内に存在することがあります。

専用ワーカーエージェント

単一のDedicatedWorkerGlobalScopeを含みます。

共有ワーカーエージェント

単一のSharedWorkerGlobalScopeを含みます。

サービスワーカーエージェント

単一のServiceWorkerGlobalScopeを含みます。

ワークレットエージェント

単一のWorkletGlobalScopeオブジェクトを含みます。

特定のワークレットが複数のレルムを持つことがありますが、それぞれのレルムには独自のエージェントが必要です。各レルムが他のレルムと同時に独立してコードを実行できるためです。

ウェブプラットフォームでは、共有ワーカーエージェントと専用ワーカーエージェントのみが、JavaScript Atomics APIを使用して、ブロックすることが可能です。

ブロックの可能性を指定してエージェントを作成するには、次の手順を行います:

  1. signifierを新しい一意の内部値とします。

  2. candidateExecutionを新しい候補実行とします。

  3. agentを、新しいエージェントとして作成し、その[[CanBlock]]をcanBlockに設定し、[[Signifier]]をsignifierに設定し、[[CandidateExecution]]をcandidateExecutionに設定し、[[IsLockFree1]]、[[IsLockFree2]]、および[[LittleEndian]]は実装の裁量に任せます。

  4. agentのイベントループを新しいイベントループに設定します。

  5. agentを返します。

レルム realmに対して、[[Signifier]]がrealm.[[AgentSignifier]]であるエージェントがそのレルムのエージェントです。

プラットフォームオブジェクト platformObjectに対する関連エージェントは、platformObjectの関連レルムのエージェントです。

現在のレルムに相当するエージェントは、周囲のエージェントです。

8.1.2.2 JavaScriptエージェントクラスター形式との統合

JavaScriptは、エージェントクラスターの概念も定義しています。この標準は、同一オリジンのウィンドウエージェントを取得するやワーカー/ワークレットエージェントを取得するアルゴリズムを使用してエージェントを適切に配置することで、この概念をウェブプラットフォームにマッピングします。

エージェントクラスターの概念は、JavaScriptのメモリモデルを定義するために重要であり、特にどのエージェント間でSharedArrayBufferオブジェクトのバックデータが共有できるかを定義するために重要です。

概念的には、エージェントクラスターの概念は、複数の「スレッド」（エージェント）をグループ化するアーキテクチャに依存しない理想化された「プロセス境界」です。仕様で定義されるエージェントクラスターは、ユーザーエージェントに実装される実際のプロセス境界よりも一般的に制限が厳しいです。これらの理想的な区分を仕様レベルで強制することで、異なる、あるいは変化するユーザーエージェントのプロセスモデルに直面しても、ウェブ開発者が共有メモリに関して互換性のある動作を確認できるようにします。

エージェントクラスターには、クロスオリジン分離モード（クロスオリジン分離モード）が関連付けられており、最初は「なし」です。

エージェントクラスターには、関連付けられたオリジンキー付き（ブール値）があり、最初はfalseです。

以下は、エージェントクラスターの割り当てを定義しています。

エージェントクラスターキーは、サイトまたはオリジンタプルです。ウェブ開発者がオリジンキー付きエージェントクラスターを実現するためのアクションを行わない限り、それはサイトになります。

同等の表現として、エージェントクラスターキーは、スキームとホストまたはオリジンである可能性があります。

同一オリジンのウィンドウエージェントを取得するには、オリジン origin、ブラウジングコンテキストグループ group、およびブール値requestsOACが与えられた場合、次のステップを実行します:

  1. siteをoriginでサイトを取得する結果とします。

  2. keyをsiteとします。

  3. もしgroupのクロスオリジン分離モードが「なし」でない場合、keyをoriginに設定します。

  4. それ以外の場合、もしgroupの過去のエージェントクラスターキーのマップ[origin]が存在する場合、keyをgroupの過去のエージェントクラスターキーのマップ[origin]に設定します。

  5. それ以外の場合:

    1. もしrequestsOACがtrueであれば、keyをoriginに設定します。

    2. groupの過去のエージェントクラスターキーのマップ[origin]をkeyに設定します。

  6. もしgroupのエージェントクラスターのマップ[key]が存在しない場合:

    1. agentCluster を新しいエージェントクラスターとします。

    2. agentCluster の クロスオリジン分離モードを group の クロスオリジン分離モードに設定します。

    3. key がオリジンの場合：

      1. アサート：key は origin です。

      2. agentCluster の オリジンキー付きであるかを true に設定します。

    4. false を指定してエージェントを作成した結果を agentCluster に追加します。

    5. group の エージェントクラスターマップ[key] を agentCluster に設定します。

  7. groupのエージェントクラスターのマップ[key]に含まれる単一の同一オリジンのウィンドウエージェントを返します。

これにより、ブラウジングコンテキストエージェントクラスターごとに1つの同一オリジンのウィンドウエージェントのみが存在することになります。（ただし、専用ワーカーおよびワークレットエージェントは、同じクラスター内に存在する可能性があります。）

以下は、その他の種類のエージェントに対するエージェントクラスターの割り当てを定義します。

ワーカー/ワークレットエージェントを取得するには、環境設定オブジェクトまたはnullのoutside settings、ブール値isTopLevel、およびブール値canBlockが与えられた場合、次のステップを実行します:

  1. agentClusterをnullとします。

  2. もしisTopLevelがtrueであれば:

    1. agentClusterを新しいエージェントクラスターに設定します。

    2. agentClusterのオリジンキー付きをtrueに設定します。

      これらのワーカーはオリジンキー付きと見なすことができます。ただし、これは（originAgentClusterがウィンドウに対してオリジンキー付きであることを公開する方法のように）いかなるAPIを通じても公開されません。

  3. それ以外の場合:

    1. 確認: outside settingsはnullではありません。

    2. ownerAgentをoutside settingsのレルムのエージェントとします。

    3. agentClusterをownerAgentを含むエージェントクラスターに設定します。

  4. agentをcanBlockを指定してエージェントを作成する結果とします。

  5. agentをagentClusterに追加します。

  6. agentを返します。

専用/共有ワーカーエージェントを取得するには、環境設定オブジェクト outside settingsおよびブール値isSharedが与えられた場合、outside settings、isShared、およびtrueを指定してワーカー/ワークレットエージェントを取得する結果を返します。

ワークレットエージェントを取得するには、環境設定オブジェクト outside settingsが与えられた場合、outside settings、false、およびfalseを指定してワーカー/ワークレットエージェントを取得する結果を返します。

サービスワーカーエージェントを取得するには、null、true、およびfalseを指定してワーカー/ワークレットエージェントを取得する結果を返します。

次のグローバルオブジェクトのペアは、それぞれ同じエージェントクラスター内にあり、したがってSharedArrayBufferインスタンスを使用して相互にメモリを共有できます:

次のグローバルオブジェクトのペアは、同じエージェントクラスター内にはなく、したがってメモリを共有することはできません:

8.1.3 レルムとその対応物

JavaScript仕様は、レルムの概念を導入しており、これはスクリプトが実行されるグローバルな環境を表しています。各レルムには実装定義のグローバルオブジェクトが付随しており、この仕様の多くはそのグローバルオブジェクトとそのプロパティを定義することに費やされています。

ウェブ仕様においては、レルム/グローバルオブジェクトのペアに値やアルゴリズムを関連付けることがしばしば有用です。値が特定の種類のレルムに固有の場合、それらは該当するグローバルオブジェクトに直接関連付けられます。例えば、WindowやWorkerGlobalScopeインターフェースの定義においてです。値が複数のレルムで有用な場合、環境設定オブジェクトの概念を使用します。

最後に、レルム/グローバルオブジェクト/環境設定オブジェクトがまだ存在していない段階で関連する値を追跡する必要がある場合があります（例えば、ナビゲーション中）。これらの値は環境の概念で追跡されます。

8.1.3.1 環境

環境とは、現在または潜在的な実行環境（例えば、ナビゲーションパラメーターの予約された環境やリクエストの予約されたクライアント）の設定を識別するオブジェクトです。環境には次のフィールドがあります:

ID

この環境を一意に識別する不透明な文字列です。

作成URL

この環境に関連付けられたリソースの場所を表すURLです。

環境設定オブジェクトにおけるWindowの場合、このURLはDocumentのURLとは異なる場合があります。これは、history.pushState()のように後者を変更するメカニズムがあるためです。

最上位の作成URL

NULLまたは「最上位」環境の作成URLを表すURLです。ワーカーやワークレットの場合はNULLです。

最上位のオリジン

現在は実装定義の値、NULL、またはオリジンです。「最上位」の潜在的な実行環境の場合、これはNULLです（つまり、まだ応答がない場合）。それ以外の場合、これは「最上位」の環境のオリジンです。専用ワーカーやワークレットの場合、これはその作成者の最上位のオリジンです。共有ワーカーやサービスワーカーの場合、これは実装定義の値です。

これは、サンドボックス化、ワーカー、ワークレットが関与する場合、最上位の作成URLのオリジンとは異なります。

ターゲットブラウジングコンテキスト

NULLまたはナビゲーションリクエスト用のターゲットブラウジングコンテキストです。

アクティブなサービスワーカー

NULLまたはサービスワーカーであり、その環境を制御します。

実行準備フラグ

環境設定が完了したかどうかを示すフラグで、初期状態では設定されていません。

仕様では、環境に対する環境破棄ステップを定義することができます。このステップは、環境を入力として受け取ります。

環境破棄ステップは、実行準備が整うことがない環境、例えば読み込みに失敗した環境に対してのみ実行されます。

8.1.3.2 環境設定オブジェクト

環境設定オブジェクトとは、次のアルゴリズムをさらに指定する環境です:

レルム実行コンテキスト

この設定オブジェクトを使用するすべてのスクリプトが共有するJavaScript実行コンテキストであり、つまり、特定のレルム内のすべてのスクリプトが共有するものです。クラシックスクリプトを実行またはモジュールスクリプトを実行する際、この実行コンテキストがJavaScript実行コンテキストスタックの最上位に置かれ、その上にスクリプト固有の実行コンテキストがプッシュされます。（このセットアップにより、ソーステキストモジュールレコードの評価がどのレルムを使用するかを判断できます。）

モジュールマップ

JavaScriptモジュールをインポートする際に使用されるモジュールマップです。

APIベースURL

この環境設定オブジェクトを使用するスクリプトによって呼び出されるAPIがURLを解析するために使用するURLです。

オリジン

セキュリティチェックで使用されるオリジンです。

ポリシーコンテナ

セキュリティチェックで使用されるポリシーを含むポリシーコンテナです。

クロスオリジン分離能力

この環境設定オブジェクトを使用するスクリプトがクロスオリジン分離を必要とするAPIを使用できるかどうかを表すブール値です。

タイムオリジン

パフォーマンス関連のタイムスタンプの基準として使用される数値です。[HRT]

環境設定オブジェクトの責任イベントループは、そのグローバルオブジェクトの関連エージェントのイベントループです。

8.1.3.3 レルム、設定オブジェクト、およびグローバルオブジェクト

グローバルオブジェクトとは、レルムの[[GlobalObject]]フィールドであるJavaScriptオブジェクトです。

この仕様では、すべてのレルムは、Window、WorkerGlobalScope、またはWorkletGlobalScopeオブジェクトであるグローバルオブジェクトと共に作成されます。

グローバルオブジェクトには、初期状態ではfalseであるエラーレポートモードブール値があります。

グローバルオブジェクトには、通知待ちの拒否されたプロミスのリストがあり、セットは、初期状態では空のプロミスオブジェクトを含みます。このセットは、そのメンバーに対して強い参照を作成してはならず、実装は、新しいエントリが追加されるときに古いエントリを削除するなど、実装定義の方法でそのサイズを制限することができます。

グローバルオブジェクトには、通知予定の拒否されたプロミスのリストがあり、初期状態では空のプロミスオブジェクトのリストを含みます。

グローバルオブジェクトは、初期状態では空のインポートマップであるインポートマップを持ちます。

今のところ、Window グローバルオブジェクトのみが、初期の空の状態からインポートマップを変更します。インポートマップは、ルートモジュールスクリプトの解決にのみアクセスされます。

グローバルオブジェクトは、初期状態では空のセットである指定子解決レコードの解決済みモジュールセットを持ちます。

解決済みモジュールセットは、同じ（リファラー、指定子）ペアで複数回呼び出された場合に、モジュール指定子の解決が同じ結果を返すことを保証します。これは、リファラーのスコープ内の指定子に影響を与えるインポートマップルールが、最初の解決後に定義できないようにすることで行われます。今のところ、Window グローバルオブジェクトのみが、初期の空の状態からモジュールセットデータ構造を変更します。

この仕様の定義では、レルム、グローバルオブジェクト、および環境設定オブジェクトの間には常に1対1対1の対応があります:

新しいレルムを作成するには、オプションでグローバルオブジェクトまたはグローバルthisバインディング（またはその両方）の作成を指示して、エージェントagentにおいて次の手順を実行します:

  1. 提供されたグローバルオブジェクトおよびグローバルthisバインディングのカスタマイズでInitializeHostDefinedRealm()を実行します。

  2. realm execution contextを、実行中のJavaScript実行コンテキストに設定します。

    これは、前の手順で作成されたJavaScript実行コンテキストです。

  3. realm execution contextをJavaScript実行コンテキストスタックから削除します。

  4. realmをrealm execution contextのレルムコンポーネントに設定します。

  5. もしagentのエージェントクラスターのクロスオリジン分離モードが"none"である場合:

    1. globalをrealmのグローバルオブジェクトに設定します。

    2. statusを! global.[[Delete]]("SharedArrayBuffer")に設定します。

    3. Assert：statusがtrueであることを確認します。

    これはウェブコンテンツとの互換性のために行われており、将来的には削除される可能性があります。ウェブ開発者はnew WebAssembly.Memory({ shared:true, initial:0, maximum:0 }).buffer.constructorを介して依然としてコンストラクタにアクセスできます。

  6. realm execution contextを返します。

この仕様全体でアルゴリズムのステップを定義する際には、どのrealmを使用するか、または同等に、どのグローバルオブジェクトや環境設定オブジェクトを使用するかを示すことが重要です。一般的に、少なくとも4つの可能性があります。

エントリ
現在実行中のスクリプトアクションを開始したスクリプトに対応します。つまり、ユーザーエージェントが作成者コードに呼び出されたときに呼び出した関数またはスクリプトです。
インカンバント
スタック上で最も最近に入った作成者関数またはスクリプト、または現在実行中のコールバックを元々スケジュールした作成者関数またはスクリプトに対応します。
カレント
現在実行中の関数オブジェクトに対応します。これは、JavaScriptとして実装されていないかもしれない組み込みのユーザーエージェント関数も含みます。(これはカレントレルムに由来します。)
レレバント
すべてのプラットフォームオブジェクトには、関連するレルムがあり、それはおおよそそのオブジェクトが作成されたレルムに対応します。アルゴリズムを書くとき、現在実行中の関数オブジェクトのthis値など、特に重要なプラットフォームオブジェクトの関連レルムが重要になることがあります。また、引数など、他の重要な関連するレルムが存在する場合もあります。

エントリ、インカンバント、およびカレントの概念が特定の条件なしに使用できる一方で、レレバントの概念は特定のプラットフォームオブジェクトに適用される必要があることに注意してください。

インカンバントとエントリの概念は、新しい仕様では使用すべきではありません。これらは過度に複雑で直感的ではないためです。プラットフォームからほぼすべての既存の使用を削除する作業を進めています。詳細については、issue #1430（インカンバントについて）およびissue #1431（エントリについて）を参照してください。

一般に、ウェブプラットフォームの仕様は、操作されるオブジェクト（通常は現在のメソッドのthis値）に適用されるレレバントの概念を使用すべきです。これは、JavaScript仕様ではカレントが一般的にデフォルトとして使用されることとは一致しません（例：Array.prototype.mapの結果を構築する際に使用されるレルムのArrayコンストラクタを決定する場合など）。しかし、この不一致はプラットフォームに深く根付いているため、今後受け入れる必要があります。

次のページを考えてみてください。a.htmlはブラウザウィンドウにロードされ、b.htmlは示されているようにiframeにロードされ、c.htmlとd.htmlは省略されています（これらは単に空のドキュメントでも構いません）。 

<!-- a.html -->
<!DOCTYPE html>
<html lang="en">
<title>Entry page</title>

<iframe src="b.html"></iframe>
<button onclick="frames[0].hello()">Hello</button>

<!--b.html -->
<!DOCTYPE html>
<html lang="en">
<title>Incumbent page</title>

<iframe src="c.html" id="c"></iframe>
<iframe src="d.html" id="d"></iframe>

<script>
  const c = document.querySelector("#c").contentWindow;
  const d = document.querySelector("#d").contentWindow;

  window.hello = () => {
    c.print.call(d);
  };
</script>

各ページには独自のブラウジングコンテキストがあり、したがって、独自のレルム、グローバルオブジェクト、および環境設定オブジェクトがあります。

print()メソッドが a.html 内のボタンを押して呼び出された場合:

レレバントの概念が、一般的にカレントの概念よりも優れたデフォルト選択である理由の一つは、複数回返されるオブジェクトを作成するのにより適しているからです。たとえば、navigator.getBattery()メソッドは、Navigatorオブジェクトの関連するレルムでPromiseを作成します。これは次の影響を持ちます：[BATTERY]

<!-- outer.html -->
<!DOCTYPE html>
<html lang="en">
<title>Relevant realm demo: outer page</title>
<script>
  function doTest() {
    const promise = navigator.getBattery.call(frames[0].navigator);

    console.log(promise instanceof Promise);           // logs false
    console.log(promise instanceof frames[0].Promise); // logs true

    frames[0].hello();
  };

もし、getBattery()メソッドのアルゴリズムがカレントレルムを使用していた場合、すべての結果は逆になっていたでしょう。つまり、getBattery()が最初にouter.htmlで呼び出された後、inner.htmlのNavigatorオブジェクトは、outer.htmlのレルムで作成されたPromiseオブジェクトを永続的に保持し、そのため、hello()関数内の呼び出しは「間違った」レルムからのPromiseを返すことになります。これは望ましくないため、アルゴリズムは代わりに関連するレルムを使用し、コメントに示されているような適切な結果を得ています。

このセクションの残りは、エントリ、インカンバント、カレント、およびレレバントの概念を正式に定義することに関するものです。

8.1.3.3.1 エントリ

スクリプトを呼び出す過程で、レルム実行コンテキストがJavaScript実行コンテキストスタックにプッシュまたはポップされますが、これらは他の実行コンテキストと交互に行われます。

これを踏まえ、エントリ実行コンテキストを、JavaScript実行コンテキストスタックに最近プッシュされたレルム実行コンテキストと定義します。エントリレルムは、エントリ実行コンテキストのレルムコンポーネントです。

次に、エントリ設定オブジェクトは、環境設定オブジェクトのエントリレルムのことです。

同様に、エントリグローバルオブジェクトは、グローバルオブジェクトのエントリレルムです。

8.1.3.3.2 インカンバント

すべてのJavaScript実行コンテキストは、コード評価の状態の一部として、インカンバント判定時にスキップするカウンター値を含む必要があります。この値は初期状態ではゼロです。コールバックを実行する準備およびコールバックの実行後のクリーンアップの過程で、この値はインクリメントおよびデクリメントされます。

すべてのイベントループには、初期状態では空のバックアップインカンバント設定オブジェクトスタックが関連付けられています。大まかに言えば、これは、スタック上にオーサーコードが存在しない場合にインカンバント設定オブジェクトを決定するために使用されますが、オーサーコードは現在のアルゴリズムが何らかの形で実行される原因となっています。コールバックを実行する準備およびコールバックの実行後のクリーンアップの過程で、このスタックが操作されます。[WEBIDL]

Web IDLが使用されてオーサーコードを呼び出す場合、またはHostEnqueuePromiseJobがプロミスジョブを呼び出す場合、これらはインカンバント設定オブジェクトを決定するために、次のアルゴリズムを使用して関連するデータを追跡します。

環境設定オブジェクトに基づいてコールバックを実行する準備をするには、次の手順を実行します。

  1. settingsをバックアップインカンバント設定オブジェクトスタックにプッシュします。

  2. contextをトップのスクリプトを持つ実行コンテキストとして定義します。

  3. contextがnullでない場合、contextのインカンバント判定時にスキップするカウンターをインクリメントします。

環境設定オブジェクトを用いてコールバックの実行後にクリーンアップするには、次の手順を実行します。

  1. contextをトップのスクリプトを持つ実行コンテキストとして定義します。

    これは、コールバックを実行する準備の対応する呼び出し内でのトップのスクリプトを持つ実行コンテキストと同じになります。

  2. contextがnullでない場合、contextのインカンバント判定時にスキップするカウンターをデクリメントします。

  3. アサート：バックアップインカンバント設定オブジェクトスタックの最上位のエントリがsettingsです。

  4. settingsをバックアップインカンバント設定オブジェクトスタックから削除します。

ここで、トップのスクリプトを持つ実行コンテキストとは、JavaScript実行コンテキストスタックの最上位のエントリであり、nullでないScriptOrModuleコンポーネントを持つエントリ、またはJavaScript実行コンテキストスタックにそのようなエントリが存在しない場合はnullとなります。

これにより、インカンバント設定オブジェクトが次のように決定されます。

  1. contextをトップのスクリプトを持つ実行コンテキストとして定義します。

  2. contextがnullである場合、またはcontextのインカンバント判定時にスキップするカウンターがゼロより大きい場合、次の手順を実行します。

    1. アサート：バックアップインカンバント設定オブジェクトスタックが空でないこと。

      これは、スクリプトの呼び出しやWeb IDLのコールバックの呼び出しによってトリガーされなかったアルゴリズム内でインカンバント設定オブジェクトを取得しようとした場合に失敗します。たとえば、著者コードが関与していない状態でイベントループの一部として定期的に実行されたアルゴリズム内でインカンバント設定オブジェクトを取得しようとした場合、インカンバントの概念は使用できません。

    2. バックアップインカンバント設定オブジェクトスタックの最上位のエントリを返します。

  3. contextのレルムコンポーネントの設定オブジェクトを返します。

次に、インカンバントレルムは、環境設定オブジェクトのレルムです。

同様に、インカンバントグローバルオブジェクトは、グローバルオブジェクトのインカンバント設定オブジェクトです。

次の一連の例は、さまざまなメカニズムがどのようにしてインカンバントの概念の定義に貢献するかを明確にするために意図されています。

次のスターター例を考えてみましょう。

<!DOCTYPE html>
<iframe></iframe>
<script>
frames[0].postMessage("some data", "*");
</script>

ここで注目すべき環境設定オブジェクトは2つあります。1つはwindow、もう1つはframes[0]のものです。問題は、postMessage()アルゴリズムが実行されるときのインカンバント設定オブジェクトが何であるかということです。

それはwindowのものであるべきです。これは、アルゴリズムを実行する原因となった著者のスクリプトがframes[0]ではなくwindowで実行されているという直感的な考えを捉えるためです。これは理にかなっています。windowのpost message手順は、結果として生じるsourceプロパティを決定するためにincumbent設定オブジェクトを使用します。そして、この場合、メッセージのソースは間違いなくwindowです。

次に、上記の手順がどのようにして直感的に望まれるwindowの関連設定オブジェクトの結果をもたらすかを説明しましょう。

ウィンドウポストメッセージの手順がインカンバント設定オブジェクトを調べるとき、トップのスクリプトを持つ実行コンテキストは、スクリプト要素に対応するものです。これは、JavaScript実行コンテキストスタックにスクリプト評価の一部としてプッシュされました。Web IDLのコールバック呼び出しは関与していないため、このコンテキストのインカンバント判定時にスキップするカウンターはゼロであり、そのためインカンバント設定オブジェクトが決定されます。結果はwindowの環境設定オブジェクトです。

（frames[0]の環境設定オブジェクトが、postMessage()メソッドが呼び出されたときのthisの関連設定オブジェクトであることに注意してください。そして、これがメッセージのターゲットの決定に関与しています。一方で、インカンベントはソースの決定に使用されます。）

次のより複雑な例を考えてみましょう。

<!DOCTYPE html>
<iframe></iframe>
<script>
const bound = frames[0].postMessage.bind(frames[0], "some data", "*");
window.setTimeout(bound);
</script>

この例は前の例と非常に似ていますが、Function.prototype.bindやsetTimeout()による追加の間接参照があります。しかし、答えは同じであるべきです。非同期的にアルゴリズムを呼び出すことは、インカンバントの概念を変更するべきではありません。

今回は、結果はより複雑なメカニズムに関係します。

boundがWeb IDLコールバックタイプに変換されると、インカンバント設定オブジェクトはwindowに対応するものとなります（上記のスターター例と同様）。Web IDLはこれをコールバック値のコールバックコンテキストとして保存します。

setTimeout()によって投稿されたタスクが実行されると、そのタスクのアルゴリズムはWeb IDLを使用して保存されたコールバック値を呼び出します。Web IDLは、上述のコールバックを実行する準備アルゴリズムを呼び出します。これにより、保存されたコールバックコンテキストがバックアップインカンバント設定オブジェクトスタックにプッシュされます。この時点（タイマータスク内）では、スタック上にオーサーコードは存在せず、トップのスクリプトを持つ実行コンテキストはnullであり、インカンバント判定時にスキップするカウンターは何もインクリメントされません。

コールバックを呼び出すと、boundが呼び出され、それがpostMessage()メソッドをframes[0]で呼び出します。postMessage()アルゴリズムがインカンバント設定オブジェクトを調べるとき、スタック上にオーサーコードは存在せず、バウンド関数がビルトインメソッドを直接呼び出すだけです。そのため、トップのスクリプトを持つ実行コンテキストはnullになります。JavaScript実行コンテキストスタックには、postMessage()に対応する実行コンテキストしか含まれておらず、その下にはスクリプト評価コンテキストや類似のものはありません。

ここで、バックアップインカンバント設定オブジェクトスタックが利用されます。前述のように、最上位のエントリはwindowの関連設定オブジェクトであり、それがpostMessage()アルゴリズムの実行中にインカンバント設定オブジェクトとして使用されます。

最後に、さらに複雑な例を考えてみましょう。

<!-- a.html -->
<!DOCTYPE html>
<button>click me</button>
<iframe></iframe>
<script>
const bound = frames[0].location.assign.bind(frames[0].location, "https://example.com/");
document.querySelector("button").addEventListener("click", bound);
</script>
<!-- b.html -->
<!DOCTYPE html>
<iframe src="a.html"></iframe>
<script>
const iframe = document.querySelector("iframe");
iframe.onload = function onLoad() {
iframe.contentWindow.document.querySelector("button").click();
};
</script>

ここでも、2つの注目すべき環境設定オブジェクトが関わっています。1つはa.html、もう1つはb.htmlのものです。location.assign()メソッドがLocationオブジェクトのナビゲートアルゴリズムをトリガーしたとき、インカンバント設定オブジェクトは何になるのでしょうか？以前と同様、直感的にはa.htmlのものになるべきです。clickリスナーは元々a.htmlによってスケジュールされたものであり、b.htmlが関与してリスナーが発火したとしても、その責任はa.htmlにあります。

コールバックのセットアップは前の例と似ています。boundがWeb IDLコールバックタイプに変換されると、インカンバント設定オブジェクトはa.htmlに対応するものであり、これがコールバックのコールバックコンテキストとして保存されます。

click()メソッドがb.html内で呼び出されると、それはイベントをa.html内のボタンにディスパッチします。今回、イベントディスパッチの一部としてコールバックを実行する準備アルゴリズムが実行されるとき、スタック上にはオーサーコードが存在します。トップのスクリプトを持つ実行コンテキストはonLoad関数のものであり、そのインカンバント判定時にスキップするカウンターがインクリメントされます。さらに、a.htmlの環境設定オブジェクト（EventHandlerのコールバックコンテキストとして保存されている）がバックアップインカンバント設定オブジェクトスタックにプッシュされます。

さて、Locationオブジェクトのナビゲートアルゴリズムがインカンバント設定オブジェクトを調べるとき、トップのスクリプトを持つ実行コンテキストは依然としてonLoad関数のものであり（コールバックとしてバウンド関数を使用しているため）、そのインカンバント判定時にスキップするカウンターの値は1です。しかし、ここで再びバックアップインカンバント設定オブジェクトスタックにフォールバックします。これにより、予想通りa.htmlの環境設定オブジェクトが得られます。

これは、iframeがa.html内でナビゲートする場合でも、a.html自体がソースドキュメントとして使用されることを意味し、これによりリクエストクライアントなどが決定されます。これは、インカンバントの概念がWebプラットフォームで正当化される唯一のケースかもしれません。それ以外の場合、インカンバントを使用することの結果は単に混乱を招くものであり、将来的にはこれらを現在または関連に適切に切り替えることを望んでいます。

8.1.3.3.3 現在

JavaScript仕様は、現在のレルム（"current Realm Record"とも呼ばれる）を定義しています。[JAVASCRIPT]

次に、現在の設定オブジェクトは、環境設定オブジェクトの現在のレルムです。

同様に、現在のグローバルオブジェクトは、グローバルオブジェクトの現在のレルムです。

8.1.3.3.4 関連

関連レルムとは、プラットフォームオブジェクトの[[Realm]]フィールドの値です。

次に、関連設定オブジェクトとは、プラットフォームオブジェクト oの環境設定オブジェクトの、関連レルムです。

同様に、関連グローバルオブジェクトとは、プラットフォームオブジェクト oのグローバルオブジェクトの、関連レルムです。

8.1.3.4 スクリプトの有効化と無効化

スクリプトが有効とは、環境設定オブジェクト settingsに対して、以下の条件がすべて真であるときです。

スクリプトが無効とは、環境設定オブジェクトに対して、スクリプトが有効ではないとき、すなわち上記のいずれかの条件が偽であるときです。

スクリプトが有効とは、ノードnodeのノードドキュメントのブラウジングコンテキストがnullでなく、かつnodeの関連設定オブジェクトに対してスクリプトが有効であるときです。

スクリプトが無効とは、スクリプトが有効でないとき、すなわちそのノードドキュメントのブラウジングコンテキストがnullであるか、nodeの関連設定オブジェクトに対してスクリプトが無効であるときです。

8.1.3.5 セキュアなコンテキスト

環境 environmentは、次のアルゴリズムがtrueを返す場合、セキュアなコンテキストです。

  1. もしenvironmentが環境設定オブジェクトである場合:

    1. globalをenvironmentのグローバルオブジェクトとします。

    2. もしglobalがWorkerGlobalScopeである場合:

      1. もしglobalのオーナーセット[0]の関連設定オブジェクトがセキュアなコンテキストである場合、trueを返します。

        すべての項目が一貫しているはずなので、0番目の項目だけを確認すれば十分です。

      2. falseを返します。

    3. もしglobalがWorkletGlobalScopeである場合、trueを返します。

      ワークレットはセキュアなコンテキストでのみ作成できます。

  2. もしURLが潜在的に信頼できるかどうかの結果がenvironmentのトップレベルの作成URLに対して「Potentially Trustworthy」である場合、trueを返します。

  3. falseを返します。

環境がセキュアなコンテキストでない場合、それは非セキュアなコンテキストです。

8.1.4 スクリプト処理モデル

8.1.4.1 スクリプト

スクリプトは、次の2つの可能性がある構造体の一つです（具体的には、クラシックスクリプトまたはモジュールスクリプト）。すべてのスクリプトは次のものを持っています：

設定オブジェクト

同じコンテキストで他のスクリプトと共有されるさまざまな設定を含む環境設定オブジェクト。

レコード

次のいずれか：

パースエラー

JavaScript値。この値はレコードがnullである場合にのみ意味を持ち、対応するスクリプトのソーステキストがパースできなかったことを示します。

この値はスクリプト作成時の即時パースエラーを内部的に追跡するために使用され、直接使用されることはありません。代わりに、このスクリプトの「何が問題だったのか」を判断する際には再スローすべきエラーを参照してください。

再スローするエラー

評価の成功を妨げるエラーを表すJavaScript値。スクリプトを実行しようとするたびに再スローされます。

これはスクリプトのパースエラーである場合がありますが、モジュールスクリプトの場合、それはその依存関係の1つのパースエラーであるか、モジュール識別子を解決するときのエラーである場合があります。

この例外値はJavaScript仕様で提供されているため、nullになることはなく、エラーが発生していないことを示すためにnullが使用されます。

フェッチオプション
nullまたはスクリプトフェッチオプション、このスクリプトまたはそれがインポートするモジュールスクリプトのフェッチに関連するさまざまなオプションを含む。
ベースURL

nullまたはURLの基本URL。これはモジュール識別子の解決に使用されます。nullでない場合、外部スクリプトの場合はスクリプトが取得されたURL、インラインスクリプトの場合は含まれているドキュメントのドキュメントベースURLのいずれかになります。

クラシックスクリプトは、次の追加の項目を持つタイプのスクリプトです：

エラーをミュートするブール値

ブール値であり、trueの場合、このスクリプトのエラー情報は提供されません。これはクロスオリジンスクリプトのエラーをミュートするために使用され、プライベートな情報が漏れるのを防ぎます。

モジュールスクリプトは、別のタイプのスクリプトです。追加の項目はありません。

モジュールスクリプトは4つのタイプに分類できます:

CSSスタイルシートおよびJSONドキュメントは依存モジュールをインポートせず、評価時に例外をスローしないため、フェッチオプションおよびベースURLはCSSモジュールスクリプトおよびJSONモジュールスクリプトでは常にnullです。

アクティブスクリプトは、次のアルゴリズムによって決定されます：

  1. recordをGetActiveScriptOrModule()に設定します。

  2. もしrecordがnullであれば、nullを返します。

  3. recordの[[HostDefined]]を返します。

アクティブスクリプトの概念は、import()機能でのみ使用され、相対モジュール識別子を解決するために使用するベースURLを決定します。

8.1.4.2 スクリプトのフェッチ

このセクションでは、スクリプトをフェッチするためのいくつかのアルゴリズムを紹介します。これらのアルゴリズムは、さまざまな必要な入力を受け取り、クラシックスクリプトやモジュールスクリプトとして結果を生成します。

スクリプトフェッチオプションは、次の構造体を持つ構造体です:

暗号化ノンス

初回フェッチおよびインポートされたモジュールのフェッチに使用される暗号化ノンスメタデータ

インテグリティメタデータ

初回フェッチに使用されるインテグリティメタデータ

パーサメタデータ

初回フェッチおよびインポートされたモジュールのフェッチに使用されるパーサメタデータ

クレデンシャルモード

初回フェッチ（モジュールスクリプトの場合）およびインポートされたモジュールのフェッチ（モジュールスクリプトとクラシックスクリプトの両方の場合）に使用されるクレデンシャルモード

リファラーポリシー

初回フェッチおよびインポートされたモジュールのフェッチに使用されるリファラーポリシー

このポリシーは、モジュールスクリプトのレスポンスが受信された後に変化することがあります。これは、レスポンスからリファラーポリシーを解析し、モジュール依存関係をフェッチするときに使用されます。

レンダーブロッキング

初回フェッチおよびインポートされたモジュールのフェッチに使用されるレンダーブロッキングのブール値です。特に指定がない限り、その値はfalseです。

フェッチ優先度

初回フェッチに使用される優先度

「import()」機能を介して、クラシックスクリプトがモジュールスクリプトをインポートできることを思い出してください。

デフォルトのスクリプトフェッチオプションは、スクリプトフェッチオプションであり、その暗号化ノンスは空の文字列、インテグリティメタデータは空の文字列、パーサメタデータは「not-parser-inserted」、クレデンシャルモードは「same-origin」、リファラーポリシーは空の文字列、そしてフェッチ優先度は「auto」です。

次のものを与えられた場合：

クラシックスクリプトリクエストの設定

requestの暗号化ノンスメタデータをoptionsの暗号化ノンスに設定し、インテグリティメタデータをoptionsのインテグリティメタデータに設定し、パーサメタデータをoptionsのパーサメタデータに設定し、リファラーポリシーをoptionsのリファラーポリシーに設定し、レンダーブロッキングをoptionsのレンダーブロッキングに設定し、優先度をoptionsのフェッチ優先度に設定します。

モジュールスクリプトリクエストの設定

requestの暗号化ノンスメタデータをoptionsの暗号化ノンスに設定し、インテグリティメタデータをoptionsのインテグリティメタデータに設定し、パーサメタデータをoptionsのパーサメタデータに設定し、クレデンシャルモードをoptionsのクレデンシャルモードに設定し、リファラーポリシーをoptionsのリファラーポリシーに設定し、レンダーブロッキングをoptionsのレンダーブロッキングに設定し、優先度をoptionsのフェッチ優先度に設定します。

子孫スクリプトフェッチオプションを取得するためには、次の手順を実行します。

  1. newOptions を originalOptions のコピーとします。

  2. integrity を、url と settingsObject を用いてモジュール整合性メタデータを解決した結果とします。

  3. newOptions の 整合性メタデータを integrity に設定します。

  4. newOptions の フェッチ優先度を「auto」に設定します。

  5. newOptions を返します。

URL url と環境設定オブジェクト settingsObject を指定して、モジュール整合性メタデータを解決するには：

  1. map を settingsObject の グローバルオブジェクトの インポートマップとします。

  2. map の 整合性[url] が存在しない場合、空の文字列を返します。

  3. map の 整合性[url] を返します。

以下のいくつかのアルゴリズムは、フェッチフックを実行するアルゴリズムでカスタマイズできます。このアルゴリズムは、リクエスト、ブール値のisTopLevel、およびprocessCustomFetchResponseアルゴリズムを取ります。このアルゴリズムは、レスポンスとnull（失敗時）またはレスポンスボディを含むバイトシーケンスを使用してprocessCustomFetchResponseを実行します。isTopLevelは、すべてのクラシックスクリプトのフェッチ、および外部モジュールスクリプトグラフをフェッチするまたはモジュールワーカースクリプトグラフをフェッチする際の最初のフェッチでtrueになりますが、グラフ全体またはimport()式で遭遇したインポート文によるフェッチの場合はfalseです。

これらのアルゴリズム固有のカスタマイズの上に、独自のカスタマイズをレイヤリングするには、指定されたリクエストを変更し、フェッチを実行し、その後、結果となるレスポンスの特定のバリデーションを実行するフェッチフックを実行するフックを提供します（バリデーションが失敗した場合はネットワークエラーで完了します）。

このフックは、レスポンスのキャッシュを保持し、フェッチを全く行わないといった、より微妙なカスタマイズにも使用できます。

Service Workersは、フックのオプションに独自のオプションを指定してこれらのアルゴリズムを実行する例です。[SW]

では、アルゴリズム自体に移りましょう。

クラシックスクリプトをフェッチするためには、次の手順を実行します。

  1. 潜在的なCORSリクエストを作成する結果をrequestとし、url、"script"、およびcorsSettingを指定します。

  2. requestのクライアントをsettingsObjectに設定します。

  3. requestのイニシエータタイプを"script"に設定します。

  4. クラシックスクリプトリクエストの設定を実行し、requestおよびoptionsを設定します。

  5. フェッチを実行し、requestのresponseおよびnull、失敗、またはbodyBytesとしてprocessResponseConsumeBodyステップを実行します。

    responseは、CORS同一オリジンまたはCORS異なるオリジンのどちらかです。これにより、エラーレポートの方法が変わります。

    1. responseをresponseの非安全なレスポンスに設定します。

    2. 以下のいずれかがtrueである場合:

      その場合、onCompleteをnullで実行し、これらのステップを中止します。

      歴史的な理由から、このアルゴリズムには、他のスクリプトフェッチアルゴリズムとは異なり、MIMEタイプチェックが含まれていません。

    3. potentialMIMETypeForEncodingを、MIMEタイプを抽出する結果として設定し、responseのヘッダーリストを指定します。

    4. encodingを、potentialMIMETypeForEncodingおよびencodingを指定してレガシーエンコーディングを抽出する結果に設定します。

      これにより、MIMEタイプエッセンスが無視されることになります。

    5. sourceTextを、デコードする結果として設定し、bodyBytesをUnicodeにデコードし、encodingをフォールバックエンコーディングとして使用します。

      このデコードアルゴリズムは、ファイルにBOMが含まれている場合、encodingをオーバーライドします。

    6. mutedErrorsを、responseがCORS異なるオリジンであった場合はtrue、それ以外の場合はfalseに設定します。

    7. scriptをクラシックスクリプトを作成する結果として設定し、sourceText、settingsObject、responseのURL、options、mutedErrors、およびurlを指定します。

    8. onCompleteをscriptで実行します。

クラシックワーカースクリプトをフェッチするには、次の手順を実行します。

  1. requestを新しいリクエストとして設定し、そのURLをurl、クライアントをfetchClient、デスティネーションをdestination、イニシエータタイプを"other"、モードを"same-origin"、クレデンシャルモードを"same-origin"、パーサーメタデータを"not parser-inserted"、URLクレデンシャルフラグをセットします。

  2. もしperformFetchが指定されている場合は、performFetchを使用し、requestと、以下に定義するprocessResponseConsumeBodyを使って実行します。

    それ以外の場合は、フェッチを実行し、requestを使用し、processResponseConsumeBodyを以下に定義する通りに設定します。

    いずれの場合も、processResponseConsumeBodyを以下のアルゴリズムに基づいて実行します。レスポンスresponseと、null、失敗、またはバイトシーケンスbodyBytesを引数として受け取ります。

    1. responseをresponseの非安全なレスポンスに設定します。

    2. 以下のいずれかがtrueである場合:

      その場合、onCompleteをnullで実行し、これらのステップを中止します。

    3. 以下のすべてがtrueである場合:

      その場合、onCompleteをnullで実行し、これらのステップを中止します。

      他のフェッチスキームは歴史的なWeb互換性の理由でMIMEタイプのチェックから除外されています。将来的にこれを強化できるかもしれません。詳しくはissue #3255を参照してください。

    4. sourceTextを、UTF-8デコードでbodyBytesから得られる結果として設定します。

    5. scriptをクラシックスクリプトを作成する結果として設定し、sourceText、settingsObject、responseのURL、およびデフォルトのスクリプトフェッチオプションを使用します。

    6. onCompleteをscriptで実行します。

次の手順を実行して、URL url、環境設定オブジェクト settingsObject、および任意のフェッチフックを実行 performFetchを使って、クラシックワーカーインポートスクリプトをフェッチします。アルゴリズムは成功時にクラシックスクリプトを返し、失敗時には例外をスローします。

  1. responseをnullに設定します。

  2. bodyBytesをnullに設定します。

  3. requestを新しいリクエストとして設定し、そのURLをurl、クライアントをsettingsObject、デスティネーションを"script"、イニシエータタイプを"other"、パーサーメタデータを"not parser-inserted"に設定し、URLクレデンシャルフラグをセットします。

  4. もしperformFetchが指定されている場合は、performFetchを使用して、request、isTopLevel、および以下に定義するprocessResponseConsumeBodyを実行します。

    それ以外の場合は、フェッチを実行し、requestを使用し、processResponseConsumeBodyを以下に定義する通りに設定します。

    いずれの場合も、processResponseConsumeBodyを以下のアルゴリズムに基づいて実行します。レスポンスresと、null、失敗、またはバイトシーケンスbbを引数として受け取ります。

    1. bodyBytesをbbに設定します。

    2. responseをresに設定します。

  5. responseがnullでなくなるまで一時停止します。

    このアルゴリズムでは、他のセクションのアルゴリズムとは異なり、フェッチプロセスは同期的に行われます。

  6. responseをresponseの非安全なレスポンスに設定します。

  7. 次のいずれかがtrueの場合:

    その場合、"NetworkError"のDOMExceptionをスローします。

  8. sourceTextを、UTF-8デコードを使用してbodyBytesから得た結果に設定します。

  9. もしresponseがCORSクロスオリジンであればmutedErrorsをtrueに、そうでない場合はfalseに設定します。

  10. scriptを、sourceText、settingsObject、responseのURL、デフォルトスクリプトフェッチオプション、およびmutedErrorsを使ってクラシックスクリプトを作成した結果に設定します。

  11. scriptを返します。

外部モジュールスクリプトグラフを取得するために、URL url、環境設定オブジェクト settingsObject、スクリプトフェッチオプション options、およびアルゴリズム onComplete を指定して、次の手順を実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. url、settingsObject、"script"、options、settingsObject、"client"、trueを指定して、単一のモジュールスクリプトを取得します。次の手順をresultを与えて実行します。

    1. resultがnullの場合、onCompleteをnullで実行し、これらの手順を中止します。

    2. resultに対して、子孫を取得してリンクするを、settingsObject、"script"、およびonCompleteを指定して実行します。

モジュールプリロードモジュールスクリプトグラフを取得するために、URL url、宛先 destination、環境設定オブジェクト settingsObject、スクリプトフェッチオプション options、およびアルゴリズム onComplete を指定して、次の手順を実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. url、settingsObject、destination、options、settingsObject、「client」、true を指定し、result を指定した以下のステップで単一のモジュールスクリプトをフェッチします。

    1. result を指定して onComplete を実行します。

    2. アサート：settingsObject の グローバルオブジェクトは Window を実装します。

    3. result が null でない場合、オプションで settingsObject、destination、および空のアルゴリズムを指定して、result の子孫をフェッチしてリンクします。

      一般的に、このステップを実行すると、外部モジュールスクリプトグラフをフェッチするなど、グラフ全体をフェッチするアルゴリズムを介して、後で必ず要求されるモジュールをプリロードできるため、パフォーマンスに有益です。ただし、ユーザーエージェントは、帯域幅が制限されている状況や、関連するフェッチが既に進行中の状況では、これらをスキップしたい場合があります。

インラインモジュールスクリプトグラフを取得するために、文字列 sourceText、URL baseURL、環境設定オブジェクト settingsObject、スクリプトフェッチオプション options、およびアルゴリズム onComplete を指定して、次の手順を実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. sourceText、settingsObject、baseURL、およびoptionsを使用して、JavaScriptモジュールスクリプトを作成します。

  2. settingsObject、"script"、およびonCompleteを指定して、子孫を取得してリンクするを実行します。

モジュールワーカースクリプトグラフを取得するために、URL url、環境設定オブジェクト fetchClient、宛先 destination、認証モード credentialsMode、環境設定オブジェクト settingsObject、およびアルゴリズム onComplete を指定して、ワークレット/モジュールワーカースクリプトグラフを取得します。 url、fetchClient、destination、credentialsMode、settingsObject、およびonCompleteを指定します。

ワークレットスクリプトグラフを取得するために、URL url、環境設定オブジェクト fetchClient、宛先 destination、認証モード credentialsMode、環境設定オブジェクト settingsObject、モジュール応答マップ moduleResponsesMap、およびアルゴリズム onComplete を指定して、ワークレット/モジュールワーカースクリプトグラフを取得します。 url、fetchClient、destination、credentialsMode、settingsObject、onComplete、および次のフェッチフックを実行するを指定します。requestとカスタムフェッチ応答を処理する。

  1. requestのURLをrequestURLに設定します。

  2. もしmoduleResponsesMap[requestURL]が"fetching"である場合、そのエントリの値が変わるまで並列で待機し、その後タスクをキューに入れ、ネットワーキングタスクソースで以下の手順を実行します。

  3. もしmoduleResponsesMap[requestURL]が存在する場合：

    1. moduleResponsesMap[requestURL]をcachedに設定します。

    2. processCustomFetchResponseをcached[0]とcached[1]で実行します。

    3. 終了します。

  4. moduleResponsesMap[requestURL]を"fetching"に設定します。

  5. フェッチをrequestで実行し、次の手順を応答 responseおよびnull、失敗、またはバイトシーケンス bodyBytesを与えて実行します。

    1. moduleResponsesMap[requestURL]を(response、bodyBytes)に設定します。

    2. processCustomFetchResponseをresponseおよびbodyBytesで実行します。

これらのアルゴリズムは、この仕様の内部使用のみを目的としており、外部モジュールスクリプトグラフを取得するや、上記の他の類似の概念の一部として使用されるもので、他の仕様によって直接使用されるべきではありません。

この図は、これらのアルゴリズムが上記のアルゴリズムや互いにどのように関連しているかを示しています。

外部モジュールスクリプトグラフを取得する モジュールプリロードモジュールスクリプトグラフを取得する インラインモジュールスクリプトグラフを取得する モジュールワーカースクリプトグラフを取得する ワークレットスクリプトグラフを取得する ワークレット/モジュールワーカースクリプトグラフを取得する モジュールスクリプトの子孫を取得してリンクする

次の手順に従って、ワークレット/モジュールワーカースクリプトグラフを取得するために、URL url、環境設定オブジェクト fetchClient、宛先 destination、認証モード credentialsMode、環境設定オブジェクト settingsObject、アルゴリズム onComplete、およびオプションでフェッチフックを実行する performFetchを指定して、次の手順を実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. スクリプトフェッチオプションをoptionsに設定します。その暗号化ナンスは空文字列、インテグリティメタデータは空文字列、パーサーメタデータは"not-parser-inserted"、認証モードはcredentialsMode、リファラーポリシーは空文字列、そしてフェッチ優先度は"auto"です。

  2. url、fetchClient、destination、options、settingsObject、"client"、true、および以下で定義されるonSingleFetchCompleteを指定して、単一のモジュールスクリプトをフェッチします。performFetchが指定された場合、それも渡します。

    onSingleFetchCompleteはresultが与えられた場合、次のアルゴリズムです：

    1. もしresultがnullであれば、onCompleteを実行し、nullを渡してこれらの手順を中止します。

    2. fetchClient、destination、およびonCompleteを指定して、モジュールスクリプトの子孫を取得してリンクする result。performFetchが指定された場合、それも渡します。

モジュールスクリプトの子孫を取得してリンクするために、モジュールスクリプト moduleScript、環境設定オブジェクト fetchClient、宛先 destination、アルゴリズム onComplete、およびオプションでフェッチフックを実行する performFetchを指定して、次の手順を実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. moduleScriptのレコードをrecordに設定します。

  2. もしrecordがnullであれば、次の手順を実行します：

    1. moduleScriptの再スローするエラーをmoduleScriptの解析エラーに設定します。

    2. onCompleteを実行し、moduleScriptを渡します。

    3. 終了します。

  3. stateをRecord { [[ParseError]]: null, [[Destination]]: destination, [[PerformFetch]]: null, [[FetchClient]]: fetchClient } に設定します。

  4. もしperformFetchが指定された場合、state.[[PerformFetch]]をperformFetchに設定します。

  5. record.LoadRequestedModules(state)をloadingPromiseに設定します。

    この手順は、すべてのモジュールのトランジティブ依存関係を再帰的にロードします。

  6. 完了時にloadingPromiseを実行し、次の手順を実行します：

    1. record.リンク()を実行します。

      この手順は、モジュールの未リンクの依存関係すべてに再帰的にリンクを呼び出します。

      これが例外をスローした場合、それをキャッチし、その例外をmoduleScriptの再スローするエラーに設定します。

    2. onCompleteを実行し、moduleScriptを渡します。

  7. 拒否時にloadingPromiseを実行し、次の手順を実行します：

    1. もしstate.[[ParseError]]がnullでなければ、moduleScriptの再スローするエラーをstate.[[ParseError]]に設定し、onCompleteを実行してmoduleScriptを渡します。

    2. それ以外の場合、onCompleteを実行してnullを渡します。

      state.[[ParseError]]がnullの場合、loadingPromiseがロードエラーにより拒否されたことを示します。

URL url、環境設定オブジェクト fetchClient、宛先 destination、スクリプトフェッチオプション options、環境設定オブジェクト settingsObject、リファラー referrer、オプションのModuleRequest レコード moduleRequest、ブール値 isTopLevel、アルゴリズム onComplete、およびオプションのフェッチを実行するフック performFetch を指定して、単一のモジュールスクリプトをフェッチするには、これらのステップを実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. moduleType を "javascript-or-wasm" に設定します。

  2. もし moduleRequest が与えられた場合は、moduleType を、moduleRequest を引数にしてモジュールリクエストからモジュールタイプを取得するステップを実行した結果に設定します。

  3. アサート: moduleType と settingsObject を引数にしてモジュールタイプが許可されているかのステップを実行した結果が true であることを確認します。そうでない場合は、moduleRequest.[[Attributes]] を HostLoadImportedModule または 単一のインポートされたモジュールスクリプトを取得する で確認する際にエラーが発生していたはずです。

  4. moduleMap を settingsObject の モジュールマップ に設定します。

  5. もしmoduleMap[(url, moduleType)]が"fetching"である場合、それが変更されるまで並行して待機し、その後次の手順を実行するためにタスクをキューに入れます。

  6. もしmoduleMap[(url, moduleType)]が存在する場合、onCompleteを実行し、moduleMap[(url, moduleType)]を渡して返します。

  7. 設定する moduleMap[(url, moduleType)] を "fetching"に。

  8. requestを新しいリクエストとして、requestのURLはurl、モードは"cors"、参照元はreferrer、およびクライアントはfetchClientに設定します。

  9. モジュールタイプからのフェッチの宛先の手順をdestinationとmoduleTypeを渡して実行した結果をrequestの宛先に設定します。

  10. もしdestinationが"worker"、"sharedworker"、または"serviceworker"であり、isTopLevelがtrueである場合、requestのモードを"same-origin"に設定します。

  11. requestの開始者タイプを"script"に設定します。

  12. モジュールスクリプトリクエストの設定の手順をrequestとoptionsに対して実行します。

  13. もしperformFetchが与えられていた場合、request、isTopLevel、および以下で定義されるprocessResponseConsumeBodyを指定してperformFetchを実行します。

    そうでない場合は、フェッチをrequestに対してprocessResponseConsumeBodyを以下で定義されるように設定して実行します。

    どちらの場合も、processResponseConsumeBodyをresponseとしてresponseがnull、失敗、またはバイトシーケンス bodyBytesが与えられた場合、次のアルゴリズムを実行します。

    responseは常にCORS同一オリジンです。

    1. 次のいずれかが true の場合:

      その場合、セットされたmoduleMap[(url, moduleType)]を null にし、onComplete を null で実行し、これらのステップを中止します。

    2. mimeType を response の抽出した MIME タイプの結果とします。

    3. moduleScript を null に設定します。

    4. referrerPolicy を response の`Referrer-Policy` ヘッダーから解析した結果に設定します。[REFERRERPOLICY]

    5. もし referrerPolicy が空文字列でない場合は、options のリファラーポリシーを referrerPolicy に設定します。

    6. もし mimeType のエッセンスが "application/wasm" であり、moduleType が "javascript-or-wasm" の場合、moduleScript をWebAssembly モジュールスクリプトを作成する結果に設定します。引数には、bodyBytes、settingsObject、response のURL、および options を使用します。

    7. そうでない場合:

      1. sourceText を UTF-8 デコードした bodyBytes の結果とします。

      2. もし mimeType がJavaScript MIME タイプであり、moduleType が "javascript-or-wasm" の場合、moduleScript をJavaScript モジュールスクリプトを作成する結果に設定します。引数には、sourceText、settingsObject、response のURL、および options を使用します。

      3. もし mimeType のMIME タイプのエッセンスが "text/css" であり、moduleType が "css" の場合、moduleScript をCSS モジュールスクリプトを作成する結果に設定します。引数には、sourceText と settingsObject を使用します。

      4. もし mimeType がJSON MIME タイプであり、moduleType が "json" の場合、moduleScript をJSON モジュールスクリプトを作成する結果に設定します。引数には、sourceText と settingsObject を使用します。

    8. セット moduleMap[(url, moduleType)]を moduleScript にし、onComplete を moduleScript で実行します。

      モジュールマップ がリクエスト URLでキー付けされている一方で、モジュールスクリプトのベース URL がレスポンス URLに設定されるのは意図的です。前者はフェッチの重複排除に使用され、後者は URL 解決に使用されます。

URL url、環境設定オブジェクト fetchClient、宛先 destination、スクリプトフェッチオプション options、環境設定オブジェクト settingsObject、リファラー referrer、ModuleRequest レコード moduleRequest、アルゴリズム onComplete、およびオプションのフェッチを実行するフック performFetch を指定して、インポートされた単一のモジュールスクリプトをフェッチするには、これらのステップを実行します。onComplete は、null（失敗時）またはモジュールスクリプト（成功時）を受け入れるアルゴリズムでなければなりません。

  1. アサート: moduleRequest.[[Attributes]] に"type"以外のキーを持つレコードが含まれていないことを確認します。なぜなら、HostGetSupportedImportAttributesで"type"属性のみを要求したためです。

  2. moduleTypeをモジュールリクエストからのモジュールタイプの手順に従って、moduleRequestを渡して実行した結果に設定します。

  3. もしモジュールタイプの許可の手順をmoduleTypeとsettingsObjectに対して実行した結果がfalseであれば、onCompleteをnullを指定して実行し、終了します。

  4. 単一のモジュールスクリプトを取得するために、url、fetchClient、destination、options、settingsObject、referrer、moduleRequest、false、およびonCompleteを指定して実行します。もしperformFetchが与えられていた場合、それも渡します。

8.1.4.3 スクリプトの作成

クラシックスクリプトを作成するには、 文字列 source、環境設定オブジェクト settings、URL baseURL、スクリプト取得オプション options、省略可能なブール値mutedErrors（デフォルトはfalse）、 および省略可能なURL-または-nullのsourceURLForWindowScripts（デフォルトはnull）を使用します:

  1. mutedErrorsがtrueの場合、baseURLを about:blankに設定します。

    mutedErrorsがtrueの場合、baseURLはスクリプトの CORSクロスオリジンの レスポンスの URLであり、 JavaScriptに公開されるべきではありません。したがって、 baseURLはここでサニタイズされます。

  2. settingsに対してスクリプトが無効化されている 場合、sourceを空の文字列に設定します。

  3. scriptを新しいクラシックスクリプト として設定し、このアルゴリズムは後で初期化を行います。

  4. scriptの設定オブジェクト をsettingsに設定します。

  5. scriptのベースURL をbaseURLに設定します。

  6. scriptの取得オプション をoptionsに設定します。

  7. scriptのエラー抑制 をmutedErrorsに設定します。

  8. scriptの解析エラーと 再スローされるエラー をnullに設定します。

  9. クラシックスクリプト作成時間を記録する にはscriptとsourceURLForWindowScriptsを使用します。

  10. resultをParseScript(source、 settingsのrealm、 script)に設定します。

    ここでscriptを最後のパラメーターとして渡すことで、 resultの[[HostDefined]]がscriptになることを保証します。

  11. resultがエラーのリストである場合、次の処理を行います：

    1. scriptの解析エラーと 再スローされるエラー をresult[0]に設定します。

    2. scriptを返します。

  12. scriptの記録をresultに設定します。

  13. scriptを返します。

JavaScriptモジュールスクリプトを作成するには、 文字列 source、環境設定オブジェクト settings、URL baseURL、および スクリプト取得オプション optionsを使用します:

  1. settingsに対してスクリプトが無効化されている 場合、sourceを空の文字列に設定します。

  2. scriptを新しいモジュールスクリプト として設定し、このアルゴリズムは後で初期化を行います。

  3. scriptの設定オブジェクト をsettingsに設定します。

  4. scriptのベースURLを baseURLに設定します。

  5. scriptの取得オプション をoptionsに設定します。

  6. scriptの解析エラーと 再スローされるエラー をnullに設定します。

  7. resultをParseModule(source、 settingsのrealm、 script)に設定します。

    ここでscriptを最後のパラメーターとして渡すことで、 resultの[[HostDefined]]がscriptになることを保証します。

  8. resultがエラーのリストである場合、次の処理を行います：

    1. scriptの解析エラー をresult[0]に設定します。

    2. scriptを返します。

  9. scriptのレコードをresultに設定します。

  10. scriptを返します。

WebAssembly モジュールスクリプトを作成するには、バイトシーケンス bodyBytes、環境設定オブジェクト settings、URL baseURL、およびスクリプトフェッチオプション optionsが必要です:

  1. もしsettingsのスクリプトが無効である場合、bodyBytesをバイトシーケンス 0x00 0x61 0x73 0x6D 0x01 0x00 0x00 0x00 に設定します。

    このバイトシーケンスは、マジックバイトとバージョン番号だけを持つ空の WebAssembly モジュールに対応します。

  2. このアルゴリズムが初期化する新しいモジュールスクリプトをscriptに設定します。

  3. scriptの設定オブジェクトをsettingsに設定します。

  4. scriptのベース URLをbaseURLに設定します。

  5. scriptのフェッチオプションをoptionsに設定します。

  6. scriptの解析エラーおよび再スローするエラーを null に設定します。

  7. result をWebAssembly モジュールを解析して得られた結果とします。引数には、bodyBytes、settingsのレルム、およびscriptを使用します。

    ここでscriptを最後のパラメーターとして渡すことで、result.[[HostDefined]]がscriptになります。

  8. 前のステップでエラーerrorがスローされた場合、次の処理を行います:

    1. scriptの解析エラーをerrorに設定します。

    2. scriptを返します。

  9. scriptのレコードをresultに設定します。

  10. scriptを返します。

WebAssembly JavaScript インターフェイス: ESM 統合は、ECMA-262 モジュール読み込みとの WebAssembly 統合のフックを指定しています。これには、直接依存関係のインポートと、仮想化やマルチインスタンスをサポートするソースフェーズのインポートの両方のサポートが含まれます。[WASMESM]

CSSモジュールスクリプトを作成するには、 文字列sourceと環境設定オブジェクト settingsを使用します:

  1. scriptを新しいモジュールスクリプト として設定し、このアルゴリズムは後で初期化を行います。

  2. scriptの設定オブジェクト をsettingsに設定します。

  3. scriptのベースURLと 取得オプションをnullに設定します。

  4. scriptの解析エラーと 再スローされるエラー をnullに設定します。

  5. sheetを構築された CSSStyleSheetを作成する手順を実行し、 引数として空の辞書を渡して、その結果をsheetに設定します。

  6. sheetに対してCSSStyleSheetの規則を同期的に置き換える 手順を実行し、sourceを渡します。

    これが例外を投げた場合、それをキャッチし、scriptの解析エラーをその例外に設定し、 scriptを返します。

    CSSStyleSheetの規則を同期的に置き換える 手順は、sourceに@importルールが含まれている場合、例外を投げます。 これは現時点では設計によるもので、CSSモジュールスクリプトのこれらをどのように扱うかについて 合意がまだないため、合意が得られるまで完全にブロックされています。

  7. scriptの記録を、 CreateDefaultExportSyntheticModule(sheet) の結果に設定します。

  8. scriptを返します。

JSONモジュールスクリプトを作成するには、 文字列sourceと環境設定オブジェクト settingsを使用します:

  1. scriptを新しいモジュールスクリプト として設定し、このアルゴリズムは後で初期化を行います。

  2. scriptの設定オブジェクト をsettingsに設定します。

  3. scriptのベースURLと 取得オプションをnullに設定します。

  4. scriptの解析エラーと 再スローされるエラー をnullに設定します。

  5. resultをParseJSONModule(source)に設定します。

    これが例外を投げた場合、それをキャッチし、scriptの解析エラーをその例外に設定し、 scriptを返します。

  6. scriptの記録をresultに設定します。

  7. scriptを返します。

モジュールリクエストからモジュールタイプを取得するステップは、 モジュールリクエストレコード moduleRequestを与えられた場合、次の通りです:

  1. moduleType を "javascript-or-wasm" に設定します。

  2. もし moduleRequest.[[Attributes]] に、レコード entry があり、 その entry.[[Key]] が "type" である場合、次を実行します:

    1. もし entry.[[Value]] が "javascript-or-wasm" である場合、moduleType を null に設定します。

      この仕様では "javascript-or-wasm" モジュールタイプをJavaScript モジュールスクリプトやWebAssembly モジュールスクリプトに内部的に使用しているため、このステップは "javascript-or-wasm" タイプ属性を使用したモジュールのインポートを防ぐために必要です (null の moduleType は モジュールタイプが許可されているかのチェックで失敗します)。

    2. それ以外の場合、moduleType を entry.[[Value]] に設定します。

  3. moduleType を返します。

モジュールタイプが許可されているかのステップは、文字列 moduleType と環境設定オブジェクト settingsを与えられたとき、以下の手順に従います:

  1. moduleType が "javascript-or-wasm"、"css"、または "json" でない場合、false を返します。

  2. moduleType が "css" であり、CSSStyleSheetインターフェイスがsettings の 公開されていない場合は、false を返します。

  3. true を返します。

モジュールタイプからフェッチ先を決定するステップは、フェッチ先 defaultDestination と文字列 moduleTypeを与えられたとき、以下の手順に従います:

  1. もし moduleType が "json" であれば、"json" を返します。
  2. もし moduleType が "css" であれば、"style" を返します。
  3. defaultDestination を返します。
8.1.4.4 スクリプトの呼び出し

クラシックスクリプト script と省略可能なブール値rethrow errors（デフォルトはfalse）を与えられた場合、 クラシックスクリプトを実行する手順は以下の通りです:

  1. settingsをscriptの設定オブジェクト に設定します。

  2. スクリプトを実行できるか確認する にsettingsを使用します。これが「実行しない」を返した場合、 NormalCompletion(空)を返します。

  3. クラシックスクリプトの実行開始時間を記録する にscriptを使用します。

  4. スクリプトの実行準備をする にsettingsを使用します。

  5. evaluationStatusをnullに設定します。

  6. scriptの再スローされるエラー がnullでない場合、evaluationStatusをCompletion { [[Type]]: throw, [[Value]]: scriptの再スローされるエラー, [[Target]]: 空 }に設定します。

  7. それ以外の場合、evaluationStatusをScriptEvaluation(scriptの 記録) に設定します。

    ScriptEvaluation が完了しない場合、ユーザーエージェントが実行中のスクリプトを中止した ため、evaluationStatusはnullのままにします。

  8. evaluationStatusが異常終了 である場合、次の処理を行います:

    1. rethrow errorsがtrueで、scriptのエラー抑制 がfalseである場合、次の処理を行います:

      1. スクリプト実行後のクリーンアップ をsettingsで行います。

      2. evaluationStatus.[[Value]]を再スローします。

    2. rethrow errorsがtrueで、scriptのエラー抑制 がtrueである場合、次の処理を行います:

      1. スクリプト実行後のクリーンアップ をsettingsで行います。

      2. "NetworkError"の DOMException をスローします。

    3. それ以外の場合、rethrow errorsはfalseです。次のステップを実行します:

      1. 例外を報告する にevaluationStatus.[[Value]]を与え、 scriptの設定オブジェクト のグローバルオブジェクト に対して報告します。

      2. スクリプト実行後のクリーンアップ をsettingsで行います。

      3. evaluationStatusを返します。

  9. スクリプト実行後のクリーンアップ をsettingsで行います。

  10. evaluationStatusが正常終了である場合、evaluationStatusを返します。

  11. ここに到達した場合、evaluationStatusはnullのままです。これはスクリプトが評価中に中断されたためです。 Completion { [[Type]]: throw, [[Value]]: 新しい "QuotaExceededError"の DOMExceptionを返します。

モジュールスクリプト script と省略可能なブール値preventErrorReporting（デフォルトはfalse）を与えられた場合、 モジュールスクリプトを実行する手順は以下の通りです:

  1. settingsをscriptの設定オブジェクト に設定します。

  2. スクリプトを実行できるか確認する にsettingsを使用します。これが「実行しない」を返した場合、 未定義を返すプロミス を返します。

  3. モジュールスクリプトの実行開始時間を記録する にscriptを使用します。

  4. スクリプトの実行準備をする にsettingsを使用します。

  5. evaluationPromiseをnullに設定します。

  6. scriptの再スローされるエラー がnullでない場合、evaluationPromiseを再スローされるエラーで拒否されたプロミス に設定します。

  7. それ以外の場合：

    1. recordをscriptの記録に設定します。

    2. evaluationPromiseをrecord.Evaluate()に設定します。

      このステップでは、モジュールのすべての依存関係が再帰的に評価されます。

      もし、ユーザーエージェントが実行中のスクリプトを中止した結果としてEvaluateが完了しなかった場合、evaluationPromiseを新しい"QuotaExceededError" DOMExceptionで拒否されたプロミスに設定します。

  8. preventErrorReportingがfalseである場合、evaluationPromiseが reasonで拒否された際に、例外を報告する にreasonを与え、scriptの設定オブジェクト のグローバルオブジェクト に対して報告します。

  9. スクリプト実行後のクリーンアップ をsettingsで行います。

  10. evaluationPromiseを返します。

環境設定オブジェクト settingsを使用して スクリプトを実行できるか確認する 手順は以下の通りです。これらは「実行」または「実行しない」のいずれかを返します。

  1. settingsで指定されたグローバルオブジェクト がWindowオブジェクトであり、 そのDocument オブジェクトが完全にアクティブでない場合、「実行しない」を返します。

  2. settingsに対してスクリプトが無効化されている 場合、「実行しない」を返します。

  3. 「実行」を返します。

環境設定オブジェクト settingsを使用して スクリプトの実行準備をする 手順は以下の通りです:

  1. settingsのRealm実行コンテキスト をJavaScript実行コンテキストスタック にプッシュします。これが現在の実行中のJavaScript実行コンテキスト になります。

  2. settingsを周囲のエージェント のイベントループ の現在実行中のタスク のスクリプト評価環境設定オブジェクトセット に追加します。

環境設定オブジェクト settingsを使用して スクリプト実行後のクリーンアップを行う 手順は以下の通りです:

  1. アサート: settingsのRealm実行コンテキスト が現在の実行中のJavaScript実行コンテキスト であることを確認します。

  2. settingsのRealm実行コンテキスト をJavaScript実行コンテキストスタック から削除します。

  3. もしJavaScript実行コンテキストスタック が空になった場合、マイクロタスクチェックポイントを実行します。 （これがスクリプトを実行する場合、これらのアルゴリズムは再帰的に呼び出されます。）

これらのアルゴリズムは、1つのスクリプトが別のスクリプトを直接呼び出すことによってではなく、間接的に再帰的に呼び出される場合があります。例えば、スクリプトがイベントをディスパッチし、イベントリスナーが登録されている場合です。

実行中のスクリプトは、スクリプト の[[HostDefined]]フィールドにあるScriptOrModuleコンポーネントで、 実行中のJavaScript実行コンテキスト 内にあります。

8.1.4.5 スクリプトの終了

JavaScriptの仕様にはこの可能性が考慮されていませんが、時には実行中のスクリプトを中止する必要があることがあります。これにより、ScriptEvaluationやソーステキストモジュールレコードのEvaluate呼び出しが直ちに停止し、JavaScript実行コンテキストスタック が空になり、finallyブロックなどの通常のメカニズムがトリガーされません。 [JAVASCRIPT]

ユーザーエージェントは、スクリプトに対してCPUクォータ、メモリ制限、総実行時間制限、または帯域幅制限などのリソース制限を課すことがあります。スクリプトが制限を超えた場合、ユーザーエージェントは"QuotaExceededError"のDOMException を投げるか、例外を発生させずにスクリプトを中止する か、ユーザーにプロンプトを表示するか、スクリプトの実行をスロットルすることがあります。

例えば、次のスクリプトは決して終了しません。ユーザーエージェントは数秒待った後に、スクリプトを終了するか続行するかをユーザーに尋ねることができます。

<script>
  while (true) { /* loop */ }
 </script>

ユーザーエージェントは、スクリプトによって（例えばwindow.alert() APIを使用して）またはスクリプトの動作によって（例えば時間制限を超えたために）プロンプトが表示された場合に、スクリプトの無効化をユーザーに許可することが推奨されます。

スクリプトが実行中にスクリプトが無効化された場合、スクリプトは直ちに終了されるべきです。

ユーザーエージェントは、ブラウジングコンテキストを閉じる目的でスクリプトを特に無効にすることをユーザーに許可することがあります。

例えば、上記の例で述べたプロンプトでは、ユーザーにページ全体を閉じる機能を提供し、unloadイベントハンドラを実行しないようにすることもできます。

8.1.4.6 実行時スクリプトエラー

reportError

すべての現在のエンジンでサポートされています。

Firefox93+Safari15.4+Chrome95+
Opera?Edge95+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
self.reportError(e)

指定された値eに対して、グローバルオブジェクトでerrorイベントを、未処理の例外と同じ方法でディスパッチします。

exceptionがJavaScript値である場合、そのエラー情報を抽出するには次の手順を行います:

  1. attributesを、IDL属性でキーされた空のマップに設定します。

  2. attributes[error] をexceptionに設定します。

  3. attributes[message], attributes[filename], attributes[lineno], およびattributes[colno] をexceptionから派生した実装依存の値に設定します。

    ブラウザはここで指定されていない動作やJavaScript仕様に従って、通常のケースで役立つ値を収集するために動作を実装します（例えば、evalなど）。将来的には、これがより詳細に指定されるかもしれません。

  4. attributesを返します。

exceptionがJavaScript値であり、特定のグローバルオブジェクト globalと、オプションのブール値omitError（デフォルトはfalse）に対して例外を報告するには次の手順を行います:

  1. notHandledをtrueに設定します。

  2. errorInfoをexceptionからエラー情報を抽出する結果に設定します。

  3. scriptを、スクリプト内で実装依存の方法で見つけられるもの、またはnullに設定します。これは通常実行中のスクリプトであるべきです（特にクラシックスクリプトを実行する場合）。

    実装は、エラーがミュートされるかどうかを判断するために使用されるスクリプトについて、あまり一般的でないケースにおいてもまだ互換性のある動作に達していません。

  4. もしscriptがクラシックスクリプトであり、scriptのエラー抑制がtrueである場合、errorInfo[error] をnullに、errorInfo[message] を"Script error."に、errorInfo[filename] を空の文字列に、errorInfo[lineno] を0に、そしてerrorInfo[colno] を0に設定します。

  5. もしomitErrorがtrueである場合、errorInfo[error] をnullに設定します。

  6. もしglobalがエラーレポートモードでない場合、次の処理を行います:

    1. globalのエラーレポートモード をtrueに設定します。

    2. もしglobalがEventTarget を実装している場合、次の結果にnotHandledを設定します： イベントをerror という名前でglobalで発生させ、ErrorEventを使用し、 cancelable属性をtrueに初期化し、 追加の属性をerrorInfoに従って初期化します。

      イベントハンドラーでtrueを返すと、イベントハンドラー処理アルゴリズムに従ってイベントがキャンセルされます。

    3. globalのエラーレポートモード をfalseに設定します。

  7. もしnotHandledがtrueである場合、次の処理を行います:

    1. errorInfo[error] をnullに設定します。

    2. もしglobalがDedicatedWorkerGlobalScope を実装している場合、グローバルタスクをキューに入れるをDOM操作タスクソースで行い、 globalに関連付けられたWorkerの関連するグローバルオブジェクト に対して次のステップを実行します:

      1. workerObjectをWorker オブジェクトに設定します。 これはglobalに関連付けられています。

      2. notHandledをイベントを発生させる結果に設定します。 これはerror という名前でworkerObjectに対して発生させ、 ErrorEvent を使用し、cancelable属性をtrueに初期化し、 追加の属性をerrorInfoに従って初期化します。

      3. もしnotHandledがtrueである場合、次の処理を行います。 例外を報告する にはworkerObjectの関連するグローバルオブジェクト に対してomitErrorをtrueに設定して行います。

        実際のexception値は所有者のレルムで利用できませんが、ユーザーエージェントは、メッセージ、ファイル名、その他の属性を設定するのに十分な情報を引き続き保持し、開発者コンソールに報告する可能性もあります。

    3. それ以外の場合、ユーザーエージェントはexceptionを開発者コンソールに報告することができます。

もしワーカーとそのWorkerオブジェクトを接続している暗黙のポートが切断された場合（つまり、親ワーカーが終了された場合）、ユーザーエージェントはそのWorkerオブジェクトにerrorイベントハンドラーがないかのように、 またそのワーカーのonerror 属性がnullであるかのように振る舞わなければなりませんが、それ以外は上記のように振る舞わなければなりません。

したがって、エラーレポートは、専用ワーカーの連鎖に沿って、元のドキュメントまで伝播します。たとえこの連鎖の途中でいくつかのワーカーが終了され、ガベージコレクトされたとしても。

この標準の以前の改訂版では、例外を報告するアルゴリズムが定義されていました。issue #958の一環として、これが例外を報告するに置き換えられ、異なる入力を受け取り、異なる動作をします。issue #10516は、仕様エコシステムの更新を追跡しています。

reportError(e)メソッドの手順は、 例外を報告する eを thisに対して実行します。

ここでエラー抑制が適用されるかどうかは不明です。ChromeとSafariでは抑制されていますが、Firefoxでは抑制されていません。issue #958も参照してください。

ErrorEvent

すべての現在のエンジンでサポートされています。

Firefox27+Safari6+Chrome10+
Opera11+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

ErrorEventインターフェイスは以下のように定義されています:

[Exposed=*]
 interface ErrorEvent : Event {
   constructor(DOMString type, optional ErrorEventInit eventInitDict = {});
 
   readonly attribute DOMString message;
   readonly attribute USVString filename;
   readonly attribute unsigned long lineno;
   readonly attribute unsigned long colno;
   readonly attribute any error;
 };
 
 dictionary ErrorEventInit : EventInit {
   DOMString message = "";
   USVString filename = "";
   unsigned long lineno = 0;
   unsigned long colno = 0;
   any error;
 };

message 属性は、初期化された値を返さなければなりません。これはエラーメッセージを表します。

filename 属性は、初期化された値を返さなければなりません。これは、エラーが最初に発生したスクリプトのURLを表します。

lineno 属性は、初期化された値を返さなければなりません。これはスクリプト内でエラーが発生した行番号を表します。

colno 属性は、初期化された値を返さなければなりません。これはスクリプト内でエラーが発生した列番号を表します。

error 属性は、初期化された値を返さなければなりません。これは初期的にはundefinedに初期化されなければなりません。適切な場合には、エラーを表すオブジェクトに設定されます（例えば、キャッチされない例外の場合の例外オブジェクトなど）。

8.1.4.7 未処理のPromiseの拒否

Window/rejectionhandled_event

すべての現在のエンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android不明Safari iOS11.3+Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

同期的な実行時スクリプトエラーに加えて、スクリプトは非同期のPromiseの拒否を経験することがあります。これはunhandledrejection およびrejectionhandled イベントによって追跡されます。これらの拒否の追跡はHostPromiseRejectionTracker 抽象操作によって行われますが、その報告はここで定義されています。

グローバルオブジェクト globalに対して拒否されたPromiseについて通知するには:

  1. listをglobalのクローンとする通知が予定されている拒否されたPromiseリストとします。

  2. もしlistが空である ならば、 戻ります。

  3. 空にする globalの通知が予定されている拒否されたPromiseリスト。

  4. グローバルタスクをキューに入れる globalを与えて、DOM操作タスクソースに実行する次のステップを設定します:

    1. 各Promisepをlistの中で行う:

      1. もしpの[[PromiseIsHandled]]がtrueならば、続行する。

      2. notCanceledを次の結果にする:イベントを発生させることを、unhandledrejection という名前でglobalに対して行い、PromiseRejectionEvent を使用し、キャンセル可能 属性をtrueに初期化し、promise 属性をpに初期化し、reason 属性をpの[[PromiseResult]]に初期化します。

      3. もしnotCanceledがtrueであれば、ユーザーエージェントは pの[[PromiseResult]]を開発者コンソールに報告することがあります。

      4. もしpの[[PromiseIsHandled]]がfalseであるならば、追加する pをglobalの未解決の拒否されたPromiseウィークセットに追加します。

PromiseRejectionEvent

すべての現在のエンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS11.3+Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

PromiseRejectionEvent インターフェイスは以下のように定義されています:

[Exposed=*]
 interface PromiseRejectionEvent : Event {
   constructor(DOMString type, PromiseRejectionEventInit eventInitDict);
 
   readonly attribute object promise;
   readonly attribute any reason;
 };
 
 dictionary PromiseRejectionEventInit : EventInit {
   必須 object promise;
   any reason;
 };

PromiseRejectionEvent/promise

すべての現在のエンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS11.3+Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

promise 属性は、初期化された値を返さなければなりません。これは、この通知に関するPromiseを表します。

Web IDLの変換ルールによるPromise<T> 型は常に入力を新しいPromiseにラップするため、promise 属性はobject 型となっており、元のPromiseオブジェクトへの不透明なハンドルを表すのに適しています。

PromiseRejectionEvent/reason

すべての現在のエンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera不明Edge79+
Edge (Legacy)不明Internet Explorerサポートなし
Firefox Android不明Safari iOS11.3+Chrome Android不明WebView Android不明Samsung Internet不明Opera Android不明

reason 属性は、初期化された値を返さなければなりません。これは、Promiseの拒否理由を表します。

8.1.4.8 インポートマップ解析結果

インポートマップ解析結果は、構造体で、スクリプトに似ており、またscript 要素の結果に格納することができますが、 他の目的のためにスクリプトとしてカウントされません。 以下の項目を持ちます:

インポートマップ
インポートマップまたはnull。
再スローされるエラー
非nullの場合、このインポートマップを使用することを妨げるJavaScriptのエラー値。

inputという文字列とbaseURLというURLを与えて、 インポートマップの解析結果を作成するには：

  1. resultをインポートマップ解析結果 とし、そのインポートマップをnullに、 再スローされるエラーをnullにします。

  2. inputおよびbaseURLを指定して、インポートマップ文字列を解析する、例外をキャッチし、 例外が発生した場合はresultの再スローされるエラー にその例外を設定します。そうでない場合は、 resultのインポートマップに返された値を設定します。

  3. resultを返します。

Window globalおよび インポートマップ解析結果 resultを指定してインポートマップを登録するには:

  1. result の 再スローするエラーが null でない場合、global に対して result の 再スローするエラーによって与えられる例外を報告し、リターンします。

  2. global と result の インポートマップを指定して、既存のインポートマップと新しいインポートマップをマージします。

8.1.5 モジュール指定子の解決

8.1.5.1 解決アルゴリズム

モジュール指定子を解決するアルゴリズムは、 モジュール指定子文字列をURLに変換するための主要なエントリポイントです。 インポートマップが関与していない場合、 これは比較的簡単であり、URLに似たモジュール指定子を解決するに還元されます。

非空のインポートマップが存在する場合、 動作はより複雑になります。これは、すべての適用可能なモジュール指定子マップから、最も具体的なものから最も一般的なものへ、 スコープに基づいて候補エントリを確認し、 最上位のスコープされていないインポートにフォールバックし、 最も具体的なプレフィックスから最も一般的なプレフィックスへと進みます。各候補について、インポートの一致を解決するアルゴリズムが次の結果を返します:

最終的に、候補となるいずれのモジュール指定子マップでも成功しなかった場合、モジュール指定子を解決するは例外をスローします。 したがって、結果は常にURLかスローされた例外のいずれかです。

モジュール指定子を解決するには、スクリプト-または-nullなreferringScriptと、 文字列のspecifierを指定します:

  1. settingsObjectとbaseURLをnullに設定します。

  2. もしreferringScriptがnullでない場合、次の操作を行います:

    1. settingsObjectをreferringScriptの設定オブジェクトに設定します。

    2. baseURLをreferringScriptのベースURLに設定します。

  3. そうでない場合:

    1. 確認: 現在の設定オブジェクトが存在することを確認します。

    2. settingsObjectを現在の設定オブジェクトに設定します。

    3. baseURLをsettingsObjectのAPIベースURLに設定します。

  4. importMapを空のインポートマップに設定します。

  5. settingsObject の グローバルオブジェクトが Window を実装している場合、importMap を settingsObject の グローバルオブジェクトの インポートマップに設定します。

  6. serializedBaseURL を baseURL をシリアライズしたものとします。

  7. asURL を、specifier と baseURL を指定してURL のようなモジュール指定子を解決した結果とします。

  8. normalizedSpecifier を、asURL が null でない場合は asURL のシリアライズとし、そうでない場合は specifier とします。

  9. result を、初期状態では null であるURL または nullとします。

  10. importMap の スコープの各 scopePrefix → scopeImports について反復処理します。

    1. scopePrefix が serializedBaseURL であるか、または scopePrefix が U+002F (/) で終わり、かつ scopePrefix が serializedBaseURL のコードユニットプレフィックスである場合：

      1. scopeImportsMatch を、normalizedSpecifier、asURL、および scopeImports を指定してインポート一致を解決した結果とします。

      2. scopeImportsMatch が null でない場合、result を scopeImportsMatch に設定し、中断します。

  11. result が null の場合、result を normalizedSpecifier、asURL、および importMap の インポートを指定してインポート一致を解決した結果に設定します。

  12. result が null の場合、それを asURL に設定します。

    この時点で result が null の場合、specifier は importMap によって何も再マッピングされませんでしたが、URL に変換できた可能性があります。

  13. result が null でない場合：

    1. settingsObject、serializedBaseURL、normalizedSpecifier、および asURL を指定して、解決済みモジュールセットにモジュールを追加します。

    2. result を返します。

  14. specifier がベア指定子であったが、importMap によって何も再マッピングされなかったことを示す TypeError をスローします。

インポートの一致を解決するには、文字列のnormalizedSpecifier、URL-または-nullなasURL、およびモジュール指定子マップのspecifierMapを指定します:

  1. 各 specifierKey → resolutionResultをspecifierMapから取得して繰り返し処理を行います:

    1. もしspecifierKeyがnormalizedSpecifierである場合、次の操作を行います:

      1. もしresolutionResultがnullである場合、TypeErrorをスローし、specifierKeyの解決がnullエントリによってブロックされたことを示します。

        これにより、モジュール指定子を解決するアルゴリズム全体が終了し、他のフォールバックは行われません。

      2. 確認: resolutionResultはURLであることを確認します。

      3. resolutionResultを返します。

    2. 次のすべてが真である場合:

      場合、次の操作を行います:

      1. もしresolutionResultがnullである場合、TypeErrorをスローし、specifierKeyの解決がnullエントリによってブロックされたことを示します。

        これにより、モジュール指定子を解決するアルゴリズム全体が終了し、他のフォールバックは行われません。

      2. 確認: resolutionResultはURLであることを確認します。

      3. normalizedSpecifierの先頭のspecifierKeyプレフィックスの後の部分をafterPrefixとします。

      4. 確認: resolutionResultがシリアライズされ、U+002F (/)で終わることを確認します。

      5. urlを、resolutionResultでafterPrefixを指定してURL解析した結果に設定します。

      6. もしurlが失敗した場合、TypeErrorをスローし、normalizedSpecifierの解決がafterPrefix部分をspecifierKeyプレフィックスに対して相対的にURL解析できなかったためにブロックされたことを示します。

        これにより、モジュール指定子を解決するアルゴリズム全体が終了し、他のフォールバックは行われません。

      7. 確認: urlがURLであることを確認します。

      8. もしシリアライズされたresolutionResultがコードユニットプレフィックスではない場合、urlがシリアライズされ、 normalizedSpecifierの解決がspecifierKeyプレフィックスより上位にバックトラッキングしたためにブロックされたことを示す TypeErrorをスローします。

        これにより、モジュール指定子を解決するアルゴリズム全体が終了し、他のフォールバックは行われません。

      9. urlを返します。

  2. nullを返します。

    モジュール指定子を解決するアルゴリズムは、可能であれば、より一般的なスコープまたは「imports」にフォールバックします。

URLに似たモジュール指定子を解決するには、文字列のspecifierと、URLのbaseURLを指定します:

  1. もしspecifierが「/」「./」または「../」で始まる場合、次の操作を行います:

    1. urlをbaseURLを指定してspecifierのURL解析結果に設定します。

    2. もしurlが失敗した場合、nullを返します。

      このようなケースの一例として、specifierが「../foo」で、baseURLがdata:URLである場合があります。

    3. urlを返します。

    これには、specifierが「//」で始まる場合も含まれます。したがって、urlは、baseURLとは異なるホストを持つことになるかもしれません。

  2. urlを（ベースURLなしで）specifierのURL解析結果に設定します。

  3. もしurlが失敗した場合、nullを返します。

  4. urlを返します。

8.1.5.2 インポートマップ

インポートマップは、モジュール識別子の解決を制御するための機能です。インポートマップは、script要素のtype属性を「importmap」に設定し、その子テキスト内容にインポートマップのJSON表現を含めることで提供されます。

ドキュメントは複数のインポートマップを処理でき、これはモジュールがインポートされる前または後、たとえば import() 式や type 属性が「module」に設定された script 要素を介して発生する可能性があります。既存のインポートマップと新しいインポートマップをマージするアルゴリズムは、新しいインポートマップが、過去のインポートマップによって既に定義されていたモジュール、または既に解決されていたモジュールのモジュール解決を定義できないようにします。

インポートマップの最も単純な使い方は、裸のモジュール識別子をグローバルにリマップすることです。

{
"imports": {
 "moment": "/node_modules/moment/src/moment.js"
}
}

これにより、import moment from "moment";という文が機能し、/node_modules/moment/src/moment.jsのJavaScriptモジュールを取得して評価します。

インポートマップは、トレーリングスラッシュを使用して、モジュール識別子のクラスをURLのクラスにリマップすることができます。

{
"imports": {
 "moment/": "/node_modules/moment/src/"
}

これにより、import localeData from "moment/locale/zh-cn.js";という文が機能し、/node_modules/moment/src/locale/zh-cn.jsのJavaScriptモジュールを取得して評価します。このようなトレーリングスラッシュのマッピングは、裸の識別子のマッピングとよく組み合わせて使用されます。 

{
"imports": {
 "moment": "/node_modules/moment/src/moment.js",
 "moment/": "/node_modules/moment/src/"
}

これにより、「moment」で指定された「メインモジュール」と、「moment/locale/zh-cn.js」などのパスで指定された「サブモジュール」の両方が利用可能になります。

インポートマップがリマップできるモジュール識別子は、ベア識別子だけではありません。 "URLに似た"識別子、すなわち絶対URLとして解析可能なもの、または "/"、"./"、"../" で始まるものも リマップすることができます:

{
   "imports": {
     "https://cdn.example.com/vue/dist/vue.runtime.esm.js": "/node_modules/vue/dist/vue.runtime.esm.js",
     "/js/app.mjs": "/js/app-8e0d62a03.mjs",
     "../helpers/": "https://cdn.example/helpers/"
   }
 }

リマップされるURLと、リマップされるURLの両方が、絶対URLとして指定できるだけでなく、"/"、"./"、"../" で始まる相対URLとしても指定できることに注意してください。（これらの始まりのシンボルがない相対URLとしては指定できません。これらのシンボルは、ベアモジュール識別子と区別するのに役立ちます。）また、末尾のスラッシュマッピングがこの文脈でも動作することにも注意してください。

このようなリマッピングは、正規化後のURLに基づいて動作し、インポートマップキーとインポートされたモジュール識別子に指定された文字列の一致は必要ありません。したがって、例えばこのインポートマップがhttps://example.com/app.htmlに含まれている場合、import "/js/app.mjs"がリマップされるだけでなく、import "./js/app.mjs"やimport "./foo/../js/app.mjs"もリマップされます。

以前のすべての例は、インポートマップのトップレベル "imports" キーを使用して、グローバルにモジュール識別子をリマップしていました。トップレベルの "scopes" キーは、参照元のモジュールが特定のURLプレフィックスと一致する場合にのみ適用される、ローカライズされたリマッピングを提供するために使用できます。例えば:

{
   "scopes": {
     "/a/" : {
       "moment": "/node_modules/moment/src/moment.js"
     },
     "/b/" : {
       "moment": "https://cdn.example.com/moment/src/moment.js"
     }
   }
 }

このインポートマップでは、import "moment"の意味は、ステートメントを含む参照スクリプトによって異なります:

スコープの典型的な使用法は、ウェブアプリケーション内で「同じ」モジュールの複数のバージョンが存在し、モジュールグラフの一部が一方のバージョンをインポートし、他の部分が別のバージョンをインポートすることを許可することです。

スコープは互いに重なり合い、グローバル "imports" 識別子マップとも重なることができます。解決時には、最も特定的なものから最も一般的なものの順にスコープが参照されます。特定性は、コードユニットが少ない演算によってスコープを並べ替えて測定されます。したがって、例えば"/scope2/scope3/"は"/scope2/"よりも特定的であり、これはトップレベル（スコープなし）のマッピングよりも特定的と見なされます。

次のインポートマップはこれを示しています:

{
   "imports": {
     "a": "/a-1.mjs",
     "b": "/b-1.mjs",
     "c": "/c-1.mjs"
   },
   "scopes": {
     "/scope2/": {
       "a": "/a-2.mjs"
     },
     "/scope2/scope3/": {
       "b": "/b-3.mjs"
     }
   }
 }

これにより、次のような解決が行われます（簡潔さのために相対URLを使用しています）:

識別子
"a" "b" "c"
参照元 /scope1/r.mjs /a-1.mjs /b-1.mjs /c-1.mjs
/scope2/r.mjs /a-2.mjs /b-1.mjs /c-1.mjs
/scope2/scope3/r.mjs /a-2.mjs /b-3.mjs /c-1.mjs

インポートマップは、サブリソースインテグリティチェックで使用されるモジュールに対してインテグリティメタデータを提供するためにも使用できます。[SRI]

次のインポートマップはこれを示しています:

{
   "imports": {
     "a": "/a-1.mjs",
     "b": "/b-1.mjs",
     "c": "/c-1.mjs"
   },
   "integrity": {
     "/a-1.mjs": "sha384-Li9vy3DqF8tnTXuiaAJuML3ky+er10rcgNR/VqsVpcw+ThHmYcwiB1pbOxEbzJr7",
     "/d-1.mjs": "sha384-MBO5IDfYaE6c6Aao94oZrIOiC6CGiSN2n4QUbHNPhzk5Xhm0djZLQqTpL0HzTUxk"
   }
 }

上記の例は、モジュール/a-1.mjsと/d-1.mjsに対してインテグリティメタデータを提供し、後者がインポートマップ内でインポートとして定義されていなくても適用されます。

子テキストコンテンツを持つscript要素は、 インポートマップを表すものであり、 次のインポートマップの作成要件に一致しなければなりません:

有効なモジュール識別子マップは、次の要件を満たすJSONオブジェクトです:

8.1.5.3 インポートマップ処理モデル

正式には、インポートマップは、3つの構造を持つ項目です:

モジュール識別子マップは、順序付きマップであり、そのキーは文字列であり、その値はURLまたはnullです。

モジュールインテグリティマップは、順序付きマップであり、そのキーはURLであり、その値は文字列であり、インテグリティメタデータとして使用されます。

空のインポートマップとは、そのインポートマップにおいて、importsとscopesが 両方とも空のマップであるものを指します。

指定子解決レコードは、構造体です。これには以下のアイテムがあります。

シリアライズされたベース URL
指定子のベース URL を表す文字列または null（存在する場合）。
指定子
指定子を表す文字列。
URL としての指定子
URL のようなモジュール指定子の場合に URL を表すURL または null。

実装は、URL としての指定子を、指定子がベアであるか、または特別である URL のようであることを示すブール値に置き換えることができます。

環境設定オブジェクト settingsObject、文字列 serializedBaseURL、文字列 normalizedSpecifier、およびURL または null asURL を指定して、解決済みモジュールセットにモジュールを追加するには：

  1. global を settingsObject のグローバルオブジェクトとします。

  2. global が Window を実装していない場合は、リターンします。

  3. record を、シリアライズされたベース URLを serializedBaseURL に、指定子を normalizedSpecifier に、URL としての指定子を asURL に設定した新しい指定子解決レコードとします。

  4. record を global の解決済みモジュールセットに追加します。

文字列 input とURL baseURL を指定して、インポートマップ文字列を解析するには：

  1. parsedを、JSON文字列をInfra値に解析する 結果として設定します。inputを与えられます。

  2. もしparsedが順序付きマップでない場合、 次のエラーをスローします。 TypeError トップレベルの値がJSONオブジェクトである必要があることを示します。

  3. sortedAndNormalizedImportsを空の順序付きマップとして設定します。

  4. もしparsed["imports"]が存在する場合、 次の手順を実行します:

    1. もしparsed["imports"]が順序付きマップでない場合、次のエラーをスローします。TypeError "imports"トップレベルキーの値がJSONオブジェクトである必要があることを示します。

    2. sortedAndNormalizedImportsをモジュール識別子マップのソートと正規化の結果に設定します。 parsed["imports"]および baseURLを与えられます。

  5. sortedAndNormalizedScopesを空の順序付きマップとして設定します。

  6. もしparsed["scopes"]が存在する場合、 次の手順を実行します:

    1. もしparsed["scopes"]が順序付きマップでない場合、次のエラーをスローします。TypeError "scopes"トップレベルキーの値がJSONオブジェクトである必要があることを示します。

    2. sortedAndNormalizedScopesをスコープのソートと正規化の結果に設定します。parsed["scopes"]および baseURLを与えられます。

  7. normalizedIntegrityを空の順序付きマップとして設定します。

  8. もしparsed["integrity"]が存在する場合、 次の手順を実行します:

    1. もしparsed["integrity"]が順序付きマップでない場合、次のエラーをスローします。TypeError "integrity"トップレベルキーの値がJSONオブジェクトである必要があることを示します。

    2. normalizedIntegrityをモジュールインテグリティマップの正規化の結果に設定します。parsed["integrity"]および baseURLを与えられます。

  9. もしparsedのキーが、"imports"、 "scopes"、または"integrity"以外の項目を含む場合、ユーザーエージェントは、コンソールに警告を報告する必要があります。 インポートマップに無効なトップレベルキーが含まれていたことを示します。

    これにより、タイプミスを検出するのに役立ちます。エラーではありません。エラーであれば、将来的な拡張が後方互換性を持たせて追加されることを妨げるからです。

  10. 次のインポートマップを返します:インポートマップ そのimportsは sortedAndNormalizedImportsであり、 scopesは sortedAndNormalizedScopesであり、そのintegrityは normalizedIntegrityです。

このインポートマップが この解析アルゴリズムによって生成されるものは、非常に正規化されています。 例えば、https://example.com/base/page.htmlを基準URLとした場合、入力は

{
   "imports": {
     "/app/helper": "node_modules/helper/index.mjs",
     "lodash": "/node_modules/lodash-es/lodash.js"
   }
 }

次のようなインポートマップを生成します imports が 

«[
   "https://example.com/app/helper" → https://example.com/base/node_modules/helper/index.mjs
   "lodash" → https://example.com/node_modules/lodash-es/lodash.js
 ]»

そして（入力文字列には何も存在しませんが）、そのscopesには空の順序付きマップが生成されます。

モジュール指定子マップ newMap と モジュール指定子マップ oldMap を指定して、モジュール指定子マップをマージするには：

  1. mergedMap を oldMap のディープコピーとします。

  2. newMap の各 specifier → url について反復処理します：

    1. specifier が oldMap に存在する場合：

      1. ユーザーエージェントは、無視されたルールを示す警告をコンソールに報告することができます。ルールが既存のものと同一である場合は、報告を回避することを選択できます。

      2. 続行します。

    2. mergedMap[specifier] を url に設定します。

  3. mergedMap を返します。

グローバルオブジェクト global と インポートマップ newImportMap を指定して、既存のインポートマップと新しいインポートマップをマージするには：

  1. newImportMapScopes を newImportMap の スコープのディープコピーとします。

    これらのコピーを変更し、スコープ固有のルールを無視するために使用されるときにアイテムを削除します。これは newImportMapScopes と、以下の newImportMapImports にも当てはまります。

  2. oldImportMap を global の インポートマップとします。

  3. newImportMapImports を newImportMap の インポートのディープコピーとします。

  4. newImportMapScopes の各 scopePrefix → scopeImports について反復処理します：

    1. global の 解決済みモジュールセットの各 record について反復処理します：

      1. scopePrefix が record の シリアライズされたベース URLであるか、または scopePrefix が U+002F (/) で終わり、かつ scopePrefix が record の シリアライズされたベース URLのコードユニットプレフィックスである場合：

        1. scopeImports の各 specifierKey → resolutionResult について反復処理します：

          1. specifierKey が record の 指定子であるか、または 以下のすべての条件が true である場合：

            その場合：

            1. ユーザーエージェントは、無視されたルールを示す警告をコンソールに報告することができます。ルールが既存のものと同一である場合は、報告を回避することを選択できます。

            2. scopeImports[specifierKey] を削除します。

      実装者は、解決済みモジュールセットを扱う際に、より効率的なマッチングアルゴリズムを実装することが推奨されます。目安として、大規模なアプリケーションにおける解決済み/マッピング済みモジュールの数は数千のオーダーになる可能性があります。

    2. scopePrefix が oldImportMap の スコープに存在する場合、 oldImportMap の スコープ[scopePrefix] を、 scopeImports と oldImportMap の スコープ[scopePrefix] を指定してモジュール指定子マップをマージした結果に設定します。

    3. それ以外の場合、oldImportMap の スコープ[scopePrefix] を scopeImports に設定します。

  5. newImportMap の 整合性の各 url → integrity について反復処理します：

    1. url が oldImportMap の 整合性に存在する場合：

      1. ユーザーエージェントは、無視されたルールを示す警告をコンソールに報告することができます。ルールが既存のものと同一である場合は、報告を回避することを選択できます。

      2. 続行します。

    2. oldImportMap の 整合性[url] を integrity に設定します。

  6. global の 解決済みモジュールセットの各 record について反復処理します：

    1. newImportMapImports の各 specifier → url について反復処理します：

      1. specifier が record の 指定子で始まる場合：

        1. ユーザーエージェントは、無視されたルールを示す警告をコンソールに報告することができます。ルールが既存のものと同一である場合は、報告を回避することを選択できます。

        2. newImportMapImports[specifier] を削除します。

  7. oldImportMap の インポートを、 newImportMapImports と oldImportMap の インポートを指定してモジュール指定子マップをマージした結果に設定します。

上記のアルゴリズムは、新しいインポートマップを指定された環境設定オブジェクトのグローバルオブジェクトのインポートマップにマージします。いくつかの例を見てみましょう：

新しいインポートマップのルールが既存のものにマージされないケースは2つあります。

  1. 新しいインポートマップルールが、既存のインポートマップのルールとまったく同じスコープと指定子を持つ場合。これを「競合するルール」と呼びます。

  2. 新しいインポートマップルールが、既に解決済みのモジュールの解決に影響を与える可能性がある場合。これを「影響を受ける既に解決済みのモジュール」と呼びます。

新しいインポートマップに競合するルールがなく、影響を受ける解決済みのモジュールがない場合、結果のマップは新しいマップと既存のマップの組み合わせになります。個別に類似のモジュール（例：「/app/」と「/app/helper」）に影響を与えたであろうが、完全一致ではないルールは競合せず、すべてマージされたマップに含まれます。

したがって、以下の既存のインポートマップと新しいインポートマップ：

{
   "imports": {
    "/app/": "./original-app/",
  }
}
{
  "imports": {
    "/app/helper": "./helper/index.mjs"
  },
  "scopes": {
    "/js": {
      "/app/": "./js-app/"
    }
  }
}

は、以下の単一のインポートマップと同等になります：

{
  "imports": {
    "/app/": "./original-app/",
    "/app/helper": "./helper/index.mjs"
  },
  "scopes": {
    "/js": {
      "/app/": "./js-app/"
    }
  }
}

新しいインポートマップが既に解決済みのモジュールに影響を与える場合、そのルールはインポートマップから削除されます。

したがって、解決済みモジュールセットに既に「/app/helper」が含まれている場合、以下の新しいインポートマップ： 

{
   "imports": {
    "/app/helper": "./helper/index.mjs",
    "lodash": "/node_modules/lodash-es/lodash.js"
  }
}

は、以下のものと同等になります：

{
  "imports": {
    "lodash": "/node_modules/lodash-es/lodash.js"
  }
}

特定のスコープで定義された既に解決済みのモジュールに影響を与えるルールについても同様です。既に「/app/main.mjs」から「/app/helper」を解決した場合、以下の新しいインポートマップ： 

{
  "scopes": {
    "/app/": {
      "/app/helper": "./helper/index.mjs"
    }
  },
   "imports": {
    "lodash": "/node_modules/lodash-es/lodash.js"
  }
}

も同様に以下と同等になります：

{
  "imports": {
    "lodash": "/node_modules/lodash-es/lodash.js"
  }
}

また、単一の既に解決済みのモジュール指定子が、参照元のスクリプトに応じて複数の解決ルールを持つ場合もあります。そのような場合、関連するルールのみがマップに追加されません。

たとえば、既に「/app/vendor/main.mjs」から「/app/helper」を解決した場合、以下の新しいインポートマップ：

{
  "scopes": {
    "/app/": {
      "/app/helper": "./helper/index.mjs"
    },
    "/app/vendor/": {
      "/app/": "./vendor_helper/"
    },
    "/vendor/": {
      "/app/helper": "./helper/vendor_index.mjs"
    }
  },
   "imports": {
    "lodash": "/node_modules/lodash-es/lodash.js"
    "/app/": "./general_app_path/"
    "/app/helper": "./other_path/helper/index.mjs"
  }
}

は以下と同等になります：

{
  "scopes": {
    "/vendor/": {
      "/app/helper": "./helper/vendor_index.mjs"
    }
  },
  "imports": {
    "lodash": "/node_modules/lodash-es/lodash.js"
  }
}

これは、マージアルゴリズムが既に解決済みのモジュールを追跡し、それらに影響を与えるルールを新しいインポートマップから削除してから既存のものにマージするという事実によって達成されます。

新しいインポートマップが既存のインポートマップと競合するルールを持ち、影響を受ける既に解決済みのモジュールがない場合、既存のインポートマップルールが維持されます。

たとえば、以下の既存のインポートマップと新しいインポートマップ：

{
   "imports": {
    "/app/helper": "./helper/index.mjs",
    "lodash": "/node_modules/lodash-es/lodash.js"
  }
}
{
  "imports": {
    "/app/helper": "./main/helper/index.mjs"
  }
}

は、以下の単一のインポートマップと同等になります：

{
  "imports": {
    "/app/helper": "./helper/index.mjs",
    "lodash": "/node_modules/lodash-es/lodash.js",
  }
}

モジュール識別子マップのソートと正規化には、順序付きマップであるoriginalMapとURL baseURLが与えられた場合:

  1. normalizedを空の順序付きマップとして設定します。

  2. 各 specifierKey → valueの originalMapの項目を処理します。

    1. normalizedSpecifierKeyを識別子キーの正規化の結果に設定します。specifierKeyおよびbaseURLが与えられます。

    2. もしnormalizedSpecifierKeyがnullの場合は、続行します。

    3. もしvalueが文字列でない場合、次の手順を行います:

      1. ユーザーエージェントはコンソールに警告を報告 し、アドレスが文字列である必要があることを示すことができます。

      2. normalized[normalizedSpecifierKey]をnullに設定します。

      3. 続行します。

    4. addressURLをURLに似たモジュール識別子の解決の結果に設定します。valueおよびbaseURLが与えられます。

    5. もしaddressURLがnullの場合、次の手順を行います:

      1. ユーザーエージェントはコンソールに警告を報告 し、そのアドレスが無効であったことを示すことができます。

      2. normalized[normalizedSpecifierKey]をnullに設定します。

      3. 続行します。

    6. もしspecifierKeyがU+002F (/)で終わり、シリアライゼーションのaddressURL が U+002F (/)で終わらない場合、次の手順を行います:

      1. ユーザーエージェントはコンソールに警告を報告 し、 その識別子キーspecifierKeyに対して無効なアドレスが指定されたことを示すことができます。specifierKeyがスラッシュで終わるため、アドレスもスラッシュで終わる必要があります。

      2. normalized[normalizedSpecifierKey]をnullに設定します。

      3. 続行します。

    7. normalized[normalizedSpecifierKey]をaddressURLに設定します。

  3. 降順でソートされたnormalizedを返します。エントリaがエントリbより小さい場合、aのキーがコードユニットが少ない順にbのキーより小さい場合。

スコープをソートして正規化するには、 順序付きマップ originalMapとURL baseURLが与えられた場合:

  1. normalizedを空の順序付きマップとして設定します。

  2. 各 scopePrefix → potentialSpecifierMapのoriginalMapを処理します:

    1. もしpotentialSpecifierMapが順序付きマップでない場合、次のエラーをスローします。 TypeError scopePrefixで指定されたスコープの値がJSONオブジェクトである必要があることを示します。

    2. scopePrefixURLをURL パースのscopePrefixおよびbaseURLの結果として設定します。

    3. もしscopePrefixURLが失敗した場合、次の手順を行います:

      1. ユーザーエージェントは、コンソールに警告を報告し、 スコーププレフィックスのURLが解析できなかったことを示すことができます。

      2. 続行します。

    4. normalizedScopePrefixをURLのシリアライゼーションのscopePrefixURLの結果として設定します。

    5. normalized[normalizedScopePrefix]を モジュール識別子マップのソートと正規化の結果として設定します。potentialSpecifierMapおよびbaseURLを与えられます。

  3. normalizedを降順でソートした結果を返します。エントリaがエントリbより小さい場合、aのキーがコードユニットが少ない順にbのキーより小さい場合。

上記の2つのアルゴリズムでは、キーとスコープを降順にソートすることで、"foo/bar/"が"foo/"の前に来ます。これにより、モジュール識別子の解決時に"foo/bar/"が"foo/"より高い優先順位を持つことになります。

モジュールインテグリティマップを正規化するには、 順序付きマップ originalMapが与えられた場合:

  1. normalizedを空の順序付きマップとして設定します。

  2. 各 key → valueのoriginalMapを処理します:

    1. resolvedURLをURLに似たモジュール識別子の解決の結果として設定します。keyおよびbaseURLが与えられます。

      「imports」とは異なり、インテグリティマップのキーはモジュール識別子ではなくURLとして扱われます。ただし、「URLに似たモジュール識別子の解決」アルゴリズムを使用して、モジュール識別子と誤解される可能性のあるfooのような「ベア」相対URLを禁止します。

    2. もしresolvedURLがnullの場合、次の手順を行います:

      1. ユーザーエージェントは、コンソールに警告を報告 し、キーの解決に失敗したことを示すことができます。

      2. 続行します。

    3. もしvalueが文字列でない場合、次の手順を行います:

      1. ユーザーエージェントは、コンソールに警告を報告 し、インテグリティメタデータ の値は文字列でなければならないことを示すことができます。

      2. 続行します。

    4. normalized[resolvedURL]をvalueに設定します。

  3. normalizedを返します。

識別子キーを正規化するには、 文字列 specifierKeyとURL baseURLが与えられた場合:

  1. もしspecifierKeyが空文字列である場合、次の手順を行います:

    1. ユーザーエージェントは、コンソールに警告を報告 し、識別子キーが空文字列であってはならないことを示すことができます。

    2. nullを返します。

  2. urlをURLに似たモジュール識別子の解決の結果として設定します。specifierKeyおよびbaseURLが与えられます。

  3. もしurlがnullでない場合、そのURLのシリアライゼーションを返します。

  4. specifierKeyを返します。

8.1.6 JavaScript仕様のホストフック

JavaScriptの仕様には、ホスト環境に応じて異なる実装依存の抽象操作がいくつか含まれています。このセクションでは、ユーザーエージェントホストのためにそれらを定義します。

8.1.6.1 HostEnsureCanAddPrivateElement(O)

JavaScriptには、実装依存のHostEnsureCanAddPrivateElement(O) という抽象操作が含まれています。ユーザーエージェントは次の実装を使用する必要があります。[JAVASCRIPT]

  1. もしOがWindowProxy オブジェクトである場合、または実装が Location を含む場合、次の結果を返します: Completion { [[Type]]: throw, [[Value]]: 新しい TypeError }。

  2. NormalCompletion(未使用)を返します。

JavaScriptのプライベートフィールドは任意のオブジェクトに適用できます。これは、特にエキゾチックなホストオブジェクトに対する実装を非常に複雑にする可能性があるため、JavaScript言語仕様はこのフックを提供して、ホストがホスト定義の基準を満たすオブジェクトに対してプライベートフィールドを拒否できるようにしています。HTMLの場合、WindowProxy および Location は特にナビゲーションやセキュリティに関して複雑なセマンティクスを持っているため、プライベートフィールドセマンティクスの実装が困難であるため、私たちの実装では単にこれらのオブジェクトを拒否しています。

8.1.6.2 HostEnsureCanCompileStrings(realm, parameterStrings, bodyString, codeString, compilationType, parameterArgs, bodyArg)

JavaScriptには、実装依存のHostEnsureCanCompileStringsという抽象操作が含まれており、Dynamic Code Brand Checks提案によって再定義されています。ユーザーエージェントは次の実装を使用する必要があります。[JAVASCRIPT] [JSDYNAMICCODEBRANDCHECKS]

  1. ? EnsureCSPDoesNotBlockStringCompilation(realm, parameterStrings, bodyString, codeString, compilationType, parameterArgs, bodyArg)を実行します。 [CSP]

8.1.6.3 HostGetCodeForEval(argument)

Dynamic Code Brand Checks提案には、 実装依存のHostGetCodeForEval(argument)という抽象操作が含まれています。 ユーザーエージェントは次の実装を使用する必要があります。[JSDYNAMICCODEBRANDCHECKS]

  1. もしargumentがTrustedScript オブジェクトである場合、argumentのデータを返します。

  2. それ以外の場合は、コードを返しません。

8.1.6.4 HostPromiseRejectionTracker(promise, operation)

JavaScriptには、実装依存のHostPromiseRejectionTracker(promise, operation)という抽象操作が含まれています。ユーザーエージェントは次の実装を使用する必要があります。 [JAVASCRIPT]

  1. scriptを実行中のスクリプトとして設定します。

  2. もしscriptがクラシックスクリプト であり、scriptのエラーがミュートされている場合は、処理を終了します。

  3. settingsObjectを現在の設定オブジェクトとして設定します。

  4. もしscriptがnullでない場合、settingsObjectをscriptの設定オブジェクトに設定します。

  5. globalをsettingsObjectのグローバルオブジェクトとして設定します。

  6. もしoperationが"reject"の場合、次の手順を行います:

    1. promiseをglobalの通知予定の拒否されたプロミスリストに追加します。

  7. もしoperationが"handle"の場合、次の手順を行います:

    1. もしglobalの通知予定の拒否されたプロミスリストがpromiseを含む場合、そのリストからpromiseを削除し、処理を終了します。

    2. もしglobalの未処理の拒否されたプロミスの弱集合がpromiseを含まない場合、処理を終了します。

    3. promiseをglobalの未処理の拒否されたプロミスの弱集合から削除します。

    4. globalに対してイベントを発火するために、グローバルタスクをキューに追加します。イベント名はrejectionhandled で、PromiseRejectionEvent を使用し、promise 属性をpromiseで初期化し、reason 属性をpromiseの[[PromiseResult]]で初期化します。

8.1.6.5 HostSystemUTCEpochNanoseconds(global)

Temporal提案には、実装依存のHostSystemUTCEpochNanosecondsという抽象操作が含まれています。 ユーザーエージェントは次の実装を使用する必要があります。[JSTEMPORAL]

  1. settingsObjectをglobalの関連する設定オブジェクトとして設定します。

  2. timeをsettingsObjectの現在の壁時計時刻として設定します。

  3. nsをUnix エポックからtimeまでのナノ秒数として設定し、最も近い整数に丸めます。

  4. nsをclampingして、nsMinInstantとnsMaxInstantの間に収めた結果を返します。

8.1.6.6 ジョブ関連のホストフック

Reference/Global_Objects/Promise#Incumbent_settings_object_tracking

1つのエンジンのみでサポートされています。

Firefox50+SafariいいえChromeいいえ
Opera？Edgeいいえ
Edge (Legacy)？Internet Explorerいいえ
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

JavaScript仕様は、ホストによってスケジュールされ、後で実行されるジョブおよび、ジョブの一部として呼び出されるJavaScript関数をカプセル化するJobCallback Recordsを定義しています。JavaScript仕様には、ジョブがどのようにスケジュールされるか、JobCallbacksがどのように処理されるかをホストが定義できる多くの実装依存抽象操作が含まれています。HTMLはこれらの抽象操作を使用して、Promise内のインカンベント設定オブジェクトおよびFinalizationRegistryのコールバックを追跡するために、JobCallbacks内のインカンベント設定オブジェクトおよびJavaScript実行コンテキストを保存および復元します。このセクションでは、ユーザーエージェントホストのためにそれらを定義します。

8.1.6.6.1 HostCallJobCallback(callback, V, argumentsList)

JavaScriptには、実装依存のHostCallJobCallback(callback, V, argumentsList)という抽象操作が含まれており、ホストがタスク内からJavaScriptコールバックを呼び出す際に状態を復元できるようにしています。ユーザーエージェントは次の実装を使用する必要があります: [JAVASCRIPT]

  1. incumbent settingsをcallback.[[HostDefined]].[[IncumbentSettings]]として設定します。

  2. script execution contextをcallback.[[HostDefined]].[[ActiveScriptContext]]として設定します。

  3. コールバックを実行する準備をする際にincumbent settingsを使用します。

    これは、コールバックが実行されている間に、現職の概念に影響を与えます。

  4. もしscript execution contextがnullでない場合、JavaScript実行コンテキストスタックにscript execution contextをプッシュします。

    これは、コールバックが実行されている間に、アクティブスクリプトに影響を与えます。

  5. resultをCall(callback.[[Callback]], V, argumentsList)の結果として設定します。

  6. もしscript execution contextがnullでない場合、JavaScript実行コンテキストスタックからscript execution contextをポップします。

  7. コールバック実行後のクリーンアップをincumbent settingsを使用して行います。

  8. resultを返します。

8.1.6.6.2 HostEnqueueFinalizationRegistryCleanupJob(finalizationRegistry)

JavaScriptには、FinalizationRegistryオブジェクトにオブジェクトを登録し、それらがガベージコレクションされた場合にクリーンアップアクションをスケジュールする機能があります。JavaScript仕様には、実装依存のHostEnqueueFinalizationRegistryCleanupJob(finalizationRegistry)という抽象操作が含まれており、クリーンアップアクションをスケジュールします。

クリーンアップ作業のタイミングと発生は、JavaScript仕様内で実装依存です。ユーザーエージェントは、オブジェクトがガベージコレクションされる時期や、WeakRef.prototype.deref()メソッドの戻り値が未定義かどうか、FinalizationRegistryのクリーンアップコールバックが発生するかどうかに影響を与える可能性があります。人気のあるウェブブラウザでは、JavaScriptでアクセスできないオブジェクトが、ガベージコレクタによって無期限に保持されるというよく知られたケースがあります。HTMLは、マイクロタスクチェックポイントの実行アルゴリズムで、WeakRefオブジェクトをクリアします。作成者は、ガベージコレクション実装のタイミングの詳細に依存しない方が良いでしょう。

クリーンアップアクションは、同期的なJavaScriptの実行と交互には行われず、キューに追加されたタスク内で実行されます。ユーザーエージェントは次の実装を使用する必要があります: [JAVASCRIPT]

  1. globalをfinalizationRegistry.[[Realm]]のグローバルオブジェクトとして設定します。

  2. globalに対して次の手順を実行するために、JavaScriptエンジンタスクソースにグローバルタスクをキューに追加します。

    1. entryをfinalizationRegistry.[[CleanupCallback]].[[Callback]].[[Realm]]の環境設定オブジェクトとして設定します。

    2. entryでスクリプトを実行できるかどうか確認します。これが「実行しない」を返した場合、処理を終了します。

    3. entryでスクリプトを実行する準備をします。

      これは、クリーンアップコールバックが実行されている間に、entryの概念に影響を与えます。

    4. resultをfinalizationRegistryのCleanupFinalizationRegistryを実行した結果として設定します。

    5. entryを使用してスクリプト実行後のクリーンアップを行います。

    6. もしresultが急な完了である場合、globalに対してresult.[[Value]]で与えられた例外を報告します。

8.1.6.6.3 HostEnqueueGenericJob(job, realm)

JavaScriptには、特定のレルム内で汎用ジョブを実行するための実装依存のHostEnqueueGenericJob(job, realm)という抽象操作が含まれています（例: Atomics.waitAsyncから生じるPromiseを解決するためのジョブ）。 ユーザーエージェントは次の実装を使用する必要があります: [JAVASCRIPT]

  1. globalをrealmのグローバルオブジェクトとして設定します。

  2. globalに対してjob()を実行するために、グローバルタスクをキューに追加します。

8.1.6.6.4 HostEnqueuePromiseJob(job, realm)

JavaScriptには、Promise関連の操作をスケジュールするための実装依存のHostEnqueuePromiseJob(job, realm)という抽象操作が含まれています。HTMLはこれらの操作をマイクロタスクキューにスケジュールします。ユーザーエージェントは次の実装を使用する必要があります: [JAVASCRIPT]

  1. もしrealmがnullでない場合、job settingsをrealmの設定オブジェクトとして設定します。それ以外の場合、job settingsをnullとして設定します。

    もしrealmがnullでない場合、それは実行される著者コードのレルムです。jobがNewPromiseReactionJobによって返される場合、それはPromiseのハンドラ関数のレルムです。jobがNewPromiseResolveThenableJobによって返される場合、それはthen関数のレルムです。

    もしrealmがnullである場合、著者コードが実行されないか、または著者コードが必ず例外を投げることが保証されます。前者の場合、著者が実行するコードを渡さなかった可能性があり、例えばpromise.then(null, null)のようなケースです。後者の場合、それは取り消されたProxyが渡されたためです。いずれの場合も、以下のステップでjob settingsが使用されるべきステップがスキップされます。

    NewPromiseResolveThenableJobとNewPromiseReactionJobは、取り消されたプロキシの場合に非nullレルム（現在のレルムレコード）を提供するようです。前述のテキストはそれを反映するように更新される可能性があります。

  2. job()を実行するために、マイクロタスクをキューに追加します。

    1. もしjob settingsがnullでない場合、スクリプトを実行できるかどうか確認します。これが「実行しない」を返した場合、処理を終了します。

    2. もしjob settingsがnullでない場合、スクリプトを実行する準備をします。

      これは、ジョブが実行される間、entryの概念に影響を与えます。

    3. resultをjob()の結果として設定します。

      jobは、抽象クロージャであり、NewPromiseReactionJobまたはNewPromiseResolveThenableJobによって返されます。jobがNewPromiseReactionJobによって返される場合、Promiseのハンドラ関数、およびjobがNewPromiseResolveThenableJobによって返される場合、then関数はJobCallback Records内にラップされます。HTMLは現職の設定オブジェクトおよびJavaScript実行コンテキストをHostMakeJobCallback内で保存し、HostCallJobCallback内でそれらを復元します。

    4. もしjob settingsがnullでない場合、スクリプト実行後のクリーンアップを行います。

    5. もしresultが急な完了である場合、realmのグローバルオブジェクトに対して、result.[[Value]]によって与えられた例外を報告します。

      HostEnqueuePromiseJobがnullレルム（例: Promise.prototype.thenがnullハンドラで呼び出された場合）で呼び出されるが、ジョブが急に終了する場合（Promise capabilityのresolveまたはrejectハンドラが例外をスローしたため、その後、このクラスが供給された関数をラップしてからPromiseスーパークラスコンストラクタに渡す）、どのグローバルが使用されるかについては非常に難しいケースがあります。この場合、現在のレルムが各ステップで異なる可能性があります（別のレルムからPromiseコンストラクタまたはPromise.prototype.thenを使用する場合）。このような場合、どのグローバルが使用されるかについては、issue #10526を参照してください。

8.1.6.6.5 HostEnqueueTimeoutJob(job, realm, milliseconds)

JavaScriptには、タイムアウト後に実行される操作をスケジュールするための実装依存のHostEnqueueTimeoutJob(job, milliseconds)という抽象操作が含まれています。HTMLはこれらの操作をタイムアウト後のステップの実行を使用してスケジュールします。 ユーザーエージェントは次の実装を使用する必要があります: [JAVASCRIPT]

  1. globalをrealmのグローバルオブジェクトとして設定します。

  2. timeoutStepを、globalに対してjob()を実行するためにグローバルタスクをキューに追加するアルゴリズムステップとして設定します。

  3. global、「JavaScript」、milliseconds、およびtimeoutStepを与えて、タイムアウト後のステップを実行します。

8.1.6.6.6 HostMakeJobCallback(callable)

JavaScriptには、実装依存のHostMakeJobCallback(callable)という抽象操作が含まれており、 ホストがタスク内から呼び出されるJavaScriptコールバックに状態を付与できるようにします。ユーザーエージェントは次の実装を使用する必要があります: [JAVASCRIPT]

  1. incumbent settingsを現職の設定オブジェクトとして設定します。

  2. active scriptをアクティブスクリプトとして設定します。

  3. script execution contextをnullとして設定します。

  4. もしactive scriptがnullでない場合、新しいJavaScript実行コンテキストを設定し、 そのFunctionフィールドをnullに、Realmフィールドをactive scriptの設定オブジェクトのレルムに、ScriptOrModuleをactive scriptの記録に設定します。

    以下に示すように、これはジョブコールバックが呼び出されるときに現在のアクティブスクリプトを伝播するために使用されます。

    active scriptがnullでなく、この方法で保存することが有用であるケースは以下のとおりです:

    Promise.resolve('import(`./example.mjs`)').then(eval);

    このステップがなければ（およびHostCallJobCallbackでそれを使用するステップがなければ）、 import()式が評価されるときにアクティブスクリプトは存在しないでしょう、 なぜならeval()は特定のスクリプトに由来しない組み込み関数だからです。

    このステップがあることで、アクティブスクリプトは上記のコードからジョブに伝播され、import()が元のスクリプトのベースURLを適切に使用できるようになります。

    ユーザーが以下のボタンをクリックすると、active scriptはnullになります:

    <button onclick="Promise.resolve('import(`./example.mjs`)').then(eval)">Click me</button>

    この場合、イベントハンドラーのJavaScript関数はイベントハンドラーの現在の値を取得するアルゴリズムによって作成され、 null [[ScriptOrModule]]値を持つ関数が作成されます。そのため、Promiseの機構がHostMakeJobCallbackを呼び出すとき、 アクティブスクリプトを渡すことはできません。

    その結果、import()式が評価されるときにアクティブスクリプトは依然として存在しないでしょう。幸いなことに、これはHostLoadImportedModuleの実装によって処理されており、 現在の設定オブジェクトのAPIベースURLを使用することで対処されています。

  5. JobCallback Record { [[Callback]]: callable, [[HostDefined]]: { [[IncumbentSettings]]: incumbent settings, [[ActiveScriptContext]]: script execution context } }を返します。

8.1.6.7 モジュールに関連するホストフック

JavaScript仕様は、モジュールの構文とその処理モデルのホストに依存しない部分を定義しています。本仕様は、その処理モデルの残りの部分、すなわち、script要素のtype属性を"module"に設定してモジュールシステムをブートストラップし、モジュールがどのようにフェッチされ、解決され、実行されるかを定義しています。[JAVASCRIPT]

JavaScript仕様では「スクリプト」と「モジュール」を区別している一方で、一般的に本仕様では従来のスクリプトとモジュールスクリプトという用語が使われています。両方ともscript要素を使用するためです。

modulePromise = import(specifier)

specifierで識別されるモジュールスクリプトのモジュール名前空間オブジェクトに対するPromiseを返します。これにより、import文形式を使用せずに、実行時にモジュールスクリプトを動的にインポートすることができます。specifierはアクティブスクリプトに相対的に解決されます。

無効なspecifierが与えられた場合、またはモジュールグラフのフェッチまたは評価中にエラーが発生した場合、返されたPromiseは拒否されます。

この構文は、従来のスクリプトとモジュールスクリプトの両方で使用できます。したがって、従来のスクリプトの世界からモジュールスクリプトの世界への橋渡しを提供します。

url = import.meta.url

アクティブなモジュールスクリプトのベースURLを返します。

この構文はモジュールスクリプト内でのみ使用できます。

url = import.meta.resolve(specifier)

specifierを返します。それはアクティブスクリプトに相対的に解決されます。つまり、これはimport(specifier)を使用してインポートされるURLを返します。

無効なspecifierが与えられた場合、TypeError例外をスローします。

この構文はモジュールスクリプト内でのみ使用できます。

モジュールマップは、マップであり、タプルをキーとします。そのタプルは、URLレコードと文字列で構成されます。 URLレコードは、モジュールがフェッチされた際のリクエストURL であり、文字列はモジュールの種類を示します （例：「javascript-or-wasm」）。モジュールマップの値は、モジュールスクリプト、null（フェッチ失敗を表すために使用）、 またはプレースホルダーの値「fetching」です。モジュールマップは、インポートされたモジュールスクリプトが ドキュメントやワーカーごとに一度だけフェッチ、解析、評価されるように使用されます。

モジュールマップは（URL、モジュールの種類）でキー とされているため、以下のコードはモジュールマップに3つの別々のエントリを作成します。これは 「javascript-or-wasm」タイプの異なる（URL、モジュールの種類）タプル3つを生成するためです：

import "https://example.com/module.mjs";
import "https://example.com/module.mjs#map-buster";
import "https://example.com/module.mjs?debug=true";

つまり、URLのクエリや フラグメントを変更することで、モジュールマップ内に別々のエントリを作成できます。これらは無視されません。 したがって、3つの別々のフェッチと3つの別々のモジュール評価が実行されます。

対照的に、以下のコードはモジュールマップに1つのエントリしか作成しません。これらの入力に対して URLパーサーを適用すると、結果の URLレコードが同一であるためです： 

import "https://example.com/module2.mjs";
import "https:example.com/module2.mjs";
import "https://///example.com\\module2.mjs";
import "https://example.com/foo/../module2.mjs";

したがって、この2つ目の例では、1つのフェッチと1つのモジュール評価しか発生しません。

この動作は、共有ワーカーが解析されたコンストラクタURLを キーとしている方法と同じです。

モジュールの種類もモジュールマップのキーの一部であるため、以下のコードはモジュールマップに2つの別々のエントリを作成します（1つ目の種類は 「javascript-or-wasm」、2つ目の種類は「css」です）：

<script type=module>
import "https://example.com/module";
</script>
<script type=module>
import "https://example.com/module" with { type: "css" };
</script>

これにより、2つの個別のフェッチと2つの個別のモジュール評価が行われる可能性があります。

実際には、まだ仕様が定まっていないメモリキャッシュ（問題#6110を参照）のため、リソースはWebKitやBlinkベースのブラウザでは1度だけフェッチされる場合があります。また、すべてのモジュールタイプが互いに排他的である限り、単一のモジュールスクリプトのフェッチでモジュールタイプチェックが少なくとも1つのインポートに失敗するため、最大で1つのモジュール評価が行われます。

モジュールマップのキーにタイプを含める目的は、誤ったタイプ属性を持つインポートが、正しいタイプを持つ同じspecifierの別のインポートの成功を妨げないようにすることです。

JavaScriptモジュールスクリプトは、他のJavaScriptモジュールからインポートする際のデフォルトのインポートタイプです。つまり、import文にtypeインポート属性が欠けている場合、インポートされたモジュールスクリプトのタイプはJavaScriptになります。typeインポート属性を持つimport文を使用してJavaScriptリソースをインポートしようとすると失敗します。 

<script type="module">
// 次のすべてのインポートは失敗します。インポートされる.mjsファイルがJavaScript MIMEタイプで提供されていると仮定しています。
// JavaScriptモジュールスクリプトはデフォルトであり、インポートタイプ属性を使用してインポートすることはできません。
import foo from "./foo.mjs" with { type: "javascript" };
import foo2 from "./foo2.mjs" with { type: "js" };
import foo3 from "./foo3.mjs" with { type: "" };
await import("./foo4.mjs", { with: { type: null } });
await import("./foo5.mjs", { with: { type: undefined } });
</script>
8.1.6.7.1 HostGetImportMetaProperties(moduleRecord)

Reference/Operators/import.meta/resolve

すべての現在のエンジンでサポートされています。

Firefox106+Safari16.4+Chrome105+
Opera？Edge105+
Edge (Legacy)？Internet Explorerサポートされていません
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

Reference/Operators/import.meta

すべての現在のエンジンでサポートされています。

Firefox62+Safari11.1+Chrome64+
Opera？Edge79+
Edge (Legacy)？Internet Explorerサポートされていません
Firefox Android？Safari iOS？Chrome Android？WebView Android？Samsung Internet？Opera Android？

JavaScriptには、実装依存のHostGetImportMetaProperties抽象操作が含まれています。 ユーザーエージェントは、次の実装を使用する必要があります：[JAVASCRIPT]

  1. moduleScriptをmoduleRecord.[[HostDefined]]とする。

  2. 確認：moduleScriptの基本URLがnullでないことを確認する。moduleScriptはJavaScriptモジュールスクリプトであるため。

  3. urlStringをmoduleScriptの基本URLのシリアライズとして設定する。

  4. 以下の手順をspecifier引数に対して実行する:

    1. specifierを? ToString(specifier)に設定する。

    2. moduleScriptおよびspecifierを使用して、モジュール指定子を解決した結果をurlに設定する。

    3. urlのシリアライズを返す。

  5. resolveFunction を ! CreateBuiltinFunction(steps, 1, "resolve", « ») に設定します。

  6. « Record { [[Key]]: "url", [[Value]]: urlString }, Record { [[Key]]: "resolve", [[Value]]: resolveFunction } » を返します。

8.1.6.7.2 HostGetSupportedImportAttributes()

JavaScript には、実装定義の HostGetSupportedImportAttributes 抽象操作が含まれています。ユーザーエージェントは、次の実装を使用する必要があります。[JAVASCRIPT]

  1. « "type" » を返します。

8.1.6.7.3 HostLoadImportedModule(referrer, moduleRequest, loadState, payload)

JavaScript には、実装定義の HostLoadImportedModule 抽象操作が含まれています。ユーザーエージェントは、次の実装を使用する必要があります。[JAVASCRIPT]

  1. settingsObjectを現在の設定オブジェクトに設定します。

  2. もしsettingsObjectのグローバルオブジェクトがWorkletGlobalScope またはServiceWorkerGlobalScopeを実装しており、loadStateが未定義の場合:

    loadStateが未定義の場合、それは現在のフェッチ処理が動的なimport() 呼び出しによって開始されたことを意味します。これは直接的であるか、動的にインポートされたモジュールの推移的依存関係をロードする際に発生します。

    1. completionを完了レコード { [[Type]]: throw, [[Value]]: 新しいTypeError, [[Target]]: empty }に設定します。

    2. FinishLoadingImportedModule(referrer, moduleRequest, payload, completion)を実行します。

    3. Returnします。

  3. referencingScriptをnullに設定します。

  4. originalFetchOptionsをデフォルトのスクリプトフェッチオプションに設定します。

  5. fetchReferrerを"client"に設定します。

  6. もしreferrerがスクリプトレコード またはモジュールレコードの場合:

    1. referencingScriptをreferrer.[[HostDefined]]に設定します。

    2. settingsObjectをreferencingScriptの設定オブジェクトに設定します。

    3. fetchReferrerをreferencingScriptの基本URLに設定します。

    4. originalFetchOptionsをreferencingScriptのフェッチオプションに設定します。

    リファラーは通常、スクリプトレコードまたは循環モジュールレコードですが、イベントハンドラの場合はイベントハンドラの現在の値を取得する アルゴリズムに従って、このようにはなりません。例えば、次のコードが与えられた場合：

    <button onclick="import('./foo.mjs')">Click me</button>

    もしクリック イベントが発生した場合、import() 式が実行される時点で、GetActiveScriptOrModuleはnullを返し、この操作はフォールバックとして現在のレルムをリファラーとして受け取ります。

  7. もしリファラーが循環モジュールレコードであり、moduleRequest がリファラー.[[RequestedModules]]の最初の要素と等しい場合は、次のことを行います:

    1. referrer.[[RequestedModules]] の各ModuleRequest レコード requested について反復処理します。

      1. もしmoduleRequest.[[Attributes]]が「type」ではないレコード entryを含む場合、次のことを行います:

        1. completionをCompletion Record { [[Type]]: throw, [[Value]]: 新しいSyntaxError 例外, [[Target]]: 空 }とします。

        2. FinishLoadingImportedModule(リファラー, moduleRequest, payload, completion)を実行します。

        3. リターンします。

        JavaScript仕様はこの検証を再実行しますが、検証エラーが発生した場合に依存関係を無駄にロードしないように、ここに重複して記載されています。

      2. モジュール識別子を解決します。 referencingScriptとmoduleRequest.[[Specifier]]が与えられた場合、例外が発生したら、resolutionErrorをスローされた例外にします。

      3. 前のステップで例外が発生した場合:

        1. completionをCompletion Record { [[Type]]: throw, [[Value]]: resolutionError, [[Target]]: 空 }とします。

        2. FinishLoadingImportedModule(リファラー, moduleRequest, payload, completion)を実行します。

        3. リターンします。

      4. moduleTypeをmoduleRequestが与えられた場合のモジュールリクエストからモジュールタイプステップを実行した結果とします。

      5. もしモジュールタイプが許可されているステップを実行した結果、 moduleTypeとsettingsObjectがfalseの場合、次のことを行います:

        1. completionをCompletion Record { [[Type]]: throw, [[Value]]: 新しいTypeError 例外, [[Target]]: 空 }とします。

        2. FinishLoadingImportedModule(リファラー, moduleRequest, payload, completion)を実行します。

        3. リターンします。

      このステップは、最初にHostLoadImportedModuleが静的モジュール依存リストに対して呼び出された際に、 すべての要求されたモジュール識別子およびタイプ属性を検証するものであり、依存関係の1つに静的エラーがある場合には さらなるロード操作を回避します。解決不可能なモジュール識別子やサポートされていないタイプ属性を持つモジュールは、 解析できないモジュールと同じように扱われます。どちらの場合も、文法的な問題があるため、後でモジュールをリンクすることは不可能です。

  8. urlをreferencingScriptとmoduleRequest.[[Specifier]]に基づいてモジュール識別子を解決する結果として設定し、例外をキャッチします。もし例外が発生した場合、resolutionErrorをスローされた例外として設定します。

  9. もし前のステップで例外が発生した場合:

    1. completionを完了レコード { [[Type]]: throw, [[Value]]: resolutionError, [[Target]]: empty }に設定します。

    2. FinishLoadingImportedModule(referrer, moduleRequest, payload, completion)を実行します。

    3. Returnします。

  10. fetchOptionsを子孫スクリプトフェッチオプションを取得する結果として、originalFetchOptions、url、およびsettingsObjectを使用して設定します。

  11. destinationを"script"に設定します。

  12. fetchClientをsettingsObjectに設定します。

  13. もしloadStateが未定義でない場合:

    1. destinationをloadState.[[Destination]]に設定します。

    2. fetchClientをloadState.[[FetchClient]]に設定します。

  14. 単一のインポートされたモジュールスクリプトをフェッチするをurl、fetchClient、destination、fetchOptions、settingsObject、fetchReferrer、moduleRequest、および以下に定義されているonSingleFetchCompleteとして渡して実行します。もしloadStateが未定義でなく、かつloadState.[[PerformFetch]]がnullでない場合、loadState.[[PerformFetch]]も一緒に渡します。

    onSingleFetchCompleteは、moduleScriptが与えられた場合に以下のアルゴリズムを実行します:

    1. completionをnullに設定します。

    2. もしmoduleScriptがnullの場合、completionを完了レコード { [[Type]]: throw, [[Value]]: 新しいTypeError, [[Target]]: empty }に設定します。

    3. それ以外の場合、もしmoduleScriptの構文エラーがnullでない場合:

      1. parseErrorをmoduleScriptの構文エラーに設定します。

      2. completionを完了レコード { [[Type]]: throw, [[Value]]: parseError, [[Target]]: empty }に設定します。

      3. もしloadStateが未定義でなく、かつloadState.[[ParseError]]がnullの場合、loadState.[[ParseError]]をparseErrorに設定します。

    4. それ以外の場合、completionを完了レコード { [[Type]]: normal, [[Value]]: moduleScriptのレコード, [[Target]]: empty }に設定します。

    5. FinishLoadingImportedModule(referrer, moduleRequest, payload, completion)を実行します。

8.1.7 イベントループ

8.1.7.1 定義

イベント、ユーザーインタラクション、スクリプト、レンダリング、ネットワーキングなどを調整するために、ユーザーエージェントはこのセクションで説明されているように、イベントループを使用しなければなりません。各エージェントには、そのエージェントに固有のイベントループが関連付けられています。

イベントループは、同一オリジンのウィンドウエージェントの場合、「ウィンドウイベントループ」として知られています。イベントループは、専用ワーカーエージェント、共有ワーカーエージェント、またはサービスワーカーエージェントの場合、「ワーカーイベントループ」として知られています。また、イベントループは、ワークレットエージェントの場合、「ワークレットイベントループ」として知られています。

イベントループは必ずしも実装スレッドに対応しているわけではありません。例えば、複数のウィンドウイベントループが1つのスレッドで協力的にスケジュールされることもあります。

ただし、[[CanBlock]]がtrueに設定されている様々なワーカーエージェントについては、JavaScript仕様書はそれらに関して前進の進捗に関する要件を課しており、事実上、これらの場合にはエージェントごとに専用のスレッドが必要になります。

イベントループには1つ以上のタスクキューがあります。タスクキューは、セットのタスクです。

タスクキューは、セットであり、キューではありません。なぜなら、イベントループ処理モデルは選択されたキューから最初の実行可能なタスクを取得するため、最初のタスクをデキューするわけではないからです。

マイクロタスクキューはタスクキューではありません。

タスクは、次のような作業を担当するアルゴリズムをカプセル化します:

イベント

特定のイベントオブジェクトを特定のイベントターゲットオブジェクトにディスパッチすることは、専用のタスクによって行われることがよくあります。

すべてのイベントがタスクキューを使用してディスパッチされるわけではなく、多くは他のタスク中にディスパッチされます。

パース

HTMLパーサーが1バイト以上をトークナイズし、その後のトークンを処理することは、通常タスクとして行われます。

コールバック

コールバックの呼び出しは、専用のタスクによって行われることがよくあります。

リソースの使用

アルゴリズムがリソースを取得するとき、非ブロッキングで取得が行われる場合は、リソースの一部または全部が利用可能になった後の処理がタスクによって実行されます。

DOM操作への反応

一部の要素にはDOM操作に反応してトリガーされるタスクがあります。例えば、その要素がドキュメントに挿入されたときなどです。

形式的には、タスクは、次の項目を持つ構造体です:

ステップ
タスクによって行われる作業を指定する一連のステップ。
ソース
タスクソースの1つで、関連するタスクをグループ化し、直列化するために使用されます。
ドキュメント
タスクに関連付けられたDocument、またはウィンドウイベントループにないタスクの場合はnull。
スクリプト評価環境設定オブジェクトセット
タスク中にスクリプト評価を追跡するために使用されるセットの環境設定オブジェクト。

タスクは、そのドキュメントがnullであるか、完全にアクティブである場合、「実行可能」です。

それぞれのタスクは、ソースフィールドに基づき、特定のタスクソースから来ると定義されています。各イベントループに対して、すべてのタスクソースは、特定のタスクキューに関連付けられなければなりません。

要するに、タスクソースは標準の中で論理的に異なるタイプのタスクを区別するために使用され、ユーザーエージェントがそれらを区別したい場合があります。タスクキューは、ユーザーエージェントが特定のイベントループ内でタスクソースを統合するために使用します。

例えば、ユーザーエージェントがマウスおよびキーイベント用のタスクキューを1つ持ち、他のすべてのタスクソースに関連付けられた別のキューを持っているとします。次に、イベントループ処理モデルの初期ステップで与えられた自由度を使用して、インターフェースを応答性の高い状態に保ちながら、他のタスクキューを犠牲にしないようにするため、キーボードおよびマウスイベントに他のタスクよりも3/4の優先度を与えることができます。このセットアップでも、処理モデルはユーザーエージェントが1つのタスクソースからのイベントを順不同で処理することがないように強制します。

各イベントループには現在実行中のタスクがあり、これはタスクまたはnullです。初期状態ではnullです。これは再入性を処理するために使用されます。

各イベントループにはマイクロタスクキューがあり、これはキューです。初期状態では空のマイクロタスクのキューです。マイクロタスクとは、マイクロタスクをキューに追加アルゴリズムを使用して作成されたタスクを指す口語的な表現です。

各イベントループにはマイクロタスクチェックポイントを実行中というブール値があり、初期状態ではfalseです。これはマイクロタスクチェックポイントを実行するアルゴリズムの再入呼び出しを防ぐために使用されます。

各ウィンドウイベントループには、初期状態でゼロに設定されたDOMHighResTimeStamp 最後のレンダー機会時間があります。

各ウィンドウイベントループには、初期状態でゼロに設定されたDOMHighResTimeStamp 最後のアイドル期間開始時間があります。

ウィンドウイベントループ loopの同じループのウィンドウを取得するには、その関連するエージェントのイベントループがloopであるすべてのWindowオブジェクトを返します。

8.1.7.2 タスクのキューイング

sourceというタスクソースに、stepsという一連のステップを実行するタスクをキューに追加するには、オプションでevent loopおよびdocumentを指定します:

  1. event loopが指定されていない場合、event loopを暗黙のイベントループに設定します。

  2. documentが指定されていない場合、documentを暗黙のドキュメントに設定します。

  3. taskを新しいタスクとして作成します。

  4. taskのstepsをstepsに設定します。

  5. taskのsourceをsourceに設定します。

  6. taskのdocumentをdocumentに設定します。

  7. taskのスクリプト評価環境設定オブジェクトセットを空のセットに設定します。

  8. queueを、sourceがevent loopに関連付けられているタスクキューに設定します。

  9. taskをqueueに追加します。

タスクをキューに追加する際にイベントループやドキュメントを渡さない場合、曖昧で仕様が不明瞭な暗黙のイベントループや暗黙のドキュメントの概念に依存することになります。仕様の著者は、これらの値を常に渡すか、代わりにグローバルタスクをキューに追加するまたは要素タスクをキューに追加するといったラッパーアルゴリズムを使用するべきです。ラッパーアルゴリズムの使用が推奨されます。

sourceというタスクソースに、globalというグローバルオブジェクトとstepsという一連のステップを使用してグローバルタスクをキューに追加するには:

  1. event loopをglobalの関連するエージェントのイベントループに設定します。

  2. documentを、globalがWindowオブジェクトである場合、globalの関連付けられたDocumentに設定します。それ以外の場合はnullに設定します。

  3. source、event loop、document、およびstepsを指定してタスクをキューに追加します。

sourceというタスクソースに、elementという要素とstepsという一連のステップを使用して要素タスクをキューに追加するには:

  1. globalをelementの関連するグローバルオブジェクトに設定します。

  2. source、global、およびstepsを指定してグローバルタスクをキューに追加します。

マイクロタスクをキューに追加するには、stepsという一連のステップを実行し、オプションでdocumentを指定します:

  1. Assert: 周囲のエージェントが存在することを確認します。つまり、このアルゴリズムは並行して呼び出されることはありません。

  2. eventLoopを、周囲のエージェントのイベントループに設定します。

  3. documentが指定されていない場合、documentを暗黙のドキュメントに設定します。

  4. microtaskを新しいタスクとして作成します。

  5. microtaskのstepsをstepsに設定します。

  6. microtaskのsourceをマイクロタスクソースに設定します。

  7. microtaskのdocumentをdocumentに設定します。

  8. microtaskのスクリプト評価環境設定オブジェクトセットを空のセットに設定します。

  9. microtaskをeventLoopのマイクロタスクキューにエンキューします。

マイクロタスクが実行中にイベントループをスピンすると、マイクロタスクが通常のタスクキューに移動されることがあります。これは、マイクロタスクのソース、ドキュメント、およびスクリプト評価環境設定オブジェクトセットが参照される唯一のケースであり、マイクロタスクチェックポイントを実行するアルゴリズムでは無視されます。

暗黙のイベントループは、タスクをキューに追加する際に呼び出しアルゴリズムのコンテキストから推定されるイベントループです。これは通常、曖昧ではありません。なぜなら、大多数の仕様アルゴリズムは単一のエージェント（したがって単一のイベントループ）のみを含むからです。例外は、ウィンドウとワーカー間の通信のようなエージェント間通信を含むまたは指定するアルゴリズムであり、そのようなケースでは暗黙のイベントループの概念に依存してはならず、仕様はタスクをキューに追加する際に明示的にイベントループを指定する必要があります。

event loopというイベントループにタスクをキューに追加する際の暗黙のドキュメントは、次のように決定されます:

  1. event loopがウィンドウイベントループでない場合は、nullを返します。

  2. タスクが要素のコンテキストでキューに追加されている場合は、要素のノードドキュメントを返します。

  3. タスクがブラウジングコンテキストのコンテキストでキューに追加されている場合は、ブラウジングコンテキストのアクティブドキュメントを返します。

  4. タスクがスクリプトによって、またはそのためにキューに追加されている場合は、スクリプトの設定オブジェクトのグローバルオブジェクトの関連付けられたDocumentを返します。

  5. Assert: このステップには決して到達しません。なぜなら、前の条件のいずれかが真であるからです。本当に？

暗黙のイベントループと暗黙のドキュメントは、漠然と定義されており、遠隔操作的な側面が多くあります。これらを、特に暗黙のドキュメントを削除することが望まれています。詳しくは、issue #4980を参照してください。

8.1.7.3 処理モデル

イベントループは、存在する限り、以下の手順を継続的に実行しなければなりません。

  1. oldestTask と taskStartTime を null に設定します。

  2. もし、イベントループに、少なくとも1つの タスクキューがあり、少なくとも1つの 実行可能な タスクがある場合は、以下の手順を実行します。

    1. taskQueue をそのような タスクキュー の1つに設定します。この選択は 実装依存の方法で行われます。

      マイクロタスクキューは タスクキューではないことを思い出してください。したがって、この手順で選択されることはありません。ただし、タスクキューに関連付けられたマイクロタスクソースが選択される場合があります。その場合、次のステップで選択されたタスクは、元々はマイクロタスクでしたが、イベントループをスピンするの一環として移動されました。

    2. taskStartTime を安全でない共有現在時刻に設定します。

    3. oldestTask を taskQueue の最初の 実行可能な タスク に設定し、taskQueue から 削除します。

    4. もし、oldestTask のドキュメントが null でない場合、taskStartTimeと oldestTask のドキュメントを使って タスクの開始時刻を記録します。

    5. イベントループの 現在実行中のタスク を oldestTask に設定します。

    6. oldestTask の手順を実行します。

    7. イベントループの 現在実行中のタスクを null に戻します。

    8. マイクロタスクチェックポイントを実行します。

  3. taskEndTime を 安全でない共有現在時刻 に設定します。 [HRT]

  4. もし、oldestTask が null でない場合は、次の手順を実行します。

    1. top-level browsing contexts を空の セットに設定します。

    2. 各 環境設定オブジェクトについて oldestTask の スクリプト評価環境設定オブジェクトセットの settings を実行します。

      1. global を settings の グローバルオブジェクトに設定します。

      2. もし、global が Window オブジェクトでない場合は、 続行します。

      3. もし、global のブラウジングコンテキストが null である場合は、 続行します。

      4. tlbc を global の ブラウジングコンテキストの トップレベルブラウジングコンテキストに設定します。

      5. もし、tlbc が null でない場合は、それをに追加します top-level browsing contextsに。

    3. 長時間のタスクを報告する、taskStartTime, taskEndTime, top-level browsing contexts, および oldestTask を指定します。

    4. もし、oldestTask のドキュメントが null でない場合、taskEndTime と oldestTask のドキュメントを使って タスク終了時刻を記録します。

  5. もし、これは ウィンドウイベントループで、この イベントループに タスクキューに実行可能な実行可能な タスクが1つもない場合、次の手順を実行します。

    1. このイベントループの 最後のアイドル期間の開始時刻 を安全でない共有現在時刻に設定します。

    2. computeDeadline を次の手順に設定します。

      1. deadline をこのイベントループの最後のアイドル期間の開始時刻に50を加えたものに設定します。

        50msの上限は、新しいユーザー入力に対する応答性を人間の知覚の閾値内で確保するためです。

      2. hasPendingRenders を false に設定します。

      3. このイベントループに対する同一ループウィンドウの各 windowInSameLoop について、

        1. もし windowInSameLoop の アニメーションフレームコールバックのリストが 空でないか、ユーザーエージェントが windowInSameLoop に保留中のレンダリング更新があると信じる場合、hasPendingRenders を true に設定します。

        2. timerCallbackEstimates を マップから値を取得する結果に設定します。 windowInSameLoopのアクティブなタイマーのマップの。

        3. timerCallbackEstimatesの各timeoutDeadlineについて、 timeoutDeadlineがdeadlineよりも小さい場合は、deadlineをtimeoutDeadlineに設定します。

      4. もし、hasPendingRendersが true の場合、次の手順を実行します。

        1. nextRenderDeadline をこのイベントループの最後のレンダー機会の時刻に（現在のリフレッシュレートで1000を割った値）を加えたものに設定します。

          リフレッシュレートはハードウェアまたは実装固有である可能性があります。リフレッシュレートが60Hzの場合、nextRenderDeadlineは 最後のレンダー機会の時刻の約16.67ms後になります。

        2. もし、nextRenderDeadline が deadline よりも小さい場合は、 nextRenderDeadline を返します。

      5. deadline を返します。

    3. このイベントループの各同一ループウィンドウについて、次のステップを実行して、winのアイドル期間の開始アルゴリズムを実行します: winの関連設定オブジェクトのクロスオリジン隔離機能を考慮して、computeDeadlineを呼び出した結果を返します。[REQUESTIDLECALLBACK]

  6. もし、これが ワーカイベントループの場合は、次の手順を実行します。

    1. もしこのイベントループのエージェントの単一の領域のグローバルオブジェクトが サポートされている DedicatedWorkerGlobalScopeであり、ユーザーエージェントがその時点でレンダリングの更新が有益であると信じている場合は、次の手順を実行します。

      1. now を 現在の高解像度時刻 に設定します DedicatedWorkerGlobalScopeの場合。 [HRT]

      2. アニメーションフレームコールバックを実行します そのDedicatedWorkerGlobalScopeに対して、nowをタイムスタンプとして渡します。

      3. その専用ワーカーのレンダリングを現在の状態を反映するように更新します。

      レンダリングの更新に関する注記と同様に、ウィンドウイベントループ内で、ユーザーエージェントは専用ワーカー内のレンダリングの速度を決定できます。

    2. もし、タスクが1つもない場合、 イベントループのタスクキューにおいて、 WorkerGlobalScopeオブジェクトのクローズフラグがtrueである場合は、イベントループを破棄し、 これらの手順を中止して、次の手順に進みます。ワーカーを実行する手順は、以下のWebワーカーセクションに記載されています。

ウィンドウイベントループ eventLoopは、存在する限り、以下の手順を並行して実行しなければなりません。

  1. 少なくとも1つのナビゲーブルが、その アクティブなドキュメントの関連エージェントのイベントループがeventLoopであり、 レンダリングの機会を持つ可能性があるまで待ちます。

  2. eventLoop の 最後のレンダー機会の時刻 を 安全でない共有現在時刻に設定します。

  3. 各 navigable に レンダリングの機会がある場合、次の手順を実行します。 グローバルタスクをキューに入れる レンダリングタスクソースで、 navigable の アクティブなウィンドウを与え、 レンダリングを更新する。

    これは、レンダリングの更新を冗長に呼び出す原因になるかもしれません。しかし、これらの呼び出しは、不必要なレンダリングステップに従って、観察可能な効果を持たないでしょう。実装は、すでにキューに入っていない場合にのみこのタスクをキューに入れるなどの最適化を導入できます。ただし、タスクに関連付けられたドキュメントがタスクの処理前に非アクティブになる可能性があることに注意してください。

    1. frameTimestamp を eventLoop の 最後のレンダー機会の時刻に設定します。

    2. docs を、すべての 完全にアクティブな Document オブジェクトに設定します。その 関連エージェント のイベントループが eventLoopであり、以下の条件を満たす限り、任意にソートされます。

      以下の手順で docs を繰り返し処理する際、各 Document はリストで見つけた順序で処理される必要があります。

    3. 非レンダリング可能ドキュメントのフィルタリング: 以下のいずれかが真である場合、docsからDocumentオブジェクトdocを削除します。

      いくつかのイベントループを共有するドキュメントが同時にレンダリングの機会を持たない可能性があるため、並行手順で確認することに加えて、ここでもレンダリングの機会を確認する必要があります。

    4. 不要なレンダリング: 以下のすべてが真である場合、docsからDocumentオブジェクトdocを削除します。

    5. ユーザーエージェントが他の理由でレンダリングの更新をスキップする方が好ましいと信じるDocumentオブジェクトをすべてdocsから削除します。

      非レンダリング可能ドキュメントのフィルタリング手順は、ユーザーエージェントがユーザーに新しいコンテンツを表示できない場合に、レンダリングの更新を防ぎます。

      不要なレンダリング手順は、新しいコンテンツを描画する必要がない場合にレンダリングの更新を防ぎます。

      この手順は、以下の手順が他の理由で実行されるのを防ぐことをユーザーエージェントに許可します。例えば、特定のタスクを、マイクロタスクチェックポイントのみを挟んで（例：アニメーションフレームコールバックを挟まずに）すぐに実行することを保証するためです。具体的には、ユーザーエージェントは、タイマーコールバックを一緒にまとめて、途中のレンダリング更新を行わないようにすることが望ましい場合があります。

    6. 各docのリビールを行います。

    7. 各docの自動フォーカス候補のフラッシュを実行します。もしそのナビゲーブルノードがトップレベルトラバーサブルである場合。

    8. 各docのリサイズ手順を実行します。 docに対して。[CSSOMVIEW]

    9. 各docのスクロール手順を実行します。 docに対して。[CSSOMVIEW]

    10. 各docのメディアクエリの評価と変更の報告を実行します。docに対して。[CSSOMVIEW]

    11. 各docのアニメーションの更新とイベントの送信を実行します。docに対して、相対的な高解像度時刻とframeTimestampおよびdocの関連するグローバルオブジェクトをタイムスタンプとして渡します。

    12. 各docのフルスクリーン手順を実行します。docに対して。[FULLSCREEN]

    13. 各 doc が docs に対して、ユーザーエージェントが CanvasRenderingContext2D または OffscreenCanvasRenderingContext2D に関連付けられたバックストレージが失われていることを検出した場合、その各 context に対して コンテキスト損失手順 を実行しなければなりません。

      1. canvas を context のキャンバス属性の値に設定します。もしcontextがCanvasRenderingContext2Dの場合。そうでない場合は、関連するOffscreenCanvasオブジェクトに設定します。

      2. context の コンテキストロストを true に設定します。

      3. レンダリングコンテキストをデフォルトの状態にリセットします。contextを指定して。

      4. shouldRestoreを、イベントを発火する結果に設定します。イベント名はcontextlost、canvasに対して、キャンセル可能属性が true に初期化されます。

      5. もしshouldRestoreがfalseの場合、これらの手順を中止します。

      6. contextの属性を使用してバックストレージを作成し、それをcontextに関連付けることでcontextを復元しようとします。これが失敗した場合、これらの手順を中止します。

      7. context の コンテキストロストを false に設定します。

      8. イベントを発火するします。イベント名はcontextrestored、canvasに対して。

    14. 各docのアニメーションフレームコールバックを実行します。docに対して、相対的な高解像度時刻を指定し、frameTimestampとdocの関連するグローバルオブジェクトをタイムスタンプとして渡します。

    15. unsafeStyleAndLayoutStartTime を 安全でない共有現在時刻に設定します。

    16. 各docについて:

      1. resizeObserverDepthを0に設定します。

      2. 無限ループの間:

        1. docのスタイルを再計算し、レイアウトを更新します。

        2. hadInitialVisibleContentVisibilityDeterminationをfalseに設定します。

        3. 'auto'を使用した 'content-visibility'の値を持つ各要素elementについて:

          1. もしelementのビューポートとの近接性がまだ決定されておらず、それがユーザーに関連しているものでない場合は、checkForInitialDeterminationをtrueに設定します。そうでない場合は、checkForInitialDeterminationをfalseに設定します。

          2. elementのビューポートとの近接性を決定します。

          3. もしcheckForInitialDeterminationがtrueであり、elementが現在ユーザーに関連しているものである場合、hadInitialVisibleContentVisibilityDeterminationをtrueに設定します。

        4. もしhadInitialVisibleContentVisibilityDeterminationがtrueであれば、続行します。

          このステップの目的は、すぐに反映される初期のビューポート近接性の決定が、このループの前のステップで行われたスタイルおよびレイアウトの計算に反映されることです。初期以外の近接性の決定は、次のレンダリングの機会で効果を発揮します。[CSSCONTAIN]

        5. 深度でアクティブなリサイズ観測を集める resizeObserverDepthをdocに設定します。

        6. もしdocがアクティブなリサイズ観測を持っている場合:

          1. アクティブなリサイズ観測を通知した結果をdocに基づいてresizeObserverDepthに設定します。

          2. 続行。
        7. そうでない場合は、ループを抜けます。

      3. もしdocがスキップされたリサイズ観測を持っている場合、リサイズループエラーを送信します。

    17. 各docについて、もしdocのフォーカスされた領域がフォーカス可能な領域でない場合、docのビューポートに対してフォーカス修正手順を実行し、docの関連するグローバルオブジェクトのナビゲーションAPIの進行中のナビゲーション中にフォーカスが変更されたをfalseに設定します。

      例えば、要素にhidden属性が追加され、レンダリングされなくなることが原因でこれが発生することがあります。また、要素が無効化されたときに、input要素に対しても発生することがあります。

      これは通常、blurイベント、そして場合によってはchangeイベントを発生させます。

      この非同期修正に加えて、もしドキュメントのフォーカスされた領域が削除された場合、同期修正が行われます。この修正では、blurまたはchangeイベントは発生しません。

    18. 各docについて、保留中の遷移操作を実行します。[CSSVIEWTRANSITIONS]

    19. 各docについて、交差観測の更新手順を実行し、相対的な高解像度時刻をnowおよびdocの関連するグローバルオブジェクトに渡してタイムスタンプとして設定します。[INTERSECTIONOBSERVER]

    20. 各docについて、レンダリング時間を記録します。docにunsafeStyleAndLayoutStartTimeを指定して。

    21. 各docについて、ペイントタイミングをマークします。docに対して。

    22. 各docについて、docおよびそのナビゲーブルノードのレンダリングまたはユーザーインターフェースを現在の状態を反映するように更新します。

    23. 各docについて、トップレイヤーの削除を処理します。docに対して。

ナビゲーブルは、ユーザーエージェントが現在、ナビゲーブルの内容をユーザーに提示できる場合、ハードウェアのリフレッシュレート制約やパフォーマンスのためのユーザーエージェントのスロットリングを考慮して、レンダリング機会を持ちます。ただし、ビューポート外のコンテンツも提示可能であると見なします。

ナビゲーブルのレンダリング機会は、ディスプレイのリフレッシュレートなどのハードウェアの制約や、ページのパフォーマンス、あるいはアクティブなドキュメントの可視状態が"visible"であるかどうかなどの他の要因に基づいて決定されます。レンダリング機会は通常、定期的な間隔で発生します。

この仕様は、レンダリング機会を選択するための特定のモデルを要求していません。ただし、例えばブラウザが60Hzのリフレッシュレートを達成しようとしている場合、レンダリング機会は最大で1秒の60分の1（約16.7ms）ごとに発生します。ブラウザがナビゲーブルがこのレートを維持できないと判断した場合、時折フレームを落とすのではなく、そのナビゲーブルに対してより持続可能な1秒間に30回のレンダリング機会に切り替えることがあります。同様に、ナビゲーブルが可視状態でない場合、ユーザーエージェントはそのページのレンダリング機会を1秒間に4回、またはそれ以下に減らすことを決定するかもしれません。

ユーザーエージェントがマイクロタスクチェックポイントを実行する場合:

  1. もしイベントループのマイクロタスクチェックポイントを実行中がtrueである場合、リターンします。

  2. イベントループのマイクロタスクチェックポイントを実行中をtrueに設定します。

  3. イベントループのマイクロタスクキューが空でない間:

    1. キューから取り出す結果をoldestMicrotaskに設定します。

    2. イベントループの現在実行中のタスクをoldestMicrotaskに設定します。

    3. oldestMicrotaskを実行します。

      これはスクリプトされたコールバックを呼び出すことを含むかもしれません。これが最終的にスクリプトの実行後のクリーンアップ手順を呼び出し、このマイクロタスクチェックポイントを実行するアルゴリズムを再度呼び出すことになります。これが再入を避けるためにマイクロタスクチェックポイントを実行中フラグを使用する理由です。

    4. イベントループの現在実行中のタスクをnullに戻します。

  4. この環境設定オブジェクトで、責任を持つイベントループがこのイベントループであるsettingsObjectのグローバルオブジェクトに基づいて拒否されたプロミスについて通知を行います。

  5. インデックスデータベーストランザクションのクリーンアップを実行します。

  6. ClearKeptObjects()を実行します。

    当WeakRef.prototype.deref()がオブジェクトを返す場合、そのオブジェクトは次のClearKeptObjects()の呼び出しまで生存し、その後再びガベージコレクションの対象となります。

  7. イベントループのマイクロタスクチェックポイントを実行中をfalseに設定します。

  8. マイクロタスクチェックポイントのタイミング情報を記録します。

アルゴリズムが並行して実行されるときに安定状態を待機するとき、ユーザーエージェントは次のステップを実行するマイクロタスクをキューに入れ、その後の実行を停止します（アルゴリズムの実行は、マイクロタスクが実行されると再開されます）。

  1. アルゴリズムの同期セクションを実行します。

  2. 適切な場合は、アルゴリズムのステップに従って並行してアルゴリズムの実行を再開します。

同期セクションのステップには⌛が付いています。

イベントループをスピンすると言うアルゴリズムステップは、goalが満たされるまで、次のアルゴリズムステップに置き換えることと同等です。

  1. イベントループの現在実行中のタスクをtaskに設定します。

    taskはマイクロタスクである可能性があります。

  2. taskのタスクソースをtask sourceに設定します。

  3. JavaScript実行コンテキストスタックのコピーをold stackに設定します。

  4. JavaScript実行コンテキストスタックを空にします。

  5. マイクロタスクチェックポイントを実行します。

    もしtaskがマイクロタスクである場合、このステップは、マイクロタスクチェックポイントを実行中がtrueであるため、何も行わないでしょう。

  6. 並行して:

    1. goalが満たされるまで待ちます。

    2. タスクをキューに入れるして、task sourceに:

      1. JavaScript実行コンテキストスタックをold stackに置き換えます。

      2. 元のアルゴリズムでこのイベントループをスピンするインスタンスの後に現れるすべてのステップを実行します。

        これによりtaskが再開されます。

  7. taskを停止し、それを呼び出したアルゴリズムが再開できるようにします。

    これによりイベントループのメインステップセットまたはマイクロタスクチェックポイントを実行するアルゴリズムが続行されます。

このおよび他の仕様内の他のアルゴリズムとは異なり、プログラミング言語の関数呼び出しに類似した動作をするものとは異なり、イベントループをスピンするは、マクロに似ています。これにより、使用場所でのタイピングやインデントを省き、一連のステップと操作に展開されます。

ステップが次のようなアルゴリズム:

  1. 何かを行う。

  2. イベントループをスピンするまで待ちます。

  3. 次のことを行う。

は、"マクロ展開"された後に次のようになります

  1. 何かを行う。

  2. JavaScript実行コンテキストスタックのコピーをold stackに設定します。

  3. JavaScript実行コンテキストスタックを空にします。

  4. マイクロタスクチェックポイントを実行します。

  5. 並行して:

    1. 驚異が起こるまで待ちます。

    2. タスクをキューに入れるして、"何かを行う"を行ったタスクソースに:

      1. JavaScript実行コンテキストスタックをold stackに置き換えます。

      2. 次のことを行う。

以下は、並行して作業を行うタスク内でイベントループがスピンされる、置換のより完全な例です。イベントループをスピンするを使用したバージョン:

  1. 並行して:

    1. 並行して行う作業1を実行します。

    2. タスクをキューに入れるして、DOM操作タスクソースで以下を実行します:

      1. タスクの作業1を実行します。

      2. イベントループをスピンするまで待ちます。

      3. タスクの作業2を実行します。

    3. 並行して行う作業2を実行します。

完全に展開されたバージョン:

  1. 並行して:

    1. 並行して行う作業1を実行します。

    2. old stackをnullに設定します。

    3. タスクをキューに入れるして、DOM操作タスクソースで以下を実行します:

      1. タスクの作業1を実行します。

      2. JavaScript実行コンテキストスタックのコピーをold stackに設定します。

      3. JavaScript実行コンテキストスタックを空にします。

      4. マイクロタスクチェックポイントを実行します。

    4. 驚異が起こるまで待ちます。

    5. タスクをキューに入れるして、DOM操作タスクソースで以下を実行します:

      1. JavaScript実行コンテキストスタックをold stackに置き換えます。

      2. タスクの作業2を実行します。

    6. 並行して行う作業2を実行します。

この仕様の一部のアルゴリズムでは、歴史的な理由により、ユーザーエージェントがgoalという条件が満たされるまで、タスクを実行している間に一時停止することが求められます。これは、次の手順を実行することを意味します:

  1. globalを現在のグローバルオブジェクトに設定します。

  2. timeBeforePauseを現在の高解像度時間に設定します。globalを指定します。

  3. 必要に応じて、Documentまたはナビゲーブルのレンダリングまたはユーザーインターフェースを更新して、現在の状態を反映させます。

  4. goalという条件が満たされるまで待ちます。ユーザーエージェントが一時停止されたタスクを持っている間、対応するイベントループはそれ以上タスクを実行せず、現在実行中のタスク内のスクリプトはブロックされます。ただし、一時停止中でもユーザー入力には応答する必要がありますが、イベントループは何もしていないため、応答性は低下します。

  5. 一時停止の期間を記録します。timeBeforePauseからglobalを指定して時間の長さを記録します。

一時停止は、特に複数のドキュメントが1つのイベントループを共有するシナリオでは、ユーザーエクスペリエンスに非常に悪影響を与えます。ユーザーエージェントは、一時停止に代わる方法を模索することが推奨されます。例えば、イベントループをスピンする、あるいは単に一時停止なしで処理を続行するなど、既存のコンテンツとの互換性を維持できる範囲で模索します。この仕様は、Web互換性が確認されるより穏やかな代替案が発見された場合、喜んで変更されます。

その間、実装者は、ユーザーエージェントが模索する可能性のあるさまざまな代替案が、イベントループの動作、タスクおよびマイクロタスクのタイミングなどの微妙な側面を変える可能性があることに注意する必要があります。一時停止操作によって暗示される正確な意味を違反することになっても、実装は引き続き実験を続けるべきです。

8.1.7.4 汎用タスクソース

以下のタスクソースは、この仕様および他の仕様で主に無関係な複数の機能によって使用されます。

DOM操作タスクソース

このタスクソースは、要素がドキュメントに挿入されたときに非ブロッキングの方式で発生する事象のように、DOM操作に反応する機能に使用されます。

ユーザーインタラクションタスクソース

このタスクソースは、キーボードやマウス入力など、ユーザーの操作に反応する機能に使用されます。

ユーザー入力に応じて送信されるイベント（例：click イベント）は、ユーザーインタラクションタスクソースでキューに入れられたタスクを使用して発行されなければなりません。[UIEVENTS]

ネットワーキングタスクソース

このタスクソースは、ネットワーク活動に応じてトリガーされる機能に使用されます。

ナビゲーションおよびトラバーサルタスクソース

このタスクソースは、ナビゲーションおよび履歴のトラバーサルに関連するタスクをキューに入れるために使用されます。

レンダリングタスクソース

このタスクソースは、レンダリングの更新のみに使用されます。

8.1.7.5 他の仕様からイベントループを扱う方法

イベントループと正しく相互作用する仕様を書くことは難しい場合があります。この仕様では並行性モデルに依存しない用語を使用しているため、「イベントループ」や「並行して」といった表現を使い、より馴染みのある「メインスレッド」や「バックグラウンドスレッド上で」といったモデル固有の用語は使用していません。

通常、仕様のテキストはイベントループ上で実行されます。これは、正式なイベントループ処理モデルに基づき、ほとんどのアルゴリズムが最終的にはタスクにキューに入れられるところにまで遡ることができるためです。

JavaScriptメソッドのアルゴリズムステップは、著者コードによってそのメソッドが呼び出されることで実行されます。そして、著者コードは通常、script処理モデルのどこかで発生したキューに入れられたタスクを介してのみ実行されます。

この出発点から、主要なガイドラインは、イベントループをブロックする可能性がある仕様が行う必要のある作業は、並行して実行されなければならないということです。これには以下を含みますが、これらに限定されません:

次に考慮すべき点は、並行して実行されるアルゴリズムセクションでは、特定のRealm、グローバル、または環境設定オブジェクトに関連付けられたオブジェクトを作成したり操作したりしてはならないということです。これは、バックグラウンドスレッドからメインスレッドのアーティファクトに直接アクセスしてはならないという、より馴染みのある用語で述べられます。これを行うと、アルゴリズムのステップがJavaScriptコードと並行して実行されるため、JavaScriptコードから観察可能なデータ競合が発生する可能性があります。

拡張すると、並行して実行されるステップからは、たとえそれらのステップが this 値にアクセスできるアルゴリズムによってアクティブ化されたとしても、Web IDL の this 値にアクセスすることはできません。

しかし、Infraのような仕様レベルのデータ構造や値を操作することは可能です。これらはRealmに依存しません。特定の変換が行われない限り（しばしばWeb IDLを介して）、JavaScriptには直接公開されません。[INFRA] [WEBIDL]

そのため、観察可能なJavaScriptオブジェクトの世界に影響を与えるには、そのような操作を実行するためにグローバルタスクをキューに入れる必要があります。これにより、イベントループ上で発生している他の事象と適切にステップがインターリーブされます。さらに、タスクソースを選択してグローバルタスクをキューに入れる必要があります。これにより、他のステップに対する相対的な順序が決定されます。どのタスクソースを使用するか不明な場合は、最も適用可能と思われる汎用タスクソースの1つを選択します。最後に、キューに入れたタスクが関連付けられるグローバルオブジェクトを指定する必要があります。これにより、そのグローバルオブジェクトが非アクティブである場合、タスクが実行されないようにします。

グローバルタスクをキューに入れる基盤となる基本的なプリミティブは、タスクをキューに入れるアルゴリズムです。一般的に、グローバルタスクをキューに入れるの方が優れています。なぜなら、これは自動的に適切なイベントループや、適切な場合にはドキュメントを選択するからです。古い仕様では、暗黙のイベントループや暗黙のドキュメントの概念と組み合わせてタスクをキューに入れるが使用されることがありますが、これは推奨されません。

これらをまとめると、非同期で作業を行う必要がある典型的なアルゴリズムのテンプレートを提供できます:

  1. イベントループ上で、すべての同期セットアップ作業を行います。これには、Realm固有のJavaScript値をRealmに依存しない仕様レベルの値に変換することが含まれる場合があります。

  2. Realmに依存しない値のみを操作し、Realmに依存しない結果を生成するために、並行して一連の潜在的に高コストなステップを実行します。

  3. 指定されたタスクソースと適切なグローバルオブジェクトを指定して、グローバルタスクをキューに入れることで、Realmに依存しない結果をイベントループ上のJavaScriptオブジェクトの観察可能な世界への観察可能な影響に変換します。

以下は、リストとして渡されたスカラー値文字列のinputをURLとして解析し、それらを「暗号化」するアルゴリズムです:

  1. urlsを空のリストに設定します。

  2. 各stringをinputで繰り返します:

    1. parsedをURLをエンコード解析するの結果に設定し、stringと現在の設定オブジェクトを相対的にします。

    2. parsedが失敗した場合、a promise rejected withを"SyntaxError" DOMExceptionで返します。

    3. serializedをURLシリアライザーをparsedに適用した結果に設定します。

    4. 追加して、serializedをurlsに設定します。

  3. realmを現在のRealmに設定します。

  4. pを新しいプロミスに設定します。

  5. 次のステップを並行して実行します:

    1. encryptedURLsを空のリストに設定します。

    2. 各urlをurlsで繰り返します:

      1. 重い暗号化処理をしているように見せるため、100ミリ秒待ちます。

      2. encryptedをurlから派生した新しい文字列に設定します。そのn番目のコード単位は、urlのn番目のコード単位に13を加えたものと等しくなります。

      3. 追加して、encryptedをencryptedURLsに設定します。

    3. グローバルタスクをキューに入れるをネットワーキングタスクソースで実行し、realmのグローバルオブジェクトを指定して、次のステップを実行します:

      1. arrayを、encryptedURLsをJavaScript配列に変換した結果に設定します。realmで実行します。

      2. pをarrayで解決します。

  6. pを返します。

このアルゴリズムに関するいくつかの注意点を以下に示します:

（これら最後の2つの点については、whatwg/webidl issue #135およびwhatwg/webidl issue #371も参照してください。上記のプロミス解決パターンの微妙な点についてまだ検討中です。）

もう一つ注意すべき点は、このアルゴリズムが sequence<USVString> を取る Web IDL 仕様の操作から呼び出された場合、作成者が入力として提供したレルム固有の JavaScript オブジェクトから、レルムに依存しない sequence<USVString> Web IDL 型への自動変換が行われ、これをスカラー値文字列のリストとして扱います。したがって、仕様がどのように構成されているかによって、並行処理の準備を整えるこのプロセス全体において、メインイベントループで発生する他の暗黙的なステップが存在する可能性があります。

8.1.8 イベント

8.1.8.1 イベントハンドラー

イベント/イベントハンドラー

多くのオブジェクトには、イベントハンドラーを指定できます。これらは、指定されたオブジェクトの非キャプチャイベントリスナーとして機能します。[DOM]

イベントハンドラーは、2つの構造体を持つ項目で構成されています。

イベントハンドラーは2つの方法で公開されます。

最初の方法は、すべてのイベントハンドラーに共通する、イベントハンドラーIDL属性としてです。

2つ目の方法は、イベントハンドラーコンテンツ属性としてです。HTML要素上のイベントハンドラーや、Windowオブジェクト上の一部のイベントハンドラーが、この方法で公開されます。

これら2つの方法のどちらにおいても、イベントハンドラーは、必ず「on」で始まり、そのハンドラーが意図するイベントの名前が続く名前として公開されます。

ほとんどの場合、イベントハンドラーを公開するオブジェクトは、対応するイベントリスナーが追加されたオブジェクトと同じです。しかし、bodyおよびframeset要素はいくつかのイベントハンドラーを公開し、それらは要素のWindowオブジェクトに対して作用します（存在する場合）。いずれの場合でも、このオブジェクトは、イベントハンドラーが作用するターゲットと呼ばれます。

イベントハンドラーのターゲットを決定するために、指定されたEventTargetオブジェクトeventTargetと、イベントハンドラーが公開されているnameを用いて、次の手順が行われます。

  1. eventTargetがbody要素またはframeset要素でない場合、eventTargetを返します。

  2. nameがWindowEventHandlersインターフェイスミックスインの属性メンバーの名前でない場合、およびWindowに反映されるbody要素のイベントハンドラーセットがnameを含んでいない場合、eventTargetを返します。

  3. eventTargetのノードドキュメントがアクティブドキュメントでない場合、nullを返します。

    これは、たとえば対応するbody要素が存在しない場合に発生する可能性があります。

    このチェックは、bodyおよびframeset要素が、ドキュメントのノードドキュメントに接続されていなくても、次のステップに進むことを妨げるわけではありません。特に、アクティブドキュメント内で作成されたが接続されていないbody要素も、対応するWindowオブジェクトが、いくつかのイベントハンドラーのターゲットとして機能する可能性があります。

  4. eventTargetのノードドキュメントの関連するグローバルオブジェクトを返します。

1つ以上のイベントハンドラーが指定されたEventTargetオブジェクトには、関連するイベントハンドラーマップがあります。これは、マップで、名前と、それに対応するイベントハンドラーが含まれています。

1つ以上のイベントハンドラーが指定されたEventTargetオブジェクトが作成されると、そのイベントハンドラーマップが初期化され、そのオブジェクトがターゲットとなる各イベントハンドラーのエントリを含むように設定されます。

エントリの順序は任意です。これは、マップ上で動作するアルゴリズムによって観測可能ではありません。

エントリは、単にそのオブジェクト上に公開されているが、他のオブジェクトをターゲットとしているイベントハンドラーの場合、オブジェクトのイベントハンドラーマップには作成されません。

イベントハンドラーIDL属性は、特定のイベントハンドラーのためのIDL属性です。このIDL属性の名前は、名前と同じです。

イベントハンドラーIDL属性のゲッターは、次の手順を実行します。

  1. このオブジェクトとnameを指定して、イベントハンドラーのターゲットを決定する結果として、eventTargetを取得します。

  2. もしeventTargetがnullである場合、nullを返します。

  3. eventTargetとnameを指定して、イベントハンドラーの現在の値を取得する結果を返します。

イベントハンドラーIDL属性のセッターは、次の手順を実行します。

  1. このオブジェクトとnameを指定して、イベントハンドラーのターゲットを決定する結果として、eventTargetを取得します。

  2. もしeventTargetがnullである場合、処理を終了します。

  3. 指定された値がnullである場合、eventTargetとnameを指定して、イベントハンドラーを無効化します。

  4. それ以外の場合は次の手順を実行します。

    1. eventTargetのイベントハンドラーマップをhandlerMapに設定します。

    2. handlerMap[name]をeventHandlerに設定します。

    3. eventHandlerの値を指定された値に設定します。

    4. eventTargetとnameを指定して、イベントハンドラーを有効化します。

特定のイベントハンドラーIDL属性には追加の要件があります。特に、onmessage属性や、MessagePortオブジェクトの属性です。

イベントハンドラーコンテンツ属性は、特定のイベントハンドラーのためのコンテンツ属性です。このコンテンツ属性の名前は、イベントハンドラーの名前と同じです。

イベントハンドラーコンテンツ属性は、有効なJavaScriptコードを含んでいる必要があり、パース時にFunctionBodyプロダクションに一致しなければなりません。自動セミコロン挿入後に一致する必要があります。

次の属性変更手順は、イベントハンドラーコンテンツ属性とイベントハンドラーを同期させるために使用されます。[DOM]

  1. namespaceがnullでない場合、またはlocalNameがelementのイベントハンドラーコンテンツ属性の名前でない場合は、処理を終了します。

  2. eventTargetを、elementとlocalNameを指定してイベントハンドラーのターゲットを決定する結果として取得します。

  3. もしeventTargetがnullである場合、処理を終了します。

  4. もしvalueがnullである場合、eventTargetとlocalNameを指定してイベントハンドラーを無効化します。

  5. それ以外の場合は次の手順を実行します。

    1. もしコンテンツセキュリティポリシーによって要素のインライン動作がブロックされるかどうかのアルゴリズムが、element、"script attribute"、およびvalueに対して実行されたときに"Blocked"を返す場合、処理を終了します。[CSP]

    2. handlerMapをeventTargetのイベントハンドラーマップに設定します。

    3. eventHandlerをhandlerMap[localName]に設定します。

    4. これらの手順を引き起こしたスクリプトの位置をlocationに設定します。

    5. eventHandlerの値を、value/locationの内部の未コンパイルハンドラーに設定します。

    6. eventTargetとlocalNameを指定してイベントハンドラーを有効化します。

DOM標準に従って、これらの手順はoldValueとvalueが同一の場合でも実行されますが、oldValueとvalueが両方ともnullである場合（現在存在しない属性を削除する場合）は実行されません。[DOM]

イベントハンドラーを無効化するために、eventTargetオブジェクトEventTargetと文字列name（イベントハンドラーの名前）を指定して、次の手順を実行します。

  1. handlerMapをeventTargetのイベントハンドラーマップに設定します。

  2. eventHandlerをhandlerMap[name]に設定します。

  3. eventHandlerの値をnullに設定します。

  4. listenerをeventHandlerのリスナーに設定します。

  5. もしlistenerがnullでない場合、eventTargetとlistenerを指定してイベントリスナーを削除します。

  6. eventHandlerのリスナーをnullに設定します。

すべてのイベントリスナーとハンドラーを消去するために、eventTargetオブジェクトEventTargetを指定して、次の手順を実行します。

  1. もしeventTargetに関連するイベントハンドラーマップが存在する場合、eventTargetの関連するイベントハンドラーマップ内の各name → eventHandlerについて、eventTargetとnameを指定してイベントハンドラーを無効化します。

  2. eventTargetを指定してすべてのイベントリスナーを削除します。

このアルゴリズムは、document.open()を定義するために使用されます。

イベントハンドラーを有効化するために、eventTargetオブジェクトEventTargetと文字列name（イベントハンドラーの名前）を指定して、次の手順を実行します。

  1. handlerMapをeventTargetのイベントハンドラーマップに設定します。

  2. eventHandlerをhandlerMap[name]に設定します。

  3. もしeventHandlerのリスナーがnullでない場合、処理を終了します。

  4. 1つの引数を持つ関数への参照を表すWeb IDL EventListenerインスタンスを作成し、callbackに設定します。この関数はeventTarget、name、およびその引数を指定して、イベントハンドラープロセスアルゴリズムの手順を実行します。

    EventListenerのコールバックコンテキストは任意であり、イベントハンドラープロセスアルゴリズムの手順には影響しません。[DOM]

    このコールバックは、イベントハンドラー自体ではありません。すべてのイベントハンドラーは、以下に定義されている同じアルゴリズムを登録し、正しいコードの呼び出しとその戻り値の処理を行います。

  5. listenerを新しいイベントリスナーに設定します。listenerのタイプはeventHandlerに対応するイベントハンドラーイベントタイプであり、callbackはコールバックです。

    イベントリスナーはEventListenerとは異なるものであることに注意してください。

  6. eventTargetとlistenerを指定してイベントリスナーを追加します。

  7. eventHandlerのリスナーをlistenerに設定します。

イベントリスナーの登録は、イベントハンドラーの値がnull以外に設定されており、無効化されていない場合にのみ行われます。特定のイベントタイプのイベントリスナーの順序は、常に次のようになります。

  1. 最初にaddEventListener()を使用して登録されたイベントリスナー

  2. 次に、現在設定されているコールバック（存在する場合）

  3. そして、最初にイベントハンドラーの値がnull以外に設定された後にaddEventListener()を使用して登録されたイベントリスナー

この例は、イベントリスナーが呼び出される順序を示しています。この例でボタンがユーザーによってクリックされると、ページには"ONE"、"TWO"、"THREE"、"FOUR"という4つのアラートが順に表示されます。 

<button id="test">Start Demo</button>
 <script>
  var button = document.getElementById('test');
  button.addEventListener('click', function () { alert('ONE') }, false);
  button.setAttribute('onclick', "alert('NOT CALLED')"); // event handler listener is registered here
  button.addEventListener('click', function () { alert('THREE') }, false);
  button.onclick = function () { alert('TWO'); };
  button.addEventListener('click', function () { alert('FOUR') }, false);
 </script>

しかし、次の例では、イベントハンドラーが初期の有効化後に無効化され（およびそのイベントリスナーが削除され）、後で再度有効化されます。ページには"ONE"、"TWO"、"THREE"、"FOUR"、"FIVE"という5つのアラートが順に表示されます。 

<button id="test">Start Demo</button>
 <script>
  var button = document.getElementById('test');
  button.addEventListener('click', function () { alert('ONE') }, false);
  button.setAttribute('onclick', "alert('NOT CALLED')"); // event handler is activated here
  button.addEventListener('click', function () { alert('TWO') }, false);
  button.onclick = null;                                 // but deactivated here
  button.addEventListener('click', function () { alert('THREE') }, false);
  button.onclick = function () { alert('FOUR'); };       // and re-activated here
  button.addEventListener('click', function () { alert('FIVE') }, false);
 </script>

イベントオブジェクトによって実装されているインターフェイスは、イベントハンドラーがトリガーされるかどうかには影響しません。

イベントハンドラープロセスアルゴリズムは、eventTargetオブジェクトEventTarget、名前を表す文字列name、およびeventオブジェクトEventに対して次の手順を実行します。

  1. callbackを、eventTargetとnameを指定してイベントハンドラーの現在の値を取得する結果として取得します。

  2. もしcallbackがnullである場合、処理を終了します。

  3. もしeventがErrorEventオブジェクトであり、eventのtypeが"error"であり、eventのcurrentTargetがWindowOrWorkerGlobalScopeミックスインを実装している場合、special error event handlingをtrueに設定します。それ以外の場合は、special error event handlingをfalseに設定します。

  4. eventオブジェクトを次のように処理します。

    もしspecial error event handlingがtrueの場合

    return value を、コールバックを次のように呼び出した結果とします：event の message、event の filename、event の lineno、event の colno、および event の error の値と、"rethrow"、そして callback this value を event の currentTarget に設定します。

    それ以外の場合

    return value を、コールバックを次のように呼び出した結果とします：event、"rethrow"、および callback this value を event の currentTarget に設定します。

    コールバックによって例外がスローされた場合、その例外は再スローされ、これらの手順は終了します。例外はDOMイベントディスパッチロジックに伝播し、報告されます。

  5. return valueを次のように処理します。

    もしeventがBeforeUnloadEventオブジェクトであり、eventのtypeが"beforeunload"である場合

    この場合、イベントハンドラーIDL属性のタイプはOnBeforeUnloadEventHandlerであり、return valueはnullまたはDOMStringに強制されます。

    もしreturn valueがnullでない場合、次の手順を実行します。

    1. eventのキャンセルフラグを設定します。

    2. もしeventのreturnValue属性の値が空文字列である場合、eventのreturnValue属性の値をreturn valueに設定します。

    もしspecial error event handlingがtrueの場合

    もしreturn valueがtrueである場合、eventのキャンセルフラグを設定します。

    それ以外の場合

    もしreturn valueがfalseである場合、eventのキャンセルフラグを設定します。

    もしeventのtypeが"beforeunload"であるためにこの"それ以外の場合"の節に到達した場合、しかしeventがBeforeUnloadEventオブジェクトでない場合、return valueがfalseになることはありません。この場合、return valueはnullまたはDOMStringに強制されます。

イベントハンドラー コールバック 関数タイプは、イベントハンドラーに使用されるコールバックを表します。これは、次のようにWeb IDLで表されます:

[LegacyTreatNonObjectAsNull]
 callback EventHandlerNonNull = any (Event event);
 typedef EventHandlerNonNull? EventHandler;

JavaScriptでは、任意の Function オブジェクトがこのインターフェースを実装します。

例えば、次のドキュメントフラグメントは:

<body onload="alert(this)" onclick="alert(this)">

...ドキュメントが読み込まれると「[object Window]」というアラートが表示され、ページ内の何かをクリックすると「[object HTMLBodyElement]」というアラートが表示されます。

関数の戻り値は、イベントがキャンセルされるかどうかに影響を与えます: 上記のように、戻り値が false である場合、イベントはキャンセルされます。

歴史的な理由から、プラットフォームには2つの例外があります:

歴史的な理由から、onerror ハンドラーには異なる引数があります:

[LegacyTreatNonObjectAsNull]
 callback OnErrorEventHandlerNonNull = any ((Event or DOMString) event, optional DOMString source, optional unsigned long lineno, optional unsigned long colno, optional any error);
 typedef OnErrorEventHandlerNonNull? OnErrorEventHandler;
window.onerror = (message, source, lineno, colno, error) => { … };

同様に、onbeforeunload ハンドラーには異なる戻り値があります:

[LegacyTreatNonObjectAsNull]
 callback OnBeforeUnloadEventHandlerNonNull = DOMString? (Event event);
 typedef OnBeforeUnloadEventHandlerNonNull? OnBeforeUnloadEventHandler;

内部の未コンパイルハンドラーは、以下の情報を含むタプルです:

ユーザーエージェントが、EventTarget オブジェクトeventTargetとイベントハンドラーの名前である文字列nameが与えられた場合に、イベントハンドラーの現在の値を取得するためには、次の手順を実行する必要があります:

  1. handlerMapをeventTargetのイベントハンドラーマップに設定します。

  2. eventHandlerをhandlerMap[name]に設定します。

  3. もしeventHandlerの値が内部の未コンパイルハンドラーである場合、次のステップを実行します:

    1. もしeventTargetが要素であれば、elementをeventTargetに設定し、documentをelementのノードドキュメントに設定します。そうでなければ、eventTargetはWindowオブジェクトであり、elementをnullに設定し、documentをeventTargetの関連付けられたDocumentに設定します。

    2. もしスクリプトが無効である場合、documentに対して、nullを返します。

    3. bodyをeventHandlerの値内の未コンパイルスクリプトボディに設定します。

    4. locationをeventHandlerの値によって与えられる、スクリプトボディの発生元の場所に設定します。

    5. もしelementがnullでなく、elementがフォームオーナーを持っている場合、そのフォームオーナーをform ownerに設定します。そうでなければ、form ownerをnullに設定します。

    6. settings objectをdocumentの関連設定オブジェクトに設定します。

    7. もしbodyがFunctionBodyとしてパース可能でない場合、またはパース中に初期エラーを検出した場合、次のサブステップに従います:

      1. eventHandlerの値をnullに設定します。

        これによって、イベントハンドラーが非アクティブ化されるわけではなく、追加でイベントハンドラーのリスナーの削除（存在する場合）が行われます。

      2. syntaxErrorを、settings objectのレルムに関連付けられた新しいSyntaxError例外に設定します。この例外は、パース中に発生したエラーを記述します。これは、スクリプトボディが発生したlocationに基づくべきです。

      3. 例外を報告し、settings objectのグローバルオブジェクトに対してsyntaxErrorを報告します。

      4. nullを返します。

    8. settings objectのレルム実行コンテキストをJavaScript実行コンテキストスタックにプッシュします。これにより、実行中のJavaScript実行コンテキストとなります。

      これが必要なのは、後続のOrdinaryFunctionCreateの呼び出しが正しいレルムで行われるようにするためです。

    9. functionを、以下の引数を使用してOrdinaryFunctionCreateを呼び出した結果に設定します:

      functionPrototype
      %Function.prototype%
      sourceText
      もしnameがonerrorであり、eventTargetがWindowオブジェクトである場合
      「function 」、name、「(event, source, lineno, colno, error) {」、U+000A LF、body、U+000A LF、および「}」を連結して形成された文字列。
      それ以外の場合
      「function 」、name、「(event) {」、U+000A LF、body、U+000A LF、および「}」を連結して形成された文字列。
      ParameterList
      もしnameがonerrorであり、eventTargetがWindowオブジェクトである場合
      関数には、event、source、lineno、colno、およびerrorという5つの引数が与えられます。
      それ以外の場合
      関数には、eventという単一の引数が与えられます。
      body
      上記のbodyのパース結果。
      thisMode
      non-lexical-this
      scope

      1. realmをsettings objectのレルムに設定します。

      2. scopeをrealmの[[GlobalEnv]]に設定します。

      3. もしeventHandlerが要素のイベントハンドラーである場合、scopeをNewObjectEnvironment(document, true, scope)に設定します。

        （それ以外の場合、eventHandlerはWindowオブジェクトのイベントハンドラーです。）

      4. もしform ownerがnullでなければ、scopeをNewObjectEnvironment(form owner, true, scope)に設定します。

      5. もしelementがnullでなければ、scopeをNewObjectEnvironment(element, true, scope)に設定します。

      6. scopeを返します。

    10. settings objectのレルム実行コンテキストをJavaScript実行コンテキストスタックから削除します。

    11. functionの[[ScriptOrModule]]をnullに設定します。

      これは、スタック上で作成された関数を最も近いスクリプトに関連付けるというデフォルトの動作が、パス依存の結果につながる可能性があるためです。例えば、最初にユーザーの操作で呼び出されたイベントハンドラーは、[[ScriptOrModule]]がnullに設定されます（このアルゴリズムが最初に実行されたとき、アクティブスクリプトがnullである場合）、一方でスクリプトからイベントをディスパッチすることで最初に呼び出されたものは、そのスクリプトに[[ScriptOrModule]]が設定されます。

      代わりに、常に[[ScriptOrModule]]をnullに設定します。これはより直感的です。イベントハンドラーコードに対して最初にイベントをディスパッチするスクリプトが何らかの形で責任を負うという考えは疑わしいです。

      実際には、これはスクリプトのベースURLを参照するHostLoadImportedModuleを介して相対URLの解決にのみ影響します。[[ScriptOrModule]]をnullに設定することで、HostLoadImportedModuleが現在の設定オブジェクトのAPIベースURLにフォールバックすることになります。

    12. eventHandlerの値を、オブジェクト参照がfunctionであり、コールバックコンテキストがsettings objectであるWeb IDLのEventHandlerコールバック関数オブジェクトを作成する結果に設定します。

  4. eventHandlerの値を返します。

8.1.8.2 要素、Document オブジェクト、およびWindow オブジェクトのイベントハンドラー

以下は、すべてのHTML要素 がサポートしなければならないイベントハンドラー（および対応するイベントハンドラーイベントタイプ）です。これらは、イベントハンドラーコンテンツ属性およびイベントハンドラーIDL属性の両方として、またすべてのDocumentおよびWindowオブジェクトがイベントハンドラーIDL属性としてサポートしなければなりません:

イベントハンドラー イベントハンドラーイベントタイプ
onabort

HTMLMediaElement/abort_event

すべての現行エンジンでサポートされています。

Firefox9+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
abort
onauxclick

Element/auxclick_event

Firefox53+SafariNoChrome55+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android53+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
auxclick
onbeforeinput beforeinput
onbeforematch beforematch
onbeforetoggle beforetoggle
oncancel

HTMLDialogElement/cancel_event

すべての現行エンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome AndroidNoWebView Android?Samsung Internet?Opera Android?
cancel
oncanplay

HTMLMediaElement/canplay_event

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
canplay
oncanplaythrough

HTMLMediaElement/canplaythrough_event

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
canplaythrough
onchange

HTMLElement/change_event

すべての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
change
onclick

Element/click_event

すべての現行エンジンでサポートされています。

Firefox6+Safari3+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android6+Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
click
onclose close
oncommand command
oncontextlost contextlost
oncontextmenu contextmenu
oncontextrestored contextrestored
oncopy

Element/copy_event

すべての現在のエンジンでサポートされています。

Firefox22+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
copy
oncuechange

HTMLTrackElement/cuechange_event

すべての現在のエンジンでサポートされています。

Firefox68+Safari10+Chrome32+
Opera19+Edge79+
Edge (Legacy)14+Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android4.4.3+Samsung Internet?Opera Android19+
cuechange
oncut

Element/cut_event

すべての現在のエンジンでサポートされています。

Firefox22+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
cut
ondblclick

Element/dblclick_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS1+Chrome AndroidサポートなしWebView Android?Samsung Internet?Opera Android12.1+
dblclick
ondrag drag
ondragend dragend
ondragenter dragenter
ondragleave dragleave
ondragover dragover
ondragstart dragstart
ondrop drop
ondurationchange

HTMLMediaElement/durationchange_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
durationchange
onemptied

HTMLMediaElement/emptied_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
emptied
onended

HTMLMediaElement/ended_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
ended
onformdata formdata
oninput

HTMLElement/input_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)サポートなしInternet Explorer🔰 9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+
input
oninvalid invalid
onkeydown

Element/keydown_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1.2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
keydown
onkeypress keypress
onkeyup

Element/keyup_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1.2+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
keyup
onloadeddata

HTMLMediaElement/loadeddata_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
loadeddata
onloadedmetadata

HTMLMediaElement/loadedmetadata_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
loadedmetadata
onloadstart

HTMLMediaElement/loadstart_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari4+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
loadstart
onmousedown

Element/mousedown_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari4+Chrome2+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
mousedown
onmouseenter

Element/mouseenter_event

すべての現在のエンジンでサポートされています。

Firefox10+Safari7+Chrome30+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
mouseenter
onmouseleave

Element/mouseleave_event

すべての現在のエンジンでサポートされています。

Firefox10+Safari7+Chrome30+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer5.5+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
mouseleave
onmousemove

Element/mousemove_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari4+Chrome2+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
mousemove
onmouseout

Element/mouseout_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
mouseout
onmouseover

Element/mouseover_event

すべての現在のエンジンでサポートされています。

Firefox3+Safari1+Chrome1+
Opera9.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
mouseover
onmouseup

Element/mouseup_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari4+Chrome2+
Opera11.6+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
mouseup
onpaste

Element/paste_event

すべての現在のエンジンでサポートされています。

Firefox22+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
paste
onpause

HTMLMediaElement/pause_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
pause
onplay

HTMLMediaElement/play_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
play
onplaying

HTMLMediaElement/playing_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
playing
onprogress

HTMLMediaElement/progress_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
progress
onratechange

HTMLMediaElement/ratechange_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
ratechange
onreset reset
onscrollend

Document/scrollend_event

Firefox109+SafariなしChrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Element/scrollend_event

Firefox109+SafariなしChrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
scrollend
onsecuritypolicyviolation

Element/securitypolicyviolation_event

全ての現在のエンジンでサポートされています。

Firefox63+Safari10+Chrome41+
Opera?Edge79+
Edge (Legacy)15+Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
securitypolicyviolation
onseeked

HTMLMediaElement/seeked_event

全ての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
seeked
onseeking

HTMLMediaElement/seeking_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
seeking
onselect

HTMLInputElement/select_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLTextAreaElement/select_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
select
onslotchange

HTMLSlotElement/slotchange_event

すべての現在のエンジンでサポートされています。

Firefox63+Safari10.1+Chrome53+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
slotchange
onstalled

HTMLMediaElement/stalled_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
stalled
onsubmit

HTMLFormElement/submit_event

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
submit
onsuspend

HTMLMediaElement/suspend_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
suspend
ontimeupdate

HTMLMediaElement/timeupdate_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome3+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
timeupdate
ontoggle toggle
onvolumechange

HTMLMediaElement/volumechange_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
volumechange
onwaiting

HTMLMediaElement/waiting_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
waiting
onwebkitanimationend webkitAnimationEnd
onwebkitanimationiteration webkitAnimationIteration
onwebkitanimationstart webkitAnimationStart
onwebkittransitionend webkitTransitionEnd
onwheel

Element/wheel_event

すべての現在のエンジンでサポートされています。

Firefox17+Safari7+Chrome31+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOSサポートなしChrome Android?WebView Android?Samsung Internet?Opera Android?
wheel

以下は、すべてのイベント ハンドラー（およびその対応するイベント ハンドラーイベントタイプ）で、すべてのHTML 要素がサポートする必要があるものです。ただし、body およびframeset 要素は除きます。すべてのイベント ハンドラーコンテンツ属性およびイベント ハンドラーIDL属性がサポートされる必要があります。すべてのDocument オブジェクト、およびすべてのイベント ハンドラーIDL属性がサポートされる必要があります。すべてのWindow オブジェクト、およびイベント ハンドラーIDL属性がサポートされる必要があります。Window オブジェクト自身で、対応するイベント ハンドラーコンテンツ属性およびイベント ハンドラーIDL属性が公開される必要があります。すべてのbody およびframeset 要素は、そのWindow オブジェクトの関連する Documentに属します。

イベントハンドラー イベントハンドラーイベントタイプ
onblur

Element/blur_event

すべての現在のエンジンでサポートされています。

Firefox24+Safari3.1+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Window/blur_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5.1+Chrome5+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
blur
onerror

Window/error_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5.1+Chrome10+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
error
onfocus

Element/focus_event

すべての現在のエンジンでサポートされています。

Firefox24+Safari3.1+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

Window/focus_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5.1+Chrome5+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
focus
onload load
onresize resize
onscroll

Document/scroll_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari2+Chrome1+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

Element/scroll_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1.3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
scroll

このテーブルの最初の列にリストされている名前のイベントハンドラーのセットを、Window反映ボディ要素イベントハンドラーセットと呼びます。

以下は、Window オブジェクトによってサポートされるべき イベントハンドラー（およびそれに対応する イベントハンドラーイベントタイプ）であり、Window オブジェクト自体の イベントハンドラー IDL 属性 およびすべての body および frameset 要素に公開される対応する イベントハンドラーコンテンツ属性 および イベントハンドラー IDL 属性 です。

イベントハンドラー イベントハンドラーイベントタイプ
onafterprint

Window/afterprint_event

全ての現行エンジンでサポートされています。

Firefox6+Safari13+Chrome63+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
afterprint
onbeforeprint

Window/beforeprint_event

全ての現行エンジンでサポートされています。

Firefox6+Safari13+Chrome63+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
beforeprint
onbeforeunload

Window/beforeunload_event

全ての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12+
beforeunload
onhashchange

Window/hashchange_event

全ての現行エンジンでサポートされています。

Firefox3.6+Safari5+Chrome8+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
hashchange
onlanguagechange

Window/languagechange_event

全ての現行エンジンでサポートされています。

Firefox32+Safari10.1+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet Explorer対応していません
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet4.0+Opera Android?
languagechange
onmessage

Window/message_event

全ての現行エンジンでサポートされています。

Firefox9+Safari4+Chrome60+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS4+Chrome Android?WebView Android?Samsung Internet?Opera Android47+
message
onmessageerror

HTMLMediaElement/error_event

全ての現行エンジンでサポートされています。

Firefox6+Safari3.1+Chrome3+
Opera11.6+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

Window/messageerror_event

全ての現行エンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+
messageerror
onoffline

Window/offline_event

全ての現行エンジンでサポートされています。

Firefox9+Safari4+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
offline
ononline

Window/online_event

全ての現行エンジンでサポートされています。

Firefox9+Safari4+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
online
onpageswap pageswap
onpagehide pagehide
onpagereveal pagereveal
onpageshow pageshow
onpopstate

Window/popstate_event

全ての現行エンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+
popstate
onrejectionhandled

Window/rejectionhandled_event

全ての現行エンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera?Edge79+
Edge (Legacy)?Internet Explorer対応していません
Firefox Android?Safari iOS11.3+Chrome Android?WebView Android?Samsung Internet?Opera Android?
rejectionhandled
onstorage

Window/storage_event

全ての現行エンジンでサポートされています。

Firefox45+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)15+Internet Explorer9+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
storage
onunhandledrejection

Window/unhandledrejection_event

全ての現行エンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera?Edge79+
Edge (Legacy)?Internet Explorer対応していません
Firefox Android?Safari iOS11.3+Chrome Android?WebView Android?Samsung Internet?Opera Android?
unhandledrejection
onunload

Window/unload_event

全ての現行エンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
unload

このイベント ハンドラーのリストは、イベント ハンドラー IDL 属性として、WindowEventHandlers インターフェースミキシンとして具現化されます。

次に示すのは、イベント ハンドラー（およびその対応するイベント ハンドラーイベントタイプ）で、Document オブジェクト上でサポートされる必要があるイベント ハンドラー IDL 属性です：

イベント ハンドラー イベント ハンドラーイベントタイプ
onreadystatechange readystatechange
onvisibilitychange

Document/visibilitychange_event

全ての現行エンジンでサポートされています。

Firefox56+Safari14.1+Chrome62+
Opera49+Edge79+
Edge (Legacy)18Internet Explorer🔰 10+
Firefox Android?Safari iOS?Chrome Android?WebView Android62+Samsung Internet?Opera Android46+
visibilitychange
8.1.8.2.1 IDL 定義
interface mixin GlobalEventHandlers {
  attribute EventHandler onabort;
  attribute EventHandler onauxclick;
  attribute EventHandler onbeforeinput;
  attribute EventHandler onbeforematch;
  attribute EventHandler onbeforetoggle;
  attribute EventHandler onblur;
  attribute EventHandler oncancel;
  attribute EventHandler oncanplay;
  attribute EventHandler oncanplaythrough;
  attribute EventHandler onchange;
  attribute EventHandler onclick;
  attribute EventHandler onclose;
  attribute EventHandler oncommand;
  attribute EventHandler oncontextlost;
  attribute EventHandler oncontextmenu;
  attribute EventHandler oncontextrestored;
  attribute EventHandler oncopy;
  attribute EventHandler oncuechange;
  attribute EventHandler oncut;
  attribute EventHandler ondblclick;
  attribute EventHandler ondrag;
  attribute EventHandler ondragend;
  attribute EventHandler ondragenter;
  attribute EventHandler ondragleave;
  attribute EventHandler ondragover;
  attribute EventHandler ondragstart;
  attribute EventHandler ondrop;
  attribute EventHandler ondurationchange;
  attribute EventHandler onemptied;
  attribute EventHandler onended;
  attribute OnErrorEventHandler onerror;
  attribute EventHandler onfocus;
  attribute EventHandler onformdata;
  attribute EventHandler oninput;
  attribute EventHandler oninvalid;
  attribute EventHandler onkeydown;
  attribute EventHandler onkeypress;
  attribute EventHandler onkeyup;
  attribute EventHandler onload;
  attribute EventHandler onloadeddata;
  attribute EventHandler onloadedmetadata;
  attribute EventHandler onloadstart;
  attribute EventHandler onmousedown;
  [LegacyLenientThis] attribute EventHandler onmouseenter;
  [LegacyLenientThis] attribute EventHandler onmouseleave;
  attribute EventHandler onmousemove;
  attribute EventHandler onmouseout;
  attribute EventHandler onmouseover;
  attribute EventHandler onmouseup;
  attribute EventHandler onpaste;
  attribute EventHandler onpause;
  attribute EventHandler onplay;
  attribute EventHandler onplaying;
  attribute EventHandler onprogress;
  attribute EventHandler onratechange;
  attribute EventHandler onreset;
  attribute EventHandler onresize;
  attribute EventHandler onscroll;
  attribute EventHandler onscrollend;
  attribute EventHandler onsecuritypolicyviolation;
  attribute EventHandler onseeked;
  attribute EventHandler onseeking;
  attribute EventHandler onselect;
  attribute EventHandler onslotchange;
  attribute EventHandler onstalled;
  attribute EventHandler onsubmit;
  attribute EventHandler onsuspend;
  attribute EventHandler ontimeupdate;
  attribute EventHandler ontoggle;
  attribute EventHandler onvolumechange;
  attribute EventHandler onwaiting;
  attribute EventHandler onwebkitanimationend;
  attribute EventHandler onwebkitanimationiteration;
  attribute EventHandler onwebkitanimationstart;
  attribute EventHandler onwebkittransitionend;
  attribute EventHandler onwheel;
};

interface mixin WindowEventHandlers {
  attribute EventHandler onafterprint;
  attribute EventHandler onbeforeprint;
  attribute OnBeforeUnloadEventHandler onbeforeunload;
  attribute EventHandler onhashchange;
  attribute EventHandler onlanguagechange;
  attribute EventHandler onmessage;
  attribute EventHandler onmessageerror;
  attribute EventHandler onoffline;
  attribute EventHandler ononline;
  attribute EventHandler onpagehide;
  attribute EventHandler onpagereveal;
  attribute EventHandler onpageshow;
  attribute EventHandler onpageswap;
  attribute EventHandler onpopstate;
  attribute EventHandler onrejectionhandled;
  attribute EventHandler onstorage;
  attribute EventHandler onunhandledrejection;
  attribute EventHandler onunload;
};
8.1.8.3 イベントの発火

特定の操作やメソッドは、要素上でイベントを発火させるように定義されています。例えば、click() メソッドは HTMLElement インターフェイス上で、要素上で click イベントを発火させるように定義されています。[UIEVENTS]

名前が e の合成ポインターイベントを target に発火させる ことは、次のステップを実行することを意味します:

  1. event を イベントを作成する ことにより取得します。PointerEvent を使用します。

  2. event の type 属性を e に初期化します。

  3. event の bubbles と cancelable 属性を true に初期化します。

  4. event の composed flag を設定します。

  5. not trusted flag が設定されている場合、event の isTrusted 属性を false に初期化します。

  6. event の ctrlKey、shiftKey、altKey、および metaKey 属性を、現在のキー入力デバイスの状態に応じて初期化します（利用できないキーは false）。

  7. event の view 属性を、target の ノードドキュメント の Window オブジェクトに初期化します。もし存在しない場合は null にします。

  8. event の getModifierState() メソッドが、キー入力デバイスの現在の状態を適切に説明する値を返すようにします。

  9. event を target に対して ディスパッチする 結果を返します。

click イベントを発火させる ことは、target に対して 名前が click の合成ポインターイベントを発火させる ことを意味します。

8.2 WindowOrWorkerGlobalScope ミキシン

WindowOrWorkerGlobalScope ミキシンは、Window および WorkerGlobalScope オブジェクト上で公開されるAPIに使用されます。

他の標準は、partial interface mixin WindowOrWorkerGlobalScope { … }; を使用してさらに拡張し、適切な参照を追加することが推奨されます。

typedef (DOMString or Function or TrustedScript) TimerHandler;

interface mixin WindowOrWorkerGlobalScope {
  [Replaceable] readonly attribute USVString origin;
  readonly attribute boolean isSecureContext;
  readonly attribute boolean crossOriginIsolated;

  undefined reportError(any e);

  // base64 utility methods
  DOMString btoa(DOMString data);
  ByteString atob(DOMString data);

  // timers
  long setTimeout(TimerHandler handler, optional long timeout = 0, any... arguments);
  undefined clearTimeout(optional long id = 0);
  long setInterval(TimerHandler handler, optional long timeout = 0, any... arguments);
  undefined clearInterval(optional long id = 0);

  // microtask queuing
  undefined queueMicrotask(VoidFunction callback);

  // ImageBitmap
  Promise<ImageBitmap> createImageBitmap(ImageBitmapSource image, optional ImageBitmapOptions options = {});
  Promise<ImageBitmap> createImageBitmap(ImageBitmapSource image, long sx, long sy, long sw, long sh, optional ImageBitmapOptions options = {});

  // structured cloning
  any structuredClone(any value, optional StructuredSerializeOptions options = {});
};
Window includes WindowOrWorkerGlobalScope;
WorkerGlobalScope includes WindowOrWorkerGlobalScope;
self.isSecureContext

isSecureContext

全ての現在のエンジンでサポートされています。

Firefox49+Safari11.1+Chrome47+
Opera?Edge79+
Edge (Legacy)15+Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

このグローバルオブジェクトがセキュアコンテキストを表しているかどうかを返します。 [SECURE-CONTEXTS]

self.origin

origin

全ての現在のエンジンでサポートされています。

Firefox54+Safari11+Chrome59+
Opera?Edge79+
Edge (Legacy)18Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

グローバルオブジェクトの起源を、文字列としてシリアライズして返します。

self.crossOriginIsolated

crossOriginIsolated

全ての現在のエンジンでサポートされています。

Firefox72+Safari15.2+Chrome87+
Opera?Edge87+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

このグローバルで実行されているスクリプトが、クロスオリジン隔離を必要とするAPIを使用することが許可されているかどうかを返します。これは、`Cross-Origin-Opener-Policy` と `Cross-Origin-Embedder-Policy` HTTP応答ヘッダー、および"cross-origin-isolated" 機能に依存します。

開発者には、self.originの使用が強く推奨されます。 location.originよりも。 前者は環境の起源を返し、 後者は環境のURLを返します。次のスクリプトが https://stargate.example/のドキュメントで実行されることを想像してください: 

var frame = document.createElement("iframe")
 frame.onload = function() {
   var frameWin = frame.contentWindow
   console.log(frameWin.location.origin) // "null"
   console.log(frameWin.origin) // "https://stargate.example"
 }
 document.body.appendChild(frame)

self.origin は、より信頼性の高いセキュリティインジケーターです。

isSecureContext のゲッター手順は、this の 関連設定オブジェクト が セキュアコンテキスト である場合に true を返し、それ以外の場合は false を返します。

origin のゲッター手順は、this の 関連設定オブジェクト の オリジン を シリアライズ された形式で返します。

crossOriginIsolated のゲッター手順は、this の 関連設定オブジェクト の クロスオリジンアイソレーテッド機能 を返します。

8.3 Base64ユーティリティメソッド

atob()およびbtoa()メソッドは、開発者がコンテンツをBase64エンコーディングに変換したり、その逆に変換したりすることを可能にします。

これらのAPIでは、覚えやすくするために、「b」は「バイナリ」を、「a」は「ASCII」を表すと考えることができます。ただし、実際には、主に歴史的な理由から、これらの関数の入力と出力はUnicode文字列です。

result = self.btoa(data)

btoa

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

Unicode文字列形式の入力データを受け取り、その各文字がそれぞれ値0x00から0xFFのバイナリバイトを表す範囲U+0000からU+00FF内に収まるように、入力データをBase64表現に変換し、結果を返します。

入力文字列に範囲外の文字が含まれている場合は、"InvalidCharacterError" DOMExceptionをスローします。

result = self.atob(data)

atob

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

Base64エンコードされたバイナリデータを含むUnicode文字列形式の入力データを受け取り、それをデコードして、対応するバイナリデータを表すU+0000からU+00FFの範囲内の文字からなる文字列を返します。

入力文字列が有効なBase64データでない場合は、"InvalidCharacterError" DOMExceptionをスローします。

btoa(data)メソッドは、dataにU+00FFを超えるコードポイントを持つ文字が含まれている場合、"InvalidCharacterError" DOMExceptionをスローしなければなりません。それ以外の場合、ユーザーエージェントはdataをn番目のコードポイントの8ビット表現がn番目のバイトとなるバイトシーケンスに変換し、次にそのバイトシーケンスにforgiving-base64 encodeを適用して結果を返さなければなりません。

atob(data)メソッドの手順は以下の通りです。

  1. decodedDataを、dataにforgiving-base64 decodeを適用した結果とします。

  2. もしdecodedDataが失敗した場合は、"InvalidCharacterError" DOMExceptionをスローします。

  3. decodedDataを返します。

8.4 動的マークアップ挿入

ドキュメントに動的にマークアップを挿入するためのAPIはパーサーと相互作用するため、それらの動作はHTMLドキュメント（およびHTMLパーサー） とXMLドキュメント（およびXMLパーサー）で使用されるかどうかによって異なります。

Documentオブジェクトには、動的マークアップ挿入時の例外カウンターがあり、 これはトークンに対する要素の作成 アルゴリズムと併用されて、 カスタム要素のコンストラクターが パーサーによって呼び出されたときに、document.open()、 document.close()、 およびdocument.write()を使用できないようにするために使用されます。 初期状態では、カウンターはゼロに設定されなければなりません。

8.4.1 入力ストリームのオープン

document = document.open()

Document/open

すべての現在のエンジンでサポートされています。

Firefox1+Safari11+Chrome64+
Opera51+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

Documentを、その場で新しいDocumentオブジェクトとして置き換えますが、以前のオブジェクトを再利用して、その結果が返されます。

結果として得られるDocumentには、HTMLパーサーが関連付けられており、document.write()を使用して解析するデータを与えることができます。

このメソッドは、Documentがまだ解析中の場合は効果がありません。

DocumentがXMLドキュメントである場合は、"InvalidStateError" DOMException例外がスローされます。

パーサーが現在カスタム要素のコンストラクターを実行している場合は、"InvalidStateError" DOMException例外がスローされます。

window = document.open(url, name, features)

window.open()メソッドのように動作します。

Documentオブジェクトには、アクティブパーサーが中止されたというブール値があり、これはドキュメントのアクティブパーサーが中止された後、スクリプトがdocument.open()およびdocument.write()メソッドを（直接的または間接的に）呼び出すのを防ぐために使用されます。初期状態では、この値はfalseです。

documentを与えられた場合のdocument open stepsは、次の通りです:

  1. もし document が XML ドキュメント である場合、"InvalidStateError" DOMException をスローする。

  2. もし document の 動的マークアップ挿入に対するスロー・カウンター が 0 より大きい場合、"InvalidStateError" DOMException をスローする。

  3. entryDocument を エントリーグローバルオブジェクト の 関連付けられた Document とする。

  4. もし document の オリジン が entryDocument の オリジン と異なる場合、"SecurityError" DOMException をスローする。

  5. もし document に アクティブなパーサー があり、その スクリプトネスティングレベル が 0 より大きい場合は、document を返す。

    これにより、document.open() がパーシング中に見つかったインラインスクリプトで呼び出された場合は無視されますが、タイマーコールバックやイベントハンドラーなどの非パーサータスクから呼び出された場合は効果があります。

  6. 同様に、もし document の アンロードカウンター が 0 より大きい場合は、document を返す。

    これにより、document.open() が beforeunload、pagehide、または unload イベントハンドラーから呼び出された場合に、Document がアンロードされる間に無視されます。

  7. もし document の アクティブなパーサーが中断された が true である場合、document を返す。

    これは特に、ナビゲーション が開始された後、しかし初期パース中のみ document.open() が呼び出された場合に無視されることを引き起こします。詳しい背景については issue #4723 を参照してください。

  8. もし document の ノード・ナビゲイブル が null でなく、document の ノード・ナビゲイブル の 進行中のナビゲーション が ナビゲーションID である場合、読み込みを停止 し、document の ノード・ナビゲイブル を停止する。

  9. それぞれの シャドウを含む包括的な子孫 node について、document に与えられた すべてのイベントリスナーとハンドラーを消去する。

  10. もし document が document の 関連するグローバルオブジェクト の 関連付けられた Document である場合、document の 関連するグローバルオブジェクト に与えられた すべてのイベントリスナーとハンドラーを消去する。

  11. document 内を null で すべて置き換える。

  12. もし document が 完全にアクティブ である場合、次の処理を行う:

    1. newURL を entryDocument の URL のコピーとする。

    2. もし entryDocument が document でない場合、newURL の フラグメント を null に設定する。

    3. URL と履歴の更新手順 を document と newURL を用いて実行する。

  13. document の 初期状態 about:blank である を false に設定する。

  14. もし document の iframe の読み込みが進行中 フラグが設定されている場合、document の iframe の読み込みをミュートする フラグを設定する。

  15. document を ノークォークモード に設定する。

  16. 新しい HTML パーサー を作成し、それを document に関連付ける。これは スクリプトで作成されたパーサー であり、document.open() や document.close() メソッドによって閉じることができ、トークナイザは document.close() の明示的な呼び出しを待ってからファイルの終端トークンを発行する。エンコーディングの 信頼度 は 関係ない。

  17. 挿入ポイント を 入力ストリーム の終わり直前を指すように設定する（この時点で空になる）。

  18. 現在のドキュメントの準備状況を更新する を document に "loading" と設定する。

    これにより、readystatechange イベントが発生しますが、前のステップで すべてのイベントリスナーとハンドラーを消去する ことで、著者コードからは実際には観察できません。

  19. document を返す。

document open stepsは、Documentがポストロードタスクの準備ができているか、完全にロードされたかどうかに影響を与えません。

open(unused1, unused2)メソッドは、document open stepsをthisで実行した結果を返さなければなりません。

unused1およびunused2引数は無視されますが、1つまたは2つの引数で関数を呼び出すコードが引き続き動作するようにIDLに残されています。これは、Web IDLのオーバーロード解決アルゴリズムのルールにより、引数がないとそのような呼び出しに対してTypeError例外がスローされるためです。whatwg/webidl issue #581は、それらの削除を可能にするためのアルゴリズムの変更を調査しています。[WEBIDL]

open(url, name, features)メソッドは、次の手順を実行する必要があります。

  1. thisが完全にアクティブでない場合は、"InvalidAccessError" DOMException例外をスローします。

  2. url、name、およびfeaturesを使用してウィンドウオープン手順を実行した結果を返します。

8.4.2 入力ストリームのクローズ

document.close()

Document/close

すべての現在のエンジンでサポートされています。

Firefox1+Safari11+Chrome64+
Opera51+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

document.open()メソッドで開かれた入力ストリームを閉じます。

DocumentがXMLドキュメントである場合は、"InvalidStateError" DOMException例外をスローします。

パーサーが現在カスタム要素のコンストラクターを実行している場合は、"InvalidStateError" DOMException例外をスローします。

close()メソッドは、次の手順を実行する必要があります。

  1. thisがXMLドキュメントである場合、"InvalidStateError" DOMException例外をスローします。

  2. thisの動的マークアップ挿入時の例外カウンターが0より大きい場合は、"InvalidStateError" DOMException例外をスローします。

  3. スクリプト作成パーサーがthisに関連付けられていない場合、何もしないで返します。

  4. パーサーの入力ストリームの終わりに明示的な「EOF」キャラクターを挿入します。

  5. thisの保留中の解析ブロックスクリプトがnullでない場合、何もしないで返します。

  6. トークナイザーを実行し、トークナイザーが明示的な「EOF」キャラクターに達するか、イベントループをスピンするまでトークンを処理します。

8.4.3 document.write()

document.write(...text)

Document/write

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

一般的に、指定された文字列をDocumentの入力ストリームに追加します。

このメソッドは非常に独特な挙動を示します。場合によっては、このメソッドが実行中のHTMLパーサーの状態に影響を与え、ドキュメントに対応しないDOMが生成されることがあります（例えば、書き込まれた文字列が"<plaintext>"や"<!--"の場合）。他の場合では、document.open()が呼び出されたかのように、ページ全体がクリアされることがあります。また、このメソッドが単に無視される、あるいは例外をスローすることもあります。ユーザーエージェントは、このメソッドを介して挿入されたscript要素の実行を明示的に回避することが許可されています。さらに悪いことに、このメソッドの正確な動作はネットワーク遅延に依存することがあり、その結果、デバッグが非常に困難な失敗を引き起こす可能性があります。これらすべての理由から、このメソッドの使用は強く推奨されません。

XMLドキュメントに対して呼び出された場合、"InvalidStateError" DOMExceptionをスローします。

パーサーが現在カスタム要素のコンストラクターを実行している場合、"InvalidStateError" DOMExceptionがスローされます。

このメソッドは、scriptやイベントハンドラーコンテンツ属性などの潜在的に危険な要素や属性を削除するためのサニタイズを行いません。

Documentオブジェクトには、破壊的書き込みを無視するカウンターがあり、これはscript要素の処理と併用され、外部スクリプトがdocument.write()を使用してdocument.open()を暗黙的に呼び出すことによってドキュメントを破壊できないようにするために使用されます。初期状態では、このカウンターはゼロに設定されなければなりません。

documentというDocumentオブジェクト、リストtext、ブール値lineFeed、および文字列sinkが与えられた場合のdocument write stepsは、次の通りです:

  1. stringを空の文字列にします。

  2. textが文字列を含む場合はisTrustedをfalseに、それ以外の場合はtrueに設定します。

  3. textのvalueごとに次の操作を行います:

    1. valueがTrustedHTMLオブジェクトである場合、その関連するデータをstringに追加します。

    2. それ以外の場合、valueをstringに追加します。

  4. isTrustedがfalseである場合、TrustedHTML、thisの関連するグローバルオブジェクト、string、sink、および"script"を使用してTrusted Type対応文字列取得アルゴリズムを呼び出した結果をstringに設定します。

  5. lineFeedがtrueである場合、U+000A LINE FEEDをstringに追加します。

  6. documentがXMLドキュメントである場合、"InvalidStateError" DOMExceptionをスローします。

  7. documentの動的マークアップ挿入時の例外カウンターが0より大きい場合、"InvalidStateError" DOMExceptionをスローします。

  8. documentのアクティブパーサーが中止されたがtrueである場合、何もせずに返します。

  9. 挿入ポイントが未定義である場合、次の操作を行います:

    1. documentのアンロードカウンターが0より大きい場合、またはdocumentの破壊的書き込みを無視するカウンターが0より大きい場合、何もせずに返します。

    2. documentを使用してdocument open stepsを実行します。

  10. stringを挿入ポイントの直前の入力ストリームに挿入します。

  11. documentの保留中の解析ブロックスクリプトがnullの場合、HTMLパーサーによりstringを1コードポイントずつ処理し、トークナイザーが挿入ポイントに達するか、ツリー構築段階でトークナイザーによる処理が中止されるまでトークンを処理します（これはトークナイザーがscriptの終了タグトークンを生成した場合に発生する可能性があります）。

    もしdocument.write()メソッドがインラインで実行されるスクリプト（すなわち、パーサーがscriptタグを解析したために実行されるスクリプト）から呼び出された場合、これはパーサーの再入呼び出しです。パーサー一時停止フラグが設定されている場合、トークナイザーは直ちに中止し、トークナイザーのパーサー一時停止フラグチェックに従って、HTMLは解析されません。

document.write(...text)メソッドの手順は、this、text、false、および"Document write"を使用してdocument write stepsを実行することです。

8.4.4 document.writeln()

document.writeln(...text)

Document/writeln

すべての現在のエンジンでサポートされています。

Firefox1+Safari11+Chrome64+
Opera51+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

指定された文字列をDocumentの入力ストリームに追加し、その後に改行文字を追加します。必要に応じて、最初にopen()メソッドを暗黙的に呼び出します。

XMLドキュメントで呼び出された場合は、"InvalidStateError" DOMExceptionをスローします。

パーサーが現在カスタム要素のコンストラクターを実行している場合は、"InvalidStateError" DOMExceptionをスローします。

このメソッドは、scriptやイベントハンドラーコンテンツ属性のような潜在的に危険な要素や属性を削除するためのサニタイズを行いません。

document.writeln(...text)メソッドの手順は、this、text、true、および"Document writeln"を使用してdocument write stepsを実行することです。

8.5 DOM解析およびシリアライゼーション API

DOMParser

すべての現在のエンジンでサポートされています。

Firefox1+Safari1.3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+ 
partial interface Element {
   [CEReactions] undefined setHTMLUnsafe((TrustedHTML or DOMString) html);
   DOMString getHTML(optional GetHTMLOptions options = {});
 
   [CEReactions] attribute (TrustedHTML or [LegacyNullToEmptyString] DOMString) innerHTML;
   [CEReactions] attribute (TrustedHTML or [LegacyNullToEmptyString] DOMString) outerHTML;
   [CEReactions] undefined insertAdjacentHTML(DOMString position, (TrustedHTML or DOMString) string);
 };
 
 partial interface ShadowRoot {
   [CEReactions] undefined setHTMLUnsafe((TrustedHTML or DOMString) html);
   DOMString getHTML(optional GetHTMLOptions options = {});
 
   [CEReactions] attribute (TrustedHTML or [LegacyNullToEmptyString] DOMString) innerHTML;
 };
 
 dictionary GetHTMLOptions {
   boolean serializableShadowRoots = false;
   sequence<ShadowRoot> shadowRoots = [];
 };

8.5.1 DOMParserインターフェイス

DOMParserインターフェイスは、文字列をHTMLまたはXMLとして解析することで、新しいDocumentオブジェクトを作成できるようにします。

parser = new DOMParser()

DOMParser/DOMParser

すべての現在のエンジンでサポートされています。

Firefox1+Safari1.3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

新しいDOMParserオブジェクトを構築します。

document = parser.parseFromString(string, type)

DOMParser/parseFromString

すべての現在のエンジンでサポートされています。

Firefox1+Safari1.3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

typeに応じて、stringをHTMLまたはXMLパーサーで解析し、結果として得られるDocumentを返します。typeには"text/html"（HTMLパーサーを呼び出す）や、"text/xml"、"application/xml"、"application/xhtml+xml"、"image/svg+xml"（XMLパーサーを呼び出す）のいずれかを指定できます。

XMLパーサーの場合、stringが解析できない場合、返されるDocumentには、結果として得られるエラーを示す要素が含まれます。

解析中にscript要素は評価されず、結果として得られるドキュメントのエンコーディングは常にUTF-8になります。ドキュメントのURLはparserの関連するグローバルオブジェクトから継承されます。

上記以外のtypeの値を指定すると、TypeError例外がスローされます。

DOMParserが、クラスとして構築され、そのparseFromString()メソッドが呼び出される必要があるという設計は、不幸な歴史的遺物です。この機能を今日設計しているのであれば、これはスタンドアロン関数になるでしょう。HTMLを解析する場合、現代的な代替手段はDocument.parseHTMLUnsafe()です。

このメソッドは、scriptやイベントハンドラーコンテンツ属性のような潜在的に危険な要素や属性を削除するためのサニタイズを行いません。 

[Exposed=Window]
interface DOMParser {
  constructor();

  [NewObject] Document parseFromString((TrustedHTML or DOMString) string, DOMParserSupportedType type);
};

enum DOMParserSupportedType {
  "text/html",
  "text/xml",
  "application/xml",
  "application/xhtml+xml",
  "image/svg+xml"
};

new DOMParser()コンストラクタの手順は、何も行わないことです。

parseFromString(string, type)メソッドの手順は次のとおりです:

  1. compliantStringを、TrustedHTML、thisの関連するグローバルオブジェクト、string、"DOMParser parseFromString"および"script"を用いてTrusted Type対応文字列取得アルゴリズムを呼び出した結果として得ます。

  2. 新しいdocumentを作成します。Documentで、コンテンツタイプはtypeであり、URLは、thisの関連するグローバルオブジェクトの関連するDocumentのURLになります。

    ドキュメントのエンコーディングはデフォルトのUTF-8のままにされます。特に、compliantStringの解析中に見つかったXML宣言やmeta要素は、エンコーディングに影響を与えません。

  3. typeに基づいてスイッチします:

    "text/html"

    1. documentとcompliantStringを指定して、文字列からHTMLを解析します。

    documentにはブラウジングコンテキストがないため、スクリプティングは無効です。

    その他

    1. documentに関連付けられたparserを用いて、XMLパーサーを作成し、XMLスクリプティングサポートを無効化します。

    2. parserを使用してcompliantStringを解析します。

    3. 前の手順でXMLの整形式またはXML名前空間の整形式エラーが発生した場合は:

      1. アサート：documentには子ノードがありません。

      2. documentを指定し、"parsererror"および"http://www.mozilla.org/newlayout/xml/parsererror.xml"を用いて要素を作成し、rootを得ます。

      3. オプションで、rootに属性や子要素を追加して、解析エラーの内容を説明します。

      4. rootをdocumentに追加します。

  4. documentを返します。

文字列からHTMLを解析するには、Documentのdocumentと文字列のhtmlを指定します:

  1. documentのタイプを"html"に設定します。

  2. documentに関連付けられたparserを用いて、HTMLパーサーを作成します。

  3. parserの入力ストリームにhtmlを配置します。エンコーディングの信頼性は無関係です。

  4. parserを起動し、入力ストリームに挿入されたすべての文字を消費するまで実行します。

    この操作により、ドキュメントのモードが変更される可能性があります。

8.5.2 危険なHTML解析メソッド

element.setHTMLUnsafe(html)

htmlをHTMLパーサーを使用して解析し、その結果でelementの子を置き換えます。elementはHTMLパーサーにコンテキストを提供します。

shadowRoot.setHTMLUnsafe(html)

htmlをHTMLパーサーを使用して解析し、その結果でshadowRootの子を置き換えます。shadowRootのホストはHTMLパーサーにコンテキストを提供します。

doc = Document.parseHTMLUnsafe(html)

htmlをHTMLパーサーを使用して解析し、結果として得られるDocumentを返します。

script要素は解析中に評価されず、結果として得られるドキュメントのエンコーディングは常にUTF-8になります。ドキュメントのURLはabout:blankになります。

これらのメソッドは、scriptやイベントハンドラーコンテンツ属性のような潜在的に危険な要素や属性を削除するためのサニタイズを行いません。

ElementのsetHTMLUnsafe(html)メソッドの手順は次のとおりです:

  1. compliantHTMLを、TrustedHTML、thisの関連するグローバルオブジェクト、html、"Element setHTMLUnsafe"および"script"を用いてTrusted Type対応文字列取得アルゴリズムを呼び出した結果として得ます。

  2. targetを、thisがtemplate要素である場合はテンプレートのコンテンツ、それ以外の場合はthisに設定します。

  3. 危険なHTML設定をtarget、this、およびcompliantHTMLを指定して行います。

ShadowRootのsetHTMLUnsafe(html)メソッドの手順は次のとおりです:

  1. compliantHTMLを、TrustedHTML、thisの関連するグローバルオブジェクト、html、"ShadowRoot setHTMLUnsafe"および"script"を用いてTrusted Type対応文字列取得アルゴリズムを呼び出した結果として得ます。

  2. 危険なHTML設定をthis、thisのシャドウホスト、およびcompliantHTMLを指定して行います。

危険なHTML設定には、ElementまたはDocumentFragmentのtarget、ElementのcontextElement、および文字列のhtmlを指定します:

  1. newChildrenをHTMLフラグメント解析アルゴリズムを用いて、contextElement、html、およびtrueを指定して得ます。

  2. fragmentを新しいDocumentFragmentにし、そのノードドキュメントはcontextElementのノードドキュメントとします。

  3. newChildrenの各nodeについて、追加をfragmentに行います。

  4. すべてを置換をfragmentとtargetに対して行います。

静的なparseHTMLUnsafe(html)メソッドの手順は次のとおりです:

  1. compliantHTMLを、TrustedHTML、thisの関連するグローバルオブジェクト、html、"Document parseHTMLUnsafe"および"script"を用いてTrusted Type対応文字列取得アルゴリズムを呼び出した結果として得ます。

  2. documentを、コンテンツタイプが"text/html"である新しいDocumentとして作成します。

    documentにはブラウジングコンテキストがないため、スクリプティングは無効です。

  3. documentの宣言的シャドウルートを許可をtrueに設定します。

  4. 文字列からHTMLを解析するを、documentとcompliantHTMLを指定して実行します。

  5. documentを返します。

8.5.3 HTMLシリアル化メソッド

html = element.getHTML({ serializableShadowRoots, shadowRoots })

elementをHTMLにシリアル化した結果を返します。element内のシャドウルートは、指定されたオプションに従ってシリアル化されます:

いずれのオプションも指定されない場合、シャドウルートはシリアル化されません。

html = shadowRoot.getHTML({ serializableShadowRoots, shadowRoots })

shadowRootをHTMLにシリアル化した結果を返します。シャドウホストがコンテキスト要素として使用されます。shadowRoot内のシャドウルートは、上記のオプションに従ってシリアル化されます。

ElementのgetHTML(options)メソッドの手順は、HTMLフラグメントシリアル化アルゴリズムの結果を返すことです。this、options["serializableShadowRoots"]、およびoptions["shadowRoots"]を使用して実行されます。

ShadowRootのgetHTML(options)メソッドの手順は、HTMLフラグメントシリアル化アルゴリズムの結果を返すことです。this、options["serializableShadowRoots"]、およびoptions["shadowRoots"]を使用して実行されます。

8.5.4 innerHTML プロパティ

innerHTMLプロパティには、「DOM Parsing and Serialization」のissueトラッカーで、その仕様に関する様々な問題を記録した複数の未解決の問題があります。

element.innerHTML

要素の内容を表すHTMLまたはXMLのフラグメントを返します。

XMLドキュメントの場合、要素がXMLにシリアル化できない場合は"InvalidStateError"DOMExceptionをスローします。

element.innerHTML = value

指定された文字列から解析されたノードで要素の内容を置き換えます。

XMLドキュメントの場合、指定された文字列が適切に形成されていない場合は"SyntaxError"DOMExceptionをスローします。

shadowRoot.innerHTML

シャドウルートの内容を表すHTMLフラグメントを返します。

shadowRoot.innerHTML = value

指定された文字列から解析されたノードでシャドウルートの内容を置き換えます。

これらのプロパティのセッターは、scriptやイベントハンドラーコンテンツ属性のような潜在的に危険な要素や属性を削除するサニタイズを行いません。

フラグメントシリアル化アルゴリズムの手順は、Element、Document、またはDocumentFragmentnodeとブール値require well-formedを与えた場合に、次の手順を実行します:

  1. context documentをnodeのノードドキュメントとします。

  2. context documentがHTMLドキュメントである場合、node、false、および「」を用いてHTMLフラグメントシリアル化アルゴリズムの結果を返します。

  3. require well-formedを指定して、nodeのXMLシリアル化を返します。

フラグメント解析アルゴリズムの手順は、Elementcontextと文字列markupを与えた場合に、次の手順を実行します:

  1. algorithm を HTML フラグメント解析アルゴリズムとします。

  2. context の ノードドキュメントが XML ドキュメントである場合、algorithm を XML フラグメント解析アルゴリズムに設定します。

  3. newChildren を、context と markup を指定して algorithm を呼び出した結果とします。

  4. fragment を、その ノードドキュメントが context の ノードドキュメントである新しい DocumentFragment とします。

  5. newChildren の各 node について、ツリー順で：node を fragment に追加します。

    これにより、新しいノードのノードドキュメントが正しいことが保証されます。

  6. fragment を返します。

ElementのinnerHTMLゲッターの手順は、フラグメントシリアル化アルゴリズムの手順を実行し、その結果を返すことです。thisとtrueを使用して実行します。

ShadowRootのinnerHTMLゲッターの手順は、フラグメントシリアル化アルゴリズムの手順を実行し、その結果を返すことです。thisとtrueを使用して実行します。

ElementのinnerHTMLセッターの手順は次のとおりです:

  1. compliantStringを、TrustedHTML、thisの関連グローバルオブジェクト、指定された値、"Element innerHTML"、および"script"を使用してGet Trusted Type compliant stringアルゴリズムを実行した結果とします。

  2. contextをthisとします。

  3. fragmentをcontextとcompliantStringを用いてフラグメント解析アルゴリズムの手順を実行した結果とします。

  4. contextがtemplate要素である場合、contextをtemplate要素のテンプレート内容（DocumentFragment）に設定します。

    innerHTMLをtemplate要素に設定すると、その子要素ではなく、テンプレート内容のすべてのノードが置き換えられます。

  5. context内でfragmentを用いてすべて置き換えを行います。

ShadowRootのinnerHTMLセッターの手順は次のとおりです:

  1. compliantStringを、TrustedHTML、thisの関連グローバルオブジェクト、指定された値、"ShadowRoot innerHTML"、および"script"を使用してGet Trusted Type compliant stringアルゴリズムを実行した結果とします。

  2. contextをthisのホストに設定します。

  3. fragmentをcontextとcompliantStringを用いてフラグメント解析アルゴリズムの手順を実行した結果とします。

  4. fragmentを用いてすべて置き換えを行います。thisの中で行います。

8.5.5 outerHTML プロパティ

outerHTMLプロパティには、「DOM Parsing and Serialization」のissueトラッカーで、その仕様に関する様々な問題を記録した複数の未解決の問題があります。

element.outerHTML

要素およびその内容を表すHTMLまたはXMLのフラグメントを返します。

XMLドキュメントの場合、要素がXMLにシリアル化できない場合は"InvalidStateError"DOMExceptionをスローします。

element.outerHTML = value

指定された文字列から解析されたノードで要素を置き換えます。

XMLドキュメントの場合、指定された文字列が適切に形成されていない場合は"SyntaxError"DOMExceptionをスローします。

要素の親がDocumentである場合、"NoModificationAllowedError"DOMExceptionをスローします。

このプロパティのセッターは、scriptやイベントハンドラーコンテンツ属性のような潜在的に危険な要素や属性を削除するサニタイズを行いません。

ElementのouterHTMLゲッターの手順は次のとおりです:

  1. elementを、その唯一の子がthisである仮想ノードとします。

  2. elementとtrueを使用してフラグメントシリアル化アルゴリズムの手順を実行した結果を返します。

ElementのouterHTMLセッターの手順は次のとおりです:

  1. compliantStringを、TrustedHTML、thisの関連グローバルオブジェクト、指定された値、"Element outerHTML"、および"script"を使用してGet Trusted Type compliant stringアルゴリズムを実行した結果とします。

  2. parentをthisの親ノードとします。

  3. parentがnullの場合は、returnします。この後の手順を実行しても、作成されたノードへの参照を取得する方法がないためです。

  4. parentがDocumentである場合、"NoModificationAllowedError"DOMExceptionをスローします。

  5. parent が DocumentFragment の場合、parent を、this の ノードドキュメント、「body」、およびHTML 名前空間を指定して要素を作成した結果に設定します。

  6. fragmentをparentとcompliantStringを用いてフラグメント解析アルゴリズムの手順を実行した結果とします。

  7. 置き換えを行い、thisをfragmentでthisの親ノード内で置き換えます。

8.5.6 insertAdjacentHTML() メソッド

insertAdjacentHTML() メソッドは、DOM Parsing and Serializationの問題追跡システムに多くの未解決の問題があり、仕様に関するさまざまな問題が文書化されています。

element.insertAdjacentHTML(position, string)

stringをHTMLまたはXMLとして解析し、position引数で指定された位置にツリー内のノードを挿入します。具体的には、次のようになります。

"beforebegin"
要素自体の前（つまり、elementの前の兄弟の後）
"afterbegin"
要素の内部、最初の子の前。
"beforeend"
要素の内部、最後の子の後。
"afterend"
要素自体の後（つまり、elementの次の兄弟の前）

"SyntaxError" DOMException をスローします。引数が無効な値を持つ場合（例：XMLドキュメントの場合、 指定された文字列が正しく整形されていない場合など）。

"NoModificationAllowedError" DOMException をスローします。指定された位置が可能でない場合（例：Documentの ルート要素の後に要素を挿入する場合）。

このメソッドのセッターは、script や イベントハンドラコンテンツ属性 のような潜在的に危険な要素や属性を削除するためのサニタイズを行いません。

Elementの insertAdjacentHTML(position, string)メソッドの手順は以下の通りです：

  1. compliantString を次のアルゴリズムを使用して呼び出した結果に設定します: Trusted Type 準拠の文字列を取得する アルゴリズムを TrustedHTML、 this の 関連するグローバルオブジェクト、string、 "Element insertAdjacentHTML"、および "script" で設定します。

  2. context を null に設定します。

  3. このリストから最初に一致する項目を使用します:

    もし position が "beforebegin" に対する ASCII 大文字小文字を区別しない 一致である場合
    もし position が "afterend" に対する ASCII 大文字小文字を区別しない 一致である場合

    1. context を this の 親要素 に設定します。

    2. もし context が null または Document である場合は、 "NoModificationAllowedError" DOMException を投げます。

    もし position が "afterbegin" に対する ASCII 大文字小文字を区別しない 一致である場合
    もし position が "beforeend" に対する ASCII 大文字小文字を区別しない 一致である場合
    context を this に設定します。
    それ以外の場合

    "SyntaxError" DOMException を投げます。

  4. もし context が Element ではない場合、 または次のすべてが真である場合:

    context を、this の ノードドキュメント、「body」、およびHTML 名前空間を指定して要素を作成した結果に設定します。

  5. fragment を フラグメント解析アルゴリズムの手順 を context と compliantString で呼び出した結果に設定します。

  6. このリストから最初に一致する項目を使用します:
    もし position が "beforebegin" に対する ASCII 大文字小文字を区別しない 一致である場合

    挿入します fragment を this の 親要素 の前に this の前に挿入します。

    もし position が "afterbegin" に対する ASCII 大文字小文字を区別しない 一致である場合

    挿入します fragment を this の 最初の子要素 の前に挿入します。

    もし position が "beforeend" に対する ASCII 大文字小文字を区別しない 一致である場合

    追加します fragment を this に追加します。

    もし position が "afterend" に対する ASCII 大文字小文字を区別しない 一致である場合

    挿入します fragment を this の 親要素 の前に this の 次の兄弟要素 の前に挿入します。

他の直接的なNode操作APIと同様に（innerHTMLとは異なり）、 insertAdjacentHTML() はtemplate要素に対する 特別な処理を含んでいません。ほとんどの場合、 templateEl.content.insertAdjacentHTML() を使用して、template 要素の子ノードを直接操作するのではなく、操作します。

8.5.7 createContextualFragment() メソッド

createContextualFragment() メソッドには、DOM Parsing and Serializationのissue trackerに多数の未解決の問題が記録されており、その仕様に関するさまざまな問題が文書化されています。

docFragment = range.createContextualFragment(string)

指定されたマークアップ文字列stringから作成されたDocumentFragmentを返します。この操作は、rangeの開始ノードを解析時のコンテキストとして使用して行われます。

このメソッドは、script要素やイベントハンドラー属性のような潜在的に危険な要素や属性を削除するためのサニタイズを行いません。 

partial interface Range {
  [CEReactions, NewObject] DocumentFragment createContextualFragment((TrustedHTML or DOMString) string);
};

Rangeの createContextualFragment(string) メソッドの手順は次の通りです：

  1. compliantString を、TrustedHTML、this の 関連するグローバルオブジェクト、string、「Range createContextualFragment」、および「script」を指定して 信頼できる型準拠文字列を取得するアルゴリズムを呼び出した結果とします。

  2. nodeを設定します。これはthisの開始ノードです。

  3. elementをnullに設定します。

  4. もしnodeがElementを 実装している場合、elementをnodeに設定します。

  5. それ以外の場合、もしnodeがTextまたは Commentを 実装している場合、elementをnodeの親要素に設定します。

  6. もしelementがnullまたは以下のすべてが真である場合：

    次に element を、this の ノードドキュメント、「body」、およびHTML 名前空間を指定して要素を作成した結果に設定します。

  7. fragment nodeを取得します。これはフラグメント解析 アルゴリズムの手順を使用して、elementとcompliantStringを 与えて得られる結果です。

  8. それぞれのfragment nodeのscript要素の 子孫に対して：

    1. scriptの既に開始されたフラグを falseに設定します。

    2. scriptのパーサードキュメントを nullに設定します。

  9. fragment nodeを返します。

8.5.8 XMLSerializer インターフェース

XMLSerializer インターフェースには、DOM 解析とシリアル化の 課題追跡システムに、その仕様に関するさまざまな問題を文書化した未解決の問題が多数あります。DOM 解析とシリアル化の残りの部分は、徐々にこの仕様にアップストリームされます。

xmlSerializer = new XMLSerializer()

新しい XMLSerializer オブジェクトを構築します。

string = xmlSerializer.serializeToString(root)

root を XML にシリアル化した結果を返します。

root を XML にシリアル化できない場合、"InvalidStateError" DOMException をスローします。

XMLSerializer の設計は、構築してからその serializeToString() メソッドを呼び出す必要があるクラスとして、残念な歴史的遺物です。今日この機能を設計するとしたら、スタンドアロン関数になるでしょう。

[Exposed=Window]
interface XMLSerializer {
  constructor();

  DOMString serializeToString(Node root);
};

new XMLSerializer() コンストラクターのステップは、何もしないことです。

serializeToString(root) メソッドのステップは次のとおりです。

  1. false を指定して、root の XML シリアル化を返します。

8.6 タイマー

setTimeout() および setInterval() メソッドは、タイマーに基づいたコールバックをスケジュールするための手段を提供します。

id = self.setTimeout(handler [, timeout [, ...arguments ] ])

setTimeout

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

handlerをtimeoutミリ秒後に実行するようにタイムアウトをスケジュールします。任意のargumentsはhandlerに直接渡されます。

id = self.setTimeout(code [, timeout ])

codeをtimeoutミリ秒後にコンパイルして実行するようにタイムアウトをスケジュールします。

self.clearTimeout(id)

clearTimeout

現在のすべてのエンジンでサポートされています。

Firefox1+Safari4+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

idで識別されるsetTimeout() または setInterval() で設定されたタイムアウトをキャンセルします。

id = self.setInterval(handler [, timeout [, ...arguments ] ])

setInterval

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

handlerをtimeoutミリ秒ごとに実行するようにタイムアウトをスケジュールします。任意のargumentsはhandlerに直接渡されます。

id = self.setInterval(code [, timeout ])

codeをtimeoutミリ秒ごとにコンパイルして実行するようにタイムアウトをスケジュールします。

self.clearInterval(id)

clearInterval

現在のすべてのエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

idで識別されるsetInterval() または setTimeout()で設定されたタイムアウトをキャンセルします。

タイマーはネスト可能です。ただし、5つ以上のネストされたタイマーがある場合、間隔は最低4ミリ秒に強制されます。

このAPIはタイマーが予定通りに正確に実行されることを保証するものではありません。CPU負荷や他のタスクなどによる遅延が予想されます。

WindowOrWorkerGlobalScope ミックスインを実装するオブジェクトは、setTimeout および setInterval の ID のマップを持ち、これは初期状態では空の順序付きマップです。このマップ内の各キーは、setTimeout()またはsetInterval()呼び出しの戻り値に対応する正の整数です。各値はオブジェクトのアクティブなタイマーのマップ内のキーに対応する一意の内部値です。

setTimeout(handler, timeout, ...arguments) メソッドの手順は、タイマー初期化手順を、this, handler, timeout, argumentsを使用し、falseで実行した結果を返します。

setInterval(handler, timeout, ...arguments) メソッドの手順は、タイマー初期化手順を、this, handler, timeout, argumentsを使用し、trueで実行した結果を返します。

clearTimeout(id) と clearInterval(id) メソッドの手順は、削除することです。thisのsetTimeout および setInterval の ID のマップ[id]を削除します。

clearTimeout() と clearInterval() は、同じマップからエントリを削除するため、どちらのメソッドも setTimeout() または setInterval() によって作成されたタイマーをクリアするために使用できます。

タイマー初期化手順を実行するために、WindowOrWorkerGlobalScope global、文字列またはFunction、 またはTrustedScript handler、数値のtimeout、リストのarguments、ブール値のrepeat、 そしてオプションでrepeatがtrueの場合に限り、数値のpreviousIdを与えて次の手順を実行します。これらは数値を返します。

  1. globalがWorkerGlobalScopeオブジェクトであれば、thisArgをglobalとします。そうでなければ、thisArgをglobalに対応するWindowProxyとします。

  2. previousIdが与えられた場合、idをpreviousIdとします。そうでなければ、idを実装定義の整数とし、それは0より大きく、globalのsetTimeoutとsetInterval IDのマップに既に存在しないものでなければなりません。

  3. 周囲のエージェントのイベントループの現在実行中のタスクが、このアルゴリズムによって作成されたタスクである場合、nesting levelをタスクのタイマーネスティングレベルとします。それ以外の場合、nesting levelを0とします。

    タスクのタイマーネスティングレベルは、setTimeout()のネストされた呼び出し、およびsetInterval()によって作成された繰り返しタイマーの両方に使用されます。（あるいは、このアルゴリズムのネストされた呼び出しを表します）。

  4. もしtimeoutが0未満である場合、timeoutを0に設定します。

  5. もしnesting levelが5を超え、timeoutが4未満である場合、timeoutを4に設定します。

  6. realmをglobalの関連する領域とします。

  7. initiating scriptをアクティブスクリプトとします。

  8. uniqueHandleをnullとします。

  9. taskを以下のサブステップを実行するタスクとします:

    1. アサート: uniqueHandleはユニークな内部値であり、nullではありません。

    2. もしidがglobalのsetTimeoutとsetInterval IDのマップに存在しない場合、これらの手順を中止します。

    3. もしglobalのsetTimeoutとsetInterval IDのマップ[id]がuniqueHandleと等しくない場合、これらの手順を中止します。

      これは、clearTimeout()やclearInterval()呼び出しによってIDがクリアされ、後続のsetTimeout()またはsetInterval()呼び出しによって再利用された場合に対応します。

    4. タイマーハンドラーのタイミング情報を記録する、handler、globalの関連する設定オブジェクト、およびrepeatを指定します。

    5. もしhandlerがFunctionである場合、コールバック関数を呼び出すことにより、argumentsを渡し、thisArgをcallback this valueに設定してhandlerを実行します。

    6. それ以外の場合:

      1. previousIdが与えられていない場合:

        1. global が Window オブジェクトである場合、globalName を「Window」とし、それ以外の場合は「WorkerGlobalScope」とします。

        2. methodNameをrepeatがtrueの場合"setInterval"、それ以外の場合"setTimeout"とします。

        3. sinkをglobalName、U+0020 SPACE、およびmethodNameを連結したものとします。

        4. handlerを信頼できる型に準拠した文字列を取得するアルゴリズムを呼び出した結果に設定し、 TrustedScript、 global、 handler、sink、および "script" を使用します。

      2. アサート: handlerは文字列です。

      3. EnsureCSPDoesNotBlockStringCompilationを実行します。realm、« »、handler、handler、タイマー、« »、handlerが与えられた場合、この操作が例外をスローした場合、キャッチし、それをグローバルに報告し、これらの手順を中止します。

      4. settings objectをglobalの関連する設定オブジェクトとします。

      5. fetch optionsをデフォルトのスクリプトフェッチオプションとします。

      6. base URLをsettings objectのAPIベースURLとします。

      7. もしinitiating scriptがnullでない場合:

        1. fetch optionsを、スクリプトフェッチオプションのうち、暗号化ノンスがinitiating scriptのフェッチオプションの暗号化ノンス、整合性メタデータが空文字列、パーサーメタデータが"not-parser-inserted"、認証モードがinitiating scriptのフェッチオプションの認証モード、参照ポリシーがinitiating scriptのフェッチオプションの参照ポリシー、フェッチ優先度が"auto"のスクリプトフェッチオプションに設定します。

        2. base URLをinitiating scriptのベースURLに設定します。

        これらの手順の効果により、setTimeout()およびsetInterval()によって実行される文字列のコンパイルは、eval()によって実行されるものと同様に動作します。つまり、モジュールスクリプトがimport()経由でフェッチされる場合、両方のコンテキストで同じように動作します。

      8. scriptを、handler、settings object、base URL、およびfetch optionsを使用してクラシックスクリプトを作成した結果とします。

      9. クラシックスクリプトを実行します。

    7. もしidがglobalのsetTimeoutとsetInterval IDのマップに存在しない場合、これらの手順を中止します。

    8. もしglobalのsetTimeoutとsetInterval IDのマップ[id]がuniqueHandleと等しくない場合、これらの手順を中止します。

      IDは、handler内の著者コードによってclearTimeout()やclearInterval()を呼び出して削除され、その後のsetTimeout()やsetInterval()呼び出しによって再利用された可能性があります。

    9. もしrepeatがtrueの場合、global、handler、timeout、arguments、true、およびidを指定して、再度タイマー初期化手順を実行します。

    10. それ以外の場合、globalのsetTimeoutとsetInterval IDのマップ[id]を削除します。

  10. nesting levelを1増やします。

  11. taskのタイマーネスティングレベルをnesting levelに設定します。

  12. completionStepを、globalにtaskを実行するグローバルタスクをキューに追加するアルゴリズムステップとします。

  13. uniqueHandle を、global、「setTimeout/setInterval」、timeout、および completionStep を指定してタイムアウト後にステップを実行した結果に設定します。

  14. 設定する globalのsetTimeoutとsetInterval IDのマップ[id]をuniqueHandleにします。

  15. idを返します。

Web IDLによって定義された引数変換（たとえば、オブジェクトのtoString()メソッドの呼び出しなど）は、このアルゴリズムが実行される前に、Web IDLで定義されたアルゴリズム内で発生します。

例えば、次のようなコードはログに "ONE TWO " が含まれる結果になります：

var log = '';
 function logger(s) { log += s + ' '; }
 
 setTimeout({ toString: function () {
   setTimeout("logger('ONE')", 100);
   return "logger('TWO')";
 } }, 100);

数ミリ秒間のタスクを遅延なしで連続して実行しつつ、ユーザーインターフェイスをブロックしないようにブラウザに制御を戻すために（また、CPUを占有しすぎてスクリプトが強制終了されないようにするために）、作業を行う前に次のタイマーをキューに入れるだけです： 

function doExpensiveWork() {
   var done = false;
   // ...
   // この関数のこの部分は最大で5ミリ秒かかります
   // 完了した場合、done を true に設定します
   // ...
   return done;
 }
 
 function rescheduleWork() {
   var id = setTimeout(rescheduleWork, 0); // 次回の繰り返しを事前にスケジュールします
   if (doExpensiveWork())
     clearTimeout(id); // もう必要なければタイムアウトをクリアします
 }

WindowOrWorkerGlobalScope を実装するオブジェクトには、最初は空の アクティブタイマーのマップ があり、これは 順序付けされたマップ です。 このマップ内の各 キー は、タイマーを表す ユニークな内部値 であり、各 値 は タイマーの満了時間を表す DOMHighResTimeStamp です。

タイムアウト後の手順を実行する には、次の手順を実行します。 WindowOrWorkerGlobalScope で指定された global、文字列 orderingIdentifier、数値 milliseconds、および completionSteps のセットが指定されます。これらの手順は ユニークな内部値 を返します。

  1. timerKey を新しい ユニークな内部値 に設定します。

  2. global に与えられた 現在の高解像度時間 を startTime に設定します。

  3. 設定 します。 global の アクティブタイマーのマップ[timerKey] に startTime + milliseconds を設定します。

  4. 次のステップを 並行して 実行します：

    1. もし global が Window オブジェクトであれば、 global の 関連付けられた Document が 完全にアクティブ になり、さらに milliseconds ミリ秒経過するまで待機します（必ずしも連続的ではありません）。

      それ以外の場合、global が WorkerGlobalScope オブジェクトであれば、 milliseconds ミリ秒が経過するまで、ワーカーが中断されていない状態で待機します（必ずしも連続的ではありません）。

    2. このアルゴリズムの同じ global と orderingIdentifier を持ち、このアルゴリズムの開始前に開始され、その milliseconds がこのアルゴリズムのものと等しいかそれ以下である すべての呼び出しが完了するまで待機します。

    3. オプションとして、さらに 実装依存 の時間だけ待機します。

      これは、デバイスの電力使用量を最適化するためにタイムアウトを調整できるようにするためです。例えば、いくつかのプロセッサには低消費電力モードがあり、 そのモードではタイマーの精度が低下します。そのようなプラットフォームでは、ユーザーエージェントはタイマーをこのスケジュールに合わせて遅くすることで、 より正確なモードの使用に伴う高い電力消費を避けることができます。

    4. completionSteps を実行します。

    5. 削除 します。global の アクティブタイマーのマップ[timerKey] を削除します。

  5. timerKey を返します。

タイムアウト後の手順を実行する は、 開発者が指定したタイムアウト後に開発者が指定したコードを実行するために、他の仕様書で使用されることを目的としています。 これは setTimeout() に似た方法で行われます。 ただし、setTimeout() のネストやクランプの動作は含まれません。 このような仕様書は、自分の仕様書内のタイムアウトの順序を保証するために orderingIdentifier を選択することができますが、 他の仕様書のタイムアウトに関して順序を制約することはありません。

8.7 マイクロタスクのキュー

queueMicrotask

すべての現行エンジンでサポートされています。

Firefox69+Safari12.1+Chrome71+
Opera?Edge79+
Edge (Legacy)?Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
self.queueMicrotask(callback)

指定された マイクロタスクを 実行するために callback をキューに入れます。

queueMicrotask(callback) メソッドは マイクロタスクをキューに入れ、 コールバック関数を « » と "report" と共に callback を呼び出す必要があります。

queueMicrotask() メソッドは、著者が マイクロタスクキュー に コールバックをスケジュールできるようにします。 これにより、コードが次に JavaScript実行コンテキストスタック が 空になった際に実行されるようになります。 これは、すべての現在実行中の同期JavaScriptが完了するまでの間に発生します。これは、例えばsetTimeout(f, 0) を使用した場合のように、コントロールが イベントループ に戻ることはありません。

著者は、多くのマイクロタスクをスケジュールすることが、多くの同期コードを実行するのと同じパフォーマンス上のデメリットを持つことに注意する必要があります。どちらも、ブラウザが描画などの自身の作業を行うことを妨げます。多くのケースでは、requestAnimationFrame() または requestIdleCallback() を使用する方が良い選択肢です。特に、次のレンダリングサイクルの前にコードを実行することが目的である場合、それがrequestAnimationFrame() の目的です。

以下の例からも分かるように、queueMicrotask() を最もよく理解する方法は、同期コードを再配置するメカニズムとして考えることです。これにより、キューに入れられたコードが現在実行中の同期JavaScriptが完了した直後に実行されることが効果的に保証されます。

queueMicrotask() を使用する最も一般的な理由は、情報が同期的に利用可能な場合でも、過度な遅延を導入せずに一貫した順序を作成することです。

例えば、以前にロードされたデータの内部キャッシュを保持するカスタム要素がloadイベントを発火させる場合、次のような単純な実装が考えられます:

MyElement.prototype.loadData = function (url) {
   if (this._cache[url]) {
     this._setData(this._cache[url]);
     this.dispatchEvent(new Event("load"));
   } else {
     fetch(url).then(res => res.arrayBuffer()).then(data => {
       this._cache[url] = data;
       this._setData(data);
       this.dispatchEvent(new Event("load"));
     });
   }

しかし、この単純な実装には問題があります。それは、ユーザーが一貫しない動作を経験する可能性があるためです。例えば、次のようなコードは

element.addEventListener("load", () => console.log("loaded"));
 console.log("1");
 element.loadData();
 console.log("2");

データを取得する必要がある場合は「1, 2, loaded」とログに記録され、データがすでにキャッシュされている場合は「1, loaded, 2」と記録される場合があります。同様に、loadData()の呼び出し後に、要素にデータが設定されているかどうかは一貫しません。

一貫した順序を得るために、queueMicrotask() を使用できます:

MyElement.prototype.loadData = function (url) {
   if (this._cache[url]) {
     queueMicrotask(() => {
       this._setData(this._cache[url]);
       this.dispatchEvent(new Event("load"));
     });
   } else {
     fetch(url).then(res => res.arrayBuffer()).then(data => {
       this._cache[url] = data;
       this._setData(data);
       this.dispatchEvent(new Event("load"));
     });
   }

このように、キューに入れられたコードを JavaScript実行コンテキストスタックが空になった後に実行されるように効果的に再配置することで、要素の状態の一貫した順序と更新を保証します。

別の興味深いqueueMicrotask() の使用例として、複数の呼び出し元による作業の非協調的な「バッチ処理」を可能にすることが挙げられます。例えば、データをできるだけ早く送信したいライブラリ関数を考えてみますが、容易に回避可能である場合には複数のネットワークリクエストを行いたくない場合。このようなバランスを取る一つの方法は次のようになります: 

const queuedToSend = [];
 
 function sendData(data) {
   queuedToSend.push(data);
 
   if (queuedToSend.length === 1) {
     queueMicrotask(() => {
       const stringToSend = JSON.stringify(queuedToSend);
       queuedToSend.length = 0;
 
       fetch("/endpoint", stringToSend);
     });
   }

このアーキテクチャでは、現在実行中の同期JavaScript内のsendData()への複数の後続の呼び出しが、1つのfetch() 呼び出しにバッチ処理されますが、（setTimeout()を使用した場合のように）フェッチの前にイベントループタスクが介入することはありません。

8.8 ユーザープロンプト

8.8.1 シンプルダイアログ

window.alert(message)

Window/alert

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera3+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android10.1+

指定されたメッセージを表示するモーダルアラートを表示し、ユーザーがそれを閉じるまで待機します。

result = window.confirm(message)

Window/confirm

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera3+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android10.1+

指定されたメッセージを表示するモーダルOK/キャンセルプロンプトを表示し、ユーザーがそれを閉じるまで待機します。そして、ユーザーがOKをクリックした場合はtrueを、キャンセルをクリックした場合はfalseを返します。

result = window.prompt(message [, default])

Window/prompt

すべての現在のエンジンでサポートされています。

Firefox1+ Safari1+ Chrome1+
Opera3+ Edge79+
Edge (Legacy)12+ Internet Explorer4+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android10.1+

指定されたメッセージを表示するモーダルテキストコントロールプロンプトを表示し、ユーザーがそれを閉じるまで待機します。ユーザーがプロンプトをキャンセルした場合はnullを返し、そうでない場合はユーザーが入力した値を返します。第2引数が指定されている場合、その値がデフォルト値として使用されます。

タスク または マイクロタスク に依存するロジック、たとえば メディア要素 がその メディアデータ を読み込んでいるときに、これらのメソッドが呼び出されると停止します。

alert()およびalert(message)メソッドのステップは次のとおりです:

  1. シンプルダイアログを表示できない場合、このメソッドは何もせずに戻ります。

  2. このメソッドが引数なしで呼び出された場合、messageは空の文字列とします。それ以外の場合、messageはメソッドの最初の引数とします。

  3. messageを改行を正規化することにより設定します。

  4. messageをシンプルダイアログの文字列をオプションで切り詰めることにより設定します。

  5. userPromptHandler を、this、「alert」、および message を指定した WebDriver BiDi ユーザープロンプトを開いたものとします。

  6. userPromptHandler が「none」の場合：

    1. U+000A LF を改行として扱い、message をユーザーに表示します。

    2. オプションで、ユーザーがメッセージを確認するのを待つ間、一時停止します。

  7. this、「alert」、および true を指定して、WebDriver BiDi ユーザープロンプトを閉じたものを呼び出します。

このメソッドは、歴史的な理由でオーバーロードを使用して定義されており、オプションの引数を使用していません。そのため、実際の影響としては、alert(undefined)はalert("undefined")として扱われますが、alert()はalert("")として扱われます。

confirm(message)メソッドのステップは次のとおりです:

  1. これに対して単純なダイアログを表示できない場合、false を返します。

  2. message を、message を指定して改行を正規化した結果に設定します。

  3. message を、message を任意に切り詰めた結果に設定します。

  4. U+000A LF を改行として扱い、message をユーザーに表示し、肯定または否定の応答をするようユーザーに求めます。

  5. userPromptHandler を、これ、「confirm」、および message を指定した WebDriver BiDi ユーザープロンプトを開いたものとします。

  6. accepted を false とします。

  7. userPromptHandler が「none」の場合：

    1. ユーザーが肯定的または否定的に応答するまで一時停止します。

    2. ユーザーが肯定的に応答した場合、accepted を true に設定します。

  8. userPromptHandler が「accept」の場合、accepted を true に設定します。

  9. これ、「confirm」、および accepted を指定して、WebDriver BiDi ユーザープロンプトを閉じたものを呼び出します。

  10. accepted を返します。

prompt(message, default)メソッドのステップは次のとおりです:

  1. シンプルダイアログを表示できない場合、このメソッドはnullを返して終了します。

  2. messageを改行を正規化することにより設定します。

  3. messageをシンプルダイアログの文字列をオプションで切り詰めることにより設定します。

  4. defaultをシンプルダイアログの文字列をオプションで切り詰めることにより設定します。

  5. messageをユーザーに表示し、U+000A LFを改行として扱い、ユーザーに文字列を入力するか、操作を中止するように求めます。この応答は、defaultで指定された値にデフォルト設定されます。

  6. userPromptHandler を、これ、「prompt」、および message を指定した WebDriver BiDi ユーザープロンプトを開いたものとします。

  7. result を null とします。

  8. userPromptHandler が「none」の場合：

    1. ユーザーの応答を待つ間、一時停止します。

    2. ユーザーが中止しなかった場合、result をユーザーが応答した文字列に設定します。

  9. それ以外の場合、userPromptHandler が「accept」の場合、result を空の文字列に設定します。

  10. これ、「prompt」、result が null の場合は false、それ以外の場合は true、および result を指定して、WebDriver BiDi ユーザープロンプトを閉じたものを呼び出します。

  11. result を返します。

シンプルダイアログの文字列をオプションで切り詰めるためには、s自体、またはsから派生した短い文字列を返します。ユーザーエージェントは、sの省略された部分を表示するためのUIを提供すべきではありません。これは、ユーザーを騙して「重要なセキュリティ警告！全文を表示するには「もっと見る」をクリックしてください！」のようなダイアログを作成するのが簡単になりすぎるためです。

たとえば、ユーザーエージェントはメッセージの最初の100文字だけを表示するようにすることができます。また、文字列の中央を「…」に置き換えることもできます。このような変更は、不自然に大きく、信頼性が高そうなシステムダイアログの濫用可能性を制限するのに役立ちます。

次のアルゴリズムがtrueを返す場合、Window windowに対してシンプルダイアログを表示することができません:

  1. windowの関連するDocumentのアクティブなサンドボックスフラグセットにサンドボックス化されたモーダルフラグが設定されている場合はtrueを返します。

  2. windowの関連する設定オブジェクトの起源とwindowのトップレベル起源が同一起源ドメインでない場合はtrueを返します。

  3. windowの関連するエージェントのイベントループの終了ネスティングレベルがゼロでない場合は、オプションでtrueを返します。

  4. オプションでtrueを返します。（たとえば、ユーザーエージェントがユーザーにすべてのモーダルダイアログを無視するオプションを提供する場合、このメソッドが呼び出されたときに、このステップで終了することができます。）

  5. falseを返します。

8.8.2 印刷

Window/print

すべての最新エンジンでサポートされています。

Firefox1+Safari1.1+Chrome1+
Opera6+Edge79+
Edge (Legacy)12+Internet Explorer5+
Firefox Android114+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
window.print()

ページを印刷するようにユーザーに促します。

print()メソッドのステップは次のとおりです:

  1. documentをこの要素の関連付けられたDocumentとします。

  2. documentが完全にアクティブでない場合、何もせずに戻ります。

  3. documentのアンロードカウンターが0より大きい場合、何もせずに戻ります。

  4. documentがポストロードタスクの準備ができている場合、documentの印刷手順を実行します。

  5. それ以外の場合、documentのロード時に印刷フラグを設定します。

ユーザーエージェントは、ユーザーが物理的な形を取得する（例: 印刷されたコピー）または物理的な形の表現（例: PDFコピー）をドキュメントから取得する機会を求めるときにも、印刷手順を実行する必要があります。

Document documentに対する印刷手順は次のとおりです:

  1. ユーザーエージェントは、ユーザーにメッセージを表示するか、何もせずに戻る（またはその両方）ことがあります。

    たとえば、キオスクブラウザは、print()メソッドの呼び出しを黙って無視することができます。

    たとえば、モバイルデバイス上のブラウザは、近くにプリンターがないことを検出し、続行する前に「PDFに保存」オプションを提供するメッセージを表示することができます。

  2. documentのアクティブなサンドボックスフラグセットにサンドボックス化されたモーダルフラグが設定されている場合、何もせずに戻ります。

    印刷ダイアログがDocumentのサンドボックスによってブロックされている場合、beforeprintおよびafterprintイベントは発生しません。

  3. ユーザーエージェントは、イベントを発生させる必要があります。documentの関連するグローバルオブジェクトおよびその中の任意の子ナビゲーブルに対してbeforeprintという名前のイベントを発生させます。

    ここで子にのみ発生させるのは適切ではなく、いくつかのタスクはキューに入れる必要があるかもしれません。詳細はissue #5096を参照してください。

    beforeprintイベントは、たとえばドキュメントが印刷された時刻を追加するなど、印刷されたコピーに注釈を付けるために使用できます。

  4. ユーザーエージェントは、documentの物理的な形を取得する（またはその表現を取得する）機会をユーザーに提供する必要があります。ユーザーエージェントは、ユーザーが受け入れるか拒否するまで待機してから戻ることができます。その場合、ユーザーエージェントはメソッドが待機している間に一時停止を行う必要があります。この時点でユーザーエージェントが待機しない場合でも、最終的に代替形式を作成する際には、このアルゴリズムのこの時点で関連するドキュメントの状態を使用する必要があります。

  5. ユーザーエージェントは、イベントを発生させる必要があります。documentの関連するグローバルオブジェクトおよびその中の任意の子ナビゲーブルに対してafterprintという名前のイベントを発生させます。

    ここで子にのみ発生させるのは適切ではなく、いくつかのタスクはキューに入れる必要があるかもしれません。詳細はissue #5096を参照してください。

    afterprintイベントは、先のイベントで追加された注釈を元に戻すためや、印刷後のUIを表示するために使用できます。たとえば、ホームローンの申請手順をユーザーに案内しているページの場合、フォームを印刷した後、自動的に次のステップに進むことができます。

8.9 システムの状態と機能

8.9.1 Navigator オブジェクト

Navigator

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

Navigator のインスタンスは、ユーザーエージェント（クライアント）の ID と状態を表します。また、さまざまな API が配置される汎用グローバルとしても使用されてきましたが、これは構築の基盤となるものではありません。代わりに、WindowOrWorkerGlobalScope ミックスインまたは同等のものを使用してください。

[Exposed=Window]
 interface Navigator {
   // このインターフェイスを実装するオブジェクトは、以下のインターフェイスも実装します
 };
 Navigator includes NavigatorID;
 Navigator includes NavigatorLanguage;
 Navigator includes NavigatorOnLine;
 Navigator includes NavigatorContentUtils;
 Navigator includes NavigatorCookies;
 Navigator includes NavigatorPlugins;
 Navigator includes NavigatorConcurrentHardware;

これらのインターフェイスミキシンは、WorkerNavigatorがNavigatorインターフェイスの一部を再利用できるように、個別に定義されています。

各Windowには、関連付けられたNavigatorがあり、それはNavigatorオブジェクトです。Windowオブジェクトが作成されると、その関連付けられたNavigatorは、Windowオブジェクトの関連する領域で作成された新しいNavigatorオブジェクトに設定されなければなりません。

Window/navigator

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera3+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

navigatorと clientInformation のゲッターステップは、このオブジェクトの関連付けられた Navigatorを返すことです。

8.9.1.1 クライアントの識別
interface mixin NavigatorID {
   readonly attribute DOMString appCodeName; // constant "Mozilla"
   readonly attribute DOMString appName; // constant "Netscape"
   readonly attribute DOMString appVersion;
   readonly attribute DOMString platform;
   readonly attribute DOMString product; // constant "Gecko"
   [Exposed=Window] readonly attribute DOMString productSub;
   readonly attribute DOMString userAgent;
   [Exposed=Window] readonly attribute DOMString vendor;
   [Exposed=Window] readonly attribute DOMString vendorSub; // constant ""
 };

場合によっては、業界全体が最善を尽くしても、Webブラウザーにはバグや制限があり、Web作成者はそれらを回避するための対応策を講じる必要があります。

このセクションでは、これらの問題を回避するために、使用されているユーザーエージェントの種類をスクリプトから判断するために使用できる属性のコレクションを定義します。

ユーザーエージェントには、ナビゲーター互換モードがあり、Chrome、Gecko、またはWebKitのいずれかです。

ナビゲーター互換モードは、NavigatorIDミキシンを、既存のWebコンテンツとの互換性が確認されている属性値の組み合わせと、taintEnabled()およびoscpuの有無に制約します。

クライアントの検出は常に現在の既知のバージョンの検出に限定されるべきであり、将来のバージョンや未知のバージョンは常に完全に準拠していると仮定するべきです。

self.navigator.appCodeName

文字列 "Mozilla" を返します。

self.navigator.appName

文字列 "Netscape" を返します。

self.navigator.appVersion

ブラウザーのバージョンを返します。

self.navigator.platform

プラットフォームの名前を返します。

self.navigator.product

文字列 "Gecko" を返します。

window.navigator.productSub

文字列 "20030107" または "20100101" のいずれかを返します。

self.navigator.userAgent

Navigator/userAgent

すべての最新エンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

WorkerNavigator/userAgent

すべての最新エンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

完全な `User-Agent` ヘッダーを返します。

window.navigator.vendor

空の文字列、"Apple Computer, Inc." または "Google Inc." のいずれかを返します。

window.navigator.vendorSub

空の文字列を返します。

appCodeName

文字列 "Mozilla" を返す必要があります。

appName

文字列 "Netscape" を返す必要があります。

appVersion

以下のように "5.0 (" で始まる適切な文字列を返す必要があります:

trail とは、"Mozilla/" の接頭辞の後に続く デフォルトの `User-Agent` 値 の部分文字列を指します。

もし、ナビゲーター互換モード が Chrome または WebKit の場合

trail を返します。

もし、ナビゲーター互換モード が Gecko の場合

trail が "5.0 (Windows" で始まる場合は、"5.0 (Windows)" を返します。

それ以外の場合は、最初の U+003B（;）までの trail の接頭辞に U+0029 右括弧を連結して返します。例えば、"5.0 (Macintosh)"、"5.0 (Android 10)"、"5.0 (X11)" のように返されます。

platform

ブラウザーが実行されているプラットフォームを表す文字列（例: "MacIntel"、"Win32"、"Linux x86_64"、"Linux armv81"）または、プライバシーおよび互換性のために、別のプラットフォームで一般的に返される文字列を返す必要があります。

product

文字列 "Gecko" を返す必要があります。

productSub

次のリストから適切な文字列を返す必要があります:

もし、ナビゲーター互換モード が Chrome または WebKit の場合

文字列 "20030107"。

もし、ナビゲーター互換モード が Gecko の場合

文字列 "20100101"。

userAgent

デフォルトの `User-Agent` 値 を返す必要があります。

vendor

次のリストから適切な文字列を返す必要があります:

もし、ナビゲーター互換モード が Chrome の場合

文字列 "Google Inc."。

もし、ナビゲーター互換モード が Gecko の場合

空の文字列。

もし、ナビゲーター互換モード が WebKit の場合

文字列 "Apple Computer, Inc."。

vendorSub

空の文字列を返す必要があります。

もし、ナビゲーター互換モード が Gecko の場合、ユーザーエージェントは以下の部分インターフェースもサポートする必要があります:

partial interface mixin NavigatorID {
   [Exposed=Window] boolean taintEnabled(); // constant false
   [Exposed=Window] readonly attribute DOMString oscpu;
 };

taintEnabled() メソッドは false を返す必要があります。

oscpu 属性のゲッターは、空の文字列または、ブラウザーが実行されているプラットフォームを表す文字列（例: "Windows NT 10.0; Win64; x64"、"Linux x86_64"）を返す必要があります。

(これはトラッキングベクターです。) このAPIに含まれる情報の中で、ユーザーごとに異なる情報は、ユーザーのプロファイル作成に利用される可能性があります。実際、十分な情報が利用可能であれば、ユーザーを一意に特定することも可能です。このため、ユーザーエージェントの実装者は、このAPIに含める情報を可能な限り少なくすることを強く推奨します。

8.9.1.2 言語設定 
interface mixin NavigatorLanguage {
   readonly attribute DOMString language;
   readonly attribute FrozenArray<DOMString> languages;
 };
self.navigator.language

Navigator/language

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

WorkerNavigator/language

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari10+Chrome4+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android4+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+

ユーザーが希望する言語を表す言語タグを返します。

self.navigator.languages

Navigator/languages

すべての現在のエンジンでサポートされています。

Firefox32+Safari10.1+Chrome37+
Opera24+Edge79+
Edge (Legacy)16+Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet3.0+Opera Android24+

WorkerNavigator/languages

すべての現在のエンジンでサポートされています。

Firefox32+Safari10.1+Chrome37+
Opera24+Edge79+
Edge (Legacy)16+Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet3.0+Opera Android24+

ユーザーの希望する言語を表す言語タグの配列を返します。最も希望される言語が最初に来ます。

最も希望される言語は、navigator.language によって返される言語です。

A languagechange イベントは、ユーザーエージェントがユーザーの希望する言語に対する理解が変わったときに、 Window または WorkerGlobalScope オブジェクトで発生します。

language

有効なBCP 47言語タグを返さなければなりません。これは、考えられる言語か、ユーザーの最も希望する 言語を表します。[BCP47]

languages

有効なBCP 47言語タグのフローズン配列を返さなければなりません。これは、1つ以上の考えられる言語か、ユーザーの希望する言語を表し、最も希望する言語が最初に来ます。同じオブジェクトを返す必要がありますが、ユーザーエージェントが異なる値、または異なる順序で返す必要があるまで同じオブジェクトを返します。[BCP47]

ユーザーエージェントがnavigator.languages 属性を持つWindow または WorkerGlobalScope オブジェクト global が新しい言語タグのセットを返す必要があるときは、ユーザーエージェントはグローバルタスクをキューに追加し、DOM操作タスクソースでglobalにイベントを発生させ、そのタスクが実行を開始するまで待つ必要があります。languagechange をglobalで発生させ、実際に新しい値を返す前にそのタスクが開始されるまで待つ必要があります。

ユーザーエージェントが考えられる言語を決定する際には、以下の点を考慮する必要があります。

(これはトラッキングベクトルです。) 新たなフィンガープリントベクトルを導入しないために、ユーザーエージェントは、この機能で定義されたAPIとHTTP `Accept-Language` ヘッダーのリストを同じにする必要があります。 

interface mixin NavigatorOnLine {
   readonly attribute boolean onLine;
 };
self.navigator.onLine

Navigator/onLine

すべての現行エンジンでサポートされています。

Firefox1.5+Safari4+Chrome2+
Opera3+Edge79+
Edge (旧版)12+Internet Explorer4+
Firefox Android4+Safari iOS?Chrome Android18+🔰 37+Samsung Internet?Opera Android10.1+

WorkerNavigator/onLine

すべての現行エンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (旧版)12+Internet Explorer10+
Firefox Android4+Safari iOS5+Chrome Android?🔰 4.4+Samsung Internet?Opera Android11+

ユーザーエージェントが確実にオフライン（ネットワークから切断）されている場合はfalseを返します。 ユーザーエージェントがオンラインである可能性がある場合はtrueを返します。

この属性の値が変わると、online および offlineイベントが発生します。

The onLine 属性は、ユーザーエージェントがリンクをたどったり、スクリプトがリモートページを要求したときにネットワークに接続しない場合（またはそのような試みが失敗すると分かっている場合）にはfalseを返し、そうでない場合はtrueを返さなければなりません。

navigator.onLine 属性の値が、Window または WorkerGlobalScope global で true から false に変わるとき、ユーザーエージェントは globalタスクをキューに追加し、ネットワークタスクソース に与え、 global で offline という名前のイベントを発火する必要があります。

逆に、navigator.onLine 属性の値が、Window または WorkerGlobalScope global で false から true に変わるとき、ユーザーエージェントは globalタスクをキューに追加し、 ネットワークタスクソース に与え、 global で online という名前のイベントを発火する必要があります。

この属性は本質的に信頼できません。コンピュータがネットワークに接続されていても、インターネットアクセスがない場合があります。

この例では、ブラウザがオンラインおよびオフラインになるたびにインジケーターが更新されます。

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <title>Online status</title>
   <script>
    function updateIndicator() {
      document.getElementById('indicator').textContent = navigator.onLine ? 'online' : 'offline';
    }
   </script>
  </head>
  <body onload="updateIndicator()" ononline="updateIndicator()" onoffline="updateIndicator()">
   <p>The network is: <span id="indicator">(state unknown)</span>
  </body>
 </html>
8.9.1.4 カスタムスキームハンドラー: registerProtocolHandler() メソッド

Navigator/registerProtocolHandler

Firefox2+SafariNoChrome13+
Opera11.6+Edge79+
Edge (Legacy)NoInternet ExplorerNo
Firefox Android?Safari iOS?Chrome AndroidNoWebView Android?Samsung Internet?Opera Android? 
interface mixin NavigatorContentUtils {
   [SecureContext] undefined registerProtocolHandler(DOMString scheme, USVString url);
   [SecureContext] undefined unregisterProtocolHandler(DOMString scheme, USVString url);
 };
window.navigator.registerProtocolHandler(scheme, url)

scheme に url でハンドラーを登録します。例えば、オンライン電話メッセージングサービスが、sms: スキームのハンドラーとして自らを登録することで、ユーザーがそのようなリンクをクリックした場合に、そのウェブサイトを使用するオプションが提供されるようになります。 [SMS]

url 内の "%s" は、処理するコンテンツの URL を挿入するプレースホルダーとして使用されます。

ユーザーエージェントが登録をブロックした場合（例えば "http" のハンドラーとして登録しようとした場合など）、"SecurityError" DOMException をスローします。

url に "%s" 文字列が欠けている場合は、"SyntaxError" DOMException をスローします。

window.navigator.unregisterProtocolHandler(scheme, url)

Navigator/unregisterProtocolHandler

一つのエンジンでのみサポートされています。

FirefoxNoSafariNoChrome38+
Opera25+Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome AndroidNoWebView Android?Samsung Internet?Opera Android?

指定された引数に基づいてハンドラーを登録解除します。

ユーザーエージェントが登録解除をブロックした場合（例えば無効なスキームの場合など）、"SecurityError" DOMException をスローします。

url に "%s" 文字列が欠けている場合は、"SyntaxError" DOMException をスローします。

registerProtocolHandler(scheme, url) メソッドの手順は次のとおりです:

  1. プロトコルハンドラーパラメーターを正規化 を実行し、 scheme, url, および this の関連する設定オブジェクト で normalizedScheme, normalizedURLString を取得します。

  2. 並行して: normalizedScheme および normalizedURLString の プロトコルハンドラーを登録する。

    ユーザーエージェントは、説明された制約内で、何でも好きなことができます。たとえば、ユーザーにプロンプトを表示し、サイトをハンドラーのリストに追加する機会を提供するか、ハンドラーをデフォルトにするか、リクエストをキャンセルするかを選択させることができます。また、ユーザーに関連する情報のみを静かに収集することもできます。

    ユーザーエージェントは、ユーザーが登録を拒否した場合でも、サイトがハンドラーを登録したかどうかを追跡し、同じリクエストで繰り返しプロンプトが表示されないようにする必要があります。

    もし registerProtocolHandler() オートメーションモード が this の 関連するグローバルオブジェクト の 関連する Document に設定されている場合、ユーザーエージェントはまずオートメーションコンテキストにいることを確認する必要があります（参照 WebDriver のセキュリティ考慮事項）。その後、上記の情報伝達とユーザーの同意収集をスキップし、代わりに registerProtocolHandler() オートメーションモード の値に基づいて次のことを行います:

    "autoAccept"

    ユーザーが登録詳細を確認し、リクエストを受け入れたかのように動作します。

    "autoReject"

    ユーザーが登録詳細を確認し、リクエストを拒否したかのように動作します。

    ユーザーエージェントが次の条件で URL inputURL のためにこのハンドラーを使用する場合:

    1. アサート: inputURL の スキーム が normalizedScheme であること。

    2. ユーザー名を設定する inputURL と空の文字列に対して。

    3. パスワードを設定する inputURL と空の文字列に対して。

    4. inputURLString を シリアライゼーション で得た結果とします。

    5. encodedURL を UTF-8 パーセントエンコード を inputURLString に対して実行し、コンポーネントパーセントエンコードセット を使用して結果を得ます。

    6. handlerURLString を normalizedURLString とします。

    7. handlerURLString の最初の "%s" を encodedURL で置き換えます。

    8. resultURL を パーシング の結果として handlerURLString で得た結果とします。

    9. 適切な ナビゲーション対象 に resultURL で移動します。

    もしユーザーが https://example.com/ にアクセスし、次の呼び出しを行った場合:

    navigator.registerProtocolHandler('web+soup', 'soup?url=%s')

    そして、後で https://www.example.net/ を訪問して、次のリンクをクリックした場合:

    <a href="web+soup:chicken-kïwi">Download our Chicken Kïwi soup!</a>

    ...その場合、ユーザーエージェントは次の URL に移動する可能性があります:

    https://example.com/soup?url=web+soup:chicken-k%C3%AFwi

    このサイトは、スープを合成してユーザーに発送するなど、自分がすることを実行します。

    これはハンドラーがいつ使用されるかを定義するものではありません。ある程度、ドキュメント間のナビゲーションモデルの処理 がいくつかの関連ケースを定義していますが、一般的にユーザーエージェントは、ネイティブプラグインやヘルパーアプリケーションにスキームを渡すかどうかを検討する際にこの情報を使用する可能性があります。

unregisterProtocolHandler(scheme, url) メソッドの手順は次のとおりです:

  1. プロトコルハンドラーパラメーターを正規化 を実行し、 scheme, url, および this の関連する設定オブジェクト で normalizedScheme, normalizedURLString を取得します。

  2. 並行して: normalizedScheme と normalizedURLString で記述されたハンドラーを登録解除します。

プロトコルハンドラーパラメーターを正規化する には、文字列 scheme, 文字列 url, および 環境設定オブジェクト environment を使用して次の手順を実行します:

  1. scheme を scheme に設定し、ASCII 小文字に変換 します。

  2. もし scheme が セーフリスト化されたスキーム でないか、"web+" で始まりその後に 1 つ以上の ASCII 小文字のアルファベット が続かない場合は、"SecurityError" DOMException をスローします。

    これにより、scheme にコロン (例: "mailto:") が含まれていると、エラーがスローされます。

    以下のスキームが セーフリスト化されたスキーム です:

    このリストは変更される可能性があります。追加すべきスキームがある場合は、フィードバックをお寄せください。

  3. もし url に "%s" が含まれていない場合は、"SyntaxError" DOMException をスローします。

  4. urlRecord を URL のエンコーディングとパーシング の結果として、 url と environment を使用して得た結果とします。

  5. もし urlRecord が失敗した場合は、"SyntaxError" DOMException をスローします。

    これは、%s プレースホルダーが URL のホストまたはポートに含まれている場合に強制的に適用されます。

  6. もし urlRecord の スキーム が HTTP(S) スキーム でなく、または urlRecord の オリジン が environment の オリジン と 同一オリジン でない場合、"SecurityError" DOMException をスローします。

  7. アサート: urlRecord が 潜在的に信頼できる URL かどうか を調べた結果として "潜在的に信頼できる" であること。

    プロトコルハンドラーパラメーターを正規化する が 安全なコンテキスト 内で実行されるため、これは 同一オリジン 条件によって暗示されます。

  8. (scheme, urlRecord) を返します。

    urlRecord の シリアライゼーション は 有効な URL 文字列 ではありません。なぜなら、 "%s" という文字列が含まれているためです。

8.9.1.4.1 安全性とプライバシー

カスタムスキームハンドラーは、特にプライバシーに関する懸念を引き起こす可能性があります。

ウェブ全体の利用のハイジャック。 ユーザーエージェントは、その通常の操作に重要なスキーム（HTTP(S) スキーム など）を第三者のサイトを介して再ルーティングすることを許可すべきではありません。これにより、ユーザーの活動が簡単に追跡され、セキュアな接続内でもユーザー情報が収集される可能性があります。

デフォルト設定のハイジャック。 ユーザーエージェントは、デフォルト設定を自動的に変更しないよう強く推奨されます。これは、ユーザーが予期しないリモートホストにデータを送信することにつながる可能性があります。新しいハンドラーが自身を登録しても、それによりそのサイトが自動的に使用されるべきではありません。

登録スパム。 ユーザーエージェントは、サイトが大量のハンドラーを、場合によっては複数のドメインから登録しようとする可能性を考慮すべきです（例えば、異なるドメイン上の一連のページを経由してリダイレクトし、それぞれが web+spam: のようなスキームのハンドラーを登録するなど。ポルノサイトが長年にわたり他のウェブブラウザ機能を悪用してきた類似の手法があります）。ユーザーエージェントは、そのような敵対的な試みを優雅に処理し、ユーザーを保護するべきです。

悪意のあるハンドラーメタデータ。 ユーザーエージェントは、インターフェイスに埋め込まれた文字列に対する典型的な攻撃に対して保護する必要があります。例えば、そのような文字列内のマークアップやエスケープ文字が実行されないようにすること、ヌルバイトが適切に処理されること、長すぎる文字列がクラッシュやバッファオーバーランを引き起こさないようにすることなどが必要です。

プライベートデータの漏洩。 ウェブページの作者は、プライベートと見なされるURLデータを使用してカスタムスキームハンドラーを参照する場合があります。彼らは、ユーザーの選択したハンドラーが組織内のページを指しており、機密データが第三者に漏れないことを期待しているかもしれません。しかし、ユーザーが外部サイトを指すハンドラーを登録している場合、そのデータが第三者に漏洩する可能性があります。実装者は、特定のサブドメイン、コンテンツタイプ、またはスキームでカスタムハンドラーを無効にするオプションを提供することを検討するかもしれません。

インターフェイス干渉。 ユーザーエージェントは、メソッドへの非常に長い引数に対処できるように準備すべきです。例えば、表示されるユーザーインターフェースが「受け入れる」ボタンと「拒否する」ボタンで構成され、「受け入れる」ボタンがハンドラーの名前を含んでいる場合、長い名前が「拒否する」ボタンを画面外に押し出さないようにすることが重要です。

8.9.1.4.2 ユーザーエージェントの自動化

各Documentには、registerProtocolHandler() 自動化モードがあり、デフォルトは "none" ですが、"autoAccept" または "autoReject" に設定することも可能です。

ユーザーエージェントの自動化およびウェブサイトのテストの目的で、この標準はRPH登録モードを設定 WebDriver 拡張コマンドを定義します。これは、ユーザーエージェントにDocumentをモードに置き、ユーザーが登録確認プロンプトダイアログを受け入れるか拒否するかを自動的にシミュレートするよう指示します。

HTTP メソッド URI テンプレート
`POST` /session/{session id}/custom-handlers/set-mode

リモートエンドの手順は以下の通りです:

  1. もしparametersがJSONオブジェクトでない場合、WebDriverエラーをwithWebDriverエラーコード無効な引数と共に返します。

  2. parametersから"mode"という名前のプロパティを取得することで、modeを取得します。

  3. もしmodeが"autoAccept"、"autoReject"、または"none"でない場合、WebDriverエラーをwithWebDriverエラーコード無効な引数と共に返します。

  4. documentを現在のブラウジングコンテキストのアクティブドキュメントとして設定します。

  5. documentのregisterProtocolHandler()自動化モードをmodeに設定します。

  6. 成功と共にデータをnullで返します。

8.9.1.5 クッキー
interface mixin NavigatorCookies {
      readonly attribute boolean cookieEnabled;
    };
window.navigator.cookieEnabled

Navigator/cookieEnabled

すべての現在のエンジンでサポートされています。

Firefox1+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

クッキーの設定が無視される場合は false を返し、それ以外の場合は true を返します。

cookieEnabled 属性は、ユーザーエージェントが HTTP State Management Mechanism に従ってクッキーを処理しようとする場合に true を返し、クッキー変更要求を無視する場合に false を返さなければなりません。[COOKIES]

8.9.1.6 PDF 閲覧サポート
window.navigator.pdfViewerEnabled

ユーザーエージェントが PDF ファイルを ナビゲートするときにインライン表示をサポートしている場合は true を返し、それ以外の場合は false を返します。後者の場合、PDF ファイルは 外部ソフトウェアで処理されます。 

interface mixin NavigatorPlugins {
   [SameObject] readonly attribute PluginArray plugins;
   [SameObject] readonly attribute MimeTypeArray mimeTypes;
   boolean javaEnabled();
   readonly attribute boolean pdfViewerEnabled;
 };
 
 [Exposed=Window,
  LegacyUnenumerableNamedProperties]
 interface PluginArray {
   undefined refresh();
   readonly attribute unsigned long length;
   getter Plugin? item(unsigned long index);
   getter Plugin? namedItem(DOMString name);
 };
 
 [Exposed=Window,
  LegacyUnenumerableNamedProperties]
 interface MimeTypeArray {
   readonly attribute unsigned long length;
   getter MimeType? item(unsigned long index);
   getter MimeType? namedItem(DOMString name);
 };
 
 [Exposed=Window,
  LegacyUnenumerableNamedProperties]
 interface Plugin {
   readonly attribute DOMString name;
   readonly attribute DOMString description;
   readonly attribute DOMString filename;
   readonly attribute unsigned long length;
   getter MimeType? item(unsigned long index);
   getter MimeType? namedItem(DOMString name);
 };
 
 [Exposed=Window]
 interface MimeType {
   readonly attribute DOMString type;
   readonly attribute DOMString description;
   readonly attribute DOMString suffixes;
   readonly attribute Plugin enabledPlugin;
 };

現在では、PDF ビューアーのサポートを検出するには navigator.pdfViewerEnabled を使用することができますが、歴史的な理由から、同じ機能を提供する複雑かつ相互に関連するインターフェースがいくつか存在しており、レガシーコードはそれに依存しています。このセクションでは、シンプルな現代的バリアントと複雑な歴史的バリアントの両方を指定します。

各ユーザーエージェントには、PDF ビューアー対応ブール値があり、その値は 実装依存です（ユーザーの設定によって変わる可能性があります）。

この値は、ナビゲーション処理モデルにも影響を与えます。

各 Window オブジェクトには、PDF ビューアープラグインオブジェクトリストがあります。ユーザー エージェントの PDF ビューアー対応 が false の場合、このリストは空です。それ以外の場合は、次の5つの Plugin オブジェクトを含むリストです。それぞれの 名前 は次の通りです:

  1. "PDF Viewer"
  2. "Chrome PDF Viewer"
  3. "Chromium PDF Viewer"
  4. "Microsoft Edge PDF Viewer"
  5. "WebKit built-in PDF"

上記のリストの値は PDF ビューアープラグイン名リストを形成します。

これらの名前は、ウェブサイトが歴史的に検索する内容に基づいて選択されたものであり、既存のコンテンツとの互換性を維持するためにユーザーエージェントが公開する必要があるものです。アルファベット順に並べられています。 "PDF Viewer" の名前は、汎用プラグイン名を指すように enabledPlugin のゲッターに対応させるために、0 番目の位置に挿入されました。

各 Window オブジェクトには、PDF ビューアー MIME タイプオブジェクトリストがあります。ユーザー エージェントの PDF ビューアー対応 が false の場合、このリストは空です。それ以外の場合は、次の2つの MimeType オブジェクトを含むリストです。それぞれの 種類 は次の通りです:

  1. "application/pdf"
  2. "text/pdf"

上記のリストの値は PDF ビューアー MIME タイプリストを形成します。

各 NavigatorPlugins オブジェクトには、プラグイン配列があり、これは新しい PluginArray であり、また新しい MIME タイプ配列があり、これは新しい MimeTypeArray です。

NavigatorPlugins ミックスインの plugins ゲッターステップは、このオブジェクトの プラグイン配列を返すことです。

NavigatorPlugins ミックスインの mimeTypes ゲッターステップは、このオブジェクトの MIME タイプ配列を返すことです。

NavigatorPlugins ミックスインの javaEnabled() メソッドステップは、false を返すことです。

Navigator/pdfViewerEnabled

すべての現行エンジンでサポートされています。

Firefox99+Safari16.4+Chrome94+
Opera?Edge94+
Edge (Legacy)?Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

NavigatorPlugins ミックスインの pdfViewerEnabled ゲッターステップは、ユーザーエージェントの PDF ビューアー対応 を返すことです。

PluginArray インターフェースは 名前付きプロパティをサポート します。ユーザーエージェントの PDF ビューアー対応 が true の場合、それらは PDF ビューアープラグイン名 です。それ以外の場合、それらは空のリストです。

PluginArray インターフェースの namedItem(name) メソッドステップは次の通りです:

  1. 各 Plugin plugin に対して、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアープラグインオブジェクト の中から、もし plugin の 名前 が name である場合、それを返します。

  2. null を返します。

PluginArray インターフェースは インデックス付きプロパティをサポート します。サポートされているプロパティのインデックス は、インデックス です。このオブジェクトの 関連グローバルオブジェクト の PDF ビューアープラグインオブジェクト です。

PluginArray インターフェースの item(index) メソッドステップは次の通りです:

  1. plugins を このオブジェクトの 関連グローバルオブジェクト の PDF ビューアープラグインオブジェクト に設定します。

  2. もし index が plugins の サイズ より小さい場合、それを返します。

  3. null を返します。

PluginArray インターフェースの length ゲッターステップは、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアープラグインオブジェクト の サイズ を返すことです。

PluginArray インターフェースの refresh() メソッドステップは、何も行わないことです。

MimeTypeArray インターフェースは 名前付きプロパティをサポート します。ユーザーエージェントの PDF ビューアー対応 が true の場合、それらは PDF ビューアー MIME タイプ です。それ以外の場合、それらは空のリストです。

MimeTypeArray インターフェースの namedItem(name) メソッドステップは次の通りです:

  1. 各 MimeType mimeType に対して、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト の中から、もし mimeType の 種類 が name である場合、それを返します。

  2. null を返します。

MimeTypeArray インターフェースは インデックス付きプロパティをサポート します。サポートされているプロパティのインデックス は、インデックス です。このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト です。

MimeTypeArray インターフェースの item(index) メソッドステップは次の通りです:

  1. mimeTypes を このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト に設定します。

  2. もし index が mimeTypes の サイズ より小さい場合、それを返します。

  3. null を返します。

MimeTypeArray インターフェースの length ゲッターステップは、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト の サイズ を返すことです。

各 Plugin オブジェクトには、名前 があり、オブジェクトの作成時に設定されます。

Plugin インターフェースの name ゲッターステップは、このオブジェクトの 名前 を返すことです。

Plugin インターフェースの description ゲッターステップは、「Portable Document Format」を返すことです。

Plugin インターフェースの filename ゲッターステップは、「internal-pdf-viewer」を返すことです。

Plugin インターフェースは 名前付きプロパティをサポート します。ユーザーエージェントの PDF ビューアー対応 が true の場合、それらは PDF ビューアー MIME タイプ です。それ以外の場合、それらは空のリストです。

Plugin インターフェースの namedItem(name) メソッドステップは次の通りです:

  1. 各 MimeType mimeType に対して、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト の中から、もし mimeType の 種類 が name である場合、それを返します。

  2. null を返します。

Plugin インターフェースは インデックス付きプロパティをサポート します。サポートされているプロパティのインデックス は、インデックス です。このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト です。

Plugin インターフェースの item(index) メソッドステップは次の通りです:

  1. mimeTypes を このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト に設定します。

  2. もし index が mimeTypes の サイズ より小さい場合、それを返します。

  3. null を返します。

Plugin インターフェースの length ゲッターステップは、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアー MIME タイプオブジェクト の サイズ を返すことです。

各 MimeType オブジェクトには 種類 があり、オブジェクトの作成時に設定されます。

MimeType インターフェースの type ゲッターステップは、このオブジェクトの 種類 を返すことです。

MimeType インターフェースの description ゲッターステップは、「Portable Document Format」を返すことです。

MimeType インターフェースの suffixes ゲッターステップは、「pdf」を返すことです。

MimeType インターフェースの enabledPlugin ゲッターステップは、このオブジェクトの 関連グローバルオブジェクト の PDF ビューアープラグインオブジェクト[0] (つまり、汎用の「PDF Viewer」プラグイン) を返すことです。

8.10 画像

8.10.1 ImageData インターフェイス

ImageData

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+ 

typedef (Uint8ClampedArray or Float16Array) ImageDataArray;

enum ImageDataPixelFormat { "rgba-unorm8", "rgba-float16" };

dictionary ImageDataSettings {
  PredefinedColorSpace colorSpace;
  ImageDataPixelFormat pixelFormat = "rgba-unorm8";
};

[Exposed=(Window,Worker),
 Serializable]
interface ImageData {
  constructor(unsigned long sw, unsigned long sh, optional ImageDataSettings settings = {});
  constructor(ImageDataArray data, unsigned long sw, optional unsigned long sh, optional ImageDataSettings settings = {});

  readonly attribute unsigned long width;
  readonly attribute unsigned long height;
  readonly attribute ImageDataArray data;
  readonly attribute ImageDataPixelFormat pixelFormat;
  readonly attribute PredefinedColorSpace colorSpace;
};

ImageData オブジェクトは、 width 属性に等しい幅と height 属性に等しい高さを持つ長方形のビットマップを表します。このビットマップのピクセル値は、 data 属性に、左から右へ、上から下へ行ごとに格納され、左上のピクセルは0から始まります。各ピクセルの色成分の順序と数値表現は、pixelFormat 属性によって決定されます。ビットマップのピクセル値の色空間は、colorSpace 属性によって決定されます。

imageData = new ImageData(sw, sh [, settings])

ImageData/ImageData

すべての現行エンジンでサポートされています。

Firefox29+Safari8+Chrome36+
Opera?Edge79+
Edge (Legacy)14+Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定された寸法と settings によって示される色空間を持つ ImageData オブジェクトを返します。返されるオブジェクト内のすべてのピクセルは透明な黒です。

幅または高さの引数のいずれかがゼロの場合、"IndexSizeError" DOMException をスローします。

imageData = new ImageData(data, sw [, sh [, settings ] ])

ImageDataArray 引数で提供されたデータを使用し、指定された寸法と settings によって示される色空間を使用して解釈された ImageData オブジェクトを返します。

データのバイト長は、ピクセルあたりのバイト数 × 指定された幅の倍数である必要があります。高さも指定されている場合、長さはピクセルあたりのバイト数 × 幅 × 高さと正確に一致する必要があります。

指定されたデータと寸法が一貫して解釈できない場合、またはいずれかの寸法がゼロの場合、"IndexSizeError" DOMException をスローします。

imageData.width

ImageData/width

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+
imageData.height

ImageData/height

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

ImageData オブジェクト内のデータの実際の寸法をピクセル単位で返します。

imageData.data

ImageData/data

すべての現行エンジンでサポートされています。

Firefox3.5+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

RGBA 順でデータを格納する1次元配列を、0から255の範囲の整数として返します。

imageData.colorSpace

ピクセルの色空間を返します。

new ImageData(sw, sh, settings) コンストラクターのステップは次のとおりです。

  1. sw と sh の一方または両方がゼロの場合、"IndexSizeError" DOMException をスローします。

  2. this を sw、sh、および settings を指定して初期化します。

  3. this の画像データを透明な黒に初期化します。

new ImageData(data, sw, sh, settings) コンストラクターのステップは次のとおりです。

  1. settings["pixelFormat"] が "rgba-unorm8" の場合は bytesPerPixel を4とし、それ以外の場合は8とします。

  2. length を data のバッファソースのバイト長とします。

  3. length が bytesPerPixel のゼロでない整数の倍数でない場合、"InvalidStateError" DOMException をスローします。

  4. length を bytesPerPixel で割った値とします。

  5. length が sw の整数の倍数でない場合、"IndexSizeError" DOMException をスローします。

    このステップでは、長さはゼロより大きいことが保証されているため（そうでない場合、上記の2番目のステップでステップが中止されます）、sw がゼロの場合、このステップは例外をスローして戻ります。

  6. height を length を sw で割った値とします。

  7. sh が指定され、その値が height と等しくない場合、"IndexSizeError" DOMException をスローします。

  8. this を sw、sh、settings、および source を data に設定して初期化します。

    このステップでは、this のデータを data のコピーに設定しません。data として渡された実際の ImageDataArray オブジェクトに設定します。

imageData ImageData オブジェクトを初期化するには、行あたりのピクセル数の正の整数 pixelsPerRow、行数の正の整数 rows、ImageDataSettings settings、オプションの ImageDataArray source、およびオプションの PredefinedColorSpace defaultColorSpace を指定します。

ImageData/colorSpace

Firefox非対応Safari15.2+Chrome92+
Opera?Edge92+
Edge (Legacy)?Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

  1. source が指定された場合：

    1. settings["pixelFormat"] が "rgba-unorm8" であり、かつ source が Uint8ClampedArray でない場合、"InvalidStateError" DOMException をスローします。

    2. settings["pixelFormat"] が "rgba-float16" であり、かつ source が Float16Array でない場合、"InvalidStateError" DOMException をスローします。

    3. imageData の data 属性を source に初期化します。

  2. それ以外の場合（source が指定されなかった場合）：

    1. settings["pixelFormat"] が "rgba-unorm8" の場合、imageData の data 属性を新しい Uint8ClampedArray オブジェクトに初期化します。Uint8ClampedArray オブジェクトは、そのストレージに新しい ArrayBuffer を使用し、ゼロバイトオフセットと、そのストレージの長さに等しいバイト長（バイト単位）を持たなければなりません。ストレージ ArrayBuffer は、4 × rows × pixelsPerRow バイトの長さを持たなければなりません。

    2. それ以外の場合で、settings["pixelFormat"] が "rgba-float16" の場合、imageData の data 属性を新しい Float16Array オブジェクトに初期化します。Float16Array オブジェクトは、そのストレージに新しい ArrayBuffer を使用し、ゼロバイトオフセットと、そのストレージの長さに等しいバイト長（バイト単位）を持たなければなりません。ストレージ ArrayBuffer は、8 × rows × pixelsPerRow バイトの長さを持たなければなりません。

    3. ストレージ ArrayBuffer が割り当てられなかった場合、JavaScript によってスローされた RangeError を再スローし、戻ります。

  3. imageData の width 属性を pixelsPerRow に初期化します。

  4. imageData の height 属性を rows に初期化します。

  5. imageData の pixelFormat 属性を settings["pixelFormat"] に初期化します。

  6. settings["colorSpace"] が存在する場合、imageData の colorSpace 属性を settings["colorSpace"] に初期化します。

  7. それ以外の場合で、defaultColorSpace が指定された場合、imageData の colorSpace 属性を defaultColorSpace に初期化します。

  8. それ以外の場合、imageData の colorSpace 属性を "srgb" に初期化します。

ImageData オブジェクトはシリアライズ可能なオブジェクトです。そのシリアライズステップは、value と serialized を指定して次のとおりです。

  1. serialized.[[Data]] を value の data 属性の値のサブシリアライズに設定します。

  2. serialized.[[Width]] を value の width 属性の値に設定します。

  3. serialized.[[Height]] を value の height 属性の値に設定します。

  4. serialized.[[ColorSpace]] を value の colorSpace 属性の値に設定します。

  5. serialized.[[PixelFormat]] を value の pixelFormat 属性の値に設定します。

そのデシリアライズステップは、serialized、value、および targetRealm を指定して次のとおりです。

  1. value の data 属性を serialized.[[Data]] のサブデシリアライズに初期化します。

  2. value の width 属性を serialized.[[Width]] に初期化します。

  3. value の height 属性を serialized.[[Height]] に初期化します。

  4. value の colorSpace 属性を serialized.[[ColorSpace]] に初期化します。

  5. value の pixelFormat 属性を serialized.[[PixelFormat]] に初期化します。

ImageDataPixelFormat 列挙型は、ImageData の data 属性の型と、各ピクセルの色成分の配置および数値表現を指定するために使用されます。

"rgba-unorm8" 値は、ImageData の data 属性が Uint8ClampedArray 型でなければならないことを示します。各ピクセルの色成分は、赤、緑、青、そしてアルファの順に4つの連続した要素に格納されなければなりません。各要素は、その成分の8ビット符号なし正規化値を表します。

"rgba-float16" 値は、ImageData の data 属性が Float16Array 型でなければならないことを示します。各ピクセルの色成分は、赤、緑、青、そしてアルファの順に4つの連続した要素に格納されなければなりません。各要素は、その成分の値を表します。

8.10.2 ImageBitmap インターフェイス

ImageBitmap

すべての現在のエンジンでサポートされています。

Firefox42+Safari15+Chrome50+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android? 
[Exposed=(Window,Worker), Serializable, Transferable]
interface ImageBitmap {
  readonly attribute unsigned long width;
  readonly attribute unsigned long height;
  undefined close();
};

typedef (CanvasImageSource or
         Blob or
         ImageData) ImageBitmapSource;

enum ImageOrientation { "from-image", "flipY" };
enum PremultiplyAlpha { "none", "premultiply", "default" };
enum ColorSpaceConversion { "none", "default" };
enum ResizeQuality { "pixelated", "low", "medium", "high" };

dictionary ImageBitmapOptions {
  ImageOrientation imageOrientation = "from-image";
  PremultiplyAlpha premultiplyAlpha = "default";
  ColorSpaceConversion colorSpaceConversion = "default";
  [EnforceRange] unsigned long resizeWidth;
  [EnforceRange] unsigned long resizeHeight;
  ResizeQuality resizeQuality = "low";
};

ImageBitmap オブジェクトは、過度の遅延なしにキャンバスに描画できるビットマップ画像を表します。

過度な遅延の判断は実装者に委ねられていますが、一般的にビットマップの使用にネットワークI/OやローカルディスクI/Oが必要な場合、その遅延は過度と見なされる可能性があります。一方、GPUまたはシステムRAMからのブロッキングリードのみが必要な場合、その遅延は許容範囲と見なされる可能性があります。

promise = self.createImageBitmap(image [, options ])

createImageBitmap

すべての現在のエンジンでサポートされています。

Firefox42+Safari15+Chrome50+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
promise = self.createImageBitmap(image, sx, sy, sw, sh [, options ])

image を取ります。これは、img 要素、SVG image 要素、video 要素、canvas 要素、Blob オブジェクト、ImageData オブジェクト、または別の ImageBitmap オブジェクトのいずれかです。新しい ImageBitmap が作成されると解決されるプロミスを返します。

ImageBitmap オブジェクトを構築できない場合、たとえば提供された image データが実際には画像でない場合、代わりにプロミスは拒否されます。

sx、sy、sw、および sh 引数が指定されている場合、ソース画像は指定されたピクセルにトリミングされ、元の画像に欠落しているピクセルは透明な黒に置き換えられます。これらの座標は、CSS ピクセルではなく、ソース画像のピクセル座標空間にあります。

options が指定されている場合、ImageBitmap オブジェクトのビットマップデータは options に従って変更されます。たとえば、premultiplyAlpha オプションが "premultiply" に設定されている場合、ビットマップデータのアルファ以外の色成分はアルファ成分によって乗算済みアルファになります。

ソース画像が有効な状態でない場合（たとえば、正常に読み込まれていない img 要素、[[Detached]] 内部スロット値が true の ImageBitmap オブジェクト、data 属性値の [[ViewedArrayBuffer]] 内部スロットがデタッチされている ImageData オブジェクト、またはデータがビットマップ画像として解釈できない Blob）、"InvalidStateError" DOMException でプロミスを拒否します。

スクリプトがソース画像の画像データにアクセスできない場合（たとえば、CORS クロスオリジンの video、または別のオリジンのワーカー内のスクリプトによって描画されている canvas）、"SecurityError" DOMException でプロミスを拒否します。

imageBitmap.close()

ImageBitmap/close

すべての現在のエンジンでサポートされています。

Firefox46+Safari15+Chrome52+
Opera37+Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

imageBitmap の基になるビットマップデータを解放します。

imageBitmap.width

ImageBitmap/width

すべての現在のエンジンでサポートされています。

Firefox42+Safari15+Chrome50+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

画像の自然な幅をCSS ピクセル単位で返します。

imageBitmap.height

ImageBitmap/height

すべての現在のエンジンでサポートされています。

Firefox42+Safari15+Chrome50+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

画像の自然な高さをCSS ピクセル単位で返します。

[[Detached]] 内部スロット値が false の ImageBitmap オブジェクトは、常に幅と高さを持つ関連付けられたビットマップデータを持ちます。ただし、このデータが破損している可能性があります。ImageBitmap オブジェクトのメディアデータをエラーなしでデコードできる場合、それは完全にデコード可能であると言われます。

ImageBitmap オブジェクトのビットマップには、オリジンクリーンフラグがあり、ビットマップが別のオリジンのコンテンツによって汚染されているかどうかを示します。フラグは最初は true に設定されており、createImageBitmap() のステップによって false に変更される場合があります。

ImageBitmap オブジェクトはシリアライズ可能なオブジェクトであり、転送可能なオブジェクトです。

それらのシリアライズステップは、value と serialized を指定して次のとおりです。

  1. value のオリジンクリーンフラグが設定されていない場合、"DataCloneError" DOMException をスローします。

  2. serialized.[[BitmapData]] を value のビットマップデータのコピーに設定します。

それらのデシリアライズステップは、serialized、value、および targetRealm を指定して次のとおりです。

  1. value のビットマップデータを serialized.[[BitmapData]] に設定します。

それらの転送ステップは、value と dataHolder を指定して次のとおりです。

  1. value のオリジンクリーンフラグが設定されていない場合、"DataCloneError" DOMException をスローします。

  2. dataHolder.[[BitmapData]] を value のビットマップデータに設定します。

  3. value のビットマップデータを解除します。

それらの転送受信ステップは、dataHolder と value を指定して次のとおりです。

  1. value のビットマップデータを dataHolder.[[BitmapData]] に設定します。

createImageBitmapメソッドは、返されたPromiseを解決するためにビットマップタスクソースを使用します。

createImageBitmap(image, options)およびcreateImageBitmap(image, sx, sy, sw, sh, options)メソッドが呼び出されたとき、次のステップを実行する必要があります。

  1. sw または sh のいずれかが指定され、かつ0である場合、RangeError で拒否されたプロミスを返します。

  2. options の resizeWidth または options の resizeHeight のいずれかが存在し、かつ0である場合、"InvalidStateError" DOMException で拒否されたプロミスを返します。

  3. image 引数のユーザビリティを確認します。これが例外をスローするか、bad を返す場合、"InvalidStateError" DOMException で拒否されたプロミスを返します。

  4. promise を新しいプロミスとします。

  5. imageBitmap を新しい ImageBitmap オブジェクトとします。

  6. image でスイッチします。

    img
    SVG image

    1. image のメディアデータに自然な寸法がない場合（たとえば、指定されたコンテンツサイズのないベクターグラフィック）、かつ options の resizeWidth または options の resizeHeight のいずれも存在しない場合、"InvalidStateError" DOMException で拒否されたプロミスを返します。

    2. image のメディアデータに自然な寸法がない場合（たとえば、指定されたコンテンツサイズのないベクターグラフィック）、resizeWidth および resizeHeight オプションで指定されたサイズのビットマップにレンダリングする必要があります。

    3. imageBitmap のビットマップデータを、フォーマット付きでソース矩形にトリミングされた image のメディアデータのコピーに設定します。これがアニメーション画像の場合、imageBitmap のビットマップデータは、アニメーションのデフォルト画像（アニメーションがサポートされていないか無効になっている場合に使用されると形式が定義している画像）、またはそのような画像がない場合はアニメーションの最初のフレームからのみ取得する必要があります。

    4. image がオリジンクリーンでない場合、imageBitmap のビットマップのオリジンクリーンフラグを false に設定します。

    5. ビットマップタスクソースを使用して、promiseをimageBitmapで解決するために、グローバルタスクをキューに入れます。

    video

    1. image の networkState 属性が NETWORK_EMPTY の場合、"InvalidStateError" DOMException で拒否されたプロミスを返します。

    2. imageBitmap のビットマップデータを、メディアリソースの自然な幅と自然な高さ（つまり、アスペクト比の補正が適用された後）で、現在の再生位置のフレームのコピーに、フォーマット付きでソース矩形にトリミングされたものに設定します。

    3. image がオリジンクリーンでない場合、imageBitmap のビットマップのオリジンクリーンフラグを false に設定します。

    4. ビットマップタスクソースを使用して、promiseをimageBitmapで解決するために、グローバルタスクをキューに入れます。

    canvas

    1. imageBitmap のビットマップデータを、image のビットマップデータのコピーに、フォーマット付きでソース矩形にトリミングされたものに設定します。

    2. imageBitmap のビットマップのオリジンクリーンフラグを、image のビットマップのオリジンクリーンフラグと同じ値に設定します。

    3. ビットマップタスクソースを使用して、promiseをimageBitmapで解決するために、グローバルタスクをキューに入れます。

    Blob

    これらのステップを並行して実行します。

    1. imageDataをimageのデータを読み取った結果とします。オブジェクトの読み取り中にエラーが発生した場合は、ビットマップタスクソースを使用してグローバルタスクをキューに入れ、promiseを"InvalidStateError" DOMExceptionで拒否し、これらのステップを中止します。

    2. imageのMIMEタイプ（imageのtype属性で指定）を公式タイプとして、画像スニッフィングルールを適用してimageDataのファイル形式を決定します。

    3. imageDataがサポートされている画像ファイル形式でない場合（たとえば、まったく画像でない場合）、またはimageDataが画像の寸法を取得できないほど致命的な方法で破損している場合（たとえば、自然なサイズのないベクターグラフィック）、ビットマップタスクソースを使用してグローバルタスクをキューに入れ、promiseを"InvalidStateError" DOMExceptionで拒否し、これらのステップを中止します。

    4. imageBitmapのビットマップデータをimageDataに設定し、フォーマット付きでソース矩形にトリミングします。これがアニメーション画像の場合、imageBitmapのビットマップデータは、アニメーションのデフォルト画像（アニメーションがサポートされていないか無効になっている場合に使用されると形式が定義している画像）、またはそのような画像がない場合はアニメーションの最初のフレームからのみ取得する必要があります。

    5. ビットマップタスクソースを使用してグローバルタスクをキューに入れ、promiseをimageBitmapで解決します。

    ImageData

    1. buffer を image の data 属性値の [[ViewedArrayBuffer]] 内部スロットとします。

    2. IsDetachedBuffer(buffer) が true の場合、"InvalidStateError" DOMException で拒否されたプロミスを返します。

    3. imageBitmap のビットマップデータを image の画像データに、フォーマット付きでソース矩形にトリミングされたものに設定します。

    4. ビットマップタスクソースを使用して、promiseをimageBitmapで解決するために、グローバルタスクをキューに入れます。

    ImageBitmap

    1. imageBitmap のビットマップデータを image のビットマップデータのコピーに、フォーマット付きでソース矩形にトリミングされたものに設定します。

    2. imageBitmap のビットマップのオリジンクリーンフラグを、image のビットマップのオリジンクリーンフラグと同じ値に設定します。

    3. ビットマップタスクソースを使用して、promiseをimageBitmapで解決するために、グローバルタスクをキューに入れます。

    VideoFrame

    1. imageBitmap のビットマップデータを image の可視ピクセルデータのコピーに、フォーマット付きでソース矩形にトリミングされたものに設定します。

    2. ビットマップタスクソースを使用して、promiseをimageBitmapで解決するために、グローバルタスクをキューに入れます。

  7. promise を返します。

上記のステップでユーザーエージェントがビットマップデータをソース矩形にフォーマット付きでトリミングする必要がある場合、ユーザーエージェントは次のステップを実行する必要があります。

  1. input を変換対象のビットマップデータとします。

  2. sx、sy、sw、sh が指定されている場合、sourceRectangle を4つの点 (sx, sy)、(sx+sw, sy)、(sx+sw, sy+sh)、(sx, sy+sh) を角とする矩形とします。それ以外の場合、sourceRectangle を4つの点 (0, 0)、(input の幅, 0)、(input の幅, input の高さ)、(0, input の高さ) を角とする矩形とします。

    sw または sh が負の場合、この矩形の左上の角は (sx, sy) 点の左または上になります。

  3. outputWidth を次のように決定します。

    options の resizeWidth メンバーが指定されている場合
    options の resizeWidth メンバーの値
    options の resizeWidth メンバーが指定されておらず、resizeHeight メンバーが指定されている場合
    sourceRectangle の幅に options の resizeHeight メンバーの値を掛け、sourceRectangle の高さで割り、最も近い整数に切り上げた値
    resizeWidth も resizeHeight も指定されていない場合
    sourceRectangle の幅

  4. outputHeight を次のように決定します。

    options の resizeHeight メンバーが指定されている場合
    options の resizeHeight メンバーの値
    options の resizeHeight メンバーが指定されておらず、resizeWidth メンバーが指定されている場合
    sourceRectangle の高さに options の resizeWidth メンバーの値を掛け、sourceRectangle の幅で割り、最も近い整数に切り上げた値
    resizeWidth も resizeHeight も指定されていない場合
    sourceRectangle の高さ

  5. input を無限の透明な黒のグリッド平面上に配置し、その左上の角が平面の原点に位置するようにし、x 座標は右に増加し、y 座標は下に増加し、input 画像データの各ピクセルが平面のグリッド上のセルを占めるようにします。

  6. output を sourceRectangle で示される平面上の矩形とします。

  7. output を outputWidth と outputHeight で指定されたサイズに拡大縮小します。ユーザーエージェントは、スケーリングアルゴリズムの選択をガイドするために resizeQuality オプションの値を使用する必要があります。

  8. options の imageOrientation メンバーの値が "flipY" の場合、ソースの画像方向メタデータ（EXIF メタデータなど）があればそれを無視して、output を垂直方向に反転する必要があります。[EXIF]

    値が "from-image" の場合、追加のステップは必要ありません。

    以前は "none" という列挙値がありました。これは "from-image" に名前が変更されました。将来的には、"none" が異なる意味で再び追加される予定です。

  9. image が img 要素または Blob オブジェクトの場合、val を options の colorSpaceConversion メンバーの値とし、次のサブステップを実行します。

    1. val が "default" の場合、色空間変換の動作は実装固有であり、実装がキャンバスへの画像の描画に使用するデフォルトの色空間に従って選択する必要があります。

    2. val が "none" の場合、output は色空間変換を実行せずにデコードする必要があります。これは、画像デコードアルゴリズムがソースデータに埋め込まれたカラープロファイルメタデータと表示デバイスのカラープロファイルの両方を無視する必要があることを意味します。

  10. val を options の premultiplyAlpha メンバーの値とし、次のサブステップを実行します。

    1. val が "default" の場合、アルファ乗算済みの動作は実装固有であり、実装がキャンバスへの画像の描画に最適と見なすように選択する必要があります。

    2. val が "premultiply" の場合、アルファで乗算済みでない output はその色成分をアルファで乗算し、アルファで乗算済みのものはそのままにする必要があります。

    3. val が "none" の場合、アルファで乗算済みでない output はそのままにし、アルファで乗算済みのものはその色成分をアルファで除算する必要があります。

  11. output を返します。

close()メソッドのステップは次のとおりです。

  1. これの [[Detached]] 内部スロット値を true に設定します。

  2. これのビットマップデータを解除します。

width ゲッターのステップは次のとおりです。

  1. これの [[Detached]] 内部スロットの値が true の場合、0 を返します。

  2. これの幅を CSS ピクセル単位で返します。

height ゲッターのステップは次のとおりです。

  1. これの [[Detached]] 内部スロットの値が true の場合、0 を返します。

  2. これの高さを CSS ピクセル単位で返します。

ResizeQuality 列挙型は、画像を拡大縮小する際に使用する補間品質の優先度を表すために使用されます。

"pixelated" 値は、ターゲットサイズが元のサイズのきれいな倍数でない場合に画像の歪みを避けるために必要に応じてマイナーなスムージングを行い、元のピクセル化を可能な限り維持するように画像を拡大縮小することを優先することを示します。

"pixelated" を実装するには、各軸について独立して、まず自然なサイズの整数倍でターゲットサイズに最も近く、かつゼロより大きいものを決定します。最近傍法を使用してこの整数倍のサイズに拡大縮小し、次にバイリニア補間を使用してターゲットサイズまでの残りの部分を拡大縮小します。

"low" 値は、低レベルの画像補間品質を優先することを示します。低品質の画像補間は、より高い設定よりも計算効率が高い場合があります。

"medium" 値は、中レベルの画像補間品質を優先することを示します。

"high" 値は、高レベルの画像補間品質を優先することを示します。高品質の画像補間は、より低い設定よりも計算コストが高くなる場合があります。

バイリニアスケーリングは、比較的速く、低品質の画像スムージングアルゴリズムの例です。バイキュービックまたはランチョススケーリングは、より高品質の出力を生成する画像スケーリングアルゴリズムの例です。この仕様では、上記で説明した "pixelated" を除き、特定の補間アルゴリズムの使用を義務付けていません。

このAPIを使用すると、スプライトシートを事前に切り取って準備できます。

var sprites = {};
 function loadMySprites() {
   var image = new Image();
   image.src = 'mysprites.png';
   var resolver;
   var promise = new Promise(function (arg) { resolver = arg });
   image.onload = function () {
     resolver(Promise.all([
       createImageBitmap(image,  0,  0, 40, 40).then(function (image) { sprites.person = image }),
       createImageBitmap(image, 40,  0, 40, 40).then(function (image) { sprites.grass  = image }),
       createImageBitmap(image, 80,  0, 40, 40).then(function (image) { sprites.tree   = image }),
       createImageBitmap(image,  0, 40, 40, 40).then(function (image) { sprites.hut    = image }),
       createImageBitmap(image, 40, 40, 40, 40).then(function (image) { sprites.apple  = image }),
       createImageBitmap(image, 80, 40, 40, 40).then(function (image) { sprites.snake  = image })
     ]));
   };
   return promise;
 }
 
 function runDemo() {
   var canvas = document.querySelector('canvas#demo');
   var context = canvas.getContext('2d');
   context.drawImage(sprites.tree, 30, 10);
   context.drawImage(sprites.snake, 70, 10);
 }
 
 loadMySprites().then(runDemo);

8.11 アニメーションフレーム

一部のオブジェクトには、AnimationFrameProviderインターフェースミックスインが含まれています。 

callback FrameRequestCallback = undefined (DOMHighResTimeStamp time);
 
 interface mixin AnimationFrameProvider {
   unsigned long requestAnimationFrame(FrameRequestCallback callback);
   undefined cancelAnimationFrame(unsigned long handle);
 };
 Window includes AnimationFrameProvider;
 DedicatedWorkerGlobalScope includes AnimationFrameProvider;

各AnimationFrameProviderオブジェクトには、プロバイダの内部状態を保持するターゲットオブジェクトもあります。それは次のように定義されます:

もしAnimationFrameProviderがWindowである場合
Windowの関連するDocument
もしAnimationFrameProviderがDedicatedWorkerGlobalScopeである場合
DedicatedWorkerGlobalScope

各ターゲットオブジェクトには、アニメーションフレームコールバックのマップがあり、これは初期状態で空の順序付きマップであり、アニメーションフレームコールバック識別子を持ち、最初はゼロに設定されています。

AnimationFrameProviderのproviderは、以下のいずれかが真である場合、サポートされていると見なされます:

Window/requestAnimationFrame

すべての現在のエンジンでサポートされています。

Firefox23+Safari7+Chrome24+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android23+Safari iOS?Chrome Android?WebView Android4.4+Samsung Internet?Opera Android?

requestAnimationFrame(callback) メソッドの手順は次のとおりです:

  1. thisがサポートされていない場合は、 "NotSupportedError"をスローし、 DOMExceptionを返します。

  2. targetをthisのターゲットオブジェクトに設定します。

  3. targetのアニメーションフレームコールバック識別子を1増やし、 handleをその結果として設定します。

  4. callbacksをtargetのアニメーションフレームコールバックのマップに設定します。

  5. 設定する callbacks[handle] を callbackに。

  6. handleを返します。

Window/cancelAnimationFrame

すべての現在のエンジンでサポートされています。

Firefox23+Safari7+Chrome24+
Opera?Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

cancelAnimationFrame(handle) メソッドの手順は次のとおりです:

  1. this がサポートされていない場合は、 "NotSupportedError"をスローし、 DOMExceptionを返します。

  2. callbacksをthisのターゲットオブジェクトのアニメーションフレームコールバックのマップに設定します。

  3. 削除する callbacks[handle]。

アニメーションフレームコールバックを実行するために、ターゲットオブジェクト targetとタイムスタンプnowが与えられた場合:

  1. callbacksをtargetのアニメーションフレームコールバックのマップに設定します。

  2. callbackHandlesをキーを取得することによってcallbacksの結果として設定します。

  3. 各 handleについて、 もしhandleが存在するならば、 callbacksの中で:

    1. callbackをcallbacks[handle]に設定します。

    2. 削除する callbacks[handle]。

    3. コールバック関数を呼び出す 「now」と「report」を渡して。

ワーカー内で、requestAnimationFrame() は、OffscreenCanvas と一緒に使用されます。まず、ドキュメント内でワーカーに制御を移します:

const offscreenCanvas = document.getElementById("c").transferControlToOffscreen();
 worker.postMessage(offscreenCanvas, [offscreenCanvas]);

次に、ワーカー内で、以下のコードは左から右に動く四角形を描画します:

let ctx, pos = 0;
 function draw(dt) {
   ctx.clearRect(0, 0, 100, 100);
   ctx.fillRect(pos, 0, 10, 10);
   pos += 10 * dt;
   requestAnimationFrame(draw);
 }
 
 self.onmessage = function(ev) {
   const transferredCanvas = ev.data;
   ctx = transferredCanvas.getContext("2d");
   draw();
 };

9 通信

WebSocket インターフェイスはここに定義されていましたが、現在は WebSockets に定義されています。[WEBSOCKETS]

9.1 MessageEvent インターフェイス

MessageEvent

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera10.6+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

サーバー送信イベントのメッセージ、 クロスドキュメントメッセージング、 チャネルメッセージング、 ブロードキャストチャネル、 そして WebSockets は、そのMessageEvent インターフェイスを使用してmessage イベントを処理します：[WEBSOCKETS] 

[Exposed=(Window,Worker,AudioWorklet)]
 interface MessageEvent : Event {
   constructor(DOMString type, optional MessageEventInit eventInitDict = {});
 
   readonly attribute any data;
   readonly attribute USVString origin;
   readonly attribute DOMString lastEventId;
   readonly attribute MessageEventSource? source;
   readonly attribute FrozenArray<MessagePort> ports;
 
   undefined initMessageEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any data = null, optional USVString origin = "", optional DOMString lastEventId = "", optional MessageEventSource? source = null, optional sequence<MessagePort> ports = []);
 };
 
 dictionary MessageEventInit : EventInit {
   any data = null;
   USVString origin = "";
   DOMString lastEventId = "";
   MessageEventSource? source = null;
   sequence<MessagePort> ports = [];
 };
 
 typedef (WindowProxy or MessagePort or ServiceWorker) MessageEventSource;
event.data

MessageEvent/data

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

メッセージのデータを返します。

event.origin

MessageEvent/origin

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

メッセージのオリジンを返します。サーバー送信イベントおよび クロスドキュメントメッセージングの場合。

event.lastEventId

MessageEvent/lastEventId

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (レガシー)17+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

サーバー送信イベントのために、最後のイベントID文字列を返します。

event.source

MessageEvent/source

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome2+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorerサポートされていません
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

WindowProxy、クロスドキュメントメッセージング、接続イベントで接続されているMessagePort、およびSharedWorkerGlobalScopeオブジェクトで発生するconnectイベントの source プロパティを返します。

event.ports

MessageEvent/ports

すべての現在のエンジンでサポートされています。

Firefox3+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (レガシー)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+

クロスドキュメントメッセージングおよびチャネルメッセージングのために、メッセージと一緒に送信されるMessagePort配列を返します。

data 属性は、初期化された値を返さなければなりません。これは送信されるメッセージを表します。

origin 属性は、初期化された値を返さなければなりません。これは、サーバー送信イベントおよびクロスドキュメントメッセージングにおいて、メッセージを送信したドキュメントのオリジンを表します（通常はドキュメントのスキーム、ホスト名、およびポートですが、パスやフラグメントは含まれません）。

lastEventId 属性は、初期化された値を返さなければなりません。これは、サーバー送信イベントにおいて、イベントソースの最後のイベントID文字列を表します。

source 属性は、初期化された値を返さなければなりません。これは、クロスドキュメントメッセージングにおいて、メッセージが送信されたWindowProxyのブラウジングコンテキストを表します。また、共有ワーカーで使用されるconnectイベントでは、新たに接続するMessagePortを表します。

ports 属性は、初期化された値を返さなければなりません。これは、クロスドキュメントメッセージングおよびチャネルメッセージングにおいて送信されるMessagePort配列を表します。

initMessageEvent(type, bubbles, cancelable, data, origin, lastEventId, source, ports) メソッドは、同様に命名されたinitEvent()メソッドと同様に、イベントを初期化しなければなりません。[DOM]

様々なAPI（例: WebSocket、EventSource）は、MessageEventインターフェイスを使用してmessageイベントを処理しますが、MessagePortAPIは使用しません。

9.2 サーバー送信イベント

サーバー送信イベント

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera11+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

9.2.1 概要

このセクションは規範的ではありません。

サーバーがHTTPまたは専用のサーバープッシュプロトコルを使用してウェブページにデータをプッシュできるようにするため、この仕様ではEventSourceインターフェイスを導入しています。

このAPIを使用するには、EventSourceオブジェクトを作成し、イベントリスナーを登録します。 

var source = new EventSource('updates.cgi');
source.onmessage = function (event) {
   alert(event.data);
};

サーバー側では、スクリプト（この場合は"updates.cgi"）が以下の形式でメッセージを送信します。MIMEタイプはtext/event-streamです。

data: これは最初のメッセージです。

data: これは2番目のメッセージで、
data: 2行あります。

data: これは3番目のメッセージです。

作成者は、異なるイベントタイプを使用してイベントを区別できます。ここに2つのイベントタイプ「add」と「remove」を持つストリームがあります。

event: add
data: 73857293

event: remove
data: 2153

event: add
data: 113411

そのようなストリームを処理するスクリプトは次のようになります（addHandlerとremoveHandlerは引数としてイベントを1つ受け取る関数です）。

var source = new EventSource('updates.cgi');
source.addEventListener('add', addHandler, false);
source.addEventListener('remove', removeHandler, false);

デフォルトのイベントタイプは「message」です。

イベントストリームは常にUTF-8でデコードされます。他の文字エンコーディングを指定する方法はありません。

イベントストリームリクエストは、通常のHTTPリクエストと同様にHTTP 301および307リダイレクトを使用してリダイレクトできます。接続が閉じられた場合、クライアントは再接続します。HTTP 204 No Contentレスポンスコードを使用して、クライアントに再接続を停止させることができます。

このAPIを使用することで、XMLHttpRequestやiframeを使用してエミュレートするよりも、ユーザーエージェントがネットワークリソースをより効果的に利用できるようになります。特に、ユーザーエージェントの実装者とネットワークオペレーターが事前に調整することが可能な場合には、特にバッテリー寿命の大幅な節約などの利点があります。これについては、以下の接続なしプッシュセクションでさらに詳しく説明します。

9.2.2 EventSource インターフェイス

EventSource

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera11+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+ 
[Exposed=(Window,Worker)]
 interface EventSource : EventTarget {
   constructor(USVString url, optional EventSourceInit eventSourceInitDict = {});
 
   readonly attribute USVString url;
   readonly attribute boolean withCredentials;
 
   // ready state
   const unsigned short CONNECTING = 0;
   const unsigned short OPEN = 1;
   const unsigned short CLOSED = 2;
   readonly attribute unsigned short readyState;
 
   // networking
   attribute EventHandler onopen;
   attribute EventHandler onmessage;
   attribute EventHandler onerror;
   undefined close();
 };
 
 dictionary EventSourceInit {
   boolean withCredentials = false;
 };

各 EventSource オブジェクトには、次のものが関連付けられています。

urlを除いて、これらは現在EventSourceオブジェクトに公開されていません。

source = new EventSource(url [, { withCredentials: true } ])

EventSource/EventSource

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera11+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

新しいEventSourceオブジェクトを作成します。

urlは、イベントストリームを提供するURLを示す文字列です。

withCredentialsをtrueに設定すると、クレデンシャルモードがurlへの接続リクエストのために"include"に設定されます。

source.close()

EventSource/close

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

このEventSourceオブジェクトに対して開始されたすべてのfetchアルゴリズムのインスタンスを中止し、readyState属性をCLOSEDに設定します。

source.url

EventSource/url

すべての現在のエンジンでサポートされています。

Firefox6+Safari6+Chrome18+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

イベントストリームを提供するURLを返します。

source.withCredentials

EventSource/withCredentials

すべての現在のエンジンでサポートされています。

Firefox6+Safari7+Chrome26+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12+

接続リクエストのためのクレデンシャルモードがincludeに設定されている場合にtrueを返し、そうでない場合はfalseを返します。

source.readyState

EventSource/readyState

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

このEventSourceオブジェクトの接続状態を返します。下記に説明される値を持つことができます。

EventSource(url, eventSourceInitDict)コンストラクタが呼び出されたとき、次の手順を実行しなければなりません。

  1. evを新しいEventSourceオブジェクトにします。

  2. settingsをevの関連する設定オブジェクトにします。

  3. urlRecordをURLのエンコーディングとパースの結果にし、urlをsettingsに相対的にします。

  4. もしurlRecordが失敗なら、"SyntaxError"のDOMExceptionをスローします。

  5. evのurlをurlRecordに設定します。

  6. corsAttributeStateをAnonymousにします。

  7. もしeventSourceInitDictのwithCredentialsメンバーの値がtrueであれば、corsAttributeStateをUse Credentialsに設定し、evのwithCredentials属性をtrueに設定します。

  8. requestを潜在的なCORSリクエストの作成の結果にし、urlRecord、空文字列、およびcorsAttributeStateを渡します。

  9. requestのクライアントをsettingsに設定します。

  10. ユーザーエージェントはrequestのヘッダーリストにAccept、text/event-streamを設定することがあります。

  11. requestのキャッシュモードを"no-store"に設定します。

  12. requestのイニシエータタイプを"other"に設定します。

  13. evのリクエストをrequestに設定します。

  14. processEventSourceEndOfBodyを次のステップにします。レスポンスのresがネットワークエラーでない場合、接続を再確立します。

  15. Fetchにrequestを指定し、processResponseEndOfBodyをprocessEventSourceEndOfBodyに設定し、processResponseを次のステップに設定します。

    1. もしresが中断されたネットワークエラーであれば、接続を失敗させます。

    2. それ以外の場合、resがネットワークエラーである場合、ユーザーエージェントが無駄だとわかっていない限り、接続を再確立し、そうでない場合はユーザーエージェントが接続を失敗させることがあります。

    3. それ以外の場合、resのステータスが200でない場合、またはresのContent-Typeがtext/event-streamでない場合、接続を失敗させます。

    4. それ以外の場合、接続を発表し、resの本文を行ごとに解釈します。

  16. evを返します。

url属性のgetterは、このEventSourceオブジェクトのurlのシリアライズを返さなければなりません。

withCredentials属性は、最後に初期化された値を返さなければなりません。オブジェクトが作成されたとき、falseに初期化されなければなりません。

readyState属性は、接続状態を表します。次の値を持つことができます。

CONNECTING（数値値 0）
接続がまだ確立されていない、または接続が閉じられ、ユーザーエージェントが再接続しています。
OPEN（数値値 1）
ユーザーエージェントがオープンな接続を持ち、受信したイベントをディスパッチしています。
CLOSED（数値値 2）
接続がオープンではなく、ユーザーエージェントが再接続を試みていません。致命的なエラーが発生したか、close()メソッドが呼び出されました。

オブジェクトが作成されると、readyStateはCONNECTING（0）に設定されなければなりません。接続を処理するために与えられたルールは、値が変わるタイミングを定義します。

close()メソッドは、このEventSourceオブジェクトのために開始されたfetchアルゴリズムのすべてのインスタンスを中止し、readyState属性をCLOSEDに設定しなければなりません。

次のイベントハンドラ（およびそれに対応するイベントハンドライベントタイプ）は、EventSourceインターフェイスを実装するすべてのオブジェクトによって、イベントハンドラIDL属性としてサポートされなければなりません。

イベントハンドラ イベントハンドライベントタイプ
onopen

EventSource/open_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+
open
onmessage

EventSource/message_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+
message
onerror

EventSource/error_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (レガシー)?Internet Explorerサポートされていません
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+
error

9.2.3 処理モデル

ユーザーエージェントが接続をアナウンスする場合、ユーザーエージェントはタスクをキューに入れる必要があります。このとき、readyState属性がCLOSED以外の値に設定されている場合、readyState属性をOPENに設定し、「open」という名前のイベントを発火させ、EventSourceオブジェクトにイベントを発火させます。

ユーザーエージェントが接続を再確立する場合、次の手順を実行する必要があります。これらの手順は並行して実行され、タスクの一部として実行されません。（もちろん、キューに入れられたタスクは通常のタスクのように実行され、それ自体が並行して実行されるわけではありません。）

  1. タスクをキューに入れることによって次のステップを実行します。

    1. readyState属性がCLOSEDに設定されている場合、タスクを中止します。

    2. readyState属性をCONNECTINGに設定します。

    3. イベントを発火させ、errorという名前のイベントをEventSourceオブジェクトに対して発火させます。

  2. イベントソースの再接続時間と同等の遅延を待ちます。

  3. 必要に応じて、さらに待ちます。特に、前回の試行が失敗した場合、ユーザーエージェントは、既に過負荷の可能性があるサーバーを過負荷にしないように指数バックオフ遅延を導入するかもしれません。あるいは、オペレーティングシステムがネットワーク接続がないと報告している場合、ユーザーエージェントは、ネットワーク接続が復旧したとオペレーティングシステムが発表するまで待つかもしれません。

  4. 前述のタスクがまだ実行されていない場合、そのタスクが実行されるまで待ちます。

  5. タスクをキューに入れることによって次のステップを実行します。

    1. EventSourceオブジェクトのreadyState属性がCONNECTINGに設定されていない場合、終了します。

    2. requestをEventSourceオブジェクトのリクエストとします。

    3. EventSourceオブジェクトの最後のイベントID文字列が空でない場合は次の操作を行います。

      1. lastEventIDValueを、EventSourceオブジェクトの最後のイベントID文字列として、UTF-8でエンコードされた文字列とします。

      2. 「Last-Event-ID」 (`Last-Event-ID`, lastEventIDValue)をrequestのヘッダーリストに設定します。

    4. リクエストをフェッチし、この方法で取得したレスポンスを処理します（もしあれば）、このセクションで前述のとおりに処理します。

ユーザーエージェントが接続を失敗させる場合、ユーザーエージェントはタスクをキューに入れる必要があり、その際にreadyState属性がCLOSEDに設定されていない場合は、それをreadyState属性にCLOSEDに設定し、イベントを発火させerrorという名前のイベントをEventSourceオブジェクトに対して行います。 一度ユーザーエージェントが接続を失敗させた場合、それは再接続しません。

EventSourceオブジェクトによってキューに入れられたすべてのタスクのタスクソースは、リモートイベントタスクソースです。

9.2.4 `Last-Event-ID` ヘッダー

Last-Event-ID` HTTPリクエストヘッダーは、ユーザーエージェントが接続を再確立する際に、EventSourceオブジェクトの最後のイベントID文字列をサーバーに報告します。

whatwg/html issue #7363を参照して、値の空間をより適切に定義してください。それは本質的には、U+0000 NULL、U+000A LF、またはU+000D CRを含まないUTF-8でエンコードされた任意の文字列です。

9.2.5 イベントストリームの解析

このイベントストリーム形式のMIMEタイプは、text/event-streamです。

イベントストリーム形式は、次のABNFのstream生成によって記述されており、その文字セットはUnicodeです。[ABNF]

stream        = [ bom ] *event
 event         = *( comment / field ) end-of-line
 comment       = colon *any-char end-of-line
 field         = 1*name-char [ colon [ space ] *any-char ] end-of-line
 end-of-line   = ( cr lf / cr / lf )
 
 ; characters
 lf            = %x000A ; U+000A LINE FEED (LF)
 cr            = %x000D ; U+000D CARRIAGE RETURN (CR)
 space         = %x0020 ; U+0020 SPACE
 colon         = %x003A ; U+003A COLON (:)
 bom           = %xFEFF ; U+FEFF BYTE ORDER MARK
 name-char     = %x0000-0009 / %x000B-000C / %x000E-0039 / %x003B-10FFFF
                 ; a scalar value other than U+000A LINE FEED (LF), U+000D CARRIAGE RETURN (CR), or U+003A COLON (:)
 any-char      = %x0000-0009 / %x000B-000C / %x000E-10FFFF
                 ; a scalar value other than U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR)

この形式のイベントストリームは常にUTF-8でエンコードされる必要があります。[ENCODING]

行は、U+000DキャリッジリターンU+000Aラインフィード（CRLF）文字ペア、単一のU+000Aラインフィード（LF）文字、または単一のU+000Dキャリッジリターン（CR）文字で区切られる必要があります。

このようなリソースに対してリモートサーバーへの接続が長時間続くことが期待されるため、ユーザーエージェントは適切なバッファリングを確保する必要があります。特に、単一のU+000Aラインフィード（LF）文字で行が終了するように定義された行バッファリングは安全ですが、ブロックバッファリングや異なる行末を持つ行バッファリングは、イベントの配信に遅延を引き起こす可能性があります。

9.2.6 イベントストリームの解釈

ストリームは、UTF-8デコードアルゴリズムを使用してデコードされる必要があります。

UTF-8デコードアルゴリズムは、先頭にある1つのUTF-8バイトオーダーマーク（BOM）を、もし存在すれば取り除きます。

次に、ストリームは行ごとに読み取られ、U+000DキャリッジリターンU+000Aラインフィード（CRLF）文字ペア、U+000Dキャリッジリターン（CR）文字が前にない単一のU+000Aラインフィード（LF）文字、またはU+000Aラインフィード（LF）文字が後にない単一のU+000Dキャリッジリターン（CR）文字が行の終わりとして認識されます。

ストリームが解析されるとき、dataバッファ、event typeバッファ、およびlast event IDバッファがそれに関連付けられ、これらは空文字列で初期化される必要があります。

受信順に従って、行は次のように処理される必要があります。

行が空白行である場合

イベントを配信します（以下で定義されている通り）。

行がU+003Aコロン文字（:）で始まる場合

行を無視します。

行がU+003Aコロン文字（:）を含む場合

最初のU+003Aコロン文字（:）までの文字を収集し、それをfieldとします。

最初のU+003Aコロン文字（:）の後の文字を収集し、それをvalueとします。valueがU+0020スペース文字で始まる場合、それを取り除きます。

フィールドを処理し、fieldをフィールド名として、valueをフィールド値として使用します。

それ以外の場合、文字列が空ではなく、U+003Aコロン文字（:）を含まない場合

行全体をフィールド名として使用し、空文字列をフィールド値としてフィールドを処理します。

ファイルの終わりに達したら、保留中のデータは破棄される必要があります。（ファイルがイベントの途中で終了した場合、最後の空行の前に、不完全なイベントは配信されません。）

フィールド名とフィールド値が与えられた場合のフィールドを処理する手順は、以下のリストに記載されたフィールド名に依存します。フィールド名は、大小文字を区別して比較される必要があります。

フィールド名が「event」の場合

event typeバッファをフィールド値に設定します。

フィールド名が「data」の場合

フィールド値をdataバッファに追加し、次に単一のU+000Aラインフィード（LF）文字をdataバッファに追加します。

フィールド名が「id」の場合

フィールド値にU+0000 NULLが含まれていない場合は、last event IDバッファをフィールド値に設定します。それ以外の場合は、フィールドを無視します。

フィールド名が「retry」の場合

フィールド値がASCII数字のみで構成されている場合、フィールド値を10進数の整数として解釈し、イベントストリームの再接続時間をその整数に設定します。それ以外の場合は、フィールドを無視します。

その他の場合

フィールドは無視されます。

ユーザーエージェントがイベントを配信する必要がある場合、ユーザーエージェントはdataバッファ、event typeバッファ、およびlast event IDバッファを、ユーザーエージェントに適した手順を使用して処理する必要があります。

ウェブブラウザーにとって、イベントを配信するための適切な手順は以下の通りです。

  1. イベントソースの最終イベントID文字列をlast event IDバッファの値に設定します。このバッファはリセットされないため、イベントソースの最終イベントID文字列は、次回サーバーによって設定されるまでこの値のまま残ります。

  2. dataバッファが空文字列である場合、dataバッファとevent typeバッファを空文字列に設定し、終了します。

  3. dataバッファの最後の文字がU+000Aラインフィード（LF）文字である場合、dataバッファから最後の文字を削除します。

  4. eventをイベントを作成する結果として生成し、そのインターフェースをMessageEventとします。

  5. eventのtype属性を「message」に設定し、data属性をdata、origin属性をイベントストリームの最終URLのシリアル化に設定し、lastEventId属性をイベントソースの最終イベントID文字列に設定します。

  6. event typeバッファが空文字列以外の値を持っている場合、新しく作成されたイベントのtypeをevent typeバッファの値に変更します。

  7. dataバッファとevent typeバッファを空文字列に設定します。

  8. タスクをキューに入れることによって、readyState属性がCLOSED以外の値に設定されている場合、新しく作成されたイベントをイベントソースに配信します。

イベントに「id」フィールドがない場合でも、以前のイベントがイベントソースの最終イベントID文字列を設定した場合、イベントのlastEventIdフィールドは、最後に見られた「id」フィールドの値に設定されます。

次のイベントストリームは、空行の後に続くと：

data: YHOO
data: +2
data: 10

...イベントがmessageとして、MessageEventインターフェースを持つイベントがEventSourceオブジェクト上で配信されます。イベントのdata属性には、文字列"YHOO\n+2\n10"（"\n"は改行を表します）が含まれます。

これを次のように使用できます：

var stocks = new EventSource("https://stocks.example.com/ticker.php");
stocks.onmessage = function (event) {
   var data = event.data.split('\n');
   updateStocks(data[0], data[1], data[2]);
};

...ここで、updateStocks()は次のように定義された関数です：

function updateStocks(symbol, delta, value) { ... }

...またはそのようなものです。

次のストリームには4つのブロックが含まれています。最初のブロックにはコメントしかなく、何も発生しません。2番目のブロックには、それぞれ"data"と"id"という名前のフィールドが2つあります。このブロックに対してイベントが発生し、データ"first event"を持ち、その後に最終イベントIDが"1"に設定されます。このブロックと次のブロックの間で接続が切れた場合、サーバーには`Last-Event-ID`ヘッダーが値`1`で送信されます。3番目のブロックはデータ"second event"を持つイベントを発生させ、今回は値のない"id"フィールドも含まれています。これにより最終イベントIDが空文字列にリセットされます（再接続が試みられた場合、`Last-Event-ID`ヘッダーは送信されません）。最後に、最後のブロックはデータ" third event"（先頭に1つのスペース文字がある）を持つイベントを発生させます。最後のブロックは空行で終了する必要があり、ストリームの終了だけでは最後のイベントを配信するのに十分ではありません。

: test stream

data: first event
id: 1

data:second event
id

data:  third event

次のストリームは2つのイベントを発生させます：

data

data
data

data:

最初のブロックはデータが空文字列に設定されたイベントを発生させます。同様に最後のブロックも、もしそれが空行の後に続いていた場合は同じです。中央のブロックはデータが1つの改行文字に設定されたイベントを発生させます。最後のブロックは空行が続かないため破棄されます。

次のストリームは2つの同一のイベントを発生させます：

data:test

data: test

これは、コロンの後のスペースが存在する場合に無視されるためです。

9.2.7 作成時の注意点

レガシープロキシサーバーは、特定のケースで短時間のタイムアウト後にHTTP接続を切断することが知られています。そのようなプロキシサーバーから保護するために、作成者は約15秒ごとにコメント行（':'文字で始まる行）を含めることができます。

イベントソース接続を互いに、または以前に提供された特定のドキュメントに関連付けたい作成者は、IPアドレスに依存することがうまくいかないことを発見するかもしれません。これは、個々のクライアントが複数のIPアドレスを持っている可能性があるためです（複数のプロキシサーバーを使用しているため）。また、個々のIPアドレスが複数のクライアントを持っている可能性もあります（プロキシサーバーを共有しているため）。ドキュメントに一意の識別子を含め、それを接続が確立される際にURLの一部として渡す方が良いでしょう。

作成者はまた、HTTPチャンク化がこのプロトコルの信頼性に予期しない悪影響を与える可能性があることにも注意が必要です。特に、タイミングの要件を認識していない別のレイヤーによってチャンク化が行われる場合です。この問題が発生する場合、イベントストリームの提供にはチャンク化を無効にすることができます。

HTTPのサーバーごとの接続制限をサポートするクライアントは、同じドメインにEventSourceを持つページを複数開くときに問題に直面する可能性があります。作成者は、接続ごとに一意のドメイン名を使用するという比較的複雑なメカニズムを使用するか、ユーザーにページごとにEventSource機能を有効または無効にするオプションを提供するか、共有ワーカーを使用して単一のEventSourceオブジェクトを共有することで、これを回避できます。

9.2.8 コネクションレスプッシュとその他の機能

特定のキャリアに結びついたモバイル端末上のブラウザなど、制御された環境で実行されるユーザーエージェントは、ネットワーク上のプロキシに接続の管理をオフロードする場合があります。そのような状況では、適合性のために、ユーザーエージェントは端末のソフトウェアとネットワークプロキシの両方を含むと見なされます。

たとえば、モバイルデバイス上のブラウザが接続を確立した後、対応するネットワーク上で動作していることを検出し、ネットワーク上のプロキシサーバーに接続の管理を引き継ぐように要求するかもしれません。このような状況のタイムラインは次のようになります：

  1. ブラウザがリモートHTTPサーバーに接続し、EventSourceコンストラクターで作成者によって指定されたリソースを要求します。
  2. サーバーが時折メッセージを送信します。
  3. メッセージ間で、ブラウザはTCP接続を維持するためのネットワークアクティビティを除いてアイドル状態であることを検出し、省電力のためにスリープモードに切り替えることを決定します。
  4. ブラウザがサーバーから切断します。
  5. ブラウザがネットワーク上のサービスに接続し、そのサービス、つまり「プッシュプロキシ」が代わりに接続を維持するように要求します。
  6. 「プッシュプロキシ」サービスがリモートHTTPサーバーに接続し、EventSourceコンストラクターで作成者によって指定されたリソースを要求します（`Last-Event-ID`HTTPヘッダーなどを含む可能性があります）。
  7. ブラウザがモバイルデバイスをスリープに移行させます。
  8. サーバーが別のメッセージを送信します。
  9. 「プッシュプロキシ」サービスがOMAプッシュなどの技術を使用してイベントをモバイルデバイスに伝達し、デバイスはイベントを処理するためにだけ目覚め、その後再びスリープ状態に戻ります。

これにより、総データ使用量を削減できるため、大幅な電力節約につながる可能性があります。

この仕様で定義されている既存のAPIおよびtext/event-streamワイヤ形式を、上記のようにより分散された方法で実装することに加えて、他の適用可能な仕様によって定義されたイベントフレーミングの形式もサポートされる場合があります。この仕様では、それらがどのように解析または処理されるかについて定義していません。

9.2.9 ガベージコレクション

EventSourceオブジェクトのreadyStateがCONNECTINGであり、オブジェクトにopen、message、またはerrorイベントのイベントリスナーが1つ以上登録されている場合、EventSourceオブジェクトのコンストラクターが呼び出されたWindowまたはWorkerGlobalScopeオブジェクトからそのEventSourceオブジェクト自体への強い参照が存在しなければなりません。

EventSourceオブジェクトのreadyStateがOPENであり、オブジェクトにmessageまたはerrorイベントのイベントリスナーが1つ以上登録されている場合、EventSourceオブジェクトのコンストラクターが呼び出されたWindowまたはWorkerGlobalScopeオブジェクトからそのEventSourceオブジェクト自体への強い参照が存在しなければなりません。

EventSourceオブジェクトによってリモートイベントタスクソースにタスクがキューに入れられている間は、EventSourceオブジェクトのコンストラクターが呼び出されたWindowまたはWorkerGlobalScopeオブジェクトからそのEventSourceオブジェクトへの強い参照が存在しなければなりません。

ユーザーエージェントがEventSourceオブジェクトを強制的に閉じる必要がある場合（これはDocumentオブジェクトが永久に消えるときに発生します）、ユーザーエージェントはこのEventSourceオブジェクトのために開始されたfetchアルゴリズムのインスタンスをすべて中止し、readyState属性をCLOSEDに設定しなければなりません。

接続がまだ開いている間にEventSourceオブジェクトがガベージコレクションされる場合、ユーザーエージェントはこのEventSourceによって開かれたfetchアルゴリズムのインスタンスをすべて中止しなければなりません。

9.2.10 実装のアドバイス

このセクションは規範的ではありません。

ユーザーエージェントは、EventSourceオブジェクトとそれに関連するネットワーク接続に関する詳細な診断情報を開発コンソールに提供し、このAPIを使用してコードをデバッグする際に作成者を支援することを強く推奨します。

たとえば、ユーザーエージェントはページが作成したすべてのEventSourceオブジェクトを表示するパネルを持ち、各オブジェクトのコンストラクタ引数、ネットワークエラーの有無、接続のCORSステータス、そのステータスに至るまでにクライアントが送信したヘッダーとサーバーから受信したヘッダー、受信したメッセージとそれらがどのように解析されたかなどを一覧表示することができます。

特に、errorイベントが発生するたびに、開発コンソールに詳細な情報を報告することが強く推奨されます。イベント自体にはほとんど情報が含まれないか、まったく情報が含まれない可能性があるためです。

9.3 クロスドキュメントメッセージング

Window/postMessage

Support in all current engines.

Firefox3+ Safari4+ Chrome2+
Opera9.5+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android≤37+ Samsung Internet? Opera Android10.1+

Webブラウザは、セキュリティとプライバシーの理由から、異なるドメインのドキュメントが互いに影響を与えることを防ぎます。つまり、クロスサイトスクリプティングは許可されていません。

これは重要なセキュリティ機能ですが、敵対的でないページ間でも異なるドメインのページが通信できなくなります。このセクションでは、クロスサイトスクリプティング攻撃を可能にしない方法で、ソースドメインに関係なくドキュメント同士が通信できるメッセージングシステムを紹介します。

postMessage() APIは、トラッキングベクターとして使用される可能性があります。

9.3.1 序章

このセクションは規範的ではありません。

例えば、ドキュメントAがiframe要素を含んでおり、その中にドキュメントBが含まれている場合、ドキュメントAのスクリプトがドキュメントBのWindowオブジェクトに対してpostMessage()を呼び出すと、そのオブジェクト上でメッセージイベントが発生し、それがドキュメントAのWindowから発信されたことが示されます。ドキュメントAのスクリプトは次のようになるかもしれません： 

var o = document.getElementsByTagName('iframe')[0];
o.contentWindow.postMessage('Hello world', 'https://b.example.org/');

受信イベントのイベントハンドラーを登録するには、スクリプトはaddEventListener()（または同様のメカニズム）を使用します。例えば、ドキュメントBのスクリプトは次のようになるかもしれません： 

window.addEventListener('message', receiver, false);
function receiver(e) {
  if (e.origin == 'https://example.com') {
    if (e.data == 'Hello world') {
      e.source.postMessage('Hello', e.origin);
    } else {
      alert(e.data); 
    }
  }
}

このスクリプトはまず、ドメインが期待されたドメインであることを確認し、その後メッセージを確認して、それをユーザーに表示するか、メッセージを最初に送信したドキュメントに返信するかを決定します。

9.3.2 セキュリティ

9.3.2.1 作成者

このAPIの使用には、悪意のある者がサイトを自分の目的のために悪用するのを防ぐために、特に注意が必要です。

作成者は、メッセージが予期されるドメインからのみ受信されるように、origin属性を確認する必要があります。そうしないと、作成者のメッセージ処理コードのバグが悪意のあるサイトによって悪用される可能性があります。

さらに、origin属性を確認した後でも、問題のデータが期待された形式であることを確認する必要があります。そうしないと、イベントのソースがクロスサイトスクリプティングの欠陥を利用して攻撃された場合、postMessage()メソッドを使用して送信された情報のさらなる未チェックの処理が、攻撃を受信者に伝播させる可能性があります。

作成者は、機密情報を含むメッセージのtargetOrigin引数にワイルドカードキーワード（*）を使用すべきではありません。そうしないと、メッセージが意図した受信者にのみ配信されることを保証する方法がなくなります。

任意のオリジンからのメッセージを受け入れる作成者は、サービス拒否攻撃のリスクを考慮することが奨励されます。攻撃者は大量のメッセージを送信する可能性があります。受信ページが各メッセージに対して高価な計算を行ったり、ネットワークトラフィックを発生させたりする場合、攻撃者のメッセージがサービス拒否攻撃に発展する可能性があります。作成者は、このような攻撃を非現実的にするために、レート制限（1分あたり一定数のメッセージのみを受け入れる）を採用することが奨励されます。

9.3.2.2 ユーザーエージェント

このAPIの整合性は、あるオリジンのスクリプトが他のオリジン（同一オリジンではないオリジン）に属するオブジェクトに対して任意のイベントを（dispatchEvent()などを使用して）投稿できないという事実に基づいています。

実装者は、この機能の実装に際して特に注意を払うよう強く促されます。この機能は、通常セキュリティ上の理由で許可されていない、あるドメインから別のドメインへの情報の送信を作成者に許可するものです。また、ユーザーエージェントは特定のプロパティにはアクセスを許可し、他のプロパティには許可しないよう慎重である必要があります。

ユーザーエージェントはまた、異なるオリジン間のメッセージトラフィックに対してレート制限を検討することが奨励されます。これは、ナイーブなサイトをサービス拒否攻撃から保護するためです。

9.3.3 メッセージの送信

window.postMessage(message [, options ])

Window/postMessage

Support in all current engines.

Firefox3+Safari4+Chrome2+
Opera9.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+

指定されたウィンドウにメッセージを投稿します。メッセージには構造化されたオブジェクト（ネストされたオブジェクトや配列など）を含めることができ、JavaScriptの値（文字列、数値、Dateオブジェクトなど）を含めることができ、File、Blob、FileList、ArrayBufferオブジェクトなどの特定のデータオブジェクトを含むことができます。

optionsのtransferメンバーにリストされているオブジェクトは、単にクローンされるのではなく、転送されるため、送信側ではもはや使用できません。

optionsのtargetOriginメンバーを使用して、ターゲットオリジンを指定できます。指定されていない場合、デフォルトは"/"です。このデフォルトは、メッセージを同一オリジンのターゲットにのみ制限します。

ターゲットウィンドウのオリジンが指定されたターゲットオリジンと一致しない場合、情報漏洩を防ぐためにメッセージは破棄されます。オリジンに関係なくメッセージをターゲットに送信するには、ターゲットオリジンを"*"に設定します。

次の条件に該当する場合、"DataCloneError" DOMException をスローします: transfer 配列に重複するオブジェクトが含まれている場合、または message がクローンできなかった場合。

window.postMessage(message, targetOrigin [, transfer ])

こちらはpostMessage()の別バージョンで、ターゲットオリジンがパラメータとして指定されます。window.postMessage(message, target, transfer)を呼び出すことは、window.postMessage(message, {targetOrigin, transfer})と同等です。

新しいDocumentにナビゲートされたばかりのbrowsing contextのWindowにメッセージを送信すると、メッセージが意図された受信者に届かない可能性が高くなります。これは、ターゲットのbrowsing contextのスクリプトがメッセージのリスナーを設定する時間を持たなければならないからです。したがって、例えば、新しく作成された子iframeのWindowにメッセージを送信するような状況では、子Documentが親にメッセージを送信してメッセージを受信する準備ができたことを知らせ、親がメッセージの送信を開始する前にこのメッセージを待つことを作成者に勧めます。

window post message stepsは、targetWindow、message、およびoptionsが与えられた場合に次のように実行されます：

  1. targetRealmをtargetWindowのrealmとします。

  2. incumbentSettingsをインカンベント設定オブジェクトとします。

  3. targetOriginをoptions["targetOrigin"]とします。

  4. targetOriginが単一のU+002F SOLIDUS文字（/）である場合、targetOriginをincumbentSettingsのoriginに設定します。

  5. そうでない場合、targetOriginが単一のU+002A ASTERISK文字（*）でない場合は：

    1. parsedURL を、targetOrigin に対してURL パーサーを実行した結果とします。

    2. parsedURL が失敗である場合、"SyntaxError" DOMException をスローします。

    3. targetOrigin を parsedURL の origin に設定します。

  6. transferをoptions["transfer"]とします。

  7. serializeWithTransferResultをStructuredSerializeWithTransfer(message, transfer)とし、例外を再スローします。

  8. targetWindowに与えられた投稿されたメッセージタスクソースに対して、次のステップを実行するためにグローバルタスクをキューに入れます：

    1. targetOrigin引数が単一のリテラルU+002A ASTERISK文字（*）でない場合、およびtargetWindowの関連するDocumentのoriginがtargetOriginと同一オリジンでない場合、戻ります。

    2. originをincumbentSettingsのoriginのシリアル化とします。

    3. sourceを、incumbentSettingsのグローバルオブジェクト（Windowオブジェクト）に対応するWindowProxyオブジェクトとします。

    4. deserializeRecordをStructuredDeserializeWithTransfer(serializeWithTransferResult, targetRealm)とします。

      これにより例外がスローされた場合、それをキャッチし、MessageEventを使用してtargetWindowでmessageerrorという名前のイベントを発火させ、origin属性をoriginに初期化し、source属性をsourceに初期化してから戻ります。

    5. messageCloneをdeserializeRecord.[[Deserialized]]とします。

    6. newPortsを、deserializeRecord.[[TransferredValues]]に含まれるすべてのMessagePortオブジェクトで構成される新しいフローズン配列とし、それらの相対的な順序を維持します。

    7. MessageEventを使用してtargetWindowでmessageという名前のイベントを発火させ、origin属性をoriginに初期化し、source属性をsourceに初期化し、data属性をmessageCloneに初期化し、ports属性をnewPortsに初期化します。

WindowインターフェースのpostMessage(message, options)メソッドのステップは、window post message stepsをthis、message、およびoptionsを使用して実行することです。

WindowインターフェースのpostMessage(message, targetOrigin, transfer)メソッドのステップは、window post message stepsをthis、message、および「["targetOrigin"→targetOrigin、"transfer"→transfer]」を使用して実行することです。

9.4 チャンネルメッセージング

Channel_Messaging_API

すべての現在のエンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

Channel_Messaging_API/Using_channel_messaging

すべての現在のエンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

9.4.1 イントロダクション

このセクションは規範的ではありません。

独立したコード片（例：異なるブラウジングコンテキストで実行される）同士が直接通信できるようにするため、作成者はチャンネルメッセージングを使用できます。

このメカニズムの通信チャネルは双方向パイプとして実装されており、各端にポートがあります。一方のポートで送信されたメッセージは、もう一方のポートで受信され、その逆も同様です。メッセージはDOMイベントとして配信され、実行中のタスクを中断したりブロックしたりすることなく配信されます。

接続（2つの「絡み合った」ポート）を作成するには、MessageChannel()コンストラクタを呼び出します：

var channel = new MessageChannel();

ポートの1つはローカルポートとして保持され、もう一方のポートはリモートコードに送信されます。例えば、postMessage()を使用して：

otherWindow.postMessage('hello', 'https://example.com', [channel.port2]);

メッセージを送信するには、ポート上のpostMessage()メソッドを使用します： 

channel.port1.postMessage('hello');

メッセージを受信するには、messageイベントをリッスンします：

channel.port1.onmessage = handleMessage;
 function handleMessage(event) {
   // メッセージは event.data に含まれています
   // ...
 }

ポート上で送信されるデータは構造化データにすることができます。例えば、ここでは文字列の配列がMessagePortで渡されます：

port1.postMessage(['hello', 'world']);
9.4.1.1 例

このセクションは規範的ではありません。

この例では、2つのJavaScriptライブラリがMessagePortを使用して互いに接続されています。これにより、後でライブラリが異なるフレームやWorkerオブジェクトでホストされるようになっても、APIを変更することなく動作します。

<script src="contacts.js"></script> <!-- contacts オブジェクトを公開します -->
 <script src="compose-mail.js"></script> <!-- composer オブジェクトを公開します -->
 <script>
  var channel = new MessageChannel();
  composer.addContactsProvider(channel.port1);
  contacts.registerConsumer(channel.port2);
 </script>

「addContactsProvider()」関数の実装は以下のようになります：

function addContactsProvider(port) {
   port.onmessage = function (event) {
     switch (event.data.messageType) {
       case 'search-result': handleSearchResult(event.data.results); break;
       case 'search-done': handleSearchDone(); break;
       case 'search-error': handleSearchError(event.data.message); break;
       // ...
     }
   };
 };

または、次のように実装することもできます：

function addContactsProvider(port) {
   port.addEventListener('message', function (event) {
     if (event.data.messageType == 'search-result')
       handleSearchResult(event.data.results);
   });
   port.addEventListener('message', function (event) {
     if (event.data.messageType == 'search-done')
       handleSearchDone();
   });
   port.addEventListener('message', function (event) {
     if (event.data.messageType == 'search-error')
       handleSearchError(event.data.message);
   });
   // ...
   port.start();
 };

主な違いは、addEventListener() を使用する場合、start() メソッドも呼び出す必要があるということです。onmessage を使用する場合、start() の呼び出しは暗黙的に行われます。

start() メソッドは、明示的に呼び出されたか暗黙的に（onmessage を設定することによって）呼び出されたかにかかわらず、メッセージの流れを開始します。メッセージポートに投稿されたメッセージは、スクリプトがハンドラーを設定する機会を得る前に破棄されないように、最初は一時停止されます。

9.4.1.2 Webにおけるオブジェクト能力モデルの基盤としてのポート

このセクションは規範的ではありません。

ポートは、システム内の他のアクターに対して限られた能力（オブジェクト能力モデルの意味で）を公開する方法と見なすことができます。これは、単に特定のオリジン内で便利なモデルとしてポートを使用する弱い能力システムである場合もあれば、1つのオリジンproviderが他のオリジンconsumerに対して変更を加えたり、providerから情報を取得したりする唯一のメカニズムとして提供する強力な能力モデルである場合もあります。

例えば、ソーシャルWebサイトが1つのiframeにユーザーのメール連絡先プロバイダー（別のオリジンのアドレス帳サイト）を埋め込み、別のiframeにゲーム（第三のオリジンから）を埋め込む状況を考えてみてください。外側のソーシャルサイトと2番目のiframe内のゲームは、最初のiframe内の何かにアクセスすることはできません。両者ができるのは、次のことだけです：

連絡先プロバイダーは、これらの方法、特に3つ目の方法を使用して、他のオリジンがユーザーのアドレス帳を操作できるAPIを提供できます。例えば、「add-contact Guillaume Tell <tell@pomme.example.net>」というメッセージに応答して、指定された人物とメールアドレスをユーザーのアドレス帳に追加することができます。

任意のサイトがユーザーの連絡先を操作できないようにするために、連絡先プロバイダーは特定の信頼できるサイト（例えばソーシャルサイト）のみがこれを行えるようにすることがあります。

さて、ゲームがユーザーのアドレス帳に連絡先を追加したい場合で、ソーシャルサイトがそれを代理で許可したいと仮定します。これにより、連絡先プロバイダーがソーシャルサイトに持っている信頼をゲームと「共有」することになります。これを行うにはいくつかの方法があります。最も単純な方法は、ソーシャルサイトがゲームサイトと連絡先サイトの間でメッセージをプロキシすることです。しかし、この解決策にはいくつかの問題があります。ソーシャルサイトがゲームサイトを完全に信頼して特権を乱用しないことを保証する必要があるか、ソーシャルサイトが各リクエストを検証して、複数の連絡先を追加する、連絡先を読み取る、または削除するなど許可したくないリクエストを防ぐ必要があります。また、複数のゲームが同時に連絡先プロバイダーとやり取りしようとする可能性がある場合には、追加の複雑さが必要になります。

しかし、メッセージチャネルとMessagePortオブジェクトを使用すれば、これらの問題はすべて解決できます。ゲームが連絡先を追加したいとソーシャルサイトに伝えると、ソーシャルサイトは連絡先を追加するように連絡先プロバイダーに要求するのではなく、単一の連絡先を追加する能力を求めます。連絡先プロバイダーは、MessagePortオブジェクトのペアを作成し、そのうちの1つをソーシャルサイトに送り返し、ソーシャルサイトはそれをゲームに転送します。これにより、ゲームと連絡先プロバイダーは直接接続され、連絡先プロバイダーは単一の「連絡先追加」リクエストのみを受け付け、それ以外は受け付けないことを認識します。言い換えれば、ゲームは単一の連絡先を追加する能力を付与されたことになります。

9.4.1.3 サービス実装の抽象化の基盤としてのポート

このセクションは規範的ではありません。

前のセクションの例を続けて、特に連絡先プロバイダーについて考えてみます。初期の実装では、単にサービスのXMLHttpRequestオブジェクトを使用し、iframe内でサービスを提供していたかもしれませんが、サービスの進化に伴い、共有ワーカーと単一のWebSocket接続を使用したいと考えるかもしれません。

初期設計でMessagePortオブジェクトを使用して能力を付与したり、複数の同時独立セッションを許可したりしていた場合、サービス実装はXMLHttpRequests-in-each-iframeモデルから、共有WebSocketモデルに変更することができ、APIをまったく変更せずに済みます。サービスプロバイダー側のポートはすべて共有ワーカーに転送でき、それがAPIのユーザーに何の影響も与えません。

9.4.2 メッセージチャネル

MessageChannel

すべての主要エンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+ 
[Exposed=(Window,Worker)]
 interface MessageChannel {
   constructor();
 
   readonly attribute MessagePort port1;
   readonly attribute MessagePort port2;
 };
channel = new MessageChannel()

MessageChannel/MessageChannel

すべての主要エンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

2つの新しいMessagePortオブジェクトを持つ新しいMessageChannelオブジェクトを返します。

channel.port1

MessageChannel/port1

すべての主要エンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

最初のMessagePortオブジェクトを返します。

channel.port2

MessageChannel/port2

すべての主要エンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android11+

2番目のMessagePortオブジェクトを返します。

MessageChannel オブジェクトには、ポート1とポート2という、どちらもMessagePortオブジェクトが関連付けられています。

new MessageChannel() コンストラクタの手順は次のとおりです:

  1. this の ポート1 を 新しい MessagePortに設定し、this の 関連する領域に設定します。

  2. this の ポート2 を 新しい MessagePortに設定し、this の 関連する領域に設定します。

  3. 結合 させます。this の ポート1 と this の ポート2 を。

port1 ゲッターの手順は、this の ポート1 を返します。

port2 ゲッターの手順は、this の ポート2 を返します。

9.4.3 MessageEventTarget ミックスイン 

interface mixin MessageEventTarget {
  attribute EventHandler onmessage;
  attribute EventHandler onmessageerror;
};

以下は、MessageEventTarget インターフェースを実装するオブジェクトによって、イベントハンドラー IDL 属性としてサポートされなければならないイベントハンドラー（およびそれに対応するイベントハンドラーイベントタイプ）です。

イベントハンドラー イベントハンドラーイベントタイプ
onmessage

MessagePort/message_event

すべての現行エンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+

DedicatedWorkerGlobalScope/message_event

すべての現行エンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+
message
onmessageerror

MessagePort/messageerror_event

すべての現行エンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

DedicatedWorkerGlobalScope/messageerror_event

すべての現行エンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+
messageerror

9.4.4 メッセージポート

MessagePort

すべての最新エンジンでサポートされています。

Firefox41+ Safari5+ Chrome2+
Opera10.6+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11+

各チャネルには2つのメッセージポートがあります。一方のポートで送信されたデータはもう一方のポートで受信され、その逆も可能です。

[Exposed=(Window,Worker,AudioWorklet), Transferable]
interface MessagePort : EventTarget {
  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});
  undefined start();
  undefined close();

  // event handlers
  attribute EventHandler onclose;
};

MessagePort includes MessageEventTarget;

dictionary StructuredSerializeOptions {
  sequence<object> transfer = [];
};
port.postMessage(message [, transfer])

MessagePort/postMessage

すべての最新エンジンでサポートされています。

Firefox41+ Safari5+ Chrome2+
Opera10.6+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11+

チャネルを通してメッセージを送信します。transferにリストされたオブジェクトは、クローンされるのではなく転送され、送信側では使用できなくなります。

transferに重複するオブジェクトやportが含まれている場合、またはmessageをクローンできなかった場合、"DataCloneError" DOMException をスローします。

port.start()

MessagePort/start

すべての最新エンジンでサポートされています。

Firefox41+ Safari5+ Chrome2+
Opera10.6+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11+

ポートで受信したメッセージのディスパッチを開始します。

port.close()

MessagePort/close

すべての最新エンジンでサポートされています。

Firefox41+ Safari5+ Chrome2+
Opera10.6+ Edge79+
Edge (Legacy)12+ Internet Explorer10+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android11+

ポートを切断し、それを非アクティブにします。

各 MessagePort オブジェクトには、message および messageerror イベントがディスパッチされるメッセージイベントターゲット（MessageEventTarget）があります。特に指定がない限り、デフォルトでは MessagePort オブジェクト自体になります。

各 MessagePort オブジェクトは、別のオブジェクトと（対称的な関係で）絡み合うことができます。各 MessagePort オブジェクトには、ポートメッセージキューと呼ばれるタスクソースもあり、最初は空です。ポートメッセージキューは有効または無効にでき、最初は無効になっています。一度有効にすると、ポートを再度無効にすることはできません（ただし、キュー内のメッセージは別のキューに移動したり、完全に削除されたりする可能性があり、これはほぼ同じ効果があります）。MessagePort には、出荷済みフラグもあり、最初は false である必要があります。

ポートのポートメッセージキューが有効化されると、イベントループは、それをタスクソースの1つとして使用しなければなりません。 ポートの 関連グローバルオブジェクトが Window である場合、そのポートの ポートメッセージキューにキューされたすべての タスクは、そのポートの関連グローバルオブジェクトに関連付けられた Documentに関連付けられなければなりません。

ドキュメントが完全にアクティブであっても、イベントリスナーがすべて完全にアクティブでないドキュメントのコンテキストで作成された場合、ドキュメントが再び完全にアクティブになるまでメッセージは受信されません。

各イベントループには、タスクソースと呼ばれる未出荷ポートメッセージキューがあります。これは仮想的なタスクソースです。 これは、出荷済みフラグが false であり、ポートメッセージキューが有効で、その関連エージェントのイベントループがそのイベントループである各 MessagePort のポートメッセージキューのタスクを含んでいるかのように動作しなければなりません。 各タスクがそれぞれのタスクソースに追加された順序で、このタスクソースに含まれるべきです。タスクが未出荷ポートメッセージキューから削除される場合、それは代わりにそのポートメッセージキューから削除されなければなりません。

MessagePort の出荷済みフラグが false である場合、そのポートメッセージキューはイベントループの目的において無視されなければなりません。（未出荷ポートメッセージキューが代わりに使用されます。）

出荷済みフラグは、ポート、そのツイン、またはクローンされたオブジェクトが転送されるかされた場合に true に設定されます。MessagePortの出荷済みフラグが true の場合、そのポートメッセージキューは、未出荷ポートメッセージキューの影響を受けずに一級のタスクソースとして機能します。

ユーザーエージェントが二つのMessagePortオブジェクトを絡め合うとき、それは次のステップを実行しなければならない：

  1. 片方のポートが既に絡め合っている場合、それを解き、絡め合っていたポートを解く。

    以前に絡め合っていた二つのポートがMessageChannelオブジェクトの二つのポートであった場合、そのMessageChannelオブジェクトはもはや実際のチャネルを表さなくなる：そのオブジェクト内の二つのポートはもはや絡め合っていない。

  2. 絡め合うべき二つのポートを関連付け、新しいチャネルの二つの部分を形成するようにする。（このチャネルを表すMessageChannelオブジェクトは存在しない。）

    このステップを経たポートAとBは、互いに絡め合っていると言われ、一方が他方に絡め合っている状態である。

    この仕様ではこのプロセスを瞬時に行うものとして記述しているが、実装はメッセージのやり取りによって実装される可能性が高い。すべてのアルゴリズムと同様に、重要なのは最終的な結果が仕様から見てブラックボックス的に区別できないことである。

MessagePortを開始したinitiatorPortに対して、解きほぐすステップは次の通りである：

  1. initiatorPortが絡め合っていたMessagePortをotherPortとする。

  2. 確認：otherPortが存在すること。

  3. initiatorPortとotherPortを解きほぐし、これ以上絡め合わず、互いに関連付けられなくする。

  4. イベントを発生させる名前付き閉じるイベントをotherPortで発生させる。

この閉じるイベントは、ポートが明示的に閉じられていない場合でも発生する。このイベントが発生するケースは次の通りである：

このイベントはotherPortでのみ発生する。なぜならinitiatorPortが明示的に閉じることをトリガーしたか、そのDocumentが存在しなくなったか、または既にガベージコレクションされたためである。

MessagePortオブジェクトは転送可能なオブジェクトです。次の転送手順に従います。

  1. valueの配送済みフラグを真に設定します。

  2. dataHolderの[[PortMessageQueue]]にvalueのポートメッセージキューを設定します。

  3. valueが他のポートremotePortと絡め合っている場合：

    1. remotePortの配送済みフラグを真に設定します。

    2. dataHolderの[[RemotePort]]にremotePortを設定します。

  4. それ以外の場合、dataHolderの[[RemotePort]]をnullに設定します。

次に、受信側の転送手順に従います：

  1. value の 出荷済みフラグを true に設定します。

  2. dataHolder.[[PortMessageQueue]] 内で message イベントを発生させるすべてのタスクを、存在する場合、value の ポートメッセージキューに移動し、value の ポートメッセージキューを初期の無効状態のままにし、value の 関連するグローバルオブジェクトが Window の場合、移動されたタスクを value の関連するグローバルオブジェクトの 関連付けられた Document に関連付けます。

  3. dataHolder.[[RemotePort]] が null でない場合、dataHolder.[[RemotePort]] と value を絡ませます。（これにより、dataHolder.[[RemotePort]] は転送された元のポートから解き放たれます。）

sourcePort、targetPort、message、および options を指定したメッセージポート post message ステップは次のとおりです。

  1. transferをoptions["transfer"]とします。

  2. もしtransferが含まれている場合、sourcePortがあれば、"DataCloneError"DOMExceptionをスローします。

  3. doomedをfalseとします。

  4. もしtargetPortがnullでなく、かつtransferが含まれている場合、doomedをtrueに設定し、開発者コンソールにターゲットポートが自分自身に投稿されたことをオプションで報告し、通信チャンネルが失われたことを通知します。

  5. serializeWithTransferResultをStructuredSerializeWithTransfer(message, transfer)とし、例外が発生した場合は再スローします。

  6. もしtargetPortがnullであるか、またはdoomedがtrueである場合は、終了します。

  7. targetPortのポートメッセージキューに次の手順を実行するタスクを追加します：

    1. finalTargetPort を、タスクが現在存在するポートメッセージキュー内の MessagePort とします。

      targetPort 自体が転送され、そのすべてのタスクが一緒に移動した場合、これは targetPort とは異なる可能性があります。

    2. messageEventTarget を finalTargetPort の メッセージイベントターゲットとします。

    3. targetRealm を finalTargetPort の 関連レルムとします。

    4. deserializeRecord を StructuredDeserializeWithTransfer(serializeWithTransferResult, targetRealm) とします。

      これが例外をスローした場合、それをキャッチし、MessageEvent を使用して messageEventTarget で messageerror という名前のイベントを発生させ、その後戻ります。

    5. messageClone を deserializeRecord.[[Deserialized]] とします。

    6. newPorts を、存在する場合、deserializeRecord.[[TransferredValues]] 内のすべての MessagePort オブジェクトで構成される新しい凍結配列とし、それらの相対的な順序を維持します。

    7. MessageEvent を使用して、data 属性を messageClone に初期化し、ports 属性を newPorts に初期化して、messageEventTarget で message という名前のイベントを発生させます。

postMessage(message, options)メソッドの手順は以下の通りです：

  1. targetPortを、このと絡め合っているポートとし、それ以外の場合はnullとします。

  2. メッセージポートのメッセージ送信手順を実行し、この、targetPort、messageおよびoptionsを提供します。

postMessage(message, transfer)メソッドの手順は以下の通りです：

  1. targetPortを、このと絡め合っているポートとし、それ以外の場合はnullとします。

  2. optionsを「transfer」→ transfer」とします。

  3. メッセージポートのメッセージ送信手順を実行し、この、targetPort、messageおよびoptionsを提供します。

The start() method steps are to enable this's port message queue, if it is not already enabled.

close()メソッドの手順は以下の通りです：

  1. thisの[[Detached]]内部スロットの値をtrueに設定します。

  2. もしthisが絡み合っている場合、それを解く。

以下は、MessagePort インターフェースを実装するすべてのオブジェクトによって、イベントハンドラー IDL 属性としてサポートされなければならないイベントハンドラー（およびそれらに対応するイベントハンドラーイベントタイプ）です。

イベントハンドラー イベントハンドラーイベントタイプ
onclose close

MessagePort オブジェクトの onmessage IDL 属性が初めて設定されたとき、start() メソッドが呼び出されたかのように、ポートのポートメッセージキューを有効にする必要があります。

9.4.5 ポートとガベージコレクション

MessagePort オブジェクト o がガベージコレクションされた場合、もし o がエンタングルされている場合、ユーザーエージェントは ディセンタングル を実行する必要があります。 o を。

MessagePort オブジェクト o がエンタングルされていて、メッセージ または メッセージエラー イベントリスナーが登録されている場合、ユーザーエージェントは o のエンタングルされた MessagePort オブジェクトが o に強い参照を持っているかのように振る舞わなければなりません。

さらに、MessagePort オブジェクトは、 そのオブジェクトに対してディスパッチされる予定の タスク によって参照されるイベントが存在する間、またはその MessagePort オブジェクトの ポートメッセージキュー が 有効であり、空でない間はガベージコレクションされてはなりません。

したがって、メッセージポートは受信され、イベントリスナーが与えられ、忘れられることができ、 そのイベントリスナーがメッセージを受信できる限り、チャネルは維持されます。

もちろん、これがチャネルの両側で発生した場合、両方のポートはガベージコレクションされる可能性があり、 生きたコードから到達できないにもかかわらず、互いに強い参照を持っているためです。 しかし、メッセージポートに保留中のメッセージがある場合、ガベージコレクションされることはありません。

著者は、リソースが再収集されるように、MessagePort オブジェクトを明示的に閉じてディセンタングルすることを強く推奨されます。 多くの MessagePort オブジェクトを作成し、 閉じずに破棄することは、特に MessagePort に関しては、クロスプロセスの調整を伴うガベージコレクションが発生するため、ガベージコレクションが必ずしも迅速に行われないため、一時的なメモリ使用量が高くなる可能性があります。

9.5 他の閲覧コンテキストへのブロードキャスト

BroadcastChannel

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Broadcast_Channel_API

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

同じユーザーエージェントで、異なる無関係の 閲覧コンテキスト において 同じユーザーが開いた、単一の オリジン 上のページは、 互いに通知を送信する必要があることがあります。例えば、「こちらでユーザーがログインしましたので、再度資格情報を確認してください」といった通知です。

より複雑なケース、例えば共有状態のロックの管理、サーバーと複数のローカルクライアント間のリソースの同期管理、リモートホストとの WebSocket 接続の共有などでは、共有ワーカー が 最も適した解決策です。

しかし、共有ワーカーが過剰な負荷となるような単純なケースでは、著者はこのセクションで説明するシンプルなチャネルベースのブロードキャストメカニズムを使用することができます。

[Exposed=(Window,Worker)]
 interface BroadcastChannel : EventTarget {
   constructor(DOMString name);
 
   readonly attribute DOMString name;
   undefined postMessage(any message);
   undefined close();
   attribute EventHandler onmessage;
   attribute EventHandler onmessageerror;
 };
broadcastChannel = new BroadcastChannel(name)

BroadcastChannel/BroadcastChannel

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたチャンネル名に対してメッセージの送受信を行うための新しい BroadcastChannel オブジェクトを返します。

broadcastChannel.name

BroadcastChannel/name

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

チャンネル名（コンストラクタに渡されたもの）を返します。

broadcastChannel.postMessage(message)

BroadcastChannel/postMessage

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

指定されたメッセージを、同じチャンネルに設定された他の BroadcastChannel オブジェクトに送信します。メッセージは、ネストされたオブジェクトや配列など、構造化されたオブジェクトにすることができます。

broadcastChannel.close()

BroadcastChannel/close

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

BroadcastChannel オブジェクトを閉じ、ガベージコレクションにかけることができます。

A BroadcastChannel オブジェクトは、チャンネル名と閉じられたフラグを持っています。

new BroadcastChannel(name)のコンストラクタ手順は次の通りです:

  1. thisのチャンネル名をnameに設定します。

  2. thisの閉じられたフラグをfalseに設定します。

nameのゲッターステップは、thisのチャンネル名を返します。

BroadcastChannel オブジェクトは、次の条件を満たすときにメッセージ送信の対象とみなされます:

postMessage(message)メソッドの手順は次の通りです:

  1. thisがメッセージ送信の対象でない場合、 処理を終了します。

  2. thisの閉じられたフラグがtrueの場合、 "InvalidStateError" DOMExceptionをスローします。

  3. serializedを、StructuredSerialize(message)で取得します。 例外を再スローします。

  4. sourceOriginをthisの関連設定オブジェクトの オリジンとして設定します。

  5. sourceStorageKeyを、ストレージ目的ではない場合のストレージキーを取得します。 取得するにはthisの関連設定オブジェクトを使用します。

  6. destinationsリストを、次の条件を満たすBroadcastChannel オブジェクトで作成します:

  7. sourceをdestinationsから削除します。

  8. destinationsを、関連エージェント が同じであるすべてのBroadcastChannel オブジェクトが作成順で古いものから並ぶように並べ替えます。 （これは完全な順序を定義するものではありません。この制約内で、ユーザーエージェントはリストを実装定義の方法で並べ替えることができます。）

  9. 各destinationについて、グローバルタスクをキューに追加 します。 DOM操作タスクソース に基づき、destinationの関連するグローバルオブジェクト に対して、以下のステップを実行します:

    1. もしdestinationの閉じられたフラグがtrueの場合、 これらのステップを中止します。

    2. targetRealmをdestinationの関連するレルム に設定します。

    3. dataをStructuredDeserialize(serialized, targetRealm)で取得します。

      これが例外をスローした場合は、例外をキャッチし、イベントを発火し、messageerror という名前のイベントを、destinationで発火し、 MessageEvent を使用し、オリジンのシリアル化 に基づいてsourceOriginを初期化します。次に、これらのステップを中止します。

    4. イベントを発火し、message という名前のイベントをdestinationで発火し、MessageEvent を使用し、data 属性をdataで初期化し、origin 属性をsourceOriginのシリアル化で初期化します。

BroadcastChannel オブジェクトが、閉じられたフラグ がfalseのときにmessage または messageerror イベントのリスナーが登録されている場合、 BroadcastChannel オブジェクト自体に対する BroadcastChannel オブジェクトの関連するグローバルオブジェクト からの強い参照が存在しなければなりません。

close()メソッドの手順は、thisの閉じられたフラグ をtrueに設定することです。

作成されたBroadcastChannel オブジェクトは、不要になったら明示的に閉じることが強く推奨されます。 多数のBroadcastChannel オブジェクトを作成して、イベントリスナーを残したまま閉じずに放置すると、オブジェクトがイベントリスナーを持っている限り、 （またはそのページやワーカーが閉じられるまで）オブジェクトが生き続けるため、見かけ上のメモリリークを引き起こす可能性があります。

次のものは、イベントハンドラー （およびそれらに対応するイベントハンドラーイベントタイプ）で、 すべてのBroadcastChannel インターフェイスを実装するオブジェクトが イベントハンドラーIDL属性 としてサポートしなければならないものです。

イベントハンドラー イベントハンドラーイベントタイプ
onmessage

BroadcastChannel/message_event

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
message
onmessageerror

BroadcastChannel/messageerror_event

すべての現在のエンジンでサポートされています。

Firefox57+Safari15.4+Chrome60+
Opera?Edge79+
Edge (Legacy)?Internet Explorerいいえ
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+
messageerror

例えば、ユーザーが別のタブでログアウトしたときにページが通知を受け取る必要がある場合:

var authChannel = new BroadcastChannel('auth');
 authChannel.onmessage = function (event) {
   if (event.data == 'logout')
     showLogout();
 }
 
 function logoutRequested() {
   // ユーザーがログアウトを要求したときに呼び出される
   doLogout();
   showLogout();
   authChannel.postMessage('logout');
 }
 
 function doLogout() {
   // ユーザーを実際にログアウトさせる（例: クッキーのクリア）
   // ...
 }
 
 function showLogout() {
   // ログアウトしたことを示すUIの更新
   // ...
 }

10 Web workers

Web_Workers_API

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

Web_Workers_API/Using_web_workers

10.1 はじめに

10.1.1 範囲

このセクションは規範ではありません。

この仕様は、ユーザーインターフェイススクリプトとは独立してバックグラウンドでスクリプトを実行するための API を定義します。

これにより、クリックやその他のユーザー操作に応答するスクリプトによって中断されることなく、長時間実行されるスクリプトを実行でき、ページを応答性を維持しながら長時間実行できるようにします。

ここで述べるバックグラウンドスクリプト（ワーカーと呼ばれます）は比較的重いものであり、大量に使用することは意図されていません。たとえば、4 メガピクセルの画像の各ピクセルに 1 つのワーカーを起動することは不適切です。以下の例では、ワーカーの適切な使用例を示します。

一般的に、ワーカーは長期間の存続が期待され、起動時のパフォーマンスコストが高く、インスタンスごとのメモリコストも高いです。

10.1.2 例

このセクションは規範ではありません。

ワーカーを使用するさまざまな用途があります。以下のサブセクションでは、これらの使用例をいくつか紹介します。

10.1.2.1 バックグラウンドでの数値計算ワーカー

このセクションは規範ではありません。

ワーカーの最も簡単な使用法は、ユーザーインターフェイスを中断することなく計算負荷の高いタスクを実行することです。

この例では、メインドキュメントがワーカーを生成して素数を（単純に）計算し、見つかったばかりの素数を逐次的に表示します。

メインページは次のとおりです。

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <meta charset="utf-8">
   <title>Worker example: One-core computation</title>
  </head>
  <body>
   <p>The highest prime number discovered so far is: <output id="result"></output></p>
   <script>
    var worker = new Worker('worker.js');
    worker.onmessage = function (event) {
      document.getElementById('result').textContent = event.data;
    };
   </script>
  </body>
 </html>

Worker() コンストラクタ呼び出しはワーカーを作成し、そのワーカーを表す Worker オブジェクトを返します。これはワーカーとの通信に使用されます。そのオブジェクトの onmessage イベントハンドラにより、コードはワーカーからメッセージを受信できます。

ワーカー自体は次のようになります:

var n = 1;
 search: while (true) {
   n += 1;
   for (var i = 2; i <= Math.sqrt(n); i += 1)
     if (n % i == 0) continue search;// 素数を発見しました！
   postMessage(n);
 }

このコードの大部分は、素数を検索する最適化されていないコードです。素数が見つかったときに、postMessage() メソッドを使用してページにメッセージを送信します。

この例をオンラインで見る.

10.1.2.2 JavaScript モジュールを使用したワーカーの使用

このセクションは規範ではありません。

これまでの例では、クラシックスクリプトを実行するワーカーを示してきました。ワーカーは、代わりにモジュールスクリプトを使用してインスタンス化することもでき、通常の利点を備えています。たとえば、他のモジュールをインポートするための JavaScript import ステートメントを使用できること、デフォルトで厳格モードであること、トップレベルの宣言がワーカーのグローバルスコープを汚染しないことなどです。

import ステートメントが使用可能であるため、importScripts() メソッドは、モジュールワーカー内で自動的に失敗します。

この例では、メインドキュメントがワーカーを使用してオフメインスレッドの画像操作を行います。使用するフィルタは別のモジュールからインポートされています。

メインページは次のとおりです:

<!DOCTYPE html>
 <html lang="en">
 <meta charset="utf-8">
 <title>Worker example: image decoding</title>
 
 <p>
   <label>
     画像の URL を入力してデコード
     <input type="url" id="image-url" list="image-list">
     <datalist id="image-list">
       <option value="https://html.spec.whatwg.org/images/drawImage.png">
       <option value="https://html.spec.whatwg.org/images/robots.jpeg">
       <option value="https://html.spec.whatwg.org/images/arcTo2.png">
     </datalist>
   </label>
 </p>

 <p>
   <label>
     適用するフィルタを選択
     <select id="filter">
       <option value="none">なし</option>
       <option value="grayscale">グレースケール</option>
       <option value="brighten">20% 明るく</option>
     </select>
   </label>
 </p>

 <div id="output"></div>

 <script type="module">
   const worker = new Worker("worker.js", { type: "module" });
   worker.onmessage = receiveFromWorker;

   const url = document.querySelector("#image-url");
   const filter = document.querySelector("#filter");
   const output = document.querySelector("#output");

   url.oninput = updateImage;
   filter.oninput = sendToWorker;

   let imageData, context;

   function updateImage() {
     const img = new Image();
     img.src = url.value;

     img.onload = () => {
       const canvas = document.createElement("canvas");
       canvas.width = img.width;
       canvas.height = img.height;

       context = canvas.getContext("2d");
       context.drawImage(img, 0, 0);
       imageData = context.getImageData(0, 0, canvas.width, canvas.height);

       sendToWorker();
       output.replaceChildren(canvas);
     };
   }

   function sendToWorker() {
     worker.postMessage({ imageData, filter: filter.value });
   }

   function receiveFromWorker(e) {
     context.putImageData(e.data, 0, 0);
   }
 </script>

次に、ワーカーファイルは次のようになります:

import * as filters from "./filters.js";

self.onmessage = e => {
   const { imageData, filter } = e.data;
   filters[filter](imageData);
   self.postMessage(imageData, [imageData.data.buffer]);
 };

これがファイル filters.js からインポートされています:

export function none() {}

export function grayscale({ data: d }) {
   for (let i = 0; i < d.length; i += 4) {
     const [r, g, b] = [d[i], d[i + 1], d[i + 2]];

     // CIE ルミナンス (RGB に対して)
     // 人間の目は赤と青を見るのが苦手なので、それらを軽視します。
     d[i] = d[i + 1] = d[i + 2] = 0.2126 * r + 0.7152 * g + 0.0722 * b;
   }

この例をオンラインで見る.

10.1.2.3 共有ワーカーの紹介

SharedWorker

すべての現在のエンジンでサポートされています。

Firefox29+Safari16+Chrome5+
Opera10.6+Edge79+
Edge (レガシー)?Internet Explorerサポートなし
Firefox Android33+Safari iOS16+Chrome AndroidサポートなしWebView Android?Samsung Internet4.0–5.0Opera Android11–14

このセクションは規範ではありません。

このセクションでは、共有ワーカーの「Hello World」例を紹介します。共有ワーカーは、複数の接続を持つことができるため、専用ワーカーとは異なる API を使用します。

この最初の例では、ワーカーに接続する方法と、ワーカーが接続時にページにメッセージを送信する方法を示しています。受信したメッセージはログに表示されます。

以下は HTML ページです:

<!DOCTYPE HTML>
 <html lang="en">
 <meta charset="utf-8">
 <title>共有ワーカー: デモ 1</title>
 <pre id="log">ログ:</pre>
 <script>
   var worker = new SharedWorker('test.js');
   var log = document.getElementById('log');
   worker.port.onmessage = function(e) { // 注: worker.onmessage ではありません！
     log.textContent += '\n' + e.data;
   }
 </script>

以下は JavaScript ワーカーです:

onconnect = function(e) {
   var port = e.ports[0];
   port.postMessage('Hello World!');
 }

この例をオンラインで見る.

この2番目の例では、最初の例を拡張し、2つの点を変更しています。まず、メッセージがイベントハンドラー IDL 属性ではなく、addEventListener() を使用して受信されるようになります。そして2番目に、ワーカーにメッセージが送信され、ワーカーがそれに応じてもう一度メッセージを送信します。受信したメッセージは再びログに表示されます。

以下は HTML ページです:

<!DOCTYPE HTML>
 <html lang="en">
 <meta charset="utf-8">
 <title>共有ワーカー: デモ 2</title>
 <pre id="log">ログ:</pre>
 <script>
   var worker = new SharedWorker('test.js');
   var log = document.getElementById('log');
   worker.port.addEventListener('message', function(e) {
     log.textContent += '\n' + e.data;
   }, false);
   worker.port.start(); // 注: addEventListener を使用する場合にはこれが必要です
   worker.port.postMessage('ping');
 </script>

以下は JavaScript ワーカーです:

onconnect = function(e) {
   var port = e.ports[0];
   port.postMessage('Hello World!');
   port.onmessage = function(e) {
     port.postMessage('pong'); // e.ports[0].postMessage ではありません！
     // e.target.postMessage('pong') でも機能します
   }
 }

この例をオンラインで見る.

最後に、例をさらに拡張して、2つのページが同じワーカーに接続する方法を示します。この場合、2 番目のページは最初のページの iframe にすぎませんが、同じ原理が別の トップレベル トラバーサブル にある完全に別のページにも適用されます。

以下は外部 HTML ページです:

<!DOCTYPE HTML>
 <html lang="en">
 <meta charset="utf-8">
 <title>共有ワーカー: デモ 3</title>
 <pre id="log">ログ:</pre>
 <script>
   var worker = new SharedWorker('test.js');
   var log = document.getElementById('log');
   worker.port.addEventListener('message', function(e) {
     log.textContent += '\n' + e.data;
   }, false);
   worker.port.start();
   worker.port.postMessage('ping');
 </script>
 <iframe src="inner.html"></iframe>

以下は内部 HTML ページです:

<!DOCTYPE HTML>
 <html lang="en">
 <meta charset="utf-8">
 <title>共有ワーカー: デモ 3 内部フレーム</title>
 <pre id=log>内部ログ:</pre>
 <script>
   var worker = new SharedWorker('test.js');
   var log = document.getElementById('log');
   worker.port.onmessage = function(e) {
    log.textContent += '\n' + e.data;
   }
 </script>

以下は JavaScript ワーカーです:

var count = 0;
 onconnect = function(e) {
   count += 1;
   var port = e.ports[0];
   port.postMessage('Hello World! あなたは接続 #' + count);
   port.onmessage = function(e) {
     port.postMessage('pong'); 
   }
 }

この例をオンラインで見る.

10.1.2.4 共有ワーカーを使用した共有状態

このセクションは規範的ではありません。

この例では、同じ地図を表示している複数のウィンドウ（ビューアー）を開くことができます。すべてのウィンドウは同じ地図情報を共有しており、単一のワーカーがすべてのビューアーを調整します。各ビューアーは独立して移動できますが、地図上にデータを設定すると、すべてのビューアーが更新されます。

メインページは特に面白くなく、ビューアーを開く手段を提供するだけです：

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <meta charset="utf-8">
   <title>Workers example: Multiviewer</title>
   <script>
    function openViewer() {
      window.open('viewer.html');
    }
   </script>
  </head>
  <body>
   <p><button type=button onclick="openViewer()">Open a new
   viewer</button></p>
   <p>Each viewer opens in a new window. You can have as many viewers
   as you like, they all view the same data.</p>
  </body>
 </html>

ビューアーの方がもっと複雑です：

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <meta charset="utf-8">
   <title>Workers example: Multiviewer viewer</title>
   <script>
    var worker = new SharedWorker('worker.js', 'core');
 
    // CONFIGURATION
    function configure(event) {
      if (event.data.substr(0, 4) != 'cfg ') return;
      var name = event.data.substr(4).split(' ', 1)[0];
      // update display to mention our name is name
      document.getElementsByTagName('h1')[0].textContent += ' ' + name;
      // no longer need this listener
      worker.port.removeEventListener('message', configure, false);
    }
    worker.port.addEventListener('message', configure, false);
 
    // MAP
    function paintMap(event) {
      if (event.data.substr(0, 4) != 'map ') return;
      var data = event.data.substr(4).split(',');
      // display tiles data[0] .. data[8]
      var canvas = document.getElementById('map');
      var context = canvas.getContext('2d');
      for (var y = 0; y < 3; y += 1) {
        for (var x = 0; x < 3; x += 1) {
          var tile = data[y * 3 + x];
          if (tile == '0')
            context.fillStyle = 'green';
          else
            context.fillStyle = 'maroon';
          context.fillRect(x * 50, y * 50, 50, 50);
        }
      }
    }
    worker.port.addEventListener('message', paintMap, false);
 
    // PUBLIC CHAT
    function updatePublicChat(event) {
      if (event.data.substr(0, 4) != 'txt ') return;
      var name = event.data.substr(4).split(' ', 1)[0];
      var message = event.data.substr(4 + name.length + 1);
      // display "<name> message" in public chat
      var public = document.getElementById('public');
      var p = document.createElement('p');
      var n = document.createElement('button');
      n.textContent = '<' + name + '> ';
      n.onclick = function () { worker.port.postMessage('msg ' + name); };
      p.appendChild(n);
      var m = document.createElement('span');
      m.textContent = message;
      p.appendChild(m);
      public.appendChild(p);
    }
    worker.port.addEventListener('message', updatePublicChat, false);
 
    // PRIVATE CHAT
    function startPrivateChat(event) {
      if (event.data.substr(0, 4) != 'msg ') return;
      var name = event.data.substr(4).split(' ', 1)[0];
      var port = event.ports[0];
      // display a private chat UI
      var ul = document.getElementById('private');
      var li = document.createElement('li');
      var h3 = document.createElement('h3');
      h3.textContent = 'Private chat with ' + name;
      li.appendChild(h3);
      var div = document.createElement('div');
      var addMessage = function(name, message) {
        var p = document.createElement('p');
        var n = document.createElement('strong');
        n.textContent = '<' + name + '> ';
        p.appendChild(n);
        var t = document.createElement('span');
        t.textContent = message;
        p.appendChild(t);
        div.appendChild(p);
      };
      port.onmessage = function (event) {
        addMessage(name, event.data);
      };
      li.appendChild(div);
      var form = document.createElement('form');
      var p = document.createElement('p');
      var input = document.createElement('input');
      input.size = 50;
      p.appendChild(input);
      p.appendChild(document.createTextNode(' '));
      var button = document.createElement('button');
      button.textContent = 'Post';
      p.appendChild(button);
      form.onsubmit = function () {
        port.postMessage(input.value);
        addMessage('me', input.value);
        input.value = '';
        return false;
      };
      form.appendChild(p);
      li.appendChild(form);
      ul.appendChild(li);
    }
    worker.port.addEventListener('message', startPrivateChat, false);
 
    worker.port.start();
   </script>
  </head>
  <body>
   <h1>Viewer</h1>
   <h2>Map</h2>
   <p><canvas id="map" height=150 width=150></canvas></p>
   <p>
    <button type=button onclick="worker.port.postMessage('mov left')">Left</button>
    <button type=button onclick="worker.port.postMessage('mov up')">Up</button>
    <button type=button onclick="worker.port.postMessage('mov down')">Down</button>
    <button type=button onclick="worker.port.postMessage('mov right')">Right</button>
    <button type=button onclick="worker.port.postMessage('set 0')">Set 0</button>
    <button type=button onclick="worker.port.postMessage('set 1')">Set 1</button>
   </p>
   <h2>Public Chat</h2>
   <div id="public"></div>
   <form onsubmit="worker.port.postMessage('txt ' + message.value); message.value = ''; return false;">
    <p>
     <input type="text" name="message" size="50">
     <button>Post</button>
    </p>
   </form>
   <h2>Private Chat</h2>
   <ul id="private"></ul>
  </body>
 </html>

ビューアーの記述方法について、いくつか重要な点があります。

複数のリスナー。単一のメッセージ処理関数の代わりに、ここでは複数のイベントリスナーをアタッチしており、それぞれがメッセージに関連しているかを迅速に確認します。この例では大きな違いはありませんが、複数の著者が一つのポートを使ってワーカーと通信し、協力しようとする場合、それぞれのコードが独立して動作し、すべての変更を一つのイベント処理関数にまとめる必要がなくなります。

この方法でイベントリスナーを登録することで、特定のリスナーが不要になったときに、configure()メソッドで行われているように、それらを解除することができます。

最後に、ワーカーについて：

var nextName = 0;
 function getNextName() {
   // this could use more friendly names
   // but for now just return a number
   return nextName++;
 }
 
 var map = [
  [0, 0, 0, 0, 0, 0, 0],
  [1, 1, 0, 1, 0, 1, 1],
  [0, 1, 0, 1, 0, 0, 0],
  [0, 1, 0, 1, 0, 1, 1],
  [0, 0, 0, 1, 0, 0, 0],
  [1, 0, 0, 1, 1, 1, 1],
  [1, 1, 0, 1, 1, 0, 1],
 ];
 
 function wrapX(x) {
   if (x < 0) return wrapX(x + map[0].length);
   if (x >= map[0].length) return wrapX(x - map[0].length);
   return x;
 }
 
 function wrapY(y) {
   if (y < 0) return wrapY(y + map.length);
   if (y >= map[0].length) return wrapY(y - map.length);
   return y;
 }
 
 function wrap(val, min, max) {
   if (val < min)
     return val + (max-min)+1;
   if (val > max)
     return val - (max-min)-1;
   return val;
 }
 
 function sendMapData(viewer) {
   var data = '';
   for (var y = viewer.y-1; y <= viewer.y+1; y += 1) {
     for (var x = viewer.x-1; x <= viewer.x+1; x += 1) {
       if (data != '')
         data += ',';
       data += map[wrap(y, 0, map[0].length-1)][wrap(x, 0, map.length-1)];
     }
   }
   viewer.port.postMessage('map ' + data);
 }
 
 var viewers = {};
 onconnect = function (event) {
   var name = getNextName();
   event.ports[0]._data = { port: event.ports[0], name: name, x: 0, y: 0, };
   viewers[name] = event.ports[0]._data;
   event.ports[0].postMessage('cfg ' + name);
   event.ports[0].onmessage = getMessage;
   sendMapData(event.ports[0]._data);
 };
 
 function getMessage(event) {
   switch (event.data.substr(0, 4)) {
     case 'mov ':
       var direction = event.data.substr(4);
       var dx = 0;
       var dy = 0;
       switch (direction) {
         case 'up': dy = -1; break;
         case 'down': dy = 1; break;
         case 'left': dx = -1; break;
         case 'right': dx = 1; break;
       }
       event.target._data.x = wrapX(event.target._data.x + dx);
       event.target._data.y = wrapY(event.target._data.y + dy);
       sendMapData(event.target._data);
       break;
     case 'set ':
       var value = event.data.substr(4);
       map[event.target._data.y][event.target._data.x] = value;
       for (var viewer in viewers)
         sendMapData(viewers[viewer]);
       break;
     case 'txt ':
       var name = event.target._data.name;
       var message = event.data.substr(4);
       for (var viewer in viewers)
         viewers[viewer].port.postMessage('txt ' + name + ' ' + message);
       break;
     case 'msg ':
       var party1 = event.target._data;
       var party2 = viewers[event.data.substr(4).split(' ', 1)[0]];
       if (party2) {
         var channel = new MessageChannel();
         party1.port.postMessage('msg ' + party2.name, [channel.port1]);
         party2.port.postMessage('msg ' + party1.name, [channel.port2]);
       }
       break;
   }
 }

複数ページへの接続。このスクリプトは、onconnect イベントリスナーを使用して、複数の接続をリッスンします。

ダイレクトチャネル。ワーカーがあるビューアーから他のビューアーを指定する「msg」メッセージを受信すると、2つのビューアー間に直接接続を設定し、ワーカーがすべてのメッセージをプロキシする必要がなくなります。

この例をオンラインで見る。

10.1.2.5 デリゲーション

このセクションは規範的ではありません。

マルチコアCPUが普及している現在、より良いパフォーマンスを得る一つの方法は、計算コストの高いタスクを複数のワーカーに分割することです。この例では、1から10,000,000までの各数に対して行われる計算コストの高いタスクを、10個のサブワーカーに分散させています。

メインページは次のとおりで、結果を報告するだけです:

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <meta charset="utf-8">
   <title>Worker example: Multicore computation</title>
  </head>
  <body>
   <p>Result: <output id="result"></output></p>
   <script>
    var worker = new Worker('worker.js');
    worker.onmessage = function (event) {
      document.getElementById('result').textContent = event.data;
    };
   </script>
  </body>
 </html>

ワーカー自体は次のとおりです:

// settings
 var num_workers = 10;
 var items_per_worker = 1000000;
 
 // start the workers
 var result = 0;
 var pending_workers = num_workers;
 for (var i = 0; i < num_workers; i += 1) {
   var worker = new Worker('core.js');
   worker.postMessage(i * items_per_worker);
   worker.postMessage((i+1) * items_per_worker);
   worker.onmessage = storeResult;
 }
 
 // handle the results
 function storeResult(event) {
   result += 1*event.data;
   pending_workers -= 1;
   if (pending_workers <= 0)
     postMessage(result); // finished!
 }

これはサブワーカーを開始するためのループと、すべてのサブワーカーが応答するのを待つハンドラーで構成されています。

サブワーカーは次のように実装されています:

var start;
 onmessage = getStart;
 function getStart(event) {
   start = 1*event.data;
   onmessage = getEnd;
 }
 
 var end;
 function getEnd(event) {
   end = 1*event.data;
   onmessage = null;
   work();
 }
 
 function work() {
   var result = 0;
   for (var i = start; i < end; i += 1) {
     // perform some complex calculation here
     result += 1;
   }
   postMessage(result);
   close();
 }

彼らは2つのイベントで2つの数字を受け取り、その指定された範囲の数字に対して計算を行い、結果を親に報告します。

この例をオンラインで見る

10.1.2.6 ライブラリの提供

このセクションは規範的ではありません。

暗号ライブラリが提供され、次の3つのタスクを実行できると仮定します:

公開鍵/秘密鍵のペアを生成する
ポートを受け取り、最初に公開鍵、次に秘密鍵を送信する2つのメッセージを送信します。
平文と公開鍵を指定して、それに対応する暗号文を返す
任意の数のメッセージを送信できるポートを受け取り、最初に公開鍵を提供し、その後に平文を送信します。各平文は暗号化され、その同じチャネルで暗号文として送信されます。暗号化が完了したら、ユーザーはポートを閉じることができます。
暗号文と秘密鍵を指定して、それに対応する平文を返す
任意の数のメッセージを送信できるポートを受け取り、最初に秘密鍵を提供し、その後に暗号文を送信します。各暗号文は復号化され、その同じチャネルで平文として送信されます。復号化が完了したら、ユーザーはポートを閉じることができます。

ライブラリ自体は次のとおりです:

function handleMessage(e) {
   if (e.data == "genkeys")
     genkeys(e.ports[0]);
   else if (e.data == "encrypt")
     encrypt(e.ports[0]);
   else if (e.data == "decrypt")
     decrypt(e.ports[0]);
 }
 
 function genkeys(p) {
   var keys = _generateKeyPair();
   p.postMessage(keys[0]);
   p.postMessage(keys[1]);
 }
 
 function encrypt(p) {
   var key, state = 0;
   p.onmessage = function (e) {
     if (state == 0) {
       key = e.data;
       state = 1;
     } else {
       p.postMessage(_encrypt(key, e.data));
     }
   };
 }
 
 function decrypt(p) {
   var key, state = 0;
   p.onmessage = function (e) {
     if (state == 0) {
       key = e.data;
       state = 1;
     } else {
       p.postMessage(_decrypt(key, e.data));
     }
   };
 }
 
 // support being used as a shared worker as well as a dedicated worker
 if ('onmessage' in this) // dedicated worker
   onmessage = handleMessage;
 else // shared worker
   onconnect = function (e) { e.port.onmessage = handleMessage; }
 
 
 // the "crypto" functions:
 
 function _generateKeyPair() {
   return [Math.random(), Math.random()];
 }
 
 function _encrypt(k, s) {
   return 'encrypted-' + k + ' ' + s;
 }
 
 function _decrypt(k, s) {
   return s.substr(s.indexOf(' ')+1);
 }

ここでの暗号関数は単なるスタブであり、実際の暗号化は行いません。

このライブラリは次のように使用できます:

<!DOCTYPE HTML>
 <html lang="en">
  <head>
   <meta charset="utf-8">
   <title>Worker example: Crypto library</title>
   <script>
    const cryptoLib = new Worker('libcrypto-v1.js'); // or could use 'libcrypto-v2.js'
    function startConversation(source, message) {
      const messageChannel = new MessageChannel();
      source.postMessage(message, [messageChannel.port2]);
      return messageChannel.port1;
    }
    function getKeys() {
      let state = 0;
      startConversation(cryptoLib, "genkeys").onmessage = function (e) {
        if (state === 0)
          document.getElementById('public').value = e.data;
        else if (state === 1)
          document.getElementById('private').value = e.data;
        state += 1;
      };
    }
    function enc() {
      const port = startConversation(cryptoLib, "encrypt");
      port.postMessage(document.getElementById('public').value);
      port.postMessage(document.getElementById('input').value);
      port.onmessage = function (e) {
        document.getElementById('input').value = e.data;
        port.close();
      };
    }
    function dec() {
      const port = startConversation(cryptoLib, "decrypt");
      port.postMessage(document.getElementById('private').value);
      port.postMessage(document.getElementById('input').value);
      port.onmessage = function (e) {
        document.getElementById('input').value = e.data;
        port.close();
      };
    }
   </script>
   <style>
    textarea { display: block; }
   </style>
  </head>
  <body onload="getKeys()">
   <fieldset>
    <legend>Keys</legend>
    <p><label>Public Key: <textarea id="public"></textarea></label></p>
    <p><label>Private Key: <textarea id="private"></textarea></label></p>
   </fieldset>
   <p><label>Input: <textarea id="input"></textarea></label></p>
   <p><button onclick="enc()">Encrypt</button> <button onclick="dec()">Decrypt</button></p>
  </body>
 </html>

ただし、後のバージョンのAPIでは、すべての暗号作業をサブワーカーにオフロードすることを検討するかもしれません。次のようにして実現できます:

function handleMessage(e) {
   if (e.data == "genkeys")
     genkeys(e.ports[0]);
   else if (e.data == "encrypt")
     encrypt(e.ports[0]);
   else if (e.data == "decrypt")
     decrypt(e.ports[0]);
 }
 
 function genkeys(p) {
   var generator = new Worker('libcrypto-v2-generator.js');
   generator.postMessage('', [p]);
 }
 
 function encrypt(p) {
   p.onmessage = function (e) {
     var key = e.data;
     var encryptor = new Worker('libcrypto-v2-encryptor.js');
     encryptor.postMessage(key, [p]);
   };
 }
 
 function encrypt(p) {
   p.onmessage = function (e) {
     var key = e.data;
     var decryptor = new Worker('libcrypto-v2-decryptor.js');
     decryptor.postMessage(key, [p]);
   };
 }
 
 // support being used as a shared worker as well as a dedicated worker
 if ('onmessage' in this) // dedicated worker
   onmessage = handleMessage;
 else // shared worker
   onconnect = function (e) { e.ports[0].onmessage = handleMessage };

小さなサブワーカーは次のようになります。

鍵ペアの生成に関しては:

onmessage = function (e) {
   var k = _generateKeyPair();
   e.ports[0].postMessage(k[0]);
   e.ports[0].postMessage(k[1]);
   close();
 }
 
 function _generateKeyPair() {
   return [Math.random(), Math.random()];
 }

暗号化の場合:

onmessage = function (e) {
   var key = e.data;
   e.ports[0].onmessage = function (e) {
     var s = e.data;
     postMessage(_encrypt(key, s));
   }
 }
 
 function _encrypt(k, s) {
   return 'encrypted-' + k + ' ' + s;
 }

復号化の場合:

onmessage = function (e) {
   var key = e.data;
   e.ports[0].onmessage = function (e) {
     var s = e.data;
     postMessage(_decrypt(key, s));
   }
 }
 
 function _decrypt(k, s) {
   return s.substr(s.indexOf(' ')+1);
 }

APIのユーザーが、この処理が行われていることを知る必要がないことに注意してください。APIは変更されていません。ライブラリはサブワーカーに委任することができますが、メッセージチャンネルを使用してデータを受け取っているにもかかわらず、APIを変更することなく動作します。

この例をオンラインで見る

10.1.3 チュートリアル

10.1.3.1 専用ワーカーの作成

このセクションは規範的ではありません。

ワーカーを作成するには、JavaScriptファイルへのURLが必要です。Worker()コンストラクタが そのファイルのURLを唯一の引数として呼び出され、ワーカーが作成されて返されます:

var worker = new Worker('helper.js');

ワーカースクリプトをデフォルトのクラシック スクリプトではなくモジュールスクリプトとして解釈させたい場合は、わずかに異なるシグネチャを使用する必要があります:

var worker = new Worker('helper.mjs', { type: "module" });
10.1.3.2 専用ワーカーとの通信

このセクションは規範的ではありません。

専用ワーカーは背後でMessagePortオブジェクトを使用しており、そのため、構造化データの送信、バイナリデータの転送、他のポートの転送など、すべての同じ機能をサポートします。

専用ワーカーからメッセージを受信するには、onmessage イベントハンドラーIDL属性をWorkerオブジェクトに使用します: 

worker.onmessage = function (event) { ... };

addEventListener()メソッドも使用できます。

専用ワーカーで使用される暗黙のMessagePortは、作成時に暗黙的にポートメッセージキューが有効化されているため、MessagePortインターフェースのstart()メソッドに相当するものは、Workerインターフェースには存在しません。

ワーカーにデータを送信するには、postMessage()メソッドを使用します。この通信チャネルを介して構造化データを送信できます。ArrayBufferオブジェクトを効率的に送信するためには、2番目の引数に配列としてリストします。 

worker.postMessage({
   operation: 'find-edges',
   input: buffer, // an ArrayBuffer object
   threshold: 0.6,
 }, [buffer]);

ワーカー内でメッセージを受信するには、再びonmessage イベントハンドラーIDL属性が使用されます。 

onmessage = function (event) { ... };

再びaddEventListener()メソッドも使用できます。

いずれの場合も、データはイベントオブジェクトのdata属性に提供されます。

メッセージを返信するには、再びpostMessage()を使用します。同様に構造化データをサポートしています。 

postMessage(event.data.input, [event.data.input]); // バッファを転送
10.1.3.3 共有ワーカー

SharedWorker

すべての現在のエンジンでサポートされています。

Firefox29+Safari16+Chrome5+
Opera10.6+Edge79+
Edge (Legacy)?Internet Explorer対応なし
Firefox Android33+Safari iOS16+Chrome Android対応なしWebView Android?Samsung Internet4.0–5.0Opera Android11–14

このセクションは規範的ではありません。

共有ワーカーは、作成に使用されるスクリプトのURL、およびオプションで明示的な名前によって識別されます。この名前を使用すると、特定の共有ワーカーの複数のインスタンスを開始することができます。

共有ワーカーはオリジンによってスコープされます。同じ名前を使用する2つの異なるサイトは衝突しません。ただし、同じサイトの別のページが異なるスクリプトURLで同じ共有ワーカー名を使用しようとすると、失敗します。

共有ワーカーの作成は、SharedWorker()コンストラクタを使用して行われます。このコンストラクタは、最初の引数として使用するスクリプトのURL、および任意でワーカーの名前を引数として受け取ります。 

var worker = new SharedWorker('service.js');

共有ワーカーとの通信は、明示的なMessagePortオブジェクトを使用して行われます。SharedWorker()コンストラクタによって返されるオブジェクトは、そのport属性にポートへの参照を保持しています。 

worker.port.onmessage = function (event) { ... };
 worker.port.postMessage('some message');
 worker.port.postMessage({ foo: 'structured', bar: ['data', 'also', 'possible']});

共有ワーカー内では、新しいクライアントが接続されるとconnectイベントによって通知されます。新しいクライアントのポートは、イベントオブジェクトのsource属性によって提供されます。 

onconnect = function (event) {
   var newPort = event.source;
   // リスナーを設定する
   newPort.onmessage = function (event) { ... };
   // ポートにメッセージを返す
   newPort.postMessage('ready!'); // もちろん構造化データも送信できます
 };

10.2 インフラストラクチャ

この規格は、専用ワーカーと共有ワーカーの2種類のワーカーを定義しています。専用ワーカーは、作成されるとその作成者にリンクされますが、メッセージポートを使用して専用ワーカーから他の複数のブラウジングコンテキストやワーカーと通信することができます。一方、共有ワーカーは名前が付けられ、作成されると同じオリジン内で動作する任意のスクリプトがそのワーカーへの参照を取得し、通信することができます。Service Workersは、第三の種類を定義します。[SW]

10.2.1 グローバルスコープ

グローバルスコープは、ワーカーの「内部」です。

10.2.1.1 WorkerGlobalScope 共通 インターフェース

WorkerGlobalScope

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+ 
[Exposed=Worker]
 interface WorkerGlobalScope : EventTarget {
   readonly attribute WorkerGlobalScope self;
   readonly attribute WorkerLocation location;
   readonly attribute WorkerNavigator navigator;
   undefined importScripts((TrustedScriptURL or USVString)... urls);
 
   attribute OnErrorEventHandler onerror;
   attribute EventHandler onlanguagechange;
   attribute EventHandler onoffline;
   attribute EventHandler ononline;
   attribute EventHandler onrejectionhandled;
   attribute EventHandler onunhandledrejection;
 };

WorkerGlobalScope は、DedicatedWorkerGlobalScope、 SharedWorkerGlobalScope、 およびServiceWorkerGlobalScopeを含む特定のタイプのワーカーグローバルスコープオブジェクトのベースクラスとして機能します。

WorkerGlobalScope オブジェクトには、関連付けられた オーナーセット（Document および WorkerGlobalScope オブジェクトの セット）があります。これは、ワーカーが作成または取得されたときに初期化され、空である状態から開始します。

これは単一のオーナーではなく、SharedWorkerGlobalScope オブジェクトを収容するためのセットです。

WorkerGlobalScope オブジェクトには、関連付けられた タイプ（"classic" または "module"）があります。これは作成時に設定されます。

WorkerGlobalScope オブジェクトには、関連付けられた URL（null または URL）があります。これは最初は null です。

WorkerGlobalScope オブジェクトには、関連付けられた名前（文字列）があります。これは作成時に設定されます。

名前は、WorkerGlobalScope の各サブクラスで異なる意味を持つことがあります。 DedicatedWorkerGlobalScope インスタンスでは、これは主にデバッグの目的で使用される開発者が提供する名前です。SharedWorkerGlobalScope インスタンスでは、SharedWorker() コンストラクタを介して共通の共有ワーカーへの参照を取得することができます。 ServiceWorkerGlobalScope オブジェクトの場合、この概念は意味を持たず（そのため、JavaScript APIではまったく公開されていません）。

WorkerGlobalScope オブジェクトには、関連付けられたポリシーコンテナ（ポリシーコンテナ）があります。これは最初は新しいポリシーコンテナです。

WorkerGlobalScope オブジェクトには、関連付けられた埋め込みポリシー（埋め込みポリシー）があります。

WorkerGlobalScope オブジェクトには、関連付けられたモジュールマップがあります。これはモジュールマップであり、最初は空です。

WorkerGlobalScope オブジェクトには、関連付けられたクロスオリジンアイソレート機能があります。これは最初はfalseです。

workerGlobal.self

WorkerGlobalScope/self

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android34+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android?
workerGlobalを返します。
workerGlobal.location

WorkerGlobalScope/location

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android?
workerGlobalのWorkerLocation オブジェクトを返します。
workerGlobal.navigator

WorkerGlobalScope/navigator

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera11.5+Edge79+
Edge (Legacy)17+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android?
workerGlobalのWorkerNavigator オブジェクトを返します。
workerGlobal.importScripts(...urls)

WorkerGlobalScope/importScripts

すべての現在のエンジンでサポートされています。

Firefox4+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+
各URLを取得し、 渡された順に1つずつ実行し、その後（問題が発生した場合はスロー）返します。

self属性は、WorkerGlobalScope オブジェクト自体を返さなければなりません。

location属性は、関連付けられたWorkerGlobalScope オブジェクトのWorkerLocation オブジェクトを返さなければなりません。

WorkerLocation オブジェクトはWorkerGlobalScope オブジェクトの後に作成されますが、スクリプトからは観察できないため、これは問題ありません。

以下は、WorkerGlobalScope インターフェイスを実装するオブジェクトがイベントハンドラーIDL属性としてサポートしなければならない イベントハンドラー（およびそれに対応する イベントハンドラーイベントタイプ）です。

イベントハンドラー イベントハンドラーイベントタイプ
onerror

WorkerGlobalScope/error_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android?
error
onlanguagechange

WorkerGlobalScope/languagechange_event

すべての現在のエンジンでサポートされています。

Firefox74+Safari4+Chrome4+
Opera11.5+Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
languagechange
onoffline

WorkerGlobalScope/offline_event

Firefox29+Safari8+ChromeNo
Opera?EdgeNo
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
offline
ononline

WorkerGlobalScope/online_event

Firefox29+Safari8+ChromeNo
Opera?EdgeNo
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
online
onrejectionhandled rejectionhandled
onunhandledrejection unhandledrejection
10.2.1.2 専用ワーカーとDedicatedWorkerGlobalScope インターフェイス

DedicatedWorkerGlobalScope

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+ 
[Global=(Worker,DedicatedWorker),Exposed=DedicatedWorker]
interface DedicatedWorkerGlobalScope : WorkerGlobalScope {
  [Replaceable] readonly attribute DOMString name;

  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});

  undefined close();
};

DedicatedWorkerGlobalScope includes MessageEventTarget;

DedicatedWorkerGlobalScope オブジェクトには関連付けられた内部ポート（MessagePort）があります。このポートは、ワーカーが作成されるときに設定されるチャネルの一部ですが、公開されません。このオブジェクトは、DedicatedWorkerGlobalScope オブジェクトの前にガベージコレクションされてはなりません。

dedicatedWorkerGlobal.name

DedicatedWorkerGlobalScope/name

すべての現在のエンジンでサポートされています。

Firefox55+Safari12.1+Chrome70+
Opera?Edge79+
Edge (Legacy)18Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

dedicatedWorkerGlobalのnameを返します。つまり、 Worker コンストラクターに渡された値です。主にデバッグに便利です。

dedicatedWorkerGlobal.postMessage(message [, transfer ])

DedicatedWorkerGlobalScope/postMessage

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?
dedicatedWorkerGlobal.postMessage(message [, { transfer } ])

messageをクローンし、それをdedicatedWorkerGlobalに関連付けられたWorker オブジェクトに送信します。transferは、クローンではなく転送するオブジェクトのリストとして渡すことができます。

dedicatedWorkerGlobal.close()

DedicatedWorkerGlobalScope/close

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?

dedicatedWorkerGlobalを中止します。

nameゲッターステップは、thisのname を返すことです。その値は、主にデバッグ目的で使用される、Workerコンストラクタを使用してワーカーに与えられた名前を表します。

postMessage(message, transfer)およびpostMessage(message, options)メソッドは、DedicatedWorkerGlobalScopeオブジェクトで 実行される場合、それがただちにそれぞれのpostMessage(message, transfer)およびpostMessage(message, options)をポートで同じ引数で呼び出し、同じ戻り値を返すかのように動作します。

ワーカーを閉じるには、workerGlobalが与えられた場合、以下の手順を実行します:

  1. タスクがworkerGlobalの関連エージェントのイベントループのタスクキューに追加された場合、それらを破棄します。

  2. workerGlobalのクローズフラグをtrueに設定します。（これにより、さらにタスクがキューに追加されることを防ぎます。）

close()メソッドのステップは、ワーカーを閉じることです。thisが与えられた場合。

10.2.1.3 共有ワーカーと SharedWorkerGlobalScope インターフェイス

SharedWorkerGlobalScope

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome4+
Opera10.6+Edge79+
Edge (レガシー)?Internet Explorer非対応
Firefox Android?Safari iOS16+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+ 
[Global=(Worker,SharedWorker),Exposed=SharedWorker]
 interface SharedWorkerGlobalScope : WorkerGlobalScope {
   [Replaceable] readonly attribute DOMString name;
 
   undefined close();
 
   attribute EventHandler onconnect;
 };

SharedWorkerGlobalScope オブジェクトには、関連付けられたコンストラクタのオリジン、コンストラクタのURL、 クレデンシャルがあります。これらは、SharedWorkerGlobalScope オブジェクトが作成されるときに、ワーカーを実行する アルゴリズムで初期化されます。

共有ワーカーは、それぞれの接続ごとにconnect イベントを介してSharedWorkerGlobalScope オブジェクトにメッセージポートを受け取ります。

sharedWorkerGlobal.name

SharedWorkerGlobalScope/name

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome4+
Opera10.6+Edge79+
Edge (レガシー)?Internet Explorer非対応
Firefox Android?Safari iOS16+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

sharedWorkerGlobal の name、 つまりSharedWorker コンストラクタに渡された値を返します。同じ名前を再利用することで、複数のSharedWorker オブジェクトが同じ共有ワーカー（およびSharedWorkerGlobalScope）に対応することができます。

sharedWorkerGlobal.close()

SharedWorkerGlobalScope/close

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome4+
Opera10.6+Edge79+
Edge (レガシー)?Internet Explorer非対応
Firefox Android?Safari iOS16+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

sharedWorkerGlobal を中止します。

name の getter のステップは、this の name を返すことです。 その値は、SharedWorker コンストラクタを使用してワーカーの参照を取得するために使用できる名前を表します。

close() メソッドのステップは、ワーカーを閉じる ことです。 this が与えられた場合。

以下は、イベントハンドラ （およびそれに対応するイベントハンドラ イベントタイプ）であり、 イベントハンドラ IDL 属性 として、SharedWorkerGlobalScope インターフェイスを実装するオブジェクトでサポートされなければなりません。

イベントハンドラ イベントハンドラ イベントタイプ
onconnect

SharedWorkerGlobalScope/connect_event

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome4+
Opera10.6+Edge79+
Edge (レガシー)?Internet Explorer非対応
Firefox Android?Safari iOS16+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
connect

10.2.2 イベントループ

ワーカーイベントループの タスクキューには、タスクとしてイベント、コールバック、およびネットワーク活動のみが含まれます。 これらのワーカーイベントループは、 ワーカーを実行するアルゴリズムによって作成されます。

各WorkerGlobalScopeオブジェクト にはclosingフラグがあり、 これは初期状態では必ず false でなければなりませんが、以下の処理モデルセクションのアルゴリズムにより true に設定されることがあります。

一度WorkerGlobalScopeの closingフラグが true に設定されると、イベントループの タスクキューはそれ以降に追加される すべてのタスクを破棄しなければなりません （既にキューにあるタスクは別段の指示がない限り影響を受けません）。実質的には、closingフラグが true になると、タイマーが停止し、すべての保留中のバックグラウンド操作の通知が中断されるなどの影響があります。

10.2.3 ワーカーのライフタイム

ワーカーは、メッセージチャネル およびそれらの MessagePort オブジェクトを介して、他のワーカーやWindowと通信します。

各WorkerGlobalScope オブジェクトworker global scopeには、 ワーカーのポートのリストがあり、これは他のポートと絡み合っており、その中の1つのポートがworker global scopeによって所有されている MessagePort オブジェクトのすべてを含みます。このリストには、 専用ワーカーの場合には暗黙のMessagePortも含まれます。

ワーカーを作成または取得する際にoという 環境設定オブジェクトが与えられた場合、 追加すべき関連オーナーはoによって指定されたグローバルオブジェクトのタイプに依存します。 もしoのグローバルオブジェクトがWorkerGlobalScope オブジェクトである場合（つまり、ネストされた専用ワーカーを作成している場合）、関連オーナーはそのグローバルオブジェクトです。 それ以外の場合、oのグローバルオブジェクトがWindow オブジェクトであるため、 関連オーナーはそのWindowの関連付けられたDocumentです。

ワーカーは、そのWorkerGlobalScopeの オーナーセットが空でない場合、または次の場合に許容されるワーカーとされます：

この定義の第2部は、ページが読み込まれている間、共有ワーカーが短時間生き残ることを可能にします。 これは、そのページが再び共有ワーカーに接続する可能性があるためです。 これにより、ユーザーが同じサイト内のページ間を移動する際に、ユーザーエージェントが共有ワーカーの再起動のコストを回避する方法として使用できます。

ワーカーは、そのオーナーのいずれかが 完全にアクティブである Documentオブジェクトか、 アクティブな必要ワーカー である場合、そのワーカーはアクティブな必要ワーカーとされます。

ワーカーは、そのアクティブな必要ワーカーであり、 それが未解決のタイマー、データベーストランザクション、またはネットワーク接続を持っている場合、またはその ワーカーのポートのリストが空でない場合、 またはそのWorkerGlobalScopeが 実際にSharedWorkerGlobalScopeオブジェクトである場合 （つまり、そのワーカーが共有ワーカーである場合）、保護されたワーカーとされます。

ワーカーは、それがアクティブな必要ワーカーではなく、 しかし許容されるワーカーである場合、一時停止可能なワーカーとされます。

10.2.4 処理モデル

ユーザーエージェントがWorkerまたはSharedWorkerオブジェクトworkerを持つスクリプトのワーカーを実行する場合、URL url、環境設定オブジェクト outside settings、MessagePort outside port、およびWorkerOptionsディクショナリoptionsを実行しなければなりません。

  1. is sharedがtrueである場合はworkerがSharedWorkerオブジェクトであり、そうでない場合はfalseとします。

  2. ownerをoutside settingsに基づいて追加する関連オーナーにします。

  3. unsafeWorkerCreationTimeを安全でない共有現在時刻にします。

  4. agentをoutside settingsおよびis sharedを指定して専用/共有ワーカーエージェントを取得する結果とします。このエージェント内でこれらのステップを実行します。

  5. realm execution contextをagentおよび次のカスタマイズを指定して新しい領域を作成する結果とします：

  6. worker global scopeをrealm execution contextのRealmコンポーネントのグローバルオブジェクトにします。

    これは前のステップで作成されたDedicatedWorkerGlobalScopeまたはSharedWorkerGlobalScopeオブジェクトです。

  7. realm execution context、outside settings、unsafeWorkerCreationTimeを指定してワーカー環境設定オブジェクトを設定するを実行し、その結果をinside settingsとします。

  8. worker global scopeのnameをoptionsのnameメンバーの値に設定します。

  9. 設定して追加 ownerをworker global scopeのオーナーセットに追加します。

  10. is sharedがtrueである場合、次のステップを実行します：

    1. worker global scopeのコンストラクタのオリジンをoutside settingsのオリジンに設定します。

    2. worker global scopeのコンストラクタのURLをurlに設定します。

    3. worker global scopeのタイプをoptionsのtypeメンバーの値に設定します。

    4. worker global scopeのクレデンシャルをoptionsのcredentialsメンバーの値に設定します。

  11. destinationをis sharedがtrueである場合"sharedworker"、そうでない場合"worker"とします。

  12. optionsのtypeメンバーの値に応じてscriptを取得します：

    "classic"
    クラシックワーカースクリプトを取得する url、outside settings、destination、inside settingsを指定し、以下に定義されたonCompleteとperformFetchを使用します。
    "module"
    モジュールワーカースクリプトグラフを取得する url、outside settings、destination、optionsのcredentialsメンバーの値、inside settingsを指定し、以下に定義されたonCompleteとperformFetchを使用します。

    いずれの場合も、フェッチフックを実行するをrequest、isTopLevel、processCustomFetchResponseを指定して実行します：

    1. isTopLevelがfalseである場合、フェッチをrequestで実行し、processResponseConsumeBodyをprocessCustomFetchResponseに設定し、これらのステップを中止します。

    2. requestの予約されたクライアントをinside settingsに設定します。

    3. フェッチをrequestで実行し、processResponseConsumeBodyを次のステップに設定し、response response、null、失敗、またはバイトシーケンス bodyBytesを指定します：

      1. worker global scopeのURLをresponseのURLに設定します。

      2. ワーカーグローバルスコープのポリシーコンテナを初期化するをworker global scope、response、およびinside settingsを指定して実行します。

      3. グローバルオブジェクトに対するCSP初期化を実行するアルゴリズムがworker global scopeに対して"Blocked"を返す場合、responseをネットワークエラーに設定します。[CSP]

      4. worker global scopeの埋め込みポリシーの値がクロスオリジン分離に対応しており、is sharedがtrueである場合、agentのエージェントクラスターのクロスオリジン分離モードを"論理的"または"具体的"に設定します。選択されるものは実装定義です。

        これはエージェントクラスターが作成された時点で設定されるべきであり、このセクションの再設計が必要です。

      5. グローバルオブジェクトの埋め込みポリシーを確認するをworker global scope、outside settings、およびresponseに対して実行した結果がfalseである場合、responseをネットワークエラーに設定します。

      6. worker global scopeのクロスオリジン分離能力をagentのエージェントクラスターのクロスオリジン分離モードが"具体的"である場合はtrueに設定します。

      7. is sharedがfalseであり、ownerのクロスオリジン分離能力がfalseである場合、worker global scopeのクロスオリジン分離能力をfalseに設定します。

      8. is sharedがfalseであり、responseのURLのスキームが"data"である場合、worker global scopeのクロスオリジン分離能力をfalseに設定します。

        これは現時点では保守的なデフォルトであり、ワーカー全般、およびdata: URLワーカーの特定の扱い（所有者からはクロスオリジンである）が、許可ポリシーの文脈でどのように扱われるかを検討している段階です。詳細はw3c/webappsec-permissions-policy issue #207を参照してください。

      9. processCustomFetchResponseをresponseおよびbodyBytesを指定して実行します。

    いずれの場合も、scriptが与えられた場合のonCompleteを次のステップにします：

    1. scriptがnullであるか、scriptの再スローするエラーがnullでない場合：

      1. グローバルタスクをキューに追加するをworkerの関連グローバルオブジェクトを指定してイベントを発生させるために実行し、workerにerrorという名前のイベントを発生させます。

      2. 環境破棄ステップをinside settingsに対して実行します。

      3. これらのステップを中止します。

    2. workerをworker global scopeと関連付けます。

    3. inside portを新しい MessagePortオブジェクトに設定し、inside settingsの領域に設定します。

    4. is shared が false の場合：

      1. inside port の メッセージイベントターゲットを worker global scope に設定します。

      2. worker global scope の 内部ポートを inside port に設定します。

    5. エンタングル outside portとinside portを実行します。

    6. 新しいWorkerLocationオブジェクトを作成し、それをworker global scopeと関連付けます。

    7. 孤立したワーカーの終了: ワーカーを監視し、保護されたワーカーでなくなった時点から遅くとも許容されるワーカーでなくなった時点までに、worker global scopeのclosingフラグがtrueに設定されるようにします。

    8. ワーカーの一時停止: ワーカーを監視し、worker global scopeのclosingフラグがfalseであり、ワーカーが一時停止可能なワーカーである場合、ユーザーエージェントがそのワーカー内でのスクリプトの実行を一時停止し、closingフラグがtrueに切り替わるか、ワーカーが一時停止可能なワーカーでなくなるまで実行を中止します。

    9. inside settingsの実行準備フラグを設定します。

    10. scriptがクラシックスクリプトである場合、クラシックスクリプトを実行する scriptを実行します。そうでない場合、それはモジュールスクリプトであり、モジュールスクリプトを実行する scriptを実行します。

      通常の結果を返すか、例外により失敗する可能性がある他に、これはスクリプトの実行を中止するアルゴリズムによりワーカーを終了することで途中で中断される可能性があります。

    11. outside portのポートメッセージキューを有効にします。

    12. is sharedがfalseである場合、ワーカーの暗黙のポートのポートメッセージキューを有効にします。

    13. is sharedがtrueである場合、グローバルタスクをキューに追加するをworker global scopeを指定してイベントを発生させるために実行し、connectという名前のイベントをworker global scopeに発生させます。これには、MessageEventを使用し、data属性を空の文字列に初期化し、ports属性をinside portを含む新しいフローズンアレイに初期化し、source属性をinside portに初期化します。

    14. クライアントメッセージキューを、関連するサービスワーカークライアントがworker global scopeの関連設定オブジェクトであるServiceWorkerContainerオブジェクトの有効にします。

    15. イベントループ: inside settingsによって指定された責任イベントループを実行し、それが破棄されるまで実行します。

      タスクによって実行されるイベントの処理またはコールバックの実行は、スクリプトの実行を中止するアルゴリズムによりワーカーを終了することで途中で中断される可能性があります。

      ワーカー処理モデルは、イベントループが破棄されるまでこのステップに留まります。これは、イベントループ処理モデルで説明されているように、closingフラグがtrueに設定された後に発生します。

    16. クリアする worker global scopeのアクティブタイマーのマップを設定します。

    17. 空にする worker global scopeのオーナーセットを設定します。

ユーザーエージェントがワーカーを終了するときは、ワーカーのメインループ（上記の「ワーカーを実行する」処理モデル）と並行して、次のステップを実行しなければなりません：

  1. ワーカーのWorkerGlobalScopeオブジェクトのclosingフラグをtrueに設定します。

  2. ワーカーのWorkerGlobalScopeオブジェクトの関連するエージェントのイベントループのタスクキューにキューされているタスクがある場合、それらを処理せずに破棄します。

  3. 現在ワーカー内で実行中のスクリプトを中止します。

  4. ワーカーのWorkerGlobalScopeオブジェクトが実際にDedicatedWorkerGlobalScopeオブジェクトである場合（つまり、そのワーカーが専用ワーカーである場合）、ワーカーの暗黙のポートと絡み合っているポートのポートメッセージキューを空にします。

ユーザーエージェントは、ワーカーがアクティブな必要ワーカーでなくなり、そのclosingフラグがtrueに設定された後もワーカーが実行を続けている場合、ワーカーを終了するアルゴリズムを呼び出すことがあります。

10.2.5 実行時スクリプトエラー

ワーカーのスクリプトの1つで未処理の実行時スクリプトエラーが発生した場合、そのエラーが以前のスクリプトエラーの処理中に発生しなかった場合、ユーザーエージェントはワーカーのWorkerGlobalScopeオブジェクトに対して報告します。

10.2.6 ワーカーの作成

10.2.6.1 AbstractWorkerミックスイン
interface mixin AbstractWorker {
   attribute EventHandler onerror;
 };

次のものは、AbstractWorkerインターフェイスを実装するオブジェクトによってサポートされなければならないイベントハンドラ（およびそれに対応するイベントハンドライベントタイプ）です。これらはイベントハンドラIDL属性としてサポートされなければなりません。

イベントハンドラ イベントハンドライベントタイプ
onerror

ServiceWorker/error_event

現在のすべてのエンジンでサポートされています。

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (レガシー)17+Internet Explorer非対応
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

SharedWorker/error_event

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome5+
Opera10.6+Edge79+
Edge (レガシー)?Internet Explorer非対応
Firefox Android33+Safari iOS16+Chrome Android非対応WebView Android?Samsung Internet4.0–5.0Opera Android11–14

Worker/error_event

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+
error
10.2.6.2 ワーカーのスクリプト設定

ワーカー環境設定オブジェクトを設定するには、JavaScript 実行コンテキスト execution context、環境設定オブジェクト outside settings、および数値unsafeWorkerCreationTimeが与えられます：

  1. inherited originをoutside settingsのオリジンに設定します。

  2. realmをexecution contextのRealmコンポーネントの値に設定します。

  3. worker global scopeをrealmのグローバルオブジェクトに設定します。

  4. settings objectを新しい環境設定オブジェクトに設定し、そのアルゴリズムを以下のように定義します：

    Realm 実行コンテキスト

    execution contextを返します。

    モジュールマップ

    worker global scopeのモジュールマップを返します。

    API ベースURL

    worker global scopeのURLを返します。

    オリジン

    worker global scopeのURLのスキームが"data"である場合、不透明なオリジンを返し、それ以外の場合はinherited originを返します。

    ポリシーコンテナ

    worker global scopeのポリシーコンテナを返します。

    クロスオリジン分離能力

    worker global scopeのクロスオリジン分離能力を返します。

    時間オリジン

    unsafeWorkerCreationTimeをworker global scopeのクロスオリジン分離能力と共に粗くする結果を返します。

  5. settings objectのIDを新しい不透明な文字列に設定し、作成URLをworker global scopeのURLに、トップレベル作成URLをnullに、ターゲットブラウジングコンテキストをnullに、アクティブサービスワーカーをnullに設定します。

  6. worker global scopeがDedicatedWorkerGlobalScopeオブジェクトである場合、settings objectのトップレベルオリジンをoutside settingsのトップレベルオリジンに設定します。

  7. それ以外の場合は、settings objectのトップレベルオリジンを実装定義の値に設定します。

    クライアントサイドストレージのパーティショニングで最新の適切な定義を参照してください。

  8. realmの[[HostDefined]]フィールドをsettings objectに設定します。

  9. settings objectを返します。

10.2.6.3 専用ワーカーとWorkerインターフェイス

Worker

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera10.6+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+ 
[Exposed=(Window,DedicatedWorker,SharedWorker)]
interface Worker : EventTarget {
  constructor((TrustedScriptURL or USVString) scriptURL, optional WorkerOptions options = {});

  undefined terminate();

  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});
};

dictionary WorkerOptions {
  WorkerType type = "classic";
  RequestCredentials credentials = "same-origin"; // credentials is only used if type is "module"
  DOMString name = "";
};

enum WorkerType { "classic", "module" };

Worker includes AbstractWorker;
Worker includes MessageEventTarget;
worker = new Worker(scriptURL [, options ])

Worker/Worker

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+

新しいWorkerオブジェクトを返します。scriptURLはバックグラウンドでフェッチされ実行され、新しいグローバル環境が作成され、workerがそのコミュニケーションチャネルを表します。optionsを使用して、主にデバッグ目的でそのグローバル環境の名前をnameオプションで定義することができます。また、この新しいグローバル環境が JavaScript モジュールをサポートするようにする（type: "module"を指定）こともでき、それが指定されている場合、scriptURLがcredentialsオプションを通じてどのようにフェッチされるかを指定することもできます。

worker.terminate()

Worker/terminate

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera10.6+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+
workerの関連するグローバル環境を中止します。
worker.postMessage(message [, transfer ])

Worker/postMessage

現在のすべてのエンジンでサポートされています。

Firefox3.5+Safari4+Chrome2+
Opera10.6+Edge79+
Edge (レガシー)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11+
workerのグローバル環境にmessageを複製して送信します。transferは、複製ではなく転送されるオブジェクトのリストとして渡すことができます。

各 Worker オブジェクトには、関連付けられた外部ポート（MessagePort）があります。このポートは、ワーカーが作成されるときに設定されるチャネルの一部ですが、公開されません。このオブジェクトは、Worker オブジェクトの前にガベージコレクションされてはなりません。

terminate() メソッドは、呼び出されると、オブジェクトが関連付けられているワーカーでワーカーを終了するアルゴリズムを実行させる必要があります。

Worker オブジェクトの postMessage(message, transfer) および postMessage(message, options) メソッドは、呼び出されると、this の 外部ポートで、同じ引数でそれぞれの postMessage(message, transfer) および postMessage(message, options) を直ちに呼び出し、同じ戻り値を返したかのように動作します。

postMessage()メソッドの最初の引数は構造化データを持つことができます： 

worker.postMessage({opcode: 'activate', device: 1938, parameters: [23, 102]});

Worker(scriptURL, options)コンストラクターが呼び出されると、ユーザーエージェントは次の手順を実行しなければなりません：

  1. compliantScriptURLを信頼された型に準拠する文字列を取得するアルゴリズムをTrustedScriptURL、thisの関連するグローバルオブジェクト、scriptURL、"Worker constructor"、および"script"と共に実行した結果に設定します。

  2. outside settingsを現在の設定オブジェクトに設定します。

  3. worker URLをcompliantScriptURLを与えたURLのエンコーディングと解析の結果に設定します。

    同一オリジンのURL（blob:URLを含む）は使用できます。data: URL も使用できますが、不透明なオリジンを持つワーカーが作成されます。

  4. worker URLが失敗した場合は、"SyntaxError" DOMExceptionをスローします。

  5. workerを新しいWorkerオブジェクトに設定します。

  6. outside portをnew MessagePortにoutside settingsのrealmに設定します。

  7. outside port の メッセージイベントターゲットを worker に設定します。

  8. worker の 外部ポートを outside port に設定します。

  9. このステップを並行して実行します：

    1. ワーカーを実行するをworker、worker URL、outside settings、outside port、およびoptionsに与えて実行します。

  10. workerを返します。

10.2.6.4 共有ワーカーと SharedWorkerインターフェイス

SharedWorker

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome5+
Opera10.6+Edge79+
Edge (レガシー)?Internet ExplorerNo
Firefox Android33+Safari iOS16+Chrome AndroidNoWebView Android?Samsung Internet4.0–5.0Opera Android11–14 
[Exposed=Window]
 interface SharedWorker : EventTarget {
   constructor((TrustedScriptURL or USVString) scriptURL, optional (DOMString or WorkerOptions) options = {});
 
   readonly attribute MessagePort port;
 };
 SharedWorker includes AbstractWorker;
sharedWorker = new SharedWorker(scriptURL [, name ])

SharedWorker/SharedWorker

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome5+
Opera10.6+Edge79+
Edge (レガシー)?Internet ExplorerNo
Firefox Android33+Safari iOS16+Chrome AndroidNoWebView Android?Samsung Internet4.0–5.0Opera Android11–14

新しいSharedWorkerオブジェクトを返します。scriptURLはバックグラウンドでフェッチおよび実行され、sharedWorkerが通信チャネルを表す新しいグローバル環境が作成されます。nameは、そのグローバル環境のnameを定義するために使用できます。

sharedWorker = new SharedWorker(scriptURL [, options ])

新しいSharedWorkerオブジェクトを返します。scriptURLはバックグラウンドでフェッチおよび実行され、sharedWorkerが通信チャネルを表す新しいグローバル環境が作成されます。optionsは、そのグローバル環境のnameをnameオプションを介して定義するために使用できます。また、この新しいグローバル環境がJavaScriptモジュールをサポートすることを確実にし（type: "module"を指定）、指定された場合、scriptURLがcredentialsオプションを通じてどのようにフェッチされるかを指定するために使用できます。なお、optionsのtypeまたはcredentialsの値が既存の共有ワーカーと一致しない場合、返されたsharedWorkerはエラーイベントを発生させ、既存の共有ワーカーに接続しません。

sharedWorker.port

SharedWorker/port

現在のすべてのエンジンでサポートされています。

Firefox29+Safari16+Chrome5+
Opera10.6+Edge79+
Edge (レガシー)?Internet ExplorerNo
Firefox Android33+Safari iOS16+Chrome AndroidNoWebView Android?Samsung Internet4.0–5.0Opera Android11–14

sharedWorkerのMessagePortオブジェクトを返します。これを使用して、グローバル環境と通信できます。

port 属性は、オブジェクトのコンストラクタによって割り当てられた値を返さなければなりません。これは、共有ワーカーとの通信に使用される MessagePort を表します。

ユーザーエージェントには、 共有ワーカーマネージャー という関連する要素があり、これは 新しい並列キューの開始 の結果です。

各ユーザーエージェントには、シンプルさを保つために1つの 共有ワーカーマネージャー があります。実装は、 オリジン ごとに1つ使用することができ、その場合でも観察可能な違いはなく、より多くの並列性が可能になります。

SharedWorker(scriptURL, options) コンストラクタが呼び出されたとき：

  1. compliantScriptURL を 信頼された型に準拠した文字列を取得する アルゴリズムを TrustedScriptURL、this の 関連するグローバルオブジェクト、 scriptURL、「SharedWorkerコンストラクタ」および「script」を使用して実行した結果とします。

  2. options が DOMString の場合、options を新しい WorkerOptions 辞書に設定し、その name メンバーを options の値に設定し、他のメンバーはデフォルト値に設定します。

  3. outside settings を 現在の設定オブジェクト にします。

  4. urlRecord を compliantScriptURL を基に outside settings に対して URLのエンコードと解析 の結果とします。

    任意の 同一オリジン のURL ( blob: URLを含む) を使用することができます。 data: URL も使用できますが、それらは不透明なオリジンを持つワーカーを作成します。

  5. urlRecord が失敗した場合、"SyntaxError" DOMException をスローします。

  6. worker を新しい SharedWorker オブジェクトとして作成します。

  7. outside port を outside settings の realm で新しい 新しい MessagePort として作成します。

  8. worker の port 属性に outside port を割り当てます。

  9. callerIsSecureContext を outside settings が セキュアコンテキスト の場合にtrue、それ以外の場合にfalseとします。

  10. outside storage key を ストレージ以外の目的のためのストレージキーを取得 の結果とし、outside settings を指定して実行します。

  11. 次の手順をキューに追加 し、 共有ワーカーマネージャー に追加します。

    1. worker global scope をnullに設定します。

    2. すべての SharedWorkerGlobalScope オブジェクトのリストを反復します。

      1. worker storage key を scope の 関連する設定オブジェクト に基づいて ストレージ以外の目的のためのストレージキーを取得 する結果とします。

      2. 次のすべてがtrueの場合：

        次に：

        1. worker global scope を scope に設定します。

        2. 中断します。

      data: URL は不透明なオリジンを持つワーカーを作成します。 コンストラクタオリジン と コンストラクタURL が比較されるため、同じ data: URL を使用して、オリジン内で同じ SharedWorkerGlobalScope オブジェクトにアクセスすることはできますが、同一オリジン制約を回避することはできません。

    3. worker global scope がnullでないが、ユーザーエージェントが worker global scope によって表されるワーカーと outside settings の スクリプト 間の通信を許可しないように構成されている場合、 worker global scope をnullに設定します。

      たとえば、ユーザーエージェントは特定の トップレベルトラバーサブル を他のすべてのページから分離する開発モードを持ち、その開発モード内のスクリプトが通常のブラウザーモードで実行されている共有ワーカーに接続することをブロックできる場合があります。

    4. worker global scope がnullでない場合、その worker global scope の タイプ と クレデンシャル が options の値と一致するかどうかを確認します。一致しない場合、 タスクをキューに追加 し、 イベントを発火 させ、これらの手順を中止します。

    5. worker global scope がnullでない場合、次のサブステップを実行します：

      1. settings object を worker global scope に関連する設定オブジェクトに設定します。

      2. workerIsSecureContext を settings object が セキュアコンテキスト の場合にtrue、それ以外の場合にfalseとします。

      3. workerIsSecureContext が callerIsSecureContext と一致しない場合、 タスクをキューに追加 し、 イベントを発火 させ、worker にエラーを発生させ、これらの手順を中止します。 [SECURE-CONTEXTS]

      4. worker と worker global scope を関連付けます。

      5. inside port を settings object の realm で新しい 新しい MessagePort として作成します。

      6. outside port と inside port を 絡ませます。

      7. タスクをキューに追加 し、 DOM操作タスクソース を使用して イベントを発火 させ、 worker global scope に connect という名前のイベントを発生させ、 MessageEvent を使用して、 data 属性を空の文字列に初期化し、ports 属性を inside port のみを含む新しい フローズン配列 に初期化し、source 属性を inside port に初期化します。

      8. 関連所有者を追加し、outside settings を指定して worker global scope の 所有者セット に追加します。

    6. それ以外の場合、 並列で 、 ワーカーを実行 し、worker、 urlRecord、 outside settings、 outside port、および options を指定します。

  12. worker を返します。

interface mixin NavigatorConcurrentHardware {
   readonly attribute unsigned long long hardwareConcurrency;
 };
self.navigator.hardwareConcurrency

Navigator/hardwareConcurrency

Firefox48+Safari10.1–11Chrome37+
Opera?Edge79+
Edge (Legacy)15+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Navigator/hardwareConcurrency

Firefox48+Safari10.1–11Chrome37+
Opera?Edge79+
Edge (Legacy)15+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

ユーザーエージェントが使用できる可能性のある論理プロセッサの数を返します。

(これは追跡ベクトルです。) navigator.hardwareConcurrency 属性のゲッターは、ユーザーエージェントが使用できる可能性のある論理プロセッサの数と1の間の値を返さなければなりません。これが判定できない場合、ゲッターは1を返さなければなりません。

ユーザーエージェントは、論理プロセッサの数を公開する方向に誤るべきであり、ワーカー の作成に制限がある場合や、フィンガープリントの可能性を制限したい場合など、ユーザーエージェント固有の制限がある場合にのみ、より低い値を使用する必要があります。

10.3 ワーカーで使用可能なAPI

10.3.1 スクリプトとライブラリのインポート

importScripts(...urls) メソッドの手順は次の通りです：

  1. urlStrings を « » に設定します。

  2. 次の項目を繰り返します： urls の url ごとに。

    1. TrustedScriptURL、this の 関連するグローバルオブジェクト、url、「WorkerGlobalScope importScripts」、および「script」を指定して信頼できる型準拠文字列を取得するアルゴリズムを呼び出した結果を urlStrings に追加します。

  3. スクリプトをワーカーのグローバルスコープにインポート します。このとき、this と urlStrings を指定します。

スクリプトをワーカーのグローバルスコープにインポート するためには、 WorkerGlobalScope オブジェクト worker global scope、リスト として スカラー値文字列 の urls、およびオプションの フェッチフックを実行 します。

  1. worker global scope の タイプ が "module" の場合、TypeError 例外をスローします。

  2. settings object を 現在の設定オブジェクト に設定します。

  3. urls が空の場合、何も返しません。

  4. urlRecords を « » に設定します。

  5. urls の url ごとに：

    1. urlRecord を URLのエンコードと解析 の結果に設定します。このとき url を指定し、settings object に相対して実行します。

    2. urlRecord が失敗した場合、"SyntaxError" DOMException をスローします。

    3. 次の項目を urlRecords に追加します： urlRecord。

  6. urlRecords の urlRecord ごとに：

    1. クラシックなワーカーインポートスクリプトをフェッチ します。このとき urlRecord と settings object を指定し、提供されている場合は performFetch を渡します。これが成功した場合、script を結果として設定します。それ以外の場合、例外を再スローします。

    2. script のクラシックスクリプトを実行します、rethrow errors を true に設定して。

      script は、返されるか、解析に失敗するか、例外をキャッチし損なうか、上記で定義されている ワーカーの終了 アルゴリズムによって 早期に中断 されるまで実行されます。

      例外がスローされた場合、またはスクリプトが 早期に中断 された場合、これらの手順をすべて中断し、例外や中断が呼び出し元の スクリプト によって引き続き処理されるようにします。

Service Workers は、このアルゴリズムを独自の フェッチフックを実行 して実行する仕様の例です。[SW]

10.3.2 WorkerNavigator インターフェース

WorkerNavigator

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

navigator 属性は、WorkerGlobalScope インターフェースの一部であり、ユーザーエージェント (クライアント) のアイデンティティと状態を表す WorkerNavigator インターフェースのインスタンスを返さなければなりません。

[Exposed=Worker]
 interface WorkerNavigator {};
 WorkerNavigator includes NavigatorID;
 WorkerNavigator includes NavigatorLanguage;
 WorkerNavigator includes NavigatorOnLine;
 WorkerNavigator includes NavigatorConcurrentHardware;

10.3.3 WorkerLocation インターフェース

WorkerLocation

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

WorkerLocation/toString

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera15+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android14+ 
[Exposed=Worker]
 interface WorkerLocation {
   stringifier readonly attribute USVString href;
   readonly attribute USVString origin;
   readonly attribute USVString protocol;
   readonly attribute USVString host;
   readonly attribute USVString hostname;
   readonly attribute USVString port;
   readonly attribute USVString pathname;
   readonly attribute USVString search;
   readonly attribute USVString hash;
 };

WorkerLocation オブジェクトには、関連する WorkerGlobalScope オブジェクト（WorkerGlobalScope オブジェクト）が存在します。

WorkerLocation/href

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

href のゲッター手順は、this の WorkerGlobalScope オブジェクト の URL を シリアル化 して返すことです。

WorkerLocation/origin

すべての現在のエンジンでサポートされています。

Firefox29+Safari10+Chrome38+
Opera?Edge79+
Edge (Legacy)14+Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

origin のゲッター手順は、オリジンのシリアル化 を this の WorkerGlobalScope オブジェクト の URL の オリジン から返すことです。

WorkerLocation/protocol

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

protocol のゲッター手順は、this の WorkerGlobalScope オブジェクト の URL の スキーム の後に ":" を付けて返すことです。

WorkerLocation/host

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

host のゲッター手順は次の通りです：

  1. url を this の WorkerGlobalScope オブジェクト の URL に設定します。

  2. url の ホスト が null である場合、空の文字列を返します。

  3. url の ポート が null である場合、url の ホスト を シリアル化 して返します。

  4. url の ホスト を シリアル化 し、続いて ":" と url の ポート を シリアル化 して返します。

WorkerLocation/hostname

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

hostname のゲッター手順は次の通りです：

  1. host を this の WorkerGlobalScope オブジェクト の URL の ホスト に設定します。

  2. host が null である場合、空の文字列を返します。

  3. host を シリアル化 して返します。

WorkerLocation/port

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

port のゲッター手順は次の通りです：

  1. port を this の WorkerGlobalScope オブジェクト の URL の ポート に設定します。

  2. port が null である場合、空の文字列を返します。

  3. port を シリアル化 して返します。

WorkerLocation/pathname

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

pathname のゲッター手順は、URL パスのシリアル化 の結果を、this の WorkerGlobalScope オブジェクト の URL から返すことです。

WorkerLocation/search

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

search のゲッター手順は次の通りです：

  1. query を this の WorkerGlobalScope オブジェクト の URL の クエリ に設定します。

  2. query が null または空の文字列である場合、空の文字列を返します。

  3. query の前に "?" を付けて返します。

WorkerLocation/hash

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

hash のゲッター手順は次の通りです：

  1. fragment を this の WorkerGlobalScope オブジェクト の URL の フラグメント に設定します。

  2. fragment が null または空の文字列である場合、空の文字列を返します。

  3. fragment の前に "#" を付けて返します。

11 ワークレット

11.1 導入

このセクションは規範的ではありません。

ワークレットは、メインのJavaScript実行環境とは独立してスクリプトを実行するための仕様インフラストラクチャであり、特定の実装モデルを必要としません。

ここで指定されているワークレットインフラストラクチャは、ウェブ開発者が直接使用することはできません。その代わり、他の仕様がそれを基にして、ブラウザの実装パイプラインの特定の部分で実行するために特化した、直接使用可能なワークレットタイプを作成します。

11.1.1 動機

このセクションは規範的ではありません。

レンダリングや、オーディオ出力のような実装パイプラインの他の重要な部分に拡張ポイントを設けることは難しいです。もし、拡張ポイントが Window で利用可能なAPIへの完全なアクセスを許可するものであった場合、エンジンは、これらのフェーズの途中で何が起こるかについての従来の前提を放棄する必要があります。たとえば、レイアウトフェーズ中に、レンダリングエンジンはDOMが変更されないことを前提としています。

さらに、Window 環境で拡張ポイントを定義すると、ユーザーエージェントは Window オブジェクトと同じスレッドで作業を行うことに制限されます。（実装がスレッドセーフなAPIを可能にするための複雑で高コストなインフラストラクチャを追加し、スレッドジョイン保証を提供しない限り）

ワークレットは、ユーザーエージェントが現在依存している保証を維持しながら、拡張ポイントを許可するために設計されています。これは、WorkletGlobalScope のサブクラスに基づいた新しいグローバル環境を通じて行われます。

ワークレットは、ウェブワーカーに似ています。ただし、以下の点が異なります:

ワークレットは比較的高いオーバーヘッドがあるため、慎重に使用することが推奨されます。このため、特定の WorkletGlobalScope は、複数の別々のスクリプト間で共有されることが期待されます。（これは、1つの Window が複数の別々のスクリプト間で共有されるのと似ています。）

ワークレットは、異なるユースケースに対応する汎用技術です。たとえば、CSS Painting API で定義されたワークレットは、ステートレスで冪等性を持ち、短時間で完了する計算のための拡張ポイントを提供しますが、これには特別な考慮事項があります。Web Audio API で定義されたワークレットは、ステートフルで長時間動作する操作のために使用されます。[CSSPAINT] [WEBAUDIO]

11.1.2 コードの冪等性

ワークレットを使用するいくつかの仕様は、ユーザーエージェントが複数のスレッドにわたって作業を並列化したり、必要に応じてスレッド間で作業を移動したりすることを可能にすることを目的としています。これらの仕様では、ユーザーエージェントがWeb開発者が提供するクラスのメソッドを実装依存の順序で呼び出す場合があります。

この結果、相互運用性の問題を防ぐために、そのようなWorkletGlobalScopeにクラスを登録する著者は、コードを冪等にする必要があります。つまり、クラスのメソッドまたはメソッド群は、特定の入力が与えられた場合に同じ出力を生成する必要があります。

この仕様は、著者が冪等な方法でコードを書くことを奨励するために、以下の技術を使用しています:

これらの制限により、2つの異なるスクリプトがグローバルオブジェクトのプロパティを使用して状態を共有することを防ぐのに役立ちます。

さらに、ワークレットを使用し、実装依存の動作を許可することを意図している仕様は、次のことを守る必要があります:

11.1.3 推測的評価

ワークレットを使用するいくつかの仕様は、ユーザーエージェントの状態に基づいて、Web開発者が提供するクラスのメソッドを呼び出すことができます。スレッド間の並行性を高めるために、ユーザーエージェントは将来の状態に基づいてメソッドを推測的に呼び出すことがあります。

これらの仕様では、ユーザーエージェントが任意のタイミングで、任意の引数を使用して（現在のユーザーエージェントの状態に対応するものだけではなく）これらのメソッドを呼び出すことができます。そのような推測的評価の結果は、すぐには表示されませんが、ユーザーエージェントの状態が推測された状態と一致した場合に使用するためにキャッシュされることがあります。これにより、ユーザーエージェントとワークレットスレッド間の並行性が向上します。

この結果、ユーザーエージェント間の相互運用性リスクを防ぐために、そのようなWorkletGlobalScopeにクラスを登録する著者は、コードをステートレスにする必要があります。つまり、メソッドの呼び出しの唯一の効果はその結果であり、可変状態の更新などの副作用ではないべきです。

コードの冪等性を奨励するのと同じ技術が、著者がステートレスなコードを書くことを奨励します。

11.2 例

このセクションは規範的ではありません。

これらの例では、フェイクワークレットを使用します。Windowオブジェクトは、独自のFakeWorkletGlobalScopeコレクション内でコードを実行する、2つのWorkletインスタンスを提供します:

partial interface Window {
   [SameObject, SecureContext] readonly attribute Worklet fakeWorklet1;
   [SameObject, SecureContext] readonly attribute Worklet fakeWorklet2;
 };

各Windowには、2つのWorkletインスタンス、フェイクワークレット1とフェイクワークレット2があります。これらの両方には、ワークレットグローバルスコープタイプがFakeWorkletGlobalScopeに設定され、ワークレット送信先タイプが「fakeworklet」に設定されています。ユーザーエージェントは、ワークレットごとに少なくとも2つのFakeWorkletGlobalScopeインスタンスを作成する必要があります。

「fakeworklet」は、FetchのFetchにおける有効な[送信先]ではありません。しかし、これにより、実際のワークレットが通常、独自のワークレットタイプ固有の送信先を持つことを説明しています。[FETCH]

fakeWorklet1ゲッターステップは、thisのフェイクワークレット1を返すことです。

fakeWorklet2ゲッターステップは、thisのフェイクワークレット2を返すことです。

[Global=(Worklet,FakeWorklet),
  Exposed=FakeWorklet,
  SecureContext]
 interface FakeWorkletGlobalScope : WorkletGlobalScope {
   undefined registerFake(DOMString type, Function classConstructor);
 };

各FakeWorkletGlobalScopeには登録されたクラスコンストラクターマップがあり、これは順序付きマップで、初期状態では空です。

registerFake(type, classConstructor)メソッドステップは、thisの登録されたクラスコンストラクターマップ[type]をclassConstructorに設定することです。

11.2.1 スクリプトの読み込み

このセクションは規範的ではありません。

フェイクワークレット1にスクリプトを読み込むには、Web開発者は次のように記述します:

window.fakeWorklet1.addModule('script1.mjs');
 window.fakeWorklet1.addModule('script2.mjs');

どのスクリプトが先にフェッチされ、実行されるかはネットワークのタイミングに依存します。これはscript1.mjsかscript2.mjsのどちらかになります。一般的に、ワークレットで読み込まれるように設計された、適切に記述されたスクリプトであれば、推測的評価に関する提案に従う限り、問題にはなりません。

Web開発者がスクリプトが正常に実行されていくつかのワークレットに読み込まれた後にのみタスクを実行したい場合、次のように記述できます:

Promise.all([
     window.fakeWorklet1.addModule('script1.mjs'),
     window.fakeWorklet2.addModule('script2.mjs')
 ]).then(() => {
     // これらのスクリプトが読み込まれていることに依存する処理を行います。
 });

スクリプトの読み込みに関するもう一つの重要なポイントは、読み込まれたスクリプトが、WorkletGlobalScopeごとに複数のWorklet内で実行できることです。これはコードの冪等性に関するセクションで説明されています。特に、上記の仕様ではフェイクワークレット1とフェイクワークレット2でこれを必要としています。したがって、次のようなシナリオを考えてみましょう:

// script.mjs
 console.log("FakeWorkletGlobalScopeからこんにちは！");
// app.mjs
 window.fakeWorklet1.addModule("script.mjs");

これは、ユーザーエージェントのコンソールに次のような出力を生成する可能性があります:

[fakeWorklet1#1] FakeWorkletGlobalScopeからこんにちは！
 [fakeWorklet1#4] FakeWorkletGlobalScopeからこんにちは！
 [fakeWorklet1#2] FakeWorkletGlobalScopeからこんにちは！
 [fakeWorklet1#3] FakeWorkletGlobalScopeからこんにちは！

ユーザーエージェントが何らかの時点でFakeWorkletGlobalScopeの3番目のインスタンスを終了して再起動することを決定した場合、この際に再び[fakeWorklet1#3] FakeWorkletGlobalScopeからこんにちは！がコンソールに表示されます。

11.2.2 クラスの登録とメソッドの呼び出し

このセクションは規範的ではありません。

仮に、Web開発者がフェイクワークレットを使用する目的の一つが、ブール値の否定という高度に複雑なプロセスをカスタマイズすることであるとしましょう。彼らは次のようにカスタマイズを登録するかもしれません:

// script.mjs
 registerFake('negation-processor', class {
   process(arg) {
     return !arg;
   }
 });
// app.mjs
 window.fakeWorklet1.addModule("script.mjs");

そのように登録されたクラスを利用するために、フェイクワークレットの仕様は、Workletworkletを与えて、真の反対を見つけるアルゴリズムを定義することができます:

  1. 任意で、ワークレットグローバルスコープを作成します。

  2. workletGlobalScopeを、workletのグローバルスコープの1つとして、実装依存の方法で選択します。

  3. classConstructorを、workletGlobalScopeの登録されたクラスコンストラクターマップ["negation-processor"]に設定します。

  4. classInstanceを、コールバック関数を構築する結果として、引数なしで生成します。

  5. functionをclassInstanceのGet(classInstance, "process")として取得します。例外があれば再スローします。

  6. callbackを、関数をWeb IDL Functionインスタンスに変換した結果として設定します。

  7. コールバック関数を呼び出す結果を返します。引数は「true」で、「rethrow」とし、コールバック this 値をclassInstanceに設定します。

別の、より良いかもしれない仕様アーキテクチャは、登録時に「process」プロパティを抽出し、registerFake()メソッドステップの一部としてFunctionに変換することです。

11.3 基盤

11.3.1 グローバルスコープ

WorkletGlobalScopeのサブクラスは、特定のWorkletにロードされたコードが実行されるグローバルオブジェクトを作成するために使用されます。

[Exposed=Worklet, SecureContext]
 interface WorkletGlobalScope {};

他の仕様は、WorkletGlobalScopeをサブクラス化し、クラスを登録するためのAPIや、ワークレットタイプに特有の他のAPIを追加することを意図しています。

各WorkletGlobalScopeには、関連するモジュールマップがあります。これはモジュールマップで、最初は空です。

11.3.1.1 エージェントとイベントループ

このセクションは規範ではありません。

各WorkletGlobalScopeは、それぞれ独自のワークレットエージェント内に含まれており、対応するイベントループがあります。しかし、実際には、これらのエージェントとイベントループの実装は他の多くとは異なると予想されます。

各WorkletGlobalScopeに対応するワークレットエージェントが存在します。これは理論上、各WorkletGlobalScopeインスタンスごとに別々のスレッドを使用する実装が可能であり、このレベルの並列性を許可するためにはエージェントを使用するのが最適だからです。しかし、これらの[[CanBlock]]値がfalseであるため、エージェントとスレッドが一対一である必要はありません。これにより、ワークレットにロードされたスクリプトを他の[[CanBlock]]がfalseのエージェント（例えば同一オリジンのウィンドウエージェント、「メインスレッド」）のコードを実行するスレッドで実行することも可能になります。これに対して、[[CanBlock]]がtrueであるために専用のオペレーティングシステムスレッドを必要とする専用ワーカーエージェントとは対照的です。

ワークレットのイベントループもまた特別です。これらは、addModule()に関連するタスク、ユーザーエージェントが作成者定義のメソッドを呼び出すタスク、そしてマイクロタスクのためにのみ使用されます。そのため、イベントループ処理モデルはすべてのイベントループが継続的に実行されることを規定していますが、実装はよりシンプルな戦略を使用して観察可能な同等の結果を達成することができ、これは単に作成者提供のメソッドを呼び出し、そのプロセスがマイクロタスクのチェックポイントを実行することに依存する形になります。

11.3.1.2 作成と終了

あるWorklet workletのために worklet グローバルスコープを作成するには、次の手順に従います。

  1. outsideSettingsをworkletの関連設定オブジェクトに設定します。

  2. agentを、outsideSettingsを指定してworklet エージェントを取得する結果として設定し、そのエージェント内で残りの手順を実行します。

  3. realmExecutionContextを、agentと次のカスタマイズを指定して新しいレルムを作成する結果として設定します：

  4. workletGlobalScopeを、realmExecutionContextのレルムコンポーネントのグローバルオブジェクトとして設定します。

  5. insideSettingsを、realmExecutionContextとoutsideSettingsを指定してworklet 環境設定オブジェクトを設定する結果として設定します。

  6. pendingAddedModulesを、workletの追加モジュールリストのクローンとして設定します。

  7. runNextAddedModuleを次の手順として設定します：

    1. pendingAddedModulesが空でない場合、次の手順を実行します：

      1. moduleURLをpendingAddedModulesからデキューした結果として設定します。

      2. scriptを指定して、moduleURL、insideSettings、workletのworklet 宛先タイプ、どの認証モード?、insideSettings、workletのモジュール応答マップを指定してworklet スクリプトグラフをフェッチするを実行します。

        これは実際にはネットワークリクエストを行わず、単にworkletのモジュール応答マップから応答を再利用します。この手順の主な目的は、応答からworkletGlobalScope固有のモジュールスクリプトを作成することです。

        1. 確認：scriptが null でないことを確認します。フェッチが成功し、workletのモジュール応答マップがmoduleURLで最初に入力されたときにソーステキストが正常に解析されたためです。

        2. scriptを指定してモジュールスクリプトを実行するを実行します。

        3. runNextAddedModuleを実行します。

      3. これらの手順を中止します。

    2. 追加 workletGlobalScopeをoutsideSettingsのグローバルオブジェクトの関連Documentに追加します。

    3. 追加 workletGlobalScopeをworkletのグローバルスコープに追加します。

    4. insideSettingsで指定された責任イベントループを実行します。

  8. runNextAddedModuleを実行します。

あるWorkletGlobalScope workletGlobalScopeに対して worklet グローバルスコープを終了するには、次の手順に従います：

  1. eventLoopをworkletGlobalScopeの関連エージェントのイベントループとして設定します。

  2. もしeventLoopのタスクキューにキューされたタスクがあれば、それらを処理せずに破棄します。

  3. eventLoopが現在実行中のタスクを完了するまで待ちます。

  4. もし前のステップが実装依存の期間内に完了しない場合、現在workletで実行中のスクリプトを中止することとします。

  5. eventLoopを破棄します。

  6. workletGlobalScopeを、workletのグローバルスコープから削除します。

  7. workletGlobalScopeを、Documentのworklet グローバルスコープから削除します。

11.3.1.3 ワークレットのスクリプト設定

次の手順を使用して、ワークレット環境設定オブジェクトを設定します。これは、JavaScript 実行コンテキストの executionContext と、環境設定オブジェクトの outsideSettings に基づいて行われます：

  1. origin を一意の 不透明なオリジン に設定します。

  2. inheritedAPIBaseURL を outsideSettings の API ベース URL に設定します。

  3. inheritedPolicyContainer を outsideSettings の ポリシーコンテナのクローン に設定します。

  4. realm を executionContext のレルムコンポーネントの値に設定します。

  5. workletGlobalScope を realm の グローバルオブジェクト に設定します。

  6. settingsObject を新しい 環境設定オブジェクト に設定し、そのアルゴリズムを次のように定義します：

    レルム実行コンテキスト

    executionContext を返します。

    モジュールマップ

    workletGlobalScope の モジュールマップ を返します。

    API ベース URL

    inheritedAPIBaseURL を返します。

    ワーカーや他のグローバルスコープと異なり、ワークレットは単一のリソースから派生しません。代わりに、各自の URL を持つ複数のスクリプトが worklet.addModule() によってグローバルスコープにロードされます。そのため、この API ベース URL は他のグローバルスコープとは異なりますが、これまでのところ、ワークレットコードで利用可能な API は API ベース URL を使用していないため、問題にはなりません。

    オリジン

    origin を返します。

    ポリシーコンテナ

    inheritedPolicyContainer を返します。

    クロスオリジン分離機能

    TODO を返します。

    時間オリジン

    確認：このアルゴリズムは呼び出されないため、ワークレットコンテキストでは時間オリジンは利用できません。

  7. settingsObject の id を新しい一意の不透明な文字列に設定し、作成 URL を inheritedAPIBaseURL に、トップレベル作成 URL を null に、トップレベルオリジン を outsideSettings のトップレベルオリジン に、ターゲット閲覧コンテキスト を null に、そしてアクティブなサービスワーカー を null に設定します。

  8. realm の [[HostDefined]] フィールドを settingsObject に設定します。

  9. settingsObject を返します。

11.3.2 Worklet クラス

Worklet

すべての最新エンジンでサポートされています。

Firefox76+Safari14.1+Chrome65+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

Worklet クラスは、関連付けられた WorkletGlobalScope にモジュールスクリプトを追加する機能を提供します。その後、ユーザーエージェントは WorkletGlobalScope に登録されたクラスを作成し、そのメソッドを呼び出すことができます。

[Exposed=Window, SecureContext]
interface Worklet {
  [NewObject] Promise<undefined> addModule(USVString moduleURL, optional WorkletOptions options = {});
};

dictionary WorkletOptions {
  RequestCredentials credentials = "same-origin";
};

Worklet インスタンスを作成する仕様では、以下の事項を指定する必要があります:

await worklet.addModule(moduleURL[, { credentials }])

Worklet/addModule

すべての最新エンジンでサポートされています。

Firefox76+Safari14.1+Chrome65+
Opera?Edge79+
Edge (Legacy)?Internet Explorerサポートなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

moduleURL で指定された モジュールスクリプト を worklet のすべての グローバルスコープ にロードして実行します。ワークレットの種類によっては、このプロセスの一環として追加のグローバルスコープを作成することもできます。スクリプトが正常にロードされ、すべてのグローバルスコープで実行されると、返されたプロミスは完了します。

credentials オプションは、スクリプト取得プロセスを変更するために クレデンシャルモード に設定できます。デフォルトは "same-origin" です。

スクリプトまたはその依存関係の 取得 中に失敗が発生した場合、返されたプロミスは "AbortError" DOMException で拒否されます。スクリプトまたはその依存関係の解析中にエラーが発生した場合、返されたプロミスは解析中に生成された例外で拒否されます。

Worklet は、リスト を持ち、 グローバルスコープ を含みます。これは、 Worklet の ワークレットグローバルスコープタイプ のインスタンスです。初期状態では空です。

Worklet は、 追加されたモジュールリスト を持ち、これは リスト であり、 URL のリストです。初期状態では空で、このリストへのアクセスはスレッドセーフである必要があります。

Worklet は、 モジュールレスポンスマップ を持ち、これは 順序付きマップ であり、 URL から "fetching" または タプル までのマップです。このマップには、 レスポンス およびレスポンスボディを表す バイト列 が含まれます。このマップは初期状態では空であり、アクセスはスレッドセーフである必要があります。

追加されたモジュールリスト と モジュールレスポンスマップ は、異なるタイミングで作成された WorkletGlobalScope に対して、同じソーステキストに基づいて同等の モジュールスクリプト を実行することを保証するために存在します。これにより、追加の WorkletGlobalScope の作成が、著者にとって透明になります。

実際には、ユーザーエージェントがこれらのデータ構造とそれを参照するアルゴリズムをスレッドセーフなプログラミング技術を使用して実装することは期待されていません。代わりに、addModule() が呼び出されたとき、ユーザーエージェントはメインスレッドでモジュールグラフを取得し、取得されたソーステキスト（つまり、 モジュールレスポンスマップ に含まれる重要なデータ）を、それぞれの WorkletGlobalScope を持つスレッドに送信できます。

その後、ユーザーエージェントが Worklet の新しい WorkletGlobalScope を 作成 するとき、メインスレッドから新しい WorkletGlobalScope を含むスレッドに、取得されたソーステキストのマップとエントリーポイントのリストを送信するだけです。

addModule(moduleURL, options) メソッドのステップは以下の通りです:

  1. outsideSettings を this の 関連する設定オブジェクトとします。

  2. moduleURLRecord を、outsideSettings を基準として moduleURL を指定して URL をエンコード解析した結果とします。

  3. moduleURLRecord が失敗の場合、"SyntaxError" DOMException で拒否されたプロミスを返します。

  4. promise を新しいプロミスとします。

  5. workletInstance を this とします。

  6. 次のステップを並行して実行します。

    1. workletInstance の グローバルスコープが空の場合：

      1. workletInstance を指定してワークレットグローバルスコープを作成します。

      2. オプションで、問題の特定のワークレットとその仕様に応じて、workletInstance を指定して追加のグローバルスコープインスタンスを作成します。

      3. ワークレットエージェント内で実行されるものを含め、作成プロセスのすべてのステップが完了するまで待ってから次に進みます。

    2. pendingTasks を workletInstance の グローバルスコープのサイズとします。

    3. addedSuccessfully を false とします。

    4. workletInstance の グローバルスコープの各 workletGlobalScope について、workletGlobalScope を指定してネットワーキングタスクソースでグローバルタスクをキューに入れ、moduleURLRecord、outsideSettings、workletInstance のワークレット宛先タイプ、options["credentials"]、workletGlobalScope の関連する設定オブジェクト、workletInstance の モジュール応答マップ、および script を指定した次のステップを指定して、ワークレットスクリプトグラフをフェッチします。

      これらのフェッチのうち、実際にネットワークリクエストを実行するのは最初のものだけであり、他の WorkletGlobalScope のものは workletInstance の モジュール応答マップからの応答を再利用します。

      1. script が null の場合：

        1. workletInstance の 関連するグローバルオブジェクトを指定してネットワーキングタスクソースでグローバルタスクをキューに入れ、次のステップを実行します。

          1. pendingTasks が -1 でない場合：

            1. pendingTasks を -1 に設定します。

            2. promise を "AbortError" DOMException で拒否します。

        2. これらのステップを中止します。

      2. script の 再スローするエラーが null でない場合：

        1. workletInstance の 関連するグローバルオブジェクトを指定してネットワーキングタスクソースでグローバルタスクをキューに入れ、次のステップを実行します。

          1. pendingTasks が -1 でない場合：

            1. pendingTasks を -1 に設定します。

            2. promise を script の 再スローするエラーで拒否します。

        2. これらのステップを中止します。

      3. addedSuccessfully が false の場合：

        1. moduleURLRecord を workletInstance の 追加されたモジュールリストに追加します。

        2. addedSuccessfully を true に設定します。

      4. script を指定してモジュールスクリプトを実行します。

      5. workletInstance の 関連するグローバルオブジェクトを指定してネットワーキングタスクソースでグローバルタスクをキューに入れ、次のステップを実行します。

        1. pendingTasks が -1 でない場合：

          1. pendingTasks を pendingTasks - 1 に設定します。

          2. pendingTasks が 0 の場合、promise を解決します。

  7. promise を返します。

11.3.3 ワークレットのライフタイム

Workletのライフタイムには特別な考慮は必要なく、 それが属するオブジェクト、例えばWindow に関連付けられています。

各Documentには、ワークレットグローバルスコープがあり、 これは初期状態では空のWorkletGlobalScopeのセットです。

WorkletGlobalScope のライフタイムは、最低でもそのDocumentに関連付けられたワークレットグローバルスコープに含まれています。特に、Documentの破棄は、対応するWorkletGlobalScope を終了させ、それをガベージコレクションの対象にすることができます。

さらに、ユーザーエージェントはいつでも特定のWorkletGlobalScope を終了させることができます。ただし、対応するワークレットタイプを定義する仕様で別の指示がない限りです。たとえば、ワークレットエージェントのイベントループにタスクがキューに入っていない場合や、ユーザーエージェントがワークレットを使用する予定の保留中の操作がない場合、または無限ループや制限時間を超えるコールバックなどの異常な操作を検出した場合などに終了させることが考えられます。

最後に、特定のワークレットタイプの仕様は、特定のワークレットタイプに対してWorkletGlobalScope を作成する 時期について、より具体的な詳細を提供することがあります。たとえば、ワークレットコードを呼び出す特定のプロセス中にこれを作成するなどです。これは例に示されています。

12 Web ストレージ

Web_Storage_API

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

Web_Storage_API/Using_the_Web_Storage_API

12.1 はじめに

このセクションは規範的ではありません。

この仕様書では、クライアント側で名前と値のペアを保存するための、HTTPセッションクッキーに似た2つの関連メカニズムを紹介します。[COOKIES]

最初のメカニズムは、ユーザーが単一の取引を行っている場合を想定していますが、同時に異なるウィンドウで複数の取引を行う可能性もあります。

クッキーはこのケースをうまく処理できません。例えば、ユーザーが同じサイトで2つの異なるウィンドウで飛行機のチケットを購入しているとします。もしそのサイトが、ユーザーが購入しているチケットを追跡するためにクッキーを使用していた場合、2つのウィンドウでページをクリックしていくうちに、現在購入中のチケットが1つのウィンドウから他のウィンドウに「漏れ」てしまい、ユーザーが気づかずに同じフライトのチケットを2枚購入してしまう可能性があります。

これに対処するため、この仕様書では sessionStorage ゲッターを導入しています。 サイトはセッションストレージにデータを追加でき、同じウィンドウで開かれた同じサイトの任意のページからアクセスすることができます。

例えば、ページにユーザーがチェックを入れるチェックボックスがあり、旅行に保険をかけたいかどうかを示すことができるとします。

<label>
  <input type="checkbox" onchange="sessionStorage.insurance = checked ? 'true' : ''">
   この旅行に保険をかける。
 </label>

その後のページで、スクリプトからユーザーがチェックボックスをチェックしたかどうかを確認することができます。

if (sessionStorage.insurance) { ... }

もしユーザーがサイトで複数のウィンドウを開いていた場合、それぞれのウィンドウはセッションストレージオブジェクトの個別のコピーを持つことになります。

2つ目のストレージメカニズムは、複数のウィンドウにまたがる保存や、現在のセッションを超えて持続する保存を目的としています。特に、Webアプリケーションは、パフォーマンス上の理由から、ユーザー作成のドキュメント全体やユーザーのメールボックスなどの数メガバイトのユーザーデータをクライアント側に保存することが考えられます。

再び、クッキーはこのケースをうまく処理できません。なぜなら、クッキーはすべてのリクエストとともに送信されるからです。

localStorage ゲッターは、ページのローカルストレージ領域にアクセスするために使用されます。

example.comのサイトは、次のコードをページの下部に配置することで、ユーザーがそのページを何回ロードしたかを表示できます。

<p>
   あなたはこのページを
   <span id="count">何回見たかわかりません</span>
   回数。
 </p>
 <script>
   if (!localStorage.pageLoadCount)
     localStorage.pageLoadCount = 0;
   localStorage.pageLoadCount = parseInt(localStorage.pageLoadCount) + 1;
   document.getElementById('count').textContent = localStorage.pageLoadCount;
 </script>

各サイトにはそれぞれ別々のストレージ領域があります。

localStorage ゲッターは共有された状態へのアクセスを提供します。この仕様書は、マルチプロセスユーザーエージェントにおける他のエージェントクラスターとの相互作用を定義しておらず、作成者はロック機構がないと仮定することを推奨します。たとえば、サイトがキーの値を読み取り、その値をインクリメントし、新しい値をセッションの一意の識別子として使用しようとするかもしれません。同じブラウザーの2つの異なるウィンドウで同時にこれを行うと、両方のセッションで同じ「一意の」識別子が使用されてしまい、潜在的に重大な影響を及ぼす可能性があります。

12.2 API

Storage

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

12.2.1 Storage インターフェイス

[Exposed=Window]
 interface Storage {
   readonly attribute unsigned long length;
   DOMString? key(unsigned long index);
   getter DOMString? getItem(DOMString key);
   setter undefined setItem(DOMString key, DOMString value);
   deleter undefined removeItem(DOMString key);
   undefined clear();
 };
storage.length

Storage/length

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

キーと値のペアの数を返します。

storage.key (n)

Storage/key

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

n 番目のキーの名前を返します。n がキーと値のペアの数以上の場合は null を返します。

value = storage.getItem (key)

Storage/getItem

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
value = storage[key]

指定された key に関連付けられている現在の値を返します。指定された key が存在しない場合は null を返します。

storage.setItem (key, value)

Storage/setItem

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
storage[key] = value

指定された key に対応する値を value に設定します。以前に key に対応するキーと値のペアが存在しなかった場合は、新しいキーと値のペアが作成されます。

新しい値を設定できなかった場合 (例えば、ユーザーがサイトのストレージを無効にしている場合や、クォータを超えた場合など)、"QuotaExceededError" DOMException がスローされます。

同等の Storage オブジェクトを保持する Window オブジェクトに対して storage イベントが発生します。

storage.removeItem (key)

Storage/removeItem

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
delete storage[key]

指定された key に対応するキーと値のペアを削除します。指定された key に対応するキーと値のペアが存在する場合。

同等の Storage オブジェクトを保持する Window オブジェクトに対して storage イベントが発生します。

storage.clear()

Storage/clear

すべての最新のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android6+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

キーと値のペアが存在する場合、それらをすべて削除します。

同等の Storage オブジェクトを保持する Window オブジェクトに対して storage イベントが発生します。

Storage オブジェクトには、次の関連情報があります:

マップ
ストレージプロキシマップ。
タイプ
"local" または "session"。

Storage オブジェクト storage を並べ替えるには、storage の マップの エントリを実装に定義された方法で並べ替えます。

残念ながら、反復順序は定義されておらず、多くの変更が加わると変更される可能性があります。

Storage オブジェクト storage を ブロードキャスト するには、key、oldValue、および newValue を指定して、次の手順を実行します:

  1. storage の 関連するグローバルオブジェクト の 関連付けられた Document を thisDocument とします。

  2. url を thisDocument の URL のシリアル化とします。

  3. Storage オブジェクトのうち storage を除く remoteStorages を、次の条件に基づいて取得します:

    そして、タイプ が "session" の場合、関連する設定オブジェクト の 関連付けられた Document の ノードナビゲーブル の ナビゲート可能なトラバース が thisDocument の ノードナビゲーブル の ナビゲート可能なトラバース であること。

  4. 各 remoteStorage について、remoteStorages を使用して: グローバルタスクをキューに入れ、remoteStorage の 関連するグローバルオブジェクト に対して、storage という名前のイベントを remoteStorage の 関連するグローバルオブジェクト で StorageEvent を使用して発生させ、key を key に初期化し、oldValue を oldValue に初期化し、newValue を newValue に初期化し、url を url に初期化し、storageArea を remoteStorage に初期化します。

    Document オブジェクトが関連付けられたタスクのタスク は、必ずしも 完全にアクティブ であるとは限りませんが、そのようなオブジェクトで発生するイベントは、Document が再び 完全にアクティブ になるまで イベントループ によって無視されます。

length ゲッターの手順は、this の マップの サイズ を返すことです。

key(index) メソッドの手順は次のとおりです:

  1. index が this の マップの サイズ 以上である場合、null を返します。

  2. keys を、キーを取得する処理を this の マップ に対して実行して得た結果とします。

  3. keys[index] を返します。

サポートされているプロパティ名 は、Storage オブジェクト storage に対して、キーを取得する 処理の結果として得られるものです。

getItem(key) メソッドの手順は次のとおりです:

  1. this の マップ[key] が 存在しない 場合は、null を返します。

  2. this の マップ[key] を返します。

setItem(key, value) メソッドのステップは次のとおりです。

  1. oldValue を null に設定します。

  2. reorder を true に設定します。

  3. this の マップ[key] が 存在する 場合:

    1. oldValue を this の マップ[key] に設定します。

    2. oldValue が 等しい value と、ならば返します。

    3. reorder を false に設定します。

  4. value が保存できない場合、"QuotaExceededError" DOMException をスローします。

  5. 設定 this の マップ[key] に value を設定します。

  6. reorder が true の場合は、並べ替え this。

  7. ブロードキャスト this に key、oldValue、および value を設定します。

removeItem(key) メソッドの手順は次のとおりです:

  1. this の マップ[key] が 存在しない 場合は、null を返します。

  2. oldValue を this の マップ[key] に設定します。

  3. 削除 this の マップ[key] を削除します。

  4. 並べ替え this。

  5. ブロードキャスト this に key、oldValue、および null を設定します。

clear() メソッドの手順は次のとおりです:

  1. クリア this の マップ。

  2. ブロードキャスト this に null、null、null を設定します。

12.2.2 sessionStorage ゲッター

interface mixin WindowSessionStorage {
   readonly attribute Storage sessionStorage;
 };
 Window includes WindowSessionStorage;
window.sessionStorage

Window/sessionStorage

すべての最新エンジンでサポートされています。

Firefox2+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

その window のオリジンに関連するセッションストレージエリアに関連付けられた Storage オブジェクトを返します。

Document の オリジン が 不透明なオリジン であるか、リクエストがポリシー決定に違反した場合 (例: ユーザーエージェントがページがデータを保持することを許可しないように設定されている場合) は、"SecurityError" DOMException をスローします。

Document オブジェクトは、関連付けられた セッションストレージホルダー を持ち、それは null または Storage オブジェクトです。それは最初は null です。

sessionStorage ゲッターの手順は次のとおりです:

  1. this の 関連する Document の セッションストレージホルダー が null でない場合、それを返します。

  2. map を、this の 関連する設定オブジェクト と "sessionStorage" を使って セッションストレージボトルマップを取得する 処理を実行した結果とします。

  3. map が失敗した場合、"SecurityError" DOMException をスローします。

  4. storage を、新しい Storage オブジェクトで、その マップ が map であるものとします。

  5. this の 関連する Document の セッションストレージホルダー を storage に設定します。

  6. storage を返します。

新しい補助的なブラウジングコンテキストとドキュメントを作成すると、セッションストレージがコピーされます。

12.2.3 localStorage ゲッター

interface mixin WindowLocalStorage {
   readonly attribute Storage localStorage;
 };
 Window includes WindowLocalStorage;
window.localStorage

Window/localStorage

すべての最新エンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.5+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11+

window のオリジンに関連付けられたローカルストレージエリアに関連する Storage オブジェクトを返します。

Document の オリジン が 不透明なオリジン である場合、またはリクエストがポリシー決定に違反する場合 (例: ユーザーエージェントがページがデータを保持することを許可しないように設定されている場合) は、"SecurityError" DOMException をスローします。

Document オブジェクトには、関連付けられた ローカルストレージホルダー があり、それは null または Storage オブジェクトです。それは最初は null です。

localStorage ゲッターの手順は次のとおりです:

  1. this の 関連する Document の ローカルストレージホルダー が null でない場合、それを返します。

  2. map を、this の 関連する設定オブジェクト と "localStorage" を使って ローカルストレージボトルマップを取得する 処理を実行した結果とします。

  3. map が失敗した場合、"SecurityError" DOMException をスローします。

  4. storage を、新しい Storage オブジェクトで、その マップ が map であるものとします。

  5. this の 関連する Document の ローカルストレージホルダー を storage に設定します。

  6. storage を返します。

12.2.4 StorageEvent インターフェース

StorageEvent

すべての最新エンジンでサポートされています。

Firefox13+Safari4+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+ 
[Exposed=Window]
 interface StorageEvent : Event {
   constructor(DOMString type, optional StorageEventInit eventInitDict = {});
 
   readonly attribute DOMString? key;
   readonly attribute DOMString? oldValue;
   readonly attribute DOMString? newValue;
   readonly attribute USVString url;
   readonly attribute Storage? storageArea;
 
   undefined initStorageEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional DOMString? key = null, optional DOMString? oldValue = null, optional DOMString? newValue = null, optional USVString url = "", optional Storage? storageArea = null);
 };
 
 dictionary StorageEventInit : EventInit {
   DOMString? key = null;
   DOMString? oldValue = null;
   DOMString? newValue = null;
   USVString url = "";
   Storage? storageArea = null;
 };
event.key

変更されているストレージアイテムのキーを返します。

event.oldValue

値が変更されているストレージアイテムのキーの古い値を返します。

event.newValue

値が変更されているストレージアイテムのキーの新しい値を返します。

event.url

ストレージアイテムが変更されたドキュメントのURLを返します。

event.storageArea

影響を受けたStorageオブジェクトを返します。

key、oldValue、newValue、urlおよびstorageArea属性は、それらが初期化された値を返さなければなりません。

initStorageEvent(type, bubbles, cancelable, key, oldValue, newValue, url, storageArea)メソッドは、同様の名前を持つinitEvent()メソッドに類似した方法でイベントを初期化しなければなりません。[DOM]

12.3 プライバシー

12.3.1 ユーザートラッキング

第三者の広告主（または複数のサイトにコンテンツを配信できる任意のエンティティ）は、そのローカルストレージ領域に保存された一意の識別子を使用して、複数のセッションにわたってユーザーを追跡し、ユーザーの関心に基づいたプロファイルを構築し、高度にターゲットを絞った広告を行うことができます。ユーザーの実際の身元を把握しているサイト（たとえば、認証された資格情報を必要とする e コマースサイト）と連携することで、純粋に匿名のウェブ利用が可能な世界よりも正確に個人を特定することができるようになります。

ユーザートラッキングのリスクを軽減するために使用できる技術がいくつかあります：

サードパーティのストレージをブロックする

ユーザーエージェントは、localStorageオブジェクトへのアクセスを、アクティブドキュメントのトップレベルのトラバーサブルのドメインから発生するスクリプトに限定することができます。たとえば、iframe内で実行される他のドメインのページに対してAPIのアクセスを拒否することがあります。

保存データの期限を設定する

ユーザーエージェントは、ユーザーによって構成される可能性のある方法で、一定期間後に自動的に保存されたデータを削除することがあります。

たとえば、ユーザーエージェントは、サードパーティのローカルストレージ領域をセッションのみのストレージとして扱い、ユーザーがそれにアクセスできるすべてのナビゲーブルを閉じた後にデータを削除するように構成することができます。

これにより、サイトがユーザーを追跡する能力が制限されます。サイトは、ユーザーがサイト自体で認証した場合（たとえば、購入を行ったり、サービスにログインしたりする場合）にのみ、複数のセッションにわたってユーザーを追跡できるようになります。

ただし、これにより、APIが長期的なストレージメカニズムとしての有用性が低下することがあります。また、ユーザーがデータの期限切れの影響を十分に理解していない場合、ユーザーのデータが危険にさらされる可能性もあります。

永続的なストレージをクッキーとして扱う

ユーザーがクッキーを削除してプライバシーを保護しようとする場合でも、ローカルストレージ領域に保存されたデータを削除しない限り、サイトは両方の機能を冗長なバックアップとして使用して、これらの試みを無効にすることができます。ユーザーエージェントは、これらを削除するためのインターフェイスを提供し、この可能性をユーザーに理解させ、すべての永続的なストレージ機能のデータを同時に削除できるようにする必要があります。[COOKIES]

ローカルストレージ領域へのアクセスのサイト固有のホワイトリスト化

ユーザーエージェントは、サイトがセッションストレージ領域に制限なくアクセスできるようにし、ローカルストレージ領域へのアクセスを許可する前にユーザーの承認を求めることができます。

保存データのオリジントラッキング

ユーザーエージェントは、サードパーティのオリジンからのコンテンツを含むサイトのオリジンを記録することができます。

この情報が使用されて、現在永続ストレージにあるデータのビューが表示されると、ユーザーは永続ストレージのどの部分を整理するかについて情報に基づいた決定を行うことができるようになります。ブラックリストと組み合わせることで（「このデータを削除し、このドメインが再びデータを保存するのを防ぐ」）、ユーザーは信頼するサイトにのみ永続ストレージの使用を制限することができます。

共有ブラックリスト

ユーザーエージェントは、ユーザーが永続ストレージのドメインブラックリストを共有できるようにすることができます。

これにより、コミュニティが協力してプライバシーを保護することができます。

これらの提案により、このAPIのユーザートラッキングへの使用を簡単に防ぐことはできますが、それを完全に阻止することはできません。単一のドメイン内で、サイトはセッション中にユーザーを追跡し続け、サイトから得られた名前、クレジットカード番号、住所などの識別情報と共に、すべての情報を第三者に渡すことができます。第三者が複数のサイトと協力してそのような情報を取得した場合、プロファイルが作成される可能性があります。

ただし、ユーザーエージェントの協力がなくても、ユーザートラッキングがある程度可能であることに変わりはありません。たとえば、URLにセッション識別子を使用することで、無害な目的で一般的に使用されている技術が、ユーザートラッキングのために容易に再利用される可能性があります。この情報は、訪問者のIPアドレスや他のユーザー固有のデータ（たとえば、ユーザーエージェントヘッダーや構成設定）を使用して、別々のセッションを一貫したユーザープロファイルにまとめるために、他のサイトと共有される可能性があります。

12.3.2 データの機密性

ユーザーエージェントは、永続的に保存されたデータを潜在的に機密性のあるものとして扱うべきです。このメカニズムにより、電子メール、カレンダーの予定、医療記録、その他の機密文書が保存される可能性があります。

この目的のために、ユーザーエージェントはデータを削除する際、基盤となるストレージからすみやかに削除することを確保するべきです。

12.4 セキュリティ

12.4.1 DNSスプーフィング攻撃

DNSスプーフィング攻撃の可能性があるため、特定のドメインに属していると主張するホストが本当にそのドメインから来ていることを保証することはできません。これを緩和するために、ページはTLSを使用できます。TLSを使用するページは、ユーザー、ユーザーの代わりに動作するソフトウェア、および同じドメインからのものであると識別される証明書を持つTLSを使用する他のページのみが、保存領域にアクセスできることを確認できます。

12.4.2 クロスディレクトリアタック

1つのホスト名を共有する複数の作成者（たとえば、かつて存在したgeocities.comにコンテンツをホストしていたユーザー）は、1つのローカルストレージオブジェクトを共有しています。パス名によるアクセス制限機能はありません。したがって、共有ホストの作成者はこれらの機能の使用を避けるように強く求められます。なぜなら、他の作成者がデータを読み取り、それを上書きするのは非常に簡単だからです。

たとえパス制限機能が提供されたとしても、通常のDOMスクリプトセキュリティモデルにより、この保護を回避して任意のパスからデータにアクセスするのは簡単です。

12.4.3 実装のリスク

これらの永続ストレージ機能を実装する際の主なリスクは、悪意のあるサイトが他のドメインから情報を読み取れるようにすること、または悪意のあるサイトが情報を記述し、それが他のドメインから読み取られるようにすることです。

第三者のサイトに、そのドメインから読み取ることを許可されていないデータを読み取らせると、情報漏洩が発生します。たとえば、あるドメインでユーザーのショッピングウィッシュリストが、他のドメインでターゲット広告のために使用される可能性があります。また、ワードプロセッシングサイトに保存されているユーザーの進行中の機密文書が、競合企業のサイトによって調査される可能性があります。

第三者のサイトに、他のドメインの永続ストレージにデータを書き込ませると、情報改ざんが発生する可能性があり、これも同様に危険です。たとえば、悪意のあるサイトがユーザーのウィッシュリストに項目を追加する可能性があります。また、悪意のあるサイトがユーザーのセッション識別子を既知のIDに設定し、その悪意のあるサイトが被害者サイトでのユーザーのアクションを追跡するためにそのIDを使用できるようにする可能性があります。

したがって、この仕様書で説明されているオリジンモデルを厳守することは、ユーザーのセキュリティにとって重要です。

13 HTML構文

このセクションでは、HTML MIMEタイプとしてラベル付けされたリソースのルールのみが説明されています。XMLリソースのルールについては、下記の「XML構文」というタイトルのセクションで説明されています。

13.1 HTMLドキュメントの作成

このセクションは、ドキュメント、オーサリングツール、およびマークアップ生成ツールにのみ適用されます。特に、コンフォーマンスチェッカーには適用されません。コンフォーマンスチェッカーは、次のセクション「HTMLドキュメントの解析」で示されている要件を使用する必要があります。

ドキュメントは、以下のパーツで構成されている必要があります。この順序で配置してください：

  1. オプションで、単一のU+FEFFバイト順マーク（BOM）文字。
  2. コメントおよびASCIIホワイトスペースが任意の数だけ。
  3. DOCTYPE。
  4. コメントおよびASCIIホワイトスペースが任意の数だけ。
  5. 文書要素としてのhtml 要素。
  6. コメントおよびASCIIホワイトスペースが任意の数だけ。

上記で言及されているさまざまな種類のコンテンツは、次のいくつかのセクションで説明されています。

さらに、文字エンコーディング宣言がどのようにシリアライズされるべきかに関する制限があります。そのトピックに関するセクションで説明されています。

ASCIIホワイトスペースは、html要素の前、html要素の開始時、head要素の前にある場合、ドキュメントが解析されるときに削除されます。html要素の後にあるASCIIホワイトスペースは、body要素の末尾にあるかのように解析されます。したがって、文書要素周りのASCIIホワイトスペースは、ラウンドトリップでは保持されません。

DOCTYPEの後、文書要素の前にあるコメントの後、html要素の開始タグ（省略されていない場合）の後、およびhtml要素の内部で、head要素の前にあるコメントの後に、改行を挿入することが推奨されます。

HTML構文の多くの文字列（例：要素の名前やその属性）は、ASCII大文字とASCII小文字に対してのみ大文字と小文字を区別しません。便宜上、このセクションではこれを「大文字と小文字を区別しない」と呼んでいます。

13.1.1 DOCTYPE

DOCTYPEは必須の前文です。

DOCTYPEはレガシーな理由で必要とされています。省略された場合、ブラウザは一部の仕様と互換性のない異なるレンダリングモードを使用する傾向があります。ドキュメントにDOCTYPEを含めることで、ブラウザが関連する仕様に従おうとする最善の試みを行うことが保証されます。

DOCTYPEは次のコンポーネントで構成されている必要があります。この順序で配置してください：

  1. 文字列が"<!DOCTYPE"とASCII大文字小文字を区別しないで一致する文字列。
  2. 1つ以上のASCIIホワイトスペース。
  3. 文字列が"html"とASCII大文字小文字を区別しないで一致する文字列。
  4. オプションで、DOCTYPEレガシー文字列。
  5. 0個以上のASCIIホワイトスペース。
  6. U+003E GREATER-THAN SIGN 文字(>)。

言い換えると、<!DOCTYPE html>（大文字小文字を区別せず）。

短いDOCTYPE "<!DOCTYPE html>"を出力できないHTML生成ツールの場合、DOCTYPEレガシー文字列をDOCTYPEに挿入することができます（上記で定義された位置に）。この文字列は次の内容で構成されている必要があります：

  1. 1つ以上のASCIIホワイトスペース。
  2. 文字列が"SYSTEM"とASCII大文字小文字を区別しないで一致する文字列。
  3. 1つ以上のASCIIホワイトスペース。
  4. U+0022 QUOTATION MARK または U+0027 APOSTROPHE 文字 (引用符)。
  5. 文字列"about:legacy-compat"。
  6. 一致するU+0022 QUOTATION MARK または U+0027 APOSTROPHE 文字（つまり、前のステップで使用したのと同じ文字）。

言い換えると、<!DOCTYPE html SYSTEM "about:legacy-compat"> または <!DOCTYPE html SYSTEM 'about:legacy-compat'>（引用符内の部分を除いて大文字小文字を区別せず）。

DOCTYPEレガシー文字列は、短い文字列を出力できないシステムから生成されたドキュメントでない限り、使用すべきではありません。

13.1.2 要素

6種類の要素があります: 空要素, template要素, 生テキスト要素, エスケープ可能な生テキスト要素, 外部要素, および通常の要素です。

空要素
area, base, br, col, embed, hr, img, input, link, meta, source, track, wbr
template要素
template
生テキスト要素
script, style
エスケープ可能な生テキスト要素
textarea, title
外部要素
MathML名前空間およびSVG名前空間の要素。
通常の要素
その他のすべてのHTML要素は通常の要素です。

タグは、マークアップ内の要素の開始と終了を区切るために使用されます。生テキスト、エスケープ可能な生テキスト、および通常の要素には、開始を示す開始タグと終了を示す終了タグがあります。 ある通常の要素の開始タグと終了タグは、下記のオプションのタグのセクションで説明されているように、省略可能です。省略できないものは省略しないでください。空要素には開始タグしかありません。空要素に終了タグを指定してはいけません。 外部要素は、開始タグと終了タグがあるか、または自己終了とマークされた開始タグがある場合は終了タグを持つことはできません。

要素の内容は、開始タグのすぐ後（特定のケースでは省略されることがあります）から、終了タグの直前（再び、特定のケースでは省略されることがあります）の間に配置する必要があります。各要素に許可されている正確な内容は、その要素の内容モデルに依存し、この仕様書の前の部分で説明されています。要素は、その内容モデルが許可しない内容を含んではなりません。ただし、これらの内容モデルによって課される制約に加えて、要素の5つの種類には追加の構文要件があります。

空要素には内容を含めることはできません（開始タグと終了タグの間に内容を入れることができないため）。

template要素にはテンプレート内容を含めることができますが、そのテンプレート内容はtemplate要素の子要素ではありません。代わりに、それらは異なるDocumentに関連付けられたDocumentFragmentに保存されます。— 閲覧コンテキストなしに — これにより、template要素の内容がメインのDocumentに干渉するのを防ぎます。 テンプレート内容のマークアップは、template要素の開始タグの直後、終了タグの直前に配置され（他の要素と同様に）、テキスト、文字参照、要素、およびコメントを含めることができますが、そのテキストにはU+003C LESS-THAN SIGN (<)や曖昧なアンパサンドを含めてはいけません。

生テキスト要素は、テキストを含めることができますが、下記で説明されている制限があります。

エスケープ可能な生テキスト要素には、テキストおよび文字参照を含めることができますが、そのテキストには曖昧なアンパサンドを含めてはいけません。さらに、下記で説明されている追加の制限もあります。

外部要素で自己終了とマークされた開始タグを持つ要素には内容を含めることができません（再度言いますが、終了タグがないため、開始タグと終了タグの間に内容を入れることはできません）。外部要素の開始タグが自己終了とマークされていない場合は、テキスト、文字参照、CDATAセクション、その他の要素、およびコメントを含めることができますが、そのテキストにはU+003C LESS-THAN SIGN (<)や曖昧なアンパサンドを含めてはいけません。

HTML構文は、外部要素内であっても名前空間宣言をサポートしていません。

例えば、次のHTML断片を考えてみましょう：

<p>
  <svg>
   <metadata>
    <!-- これは無効です -->
    <cdr:license xmlns:cdr="https://www.example.com/cdr/metadata" name="MIT"/>
   </metadata>
  </svg>
 </p>

最も内側の要素cdr:licenseは、実際にはSVG名前空間に属しています。これは、xmlns:cdr属性が効果を持たないためです（XMLとは異なります）。実際、上記の断片のコメントにあるように、この断片は非準拠です。これは、SVG 2がSVG名前空間にcdr:licenseという名前の要素を定義していないためです。

通常の要素には、テキスト、文字参照、その他の要素、およびコメントを含めることができますが、そのテキストにはU+003C LESS-THAN SIGN (<)や曖昧なアンパサンドを含めてはいけません。 一部の通常の要素には、内容モデルおよびこの段落で説明されている制約に加えて、保持が許可される内容にさらに制限が設けられています。それらの制限については以下に説明されています。

タグには、要素の名前を指定するタグ名が含まれています。HTML要素はすべて、ASCII英数字のみを使用する名前を持っています。HTML構文では、外部要素を含むタグ名は、すべて小文字に変換されたときに要素のタグ名と一致するように、大文字と小文字の任意の組み合わせで記述できます。タグ名は大文字と小文字を区別しません。

13.1.2.1 開始タグ

開始タグは、以下の形式でなければなりません:

  1. 開始タグの最初の文字は、U+003C LESS-THAN SIGN 文字 (<) でなければなりません。
  2. 開始タグの次の数文字は、その要素のタグ名でなければなりません。
  3. 次のステップで属性がある場合、最初に1つ以上のASCIIホワイトスペースが必要です。
  4. その後、開始タグにはいくつかの属性が含まれる場合があります。その構文は以下に説明されています。属性同士は、1つ以上のASCIIホワイトスペースで区切られていなければなりません。
  5. 属性の後、または属性がない場合はタグ名の後に、1つ以上のASCIIホワイトスペースがあってもよいです。（一部の属性はスペースで区切られる必要があります。詳細は属性セクションを参照してください。）
  6. 次に、要素が空要素の1つである場合、またはその要素が外部要素である場合、開始タグを自己終了タグとしてマークするためのU+002F SOLIDUS文字 (/) が1つ含まれてもよいです。空要素において、この文字は自己終了タグとしてマークするものではなく、不要であり、解析器により無視されます。そのような空要素に対して、この文字を使用する際には注意が必要です。特に、引用符なしの属性値の直前にある場合、それは属性値の一部となり、解析器により破棄されるのではなく、属性値として認識されます。
  7. 最後に、開始タグはU+003E GREATER-THAN SIGN 文字 (>) で閉じられなければなりません。
13.1.2.2 終了タグ

終了タグは、以下の形式でなければなりません:

  1. 終了タグの最初の文字は、U+003C LESS-THAN SIGN 文字 (<) でなければなりません。
  2. 終了タグの2番目の文字は、U+002F SOLIDUS 文字 (/) でなければなりません。
  3. 終了タグの次の数文字は、その要素のタグ名でなければなりません。
  4. タグ名の後に1つ以上のASCIIホワイトスペースがあってもよいです。
  5. 最後に、終了タグはU+003E GREATER-THAN SIGN 文字 (>) で閉じられなければなりません。
13.1.2.3 属性

属性は、要素の開始タグ内に記述されます。

属性には名前と値があります。属性名は、制御文字、U+0020 スペース、U+0022（"）、U+0027（'）、U+003E（>）、U+002F（/）、U+003D（=）および非文字以外の1文字以上で構成されている必要があります。HTML構文では、属性名は外部要素のものを含め、ASCII 小文字とASCII 大文字の任意の組み合わせで記述できます。

属性値は、テキストと文字参照の組み合わせですが、テキストには曖昧なアンパサンドが含まれてはいけません。

属性は、以下の4つの方法で指定できます:

空属性構文

単に属性名のみで記述されます。値は暗黙的に空文字列となります。

以下の例では、disabled属性が空属性構文で指定されています: 

<input disabled>

空属性構文を使用した属性の後に別の属性が続く場合、両者の間にASCII ホワイトスペースが必要です。

引用符なし属性値構文

属性名に続き、0個以上のASCII ホワイトスペース、U+003D 等号文字、0個以上のASCII ホワイトスペースに続いて、属性値を指定します。属性値には、上記の要件に加え、リテラルASCII ホワイトスペース、U+0022 クオーテーションマーク（"）、U+0027 アポストロフィー（'）、U+003D 等号（=）、U+003C 小なり記号（<）、U+003E 大なり記号（>）、U+0060 グレイヴアクセント（`）が含まれてはならず、空文字列ではありません。

以下の例では、value属性が引用符なし属性値構文で指定されています: 

<input value=yes>

引用符なし属性構文を使用した属性の後に別の属性や、上記の開始タグ構文のステップ6で許可されているオプションのU+002F スラッシュ文字（/）が続く場合、両者の間にASCII ホワイトスペースが必要です。

単一引用符付き属性値構文

属性名に続き、0個以上のASCII ホワイトスペース、U+003D 等号文字、0個以上のASCII ホワイトスペースに続いて、単一のU+0027 アポストロフィー（'）文字、その後に属性値が記述されます。属性値には、上記の要件に加え、リテラルのU+0027 アポストロフィー文字（'）が含まれてはならず、最後に2番目の単一のU+0027 アポストロフィー文字（'）が続きます。

以下の例では、type属性が単一引用符付き属性値構文で指定されています: 

<input type='checkbox'>

単一引用符付き属性構文を使用した属性の後に別の属性が続く場合、両者の間にASCII ホワイトスペースが必要です。

二重引用符付き属性値構文

属性名に続き、0個以上のASCII ホワイトスペース、U+003D 等号文字、0個以上のASCII ホワイトスペースに続いて、単一のU+0022 クオーテーションマーク（"）文字、その後に属性値が記述されます。属性値には、上記の要件に加え、リテラルのU+0022 クオーテーションマーク（"）文字が含まれてはならず、最後に2番目の単一のU+0022 クオーテーションマーク（"）文字が続きます。

以下の例では、name属性が二重引用符付き属性値構文で指定されています:

<input name="be evil">

二重引用符付き属性構文を使用した属性の後に別の属性が続く場合、両者の間にASCII ホワイトスペースが必要です。

同じ開始タグにおいて、名前が互いにASCII 大文字小文字を区別しない一致となる属性が2つ以上存在してはいけません。

外部要素が次の表の各行の最初の2つのセルに示されているローカル名および名前空間の名前空間属性を持つ場合、その属性は同じ行の3番目のセルに示されている名前を使用して記述されなければなりません。

ローカル名 名前空間 属性名
actuate XLink 名前空間 xlink:actuate
arcrole XLink 名前空間 xlink:arcrole
href XLink 名前空間 xlink:href
role XLink 名前空間 xlink:role
show XLink 名前空間 xlink:show
title XLink 名前空間 xlink:title
type XLink 名前空間 xlink:type
lang XML 名前空間 xml:lang
space XML 名前空間 xml:space
xmlns XMLNS 名前空間 xmlns
xlink XMLNS 名前空間 xmlns:xlink

他の名前空間属性は、HTML構文では表現できません。

上記の表にある属性が適合するかどうかは、他の仕様（例えば、SVG 2やMathML）で定義されています。このセクションは、属性がHTML構文を使用してシリアル化される場合の構文ルールのみを記述しています。

13.1.2.4 省略可能なタグ

特定のタグは省略することができます。

以下に記載されている状況で要素の開始タグを省略することは、要素が存在しないことを意味するわけではありません。それは暗黙的に存在しますが、依然としてそこにあります。たとえば、HTML文書には、html要素が常にありますが、マークアップ内に<html>という文字列が現れなくても問題ありません。

html要素の開始タグは、html要素内の最初の内容がコメントでない場合に省略することができます。

たとえば、以下のケースでは「<html>」タグを削除しても問題ありません:

<!DOCTYPE HTML>
 <html>
   <head>
     <title>Hello</title>
   </head>
   <body>
     <p>Welcome to this example.</p>
   </body>
 </html>

これを行うと、文書は次のように見えます:

<!DOCTYPE HTML>
 
   <head>
     <title>Hello</title>
   </head>
   <body>
     <p>Welcome to this example.</p>
   </body>
 </html>

これは完全に同じDOMです。特に、ドキュメント要素の周囲の空白はパーサーによって無視されます。次の例も完全に同じDOMを持ちます:

<!DOCTYPE HTML><head>
     <title>Hello</title>
   </head>
   <body>
     <p>Welcome to this example.</p>
   </body>
 </html>

しかし、次の例では、開始タグを削除するとコメントがhtml要素の前に移動します:

<!DOCTYPE HTML>
 <html>
   <!-- where is this comment in the DOM? -->
   <head>
     <title>Hello</title>
   </head>
   <body>
     <p>Welcome to this example.</p>
   </body>
 </html>

タグを削除すると、実際に文書は次のようになります:

<!DOCTYPE HTML>
 <!-- where is this comment in the DOM? -->
 <html>
   <head>
     <title>Hello</title>
   </head>
   <body>
     <p>Welcome to this example.</p>
   </body>
 </html>

このため、タグはコメントが続かない場合にのみ削除できます。コメントがある場合にタグを削除すると、文書の解析ツリーが変更されます。もちろん、コメントの位置が重要でない場合は、最初からコメントが開始タグの前に移動されたかのようにタグを省略することができます。

html要素の終了タグは、html要素が直後にコメントで続かない場合に省略することができます。

head要素の開始タグは、要素が空の場合、またはhead要素内の最初の内容が要素である場合に省略することができます。

head要素の終了タグは、head要素が直後にASCIIホワイトスペースまたはコメントで続かない場合に省略することができます。

body要素の開始タグは、要素が空の場合、またはbody要素内の最初の内容がASCIIホワイトスペースまたはコメントでない場合に省略することができます。ただし、body要素内の最初の内容がmeta、noscript、link、script、style、またはtemplate要素である場合を除きます。

body要素の終了タグは、body要素が直後にコメントで続かない場合に省略することができます。

上記の例では、head要素の開始および終了タグ、およびbody要素の開始タグは、空白で囲まれているため省略できません: 

<!DOCTYPE HTML>
 <html>
   <head>
     <title>Hello</title>
   </head>
   <body>
     <p>Welcome to this example.</p>
   </body>
 </html>

(bodyおよびhtml要素の終了タグは、問題なく省略することができます。それらの後に空白がある場合、それはbody要素に解析されます。）

ただし、通常は空白は問題になりません。まず気にしない空白を削除します:

<!DOCTYPE HTML><html><head><title>Hello</title></head><body><p>Welcome to this example.</p></body></html>

次に、DOMに影響を与えることなく、いくつかのタグを省略できます:

<!DOCTYPE HTML><title>Hello</title><p>Welcome to this example.</p>

その時点で、いくつかの空白を戻すこともできます:

<!DOCTYPE HTML>
 <title>Hello</title>
 <p>Welcome to this example.</p>

これは、次のように省略されたタグがパーサーによって暗示された位置に表示される文書と同等です。生成される唯一の空白テキストノードは、head要素の最後の改行です:

<!DOCTYPE HTML>
 <html><head><title>Hello</title>
 </head><body><p>Welcome to this example.</p></body></html>

li要素の終了タグは、li要素が直後に別のli要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

dt要素の終了タグは、dt要素が直後に別のdt要素またはdd要素が続く場合に省略することができます。

dd要素の終了タグは、dd要素が直後に別のdd要素またはdt要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

p 要素の終了タグは、p要素の直後に address、article、 aside、blockquote、details、dialog、 div、dl、fieldset、figcaption、 figure、footer、form、 h1、 h2、 h3、 h4、 h5、 h6、 header、 hgroup、hr、main、menu、nav、 ol、p、pre、search、section、 table、またはul要素が続く場合、または親要素にこれ以上コンテンツがなく、親要素がHTML要素であり、 a、audio、del、ins、map、 noscript、またはvideo要素、もしくは独立したカスタム要素ではない場合に省略できます。

これにより、前の例をさらに簡略化できます: 

<!DOCTYPE HTML><title>Hello</title><p>Welcome to this example.

rt要素の終了タグは、rt要素が直後にrtまたはrp要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

rp要素の終了タグは、rp要素が直後にrtまたはrp要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

optgroup要素の終了タグは、optgroup要素が直後に別のoptgroup要素が続く場合、hr要素が直後に続く場合、または親要素にこれ以上内容がない場合に省略することができます。

option要素の終了タグは、option要素が直後に別のoption要素が続く場合、optgroup要素が直後に続く場合、hr要素が直後に続く場合、または親要素にこれ以上内容がない場合に省略することができます。

colgroup要素の開始タグは、colgroup要素の最初の内容がcol要素であり、その要素が直前の別のcolgroup要素で、その終了タグが省略されていない限り省略することができます。（要素が空の場合、省略することはできません。）

colgroup要素の終了タグは、colgroup要素が直後にASCII空白文字またはコメントが続かない場合に省略することができます。

caption要素の終了タグは、caption要素が直後にASCII空白文字またはコメントが続かない場合に省略することができます。

thead要素の終了タグは、thead要素が直後にtbody要素またはtfoot要素が続く場合に省略することができます。

tbody要素の開始タグは、tbody要素の最初の内容がtr要素であり、その要素が直前の別のtbody、thead、またはtfoot要素で、その終了タグが省略されていない限り省略することができます。（要素が空の場合、省略することはできません。）

tbody要素の終了タグは、tbody要素が直後にtbody要素またはtfoot要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

tfoot要素の終了タグは、親要素にこれ以上内容がない場合に省略することができます。

tr要素の終了タグは、tr要素が直後に別のtr要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

td要素の終了タグは、td要素が直後にtdまたはth要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

th要素の終了タグは、th要素が直後にtdまたはth要素が続く場合、または親要素にこれ以上内容がない場合に省略することができます。

これらのテーブル関連のタグをすべて省略できることで、テーブルのマークアップが大幅に簡略化されます。

次の例をご覧ください:

<table>
  <caption>37547 TEE Electric Powered Rail Car Train Functions (Abbreviated)</caption>
  <colgroup><col><col><col></colgroup>
  <thead>
   <tr>
    <th>Function</th>
    <th>Control Unit</th>
    <th>Central Station</th>
   </tr>
  </thead>
  <tbody>
   <tr>
    <td>Headlights</td>
    <td>✔</td>
    <td>✔</td>
   </tr>
   <tr>
    <td>Interior Lights</td>
    <td>✔</td>
    <td>✔</td>
   </tr>
   <tr>
    <td>Electric locomotive operating sounds</td>
    <td>✔</td>
    <td>✔</td>
   </tr>
   <tr>
    <td>Engineer's cab lighting</td>
    <td></td>
    <td>✔</td>
   </tr>
   <tr>
    <td>Station Announcements - Swiss</td>
    <td></td>
    <td>✔</td>
   </tr>
  </tbody>
 </table>

同じテーブルが、いくつかの空白の違いを除けば、次のようにマークアップできます:

<table>
  <caption>37547 TEE Electric Powered Rail Car Train Functions (Abbreviated)
  <colgroup><col><col><col>
  <thead>
   <tr>
    <th>Function
    <th>Control Unit
    <th>Central Station
  <tbody>
   <tr>
    <td>Headlights
    <td>✔
    <td>✔
   <tr>
    <td>Interior Lights
    <td>✔
    <td>✔
   <tr>
    <td>Electric locomotive operating sounds
    <td>✔
    <td>✔
   <tr>
    <td>Engineer's cab lighting
    <td>
    <td>✔
   <tr>
    <td>Station Announcements - Swiss
    <td>
    <td>✔
 </table>

この方法ではセルがはるかに少ないスペースを占有するため、各行を1行にまとめることでさらに簡潔にすることができます:

<table>
  <caption>37547 TEE Electric Powered Rail Car Train Functions (Abbreviated)
  <colgroup><col><col><col>
  <thead>
   <tr> <th>Function                              <th>Control Unit     <th>Central Station
  <tbody>
   <tr> <td>Headlights                            <td>✔                <td>✔
   <tr> <td>Interior Lights                       <td>✔                <td>✔
   <tr> <td>Electric locomotive operating sounds  <td>✔                <td>✔
   <tr> <td>Engineer's cab lighting               <td>                 <td>✔
   <tr> <td>Station Announcements - Swiss         <td>                 <td>✔
 </table>

これらのテーブルのDOMレベルでの唯一の違いは、（いずれの場合も意味的に中立な）空白の正確な位置です。

しかし、開始タグに属性がある場合は、決して省略してはいけません。

すべての空白を削除し、次にすべてのオプションタグを削除した前の例に戻ります:

<!DOCTYPE HTML><title>Hello</title><p>Welcome to this example.

この例でbody要素にclass属性が必要であり、html要素にlang属性が必要な場合、マークアップは次のようになります:

<!DOCTYPE HTML><html lang="en"><title>Hello</title><body class="demo"><p>Welcome to this example.

このセクションでは、文書が適合していること、特に内容モデル違反がないことを前提としています。このセクションで説明した方法で、仕様で説明されている内容モデルに適合しない文書でタグを省略すると、予期しないDOMの違いが生じる可能性があります（これが、内容モデルが設計されている目的の一部です）。

13.1.2.5 内容モデルの制限

歴史的な理由から、特定の要素には、その内容モデルで指定された制限を超えた追加の制限があります。

table要素には、たとえtr要素がこの仕様書で説明されている内容モデルにおいて技術的には許可されていても、tr要素を含めてはなりません。（マークアップ内でtr要素をtableの内部に置くと、実際にはtbody開始タグがその前に暗示されることになります。）

preおよびtextarea要素の開始タグの直後には、単一の改行を置くことができます。これは要素の処理に影響を与えません。要素の内容自体が改行で始まる場合、このオプションの改行は必ず含めなければなりません（そうしないと、内容の先頭にある改行がオプションの改行と見なされ、無視されてしまうためです）。

次の2つのpreブロックは等価です:

<pre>Hello</pre>
<pre>
Hello</pre>
13.1.2.6生のテキスト要素およびエスケープ可能な生のテキスト要素の内容に対する制約

生のテキスト要素およびエスケープ可能な生のテキスト要素内のテキストは、文字列"</"（U+003C LESS-THAN SIGN, U+002F SOLIDUS）に続いて、要素のタグ名と大文字・小文字を区別しないで一致する文字があり、その後にU+0009 CHARACTER TABULATION（タブ）、U+000A LINE FEED（LF）、U+000C FORM FEED（FF）、U+000D CARRIAGE RETURN（CR）、U+0020 SPACE、U+003E GREATER-THAN SIGN（>）、またはU+002F SOLIDUS（/）のいずれかが続くことはできません。

13.1.3テキスト

テキストは、要素、属性値、およびコメント内で許可されています。テキストがどこに配置されるかによって、テキストに何が許可され、何が許可されないかについて追加の制約が課されます。これらの制約は、他のセクションで説明されています。

13.1.3.1改行

改行は、HTMLではU+000D CARRIAGE RETURN（CR）文字、U+000A LINE FEED（LF）文字、またはU+000D CARRIAGE RETURN（CR）とU+000A LINE FEED（LF）文字のペアとして表現されます。

文字参照が許可されている場所では、U+000A LINE FEED（LF）文字の文字参照（ただし、U+000D CARRIAGE RETURN（CR）文字の文字参照は含まれません）もまた改行を表します。

13.1.4文字参照

他のセクションで説明されている特定のケースでは、テキストと文字参照が混在することがあります。これらは、テキストに合法的に含めることができない文字をエスケープするために使用できます。

文字参照は、U+0026 AMPERSAND文字（&）で始まる必要があります。これに続いて、3種類の文字参照が考えられます:

名前付き文字参照
アンパサンドに続いて、名前付き文字参照セクションで示される名前のいずれかを、同じ大文字・小文字で使用する必要があります。名前は、U+003B SEMICOLON文字（;）で終了しなければなりません。
10進数の数値文字参照
アンパサンドに続いて、U+0023 NUMBER SIGN文字（#）、さらに1つ以上のASCII数字が続きます。これにより、以下で定義されるコードポイントに対応する10進数の整数が表されます。数字の後には、U+003B SEMICOLON文字（;）が続かなければなりません。
16進数の数値文字参照
アンパサンドに続いて、U+0023 NUMBER SIGN文字（#）、次にU+0078 LATIN SMALL LETTER X文字（x）またはU+0058 LATIN CAPITAL LETTER X文字（X）が続き、次に1つ以上のASCII 16進数字が続きます。これにより、以下で定義されるコードポイントに対応する16進数の整数が表されます。数字の後には、U+003B SEMICOLON文字（;）が続かなければなりません。

上記で説明した数値文字参照形式は、U+000D CR、非文字、および制御文字以外のいかなるコードポイントも参照することができます。ただし、ASCII空白は除きます。

曖昧なアンパサンドとは、U+0026 AMPERSAND文字（&）に続いて1つ以上のASCII英数字が続き、次にU+003B SEMICOLON文字（;）が続く文字列を指しますが、これらの文字列が名前付き文字参照セクションに示されている名前のいずれにも一致しない場合を指します。

13.1.5 CDATAセクション

CDATAセクションは、次の順序で構成されなければなりません:

  1. 文字列"<![CDATA["。
  2. オプションで、テキスト。ただし、テキストは文字列"]]>"を含んではなりません。
  3. 文字列"]]>"。

CDATAセクションは、外部コンテンツ（MathMLまたはSVG）でのみ使用できます。この例では、CDATAセクションを使用してMathML ms要素の内容をエスケープしています:

<p>文字列を数値に追加できますが、これにより数値が文字列化されます:</p>
             <math>
              <ms><![CDATA[x<y]]></ms>
              <mo>+</mo>
              <mn>3</mn>
              <mo>=</mo>
              <ms><![CDATA[x<y3]]></ms>
             </math>

13.1.6 コメント

コメントは、次の形式でなければなりません:

  1. 文字列"<!--"。
  2. オプションで、テキスト。ただし、テキストは文字列">"で始まってはならず、"->"で始まってはならず、"<!--"、"-->"、"--!>"を含んではならず、"<!-"で終わってはなりません。
  3. 文字列"-->"。

テキストは、文字列"<!"で終わることが許されています。例えば、<!--私の好きな演算子は > と <!-->のように。

13.2 HTML文書の解析

このセクションは、ユーザーエージェント、データマイニングツール、および適合性チェッカーにのみ適用されます。

XML文書をDOMツリーに解析するためのルールは、次のセクション「XML構文」で説明されています。

ユーザーエージェントは、このセクションで説明されている解析ルールを使用して、text/htmlリソースからDOMツリーを生成しなければなりません。これらのルールを総称してHTMLパーサーと呼びます。

この仕様書で説明されているHTML構文は、SGMLやXMLと非常に似ていますが、独自の解析ルールを持つ別の言語です。

HTMLの以前のバージョン（特にHTML2からHTML4）はSGMLに基づいており、SGMLの解析ルールを使用していました。しかし、HTML文書に対して真のSGML解析を実装したウェブブラウザはほとんど（もしあれば）存在せず、HTMLを厳密にSGMLアプリケーションとして扱った唯一のユーザーエージェントは、歴史的にバリデーターのみでした。この結果、バリデーターが文書に対してある表現を主張する一方で、広く展開されているウェブブラウザが別の表現を相互運用的に実装しているという混乱が生じ、生産性が数十年にわたって浪費されてきました。このバージョンのHTMLは、したがって非SGMLベースに戻っています。

適合性チェッカーの目的のために、リソースがHTML構文にあると判断された場合、それはHTML文書です。

用語セクションの記述にあるように、名前空間を明示的に指定していない要素型への参照は常にHTML名前空間内の要素を参照します。たとえば、仕様書が「menu要素」について言及している場合、それはローカル名「menu」、名前空間「http://www.w3.org/1999/xhtml」、およびインターフェースHTMLMenuElementを持つ要素です。可能な場合、これらの要素への参照は定義にハイパーリンクされています。

13.2.1 解析モデルの概要

HTML解析プロセスへの入力は、コードポイントのストリームで構成されており、トークン化段階を経て、ツリー構築段階に渡されます。出力はDocumentオブジェクトです。

スクリプトをサポートしていない実装では、実際にDOMのDocumentオブジェクトを作成する必要はありませんが、そのような場合でもDOMツリーはこの仕様書の他の部分のモデルとして使用されます。

一般的な場合、トークン化段階で処理されるデータはネットワークから取得されますが、スクリプトから取得されることもあります。例えば、document.write()APIを使用する場合などです。

トークン化段階とツリー構築段階には、1セットの状態のみがありますが、ツリー構築段階はリエントラントです。つまり、ツリー構築段階が1つのトークンを処理している間に、トークナイザーが再開され、最初のトークンの処理が完了する前にさらにトークンが生成され処理されることがあります。

次の例では、「script」終了タグトークンを処理している間に、「p」開始タグトークンを処理するためにツリー構築段階が呼び出されます：

...
 <script>
  document.write('<p>');
 </script>
 ...

これらのケースに対処するために、パーサーにはスクリプトネスティングレベルがあり、これは最初にゼロに設定されなければならず、パーサー一時停止フラグがあり、これは最初にfalseに設定されなければなりません。

13.2.2 解析エラー

この仕様書では、HTML文書の解析ルールを定義しており、それが文法的に正しいかどうかにかかわらず適用されます。解析アルゴリズムの特定のポイントは解析エラーとして示されています。解析エラーのエラーハンドリングは明確に定義されています（この仕様書全体で説明されている処理ルール）が、ユーザーエージェントはHTML文書を解析する際に、最初に遭遇した解析エラーで、仕様書に記載されたルールを適用したくない場合、パーサーを中止することができます。

適合性チェッカーは、文書に1つ以上の解析エラー条件が存在する場合、少なくとも1つの解析エラー条件をユーザーに報告しなければならず、文書に解析エラー条件が存在しない場合は解析エラー条件を報告してはなりません。適合性チェッカーは、文書に複数の解析エラー条件が存在する場合、それらを複数報告することができます。

解析エラーはHTMLの文法に関するエラーのみです。解析エラーのチェックに加えて、適合性チェッカーは文書がこの仕様書で説明されている他のすべての適合性要件を遵守しているかどうかも確認します。

一部の解析エラーには、以下の表に示されている専用のコードがあり、適合性チェッカーのレポートで使用する必要があります。

以下の表のエラー説明は規範的ではありません。

コード 説明
abrupt-closing-of-empty-comment

このエラーは、パーサーがU+003E (>)コードポイントで突然閉じられた空のコメントに遭遇した場合に発生します（例：<!-->または<!--->）。パーサーはコメントが正しく閉じられているかのように動作します。

abrupt-doctype-public-identifier

このエラーは、パーサーがDOCTYPEパブリック識別子内でU+003E (>)コードポイントに遭遇した場合に発生します（例：<!DOCTYPE html PUBLIC "foo>）。この場合、DOCTYPEが文書の前文に正しく配置されている場合、パーサーはDocumentをクワークスモードに設定します。

abrupt-doctype-system-identifier

このエラーは、パーサーがDOCTYPEシステム識別子内でU+003E (>)コードポイントに遭遇した場合に発生します（例：<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "foo>）。この場合、DOCTYPEが文書の前文に正しく配置されている場合、パーサーはDocumentをクワークスモードに設定します。

absence-of-digits-in-numeric-character-reference

このエラーは、パーサーが数字を含まない数値文字参照に遭遇した場合に発生します（例：&#qux;）。この場合、パーサーは文字参照を解決しません。

cdata-in-html-content

このエラーは、パーサーが外国コンテンツ（SVGまたはMathML）以外でCDATAセクションに遭遇した場合に発生します。パーサーはそのようなCDATAセクション（先頭の"[CDATA["および末尾の"]]"文字列を含む）をコメントとして扱います。

character-reference-outside-unicode-range

このエラーは、パーサーが有効なUnicode範囲を超えるコードポイントを参照する数値文字参照に遭遇した場合に発生します。パーサーはそのような文字参照をU+FFFD置換文字に解決します。

control-character-in-input-stream

このエラーは、入力ストリームにASCIIの空白文字やU+0000 NULLではない制御コードポイントが含まれている場合に発生します。そのようなコードポイントはそのまま解析され、通常は追加の制限が適用されない限り、DOMにそのまま入り込みます。

control-character-reference

このエラーは、パーサーがASCIIの空白文字またはU+000D復帰が含まれていない制御コードポイントを参照する数値文字参照に遭遇した場合に発生します。パーサーはそのような文字参照をそのまま解決しますが、C1制御参照は数値文字参照終了状態に従って置換されます。

duplicate-attribute

このエラーは、パーサーがタグ内で同じ名前を持つ属性に遭遇した場合に発生します。パーサーはそのような重複した属性を無視します。

end-tag-with-attributes

このエラーは、パーサーが終了タグに属性が含まれている場合に発生します。終了タグ内の属性は無視され、DOMには入り込みません。

end-tag-with-trailing-solidus

このエラーは、パーサーが終了タグにU+002F (/) コードポイントがU+003E (>)閉じるコードポイントの直前に含まれている場合に発生します（例：</div/>）。そのようなタグは通常の終了タグとして扱われます。

eof-before-tag-name

このエラーは、タグ名が期待される場所で入力ストリームの終わりに遭遇した場合に発生します。この場合、パーサーは開始タグ（つまり、<）または終了タグ（つまり、</）の始まりをテキストコンテンツとして扱います。

eof-in-cdata

このエラーは、入力ストリームの終わりにCDATAセクションに遭遇した場合に発生します。パーサーはそのようなCDATAセクションを入力ストリームの終わりの直前で閉じられているかのように扱います。

eof-in-comment

このエラーは、入力ストリームの終わりにコメントに遭遇した場合に発生します。パーサーはそのようなコメントを入力ストリームの終わりの直前で閉じられているかのように扱います。

eof-in-doctype

このエラーは、パーサーがDOCTYPE内で入力ストリームの終わりに到達した場合に発生します。この場合、DOCTYPEが文書の序文として正しく配置されている場合、パーサーはDocumentをクイークスモードに設定します。

eof-in-script-html-comment-like-text

このエラーは、パーサーが入力ストリームの終わりに到達した際に、script要素の内容内でHTMLコメントに似たテキストに遭遇した場合に発生します（例: <script><!-- foo）。

script要素内のHTMLコメントに似た構造はテキストコンテンツとして解析されます。それらはスクリプト言語特有の構文構造の一部であるか、スクリプト言語がそれらをサポートしている場合にHTMLのようなコメントとして扱われることがあります（例：HTMLのようなコメントの解析ルールはJavaScript仕様書の附属書Bに記載されています）。このエラーの一般的な原因は、script要素の内容に関する制限の違反です。[JAVASCRIPT]

eof-in-tag

このエラーは、パーサーが入力ストリームの終わりに到達した際に、開始タグや終了タグ内にいる場合に発生します（例: <div id=）。このようなタグは無視されます。

incorrectly-closed-comment

このエラーは、パーサーが"--!>"コードポイントシーケンスで閉じられたコメントに遭遇した場合に発生します。パーサーはそのようなコメントを"-->"コードポイントシーケンスで正しく閉じられているかのように扱います。

incorrectly-opened-comment

このエラーは、パーサーが"<!"コードポイントシーケンスに遭遇し、それが直後に2つのU+002D (-) コードポイントが続かず、DOCTYPEまたはCDATAセクションの開始でない場合に発生します。"<!"コードポイントシーケンスに続くすべてのコンテンツは、U+003E (>) コードポイント（存在する場合）または入力ストリームの終わりまでコメントとして扱われます。

このエラーの1つの可能な原因は、HTMLでXMLのマークアップ宣言（例：<!ELEMENT br EMPTY>）を使用することです。

invalid-character-sequence-after-doctype-name

このエラーは、パーサーがDOCTYPE名の後に"PUBLIC"や"SYSTEM"キーワード以外のコードポイントシーケンスに遭遇した場合に発生します。この場合、パーサーは以降のパブリックまたはシステム識別子を無視し、DOCTYPEが文書の前文に正しく配置されている場合、パーサーがモードを変更できないフラグがfalseであれば、Documentをクワークスモードに設定します。

invalid-first-character-of-tag-name

このエラーは、パーサーがコードポイントに遭遇し、それがASCIIアルファでない場合、開始タグ名または終了タグ名が期待される位置で発生します。開始タグが期待される場合、そのコードポイントと先行するU+003C (<) はテキストコンテンツとして扱われ、続くすべてのコンテンツがマークアップとして扱われます。一方、終了タグが期待される場合、そのコードポイントと、それに続くすべてのコンテンツがU+003E (>) コードポイント（存在する場合）または入力ストリームの終わりまでコメントとして扱われます。

例えば、次のマークアップを考えてみましょう：

<42></42>

これは次のように解析されます：

タグ名の最初のコードポイントはASCIIアルファに限定されていますが、後続の位置には幅広いコードポイント（ASCII数字を含む）が許可されています。

missing-attribute-value

このエラーは、属性値が期待される場所でU+003E (>)コードポイントに遭遇した場合に発生します（例：<div id=>）。パーサーは属性が空の値を持つかのように扱います。

missing-doctype-name

このエラーは、名前が欠落しているDOCTYPEにパーサーが遭遇した場合に発生します（例：<!DOCTYPE>）。この場合、DOCTYPEが文書の前文に正しく配置されている場合、パーサーはDocumentをクワークスモードに設定します。

missing-doctype-public-identifier

このエラーは、DOCTYPEパブリック識別子の開始が期待される場所でU+003E (>)コードポイントに遭遇した場合に発生します（例：<!DOCTYPE html PUBLIC >）。この場合、DOCTYPEが文書の前文に正しく配置されている場合、パーサーはDocumentをクワークスモードに設定します。

missing-doctype-system-identifier

このエラーは、DOCTYPEシステム識別子の開始が期待される場所でU+003E (>)コードポイントに遭遇した場合に発生します（例：<!DOCTYPE html SYSTEM >）。この場合、DOCTYPEが文書の前文に正しく配置されている場合、パーサーはDocumentをクワークスモードに設定します。

missing-end-tag-name

このエラーは、終了タグ名が期待される場所でU+003E (>)コードポイントに遭遇した場合に発生します（つまり、</>）。パーサーは"</>"コードポイントシーケンス全体を無視します。

missing-quote-before-doctype-public-identifier

このエラーは、パーサーが引用符なしでDOCTYPEパブリック識別子に遭遇した場合に発生します（例：<!DOCTYPE html PUBLIC -//W3C//DTD HTML 4.01//EN">）。この場合、パーサーはパブリック識別子を無視し、DOCTYPEが文書の前文に正しく配置されている場合、Documentをクワークスモードに設定します。

missing-quote-before-doctype-system-identifier

このエラーは、パーサーが引用符なしでDOCTYPEシステム識別子に遭遇した場合に発生します（例：<!DOCTYPE html SYSTEM http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">）。この場合、パーサーはシステム識別子を無視し、DOCTYPEが文書の前文に正しく配置されている場合、Documentをクワークスモードに設定します。

missing-semicolon-after-character-reference

このエラーは、U+003B (;)コードポイントで終了していない文字参照にパーサーが遭遇した場合に発生します。通常、パーサーは文字参照がU+003B (;)コードポイントで終了しているかのように動作しますが、曖昧なケースでは、パーサーが後続のコードポイントを文字参照に含めることがあります。

例えば、&not;inは"¬in"と解析されますが、&notinは"∉"と解析されます。

missing-whitespace-after-doctype-public-keyword

このエラーは、"PUBLIC"キーワードとパブリック識別子がASCIIの空白文字で区切られていないDOCTYPEにパーサーが遭遇した場合に発生します。この場合、パーサーはASCIIの空白文字が存在するかのように動作します。

missing-whitespace-after-doctype-system-keyword

このエラーは、"SYSTEM"キーワードとシステム識別子がASCIIの空白文字で区切られていないDOCTYPEにパーサーが遭遇した場合に発生します。この場合、パーサーはASCIIの空白文字が存在するかのように動作します。

missing-whitespace-before-doctype-name

このエラーは、"DOCTYPE"キーワードと名前がASCIIの空白文字で区切られていないDOCTYPEにパーサーが遭遇した場合に発生します。この場合、パーサーはASCIIの空白文字が存在するかのように動作します。

missing-whitespace-between-attributes

このエラーは、ASCIIの空白文字で区切られていない属性にパーサーが遭遇した場合に発生します（例：<div id="foo"class="bar">）。この場合、パーサーはASCIIの空白文字が存在するかのように動作します。

missing-whitespace-between-doctype-public-and-system-identifiers

このエラーは、パブリック識別子とシステム識別子がASCIIの空白文字で区切られていないDOCTYPEにパーサーが遭遇した場合に発生します。この場合、パーサーはASCIIの空白文字が存在するかのように動作します。

nested-comment

このエラーは、パーサーがネストされたコメントに遭遇した場合に発生します（例：<!-- <!-- nested --> -->）。そのようなコメントは最初に出現する"-->"コードポイントシーケンスで閉じられ、それ以降のすべてがマークアップとして扱われます。

noncharacter-character-reference

このエラーは、非文字を参照する数値文字参照にパーサーが遭遇した場合に発生します。パーサーはそのような文字参照をそのまま解決します。

noncharacter-in-input-stream

このエラーは、入力ストリームに非文字が含まれている場合に発生します。そのようなコードポイントはそのまま解析され、通常は追加の制限が適用されない限り、DOMにそのまま入り込みます。

non-void-html-element-start-tag-with-trailing-solidus

このエラーは、空要素リストに含まれていない要素や外国コンテンツ（SVGやMathML要素ではない）に対して、U+002F (/)コードポイントが閉じるU+003E (>)コードポイントの直前に含まれている開始タグにパーサーが遭遇した場合に発生します。パーサーはU+002F (/)が存在しないかのように動作します。

例えば、次のマークアップを考えてみましょう：

<div/><span></span><span></span>

これは次のように解析されます：

開始タグ名の末尾にU+002F (/)を使用できるのは、自己終了タグを指定するための外国コンテンツ内のみです（HTMLには自己終了タグは存在しません）。空要素には許可されていますが、この場合には効果はありません。

null-character-reference

このエラーは、U+0000 NULLコードポイントを参照する数値文字参照にパーサーが遭遇した場合に発生します。パーサーはそのような文字参照をU+FFFD置換文字に解決します。

surrogate-character-reference

このエラーは、サロゲートを参照する数値文字参照にパーサーが遭遇した場合に発生します。パーサーはそのような文字参照をU+FFFD置換文字に解決します。

surrogate-in-input-stream

このエラーは、入力ストリームにサロゲートが含まれている場合に発生します。そのようなコードポイントはそのまま解析され、通常は追加の制限が適用されない限り、DOMにそのまま入り込みます。

サロゲートは、document.write()のようなスクリプトAPIを介してのみ入力ストリームに入ることができます。

unexpected-character-after-doctype-system-identifier

このエラーは、パーサーがコードポイント以外のASCIIの空白文字または閉じるU+003E (>)コードポイントにDOCTYPEシステム識別子の後に遭遇した場合に発生します。パーサーはこれらのコードポイントを無視します。

unexpected-character-in-attribute-name

このエラーは、属性名内にU+0022 ("), U+0027 ('), またはU+003C (<)コードポイントにパーサーが遭遇した場合に発生します。パーサーはそのようなコードポイントを属性名に含めます。

このエラーを引き起こすコードポイントは通常、別の構文構造の一部であり、属性名の周りのタイプミスの兆候である可能性があります。

例えば、次のマークアップを考えてみましょう：

<div foo<div>

fooの後に忘れられたU+003E (>)コードポイントのため、パーサーはこのマークアップを単一のdiv要素として扱い、"foo<div"属性を持つものとして扱います。

このエラーの別の例として、次のマークアップを考えてみましょう：

<div id'bar'>

属性名と値の間に忘れられたU+003D (=)コードポイントのため、パーサーはこのマークアップをdiv要素として扱い、空の値を持つ"id'bar'"属性を持つものとして扱います。

unexpected-character-in-unquoted-attribute-value

このエラーは、引用符で囲まれていない属性値内にU+0022 ("), U+0027 ('), U+003C (<), U+003D (=), またはU+0060 (`)コードポイントにパーサーが遭遇した場合に発生します。パーサーはそのようなコードポイントを属性値に含めます。

このエラーを引き起こすコードポイントは通常、別の構文構造の一部であり、属性値の周りのタイプミスの兆候である可能性があります。

U+0060 (`)は、このエラーを引き起こすコードポイントのリストに含まれているのは、特定のレガシーユーザーエージェントがこれを引用符として扱うためです。

例えば、次のマークアップを考えてみましょう：

<div foo=b'ar'>

誤って配置されたU+0027 (')コードポイントのため、パーサーは"foo"属性の値を"b'ar'"に設定します。

unexpected-equals-sign-before-attribute-name

このエラーは、属性名の前にU+003D (=)コードポイントにパーサーが遭遇した場合に発生します。この場合、パーサーはU+003D (=)を属性名の最初のコードポイントとして扱います。

このエラーの一般的な原因は、属性名の忘れです。

例えば、次のマークアップを考えてみましょう：

<div foo="bar" ="baz">

属性名を忘れたため、パーサーはこのマークアップをdiv要素として扱い、"foo"属性に"bar"値を持ち、"="baz""属性に空の値を持つものとして扱います。

unexpected-null-character

このエラーは、特定の位置で入力ストリームにU+0000 NULLコードポイントにパーサーが遭遇した場合に発生します。一般的に、そのようなコードポイントは無視されるか、セキュリティ上の理由からU+FFFD置換文字に置き換えられます。

unexpected-question-mark-instead-of-tag-name

このエラーは、タグ名の最初のコードポイントが期待される場所でU+003F (?)コードポイントにパーサーが遭遇した場合に発生します。U+003F (?)とそれに続くすべてのコンテンツは、U+003E (>)コードポイント（存在する場合）または入力ストリームの終わりまでコメントとして扱われます。

例えば、次のマークアップを考えてみましょう：

<?xml-stylesheet type="text/css" href="style.css"?>

これは次のように解析されます：

このエラーの一般的な原因は、HTMLで使用されているXML処理命令（例：<?xml-stylesheet type="text/css" href="style.css"?>）またはXML宣言（例：<?xml version="1.0" encoding="UTF-8"?>）です。

unexpected-solidus-in-tag

このエラーは、タグ内で引用符で囲まれていない属性値の一部ではなく、閉じるU+003E (>)コードポイントの直前にU+002F (/)がない場合にパーサーが遭遇した場合に発生します（例：<div / id="foo">）。この場合、パーサーはASCIIの空白文字に遭遇したかのように動作します。

unknown-named-character-reference

このエラーは、パーサーが曖昧なアンパサンドに遭遇した場合に発生します。この場合、パーサーは文字参照を解決しません。

13.2.3 入力バイトストリーム

トークン化段階への入力を構成するコードポイントのストリームは、最初はユーザーエージェントによってバイトのストリーム（通常はネットワーク経由またはローカルファイルシステムから来る）として認識されます。これらのバイトは特定の文字エンコーディングに従って実際の文字をエンコードしており、ユーザーエージェントはこれを使用してバイトを文字にデコードします。

XML文書に対して、ユーザーエージェントが使用することを求められる文字エンコーディングを決定するアルゴリズムはXMLによって定義されています。このセクションはXML文書には適用されません。[XML]

通常、以下に定義されているエンコーディング検出アルゴリズムが文字エンコーディングを決定するために使用されます。

特定の文字エンコーディングが決定された場合、入力バイトストリーム内のバイトは、入力ストリームとしてトークナイザーに渡される文字に変換されなければなりません。これは、入力バイトストリームと文字エンコーディングをdecodeに渡すことで行います。

先頭のバイト順マーク（BOM）がある場合、文字エンコーディング引数は無視され、BOM自体はスキップされます。

元のバイトストリーム内のバイトやバイトシーケンスがエンコーディング標準に準拠していない場合（例：UTF-8入力バイトストリーム内の無効なUTF-8バイトシーケンス）、適合性チェッカーが報告することが期待されるエラーです。[ENCODING]

デコーダーアルゴリズムは無効な入力をどのように処理するかを説明しています。セキュリティ上の理由から、これらのルールを正確に守ることが不可欠です。無効なバイトシーケンスの処理方法に違いがあると、スクリプトインジェクションの脆弱性（「XSS」など）などの問題が発生する可能性があります。

HTMLパーサーが入力バイトストリームをデコードする際には、文字エンコーディングと確信度を使用します。確信度は暫定的、確実、または無関係のいずれかです。使用されたエンコーディングと、そのエンコーディングに対する確信度が暫定的または確実であるかどうかは、パース中に使用され、エンコーディングを変更するかどうかを決定します。エンコーディングが不要な場合、たとえば、パーサーがUnicodeストリームで動作しており、文字エンコーディングをまったく使用する必要がない場合、確信度は無関係です。

一部のアルゴリズムは、入力バイトストリームにバイトを追加するのではなく、直接入力ストリームに文字を追加することでパーサーにフィードします。

13.2.3.1 既知の文字エンコーディングでのパース

HTMLパーサーが既知の確定エンコーディングを持つ入力バイトストリームで動作する場合、文字エンコーディングはそのエンコーディングであり、確信度は確実です。

13.2.3.2 文字エンコーディングの決定

場合によっては、文書をパースする前にエンコーディングを明確に決定することが現実的でないことがあります。このため、この仕様はオプションのプリスキャンを伴う2パスのメカニズムを提供しています。実装は、以下に示すように、文書のパースを開始する前に、利用可能なバイトに対して簡略化されたパースアルゴリズムを適用することが許可されています。そして、実際のパーサーは、このプリパースおよび他の外部メタデータから導き出された暫定的なエンコーディングを使用して開始されます。文書がロードされている間に、ユーザーエージェントがこの情報と矛盾する文字エンコーディング宣言を発見した場合、パーサーは再度呼び出され、実際のエンコーディングで文書をパースすることができます。

ユーザーエージェントは、最初のパスで文書をデコードする際に使用する文字エンコーディングを決定するために、次のアルゴリズム、エンコーディング検出アルゴリズムを使用しなければなりません。このアルゴリズムは、ユーザーエージェントが利用可能な外部メタデータ（例えば、文書のContent-Typeメタデータ）とこれまでに利用可能なすべてのバイトを入力とし、文字エンコーディングと暫定的または確実のいずれかの確信度を返します。

  1. BOM検出の結果がエンコーディングである場合、そのエンコーディングと確実な確信度を返します。

    デコードアルゴリズムは、バイトオーダーマークの存在に基づいてエンコーディングを変更しますが、このアルゴリズムもBOMを検出して、正しい文書の文字エンコーディングと確信度を設定します。

  2. ユーザーが特定のエンコーディングで文書の文字エンコーディングを上書きするようにユーザーエージェントに明示的に指示した場合、そのエンコーディングと確実な確信度を返します。

    通常、ユーザーエージェントはセッションをまたいでこのようなユーザーの要求を記憶し、場合によってはiframe内の文書にも適用します。

  3. ユーザーエージェントは、この手順またはこのアルゴリズムのいかなる後続のステップでも、リソースのより多くのバイトが利用可能になるのを待つことができます。例えば、ユーザーエージェントは500msまたは1024バイトのどちらか早い方を待つことができます。一般的に、ソースを事前にパースしてエンコーディングを見つけることは、パース時にエンコーディング情報を見つけた際にデータ構造を破棄する必要性が減るため、パフォーマンスを向上させます。しかし、ユーザーエージェントがエンコーディングを決定するためにデータを取得するのを長く待ちすぎると、事前解析によるパフォーマンス向上よりも遅延のコストが上回る可能性があります。

    文字エンコーディング宣言の著者適合性要件により、これらは最初の1024バイト以内にのみ現れるよう制限されています。したがって、ユーザーエージェントは、最初の1024バイトに対して以下のように呼び出されるプリスキャンアルゴリズムを使用することが奨励されますが、それ以上の遅延は避けるべきです。

  4. トランスポート層が文字エンコーディングを指定しており、それがサポートされている場合、そのエンコーディングと確実な確信度を返します。

  5. オプションで、バイトストリームをプリスキャンしてエンコーディングを決定することができますが、その終了条件は、ユーザーエージェントがこれ以上のバイトをスキャンすることが効率的でないと判断したときです。ユーザーエージェントは最初の1024バイトだけをプリスキャンすることが奨励されます。ユーザーエージェントは、どのバイトもスキャンすることが効率的でないと判断することができ、その場合、これらのサブステップは完全にスキップされます。

    前述のアルゴリズムは、文字エンコーディングまたは失敗を返します。文字エンコーディングを返した場合、そのエンコーディングと暫定的な確信度を返します。

  6. このアルゴリズムが実行されているHTMLパーサーが、非nullのコンテナドキュメントを持つDocument dに関連付けられている場合:

    1. parentDocumentをdのコンテナドキュメントとします。

    2. もしparentDocumentのオリジンがdのオリジンと同じオリジンであり、かつparentDocumentの文字エンコーディングがUTF-16BE/LEでない場合、parentDocumentの文字エンコーディングを返し、確信度は暫定的です。

  7. それ以外の場合、ユーザーエージェントがこのページのエンコーディングに関する情報を持っている場合（例えば、最後に訪問したときのページのエンコーディングに基づいて）、そのエンコーディングを返し、確信度は暫定的です。

  8. ユーザーエージェントは、頻度分析や他のアルゴリズムを適用してデータストリームから文字エンコーディングを自動検出することを試みることができます。このようなアルゴリズムは、リソースの内容以外の情報（リソースのアドレスなど）を使用することがあります。自動検出が文字エンコーディングを特定することに成功し、そのエンコーディングがサポートされているエンコーディングである場合、そのエンコーディングを返し、確信度は暫定的です。[UNIVCHARDET]

    ユーザーエージェントは、リソースのエンコーディングを自動検出することを一般的に避けることが推奨されています。特にHTML文書のプレアンブルに基づいてエンコーディングを検出することは非常に難しいです。なぜなら、HTMLマークアップは通常、ASCII文字のみを使用し、HTML文書はテキストコンテンツよりもマークアップで始まることが多いからです。

    UTF-8エンコーディングは非常に検出可能なビットパターンを持っています。ローカルファイルシステムからのファイルに、値が0x7Fを超えるバイトが含まれていて、それがUTF-8パターンと一致する場合、それらは非常に高い確率でUTF-8です。一方、UTF-8パターンと一致しないバイトシーケンスを持つ文書は、非常に高い確率でUTF-8ではありません。ユーザーエージェントがプレアンブルだけでなくファイル全体を調べることができる場合、特にUTF-8を検出することが非常に効果的です。[PPUTF8][UTF8DET]

  9. それ以外の場合、実装依存またはユーザーが指定したデフォルト文字エンコーディングを返し、確信度は暫定的です。

    管理された環境や文書のエンコーディングを規定できる環境（例：新しいネットワークでの専用使用を目的としたユーザーエージェント）では、包括的なUTF-8エンコーディングが推奨されます。

    その他の環境では、デフォルトのエンコーディングは通常、ユーザーのロケールに依存します（つまり、ユーザーが頻繁に利用する可能性の高いページの言語、したがってエンコーディングの近似）。次の表は、レガシーコンテンツとの互換性のために、ユーザーのロケールに基づく推奨デフォルトを示しています。ロケールはBCP 47言語タグで識別されます。[BCP47] [ENCODING]

    ロケール言語 推奨デフォルトエンコーディング
    ar アラビア語 windows-1256
    az アゼルバイジャン語 windows-1254
    ba バシキール語 windows-1251
    be ベラルーシ語 windows-1251
    bg ブルガリア語 windows-1251
    cs チェコ語 windows-1250
    el ギリシャ語 ISO-8859-7
    et エストニア語 windows-1257
    fa ペルシャ語 windows-1256
    he ヘブライ語 windows-1255
    hr クロアチア語 windows-1250
    hu ハンガリー語 ISO-8859-2
    ja 日本語 Shift_JIS
    kk カザフ語 windows-1251
    ko 韓国語 EUC-KR
    ku クルド語 windows-1254
    ky キルギス語 windows-1251
    lt リトアニア語 windows-1257
    lv ラトビア語 windows-1257
    mk マケドニア語 windows-1251
    pl ポーランド語 ISO-8859-2
    ru ロシア語 windows-1251
    sah ヤクート語 windows-1251
    sk スロバキア語 windows-1250
    sl スロベニア語 ISO-8859-2
    sr セルビア語 windows-1251
    tg タジク語 windows-1251
    th タイ語 windows-874
    tr トルコ語 windows-1254
    tt タタール語 windows-1251
    uk ウクライナ語 windows-1251
    vi ベトナム語 windows-1258
    zh-Hans, zh-CN, zh-SG 中国語（簡体字） GBK
    zh-Hant, zh-HK, zh-MO, zh-TW 中国語（繁体字） Big5
    その他のすべてのロケール windows-1252

    この表の内容は、Windows、Chrome、Firefoxのデフォルトの交差点から導出されています。

文書の文字エンコーディングは、このアルゴリズムから返された値に即座に設定されなければならず、ユーザーエージェントが入力バイトストリームに使用するデコーダーを選択するために返された値を使用するのと同時に行われます。

アルゴリズムがユーザーエージェントに対して、特定のend conditionを与えられた状態で、バイトストリームの事前スキャンを行い、エンコーディングを決定するように要求する場合、次の手順を実行する必要があります。これらの手順のいずれかの時点で（以下の手順で呼び出される属性を取得するアルゴリズムのインスタンスも含む）、ユーザーエージェントがバイトを使い果たした場合（以下の最初の手順で作成されたpositionポインタがこれまでに取得されたバイトストリームの末尾を超えた場合）またはend conditionに到達した場合は、バイトストリームの事前スキャンを行い、エンコーディングを決定するアルゴリズムを中止し、XMLエンコーディングを取得するを適用した結果を返します。同じバイトに適用されたバイトストリームの事前スキャンを行い、エンコーディングを決定するアルゴリズムが適用された場合です。そうでない場合、これらの手順は文字エンコーディングを返します。

  1. positionを入力バイトストリーム内のバイトへのポインタとし、最初は最初のバイトを指すようにします。

  2. UTF-16 XML宣言の事前スキャンを行います。positionが次の値を指している場合:

    次の値で始まるバイト列: 0x3C, 0x0, 0x3F, 0x0, 0x78, 0x0 (ケースセンシティブなUTF-16リトルエンディアン '<?x')

    UTF-16LEを返します。

    次の値で始まるバイト列: 0x0, 0x3C, 0x0, 0x3F, 0x0, 0x78 (ケースセンシティブなUTF-16ビッグエンディアン '<?x')

    UTF-16BEを返します。

    歴史的な理由から、このプレフィックスはXMLの付録Fよりも2バイト長く、エンコーディング名はチェックされません。

  3. ループ: positionが次の値を指している場合:

    次の値で始まるバイト列: 0x3C 0x21 0x2D 0x2D (`<!--`)

    positionポインタを進め、最初の0x3Eバイトを指すようにします。このバイトは、2つの0x2Dバイト（ASCIIの'-->'シーケンスの終わりに対応）に続き、見つかった0x3Cバイトの後に来ます。（2つの0x2Dバイトは'<!--'シーケンスのものと同じでもかまいません。）

    次の値で始まるバイト列: 0x3C, 0x4Dまたは0x6D, 0x45または0x65, 0x54または0x74, 0x41または0x61、および0x09, 0x0A, 0x0C, 0x0D, 0x20, 0x2Fのいずれか（ケースインセンシティブなASCII '<meta'、スペースまたはスラッシュに続く）

    1. positionポインタを進め、次の0x09, 0x0A, 0x0C, 0x0D, 0x20, または0x2Fバイトを指すようにします（上記で一致した文字のシーケンス内のもの）。

    2. attribute listを空の文字列リストとします。

    3. got pragmaをfalseに設定します。

    4. need pragmaをnullに設定します。

    5. charsetをnull値に設定します（このアルゴリズムの目的では、認識されないエンコーディングや空の文字列とは異なるものとします）。

    6. 属性: 属性を取得するとその値を取得します。属性がスニッフされなかった場合、以下の処理ステップにジャンプします。

    7. 属性名がすでにattribute listにある場合、属性ラベルの手順に戻ります。

    8. 属性名をattribute listに追加します。

    9. 次のリストから該当する手順を実行します:

      属性名が"http-equiv"の場合

      属性の値が"content-type"であれば、got pragmaをtrueに設定します。

      属性名が"content"の場合

      属性の値を解析する文字列として与え、meta要素から文字エンコーディングを抽出するためのアルゴリズムを適用します。エンコーディングが返された場合、charsetが依然としてnullに設定されている場合は、返されたエンコーディングをcharsetに設定し、need pragmaをtrueに設定します。

      属性名が"charset"の場合

      charsetを、属性値からエンコーディングを取得する結果に設定し、need pragmaをfalseに設定します。

    10. 属性ラベルの手順に戻ります。

    11. 処理: need pragmaがnullであれば、以下の次のバイトラベルの手順にジャンプします。

    12. need pragmaがtrueで、got pragmaがfalseであれば、以下の次のバイトラベルの手順にジャンプします。

    13. charsetが失敗の場合、以下の次のバイトラベルの手順にジャンプします。

    14. charsetがUTF-16BE/LEである場合、charsetをUTF-8に設定します。

    15. charsetがx-user-definedである場合、charsetをwindows-1252に設定します。

    16. charsetを返します。

    次の値で始まるバイト列: 0x3Cバイト (<), 任意の0x2Fバイト (/), および最終的に0x41-0x5Aまたは0x61-0x7Aの範囲内のバイト (A-Zまたはa-z)

    1. positionポインタを進め、次の0x09 (HT), 0x0A (LF), 0x0C (FF), 0x0D (CR), 0x20 (SP), または0x3E (>) バイトを指すようにします。

    2. 繰り返し属性を取得するを実行し、さらに属性を取得できなくなるまで繰り返し、次に以下の次のバイトラベルの手順にジャンプします。

    次の値で始まるバイト列: 0x3C 0x21 (`<!`)
    次の値で始まるバイト列: 0x3C 0x2F (`</`)
    次の値で始まるバイト列: 0x3C 0x3F (`<?`)

    発見された0x3Cバイトの後に来る最初の0x3Eバイト（>）を指すようにpositionポインタを進めます。

    その他のバイト

    そのバイトに対して何も行いません。

  4. 次のバイト: positionを入力バイトストリームの次のバイトを指すように移動し、ループラベルの手順に戻ります。

バイトストリームの事前スキャンを行い、エンコーディングを決定するアルゴリズムが属性を取得すると言う場合、それは次の手順を実行することを意味します:

  1. positionのバイトが0x09 (HT), 0x0A (LF), 0x0C (FF), 0x0D (CR), 0x20 (SP), または0x2F (/)のいずれかである場合、positionを次のバイトに進め、この手順を再実行します。

  2. positionのバイトが0x3E (>)である場合、属性を取得するアルゴリズムを中止します。属性は存在しません。

  3. それ以外の場合、positionのバイトは属性名の開始です。attribute nameとattribute valueを空の文字列とします。

  4. positionのバイトを次のように処理します:

    それが0x3D (=)であり、attribute nameが空の文字列よりも長い場合
    positionを次のバイトに進め、以下の値ラベルの手順にジャンプします。
    それが0x09 (HT), 0x0A (LF), 0x0C (FF), 0x0D (CR), または0x20 (SP)の場合
    スペースラベルの手順にジャンプします。
    それが0x2F (/) または0x3E (>)の場合
    属性を取得するアルゴリズムを中止します。属性の名前はattribute nameの値であり、その値は空の文字列です。
    それが0x41 (A)から0x5A (Z)の範囲内の場合
    b+0x20のコードポイントをattribute nameに追加します（ここでbはpositionのバイトの値です）。（これにより入力が小文字に変換されます。）
    その他の場合
    positionのバイトの値と同じ値を持つコードポイントをattribute nameに追加します。（ここで、ASCII範囲外のバイトがどのように処理されるかは実際には関係ありません。文字エンコーディングの検出に寄与できるのはASCIIバイトだけだからです。）

  5. positionを次のバイトに進め、前の手順に戻ります。

  6. スペース: positionのバイトが0x09 (HT), 0x0A (LF), 0x0C (FF), 0x0D (CR), または0x20 (SP)のいずれかである場合、positionを次のバイトに進め、この手順を再実行します。

  7. positionのバイトが0x3D (=)でない場合、属性を取得するアルゴリズムを中止します。属性名はattribute nameの値であり、その値は空の文字列です。

  8. positionを0x3D (=) バイトの先に進めます。

  9. 値: positionのバイトが0x09 (HT), 0x0A (LF), 0x0C (FF), 0x0D (CR), または0x20 (SP)のいずれかである場合、positionを次のバイトに進め、この手順を再実行します。

  10. positionのバイトを次のように処理します:

    それが0x22 (")または0x27 (')の場合
    1. bをpositionのバイトの値とします。
    2. 引用ループ: positionを次のバイトに進めます。
    3. positionのバイトの値がbの値である場合、positionを次のバイトに進め、"属性を取得"アルゴリズムを中止します。属性名はattribute nameの値であり、その値はattribute valueの値です。
    4. それ以外の場合、positionのバイトの値が0x41 (A)から0x5A (Z)の範囲内である場合、attribute valueにpositionのバイトの値より20高い値を持つコードポイントを追加します。
    5. それ以外の場合、attribute valueにpositionのバイトの値と同じ値を持つコードポイントを追加します。
    6. 引用ループラベルの手順に戻ります。
    それが0x3E (>)の場合
    属性を取得するアルゴリズムを中止します。属性名はattribute nameの値であり、その値は空の文字列です。
    それが0x41 (A)から0x5A (Z)の範囲内の場合
    b+0x20のコードポイントをattribute valueに追加します（ここでbはpositionのバイトの値です）。positionを次のバイトに進めます。
    その他の場合
    positionのバイトの値と同じ値を持つコードポイントをattribute valueに追加します。positionを次のバイトに進めます。

  11. positionのバイトを次のように処理します:

    それが0x09 (HT), 0x0A (LF), 0x0C (FF), 0x0D (CR), 0x20 (SP), または0x3E (>)の場合
    属性を取得するアルゴリズムを中止します。属性名はattribute nameの値であり、その値はattribute valueの値です。
    それが0x41 (A)から0x5A (Z)の範囲内の場合
    b+0x20のコードポイントをattribute valueに追加します（ここでbはpositionのバイトの値です）。
    その他の場合
    positionのバイトの値と同じ値を持つコードポイントをattribute valueに追加します。

  12. positionを次のバイトに進め、前の手順に戻ります。

バイトストリームの事前スキャンを行い、エンコーディングを決定するアルゴリズムがエンコーディングを返さずに中止された場合、XMLエンコーディングを取得するとは次の手順を実行することを意味します。

既存のコンテンツとの互換性を保つために、text/htmlでもXML宣言に似た構文を探す必要があります。

  1. encodingPositionをストリームの開始位置へのポインタとします。

  2. encodingPositionがバイトシーケンス0x3C, 0x3F, 0x78, 0x6D, 0x6C (`<?xml`)の開始を指していない場合、失敗を返します。

  3. xml宣言終了を入力バイトストリーム内の次のバイト0x3E (>)へのポインタとします。もしそのようなバイトが存在しない場合、失敗を返します。

  4. encodingPositionを、現在のencodingPosition以降でバイトシーケンス0x65, 0x6E, 0x63, 0x6F, 0x64, 0x69, 0x6E, 0x67 (`encoding`)の最初の出現箇所に設定します。そのようなシーケンスが存在しない場合、失敗を返します。

  5. encodingPositionを0x67 (g) バイトの後に進めます。

  6. encodingPositionのバイトが0x20以下である間（つまり、ASCIIスペースまたは制御文字である間）、encodingPositionを次のバイトに進めます。

  7. encodingPositionのバイトが0x3D (=)でない場合、失敗を返します。

  8. encodingPositionを次のバイトに進めます。

  9. encodingPositionのバイトが0x20以下である間（つまり、ASCIIスペースまたは制御文字である間）、encodingPositionを次のバイトに進めます。

  10. quoteMarkをencodingPositionのバイトとします。

  11. quoteMarkが0x22 (")または0x27 (')でない場合、失敗を返します。

  12. encodingPositionを次のバイトに進めます。

  13. quoteMarkがencodingPosition以降に再び出現しない場合、失敗を返します。

  14. potentialEncodingをencodingPosition（含む）からencodingEndPosition（含まない）までのバイトシーケンスとします。

  15. potentialEncodingに0x20以下の値を持つバイトが1つ以上含まれている場合、失敗を返します。

  16. encodingをエンコーディングを取得するの結果とし、potentialEncodingを与えます等価デコードされた。

  17. encodingがUTF-16BE/LEである場合、それをUTF-8に変更します。

  18. encodingを返します。

相互運用性の観点から、上記のものとは異なる結果を返す事前スキャンアルゴリズムを使用すべきではありません。（ただし、もしそうする場合は、少なくとも私たちにお知らせください。このアルゴリズムを改善し、全員が恩恵を受けられるようにします...）

13.2.3.3 文字エンコーディング

ユーザーエージェントは、エンコーディングで定義されているエンコーディング、特に次のものをサポートする必要があります： UTF-8、 ISO-8859-2、 ISO-8859-7、 ISO-8859-8、 windows-874、 windows-1250、 windows-1251、 windows-1252、 windows-1254、 windows-1255、 windows-1256、 windows-1257、 windows-1258、 GBK、 Big5、 ISO-2022-JP、 Shift_JIS、 EUC-KR、 UTF-16BE、 UTF-16LE、 UTF-16BE/LE、 x-user-defined。 ユーザーエージェントは、他のエンコーディングをサポートしてはなりません。

上記は、例えば、CESU-8、UTF-7、BOCU-1、SCSU、EBCDIC、UTF-32 のサポートを禁止します。この仕様は、禁止されたエンコーディングをサポートすることを試みておらず、そのアルゴリズムでは使用されないため、禁止されたエンコーディングのサポートと使用は予期しない動作につながる可能性があります。 [CESU8] [UTF7] [BOCU1] [SCSU]

13.2.3.4 解析中のエンコーディングの変更

パーサーがユーザーエージェントにエンコーディングを変更することを要求した場合、次のステップを実行する必要があります。これは、上記のエンコーディングスニッフィングアルゴリズムが文字エンコーディングを見つけることに失敗した場合、またはファイルの実際のエンコーディングではない文字エンコーディングを見つけた場合に発生する可能性があります。

  1. 入力ストリームを解釈するために既に使用されているエンコーディングがUTF-16BE/LEである場合、信頼度を確実に設定し、リターンします。新しいエンコーディングは無視されます。それが同じエンコーディングでなかった場合、それは明らかに不正確です。

  2. 新しいエンコーディングがUTF-16BE/LEである場合、それをUTF-8に変更します。

  3. 新しいエンコーディングがx-user-definedである場合、それをwindows-1252に変更します。

  4. 新しいエンコーディングが既に使用されているエンコーディングと同一または同等である場合、信頼度を確実に設定し、リターンします。 これは、ファイルに見つかったエンコーディング情報がエンコーディングスニッフィングアルゴリズムによって決定されたエンコーディングと一致する場合、および前のパスで、上記のセクションで説明したエンコーディングスニッフィングアルゴリズムが正しいエンコーディングを見つけることに失敗した場合に、パーサーの2回目のパスで発生します。

  5. 現在のデコーダーによって変換された最後のバイトまでのすべてのバイトが、現在のエンコーディングと新しいエンコーディングの両方で同じUnicode解釈を持ち、ユーザーエージェントがフライでコンバータを変更することをサポートしている場合、ユーザーエージェントはその場で新しいエンコーディングに切り替えることができます。文書の文字エンコーディングと入力ストリームを変換するために使用されるエンコーディングを新しいエンコーディングに設定し、信頼度を確実に設定し、リターンします。

  6. それ以外の場合、ナビゲートアルゴリズムを再起動します。履歴処理を「置き換え」に設定し、他の入力を同じままにしますが、この場合はエンコーディングスニッフィングアルゴリズムをスキップし、代わりに新しいエンコーディングと信頼度を確実に設定します。可能な限り、ネットワーク層に実際に接触せずにこれを行うべきです（ドキュメントがキャッシュ可能でないとマークされている場合でも、バイトはメモリから再解析されるべきです）。もしこれが不可能で、ネットワーク層に接触することが、GET以外のメソッドを使用するリクエストを繰り返すことを伴う場合は、代わりに信頼度を確実に設定し、新しいエンコーディングを無視します。リソースは誤って解釈されます。ユーザーエージェントは、アプリケーション開発の支援のために状況をユーザーに通知することができます。

このアルゴリズムは、meta要素で新しいエンコーディングが宣言された場合にのみ呼び出されます。

13.2.3.5 入力ストリームの前処理

入力ストリームは、入力バイトストリームがデコードされる際にそれにプッシュされる文字や、入力ストリームを直接操作するさまざまなAPIから構成されます。

サロゲートが出現した場合、それはサロゲート-in-入力ストリームの構文エラーとなります。非文字が出現した場合、それは非文字-in-入力ストリームの構文エラーとなり、制御文字（ASCII空白文字およびU+0000 NULL文字以外）は、制御文字-in-入力ストリームの構文エラーとなります。

U+0000 NULL文字の処理は、文字が見つかる場所に応じて異なり、解析の後の段階で行われます。これらの文字は無視されるか、セキュリティ上の理由でU+FFFD REPLACEMENT CHARACTERに置き換えられます。この処理は必然的に、トークナイズ段階とツリー構築段階の両方にまたがって行われます。

トークナイズ段階の前に、入力ストリームは改行の正規化を行って前処理されなければなりません。したがって、HTML DOM内の改行はU+000A LF文字で表され、トークナイズ段階に入力される際にU+000D CR文字は存在しません。

次の入力文字は、まだ消費されていないか、このセクションの要件によって明示的に無視されていない入力ストリームの最初の文字です。最初は、次の入力文字は入力の最初の文字です。現在の入力文字は最後に消費された文字です。

挿入ポイントは、document.write()を使用してコンテンツが実際に挿入される位置（文字の直前または入力ストリームの終わりの直前）です。挿入ポイントは、直後の文字の位置に対して相対的であり、入力ストリームへの絶対的なオフセットではありません。最初は、挿入ポイントは未定義です。

以下のテーブルにある「EOF」文字は、入力ストリームの終わりを表す概念的な文字です。パーサーがスクリプトによって作成されたパーサーである場合、document.close()メソッドによって「EOF」文字が明示的に挿入され、それが消費されたときに入力ストリームの終わりに達します。それ以外の場合、「EOF」文字はストリーム内の実際の文字ではなく、単にさらに文字がないことを示します。

13.2.4 パース状態

13.2.4.1 挿入モード

挿入モードは、ツリー構築段階の主な操作を制御する状態変数です。

初めは、挿入モードは"初期"です。パースの過程で"htmlの前"、"headの前"、"head内"、"head内noscript"、"head後"、"body内"、"テキスト"、"テーブル内"、"テーブル内テキスト"、"キャプション内"、"カラムグループ内"、"テーブルボディ内"、"行内"、"セル内"、"選択内"、"テーブル内選択"、"テンプレート内"、"body後"、"フレームセット内"、"フレームセット後"、"body後後"、および"フレームセット後後"に変更されます。挿入モードはトークンが処理される方法やCDATAセクションがサポートされるかどうかに影響を与えます。

これらのモードのうち、"head内"、"body内"、"テーブル内"、および"選択内"は特別であり、他のモードがさまざまな時点でそれらに従います。以下のアルゴリズムで、ユーザーエージェントが「あるモードのルールを使用して」何かを行うべきと指示された場合、そのmモードが何であれ、ユーザーエージェントはmモードのセクションに記載されているルールを使用しなければなりませんが、mモード自体のルールがmモードを新しい値に変更しない限り、挿入モードは変更してはなりません。

挿入モードが"テキスト"または"テーブル内テキスト"に切り替えられるとき、元の挿入モードも設定されます。これは、ツリー構築段階が戻る挿入モードです。

同様に、ネストされたテンプレート要素をパースするために、テンプレート挿入モードのスタックが使用されます。これは最初は空です。現在のテンプレート挿入モードは、テンプレート挿入モードのスタックに最近追加された挿入モードです。以下のセクションに記載されたアルゴリズムは、挿入モードをこのスタックにプッシュする、つまり指定された挿入モードをスタックに追加することを意味し、挿入モードをスタックからポップする、つまり最も最近追加された挿入モードをスタックから削除することを意味します。

以下のステップがUAに挿入モードを適切にリセットすることを要求する場合、それはUAが以下のステップを実行しなければならないことを意味します:

  1. lastをfalseに設定します。

  2. nodeをオープン要素のスタックの最後のノードに設定します。

  3. ループ: nodeがオープン要素のスタックの最初のノードである場合、lastをtrueに設定し、パーサーがHTMLフラグメントパースアルゴリズム（フラグメントケース）の一部として作成された場合、nodeをそのアルゴリズムに渡されたcontext要素に設定します。

  4. nodeがselect要素である場合、次のサブステップを実行します:

    1. lastがtrueである場合、以下の終了とラベル付けされたステップに進みます。

    2. ancestorをnodeに設定します。

    3. ループ: ancestorがオープン要素のスタックの最初のノードである場合、以下の終了とラベル付けされたステップに進みます。

    4. ancestorをオープン要素のスタック内のancestorの前のノードに設定します。

    5. ancestorがtemplateノードである場合、以下の終了とラベル付けされたステップに進みます。

    6. ancestorがtableノードである場合、挿入モードを"テーブル内選択"に切り替え、戻ります。

    7. ループのステップに戻ります。

    8. 終了: 挿入モードを"選択内"に切り替え、戻ります。

  5. nodeがtdまたはth要素であり、lastがfalseである場合、挿入モードを"セル内"に切り替え、戻ります。

  6. nodeがtr要素である場合、挿入モードを"行内"に切り替え、戻ります。

  7. nodeがtbody、thead、またはtfoot要素である場合、挿入モードを"テーブルボディ内"に切り替え、戻ります。

  8. nodeがcaption要素である場合、挿入モードを"キャプション内"に切り替え、戻ります。

  9. nodeがcolgroup要素である場合、挿入モードを"カラムグループ内"に切り替え、戻ります。

  10. nodeがtable要素である場合、挿入モードを"テーブル内"に切り替え、戻ります。

  11. nodeがtemplate要素である場合、挿入モードを現在のテンプレート挿入モードに切り替え、戻ります。

  12. nodeがhead要素であり、lastがfalseである場合、挿入モードを"head内"に切り替え、戻ります。

  13. nodeがbody要素である場合、挿入モードを"body内"に切り替え、戻ります。

  14. nodeがframeset要素である場合、挿入モードを"フレームセット内"に切り替え、戻ります。 (フラグメントケース)

  15. nodeがhtml要素である場合、次のサブステップを実行します:

    1. head要素ポインタがnullである場合、挿入モードを"headの前"に切り替え、戻ります。 (フラグメントケース)

    2. それ以外の場合、head要素ポインタがnullでない場合、挿入モードを"head後"に切り替え、戻ります。

  16. lastがtrueである場合、挿入モードを"body内"に切り替え、戻ります。 (フラグメントケース)

  17. 今、nodeをオープン要素のスタック内のnodeの前のノードに設定します。

  18. ループのステップに戻ります。

13.2.4.2 開いている要素のスタック

最初に、開いている要素のスタックは空です。このスタックは下に向かって成長します。 スタックの最上部のノードはスタックに最初に追加されたものであり、スタックの最下部のノードはスタックに最近追加されたノードです （スタックがランダムアクセス方式で操作される場合を除きます。誤ってネストされたタグの処理の一環として）。

「htmlの前」 挿入モードは html ドキュメント要素を作成し、 それがスタックに追加されます。

フラグメントの場合には、 開いている要素のスタックが html要素を含むように初期化され、 それはそのアルゴリズムの一部として作成されます。 （フラグメントの場合には、 「htmlの前」の 挿入モードをスキップします。）

どのように作成されたとしても、html ノードはスタックの最上部のノードです。それがスタックからポップされるのは、パーサーが 終了したときのみです。

現在のノードは、この開いている要素のスタックの最下部のノードです。

調整された現在のノードは、 コンテキスト要素であり、 パーサーがHTMLフラグメント解析アルゴリズムの一部として作成され、 開いている要素のスタックに1つの要素しかない場合 (フラグメントの場合)に限られます。 それ以外の場合、調整された現在のノードは 現在のノードです。

現在のノードが 開いている要素のスタックから削除されたとき、 内部リソースリンクを処理します 現在のノードの ノードドキュメントに基づいて。

開いている要素のスタック内の要素は次のカテゴリに分類されます:

特別な要素

以下の要素は、さまざまなレベルで特別な解析ルールを持っています。HTMLの address, applet, area, article, aside, base, basefont, bgsound, blockquote, body, br, button, caption, center, col, colgroup, dd, details, dir, div, dl, dt, embed, fieldset, figcaption, figure, footer, form, frame, frameset, h1, h2, h3, h4, h5, h6, head, header, hgroup, hr, html, iframe, img, input, keygen, li, link, listing, main, marquee, menu, meta, nav, noembed, noframes, noscript, object, ol, p, param, plaintext, pre, script, search, section, select, source, style, summary, table, tbody, td, template, textarea, tfoot, th, thead, title, tr, track, ul, wbr, xmp; MathMLの mi, MathMLのmo, MathMLの mn, MathMLの ms, MathMLの mtext, およびMathMLの annotation-xml; SVGのforeignObject, SVGの desc, およびSVGの title。

image開始タグトークンはツリービルダーによって処理されますが、 これは要素ではないため、このリストには含まれていません。それはimg 要素に変換されます。

フォーマット

次のHTML要素は、アクティブなフォーマット要素のリストに含まれる要素です。 a, b, big, code, em, font, i, nobr, s, small, strike, strong, tt, および u。

通常の要素

HTMLドキュメントを解析する際に見つかる他のすべての要素。

通常、特別な要素は 開始タグと終了タグのトークンが特別に処理されますが、 通常の要素のトークンは 「その他の開始タグ」と「その他の終了タグ」の節に該当し、 ツリービルダーの一部では、開いている要素のスタック内の特定の要素が 特別なカテゴリに属しているかどうかをチェックします。 しかし、option 要素のように、開始タグまたは終了タグのトークンが特別に処理されるものの、 特別なカテゴリには含まれず、 他の場所では通常の処理が行われるものもあります。

開いている要素のスタックは、 特定のスコープでターゲットノードを list内の要素型のリストに含んでいると見なされます。このアルゴリズムが一致状態で終了する場合:

  1. nodeを現在のノード（スタックの最下部のノード）として初期化します。

  2. node が target node である場合、一致状態で終了します。

  3. それ以外の場合、nodeがlist内の要素型の1つである場合、失敗状態で終了します。

  4. それ以外の場合、nodeを開いている要素のスタックの前のエントリに設定し、 ステップ2に戻ります。（このループは、スタックの上部—html要素—が 到達された場合、必ず前のステップで終了するため、失敗することはありません。）

開いている要素のスタックは、 特定の要素がスコープ内にあると見なされます。 それは次の要素型のリストに含まれているとき:特定のスコープ内にその要素があることに基づきます。

開いている要素のスタックは、 リスト項目スコープ内に特定の要素があると見なされます。 それは次の要素型のリストに含まれているとき:特定のスコープ内にその要素があることに基づきます。

開いている要素のスタックは、 ボタンスコープ内に特定の要素があると見なされます。 それは次の要素型のリストに含まれているとき:特定のスコープ内にその要素があることに基づきます。

開いている要素のスタックは、 テーブルスコープ内に特定の要素があると見なされます。 それは次の要素型のリストに含まれているとき:特定のスコープ内にその要素があることに基づきます。

開いている要素のスタックは、 セレクトスコープ内に特定の要素があると見なされます。 それは次の要素型のリストに含まれているとき:特定のスコープ内にその要素があることに基づきます。 ただし、次の要素型は含まれません:

任意の時点で、開いている要素のスタック内の要素が ドキュメントツリー内で新しい場所に移動されたり、削除されたりしても、 何も起こりません。特に、スタックはこの状況で変更されません。これにより、DOMに存在しなくなったノードにコンテンツが追加されるなどの奇妙な効果が発生する可能性があります。

一部のケース（すなわち、誤ってネストされたフォーマット要素を閉じる場合）では、スタックがランダムアクセス方式で操作されます。

13.2.4.3 アクティブなフォーマット要素のリスト

最初は、アクティブなフォーマット要素のリストは空です。これは、フォーマット要素のタグの入れ子が正しくない場合に使用されます。

このリストには、フォーマットカテゴリの要素と、マーカーが含まれます。マーカーは、applet、object、marquee、template、td、th、およびcaption要素に入るときに挿入され、フォーマットがこれらの要素に「漏れ込む」ことを防ぎます。

さらに、アクティブなフォーマット要素のリストの各要素は、その要素が作成されたトークンと関連付けられており、必要に応じてそのトークンのためにさらに要素が作成されることがあります。

以下の手順でユーザーエージェント（UA）にアクティブなフォーマット要素のリストに追加することを要求する場合、UAは次の手順を実行する必要があります。

  1. リスト内にすでに同じタグ名、名前空間、および属性を持つ要素が3つ存在する場合、最初のそのような要素をリストから削除します。これには、マーカー以降のすべての要素、またはマーカーがない場合はリスト全体が対象です。このとき、属性は要素がパーサーによって作成されたときの状態で比較されます。2つの要素が同じ属性を持つ場合、それらの属性はすべて名前、名前空間、および値が一致するペアにすることができます（属性の順序は関係ありません）。

    これは「ノアの方舟条項」です。ただし、1家族あたり2つではなく3つです。

  2. elementをアクティブなフォーマット要素のリストに追加します。

以下の手順でユーザーエージェント（UA）にアクティブなフォーマット要素を再構築することを要求する場合、UAは次の手順を実行する必要があります。

  1. リストにエントリがない場合、再構築するものはありません。このアルゴリズムを停止します。

  2. リスト内の最後（最も最近追加された）のエントリがマーカーである場合、またはオープン要素のスタックに含まれている要素である場合、再構築するものはありません。このアルゴリズムを停止します。

  3. リスト内の最後の要素をentryとします。

  4. 巻き戻し：リスト内でentryの前にエントリがない場合、作成の手順に進みます。

  5. リスト内でentryの1つ前のエントリをentryとします。

  6. entryがマーカーでも、オープン要素のスタックにも含まれていない場合、巻き戻しの手順に進みます。

  7. 前進：リスト内でentryの1つ後の要素をentryとします。

  8. 作成：要素entryが作成されたトークンのために、HTML要素を挿入し、new elementを取得します。

  9. リスト内のentryのエントリをnew elementのエントリで置き換えます。

  10. リスト内のnew elementのエントリがリストの最後のエントリでない場合、前進の手順に戻ります。

これは、現在のボディ、セル、またはキャプション（最も若いもの）のすべてのフォーマット要素を再度開く効果がありますが、これらは明示的に閉じられていません。

この仕様書の書き方では、アクティブなフォーマット要素のリストは常に時間順で、最も古い要素が最初で、最も新しい要素が最後に追加されます（ただし、上記のアルゴリズムのステップ7から10を実行している間は例外です）。

以下の手順でユーザーエージェント（UA）に最後のマーカーまでアクティブなフォーマット要素のリストをクリアすることを要求する場合、UAは次の手順を実行する必要があります。

  1. リスト内の最後（最も最近追加された）のエントリをentryとします。

  2. entryをリストから削除します。

  3. entryがマーカーであった場合、この時点でアルゴリズムを停止します。リストは最後のマーカーまでクリアされました。

  4. 手順1に戻ります。

13.2.4.4 要素ポインタ

最初は、head 要素ポインタとform 要素ポインタはどちらもnullです。

head要素が解析されると（明示的または暗黙的に）、head 要素ポインタがこのノードを指すように設定されます。

form 要素ポインタは、最後に開かれ、終了タグがまだ見つかっていないform要素を指します。これは、歴史的な理由から、非常に悪いマークアップでもフォームコントロールがフォームに関連付けられるようにするために使用されます。template要素内では無視されます。

13.2.4.5 その他の解析状態フラグ

スクリプトフラグは、パーサーが作成されたときにパーサーが関連付けられているドキュメントでスクリプトが有効であった場合に「有効」に設定され、それ以外の場合は「無効」に設定されます。

スクリプトフラグは、パーサーがHTMLフラグメント解析アルゴリズムの一部として作成された場合でも有効にすることができますが、その場合でもscript要素は実行されません。

フレームセットOKフラグは、パーサーが作成されたときに「ok」に設定されます。特定のトークンが検出された後、「not ok」に設定されます。

13.2.5 トークン化

実装は、HTMLをトークン化するために次の状態機械を使用するかのように動作しなければなりません。状態機械は、データ状態で開始しなければなりません。ほとんどの状態は単一の文字を消費し、さまざまな副作用を引き起こすことがあります。また、状態機械を新しい状態に切り替えて再消費させたり、現在の入力文字を再消費させたり、次の文字を消費するために新しい状態に切り替えたり、同じ状態にとどまって次の文字を消費したりします。いくつかの状態はより複雑な動作を持ち、別の状態に切り替わる前に複数の文字を消費することがあります。トークン化の状態は、ツリー構築段階によっても変更されることがあります。

状態が一致した文字を指定された状態で再消費するように指示する場合、それはその状態に切り替わることを意味しますが、次の入力文字を消費しようとする際には次の入力文字ではなく、現在の入力文字を提供します。

特定の状態の正確な動作は、挿入モードやオープン要素のスタックに依存します。特定の状態は、進行を追跡するためのtemporary bufferや、文字参照状態がreturn stateを使用して、それが呼び出された状態に戻るなど、複数の状態も使用します。

トークン化ステップの出力は、以下のいずれかのトークンの一連で構成されます：DOCTYPE、開始タグ、終了タグ、コメント、文字、ファイルの終わり。DOCTYPEトークンには名前、パブリック識別子、システム識別子、強制クワークスフラグが含まれます。DOCTYPEトークンが作成されると、その名前、パブリック識別子、およびシステム識別子は欠落しているとマークされ（これは空文字列とは異なる状態です）、強制クワークスフラグはオフに設定されなければなりません（もう一つの状態はオンです）。開始および終了タグトークンには、タグ名、自己終了フラグ、および属性のリストが含まれます。属性リストには、名前と値が含まれています。開始または終了タグトークンが作成されると、その自己終了フラグは解除され（もう一つの状態はセットされることです）、属性リストは空でなければなりません。コメントおよび文字トークンにはデータが含まれます。

トークンが発行されると、それはすぐにツリー構築段階で処理されなければなりません。ツリー構築段階は、トークン化段階の状態に影響を与えたり、ストリームに追加の文字を挿入することができます。（例えば、script要素はスクリプトの実行を引き起こし、動的マークアップ挿入APIを使用してトークン化されているストリームに文字を挿入することができます。）

トークンの作成と発行は別のアクションです。例えば、開始タグトークンを解析中にファイルが予期せず終了した場合、そのトークンは作成されても発行されない（つまり放棄される）ことがあります。

開始タグトークンが自己終了フラグが設定された状態で発行された場合、そのフラグがツリー構築段階で処理される際に認識されないと、それは非空HTML要素の開始タグにトレーリングスラッシュがある解析エラーです。

属性を持つ終了タグトークンが発行されると、それは属性を持つ終了タグの解析エラーです。

自己終了フラグが設定された状態で終了タグトークンが発行された場合、それはトレーリングスラッシュ付き終了タグ解析エラーです。

適切な終了タグトークンとは、このトークナイザから発行された最後の開始タグとタグ名が一致する終了タグトークンのことです。トークナイザから開始タグが発行されていない場合、その場合、適切な終了タグトークンはありません。

文字参照が属性の一部として消費されると、戻り状態が属性値（ダブルクォーテーション）状態、属性値（シングルクォーテーション）状態または属性値（アンコーテッド）状態のいずれかです。

状態が文字参照として消費されたコードポイントをフラッシュするように指示すると、一時バッファに追加された順序で、バッファからの各コードポイントを現在の属性値に追加するか、属性として消費された場合は、バッファのコードポイントを文字トークンとして発行します。

トークナイザの各ステップの前に、ユーザーエージェントは最初にパーサー一時停止フラグをチェックしなければなりません。フラグが真の場合、トークナイザはトークナイザのネストされた呼び出しの処理を中止し、制御を呼び出し元に戻さなければなりません。

トークナイザ状態機械は、以下のサブセクションで定義された状態で構成されています。

13.2.5.1 データ状態

次の入力文字を消費します:

U+0026 アンパサンド (&)
戻り状態をデータ状態に設定します。文字参照状態に切り替えます。
U+003C 小なり記号 (<)
タグ開始状態に切り替えます。
U+0000 NULL
これは予期しないNULL文字の解析エラーです。現在の入力文字を文字トークンとして発行します。
EOF
ファイル終端トークンを発行します。
その他
現在の入力文字を文字トークンとして発行します。
13.2.5.2 RCDATA状態

次の入力文字を消費します:

U+0026 アンパサンド (&)
戻り状態をRCDATA状態に設定します。文字参照状態に切り替えます。
U+003C 小なり記号 (<)
RCDATA小なり記号状態に切り替えます。
U+0000 NULL
これは予期しないNULL文字の解析エラーです。U+FFFD 置換文字トークンを発行します。
EOF
ファイル終端トークンを発行します。
その他
現在の入力文字を文字トークンとして発行します。
13.2.5.3 RAWTEXT状態

次の入力文字を消費します:

U+003C 小なり記号 (<)
RAWTEXT小なり記号状態に切り替えます。
U+0000 NULL
これは予期しないNULL文字の解析エラーです。U+FFFD 置換文字トークンを発行します。
EOF
ファイル終端トークンを発行します。
その他
現在の入力文字を文字トークンとして発行します。
13.2.5.4 スクリプトデータ状態

次の入力文字を消費します:

U+003C 小なり記号 (<)
スクリプトデータ小なり記号状態に切り替えます。
U+0000 NULL
これは予期しないNULL文字の解析エラーです。U+FFFD 置換文字トークンを発行します。
EOF
ファイル終端トークンを発行します。
その他
現在の入力文字を文字トークンとして発行します。
13.2.5.5 PLAINTEXT状態

次の入力文字を消費します:

U+0000 NULL
これは予期しないNULL文字の解析エラーです。U+FFFD 置換文字トークンを発行します。
EOF
ファイル終端トークンを発行します。
その他
現在の入力文字を文字トークンとして発行します。
13.2.5.6 タグ開始状態

次の入力文字を消費します:

U+0021 感嘆符 (!)
マークアップ宣言開始状態に切り替えます。
U+002F 斜線 (/)
終了タグ開始状態に切り替えます。
ASCIIアルファベット
新しい開始タグトークンを作成し、そのタグ名を空文字列に設定します。再消費をタグ名状態で行います。
U+003F 疑問符 (?)
これはタグ名の代わりに予期しない疑問符の解析エラーです。データが空のコメントトークンを作成し、再消費を偽コメント状態で行います。
EOF
これはタグ名の前のEOFの解析エラーです。U+003C 小なり記号トークンとファイル終端トークンを発行します。
その他
これはタグ名の無効な最初の文字の解析エラーです。U+003C 小なり記号トークンを発行します。再消費をデータ状態で行います。
13.2.5.7 終了タグ開始状態

次の入力文字を消費します:

ASCIIアルファベット
新しい終了タグトークンを作成し、そのタグ名を空文字列に設定します。再消費をタグ名状態で行います。
U+003E 大なり記号 (>)
これは終了タグ名の欠如の解析エラーです。データ状態に切り替えます。
EOF
これはタグ名の前のEOFの解析エラーです。U+003C 小なり記号トークン、U+002F 斜線トークン、そしてファイル終端トークンを発行します。
その他
これはタグ名の無効な最初の文字の解析エラーです。データが空のコメントトークンを作成し、再消費を偽コメント状態で行います。
13.2.5.8 タグ名状態

次の入力文字を消費します:

U+0009 タブ文字 (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 スペース
属性名の前の状態に切り替えます。
U+002F 斜線 (/)
自己終了開始タグ状態に切り替えます。
U+003E 大なり記号 (>)
データ状態に切り替え、現在のタグトークンを発行します。
ASCII大文字アルファベット
現在の入力文字の小文字版（文字のコードポイントに0x0020を加えたもの）を現在のタグトークンのタグ名に追加します。
U+0000 NULL
これは予期しないNULL文字の解析エラーです。U+FFFD 置換文字を現在のタグトークンのタグ名に追加します。
EOF
これはタグ内のEOFの解析エラーです。ファイル終端トークンを発行します。
その他
現在の入力文字を現在のタグトークンのタグ名に追加します。
13.2.5.9 RCDATA小なり記号状態

次の入力文字を消費します:

U+002F 斜線 (/)
一時バッファを空にします。RCDATA終了タグ開始状態に切り替えます。
その他
U+003C 小なり記号トークンを発行します。再消費をRCDATA状態で行います。
13.2.5.10 RCDATA終了タグ開始状態

次の入力文字を消費します:

ASCIIアルファベット
新しい終了タグトークンを作成し、そのタグ名を空文字列に設定します。再消費をRCDATA終了タグ名状態で行います。
その他
U+003C 小なり記号トークンとU+002F 斜線トークンを発行します。再消費をRCDATA状態で行います。
13.2.5.11 RCDATA 終了タグ名状態

次の入力文字を消費します:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 スペース
現在の終了タグトークンが適切な終了タグトークンである場合、属性名の前の状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+002F 斜線 (/)
現在の終了タグトークンが適切な終了タグトークンである場合、自己終了開始タグ状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+003E 大なり記号 (>)
現在の終了タグトークンが適切な終了タグトークンである場合、データ状態に切り替え、現在のタグトークンを発行します。それ以外の場合は、以下の「その他」のエントリに従います。
ASCII大文字
現在の入力文字の小文字版（文字のコードポイントに0x0020を加えたもの）を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
ASCII小文字
現在の入力文字を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
その他
U+003C 小なり記号トークン、U+002F 斜線トークン、および一時バッファに追加された文字ごとのトークンを発行します。再消費をRCDATA状態で行います。
13.2.5.12 RAWTEXT小なり記号状態

次の入力文字を消費します:

U+002F 斜線 (/)
一時バッファを空にします。RAWTEXT終了タグ開始状態に切り替えます。
その他
U+003C 小なり記号トークンを発行します。再消費をRAWTEXT状態で行います。
13.2.5.13 RAWTEXT終了タグ開始状態

次の入力文字を消費します:

ASCIIアルファベット
新しい終了タグトークンを作成し、そのタグ名を空文字列に設定します。再消費をRAWTEXT終了タグ名状態で行います。
その他
U+003C 小なり記号トークンとU+002F 斜線トークンを発行します。再消費をRAWTEXT状態で行います。
13.2.5.14 RAWTEXT終了タグ名状態

次の入力文字を消費します:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 スペース
現在の終了タグトークンが適切な終了タグトークンである場合、属性名の前の状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+002F 斜線 (/)
現在の終了タグトークンが適切な終了タグトークンである場合、自己終了開始タグ状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+003E 大なり記号 (>)
現在の終了タグトークンが適切な終了タグトークンである場合、データ状態に切り替え、現在のタグトークンを発行します。それ以外の場合は、以下の「その他」のエントリに従います。
ASCII大文字
現在の入力文字の小文字版（文字のコードポイントに0x0020を加えたもの）を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
ASCII小文字
現在の入力文字を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
その他
U+003C 小なり記号トークン、U+002F 斜線トークン、および一時バッファに追加された文字ごとのトークンを発行します。再消費をRAWTEXT状態で行います。
13.2.5.15 スクリプトデータ小なり記号状態

次の入力文字を消費します:

U+002F 斜線 (/)
一時バッファを空にします。スクリプトデータ終了タグ開始状態に切り替えます。
U+0021 感嘆符 (!)
スクリプトデータエスケープ開始状態に切り替えます。U+003C 小なり記号トークンとU+0021 感嘆符トークンを発行します。
その他
U+003C 小なり記号トークンを発行します。再消費をスクリプトデータ状態で行います。
13.2.5.16 スクリプトデータ終了タグ開始状態

次の入力文字を消費します:

ASCIIアルファベット
新しい終了タグトークンを作成し、そのタグ名を空文字列に設定します。再消費をスクリプトデータ終了タグ名状態で行います。
その他
U+003C 小なり記号トークンとU+002F 斜線トークンを発行します。再消費をスクリプトデータ状態で行います。
13.2.5.17 スクリプトデータ終了タグ名状態

次の入力文字を消費します:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 スペース
現在の終了タグトークンが適切な終了タグトークンである場合、属性名の前の状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+002F 斜線 (/)
現在の終了タグトークンが適切な終了タグトークンである場合、自己終了開始タグ状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+003E 大なり記号 (>)
現在の終了タグトークンが適切な終了タグトークンである場合、データ状態に切り替え、現在のタグトークンを発行します。それ以外の場合は、以下の「その他」のエントリに従います。
ASCII大文字
現在の入力文字の小文字版（文字のコードポイントに0x0020を加えたもの）を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
ASCII小文字
現在の入力文字を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
その他
U+003C 小なり記号トークン、U+002F 斜線トークン、および一時バッファに追加された文字ごとのトークンを発行します。再消費をスクリプトデータ状態で行います。
13.2.5.18スクリプトデータエスケープ開始状態

次の入力文字を消費します:

U+002D ハイフンマイナス (-)
スクリプトデータエスケープ開始ダッシュ状態に切り替えます。U+002D ハイフンマイナス文字トークンを発行します。
その他
再消費をスクリプトデータ状態で行います。
13.2.5.19スクリプトデータエスケープ開始ダッシュ状態

次の入力文字を消費します:

U+002D ハイフンマイナス (-)
スクリプトデータエスケープダッシュダッシュ状態に切り替えます。U+002D ハイフンマイナス文字トークンを発行します。
その他
再消費をスクリプトデータ状態で行います。
13.2.5.20スクリプトデータエスケープ状態

次の入力文字を消費します:

U+002D ハイフンマイナス (-)
スクリプトデータエスケープダッシュ状態に切り替えます。U+002D ハイフンマイナス文字トークンを発行します。
U+003C 小なり記号 (<)
スクリプトデータエスケープ小なり記号状態に切り替えます。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。U+FFFD 置換文字トークンを発行します。
EOF
これはスクリプトHTMLコメントのようなテキスト内でのEOFエラーです。解析エラー。ファイルの終端トークンを発行します。
その他
現在の入力文字を文字トークンとして発行します。
13.2.5.21スクリプトデータエスケープダッシュ状態

次の入力文字を消費します:

U+002D ハイフンマイナス (-)
スクリプトデータエスケープダッシュダッシュ状態に切り替えます。U+002D ハイフンマイナス文字トークンを発行します。
U+003C 小なり記号 (<)
スクリプトデータエスケープ小なり記号状態に切り替えます。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。スクリプトデータエスケープ状態に切り替えます。U+FFFD 置換文字トークンを発行します。
EOF
これはスクリプトHTMLコメントのようなテキスト内でのEOFエラーです。解析エラー。ファイルの終端トークンを発行します。
その他
スクリプトデータエスケープ状態に切り替えます。現在の入力文字を文字トークンとして発行します。
13.2.5.22スクリプトデータエスケープダッシュダッシュ状態

次の入力文字を消費します:

U+002D ハイフンマイナス (-)
U+002D ハイフンマイナス文字トークンを発行します。
U+003C 小なり記号 (<)
スクリプトデータエスケープ小なり記号状態に切り替えます。
U+003E 大なり記号 (>)
スクリプトデータ状態に切り替えます。U+003E 大なり記号文字トークンを発行します。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。スクリプトデータエスケープ状態に切り替えます。U+FFFD 置換文字トークンを発行します。
EOF
これはスクリプトHTMLコメントのようなテキスト内でのEOFエラーです。解析エラー。ファイルの終端トークンを発行します。
その他
スクリプトデータエスケープ状態に切り替えます。現在の入力文字を文字トークンとして発行します。
13.2.5.23スクリプトデータエスケープ小なり記号状態

次の入力文字を消費します:

U+002F 斜線 (/)
一時バッファを空の文字列に設定します。スクリプトデータエスケープ終了タグ開始状態に切り替えます。
ASCII文字
一時バッファを空の文字列に設定します。U+003C 小なり記号文字トークンを発行します。再消費をスクリプトデータ二重エスケープ開始状態で行います。
その他
U+003C 小なり記号文字トークンを発行します。再消費をスクリプトデータエスケープ状態で行います。
13.2.5.24スクリプトデータエスケープ終了タグ開始状態

次の入力文字を消費します:

ASCII文字
新しい終了タグトークンを作成し、そのタグ名を空の文字列に設定します。再消費をスクリプトデータエスケープ終了タグ名状態で行います。
その他
U+003C 小なり記号文字トークンとU+002F 斜線文字トークンを発行します。再消費をスクリプトデータエスケープ状態で行います。
13.2.5.25スクリプトデータエスケープ終了タグ名状態

次の入力文字を消費します:

U+0009 タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 スペース
現在の終了タグトークンが適切な終了タグトークンであれば、属性名の前の状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+002F 斜線 (/)
現在の終了タグトークンが適切な終了タグトークンであれば、自己終了開始タグ状態に切り替えます。それ以外の場合は、以下の「その他」のエントリに従います。
U+003E 大なり記号 (>)
現在の終了タグトークンが適切な終了タグトークンであれば、データ状態に切り替え、現在のタグトークンを発行します。それ以外の場合は、以下の「その他」のエントリに従います。
ASCII大文字
現在の入力文字の小文字バージョンを(文字のコードポイントに0x0020を加えて)現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
ASCII小文字
現在の入力文字を現在のタグトークンのタグ名に追加します。また、現在の入力文字を一時バッファに追加します。
その他
U+003C 小なり記号文字トークン、U+002F 斜線文字トークン、および一時バッファ内の文字ごとの文字トークンを(バッファに追加された順序で)発行します。再消費をスクリプトデータエスケープ状態で行います。
13.2.5.26 スクリプトデータダブルエスケープ開始状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
U+002F スラッシュ (/)
U+003E 大なり記号 (>)
もし一時バッファが文字列「script」である場合、スクリプトデータダブルエスケープ状態に切り替える。それ以外の場合、スクリプトデータエスケープ状態に切り替える。現在の入力文字を文字トークンとして出力する。
ASCII大文字
現在の入力文字の小文字バージョン（文字のコードポイントに0x0020を加える）を一時バッファに追加する。現在の入力文字を文字トークンとして出力する。
ASCII小文字
現在の入力文字を一時バッファに追加する。現在の入力文字を文字トークンとして出力する。
その他
再消費をスクリプトデータエスケープ状態で行う。
13.2.5.27 スクリプトデータダブルエスケープ状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
スクリプトデータダブルエスケープダッシュ状態に切り替える。U+002D ハイフンマイナス文字トークンを出力する。
U+003C 小なり記号 (<)
スクリプトデータダブルエスケープ小なり記号状態に切り替える。U+003C 小なり記号文字トークンを出力する。
U+0000 NULL
これは予期しないNULL文字エラーです。U+FFFD 置換文字トークンを出力する。
EOF
これはスクリプトHTMLコメントのようなテキスト内のEOFエラーです。ファイル終了トークンを出力する。
その他
現在の入力文字を文字トークンとして出力する。
13.2.5.28 スクリプトデータダブルエスケープダッシュ状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
スクリプトデータダブルエスケープダッシュダッシュ状態に切り替える。U+002D ハイフンマイナス文字トークンを出力する。
U+003C 小なり記号 (<)
スクリプトデータダブルエスケープ小なり記号状態に切り替える。U+003C 小なり記号文字トークンを出力する。
U+0000 NULL
これは予期しないNULL文字エラーです。スクリプトデータダブルエスケープ状態に切り替える。U+FFFD 置換文字トークンを出力する。
EOF
これはスクリプトHTMLコメントのようなテキスト内のEOFエラーです。ファイル終了トークンを出力する。
その他
スクリプトデータダブルエスケープ状態に切り替える。現在の入力文字を文字トークンとして出力する。
13.2.5.29 スクリプトデータダブルエスケープダッシュダッシュ状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
U+002D ハイフンマイナス文字トークンを出力する。
U+003C 小なり記号 (<)
スクリプトデータダブルエスケープ小なり記号状態に切り替える。U+003C 小なり記号文字トークンを出力する。
U+003E 大なり記号 (>)
スクリプトデータ状態に切り替える。U+003E 大なり記号文字トークンを出力する。
U+0000 NULL
これは予期しないNULL文字エラーです。スクリプトデータダブルエスケープ状態に切り替える。U+FFFD 置換文字トークンを出力する。
EOF
これはスクリプトHTMLコメントのようなテキスト内のEOFエラーです。ファイル終了トークンを出力する。
その他
スクリプトデータダブルエスケープ状態に切り替える。現在の入力文字を文字トークンとして出力する。
13.2.5.30スクリプトデータダブルエスケープ小なり記号状態

次の入力文字を読み取る:

U+002F スラッシュ (/)
一時バッファを空文字列に設定する。スクリプトデータダブルエスケープ終了状態に切り替える。U+002F スラッシュ文字トークンを出力する。
その他
再消費をスクリプトデータダブルエスケープ状態で行う。
13.2.5.31 スクリプトデータダブルエスケープ終了状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
U+002F スラッシュ (/)
U+003E 大なり記号 (>)
もし一時バッファが文字列「script」である場合、スクリプトデータエスケープ状態に切り替える。それ以外の場合、スクリプトデータダブルエスケープ状態に切り替える。現在の入力文字を文字トークンとして出力する。
ASCII大文字
現在の入力文字の小文字バージョン（文字のコードポイントに0x0020を加える）を一時バッファに追加する。現在の入力文字を文字トークンとして出力する。
ASCII小文字
現在の入力文字を一時バッファに追加する。現在の入力文字を文字トークンとして出力する。
その他
再消費をスクリプトデータダブルエスケープ状態で行う。
13.2.5.32 属性名の前状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
この文字を無視する。
U+002F スラッシュ (/)
U+003E 大なり記号 (>)
EOF
再消費を属性名の後状態で行う。
U+003D イコール記号 (=)
これは予期しない属性名の前のイコール記号エラーです。新しい属性を現在のタグトークンに追加する。その属性の名前を現在の入力文字に設定し、値を空文字列に設定する。属性名状態に切り替える。
その他
現在のタグトークンに新しい属性を追加する。その属性名と値を空文字列に設定する。再消費を属性名状態で行う。
13.2.5.33 属性名状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
U+002F スラッシュ (/)
U+003E 大なり記号 (>)
EOF
再消費を属性名の後状態で行う。
U+003D イコール記号 (=)
属性値の前状態に切り替える。
ASCII大文字
現在の入力文字の小文字バージョン（文字のコードポイントに0x0020を加える）を現在の属性名に追加する。
U+0000 NULL
これは予期しないNULL文字エラーです。U+FFFD 置換文字を現在の属性名に追加する。
U+0022 二重引用符 (")
U+0027 アポストロフィ (')
U+003C 小なり記号 (<)
これは属性名内の予期しない文字エラーです。以下の「その他」エントリに従って処理する。
その他
現在の入力文字を現在の属性名に追加する。

ユーザーエージェントが属性名状態を抜けたとき（適切な場合、タグトークンを発行する前に）、完全な属性名は同じトークン上の他の属性と比較されなければならない。同じ名前の属性がトークン上にすでに存在する場合、これは重複属性エラーであり、新しい属性はトークンから削除されなければならない。

トークンから属性がこのように削除された場合、それと、それに関連付けられる値（ある場合）は、後でパーサーによって使用されることはなく、したがって事実上破棄される。このように属性を削除しても、トークナイザーの目的において「現在の属性」としてのステータスは変わらない。

13.2.5.34 属性名の後状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
この文字を無視する。
U+002F スラッシュ (/)
自己終了タグ開始状態に切り替える。
U+003D イコール記号 (=)
属性値の前状態に切り替える。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のタグトークンを発行する。
EOF
これはタグ内EOFエラーです。ファイル終了トークンを発行する。
その他
現在のタグトークンに新しい属性を追加する。その属性名と値を空文字列に設定する。再消費を属性名状態で行う。
13.2.5.35 属性値の前状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
この文字を無視する。
U+0022 二重引用符 (")
属性値（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
属性値（シングルクォート付き）状態に切り替える。
U+003E 大なり記号 (>)
これは属性値欠落エラーです。データ状態に切り替える。現在のタグトークンを発行する。
その他
再消費を属性値（引用符なし）状態で行う。
13.2.5.36 属性値 (二重引用符付き) 状態

次の入力文字を読み取る:

U+0022 二重引用符 (")
属性値 (引用符付き) の後の状態に切り替える。
U+0026 アンパサンド (&)
戻り状態を属性値 (二重引用符付き) 状態に設定する。文字参照状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在の属性値にU+FFFD 置換文字を追加する。
EOF
これはタグ内EOFエラーです。解析エラー。ファイル終了トークンを発行する。
その他
現在の入力文字を現在の属性値に追加する。
13.2.5.37 属性値 (シングルクォート付き) 状態

次の入力文字を読み取る:

U+0027 アポストロフィ (')
属性値 (引用符付き) の後の状態に切り替える。
U+0026 アンパサンド (&)
戻り状態を属性値 (シングルクォート付き) 状態に設定する。文字参照状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在の属性値にU+FFFD 置換文字を追加する。
EOF
これはタグ内EOFエラーです。解析エラー。ファイル終了トークンを発行する。
その他
現在の入力文字を現在の属性値に追加する。
13.2.5.38 属性値 (引用符なし) 状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
属性名の前状態に切り替える。
U+0026 アンパサンド (&)
戻り状態を属性値 (引用符なし) 状態に設定する。文字参照状態に切り替える。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のタグトークンを発行する。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在の属性値にU+FFFD 置換文字を追加する。
U+0022 二重引用符 (")
U+0027 アポストロフィ (')
U+003C 小なり記号 (<)
U+003D イコール記号 (=)
U+0060 逆アクセント (`)
これは引用符なしの属性値での予期しない文字エラーです。解析エラー。以下の「その他」エントリに従って処理する。
EOF
これはタグ内EOFエラーです。解析エラー。ファイル終了トークンを発行する。
その他
現在の入力文字を現在の属性値に追加する。
13.2.5.39 属性値 (引用符付き) の後の状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
属性名の前状態に切り替える。
U+002F スラッシュ (/)
自己終了タグ開始状態に切り替える。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のタグトークンを発行する。
EOF
これはタグ内EOFエラーです。解析エラー。ファイル終了トークンを発行する。
その他
これは属性間の空白欠落エラーです。解析エラー。再消費を属性名の前状態で行う。
13.2.5.40 自己終了タグ開始状態

次の入力文字を読み取る:

U+003E 大なり記号 (>)
現在のタグトークンの自己終了フラグを設定する。データ状態に切り替える。現在のタグトークンを発行する。
EOF
これはタグ内EOFエラーです。解析エラー。ファイル終了トークンを発行する。
その他
これはタグ内での予期しないスラッシュエラーです。解析エラー。再消費を属性名の前状態で行う。
13.2.5.41 偽のコメント状態

次の入力文字を読み取る:

U+003E 大なり記号 (>)
データ状態に切り替える。現在のコメントトークンを発行する。
EOF
コメントを発行する。ファイル終了トークンを発行する。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。コメントトークンのデータにU+FFFD 置換文字を追加する。
その他
現在の入力文字をコメントトークンのデータに追加する。
13.2.5.42 マークアップ宣言開始状態

次の文字が次の場合:

U+002D ハイフンマイナス (-) が2つ
これらの2文字を消費し、データが空文字列のコメントトークンを作成し、コメント開始状態に切り替える。
ASCIIの大文字と小文字を区別しない「DOCTYPE」に一致する場合
それらの文字を消費し、DOCTYPE状態に切り替える。
文字列「[CDATA[」 (5つの大文字「CDATA」と、前後にU+005B 左角括弧文字を持つ文字列)
これらの文字を消費する。調整された現在のノードがあり、それがHTML名前空間内の要素でない場合、CDATAセクション状態に切り替える。それ以外の場合、これはHTMLコンテンツ内のCDATAエラーです。解析エラー。データが「[CDATA[」のコメントトークンを作成する。偽のコメント状態に切り替える。
その他
これは誤って開かれたコメントエラーです。解析エラー。データが空文字列のコメントトークンを作成する。偽のコメント状態に切り替える (現在の状態では何も消費しない)。
13.2.5.43 コメント開始状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
コメント開始ダッシュ状態に切り替える。
U+003E 大なり記号 (>)
これは空のコメントの突然の閉鎖エラーです。解析エラー。データ状態に切り替える。現在のコメントトークンを発行する。
その他
再消費をコメント状態で行う。
13.2.5.44 コメント開始ダッシュ状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
コメント終了状態に切り替える。
U+003E 大なり記号 (>)
これは空のコメントの突然の閉鎖エラーです。解析エラー。データ状態に切り替える。現在のコメントトークンを発行する。
EOF
これはコメント内EOFエラーです。解析エラー。現在のコメントトークンを発行する。ファイル終了トークンを発行する。
その他
コメントトークンのデータにU+002D ハイフンマイナス文字 (-) を追加する。再消費をコメント状態で行う。
13.2.5.45 コメント状態

次の入力文字を読み取る:

U+003C 小なり記号 (<)
コメントトークンのデータに現在の入力文字を追加する。コメント小なり記号状態に切り替える。
U+002D ハイフンマイナス (-)
コメント終了ダッシュ状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。コメントトークンのデータにU+FFFD 置換文字を追加する。
EOF
これはコメント内EOFエラーです。解析エラー。現在のコメントトークンを発行する。ファイル終了トークンを発行する。
その他
コメントトークンのデータに現在の入力文字を追加する。
13.2.5.46 コメント小なり記号状態

次の入力文字を読み取る:

U+0021 感嘆符 (!)
コメントトークンのデータに現在の入力文字を追加する。コメント小なり記号感嘆符状態に切り替える。
U+003C 小なり記号 (<)
コメントトークンのデータに現在の入力文字を追加する。
その他
再消費をコメント状態で行う。
13.2.5.47 コメント小なり記号感嘆符状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
コメント小なり記号感嘆符ダッシュ状態に切り替える。
その他
再消費をコメント状態で行う。
13.2.5.48 コメント小なり記号感嘆符ダッシュ状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
コメント小なり記号感嘆符ダッシュダッシュ状態に切り替える。
その他
再消費をコメント終了ダッシュ状態で行う。
13.2.5.49 コメント小なり記号感嘆符ダッシュダッシュ状態

次の入力文字を読み取る:

U+003E 大なり記号 (>)
EOF
再消費をコメント終了状態で行う。
その他
これはネストされたコメントエラーです。解析エラー。再消費をコメント終了状態で行う。
13.2.5.50 コメント終了ダッシュ状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
コメント終了状態に切り替える。
EOF
これはコメント内EOFエラーです。解析エラー。現在のコメントトークンを発行する。ファイル終了トークンを発行する。
その他
コメントトークンのデータにU+002D ハイフンマイナス文字 (-) を追加する。再消費をコメント状態で行う。
13.2.5.51 コメント終了状態

次の入力文字を読み取る:

U+003E 大なり記号 (>)
データ状態に切り替える。現在のコメントトークンを発行する。
U+0021 感嘆符 (!)
コメント終了感嘆符状態に切り替える。
U+002D ハイフンマイナス (-)
コメントトークンのデータにU+002D ハイフンマイナス文字 (-) を追加する。
EOF
これはコメント内EOFエラーです。解析エラー。現在のコメントトークンを発行する。ファイル終了トークンを発行する。
その他
コメントトークンのデータにU+002D ハイフンマイナス文字 (-) を2つ追加する。再消費をコメント状態で行う。
13.2.5.52 コメント終了感嘆符状態

次の入力文字を読み取る:

U+002D ハイフンマイナス (-)
コメントトークンのデータにU+002D ハイフンマイナス文字 (-) を2つ、U+0021 感嘆符文字 (!) を追加する。コメント終了ダッシュ状態に切り替える。
U+003E 大なり記号 (>)
これは誤って閉じられたコメントエラーです。解析エラー。データ状態に切り替える。現在のコメントトークンを発行する。
EOF
これはコメント内EOFエラーです。解析エラー。現在のコメントトークンを発行する。ファイル終了トークンを発行する。
その他
コメントトークンのデータにU+002D ハイフンマイナス文字 (-) を2つ、U+0021 感嘆符文字 (!) を追加する。再消費をコメント状態で行う。
13.2.5.53 DOCTYPE状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
DOCTYPE名の前状態に切り替える。
U+003E 大なり記号 (>)
再消費をDOCTYPE名の前状態で行う。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。新しいDOCTYPEトークンを作成する。そのトークンのフォースクワークスフラグをオンに設定する。現在のトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPE名の前の空白欠落エラーです。解析エラー。再消費をDOCTYPE名の前状態で行う。
13.2.5.54 DOCTYPE名の前状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
この文字を無視する。
ASCII大文字
新しいDOCTYPEトークンを作成する。トークンの名前を現在の入力文字の小文字版（文字コードに0x0020を加える）に設定する。DOCTYPE名の状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。新しいDOCTYPEトークンを作成する。トークンの名前をU+FFFD 置換文字に設定する。DOCTYPE名の状態に切り替える。
U+003E 大なり記号 (>)
これはDOCTYPE名欠落エラーです。解析エラー。新しいDOCTYPEトークンを作成する。そのトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。新しいDOCTYPEトークンを作成する。そのトークンのフォースクワークスフラグをオンに設定する。現在のトークンを発行する。ファイル終了トークンを発行する。
その他
新しいDOCTYPEトークンを作成する。トークンの名前を現在の入力文字に設定する。DOCTYPE名の状態に切り替える。
13.2.5.55 DOCTYPE名の状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
DOCTYPE名の後状態に切り替える。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のDOCTYPEトークンを発行する。
ASCII大文字
現在のDOCTYPEトークンの名前に現在の入力文字の小文字版（文字コードに0x0020を加える）を追加する。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在のDOCTYPEトークンの名前にU+FFFD 置換文字を追加する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
現在のDOCTYPEトークンの名前に現在の入力文字を追加する。
13.2.5.56 DOCTYPE名の後状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
この文字を無視する。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他

現在の入力文字から始まる6文字が「PUBLIC」にASCIIの大文字と小文字を区別せず一致する場合、それらの文字を消費し、DOCTYPEパブリックキーワード後状態に切り替える。

それ以外の場合、現在の入力文字から始まる6文字が「SYSTEM」にASCIIの大文字と小文字を区別せず一致する場合、それらの文字を消費し、DOCTYPEシステムキーワード後状態に切り替える。

それ以外の場合、これはDOCTYPE名後の無効な文字シーケンスエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。

13.2.5.57 DOCTYPEパブリックキーワード後状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
DOCTYPEパブリック識別子の前状態に切り替える。
U+0022 引用符 (")
これはDOCTYPEパブリックキーワード後の空白欠落エラーです。解析エラー。現在のDOCTYPEトークンのパブリック識別子を空文字列（欠落なし）に設定し、DOCTYPEパブリック識別子（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
これはDOCTYPEパブリックキーワード後の空白欠落エラーです。解析エラー。現在のDOCTYPEトークンのパブリック識別子を空文字列（欠落なし）に設定し、DOCTYPEパブリック識別子（単一引用符付き）状態に切り替える。
U+003E 大なり記号 (>)
これはDOCTYPEパブリック識別子欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEパブリック識別子前の引用符欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。
13.2.5.58 DOCTYPEパブリック識別子の前状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
この文字を無視する。
U+0022 引用符 (")
現在のDOCTYPEトークンのパブリック識別子を空文字列（欠落なし）に設定し、DOCTYPEパブリック識別子（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
現在のDOCTYPEトークンのパブリック識別子を空文字列（欠落なし）に設定し、DOCTYPEパブリック識別子（単一引用符付き）状態に切り替える。
U+003E 大なり記号 (>)
これはDOCTYPEパブリック識別子欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEパブリック識別子前の引用符欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。
13.2.5.59 DOCTYPEパブリック識別子（二重引用符付き）状態

次の入力文字を読み取る:

U+0022 引用符 (")
DOCTYPEパブリック識別子後状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在のDOCTYPEトークンのパブリック識別子にU+FFFD 置換文字を追加する。
U+003E 大なり記号 (>)
これはDOCTYPEパブリック識別子の突然の終了エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のトークンを発行する。ファイル終了トークンを発行する。
その他
現在のDOCTYPEトークンのパブリック識別子に現在の入力文字を追加する。
13.2.5.60 DOCTYPEパブリック識別子（単一引用符付き）状態

次の入力文字を読み取る:

U+0027 アポストロフィ (')
DOCTYPEパブリック識別子後状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在のDOCTYPEトークンのパブリック識別子にU+FFFD 置換文字を追加する。
U+003E 大なり記号 (>)
これはDOCTYPEパブリック識別子の突然の終了エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のトークンを発行する。ファイル終了トークンを発行する。
その他
現在のDOCTYPEトークンのパブリック識別子に現在の入力文字を追加する。
13.2.5.61 DOCTYPEパブリック識別子後状態

次の入力文字を読み取る:

U+0009 文字タブ (タブ)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
DOCTYPEパブリック識別子とシステム識別子の間の状態に切り替える。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のDOCTYPEトークンを発行する。
U+0022 引用符 (")
これはDOCTYPEパブリック識別子とシステム識別子の間の空白欠落エラーです。解析エラー。現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
これはDOCTYPEパブリック識別子とシステム識別子の間の空白欠落エラーです。解析エラー。現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（単一引用符付き）状態に切り替える。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEシステム識別子前の引用符欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。
13.2.5.62 DOCTYPEパブリック識別子とシステム識別子の間の状態

次の入力文字を読み取る:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
文字を無視する。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のDOCTYPEトークンを発行する。
U+0022 引用符 (")
現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（単一引用符付き）状態に切り替える。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEシステム識別子前の引用符欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。
13.2.5.63 DOCTYPEシステムキーワード後状態

次の入力文字を読み取る:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
DOCTYPEシステム識別子前状態に切り替える。
U+0022 引用符 (")
これはDOCTYPEシステムキーワード後の空白欠落エラーです。解析エラー。現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
これはDOCTYPEシステムキーワード後の空白欠落エラーです。解析エラー。現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（単一引用符付き）状態に切り替える。
U+003E 大なり記号 (>)
これはDOCTYPEシステム識別子欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEシステム識別子前の引用符欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。
13.2.5.64 DOCTYPEシステム識別子前状態

次の入力文字を読み取る:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
文字を無視する。
U+0022 引用符 (")
現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（二重引用符付き）状態に切り替える。
U+0027 アポストロフィ (')
現在のDOCTYPEトークンのシステム識別子を空文字列（欠落なし）に設定し、DOCTYPEシステム識別子（単一引用符付き）状態に切り替える。
U+003E 大なり記号 (>)
これはDOCTYPEシステム識別子欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEシステム識別子前の引用符欠落エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。再消費を偽のDOCTYPE状態で行う。
13.2.5.65 DOCTYPEシステム識別子（二重引用符付き）状態

次の入力文字を読み取る:

U+0022 引用符 (")
DOCTYPEシステム識別子後状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在のDOCTYPEトークンのシステム識別子にU+FFFD置換文字を追加する。
U+003E 大なり記号 (>)
これはDOCTYPEシステム識別子の突然の終了エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
現在のDOCTYPEトークンのシステム識別子に現在の入力文字を追加する。
13.2.5.66 DOCTYPEシステム識別子（単一引用符付き）状態

次の入力文字を読み取る:

U+0027 アポストロフィ (')
DOCTYPEシステム識別子後状態に切り替える。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。現在のDOCTYPEトークンのシステム識別子にU+FFFD置換文字を追加する。
U+003E 大なり記号 (>)
これはDOCTYPEシステム識別子の突然の終了エラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
現在のDOCTYPEトークンのシステム識別子に現在の入力文字を追加する。
13.2.5.67 DOCTYPEシステム識別子後状態

次の入力文字を読み取る:

U+0009 文字タブ (tab)
U+000A 改行 (LF)
U+000C 改ページ (FF)
U+0020 空白
文字を無視する。
U+003E 大なり記号 (>)
データ状態に切り替える。現在のDOCTYPEトークンを発行する。
EOF
これはDOCTYPE内EOFエラーです。解析エラー。現在のDOCTYPEトークンのフォースクワークスフラグをオンに設定する。現在のDOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
これはDOCTYPEシステム識別子後の予期しない文字エラーです。解析エラー。再消費を偽のDOCTYPE状態で行う。（これにより、現在のDOCTYPEトークンのフォースクワークスフラグはオンになりません。）
13.2.5.68 偽のDOCTYPE状態

次の入力文字を読み取る:

U+003E 大なり記号 (>)
データ状態に切り替える。DOCTYPEトークンを発行する。
U+0000 NULL
これは予期しないNULL文字エラーです。解析エラー。文字を無視する。
EOF
DOCTYPEトークンを発行する。ファイル終了トークンを発行する。
その他
文字を無視する。
13.2.5.69 CDATAセクション状態

次の入力文字を読み取る:

U+005D 右角括弧 (])
CDATAセクション括弧状態に切り替える。
EOF
これはCDATA内EOFエラーです。解析エラー。ファイル終了トークンを発行する。
その他
現在の入力文字を文字トークンとして発行する。

U+0000 NULL文字は、ツリー構築段階で処理されます。これは、外部コンテンツの解析挿入モードの一部であり、CDATAセクションが現れる唯一の場所です。

13.2.5.70 CDATAセクション括弧状態

次の入力文字を読み取る:

U+005D 右角括弧 (])
CDATAセクション終了状態に切り替える。
その他
U+005D 右角括弧文字トークンを発行する。再消費をCDATAセクション状態で行う。
13.2.5.71 CDATAセクション終了状態

次の入力文字を読み取る:

U+005D 右角括弧 (])
U+005D 右角括弧文字トークンを発行する。
U+003E 大なり記号 (>)
データ状態に切り替える。
その他
U+005D 右角括弧文字トークンを2つ発行する。再消費をCDATAセクション状態で行う。
13.2.5.72 文字参照状態

一時的なバッファーを空の文字列に設定します。U+0026 AMPERSAND(&)文字を一時的なバッファーに追加します。次の入力文字を消費します。

ASCII 英数字
再消費する 名前付き文字参照状態で。
U+0023 NUMBER SIGN (#)
現在の入力文字を一時的なバッファーに追加します。数値文字参照状態に切り替えます。
その他
文字参照として消費されたコードポイントをフラッシュします。再消費する 戻り状態で。
13.2.5.73 名前付き文字参照状態

名前付き文字参照テーブルの最初の列の識別子の一つに該当する、可能な限り多くの文字を消費します。消費された文字を一時的なバッファーに追加します。

一致する場合

属性の一部として消費された場合、最後に一致した文字がU+003B セミコロン文字(;)でなく、次の入力文字がU+003D イコール記号(=)またはASCII 英数字である場合、歴史的な理由から、文字参照として消費されたコードポイントをフラッシュして戻り状態に切り替えます。

それ以外の場合:

  1. 最後に一致した文字がU+003B セミコロン文字(;)でない場合、これは文字参照の後にセミコロンが欠落しているエラーです。解析エラーです。

  2. 一時的なバッファーを空の文字列に設定します。名前付き文字参照テーブルの2列目で与えられる文字参照名に対応する1つまたは2つの文字を一時的なバッファーに追加します。

  3. 文字参照として消費されたコードポイントをフラッシュします。戻り状態に切り替えます。
一致しない場合
文字参照として消費されたコードポイントをフラッシュします。曖昧なアンパサンド状態に切り替えます。

マークアップに(属性内ではなく) I'm &notit; I tell youという文字列が含まれている場合、文字参照は"not"として解析され、 I'm ¬it; I tell you となり(これは解析エラーです)。しかし、マークアップが I'm &notin; I tell you であった場合、文字参照は"notin;"として解析され、I'm ∉ I tell you となります(解析エラーはありません)。

ただし、マークアップが I'm &notit; I tell you を属性内に含む場合、文字参照は解析されず、文字列はそのまま残ります(解析エラーはありません)。

13.2.5.74 曖昧なアンパサンド状態

次の入力文字を消費します:

ASCII 英数字
属性の一部として消費された場合、現在の入力文字を現在の属性の値に追加します。それ以外の場合、現在の入力文字を文字トークンとして出力します。
U+003B SEMICOLON (;)
これは不明な名前付き文字参照エラーです。解析エラー。再消費する 戻り状態で。
その他
再消費する 戻り状態で。
13.2.5.75 数値文字参照状態

character reference codeをゼロ(0)に設定します。

次の入力文字を消費します:

U+0078 ラテン小文字 x
U+0058 ラテン大文字 X
現在の入力文字を一時的なバッファーに追加します。16進数文字参照開始状態に切り替えます。
その他
再消費する 10進数文字参照開始状態で。
13.2.5.76 16進数文字参照開始状態

次の入力文字を消費します:

ASCII 16進数桁
再消費し、 16進数文字参照状態に戻ります。
それ以外のもの
これは数値文字参照の桁なしエラー 構文エラーです。 文字参照として消費されたコードポイントをフラッシュします。 再消費 戻る状態にて。
13.2.5.77 10進数文字参照開始状態

次の入力文字を消費します:

ASCII 桁
再消費し、 10進数文字参照状態に戻ります。
それ以外のもの
これは数値文字参照の桁なしエラー 構文エラーです。 文字参照として消費されたコードポイントをフラッシュします。 再消費し、 戻る状態にて。
13.2.5.78 16進数文字参照状態

次の入力文字を消費します:

ASCII 桁
文字参照コードに16を掛けます。 現在の入力文字 の数値バージョンを（文字のコードポイントから0x0030を引く）文字参照コードに加えます。
ASCII 大文字16進数桁
文字参照コードに16を掛けます。 現在の入力文字 を16進数桁として（文字のコードポイントから0x0037を引く）文字参照コードに加えます。
ASCII 小文字16進数桁
文字参照コードに16を掛けます。 現在の入力文字 を16進数桁として（文字のコードポイントから0x0057を引く）文字参照コードに加えます。
U+003B セミコロン (;)
数値文字参照終了状態に切り替えます。
それ以外のもの
これは文字参照後のセミコロン欠如エラー 構文エラーです。 再消費し、 数値文字参照終了状態にて。
13.2.5.79 10進数文字参照状態

次の入力文字を消費します:

ASCII 桁
文字参照コードに10を掛けます。 現在の入力文字 の数値バージョンを（文字のコードポイントから0x0030を引く）文字参照コードに加えます。
U+003B セミコロン (;)
数値文字参照終了状態に切り替えます。
それ以外のもの
これは文字参照後のセミコロン欠如エラー 構文エラーです。 再消費し、 数値文字参照終了状態にて。
13.2.5.80 数値文字参照終了状態

文字参照コードを確認します:

一時バッファを空文字列に設定します。一時バッファに文字参照コードに等しいコードポイントを追加します。文字参照として消費されたコードポイントをフラッシュします。戻り状態に切り替えます。

13.2.6 ツリー構築

ツリー構築段階の入力は、トークン化段階からのトークンのシーケンスです。ツリー構築段階は、パーサーが作成されるときにDOM ドキュメントオブジェクトに関連付けられます。この段階の「出力」は、そのドキュメントのDOMツリーを動的に変更または拡張することです。

この仕様では、インタラクティブなユーザーエージェントが ドキュメントをユーザーに利用可能にするために描画するタイミングや、ユーザー入力を受け付け始めるタイミングを定義していません。

各トークンがトークナイザーから発行されるたびに、ユーザーエージェントは次に示すリストから適切な手順に従わなければなりません。これをツリー構築ディスパッチャーと呼びます。

オープン要素のスタックが空の場合
調整された現在のノードがHTML名前空間内の要素である場合
調整された現在のノードがMathMLテキスト統合ポイントであり、トークンが「mglyph」または「malignmark」でない開始タグである場合
調整された現在のノードがMathMLテキスト統合ポイントであり、トークンが文字トークンである場合
調整された現在のノードがMathMLannotation-xml要素であり、トークンが「svg」の開始タグである場合
調整された現在のノードがHTML統合ポイントであり、トークンが開始タグである場合
調整された現在のノードがHTML統合ポイントであり、トークンが文字トークンである場合
トークンがEOFトークンである場合
現在の挿入モードに対応するセクションで示される規則に従ってトークンを処理します。
その他の場合
外国コンテンツ内でのトークン解析に関するセクションで示される規則に従ってトークンを処理します。

次のトークンとは、ツリー構築ディスパッチャーによって処理される予定のトークンのことです（たとえそのトークンが後で無視されるだけであっても）。

ノードがMathMLテキスト統合ポイントであるのは、それが次の要素のいずれかである場合です：

ノードがHTML統合ポイントであるのは、それが次の要素のいずれかである場合です：

問題のノードが、HTMLフラグメント解析アルゴリズムに渡されたcontext要素である場合、その要素の開始タグトークンは、そのHTMLフラグメント解析アルゴリズムによって作成された「フェイク」トークンです。

以下に述べるタグ名のすべてがこの仕様で準拠したタグ名ではありません。多くはレガシーコンテンツを処理するために含まれています。それらは、実装が準拠を主張するために実装する必要があるアルゴリズムの一部です。

以下に説明するアルゴリズムは、生成されるDOMツリーの深さ、タグ名の長さ、属性名、属性値、Textノードなどに制限を設けていません。実装者は任意の制限を避けることを推奨されますが、実際の問題として、ユーザーエージェントがネスティング深度の制約を課す必要があると認識されています。

13.2.6.1 ノードの作成と挿入

パーサーがトークンを処理している間、養育親の概念を有効または無効にすることができます。これにより、次のアルゴリズムに影響を与えます。

ノードを挿入する適切な場所は、特定のオーバーライドターゲットを使用するオプションがあり、次の手順を実行して返される要素内の位置です。

  1. もしオーバーライドターゲットが指定されていた場合、targetをそのオーバーライドターゲットとします。

    それ以外の場合、targetを現在のノードとします。

  2. 次のリストから最初に一致する手順を使用して、adjusted insertion locationを決定します：

    もし養育親の概念が有効であり、targetがtable、 tbody、 tfoot、 thead、 またはtr 要素である場合

    養育親の概念は、コンテンツがテーブル内で誤ってネストされた場合に発生します。

    次のサブステップを実行します：

    1. last templateを、オープン要素のスタック内の最後のtemplate要素とします（存在する場合）。

    2. last tableを、オープン要素のスタック内の最後のtable要素とします（存在する場合）。

    3. もしlast templateが存在し、かつlast tableが存在しないか、または存在するがlast templateがlast tableよりも低い（より最近追加された）場合、adjusted insertion locationをlast templateのテンプレート内容内で、その最後の子要素（存在する場合）の後に設定し、これらの手順を中止します。

    4. もしlast tableが存在しない場合、adjusted insertion locationをオープン要素のスタック内の最初の要素（html要素）内で、その最後の子要素（存在する場合）の後に設定し、これらの手順を中止します。 (フラグメントケース)

    5. もしlast tableに親ノードがある場合、adjusted insertion locationをlast tableの親ノード内で、last tableの直前に設定し、これらの手順を中止します。

    6. previous elementをlast tableのすぐ上にある要素とします。

    7. adjusted insertion locationをprevious element内で、その最後の子要素（存在する場合）の後に設定します。

    これらの手順が複雑なのは、特にこの場合table要素が、スクリプトによってDOM内で移動されたり、DOMから完全に削除されたりした可能性があるためです。

    その他の場合

    adjusted insertion locationをtarget内で、その最後の子要素（存在する場合）の後に設定します。

  3. もしadjusted insertion locationがtemplate要素内にある場合、それをtemplate要素のテンプレート内容内で、その最後の子要素（存在する場合）の後に設定します。

  4. adjusted insertion locationを返します。

トークン用の要素を作成するには、トークン token、文字列 namespace、および Node オブジェクト intendedParent を指定します。

  1. アクティブな投機的 HTML パーサーが null でない場合、namespace、token のタグ名、および token の属性を指定して投機的モック要素を作成した結果を返します。

  2. それ以外の場合、オプションで、namespace、token のタグ名、および token の属性を指定して投機的モック要素を作成します。

    結果は使用されません。このステップにより、非投機的解析から投機的フェッチを開始できます。この時点では、フェッチはまだ投機的です。なぜなら、たとえば、要素が挿入されるまでに、intended parent がドキュメントから削除されている可能性があるためです。

  3. document を intendedParent の ノードドキュメントとします。

  4. localName を token のタグ名とします。

  5. is を、token にそのような属性が存在する場合は「is」属性の値とし、それ以外の場合は null とします。

  6. registry を、intendedParent を指定してカスタム要素レジストリを検索した結果とします。

  7. definition を、registry、namespace、localName、および is を指定してカスタム要素定義を検索した結果とします。

  8. willExecuteScript を、definition が null でなく、パーサーがHTML フラグメント解析アルゴリズムの一部として作成されなかった場合は true とし、それ以外の場合は false とします。

  9. willExecuteScript が true の場合：

    1. document の 動的マークアップ挿入カウンターでのスローをインクリメントします。

    2. JavaScript 実行コンテキストスタックが空の場合、マイクロタスクチェックポイントを実行します。

    3. 新しい要素キューを document の 関連エージェントの カスタム要素リアクションスタックにプッシュします。

  10. element を、document、localName、namespace、null、is、willExecuteScript、および registry を指定して要素を作成した結果とします。

    これにより、willExecuteScript が true の場合、カスタム要素コンストラクターが実行されます。ただし、動的マークアップ挿入カウンターでのスローをインクリメントしたため、これにより新しい文字がトークナイザーに挿入されたり、ドキュメントが破棄されたりすることはありません。

  11. 指定されたトークン内の各属性を element に追加します。

    これにより、attributeChangedCallback のカスタム要素コールバックリアクションをキューに入れることができ、これはすぐに（次のステップで）実行される可能性があります。

    is 属性はカスタマイズされた組み込み要素の作成を制御しますが、関連するカスタム要素コンストラクターの実行中には存在しません。他のすべての属性とともに、このステップで追加されます。

  12. willExecuteScript が true の場合：

    1. queue を、document の 関連エージェントの カスタム要素リアクションスタックからポップした結果とします。（これは、上記でプッシュされたものと同じ要素キューになります。）

    2. queue 内のカスタム要素リアクションを呼び出します。

    3. document の 動的マークアップ挿入カウンターでのスローをデクリメントします。

  13. element が、要素の名前空間と完全に同じではない値を持つ XMLNS 名前空間 の xmlns 属性を持つ場合、それは解析エラーです。同様に、element が、XLink 名前空間ではない値を持つ XMLNS 名前空間の xmlns:xlink 属性を持つ場合、それは解析エラーです。

  14. element がリセット可能な要素であり、フォーム関連のカスタム要素ではない場合、そのリセットアルゴリズムを呼び出します。（これにより、要素の属性に基づいて要素の値とチェック状態が初期化されます。）

  15. element がフォーム関連要素であり、フォーム関連のカスタム要素ではなく、form 要素ポインターが null ではなく、開いている要素のスタックにtemplate 要素がなく、element がリストされていないか、form 属性を持っておらず、intendedParent がform 要素ポインターによって指されている要素と同じツリーにある場合、element をform 要素ポインターによって指されているform 要素に関連付け、element のパーサー挿入フラグを設定します。

  16. element を返します。

次の手順が、要素elementを使用して調整された挿入位置に要素を挿入することを要求する場合：

  1. adjusted insertion locationをノードを挿入する適切な場所とします。

  2. もしelementをadjusted insertion locationに挿入することができない場合、これらの手順を中止します。

  3. パーサーがHTMLフラグメント解析アルゴリズムの一部として作成されていない場合、新しい要素キューをelementの関連エージェントのカスタム要素のリアクションスタックにプッシュします。

  4. elementをadjusted insertion locationに挿入します。

  5. パーサーがHTMLフラグメント解析アルゴリズムの一部として作成されていない場合、elementの関連エージェントのカスタム要素のリアクションスタックから要素キューをポップし、そのキュー内でカスタム要素のリアクションを実行します。

もしadjusted insertion locationがさらに要素を受け入れられない場合、たとえば既に子要素を持つDocumentである場合、elementは破棄されます。

外部要素を挿入するには、トークン token、文字列 namespace、およびブール値 onlyAddToElementStack を指定します。

  1. adjustedInsertionLocation をノードを挿入する適切な場所とします。

  2. element を、token、namespace、および adjustedInsertionLocation が存在する要素を指定してトークン用の要素を作成した結果とします。

  3. onlyAddToElementStack が false の場合、element を使用して調整された挿入場所に要素を挿入します。

  4. element を開いている要素のスタックにプッシュして、新しい現在のノードにします。

  5. element を返します。

トークン token を指定してHTML 要素を挿入するには、token、HTML 名前空間、および false を指定して外部要素を挿入します。

次の手順が、トークンのためにMathML属性を調整することをユーザーエージェントに要求する場合、トークンにdefinitionurlという名前の属性がある場合、その名前をdefinitionURLに変更します（大文字と小文字の違いに注意してください）。

次の手順が、トークンのためにSVG属性を調整することをユーザーエージェントに要求する場合、トークンの各属性について、その属性名が次の表の第一列にあるものの一つである場合、その属性の名前を対応する第二列の名前に変更します（これは、大文字と小文字がすべて小文字でないSVG属性を修正するものです）。

トークン上の属性名 要素上の属性名
attributename attributeName
attributetype attributeType
basefrequency baseFrequency
baseprofile baseProfile
calcmode calcMode
clippathunits clipPathUnits
diffuseconstant diffuseConstant
edgemode edgeMode
filterunits filterUnits
glyphref glyphRef
gradienttransform gradientTransform
gradientunits gradientUnits
kernelmatrix kernelMatrix
kernelunitlength kernelUnitLength
keypoints keyPoints
keysplines keySplines
keytimes keyTimes
lengthadjust lengthAdjust
limitingconeangle limitingConeAngle
markerheight markerHeight
markerunits markerUnits
markerwidth markerWidth
maskcontentunits maskContentUnits
maskunits maskUnits
numoctaves numOctaves
pathlength pathLength
patterncontentunits patternContentUnits
patterntransform patternTransform
patternunits patternUnits
pointsatx pointsAtX
pointsaty pointsAtY
pointsatz pointsAtZ
preservealpha preserveAlpha
preserveaspectratio preserveAspectRatio
primitiveunits primitiveUnits
refx refX
refy refY
repeatcount repeatCount
repeatdur repeatDur
requiredextensions requiredExtensions
requiredfeatures requiredFeatures
specularconstant specularConstant
specularexponent specularExponent
spreadmethod spreadMethod
startoffset startOffset
stddeviation stdDeviation
stitchtiles stitchTiles
surfacescale surfaceScale
systemlanguage systemLanguage
tablevalues tableValues
targetx targetX
targety targetY
textlength textLength
viewbox viewBox
viewtarget viewTarget
xchannelselector xChannelSelector
ychannelselector yChannelSelector
zoomandpan zoomAndPan

次の手順が、トークンのために外部属性を調整することをユーザーエージェントに要求する場合、トークン上の属性が以下の表の第一列に記載されている文字列と一致する場合、その属性を名前空間付き属性とし、接頭辞を対応する第二列の文字列、ローカル名を対応する第三列の文字列、名前空間を対応する第四列の名前空間に設定します。（これは特に、lang属性をXML名前空間で修正するものです。）

属性名 接頭辞 ローカル名 名前空間
xlink:actuate xlink actuate XLink名前空間
xlink:arcrole xlink arcrole XLink名前空間
xlink:href xlink href XLink名前空間
xlink:role xlink role XLink名前空間
xlink:show xlink show XLink名前空間
xlink:title xlink title XLink名前空間
xlink:type xlink type XLink名前空間
xml:lang xml lang XML名前空間
xml:space xml space XML名前空間
xmlns (なし) xmlns XMLNS名前空間
xmlns:xlink xmlns xlink XMLNS名前空間

次の手順が、トークンを処理しながら文字を挿入することをユーザーエージェントに要求する場合、ユーザーエージェントは次の手順を実行する必要があります：

  1. dataをアルゴリズムに渡された文字、または明示的に指定されていない場合は、処理されている文字トークンの文字とします。

  2. adjusted insertion locationをノードを挿入する適切な場所とします。

  3. もしadjusted insertion locationがDocumentノード内にある場合、終了します。

    DOMはDocumentノードがTextノードの子供を持つことを許さないので、それらは破棄されます。

  4. もしadjusted insertion locationの直前にTextノードがある場合、dataをそのTextノードのdataに追加します。

    そうでない場合、dataを持つ新しいTextノードを作成し、そのdataがdataであり、そのノードドキュメントがadjusted insertion locationが存在する要素と同じものであるようにし、新しく作成されたノードをadjusted insertion locationに挿入します。

以下に、スクリプトを実行するユーザーエージェントを想定した場合の、パーサーへの入力とそれによって生成されるTextノードの数の例を示します。

入力 Textノードの数 
A<script>
 var script = document.getElementsByTagName('script')[0];
 document.body.removeChild(script);
 </script>B
ドキュメント内に1つのTextノードがあり、"AB"を含んでいます。 
A<script>
 var text = document.createTextNode('B');
 document.body.appendChild(text);
 </script>C
スクリプトの前に"A"、スクリプトの内容、スクリプトの後に"BC"を含む3つのTextノード（パーサーはスクリプトによって作成されたTextノードに追加します）。 
A<script>
 var text = document.getElementsByTagName('script')[0].firstChild;
 text.data = 'B';
 document.body.appendChild(text);
 </script>C
ドキュメント内に2つの隣接するTextノードがあり、"A"と"BC"を含んでいます。 
A<table>B<tr>C</tr>D</table>
テーブルの前に1つのTextノードがあり、"ABCD"を含んでいます。（これは養育親の概念によるものです。） 
A<table><tr> B</tr> C</table>
テーブルの前に1つのTextノードがあり、"A B C"（A-スペース-B-スペース-C）を含んでいます。（これは養育親の概念によるものです。） 
A<table><tr> B</tr> </em>C</table>
テーブルの前に1つのTextノードがあり、"A BC"（A-スペース-B-C）を含み、テーブル内に1つのTextノード（tbodyの子要素として）を持ち、単一のスペース文字を含んでいます。（非文字トークンによって非スペース文字から分離されたスペース文字は、他のトークンが無視される場合でも養育親の概念の影響を受けません。）
s

次の手順が、コメントトークンを処理しながらコメントを挿入することをユーザーエージェントに要求する場合、オプションで明示的な挿入位置positionを指定して、ユーザーエージェントは次の手順を実行する必要があります：

  1. dataを処理されているコメントトークンで指定されたデータとします。

  2. もしpositionが指定されていた場合、adjusted insertion locationをpositionとします。そうでない場合は、adjusted insertion locationをノードを挿入する適切な場所とします。

  3. Commentノードを作成し、そのdata属性をdataに設定し、そのノードドキュメントをadjusted insertion locationが存在するノードと同じものとします。

  4. 新しく作成されたノードをadjusted insertion locationに挿入します。

13.2.6.2テキストのみを含む要素の解析

汎用生テキスト要素解析アルゴリズムと汎用RCDATA要素解析アルゴリズムは次の手順から構成されます。これらのアルゴリズムは常に開始タグトークンに応答して呼び出されます。

  1. そのトークンのためにHTML要素を挿入する。

  2. 呼び出されたアルゴリズムが汎用生テキスト要素解析アルゴリズムである場合、トークナイザーをRAWTEXT状態に切り替えます。それ以外の場合は、呼び出されたアルゴリズムは汎用RCDATA要素解析アルゴリズムであり、トークナイザーをRCDATA状態に切り替えます。

  3. 元の挿入モードを現在の挿入モードとします。

  4. 次に、挿入モードを"テキスト"に切り替えます。

13.2.6.3暗黙の終了タグを持つ要素を閉じる

次の手順が、ユーザーエージェントに暗黙の終了タグを生成することを要求する場合、現在のノードがdd要素、dt要素、li要素、optgroup要素、option要素、p要素、rb要素、rp要素、rt要素、またはrtc要素である限り、ユーザーエージェントは現在のノードをオープン要素のスタックからポップする必要があります。

ステップがユーザーエージェントに暗黙の終了タグを生成することを要求するが、そのプロセスから除外する要素をリストしている場合、ユーザーエージェントは、その要素が上記のリストにないかのように、上記のステップを実行しなければなりません。

次の手順が、ユーザーエージェントにすべての暗黙の終了タグを徹底的に生成することを要求する場合、現在のノードがcaption要素、colgroup要素、dd要素、dt要素、li要素、optgroup要素、option要素、p要素、rb要素、rp要素、rt要素、rtc要素、tbody要素、td要素、tfoot要素、th要素、thead要素、またはtr要素である限り、ユーザーエージェントは現在のノードをオープン要素のスタックからポップする必要があります。

13.2.6.4HTMLコンテンツのトークン解析ルール
13.2.6.4.1「初期」挿入モード

Documentオブジェクトには、パーサーがモードを変更できないフラグ（ブール値）が関連付けられています。このフラグは最初はfalseに設定されています。

ユーザーエージェントが「初期」挿入モードのルールを適用する際、ユーザーエージェントは以下のようにトークンを処理する必要があります：

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかの文字トークン

トークンを無視します。

コメントトークン

コメントを挿入して、Documentオブジェクトの最後の子要素として配置します。

DOCTYPEトークン

DOCTYPEトークンの名前が"html"でない場合、またはトークンのパブリック識別子が欠落していない場合、またはトークンのシステム識別子が欠落していないか、"about:legacy-compat"でない場合、解析エラーが発生します。

DocumentTypeノードをDocumentノードに追加し、そのname属性をDOCTYPEトークンで指定された名前に設定します（名前が欠落している場合は空文字列）。public ID属性はDOCTYPEトークンで指定されたパブリック識別子に設定します（パブリック識別子が欠落している場合は空文字列）。system ID属性はDOCTYPEトークンで指定されたシステム識別子に設定します（システム識別子が欠落している場合は空文字列）。

これにより、DocumentTypeノードがdoctype属性の値として返されることも保証されます。

次に、ドキュメントが「iframe srcdoc」ドキュメントでない場合、かつパーサーがモードを変更できないフラグがfalseであり、かつDOCTYPEトークンが次のリストにある条件のいずれかに一致する場合、Documentをクイークスモードに設定します：

それ以外の場合、ドキュメントが「iframe srcdoc」ドキュメントでない場合、かつパーサーがモードを変更できないフラグがfalseであり、かつDOCTYPEトークンが次のリストにある条件のいずれかに一致する場合、Documentを制限付きクイークスモードに設定します：

システム識別子およびパブリック識別子の文字列は、上記の値とASCIIケースインセンシティブな方法で比較する必要があります。システム識別子の値が空文字列である場合、上記の条件の目的のためには欠落しているとは見なされません。

次に、挿入モードを"before html"に切り替えます。

それ以外

ドキュメントが「iframe srcdoc」ドキュメントでない場合、これは解析エラーです。また、パーサーがモードを変更できないフラグがfalseであれば、Documentをクイークスモードに設定します。

いずれにしても、挿入モードを"before html"に切り替え、そのトークンを再処理します。

13.2.6.4.2「htmlの前」挿入モード

ユーザーエージェントが「htmlの前」挿入モードのルールを適用する際、ユーザーエージェントは以下のようにトークンを処理する必要があります：

DOCTYPEトークン

解析エラー。トークンを無視します。

コメントトークン

コメントを挿入して、Documentオブジェクトの最後の子要素として配置します。

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかの文字トークン

トークンを無視します。

タグ名が"html"の開始タグ

トークンの要素を作成し、HTML名前空間に追加します。Documentを親要素として指定し、それをDocumentオブジェクトに追加します。この要素をスタックのオープン要素に配置します。

挿入モードを「headの前」に切り替えます。

タグ名が次のいずれかである終了タグ: "head", "body", "html", "br"

以下の「その他の項目」の記述に従って処理します。

その他の終了タグ

解析エラー。トークンを無視します。

その他の項目

html要素を作成し、そのノードドキュメントがDocumentオブジェクトであるようにします。それをDocumentオブジェクトに追加し、この要素をスタックのオープン要素に配置します。

挿入モードを「headの前」に切り替え、そのトークンを再処理します。

ドキュメント要素は、例えばスクリプトによってDocumentオブジェクトから削除される可能性があります。このような場合でも、特に何も起こらず、次のセクションで説明されているようにノードにコンテンツが追加され続けます。

13.2.6.4.3「headの前」挿入モード

ユーザーエージェントが「headの前」挿入モードのルールを適用する際、ユーザーエージェントは以下のようにトークンを処理する必要があります：

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかの文字トークン

トークンを無視します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

解析エラー。トークンを無視します。

タグ名が"html"の開始タグ

トークンを次のルールを使用して処理します：「in body」挿入モード。

タグ名が"head"の開始タグ

トークンに対してHTML要素を挿入します。

head要素ポインタを新しく作成されたhead要素に設定します。

挿入モードを「in head」に切り替えます。

タグ名が次のいずれかである終了タグ: "head", "body", "html", "br"

以下の「その他の項目」の記述に従って処理します。

その他の終了タグ

解析エラー。トークンを無視します。

その他の項目

属性なしの"head"開始タグトークンに対してHTML要素を挿入します。

head要素ポインタを新しく作成されたhead要素に設定します。

挿入モードを「in head」に切り替えます。

現在のトークンを再処理します。

13.2.6.4.4「head内」挿入モード

ユーザーエージェントが「head内」挿入モードのルールを適用する際、ユーザーエージェントは以下のようにトークンを処理する必要があります：

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかの文字トークン

文字を挿入します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

解析エラー。トークンを無視します。

タグ名が"html"の開始タグ

トークンを次のルールを使用して処理します：「in body」挿入モード。

タグ名が"base"、"basefont"、"bgsound"、"link"のいずれかである開始タグ

HTML要素を挿入します。直ちに現在のノードをオープン要素のスタックからポップします。

トークンのセルフクロージングフラグが設定されている場合、それを確認します。

タグ名が"meta"である開始タグ

HTML要素を挿入します。直ちに現在のノードをオープン要素のスタックからポップします。

トークンのセルフクロージングフラグが設定されている場合、それを確認します。

もしアクティブな推測HTMLパーサーがnullである場合、以下の手順を実行します:

  1. その要素がcharset属性を持っており、その値からエンコーディングを取得するとエンコーディングが得られ、現在の信頼度が暫定的であれば、その結果に基づいてエンコーディングを変更します。

  2. また、その要素がhttp-equiv属性を持ち、その値が文字列"Content-Type"とASCIIケース非区別で一致し、かつその要素がcontent属性を持ち、その属性値に対してmeta要素から文字エンコーディングを抽出するアルゴリズムを適用するとエンコーディングが得られ、現在の信頼度が暫定的であれば、その抽出されたエンコーディングに基づいてエンコーディングを変更します。

推測HTMLパーサーは、実装の複雑さを減らすために、文字エンコーディングの宣言を推測的に適用しません。

タグ名が"タイトル"である開始タグ

汎用RCDATA要素解析アルゴリズムに従います。

タグ名が"noscript"であり、スクリプトフラグが有効である場合の開始タグ
タグ名が"noframes"、"style"のいずれかである開始タグ

汎用生テキスト要素解析アルゴリズムに従います。

タグ名が"noscript"であり、スクリプトフラグが無効である場合の開始タグ

HTML要素を挿入します。

挿入モードを「head内noscript」に切り替えます。

タグ名が"script"である開始タグ

以下の手順を実行します：

  1. adjusted insertion locationを適切なノード挿入場所に設定します。

  2. トークンに対応する要素を作成し、adjusted insertion locationが見つかる要素をintended parentに設定します。

  3. 要素のパーサー文書を文書に設定し、要素の強制非同期をfalseに設定します。

    これにより、スクリプトが外部にある場合、そのスクリプト内のdocument.write()呼び出しがインラインで実行され、通常は文書が破棄される他の多くのケースとは異なり、この現象が回避されます。また、終了タグが見つかるまでスクリプトの実行を遅延させることも防止されます。

  4. パーサーがHTMLフラグメント解析アルゴリズムの一部として作成された場合、スクリプト要素の既に開始されたフラグをtrueに設定します。(フラグメントケース)

  5. パーサーがdocument.write()またはdocument.writeln()メソッドを通じて呼び出された場合、オプションでスクリプト要素の既に開始されたフラグをtrueに設定します。（例えば、ユーザーエージェントはこの条項を利用して、document.write()を介して挿入されたクロスオリジンスクリプトの実行を、ネットワーク条件が遅い場合やページの読み込みに長時間かかる場合に防止することができます。）

  6. 新しく作成された要素をadjusted insertion locationに挿入します。

  7. その要素をオープン要素のスタックに追加し、それを新しい現在のノードにします。

  8. トークナイザをスクリプトデータ状態に切り替えます。

  9. 元の挿入モードを現在の挿入モードに設定します。

  10. 挿入モードを「テキスト」に切り替えます。

タグ名が"head"である終了タグ

現在のノード（これはhead要素である）をオープン要素のスタックからポップします。

挿入モードを「head後」に切り替えます。

タグ名が"body"、"html"、"br"のいずれかである終了タグ

以下の「その他の項目」の記述に従って処理します。

タグ名が"template"である開始タグ

以下のステップを実行します。

  1. templateStartTag を開始タグとします。

  2. アクティブな書式設定要素のリストの末尾にマーカーを挿入します。

  3. frameset-ok フラグを「not ok」に設定します。

  4. 挿入モードを「in template」に切り替えます。

  5. 「in template」をテンプレート挿入モードのスタックにプッシュして、新しい現在のテンプレート挿入モードにします。

  6. adjustedInsertionLocation をノードを挿入する適切な場所とします。

  7. intendedParent を adjustedInsertionLocation が存在する要素とします。

  8. document を intendedParent の ノードドキュメントとします。

  9. 以下のいずれかが false の場合：

    その場合、トークンに対してHTML 要素を挿入します。

  10. それ以外の場合：

    1. declarativeShadowHostElement を調整された現在のノードとします。

    2. template を、templateStartTag に対して、HTML 名前空間と true を指定して外部要素を挿入した結果とします。

    3. mode を templateStartTag の shadowrootmode 属性の値とします。

    4. clonable を、templateStartTag が shadowrootclonable 属性を持つ場合は true とし、それ以外の場合は false とします。

    5. serializable を、templateStartTag が shadowrootserializable 属性を持つ場合は true とし、それ以外の場合は false とします。

    6. delegatesFocus を、templateStartTag が shadowrootdelegatesfocus 属性を持つ場合は true とし、それ以外の場合は false とします。

    7. declarativeShadowHostElement がシャドウホストの場合、template を使用して調整された挿入場所に要素を挿入します。

    8. それ以外の場合：

      1. registry を declarativeShadowHostElement の カスタム要素レジストリとします。

      2. templateStartTag が shadowrootcustomelementregistry 属性を持つ場合、registry を null に設定します。

      3. declarativeShadowHostElement、mode、clonable、serializable、delegatesFocus、「named」、および registry を使用してシャドウ ルートをアタッチします。

        例外がスローされた場合は、それをキャッチして次のようにします。

        1. template を使用して調整された挿入場所に要素を挿入します。

        2. ユーザーエージェントは開発者コンソールにエラーを報告することがあります。

        3. 戻ります。

      4. shadow を declarativeShadowHostElement の シャドウ ルートとします。

      5. shadow の declarative を true に設定します。

      6. template の template contents プロパティを shadow に設定します。

      7. shadow の available to element internals を true に設定します。

      8. templateStartTag が shadowrootcustomelementregistry 属性を持つ場合、shadow の keep custom element registry null を true に設定します。

タグ名が"template"である終了タグ

template要素がオープン要素のスタックにない場合、これは解析エラーです。トークンを無視します。

それ以外の場合、以下の手順を実行します：

  1. すべての暗示的な終了タグを徹底的に生成します。

  2. 現在のノードがtemplate要素でない場合、これは解析エラーです。

  3. オープン要素のスタックからtemplate要素がポップされるまで要素をポップします。

  4. 最後のマーカーまでのアクティブな書式設定要素のリストをクリアします。

  5. 現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

  6. 適切に挿入モードをリセットします。

タグ名が"head"である開始タグ
その他の終了タグ

解析エラー。トークンを無視します。

その他のもの

現在のノード（これはhead要素である）をオープン要素のスタックからポップします。

挿入モードを「head後」に切り替えます。

トークンを再処理します。

13.2.6.4.5 「in head noscript」 挿入モード

ユーザーエージェントが「in head noscript」挿入モードのルールを適用する場合、 ユーザーエージェントはトークンを以下のように処理する必要があります。

DOCTYPEトークン

構文エラー。トークンを無視します。

タグ名が「html」の開始タグ

トークンを「in body」挿入モードのルールに従って処理します。

タグ名が「noscript」の終了タグ

現在のノード（これはnoscript要素になります）をオープン要素のスタックからポップします。新しい現在のノードはhead要素になります。

挿入モードを「in head」に切り替えます。

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかである文字トークン
コメントトークン
タグ名が「basefont」、「bgsound」、「link」、「meta」、「noframes」、「style」の開始タグ

トークンを「in head」挿入モードのルールに従って処理します。

タグ名が「br」の終了タグ

以下の「その他の項目」に記載された処理を実行します。

タグ名が「head」または「noscript」の開始タグ
その他の終了タグ

構文エラー。トークンを無視します。

その他の項目

構文エラー。

現在のノード（これはnoscript要素になります）をオープン要素のスタックからポップします。新しい現在のノードはhead要素になります。

挿入モードを「in head」に切り替えます。

トークンを再処理します。

13.2.6.4.6「ヘッド後」挿入モード

ユーザーエージェントが「ヘッド後」挿入モードのルールを適用する場合、ユーザーエージェントはトークンを以下のように処理する必要があります。

U+0009 文字タブ、U+000A ラインフィード（LF）、U+000C フォームフィード（FF）、U+000D キャリッジリターン（CR）、またはU+0020 スペースのいずれかの文字トークン

文字を挿入します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

構文エラー。トークンを無視します。

タグ名が「html」の開始タグ

トークンを「インボディ」挿入モードのルールに従って処理します。

タグ名が「body」の開始タグ

HTML要素を挿入します。

frameset-okフラグを「not ok」に設定します。

挿入モードを「インボディ」に切り替えます。

タグ名が「frameset」の開始タグ

HTML要素を挿入します。

挿入モードを「インフレームセット」に切り替えます。

タグ名が「base」、「basefont」、「bgsound」、「link」、「meta」、「noframes」、「script」、「style」、「template」、「title」のいずれかである開始タグ

構文エラー。

ヘッド要素ポインタで指し示されているノードをオープン要素のスタックにプッシュします。

トークンを「インヘッド」挿入モードのルールに従って処理します。

ヘッド要素ポインタで指し示されているノードをオープン要素のスタックから取り除きます。（この時点で必ずしも現在のノードであるとは限りません。）

ヘッド要素ポインタはこの時点でnullであることはありません。

タグ名が「template」の終了タグ

トークンを「インヘッド」挿入モードのルールに従って処理します。

タグ名が「body」、「html」、「br」のいずれかである終了タグ

以下の「その他の項目」に記載された処理を実行します。

タグ名が「head」の開始タグ
その他の終了タグ

構文エラー。トークンを無視します。

その他の項目

「body」開始タグトークンに属性なしでHTML要素を挿入します。

挿入モードを「インボディ」に切り替えます。

現在のトークンを再処理します。

13.2.6.4.7「本文内」挿入モード

ユーザーエージェントが「本文内」挿入モードのルールを適用する場合、ユーザーエージェントはトークンを次のように処理する必要があります。

U+0000 NULLの文字トークン

構文エラー。トークンを無視します。

U+0009 文字タブ、U+000A ラインフィード (LF)、U+000C フォームフィード (FF)、U+000D キャリッジリターン (CR)、またはU+0020 スペースのいずれかの文字トークン

アクティブフォーマット要素を再構築します、ある場合。

トークンの文字を挿入します。

その他の文字トークン

アクティブフォーマット要素を再構築します、ある場合。

トークンの文字を挿入します。

frameset-okフラグを「not ok」に設定します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

構文エラー。トークンを無視します。

タグ名が「html」の開始タグ

構文エラー。

オープン要素のスタックにテンプレート要素がある場合、トークンを無視します。

それ以外の場合、トークンの各属性について、その属性がオープン要素のスタックの最上位要素に既に存在するかどうかを確認します。存在しない場合、その属性と対応する値をその要素に追加します。

タグ名が「base」、「basefont」、「bgsound」、「link」、「meta」、「noframes」、「script」、「style」、「template」、「title」のいずれかである開始タグ
タグ名が「template」の終了タグ

トークンを「インヘッド」挿入モードのルールに従って処理します。

タグ名が「body」の開始タグ

構文エラー。

オープン要素のスタックにノードが1つしかない場合、オープン要素のスタックの2番目の要素がbody要素でない場合、またはオープン要素のスタックにテンプレート要素がある場合は、トークンを無視します。

それ以外の場合、frameset-okフラグを「not ok」に設定し、その後トークンの各属性について、その属性がbody要素（2番目の要素）に既に存在するかどうかを確認し、存在しない場合、その属性と対応する値をその要素に追加します。

タグ名が「frameset」の開始タグ

構文エラー。

オープン要素のスタックにノードが1つしかない場合、またはオープン要素のスタックの2番目の要素がbody要素でない場合、トークンを無視します。

frameset-okフラグが「not ok」に設定されている場合、トークンを無視します。

それ以外の場合、以下の手順を実行します:

  1. オープン要素のスタックの2番目の要素を親ノードから削除します。

  2. 現在のノードから始めて、オープン要素のスタックの下位のノードをすべてポップします。

  3. HTML要素を挿入します。

  4. 挿入モードを「フレームセット内」に切り替えます。

ファイルの終わりのトークン

テンプレート挿入モードのスタックが空でない場合、トークンを「テンプレート内」挿入モードのルールに従って処理します。

それ以外の場合、次の手順を実行します:

  1. オープン要素のスタックに、dd、dt、li、optgroup、option、p、rb、rp、rt、rtc、tbody、td、tfoot、th、thead、tr、body、またはhtmlでないノードが含まれている場合、これは構文エラーです。

  2. 解析を停止します。

タグ名が「body」の終了タグ

オープン要素のスタックにbody要素がスコープ内にない場合、これは構文エラーです。トークンを無視します。

それ以外の場合、オープン要素のスタックにdd、dt、li、optgroup、option、p、rb、rp、rt、rtc、tbody、td、tfoot、th、thead、tr、body、またはhtmlでないノードが含まれている場合、これは構文エラーです。

挿入モードを「本文後」に切り替えます。

タグ名が「html」の終了タグ

オープン要素のスタックにbody要素がスコープ内にない場合、これは構文エラーです。トークンを無視します。

それ以外の場合、オープン要素のスタックにdd、dt、li、optgroup、option、p、rb、rp、rt、rtc、tbody、td、tfoot、th、thead、tr、body、またはhtmlでないノードが含まれている場合、これは構文エラーです。

挿入モードを「本文後」に切り替えます。

トークンを再処理します。

開始タグのタグ名が次のいずれかである場合: "address", "article", "aside", "blockquote", "center", "details", "dialog", "dir", "div", "dl", "fieldset", "figcaption", "figure", "footer", "header", "hgroup", "main", "menu", "nav", "ol", "p", "search", "section", "summary", "ul"

もしオープン要素のスタックにボタンスコープ内にp要素がある場合、p要素を閉じる。

トークンのためにHTML要素を挿入する。

開始タグのタグ名が次のいずれかである場合: "h1", "h2", "h3", "h4", "h5", "h6"

もしオープン要素のスタックにボタンスコープ内にp要素がある場合、p要素を閉じる。

もし現在のノードがタグ名が "h1", "h2", "h3", "h4", "h5", "h6" のいずれかであるHTML要素である場合、これは構文エラーであり、現在のノードをオープン要素のスタックからポップする。

トークンのためにHTML要素を挿入する。

開始タグのタグ名が "pre" または "listing" である場合

もしオープン要素のスタックにボタンスコープ内にp要素がある場合、p要素を閉じる。

トークンのためにHTML要素を挿入する。

もし次のトークンが U+000A LINE FEED (LF) 文字トークンである場合、そのトークンを無視し、次のトークンに進む。（pre ブロックの最初の改行は、著者の利便性のために無視される。）

frameset-ok フラグを「not ok」に設定する。

開始タグのタグ名が "form" である場合

もしform要素ポインタがnullでなく、かつtemplate要素がオープン要素のスタックに存在しない場合、これは構文エラーであり、そのトークンを無視する。

それ以外の場合:

もしオープン要素のスタックにボタンスコープ内にp要素がある場合、p要素を閉じる。

トークンのためにHTML要素を挿入する。そして、もしtemplate要素がオープン要素のスタックに存在しない場合、form要素ポインタを作成された要素を指すように設定する。

開始タグのタグ名が "li" である場合

次の手順を実行する:

  1. frameset-ok フラグを「not ok」に設定する。

  2. nodeを現在のノード（スタックの最下部のノード）に初期化する。

  3. ループ: もしnodeがli要素である場合、次のサブステップを実行する:

    1. 暗黙の終了タグを生成する、ただしli要素を除く。

    2. もし現在のノードがli要素でない場合、これは構文エラーである。

    3. オープン要素のスタックからli要素がポップされるまで要素をポップする。

    4. 完了のラベルが付いたステップに進む。

  4. もしnodeが特別なカテゴリに属しているが、address、div、またはp要素でない場合、完了のラベルが付いたステップに進む。

  5. それ以外の場合、nodeをオープン要素のスタックの前のエントリに設定し、ループのラベルが付いたステップに戻る。

  6. 完了: もしオープン要素のスタックにボタンスコープ内にp要素がある場合、p要素を閉じる。

  7. 最後に、トークンのためにHTML要素を挿入する。

開始タグのタグ名が次のいずれかである場合: "dd", "dt"

次の手順を実行する:

  1. frameset-ok フラグを「not ok」に設定する。

  2. nodeを現在のノード（スタックの最下部のノード）に初期化する。

  3. ループ: もしnodeがdd要素である場合、次のサブステップを実行する:

    1. 暗黙の終了タグを生成する、ただしdd要素を除く。

    2. もし現在のノードがdd要素でない場合、これは構文エラーである。

    3. オープン要素のスタックからdd要素がポップされるまで要素をポップする。

    4. 完了のラベルが付いたステップに進む。

  4. もしnodeがdt要素である場合、次のサブステップを実行する:

    1. 暗黙の終了タグを生成する、ただしdt要素を除く。

    2. もし現在のノードがdt要素でない場合、これは構文エラーである。

    3. オープン要素のスタックからdt要素がポップされるまで要素をポップする。

    4. 完了のラベルが付いたステップに進む。

  5. もしnodeが特別なカテゴリに属しているが、address、div、またはp要素でない場合、完了のラベルが付いたステップに進む。

  6. それ以外の場合、nodeをオープン要素のスタックの前のエントリに設定し、ループのラベルが付いたステップに戻る。

  7. 完了: もしオープン要素のスタックにボタンスコープ内にp要素がある場合、p要素を閉じる。

  8. 最後に、トークンのためにHTML要素を挿入する。

開始タグのタグ名が "plaintext" である場合

もしオープン要素のスタックがボタンスコープにp要素を持っている場合、p要素を閉じる。

トークンのためにHTML要素を挿入する。

トークナイザをPLAINTEXT状態に切り替える。

一度 "plaintext" というタグ名の開始タグが表示されると、すべての残りのトークンは文字トークン（および最後のファイル終了トークン）になる。なぜなら、トークナイザをPLAINTEXT状態から切り替える方法がないからである。しかし、ツリービルダーが既存の挿入モードのままであるため、これらの文字トークンを処理する際にアクティブなフォーマット要素を再構築することがある。これにより、パーサーがplaintext要素に他の要素を挿入することができる。

開始タグのタグ名が "button" である場合

  1. もしオープン要素のスタックがbutton要素をスコープに持っている場合、次のサブステップを実行する:

    1. 構文エラー。

    2. 暗黙の終了タグを生成する。

    3. オープン要素のスタックからbutton要素がポップされるまで要素をポップする。

  2. もしあれば、アクティブなフォーマット要素を再構築する。

  3. トークンのためにHTML要素を挿入する。

  4. frameset-ok フラグを「not ok」に設定する。

終了タグのタグ名が "address", "article", "aside", "blockquote", "button", "center", "details", "dialog", "dir", "div", "dl", "fieldset", "figcaption", "figure", "footer", "header", "hgroup", "listing", "main", "menu", "nav", "ol", "pre", "search", "section", "summary", "ul" のいずれかである場合

もしオープン要素のスタックが、トークンと同じタグ名を持つ要素がスコープにない場合、これは構文エラーである。トークンを無視する。

それ以外の場合、次の手順を実行する:

  1. 暗黙の終了タグを生成する。

  2. もし現在のノードがトークンと同じタグ名を持つHTML要素でない場合、これは構文エラーである。

  3. オープン要素のスタックから、トークンと同じタグ名を持つHTML要素がポップされるまで要素をポップする。

終了タグのタグ名が "form" である場合

もしオープン要素のスタックにtemplate要素がない場合、次のサブステップを実行する:

  1. form要素ポインタが設定されている要素をnodeに代入する。要素が設定されていない場合はnodeをnullに設定する。

  2. form要素ポインタをnullに設定する。

  3. もしnodeがnullであるか、またはオープン要素のスタックがnodeをスコープに持っていない場合、これは構文エラーであり、トークンを無視する。

  4. 暗黙の終了タグを生成する。

  5. もし現在のノードがnodeでない場合、これは構文エラーである。

  6. nodeをオープン要素のスタックから削除する。

もしオープン要素のスタックにtemplate要素が存在する場合、代わりに次のサブステップを実行する:

  1. もしオープン要素のスタックにform要素がスコープにない場合、これは構文エラーであり、トークンを無視する。

  2. 暗黙の終了タグを生成する。

  3. もし現在のノードがform要素でない場合、これは構文エラーである。

  4. オープン要素のスタックからform要素がポップされるまで要素をポップする。

終了タグのタグ名が "p" である場合

もしオープン要素のスタックにp要素がボタンスコープにない場合、これは構文エラーであり、属性なしの "p" 開始タグトークンとしてHTML要素を挿入する。

p要素を閉じる。

終了タグのタグ名が "li" である場合

もしオープン要素のスタックにli要素がリスト項目スコープにない場合、これは構文エラーであり、トークンを無視する。

それ以外の場合、次の手順を実行する:

  1. 暗黙の終了タグを生成する。ただし、li要素は除く。

  2. もし現在のノードがli要素でない場合、これは構文エラーである。

  3. オープン要素のスタックからli要素がポップされるまで要素をポップする。

終了タグのタグ名が "dd", "dt" のいずれかである場合

もしオープン要素のスタックがトークンと同じタグ名を持つ要素がスコープにない場合、これは構文エラーであり、トークンを無視する。

それ以外の場合、次の手順を実行する:

  1. 暗黙の終了タグを生成する。ただし、トークンと同じタグ名を持つHTML要素は除く。

  2. もし現在のノードがトークンと同じタグ名を持つHTML要素でない場合、これは構文エラーである。

  3. オープン要素のスタックから、トークンと同じタグ名を持つHTML要素がポップされるまで要素をポップする。

終了タグのタグ名が "h1", "h2", "h3", "h4", "h5", "h6" のいずれかである場合

もしオープン要素のスタックが、タグ名が "h1", "h2", "h3", "h4", "h5", "h6" のいずれかであるHTML要素をスコープに持っていない場合、これは構文エラーであり、トークンを無視する。

それ以外の場合、次の手順を実行する:

  1. 暗黙の終了タグを生成する。

  2. もし現在のノードがトークンと同じタグ名を持つHTML要素でない場合、これは構文エラーである。

  3. オープン要素のスタックから、タグ名が "h1", "h2", "h3", "h4", "h5", "h6" のいずれかであるHTML要素がポップされるまで要素をポップする。

終了タグのタグ名が "sarcasm" である場合

深呼吸してから、以下の「他の終了タグ」項目に記載されている通りに行動します。

開始タグのタグ名が "a" である場合

もしアクティブなフォーマット要素のリストにa要素があり、その要素がリストの最後のマーカーとリストの末尾の間に含まれている場合（またはマーカーがリストにない場合はリストの最初）、これは構文エラーです。そのトークンについて養子縁組機関アルゴリズムを実行し、その後、アクティブなフォーマット要素のリストおよびオープン要素のスタックからその要素を削除します（養子縁組機関アルゴリズムが既に削除していない場合は、削除します）。

不適合なストリーム<a href="a">a<table><a href="b">b</table>xでは、最初のa要素は2番目のものを見たときに閉じられ、「x」文字は「a」ではなく「b」へのリンク内に入ります。これは、外側のa要素がテーブルスコープ内にないにもかかわらず（テーブルの開始時の通常の</a>終了タグが外側のa要素を閉じないことを意味します）、発生します。その結果、2つのa要素が間接的に互いにネストされることになります。不適合なマークアップは、パースされたときに不適合なDOMになることがよくあります。

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。その要素をアクティブなフォーマット要素のリストに追加する。

開始タグのタグ名が "b", "big", "code", "em", "font", "i", "s", "small", "strike", "strong", "tt", "u" のいずれかである場合

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。その要素をアクティブなフォーマット要素のリストに追加する。

開始タグのタグ名が "nobr" である場合

アクティブなフォーマット要素を再構築する（あれば）。

もしオープン要素のスタックがスコープ内にnobr要素を含んでいる場合、これは構文エラーであり、そのトークンについて養子縁組機関アルゴリズムを実行し、再びアクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。その要素をアクティブなフォーマット要素のリストに追加する。

終了タグのタグ名が "a", "b", "big", "code", "em", "font", "i", "nobr", "s", "small", "strike", "strong", "tt", "u" のいずれかである場合

養子縁組機関アルゴリズムをそのトークンに対して実行する。

開始タグのタグ名が "applet", "marquee", "object" のいずれかである場合

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。

マーカーをアクティブなフォーマット要素のリストの最後に挿入する。

フレームセットOKフラグを "not ok" に設定する。

終了タグのタグ名が "applet", "marquee", "object" のいずれかである場合

もしオープン要素のスタックがトークンと同じタグ名を持つ要素をスコープに持っていない場合、これは構文エラーであり、トークンを無視する。

それ以外の場合、次の手順を実行する:

  1. 暗黙の終了タグを生成する。

  2. もし現在のノードがトークンと同じタグ名を持つHTML要素でない場合、これは構文エラーである。

  3. オープン要素のスタックから、トークンと同じタグ名を持つHTML要素がポップされるまで要素をポップする。

  4. 最後のマーカーまでアクティブなフォーマット要素のリストをクリアする。
開始タグのタグ名が "table" である場合

もしDocumentがクイークスモードに設定されていない場合、そしてオープン要素のスタックがp要素をボタンスコープに持っている場合、p要素を閉じる。

そのトークンに対してHTML要素を挿入する。

フレームセットOKフラグを "not ok" に設定する。

挿入モードを "テーブル内" に切り替える。

終了タグのタグ名が "br" である場合

構文エラー。トークンから属性を削除し、次のエントリに記載されているように行動する。すなわち、実際には終了タグトークンであるが、属性のない "br" 開始タグトークンであるかのように行動する。

開始タグのタグ名が "area", "br", "embed", "img", "keygen", "wbr" のいずれかである場合

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。直ちに現在のノードをオープン要素のスタックからポップする。

そのトークンの自己閉鎖フラグを認識する（設定されている場合）。

フレームセットOKフラグを "not ok" に設定する。

開始タグのタグ名が "input" である場合

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。直ちに現在のノードをオープン要素のスタックからポップする。

そのトークンの自己閉鎖フラグを認識する（設定されている場合）。

トークンが "type" という名前の属性を持たない場合、またはその属性がASCII大文字小文字を区別しない方法で "hidden" と一致しない場合、フレームセットOKフラグを "not ok" に設定する。

開始タグのタグ名が "param", "source", "track" のいずれかである場合

そのトークンに対してHTML要素を挿入する。直ちに現在のノードをオープン要素のスタックからポップする。

そのトークンの自己閉鎖フラグを認識する（設定されている場合）。

開始タグのタグ名が "hr" である場合

もしオープン要素のスタックがp要素をボタンスコープに持っている場合、p要素を閉じる。

そのトークンに対してHTML要素を挿入する。直ちに現在のノードをオープン要素のスタックからポップする。

そのトークンの自己閉鎖フラグを認識する（設定されている場合）。

フレームセットOKフラグを "not ok" に設定する。

開始タグのタグ名が "image" である場合

構文エラー。トークンのタグ名を "img" に変更し、再処理する。（質問しないでください。）

開始タグのタグ名が "textarea" である場合

次の手順を実行する:

  1. そのトークンに対してHTML要素を挿入する。

  2. もし次のトークンがU+000A LINE FEED (LF) 文字トークンである場合、そのトークンを無視し、次のトークンに進む。（textarea要素の先頭にある改行は、作成者の便宜として無視される。）

  3. トークナイザをRCDATA状態に切り替える。

  4. 元の挿入モードを現在の挿入モードとする。

  5. フレームセットOKフラグを "not ok" に設定する。

  6. 挿入モードを"text"に切り替える。

開始タグのタグ名が "xmp" である場合

もしオープン要素のスタックがp要素をボタンスコープに持っている場合、p要素を閉じる。

アクティブなフォーマット要素を再構築する（あれば）。

フレームセットOKフラグを "not ok" に設定する。

一般的な生テキスト要素の解析アルゴリズムに従う。

開始タグのタグ名が "iframe" である場合

フレームセットOKフラグを "not ok" に設定する。

一般的な生テキスト要素の解析アルゴリズムに従う。

開始タグのタグ名が "noembed" である場合
開始タグのタグ名が "noscript" であり、スクリプトフラグが有効である場合

一般的な生テキスト要素の解析アルゴリズムに従う。

開始タグのタグ名が "select" である場合

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。

フレームセットOKフラグを "not ok" に設定する。

もし挿入モードが"テーブル内、"キャプション内"、"テーブルボディ内"、"行内"、または"セル内"のいずれかである場合、挿入モードを"テーブル内の選択"に切り替える。それ以外の場合は、挿入モードを"選択内"に切り替える。

開始タグのタグ名が "optgroup"、"option" のいずれかである場合

もし現在のノードがoption要素である場合、現在のノードをオープン要素のスタックからポップする。

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。

開始タグのタグ名が "rb"、"rtc" のいずれかである場合

もしオープン要素のスタックがruby要素をスコープに持っている場合、暗黙の終了タグを生成する。もし現在のノードが今ruby要素でない場合、これは構文エラーである。

そのトークンに対してHTML要素を挿入する。

開始タグのタグ名が "rp"、"rt" のいずれかである場合

もしオープン要素のスタックがruby要素をスコープに持っている場合、暗黙の終了タグを生成する、ただしrtc要素は除く。もし現在のノードが今rtc要素またはruby要素でない場合、これは構文エラーである。

そのトークンに対してHTML要素を挿入する。

開始タグのタグ名が "math" である場合

アクティブなフォーマット要素を再構築する（あれば）。

トークンのMathML属性を調整する。（これは、MathML属性がすべて小文字でない場合を修正する。）

トークンの外部属性を調整する。（これは、特にXLinkにおいて名前空間付き属性の使用を修正する。）

そのトークンに対して外部要素を挿入する、MathML名前空間とfalseを指定する。

もしトークンが自己閉鎖フラグを設定している場合、現在のノードをオープン要素のスタックからポップし、そのトークンの自己閉鎖フラグを認識する。

開始タグのタグ名が "svg" である場合

アクティブなフォーマット要素を再構築する（あれば）。

トークンのSVG属性を調整する。（これは、SVG属性がすべて小文字でない場合を修正する。）

トークンの外部属性を調整する。（これは、特にSVGにおけるXLinkの使用を修正する。）

そのトークンに対して外部要素を挿入する、SVG名前空間とfalseを指定する。

もしトークンが自己閉鎖フラグを設定している場合、現在のノードをオープン要素のスタックからポップし、そのトークンの自己閉鎖フラグを認識する。

開始タグのタグ名が "caption", "col", "colgroup", "frame", "head", "tbody", "td", "tfoot", "th", "thead", "tr" のいずれかである場合

構文エラー。そのトークンを無視する。

その他の開始タグ

アクティブなフォーマット要素を再構築する（あれば）。

そのトークンに対してHTML要素を挿入する。

この要素は通常の要素となる。例外は1つだけで、スクリプトフラグが無効になっている場合、noscript要素であることもある。

その他の終了タグ

次の手順を実行します：

  1. nodeを現在のノード（スタックの最下層のノード）に初期化します。

  2. ループ：もしnodeがHTML要素であり、そのタグ名がトークンと同じ場合、以下の手順を実行します：

    1. 暗黙の終了タグを生成する、ただし、トークンと同じタグ名を持つHTML要素は除く。

    2. もしnodeが現在のノードでない場合、これは構文エラーです。

    3. nodeを含むまで、現在のノードからnodeまでのすべてのノードをポップして、これらの手順を終了します。

  3. それ以外の場合、もしnodeが特別なカテゴリにある場合、これは構文エラーです；トークンを無視し、返します。

  4. nodeをオープン要素のスタック内の前のエントリに設定します。

  5. ループというラベルが付けられた手順に戻ります。

上記の手順でユーザーエージェントがp要素を閉じるよう指示されている場合、それはユーザーエージェントが次の手順を実行することを意味します：

  1. 暗黙の終了タグを生成する、ただし、p要素は除く。

  2. もし現在のノードがp要素でない場合、これは構文エラーです。

  3. p要素がスタックからポップされるまで、オープン要素のスタックから要素をポップします。

養子縁組エージェンシーアルゴリズムは、アルゴリズムが実行されるトークンtokenを唯一の引数として取り、次の手順で構成されます。

  1. subjectをtokenのタグ名に設定します。

  2. もし現在のノードがHTML要素であり、そのタグ名がsubjectであり、かつ現在のノードがアクティブなフォーマット要素のリストに含まれていない場合、現在のノードをオープン要素のスタックからポップし、終了します。

  3. outerLoopCounterを0に設定します。

  4. 真である間:

    1. もしouterLoopCounterが8以上であれば、終了します。

    2. outerLoopCounterを1増やします。

    3. formattingElementをアクティブなフォーマット要素のリストの最後の要素として設定します。ただし、次の条件を満たす必要があります。

      • リストの終わりとリスト内の最後のマーカーの間、またはそのマーカーがない場合はリストの始まりの間にあり、
      • タグ名がsubjectであること。

      そのような要素が存在しない場合、終了し、代わりに上記の「他の終了タグ」エントリに記載されているように動作します。

    4. もしformattingElementがオープン要素のスタックにない場合、これは構文エラーです。要素をリストから削除し、終了します。

    5. もしformattingElementがオープン要素のスタックにあるが、その要素がスコープ内にない場合、これは構文エラーです。終了します。

    6. もしformattingElementが現在のノードでない場合、これは構文エラーです。（ただし、終了しません。）

    7. furthestBlockを、formattingElementよりスタック内で低い位置にある、オープン要素のスタック内の最上位のノードとして設定し、特別なカテゴリーに属する要素とします。存在しない場合もあります。

    8. もしfurthestBlockが存在しない場合、ユーザーエージェントはまずオープン要素のスタックの下から、現在のノードからformattingElementを含むまで、すべてのノードをポップし、その後formattingElementをアクティブなフォーマット要素のリストから削除し、最終的に終了します。

    9. commonAncestorをオープン要素のスタック内のformattingElementの直上の要素として設定します。

    10. ブックマークを設定し、formattingElementのアクティブなフォーマット要素のリスト内の位置を、そのリスト内の両側にある要素に対して相対的に記録します。

    11. nodeおよびlastNodeをfurthestBlockに設定します。

    12. innerLoopCounterを0に設定します。

    13. 真である間:

      1. innerLoopCounterを1増やします。

      2. nodeを、オープン要素のスタック内でnodeの直上にある要素として設定します。あるいは、nodeがnodeをスタックから削除したことにより、もはやスタックに存在しない場合、nodeが削除される前にオープン要素のスタック内でnodeの直上にあった要素を設定します。

      3. もしnodeがformattingElementである場合、終了します。

      4. もしinnerLoopCounterが3を超えており、nodeがアクティブなフォーマット要素のリストに含まれている場合、そのnodeをリストから削除します。

      5. もしnodeがアクティブなフォーマット要素のリストに含まれていない場合、そのnodeをオープン要素のスタックから削除し、次へ進みます。

      6. トークン用の要素を作成します、nodeが作成された要素で、commonAncestorを意図した親として設定し、HTML名前空間で、nodeを新しい要素に置き換え、アクティブなフォーマット要素のリストとオープン要素のスタック内のnodeのエントリを、新しい要素に置き換え、nodeを新しい要素にします。

      7. lastNode が furthestBlock の場合、前述のブックマークをアクティブな書式設定要素のリスト内の新しい node の直後に移動します。

      8. 最後のノードをnodeに追加します。

      9. lastNodeをnodeに設定します。

    14. 前のステップで得られたlastNodeを、ノードを挿入する適切な場所に挿入します。ただし、commonAncestorをオーバーライド対象として使用します。

    15. トークン用の要素を作成します、formattingElementが作成された要素で、furthestBlockを意図した親として設定し、HTML名前空間で。

    16. furthestBlockのすべての子ノードを取り出し、最後のステップで作成された要素に追加します。

    17. その新しい要素をfurthestBlockに追加します。

    18. formattingElementをアクティブなフォーマット要素のリストから削除し、上記のブックマークの位置に新しい要素をリストに挿入します。

    19. formattingElementをオープン要素のスタックから削除し、新しい要素をオープン要素のスタックのfurthestBlockの直下に挿入します。

このアルゴリズムの名前「養子縁組エージェンシーアルゴリズム」は、要素が親を変更する方法に由来し、誤った入れ子のコンテンツに対処するための他の可能なアルゴリズムとは対照的です。

13.2.6.4.8 「テキスト」挿入モード

ユーザーエージェントが「テキスト」挿入モードのルールを適用する場合、ユーザーエージェントはトークンを以下のように処理する必要があります。

文字トークン

トークンの文字を挿入します。

これはU+0000 NULL文字であることはできません。トークナイザーはこれをU+FFFD 置換文字に変換します。

ファイルの終わりのトークン

構文エラーです。

もし現在のノードがスクリプト要素である場合、そのすでに開始されているフラグをtrueに設定します。

現在のノードをオープン要素のスタックからポップします。

挿入モードを元の挿入モードに切り替え、そのトークンを再処理します。

タグ名が「script」である終了タグ

もしアクティブな推測的HTMLパーサーがnullであり、JavaScript実行コンテキストスタックが空である場合、マイクロタスクチェックポイントを実行します。

scriptを現在のノード（これはスクリプト要素になります）として設定します。

現在のノードをオープン要素のスタックからポップします。

挿入モードを元の挿入モードに切り替えます。

old insertion point を現在の挿入ポイントと同じ値に設定します。挿入ポイントを次の入力文字の直前に設定します。

パーサーのスクリプトネスティングレベルを1つ増やします。

もしアクティブな推測的HTMLパーサーがnullである場合、script要素を準備します。これにより、スクリプトが実行され、新しい文字がトークナイザーに挿入される可能性があり、トークナイザーがさらにトークンを出力し、パーサーの再帰的呼び出しが発生する可能性があります。

パーサーのスクリプトネスティングレベルを1つ減らします。もしパーサーのスクリプトネスティングレベルがゼロであれば、パーサー停止フラグをfalseに設定します。

挿入ポイントをold insertion point の値に設定します。（つまり、挿入ポイントを以前の値に戻します。この値は「未定義」の値である可能性があります。）

この段階で、もし保留中の解析ブロックスクリプトがnullでない場合、次のようにします。

もしスクリプトネスティングレベルがゼロでない場合:

パーサー停止フラグをtrueに設定し、ネストされたトークナイザーの呼び出しの処理を中止し、呼び出し元に制御を返します。（トークナイズは呼び出し元が「外部」のツリー構築段階に戻ったときに再開されます。）

この特定のパーサーのツリー構築段階は再帰的に呼び出されている、例えば、document.write()の呼び出しからです。

それ以外の場合:

次のように、保留中の解析ブロックスクリプトがnullでない間:

  1. the scriptを保留中の解析ブロックスクリプトに設定します。

  2. 保留中の解析ブロックスクリプトをnullに設定します。

  3. 推測的HTMLパーサーを開始します、このHTMLパーサーのインスタンスのために。

  4. このHTMLパーサーのインスタンスのために、トークナイザーをブロックします、イベントループがトークナイザーを呼び出すタスクを実行しないようにします。

  5. もしパーサーのドキュメントがスクリプトをブロックしているスタイルシートを持っている、またはthe scriptの準備ができているがfalseである場合、パーサーのドキュメントがスクリプトをブロックしているスタイルシートを持たず、the scriptの準備ができているがtrueになるまで、イベントループを回します。

  6. もしこのパーサーが中止されたなら、その時点で終了します。

    例えば、イベントループを回すアルゴリズムが実行されている間に、ドキュメントが破棄された、またはdocument.open()メソッドがドキュメントで呼び出される可能性があります。

  7. 推測的HTMLパーサーを停止します、このHTMLパーサーのインスタンスのために。

  8. このHTMLパーサーのインスタンスのために、トークナイザーのブロックを解除します、タスクがトークナイザーを呼び出せるようにします。

  9. 挿入ポイントを次の入力文字の直前に設定します。

  10. パーサーのスクリプトネスティングレベルを1つ増やします（これが1になります）。

  11. スクリプト要素を実行しますthe script。

  12. パーサーのスクリプトネスティングレベルを1つ減らします。もしパーサーのスクリプトネスティングレベルがゼロであれば（この時点でゼロであるはずです）、パーサー停止フラグをfalseに設定します。

  13. 挿入ポイントを再び未定義に設定します。

その他の終了タグ

現在のノードをオープン要素のスタックからポップします。

挿入モードを元の挿入モードに切り替えます。

13.2.6.4.9 「テーブル内」挿入モード

ユーザーエージェントが「テーブル内」挿入モードのルールを適用する場合、ユーザーエージェントはトークンを以下のように処理する必要があります。

文字トークン、現在のノードがtable、tbody、template、tfoot、thead、またはtr要素である場合

pending table character tokensを空のトークンリストとします。

元の挿入モードを現在の挿入モードとします。

挿入モードを「テーブル内テキスト」に切り替え、そのトークンを再処理します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

構文エラーです。そのトークンを無視します。

タグ名が「caption」である開始タグ

スタックをテーブルコンテキストに戻します。（以下を参照してください。）

マーカーをアクティブフォーマット要素リストの最後に挿入します。

そのトークンのためにHTML要素を挿入し、次に挿入モードを「キャプション内」に切り替えます。

タグ名が「colgroup」である開始タグ

スタックをテーブルコンテキストに戻します。（以下を参照してください。）

そのトークンのためにHTML要素を挿入し、次に挿入モードを「カラムグループ内」に切り替えます。

タグ名が「col」である開始タグ

スタックをテーブルコンテキストに戻します。（以下を参照してください。）

「colgroup」開始タグトークンに属性なしでHTML要素を挿入し、次に挿入モードを「カラムグループ内」に切り替えます。

現在のトークンを再処理します。

タグ名が「tbody」、「tfoot」、「thead」のいずれかである開始タグ

スタックをテーブルコンテキストに戻します。（以下を参照してください。）

そのトークンのためにHTML要素を挿入し、次に挿入モードを「テーブル内ボディ」に切り替えます。

タグ名が「td」、「th」、「tr」のいずれかである開始タグ

スタックをテーブルコンテキストに戻します。（以下を参照してください。）

「tbody」開始タグトークンに属性なしでHTML要素を挿入し、次に挿入モードを「テーブル内ボディ」に切り替えます。

現在のトークンを再処理します。

タグ名が「table」である開始タグ

構文エラーです。

もしオープン要素のスタックにテーブルスコープ内にtable要素がない場合、そのトークンを無視します。

それ以外の場合：

このスタックからtable要素がポップされるまでスタックから要素をポップします。

挿入モードを適切にリセットします。

そのトークンを再処理します。

タグ名が「table」である終了タグ

もしオープン要素のスタックにテーブルスコープ内にtable要素がない場合、これは構文エラーです；そのトークンを無視します。

それ以外の場合：

このスタックからtable要素がポップされるまでスタックから要素をポップします。

挿入モードを適切にリセットします。

タグ名が「body」、「caption」、「col」、「colgroup」、「html」、「tbody」、「td」、「tfoot」、「th」、「thead」、「tr」のいずれかである終了タグ

構文エラーです。そのトークンを無視します。

タグ名が「style」、「script」、「template」である開始タグ
タグ名が「template」である終了タグ

トークンを処理する際は、以下の規則を使用して、 "head内" 挿入モードで処理します。

タグ名が「input」である開始タグ

もしトークンに「type」という名前の属性がない場合、またはその属性があるがその属性の値が文字列「hidden」に対してASCII大文字小文字を区別しない一致ではない場合：以下の「その他のもの」エントリに記載されているように処理します。

それ以外の場合：

構文エラーです。

そのトークンのためにHTML要素を挿入します。

input要素をオープン要素のスタックからポップします。

そのトークンの自己終了フラグが設定されている場合、そのトークンの自己終了フラグを認識します。

タグ名が「form」である開始タグ

構文エラーです。

もしオープン要素のスタックにtemplate要素がある場合、またはform要素ポインタがnullでない場合、そのトークンを無視します。

それ以外の場合：

そのトークンのためにHTML要素を挿入し、form要素ポインタを作成された要素を指すように設定します。

form要素をオープン要素のスタックからポップします。

ファイルの終端トークン

トークンを処理する際は、以下の規則を使用して、 "body内" 挿入モードで処理します。

その他のもの

構文エラーです。フォスターペアレンティングを有効にし、「ボディ内」挿入モードのルールを使用してそのトークンを処理し、次にフォスターペアレンティングを無効にします。

上記の手順でUAにスタックをテーブルコンテキストに戻すことが要求される場合、それは現在のノードがtable、template、またはhtml要素でない間、オープン要素のスタックから要素をポップする必要があることを意味します。

これはテーブルスコープ内に要素がある手順で使用されるものと同じ要素リストです。

このプロセスの後、現在のノードがhtml要素である場合、これはフラグメントケースです。

13.2.6.4.10 「テーブルテキスト内」挿入モード

ユーザーエージェントが「テーブルテキスト内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

U+0000 NULLの文字トークン

パースエラー。トークンを無視します。

その他の文字トークン

文字トークンを保留中のテーブル文字トークンリストに追加します。

その他

保留中のテーブル文字トークンリスト内にASCIIの空白文字ではない文字トークンが含まれている場合、これはパースエラーです。リスト内の文字トークンを「テーブル内」挿入モードの「その他」エントリで指定されたルールを使用して再処理します。

それ以外の場合、保留中のテーブル文字トークンリストにある文字を挿入します。

挿入モードを元の挿入モードに切り替え、トークンを再処理します。

13.2.6.4.11 「キャプション内」挿入モード

ユーザーエージェントが「キャプション内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

終了タグのタグ名が「caption」の場合

オープン要素のスタックにcaption要素がテーブルスコープ内に存在しない場合、これはパースエラーです。トークンを無視します。（フラグメントケース）

そうでない場合：

暗黙の終了タグを生成します。

この時点で、現在のノードがcaption要素でない場合、これはパースエラーです。

このスタックからcaption要素がポップされるまで要素をスタックからポップします。

最後のマーカーまでのアクティブフォーマット要素のリストをクリアします。

挿入モードを「テーブル内」に切り替えます。

開始タグのタグ名が「caption」「col」「colgroup」「tbody」「td」「tfoot」「th」「thead」「tr」のいずれかである場合
終了タグのタグ名が「table」の場合

オープン要素のスタックにcaption要素がテーブルスコープ内に存在しない場合、これはパースエラーです。トークンを無視します。（フラグメントケース）

そうでない場合：

暗黙の終了タグを生成します。

この時点で、現在のノードがcaption要素でない場合、これはパースエラーです。

このスタックからcaption要素がポップされるまで要素をスタックからポップします。

最後のマーカーまでのアクティブフォーマット要素のリストをクリアします。

挿入モードを「テーブル内」に切り替えます。

トークンを再処理します。

終了タグのタグ名が「body」「col」「colgroup」「html」「tbody」「td」「tfoot」「th」「thead」「tr」のいずれかである場合

パースエラー。トークンを無視します。

その他

トークンを「本文内」挿入モードのルールを使用して処理します。

13.2.6.4.12 「カラムグループ内」挿入モード

ユーザーエージェントが「カラムグループ内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

文字トークンがU+0009キャラクタタブ、U+000Aラインフィード(LF)、U+000Cフォームフィード(FF)、U+000Dキャリッジリターン(CR)、またはU+0020スペースのいずれかである場合

文字を挿入します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

パースエラー。トークンを無視します。

タグ名が「html」の開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

タグ名が「col」の開始タグ

HTML要素を挿入します。直ちに現在のノードをオープン要素のスタックからポップします。

トークンの自己終了フラグを認識します（設定されている場合）。

タグ名が「colgroup」の終了タグ

現在のノードがcolgroup要素でない場合、これはパースエラーです。トークンを無視します。

そうでない場合、現在のノードをオープン要素のスタックからポップします。挿入モードを「テーブル内」に切り替えます。

タグ名が「col」の終了タグ

パースエラー。トークンを無視します。

タグ名が「template」の開始タグ
タグ名が「template」の終了タグ

トークンを「ヘッド内」挿入モードのルールを使用して処理します。

ファイル終了トークン

トークンを「本文内」挿入モードのルールを使用して処理します。

その他

現在のノードがcolgroup要素でない場合、これはパースエラーです。トークンを無視します。

そうでない場合、現在のノードをオープン要素のスタックからポップします。

挿入モードを「テーブル内」に切り替えます。

トークンを再処理します。

13.2.6.4.13 「テーブル本文内」挿入モード

ユーザーエージェントが「テーブル本文内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

タグ名が「tr」の開始タグ

テーブル本文のコンテキストにスタックをクリアします。（以下を参照。）

HTML要素を挿入します。次に挿入モードを「行内」に切り替えます。

タグ名が「th」「td」のいずれかである開始タグ

パースエラー。

テーブル本文のコンテキストにスタックをクリアします。（以下を参照。）

HTML要素を「tr」開始タグトークンとして挿入し、次に挿入モードを「行内」に切り替えます。

現在のトークンを再処理します。

タグ名が「tbody」「tfoot」「thead」のいずれかである終了タグ

オープン要素のスタックにそのトークンと同じタグ名を持つHTML要素がテーブルスコープ内にない場合、これはパースエラーです。トークンを無視します。

そうでない場合:

テーブル本文のコンテキストにスタックをクリアします。（以下を参照。）

現在のノードをオープン要素のスタックからポップします。挿入モードを「テーブル内」に切り替えます。

タグ名が「caption」「col」「colgroup」「tbody」「tfoot」「thead」のいずれかである開始タグ
タグ名が「table」の終了タグ

オープン要素のスタックに「tbody」「thead」「tfoot」要素がテーブルスコープ内にない場合、これはパースエラーです。トークンを無視します。

そうでない場合:

テーブル本文のコンテキストにスタックをクリアします。（以下を参照。）

現在のノードをオープン要素のスタックからポップします。挿入モードを「テーブル内」に切り替えます。

トークンを再処理します。

タグ名が「body」「caption」「col」「colgroup」「html」「td」「th」「tr」のいずれかである終了タグ

パースエラー。トークンを無視します。

その他

トークンを「テーブル内」挿入モードのルールを使用して処理します。

上記のステップがUAにテーブル本文のコンテキストにスタックをクリアすることを要求する場合、それは、現在のノードがtbody、tfoot、thead、template、またはhtml要素でない間、オープン要素のスタックから要素をポップすることを意味します。

現在のノードがこのプロセスの後にhtml要素である場合、これはフラグメントケースです。

13.2.6.4.14 「行内」挿入モード

ユーザーエージェントが「行内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

タグ名が「th」「td」のいずれかである開始タグ

テーブル行のコンテキストにスタックをクリアします。（以下を参照。）

HTML要素を挿入します。次に挿入モードを「セル内」に切り替えます。

マーカーをアクティブフォーマット要素のリストの末尾に挿入します。

タグ名が「tr」である終了タグ

オープン要素のスタックにtr要素がテーブルスコープ内にない場合、これはパースエラーです。トークンを無視します。

そうでない場合:

テーブル行のコンテキストにスタックをクリアします。（以下を参照。）

現在のノード（tr要素）をオープン要素のスタックからポップします。挿入モードを「テーブル本文内」に切り替えます。

タグ名が「caption」「col」「colgroup」「tbody」「tfoot」「thead」「tr」のいずれかである開始タグ
タグ名が「table」である終了タグ

オープン要素のスタックにtr要素がテーブルスコープ内にない場合、これはパースエラーです。トークンを無視します。

そうでない場合:

テーブル行のコンテキストにスタックをクリアします。（以下を参照。）

現在のノード（tr要素）をオープン要素のスタックからポップします。挿入モードを「テーブル本文内」に切り替えます。

トークンを再処理します。

タグ名が「tbody」「tfoot」「thead」のいずれかである終了タグ

もし、オープン要素のスタックに トークンと同じタグ名を持つHTML要素が テーブルスコープに含まれていない 場合、これは解析エラーです。 トークンを無視してください。

オープン要素のスタックにtr要素がテーブルスコープ内にない場合、トークンを無視します。

そうでない場合:

テーブル行のコンテキストにスタックをクリアします。（以下を参照。）

現在のノード（tr要素）をオープン要素のスタックからポップします。挿入モードを「テーブル本文内」に切り替えます。

トークンを再処理します。

タグ名が「body」「caption」「col」「colgroup」「html」「td」「th」のいずれかである終了タグ

パースエラー。トークンを無視します。

その他

トークンを「テーブル内」挿入モードのルールを使用して処理します。

上記のステップがUAにテーブル行のコンテキストにスタックをクリアすることを要求する場合、それは、現在のノードがtr、template、またはhtml要素でない間、オープン要素のスタックから要素をポップすることを意味します。

現在のノードがこのプロセスの後にhtml要素である場合、これはフラグメントケースです。

13.2.6.4.15 「セル内」挿入モード

ユーザーエージェントが「セル内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

タグ名が「td」「th」のいずれかである終了タグ

オープン要素のスタックにテーブルスコープ内にあるHTML要素が、トークンのタグ名と同じでない場合、これはパースエラーです。トークンを無視します。

そうでない場合:

暗黙の終了タグを生成します。

次に、現在のノードがトークンと同じタグ名のHTML要素でない場合、これはパースエラーです。

オープン要素のスタックから、トークンと同じタグ名のHTML要素がポップされるまで、要素をポップします。

最後のマーカーまでアクティブなフォーマット要素のリストをクリアします。

挿入モードを「行内」に切り替えます。

タグ名が「caption」「col」「colgroup」「tbody」「td」「tfoot」「th」「thead」「tr」のいずれかである開始タグ

Assert: オープン要素のスタックにはtdまたはth要素がテーブルスコープ内にある。

セルを閉じます（下記参照）し、トークンを再処理します。

タグ名が「body」「caption」「col」「colgroup」「html」のいずれかである終了タグ

パースエラー。トークンを無視します。

タグ名が「table」「tbody」「tfoot」「thead」「tr」のいずれかである終了タグ

オープン要素のスタックにテーブルスコープ内にあるHTML要素が、トークンのタグ名と同じでない場合、これはパースエラーです。トークンを無視します。

そうでない場合、セルを閉じます（下記参照）し、トークンを再処理します。

その他

トークンを「本文内」挿入モードのルールを使用して処理します。

上記の手順で「セルを閉じる」ように指定されている場合、それは次のアルゴリズムを実行することを意味します:

  1. 暗黙の終了タグを生成します。

  2. 現在のノードがtd要素またはth要素でない場合、これはパースエラーです。

  3. オープン要素のスタックからtd要素またはth要素がポップされるまで、要素をポップします。

  4. 最後のマーカーまでアクティブなフォーマット要素のリストをクリアします。

  5. 挿入モードを「行内」に切り替えます。

オープン要素のスタックには、td要素とth要素の両方がテーブルスコープ内に同時に存在することはできず、「セルを閉じる」アルゴリズムが呼び出されたときにどちらも存在しないこともできません。

13.2.6.4.16 「select内」挿入モード

ユーザーエージェントが「select内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

U+0000 NULLである文字トークン

パースエラー。トークンを無視します。

その他の文字トークン

トークンの文字を挿入します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

パースエラー。トークンを無視します。

タグ名が「html」である開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

タグ名が「option」である開始タグ

現在のノードがoption要素である場合、そのノードをオープン要素のスタックからポップします。

トークンのHTML要素を挿入します。

タグ名が「optgroup」である開始タグ

現在のノードがoption要素である場合、そのノードをオープン要素のスタックからポップします。

現在のノードがoptgroup要素である場合、そのノードをオープン要素のスタックからポップします。

トークンのHTML要素を挿入します。

タグ名が「hr」である開始タグ

現在のノードがoption要素である場合、そのノードをオープン要素のスタックからポップします。

現在のノードがoptgroup要素である場合、そのノードをオープン要素のスタックからポップします。

トークンのHTML要素を挿入します。すぐに現在のノードをオープン要素のスタックからポップします。

トークンの自己閉じフラグを確認します、もしそれが設定されている場合。

タグ名が「optgroup」である終了タグ

まず、現在のノードがoption要素であり、オープン要素のスタック内のすぐ前のノードがoptgroup要素である場合、その現在のノードをオープン要素のスタックからポップします。

現在のノードがoptgroup要素である場合、そのノードをオープン要素のスタックからポップします。そうでない場合、これはパースエラーです。トークンを無視します。

タグ名が「option」である終了タグ

現在のノードがoption要素である場合、そのノードをオープン要素のスタックからポップします。そうでない場合、これはパースエラーです。トークンを無視します。

タグ名が「select」である終了タグ

オープン要素のスタックがselect要素がselectスコープにある要素を持っていない場合、これはパースエラーです。トークンを無視します。(フラグメントケース)

それ以外の場合:

オープン要素のスタックからselect要素がポップされるまで、要素をポップします。

挿入モードを適切にリセットします。

タグ名が「select」である開始タグ

パースエラー。

オープン要素のスタックがselect要素がselectスコープにある要素を持っていない場合、トークンを無視します。(フラグメントケース)

それ以外の場合:

オープン要素のスタックからselect要素がポップされるまで、要素をポップします。

挿入モードを適切にリセットします。

これは終了タグとして扱われます。

タグ名が「input」、「keygen」、「textarea」である開始タグ

パースエラー。

オープン要素のスタックがselect要素がselectスコープにある要素を持っていない場合、トークンを無視します。(フラグメントケース)

それ以外の場合:

オープン要素のスタックからselect要素がポップされるまで、要素をポップします。

挿入モードを適切にリセットします。

トークンを再処理します。

タグ名が「script」、「template」である開始タグ
タグ名が「template」である終了タグ

トークンを「head内」挿入モードのルールを使用して処理します。

ファイル終端トークン

トークンを「本文内」挿入モードのルールを使用して処理します。

その他

パースエラー。トークンを無視します。

13.2.6.4.17 「テーブル内のselect内」 挿入モード

ユーザーエージェントが「テーブル内のselect内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

タグ名が「caption」、「table」、「tbody」、「tfoot」、「thead」、「tr」、「td」、「th」のいずれかである開始タグ

パースエラー。

オープン要素のスタックから、select要素がポップされるまで、要素をポップします。

挿入モードを適切にリセットします。

トークンを再処理します。

タグ名が「caption」、「table」、「tbody」、「tfoot」、「thead」、「tr」、「td」、「th」のいずれかである終了タグ

パースエラー。

オープン要素のスタックが、トークンのタグ名と同じタグ名を持つテーブルスコープ内の要素を持っていない場合、トークンを無視します。

それ以外の場合:

オープン要素のスタックから、select要素がポップされるまで、要素をポップします。

挿入モードを適切にリセットします。

トークンを再処理します。

その他

トークンを「select内」挿入モードのルールを使用して処理します。

13.2.6.4.18 「テンプレート内」挿入モード

ユーザーエージェントが「テンプレート内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

文字トークン
コメントトークン
DOCTYPEトークン

トークンを「本文内」挿入モードのルールを使用して処理します。

タグ名が「base」、「basefont」、「bgsound」、「link」、「meta」、「noframes」、「script」、「style」、「template」、「title」のいずれかである開始タグ
タグ名が「template」である終了タグ

トークンを「ヘッド内」挿入モードのルールを使用して処理します。

タグ名が「caption」、「colgroup」、「tbody」、「tfoot」、「thead」のいずれかである開始タグ

現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

テーブル内」をテンプレート挿入モードのスタックにプッシュし、それを現在のテンプレート挿入モードにします。

挿入モードを「テーブル内」に切り替え、トークンを再処理します。

タグ名が「col」である開始タグ

現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

カラムグループ内」をテンプレート挿入モードのスタックにプッシュし、それを現在のテンプレート挿入モードにします。

挿入モードを「カラムグループ内」に切り替え、トークンを再処理します。

タグ名が「tr」である開始タグ

現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

テーブルボディ内」をテンプレート挿入モードのスタックにプッシュし、それを現在のテンプレート挿入モードにします。

挿入モードを「テーブルボディ内」に切り替え、トークンを再処理します。

タグ名が「td」または「th」である開始タグ

現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

行内」をテンプレート挿入モードのスタックにプッシュし、それを現在のテンプレート挿入モードにします。

挿入モードを「行内」に切り替え、トークンを再処理します。

その他の開始タグ

現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

本文内」をテンプレート挿入モードのスタックにプッシュし、それを現在のテンプレート挿入モードにします。

挿入モードを「本文内」に切り替え、トークンを再処理します。

その他の終了タグ

パースエラー。トークンを無視します。

ファイル終端トークン

オープン要素のスタックにtemplate要素がない場合、解析を停止します。（フラグメントケース）

それ以外の場合は、パースエラーです。

オープン要素のスタックから、template要素がポップされるまで、要素をポップします。

最後のマーカーまでアクティブなフォーマット要素のリストをクリアします。

現在のテンプレート挿入モードをテンプレート挿入モードのスタックからポップします。

挿入モードを適切にリセットします。

トークンを再処理します。

13.2.6.4.19 「ボディ終了後」挿入モード

ユーザーエージェントが「ボディ終了後」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかである文字トークン

トークンを「本文内」挿入モードのルールを使用して処理します。

コメントトークン

コメントを挿入します。オープン要素のスタックの最初の要素（html要素）の最後の子要素として挿入します。

DOCTYPEトークン

パースエラー。トークンを無視します。

タグ名が「html」である開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

タグ名が「html」である終了タグ

パーサーがHTMLフラグメント解析アルゴリズムの一部として作成された場合、これはパースエラーです。トークンを無視します。（フラグメントケース）

それ以外の場合、挿入モードを「ボディ終了後の後」に切り替えます。

ファイル終端トークン

解析を停止します。

その他

パースエラー。挿入モードを「本文内」に切り替えて、トークンを再処理します。

13.2.6.4.20 「フレームセット内」挿入モード

ユーザーエージェントが「フレームセット内」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかである文字トークン

文字を挿入します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

パースエラー。トークンを無視します。

タグ名が「html」である開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

タグ名が「frameset」である開始タグ

HTML要素を挿入します。

タグ名が「frameset」である終了タグ

現在のノードがルートhtml要素である場合、これはパースエラーです。トークンを無視します。（フラグメントケース）

それ以外の場合、現在のノードをオープン要素のスタックからポップします。

パーサーがHTMLフラグメント解析アルゴリズムの一部として作成されていない場合（フラグメントケース）、かつ現在のノードがもはやframeset要素でない場合、挿入モードを「フレームセット終了後」に切り替えます。

タグ名が「frame」である開始タグ

HTML要素を挿入します。直ちに現在のノードをオープン要素のスタックからポップします。

トークンの自己終了フラグを認識します（設定されている場合）。

タグ名が「noframes」である開始タグ

トークンを「ヘッド内」挿入モードのルールを使用して処理します。

ファイル終端トークン

現在のノードがルートhtml要素でない場合、これはパースエラーです。

現在のノードがルートhtml要素であるのはフラグメントケースのみです。

解析を停止します。

その他

パースエラー。トークンを無視します。

13.2.6.4.21 「フレームセット後」挿入モード

ユーザーエージェントが「フレームセット後」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかである文字トークン

文字を挿入します。

コメントトークン

コメントを挿入します。

DOCTYPEトークン

パースエラー。トークンを無視します。

タグ名が「html」である開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

タグ名が「html」である終了タグ

挿入モードを「フレームセット終了後」に切り替えます。

タグ名が「noframes」である開始タグ

トークンを「ヘッド内」挿入モードのルールを使用して処理します。

ファイル終端トークン

解析を停止します。

その他

パースエラー。トークンを無視します。

13.2.6.4.22 「本文後」挿入モード

ユーザーエージェントが「本文後」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

コメントトークン

コメントを挿入します。それをDocumentオブジェクトの最後の子として追加します。

DOCTYPEトークン
U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかである文字トークン
タグ名が「html」である開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

ファイル終端トークン

解析を停止します。

その他

パースエラー。挿入モードを「本文内」に切り替え、トークンを再処理します。

13.2.6.4.23 「フレームセット後」挿入モード

ユーザーエージェントが「フレームセット後」挿入モードのルールを適用する場合、ユーザーエージェントは次のようにトークンを処理する必要があります:

コメントトークン

コメントを挿入します。それをDocumentオブジェクトの最後の子として追加します。

DOCTYPEトークン
U+0009 CHARACTER TABULATION、U+000A LINE FEED (LF)、U+000C FORM FEED (FF)、U+000D CARRIAGE RETURN (CR)、またはU+0020 SPACEのいずれかである文字トークン
タグ名が「html」である開始タグ

トークンを「本文内」挿入モードのルールを使用して処理します。

ファイル終端トークン

解析を停止します。

タグ名が「noframes」である開始タグ

トークンを「ヘッド内」挿入モードのルールを使用して処理します。

その他

パースエラー。トークンを無視します。

13.2.6.5 外部コンテンツでトークンを解析するためのルールin foreign content

ユーザーエージェントが外部コンテンツでトークンを解析するルールを適用する場合、ユーザーエージェントは次のようにトークンを処理しなければなりません:

U+0000 NULL の文字トークン

解析エラー。 U+FFFD 置換文字を挿入します。

U+0009 文字タブ、U+000A ラインフィード (LF)、U+000C 改ページ (FF)、U+000D 復帰 (CR)、または U+0020 スペースのいずれかの文字トークン

トークンの文字を挿入します。

その他の文字トークン

トークンの文字を挿入します。

frameset-okフラグを"not ok"に設定します。

コメントトークン

コメントを挿入します。

DOCTYPE トークン

解析エラー。トークンを無視します。

次のいずれかのタグ名を持つ開始タグ: "b", "big", "blockquote", "body", "br", "center", "code", "dd", "div", "dl", "dt", "em", "embed", "h1", "h2", "h3", "h4", "h5", "h6", "head", "hr", "i", "img", "li", "listing", "menu", "meta", "nobr", "ol", "p", "pre", "ruby", "s", "small", "span", "strong", "strike", "sub", "sup", "table", "tt", "u", "ul", "var"
属性名 "color", "face", または "size" を持つ "font" タグ
"br", "p" タグの終了タグ

解析エラー。

現在のノードが MathML テキスト統合ポイント、HTML 統合ポイント、またはHTML 名前空間内の要素でない限り、オープン要素のスタックから要素をポップします。

トークンを現在の挿入モードに従ってHTMLコンテンツで再処理します。

その他の開始タグ

調整された現在のノードがMathML名前空間の要素である場合、トークンのMathML属性を調整します。

調整された現在のノードがSVG名前空間の要素であり、トークンのタグ名が以下の表の最初の列のいずれかである場合、タグ名を対応するセルの名前に変更します。

タグ名 要素名
altglyph altGlyph
altglyphdef altGlyphDef
altglyphitem altGlyphItem
animatecolor animateColor
animatemotion animateMotion
animatetransform animateTransform
clippath clipPath
feblend feBlend
fecolormatrix feColorMatrix
fecomponenttransfer feComponentTransfer
fecomposite feComposite
feconvolvematrix feConvolveMatrix
fediffuselighting feDiffuseLighting
fedisplacementmap feDisplacementMap
fedistantlight feDistantLight
fedropshadow feDropShadow
feflood feFlood
fefunca feFuncA
fefuncb feFuncB
fefuncg feFuncG
fefuncr feFuncR
fegaussianblur feGaussianBlur
feimage feImage
femerge feMerge
femergenode feMergeNode
femorphology feMorphology
feoffset feOffset
fepointlight fePointLight
fespecularlighting feSpecularLighting
fespotlight feSpotLight
fetile feTile
feturbulence feTurbulence
foreignobject foreignObject
glyphref glyphRef
lineargradient linearGradient
radialgradient radialGradient
textpath textPath

調整された現在のノードが SVG名前空間 の要素である場合、トークンに対して SVG属性を調整します。 （これにより、すべてが小文字ではないSVG属性が修正されます。）

トークンに対して他の属性を調整します。 （これにより、特にSVGのXLinkにおいて、名前空間付きの属性の使用が修正されます。）

他の要素を挿入します。 調整された現在のノードの名前空間を使用し、falseで。

トークンに自己終了フラグが設定されている場合、以下のリストの適切な手順を実行します：

トークンのタグ名が"script"であり、現在のノード が SVG名前空間内にある場合

トークンの 自己終了フラグを認識し、以下の「script」終了タグの手順で説明されているように行動します。

その他の場合

現在のノードを オープン要素のスタックから ポップし、トークンの 自己終了フラグを認識します。

終了タグのタグ名が"script"であり、現在のノード が SVGの script要素である場合

現在のノードを オープン要素のスタックから ポップします。

old insertion pointを現在の挿入ポイントと同じ値に設定します。 挿入ポイントを次の 次の入力文字の直前に設定します。

パーサーのスクリプトネスティングレベル を 1つ増やし、パーサーポーズフラグを trueに設定します。

アクティブな予測HTMLパーサーがnullであり、ユーザーエージェントがSVGをサポートしている場合は、 SVG script要素をSVGの規則に従って処理します。[SVG]

これによって トークナイザに新しい文字が挿入される 場合でも、パーサーポーズフラグがtrueであるため、 パーサーは再帰的に実行されません。

パーサーのスクリプトネスティングレベル を 1つ減らします。パーサーのスクリプトネスティングレベル が0の場合、パーサーポーズフラグ をfalseに設定します。

挿入ポイント の値をold insertion pointの値に設定します。 （言い換えれば、 挿入ポイント を以前の値に復元します。この値は「未定義」値である可能性があります。）

その他の終了タグ

次の手順を実行します：

  1. nodeを現在のノード （スタックの最下部のノード）に初期化します。

  2. nodeのタグ名が、ASCII小文字に変換されたものと異なる場合、 これは構文エラー です。

  3. ループ：nodeが オープン要素のスタック の最上部の要素である場合、戻ります。 (フラグメントケース)

  4. nodeのタグ名が、ASCII小文字に変換されたものと同じである場合、 nodeがスタックからポップされるまでオープン要素のスタックから要素をポップし、その後に戻ります。

  5. nodeを オープン要素のスタック の前のエントリに設定します。

  6. nodeがHTML名前空間の要素ではない場合、 ループというラベルの付いた手順に戻ります。

  7. それ以外の場合、HTMLコンテンツ内の現在の挿入モードに対応するセクションで指定された規則に従ってトークンを処理します。

13.2.7 終了

ユーザーエージェントがドキュメントの解析を停止すると、以下の手順を実行する必要があります。

  1. もし、アクティブな推測HTMLパーサーがnullでない場合、 推測HTMLパーサーを停止して戻ります。

  2. 挿入ポイントを未定義に設定します。

  3. 現在のドキュメントの準備状態を "interactive"に更新します。

  4. すべてのノードをオープン要素のスタックからポップします。

  5. ドキュメントの解析が完了した後に実行されるスクリプトのリスト が空でない間:

    1. イベントループをスピンして、 最初のスクリプト要素が パーサー実行準備が完了する ようにし、かつパーサーのDocumentに スクリプトをブロックするスタイルシートがない 状態になるまで待ちます。

    2. 最初のスクリプト要素を 実行します。

    3. 最初のスクリプト要素を スクリプトのリストから 削除します (すなわち、リストの最初のエントリをシフトアウトします)。

  6. グローバルタスクをキューに入れて、Documentの関連するグローバルオブジェクトに 以下のサブステップを実行させます。

    1. 現在のドキュメントの準備状態を "complete"に更新します。

    2. もしDocumentのブラウジングコンテキストがnullである場合、これらの手順を中止します。

    3. windowをDocumentの 関連するグローバルオブジェクトに設定します。

    4. Documentのロードタイミング情報のロードイベント開始時間を、windowに与えられた現在の高精度時間に設定します。

    5. イベントを発火し、windowでloadという名前のイベントを、legacy target override flagを設定して発生させます。

    6. WebDriver BiDiのロード完了をDocumentのブラウジングコンテキストで実行し、 新しいWebDriver BiDiナビゲーションステータスを 使用し、そのidを Documentの読み込み中のナビゲーションIDとして設定し、 ステータスを "complete"に、 URLを DocumentのURLとして設定します。

    7. DocumentのWebDriver BiDiの読み込み中ナビゲーションIDをnullに設定します。

    8. Documentのロードタイミング情報のロードイベント終了時間を、windowに与えられた現在の高精度時間に設定します。

    9. Documentのページ表示がfalseであることを確認します。

    10. Documentのページ表示フラグをtrueに設定します。

    11. windowでページ遷移イベントをpageshowという名前で発生させ、 falseに設定します。

    12. Documentの完全な読み込みを完了します。

    13. Documentのナビゲーションタイミングエントリを キューに入れます。

  7. もしDocumentの読み込み後に印刷フラグが設定されている場合、 印刷手順を実行します。

  8. Documentは、読み込み後のタスクに対して準備完了です。

ユーザーエージェントがパーサーを中止するとき、以下の手順を実行する必要があります。

  1. 入力ストリーム内の保留中のコンテンツをすべて破棄し、今後追加されるであろうコンテンツも破棄します。

  2. 推測HTMLパーサーを停止します。

  3. 現在のドキュメントの準備状態を "interactive"に更新します。

  4. すべてのノードをオープン要素のスタックからポップします。

  5. 現在のドキュメントの準備状態を "complete"に更新します。

13.2.8 推測的HTML解析

ユーザーエージェントは、HTMLパーサーが保留中のパーサーをブロックするスクリプトの取得と実行を待機している間、または通常の解析中に、HTMLマークアップ内で宣言されたリソースを推測的にフェッチするための最適化を、このセクションで説明されているように実装することができます。この最適化は正確な詳細が定義されていませんが、互換性のために考慮すべきルールがあります。

各HTMLパーサーには、アクティブな推測的HTMLパーサーを持つことができます。これは初期状態ではnullです。

推測的HTMLパーサーは通常のHTMLパーサーのように動作する必要があります（例えば、ツリービルダールールが適用されます）が、いくつかの例外があります。

推測フェッチは、推測モック要素のelementに対して、次のルールに従わなければなりません。

各Documentは、最初は空の状態の推測的フェッチURLのリストを持っています。

HTMLパーサーのインスタンスparserに対して推測的HTMLパーサーを開始するには:

  1. 任意でリターンします。

    このステップは、ユーザーエージェントが推測的HTML解析をオプトアウトすることを許可します。

  2. もしparserのアクティブな推測的HTMLパーサーがnullでない場合、parserの推測的HTMLパーサーを停止します。

    これはdocument.write()が別のパーサーブロックするスクリプトを書き込むときに起こり得ます。簡単のため、この仕様では常に推測的解析を再開しますが、最終的な結果が同等である限り、ユーザーエージェントはより効率的な戦略を実装することができます。

  3. speculativeParserを新しい推測的HTMLパーサーとして、parserと同じ状態に設定します。

  4. speculativeDocをparserのDocumentの新しい等価表現とし、すべての要素が推測的モック要素として設定されたものとします。speculativeParserがspeculativeDocに解析を行うようにします。

  5. parserのアクティブな推測的HTMLパーサーをspeculativeParserに設定します。

  6. 並行して、speculativeParserが停止するか、その入力ストリームが終了するまで実行します。

HTMLパーサーのインスタンスparserに対して推測的HTMLパーサーを停止するには:

  1. speculativeParserをparserのアクティブな推測的HTMLパーサーとして設定します。

  2. もしspeculativeParserがnullである場合、リターンします。

  3. speculativeParserの入力ストリーム内の保留中のコンテンツをすべて破棄し、今後追加されるであろうコンテンツも破棄します。

  4. parserのアクティブな推測的HTMLパーサーをnullに設定します。

推測的HTMLパーサーは、通常の要素ではなく推測的モック要素を作成します。ツリービルダーが通常要素に対して行うDOM操作は、推測的モック要素に対して適切に動作することが期待されます。

推測的モック要素を作成するには、namespace、tagName、およびattributesを与えて:

  1. elementを新しい推測的モック要素として設定します。

  2. elementの名前空間をnamespaceに設定します。

  3. elementのローカル名をtagNameに設定します。

  4. elementの属性リストをattributesに設定します。

  5. elementの子要素を新しい空のリストに設定します。

  6. 任意で、elementのために推測的フェッチを実行します。

  7. elementを返します。

ツリービルダーがtemplate要素のテンプレート内容に要素を挿入すると言った場合、それが推測的モック要素であり、template要素のテンプレート内容がShadowRootノードでない場合、代わりに何もしません。非宣言的シャドウルート内のtemplate要素の中で推測的に見つかったURLは、それ自体がテンプレートである可能性があり、推測的にフェッチされてはなりません。

13.2.9 HTML DOMのインフォセットへの強制

アプリケーションがXMLパイプラインと併用してHTMLパーサーを使用する場合、構築されたDOMが特定の微妙な点でXMLツールチェーンと互換性がない可能性があります。例えば、XMLツールチェーンがxmlnsという名前の属性を表現できない場合があります。これはXMLの名前空間構文と競合するためです。また、HTMLパーサーが生成するデータの一部は、DOM自体には含まれていません。このセクションでは、これらの問題を処理するためのいくつかのルールを指定します。

使用されているXML APIがDOCTYPEをサポートしていない場合、ツールはDOCTYPEを完全に削除することがあります。

XML APIが名前が「xmlns」の名前空間に属していない属性、名前が「xmlns:」で始まる属性、またはXMLNS名前空間内の属性をサポートしていない場合、そのような属性をツールが削除することがあります。

ツールは、適切な操作のために必要な任意の名前空間宣言で出力を注釈付けすることができます。

使用されているXML APIが要素や属性のローカル名に許可される文字を制限している場合、ツールはAPIがサポートしないすべての要素と属性のローカル名を許可された名前のセットにマッピングすることができます。サポートされていない文字をすべて大文字のUに置き換え、その文字のコードポイントを16進数で表現した6桁の数字を使用し、記号として0-9の数字とA-Fの大文字を使用して、数値の昇順で置き換えます。

例えば、要素名foo<barは、HTMLパーサーによって出力されることがありますが、これは合法的なHTML要素名でも整形式のXML要素名でもありません。これがfooU00003Cbarに変換されます。これは整形式のXML要素名ですが、HTMLでは依然として合法ではありません。

別の例として、属性xlink:hrefを考えてみましょう。MathML要素で使用された場合、それは調整後に、接頭辞「xlink」とローカル名「href」を持つ属性になります。しかし、HTML要素で使用された場合、それは接頭辞がなく、ローカル名「xlink:href」を持つ属性になります。これは有効なNCNameではないため、XML APIによって受け入れられない可能性があります。それは「xlinkU00003Ahref」に変換される可能性があります。

この変換によって生成された名前は、HTMLパーサーによって生成された属性と競合することはありません。これらはすべて小文字であるか、外部属性を調整するアルゴリズムのテーブルにリストされているものだからです。

XML APIが連続した2つのU+002D HYPHEN-MINUS文字（--）をコメントに含むことを制限している場合、ツールはそのような違反する文字の間に1つのU+0020 SPACE文字を挿入することがあります。

XML APIがコメントの末尾にU+002D HYPHEN-MINUS文字（-）を含むことを制限している場合、ツールはそのようなコメントの末尾に1つのU+0020 SPACE文字を挿入することがあります。

XML APIが文字データ、属性値、またはコメントに許可される文字を制限している場合、ツールはU+000C FORM FEED（FF）文字をU+0020 SPACE文字に置き換え、その他の非XML文字をU+FFFD REPLACEMENT CHARACTERに置き換えることがあります。

ツールが帯域外情報を伝達する方法を持たない場合、次の情報を削除することがあります。

このセクションで許可されている変換は、HTMLパーサーのルールが適用された後に適用されます。例えば、<a::>開始タグは</a::>終了タグで閉じられ、</aU00003AU00003A>終了タグでは決して閉じられません。たとえユーザーエージェントが上記のルールを使用して、その開始タグのためにDOM内で実際のaU00003AU00003Aという名前の要素を生成する場合であっても。

13.2.10 パーサーにおけるエラーハンドリングと奇妙なケースの紹介

このセクションは規範的ではありません。

このセクションでは、いくつかの誤ったマークアップを検討し、それらのケースをHTMLパーサーがどのように処理するかを説明します。

13.2.10.1 入れ子が間違ったタグ: <b><i></b></i>

このセクションは規範的ではありません。

最もよく議論される誤ったマークアップの例は次のとおりです:

<p>1<b>2<i>3</b>4</i>5</p>

このマークアップの解析は「3」まで順調に進みます。この時点で、DOMは次のようになります:

ここで、オープン要素のスタックには5つの要素があります: html, body, p, b, およびiです。アクティブフォーマット要素のリストには2つの要素だけがあります: b と iです。挿入モードは「in body」です。

「b」というタグ名の終了タグトークンを受信すると、養子縁組アルゴリズムが呼び出されます。これは単純なケースで、formattingElementはb要素であり、furthest blockはありません。このため、オープン要素のスタックには3つの要素しか残りません: html, body, およびpです。一方、アクティブフォーマット要素のリストには1つの要素だけが残ります: iです。DOMツリーはこの時点では変更されていません。

次のトークンは文字「4」で、これはアクティブフォーマット要素の再構築を引き起こします。この場合、i要素だけが再構築されます。そのため、「4」テキストノードのために新しいi要素が作成されます。「i」の終了タグトークンも受信され、「5」テキストノードが挿入された後、DOMは次のようになります:

13.2.10.2 入れ子が正しくないタグ: <b><p></b></p>

このセクションは規範的ではありません。

前回のケースに似た例として、次のようなものがあります。

<b>1<p>2</b>3</p>

「2」までの解析は簡単です。

「b」というタグ名の終了タグトークンが解析されると、興味深い部分が出てきます。

そのトークンが表示される前に、オープン要素のスタックには4つの要素があります： html、body、b、pです。アクティブなフォーマット要素のリストには、bの1つしかありません。挿入モードは「本文内解析」です。

「b」というタグ名の終了タグトークンを受け取ると、前回と同様に「アドプションエージェンシーアルゴリズム」が起動します。しかし、この場合、furthest block、すなわちp要素が存在するため、アドプションエージェンシーアルゴリズムはスキップされません。

common ancestorはbody要素です。概念的な「ブックマーク」は、アクティブなフォーマット要素のリスト内のbの位置をマークしますが、そのリストには1つの要素しかないため、このブックマークはほとんど効果がありません。

アルゴリズムが進行すると、nodeがフォーマット要素（b）に設定され、last nodeがfurthest block（p）に設定されます。

last nodeがcommon ancestorに追加（移動）され、DOMは次のようになります。

新しいb要素が作成され、p要素の子がそれに移動されます。

最後に、新しいb要素がp要素に追加され、DOMは次のようになります。

b 要素は、アクティブなフォーマット要素のリストおよびオープン要素のスタックから削除され、「3」が解析されたときに、それがp要素に追加されるようにします。

13.2.10.3 テーブル内の予期しないマークアップ

このセクションは規範的ではありません。

テーブル内でのエラーハンドリングは、歴史的な理由により特に奇妙です。例えば、次のマークアップを考えてみましょう。

<table><b><tr><td>aaa</td></tr>bbb</table>ccc

ハイライトされたb 要素の開始タグは、テーブル内に直接置くことはできません。この場合、パーサーはこの要素をテーブルの前に配置して処理します（これは養育親と呼ばれます）。次に示すDOMツリーは、table要素の開始タグが見つかった直後のものです。

そして、b要素の開始タグが見つかった直後のDOMツリーは次のようになります。

この時点で、オープン要素のスタックにはhtml、body、table、およびbの要素が順番に含まれています（結果的なDOMツリーとは一致しませんが）。アクティブなフォーマット要素のリストにはb要素のみが含まれており、挿入モードは「テーブル内」です。

tr開始タグが見つかると、b要素がスタックからポップされ、tbodyの開始タグが暗黙的に挿入されます。tbodyとtrの要素は、比較的単純な方法で処理され、パーサーは「テーブルボディ内」および「行内」の挿入モードを通過します。その後、DOMツリーは次のようになります。

ここで、オープン要素のスタックにはhtml、body、table、tbody、およびtrの要素が含まれています。アクティブなフォーマット要素のリストにはまだb要素が含まれており、挿入モードは「行内」です。

td要素の開始タグトークンは、td要素をツリーに配置し、マーカーをアクティブなフォーマット要素のリストに配置します（また、「セル内」挿入モードに切り替えます）。

マーカーは、「aaa」文字トークンが見つかったときに、生成されたTextノードを保持するためのb要素が作成されないことを意味します。

終了タグは直線的に処理されます。処理後、オープン要素のスタックには、html、body、table、tbody要素が含まれています。アクティブなフォーマット要素のリストにはまだb要素が含まれており、「td」終了タグトークンによってマーカーが削除されました。そして挿入モードは「テーブルボディ内」のままです。

こうして「bbb」文字トークンが見つかります。これにより、「テーブルテキスト内」挿入モードが使用され（元の挿入モードは「テーブルボディ内」に設定されます）、文字トークンが収集され、次のトークン（table要素終了タグ）が見つかると、文字トークンが一括して処理されます。文字トークンがすべてスペースではないため、「テーブル内」挿入モードの「その他のもの」ルールに従って処理されますが、「本文内」挿入モードが適用され、養育親が適用されます。

アクティブなフォーマット要素が再構築されると、b要素が作成され、フォスターペアレントされ、その後「bbb」のテキストノードがそれに追加されます。

オープン要素のスタックにはhtml、body、table、tbody、および新しいb要素が含まれています（再び、この要素は結果として得られるツリーとは一致しません）。アクティブなフォーマット要素のリストには新しいb要素が含まれており、挿入モードはまだ「テーブルボディ内」です。

キャラクタートークンが「bbb」ではなくASCIIホワイトスペースのみであった場合、そのASCIIホワイトスペースは単にtbody要素に追加されます。

最後に、tableは「table」終了タグによって閉じられます。これにより、オープン要素のスタックからtable要素までのすべてのノードがポップされますが、アクティブなフォーマット要素のリストには影響を与えません。そのため、テーブルの後の「ccc」文字トークンは、さらに別のb要素が作成され、今回はテーブルの後に配置されます。

13.2.10.4 パース中にページを変更するスクリプト

このセクションは規範的ではありません。

次のマークアップを考えてみましょう。この例では、このドキュメントがURL https://example.com/innerを持ち、別のドキュメント内のiframeのコンテンツとしてレンダリングされていると仮定します。その別のドキュメントはURL https://example.com/outerを持っています。 

<div id=a>
  <script>
   var div = document.getElementById('a');
   parent.document.body.appendChild(div);
  </script>
  <script>
   alert(document.URL);
  </script>
 </div>
 <script>
  alert(document.URL);
 </script>

最初の「script」終了タグまでの処理では、スクリプトが解析される前の結果は比較的単純です:

しかし、スクリプトが解析された後、div要素とその子要素であるscript要素は削除されます:

それらは、この時点で前述の外側のDocumentの中にあります。しかし、スタック内のオープン要素にはまだdiv要素が含まれています。

したがって、2番目のscript要素が解析されると、それは外側のDocumentオブジェクトに挿入されます。

解析されたDocumentがパーサーが作成されたものとは異なる場合、それらは実行されないため、最初のアラートは表示されません。

div要素の終了タグが解析されると、div要素がスタックからポップされるため、次のscript要素は内側のDocumentに入ります：

このスクリプトは実行され、「https://example.com/inner」と表示するアラートが発生します。

13.2.10.5 複数のドキュメント間を移動するスクリプトの実行

このセクションは非規範的です。

前のセクションの例を詳述すると、2番目のscript 要素が外部スクリプト（つまりsrc 属性を持つもの）である場合を考えてみましょう。この要素が作成されたときにパーサーの Document に存在していなかったため、その外部スクリプトはダウンロードさえされません。

通常、script 要素がsrc 属性を持ち、そのパーサーのDocument に正常に解析されますが、外部スクリプトのダウンロード中にその要素が別のドキュメントに移動された場合、スクリプトはダウンロードを続けますが、実行はされません。

一般的に、script 要素をDocument 間で移動することは、悪いプラクティスと見なされます。

13.2.10.6 未閉じのフォーマット要素

このセクションは非規範的です。

次のマークアップは、ネストされたフォーマット要素（bなど）がどのように収集され、それが含まれる要素が閉じられた後でも適用され続けるが、過剰な重複は破棄されるかを示しています。 

<!DOCTYPE html>
 <p><b class=x><b class=x><b><b class=x><b class=x><b>X
 <p>X
 <p><b><b class=x><b>X
 <p></b></b></b></b></b></b>X

結果として得られるDOMツリーは次のとおりです:

マークアップ内の2番目のp 要素には、明示的なb 要素がないことに注目してください。しかし、結果として得られるDOMでは、各種類のフォーマット要素 （この場合、クラス属性を持つb 要素が3つ、そして装飾のないb 要素が2つ）までが、「X」要素の前に再構築されます。

また、このことから、最終段落では、リスト内の全てのb 終了タグを完全にクリアするために、6つのb 開始タグが必要であることがわかります。これまでに9つの開始タグが表示されていますが、

13.3 HTMLフラグメントのシリアライズ

以下のアルゴリズムの目的のために、ある要素のタイプが空要素の1つである場合、またはbasefont、bgsound、frame、keygen、またはparamである場合、空としてシリアライズされるとみなします。

次のステップは、HTMLフラグメントのシリアライズアルゴリズムを形成します。このアルゴリズムは、DOM Element、Document、またはDocumentFragmentをthe nodeとして、ブール値のserializableShadowRootsとsequence<ShadowRoot> shadowRootsを入力として受け取り、文字列を返します。

このアルゴリズムは、シリアライズされるノード自体ではなく、そのノードの子ノードをシリアライズします。

  1. もしthe nodeが空としてシリアライズされるならば、空の文字列を返します。

  2. sを文字列として、空の文字列に初期化します。

  3. もしthe nodeがtemplate要素であるならば、the nodeをそのtemplate要素のtemplate contents（DocumentFragmentノード）に置き換えます。

  4. もしcurrent nodeがシャドウホストである場合、次の手順を実行します:

    1. shadowをcurrent nodeのシャドウルートとして設定します。

    2. 以下のいずれかが真である場合:

      • serializableShadowRootsが真であり、shadowのserializableが真である場合、または

      • shadowRootsがshadowを含む場合

      次を実行します:

      1. "<template shadowrootmode=""を追加します。

      2. もしshadowのモードが"open"であるならば、"open"を追加します。そうでなければ、"closed"を追加します。

      3. """を追加します。

      4. もしshadowのdelegates focusが設定されている場合、" shadowrootdelegatesfocus="""を追加します。

      5. もしshadowのserializableが設定されている場合、" shadowrootserializable="""を追加します。

      6. もしshadowのclonableが設定されている場合、" shadowrootclonable="""を追加します。

      7. current node の カスタム要素レジストリが shadow の カスタム要素レジストリではない場合、「 shadowrootcustomelementregistry=""」を追加します。

      8. ">"を追加します。

      9. HTMLフラグメントシリアライズアルゴリズムをshadow、serializableShadowRoots、およびshadowRootsで実行し、その結果を追加します（この要素についてこのアルゴリズムを再帰的に実行します）。

      10. "</template>"を追加します。

  5. the nodeの各子ノードについて、ツリー順に次の手順を実行します:

    1. current nodeを処理中の子ノードに設定します。

    2. 次のリストから適切な文字列をsに追加します:

      もしcurrent nodeが要素ノードである場合

      もしcurrent nodeがHTML名前空間、MathML名前空間、またはSVG名前空間内の要素であるならば、tagnameをcurrent nodeのローカル名とします。そうでなければ、tagnameをcurrent nodeの修飾名とします。

      U+003C LESS-THAN SIGN文字 (<) に続いてtagnameを追加します。

      HTML要素がHTMLパーサーまたはcreateElement()によって作成された場合、tagnameは小文字になります。

      もしcurrent nodeのis値がnullでなく、かつその要素が属性リストにis属性を持たない場合、" is=""という文字列を追加し、続いてcurrent nodeのis値を属性モードで下記に記載されているようにエスケープされたものを追加し、最後にU+0022 QUOTATION MARK文字 (")を追加します。

      その要素が持つ各属性について、U+0020 SPACE文字、属性のシリアライズ名、U+003D EQUALS SIGN文字 (=)、U+0022 QUOTATION MARK文字 (")、属性値、下記に記載されているようにエスケープされたものを属性モードで追加し、最後に再度U+0022 QUOTATION MARK文字 (")を追加します。

      属性のシリアライズ名は、前段落の目的のために以下のように決定されなければなりません:

      もし属性が名前空間を持たない場合

      その属性のシリアライズ名は、その属性のローカル名です。

      HTML要素の属性がHTMLパーサーまたはsetAttribute()によって設定された場合、ローカル名は小文字になります。

      もし属性がXML名前空間にある場合

      その属性のシリアライズ名は、"xml:"という文字列に続いて属性のローカル名を追加したものです。

      もし属性がXMLNS名前空間にあり、そのローカル名がxmlnsである場合

      その属性のシリアライズ名は、"xmlns"という文字列です。

      もし属性がXMLNS名前空間にあり、そのローカル名がxmlnsでない場合

      その属性のシリアライズ名は、"xmlns:"という文字列に続いて属性のローカル名を追加したものです。

      もし属性がXLink名前空間にある場合

      その属性のシリアライズ名は、"xlink:"という文字列に続いて属性のローカル名を追加したものです。

      もし属性が他の名前空間にある場合

      その属性のシリアライズ名は、属性の修飾名です。

      属性の正確な順序は実装依存であり、元のマークアップで属性が与えられた順序などの要因によって異なる場合がありますが、このアルゴリズムの連続した呼び出しが要素の属性を同じ順序でシリアライズするように、そのソート順序は安定していなければなりません。

      U+003E GREATER-THAN SIGN文字 (>) を追加します。

      もしcurrent nodeが空としてシリアライズされるならば、この時点で次の子ノードに進む必要があります。

      HTMLフラグメントシリアライズアルゴリズムをcurrent node、serializableShadowRoots、およびshadowRootsで実行し、その結果を追加し（このノードについてこのアルゴリズムを再帰的に実行します）、次にU+003C LESS-THAN SIGN文字 (<)、U+002F SOLIDUS文字 (/) 、再度tagname、最後にU+003E GREATER-THAN SIGN文字 (>) を追加します。

      もしcurrent nodeがテキストノードである場合

      もしcurrent nodeの親がstyle、script、xmp、iframe、noembed、noframes、またはplaintext要素であるか、またはcurrent nodeの親がnoscript要素であり、current nodeに対してスクリプトが有効である場合、current nodeのデータをそのまま追加します。

      それ以外の場合、current nodeのデータを下記に記載されているようにエスケープされたものを追加します。

      もしcurrent nodeがコメントノードである場合

      "<!--" (U+003C LESS-THAN SIGN、U+0021 EXCLAMATION MARK、U+002D HYPHEN-MINUS、U+002D HYPHEN-MINUS) に続いて、current nodeのデータの値を追加し、続いて"-->" (U+002D HYPHEN-MINUS、U+002D HYPHEN-MINUS、U+003E GREATER-THAN SIGN) というリテラル文字列を追加します。

      もしcurrent nodeが処理命令ノードである場合

      "<?" (U+003C LESS-THAN SIGN、U+003F QUESTION MARK) に続いて、current nodeのターゲットIDL属性の値を追加し、続いて1つのU+0020 SPACE文字、続いてcurrent nodeのデータの値を追加し、最後にU+003E GREATER-THAN SIGN文字 (>) を追加します。

      もしcurrent nodeが文書型宣言ノードである場合

      "<!DOCTYPE" (U+003C LESS-THAN SIGN、U+0021 EXCLAMATION MARK、U+0044 LATIN CAPITAL LETTER D、U+004F LATIN CAPITAL LETTER O、U+0043 LATIN CAPITAL LETTER C、U+0054 LATIN CAPITAL LETTER T、U+0059 LATIN CAPITAL LETTER Y、U+0050 LATIN CAPITAL LETTER P、U+0045 LATIN CAPITAL LETTER E) に続いてスペース (U+0020 SPACE)、続いてcurrent nodeの名前の値を追加し、">" (U+003E GREATER-THAN SIGN) を追加します。

  6. sを返します。

このアルゴリズムの出力は、HTMLパーサーで解析された場合、元のツリー構造を返さない可能性があります。シリアライズと再解析の手順をラウンドトリップしないツリー構造は、HTMLパーサー自体によっても生成されることがありますが、そのようなケースは通常、非準拠です。

例えば、textarea 要素にComment ノードが追加された場合、それがシリアライズされ、その出力が再解析されると、コメントがテキストコントロール内に表示されることになります。同様に、DOM操作の結果として要素に"-->"を含むコメントが含まれている場合、その要素のシリアライズ結果が解析されると、そのコメントはその時点で切り捨てられ、コメントの残りの部分はマークアップとして解釈されます。さらに例を挙げると、script 要素に"</script>"というテキスト文字列を含むText ノードを含めたり、p 要素にul 要素を含める（ul 要素の開始タグがp要素の終了タグを暗黙的に示すことになります）場合があります。

これはクロスサイトスクリプティング攻撃を可能にすることがあります。例としては、ユーザーがフォントファミリ名を入力し、それがDOMを介してCSSのstyle ブロックに挿入され、その後、innerHTML IDL属性を使用してそのstyle 要素のHTMLシリアライズを取得するページです。もしユーザーがフォントファミリ名として"</style><script>attack</script>"を入力すると、innerHTML は、異なるコンテキストで解析された場合、script ノードを含むマークアップを返すことになりますが、元のDOMにはそのようなscript ノードは存在しません。

例えば、次のマークアップを考えてみてください:

<form id="outer"><div></form><form id="inner"><input>

これは次のように解析されます:

input要素は、内部のform要素に関連付けられます。しかし、このツリー構造がシリアライズされ再解析されると、<form id="inner">開始タグは無視されるため、input要素は外側のform要素に関連付けられることになります。 

<html><head></head><body><form id="outer"><div><form id="inner"><input></form></div></form></body></html>

別の例として、次のマークアップを考えてみてください：

<a><table><a>

これは次のように解析されます：

つまり、a要素がネストされています。これは、2番目のa要素がフォスターペアレントされたためです。シリアライズ-再解析ラウンドトリップ後、a要素とtable要素はすべて兄弟要素になります。これは、2番目の<a>開始タグが最初のa要素を暗黙的に閉じるためです。

<html><head></head><body><a><a></a><table></table></a></body></html>

歴史的な理由により、このアルゴリズムはpre、textarea、およびlisting要素内の最初のU+000A LINE FEED（LF）文字をラウンドトリップしません。（最初の2つの場合で）ラウンドトリップされるマークアップが適合する場合でも、HTMLパーサーは解析中にそのような文字を削除しますが、このアルゴリズムは余分なU+000A LINE FEED（LF）文字をシリアル化しません。

例えば、次のマークアップを考えてみましょう:

<pre>
 
 Hello.</pre>

この文書が最初に解析されたとき、pre要素の子テキスト内容は単一の改行文字から始まります。シリアル化と再解析のラウンドトリップ後、pre要素の子テキスト内容は単に「Hello.」になります。

is属性の特別な役割は、カスタマイズされた組み込み要素の作成をシグナルすることにあるため、これはシリアル化中に特別に扱われます。これにより、要素のis値がシリアル化と解析のラウンドトリップを通じて保持されることが保証されます。

パーサーを介してカスタマイズされた組み込み要素を作成する場合、開発者はis属性を直接使用します。このような場合、シリアル化と解析のラウンドトリップは問題なく機能します。 

<script>
 window.SuperP = class extends HTMLParagraphElement {};
 customElements.define("super-p", SuperP, { extends: "p" });
 </script>
 
 <div id="container"><p is="super-p">Superb!</p></div>
 
 <script>
 console.log(container.innerHTML); // <p is="super-p">
 container.innerHTML = container.innerHTML;
 console.log(container.innerHTML); // <p is="super-p">
 console.assert(container.firstChild instanceof SuperP);
 </script>

しかし、コンストラクターを介して、またはcreateElement()を使用してカスタマイズされた組み込み要素を作成する場合、is属性は追加されません。代わりに、is値（これはカスタム要素の仕組みが使用するものです）が、属性を介さずに直接設定されます。 

<script>
 container.innerHTML = "";
 const p = document.createElement("p", { is: "super-p" });
 container.appendChild(p);
 
 // The is attribute is not present in the DOM:
 console.assert(!p.hasAttribute("is"));
 
 // But the element is still a super-p:
 console.assert(p instanceof SuperP);
 </script>

シリアライズ-パースの往復が正常に機能するようにするために、シリアライズプロセスでは、要素のis値をis属性として明示的に書き出します:

<script>
 console.log(container.innerHTML); // <p is="super-p">
 container.innerHTML = container.innerHTML;
 console.log(container.innerHTML); // <p is="super-p">
 console.assert(container.firstChild instanceof SuperP);
 </script>

エスケープ処理（上記アルゴリズムの目的のため）とは、以下の手順を実行することです:

  1. "&"文字の出現箇所をすべて文字列"&amp;"に置き換える。

  2. U+00A0 NO-BREAK SPACE文字の出現箇所をすべて文字列"&nbsp;"に置き換える。

  3. "<"文字の出現箇所をすべて文字列"&lt;"に置き換える。

  4. ">"文字の出現箇所をすべて文字列"&gt;"に置き換える。

  5. アルゴリズムが属性モードで呼び出された場合、"""文字の出現箇所をすべて文字列"&quot;"に置き換える。

13.4 HTMLフラグメントの解析

HTML フラグメント解析アルゴリズムは、Element ノード context、文字列 input、およびオプションのブール値 allowDeclarativeShadowRoots (デフォルトは false) を指定すると、次のステップになります。これらは 0 個以上のノードのリストを返します。

HTML パーサーセクションのアルゴリズムでフラグメントケースとマークされた部分は、パーサーがこのアルゴリズムの目的で作成された場合にのみ発生する部分です。アルゴリズムには、情報提供のみを目的としてそのようなマークが付けられています。そのようなマークには規範的な重みはありません。フラグメントケースとして記述された条件が、パーサーがこのアルゴリズムを処理する目的で作成されなかった場合でも発生する可能性がある場合、それは仕様のエラーです。

  1. document を、タイプが「html」である Document ノードとします。

  2. context の ノードドキュメントがquirks モードの場合、document の モードを「quirks」に設定します。

  3. それ以外の場合で、context の ノードドキュメントがlimited-quirks モードの場合、document の モードを「limited-quirks」に設定します。

  4. allowDeclarativeShadowRoots が true の場合、document の 宣言的なシャドウルートを許可するを true に設定します。

  5. 新しいHTML パーサーを作成し、それを document に関連付けます。

  6. HTML パーサーのトークン化ステージの状態を、context 要素に応じて次のように設定します。

    title
    textarea
    トークナイザーをRCDATA 状態に切り替えます。
    style
    xmp
    iframe
    noembed
    noframes
    トークナイザーをRAWTEXT 状態に切り替えます。
    script
    トークナイザーをスクリプトデータ状態に切り替えます。
    noscript
    スクリプティングフラグが有効な場合、トークナイザーをRAWTEXT 状態に切り替えます。それ以外の場合、トークナイザーをデータ状態のままにします。
    plaintext
    トークナイザーをPLAINTEXT 状態に切り替えます。
    その他の要素
    トークナイザーをデータ状態のままにします。

    パフォーマンス上の理由から、エラーを報告せず、この仕様で説明されている実際の状態マシンを直接使用する実装では、上記のリストで言及されている RAWTEXT およびスクリプトデータ状態の代わりに PLAINTEXT 状態を使用できます。解析エラーに関するルールを除いて、フラグメントケースには適切な終了タグトークンがないため、それらは同等ですが、状態遷移がはるかに少なくなります。

  7. root を、document、「html」、HTML 名前空間、null、null、false、および context の カスタム要素レジストリを指定して要素を作成した結果とします。

  8. root を document に追加します。

  9. HTML パーサーの開いている要素のスタックを、単一の要素 root のみを含むように設定します。

  10. context が template 要素の場合、「in template」をテンプレート挿入モードのスタックにプッシュして、新しい現在のテンプレート挿入モードにします。

  11. context のローカル名を名前とし、context の属性を属性とする開始タグトークンを作成します。

    この開始タグトークンを context の開始タグトークンとします。たとえば、それがHTML 統合ポイントであるかどうかを判断する目的で。

  12. パーサーの挿入モードを適切にリセットします。

    パーサーは、そのアルゴリズムの一部として context 要素を参照します。

  13. HTML パーサーのform 要素ポインターを、context に最も近いノードで、form 要素であるもの（祖先チェーンをまっすぐ上にたどり、要素自体が form 要素の場合はそれを含む）に設定します（存在する場合）。（そのような form 要素がない場合、form 要素ポインターは初期値の null のままです。）

  14. input を、作成されたばかりのHTML パーサーの入力ストリームに入れます。エンコーディングの信頼性は無関係です。

  15. HTML パーサーを開始し、入力ストリームに挿入されたすべての文字を消費するまで実行させます。

  16. root の子を、ツリー順で返します。

13.5 名前付き文字参照

この表は、HTMLがサポートする文字参照名と、それが参照するコードポイントを示しています。これは前のセクションで参照されています。

レガシー互換性のため、多くのコードポイントが複数の文字参照名を持つことが意図されています。例えば、一部の文字参照名は、末尾にセミコロンがある場合とない場合、または異なる大文字小文字の組み合わせで表示される場合があります。

名前 文字 グリフ
Aacute; U+000C1 Á
Aacute U+000C1 Á
aacute; U+000E1 á
aacute U+000E1 á
Abreve; U+00102 Ă
abreve; U+00103 ă
ac; U+0223E ∾
acd; U+0223F ∿
acE; U+0223E U+00333 ∾̳
Acirc; U+000C2 Â
Acirc U+000C2 Â
acirc; U+000E2 â
acirc U+000E2 â
acute; U+000B4 ´
acute U+000B4 ´
Acy; U+00410 А
acy; U+00430 а
AElig; U+000C6 Æ
AElig U+000C6 Æ
aelig; U+000E6 æ
aelig U+000E6 æ
af; U+02061 ⁡
Afr; U+1D504 𝔄
afr; U+1D51E 𝔞
Agrave; U+000C0 À
Agrave U+000C0 À
agrave; U+000E0 à
agrave U+000E0 à
alefsym; U+02135 ℵ
aleph; U+02135 ℵ
Alpha; U+00391 Α
alpha; U+003B1 α
Amacr; U+00100 Ā
amacr; U+00101 ā
amalg; U+02A3F ⨿
AMP; U+00026 &
AMP U+00026 &
amp; U+00026 &
amp U+00026 &
And; U+02A53 ⩓
and; U+02227 ∧
andand; U+02A55 ⩕
andd; U+02A5C ⩜
andslope; U+02A58 ⩘
andv; U+02A5A ⩚
ang; U+02220 ∠
ange; U+029A4 ⦤
angle; U+02220 ∠
angmsd; U+02221 ∡
angmsdaa; U+029A8 ⦨
angmsdab; U+029A9 ⦩
angmsdac; U+029AA ⦪
angmsdad; U+029AB ⦫
angmsdae; U+029AC ⦬
angmsdaf; U+029AD ⦭
angmsdag; U+029AE ⦮
angmsdah; U+029AF ⦯
angrt; U+0221F ∟
angrtvb; U+022BE ⊾
angrtvbd; U+0299D ⦝
angsph; U+02222 ∢
angst; U+000C5 Å
angzarr; U+0237C ⍼
Aogon; U+00104 Ą
aogon; U+00105 ą
Aopf; U+1D538 𝔸
aopf; U+1D552 𝕒
ap; U+02248 ≈
apacir; U+02A6F ⩯
apE; U+02A70 ⩰
ape; U+0224A ≊
apid; U+0224B ≋
apos; U+00027 '
ApplyFunction; U+02061 ⁡
approx; U+02248 ≈
approxeq; U+0224A ≊
Aring; U+000C5 Å
Aring U+000C5 Å
aring; U+000E5 å
aring U+000E5 å
Ascr; U+1D49C 𝒜
ascr; U+1D4B6 𝒶
Assign; U+02254 ≔
ast; U+0002A *
asymp; U+02248 ≈
asympeq; U+0224D ≍
Atilde; U+000C3 Ã
Atilde U+000C3 Ã
atilde; U+000E3 ã
atilde U+000E3 ã
Auml; U+000C4 Ä
Auml U+000C4 Ä
auml; U+000E4 ä
auml U+000E4 ä
awconint; U+02233 ∳
awint; U+02A11 ⨑
backcong; U+0224C ≌
backepsilon; U+003F6 ϶
backprime; U+02035 ‵
backsim; U+0223D ∽
backsimeq; U+022CD ⋍
Backslash; U+02216 ∖
Barv; U+02AE7 ⫧
barvee; U+022BD ⊽
Barwed; U+02306 ⌆
barwed; U+02305 ⌅
barwedge; U+02305 ⌅
bbrk; U+023B5 ⎵
bbrktbrk; U+023B6 ⎶
bcong; U+0224C ≌
Bcy; U+00411 Б
bcy; U+00431 б
bdquo; U+0201E „
becaus; U+02235 ∵
Because; U+02235 ∵
because; U+02235 ∵
bemptyv; U+029B0 ⦰
bepsi; U+003F6 ϶
bernou; U+0212C ℬ
Bernoullis; U+0212C ℬ
Beta; U+00392 Β
beta; U+003B2 β
beth; U+02136 ℶ
between; U+0226C ≬
Bfr; U+1D505 𝔅
bfr; U+1D51F 𝔟
bigcap; U+022C2 ⋂
bigcirc; U+025EF ◯
bigcup; U+022C3 ⋃
bigodot; U+02A00 ⨀
bigoplus; U+02A01 ⨁
bigotimes; U+02A02 ⨂
bigsqcup; U+02A06 ⨆
bigstar; U+02605 ★
bigtriangledown; U+025BD ▽
bigtriangleup; U+025B3 △
biguplus; U+02A04 ⨄
bigvee; U+022C1 ⋁
bigwedge; U+022C0 ⋀
bkarow; U+0290D ⤍
blacklozenge; U+029EB ⧫
blacksquare; U+025AA ▪
blacktriangle; U+025B4 ▴
blacktriangledown; U+025BE ▾
blacktriangleleft; U+025C2 ◂
blacktriangleright; U+025B8 ▸
blank; U+02423 ␣
blk12; U+02592 ▒
blk14; U+02591 ░
blk34; U+02593 ▓
block; U+02588 █
bne; U+0003D U+020E5 =⃥
bnequiv; U+02261 U+020E5 ≡⃥
bNot; U+02AED ⫭
bnot; U+02310 ⌐
Bopf; U+1D539 𝔹
bopf; U+1D553 𝕓
bot; U+022A5 ⊥
bottom; U+022A5 ⊥
bowtie; U+022C8 ⋈
boxbox; U+029C9 ⧉
boxDL; U+02557 ╗
boxDl; U+02556 ╖
boxdL; U+02555 ╕
boxdl; U+02510 ┐
boxDR; U+02554 ╔
boxDr; U+02553 ╓
boxdR; U+02552 ╒
boxdr; U+0250C ┌
boxH; U+02550 ═
boxh; U+02500 ─
boxHD; U+02566 ╦
boxHd; U+02564 ╤
boxhD; U+02565 ╥
boxhd; U+0252C ┬
boxHU; U+02569 ╩
boxHu; U+02567 ╧
boxhU; U+02568 ╨
boxhu; U+02534 ┴
boxminus; U+0229F ⊟
boxplus; U+0229E ⊞
boxtimes; U+022A0 ⊠
boxUL; U+0255D ╝
boxUl; U+0255C ╜
boxuL; U+0255B ╛
boxul; U+02518 ┘
boxUR; U+0255A ╚
boxUr; U+02559 ╙
boxuR; U+02558 ╘
boxur; U+02514 └
boxV; U+02551 ║
boxv; U+02502 │
boxVH; U+0256C ╬
boxVh; U+0256B ╫
boxvH; U+0256A ╪
boxvh; U+0253C ┼
boxVL; U+02563 ╣
boxVl; U+02562 ╢
boxvL; U+02561 ╡
boxvl; U+02524 ┤
boxVR; U+02560 ╠
boxVr; U+0255F ╟
boxvR; U+0255E ╞
boxvr; U+0251C ├
bprime; U+02035 ‵
Breve; U+002D8 ˘
breve; U+002D8 ˘
brvbar; U+000A6 ¦
brvbar U+000A6 ¦
Bscr; U+0212C ℬ
bscr; U+1D4B7 𝒷
bsemi; U+0204F ⁏
bsim; U+0223D ∽
bsime; U+022CD ⋍
bsol; U+0005C \
bsolb; U+029C5 ⧅
bsolhsub; U+027C8 ⟈
bull; U+02022 •
bullet; U+02022 •
bump; U+0224E ≎
bumpE; U+02AAE ⪮
bumpe; U+0224F ≏
Bumpeq; U+0224E ≎
bumpeq; U+0224F ≏
Cacute; U+00106 Ć
cacute; U+00107 ć
Cap; U+022D2 ⋒
cap; U+02229 ∩
capand; U+02A44 ⩄
capbrcup; U+02A49 ⩉
capcap; U+02A4B ⩋
capcup; U+02A47 ⩇
capdot; U+02A40 ⩀
CapitalDifferentialD; U+02145 ⅅ
caps; U+02229 U+0FE00 ∩︀
caret; U+02041 ⁁
caron; U+002C7 ˇ
Cayleys; U+0212D ℭ
ccaps; U+02A4D ⩍
Ccaron; U+0010C Č
ccaron; U+0010D č
Ccedil; U+000C7 Ç
Ccedil U+000C7 Ç
ccedil; U+000E7 ç
ccedil U+000E7 ç
Ccirc; U+00108 Ĉ
ccirc; U+00109 ĉ
Cconint; U+02230 ∰
ccups; U+02A4C ⩌
ccupssm; U+02A50 ⩐
Cdot; U+0010A Ċ
cdot; U+0010B ċ
cedil; U+000B8 ¸
cedil U+000B8 ¸
Cedilla; U+000B8 ¸
cemptyv; U+029B2 ⦲
cent; U+000A2 ¢
cent U+000A2 ¢
CenterDot; U+000B7 ·
centerdot; U+000B7 ·
Cfr; U+0212D ℭ
cfr; U+1D520 𝔠
CHcy; U+00427 Ч
chcy; U+00447 ч
check; U+02713 ✓
checkmark; U+02713 ✓
Chi; U+003A7 Χ
chi; U+003C7 χ
cir; U+025CB ○
circ; U+002C6 ˆ
circeq; U+02257 ≗
circlearrowleft; U+021BA ↺
circlearrowright; U+021BB ↻
circledast; U+0229B ⊛
circledcirc; U+0229A ⊚
circleddash; U+0229D ⊝
CircleDot; U+02299 ⊙
circledR; U+000AE ®
circledS; U+024C8 Ⓢ
CircleMinus; U+02296 ⊖
CirclePlus; U+02295 ⊕
CircleTimes; U+02297 ⊗
cirE; U+029C3 ⧃
cire; U+02257 ≗
cirfnint; U+02A10 ⨐
cirmid; U+02AEF ⫯
cirscir; U+029C2 ⧂
ClockwiseContourIntegral; U+02232 ∲
CloseCurlyDoubleQuote; U+0201D ”
CloseCurlyQuote; U+02019 ’
clubs; U+02663 ♣
clubsuit; U+02663 ♣
Colon; U+02237 ∷
colon; U+0003A :
Colone; U+02A74 ⩴
colone; U+02254 ≔
coloneq; U+02254 ≔
comma; U+0002C ,
commat; U+00040 @
comp; U+02201 ∁
compfn; U+02218 ∘
complement; U+02201 ∁
complexes; U+02102 ℂ
cong; U+02245 ≅
congdot; U+02A6D ⩭
Congruent; U+02261 ≡
Conint; U+0222F ∯
conint; U+0222E ∮
ContourIntegral; U+0222E ∮
Copf; U+02102 ℂ
copf; U+1D554 𝕔
coprod; U+02210 ∐
Coproduct; U+02210 ∐
COPY; U+000A9 ©
COPY U+000A9 ©
copy; U+000A9 ©
copy U+000A9 ©
copysr; U+02117 ℗
CounterClockwiseContourIntegral; U+02233 ∳
crarr; U+021B5 ↵
Cross; U+02A2F ⨯
cross; U+02717 ✗
Cscr; U+1D49E 𝒞
cscr; U+1D4B8 𝒸
csub; U+02ACF ⫏
csube; U+02AD1 ⫑
csup; U+02AD0 ⫐
csupe; U+02AD2 ⫒
ctdot; U+022EF ⋯
cudarrl; U+02938 ⤸
cudarrr; U+02935 ⤵
cuepr; U+022DE ⋞
cuesc; U+022DF ⋟
cularr; U+021B6 ↶
cularrp; U+0293D ⤽
Cup; U+022D3 ⋓
cup; U+0222A ∪
cupbrcap; U+02A48 ⩈
CupCap; U+0224D ≍
cupcap; U+02A46 ⩆
cupcup; U+02A4A ⩊
cupdot; U+0228D ⊍
cupor; U+02A45 ⩅
cups; U+0222A U+0FE00 ∪︀
curarr; U+021B7 ↷
curarrm; U+0293C ⤼
curlyeqprec; U+022DE ⋞
curlyeqsucc; U+022DF ⋟
curlyvee; U+022CE ⋎
curlywedge; U+022CF ⋏
curren; U+000A4 ¤
curren U+000A4 ¤
curvearrowleft; U+021B6 ↶
curvearrowright; U+021B7 ↷
cuvee; U+022CE ⋎
cuwed; U+022CF ⋏
cwconint; U+02232 ∲
cwint; U+02231 ∱
cylcty; U+0232D ⌭
Dagger; U+02021 ‡
dagger; U+02020 †
daleth; U+02138 ℸ
Darr; U+021A1 ↡
dArr; U+021D3 ⇓
darr; U+02193 ↓
dash; U+02010 ‐
Dashv; U+02AE4 ⫤
dashv; U+022A3 ⊣
dbkarow; U+0290F ⤏
dblac; U+002DD ˝
Dcaron; U+0010E Ď
dcaron; U+0010F ď
Dcy; U+00414 Д
dcy; U+00434 д
DD; U+02145 ⅅ
dd; U+02146 ⅆ
ddagger; U+02021 ‡
ddarr; U+021CA ⇊
DDotrahd; U+02911 ⤑
ddotseq; U+02A77 ⩷
deg; U+000B0 °
deg U+000B0 °
Del; U+02207 ∇
Delta; U+00394 Δ
delta; U+003B4 δ
demptyv; U+029B1 ⦱
dfisht; U+0297F ⥿
Dfr; U+1D507 𝔇
dfr; U+1D521 𝔡
dHar; U+02965 ⥥
dharl; U+021C3 ⇃
dharr; U+021C2 ⇂
DiacriticalAcute; U+000B4 ´
DiacriticalDot; U+002D9 ˙
DiacriticalDoubleAcute; U+002DD ˝
DiacriticalGrave; U+00060 `
DiacriticalTilde; U+002DC ˜
diam; U+022C4 ⋄
Diamond; U+022C4 ⋄
diamond; U+022C4 ⋄
diamondsuit; U+02666 ♦
diams; U+02666 ♦
die; U+000A8 ¨
DifferentialD; U+02146 ⅆ
digamma; U+003DD ϝ
disin; U+022F2 ⋲
div; U+000F7 ÷
divide; U+000F7 ÷
divide U+000F7 ÷
divideontimes; U+022C7 ⋇
divonx; U+022C7 ⋇
DJcy; U+00402 Ђ
djcy; U+00452 ђ
dlcorn; U+0231E ⌞
dlcrop; U+0230D ⌍
dollar; U+00024 $
Dopf; U+1D53B 𝔻
dopf; U+1D555 𝕕
Dot; U+000A8 ¨
dot; U+002D9 ˙
DotDot; U+020DC ◌⃜
doteq; U+02250 ≐
doteqdot; U+02251 ≑
DotEqual; U+02250 ≐
dotminus; U+02238 ∸
dotplus; U+02214 ∔
dotsquare; U+022A1 ⊡
doublebarwedge; U+02306 ⌆
DoubleContourIntegral; U+0222F ∯
DoubleDot; U+000A8 ¨
DoubleDownArrow; U+021D3 ⇓
DoubleLeftArrow; U+021D0 ⇐
DoubleLeftRightArrow; U+021D4 ⇔
DoubleLeftTee; U+02AE4 ⫤
DoubleLongLeftArrow; U+027F8 ⟸
DoubleLongLeftRightArrow; U+027FA ⟺
DoubleLongRightArrow; U+027F9 ⟹
DoubleRightArrow; U+021D2 ⇒
DoubleRightTee; U+022A8 ⊨
DoubleUpArrow; U+021D1 ⇑
DoubleUpDownArrow; U+021D5 ⇕
DoubleVerticalBar; U+02225 ∥
DownArrow; U+02193 ↓
Downarrow; U+021D3 ⇓
downarrow; U+02193 ↓
DownArrowBar; U+02913 ⤓
DownArrowUpArrow; U+021F5 ⇵
DownBreve; U+00311 ◌̑
downdownarrows; U+021CA ⇊
downharpoonleft; U+021C3 ⇃
downharpoonright; U+021C2 ⇂
DownLeftRightVector; U+02950 ⥐
DownLeftTeeVector; U+0295E ⥞
DownLeftVector; U+021BD ↽
DownLeftVectorBar; U+02956 ⥖
DownRightTeeVector; U+0295F ⥟
DownRightVector; U+021C1 ⇁
DownRightVectorBar; U+02957 ⥗
DownTee; U+022A4 ⊤
DownTeeArrow; U+021A7 ↧
drbkarow; U+02910 ⤐
drcorn; U+0231F ⌟
drcrop; U+0230C ⌌
Dscr; U+1D49F 𝒟
dscr; U+1D4B9 𝒹
DScy; U+00405 Ѕ
dscy; U+00455 ѕ
dsol; U+029F6 ⧶
Dstrok; U+00110 Đ
dstrok; U+00111 đ
dtdot; U+022F1 ⋱
dtri; U+025BF ▿
dtrif; U+025BE ▾
duarr; U+021F5 ⇵
duhar; U+0296F ⥯
dwangle; U+029A6 ⦦
DZcy; U+0040F Џ
dzcy; U+0045F џ
dzigrarr; U+027FF ⟿
Eacute; U+000C9 É
Eacute U+000C9 É
eacute; U+000E9 é
eacute U+000E9 é
easter; U+02A6E ⩮
Ecaron; U+0011A Ě
ecaron; U+0011B ě
ecir; U+02256 ≖
Ecirc; U+000CA Ê
Ecirc U+000CA Ê
ecirc; U+000EA ê
ecirc U+000EA ê
ecolon; U+02255 ≕
Ecy; U+0042D Э
ecy; U+0044D э
eDDot; U+02A77 ⩷
Edot; U+00116 Ė
eDot; U+02251 ≑
edot; U+00117 ė
ee; U+02147 ⅇ
efDot; U+02252 ≒
Efr; U+1D508 𝔈
efr; U+1D522 𝔢
eg; U+02A9A ⪚
Egrave; U+000C8 È
Egrave U+000C8 È
egrave; U+000E8 è
egrave U+000E8 è
egs; U+02A96 ⪖
egsdot; U+02A98 ⪘
el; U+02A99 ⪙
Element; U+02208 ∈
elinters; U+023E7 ⏧
ell; U+02113 ℓ
els; U+02A95 ⪕
elsdot; U+02A97 ⪗
Emacr; U+00112 Ē
emacr; U+00113 ē
empty; U+02205 ∅
emptyset; U+02205 ∅
EmptySmallSquare; U+025FB ◻
emptyv; U+02205 ∅
EmptyVerySmallSquare; U+025AB ▫
emsp; U+02003  
emsp13; U+02004  
emsp14; U+02005  
ENG; U+0014A Ŋ
eng; U+0014B ŋ
ensp; U+02002  
Eogon; U+00118 Ę
eogon; U+00119 ę
Eopf; U+1D53C 𝔼
eopf; U+1D556 𝕖
epar; U+022D5 ⋕
eparsl; U+029E3 ⧣
eplus; U+02A71 ⩱
epsi; U+003B5 ε
Epsilon; U+00395 Ε
epsilon; U+003B5 ε
epsiv; U+003F5 ϵ
eqcirc; U+02256 ≖
eqcolon; U+02255 ≕
eqsim; U+02242 ≂
eqslantgtr; U+02A96 ⪖
eqslantless; U+02A95 ⪕
Equal; U+02A75 ⩵
equals; U+0003D =
EqualTilde; U+02242 ≂
equest; U+0225F ≟
Equilibrium; U+021CC ⇌
equiv; U+02261 ≡
equivDD; U+02A78 ⩸
eqvparsl; U+029E5 ⧥
erarr; U+02971 ⥱
erDot; U+02253 ≓
Escr; U+02130 ℰ
escr; U+0212F ℯ
esdot; U+02250 ≐
Esim; U+02A73 ⩳
esim; U+02242 ≂
Eta; U+00397 Η
eta; U+003B7 η
ETH; U+000D0 Ð
ETH U+000D0 Ð
eth; U+000F0 ð
eth U+000F0 ð
Euml; U+000CB Ë
Euml U+000CB Ë
euml; U+000EB ë
euml U+000EB ë
euro; U+020AC €
excl; U+00021 !
exist; U+02203 ∃
Exists; U+02203 ∃
expectation; U+02130 ℰ
ExponentialE; U+02147 ⅇ
exponentiale; U+02147 ⅇ
fallingdotseq; U+02252 ≒
Fcy; U+00424 Ф
fcy; U+00444 ф
female; U+02640 ♀
ffilig; U+0FB03 ffi
fflig; U+0FB00 ff
ffllig; U+0FB04 ffl
Ffr; U+1D509 𝔉
ffr; U+1D523 𝔣
filig; U+0FB01 fi
FilledSmallSquare; U+025FC ◼
FilledVerySmallSquare; U+025AA ▪
fjlig; U+00066 U+0006A fj
flat; U+0266D ♭
fllig; U+0FB02 fl
fltns; U+025B1 ▱
fnof; U+00192 ƒ
Fopf; U+1D53D 𝔽
fopf; U+1D557 𝕗
ForAll; U+02200 ∀
forall; U+02200 ∀
fork; U+022D4 ⋔
forkv; U+02AD9 ⫙
Fouriertrf; U+02131 ℱ
fpartint; U+02A0D ⨍
frac12; U+000BD ½
frac12 U+000BD ½
frac13; U+02153 ⅓
frac14; U+000BC ¼
frac14 U+000BC ¼
frac15; U+02155 ⅕
frac16; U+02159 ⅙
frac18; U+0215B ⅛
frac23; U+02154 ⅔
frac25; U+02156 ⅖
frac34; U+000BE ¾
frac34 U+000BE ¾
frac35; U+02157 ⅗
frac38; U+0215C ⅜
frac45; U+02158 ⅘
frac56; U+0215A ⅚
frac58; U+0215D ⅝
frac78; U+0215E ⅞
frasl; U+02044 ⁄
frown; U+02322 ⌢
Fscr; U+02131 ℱ
fscr; U+1D4BB 𝒻
gacute; U+001F5 ǵ
Gamma; U+00393 Γ
gamma; U+003B3 γ
Gammad; U+003DC Ϝ
gammad; U+003DD ϝ
gap; U+02A86 ⪆
Gbreve; U+0011E Ğ
gbreve; U+0011F ğ
Gcedil; U+00122 Ģ
Gcirc; U+0011C Ĝ
gcirc; U+0011D ĝ
Gcy; U+00413 Г
gcy; U+00433 г
Gdot; U+00120 Ġ
gdot; U+00121 ġ
gE; U+02267 ≧
ge; U+02265 ≥
gEl; U+02A8C ⪌
gel; U+022DB ⋛
geq; U+02265 ≥
geqq; U+02267 ≧
geqslant; U+02A7E ⩾
ges; U+02A7E ⩾
gescc; U+02AA9 ⪩
gesdot; U+02A80 ⪀
gesdoto; U+02A82 ⪂
gesdotol; U+02A84 ⪄
gesl; U+022DB U+0FE00 ⋛︀
gesles; U+02A94 ⪔
Gfr; U+1D50A 𝔊
gfr; U+1D524 𝔤
Gg; U+022D9 ⋙
gg; U+0226B ≫
ggg; U+022D9 ⋙
gimel; U+02137 ℷ
GJcy; U+00403 Ѓ
gjcy; U+00453 ѓ
gl; U+02277 ≷
gla; U+02AA5 ⪥
glE; U+02A92 ⪒
glj; U+02AA4 ⪤
gnap; U+02A8A ⪊
gnapprox; U+02A8A ⪊
gnE; U+02269 ≩
gne; U+02A88 ⪈
gneq; U+02A88 ⪈
gneqq; U+02269 ≩
gnsim; U+022E7 ⋧
Gopf; U+1D53E 𝔾
gopf; U+1D558 𝕘
grave; U+00060 `
GreaterEqual; U+02265 ≥
GreaterEqualLess; U+022DB ⋛
GreaterFullEqual; U+02267 ≧
GreaterGreater; U+02AA2 ⪢
GreaterLess; U+02277 ≷
GreaterSlantEqual; U+02A7E ⩾
GreaterTilde; U+02273 ≳
Gscr; U+1D4A2 𝒢
gscr; U+0210A ℊ
gsim; U+02273 ≳
gsime; U+02A8E ⪎
gsiml; U+02A90 ⪐
GT; U+0003E >
GT U+0003E >
Gt; U+0226B ≫
gt; U+0003E >
gt U+0003E >
gtcc; U+02AA7 ⪧
gtcir; U+02A7A ⩺
gtdot; U+022D7 ⋗
gtlPar; U+02995 ⦕
gtquest; U+02A7C ⩼
gtrapprox; U+02A86 ⪆
gtrarr; U+02978 ⥸
gtrdot; U+022D7 ⋗
gtreqless; U+022DB ⋛
gtreqqless; U+02A8C ⪌
gtrless; U+02277 ≷
gtrsim; U+02273 ≳
gvertneqq; U+02269 U+0FE00 ≩︀
gvnE; U+02269 U+0FE00 ≩︀
Hacek; U+002C7 ˇ
hairsp; U+0200A  
half; U+000BD ½
hamilt; U+0210B ℋ
HARDcy; U+0042A Ъ
hardcy; U+0044A ъ
hArr; U+021D4 ⇔
harr; U+02194 ↔
harrcir; U+02948 ⥈
harrw; U+021AD ↭
Hat; U+0005E ^
hbar; U+0210F ℏ
Hcirc; U+00124 Ĥ
hcirc; U+00125 ĥ
hearts; U+02665 ♥
heartsuit; U+02665 ♥
hellip; U+02026 …
hercon; U+022B9 ⊹
Hfr; U+0210C ℌ
hfr; U+1D525 𝔥
HilbertSpace; U+0210B ℋ
hksearow; U+02925 ⤥
hkswarow; U+02926 ⤦
hoarr; U+021FF ⇿
homtht; U+0223B ∻
hookleftarrow; U+021A9 ↩
hookrightarrow; U+021AA ↪
Hopf; U+0210D ℍ
hopf; U+1D559 𝕙
horbar; U+02015 ―
HorizontalLine; U+02500 ─
Hscr; U+0210B ℋ
hscr; U+1D4BD 𝒽
hslash; U+0210F ℏ
Hstrok; U+00126 Ħ
hstrok; U+00127 ħ
HumpDownHump; U+0224E ≎
HumpEqual; U+0224F ≏
hybull; U+02043 ⁃
hyphen; U+02010 ‐
Iacute; U+000CD Í
Iacute U+000CD Í
iacute; U+000ED í
iacute U+000ED í
ic; U+02063 ⁣
Icirc; U+000CE Î
Icirc U+000CE Î
icirc; U+000EE î
icirc U+000EE î
Icy; U+00418 И
icy; U+00438 и
Idot; U+00130 İ
IEcy; U+00415 Е
iecy; U+00435 е
iexcl; U+000A1 ¡
iexcl U+000A1 ¡
iff; U+021D4 ⇔
Ifr; U+02111 ℑ
ifr; U+1D526 𝔦
Igrave; U+000CC Ì
Igrave U+000CC Ì
igrave; U+000EC ì
igrave U+000EC ì
ii; U+02148 ⅈ
iiiint; U+02A0C ⨌
iiint; U+0222D ∭
iinfin; U+029DC ⧜
iiota; U+02129 ℩
IJlig; U+00132 IJ
ijlig; U+00133 ij
Im; U+02111 ℑ
Imacr; U+0012A Ī
imacr; U+0012B ī
image; U+02111 ℑ
ImaginaryI; U+02148 ⅈ
imagline; U+02110 ℐ
imagpart; U+02111 ℑ
imath; U+00131 ı
imof; U+022B7 ⊷
imped; U+001B5 Ƶ
Implies; U+021D2 ⇒
in; U+02208 ∈
incare; U+02105 ℅
infin; U+0221E ∞
infintie; U+029DD ⧝
inodot; U+00131 ı
Int; U+0222C ∬
int; U+0222B ∫
intcal; U+022BA ⊺
integers; U+02124 ℤ
Integral; U+0222B ∫
intercal; U+022BA ⊺
Intersection; U+022C2 ⋂
intlarhk; U+02A17 ⨗
intprod; U+02A3C ⨼
InvisibleComma; U+02063 ⁣
InvisibleTimes; U+02062 ⁢
IOcy; U+00401 Ё
iocy; U+00451 ё
Iogon; U+0012E Į
iogon; U+0012F į
Iopf; U+1D540 𝕀
iopf; U+1D55A 𝕚
Iota; U+00399 Ι
iota; U+003B9 ι
iprod; U+02A3C ⨼
iquest; U+000BF ¿
iquest U+000BF ¿
Iscr; U+02110 ℐ
iscr; U+1D4BE 𝒾
isin; U+02208 ∈
isindot; U+022F5 ⋵
isinE; U+022F9 ⋹
isins; U+022F4 ⋴
isinsv; U+022F3 ⋳
isinv; U+02208 ∈
it; U+02062 ⁢
Itilde; U+00128 Ĩ
itilde; U+00129 ĩ
Iukcy; U+00406 І
iukcy; U+00456 і
Iuml; U+000CF Ï
Iuml U+000CF Ï
iuml; U+000EF ï
iuml U+000EF ï
Jcirc; U+00134 Ĵ
jcirc; U+00135 ĵ
Jcy; U+00419 Й
jcy; U+00439 й
Jfr; U+1D50D 𝔍
jfr; U+1D527 𝔧
jmath; U+00237 ȷ
Jopf; U+1D541 𝕁
jopf; U+1D55B 𝕛
Jscr; U+1D4A5 𝒥
jscr; U+1D4BF 𝒿
Jsercy; U+00408 Ј
jsercy; U+00458 ј
Jukcy; U+00404 Є
jukcy; U+00454 є
Kappa; U+0039A Κ
kappa; U+003BA κ
kappav; U+003F0 ϰ
Kcedil; U+00136 Ķ
kcedil; U+00137 ķ
Kcy; U+0041A К
kcy; U+0043A к
Kfr; U+1D50E 𝔎
kfr; U+1D528 𝔨
kgreen; U+00138 ĸ
KHcy; U+00425 Х
khcy; U+00445 х
KJcy; U+0040C Ќ
kjcy; U+0045C ќ
Kopf; U+1D542 𝕂
kopf; U+1D55C 𝕜
Kscr; U+1D4A6 𝒦
kscr; U+1D4C0 𝓀
lAarr; U+021DA ⇚
Lacute; U+00139 Ĺ
lacute; U+0013A ĺ
laemptyv; U+029B4 ⦴
lagran; U+02112 ℒ
Lambda; U+0039B Λ
lambda; U+003BB λ
Lang; U+027EA ⟪
lang; U+027E8 ⟨
langd; U+02991 ⦑
langle; U+027E8 ⟨
lap; U+02A85 ⪅
Laplacetrf; U+02112 ℒ
laquo; U+000AB «
laquo U+000AB «
Larr; U+0219E ↞
lArr; U+021D0 ⇐
larr; U+02190 ←
larrb; U+021E4 ⇤
larrbfs; U+0291F ⤟
larrfs; U+0291D ⤝
larrhk; U+021A9 ↩
larrlp; U+021AB ↫
larrpl; U+02939 ⤹
larrsim; U+02973 ⥳
larrtl; U+021A2 ↢
lat; U+02AAB ⪫
lAtail; U+0291B ⤛
latail; U+02919 ⤙
late; U+02AAD ⪭
lates; U+02AAD U+0FE00 ⪭︀
lBarr; U+0290E ⤎
lbarr; U+0290C ⤌
lbbrk; U+02772 ❲
lbrace; U+0007B {
lbrack; U+0005B [
lbrke; U+0298B ⦋
lbrksld; U+0298F ⦏
lbrkslu; U+0298D ⦍
Lcaron; U+0013D Ľ
lcaron; U+0013E ľ
Lcedil; U+0013B Ļ
lcedil; U+0013C ļ
lceil; U+02308 ⌈
lcub; U+0007B {
Lcy; U+0041B Л
lcy; U+0043B л
ldca; U+02936 ⤶
ldquo; U+0201C “
ldquor; U+0201E „
ldrdhar; U+02967 ⥧
ldrushar; U+0294B ⥋
ldsh; U+021B2 ↲
lE; U+02266 ≦
le; U+02264 ≤
LeftAngleBracket; U+027E8 ⟨
LeftArrow; U+02190 ←
Leftarrow; U+021D0 ⇐
leftarrow; U+02190 ←
LeftArrowBar; U+021E4 ⇤
LeftArrowRightArrow; U+021C6 ⇆
leftarrowtail; U+021A2 ↢
LeftCeiling; U+02308 ⌈
LeftDoubleBracket; U+027E6 ⟦
LeftDownTeeVector; U+02961 ⥡
LeftDownVector; U+021C3 ⇃
LeftDownVectorBar; U+02959 ⥙
LeftFloor; U+0230A ⌊
leftharpoondown; U+021BD ↽
leftharpoonup; U+021BC ↼
leftleftarrows; U+021C7 ⇇
LeftRightArrow; U+02194 ↔
Leftrightarrow; U+021D4 ⇔
leftrightarrow; U+02194 ↔
leftrightarrows; U+021C6 ⇆
leftrightharpoons; U+021CB ⇋
leftrightsquigarrow; U+021AD ↭
LeftRightVector; U+0294E ⥎
LeftTee; U+022A3 ⊣
LeftTeeArrow; U+021A4 ↤
LeftTeeVector; U+0295A ⥚
leftthreetimes; U+022CB ⋋
LeftTriangle; U+022B2 ⊲
LeftTriangleBar; U+029CF ⧏
LeftTriangleEqual; U+022B4 ⊴
LeftUpDownVector; U+02951 ⥑
LeftUpTeeVector; U+02960 ⥠
LeftUpVector; U+021BF ↿
LeftUpVectorBar; U+02958 ⥘
LeftVector; U+021BC ↼
LeftVectorBar; U+02952 ⥒
lEg; U+02A8B ⪋
leg; U+022DA ⋚
leq; U+02264 ≤
leqq; U+02266 ≦
leqslant; U+02A7D ⩽
les; U+02A7D ⩽
lescc; U+02AA8 ⪨
lesdot; U+02A7F ⩿
lesdoto; U+02A81 ⪁
lesdotor; U+02A83 ⪃
lesg; U+022DA U+0FE00 ⋚︀
lesges; U+02A93 ⪓
lessapprox; U+02A85 ⪅
lessdot; U+022D6 ⋖
lesseqgtr; U+022DA ⋚
lesseqqgtr; U+02A8B ⪋
LessEqualGreater; U+022DA ⋚
LessFullEqual; U+02266 ≦
LessGreater; U+02276 ≶
lessgtr; U+02276 ≶
LessLess; U+02AA1 ⪡
lesssim; U+02272 ≲
LessSlantEqual; U+02A7D ⩽
LessTilde; U+02272 ≲
lfisht; U+0297C ⥼
lfloor; U+0230A ⌊
Lfr; U+1D50F 𝔏
lfr; U+1D529 𝔩
lg; U+02276 ≶
lgE; U+02A91 ⪑
lHar; U+02962 ⥢
lhard; U+021BD ↽
lharu; U+021BC ↼
lharul; U+0296A ⥪
lhblk; U+02584 ▄
LJcy; U+00409 Љ
ljcy; U+00459 љ
Ll; U+022D8 ⋘
ll; U+0226A ≪
llarr; U+021C7 ⇇
llcorner; U+0231E ⌞
Lleftarrow; U+021DA ⇚
llhard; U+0296B ⥫
lltri; U+025FA ◺
Lmidot; U+0013F Ŀ
lmidot; U+00140 ŀ
lmoust; U+023B0 ⎰
lmoustache; U+023B0 ⎰
lnap; U+02A89 ⪉
lnapprox; U+02A89 ⪉
lnE; U+02268 ≨
lne; U+02A87 ⪇
lneq; U+02A87 ⪇
lneqq; U+02268 ≨
lnsim; U+022E6 ⋦
loang; U+027EC ⟬
loarr; U+021FD ⇽
lobrk; U+027E6 ⟦
LongLeftArrow; U+027F5 ⟵
Longleftarrow; U+027F8 ⟸
longleftarrow; U+027F5 ⟵
LongLeftRightArrow; U+027F7 ⟷
Longleftrightarrow; U+027FA ⟺
longleftrightarrow; U+027F7 ⟷
longmapsto; U+027FC ⟼
LongRightArrow; U+027F6 ⟶
Longrightarrow; U+027F9 ⟹
longrightarrow; U+027F6 ⟶
looparrowleft; U+021AB ↫
looparrowright; U+021AC ↬
lopar; U+02985 ⦅
Lopf; U+1D543 𝕃
lopf; U+1D55D 𝕝
loplus; U+02A2D ⨭
lotimes; U+02A34 ⨴
lowast; U+02217 ∗
lowbar; U+0005F _
LowerLeftArrow; U+02199 ↙
LowerRightArrow; U+02198 ↘
loz; U+025CA ◊
lozenge; U+025CA ◊
lozf; U+029EB ⧫
lpar; U+00028 (
lparlt; U+02993 ⦓
lrarr; U+021C6 ⇆
lrcorner; U+0231F ⌟
lrhar; U+021CB ⇋
lrhard; U+0296D ⥭
lrm; U+0200E ‎
lrtri; U+022BF ⊿
lsaquo; U+02039 ‹
Lscr; U+02112 ℒ
lscr; U+1D4C1 𝓁
Lsh; U+021B0 ↰
lsh; U+021B0 ↰
lsim; U+02272 ≲
lsime; U+02A8D ⪍
lsimg; U+02A8F ⪏
lsqb; U+0005B [
lsquo; U+02018 ‘
lsquor; U+0201A ‚
Lstrok; U+00141 Ł
lstrok; U+00142 ł
LT; U+0003C <
LT U+0003C <
Lt; U+0226A ≪
lt; U+0003C <
lt U+0003C <
ltcc; U+02AA6 ⪦
ltcir; U+02A79 ⩹
ltdot; U+022D6 ⋖
lthree; U+022CB ⋋
ltimes; U+022C9 ⋉
ltlarr; U+02976 ⥶
ltquest; U+02A7B ⩻
ltri; U+025C3 ◃
ltrie; U+022B4 ⊴
ltrif; U+025C2 ◂
ltrPar; U+02996 ⦖
lurdshar; U+0294A ⥊
luruhar; U+02966 ⥦
lvertneqq; U+02268 U+0FE00 ≨︀
lvnE; U+02268 U+0FE00 ≨︀
macr; U+000AF ¯
macr U+000AF ¯
male; U+02642 ♂
malt; U+02720 ✠
maltese; U+02720 ✠
Map; U+02905 ⤅
map; U+021A6 ↦
mapsto; U+021A6 ↦
mapstodown; U+021A7 ↧
mapstoleft; U+021A4 ↤
mapstoup; U+021A5 ↥
marker; U+025AE ▮
mcomma; U+02A29 ⨩
Mcy; U+0041C М
mcy; U+0043C м
mdash; U+02014 —
mDDot; U+0223A ∺
measuredangle; U+02221 ∡
MediumSpace; U+0205F  
Mellintrf; U+02133 ℳ
Mfr; U+1D510 𝔐
mfr; U+1D52A 𝔪
mho; U+02127 ℧
micro; U+000B5 µ
micro U+000B5 µ
mid; U+02223 ∣
midast; U+0002A *
midcir; U+02AF0 ⫰
middot; U+000B7 ·
middot U+000B7 ·
minus; U+02212 −
minusb; U+0229F ⊟
minusd; U+02238 ∸
minusdu; U+02A2A ⨪
MinusPlus; U+02213 ∓
mlcp; U+02ADB ⫛
mldr; U+02026 …
mnplus; U+02213 ∓
models; U+022A7 ⊧
Mopf; U+1D544 𝕄
mopf; U+1D55E 𝕞
mp; U+02213 ∓
Mscr; U+02133 ℳ
mscr; U+1D4C2 𝓂
mstpos; U+0223E ∾
Mu; U+0039C Μ
mu; U+003BC μ
multimap; U+022B8 ⊸
mumap; U+022B8 ⊸
nabla; U+02207 ∇
Nacute; U+00143 Ń
nacute; U+00144 ń
nang; U+02220 U+020D2 ∠⃒
nap; U+02249 ≉
napE; U+02A70 U+00338 ⩰̸
napid; U+0224B U+00338 ≋̸
napos; U+00149 ʼn
napprox; U+02249 ≉
natur; U+0266E ♮
natural; U+0266E ♮
naturals; U+02115 ℕ
nbsp; U+000A0
nbsp U+000A0
nbump; U+0224E U+00338 ≎̸
nbumpe; U+0224F U+00338 ≏̸
ncap; U+02A43 ⩃
Ncaron; U+00147 Ň
ncaron; U+00148 ň
Ncedil; U+00145 Ņ
ncedil; U+00146 ņ
ncong; U+02247 ≇
ncongdot; U+02A6D U+00338 ⩭̸
ncup; U+02A42 ⩂
Ncy; U+0041D Н
ncy; U+0043D н
ndash; U+02013 –
ne; U+02260 ≠
nearhk; U+02924 ⤤
neArr; U+021D7 ⇗
nearr; U+02197 ↗
nearrow; U+02197 ↗
nedot; U+02250 U+00338 ≐̸
NegativeMediumSpace; U+0200B ​
NegativeThickSpace; U+0200B ​
NegativeThinSpace; U+0200B ​
NegativeVeryThinSpace; U+0200B ​
nequiv; U+02262 ≢
nesear; U+02928 ⤨
nesim; U+02242 U+00338 ≂̸
NestedGreaterGreater; U+0226B ≫
NestedLessLess; U+0226A ≪
NewLine; U+0000A ␊
nexist; U+02204 ∄
nexists; U+02204 ∄
Nfr; U+1D511 𝔑
nfr; U+1D52B 𝔫
ngE; U+02267 U+00338 ≧̸
nge; U+02271 ≱
ngeq; U+02271 ≱
ngeqq; U+02267 U+00338 ≧̸
ngeqslant; U+02A7E U+00338 ⩾̸
nges; U+02A7E U+00338 ⩾̸
nGg; U+022D9 U+00338 ⋙̸
ngsim; U+02275 ≵
nGt; U+0226B U+020D2 ≫⃒
ngt; U+0226F ≯
ngtr; U+0226F ≯
nGtv; U+0226B U+00338 ≫̸
nhArr; U+021CE ⇎
nharr; U+021AE ↮
nhpar; U+02AF2 ⫲
ni; U+0220B ∋
nis; U+022FC ⋼
nisd; U+022FA ⋺
niv; U+0220B ∋
NJcy; U+0040A Њ
njcy; U+0045A њ
nlArr; U+021CD ⇍
nlarr; U+0219A ↚
nldr; U+02025 ‥
nlE; U+02266 U+00338 ≦̸
nle; U+02270 ≰
nLeftarrow; U+021CD ⇍
nleftarrow; U+0219A ↚
nLeftrightarrow; U+021CE ⇎
nleftrightarrow; U+021AE ↮
nleq; U+02270 ≰
nleqq; U+02266 U+00338 ≦̸
nleqslant; U+02A7D U+00338 ⩽̸
nles; U+02A7D U+00338 ⩽̸
nless; U+0226E ≮
nLl; U+022D8 U+00338 ⋘̸
nlsim; U+02274 ≴
nLt; U+0226A U+020D2 ≪⃒
nlt; U+0226E ≮
nltri; U+022EA ⋪
nltrie; U+022EC ⋬
nLtv; U+0226A U+00338 ≪̸
nmid; U+02224 ∤
NoBreak; U+02060 ⁠
NonBreakingSpace; U+000A0
Nopf; U+02115 ℕ
nopf; U+1D55F 𝕟
Not; U+02AEC ⫬
not; U+000AC ¬
not U+000AC ¬
NotCongruent; U+02262 ≢
NotCupCap; U+0226D ≭
NotDoubleVerticalBar; U+02226 ∦
NotElement; U+02209 ∉
NotEqual; U+02260 ≠
NotEqualTilde; U+02242 U+00338 ≂̸
NotExists; U+02204 ∄
NotGreater; U+0226F ≯
NotGreaterEqual; U+02271 ≱
NotGreaterFullEqual; U+02267 U+00338 ≧̸
NotGreaterGreater; U+0226B U+00338 ≫̸
NotGreaterLess; U+02279 ≹
NotGreaterSlantEqual; U+02A7E U+00338 ⩾̸
NotGreaterTilde; U+02275 ≵
NotHumpDownHump; U+0224E U+00338 ≎̸
NotHumpEqual; U+0224F U+00338 ≏̸
notin; U+02209 ∉
notindot; U+022F5 U+00338 ⋵̸
notinE; U+022F9 U+00338 ⋹̸
notinva; U+02209 ∉
notinvb; U+022F7 ⋷
notinvc; U+022F6 ⋶
NotLeftTriangle; U+022EA ⋪
NotLeftTriangleBar; U+029CF U+00338 ⧏̸
NotLeftTriangleEqual; U+022EC ⋬
NotLess; U+0226E ≮
NotLessEqual; U+02270 ≰
NotLessGreater; U+02278 ≸
NotLessLess; U+0226A U+00338 ≪̸
NotLessSlantEqual; U+02A7D U+00338 ⩽̸
NotLessTilde; U+02274 ≴
NotNestedGreaterGreater; U+02AA2 U+00338 ⪢̸
NotNestedLessLess; U+02AA1 U+00338 ⪡̸
notni; U+0220C ∌
notniva; U+0220C ∌
notnivb; U+022FE ⋾
notnivc; U+022FD ⋽
NotPrecedes; U+02280 ⊀
NotPrecedesEqual; U+02AAF U+00338 ⪯̸
NotPrecedesSlantEqual; U+022E0 ⋠
NotReverseElement; U+0220C ∌
NotRightTriangle; U+022EB ⋫
NotRightTriangleBar; U+029D0 U+00338 ⧐̸
NotRightTriangleEqual; U+022ED ⋭
NotSquareSubset; U+0228F U+00338 ⊏̸
NotSquareSubsetEqual; U+022E2 ⋢
NotSquareSuperset; U+02290 U+00338 ⊐̸
NotSquareSupersetEqual; U+022E3 ⋣
NotSubset; U+02282 U+020D2 ⊂⃒
NotSubsetEqual; U+02288 ⊈
NotSucceeds; U+02281 ⊁
NotSucceedsEqual; U+02AB0 U+00338 ⪰̸
NotSucceedsSlantEqual; U+022E1 ⋡
NotSucceedsTilde; U+0227F U+00338 ≿̸
NotSuperset; U+02283 U+020D2 ⊃⃒
NotSupersetEqual; U+02289 ⊉
NotTilde; U+02241 ≁
NotTildeEqual; U+02244 ≄
NotTildeFullEqual; U+02247 ≇
NotTildeTilde; U+02249 ≉
NotVerticalBar; U+02224 ∤
npar; U+02226 ∦
nparallel; U+02226 ∦
nparsl; U+02AFD U+020E5 ⫽⃥
npart; U+02202 U+00338 ∂̸
npolint; U+02A14 ⨔
npr; U+02280 ⊀
nprcue; U+022E0 ⋠
npre; U+02AAF U+00338 ⪯̸
nprec; U+02280 ⊀
npreceq; U+02AAF U+00338 ⪯̸
nrArr; U+021CF ⇏
nrarr; U+0219B ↛
nrarrc; U+02933 U+00338 ⤳̸
nrarrw; U+0219D U+00338 ↝̸
nRightarrow; U+021CF ⇏
nrightarrow; U+0219B ↛
nrtri; U+022EB ⋫
nrtrie; U+022ED ⋭
nsc; U+02281 ⊁
nsccue; U+022E1 ⋡
nsce; U+02AB0 U+00338 ⪰̸
Nscr; U+1D4A9 𝒩
nscr; U+1D4C3 𝓃
nshortmid; U+02224 ∤
nshortparallel; U+02226 ∦
nsim; U+02241 ≁
nsime; U+02244 ≄
nsimeq; U+02244 ≄
nsmid; U+02224 ∤
nspar; U+02226 ∦
nsqsube; U+022E2 ⋢
nsqsupe; U+022E3 ⋣
nsub; U+02284 ⊄
nsubE; U+02AC5 U+00338 ⫅̸
nsube; U+02288 ⊈
nsubset; U+02282 U+020D2 ⊂⃒
nsubseteq; U+02288 ⊈
nsubseteqq; U+02AC5 U+00338 ⫅̸
nsucc; U+02281 ⊁
nsucceq; U+02AB0 U+00338 ⪰̸
nsup; U+02285 ⊅
nsupE; U+02AC6 U+00338 ⫆̸
nsupe; U+02289 ⊉
nsupset; U+02283 U+020D2 ⊃⃒
nsupseteq; U+02289 ⊉
nsupseteqq; U+02AC6 U+00338 ⫆̸
ntgl; U+02279 ≹
Ntilde; U+000D1 Ñ
Ntilde U+000D1 Ñ
ntilde; U+000F1 ñ
ntilde U+000F1 ñ
ntlg; U+02278 ≸
ntriangleleft; U+022EA ⋪
ntrianglelefteq; U+022EC ⋬
ntriangleright; U+022EB ⋫
ntrianglerighteq; U+022ED ⋭
Nu; U+0039D Ν
nu; U+003BD ν
num; U+00023 #
numero; U+02116 №
numsp; U+02007  
nvap; U+0224D U+020D2 ≍⃒
nVDash; U+022AF ⊯
nVdash; U+022AE ⊮
nvDash; U+022AD ⊭
nvdash; U+022AC ⊬
nvge; U+02265 U+020D2 ≥⃒
nvgt; U+0003E U+020D2 >⃒
nvHarr; U+02904 ⤄
nvinfin; U+029DE ⧞
nvlArr; U+02902 ⤂
nvle; U+02264 U+020D2 ≤⃒
nvlt; U+0003C U+020D2 <⃒
nvltrie; U+022B4 U+020D2 ⊴⃒
nvrArr; U+02903 ⤃
nvrtrie; U+022B5 U+020D2 ⊵⃒
nvsim; U+0223C U+020D2 ∼⃒
nwarhk; U+02923 ⤣
nwArr; U+021D6 ⇖
nwarr; U+02196 ↖
nwarrow; U+02196 ↖
nwnear; U+02927 ⤧
Oacute; U+000D3 Ó
Oacute U+000D3 Ó
oacute; U+000F3 ó
oacute U+000F3 ó
oast; U+0229B ⊛
ocir; U+0229A ⊚
Ocirc; U+000D4 Ô
Ocirc U+000D4 Ô
ocirc; U+000F4 ô
ocirc U+000F4 ô
Ocy; U+0041E О
ocy; U+0043E о
odash; U+0229D ⊝
Odblac; U+00150 Ő
odblac; U+00151 ő
odiv; U+02A38 ⨸
odot; U+02299 ⊙
odsold; U+029BC ⦼
OElig; U+00152 Œ
oelig; U+00153 œ
ofcir; U+029BF ⦿
Ofr; U+1D512 𝔒
ofr; U+1D52C 𝔬
ogon; U+002DB ˛
Ograve; U+000D2 Ò
Ograve U+000D2 Ò
ograve; U+000F2 ò
ograve U+000F2 ò
ogt; U+029C1 ⧁
ohbar; U+029B5 ⦵
ohm; U+003A9 Ω
oint; U+0222E ∮
olarr; U+021BA ↺
olcir; U+029BE ⦾
olcross; U+029BB ⦻
oline; U+0203E ‾
olt; U+029C0 ⧀
Omacr; U+0014C Ō
omacr; U+0014D ō
Omega; U+003A9 Ω
omega; U+003C9 ω
Omicron; U+0039F Ο
omicron; U+003BF ο
omid; U+029B6 ⦶
ominus; U+02296 ⊖
Oopf; U+1D546 𝕆
oopf; U+1D560 𝕠
opar; U+029B7 ⦷
OpenCurlyDoubleQuote; U+0201C “
OpenCurlyQuote; U+02018 ‘
operp; U+029B9 ⦹
oplus; U+02295 ⊕
Or; U+02A54 ⩔
or; U+02228 ∨
orarr; U+021BB ↻
ord; U+02A5D ⩝
order; U+02134 ℴ
orderof; U+02134 ℴ
ordf; U+000AA ª
ordf U+000AA ª
ordm; U+000BA º
ordm U+000BA º
origof; U+022B6 ⊶
oror; U+02A56 ⩖
orslope; U+02A57 ⩗
orv; U+02A5B ⩛
oS; U+024C8 Ⓢ
Oscr; U+1D4AA 𝒪
oscr; U+02134 ℴ
Oslash; U+000D8 Ø
Oslash U+000D8 Ø
oslash; U+000F8 ø
oslash U+000F8 ø
osol; U+02298 ⊘
Otilde; U+000D5 Õ
Otilde U+000D5 Õ
otilde; U+000F5 õ
otilde U+000F5 õ
Otimes; U+02A37 ⨷
otimes; U+02297 ⊗
otimesas; U+02A36 ⨶
Ouml; U+000D6 Ö
Ouml U+000D6 Ö
ouml; U+000F6 ö
ouml U+000F6 ö
ovbar; U+0233D ⌽
OverBar; U+0203E ‾
OverBrace; U+023DE ⏞
OverBracket; U+023B4 ⎴
OverParenthesis; U+023DC ⏜
par; U+02225 ∥
para; U+000B6
para U+000B6
parallel; U+02225 ∥
parsim; U+02AF3 ⫳
parsl; U+02AFD ⫽
part; U+02202 ∂
PartialD; U+02202 ∂
Pcy; U+0041F П
pcy; U+0043F п
percnt; U+00025 %
period; U+0002E .
permil; U+02030 ‰
perp; U+022A5 ⊥
pertenk; U+02031 ‱
Pfr; U+1D513 𝔓
pfr; U+1D52D 𝔭
Phi; U+003A6 Φ
phi; U+003C6 φ
phiv; U+003D5 ϕ
phmmat; U+02133 ℳ
phone; U+0260E ☎
Pi; U+003A0 Π
pi; U+003C0 π
pitchfork; U+022D4 ⋔
piv; U+003D6 ϖ
planck; U+0210F ℏ
planckh; U+0210E ℎ
plankv; U+0210F ℏ
plus; U+0002B +
plusacir; U+02A23 ⨣
plusb; U+0229E ⊞
pluscir; U+02A22 ⨢
plusdo; U+02214 ∔
plusdu; U+02A25 ⨥
pluse; U+02A72 ⩲
PlusMinus; U+000B1 ±
plusmn; U+000B1 ±
plusmn U+000B1 ±
plussim; U+02A26 ⨦
plustwo; U+02A27 ⨧
pm; U+000B1 ±
Poincareplane; U+0210C ℌ
pointint; U+02A15 ⨕
Popf; U+02119 ℙ
popf; U+1D561 𝕡
pound; U+000A3 £
pound U+000A3 £
Pr; U+02ABB ⪻
pr; U+0227A ≺
prap; U+02AB7 ⪷
prcue; U+0227C ≼
prE; U+02AB3 ⪳
pre; U+02AAF ⪯
prec; U+0227A ≺
precapprox; U+02AB7 ⪷
preccurlyeq; U+0227C ≼
Precedes; U+0227A ≺
PrecedesEqual; U+02AAF ⪯
PrecedesSlantEqual; U+0227C ≼
PrecedesTilde; U+0227E ≾
preceq; U+02AAF ⪯
precnapprox; U+02AB9 ⪹
precneqq; U+02AB5 ⪵
precnsim; U+022E8 ⋨
precsim; U+0227E ≾
Prime; U+02033 ″
prime; U+02032 ′
primes; U+02119 ℙ
prnap; U+02AB9 ⪹
prnE; U+02AB5 ⪵
prnsim; U+022E8 ⋨
prod; U+0220F ∏
Product; U+0220F ∏
profalar; U+0232E ⌮
profline; U+02312 ⌒
profsurf; U+02313 ⌓
prop; U+0221D ∝
Proportion; U+02237 ∷
Proportional; U+0221D ∝
propto; U+0221D ∝
prsim; U+0227E ≾
prurel; U+022B0 ⊰
Pscr; U+1D4AB 𝒫
pscr; U+1D4C5 𝓅
Psi; U+003A8 Ψ
psi; U+003C8 ψ
puncsp; U+02008  
Qfr; U+1D514 𝔔
qfr; U+1D52E 𝔮
qint; U+02A0C ⨌
Qopf; U+0211A ℚ
qopf; U+1D562 𝕢
qprime; U+02057 ⁗
Qscr; U+1D4AC 𝒬
qscr; U+1D4C6 𝓆
quaternions; U+0210D ℍ
quatint; U+02A16 ⨖
quest; U+0003F ?
questeq; U+0225F ≟
QUOT; U+00022 "
QUOT U+00022 "
quot; U+00022 "
quot U+00022 "
rAarr; U+021DB ⇛
race; U+0223D U+00331 ∽̱
Racute; U+00154 Ŕ
racute; U+00155 ŕ
radic; U+0221A √
raemptyv; U+029B3 ⦳
Rang; U+027EB ⟫
rang; U+027E9 ⟩
rangd; U+02992 ⦒
range; U+029A5 ⦥
rangle; U+027E9 ⟩
raquo; U+000BB »
raquo U+000BB »
Rarr; U+021A0 ↠
rArr; U+021D2 ⇒
rarr; U+02192 →
rarrap; U+02975 ⥵
rarrb; U+021E5 ⇥
rarrbfs; U+02920 ⤠
rarrc; U+02933 ⤳
rarrfs; U+0291E ⤞
rarrhk; U+021AA ↪
rarrlp; U+021AC ↬
rarrpl; U+02945 ⥅
rarrsim; U+02974 ⥴
Rarrtl; U+02916 ⤖
rarrtl; U+021A3 ↣
rarrw; U+0219D ↝
rAtail; U+0291C ⤜
ratail; U+0291A ⤚
ratio; U+02236 ∶
rationals; U+0211A ℚ
RBarr; U+02910 ⤐
rBarr; U+0290F ⤏
rbarr; U+0290D ⤍
rbbrk; U+02773 ❳
rbrace; U+0007D }
rbrack; U+0005D ]
rbrke; U+0298C ⦌
rbrksld; U+0298E ⦎
rbrkslu; U+02990 ⦐
Rcaron; U+00158 Ř
rcaron; U+00159 ř
Rcedil; U+00156 Ŗ
rcedil; U+00157 ŗ
rceil; U+02309 ⌉
rcub; U+0007D }
Rcy; U+00420 Р
rcy; U+00440 р
rdca; U+02937 ⤷
rdldhar; U+02969 ⥩
rdquo; U+0201D ”
rdquor; U+0201D ”
rdsh; U+021B3 ↳
Re; U+0211C ℜ
real; U+0211C ℜ
realine; U+0211B ℛ
realpart; U+0211C ℜ
reals; U+0211D ℝ
rect; U+025AD ▭
REG; U+000AE ®
REG U+000AE ®
reg; U+000AE ®
reg U+000AE ®
ReverseElement; U+0220B ∋
ReverseEquilibrium; U+021CB ⇋
ReverseUpEquilibrium; U+0296F ⥯
rfisht; U+0297D ⥽
rfloor; U+0230B ⌋
Rfr; U+0211C ℜ
rfr; U+1D52F 𝔯
rHar; U+02964 ⥤
rhard; U+021C1 ⇁
rharu; U+021C0 ⇀
rharul; U+0296C ⥬
Rho; U+003A1 Ρ
rho; U+003C1 ρ
rhov; U+003F1 ϱ
RightAngleBracket; U+027E9 ⟩
RightArrow; U+02192 →
Rightarrow; U+021D2 ⇒
rightarrow; U+02192 →
RightArrowBar; U+021E5 ⇥
RightArrowLeftArrow; U+021C4 ⇄
rightarrowtail; U+021A3 ↣
RightCeiling; U+02309 ⌉
RightDoubleBracket; U+027E7 ⟧
RightDownTeeVector; U+0295D ⥝
RightDownVector; U+021C2 ⇂
RightDownVectorBar; U+02955 ⥕
RightFloor; U+0230B ⌋
rightharpoondown; U+021C1 ⇁
rightharpoonup; U+021C0 ⇀
rightleftarrows; U+021C4 ⇄
rightleftharpoons; U+021CC ⇌
rightrightarrows; U+021C9 ⇉
rightsquigarrow; U+0219D ↝
RightTee; U+022A2 ⊢
RightTeeArrow; U+021A6 ↦
RightTeeVector; U+0295B ⥛
rightthreetimes; U+022CC ⋌
RightTriangle; U+022B3 ⊳
RightTriangleBar; U+029D0 ⧐
RightTriangleEqual; U+022B5 ⊵
RightUpDownVector; U+0294F ⥏
RightUpTeeVector; U+0295C ⥜
RightUpVector; U+021BE ↾
RightUpVectorBar; U+02954 ⥔
RightVector; U+021C0 ⇀
RightVectorBar; U+02953 ⥓
ring; U+002DA ˚
risingdotseq; U+02253 ≓
rlarr; U+021C4 ⇄
rlhar; U+021CC ⇌
rlm; U+0200F ‏
rmoust; U+023B1 ⎱
rmoustache; U+023B1 ⎱
rnmid; U+02AEE ⫮
roang; U+027ED ⟭
roarr; U+021FE ⇾
robrk; U+027E7 ⟧
ropar; U+02986 ⦆
Ropf; U+0211D ℝ
ropf; U+1D563 𝕣
roplus; U+02A2E ⨮
rotimes; U+02A35 ⨵
RoundImplies; U+02970 ⥰
rpar; U+00029 )
rpargt; U+02994 ⦔
rppolint; U+02A12 ⨒
rrarr; U+021C9 ⇉
Rrightarrow; U+021DB ⇛
rsaquo; U+0203A ›
Rscr; U+0211B ℛ
rscr; U+1D4C7 𝓇
Rsh; U+021B1 ↱
rsh; U+021B1 ↱
rsqb; U+0005D ]
rsquo; U+02019 ’
rsquor; U+02019 ’
rthree; U+022CC ⋌
rtimes; U+022CA ⋊
rtri; U+025B9 ▹
rtrie; U+022B5 ⊵
rtrif; U+025B8 ▸
rtriltri; U+029CE ⧎
RuleDelayed; U+029F4 ⧴
ruluhar; U+02968 ⥨
rx; U+0211E ℞
Sacute; U+0015A Ś
sacute; U+0015B ś
sbquo; U+0201A ‚
Sc; U+02ABC ⪼
sc; U+0227B ≻
scap; U+02AB8 ⪸
Scaron; U+00160 Š
scaron; U+00161 š
sccue; U+0227D ≽
scE; U+02AB4 ⪴
sce; U+02AB0 ⪰
Scedil; U+0015E Ş
scedil; U+0015F ş
Scirc; U+0015C Ŝ
scirc; U+0015D ŝ
scnap; U+02ABA ⪺
scnE; U+02AB6 ⪶
scnsim; U+022E9 ⋩
scpolint; U+02A13 ⨓
scsim; U+0227F ≿
Scy; U+00421 С
scy; U+00441 с
sdot; U+022C5 ⋅
sdotb; U+022A1 ⊡
sdote; U+02A66 ⩦
searhk; U+02925 ⤥
seArr; U+021D8 ⇘
searr; U+02198 ↘
searrow; U+02198 ↘
sect; U+000A7 §
sect U+000A7 §
semi; U+0003B ;
seswar; U+02929 ⤩
setminus; U+02216 ∖
setmn; U+02216 ∖
sext; U+02736 ✶
Sfr; U+1D516 𝔖
sfr; U+1D530 𝔰
sfrown; U+02322 ⌢
sharp; U+0266F ♯
SHCHcy; U+00429 Щ
shchcy; U+00449 щ
SHcy; U+00428 Ш
shcy; U+00448 ш
ShortDownArrow; U+02193 ↓
ShortLeftArrow; U+02190 ←
shortmid; U+02223 ∣
shortparallel; U+02225 ∥
ShortRightArrow; U+02192 →
ShortUpArrow; U+02191 ↑
shy; U+000AD ­
shy U+000AD ­
Sigma; U+003A3 Σ
sigma; U+003C3 σ
sigmaf; U+003C2 ς
sigmav; U+003C2 ς
sim; U+0223C ∼
simdot; U+02A6A ⩪
sime; U+02243 ≃
simeq; U+02243 ≃
simg; U+02A9E ⪞
simgE; U+02AA0 ⪠
siml; U+02A9D ⪝
simlE; U+02A9F ⪟
simne; U+02246 ≆
simplus; U+02A24 ⨤
simrarr; U+02972 ⥲
slarr; U+02190 ←
SmallCircle; U+02218 ∘
smallsetminus; U+02216 ∖
smashp; U+02A33 ⨳
smeparsl; U+029E4 ⧤
smid; U+02223 ∣
smile; U+02323 ⌣
smt; U+02AAA ⪪
smte; U+02AAC ⪬
smtes; U+02AAC U+0FE00 ⪬︀
SOFTcy; U+0042C Ь
softcy; U+0044C ь
sol; U+0002F /
solb; U+029C4 ⧄
solbar; U+0233F ⌿
Sopf; U+1D54A 𝕊
sopf; U+1D564 𝕤
spades; U+02660 ♠
spadesuit; U+02660 ♠
spar; U+02225 ∥
sqcap; U+02293 ⊓
sqcaps; U+02293 U+0FE00 ⊓︀
sqcup; U+02294 ⊔
sqcups; U+02294 U+0FE00 ⊔︀
Sqrt; U+0221A √
sqsub; U+0228F ⊏
sqsube; U+02291 ⊑
sqsubset; U+0228F ⊏
sqsubseteq; U+02291 ⊑
sqsup; U+02290 ⊐
sqsupe; U+02292 ⊒
sqsupset; U+02290 ⊐
sqsupseteq; U+02292 ⊒
squ; U+025A1 □
Square; U+025A1 □
square; U+025A1 □
SquareIntersection; U+02293 ⊓
SquareSubset; U+0228F ⊏
SquareSubsetEqual; U+02291 ⊑
SquareSuperset; U+02290 ⊐
SquareSupersetEqual; U+02292 ⊒
SquareUnion; U+02294 ⊔
squarf; U+025AA ▪
squf; U+025AA ▪
srarr; U+02192 →
Sscr; U+1D4AE 𝒮
sscr; U+1D4C8 𝓈
ssetmn; U+02216 ∖
ssmile; U+02323 ⌣
sstarf; U+022C6 ⋆
Star; U+022C6 ⋆
star; U+02606 ☆
starf; U+02605 ★
straightepsilon; U+003F5 ϵ
straightphi; U+003D5 ϕ
strns; U+000AF ¯
Sub; U+022D0 ⋐
sub; U+02282 ⊂
subdot; U+02ABD ⪽
subE; U+02AC5 ⫅
sube; U+02286 ⊆
subedot; U+02AC3 ⫃
submult; U+02AC1 ⫁
subnE; U+02ACB ⫋
subne; U+0228A ⊊
subplus; U+02ABF ⪿
subrarr; U+02979 ⥹
Subset; U+022D0 ⋐
subset; U+02282 ⊂
subseteq; U+02286 ⊆
subseteqq; U+02AC5 ⫅
SubsetEqual; U+02286 ⊆
subsetneq; U+0228A ⊊
subsetneqq; U+02ACB ⫋
subsim; U+02AC7 ⫇
subsub; U+02AD5 ⫕
subsup; U+02AD3 ⫓
succ; U+0227B ≻
succapprox; U+02AB8 ⪸
succcurlyeq; U+0227D ≽
Succeeds; U+0227B ≻
SucceedsEqual; U+02AB0 ⪰
SucceedsSlantEqual; U+0227D ≽
SucceedsTilde; U+0227F ≿
succeq; U+02AB0 ⪰
succnapprox; U+02ABA ⪺
succneqq; U+02AB6 ⪶
succnsim; U+022E9 ⋩
succsim; U+0227F ≿
SuchThat; U+0220B ∋
Sum; U+02211 ∑
sum; U+02211 ∑
sung; U+0266A ♪
Sup; U+022D1 ⋑
sup; U+02283 ⊃
sup1; U+000B9 ¹
sup1 U+000B9 ¹
sup2; U+000B2 ²
sup2 U+000B2 ²
sup3; U+000B3 ³
sup3 U+000B3 ³
supdot; U+02ABE ⪾
supdsub; U+02AD8 ⫘
supE; U+02AC6 ⫆
supe; U+02287 ⊇
supedot; U+02AC4 ⫄
Superset; U+02283 ⊃
SupersetEqual; U+02287 ⊇
suphsol; U+027C9 ⟉
suphsub; U+02AD7 ⫗
suplarr; U+0297B ⥻
supmult; U+02AC2 ⫂
supnE; U+02ACC ⫌
supne; U+0228B ⊋
supplus; U+02AC0 ⫀
Supset; U+022D1 ⋑
supset; U+02283 ⊃
supseteq; U+02287 ⊇
supseteqq; U+02AC6 ⫆
supsetneq; U+0228B ⊋
supsetneqq; U+02ACC ⫌
supsim; U+02AC8 ⫈
supsub; U+02AD4 ⫔
supsup; U+02AD6 ⫖
swarhk; U+02926 ⤦
swArr; U+021D9 ⇙
swarr; U+02199 ↙
swarrow; U+02199 ↙
swnwar; U+0292A ⤪
szlig; U+000DF ß
szlig U+000DF ß
Tab; U+00009 ␉
target; U+02316 ⌖
Tau; U+003A4 Τ
tau; U+003C4 τ
tbrk; U+023B4 ⎴
Tcaron; U+00164 Ť
tcaron; U+00165 ť
Tcedil; U+00162 Ţ
tcedil; U+00163 ţ
Tcy; U+00422 Т
tcy; U+00442 т
tdot; U+020DB ◌⃛
telrec; U+02315 ⌕
Tfr; U+1D517 𝔗
tfr; U+1D531 𝔱
there4; U+02234 ∴
Therefore; U+02234 ∴
therefore; U+02234 ∴
Theta; U+00398 Θ
theta; U+003B8 θ
thetasym; U+003D1 ϑ
thetav; U+003D1 ϑ
thickapprox; U+02248 ≈
thicksim; U+0223C ∼
ThickSpace; U+0205F U+0200A   
thinsp; U+02009  
ThinSpace; U+02009  
thkap; U+02248 ≈
thksim; U+0223C ∼
THORN; U+000DE Þ
THORN U+000DE Þ
thorn; U+000FE þ
thorn U+000FE þ
Tilde; U+0223C ∼
tilde; U+002DC ˜
TildeEqual; U+02243 ≃
TildeFullEqual; U+02245 ≅
TildeTilde; U+02248 ≈
times; U+000D7 ×
times U+000D7 ×
timesb; U+022A0 ⊠
timesbar; U+02A31 ⨱
timesd; U+02A30 ⨰
tint; U+0222D ∭
toea; U+02928 ⤨
top; U+022A4 ⊤
topbot; U+02336 ⌶
topcir; U+02AF1 ⫱
Topf; U+1D54B 𝕋
topf; U+1D565 𝕥
topfork; U+02ADA ⫚
tosa; U+02929 ⤩
tprime; U+02034 ‴
TRADE; U+02122 ™
trade; U+02122 ™
triangle; U+025B5 ▵
triangledown; U+025BF ▿
triangleleft; U+025C3 ◃
trianglelefteq; U+022B4 ⊴
triangleq; U+0225C ≜
triangleright; U+025B9 ▹
trianglerighteq; U+022B5 ⊵
tridot; U+025EC ◬
trie; U+0225C ≜
triminus; U+02A3A ⨺
TripleDot; U+020DB ◌⃛
triplus; U+02A39 ⨹
trisb; U+029CD ⧍
tritime; U+02A3B ⨻
trpezium; U+023E2 ⏢
Tscr; U+1D4AF 𝒯
tscr; U+1D4C9 𝓉
TScy; U+00426 Ц
tscy; U+00446 ц
TSHcy; U+0040B Ћ
tshcy; U+0045B ћ
Tstrok; U+00166 Ŧ
tstrok; U+00167 ŧ
twixt; U+0226C ≬
twoheadleftarrow; U+0219E ↞
twoheadrightarrow; U+021A0 ↠
Uacute; U+000DA Ú
Uacute U+000DA Ú
uacute; U+000FA ú
uacute U+000FA ú
Uarr; U+0219F ↟
uArr; U+021D1 ⇑
uarr; U+02191 ↑
Uarrocir; U+02949 ⥉
Ubrcy; U+0040E Ў
ubrcy; U+0045E ў
Ubreve; U+0016C Ŭ
ubreve; U+0016D ŭ
Ucirc; U+000DB Û
Ucirc U+000DB Û
ucirc; U+000FB û
ucirc U+000FB û
Ucy; U+00423 У
ucy; U+00443 у
udarr; U+021C5 ⇅
Udblac; U+00170 Ű
udblac; U+00171 ű
udhar; U+0296E ⥮
ufisht; U+0297E ⥾
Ufr; U+1D518 𝔘
ufr; U+1D532 𝔲
Ugrave; U+000D9 Ù
Ugrave U+000D9 Ù
ugrave; U+000F9 ù
ugrave U+000F9 ù
uHar; U+02963 ⥣
uharl; U+021BF ↿
uharr; U+021BE ↾
uhblk; U+02580 ▀
ulcorn; U+0231C ⌜
ulcorner; U+0231C ⌜
ulcrop; U+0230F ⌏
ultri; U+025F8 ◸
Umacr; U+0016A Ū
umacr; U+0016B ū
uml; U+000A8 ¨
uml U+000A8 ¨
UnderBar; U+0005F _
UnderBrace; U+023DF ⏟
UnderBracket; U+023B5 ⎵
UnderParenthesis; U+023DD ⏝
Union; U+022C3 ⋃
UnionPlus; U+0228E ⊎
Uogon; U+00172 Ų
uogon; U+00173 ų
Uopf; U+1D54C 𝕌
uopf; U+1D566 𝕦
UpArrow; U+02191 ↑
Uparrow; U+021D1 ⇑
uparrow; U+02191 ↑
UpArrowBar; U+02912 ⤒
UpArrowDownArrow; U+021C5 ⇅
UpDownArrow; U+02195 ↕
Updownarrow; U+021D5 ⇕
updownarrow; U+02195 ↕
UpEquilibrium; U+0296E ⥮
upharpoonleft; U+021BF ↿
upharpoonright; U+021BE ↾
uplus; U+0228E ⊎
UpperLeftArrow; U+02196 ↖
UpperRightArrow; U+02197 ↗
Upsi; U+003D2 ϒ
upsi; U+003C5 υ
upsih; U+003D2 ϒ
Upsilon; U+003A5 Υ
upsilon; U+003C5 υ
UpTee; U+022A5 ⊥
UpTeeArrow; U+021A5 ↥
upuparrows; U+021C8 ⇈
urcorn; U+0231D ⌝
urcorner; U+0231D ⌝
urcrop; U+0230E ⌎
Uring; U+0016E Ů
uring; U+0016F ů
urtri; U+025F9 ◹
Uscr; U+1D4B0 𝒰
uscr; U+1D4CA 𝓊
utdot; U+022F0 ⋰
Utilde; U+00168 Ũ
utilde; U+00169 ũ
utri; U+025B5 ▵
utrif; U+025B4 ▴
uuarr; U+021C8 ⇈
Uuml; U+000DC Ü
Uuml U+000DC Ü
uuml; U+000FC ü
uuml U+000FC ü
uwangle; U+029A7 ⦧
vangrt; U+0299C ⦜
varepsilon; U+003F5 ϵ
varkappa; U+003F0 ϰ
varnothing; U+02205 ∅
varphi; U+003D5 ϕ
varpi; U+003D6 ϖ
varpropto; U+0221D ∝
vArr; U+021D5 ⇕
varr; U+02195 ↕
varrho; U+003F1 ϱ
varsigma; U+003C2 ς
varsubsetneq; U+0228A U+0FE00 ⊊︀
varsubsetneqq; U+02ACB U+0FE00 ⫋︀
varsupsetneq; U+0228B U+0FE00 ⊋︀
varsupsetneqq; U+02ACC U+0FE00 ⫌︀
vartheta; U+003D1 ϑ
vartriangleleft; U+022B2 ⊲
vartriangleright; U+022B3 ⊳
Vbar; U+02AEB ⫫
vBar; U+02AE8 ⫨
vBarv; U+02AE9 ⫩
Vcy; U+00412 В
vcy; U+00432 в
VDash; U+022AB ⊫
Vdash; U+022A9 ⊩
vDash; U+022A8 ⊨
vdash; U+022A2 ⊢
Vdashl; U+02AE6 ⫦
Vee; U+022C1 ⋁
vee; U+02228 ∨
veebar; U+022BB ⊻
veeeq; U+0225A ≚
vellip; U+022EE ⋮
Verbar; U+02016 ‖
verbar; U+0007C |
Vert; U+02016 ‖
vert; U+0007C |
VerticalBar; U+02223 ∣
VerticalLine; U+0007C |
VerticalSeparator; U+02758 ❘
VerticalTilde; U+02240 ≀
VeryThinSpace; U+0200A  
Vfr; U+1D519 𝔙
vfr; U+1D533 𝔳
vltri; U+022B2 ⊲
vnsub; U+02282 U+020D2 ⊂⃒
vnsup; U+02283 U+020D2 ⊃⃒
Vopf; U+1D54D 𝕍
vopf; U+1D567 𝕧
vprop; U+0221D ∝
vrtri; U+022B3 ⊳
Vscr; U+1D4B1 𝒱
vscr; U+1D4CB 𝓋
vsubnE; U+02ACB U+0FE00 ⫋︀
vsubne; U+0228A U+0FE00 ⊊︀
vsupnE; U+02ACC U+0FE00 ⫌︀
vsupne; U+0228B U+0FE00 ⊋︀
Vvdash; U+022AA ⊪
vzigzag; U+0299A ⦚
Wcirc; U+00174 Ŵ
wcirc; U+00175 ŵ
wedbar; U+02A5F ⩟
Wedge; U+022C0 ⋀
wedge; U+02227 ∧
wedgeq; U+02259 ≙
weierp; U+02118 ℘
Wfr; U+1D51A 𝔚
wfr; U+1D534 𝔴
Wopf; U+1D54E 𝕎
wopf; U+1D568 𝕨
wp; U+02118 ℘
wr; U+02240 ≀
wreath; U+02240 ≀
Wscr; U+1D4B2 𝒲
wscr; U+1D4CC 𝓌
xcap; U+022C2 ⋂
xcirc; U+025EF ◯
xcup; U+022C3 ⋃
xdtri; U+025BD ▽
Xfr; U+1D51B 𝔛
xfr; U+1D535 𝔵
xhArr; U+027FA ⟺
xharr; U+027F7 ⟷
Xi; U+0039E Ξ
xi; U+003BE ξ
xlArr; U+027F8 ⟸
xlarr; U+027F5 ⟵
xmap; U+027FC ⟼
xnis; U+022FB ⋻
xodot; U+02A00 ⨀
Xopf; U+1D54F 𝕏
xopf; U+1D569 𝕩
xoplus; U+02A01 ⨁
xotime; U+02A02 ⨂
xrArr; U+027F9 ⟹
xrarr; U+027F6 ⟶
Xscr; U+1D4B3 𝒳
xscr; U+1D4CD 𝓍
xsqcup; U+02A06 ⨆
xuplus; U+02A04 ⨄
xutri; U+025B3 △
xvee; U+022C1 ⋁
xwedge; U+022C0 ⋀
Yacute; U+000DD Ý
Yacute U+000DD Ý
yacute; U+000FD ý
yacute U+000FD ý
YAcy; U+0042F Я
yacy; U+0044F я
Ycirc; U+00176 Ŷ
ycirc; U+00177 ŷ
Ycy; U+0042B Ы
ycy; U+0044B ы
yen; U+000A5 ¥
yen U+000A5 ¥
Yfr; U+1D51C 𝔜
yfr; U+1D536 𝔶
YIcy; U+00407 Ї
yicy; U+00457 ї
Yopf; U+1D550 𝕐
yopf; U+1D56A 𝕪
Yscr; U+1D4B4 𝒴
yscr; U+1D4CE 𝓎
YUcy; U+0042E Ю
yucy; U+0044E ю
Yuml; U+00178 Ÿ
yuml; U+000FF ÿ
yuml U+000FF ÿ
Zacute; U+00179 Ź
zacute; U+0017A ź
Zcaron; U+0017D Ž
zcaron; U+0017E ž
Zcy; U+00417 З
zcy; U+00437 з
Zdot; U+0017B Ż
zdot; U+0017C ż
zeetrf; U+02128 ℨ
ZeroWidthSpace; U+0200B ​
Zeta; U+00396 Ζ
zeta; U+003B6 ζ
Zfr; U+02128 ℨ
zfr; U+1D537 𝔷
ZHcy; U+00416 Ж
zhcy; U+00436 ж
zigrarr; U+021DD ⇝
Zopf; U+02124 ℤ
zopf; U+1D56B 𝕫
Zscr; U+1D4B5 𝒵
zscr; U+1D4CF 𝓏
zwj; U+0200D ‍
zwnj; U+0200C ‌

このデータはJSONファイルとしても利用可能です。

上記に表示されているグリフは規範的ではありません。リストされた文字の正式な定義についてはUnicodeを参照してください。

文字参照名はXML Entity Definitions for Charactersに由来していますが、規範的と見なされるのは上記のみです。[XMLENTITY]

このリストは静的であり、将来的に拡張や変更は行われません。

14 XML構文

HTML/XHTML

すべての現在のエンジンでサポートされています。

Firefox2+Safari3.1+Chrome4+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android4+Safari iOS2+Chrome Android18+WebView Android2+Samsung Internet1.0+Opera Android10.1+

このセクションは、XMLリソースのルールのみを説明します。text/html リソースのルールについては、 上記の「HTML構文」というタイトルのセクションで説明しています。

14.1 XML構文でドキュメントを書く

HTMLのXML構文はかつて「XHTML」と呼ばれていましたが、この仕様ではその用語は使用していません（他の理由として、MathMLやSVGのHTML構文に対してそのような用語が使用されていないためです）。

XMLの構文はXMLおよびNamespaces in XMLで定義されています。[XML] [XMLNS]

この仕様は、XML本来のものとして定義されている構文レベルの要件以外には、何も定義していません。

XMLドキュメントには、必要に応じてDOCTYPEを含めることができますが、この仕様に準拠するために必要ではありません。この仕様では、パブリックまたはシステム識別子を定義しておらず、正式なDTDも提供していません。

XMLによれば、XMLプロセッサは、DOCTYPEで参照されている外部DTDサブセットを処理することを保証されていません。これは、例えば、XMLドキュメント内で文字にエンティティ参照を使用する場合、それらが外部ファイルで定義されていると安全ではないことを意味します（ただし、&lt;、 &gt;、&amp;、 &quot;、および&apos;を除きます）。

14.2 XML文書の解析

このセクションでは、XMLとDOMの関係について説明し、特にHTMLとの相互作用に焦点を当てています。

この仕様の目的上、XMLパーサーは、XMLで定義された規則に従って、バイトまたは文字列をDocumentオブジェクトにマッピングする構造体です。

執筆時点では、そのような規則は実際には存在しません。

XMLパーサーは、作成時にDocumentオブジェクトと関連付けられているか、暗黙的にオブジェクトを作成します。

このDocumentは、その後、XML、Namespaces in XML、およびDOMで定義されているように、パーサーに渡された入力の木構造を表すDOMノードで構成される必要があります。要素を表すDOMノードを作成する際には、トークンのための要素を作成するアルゴリズムや、適切なXMLデータ構造上で動作する同等のものを使用して、適切な要素インターフェースが作成されること、カスタム要素が正しく設定されることを確認しなければなりません。

ユーザーエージェントは、XML パーサー が Document のツリーに対して行う操作について、要素や属性が個別に追加されたり設定されたりして、この仕様で規定されている要素がドキュメントに挿入されたり属性が設定されたりした際に発生するルールを引き起こすように振る舞わなければならない。また、DOM の ミューテーションオブザーバー に関する要件は、ミューテーションオブザーバーが実際に発火することを意味する。[XML] [XMLNS] [DOM] [UIEVENTS]

要素の開始タグが解析されてから、その要素の終了タグが解析されるか、またはパーサーが整形式エラーを検出するまでの間、ユーザーエージェントはその要素が開かれた要素のスタックにあるかのように振る舞わなければなりません。

これは、開かれた要素のスタックからポップされるまで、特定のプロセスを開始しないように、さまざまな要素によって使用されます。

この仕様は、外部エンティティを取得する際にユーザーエージェントが使用すべき追加情報を次のように提供しています。以下のリストに記載されたパブリック識別子はすべて、 このリンクにより指定されたURL。（このURLは、エンティティ宣言が含まれているDTDであり、名前付き文字参照セクションにリストされている名前のためのものです。）[XML]

さらに、ユーザーエージェントは上記のパブリック識別子が使用された場合、上記の外部エンティティのコンテンツを取得しようとし、他の外部エンティティのコンテンツを取得しようとしないようにすべきです。

これは厳密にはXMLの違反ではありませんが、XMLの要件の精神に反します。これは、外部サブセットを処理するためにネットワークアクセスを必要とせずに、ユーザーエージェントがすべてエンティティを相互運用可能な方法で処理できるようにしたいという要望に基づいています。[XML]

XMLパーサーは、XMLスクリプトサポートが有効またはXMLスクリプトサポートが無効で呼び出すことができます。特に指定がない限り、XMLパーサーはXMLスクリプトサポートが有効で呼び出されます。

XMLパーサーがXMLスクリプトサポートが有効でscript要素を作成するとき、そのパーサードキュメントが設定され、強制非同期がfalseに設定されなければなりません。もしパーサーがXMLフラグメント解析アルゴリズムの一部として作成された場合、その要素のすでに開始済みがtrueに設定されなければなりません。その要素の終了タグがその後に解析されたとき、ユーザーエージェントはマイクロタスクチェックポイントを実行し、その後、script要素を準備しなければなりません。もしこれにより解析ブロック中のスクリプトが発生した場合、ユーザーエージェントは次の手順を実行しなければなりません：

  1. このXMLパーサーのインスタンスをブロックし、イベントループがタスクを呼び出さないようにする。

  2. イベントループを回転させ、パーサーのドキュメントがスクリプトをブロックするスタイルシートを持っていないこと、および解析ブロック中のスクリプトがパーサー実行準備完了であることを確認する。

  3. このXMLパーサーのインスタンスを解除し、タスクが再び実行されるようにする。

  4. script要素を実行し、解析ブロック中のスクリプトを実行する。

  5. 解析ブロック中のスクリプトをnullに設定する。

document.write() APIはXMLドキュメントでは利用できないため、HTMLパーサーの複雑さの多くはXMLパーサーには必要ありません。

XMLパーサーがXMLスクリプトサポートが無効の場合、これらは一切行われません。

XMLパーサーがノードをtemplate要素に追加しようとするとき、それをその要素のテンプレートコンテンツ（DocumentFragmentノード）に追加する必要があります。

これはXMLの意図的な違反です。残念ながら、XML は template 処理に必要な方法で正式に拡張可能ではありません。 [XML]

XMLパーサーがノードオブジェクトを作成するとき、それのノードドキュメントは新しく作成されるノードが挿入されるノードのノードドキュメントに設定されなければなりません。

この仕様の特定のアルゴリズムは、文字列を1つずつパーサーにスプーンフィードします。このような場合、XMLパーサーは、それらすべての文字列を連結した単一の文字列に直面した場合のように動作しなければなりません。

XMLパーサーがその入力の終わりに到達したとき、それは解析を停止し、HTMLパーサーと同じルールに従います。また、XMLパーサーは中止することもでき、これも再びHTMLパーサーと同じ方法で行われなければなりません。

適合性チェッカーの目的のために、リソースがXML構文であると判断された場合、それはXMLドキュメントです。

14.3 XMLフラグメントのシリアル化

Document または Element ノードの XMLフラグメントシリアル化アルゴリズムは、そのノードを表すXMLフラグメントを返すか、例外をスローします。

Documentの場合、このアルゴリズムは以下のエラーケースが適用されない場合、 ドキュメントエンティティの形式で文字列を返さなければなりません。

Elementの場合、以下のエラーケースが適用されない場合、 内部汎用解析エンティティの形式で文字列を返さなければなりません。

いずれの場合も、返される文字列はXML名前空間的に整形式でなければならず、そのノードの関連子ノード全ての ツリー順での同形シリアル化でなければなりません。ユーザーエージェントは、シリアル化においてプレフィックスや名前空間宣言を調整することができます（実際に名前空間的に整形式のXMLを得るために強制される場合もあります）。ユーザーエージェントは、DOM内のTextノードを表すために、通常のテキストと文字参照の組み合わせを使用することができます。

ノードの関連子ノードは、次のルールに従って適用されるものです：

template要素の場合
関連子ノードはtemplate要素のテンプレートコンテンツの子ノードです（存在する場合）。
他のすべてのノードの場合
関連子ノードはノード自体の子ノードです（存在する場合）。

Elementの場合、シリアル化された要素のいずれかが名前空間を持たない場合、これらの要素のスコープ内にあるデフォルトの名前空間は、空の文字列として明示的に宣言されなければなりません。（これはDocumentの場合には適用されません。）[XML] [XMLNS]

このセクションの目的のために、内部汎用解析エンティティは、名前空間宣言を持たない要素を含むドキュメントがXML名前空間的に整形式である場合、それ自体がXML名前空間的に整形式と見なされます。

シリアル化されるDOMサブツリー内で次のエラーケースが見つかった場合、アルゴリズムは文字列を返す代わりにDOMExceptionをスローしなければなりません：

これらがDOMをシリアル化不能にする唯一の方法です。DOMは他のすべてのXML制約を強制します。例えば、Documentノードに2つの要素を追加しようとすると、DOMExceptionである"HierarchyRequestError"がスローされます。

14.4 XMLフラグメントの解析

XML フラグメント解析アルゴリズムは、Element ノード context と文字列 input を指定すると、次のステップを実行します。これらはノードのリストを返します。

  1. 新しいXML パーサーを作成します。

  2. 作成したばかりのパーサーに、context の開始タグに対応する文字列をフィードし、DOM 内のその要素でスコープ内にあるすべての名前空間プレフィックスを宣言し、さらに DOM 内のその要素でスコープ内にあるデフォルトの名前空間（もしあれば）を宣言します。

    名前空間プレフィックスは、要素の DOM lookupNamespaceURI() メソッドがそのプレフィックスに対して null 以外の値を返す場合にスコープ内にあります。

    デフォルトの名前空間は、要素の DOM isDefaultNamespace() メソッドが true を返す名前空間です。

    パーサーには DOCTYPE は渡されず、したがって外部サブセットは参照されず、したがってエンティティは認識されません。

  3. 作成したばかりのパーサーに文字列 input をフィードします。

  4. 作成したばかりのパーサーに、context の終了タグに対応する文字列をフィードします。

  5. XML 整形式または XML 名前空間整形式エラーがある場合、"SyntaxError" DOMException をスローします。

  6. 結果の Document のドキュメント要素に兄弟ノードがある場合、"SyntaxError" DOMException をスローします。

  7. 結果の Document ノードのドキュメント要素の子を、ツリー順で返します。

15 レンダリング

ユーザーエージェントは、HTMLドキュメントを特定の方法で表示することを要求されていません。しかし、このセクションでは、HTMLドキュメントをレンダリングするための一連の提案を提供しており、それに従えば、ドキュメントの作者が意図したユーザーエクスペリエンスに近い体験が得られる可能性が高いです。このセクションの規範性に関して混乱を避けるために、「must」という言葉は使用されていません。その代わりに、「expected」という用語が使用されており、この体験につながる動作を示しています。推奨されるデフォルトのレンダリングをサポートすると指定されたユーザーエージェントの適合性のためには、このセクションの「expected」という用語は「must」と同じ適合性の意味を持ちます。

15.1 序論

このセクションの提案は一般的にCSSの用語で表現されています。ユーザーエージェントは、CSSをサポートするか、このセクションで与えられたCSSルールを他のプレゼンテーションメカニズムの近似に変換することが期待されています。

特に反するスタイルレイヤーのルール（例: 著者スタイルシート）がない場合、ユーザーエージェントは、要素がこの仕様で記述されているように要素が表す意味をユーザーに伝えるように要素をレンダリングすることが期待されています。

このセクションの提案は一般的に96dpi以上の解像度を持つ視覚的な出力メディアを前提としていますが、HTMLは複数のメディアに適用されることを意図しており（メディアに依存しない言語です）、ユーザーエージェントの実装者は、このセクションの提案を対象メディアに適応させることが奨励されています。

要素が関連付けられたCSSレイアウトボックス、SVGレイアウトボックス、または他のスタイリング言語で同等のものを持っている場合、その要素はレンダリングされていると言います。

画面外にあるだけでは、その要素がレンダリングされているわけではありません。通常、hidden属性が存在する場合、その要素はレンダリングされていないことを意味しますが、これはスタイルシートによって上書きされる場合があります。

完全にアクティブな状態は、要素がレンダリングされているかどうかには影響しません。ドキュメントが完全にアクティブではなく、ユーザーにまったく表示されていない場合でも、その中の要素は依然として「レンダリングされている」と見なされることがあります。

要素がレンダリングされている状態で、その関連付けられたCSSレイアウトボックスがビューポートと交差しているとき、その要素はビューポートと交差していると言われます。

レンダリングされている状態と同様に、非完全にアクティブなドキュメント内の要素も、依然としてビューポートと交差することができます。ビューポートはドキュメント間で共有されず、常にユーザーに表示されるわけではないため、非完全にアクティブなドキュメント内の要素は、それが属するドキュメントに関連付けられたビューポートと交差することができます。

この仕様では、交差のタイミングを正確に定義していませんが、交差のタイミングはIntersection Observer APIのタイミングと一致することが推奨されています。[INTERSECTIONOBSERVER]

要素がレンダリングされていないが、その子要素がレンダリングされる可能性がある場合、要素はCSSの 'display: contents' または他のスタイリング言語で同等のものの結果として、レンダリングを子要素に委任していると言います。[CSSDISPLAY]

著者レベルのCSSスタイルシートを適用しないユーザーエージェントでも、このセクションに示されたCSSルールをこの仕様や関連するCSSおよびUnicodeの仕様に従って適用したかのように動作することが期待されています。[CSS] [UNICODE] [BIDI]

これは、'display'、'unicode-bidi'、および'direction'プロパティに関連する問題に特に重要です。

15.2 CSSユーザーエージェントのスタイルシートとプレゼンテーショナルヒント

これらのサブセクションで示されるCSSルールは、特に指定がない限り、HTML要素を含むすべてのドキュメントのユーザーエージェントレベルのスタイルシートデフォルトの一部として使用されることが期待されています。

一部のルールは、著者レベルのゼロ特異性のプレゼンテーショナルヒントとしてのCSSカスケードに含まれることを意図しており、これらは明示的にプレゼンテーショナルヒントとして記載されています。

以下のテキストで、ある要素 element の属性 attribute が ピクセル長のプロパティ（またはプロパティ properties）にマッピングされると記載されている場合、それは、element に属性 attribute が設定されており、その属性の値を非負の整数を解析するための規則を使用して解析してもエラーが発生しない場合、ユーザーエージェントがその解析された値を properties に対するプレゼンテーショナルヒントとしてピクセル長として使用することが期待されることを意味します。

以下のテキストで、要素elementの属性attributeが寸法プロパティ（またはプロパティproperties）にマップされると述べられている場合、elementが属性attributeを設定しており、その属性の値を寸法値を解析するためのルールを使用して解析してもエラーが発生しない場合、ユーザーエージェントは、その解析された寸法をpropertiesのプレゼンテーショナルヒントの値として使用することが期待されます。寸法が長さの場合はピクセル長として、寸法がパーセンテージの場合はパーセンテージとして値が設定されます。

以下のテキストで、要素elementの属性attributeが寸法プロパティ（ゼロを無視）（またはプロパティproperties）にマップされると述べられている場合、elementが属性attributeを設定しており、その属性の値をゼロでない寸法値を解析するためのルールを使用して解析してもエラーが発生しない場合、ユーザーエージェントは、その解析された寸法をpropertiesのプレゼンテーショナルヒントの値として使用することが期待されます。寸法が長さの場合はピクセル長として、寸法がパーセンテージの場合はパーセンテージとして値が設定されます。

以下のテキストで、要素elementの属性wとhのペアがアスペクト比プロパティにマップされると述べられている場合、elementが属性wとhの両方を持ち、それらの属性の値を負でない整数を解析するためのルールを使用して解析してもエラーが発生しない場合、ユーザーエージェントはその解析された整数を、auto w / hの形式でプレゼンテーショナルヒントとしてアスペクト比プロパティに使用することが期待されています。

以下のテキストで、要素elementの属性wとhのペアが寸法ルールを使用してアスペクト比プロパティにマップされると述べられている場合、elementが属性wとhの両方を持ち、それらの属性の値を寸法値を解析するためのルールを使用して解析してもエラーが発生せず、どちらの属性もパーセンテージを返さない場合、ユーザーエージェントはその解析された寸法を、auto w / hの形式でプレゼンテーショナルヒントとしてアスペクト比プロパティに使用することが期待されています。

ユーザーエージェントがノードの子孫を整列させる場合、ユーザーエージェントは、'margin-inline-start'および'margin-inline-end'プロパティが'auto'以外の値に計算され、過剰に制約されており、その2つのマージンの1つが使用値が大きい値に強制され、かつ適用可能なalign属性を持たない子孫のみを整列させることが期待されています。特定の子孫を整列させるために複数の要素が整列を実行する場合、最も深くネストされた要素が他の要素を上書きすることが期待されています。整列された要素は、マージンのラインの左側とラインの右側に応じて使用値が設定されることによって整列されることが期待されています。[CSSLOGICAL] [CSSWM]

15.3 置換されない要素

15.3.1 隠し要素

@namespace "http://www.w3.org/1999/xhtml";
 
 area, base, basefont, datalist, head, link, meta, noembed,
 noframes, param, rp, script, style, template, title {
   display: none;
 }
 
 [hidden]:not([hidden=until-found i]):not(embed) {
   display: none;
 }
 
 [hidden=until-found i]:not(embed) {
   content-visibility: hidden;
 }
 
 embed[hidden] { display: inline; height: 0; width: 0; } 
 
 input[type=hidden i] { display: none !important; }
 
 @media (scripting) {
   noscript { display: none !important; }
 }

15.3.2 ページ

@namespace "http://www.w3.org/1999/xhtml";
 
 html, body { display: block; }

以下の表に示されている各プロパティについて、body要素に対して最初に存在する属性が、body要素のピクセル長プロパティにマップされます。プロパティに対応する属性が見つからない場合、または見つかった属性の値を正しく解析できなかった場合、そのプロパティにはデフォルト値として8pxが使用されることが期待されます。

プロパティ ソース
'margin-top' body要素のmarginheight属性
body要素のtopmargin属性
body要素のコンテナフレーム要素のmarginheight属性
'margin-right' body要素のmarginwidth属性
body要素のrightmargin属性
body要素のコンテナフレーム要素のmarginwidth属性
'margin-bottom' body要素のmarginheight属性
body要素のbottommargin属性
body要素のコンテナフレーム要素のmarginheight属性
'margin-left' body要素のmarginwidth属性
body要素のleftmargin属性
body要素のコンテナフレーム要素のmarginwidth属性

もしbody要素のノードドキュメントのノードナビゲーブルが子ナビゲーブルであり、そのコンテナがフレームまたはiframe要素である場合、body要素のコンテナフレーム要素はそのフレームまたはiframe要素です。そうでなければ、コンテナフレーム要素は存在しません。

上記の要件は、あるページが他のページ（別のオリジンからのものを含む）のマージンを変更できることを意味します。例えば、iframeを使用する場合などです。これは、場合によってはページが作者の意図した通りに表示されない状況を作り出し、フィッシングやユーザーを誤解させる目的での攻撃を許す可能性があるため、潜在的なセキュリティリスクです。

もしDocumentのノードナビゲーブルが子ナビゲーブルである場合、それはそのコンテナのコンテンツボックス内に収まるように配置されサイズ変更されることが期待されます。もしコンテナがレンダリングされていない場合、そのナビゲーブルは幅ゼロ、高さゼロのビューポートを持つことが期待されます。

もしDocumentのノードナビゲーブルが子ナビゲーブルであり、そのコンテナがフレームまたはiframe要素であり、その要素にscrolling属性があり、その属性の値が"off"、"noscroll"、または"no"という文字列とASCII大文字小文字無視で一致する場合、ユーザーエージェントはそのDocumentのノードナビゲーブルのビューポートに対して、適用される'overflow'プロパティに関わらず、スクロールバーを表示しないようにすることが期待されています。

body 要素に空でない値の background 属性が設定されている場合、新しい値は要素の ノードドキュメントを基準としてエンコード、解析、シリアル化されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の 'background-image' プロパティを戻り値に設定することが期待されます。

body 要素に bgcolor 属性が設定されている場合、新しい値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の 'background-color' プロパティを結果の色に設定することが期待されます。

body 要素に text 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の 'color' プロパティを結果の色に設定することが期待されます。

body 要素に link 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、:link 擬似クラスに一致する Document 内の任意の要素の 'color' プロパティを結果の色に設定することが期待されます。

body 要素に vlink 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、:visited 擬似クラスに一致する Document 内の任意の要素の 'color' プロパティを結果の色に設定することが期待されます。

body 要素に alink 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、:active 擬似クラスと :link 擬似クラスまたは :visited 擬似クラスのいずれかに一致する Document 内の任意の要素の 'color' プロパティを結果の色に設定することが期待されます。

15.3.3 フローコンテンツ

@namespace "http://www.w3.org/1999/xhtml";
 
 address, blockquote, center, dialog, div, figure, figcaption, footer, form,
 header, hr, legend, listing, main, p, plaintext, pre, search, xmp {
   display: block;
 }
 
 blockquote, figure, listing, p, plaintext, pre, xmp {
   margin-block: 1em;
 }
 
 blockquote, figure { margin-inline: 40px; }
 
 address { font-style: italic; }
 listing, plaintext, pre, xmp {
   font-family: monospace; white-space: pre;
 }
 
 dialog:not([open]) { display: none; }
 dialog {
   position: absolute;
   inset-inline-start: 0; inset-inline-end: 0;
   width: fit-content;
   height: fit-content;
   margin: auto;
   border: solid;
   padding: 1em;
   background-color: Canvas;
   color: CanvasText;
 }
 dialog:modal {
   position: fixed;
   overflow: auto;
   inset-block: 0;
   max-width: calc(100% - 6px - 2em);
   max-height: calc(100% - 6px - 2em);
 }
 dialog::backdrop {
   background: rgba(0,0,0,0.1);
 }
 
 [popover]:not(:popover-open):not(dialog[open]) {
   display:none;
 }
 
 dialog:popover-open {
   display:block;
 }
 
 [popover] {
   position: fixed;
   inset: 0;
   width: fit-content;
   height: fit-content;
   margin: auto;
   border: solid;
   padding: 0.25em;
   overflow: auto;
   color: CanvasText;
   background-color: Canvas;
 }
 
 :popover-open::backdrop {
   position: fixed;
   inset: 0;
   pointer-events: none !important;
   background-color: transparent;
 }
 
 slot {
   display: contents;
 }

以下のルールもまた、プレゼンテーショナルヒントとして適用されることが期待されています:

@namespace "http://www.w3.org/1999/xhtml";
 
 pre[wrap] { white-space: pre-wrap; }

In quirks mode, the following rules are also expected to apply: 

@namespace "http://www.w3.org/1999/xhtml";
 
 form { margin-block-end: 1em; }

center要素、およびdiv要素がalign属性を持ち、その値が"center"または"middle"という文字列とASCII大文字小文字無視で一致する場合、これらの要素は、プレゼンテーショナルヒントとして''text-align''プロパティが'center'に設定されているかのように、テキストを中央に配置し、子孫を中央に揃えることが期待されています。

div要素がalign属性を持ち、その値が"left"という文字列とASCII大文字小文字無視で一致する場合、その要素は、プレゼンテーショナルヒントとして''text-align''プロパティが'left'に設定されているかのように、テキストを左に配置し、子孫を左に揃えることが期待されています。

div要素がalign属性を持ち、その値が"right"という文字列とASCII大文字小文字無視で一致する場合、その要素は、プレゼンテーショナルヒントとして''text-align''プロパティが'right'に設定されているかのように、テキストを右に配置し、子孫を右に揃えることが期待されています。

div要素がalign属性を持ち、その値が"justify"という文字列とASCII大文字小文字無視で一致する場合、その要素は、プレゼンテーショナルヒントとして''text-align''プロパティが'justify'に設定されているかのように、テキストを左右両端に揃え、子孫を左に揃えることが期待されています。

15.3.4 フレージングコンテンツ

@namespace "http://www.w3.org/1999/xhtml";
 
 cite, dfn, em, i, var { font-style: italic; }
 b, strong { font-weight: bolder; }
 code, kbd, samp, tt { font-family: monospace; }
 big { font-size: larger; }
 small { font-size: smaller; }
 
 sub { vertical-align: sub; }
 sup { vertical-align: super; }
 sub, sup { line-height: normal; font-size: smaller; }
 
 ruby { display: ruby; }
 rt { display: ruby-text; }
 
 :link { color: #0000EE; }
 :visited { color: #551A8B; }
 :link:active, :visited:active { color: #FF0000; }
 :link, :visited { text-decoration: underline; cursor: pointer; }
 
 :focus-visible { outline: auto; }
 
 mark { background: yellow; color: black; } /* this color is just a suggestion and can be changed based on implementation feedback */
 
 abbr[title], acronym[title] { text-decoration: dotted underline; }
 ins, u { text-decoration: underline; }
 del, s, strike { text-decoration: line-through; }
 
 q::before { content: open-quote; }
 q::after { content: close-quote; }
 
 br { display-outside: newline; } /* this also has bidi implications */
 nobr { white-space: nowrap; }
 wbr { display-outside: break-opportunity; } /* this also has bidi implications */
 nobr wbr { white-space: normal; }

以下のルールもまた、プレゼンテーショナルヒントとして適用されることが期待されています:

@namespace "http://www.w3.org/1999/xhtml";
 
 br[clear=left i] { clear: left; }
 br[clear=right i] { clear: right; }
 br[clear=all i], br[clear=both i] { clear: both; }

CSSルビモデルの目的のために、ruby要素の子孫でrt要素またはrp要素ではないものの連続は、'display'プロパティが'ruby-base'の値を持つ匿名ボックスでラップされることが期待されています。[CSSRUBY]

特定のルビの部分に複数の注釈がある場合、注釈はルビ注釈が一方の側に積み重なるのを最小限に抑えるように、基底テキストの両側に分散されるべきです。

可能になり次第、前述の要件はCSSルビの用語で表現されるように更新されます。（現在のところ、CSSルビはネストされたruby要素や、複数の連続するrt要素を扱うことができないため、この意味が表現されています。）

正しいルビレンダリングをサポートしていないユーザーエージェントは、rt要素にrp要素が存在しない場合、そのテキストの周りに括弧を表示することが期待されています。

ユーザーエージェントは、インライン要素における'clear'プロパティをサポートすることが期待されています（これは、br要素にclear属性が設定されている場合に、その要素をレンダリングするためです）。これは、CSSの該当する非規範的な注記に記述されている方法で行われます。

'color'プロパティの初期値は黒であることが期待されています。'background-color'プロパティの初期値は「透明」であることが期待されています。キャンバスの背景は白であることが期待されています。

font 要素に color 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の 'color' プロパティを結果の色に設定することが期待されます。

font要素にface属性が設定されている場合、ユーザーエージェントはその属性を要素の'font-family'プロパティを属性の値に設定するプレゼンテーショナルヒントとして扱うことが期待されています。

font要素にsize属性が設定されている場合、ユーザーエージェントは以下の手順に従って、プレゼンテーショナルヒントとしてその要素の'font-size'プロパティを設定するために、この手順を「レガシーフォントサイズを解析するためのルール」として扱うことが期待されています:

  1. inputを属性の値とします。

  2. positionをinput内のポインタとし、初期状態では文字列の先頭を指すようにします。

  3. ASCIIの空白文字をスキップします、positionを基にしてinput内をスキップします。

  4. もしpositionがinputの終端を超えている場合、プレゼンテーショナルヒントは存在しません。終了します。

  5. もしpositionの文字がU+002B PLUS SIGNキャラクター(+)である場合、modeを相対プラスとし、positionを次の文字に進めます。それ以外の場合、もしpositionの文字がU+002D HYPHEN-MINUSキャラクター(-)である場合、modeを相対マイナスとし、positionを次の文字に進めます。それ以外の場合、modeを絶対とします。

  6. 一連のコードポイントを収集します、positionを基にしてinputからdigitsを得ます。

  7. もしdigitsが空文字列である場合、プレゼンテーショナルヒントは存在しません。終了します。

  8. digitsを10進数の整数として解釈します。valueをその結果の数とします。

  9. もしmodeが相対プラスである場合、valueに3を加算します。もしmodeが相対マイナスである場合、valueから3を引いた結果をvalueとします。

  10. もしvalueが7より大きい場合、7とします。

  11. もしvalueが1より小さい場合、1とします。

  12. 次の表に従って、valueの値に対応するキーワードを'font-size'に設定します:

    value 'font-size'キーワード
    1 'x-small'
    2 'small'
    3 'medium'
    4 'large'
    5 'x-large'
    6 'xx-large'
    7 'xxx-large'

15.3.5 双方向テキスト

@namespace "http://www.w3.org/1999/xhtml";
 
 [dir]:dir(ltr), bdi:dir(ltr), input[type=tel i]:dir(ltr) { direction: ltr; }
 [dir]:dir(rtl), bdi:dir(rtl) { direction: rtl; }
 
 address, blockquote, center, div, figure, figcaption, footer, form, header, hr,
 legend, listing, main, p, plaintext, pre, summary, xmp, article, aside, h1, h2,
 h3, h4, h5, h6, hgroup, nav, section, search, table, caption, colgroup, col,
 thead, tbody, tfoot, tr, td, th, dir, dd, dl, dt, menu, ol, ul, li, bdi, output,
 [dir=ltr i], [dir=rtl i], [dir=auto i] {
   unicode-bidi: isolate; 
 }
 
 bdo, bdo[dir] { unicode-bidi: isolate-override; } 
 
 input[dir=auto i]:is([type=search i], [type=tel i], [type=url i],
 [type=email i]), textarea[dir=auto i], pre[dir=auto i] {
   unicode-bidi: plaintext;
 }
 /* see prose for input elements whose type attribute is in the Text state */
 
 /* the rules setting the 'content' property on br and wbr elements also has bidi implications */

input要素のdir属性がauto状態にあり、そのtype属性がText状態にある場合、ユーザーエージェントは、ユーザーエージェントレベルのスタイルシートルールが'unicode-bidi'プロパティを'plaintext'に設定するかのように動作することが期待されています。

入力フィールド（すなわち、textarea要素、およびinput要素であり、そのtype属性がText、Search、Telephone、URL、またはEmail状態にある場合）は、その要素の'direction'プロパティに一致する方向性を持つ編集ユーザーインターフェースを提供することが期待されています。

ドキュメントの文字エンコーディングがISO-8859-8である場合、次のルールが上記に続いて適用されることが期待されています: [ENCODING]

@namespace "http://www.w3.org/1999/xhtml";
 
 address, blockquote, center, div, figure, figcaption, footer, form, header, hr,
 legend, listing, main, p, plaintext, pre, summary, xmp, article, aside, h1, h2,
 h3, h4, h5, h6, hgroup, nav, section, search, table, caption, colgroup, col,
 thead, tbody, tfoot, tr, td, th, dir, dd, dl, dt, menu, ol, ul, li, [dir=ltr i],
 [dir=rtl i], [dir=auto i], *|* {
   unicode-bidi: bidi-override;
 }
 input:not([type=submit i]):not([type=reset i]):not([type=button i]),
 textarea {
   unicode-bidi: normal;
 }

15.3.6 セクションと見出し

@namespace "http://www.w3.org/1999/xhtml";
 
 article, aside, h1, h2, h3, h4, h5, h6, hgroup, nav, section {
   display: block;
 }
 
 h1 { margin-block: 0.67em; font-size: 2.00em; font-weight: bold; }
 h2 { margin-block: 0.83em; font-size: 1.50em; font-weight: bold; }
 h3 { margin-block: 1.00em; font-size: 1.17em; font-weight: bold; }
 h4 { margin-block: 1.33em; font-size: 1.00em; font-weight: bold; }
 h5 { margin-block: 1.67em; font-size: 0.83em; font-weight: bold; }
 h6 { margin-block: 2.33em; font-size: 0.67em; font-weight: bold; }

次のCSSブロックでは、xは次のセレクタの省略形です: :is(article, aside, nav, section)

@namespace "http://www.w3.org/1999/xhtml";
 
 x h1 { margin-block: 0.83em; font-size: 1.50em; }
 x x h1 { margin-block: 1.00em; font-size: 1.17em; }
 x x x h1 { margin-block: 1.33em; font-size: 1.00em; }
 x x x x h1 { margin-block: 1.67em; font-size: 0.83em; }
 x x x x x h1 { margin-block: 2.33em; font-size: 0.67em; }

この省略形は、このブロックを少なくとも多少読みやすく保つために使用されています。

15.3.7 リスト

@namespace "http://www.w3.org/1999/xhtml";
 
 dir, dd, dl, dt, menu, ol, ul { display: block; }
 li { display: list-item; text-align: match-parent; }
 
 dir, dl, menu, ol, ul { margin-block: 1em; }
 
 :is(dir, dl, menu, ol, ul) :is(dir, dl, menu, ol, ul) {
   margin-block: 0;
 }
 
 dd { margin-inline-start: 40px; }
 dir, menu, ol, ul { padding-inline-start: 40px; }
 
 ol, ul, menu { counter-reset: list-item; }
 ol { list-style-type: decimal; }
 
 dir, menu, ul {
   list-style-type: disc;
 }
 :is(dir, menu, ol, ul) :is(dir, menu, ul) {
   list-style-type: circle;
 }
 :is(dir, menu, ol, ul) :is(dir, menu, ol, ul) :is(dir, menu, ul) {
   list-style-type: square;
 }

以下のルールもまた、プレゼンテーショナルヒントとして適用されることが期待されています:

@namespace "http://www.w3.org/1999/xhtml";

ol[type="1"], li[type="1"] { list-style-type: decimal; }
ol[type=a s], li[type=a s] { list-style-type: lower-alpha; }
ol[type=A s], li[type=A s] { list-style-type: upper-alpha; }
ol[type=i s], li[type=i s] { list-style-type: lower-roman; }
ol[type=I s], li[type=I s] { list-style-type: upper-roman; }
ul[type=none i], li[type=none i] { list-style-type: none; }
ul[type=disc i], li[type=disc i] { list-style-type: disc; }
ul[type=circle i], li[type=circle i] { list-style-type: circle; }
ul[type=square i], li[type=square i] { list-style-type: square; }

quirks モードでは、以下のルールも適用されることが期待されます。

@namespace "http://www.w3.org/1999/xhtml";

li { list-style-position: inside; }
li :is(dir, menu, ol, ul) { list-style-position: outside; }
:is(dir, menu, ol, ul) :is(dir, menu, ol, ul, li) { list-style-position: unset; }

li要素をレンダリングする際に、非CSSユーザーエージェントはリストアイテムマーカーのカウンターをレンダリングするために、そのli要素の序数値を使用することが期待されています。

CSSユーザーエージェントの場合、リストアイテムのレンダリングに関するいくつかの側面はCSS Lists仕様によって定義されています。さらに、以下の属性マッピングが適用されることが期待されています: [CSSLISTS]

li要素がvalue属性を持ち、その属性の値を整数の解析ルールを使用して解析した結果エラーが発生しない場合、ユーザーエージェントは解析された値valueを、プレゼンテーショナルヒントとして'counter-set'プロパティに「list-item value」の形式で使用することが期待されています。

ol要素がstart属性またはreversed属性、またはその両方を持つ場合、ユーザーエージェントは以下の手順を使用して、これらの属性をプレゼンテーショナルヒントとして'counter-reset'プロパティに適用することが期待されています:

  1. valueをnullにします。

  2. 要素がstart属性を持つ場合、その属性の値を整数の解析ルールを使用して解析した結果をvalueに設定します。

  3. 要素がreversed属性を持つ場合:

    1. valueが整数である場合、valueを1増加させ、「reversed(list-item) value」を返します。

    2. それ以外の場合、「reversed(list-item)」を返します。

      start属性が存在しなかったか、またはその値の解析がエラーになった可能性があります。

  4. それ以外の場合:

    1. valueが整数である場合、valueを1減少させ、「list-item value」を返します。

    2. それ以外の場合、プレゼンテーショナルヒントは存在しません。

15.3.8 テーブル

@namespace "http://www.w3.org/1999/xhtml";
 
 table { display: table; }
 caption { display: table-caption; }
 colgroup, colgroup[hidden] { display: table-column-group; }
 col, col[hidden] { display: table-column; }
 thead, thead[hidden] { display: table-header-group; }
 tbody, tbody[hidden] { display: table-row-group; }
 tfoot, tfoot[hidden] { display: table-footer-group; }
 tr, tr[hidden] { display: table-row; }
 td, th { display: table-cell; }
 
 colgroup[hidden], col[hidden], thead[hidden], tbody[hidden],
 tfoot[hidden], tr[hidden] {
   visibility: collapse;
 }
 
 table {
   box-sizing: border-box;
   border-spacing: 2px;
   border-collapse: separate;
   text-indent: initial;
 }
 td, th { padding: 1px; }
 th { font-weight: bold; }
 
 caption { text-align: center; }
 thead, tbody, tfoot, table > tr { vertical-align: middle; }
 tr, td, th { vertical-align: inherit; }
 
 thead, tbody, tfoot, tr { border-color: inherit; }
 table[rules=none i], table[rules=groups i], table[rules=rows i],
 table[rules=cols i], table[rules=all i], table[frame=void i],
 table[frame=above i], table[frame=below i], table[frame=hsides i],
 table[frame=lhs i], table[frame=rhs i], table[frame=vsides i],
 table[frame=box i], table[frame=border i],
 table[rules=none i] > tr > td, table[rules=none i] > tr > th,
 table[rules=groups i] > tr > td, table[rules=groups i] > tr > th,
 table[rules=rows i] > tr > td, table[rules=rows i] > tr > th,
 table[rules=cols i] > tr > td, table[rules=cols i] > tr > th,
 table[rules=all i] > tr > td, table[rules=all i] > tr > th,
 table[rules=none i] > thead > tr > td, table[rules=none i] > thead > tr > th,
 table[rules=groups i] > thead > tr > td, table[rules=groups i] > thead > tr > th,
 table[rules=rows i] > thead > tr > td, table[rules=rows i] > thead > tr > th,
 table[rules=cols i] > thead > tr > td, table[rules=cols i] > thead > tr > th,
 table[rules=all i] > thead > tr > td, table[rules=all i] > thead > tr > th,
 table[rules=none i] > tbody > tr > td, table[rules=none i] > tbody > tr > th,
 table[rules=groups i] > tbody > tr > td, table[rules=groups i] > tbody > tr > th,
 table[rules=rows i] > tbody > tr > td, table[rules=rows i] > tbody > tr > th,
 table[rules=cols i] > tbody > tr > td, table[rules=cols i] > tbody > tr > th,
 table[rules=all i] > tbody > tr > td, table[rules=all i] > tbody > tr > th,
 table[rules=none i] > tfoot > tr > td, table[rules=none i] > tfoot > tr > th,
 table[rules=groups i] > tfoot > tr > td, table[rules=groups i] > tfoot > tr > th,
 table[rules=rows i] > tfoot > tr > td, table[rules=rows i] > tfoot > tr > th,
 table[rules=cols i] > tfoot > tr > td, table[rules=cols i] > tfoot > tr > th,
 table[rules=all i] > tfoot > tr > td, table[rules=all i] > tfoot > tr > th {
   border-color: black;
 }

以下のルールもまた、プレゼンテーショナルヒントとして適用されることが期待されています: 

@namespace "http://www.w3.org/1999/xhtml";
 
 table[align=left i] { float: left; }
 table[align=right i] { float: right; }
 table[align=center i] { margin-inline: auto; }
 thead[align=absmiddle i], tbody[align=absmiddle i], tfoot[align=absmiddle i],
 tr[align=absmiddle i], td[align=absmiddle i], th[align=absmiddle i] {
   text-align: center;
 }
 
 caption[align=bottom i] { caption-side: bottom; }
 p[align=left i], h1[align=left i], h2[align=left i], h3[align=left i],
 h4[align=left i], h5[align=left i], h6[align=left i] {
   text-align: left;
 }
 p[align=right i], h1[align=right i], h2[align=right i], h3[align=right i],
 h4[align=right i], h5[align=right i], h6[align=right i] {
   text-align: right;
 }
 p[align=center i], h1[align=center i], h2[align=center i], h3[align=center i],
 h4[align=center i], h5[align=center i], h6[align=center i] {
   text-align: center;
 }
 p[align=justify i], h1[align=justify i], h2[align=justify i], h3[align=justify i],
 h4[align=justify i], h5[align=justify i], h6[align=justify i] {
   text-align: justify;
 }
 thead[valign=top i], tbody[valign=top i], tfoot[valign=top i],
 tr[valign=top i], td[valign=top i], th[valign=top i] {
   vertical-align: top;
 }
 thead[valign=middle i], tbody[valign=middle i], tfoot[valign=middle i],
 tr[valign=middle i], td[valign=middle i], th[valign=middle i] {
   vertical-align: middle;
 }
 thead[valign=bottom i], tbody[valign=bottom i], tfoot[valign=bottom i],
 tr[valign=bottom i], td[valign=bottom i], th[valign=bottom i] {
   vertical-align: bottom;
 }
 thead[valign=baseline i], tbody[valign=baseline i], tfoot[valign=baseline i],
 tr[valign=baseline i], td[valign=baseline i], th[valign=baseline i] {
   vertical-align: baseline;
 }
 
 td[nowrap], th[nowrap] { white-space: nowrap; }
 
 table[rules=none i], table[rules=groups i], table[rules=rows i],
 table[rules=cols i], table[rules=all i] {
   border-style: hidden;
   border-collapse: collapse;
 }
 table[border] { border-style: outset; } /* only if border is not equivalent to zero */
 table[frame=void i] { border-style: hidden; }
 table[frame=above i] { border-style: outset hidden hidden hidden; }
 table[frame=below i] { border-style: hidden hidden outset hidden; }
 table[frame=hsides i] { border-style: outset hidden outset hidden; }
 table[frame=lhs i] { border-style: hidden hidden hidden outset; }
 table[frame=rhs i] { border-style: hidden outset hidden hidden; }
 table[frame=vsides i] { border-style: hidden outset; }
 table[frame=box i], table[frame=border i] { border-style: outset; }
 
 table[border] > tr > td, table[border] > tr > th,
 table[border] > thead > tr > td, table[border] > thead > tr > th,
 table[border] > tbody > tr > td, table[border] > tbody > tr > th,
 table[border] > tfoot > tr > td, table[border] > tfoot > tr > th {
   /* only if border is not equivalent to zero */
   border-width: 1px;
   border-style: inset;
 }
 table[rules=none i] > tr > td, table[rules=none i] > tr > th,
 table[rules=none i] > thead > tr > td, table[rules=none i] > thead > tr > th,
 table[rules=none i] > tbody > tr > td, table[rules=none i] > tbody > tr > th,
 table[rules=none i] > tfoot > tr > td, table[rules=none i] > tfoot > tr > th,
 table[rules=groups i] > tr > td, table[rules=groups i] > tr > th,
 table[rules=groups i] > thead > tr > td, table[rules=groups i] > thead > tr > th,
 table[rules=groups i] > tbody > tr > td, table[rules=groups i] > tbody > tr > th,
 table[rules=groups i] > tfoot > tr > td, table[rules=groups i] > tfoot > tr > th,
 table[rules=rows i] > tr > td, table[rules=rows i] > tr > th,
 table[rules=rows i] > thead > tr > td, table[rules=rows i] > thead > tr > th,
 table[rules=rows i] > tbody > tr > td, table[rules=rows i] > tbody > tr > th,
 table[rules=rows i] > tfoot > tr > td, table[rules=rows i] > tfoot > tr > th {
   border-width: 1px;
   border-style: none;
 }
 table[rules=cols i] > tr > td, table[rules=cols i] > tr > th,
 table[rules=cols i] > thead > tr > td, table[rules=cols i] > thead > tr > th,
 table[rules=cols i] > tbody > tr > td, table[rules=cols i] > tbody > tr > th,
 table[rules=cols i] > tfoot > tr > td, table[rules=cols i] > tfoot > tr > th {
   border-width: 1px;
   border-block-style: none;
   border-inline-style: solid;
 }
 table[rules=all i] > tr > td, table[rules=all i] > tr > th,
 table[rules=all i] > thead > tr > td, table[rules=all i] > thead > tr > th,
 table[rules=all i] > tbody > tr > td, table[rules=all i] > tbody > tr > th,
 table[rules=all i] > tfoot > tr > td, table[rules=all i] > tfoot > tr > th {
   border-width: 1px;
   border-style: solid;
 }
 
 table[rules=groups i] > colgroup {
   border-inline-width: 1px;
   border-inline-style: solid;
 }
 table[rules=groups i] > thead,
 table[rules=groups i] > tbody,
 table[rules=groups i] > tfoot {
   border-block-width: 1px;
   border-block-style: solid;
 }
 
 table[rules=rows i] > tr, table[rules=rows i] > thead > tr,
 table[rules=rows i] > tbody > tr, table[rules=rows i] > tfoot > tr {
   border-block-width: 1px;
   border-block-style: solid;
 }

クイークスモードでは、以下のルールも適用されることが期待されています:

@namespace "http://www.w3.org/1999/xhtml";
 
 table {
   font-weight: initial;
   font-style: initial;
   font-variant: initial;
   font-size: initial;
   line-height: initial;
   white-space: initial;
   text-align: initial;
 }

CSSテーブルモデルの目的のために、col要素は、そのspan属性が指定する回数だけ存在するかのように扱われることが期待されています。

CSSテーブルモデルの目的のために、colgroup要素がcol要素を含まない場合、そのspan属性が指定する回数だけ子要素が存在するかのように扱われることが期待されています。

CSSテーブルモデルの目的のために、colspanおよびrowspan属性は、td要素およびth要素において、行および列にまたがるセルに関する特別な知識を提供することが期待されています。

HTMLドキュメントにおいて、以下のルールも適用されることが期待されています:

@namespace "http://www.w3.org/1999/xhtml";

:is(table, thead, tbody, tfoot, tr) > form { display: none !important; }

table要素のcellspacing属性は、要素のピクセル長プロパティにマッピングされ、'border-spacing'プロパティに設定されます。

table要素のcellpadding属性は、対応するピクセル長プロパティにマッピングされ、対応するセルを持つテーブルのtable要素の任意のtdおよびth要素の'padding-top'、'padding-right'、'padding-bottom'および'padding-left'に設定されます。

table要素のheight属性は、要素の寸法プロパティにマッピングされ、'height'プロパティに設定されます。

table要素のwidth属性は、要素のゼロを無視して寸法プロパティにマッピングされ、'width'プロパティに設定されます。

col要素のwidth属性は、要素の寸法プロパティにマッピングされ、'width'プロパティに設定されます。

thead、tbodyおよびtfoot要素のheight属性は、要素の寸法プロパティにマッピングされ、'height'プロパティに設定されます。

tr要素のheight属性は、要素の寸法プロパティにマッピングされ、'height'プロパティに設定されます。

tdおよびth要素のheight属性は、要素のゼロを無視して寸法プロパティにマッピングされ、'height'プロパティに設定されます。

tdおよびth要素のwidth属性は、要素のゼロを無視して寸法プロパティにマッピングされ、'width'プロパティに設定されます。

thead、tbody、tfoot、tr、 td、およびth要素は、align属性の値が文字列「center」または文字列「middle」と一致する場合、ASCII 大文字小文字を区別しない方法で、自身のテキストを中央に配置することが期待されます。これは、'text-align' プロパティが「center」に設定されているような状態で、プレゼンテーションヒントとして 設定されているかのように動作し、子要素を中央に揃えることを期待されます。

thead、tbody、tfoot、tr、 td、およびth要素は、align属性の値が文字列「left」と一致する場合、ASCII 大文字小文字を区別しない方法で、自身のテキストを左揃えにすることが期待されます。これは、'text-align' プロパティが「left」に設定されているような状態で、プレゼンテーションヒントとして設定されているかのように動作し、子要素を左揃えにすることを期待されます。

thead、tbody、tfoot、tr、 td、およびth要素は、align属性の値が文字列「right」と一致する場合、ASCII 大文字小文字を区別しない方法で、自身のテキストを右揃えにすることが期待されます。これは、'text-align' プロパティが「right」に設定されているような状態で、プレゼンテーションヒントとして設定されているかのように動作し、子要素を右揃えにすることを期待されます。

thead、tbody、tfoot、tr、 td、およびth要素は、align属性の値が文字列「justify」と一致する場合、ASCII 大文字小文字を区別しない方法で、自身のテキストを両端揃えにすることが期待されます。これは、'text-align' プロパティが「justify」に設定されているような状態で、プレゼンテーションヒントとして設定されているかのように動作し、子要素を左揃えにすることを期待されます。

ユーザーエージェントは、親ノードが計算値に初期値を持つ場合、宣言ブロックが 単一の宣言で構成されているth要素に対して、その'text-align' プロパティの値を「center」に設定するルールを、ユーザーエージェントのスタイルシートに持っていることが期待されます。

次の要素、table、thead、tbody、tfoot、tr、td、thがbackground属性を持ち、値が空でない場合、新しい値はその要素のエンコード、パース、およびシリアライズされたURLとして扱われ、そのプレゼンテーショナルヒントとして、その要素の'background-image'プロパティに設定されることが期待されます。

table、thead、tbody、tfoot、tr、td、または th 要素に bgcolor 属性が設定されている場合、新しい値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の'background-color' プロパティを結果の色に設定することが期待されます。

table 要素に bordercolor 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の 'border-top-color'、'border-right-color'、'border-bottom-color'、および 'border-left-color' プロパティを結果の色に設定することが期待されます。

table要素のborder属性は、次のプロパティにピクセル長プロパティとしてマッピングされます。'border-top-width'、'border-right-width'、'border-bottom-width'および'border-left-width'がその要素に設定されます。その属性が存在し、かつその値が非負整数のパースルールに従ってパースされエラーが発生した場合、そのプロパティに対してデフォルト値の1pxが使用されることが期待されます。

上記のCSSブロックで「borderがゼロと等しくない場合のみ」とマークされたルールは、選択子で言及されているborder属性が存在し、かつ非負整数のパースルールに従ってパースされ、その値がゼロ以外であるか、エラーが発生した場合にのみ適用されることが期待されます。

クイークモードでは、次の要素がtdまたはth属性を持ち、かつその属性が存在し、値が非ゼロ寸法値のパースルールに従ってパースされ、その結果が長さ（エラーや割合として分類される数字ではない）である場合、要素のプレゼンテーショナルヒントとして要素の'white-space'プロパティを「normal」に設定し、上記CSSブロックに設定された「nowrap」を上書きすることが期待されます。

15.3.9 マージンの折り畳みの癖

ノードが、テキストノードであり、要素間空白でない場合、または要素ノードである場合、そのノードは重要と見なされます。

ノードが要素であり、重要なノードを含まない場合、そのノードは空白と見なされます。

デフォルトのマージンを持つ要素は、次の要素です：blockquote、dir、dl、h1、h2、h3、h4、h5、h6、listing、menu、ol、p、plaintext、pre、ul、xmp

クイークモードでは、デフォルトのマージンを持つ要素が、body、td、またはthの要素の子であり、かつその前に重要な兄弟要素がない場合、ユーザーエージェントのスタイルシートのルールがその要素の'margin-block-start'プロパティをゼロに設定することが期待されます。

クイークモードでは、デフォルトのマージンを持つ要素が、body、td、またはthの要素の子であり、かつその前に重要な兄弟要素がない場合、かつ空白である場合、ユーザーエージェントのスタイルシートのルールがその要素の'margin-block-end'プロパティをゼロに設定することが期待されます。

クイークモードでは、デフォルトのマージンを持つ要素が、tdまたはthの要素の子であり、かつその後に重要な兄弟要素がなく、空白である場合、ユーザーエージェントのスタイルシートのルールがその要素の'margin-block-start'プロパティをゼロに設定することが期待されます。

クイークモードでは、p要素が、tdまたはthの要素の子であり、かつその後に重要な兄弟要素がない場合、ユーザーエージェントのスタイルシートのルールがその要素の'margin-block-end'プロパティをゼロに設定することが期待されます。

15.3.10 フォームコントロール

@namespace "http://www.w3.org/1999/xhtml";
 
 input, select, button, textarea {
   letter-spacing: initial;
   word-spacing: initial;
   line-height: initial;
   text-transform: initial;
   text-indent: initial;
   text-shadow: initial;
   appearance: auto;
 }
 
 input:not([type=image i], [type=range i], [type=checkbox i], [type=radio i]) {
   overflow: clip !important;
   overflow-clip-margin: 0 !important;
 }
 
 input, select, textarea {
   text-align: initial;
 }
 
 :autofill {
   field-sizing: fixed !important;
 }
 
 input:is([type=reset i], [type=button i], [type=submit i]), button {
   text-align: center;
 }
 
 input, button {
   display: inline-block;
 }
 
 input[type=hidden i], input[type=file i], input[type=image i] {
   appearance: none;
 }
 
 input:is([type=radio i], [type=checkbox i], [type=reset i], [type=button i],
 [type=submit i], [type=color i], [type=search i]), select, button {
   box-sizing: border-box;
 }
 
 textarea { white-space: pre-wrap; }

クイークモードでは、次のルールも適用されることが期待されます: 

@namespace "http://www.w3.org/1999/xhtml";
 
 input:not([type=image i]), textarea { box-sizing: border-box; }

各種フォームコントロールについては、ウィジェットセクションにも記載されており、コントロールの外観や操作感について説明しています。

input要素において、type属性がHidden状態またはImage Button状態でない場合で、かつレンダリングされている場合、次のように動作することが期待されます:

15.3.11 hr 要素

@namespace "http://www.w3.org/1999/xhtml";
 
 hr {
   color: gray;
   border-style: inset;
   border-width: 1px;
   margin-block: 0.5em;
   margin-inline: auto;
   overflow: hidden;
 }

次のルールも、提示ヒントとして適用されることが期待されます:

@namespace "http://www.w3.org/1999/xhtml";
 
 hr[align=left i] { margin-left: 0; margin-right: auto; }
 hr[align=right i] { margin-left: auto; margin-right: 0; }
 hr[align=center i] { margin-left: auto; margin-right: auto; }
 hr[color], hr[noshade] { border-style: solid; }

もしhr要素がcolor属性またはnoshade属性を持ち、さらにsize属性を持っている場合、その属性の値を負でない整数を解析するための規則に従って解析してエラーが発生しなかった場合、ユーザーエージェントは、解析された値を2で割った値を、提示ヒントとして、要素の'border-top-width'、'border-right-width'、'border-bottom-width'、および'border-left-width'のピクセル長として使用することが期待されます。

それ以外の場合、hr要素がcolor属性やnoshade属性を持たず、size属性を持ち、その属性の値を負でない整数を解析するためのルールを使用して解析してもエラーが発生しない場合は、解析された値が1であるならば、ユーザーエージェントは属性をプレゼンテーションヒントとして使用し、要素の'border-bottom-width'を0に設定することが期待されます。解析された値が1より大きい場合は、ユーザーエージェントは解析された値から2を引いたピクセルの長さを、要素のプレゼンテーションヒントとして'height'プロパティに使用することが期待されます。

width属性は、hr要素の寸法プロパティにマッピングされ、要素の'width'プロパティとして使用されます。

hr 要素に color 属性がある場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の'color' プロパティを結果の色に設定することが期待されます。

15.3.12 fieldset と legend 要素 

@namespace "http://www.w3.org/1999/xhtml";
 
 fieldset {
   display: block;
   margin-inline: 2px;
   border: groove 2px ThreeDFace;
   padding-block: 0.35em 0.625em;
   padding-inline: 0.75em;
   min-inline-size: min-content;
 }
 
 legend {
   padding-inline: 2px;
 }
 
 legend[align=left i] {
   justify-self: left;
 }
 
 legend[align=center i] {
   justify-self: center;
 }
 
 legend[align=right i] {
   justify-self: right;
 }

fieldset要素は、CSSボックスを生成する際に、次のように動作することが期待されます:

fieldset要素の描画された伝説がある場合、それは次のように動作することが期待されます:

fieldset要素の匿名のフィールドセットコンテンツボックスは、次のように動作することが期待されます:

フィールドセットの余白 伝説 パディング 伝説の余白 パディング 匿名のフィールドセットコンテンツボックス コンテンツ
伝説は上部ボーダーの上に描画され、上部ボーダー領域は伝説のために垂直スペースを確保します。フィールドセットの上部余白は、伝説の上部余白エッジから始まります。伝説の水平余白、または'justify-self'プロパティにより、その水平位置が決まります。匿名のフィールドセットコンテンツボックスは伝説の下に表示されます。

15.4 置換要素

次の要素は置換要素になることができます: audio、canvas、embed、iframe、img、input、object、およびvideoです。

15.4.1 埋め込みコンテンツ

embed、iframe、およびvideo要素は、置換要素として扱われることが期待されます。

埋め込みコンテンツを表す canvas要素は、置換要素として扱われることが期待されます。そのような要素の内容は、要素のビットマップがある場合はそのビットマップ、またはそうでない場合はその要素と同じ自然な寸法を持つ透明な黒のビットマップです。他のcanvas要素は、レンダリングモデルにおいて通常の要素として扱われることが期待されます。

画像、プラグイン、またはそのナビゲーブルなコンテンツを表すobject要素は、置換要素として扱われることが期待されています。その他のobject要素は、レンダリングモデルにおいて通常の要素として扱われることが期待されています。

ユーザーインターフェースを露出する audio要素は、一行の高さで、ユーザーエージェントのユーザーインターフェース機能を露出するのに必要なだけの幅で置換要素として扱われることが期待されます。audio要素がユーザーインターフェースを露出しない場合、ユーザーエージェントはCSSルールにかかわらず、その'display'プロパティを'none'に計算させることが期待されます。

video要素がユーザーインターフェースを露出するかどうかは、レンダリングのサイズには影響を与えないことが期待されます。コントロールはページコンテンツの上にオーバーレイされ、レイアウトの変更を引き起こすことなく、ユーザーがそれを必要としなくなると消えることが期待されます。

video要素がポスターフレームまたはビデオのフレームを表す場合、ポスターフレームまたはビデオのフレームは、そのポスターフレームまたはビデオのフレームのアスペクト比を維持しつつ、そのvideo要素自体よりも高くも広くもない最大サイズでレンダリングされ、そのvideo要素の中央に配置されることが期待されます。

字幕やキャプションは、それぞれのvideo要素の上に直接オーバーレイされることが期待されます。WebVTTの場合、それは関連するレンダリングルールによって定義されます。たとえば、WebVTTベースのテキストトラックの場合、WebVTTテキストトラックの表示を更新するためのルールです。

videoおよびcanvas要素のサイズ変更は、ビデオの再生やキャンバスのクリアを中断しないことが期待されます。

次のCSSルールが適用されることが期待されます:

@namespace "http://www.w3.org/1999/xhtml";
 
 iframe { border: 2px inset; }
 video { object-fit: contain; }

15.4.2 画像

ユーザーエージェントは、img要素およびinput要素のtype属性が画像ボタンの状態にある場合、次のリストから最初に適用可能なルールに従って要素をレンダリングすることが期待されます:

要素が画像を表す場合
ユーザーエージェントは、その要素を置換要素として扱い、CSSで定義されたルールに従って画像をレンダリングすることが期待されます。
要素が画像を表さない場合で、以下のいずれかの場合:
ユーザーエージェントは、その要素を、要素が表すテキストがあればそのテキストを内容とする置換要素として扱うことが期待されます。また、必要に応じて、画像が取得中であることを示すアイコンを表示することもあります。input要素の場合、要素はボタンのように見え、その要素がボタンであることを示すことが期待されます。
要素がテキストを表す img要素であり、ユーザーエージェントがこれが変わると予想していない場合
ユーザーエージェントは、要素を非置換フレージング要素として扱い、その内容がテキストであり、オプションとして、画像が欠落していることを示すアイコンを表示することが期待されます。このアイコンにより、ユーザーが画像の表示をリクエストしたり、なぜレンダリングされていないのかを調査したりすることができます。非グラフィカルな環境では、そのようなアイコンは省略されるべきです。
要素が何も表さない img要素であり、ユーザーエージェントがこれが変わると予想していない場合
ユーザーエージェントは、要素を自然な寸法が0である置換要素として扱うことが期待されます。（追加のスタイルがない場合、これにより要素は実質的にレンダリングされなくなります。）
要素が画像を表さない input要素であり、ユーザーエージェントがこれが変わると予想していない場合
ユーザーエージェントは、その要素を、要素の代替テキストを内容とするボタンから成る置換要素として扱うことが期待されます。ボタンの自然な寸法は、一行の高さと、テキストを一行でレンダリングするために必要な幅であることが期待されます。

上記のアイコンは、ほとんどのテキストを妨げないように比較的小さく、簡単にクリックできることが期待されます。例えば、ビジュアル環境では、アイコンは16ピクセル×16ピクセルの正方形、または画像がスケーラブルな場合は1em×1emである可能性があります。音声環境では、アイコンは短いビープ音である可能性があります。これらのアイコンは、ユーザーが画像に関するオプションにアクセスできることを示し、適切な場合は、実際の画像と対話した場合に表示されるコンテキストメニューへのアクセスを提供することが期待されます。

次のCSSルールが適用されることが期待されます:

@namespace "http://www.w3.org/1999/xhtml";
 
 img:is([sizes="auto" i], [sizes^="auto," i]) {
   contain: size !important;
   contain-intrinsic-size: 300px 150px;
 }

次のCSSルールは、ドキュメントがクイークスモードにある場合に適用されることが期待されます:

@namespace "http://www.w3.org/1999/xhtml";
 
 img[align=left i] { margin-right: 3px; }
 img[align=right i] { margin-left: 3px; }

15.4.3 埋め込みコンテンツおよび画像の属性

次のCSSルールがプレゼンテーショナルヒントとして適用されることが期待されます:

@namespace "http://www.w3.org/1999/xhtml";

embed[align=left i], iframe[align=left i], img[align=left i],
input[type=image i][align=left i], object[align=left i] {
  float: left;
}

embed[align=right i], iframe[align=right i], img[align=right i],
input[type=image i][align=right i], object[align=right i] {
  float: right;
}

embed[align=top i], iframe[align=top i], img[align=top i],
input[type=image i][align=top i], object[align=top i] {
  vertical-align: top;
}

embed[align=baseline i], iframe[align=baseline i], img[align=baseline i],
input[type=image i][align=baseline i], object[align=baseline i] {
  vertical-align: baseline;
}

embed[align=texttop i], iframe[align=texttop i], img[align=texttop i],
input[type=image i][align=texttop i], object[align=texttop i] {
  vertical-align: text-top;
}

embed[align=absmiddle i], iframe[align=absmiddle i], img[align=absmiddle i],
input[type=image i][align=absmiddle i], object[align=absmiddle i],
embed[align=abscenter i], iframe[align=abscenter i], img[align=abscenter i],
input[type=image i][align=abscenter i], object[align=abscenter i] {
  vertical-align: middle;
}

embed[align=bottom i], iframe[align=bottom i], img[align=bottom i],
input[type=image i][align=bottom i], object[align=bottom i] {
  vertical-align: bottom;
}

次のような要素が、embed、iframe、img、object要素、またはinput要素であり、type属性が画像ボタンの状態にある場合、そしてalign属性の値が、文字列"center"または文字列"middle"とASCII大文字小文字を区別しない一致をする場合、ユーザーエージェントは、その要素の'vertical-align'プロパティが、要素の垂直中央を親要素のベースラインに揃える値に設定されたかのように振る舞うことが期待されます。

hspace属性がembed、img、object要素、およびinput要素に設定されており、type属性が画像ボタン状態にある場合、この属性は、要素の'margin-left'および'margin-right'の寸法プロパティにマップされることが期待されます。

vspace属性がembed、img、object要素、およびinput要素に設定されており、type属性が画像ボタン状態にある場合、この属性は、要素の'margin-top'および'margin-bottom'の寸法プロパティにマップされることが期待されます。

iframe 要素に frameborder 属性があり、その値を整数を解析するためのルールを使用して解析した結果がゼロまたはエラーである場合、ユーザーエージェントは要素の 'border-top-width'、'border-right-width'、'border-bottom-width'、および'border-left-width' プロパティをゼロに設定する表示ヒントを持つことが期待されます。

img 要素、object 要素、または input 要素（画像ボタン状態の type 属性を持つ）に border 属性があり、その値が、非負整数を解析するためのルールを使用して解析された場合にゼロより大きい数値である場合、ユーザーエージェントは、解析された値を8つの表示ヒントに使用することが期待されます。4つは、解析された値をピクセル長として要素の 'border-top-width'、'border-right-width'、'border-bottom-width'、および'border-left-width' プロパティに設定し、そして4つは、要素の'border-top-style'、'border-right-style'、'border-bottom-style'、および 'border-left-style' プロパティを値 'solid' に設定します。

widthおよびheight属性は、img要素の寸法属性ソースにおいて、要素の寸法プロパティの'width'および'height'にそれぞれマップされます。同様に、img要素のアスペクト比プロパティ（寸法ルールを使用）にマップされます。

widthおよびheight属性は、embed、iframe、object、およびvideo要素、ならびに、input要素において、type属性が画像ボタンの状態にあり、画像を表している、またはユーザーが最終的に画像を表すと予想している場合に、要素の寸法プロパティ'width'および'height'にそれぞれマップされます。

widthおよびheight属性は、imgおよびvideo要素、ならびに、input要素において、type属性が画像ボタンの状態にある場合、要素のアスペクト比プロパティ（寸法ルールを使用）にマップされます。

widthおよびheight属性は、canvas要素のアスペクト比プロパティにマップされます。

15.4.4 画像マップ

画像マップ上のシェイプは、CSSカスケードの目的上、元のarea要素とは独立した要素として振る舞うことが期待されており、同じスタイルルールに一致しますが、imgまたはobject要素から継承されます。

レンダリングの目的上、'cursor'プロパティのみがシェイプに影響を与えると想定されます。

例えば、area要素にstyle属性があり、それが'cursor'プロパティを'help'に設定している場合、ユーザーがそのシェイプを指定すると、カーソルがヘルプカーソルに変わります。

同様に、area要素がCSSルールで'cursor'プロパティを'inherit'に設定している場合（または'cursor'プロパティを設定するルールが全く要素に適合しなかった場合）、シェイプのカーソルは画像マップのimgまたはobject要素から継承され、area要素の親からは継承されません。

15.5 ウィジェット

15.5.1 ネイティブアピアランス

CSS基本ユーザーインターフェイス仕様では、ネイティブアピアランスを持つことができる要素をネイティブアピアランスと呼び、ウィジェットと定義しています。そして、そのネイティブアピアランスを使用するかどうかは、'appearance'プロパティに依存します。このロジックは、各要素が移行可能ウィジェットか非移行可能ウィジェットとして分類されるかどうかに依存します。このセクションでは、HTMLのこれらの概念に一致する要素、ネイティブアピアランスが何であるか、移行後の状態またはプリミティブアピアランスに関する特異性を定義します。[CSSUI]

次の要素は、CSSの'appearance'プロパティの目的でネイティブアピアランスを持つことができます。

15.5.2 書字モード

いくつかのウィジェットは、'writing-mode'CSSプロパティによってレンダリングが制御されます。これらのウィジェットの目的のために、以下の定義があります。

水平書字モードとは、コントロールの'writing-mode'プロパティを解決した結果が'horizontal-tb'となる場合です。

垂直書字モードとは、コントロールの'writing-mode'プロパティを解決した結果が'vertical-rl'、'vertical-lr'、'sideways-rl'、または'sideways-lr'のいずれかとなる場合です。

15.5.3 ボタンレイアウト

要素がボタンレイアウトを使用する場合、それは移行可能ウィジェットであり、ネイティブアピアランスはボタンの外観です。

ボタンレイアウトは以下の通りです:

期待されるプリミティブアピアランスを定義する必要があります。

15.5.4 button要素

button要素がCSSボックスを生成する場合、ボタンを表現し、ボタンレイアウトを使用することが期待されます。このレイアウトの匿名ボタンコンテンツボックス（もし匿名ボタンコンテンツボックスがあれば）の内容は、要素のボックスが通常持つはずの子ボックスです。

15.5.5 details および summary 要素 

@namespace "http://www.w3.org/1999/xhtml";
 
 details, summary {
   display: block;
 }
 details > summary:first-of-type {
   display: list-item;
   counter-increment: list-item 0;
   list-style: disclosure-closed inside;
 }
 details[open] > summary:first-of-type {
   list-style-type: disclosure-open;
 }

details 要素には、3つの子要素を持つ内部 シャドウツリー があることが期待されています:

  1. 最初の子要素は、slot であり、このスロットは details 要素の最初の summary 要素の子を受け取ることが期待されます。 この要素には、デフォルトサマリーと呼ばれる単一の summary 要素があり、そのテキスト内容は 実装依存 です (おそらくローカルによる)。

    この summary 要素を通じて、ユーザーが詳細の表示または非表示を要求できることが期待されます。

  2. 2番目の子要素は slot であり、このスロットは details 要素の残りの子孫を受け取ることが期待されます。 この要素には内容がありません。

    この要素は '::details-content' 擬似要素に一致することが期待されます。

    この要素の style 属性は、details 要素に open 属性がない場合に "display: block; content-visibility: hidden;" に設定されることが期待されます。open 属性がある場合、この style 属性は "display: block;" に設定されることが期待されます。

    スロットがシャドウツリー内に隠されているため、この style 属性は著者コードから直接見えるわけではありませんが、その影響は見えます。特に、content-visibility: hidden の選択は、例えば display: none といった選択に比べて、レイアウト情報を照会するさまざまなAPIの結果に影響を与えます。

  3. 3番目の子要素は link または style 要素であり、デフォルトサマリー のために以下のスタイルを持ちます: 

    :host summary {
   display: list-item;
   counter-increment: list-item 0;
   list-style: disclosure-closed inside;
 }
 :host([open]) summary {
   list-style-type: disclosure-open;
 }

    この子要素の他の2つに対する位置は観察可能ではありません。これは、実装によっては兄弟要素に対して異なる順序で配置される可能性があることを意味します。実装によっては、要素ではないメカニズムを使用してシャドウツリーにスタイルを関連付けることさえあります。

このシャドウツリーの構造は、details 要素と '::details-content' 擬似要素がCSSスタイルに応答する方法を通じて観察可能です。

15.5.6 input 要素をテキスト入力ウィジェットとして使用

input 要素の type 属性が Text, Telephone, URL, または Email ステートのいずれかである場合、その要素は 退化可能なウィジェット と見なされます。期待される ネイティブアピアランス は、 インラインブロック ボックスとして描画され、1行のテキストコントロールを表します。

input 要素の type 属性が Search ステートである場合、その要素は 退化可能なウィジェット と見なされます。期待される ネイティブアピアランス は、1行のテキストコントロールを表す インラインブロック ボックスとして描画されます。要素の 計算値 が テキストフィールド として計算されていない場合、検索フィールドであることを示す異なるスタイルを持つ場合があります。

input 要素の type 属性が Password ステートである場合、その要素は 退化可能なウィジェット と見なされます。期待される ネイティブアピアランス は、データ入力を隠す 1 行のテキストコントロールを表す インラインブロック ボックスとして描画されます。

input 要素の type 属性が上記のいずれかのステートにある場合、使用される値 は、'line-height: normal' の場合の line-height プロパティよりも小さくない長さの値である必要があります。

使用される値 は実際の 'normal' キーワードではありません。また、このルールは 計算値 に影響しません。

これらのテキストコントロールがテキスト選択を提供する場合、ユーザーが現在の選択を変更すると、ユーザーエージェントは エレメントタスクをキューに追加 し、ユーザーインタラクションタスクソース に対して、input 要素の イベント を 'select' として発火します。バブル 属性が true に初期化されます。

input 要素の type 属性が上記のいずれかのステートにある場合、その要素は デフォルトの推奨サイズを持つ要素 であり、ユーザーエージェントは要素に フィールドサイズ CSS プロパティを適用する必要があります。ユーザーエージェントは、以下の手順に従って インラインサイズ を決定する必要があります：

  1. 要素の フィールドサイズ プロパティが コンテンツ の 計算値 を持つ場合、インラインサイズは要素が表示するテキストによって決まります。テキストは、 値 または プレースホルダ 属性によって指定される短いヒントです。ユーザーエージェントは、インラインサイズにテキストカーソルのサイズを考慮することができます。

  2. 要素に サイズ 属性があり、その属性の値を 負でない整数の解析ルール を使用して解析してもエラーが発生しない場合、その属性の値をピクセルに変換するアルゴリズムを適用して得られた値を返します。

  3. それ以外の場合は、20という数値にピクセル幅に変換するアルゴリズムを適用して得られた値を返します。

文字幅をピクセルに変換する アルゴリズムは、次の式を返します: (size-1)×avg + max。ここで、size は変換する文字幅、avg はアルゴリズムが実行されている要素の主フォントの平均文字幅 (ピクセル単位)、および max は同じフォントの最大文字幅 (ピクセル単位) です。 (要素の レタースペーシング プロパティは結果に影響を与えません。)

これらのテキストコントロールは、 スクロールコンテナ として機能し、 インライン軸 でのスクロールをサポートしますが、 ブロック軸 ではサポートしません。

期待される ネイティブアピアランス および プリミティブアピアランス を詳述する必要があります。

15.5.7 input 要素のドメイン固有ウィジェットとしての使用

input 要素の type 属性が Date 状態である場合、この要素は 進化可能なウィジェット として扱われ、日付コントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

input 要素の type 属性が Month 状態である場合、この要素は 進化可能なウィジェット として扱われ、月コントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

input 要素の type 属性が Week 状態である場合、この要素は 進化可能なウィジェット として扱われ、週コントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

input 要素の type 属性が Time 状態である場合、この要素は 進化可能なウィジェット として扱われ、時刻コントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

input 要素の type 属性が Local Date and Time 状態である場合、この要素は 進化可能なウィジェット として扱われ、ローカル日付と時刻のコントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

input 要素の type 属性が Number 状態である場合、この要素は 進化可能なウィジェット として扱われ、数値コントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

input 要素の type 属性が Number 状態である場合、この要素は デフォルトの推奨サイズを持つ要素 として扱われ、フィールドサイズ CSS プロパティが適用されることが期待されます。ブロックサイズ は1行分の高さ程度とされます。要素上の フィールドサイズ プロパティの 計算値 が 'content' の場合、インラインサイズ は現在の 値 を表示するのに必要な幅程度とされます。それ以外の場合、インラインサイズ は最も幅広い可能性のある値を表示するのに必要な幅程度とされます。

input 要素の type 属性が Date, Month, Week, Time, または Local Date and Time 状態である場合、1行分の高さ程度で、最も幅広い可能性のある値を表示するのに必要な幅程度とされます。

予想される ネイティブな外観 と プリミティブな外観 を詳述する必要があります。

15.5.8 input 要素のレンジコントロールとしての使用

input 要素の type 属性が Range 状態である場合、この要素は 進化不可ウィジェット として扱われ、スライダーコントロールを表す インラインブロック ボックスとしてレンダリングされることが期待されます。

このコントロールが 水平書字モード を持つ場合、コントロールは水平スライダーであることが期待されます。direction プロパティの 計算値 が 'rtl' である場合、最小値は右側に、そうでない場合は左側に配置されます。このコントロールが 垂直書字モード を持つ場合、コントロールは垂直スライダーであることが期待されます。direction プロパティの 計算値 が 'rtl' である場合、最小値は下側に、そうでない場合は上側に配置されます。

定義済みの推奨値（list 属性で提供される）は、スライダー上にティックマークとして表示され、スライダーはそれにスナップすることが期待されます。

予想される プリミティブな外観 を詳述する必要があります。

15.5.9 input 要素のカラーウェルとしての使用

input 要素の type 属性が Color 状態である場合、この要素はカラーウェルを表すことが期待されます。アクティブにすると、色を変更できるカラーピッカー（例：カラーホイールやカラーパレット）がユーザーに提供されます。この要素が CSS ボックス を生成する際には、ボタンレイアウト が使用され、匿名ボタンコンテンツボックス は持ちません。匿名ボタンコンテンツボックス には、表現的なヒントが設定され、背景色プロパティがその要素の 値 に設定されることが期待されます。

定義済みの推奨値（list 属性で提供される）は、カラーピッカーインターフェースに表示されることが期待され、カラーウェル自体には表示されません。

予想される ネイティブ外観 および 基本的外観 を詳述する必要があります。

15.5.10 input 要素のチェックボックスおよびラジオボタンウィジェットとしての使用

input 要素の type 属性が チェックボックス 状態である場合、この要素は 進化不可ウィジェット として扱われ、ラベルのない単一のチェックボックスコントロールを含む インラインブロック ボックスとしてレンダリングされることが期待されます。

予想される ネイティブ外観 および 基本的外観 を詳述する必要があります。

input 要素の type 属性が ラジオボタン 状態である場合、この要素は 進化不可ウィジェット として扱われ、ラベルのない単一のラジオボタンコントロールを含む インラインブロック ボックスとしてレンダリングされることが期待されます。

予想される ネイティブ外観 および 基本的外観 を詳述する必要があります。

15.5.11 input 要素のファイルアップロードコントロールとしての使用

input 要素の type 属性が ファイルアップロード 状態である場合、CSS ボックス を生成する際に、選択されたファイル名（存在する場合）を示すテキストのスパンと、その後にボタンを含む インラインブロック ボックスとしてレンダリングされることが期待されます。このボタンは、アクティブ化されると、ユーザーにファイルピッカーを提供し、そこから選択を変更することができます。ボタンは ボタンレイアウト を使用し、::file-selector-button 疑似要素に一致することが期待されます。その 匿名ボタンコンテンツボックス の内容は、実装定義（おそらくローカル固有）テキストであることが期待されます。例えば「ファイルを選択」などです。

ユーザーエージェントは、input 要素の type 属性が ファイルアップロード 状態である場合、この要素を デフォルトの推奨サイズを持つ要素 として扱うことができ、ユーザーエージェントはこの要素に フィールドサイズ CSS プロパティを適用することができます。もし、この要素の フィールドサイズ プロパティが 'content' の 計算値 を持つ場合、その要素の 本来のサイズ は、その内容（例えば、::file-selector-button 疑似要素や選択されたファイル名）に依存することが期待されます。

15.5.12 input 要素のボタンとしての使用

input 要素の type 属性が 送信ボタン、リセットボタン、または ボタン 状態である場合、CSS ボックス を生成する際に、ボタンを描画し、ボタンレイアウト を使用することが期待されます。また、匿名ボタンコンテンツボックス の内容は、要素の value 属性のテキスト（存在する場合）であるか、または存在しない場合には、要素の type 属性から導き出されたテキストであることが期待されます。このテキストは、実装定義（おそらくローカル固有）の形式で提供されます。

15.5.13 marquee 要素

@namespace "http://www.w3.org/1999/xhtml";

marquee {
  display: inline-block;
  text-align: initial;
  overflow: hidden !important;
}

marquee 要素は、オンにすると、以下の属性に従ってアニメーション形式で表示されることが期待されます:

要素の behavior 属性が scroll 状態である場合

要素の direction 属性で定義された方向に従って、内容をスライドさせます。内容は marquee の開始側から始まり、終了側で内部に収まるようにスライドします。

例えば、direction 属性が left （デフォルト）である場合、内容は右端から外れたところから始まり、marquee の左端で内部に収まるまでスライドします。

アニメーションが終了すると、ユーザーエージェントは marquee 現在のループインデックスをインクリメントする ことが期待されます。その後も要素が オンにされたまま であれば、アニメーションが再開されることが期待されます。

要素の behavior 属性が slide 状態である場合

要素の direction 属性で定義された方向に従って、内容をスライドさせます。内容は marquee の開始側から始まり、終了側から外れるまでスライドします。

例えば、direction 属性が left （デフォルト）である場合、内容は右端から外れたところから始まり、marquee の左端で内部に収まるまでスライドします。

アニメーションが終了すると、ユーザーエージェントは marquee 現在のループインデックスをインクリメントする ことが期待されます。その後も要素が オンにされたまま であれば、アニメーションが再開されることが期待されます。

要素の behavior 属性が alternate 状態である場合

marquee 現在のループインデックス が偶数（またはゼロ）の場合、要素の direction 属性で定義された方向に従って内容をスライドさせます。内容は marquee の開始側で内部に収まり、終了側で内部に収まります。

marquee 現在のループインデックス が奇数の場合、direction 属性で定義された方向と逆方向に内容をスライドさせます。内容は marquee の終了側で内部に収まり、開始側で内部に収まります。

例えば、direction 属性が left （デフォルト）である場合、内容は右端で内部に収まり、marquee の左端で内部に収まるまでスライドします。

アニメーションが終了すると、ユーザーエージェントは marquee 現在のループインデックスをインクリメントする ことが期待されます。その後も要素が オンにされたまま であれば、アニメーションが継続されることが期待されます。

direction 属性は、以下の表で説明されている意味を持ちます:

direction 属性の状態 アニメーションの方向 開始端 終了端 反対方向
left ← 右から左 右 左 → 左から右
right → 左から右 左 右 ← 右から左
up ↑ 上（下から上） 下 上 ↓ 下（上から下）
down ↓ 下（上から下） 上 下 ↑ 上（下から上）

いずれの場合でも、アニメーションは各フレームの間に marquee スクロール間隔 で指定された遅延が発生するように進行し、各フレームで marquee スクロール距離 で指定された距離までしか移動しないようにする必要があります。

marquee 要素に bgcolor 属性が設定されている場合、その値はレガシーカラー値を解析するためのルールを使用して解析されることが期待され、それが失敗を返さない場合、ユーザーエージェントは属性を表示ヒントとして扱い、要素の'background-color' プロパティを結果の色に設定することが期待されます。

width と height 属性は marquee 要素において、それぞれ 寸法プロパティにマップされる 'width' および 'height' プロパティにマップされます。

marquee 要素で、direction 属性が up または down 状態である場合、要素の 自然高さ は 200 CSS ピクセル です。

marquee 要素の vspace 属性は、寸法プロパティにマップされます。このプロパティは、要素の 'margin-top' および 'margin-bottom' にマップされます。同様に、marquee 要素の hspace 属性は、寸法プロパティにマップされます。このプロパティは、要素の 'margin-left' および 'margin-right' にマップされます。

15.5.14 meter 要素

@namespace "http://www.w3.org/1999/xhtml";

meter { appearance: auto; }

meter 要素は、展開可能なウィジェットです。期待される ネイティブ表示 は、インラインブロック ボックスとして描画され、その ブロックサイズ は '1em'、インラインサイズ は '5em'、縦揃え は '-0.2em' とされ、その内容がゲージとして描画されることです。

この要素が 水平書字モード を持つ場合、描画は水平方向のゲージであることが期待されます。最小値は、方向 プロパティが 'rtl' の 計算値 を持つ場合は右側にあり、そうでない場合は左側にあります。この要素が 垂直書字モード を持つ場合、描画は垂直方向のゲージであることが期待されます。最小値は、方向 プロパティが 'rtl' の 計算値 を持つ場合は下側にあり、そうでない場合は上側にあります。

ユーザーエージェントは、ゲージに関するプラットフォームの慣習と一致するプレゼンテーションを使用することが期待されます。

ゲージに何を描画するかの要件は、meter 要素の定義に含まれています。

期待される 基本的な表示 の詳細を記載する必要があります。

15.5.15 progress 要素

@namespace "http://www.w3.org/1999/xhtml";

progress { appearance: auto; }

progress 要素は、展開可能なウィジェットです。期待される ネイティブ表示 は、インラインブロック ボックスとして描画され、その ブロックサイズ は '1em'、インラインサイズ は '10em'、縦揃え は '-0.2em' です。

この要素が 水平書字モード を持つとき、この要素は水平プログレスバーとして描画されることが期待されます。開始点は右側、終了点は左側です。この要素の 方向 プロパティが 'rtl' の 計算値 を持つ場合は右から左へ進行し、それ以外の場合は左から右へ進行します。この要素が 垂直書字モード を持つ場合、垂直プログレスバーとして描画されることが期待されます。開始点は下側、終了点は上側です。この要素の 方向 プロパティが 'rtl' の 計算値 を持つ場合は下から上へ進行し、それ以外の場合は上から下へ進行します。

ユーザーエージェントは、プラットフォームの慣習に一致するプログレスバーのプレゼンテーションを使用することが期待されます。特に、ユーザーエージェントは決定的および不確定なプログレスバーに対して異なるプレゼンテーションを使用することが期待されます。また、要素の寸法に基づいてプレゼンテーションを変更することも期待されます。

プログレスバーが決定的か不確定かを判断する方法、および決定的なプログレスバーがどのような進行を示すべきかの要件は、progress 要素の定義に含まれています。

期待される 基本的な表示 の詳細を記載する必要があります。

15.5.16 select 要素

select 要素は、既定の推奨サイズを持つ要素であり、ユーザーエージェントは フィールドサイズ指定 CSS プロパティを select 要素に適用することが期待されます。

select 要素は、その属性に応じて、リストボックス または ドロップダウンボックス のいずれかです。

select 要素に multiple 属性が存在する場合は、マルチセレクトの リストボックス として描画されることが期待されます。

select 要素に multiple 属性が存在せず、その 表示サイズ が 1 を超える場合、シングルセレクトの リストボックス として描画されることが期待されます。

この要素が リストボックス として描画される場合、それは 展開可能なウィジェット であり、インラインブロック ボックスとして描画されることが期待されます。その インラインサイズ は、select のラベルの幅 にスクロールバーの幅を加えたものです。その ブロックサイズ は次の手順で決定されます：

  1. 要素の フィールドサイズ指定 プロパティの 計算値 が 'コンテンツ' である場合、すべての行を表示するために必要な高さを返します。

  2. size 属性が存在しないか、有効な値を持たない場合、4 行を表示するために必要な高さを返します。

  3. それ以外の場合、要素の 表示サイズ によって指定された行数を表示するために必要な高さを返します。

select 要素に multiple 属性が存在せず、表示サイズ が 1 の場合、インラインブロック の一行 ドロップダウンボックス として描画されることが期待されます。その インラインサイズ は select のラベルの幅 です。要素の フィールドサイズ指定 プロパティの 計算値 が 'コンテンツ' である場合、インラインサイズ は表示されるテキストに依存します。表示されるテキストは、通常、選択状態 が true に設定された option のラベルです。

この要素が ドロップダウンボックス として描画される場合、それは 展開可能なウィジェット です。展開された状態での表示、または要素の 計算値 が アピアランス プロパティの値として 'メニューリストボタン' であるとき、その表示はドロップダウンボックスのようになります。これには「ドロップダウンボタン」が含まれますが、ホストオペレーティングシステムのネイティブコントロールを使用して描画する必要はありません。このような状態では、カラー、背景色、および「ボーダー」などの CSS プロパティを無視してはなりません（要素をネイティブアピアランスに基づいて描画するときに一般的に許容される方法として）。

いずれの場合（リストボックス または ドロップダウンボックス）、要素のアイテムは、要素の オプションのリスト であることが期待されます。optgroup 要素は、該当する場合、オプションのグループのヘッダーを提供します。

optgroup 要素は、その ラベル 属性を表示して描画されることが期待されます。

option 要素は、その ラベル を表示して描画されることが期待され、optgroup 要素がある場合は、その下にインデントされます。

1 つ以上の子 hr 要素のシーケンスは、1 つのセパレーターとして描画されることがあります。

select のラベルの幅 は、最も広い optgroup を描画するために必要な幅と、要素の オプションのリスト にある最も広い option 要素（インデントがある場合はそのインデントを含む）を描画するために必要な幅のうち、広い方です。

select 要素が プレースホルダラベルオプション を含んでいる場合、ユーザーエージェントはその option を、コントロールの有効なオプションではなくラベルであることを伝えるような方法で描画することが期待されます。これには、プレースホルダラベルオプション がユーザーによって明示的に選択されることを防ぐことが含まれる場合があります。プレースホルダラベルオプション の 選択状態 が true の場合、コントロールは現在有効なオプションが選択されていないことを示す方法で表示されることが期待されます。

ユーザーエージェントは、ラベルがページの一部として表示されている場合やメニューコントロール内で表示されている場合でも、一貫した整列を保つ方法で select 内のラベルを描画することが期待されます。

期待される ネイティブアピアランス と 基本的な表示 の詳細を記載する必要があります。

15.5.17 textarea 要素

textarea 要素は 展開可能なウィジェット であり、複数行のテキストコントロールを描画する インラインブロック ボックスとして描画されることが期待されます。この複数行のテキストコントロールが選択を提供する場合、ユーザーが現在の選択を変更すると、ユーザーエージェントは 要素タスクをキューに追加 し、ユーザー操作タスクソース に基づいて、textarea 要素に select という名前のイベントを発火させ、その バブル 属性を true に初期化します。

textarea 要素は 既定の推奨サイズを持つ要素 であり、ユーザーエージェントは フィールドサイズ指定 CSS プロパティを textarea 要素に適用することが期待されます。

要素の フィールドサイズ指定 プロパティの 計算値 が 'コンテンツ' である場合、本質的なサイズ は要素が表示するテキストから決定されます。テキストは、生の値 または プレースホルダー 属性で指定された短いヒントです。ユーザーエージェントは、本質的なサイズにテキストキャレットサイズを考慮に入れることができます。それ以外の場合、本質的なサイズ は textareaの実効幅 と textareaの実効高さ から計算されます（以下で定義されます）。

textareaの実効幅 は、textarea 要素の size×avg + sbw です。ここで、size は要素の 文字幅、avg は要素の主要フォントの平均文字幅（CSS ピクセル）、sbw はスクロールバーの幅（CSS ピクセル）です。（要素の 文字間隔 プロパティは結果に影響を与えません。）

textareaの実効高さ は、textarea 要素の CSS ピクセル 単位の高さで、要素の 文字高さ で指定された行数の高さ、およびスクロールバーの高さを含みます。

ユーザーエージェントは、ホワイトスペース CSS プロパティを textarea 要素に適用することが期待されます。歴史的な理由から、要素に wrap 属性があり、その値が "off" という文字列と ASCII ケースインセンシティブ な一致を示す場合、ユーザーエージェントはその属性を要素の 提示ヒント として扱い、要素の ホワイトスペース プロパティを 'pre' に設定することが期待されます。

期待される ネイティブアピアランス と 基本的な表示 の詳細を記載する必要があります。

15.6 フレームとフレームセット

ユーザーエージェントは、frameset 要素を、ビューポートの高さと幅を持つボックスとしてレンダリングし、以下のレイアウトアルゴリズムに従って表面を描画することが期待されます。

  1. cols および rows 変数は、数値と単位のペアで構成されるゼロ以上のリストであり、単位は パーセンテージ、相対、絶対 のいずれかです。

    要素の cols 属性の値を解析するために、寸法リストを解析するためのルール を使用します。cols を結果とし、属性がない場合は空のリストにします。

    要素の rows 属性の値を解析するために、寸法リストを解析するためのルール を使用します。rows を結果とし、属性がない場合は空のリストにします。

  2. cols または rows のエントリの中で、数値がゼロで単位が 相対 であるエントリがある場合、そのエントリの数値を 1 に変更します。

  3. cols にエントリがない場合、cols に値 1 と単位 相対 のエントリを 1 つ追加します。

    rows にエントリがない場合、rows に値 1 と単位 相対 のエントリを 1 つ追加します。

  4. 以下のアルゴリズムを使用して、寸法リストをピクセル値のリストに変換 し、入力リストとして cols を使用し、frameset がレンダリングされている表面の幅（CSS ピクセル単位）を入力寸法とします。sized cols を結果のリストとします。

    以下のアルゴリズムを使用して、寸法リストをピクセル値のリストに変換 し、入力リストとして rows を使用し、frameset がレンダリングされている表面の高さ（CSS ピクセル単位）を入力寸法とします。sized rows を結果のリストとします。

  5. 表面を w×h の矩形グリッドに分割します。ここで、w は sized cols リストのエントリ数、h は sized rows リストのエントリ数です。

    グリッド内の各列の幅を、対応する sized cols リストのエントリの値に応じた CSS ピクセル 単位に設定します。

    グリッド内の各行の高さを、対応する sized rows リストのエントリの値に応じた CSS ピクセル 単位に設定します。

  6. children を、このアルゴリズムが呼び出された frameset 要素の 子要素 である frame 要素と frameset 要素のリストに設定します。

  7. グリッドの各行について、上から下に向かって以下のサブステップを実行します。

    1. 各行の矩形について、左から右に向かって以下のサブステップを実行します。

      1. children にエレメントが残っている場合、そのリストの最初のエレメントを取り出し、その矩形に割り当てます。

        これが frameset 要素である場合、その矩形を表面として、その frameset 要素のレイアウトアルゴリズム全体を再帰的に実行します。

        それ以外の場合、それは frame 要素であり、ナビゲート可能なコンテンツ を、その矩形にフィットするように位置を決めてサイズを調整してレンダリングします。

      2. children にエレメントが残っている場合、children の最初のエレメントを削除します。

  8. frameset 要素が ボーダーを持つ 場合、要素の フレームボーダーの色 を使用して、矩形の外側に一連のボーダーを描画します。

    各矩形について、そこに要素が割り当てられている場合、その要素が ボーダーを持つ 場合、その矩形の内側に一連のボーダーを描画し、その要素の フレームボーダーの色 を使用します。

    （表示される）ボーダーが、frame 要素の noresize 属性が設定された矩形（ネストされた frameset 要素内の矩形も含む）に隣接していない場合、ユーザーエージェントはそのボーダーを移動させ、矩形内の矩形をリサイズできるようにすることが期待されます。また、ネストされた frameset グリッドの比率を維持します。

    frameset または frame 要素が ボーダーを持つ のは、次のアルゴリズムが true を返す場合です。

    1. 要素が frameborder 属性を持ち、その値が空文字列ではなく、最初の文字が U+0031 DIGIT ONE (1) 文字、U+0079 LATIN SMALL LETTER Y 文字 (y)、または U+0059 LATIN CAPITAL LETTER Y 文字 (Y) のいずれかである場合、true を返します。

    2. それ以外の場合、要素が frameborder 属性を持っている場合、false を返します。

    3. それ以外の場合、要素が親要素として frameset 要素を持つ場合、その要素が ボーダーを持つ 場合は true を返し、そうでない場合は false を返します。

    4. それ以外の場合、true を返します。

    frameset または frame 要素の フレームボーダーの色 は、次のアルゴリズムから取得された色です。

    1. 要素に bordercolor 属性があり、その属性の値にレガシーカラー値を解析するためのルールを適用しても失敗が返されない場合、取得した色を返します。

    2. それ以外の場合で、要素の親要素が frameset 要素である場合、その要素のフレーム境界色を返します。

    3. それ以外の場合、灰色を返します。

寸法リストをピクセル値のリストに変換する アルゴリズムは、以下の手順で構成されています。

  1. input list は、アルゴリズムに渡された数値と単位のリストです。

    output list は、input list と同じ長さで、すべてゼロの数値リストです。

    output list のエントリは、input list の同じ位置のエントリに対応します。

  2. input dimension は、アルゴリズムに渡されたサイズです。

  3. total percentage は、input list の中で単位が パーセンテージ であるすべての数値の合計です。

    total relative は、input list の中で単位が 相対 であるすべての数値の合計です。

    total absolute は、input list の中で単位が 絶対 であるすべての数値の合計です。

    remaining space は、input dimension の値です。

  4. total absolute が remaining space を超える場合、input list の中で単位が 絶対 であるエントリごとに、input list のエントリの数値を remaining space に掛けて total absolute で割った値を output list に設定します。そして、remaining space をゼロに設定します。

    それ以外の場合、input list の中で単位が 絶対 であるエントリごとに、input list のエントリの数値を output list に設定します。その後、remaining space を total absolute で減らします。

  5. total percentage を input dimension に掛けて 100 で割った値が remaining space を超える場合、input list の中で単位が パーセンテージ であるエントリごとに、input list のエントリの数値を remaining space に掛けて total percentage で割った値を output list に設定します。そして、remaining space をゼロに設定します。

    それ以外の場合、input list の中で単位が パーセンテージ であるエントリごとに、input list のエントリの数値を input dimension に掛けて 100 で割った値を output list に設定します。その後、remaining space を total percentage を掛けて input dimension で 100 で割った値で減らします。

  6. input list の中で単位が 相対 であるエントリごとに、remaining space に掛けて total relative で割った値を output list に設定します。

  7. output list を返します。

フレーム幅の整数値で作業するユーザーエージェント（サブピクセル精度でフレームをレイアウトできるユーザーエージェントとは対照的に）は、余剰分を最初に単位が 相対 の最後のエントリに配分し、次に単位が パーセンテージ の各エントリに等しく（比例的ではなく）配分し、次に単位が 絶対 の各エントリに等しく（比例的ではなく）配分し、それでも不十分な場合は最後のエントリに配分することが期待されます。

親要素として frameset を持たない frame 要素の内容は、透明な黒 としてレンダリングされることが期待され、その場合、ユーザーエージェントはその ナビゲート可能なコンテンツ をレンダリングしないことが期待されます。また、その ナビゲート可能なコンテンツ が幅ゼロ、高さゼロの ビューポート を持つことが期待されます。

15.7 インタラクティブメディア

15.7.1 リンク、フォーム、ナビゲーション

ユーザーエージェントは、ハイパーリンクのアクティベーションやフォームの送信など、どのナビゲーブルが次のナビゲーションに使用されるかといった側面を、ユーザーが制御できるようにすることが期待されます。

ユーザーエージェントは、ハイパーリンクやフォームの目的地をナビゲーションを実行する前にユーザーが確認できるようにすることが期待されます。

ユーザーエージェントは、ハイパーリンクにハイパーリンク監査が含まれているかどうかをユーザーに知らせ、最低でもその監査の一環としてどのドメインが接触されるかを通知することが期待されます。

ユーザーエージェントは、ナビゲートして、ナビゲーブルをcite属性が示すURLにナビゲートさせることができる場合があります。対象は、q、blockquote、ins、およびdel要素です。

ユーザーエージェントは、link要素によって作成されたハイパーリンクを、そのユーザーインターフェースに表示することがあるかもしれません。これは以前に説明されたようにです。

15.7.2 title属性

ユーザーエージェントは、ユーザーの要求に応じて要素の補足情報を表示し、その情報の存在をユーザーに知らせることが期待されます。

ユーザーがポインティングデバイスを使用できるインタラクティブグラフィカルシステムでは、ツールチップの形式で表示されることがあります。ユーザーがポインティングデバイスを使用できない場合、ユーザーエージェントは、例えば、要素をフォーカス可能領域にし、現在フォーカスされている要素の補足情報を常に表示するか、タッチデバイスではユーザーが画面をパンしている間に指の下にある要素の補足情報を表示するなど、他の方法でコンテンツを利用可能にすることが期待されます。

U+000A 改行(LF)文字はツールチップで改行を引き起こすことが期待されます。U+0009 水平タブ(tab)文字は、次のタブストップと次のグリフが一致するように、非ゼロの水平シフトとして表示されることが期待され、タブストップはU+0020 スペース文字の幅の8倍のポイントで発生します。

例えば、視覚的なユーザーエージェントは、title属性を持つ要素をフォーカス可能にし、title属性を持つフォーカスされた要素がフォーカスされている間、そのツールチップを要素の下に表示することができます。これにより、ユーザーはドキュメント内をタブで移動して、すべての補足テキストを見つけることができます。

別の例として、スクリーンリーダーは、ツールチップを持つ要素を読み上げる際にオーディオキューを提供し、そのキューが再生された最後のツールチップを読み上げるためのキーを関連付けることができます。

15.7.3 編集ホスト

現在のテキスト編集カーソル（つまり、アクティブ範囲、それが空であり、編集ホスト内にある場合）は、CSSレンダリングモデルの目的において、カーソルの垂直方向の寸法と幅ゼロのインライン置換要素のように動作することが期待されます。

これは、空のブロックであってもその中にカーソルを配置できることを意味し、その要素内にカーソルがある場合、それはマージンが要素を通じて折りたたまれるのを防ぐことを意味します。

15.7.4 ネイティブユーザーインターフェースにレンダリングされるテキスト

ユーザーエージェントは、ユーザーインターフェースに表示されるテキストのUnicodeセマンティクスを尊重することが期待されます。例えば、ダイアログ、タイトルバー、ポップアップメニュー、ツールチップに表示されるテキストで双方向アルゴリズムをサポートすることです。要素のコンテンツから取得されたテキストは、そのテキストが取得された要素の方向性を尊重してレンダリングされることが期待されます。属性から取得されたテキストは、その属性の方向性を尊重してレンダリングされることが期待されます。

次のマークアップを考えてみましょう。ヘブライ語のテキストでプログラミング言語を選択するように要求しており、いくつかの言語名に含まれる句読点を考慮すると、左から右への方向が重要です。

<p dir="rtl" lang="he">
  <label>
   בחר שפת תכנות:
   <select>
    <option dir="ltr">C++</option>
    <option dir="ltr">C#</option>
    <option dir="ltr">FreePascal</option>
    <option dir="ltr">F#</option>
   </select>
  </label>
 </p>

もしselect要素がドロップダウンボックスとしてレンダリングされた場合、正しいレンダリングでは、ドロップダウン内でも、現在の選択が表示されるボックス内でも句読点が同じになることを保証します。

属性の方向性は属性や要素のdir属性に依存しますが、次の例で示すように結果は異なります。このマークアップを考えてみましょう。 

<table>
  <tr>
   <th abbr="(א" dir=ltr>A
   <th abbr="(א" dir=rtl>A
   <th abbr="(א" dir=auto>A
 </table>

もしabbr属性が、例えばツールチップや他のユーザーインターフェースに表示された場合、最初のものは左括弧（方向が 'ltr' のため）、2番目のものは右括弧（方向が 'rtl' のため）、3番目のものは右括弧（属性値から判断された方向が 'rtl' のため）を持つことになります。

しかし、もし属性が方向性対応属性ではなかった場合、結果は異なります。 

<table>
  <tr>
   <th data-abbr="(א" dir=ltr>A
   <th data-abbr="(א" dir=rtl>A
   <th data-abbr="(א" dir=auto>A
 </table>

この場合、もしユーザーエージェントがdata-abbr属性をユーザーインターフェース（例えばデバッグ環境）に表示する場合、最後のケースは要素の内容から判断されて左括弧で表示されることになります。

スクリプトによって提供される文字列（例えば、window.alert()の引数）は、表示時に、双方向アルゴリズムによって定義された通りに、1つ以上の双方向アルゴリズム段落の独立したセットとして扱われることが期待されます。これには、例えば、U+000A 改行(LF)文字の段落分割の動作が含まれます。このテキストの双方向アルゴリズムにおける段落レベルを決定する目的で、この仕様書は規則P2およびP3の上位レベルのオーバーライドを提供しません。[BIDI]

必要に応じて、著者は特定の段落に特定の方向性を強制するために、Unicode U+200E 左から右のマークまたはU+200F 右から左のマーク文字を使用して段落を開始することができます。

したがって、次のスクリプト：

alert('\u05DC\u05DE\u05D3 HTML \u05D4\u05D9\u05D5\u05DD!')

...は常に、メッセージ"למד LMTH היום!"が表示されます（"דמל HTML םויה!"ではありません）。これは、ユーザーエージェントのインターフェースの言語やページやその要素の方向性に関係なく行われます。

より複雑な例として、次のスクリプトを考えてみましょう。

/* 注意: このスクリプトは右から左へのスクリプトを正しく処理しません */
 var s;
 if (s = prompt('お名前は何ですか？')) {
   alert(s + '! Ok, Fred, ' + s + ', そしてWilmaが車を持ってきます。');
 }

ユーザーが「Kitty」と入力した場合、ユーザーエージェントは「Kitty! Ok, Fred, Kitty, and Wilma will get the car.」とアラートを表示します。しかし、ユーザーが「لا أفهم」と入力した場合、双方向アルゴリズムにより段落の方向が右から左と判断され、次のような予期しない混乱が生じます。「لا أفهم! derF ,kO, لا أفهم, rac eht teg lliw amliW dna.」

ユーザー提供のテキスト（または方向性が不明なその他のテキスト）で始まるアラートを左から右に強制するには、文字列の前にU+200E 左から右のマーク文字を追加することができます。

var s;
 if (s = prompt('お名前は何ですか？')) {
   alert('\u200E' + s + '! Ok, Fred, ' + s + ', そしてWilmaが車を持ってきます。');
 }

ユーザーエージェントは、ユーザーが物理的な形態（または物理的な形態の表現）をドキュメントで取得する機会を要求できるようにすることが期待されます。例えば、ページを印刷するオプションを選択したり、PDF形式に変換したりする場合です。[PDF]

ユーザーが実際に物理的な形式を取得する（または物理的な形式の表現を取得する）場合、ドキュメントの、ユーザーエージェントは印刷メディア用にドキュメントの新しいレンダリングを作成することが期待されます。

15.9 スタイルなしXMLドキュメント

HTMLユーザーエージェントは、特定の状況で、内部知識を持たない語彙を使用する非HTMLドキュメントをレンダリングすることがあるかもしれません。このセクションは、ユーザーエージェントがそのようなドキュメントをある程度有用な方法で処理する方法を提供します。

ドキュメントがスタイルなしドキュメントである間、ユーザーエージェントはスタイルなしドキュメントビューをレンダリングすることが期待されます。

ドキュメントがスタイルなしドキュメントであるのは、以下の条件に該当する場合です。

スタイルなしドキュメントビューとは、CSSに従ってDOMがレンダリングされないビューのことです（このコンテキストでは適用されるスタイルがないため、単にテキストの壁になってしまうでしょう）。その代わりに、開発者にとって有用な方法でレンダリングされます。これには、ドキュメントオブジェクトのソースを表示するだけでなく、シンタックスハイライトを行ったり、DOMツリーを表示するだけであったり、ページがスタイルなしドキュメントであるというメッセージを表示したりすることが含まれます。

ドキュメントがスタイルなしドキュメントでなくなった場合、上記の条件は適用されなくなります。したがって、これらの要件に従うユーザーエージェントは、通常のCSSレンダリングを使用するように切り替えます。

16 廃止された機能

16.1 廃止されたが適合する機能

このセクションに記載されている機能は、適合性チェッカーで警告を引き起こします。

著者は、border属性を img要素に指定しては なりません。属性が存在する場合、その値は"0"でなければなりません。代わりにCSSを使用すべきです。

著者は、charset 属性をscript 要素に指定してはなりません。属性が存在する場合、その値は"utf-8"と ASCII case-insensitiveに一致しなければなりません。（この標準の他の場所で要求されている要件に適合する文書では、これには効果がありません）。

著者は、language 属性をscript 要素に指定してはなりません。属性が存在する場合、その値は"JavaScript"と ASCII case-insensitiveに一致し、type 属性が省略されるか、その値が"text/javascript"と ASCII case-insensitiveに一致しなければなりません。代わりに属性全体を省略すべきです（"JavaScript"の値は効果がないため）。 またはtype 属性を使用して置き換えるべきです。

著者は、type 属性に空文字列やscript要素に指定してはなりません。 代わりに、この属性を省略すべきです。

著者は、type 属性をstyle要素に指定してはなりません。 属性が存在する場合、その値は"text/css"と ASCII case-insensitiveに一致しなければなりません。

著者は、name 属性をa要素に指定してはなりません。 属性が存在する場合、その値は空文字列であってはならず、要素の IDs の値と一致してはなりません。また、ツリー内の他のname 属性の値とも一致してはなりません。 属性が存在し、要素に ID がある場合、属性の値は要素の ID と一致しなければなりません。 この言語の以前のバージョンでは、この属性は フラグメント を指定する方法として意図されていました。代わりに id 属性を使用すべきです。

著者は、この仕様の他の箇所で要求されているにもかかわらず、 maxlength およびsize 属性をinput 要素のtype属性が Number状態にある場合、指定してはなりません。 これらの属性を使用する有効な理由の一つとして、 input 要素がtype="number"を持たないレガシーユーザーエージェントに対して、役立つ幅でテキストコントロールを表示するために使用される場合があります。

16.1.1 廃止されたが適合する機能に対する警告

HTML4トランジショナル文書からこの仕様で定義される言語への移行を容易にし、非常に限られた状況でのみ許可される機能を思いとどまらせるために、適合性チェッカーは、以下の機能が文書で使用された場合にユーザーに警告を発する必要があります。これらは一般的に効果がない古い廃止された機能であり、単なる誤り（通常の適合性エラー）と、単なる名残のマークアップまたは不推奨の実践（これらの警告）を区別するためにのみ許可されています。

以下の機能は上記のように分類されなければなりません:

適合性チェッカーは、適合エラーがなく、これらの廃止された機能が含まれていないページと、適合エラーがなく、いくつかの廃止された機能が含まれているページを区別しなければなりません。

例えば、バリデーターは一部のページを"有効なHTML"として報告し、他のページを"警告付きの有効なHTML"として報告することができます。

16.2 非適合機能

以下のリストにある要素は完全に廃止されており、著者は使用してはなりません:

applet

代わりにembedまたはobjectを使用します。

acronym

代わりにabbrを使用します。

bgsound

代わりにaudioを使用します。

dir

代わりにulを使用します。

frame
frameset
noframes

代わりにiframeとCSSを使用するか、サーバーサイドインクルードを使用して、さまざまな不変部分を統合した完全なページを生成します。

isindex

代わりにformとtext controlの組み合わせを使用します。

keygen

エンタープライズデバイス管理のユースケースでは、ネイティブのデバイス管理機能を使用します。

証明書登録のユースケースでは、Web Cryptography APIを使用して証明書のためのキーペアを生成し、その後証明書とキーをエクスポートして、ユーザーが手動でインストールできるようにします。[WEBCRYPTO]

listing

代わりにpreとcodeを使用します。

menuitem

カスタムコンテキストメニューを実装するには、contextmenuイベントを処理するスクリプトを使用します。

nextid

代わりにGUIDを使用します。

noembed

フォールバックが必要な場合は、objectを使用し、embedを避けます。

param

代わりにdata属性を使用して、object要素に外部リソースのURLを設定します。

plaintext

代わりに"text/plain"MIMEタイプを使用します。

rb
rtc

ruby要素の中に直接ルビーベースを提供するか、ネストされたruby要素を使用することで十分です。

strike

編集をマークしている場合はdelを使用し、それ以外の場合はsを使用します。

xmp

代わりにpreとcodeを使用し、"<"や"&"文字をそれぞれ"&lt;"や"&amp;"としてエスケープします。

basefont
big
blink
center
font
marquee
multicol
nobr
spacer
tt

代わりに適切な要素やCSSを使用します。

tt要素がキーボード入力をマークアップするために使用される場合は、kbd要素を検討します。変数の場合はvar要素を検討し、コンピュータコードの場合はcode要素を検討し、コンピュータ出力の場合はsamp要素を検討します。

同様に、big要素が見出しを示すために使用されている場合は、h1要素を検討し、重要な部分をマークアップするために使用されている場合は、strong要素を検討し、参照のためにテキストを強調するために使用されている場合は、mark要素を検討します。

他の提案や例については、テキストレベルの意味論使用の概要も参照してください。

以下の属性は廃止されていますが、要素はまだ言語の一部であり、著者は使用してはなりません:

charset がa要素に使用されています
charset がlink要素に使用されています

代わりにリンクされたリソースのHTTP `Content-Type` ヘッダーを使用します。

charset がscript要素に使用されています（前のセクションで述べた例外を除く）

属性を省略します。ドキュメントとスクリプトはどちらもUTF-8を使用する必要があるため、script要素に指定するのは冗長であり、ドキュメントから継承されます。

coords がa要素に使用されています
shape がa要素に使用されています

イメージマップにはarea要素を使用します。

methods がa要素に使用されています
methods がlink要素に使用されています

代わりにHTTP OPTIONS機能を使用します。

name がa要素に使用されています（前のセクションで述べた例外を除く）
name がembed要素に使用されています
name がimg要素に使用されています
name がoption要素に使用されています

代わりにid属性を使用します。

rev がa要素に使用されています
rev がlink要素に使用されています

代わりにrel属性を使用し、反対の用語を使用します。（例: rev="made"の代わりにrel="author"を使用します。）

urn がa要素に使用されています
urn がlink要素に使用されています

代わりにhref属性を使用して、推奨される永続的な識別子を指定します。

accept がform要素に使用されています

代わりにaccept属性をinput要素に直接使用します。

hreflang がarea要素に使用されています
type がarea要素に使用されています

これらの属性は役に立たず、歴史的な理由から、area要素に対応するIDL属性はありません。それらを完全に省略します。

nohref がarea要素に使用されています

href属性を省略するだけで十分であり、nohref属性は不要です。それを完全に省略します。

profile がhead要素に使用されています

不要です。それを完全に省略します。

manifest がhtml要素に使用されています

代わりにサービスワーカーを使用します。[SW]

version がhtml要素に使用されています

不要です。それを完全に省略します。

ismap がinput要素に使用されています

不要です。それを完全に省略します。すべてのinput要素は、type属性がImage Button状態にある場合、サーバーサイドのイメージマップとして処理されます。

usemap がinput要素に使用されています
usemap がobject要素に使用されています

イメージマップにはimg要素を使用します。

longdesc がiframe要素に使用されています
longdesc がimg要素に使用されています

説明へのリンクを提供するために、通常のa要素を使用するか、（画像の場合は）イメージマップを使用して、画像からその説明へのリンクを提供します。

lowsrc がimg要素に使用されています

2つの別々の画像を使用する代わりに、進行的なJPEG画像（src属性で指定）を使用します。

target がlink要素に使用されています

不要です。それを完全に省略します。

type がmenu要素に使用されています

カスタムコンテキストメニューを実装するには、contextmenuイベントを処理するスクリプトを使用します。ツールバーメニューの場合は、この属性を省略します。

label がmenu要素に使用されています
contextmenuがすべての要素に使用されています
onshowがすべての要素に使用されています

カスタムコンテキストメニューを実装するには、contextmenuイベントを処理するスクリプトを使用します。

scheme がmeta要素に使用されています

フィールドごとに1つのスキームのみを使用するか、スキームの宣言を値の一部にします。

archive がobject要素に使用されています
classid がobject要素に使用されています
code がobject要素に使用されています
codebase がobject要素に使用されています
codetype がobject要素に使用されています

プラグインを呼び出すには、data属性とtype属性を使用します。

declare がobject要素に使用されています

リソースを再利用するたびにobject要素を完全に繰り返します。

standby がobject要素に使用されています

リンクされたリソースを最適化して、高速または少なくとも段階的に読み込めるようにします。

typemustmatch がobject要素に使用されています

信頼できないリソースを使用するobject要素の使用は避けます。

language がscript要素に使用されています（前のセクションで述べた例外を除く）

JavaScriptの場合は属性を省略し、データブロックの場合はtype属性を使用します。

event がscript要素に使用されています
for がscript要素に使用されています

DOMイベントのメカニズムを使用して、イベントリスナーを登録します。[DOM]

type がstyle要素に使用されています（前のセクションで述べた例外を除く）

CSSの場合は属性を省略し、データブロックにはscriptをコンテナとして使用し、styleの代わりに使用します。

datapagesize がtable要素に使用されています

不要です。それを完全に省略します。

summary がtable要素に使用されています

代わりに、このtableセクションで示されるテーブルの記述技法の1つを使用します。

abbr がtd要素に使用されています

曖昧でなく簡潔な方法で始まるテキストを使用し、その後により詳細なテキストを含めます。title属性も、セルの内容を簡潔にするために、より詳細なテキストを含めるのに役立ちます。それが見出しである場合は、th（これにはabbr属性があります）を使用します。

axis がtdおよびth要素に使用されています

該当するscope属性を該当するth要素に使用します。

scope がtd要素に使用されています

見出しセルにはth要素を使用します。

datasrc がa、button、div、frame、iframe、img、input、label、legend、marquee、object、option、select、span、table、およびtextarea要素に使用されています
datafld がa、button、div、fieldset、frame、iframe、img、input、label、legend、marquee、object、select、span、およびtextarea要素に使用されています
dataformatas がbutton、div、input、label、legend、marquee、object、option、select、span、およびtable要素に使用されています

スクリプトとXMLHttpRequestなどのメカニズムを使用して、ページを動的に構成します。[XHR]

dropzone がすべての要素に使用されています

dragenterおよびdragoverイベントを処理するスクリプトを使用します。

alink がbody要素に使用されています
bgcolor がbody要素に使用されています
bottommargin がbody要素に使用されています
leftmargin がbody要素に使用されています
link がbody要素に使用されています
marginheight がbody要素に使用されています
marginwidth がbody要素に使用されています
rightmargin がbody要素に使用されています
text がbody要素に使用されています
topmargin がbody要素に使用されています
vlink がbody要素に使用されています
clear がbr要素に使用されています
align がcaption要素に使用されています
align がcol要素に使用されています
char がcol要素に使用されています
charoff がcol要素に使用されています
valign がcol要素に使用されています
width がcol要素に使用されています
align がdiv要素に使用されています
compact がdl要素に使用されています
align がembed要素に使用されています
hspace がembed要素に使用されています
vspace がembed要素に使用されています
align がhr要素に使用されています
color がhr要素に使用されています
noshade がhr要素に使用されています
size がhr要素に使用されています
width がhr要素に使用されています
align がh1—h6要素に使用されています
align がiframe要素に使用されています
allowtransparency がiframe要素に使用されています
frameborder がiframe要素に使用されています
framespacing がiframe要素に使用されています
hspace がiframe要素に使用されています
marginheight がiframe要素に使用されています
marginwidth がiframe要素に使用されています
scrolling がiframe要素に使用されています
vspace がiframe要素に使用されています
align がinput要素に使用されています
border がinput要素に使用されています
hspace がinput要素に使用されています
vspace がinput要素に使用されています
align がimg要素に使用されています
border がimg要素に使用されています（前のセクションで述べた例外を除く）
hspace がimg要素に使用されています
vspace がimg要素に使用されています
align がlegend要素に使用されています
type がli要素に使用されています
compact がmenu要素に使用されています
align がobject要素に使用されています
border がobject要素に使用されています
hspace がobject要素に使用されています
vspace がobject要素に使用されています
compact がol要素に使用されています
align がp要素に使用されています
width がpre要素に使用されています
align がtable要素に使用されています
bgcolor がtable要素に使用されています
border がtable要素に使用されています
bordercolor がtable要素に使用されています
cellpadding がtable要素に使用されています
cellspacing がtable要素に使用されています
frame がtable要素に使用されています
height がtable要素に使用されています
rules がtable要素に使用されています
width がtable要素に使用されています
align がtbody、thead、およびtfoot要素に使用されています
char がtbody、thead、およびtfoot要素に使用されています
charoff がtbody、thead、およびtfoot要素に使用されています
height がthead、tbody、およびtfoot要素に使用されています
valign がtbody、thead、およびtfoot要素に使用されています
align がtdおよびth要素に使用されています
bgcolor がtdおよびth要素に使用されています
char がtdおよびth要素に使用されています
charoff がtdおよびth要素に使用されています
height がtdおよびth要素に使用されています
nowrap がtdおよびth要素に使用されています
valign がtdおよびth要素に使用されています
width がtdおよびth要素に使用されています
align がtr要素に使用されています
bgcolor がtr要素に使用されています
char がtr要素に使用されています
charoff がtr要素に使用されています
height がtr要素に使用されています
valign がtr要素に使用されています
compact がul要素に使用されています
type がul要素に使用されています
background がbody、table、thead、tbody、tfoot、tr、td、およびth要素に使用されています

代わりにCSSを使用します。

16.3 実装の要件

16.3.1 marquee 要素

marquee 要素は、コンテンツをアニメーション化するためのプレゼンテーション要素です。CSSトランジションとアニメーションの方が適切なメカニズムです。[CSSANIMATIONS] [CSSTRANSITIONS]

marquee 要素は、HTMLMarqueeElement インターフェースを実装する必要があります。

[Exposed=Window]
 interface HTMLMarqueeElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString behavior;
   [CEReactions] attribute DOMString bgColor;
   [CEReactions] attribute DOMString direction;
   [CEReactions] attribute DOMString height;
   [CEReactions] attribute unsigned long hspace;
   [CEReactions] attribute long loop;
   [CEReactions] attribute unsigned long scrollAmount;
   [CEReactions] attribute unsigned long scrollDelay;
   [CEReactions] attribute boolean trueSpeed;
   [CEReactions] attribute unsigned long vspace;
   [CEReactions] attribute DOMString width;
 
   undefined start();
   undefined stop();
 };

marquee 要素は、オンまたはオフにすることができます。作成されると、オンになります。

start() メソッドが呼び出されると、marquee 要素はオンにする必要があります。

stop() メソッドが呼び出されると、marquee 要素はオフにする必要があります。

behavior コンテンツ属性は、marquee 要素における列挙属性であり、次のキーワードと状態を持ちます（すべて非準拠）：

キーワード 状態
scroll scroll
slide slide
alternate alternate

この属性の欠損値デフォルトおよび無効値デフォルトはどちらもscroll状態です。

direction コンテンツ属性は、marquee 要素における列挙属性であり、次のキーワードと状態を持ちます（すべて非準拠）：

キーワード 状態
left left
right right
up up
down down

この属性の欠損値デフォルトおよび無効値デフォルトはどちらもleft状態です。

truespeed コンテンツ属性は、marquee 要素におけるブール属性です。

marquee 要素には マルキースクロール間隔 があり、次のように取得されます：

  1. 要素に scrolldelay 属性があり、その値を非負整数の解析ルールを使用して解析し、エラーが発生しない場合は、delayを解析された値に設定します。そうでない場合は、delayを85に設定します。

  2. 要素に truespeed 属性がない場合、かつdelay値が60未満である場合は、代わりにdelayを60に設定します。

  3. マルキースクロール間隔はdelayであり、ミリ秒で解釈されます。

marquee 要素には マルキースクロール距離 があり、要素に scrollamount 属性があり、その値を非負整数の解析ルールを使用して解析し、エラーが発生しない場合は、その値をCSSピクセル単位で解釈します。そうでない場合は6CSSピクセルです。

marquee 要素には マルキーのループカウント があり、要素にloop 属性があり、その値を整数の解析ルールを使用して解析し、エラーや1未満の数値が返されない場合は、その値が設定されます。そうでない場合は-1になります。

loop IDL属性は、取得時に要素のマルキーのループカウントを返す必要があります。また、設定時に新しい値が要素のマルキーのループカウントと異なり、新しい値が0より大きいか、または-1と等しい場合、loopコンテンツ属性を（必要に応じて追加して）新しい値を表す有効な整数に設定する必要があります。（他の値は無視されます。）

marquee 要素には、作成時にゼロであるマルキーの現在のループインデックスもあります。

レンダリングレイヤーは、時折マルキーの現在のループインデックスを増加させることがあり、これにより次の手順が実行される必要があります：

  1. もしマルキーのループカウントが-1であれば、リターンします。

  2. マルキーの現在のループインデックスを1つ増加させます。

  3. もしマルキーの現在のループインデックスが要素のマルキーのループカウント以上になった場合、marquee 要素をオフにします。

behavior、direction、height、hspace、vspace、およびwidth IDL属性は、それぞれ同じ名前のコンテンツ属性を反映する必要があります。

bgColor IDL属性は、bgcolor コンテンツ属性を反映する必要があります。

scrollAmount IDL属性は、scrollamountコンテンツ属性を反映する必要があります。デフォルト値は6です。

scrollDelay IDL属性は、scrolldelay コンテンツ属性を反映する必要があります。デフォルト値は85です。

trueSpeed IDL属性は、truespeed コンテンツ属性を反映する必要があります。

16.3.2 フレーム

frameset 要素は、フレームを使用する文書においてbody 要素として機能します。

frameset 要素はHTMLFrameSetElement インターフェイスを実装する必要があります。

[Exposed=Window]
 interface HTMLFrameSetElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString cols;
   [CEReactions] attribute DOMString rows;
 };
 HTMLFrameSetElement includes WindowEventHandlers;

colsおよびrowsIDL属性は、frameset要素の同名のコンテンツ属性を反映する必要があります。

frameset要素は、イベントハンドラコンテンツ属性として、Windowオブジェクトのイベントハンドラのいくつかを公開します。また、それらのイベントハンドラIDL属性をミラーリングします。

WindowオブジェクトのWindow-反映ボディ要素イベントハンドラセットによって名付けられたイベントハンドラは、frameset要素で公開され、HTML要素が通常サポートする同名の汎用的なイベントハンドラを置き換えます。

frame要素は、iframe要素に類似したナビゲート可能なコンテンツを持ちますが、frameset要素内にレンダリングされます。

frameのHTML要素挿入手順は、insertedNodeが与えられた場合、以下の通りです:

  1. insertedNodeが文書ツリー内にない場合は、戻ります。

  2. insertedNodeのルートのブラウジングコンテキストがnullの場合、戻ります。

  3. insertedNodeのために新しい子ナビゲーション可能な要素を作成します。

  4. initialInsertionがtrueに設定された状態で、insertedNodeのframe属性を処理します。

frameのHTML要素削除手順は、removedNodeが与えられた場合、removedNodeを使って子ナビゲーション可能な要素を破壊することです。

nullでないナビゲート可能なコンテンツを持つframe要素において、そのsrc属性が設定、変更、または削除されるたびに、ユーザーエージェントはframe属性を処理する必要があります。

elementに対して、オプションのブール値initialInsertionを使用して、要素のframe属性を処理するために:

  1. elementに与えられたiframeおよびframe要素の共通属性処理手順を実行し、その結果urlを取得します。

  2. urlがnullの場合、戻ります。

  3. urlがabout:blankと一致し、initialInsertionがtrueの場合、以下を行います:

    1. elementでloadという名前のイベントを発生させます。

    2. 戻ります。

  4. element、url、空文字列、および initialInsertion を指定して、iframe または frame をナビゲートします。

frame要素はロードイベントを遅延させる可能性があります。

frame要素はHTMLFrameElementインターフェイスを実装する必要があります。

[Exposed=Window]
 interface HTMLFrameElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute DOMString scrolling;
   [CEReactions] attribute USVString src;
   [CEReactions] attribute DOMString frameBorder;
   [CEReactions] attribute USVString longDesc;
   [CEReactions] attribute boolean noResize;
   readonly attribute Document? contentDocument;
   readonly attribute WindowProxy? contentWindow;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString marginHeight;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString marginWidth;
 };

name、scrolling、およびsrcIDL属性は、frame要素の同名のコンテンツ属性を反映する必要があります。反映の目的において、frame要素のsrcコンテンツ属性はURLを含むものとして定義されます。

frameBorderIDL属性は、frame要素のframeborderコンテンツ属性を反映する必要があります。

longDescIDL属性は、frame要素のlongdescコンテンツ属性を反映する必要があります。この反映の目的において、longdescコンテンツ属性はURLを含むものとして定義されます。

noResizeIDL属性は、frame要素のnoresizeコンテンツ属性を反映する必要があります。

marginHeightIDL属性は、frame要素のmarginheightコンテンツ属性を反映する必要があります。

marginWidthIDL属性は、frame要素のmarginwidthコンテンツ属性を反映する必要があります。

contentDocumentゲッターステップは、thisのコンテンツ文書を返すことです。

contentWindowゲッターステップは、thisのコンテンツウィンドウを返すことです。

16.3.3 その他の要素、属性、API

ユーザーエージェントは、acronym要素を、セマンティクスとレンダリングの目的でabbr要素と同等に扱う必要があります。 

partial interface HTMLAnchorElement {
   [CEReactions] attribute DOMString coords;
   [CEReactions] attribute DOMString charset;
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute DOMString rev;
   [CEReactions] attribute DOMString shape;
 };

coords、charset、name、rev、およびshapeIDL属性は、a要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLAreaElement {
   [CEReactions] attribute boolean noHref;
 };

noHrefIDL属性は、area要素のnohrefコンテンツ属性を反映する必要があります。

partial interface HTMLBodyElement {
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString text;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString link;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString vLink;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString aLink;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString bgColor;
   [CEReactions] attribute DOMString background;
 };

textIDL属性は、body要素のtextコンテンツ属性を反映する必要があります。

linkIDL属性は、body要素のlinkコンテンツ属性を反映する必要があります。

aLinkIDL属性は、body要素のalinkコンテンツ属性を反映する必要があります。

vLinkIDL属性は、body要素のvlinkコンテンツ属性を反映する必要があります。

bgColorIDL属性は、body要素のbgcolorコンテンツ属性を反映する必要があります。

backgroundIDL属性は、body要素のbackgroundコンテンツ属性を反映する必要があります。(上記のRenderingセクションにおける処理に関するルールにもかかわらず、backgroundのコンテンツはURLを含むものとして定義されていません。) 

partial interface HTMLBRElement {
   [CEReactions] attribute DOMString clear;
 };

clearIDL属性は、br要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLTableCaptionElement {
   [CEReactions] attribute DOMString align;
 };

alignIDL属性は、caption要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLTableColElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString ch;
   [CEReactions] attribute DOMString chOff;
   [CEReactions] attribute DOMString vAlign;
   [CEReactions] attribute DOMString width;
 };

alignおよびwidthIDL属性は、col要素のそれぞれの同名のコンテンツ属性を反映する必要があります。

chIDL属性は、col要素のcharコンテンツ属性を反映する必要があります。

chOffIDL属性は、col要素のcharoffコンテンツ属性を反映する必要があります。

vAlignIDL属性は、col要素のvalignコンテンツ属性を反映する必要があります。

ユーザーエージェントは、dir要素を、セマンティクスおよびレンダリングの目的で、ul要素と同等に扱う必要があります。

dir要素は、HTMLDirectoryElementインターフェイスを実装する必要があります。 

[Exposed=Window]
 interface HTMLDirectoryElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute boolean compact;
 };

compactIDL属性は、dir要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLDivElement {
   [CEReactions] attribute DOMString align;
 };

alignIDL属性は、div要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLDListElement {
   [CEReactions] attribute boolean compact;
 };

compactIDL属性は、dl要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLEmbedElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString name;
 };

nameおよびalignIDL属性は、embed要素のそれぞれの同名のコンテンツ属性を反映する必要があります。

font要素は、HTMLFontElementインターフェイスを実装する必要があります。 

[Exposed=Window]
 interface HTMLFontElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString color;
   [CEReactions] attribute DOMString face;
   [CEReactions] attribute DOMString size; 
 };

color、face、およびsizeIDL属性は、font要素のそれぞれの同名のコンテンツ属性を反映する必要があります。

partial interface HTMLHeadingElement {
   [CEReactions] attribute DOMString align;
 };

alignIDL属性は、h1–h6要素の同名のコンテンツ属性を反映する必要があります。

profileIDL属性は、head要素（HTMLHeadElementインターフェイスを持つ）に存在しません。他の適用される仕様によって要求されない限り、実装はこの属性をサポートしないでしょう。（これは、以前のバージョンのDOMで定義されていたため、ここで言及されています。） 

partial interface HTMLHRElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString color;
   [CEReactions] attribute boolean noShade;
   [CEReactions] attribute DOMString size;
   [CEReactions] attribute DOMString width;
 };

align、color、size、およびwidthIDL属性は、hr要素のそれぞれの同名のコンテンツ属性を反映する必要があります。

noShadeIDL属性は、hr要素のnoshadeコンテンツ属性を反映する必要があります。

partial interface HTMLHtmlElement {
   [CEReactions] attribute DOMString version;
 };

versionIDL属性は、html要素の同名のコンテンツ属性を反映する必要があります。

partial interface HTMLIFrameElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString scrolling;
   [CEReactions] attribute DOMString frameBorder;
   [CEReactions] attribute USVString longDesc;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString marginHeight;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString marginWidth;
 };

alignおよびscrollingIDL属性は、iframe要素のそれぞれの同名のコンテンツ属性を反映する必要があります。

frameBorderIDL属性は、iframe要素のframeborderコンテンツ属性を反映する必要があります。

longDescIDL属性は、iframe要素のlongdescコンテンツ属性を反映する必要があり、反映の目的でそれはURLを含んでいると定義されます。

marginHeightIDL属性は、iframe要素のmarginheightコンテンツ属性を反映する必要があります。

marginWidthIDL属性は、iframe要素のmarginwidthコンテンツ属性を反映する必要があります。

partial interface HTMLImageElement {
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute USVString lowsrc;
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute unsigned long hspace;
   [CEReactions] attribute unsigned long vspace;
   [CEReactions] attribute USVString longDesc;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString border;
 };

img要素のname、align、border、hspace、およびvspaceIDL属性は、それぞれの同名のコンテンツ属性を反映する必要があります。

img要素のlongDescIDL属性は、要素のlongdescコンテンツ属性を反映する必要があります。これは、反映の目的でURLを含むと定義されます。

img要素のlowsrcIDL属性は、要素のlowsrcコンテンツ属性を反映する必要があります。これは、反映の目的でURLを含むと定義されます。

partial interface HTMLInputElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString useMap;
 };

input要素のalignIDL属性は、同名のコンテンツ属性を反映する必要があります。

input要素のuseMapIDL属性は、要素のusemapコンテンツ属性を反映する必要があります。

partial interface HTMLLegendElement {
   [CEReactions] attribute DOMString align;
 };

legend要素のalignIDL属性は、同名のコンテンツ属性を反映する必要があります。

partial interface HTMLLIElement {
   [CEReactions] attribute DOMString type;
 };

li要素のtypeIDL属性は、同名のコンテンツ属性を反映する必要があります。

partial interface HTMLLinkElement {
   [CEReactions] attribute DOMString charset;
   [CEReactions] attribute DOMString rev;
   [CEReactions] attribute DOMString target;
 };

link要素のcharset、rev、およびtargetIDL属性は、それぞれの同名のコンテンツ属性を反映する必要があります。

ユーザーエージェントは、listing要素を、セマンティクスおよびレンダリングの目的において、pre要素と同等に扱わなければなりません。 

partial interface HTMLMenuElement {
   [CEReactions] attribute boolean compact;
 };

menu要素のcompactIDL属性は、同名のコンテンツ属性を反映する必要があります。

partial interface HTMLMetaElement {
   [CEReactions] attribute DOMString scheme;
 };

ユーザーエージェントは、schemeコンテンツ属性を持つmeta要素を処理する際に、name属性の拡張として扱うことができます。これは、ユーザーエージェントがscheme属性をサポートすると認識するname属性の値に基づいて処理されます。

ユーザーエージェントはscheme属性を無視し、メタデータの名前に指定された値を、scheme属性の各予期された値に対して指定されたかのように処理することが推奨されます。

例えば、ユーザーエージェントが、値が「eGMS.subject.keyword」であるmeta要素のname属性を操作し、このメタデータ名にscheme属性が使用されていることを認識している場合、そのscheme属性を考慮し、name属性の拡張として扱うことができる。そのため、次の2つのmeta要素は、それぞれ異なるメタデータ名の値を提供する2つの要素として扱われる可能性がある。一つは「eGMS.subject.keyword」と「LGCL」の組み合わせ、もう一つは「eGMS.subject.keyword」と「ORLY」の組み合わせである: 

<!-- this markup is invalid -->
 <meta name="eGMS.subject.keyword" scheme="LGCL" content="Abandoned vehicles">
 <meta name="eGMS.subject.keyword" scheme="ORLY" content="Mah car: kthxbye">

ただし、このマークアップの推奨処理は、次のように等価になるでしょう:

<meta name="eGMS.subject.keyword" content="Abandoned vehicles">
 <meta name="eGMS.subject.keyword" content="Mah car: kthxbye">

scheme属性のIDL属性は、meta要素の同名のコンテンツ属性を反映しなければなりません。

partial interface HTMLObjectElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString archive;
   [CEReactions] attribute DOMString code;
   [CEReactions] attribute boolean declare;
   [CEReactions] attribute unsigned long hspace;
   [CEReactions] attribute DOMString standby;
   [CEReactions] attribute unsigned long vspace;
   [CEReactions] attribute DOMString codeBase;
   [CEReactions] attribute DOMString codeType;
   [CEReactions] attribute DOMString useMap;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString border;
 };

align、archive、border、code、declare、hspace、standbyおよびvspaceIDL属性は、object要素の同名のコンテンツ属性を反映しなければなりません。

codeBase属性のIDL属性は、object要素のcodebaseコンテンツ属性を反映しなければなりません。反映の目的としては、URLを含むと定義されます。

codeType属性のIDL属性は、object要素のcodetypeコンテンツ属性を反映しなければなりません。

HTMLObjectElement/useMap

Support in all current engines.

Firefox1+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer6+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

useMap属性のIDL属性は、usemapコンテンツ属性を反映しなければなりません。

partial interface HTMLOListElement {
   [CEReactions] attribute boolean compact;
 };

compact属性のIDL属性は、ol要素の同名のコンテンツ属性を反映しなければなりません。

partial interface HTMLParagraphElement {
   [CEReactions] attribute DOMString align;
 };

align属性のIDL属性は、p要素の同名のコンテンツ属性を反映しなければなりません。

param要素は、HTMLParamElementインターフェイスを実装しなければなりません。 

[Exposed=Window]
 interface HTMLParamElement : HTMLElement {
   [HTMLConstructor] constructor();
 
   [CEReactions] attribute DOMString name;
   [CEReactions] attribute DOMString value;
   [CEReactions] attribute DOMString type;
   [CEReactions] attribute DOMString valueType;
 };

name、value、typeのIDL属性は、param要素の同名のコンテンツ属性を反映しなければなりません。

valueTypeのIDL属性は、param要素のvaluetypeコンテンツ属性を反映しなければなりません。

ユーザーエージェントは、plaintext要素をpre要素と同様に扱い、セマンティクスおよびレンダリングの目的で使用する必要があります。（ただし、この要素に関してはパーサーが特別な動作を行います。） 

partial interface HTMLPreElement {
   [CEReactions] attribute long width;
 };

widthのIDL属性は、pre要素の同名のコンテンツ属性を反映しなければなりません。

partial interface HTMLStyleElement {
   [CEReactions] attribute DOMString type;
 };

typeのIDL属性は、style要素の同名のコンテンツ属性を反映しなければなりません。

partial interface HTMLScriptElement {
   [CEReactions] attribute DOMString charset;
   [CEReactions] attribute DOMString event;
   [CEReactions] attribute DOMString htmlFor;
 };

charsetおよびeventのIDL属性は、script要素の同名のコンテンツ属性を反映しなければなりません。

htmlForのIDL属性は、script要素のforコンテンツ属性を反映しなければなりません。

partial interface HTMLTableElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString border;
   [CEReactions] attribute DOMString frame;
   [CEReactions] attribute DOMString rules;
   [CEReactions] attribute DOMString summary;
   [CEReactions] attribute DOMString width;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString bgColor;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString cellPadding;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString cellSpacing;
 };

table 要素の align、border、frame、summary、rules、および width IDL 属性は、同じ名前のそれぞれのコンテンツ属性を反映する必要があります。

bgColorのIDL属性は、table要素のbgcolorコンテンツ属性を反映しなければなりません。

cellPaddingのIDL属性は、table要素のcellpaddingコンテンツ属性を反映しなければなりません。

cellSpacingのIDL属性は、table要素のcellspacingコンテンツ属性を反映しなければなりません。

partial interface HTMLTableSectionElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString ch;
   [CEReactions] attribute DOMString chOff;
   [CEReactions] attribute DOMString vAlign;
 };

alignのIDL属性は、tbody、thead、およびtfoot要素の同名のコンテンツ属性を反映しなければなりません。

chのIDL属性は、tbody、thead、およびtfoot要素のcharコンテンツ属性を反映しなければなりません。

chOffのIDL属性は、tbody、thead、およびtfoot要素のcharoffコンテンツ属性を反映しなければなりません。

tbody、thead、およびtfoot 要素の vAlign IDL 属性は、要素の valign コンテンツ属性を反映する必要があります。 

partial interface HTMLTableCellElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString axis;
   [CEReactions] attribute DOMString height;
   [CEReactions] attribute DOMString width;
 
   [CEReactions] attribute DOMString ch;
   [CEReactions] attribute DOMString chOff;
   [CEReactions] attribute boolean noWrap;
   [CEReactions] attribute DOMString vAlign;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString bgColor;
 };

align、axis、heightおよびwidthのIDL属性は、td要素とth要素の同名のコンテンツ属性を反映しなければなりません。

chのIDL属性は、td要素とth要素のcharコンテンツ属性を反映しなければなりません。

chOffのIDL属性は、td要素とth要素のcharoffコンテンツ属性を反映しなければなりません。

noWrapのIDL属性は、td要素とth要素のnowrapコンテンツ属性を反映しなければなりません。

vAlignのIDL属性は、td要素とth要素のvalignコンテンツ属性を反映しなければなりません。

bgColorのIDL属性は、td要素とth要素のbgcolorコンテンツ属性を反映しなければなりません。

partial interface HTMLTableRowElement {
   [CEReactions] attribute DOMString align;
   [CEReactions] attribute DOMString ch;
   [CEReactions] attribute DOMString chOff;
   [CEReactions] attribute DOMString vAlign;
 
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString bgColor;
 };

alignのIDL属性は、tr要素の同名のコンテンツ属性を反映しなければなりません。

chのIDL属性は、tr要素のcharコンテンツ属性を反映しなければなりません。

chOffのIDL属性は、tr要素のcharoffコンテンツ属性を反映しなければなりません。

vAlignのIDL属性は、tr要素のvalignコンテンツ属性を反映しなければなりません。

bgColorのIDL属性は、tr要素のbgcolorコンテンツ属性を反映しなければなりません。

partial interface HTMLUListElement {
   [CEReactions] attribute boolean compact;
   [CEReactions] attribute DOMString type;
 };

compactおよびtypeのIDL属性は、ul要素の同名のコンテンツ属性を反映しなければなりません。

xmp要素は、セマンティクスおよびレンダリングに関してはpre要素と同等に扱わなければなりません（ただし、この要素にはパーサーによる特別な処理があります）。 

partial interface Document {
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString fgColor;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString linkColor;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString vlinkColor;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString alinkColor;
   [CEReactions] attribute [LegacyNullToEmptyString] DOMString bgColor;
 
   [SameObject] readonly attribute HTMLCollection anchors;
   [SameObject] readonly attribute HTMLCollection applets;
 
   undefined clear();
   undefined captureEvents();
   undefined releaseEvents();
 
   [SameObject] readonly attribute HTMLAllCollection all;
 };

Documentオブジェクトの以下の表の最初の列にリストされている属性は、反映しなければなりません。

IDL属性 コンテンツ属性
fgColor text
linkColor link
vlinkColor vlink
alinkColor alink
bgColor bgcolor

anchors属性は、HTMLCollectionを返さなければなりません。このDocumentノードをルートにし、フィルタはa要素のname属性に一致するものだけを含めるべきです。

applets属性は、HTMLCollectionを返さなければなりません。このDocumentノードをルートにし、フィルタは何も一致しないものにするべきです（これは歴史的な理由で存在しています）。

clear()、captureEvents()、およびreleaseEvents()メソッドは何も行わないものとします。

all属性は、HTMLAllCollectionを返さなければなりません。このDocumentノードをルートにし、フィルタはすべての要素に一致するものにするべきです。 

partial interface Window {
   undefined captureEvents();
   undefined releaseEvents();
 
   [Replaceable, SameObject] readonly attribute External external;
 };

captureEvents()およびreleaseEvents()メソッドは何も行わないものとします。

external属性は、Windowインターフェイスの一部として、Externalインターフェイスのインスタンスを返さなければなりません。 

[Exposed=Window]
 interface External {
   undefined AddSearchProvider();
   undefined IsSearchProviderInstalled();
 };

AddSearchProvider()およびIsSearchProviderInstalled()メソッドは何も行わないものとします。

17 IANAの考慮事項

17.1 text/html

この登録はコミュニティのレビューのためのものであり、IESGに提出され、レビュー、承認、IANAへの登録が行われます。

タイプ名:
text
サブタイプ名:
html
必須パラメータ:
必須パラメータなし
オプションパラメータ:
charset

charset パラメータを指定して、文書の文字エンコーディングを指定することができ、 ドキュメント内の他の 文字エンコーディング宣言 を上書きします（バイト順序マーク（BOM）を除く）。パラメータの値は、文字列 "utf-8" に対して ASCII 大文字小文字を区別しない 一致でなければなりません。 [ENCODING]

エンコーディングの考慮事項:
8bit（文字エンコーディング宣言に関するセクションを参照）
セキュリティの考慮事項:

HTMLドキュメントに適用されるセキュリティの考慮事項については、全体的な文書に多くの記載があります。詳細はこの文書にリストされているものを参照してください。しかし、ここでいくつかの一般的な懸念事項について触れておきます。

HTMLはスクリプト言語であり、多数のAPIを持っています（そのいくつかはこの文書で説明されています）。スクリプトは、情報漏えい、資格情報漏えい、クロスサイトスクリプティング攻撃、クロスサイトリクエストフォージェリ、およびその他の問題のリスクをユーザーにさらす可能性があります。この仕様の設計は正しく実装されれば安全であることを意図していますが、完全な実装は大規模な作業であり、他のソフトウェアと同様に、ユーザーエージェントにはセキュリティ上のバグが存在する可能性があります。

スクリプトがない場合でも、互換性のために歴史的に必要とされる特定の機能があり、それがセキュリティ上の問題を引き起こす可能性があります。特に、img要素は、他の機能と組み合わせて、ユーザーのインターネット上の位置からポートスキャンを行う手段として使用される可能性があります。これにより、攻撃者が通常は特定できないローカルネットワークのトポロジーが明らかになる可能性があります。

HTMLは、同一オリジンポリシーとして知られるコンパートメント化スキームに依存しています。オリジンは、通常、同じホスト、同じポート、同じプロトコルで提供されるすべてのページで構成されます。

したがって、サイトの一部を構成する信頼できないコンテンツは、サイト上の他の機密コンテンツとは異なるオリジンでホストされるようにすることが重要です。信頼できないコンテンツは、同じオリジン上の他のページを簡単に偽装したり、そのオリジンからデータを読み取ったり、そのオリジンのスクリプトを実行させたり、クロスサイトリクエストフォージェリ攻撃から保護されていてもそのオリジンにフォームを提出したり、そのオリジンに対して公開されているまたは権利が付与されている任意のサードパーティリソースを利用することができます。

相互運用性の考慮事項:
適合するコンテンツおよび適合しないコンテンツの処理に関するルールは、この仕様で定義されています。
公開されている仕様:
この文書が関連する仕様です。リソースをtext/htmlタイプとしてラベル付けすることで、そのリソースがHTMLドキュメントであり、HTML構文を使用していることを主張します。
このメディアタイプを使用するアプリケーション:
ウェブブラウザ、ウェブコンテンツを処理するツール、HTML作成ツール、検索エンジン、バリデータ。
追加情報:
マジックナンバー:
HTMLドキュメントを一意に識別するバイトシーケンスは存在しません。HTMLドキュメントの検出に関する詳細は、MIME Sniffingに記載されています。[MIMESNIFF]
ファイル拡張子:
"html"および"htm"は、一般的に使用されますが、必ずしもHTMLドキュメントの拡張子として限定されているわけではありません。
Macintoshファイルタイプコード:
TEXT
追加情報を求める連絡先:
Ian Hickson <ian@hixie.ch>
意図された使用法:
共通
使用制限:
使用制限はありません。
著者:
Ian Hickson <ian@hixie.ch>
変更管理者:
W3C

フラグメントは、text/htmlリソースと共に使用される場合、対応するDocumentの指示された部分を参照するか、ページ内スクリプトの状態情報を提供します。

17.2 multipart/x-mixed-replace

この登録はコミュニティのレビューのためのものであり、IESGに提出され、レビュー、承認、IANAへの登録が行われます。

タイプ名:
multipart
サブタイプ名:
x-mixed-replace
必須パラメータ:
オプションパラメータ:
オプションパラメータなし
エンコーディングの考慮事項:
バイナリ
セキュリティの考慮事項:
multipart/x-mixed-replaceリソースのサブリソースは、text/htmlのような、非自明なセキュリティ影響を持つタイプを含む任意のタイプである可能性があります。
相互運用性の考慮事項:
特になし。
公開されている仕様:
この仕様は、ウェブブラウザの処理ルールを説明しています。このタイプを使用してリソースを生成する際の適合要件は、multipart/mixedと同じです。[RFC2046]
このメディアタイプを使用するアプリケーション:
このタイプは、ウェブサーバーによって生成され、ウェブブラウザによって消費されるリソースに使用されることを意図しています。
追加情報:
マジックナンバー:
multipart/x-mixed-replaceリソースを一意に識別するバイトシーケンスは存在しません。
ファイル拡張子:
このタイプに対して特定のファイル拡張子は推奨されていません。
Macintoshファイルタイプコード:
このタイプに対して特定のMacintoshファイルタイプコードは推奨されていません。
追加情報を求める連絡先:
Ian Hickson <ian@hixie.ch>
意図された使用法:
共通
使用制限:
使用制限はありません。
著者:
Ian Hickson <ian@hixie.ch>
変更管理者:
W3C

フラグメントは、multipart/x-mixed-replaceリソースと共に使用される場合、ボディパートが使用するタイプによって定義される各ボディパートに適用されます。

17.3 application/xhtml+xml

この登録はコミュニティのレビューのためのものであり、IESGに提出され、レビュー、承認、IANAへの登録が行われます。

タイプ名:
application
サブタイプ名:
xhtml+xml
必須パラメータ:
application/xmlと同じ[RFC7303]
オプションパラメータ:
application/xmlと同じ[RFC7303]
エンコーディングの考慮事項:
application/xmlと同じ[RFC7303]
セキュリティの考慮事項:
application/xmlと同じ[RFC7303]
相互運用性の考慮事項:
application/xmlと同じ[RFC7303]
公開された仕様:
application/xhtml+xmlタイプを持つリソースは、ドキュメント要素を含む可能性が高いXMLドキュメントであることを示しています。関連する仕様はXML、Namespaces in XML、およびこの仕様です。[XML] [XMLNS]
このメディアタイプを使用するアプリケーション:
application/xmlと同じ[RFC7303]
追加情報:
マジックナンバー:
application/xmlと同じ[RFC7303]
ファイル拡張子:
"xhtml" および "xht" は、ドキュメント要素を含むXMLリソースに時折使用されます。HTML名前空間からのものです。
Macintoshファイルタイプコード:
TEXT
追加情報を求める連絡先:
Ian Hickson <ian@hixie.ch>
意図された使用法:
共通
使用制限:
使用制限はありません。
著者:
Ian Hickson <ian@hixie.ch>
変更管理者:
W3C

フラグメントは、application/xhtml+xmlリソースと共に使用される場合、任意のXML MIMEタイプと同じ意味を持ちます。[RFC7303]

17.4 text/ping

この登録はコミュニティのレビューのためのものであり、IESGに提出され、レビュー、承認、IANAへの登録が行われます。

タイプ名:
text
サブタイプ名:
ping
必須パラメータ:
なし
オプションパラメータ:
charset

charsetパラメータが指定される場合があります。パラメータの値は「utf-8」でなければなりません。このパラメータには特に意味はなく、レガシーサーバーとの互換性のためにのみ許可されています。

エンコーディングの考慮事項:
適用不可
セキュリティの考慮事項:

ハイパーリンク監査の文脈で記述されているように専ら使用される場合、このタイプは新たなセキュリティ上の懸念を引き起こすことはありません。

相互運用性の考慮事項:
このタイプに適用されるルールは本仕様書に定義されています。
公開された仕様:
本書が関連する仕様書です。
このメディアタイプを使用するアプリケーション:
Webブラウザ。
追加情報:
マジックナンバー:
text/pingリソースは常に「PING」の4バイト（0x50 0x49 0x4E 0x47）で構成されています。
ファイル拡張子:
このタイプには特定のファイル拡張子は推奨されていません。
Macintoshファイルタイプコード:
このタイプには特定のMacintoshファイルタイプコードは推奨されていません。
追加情報を求める連絡先:
Ian Hickson <ian@hixie.ch>
意図された使用法:
共通
使用制限:
このタイプは、Webブラウザの処理の一環として生成されたHTTP POSTリクエストでのみ使用することを意図しています。
著者:
Ian Hickson <ian@hixie.ch>
変更管理者:
W3C

フラグメントは、text/pingリソースには意味がありません。

17.5 application/microdata+json

この登録はコミュニティのレビューのためのものであり、IESGに提出され、レビュー、承認、IANAへの登録が行われます。

タイプ名:
application
サブタイプ名:
microdata+json
必須パラメータ:
application/jsonと同じ[JSON]
オプションパラメータ:
application/jsonと同じ[JSON]
エンコーディングの考慮事項:
8bit（常にUTF-8）
セキュリティの考慮事項:
application/jsonと同じ[JSON]
相互運用性の考慮事項:
application/jsonと同じ[JSON]
公開された仕様:
application/microdata+jsonタイプでラベル付けされたリソースは、オブジェクトを含むJSONテキストであり、各エントリが文字列、別の文字列、配列などを含むオブジェクトで構成されています。関連する仕様はJSONとこの仕様です。[JSON]
このメディアタイプを使用するアプリケーション:

HTMLのマイクロデータ機能で使用するデータを転送するアプリケーション、特にドラッグ＆ドロップのコンテキストでこのタイプが使用されます。

追加情報:
マジックナンバー:
application/jsonと同じ[JSON]
ファイル拡張子:
application/jsonと同じ[JSON]
Macintoshファイルタイプコード:
application/jsonと同じ[JSON]
追加情報を求める連絡先:
Ian Hickson <ian@hixie.ch>
意図された使用法:
共通
使用制限:
使用制限はありません。
著者:
Ian Hickson <ian@hixie.ch>
変更管理者:
W3C

フラグメントは、application/microdata+jsonリソースと一緒に使用される場合、application/jsonと同じ意味を持ちます（つまり、執筆時点ではまったく意味がありません）。[JSON]

17.6 text/event-stream

この登録はコミュニティのレビューのためのものであり、IESGに提出され、レビュー、承認、IANAへの登録が行われます。

タイプ名:
text
サブタイプ名:
event-stream
必須パラメータ:
なし
オプションパラメータ:
charset

charsetパラメータが指定される場合があります。パラメータの値は「utf-8」でなければなりません。このパラメータには特に意味はなく、レガシーサーバーとの互換性のためにのみ許可されています。

エンコーディングの考慮事項:
8bit（常にUTF-8）
セキュリティの考慮事項:

コンテンツを消費する起源とは異なる起源からのイベントストリームは、情報漏えいの原因となる可能性があります。これを避けるために、ユーザーエージェントはCORSセマンティクスを適用する必要があります。[FETCH]

イベントストリームはユーザーエージェントに過負荷をかける可能性があります。ユーザーエージェントは、イベントストリームからの情報の過剰供給によってローカルリソースが枯渇するのを避けるため、適切な制限を適用することが期待されています。

サーバーがクライアントに急速に再接続を促す状況が発生すると、サーバーは過負荷になる可能性があります。サーバーは、容量の問題を示すために5xxステータスコードを使用するべきです。これにより、適合クライアントが自動的に再接続するのを防ぐことができます。

相互運用性の考慮事項:
適合および非適合コンテンツの処理に関するルールは、本仕様書で定義されています。
公開された仕様:
本書が関連する仕様書です。
このメディアタイプを使用するアプリケーション:
WebブラウザおよびWebサービスを使用するツール。
追加情報:
マジックナンバー:
イベントストリームを一意に識別するバイト列はありません。
ファイル拡張子:
このタイプには特定のファイル拡張子は推奨されていません。
Macintoshファイルタイプコード:
このタイプには特定のMacintoshファイルタイプコードは推奨されていません。
追加情報を求める連絡先:
Ian Hickson <ian@hixie.ch>
意図された使用法:
共通
使用制限:
このフォーマットは、HTTPまたは類似のプロトコルを使用して提供される動的な無限ストリームでのみ使用されることが期待されています。有限なリソースはこのタイプでラベル付けされることは想定されていません。
著者:
Ian Hickson <ian@hixie.ch>
変更管理者:
W3C

フラグメントは、text/event-streamリソースには意味がありません。

17.7 web+ スキームプレフィックス

このセクションでは、IANA URIスキームレジストリで使用するための慣例について説明します。特定のスキーム自体を登録するものではありません。[RFC7595]

スキーム名:
web+で始まり、その後にa-zの範囲の1文字以上の文字が続くスキーム。
ステータス:
永久
スキーム構文:
スキーム固有。
スキームの意味:
スキーム固有。
エンコーディングの考慮事項:
すべてのweb+スキームは、関連する場合にUTF-8エンコーディングを使用する必要があります。
このスキーム名を使用するアプリケーション/プロトコル:
スキーム固有。
相互運用性の考慮事項:
このスキームは、ウェブアプリケーションのコンテキストで使用されることが予想されます。
セキュリティの考慮事項:
任意のウェブページがすべてのweb+スキームのハンドラーを登録できるため、これらのスキームは、HTTPなどのコアプラットフォーム機能を目的とした機能には使用しないでください。同様に、そのようなスキームは、ユーザー名、パスワード、個人情報、または機密プロジェクト名などの機密情報をURLに保存しないでください。
連絡先:
Ian Hickson <ian@hixie.ch>
変更管理者:
Ian Hickson <ian@hixie.ch>
参考文献:
カスタムスキームハンドラー, HTML Living Standard: https://html.spec.whatwg.org/#custom-handlers

インデックス

次のセクションは、適合する要素と機能のみを対象としています。

要素

このセクションは規範的ではありません。

要素のリスト
要素 説明 カテゴリ 親要素 子要素 属性 インターフェース
a ハイパーリンク flow; phrasing*; interactive; palpable phrasing transparent* globals; href; target; download; ping; rel; hreflang; type; referrerpolicy HTMLAnchorElement
abbr 略語 flow; phrasing; palpable phrasing phrasing globals HTMLElement
address ページやarticle要素の連絡先情報 flow; palpable flow flow* globals HTMLElement
area イメージマップのハイパーリンクまたはデッドエリア flow; phrasing phrasing* 空 globals; alt; coords; shape; href; target; download; ping; rel; referrerpolicy HTMLAreaElement
article 自己完結型のシンジケート可能または再利用可能なコンポジション flow; sectioning; palpable flow flow globals HTMLElement
aside 関連する内容と間接的に関連するサイドバー flow; sectioning; palpable flow flow globals HTMLElement
audio オーディオプレーヤー flow; phrasing; embedded; interactive; palpable* phrasing source*; track*; transparent* globals; src; crossorigin; preload; autoplay; loop; muted; controls HTMLAudioElement
b キーワード flow; phrasing; palpable phrasing phrasing globals HTMLElement
base 基底URLと既定のターゲットnavigable、ハイパーリンクとフォーム metadata head 空 globals; href; target HTMLBaseElement
bdi テキストの方向性の分離 flow; phrasing; palpable phrasing phrasing globals HTMLElement
bdo テキストの方向性のフォーマット flow; phrasing; palpable phrasing phrasing globals HTMLElement
blockquote 別のソースから引用されたセクション flow; palpable flow flow globals; cite HTMLQuoteElement
body ドキュメント本文 なし html flow globals; onafterprint; onbeforeprint; onbeforeunload; onhashchange; onlanguagechange; onmessage; onmessageerror; onoffline; ononline; onpageswap; onpagehide; onpagereveal; onpageshow; onpopstate; onrejectionhandled; onstorage; onunhandledrejection; onunload HTMLBodyElement
br 行の区切り、例: 詩や住所 flow; phrasing phrasing 空 globals HTMLBRElement
button ボタンコントロール flow; phrasing; interactive; listed; labelable; submittable; form-associated; palpable phrasing phrasing* globals; command; commandfor; disabled; form; formaction; formenctype; formmethod; formnovalidate; formtarget; name; popovertarget; popovertargetaction; type; value HTMLButtonElement
canvas スクリプト可能なビットマップキャンバス flow; phrasing; embedded; palpable phrasing transparent globals; width; height HTMLCanvasElement
caption テーブルのキャプション なし table flow* globals HTMLTableCaptionElement
cite 作品のタイトル flow; phrasing; palpable phrasing phrasing globals HTMLElement
code コンピュータコード flow; phrasing; palpable phrasing phrasing globals HTMLElement
col テーブルの列 なし colgroup 空 globals; span HTMLTableColElement
colgroup テーブル内の列のグループ なし table col*; template* globals; span HTMLTableColElement
data 機械可読な等価物 flow; phrasing; palpable phrasing phrasing globals; value HTMLDataElement
datalist コンボボックスコントロール用のオプションのコンテナ flow; phrasing phrasing phrasing*; option*; スクリプトサポート要素* globals HTMLDataListElement
dd 対応するdt要素の内容 なし dl; div* flow globals HTMLElement
del ドキュメントからの削除 flow; phrasing*; palpable phrasing transparent globals; cite; datetime HTMLModElement
details 詳細を隠すための開閉コントロール flow; interactive; palpable flow summary*; flow globals; name; open HTMLDetailsElement
dfn 定義インスタンス flow; phrasing; palpable phrasing phrasing* globals HTMLElement
dialog ダイアログボックスまたはウィンドウ flow flow flow globals; open HTMLDialogElement
div 一般的なフローコンテナ、またはdl要素の中の名前と値のグループのコンテナ flow; palpable flow; dl flow globals HTMLDivElement
dl 0個以上の名前と値のグループからなる連想リスト flow; palpable flow dt*; dd*; div*; スクリプトサポート要素 globals HTMLDListElement
dt 対応するdd要素の説明 なし dl; div* flow* globals HTMLElement
em 強調 flow; phrasing; palpable phrasing phrasing globals HTMLElement
embed プラグイン flow; phrasing; embedded; interactive; palpable phrasing 空 globals; src; type; width; height; any* HTMLEmbedElement
fieldset フォームコントロールのグループ flow; listed; form-associated; palpable flow legend*; flow globals; disabled; form; name HTMLFieldSetElement
figcaption 図のキャプション なし figure フロー グローバル属性 HTMLElement
figure オプションのキャプション付きの図 フロー; 明示的なコンテンツ フロー figcaption*; フロー グローバル属性 HTMLElement
footer ページまたはセクションのフッター フロー; 明示的なコンテンツ フロー フロー* グローバル属性 HTMLElement
form ユーザーが送信可能なフォーム フロー; 明示的なコンテンツ フロー フロー* グローバル属性; accept-charset; action; autocomplete; enctype; method; name; novalidate; rel; target HTMLFormElement
h1, h2, h3, h4, h5, h6 見出し フロー; 見出しコンテンツ; 明示的なコンテンツ legend; summary; フロー フレージング グローバル属性 HTMLHeadingElement
head 文書のメタデータを格納するコンテナ なし html メタデータコンテンツ* グローバル属性 HTMLHeadElement
header ページやセクションの紹介またはナビゲーションの補助 フロー; 明示的なコンテンツ フロー フロー* グローバル属性 HTMLElement
hgroup 見出しのコンテナ フロー; 明示的なコンテンツ legend; summary; フロー h1; h2; h3; h4; h5; h6; スクリプトサポート要素 グローバル属性 HTMLElement
hr 主題の区切り フロー フロー 空 グローバル属性 HTMLHRElement
html ルート要素 なし なし* head*; body* globals HTMLHtmlElement
i 別の声 フロー; フレージング; 明示的なコンテンツ フレージング フレージング グローバル属性 HTMLElement
iframe ナビゲーション可能な子要素 フロー; フレージング; 埋め込みコンテンツ; インタラクティブ; 明示的なコンテンツ フレージング 空 グローバル属性; src; srcdoc; name; sandbox; allow; allowfullscreen; width; height; referrerpolicy; loading HTMLIFrameElement
img 画像 フロー; フレージング; 埋め込みコンテンツ; インタラクティブ*; フォーム関連; 明示的なコンテンツ フレージング; picture 空 グローバル属性; alt; src; srcset; sizes; crossorigin; usemap; ismap; width; height; referrerpolicy; decoding; loading; fetchpriority HTMLImageElement
input フォームコントロール フロー; フレージング; インタラクティブ*; リスト; ラベル; 送信可能; リセット可能; フォーム関連; 明示的なコンテンツ* フレージング 空 グローバル属性; accept; alpha; alt; autocomplete; checked; colorspace; dirname; disabled; form; formaction; formenctype; formmethod; formnovalidate; formtarget; height; list; max; maxlength; min; minlength; multiple; name; pattern; placeholder; popovertarget; popovertargetaction; readonly; required; size; src; step; type; value; width HTMLInputElement
ins ドキュメントへの追加 フロー; フレージング*; 知覚可能 フレージング 透明 グローバル属性; cite; datetime HTMLModElement
kbd ユーザー入力 フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
label フォームコントロールのキャプション フロー; フレージング; インタラクティブ; 知覚可能 フレージング フレージング* グローバル属性; for HTMLLabelElement
legend fieldset のキャプション なし fieldset フレージング; 見出しコンテンツ グローバル属性 HTMLLegendElement
li リスト項目 なし ol; ul; menu* フロー グローバル属性; value* HTMLLIElement
link リンクメタデータ メタデータ; フロー*; フレージング* head; noscript*; フレージング* 空 グローバル属性; href; crossorigin; rel; as; media; hreflang; type; sizes; imagesrcset; imagesizes; referrerpolicy; integrity; blocking; color; disabled; fetchpriority HTMLLinkElement
main 文書の主要な内容のコンテナ フロー; 知覚可能 フロー* フロー グローバル属性 HTMLElement
map イメージマップ フロー; フレージング*; 知覚可能 フレージング 透明; area* グローバル属性; name HTMLMapElement
mark ハイライト フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
MathML math MathML ルート フロー; フレージング; 埋め込みコンテンツ; 知覚可能 フレージング per [MATHML] per [MATHML] Element
menu コマンドのメニュー フロー; 知覚可能* フロー li; スクリプトサポート要素 グローバル属性 HTMLMenuElement
meta テキストメタデータ メタデータ; フロー*; フレージング* head; noscript*; フレージング* 空 グローバル属性; name; http-equiv; content; charset; media HTMLMetaElement
meter メーター フロー; フレージング; ラベル可能; 知覚可能 フレージング フレージング* グローバル属性; value; min; max; low; high; optimum HTMLMeterElement
nav ナビゲーションリンクを含むセクション フロー; セクショニング; 知覚可能 フロー フロー グローバル属性 HTMLElement
noscript スクリプトのフォールバックコンテンツ メタデータ; フロー; フレージング head*; フレージング* 様々* グローバル属性 HTMLElement
object 画像、子ナビゲーショブル、 またはプラグイン フロー; フレージング; 埋め込み; インタラクティブ*; リスト; フォーム関連; 知覚可能 フレージング 透明 グローバル属性; data; type; name; form; width; height HTMLObjectElement
ol 順序付きリスト フロー; 知覚可能* フロー li; スクリプトサポート要素 グローバル属性; reversed; start; type HTMLOListElement
optgroup リストボックス内のオプションのグループ なし select option; スクリプトサポート要素 グローバル属性; disabled; label HTMLOptGroupElement
option リストボックスまたはコンボボックスのオプション なし select; datalist; optgroup テキスト* グローバル属性; disabled; label; selected; value HTMLOptionElement
output 計算された出力値 フロー; フレージング; リスト; ラベル可能; リセット可能; フォーム関連; 知覚可能 フレージング フレージング グローバル属性; for; form; name HTMLOutputElement
p 段落 フロー; 知覚可能 フロー フレージング グローバル属性 HTMLParagraphElement
picture 画像 フロー; フレージング; 埋め込み; 知覚可能 フレージング source*; 1つのimg; スクリプトサポート要素 グローバル属性 HTMLPictureElement
pre 整形済みテキストのブロック フロー; 知覚可能 フロー フレージング グローバル属性 HTMLPreElement
progress 進捗バー フロー; フレージング; ラベル可能; 知覚可能 フレージング フレージング* グローバル属性; value; max HTMLProgressElement
q 引用 フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性; cite HTMLQuoteElement
rp ルビ注釈テキストの括弧 なし ruby テキスト グローバル属性 HTMLElement
rt ルビ注釈テキスト なし ruby フレージング グローバル属性 HTMLElement
ruby ルビ注釈 フロー; フレージング; 知覚可能 フレージング フレージング; rt; rp* グローバル属性 HTMLElement
s 不正確なテキスト フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
samp コンピュータ出力 フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
script 埋め込みスクリプト メタデータ; フロー; フレージング; スクリプトサポート head; フレージング; スクリプトサポート スクリプト、データ、またはスクリプトドキュメント* グローバル属性; src; type; nomodule; async; defer; crossorigin; integrity; referrerpolicy; blocking; fetchpriority HTMLScriptElement
search 検索コントロールのコンテナ フロー; 知覚可能 フロー フロー グローバル属性 HTMLElement
section 汎用のドキュメントまたはアプリケーションセクション フロー; セクショニング; 知覚可能 フロー フロー グローバル属性 HTMLElement
select リストボックスコントロール フロー; フレージング; インタラクティブ; リスト化; ラベル可能; 送信可能; リセット可能; フォーム関連; 知覚可能 フレージング option; optgroup; スクリプトサポート要素 グローバル属性; autocomplete; disabled; form; multiple; name; required; size HTMLSelectElement
slot シャドウツリースロット フロー; フレージング フレージング 透明 グローバル属性; name HTMLSlotElement
small サイドコメント フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
source imgの画像ソースまたは videoのメディアソース、 またはaudioのメディアソース なし picture; video; audio 空 グローバル属性; type; media; src; srcset; sizes; width; height HTMLSourceElement
span 汎用のフレージングコンテナ フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLSpanElement
strong 重要 フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
style 埋め込みスタイル情報 メタデータ head; noscript* テキスト* グローバル属性; media; blocking HTMLStyleElement
sub 下付き文字 フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
summary detailsのキャプション なし details フレージング; 見出しコンテンツ グローバル属性 HTMLElement
sup 上付き文字 フロー; フレージング; 知覚可能 フレージング フレージング グローバル属性 HTMLElement
SVG svg SVGルート フロー; フレージング; 埋め込み; 知覚可能 フレージング [SVG]に準拠 [SVG]に準拠 SVGSVGElement
table テーブル フロー; 明確な フロー caption*; colgroup*; thead*; tbody*; tfoot*; tr*; スクリプト対応要素 グローバル属性 HTMLTableElement
tbody テーブル内の行のグループ なし table tr; スクリプト対応要素 グローバル属性 HTMLTableSectionElement
td テーブルセル なし tr フロー グローバル属性; colspan; rowspan; headers HTMLTableCellElement
template テンプレート メタデータ; フロー; フレージング; スクリプト対応 メタデータ; フレージング; スクリプト対応; colgroup* 空 グローバル属性; shadowrootmode; shadowrootdelegatesfocus; shadowrootclonable; shadowrootserializable; shadowrootcustomelementregistry HTMLTemplateElement
textarea 複数行のテキストコントロール フロー; フレージング; インタラクティブ; リスト; ラベル可能; 送信可能; リセット可能; フォーム関連; 明確な フレージング テキスト グローバル属性; autocomplete; cols; dirname; disabled; form; maxlength; minlength; name; placeholder; readonly; required; rows; wrap HTMLTextAreaElement
tfoot テーブルのフッター行のグループ なし table tr; スクリプト対応要素 グローバル属性 HTMLTableSectionElement
th テーブルヘッダーセル インタラクティブ* tr フロー* グローバル属性; colspan; rowspan; headers; scope; abbr HTMLTableCellElement
thead テーブルのヘッダー行のグループ なし table tr; スクリプト対応要素 グローバル属性 HTMLTableSectionElement
time 日付や時間に関連するデータの機械可読な形式 フロー; フレージング; 明確な フレージング フレージング グローバル属性; datetime HTMLTimeElement
title 文書のタイトル メタデータ head テキスト* グローバル属性 HTMLTitleElement
tr テーブル行 なし table; thead; tbody; tfoot th*; td; スクリプト対応要素 グローバル属性 HTMLTableRowElement
track タイミングテキストトラック なし audio; video 空 グローバル属性; default; kind; label; src; srclang HTMLTrackElement
u 未発表の注釈 フロー; フレージング; 明確な フレージング フレージング グローバル属性 HTMLElement
ul リスト フロー; 明確な* フロー li; スクリプト対応要素 グローバル属性 HTMLUListElement
var 変数 フロー; フレージング; 明確な フレージング フレージング グローバル属性 HTMLElement
video ビデオプレーヤー フロー; フレージング; 埋め込み; インタラクティブ; 明確な フレージング source*; track*; 透過的* グローバル属性; src; crossorigin; poster; preload; autoplay; playsinline; loop; muted; controls; width; height HTMLVideoElement
wbr 改行の機会 フロー; フレージング フレージング 空 グローバル属性 HTMLElement
自律型カスタム要素 作成者定義の要素 フロー; フレージング; 明確な フロー; フレージング 透過的 グローバル属性; 作成者が決定 作成者が提供（HTMLElement から継承）

セル内のアスタリスク (*) は、実際のルールが上記の表に示されているよりも複雑であることを示しています。

† 「親」列のカテゴリは、コンテンツモデルに指定されたカテゴリをリストしている親を指し、それ自体がそのカテゴリに含まれる要素を指しているわけではありません。例えば、a 要素の「親」列には「フレージング」と書かれているので、コンテンツモデルに「フレージング」カテゴリを含む要素が a 要素の親になることができます。「フロー」カテゴリにはすべての「フレージング」要素が含まれているため、th 要素が a 要素の親になることができることを意味します。

要素のコンテンツカテゴリ

このセクションは規範的ではありません。

要素コンテンツカテゴリの一覧
カテゴリ 要素 例外のある要素
メタデータコンテンツ base; link; meta; noscript; script; style; template; title —
フローコンテンツ a; abbr; address; article; aside; audio; b; bdi; bdo; blockquote; br; button; canvas; cite; code; data; datalist; del; details; dfn; dialog; div; dl; em; embed; fieldset; figure; footer; form; h1; h2; h3; h4; h5; h6; header; hgroup; hr; i; iframe; img; input; ins; kbd; label; map; mark; MathML math; menu; meter; nav; noscript; object; ol; output; p; picture; pre; progress; q; ruby; s; samp; script; search; section; select; slot; small; span; strong; sub; sup; SVG svg; table; template; textarea; time; u; ul; var; video; wbr; 自律型カスタム要素; テキスト area （map 要素の子孫である場合); link （本文に許可されている場合); main （階層的に正しい main 要素である場合); meta （itemprop 属性が存在する場合)
セクショニングコンテンツ article; aside; nav; section —
見出しコンテンツ h1; h2; h3; h4; h5; h6; hgroup —
フレージングコンテンツ a; abbr; audio; b; bdi; bdo; br; button; canvas; cite; code; data; datalist; del; dfn; em; embed; i; iframe; img; input; ins; kbd; label; map; mark; MathML math; meter; noscript; object; output; picture; progress; q; ruby; s; samp; script; select; slot; small; span; strong; sub; sup; SVG svg; template; textarea; time; u; var; video; wbr; 自律カスタム要素; テキスト area (もし map 要素の子孫であれば); link (もし 本文に許可されている場合); meta (もし itemprop 属性が存在する場合)
埋め込みコンテンツ audio; canvas; embed; iframe; img; MathML math; object; picture; SVG svg; video —
インタラクティブコンテンツ button; details; embed; iframe; label; select; textarea a (もし href 属性が存在する場合); audio (もし controls 属性が存在する場合); img (もし usemap 属性が存在する場合); input (もし type 属性が 隠し 状態でない場合); video (もし controls 属性が存在する場合)
フォーム関連要素 button; fieldset; input; label; object; output; select; textarea; img; フォーム関連カスタム要素 —
リスト化された要素 button; fieldset; input; object; output; select; textarea; フォーム関連カスタム要素 —
送信可能な要素 button; input; select; textarea; フォーム関連カスタム要素 —
リセット可能な要素 input; output; select; textarea; フォーム関連カスタム要素 —
自動大文字化および自動修正を継承する要素 button; fieldset; input; output; select; textarea —
ラベル可能な要素 button; input; meter; output; progress; select; textarea; フォーム関連カスタム要素 —
触知可能なコンテンツ a; abbr; address; article; aside; b; bdi; bdo; blockquote; button; canvas; cite; code; data; del; details; dfn; div; em; embed; fieldset; figure; footer; form; h1; h2; h3; h4; h5; h6; header; hgroup; i; iframe; img; ins; kbd; label; main; map; mark; MathML math; meter; nav; object; output; p; picture; pre; progress; q; ruby; s; samp; search; section; select; small; span; strong; sub; sup; SVG svg; table; textarea; time; u; var; video; 自律カスタム要素 audio (もし controls 属性が存在する場合); dl (もし要素の子要素に少なくとも1つの名前と値のペアが含まれる場合); input (もし type 属性が 隠し 状態でない場合); menu (もし要素の子要素に少なくとも1つの li 要素が含まれる場合); ol (もし要素の子要素に少なくとも1つの li 要素が含まれる場合); ul (もし要素の子要素に少なくとも1つの li 要素が含まれる場合); テキスト で、 要素間の空白 ではないもの
スクリプトサポート要素 script; template —

属性

このセクションは規範的ではありません。

属性の一覧（イベントハンドラー属性を除く）
属性 要素 説明 値
abbr th セルを他のコンテキストで参照する際に使用する代替ラベル テキスト*
accept input ファイルアップロードコントロールで期待されるファイルタイプのヒント カンマ区切りトークンのセット*で、パラメータなしの有効なMIMEタイプ文字列またはaudio/*、video/*、image/*
accept-charset form フォーム送信に使用する文字エンコーディング ASCII大文字小文字を区別しない "UTF-8"
accesskey HTML要素 要素をアクティブにしたりフォーカスしたりするためのキーボードショートカット スペース区切りの一意なトークンの順序付きセットで、他のものと同一ではない長さ1コードポイントからなる
action form URL、フォーム送信に使用する スペースで囲まれる可能性がある有効な非空URL
allow iframe 権限ポリシーをiframeの内容に適用するかどうか シリアル化された権限ポリシー
allowfullscreen iframe iframeの内容がrequestFullscreen()を使用することを許可するかどうか ブール属性
alpha input 色のアルファ成分の設定を許可する ブール属性
alt area; img; input 画像が利用できない場合に使用される代替テキスト テキスト*
as link プレロードリクエストの潜在的な宛先（rel="preload"およびrel="modulepreload"の場合 潜在的な宛先、rel="preload"の場合; スクリプトのような宛先、rel="modulepreload"の場合
async script スクリプトをフェッチ中にブロックせずに、利用可能な場合に実行する ブール属性
autocapitalize HTML要素 推奨される自動大文字化の動作（サポートされている入力方法に対して） "on"; "off"; "none"; "sentences"; "words"; "characters"
autocomplete form フォーム内のコントロールのための自動補完機能のデフォルト設定 "on"; "off"
autocomplete input; select; textarea フォーム自動補完機能のためのヒント 自動補完フィールドの名前および関連するトークン*
autocorrect HTML 要素 推奨される自動修正の挙動（サポートされている入力方法の場合） "on"; "off"
autofocus HTML要素 ページが読み込まれたときに自動的に要素にフォーカスするかどうか ブール属性
autoplay audio; video ページが読み込まれたときにメディアリソースが自動的に開始できることのヒント ブール属性
blocking link; script; style 要素が潜在的にレンダーブロックしているかどうか 一意なスペース区切りトークンの順不同セット*
charset meta 文字エンコーディング宣言 "utf-8"
checked input コントロールが選択されているかどうか ブール属性
cite blockquote; del; ins; q 引用元または編集に関する詳細情報へのリンク スペースで囲まれる可能性のある有効なURL
class HTML要素 要素が属するクラス スペース区切りトークンのセット
closedby dialog どのユーザーアクションがダイアログを閉じるか "any"; "closerequest"; "none";
color link サイトのアイコンをカスタマイズする際に使用する色（rel="mask-icon"の場合） CSS <color>
colorspace input シリアル化された色の色空間 "limited-srgb"; "display-p3"
cols textarea 1行あたりの最大文字数 ゼロ以上の有効な整数でゼロより大きいもの
colspan td; th セルが跨ぐ列数 ゼロ以上の有効な整数でゼロより大きいもの
command button ターゲット要素にどのアクションを実行するかを示します。 "toggle-popover"; "show-popover"; "hide-popover"; "close"; "request-close"; "show-modal"; カスタムコマンドキーワード
commandfor button 呼び出される別の要素をターゲットにします。 ID*
content meta 要素の値 テキスト*
contenteditable HTML要素 要素が編集可能かどうか "true"; "plaintext-only"; "false"
controls audio; video ユーザーエージェントコントロールを表示するかどうか ブール属性
coords area イメージマップ内に作成される形状の座標 有効な浮動小数点数のリスト*
crossorigin audio; img; link; script; video 要素がクロスオリジンリクエストを処理する方法 "anonymous"; "use-credentials"
data object リソースのアドレス スペースで囲まれる可能性がある有効な非空URL
datetime del; ins 変更の日時（オプション） 有効な日付文字列（オプションで時間）
datetime time 機械が読み取れる値 有効な月の文字列、 有効な日付文字列、 有効な年なし日付文字列、 有効な時間文字列、 有効なローカル日付時刻文字列、 有効なタイムゾーンオフセット文字列、 有効なグローバル日付時刻文字列、 有効な週の文字列、 有効な非負の整数、 または有効な期間文字列
decoding img 表示のためにこの画像を処理するときに使用するデコードのヒント "sync"; "async"; "auto"
default track 他のテキストトラックがより適切でない場合にトラックを有効にする ブール属性
defer script スクリプトの実行を遅延させる ブール属性
dir HTML要素 要素のテキストの方向性 "ltr"; "rtl"; "auto"
dir bdo 要素のテキストの方向性 "ltr"; "rtl"
dirname input; textarea 方向性を送信するために使用するフォームコントロールの名前フォーム送信 テキスト*
disabled button; input; optgroup; option; select; textarea; フォーム関連カスタム要素 フォームコントロールが無効かどうか ブール属性
disabled fieldset 子孫のフォームコントロールが、legendの内部を除き、無効かどうか ブール属性
disabled link リンクが無効かどうか ブール属性
download a; area リソースをナビゲートする代わりにダウンロードするかどうか、その場合のファイル名 テキスト
draggable HTML要素 要素がドラッグ可能かどうか "true"; "false"
enctype form エントリリストエンコーディングタイプ、フォーム送信に使用する "application/x-www-form-urlencoded"; "multipart/form-data"; "text/plain"
enterkeyhint HTML要素 エンターキーアクションを選択するためのヒント "enter"; "done"; "go"; "next"; "previous"; "search"; "send"
fetchpriority img; link; script 要素によって開始されたフェッチの優先度を設定 "auto"; "high"; "low"
for label ラベルをフォームコントロールと関連付ける ID*
for output 出力が計算されたコントロールを指定 一意なスペース区切りトークンの順不同セットで構成されるID*
form button; fieldset; input; object; output; select; textarea; フォーム関連カスタム要素 要素をフォーム要素と関連付ける ID*
formaction button; input URLを使用してフォーム送信を行う スペースで囲まれる可能性のある有効な非空URL
formenctype button; input エントリリストエンコーディングタイプ、フォーム送信に使用する "application/x-www-form-urlencoded"; "multipart/form-data"; "text/plain"
formmethod button; input フォーム送信に使用するバリアント "GET"; "POST"; "dialog"
formnovalidate button; input フォーム送信に対するフォームコントロールの検証をバイパス ブール属性
formtarget button; input ナビゲート可能、フォーム送信に使用 有効なナビゲート可能なターゲット名またはキーワード
headers td; th このセルのヘッダーセル IDで構成される一意なスペース区切りトークンの順不同セット*
height canvas; embed; iframe; img; input; object; source (picture内); video 垂直寸法 有効な非負整数
hidden HTML要素 要素が関連しているかどうか "until-found"; "hidden"; 空の文字列
high meter 高範囲の低限度 有効な浮動小数点数*
href a; area ハイパーリンクのアドレス スペースで囲まれる可能性のある有効なURL
href link ハイパーリンクのアドレス スペースで囲まれる可能性のある有効な非空URL
href base ドキュメントベースURL スペースで囲まれる可能性のある有効なURL
hreflang a; link リンクされたリソースの言語 有効なBCP 47言語タグ
http-equiv meta プラグマ指令 "content-type"; "default-style"; "refresh"; "x-ua-compatible"; "content-security-policy"
id HTML要素 要素のID テキスト*
imagesizes link 異なるページレイアウトに対する画像サイズ (rel="preload" の場合) 有効なソースサイズリスト
imagesrcset link 高解像度ディスプレイや小さなモニターなど、さまざまな状況で使用する画像 (rel="preload" の場合) 画像候補文字列のカンマ区切りリスト
inert HTML要素 要素がinertであるかどうか ブール属性
inputmode HTML要素 入力モダリティを選択するためのヒント "none"; "text"; "tel"; "email"; "url"; "numeric"; "decimal"; "search"
integrity link; script Subresource Integrityチェックで使用される整合性メタデータ[SRI] テキスト
is HTML要素 カスタマイズされた組み込み要素を作成 有効なカスタム要素名、定義されたカスタマイズされた組み込み要素
ismap img 画像がサーバーサイドイメージマップであるかどうか ブール属性
itemid HTML要素 マイクロデータ項目のグローバル識別子 スペースで囲まれる可能性のある有効なURL
itemprop HTML要素 マイクロデータ項目のプロパティ名 一意なスペース区切りトークンの順不同セット、有効な絶対URL、定義されたプロパティ名、またはテキスト*
itemref HTML要素 参照された要素 一意なスペース区切りトークンの順不同セット、IDで構成される*
itemscope HTML要素 マイクロデータ項目を導入 ブール属性
itemtype HTML要素 マイクロデータ項目の項目タイプ 一意なスペース区切りトークンの順不同セット、有効な絶対URLで構成される*
kind track テキストトラックのタイプ "subtitles"; "captions"; "descriptions"; "chapters"; "metadata"
label optgroup; option; track ユーザーに表示されるラベル テキスト
lang HTML要素 要素の言語 有効なBCP 47言語タグまたは空の文字列
list input オートコンプリートオプションのリスト ID*
loading iframe; img ローディング遅延を決定する際に使用 "lazy"; "eager"
loop audio; video メディアリソースをループ再生するかどうか ブール属性
low meter 低範囲の上限 有効な浮動小数点数*
max input 最大値 さまざまな値*
max meter; progress 範囲の上限 有効な浮動小数点数*
maxlength input; textarea 値の最大長さ 有効な非負整数
media link; meta; source; style 適用可能なメディア 有効なメディアクエリリスト
method form フォーム送信に使用するバリアント "GET"; "POST"; "dialog"
min input 最小値 さまざまな値*
min meter 範囲の下限 有効な浮動小数点数*
minlength input; textarea 値の最小長さ 有効な非負整数
multiple input; select 複数の値を許可するかどうか ブール属性
muted audio; video メディアリソースをデフォルトでミュートにするかどうか ブール属性
name button; fieldset; input; output; select; textarea; フォーム関連のカスタム要素 フォーム送信およびform.elements APIで使用する要素の名前 テキスト*
name details 相互排他的なdetails要素のグループ名 テキスト*
name form document.forms APIで使用するフォームの名前 テキスト*
name iframe; object コンテンツナビゲーションの名前 有効なナビゲーブルターゲット名またはキーワード
name map usemap属性からイメージマップを参照するための名前 テキスト*
name meta メタデータの名前 テキスト*
name slot シャドウツリースロットの名前 テキスト
nomodule script モジュールスクリプトをサポートするユーザーエージェントで実行を防ぐ ブール属性
nonce HTML要素 Content Security Policyチェックで使用される暗号化ノンス[CSP] テキスト
novalidate form フォーム送信のためのフォームコントロールの検証をバイパス ブール属性
open details 詳細が表示されているかどうか ブール属性
open dialog ダイアログボックスが表示されているかどうか ブール属性
optimum meter ゲージの最適値 有効な浮動小数点数*
pattern input フォームコントロールの値と一致するパターン 正規表現はJavaScriptのPattern生成物に一致する
ping a; area URLにpingを送信 スペース区切りトークンのセット、有効な非空URLで構成される
placeholder input; textarea フォームコントロール内に表示されるユーザー向けラベル テキスト*
playsinline video ユーザーエージェントが要素の再生エリア内でビデオコンテンツを表示するよう推奨 ブール属性
popover HTML要素 要素をポップオーバー要素にする "auto"; "manual";
popovertarget button; input ポップオーバー要素を切り替える、表示する、または隠すためのターゲット ID*
popovertargetaction button; input ターゲットのポップオーバー要素が切り替え、表示、または隠されるかを示す "toggle"; "show"; "hide"
poster video ビデオ再生前に表示されるポスターフレーム 有効な非空URL（スペースに囲まれている可能性あり）
preload audio; video メディアリソースが必要とするバッファリング量のヒント "none"; "metadata"; "auto"
readonly input; textarea ユーザーが値を編集できるかどうか ブール属性
readonly フォーム関連のカスタム要素 willValidate に影響を与える他、カスタム要素の作成者が追加する任意の動作 ブール属性
referrerpolicy a; area; iframe; img; link; script 要素によって開始されるフェッチの参照ポリシー 参照ポリシー
rel a; area ドキュメント内のハイパーリンクと宛先リソースの間の関係 ユニークなスペース区切りトークンの非順序セット*
rel link ハイパーリンクを含むドキュメントと宛先リソースの間の関係 ユニークなスペース区切りトークンの非順序セット*
required input; select; textarea フォーム送信にこのコントロールが必要かどうか ブール属性
reversed ol リストを逆順に番号付けするかどうか ブール属性
rows textarea 表示する行数 ゼロより大きい有効な非負整数
rowspan td; th セルがまたがる行数 有効な非負整数
sandbox iframe ネストされたコンテンツのセキュリティルール ユニークなスペース区切りトークンの非順序セット、ASCIIケースインセンシティブ、以下の項目から成る
scope th ヘッダーセルが適用されるセルを指定 "row"; "col"; "rowgroup"; "colgroup"
selected option デフォルトでオプションが選択されているかどうか ブール属性
shadowrootclonable template 宣言的シャドウルートにクローン可能を設定 ブール属性
shadowrootcustomelementregistry template 宣言的なシャドウルートがカスタム要素レジストリを使用することを示すことを有効にします ブール属性
shadowrootdelegatesfocus template 宣言的シャドウルートにフォーカス委譲を設定 ブール属性
shadowrootmode template ストリーミング宣言的シャドウルートを有効化 "open"; "closed"
shadowrootserializable template 宣言的シャドウルートにシリアライズ可能を設定 ブール属性
shape area イメージマップに作成される形状の種類 "circle"; "default"; "poly"; "rect"
size input; select コントロールのサイズ ゼロより大きい有効な非負整数
sizes link アイコンのサイズ（rel="icon"の場合） ユニークなスペース区切りトークンの非順序セット、ASCIIケースインセンシティブ、サイズから構成される*
sizes img; source 異なるページレイアウトのための画像サイズ 有効なソースサイズリスト
slot HTML要素 要素の希望するスロット テキスト
span col; colgroup 要素がまたがる列数 ゼロより大きい有効な非負整数
spellcheck HTML要素 要素がスペルチェックや文法チェックを受けるかどうか "true"; "false"; 空文字列
src audio; embed; iframe; img; input; script; source (videoまたはaudio内); track; video リソースのアドレス 有効な空白で囲まれている可能性のある非空のURL
srcdoc iframe iframeにレンダリングするドキュメント iframe srcdoc ドキュメントのソース*
srclang track テキストトラックの言語 有効なBCP 47言語タグ
srcset img; source 異なる状況で使用される画像（例: 高解像度ディスプレイ、小さなモニターなど） 画像候補文字列のカンマ区切りリスト
start ol リストの開始値 有効な整数
step input フォームコントロールの値に一致させるグラニュラリティ ゼロより大きい有効な浮動小数点数、または"any"
style HTML要素 プレゼンテーションおよびフォーマットの指示 CSS宣言*
tabindex HTML要素 要素がフォーカス可能かどうか、および順次フォーカス可能かどうか、および順次フォーカスナビゲーションの目的で要素の相対的な順序 有効な整数
target a; area ナビゲーブルのハイパーリンク ナビゲーション 有効なナビゲーブルターゲット名またはキーワード
target base ナビゲーブルのデフォルト設定で、ハイパーリンク ナビゲーションおよびフォーム送信の際に使用される 有効なナビゲーブルターゲット名またはキーワード
target form ナビゲーブルのフォーム送信の際に使用される 有効なナビゲーブルターゲット名またはキーワード
title HTML要素 要素に関するアドバイザリ情報 テキスト
title abbr; dfn 略語の完全な用語または展開形 テキスト
title input pattern属性と一緒に使用する際のパターンの説明 テキスト
title link リンクのタイトル テキスト
title link; style CSSスタイルシートセット名 テキスト
translate HTML要素 ページがローカライズされる際に、要素が翻訳されるかどうか "yes"; "no"
type a; link 参照リソースのタイプに関するヒント 有効なMIMEタイプ文字列
type button ボタンのタイプ "submit"; "reset"; "button"
type embed; object; source 埋め込みリソースのタイプ 有効なMIMEタイプ文字列
type input フォームコントロールのタイプ inputタイプキーワード
type ol リストマーカーの種類 "1"; "a"; "A"; "i"; "I"
type script スクリプトのタイプ "module"; 有効なMIMEタイプ文字列で、JavaScript MIMEタイプエッセンス一致ではないもの
usemap img 使用するイメージマップの名前 有効なハッシュ名参照*
value button; option フォーム送信のために使用される値 テキスト
value data 機械可読値 テキスト*
value input フォームコントロールの値 さまざま*
value li リストアイテムの序数値 有効な整数
value meter; progress 要素の現在の値 有効な浮動小数点数
width canvas; embed; iframe; img; input; object; source (picture内); video 水平方向の寸法 有効な非負整数
wrap textarea フォーム送信の際に、フォームコントロールの値をどのようにラップするか "soft"; "hard"
writingsuggestions HTML要素 要素が執筆の提案を提供できるかどうか "true"; "false"; 空文字列

セルにアスタリスク (*) が付いている場合、そのルールが上記の表よりも複雑であることを示しています。

HTMLElement/drag_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+

HTMLElement/dragend_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+

HTMLElement/dragenter_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+

HTMLElement/dragleave_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+

HTMLElement/dragover_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+

HTMLElement/dragstart_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+

HTMLElement/drop_event

すべての現行エンジンでサポートされています。

Firefox9+ Safari3.1+ Chrome1+
Opera12+ Edge79+
Edge (Legacy)12+ Internet Explorer9+
Firefox Android? Safari iOS? Chrome Android? WebView Android? Samsung Internet? Opera Android12+
イベントハンドラーコンテンツ属性のリスト
属性 要素 説明 値
onafterprint body afterprint イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onauxclick HTML 要素 auxclick イベントハンドラー イベントハンドラーコンテンツ属性
onbeforeinput HTML 要素 beforeinput イベントハンドラー イベントハンドラーコンテンツ属性
onbeforematch HTML 要素 beforematch イベントハンドラー イベントハンドラーコンテンツ属性
onbeforeprint body beforeprint イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onbeforeunload body beforeunload イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onbeforetoggle HTML 要素 beforetoggle イベントハンドラー イベントハンドラーコンテンツ属性
onblur HTML 要素 blur イベントハンドラー イベントハンドラーコンテンツ属性
oncancel HTML 要素 cancel イベントハンドラー イベントハンドラーコンテンツ属性
oncanplay HTML 要素 canplay イベントハンドラー イベントハンドラーコンテンツ属性
oncanplaythrough HTML 要素 canplaythrough イベントハンドラー イベントハンドラーコンテンツ属性
onchange HTML 要素 change イベントハンドラー イベントハンドラーコンテンツ属性
onclick HTML 要素 click イベントハンドラー イベントハンドラーコンテンツ属性
onclose HTML 要素 close イベントハンドラー イベントハンドラーコンテンツ属性
oncommand HTML 要素 command イベントハンドラ イベントハンドラコンテンツ属性
oncontextlost HTML 要素 contextlost イベントハンドラー イベントハンドラーコンテンツ属性
oncontextmenu HTML 要素 contextmenu イベントハンドラー イベントハンドラーコンテンツ属性
oncontextrestored HTML 要素 contextrestored イベントハンドラー イベントハンドラーコンテンツ属性
oncopy HTML 要素 copy イベントハンドラー イベントハンドラーコンテンツ属性
oncuechange HTML 要素 cuechange イベントハンドラー イベントハンドラーコンテンツ属性
oncut HTML 要素 cut イベントハンドラー イベントハンドラーコンテンツ属性
ondblclick HTML 要素 dblclick イベントハンドラー イベントハンドラーコンテンツ属性
ondrag HTML 要素 drag イベントハンドラー イベントハンドラーコンテンツ属性
ondragend HTML 要素 dragend イベントハンドラー イベントハンドラーコンテンツ属性
ondragenter HTML 要素 dragenter イベントハンドラー イベントハンドラーコンテンツ属性
ondragleave HTML 要素 dragleave イベントハンドラー イベントハンドラーコンテンツ属性
ondragover HTML 要素 dragover イベントハンドラー イベントハンドラーコンテンツ属性
ondragstart HTML 要素 dragstart イベントハンドラー イベントハンドラーコンテンツ属性
ondrop HTML 要素 drop イベントハンドラー イベントハンドラーコンテンツ属性
ondurationchange HTML 要素 durationchange イベントハンドラー イベントハンドラーコンテンツ属性
onemptied HTML 要素 emptied イベントハンドラー イベントハンドラーコンテンツ属性
onended HTML 要素 ended イベントハンドラー イベントハンドラーコンテンツ属性
onerror HTML 要素 error イベントハンドラー イベントハンドラーコンテンツ属性
onfocus HTML 要素 focus イベントハンドラー イベントハンドラーコンテンツ属性
onformdata HTML 要素 formdata イベントハンドラー イベントハンドラーコンテンツ属性
onhashchange body hashchange イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
oninput HTML 要素 input イベントハンドラー イベントハンドラーコンテンツ属性
oninvalid HTML 要素 invalid イベントハンドラー イベントハンドラーコンテンツ属性
onkeydown HTML 要素 keydown イベントハンドラー イベントハンドラーコンテンツ属性
onkeypress HTML 要素 keypress イベントハンドラー イベントハンドラーコンテンツ属性
onkeyup HTML 要素 keyup イベントハンドラー イベントハンドラーコンテンツ属性
onlanguagechange body languagechange イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onload HTML 要素 load イベントハンドラー イベントハンドラーコンテンツ属性
onloadeddata HTML 要素 loadeddata イベントハンドラー イベントハンドラーコンテンツ属性
onloadedmetadata HTML 要素 loadedmetadata イベントハンドラー イベントハンドラーコンテンツ属性
onloadstart HTML 要素 loadstart イベントハンドラー イベントハンドラーコンテンツ属性
onmessage body message イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onmessageerror body messageerror イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onmousedown HTML 要素 mousedown イベントハンドラー イベントハンドラーコンテンツ属性
onmouseenter HTML 要素 mouseenter イベントハンドラー イベントハンドラーコンテンツ属性
onmouseleave HTML 要素 mouseleave イベントハンドラー イベントハンドラーコンテンツ属性
onmousemove HTML 要素 mousemove イベントハンドラー イベントハンドラーコンテンツ属性
onmouseout HTML 要素 mouseout イベントハンドラー イベントハンドラーコンテンツ属性
onmouseover HTML 要素 mouseover イベントハンドラー イベントハンドラーコンテンツ属性
onmouseup HTML 要素 mouseup イベントハンドラー イベントハンドラーコンテンツ属性
onoffline body offline イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
ononline body online イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onpagehide body pagehide イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onpagereveal body pagereveal イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onpageshow body pageshow イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onpageswap body pageswap イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onpaste HTML 要素 paste イベントハンドラー イベントハンドラーコンテンツ属性
onpause HTML 要素 pause イベントハンドラー イベントハンドラーコンテンツ属性
onplay HTML 要素 play イベントハンドラー イベントハンドラーコンテンツ属性
onplaying HTML 要素 playing イベントハンドラー イベントハンドラーコンテンツ属性
onpopstate body popstate イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onprogress HTML 要素 progress イベントハンドラー イベントハンドラーコンテンツ属性
onratechange HTML 要素 ratechange イベントハンドラー イベントハンドラーコンテンツ属性
onreset HTML 要素 reset イベントハンドラー イベントハンドラーコンテンツ属性
onresize HTML 要素 resize イベントハンドラー イベントハンドラーコンテンツ属性
onrejectionhandled body rejectionhandled イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onscroll HTML 要素 scroll イベントハンドラー イベントハンドラーコンテンツ属性
onscrollend HTML 要素 scrollend イベントハンドラー イベントハンドラーコンテンツ属性
onsecuritypolicyviolation HTML 要素 securitypolicyviolation イベントハンドラー イベントハンドラーコンテンツ属性
onseeked HTML 要素 seeked イベントハンドラー イベントハンドラーコンテンツ属性
onseeking HTML 要素 seeking イベントハンドラー イベントハンドラーコンテンツ属性
onselect HTML 要素 select イベントハンドラー イベントハンドラーコンテンツ属性
onslotchange HTML 要素 slotchange イベントハンドラー イベントハンドラーコンテンツ属性
onstalled HTML 要素 stalled イベントハンドラー イベントハンドラーコンテンツ属性
onstorage body storage イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onsubmit HTML 要素 submit イベントハンドラー イベントハンドラーコンテンツ属性
onsuspend HTML 要素 suspend イベントハンドラー イベントハンドラーコンテンツ属性
ontimeupdate HTML 要素 timeupdate イベントハンドラー イベントハンドラーコンテンツ属性
ontoggle HTML 要素 toggle イベントハンドラー イベントハンドラーコンテンツ属性
onunhandledrejection body unhandledrejection イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onunload body unload イベントハンドラー for Window オブジェクト イベントハンドラーコンテンツ属性
onvolumechange HTML 要素 volumechange イベントハンドラー イベントハンドラーコンテンツ属性
onwaiting HTML 要素 waiting イベントハンドラー イベントハンドラーコンテンツ属性
onwheel HTML 要素 wheel イベントハンドラー イベントハンドラーコンテンツ属性

要素インターフェース

このセクションは規範的ではありません。

要素のインターフェース一覧
要素 インターフェース
a HTMLAnchorElement : HTMLElement
abbr HTMLElement
address HTMLElement
area HTMLAreaElement : HTMLElement
article HTMLElement
aside HTMLElement
audio HTMLAudioElement : HTMLMediaElement : HTMLElement
b HTMLElement
base HTMLBaseElement : HTMLElement
bdi HTMLElement
bdo HTMLElement
blockquote HTMLQuoteElement : HTMLElement
body HTMLBodyElement : HTMLElement
br HTMLBRElement : HTMLElement
button HTMLButtonElement : HTMLElement
canvas HTMLCanvasElement : HTMLElement
caption HTMLTableCaptionElement : HTMLElement
cite HTMLElement
code HTMLElement
col HTMLTableColElement : HTMLElement
colgroup HTMLTableColElement : HTMLElement
data HTMLDataElement : HTMLElement
datalist HTMLDataListElement : HTMLElement
dd HTMLElement
del HTMLModElement : HTMLElement
details HTMLDetailsElement : HTMLElement
dfn HTMLElement
dialog HTMLDialogElement : HTMLElement
div HTMLDivElement : HTMLElement
dl HTMLDListElement : HTMLElement
dt HTMLElement
em HTMLElement
embed HTMLEmbedElement : HTMLElement
fieldset HTMLFieldSetElement : HTMLElement
figcaption HTMLElement
figure HTMLElement
footer HTMLElement
form HTMLFormElement : HTMLElement
h1 HTMLHeadingElement : HTMLElement
h2 HTMLHeadingElement : HTMLElement
h3 HTMLHeadingElement : HTMLElement
h4 HTMLHeadingElement : HTMLElement
h5 HTMLHeadingElement : HTMLElement
h6 HTMLHeadingElement : HTMLElement
head HTMLHeadElement : HTMLElement
header HTMLElement
hgroup HTMLElement
hr HTMLHRElement : HTMLElement
html HTMLHtmlElement : HTMLElement
i HTMLElement
iframe HTMLIFrameElement : HTMLElement
img HTMLImageElement : HTMLElement
input HTMLInputElement : HTMLElement
ins HTMLModElement : HTMLElement
kbd HTMLElement
label HTMLLabelElement : HTMLElement
legend HTMLLegendElement : HTMLElement
li HTMLLIElement : HTMLElement
link HTMLLinkElement : HTMLElement
main HTMLElement
map HTMLMapElement : HTMLElement
mark HTMLElement
menu HTMLMenuElement : HTMLElement
meta HTMLMetaElement : HTMLElement
meter HTMLMeterElement : HTMLElement
nav HTMLElement
noscript HTMLElement
object HTMLObjectElement : HTMLElement
ol HTMLOListElement : HTMLElement
optgroup HTMLOptGroupElement : HTMLElement
option HTMLOptionElement : HTMLElement
output HTMLOutputElement : HTMLElement
p HTMLParagraphElement : HTMLElement
picture HTMLPictureElement : HTMLElement
pre HTMLPreElement : HTMLElement
progress HTMLProgressElement : HTMLElement
q HTMLQuoteElement : HTMLElement
rp HTMLElement
rt HTMLElement
ruby HTMLElement
s HTMLElement
samp HTMLElement
search HTMLElement
script HTMLScriptElement : HTMLElement
section HTMLElement
select HTMLSelectElement : HTMLElement
slot HTMLSlotElement : HTMLElement
small HTMLElement
source HTMLSourceElement : HTMLElement
span HTMLSpanElement : HTMLElement
strong HTMLElement
style HTMLStyleElement : HTMLElement
sub HTMLElement
summary HTMLElement
sup HTMLElement
table HTMLTableElement : HTMLElement
tbody HTMLTableSectionElement : HTMLElement
td HTMLTableCellElement : HTMLElement
template HTMLTemplateElement : HTMLElement
textarea HTMLTextAreaElement : HTMLElement
tfoot HTMLTableSectionElement : HTMLElement
th HTMLTableCellElement : HTMLElement
thead HTMLTableSectionElement : HTMLElement
time HTMLTimeElement : HTMLElement
title HTMLTitleElement : HTMLElement
tr HTMLTableRowElement : HTMLElement
track HTMLTrackElement : HTMLElement
u HTMLElement
ul HTMLUListElement : HTMLElement
var HTMLElement
video HTMLVideoElement : HTMLMediaElement : HTMLElement
wbr HTMLElement
custom elements supplied by the element's author (inherits from HTMLElement)

すべてのインターフェース

このセクションは規範的ではありません。

イベント

このセクションは規範的ではありません。

次の表は、このドキュメントによって発生するイベントを示していますが、メディア要素のイベントやドラッグ＆ドロップのイベントに既に定義されているものは除外されています。

イベントの一覧
イベント インターフェース 対象となる要素 説明
DOMContentLoaded

Window/DOMContentLoaded_event

Support in all current engines.

Firefox1+Safari3.1+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android10.1+
Event Document パーサーが完了した後にDocumentで発生します
afterprint

Window/afterprint_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari13+Chrome63+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event Window 印刷後にWindowで発生します
beforeprint

Window/beforeprint_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari13+Chrome63+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event Window 印刷前にWindowで発生します
beforematch

Element/beforematch_event

1つのエンジンでのみサポートされています。

FirefoxNoSafariNoChrome102+
OperaNoEdge102+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event Elements hidden=until-found属性を持つ要素が、表示される前に発生します。
beforetoggle

HTMLElement/beforetoggle_event

すべての現在のエンジンでサポートされています。

Firefox🔰 114+Safaripreview+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
ToggleEvent Elements popover属性を持つ要素が表示と非表示の間を遷移するときに発生します。
beforeunload

Window/beforeunload_event

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera12+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android12+
BeforeUnloadEvent Window ページがアンロードされる直前にWindowで発生し、ページが警告プロンプトを表示したい場合に使用されます。
blur Event Window, elements フォーカスが外れたときにノードで発生します。focusedノードで発生します。
cancel

HTMLDialogElement/cancel_event

すべての現在のエンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome AndroidNoWebView Android?Samsung Internet?Opera Android?
Event CloseWatcher, dialog elements, input elements CloseWatcher オブジェクトまたは dialog 要素が クローズリクエスト を受信したとき、または input 要素の type 属性が ファイル 状態で、ユーザーが選択を変更しない場合に発行されます
change

HTMLElement/change_event

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera9+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
Event Form controls ユーザーが値の変更を確定したときにフォームコントロールで発生します（inputイベントも参照してください）。
click PointerEvent 要素 通常はマウスイベントですが、要素のアクティベーション動作が実行される前に、非ポインタ入力デバイス（例：キーボード）から要素がアクティブ化されるときにも合成的に発火します
close

HTMLDialogElement/close_event

すべての現在のエンジンでサポートされています。

Firefox98+Safari15.4+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event CloseWatcher, dialog elements, MessagePort CloseWatcher オブジェクトや dialog 要素が close request または ウェブ開発者コードによって閉じられるとき、または MessagePort オブジェクトが 解き放たれたときに発火します
command CommandEvent 要素 commandfor 属性を介してユーザーの呼び出しを処理するときに要素で発生します。
connect

SharedWorkerGlobalScope/connect_event

すべての現在のエンジンでサポートされています。

Firefox29+Safari16+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS16+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
MessageEvent SharedWorkerGlobalScope 新しいクライアントが接続する際に、共有ワーカーのグローバルスコープで発火します
contextlost

HTMLCanvasElement/webglcontextlost_event

1つのエンジンのみでサポートされています。

FirefoxNoSafariNoChrome98+
Opera?Edge98+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event canvas elements, OffscreenCanvas objects 対応するCanvasRenderingContext2D または OffscreenCanvasRenderingContext2D が失われたときに発火します
contextrestored

HTMLCanvasElement/contextrestored_event

1つのエンジンのみでサポートされています。

FirefoxNoSafariNoChrome98+
Opera?Edge98+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event canvas elements, OffscreenCanvas objects 対応するCanvasRenderingContext2D または OffscreenCanvasRenderingContext2D が失われた後に復元されたときに発火します
currententrychange NavigationCurrentEntryChangeEvent Navigation navigation.currentEntry が変更されたときに発生
dispose Event NavigationHistoryEntry セッション履歴エントリ に対応する NavigationHistoryEntry がセッション履歴から永久に削除され、もはや移動できないときに発生
error

EventSource/error_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

Window/error_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5.1+Chrome10+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
Event または ErrorEvent グローバルスコープオブジェクト、Worker オブジェクト、 要素、 ネットワーキング関連オブジェクト 意図しないエラーが発生したとき（例えば、ネットワークエラー、スクリプトエラー、デコーディングエラー）
focus Event Window、要素 フォーカスを得る ノードで発生
formdata

HTMLFormElement/formdata_event

すべての現在のエンジンでサポートされています。

Firefox72+Safari15+Chrome77+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
FormDataEvent form 要素 form 要素で、エントリーリストを構築している ときに発生
hashchange

Window/hashchange_event

すべての現在のエンジンでサポートされています。

Firefox3.6+Safari5+Chrome8+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android11+
HashChangeEvent Window Window の フラグメント 部分が変更されたときに発生します ドキュメントの URL
input Event 要素 ユーザーが contenteditable 要素の内容やフォームコントロールの値を変更したときに発生します。フォームコントロールの change イベントも参照してください。
invalid

HTMLInputElement/invalid_event

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome10+
Opera10+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android64+Safari iOS5+Chrome Android?WebView Android4+Samsung Internet4.0+Opera Android12+
Event フォームコントロール フォーム検証中に、コントロールが制約を満たさない場合に発生します
languagechange

Window/languagechange_event

すべての現在のエンジンでサポートされています。

Firefox32+Safari10.1+Chrome37+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android4+Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?

WorkerGlobalScope/languagechange_event

すべての現在のエンジンでサポートされています。

Firefox74+Safari4+Chrome4+
Opera11.5+Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
Event グローバルスコープオブジェクト ユーザーの優先言語が変更されたときに、グローバルスコープオブジェクトで発生します
load Event Window、要素 ドキュメントの読み込みが完了したときに Window で発生します。また、リソース（例: img、embed）を含む要素がリソースの読み込みを完了したときにも発生します。
message

BroadcastChannel/message_event

すべての現在のエンジンでサポートされています。

Firefox38+Safari15.4+Chrome54+
Opera?Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

DedicatedWorkerGlobalScope/message_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+

EventSource/message_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome6+
Opera12+Edge79+
Edge (Legacy)?Internet ExplorerNo
Firefox Android45+Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android12+

MessagePort/message_event

すべての現在のエンジンでサポートされています。

Firefox41+Safari5+Chrome2+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+

Window/message_event

すべての現在のエンジンでサポートされています。

Firefox9+Safari4+Chrome60+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer8+
Firefox Android?Safari iOS4+Chrome Android?WebView Android?Samsung Internet?Opera Android47+

Worker/message_event

すべての現在のエンジンでサポートされています。

Firefox3.5+Safari4+Chrome4+
Opera10.6+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android11.5+
MessageEvent Window、EventSource、MessagePort、BroadcastChannel、DedicatedWorkerGlobalScope、Worker、ServiceWorkerContainer メッセージを受信したときにオブジェクトで発生します
messageerror

BroadcastChannel/messageerror_event

すべての現在のエンジンでサポートされています。

Firefox57+Safari15.4+Chrome60+
Opera?Edge79+
Edge (Legacy)?Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

DedicatedWorkerGlobalScope/messageerror_event

すべての現在のエンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

MessagePort/messageerror_event

すべての現在のエンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

Window/messageerror_event

すべての現在のエンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+

Worker/messageerror_event

すべての現在のエンジンでサポートされています。

Firefox57+Safari16.4+Chrome60+
Opera?Edge79+
Edge (Legacy)18Internet Explorer対応していません
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android47+
MessageEvent Window, MessagePort, BroadcastChannel, DedicatedWorkerGlobalScope, Worker, ServiceWorkerContainer デシリアライズできないメッセージを受信したときにオブジェクトで発生します。
navigate NavigateEvent Navigation ナビゲーション可能 ナビゲーション、リロード、履歴の移動、またはその他の変更が行われる前に発火するURL
navigateerror ErrorEvent Navigation ナビゲーションが正常に完了しなかったときに発火する
navigatesuccess Event Navigation ナビゲーションが正常に完了したときに発火する
offline

Window/offline_event

全ての現在のエンジンでサポートされています。

Firefox9+Safari4+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
Event グローバルスコープオブジェクト ネットワーク接続が失敗したときにグローバルスコープオブジェクトで発火する
online

Window/online_event

全ての現在のエンジンでサポートされています。

Firefox9+Safari4+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS3+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
Event グローバルスコープオブジェクト ネットワーク接続が復帰したときにグローバルスコープオブジェクトで発火する
open

EventSource/open_event

全ての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome12+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer—
Firefox Android?Safari iOS5+Chrome Android?WebView Android?Samsung Internet?Opera Android?
Event EventSource オブジェクト イベントソースとの接続が確立されたときに発火する
pageswap PageSwapEvent Window Window で発生し、ドキュメントがナビゲーションの結果として アンロード される直前。
pagehide

Window/pagehide_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
PageTransitionEvent Window Window で発生し、ページの セッション履歴エントリ が アクティブエントリ でなくなるとき。
pagereveal PageRevealEvent Window Window で発生し、ページが 初めてレンダリングを開始したとき、または 再アクティブ化 された後。
pageshow

Window/pageshow_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari5+Chrome3+
Opera?Edge79+
Edge (Legacy)12+Internet Explorer11
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android?
PageTransitionEvent Window Window で発生し、ページの セッション履歴エントリ が アクティブエントリ になるとき。
pointercancel PointerEvent Text ユーザーがドラッグアンドドロップ操作を開始しようとしたときに ソースノード で発生するイベント。
popstate

Window/popstate_event

すべての現在のエンジンでサポートされています。

Firefox4+Safari5+Chrome5+
Opera11.5+Edge79+
Edge (Legacy)12+Internet Explorer10+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android11.5+
PopStateEvent Window Window で発生し、セッション履歴のトラバース の一部のケースで。
readystatechange

Document/readystatechange_event

すべての現在のエンジンでサポートされています。

Firefox4+Safari5.1+Chrome9+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS?Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
Event Document Document が解析を終え、すべてのサブリソースの読み込みが完了すると発火します
rejectionhandled PromiseRejectionEvent グローバルスコープオブジェクト 以前に未処理の約束拒否が処理されると、グローバルスコープオブジェクトで発火します
reset

HTMLFormElement/reset_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari3+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android37+Samsung Internet?Opera Android12.1+
Event form 要素 form 要素が リセット されたときに発火します
select

HTMLInputElement/select_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+

HTMLTextAreaElement/select_event

すべての現在のエンジンでサポートされています。

Firefox6+Safari1+Chrome1+
Opera12.1+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android12.1+
Event フォームコントロール テキスト選択が調整されたとき（APIによってまたはユーザーによって）フォームコントロールで発火します
storage

Window/storage_event

すべての現在のエンジンでサポートされています。

Firefox45+Safari4+Chrome1+
Opera?Edge79+
Edge (Legacy)15+Internet Explorer9+
Firefox Android?Safari iOS4+Chrome Android?WebView Android37+Samsung Internet?Opera Android?
StorageEvent Window Window イベントで発火します localStorage または sessionStorage ストレージ領域が変更されたとき
submit

HTMLFormElement/submit_event

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera8+Edge79+
Edge (Legacy)12+Internet Explorer9+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
SubmitEvent form 要素 form 要素が 送信 されたときに発火します
toggle

HTMLDetailsElement/toggle_event

すべての現在のエンジンでサポートされています。

Firefox49+Safari10.1+Chrome36+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?

HTMLElement/toggle_event

すべての現在のエンジンでサポートされています。

Firefox🔰 114+Safariプレビュー+Chrome114+
Opera?Edge114+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS?Chrome Android?WebView Android?Samsung Internet?Opera Android?
ToggleEvent details および popover 要素 details 要素が開いたり閉じたりするときに発火します。popover 属性を持つ要素で、表示と非表示の間を遷移する際に発火します
unhandledrejection

Window/unhandledrejection_event

すべての現在のエンジンでサポートされています。

Firefox69+Safari11+Chrome49+
Opera?Edge79+
Edge (Legacy)?Internet Explorerなし
Firefox Android?Safari iOS11.3+Chrome Android?WebView Android?Samsung Internet?Opera Android?
PromiseRejectionEvent グローバルスコープオブジェクト プロミスの拒否が処理されないときに、グローバルスコープオブジェクトで発火します
unload

Window/unload_event

すべての現在のエンジンでサポートされています。

Firefox1+Safari3+Chrome1+
Opera4+Edge79+
Edge (Legacy)12+Internet Explorer4+
Firefox Android?Safari iOS1+Chrome Android?WebView Android?Samsung Internet?Opera Android10.1+
Event Window Window オブジェクトで発火します ページが 去るときに
visibilitychange

Document/visibilitychange_event

すべての現在のエンジンでサポートされています。

Firefox56+Safari14.1+Chrome62+
Opera49+Edge79+
Edge (Legacy)18Internet Explorer🔰 10+
Firefox Android?Safari iOS?Chrome Android?WebView Android62+Samsung Internet?Opera Android46+
Event Document Document オブジェクトがユーザーに対してページが表示されたり非表示になったりする際に発生します

HTTP ヘッダー

このセクションは非規範的です。

この仕様によって定義される HTTP リクエストヘッダーは次のとおりです：

この仕様によって定義される HTTP レスポンスヘッダーは次のとおりです：

MIME タイプ

このセクションは非規範的です。

この仕様で言及されている MIME タイプは次のとおりです：

application/atom+xml
Atom [ATOM]
application/json
JSON [JSON]
application/octet-stream
一般的なバイナリデータ [RFC2046]
application/microdata+json
Microdata を JSON 形式で
application/rss+xml
RSS
application/wasm
WebAssembly [WASM]
application/x-www-form-urlencoded
フォーム送信
application/xhtml+xml
HTML
application/xml
XML [XML] [RFC7303]
image/gif
GIF 画像 [GIF]
image/jpeg
JPEG 画像 [JPEG]
image/png
PNG 画像 [PNG]
image/svg+xml
SVG 画像 [SVG]
multipart/form-data
フォーム送信 [RFC7578]
multipart/mixed
一般的な混合コンテンツ [RFC2046]
multipart/x-mixed-replace
ストリーミングサーバープッシュ
text/css
CSS [CSS]
text/event-stream
サーバー送信イベントストリーム
text/javascript
JavaScript [JAVASCRIPT] [RFC9239]
text/json
JSON (レガシータイプ)
text/plain
一般的なプレーンテキスト [RFC2046] [RFC3676]
text/html
HTML
text/ping
ハイパーリンク監査
text/uri-list
URL のリスト [RFC2483]
text/vcard
vCard [RFC6350]
text/vtt
WebVTT [WEBVTT]
text/xml
XML [XML] [RFC7303]
video/mp4
MPEG-4 ビデオ [RFC4337]
video/mpeg
MPEG ビデオ [RFC2046]

参考文献

すべての参考文献は「非標準」とマークされていない限り、標準的なものです。

[ABNF]
文法仕様のための拡張BNF: ABNF、D. Crocker、P. Overell。IETF。
[ABOUT]
'about' URIスキーム、S. Moonesamy。IETF。
[APNG]
(非標準) APNG仕様。S. Parmenter、V. Vukicevic、A. Smith。Mozilla。
[ARIA]
アクセシブルリッチインターネットアプリケーション（WAI-ARIA）、J. Diggs、J. Nurthen、M. Cooper。W3C。
[ARIAHTML]
HTMLのARIA、S. Faulkner、S. O'Hara。W3C。
[ATAG]
(非標準) 著作ツールアクセシビリティガイドライン（ATAG）2.0、J. Richards、J. Spellman、J. Treviranus。W3C。
[ATOM]
(非標準) Atomシンジケーションフォーマット、M. Nottingham、R. Sayre。IETF。
[BATTERY]
(非標準) バッテリーステータスAPI、A. Kostiainen、M. Lamouri。W3C。
[BCP47]
言語識別タグ; 言語タグのマッチング、A. Phillips、M. Davis。IETF。
[BEZIER]
Courbes à poles、P. de Casteljau。INPI、1959年。
[BIDI]
UAX #9: Unicode双方向アルゴリズム、M. Davis。Unicode Consortium。
[BOCU1]
(非標準) UTN #6: BOCU-1: MIME互換Unicode圧縮、M. Scherer、M. Davis。Unicode Consortium。
[CESU8]
(非標準) UTR #26: UTF-16互換エンコーディングスキーム: 8-BIT (CESU-8)、T. Phipps。Unicode Consortium。
[CHARMOD]
(非標準) ワールドワイドウェブのための文字モデル 1.0: 基本、M. Dürst、F. Yergeau、R. Ishida、M. Wolf、T. Texin。W3C。
[CHARMODNORM]
(非標準) ワールドワイドウェブのための文字モデル: 文字列の一致、A. Phillips。W3C。
[CLIPBOARD-APIS]
クリップボードAPIとイベント、G. Kacmarcik、A. Snigdha。W3C。
[COMPOSITE]
合成とブレンド、R. Cabanier、N. Andronikos。W3C。
[COMPUTABLE]
(非標準) 計算可能な数について、決定問題への応用を含む、A. Turing。ロンドン数学会の会報、第2シリーズ、巻42、ページ230-265。ロンドン数学会、1937年。
[COMPUTEPRESSURE]
(非標準) 計算圧力、K. Christiansen、A. Mandy。W3C。
[CONSOLE]
コンソール、T. Stock、R. Kowalski、D. Farolino。WHATWG。
[COOKIES]
HTTP状態管理メカニズム、A. Barth。IETF。
[CREDMAN]
認証情報管理、N. Satragno、J. Hodges、M. West。W3C。
[CSP]
コンテンツセキュリティポリシー、M. West、D. Veditz。W3C。
[CSS]
カスケーディングスタイルシート レベル2 リビジョン2、B. Bos、T. Çelik、I. Hickson、H. Lie 著。W3C。
[CSSALIGN]
CSS ボックス配置、E. Etemad、T. Atkins 著。W3C。
[CSSANCHOR]
CSS アンカー配置、T. Atkins、E. Etemad、I. Kilpatrick 著。W3C。
[CSSANIMATIONS]
CSS アニメーション、D. Jackson、D. Hyatt、C. Marrin、S. Galineau、L. Baron 著。W3C。
[CSSATTR]
CSS スタイル属性、T. Çelik、E. Etemad 著。W3C。
[CSSBG]
CSS 背景と境界、B. Bos、E. Etemad、B. Kemper 著。W3C。
[CSSBOX]
CSS ボックスモデル、E. Etemad 著。W3C。
[CSSCASCADE]
CSS カスケーディングと継承、E. Etemad、T. Atkins 著。W3C。
[CSSCONTAIN]
CSS 包含、T. Atkins、F. Rivoal、V. Levin 著。W3C。
[CSSCOLOR]
CSS カラーモジュール、T. Çelik、C. Lilley、L. Baron 著。W3C。
[CSSCOLORADJUST]
CSS カラー調整モジュール、E. Etemad、R. Atanassov、R. Lillesveen、T. Atkins 著。W3C。
[CSSDEVICEADAPT]
CSS デバイス適応、F. Rivoal、M. Rakow 著。W3C。
[CSSDISPLAY]
CSS 表示、T. Atkins、E. Etemad 著。W3C。
[CSSFONTLOAD]
CSS フォント読み込み、T. Atkins、J. Daggett 著。W3C。
[CSSFONTS]
CSS フォント、J. Daggett 著。W3C。
[CSSFLEXBOX]
CSS フレキシブルボックスレイアウト、T. Atkins、E. Etemad、R. Atanassov 著。W3C。
[CSSGC]
CSS 生成コンテンツ、H. Lie、E. Etemad、I. Hickson 著。W3C。
[CSSGRID]
CSS グリッドレイアウト、T. Atkins、E. Etemad、R. Atanassov 著。W3C。
[CSSIMAGES]
CSS 画像モジュール、E. Etemad、T. Atkins、L. Verou 著。W3C。
[CSSIMAGES4]
CSS 画像モジュール レベル4、E. Etemad、T. Atkins、L. Verou 著。W3C。
[CSSINLINE]
CSS インラインレイアウト、D. Cramer、E. Etemad 著。W3C。
[CSSLISTS]
CSS リストとカウンター、T. Atkins 著。W3C。
[CSSLOGICAL]
CSS 論理プロパティ、R. Atanassov、E. Etemad 著。W3C。
[CSSMULTICOL]
CSS マルチカラムレイアウト、H. Lie、F. Rivoal、R. Andrew 著。W3C。
[CSSOM]
カスケーディングスタイルシート オブジェクトモデル (CSSOM)、S. Pieters、G. Adams 著。W3C。
[CSSOMVIEW]
CSSOM ビューモジュール、S. Pieters、G. Adams 著。W3C。
[CSSOVERFLOW]
CSS オーバーフローモジュール、L. Baron、F. Rivoal 著。W3C。
[CSSPAINT]
(非規範的) CSS ペイント API、I. Kilpatrick、D. Jackson 著。W3C。
[CSSPOSITION]
CSS 位置指定レイアウト、R. Atanassov、A. Eicholz 著。W3C。
[CSSPSEUDO]
CSS 疑似要素、D. Glazman、E. Etemad、A. Stearns 著。W3C。
[CSSRUBY]
CSS3 ルビモジュール、R. Ishida 著。W3C。
[CSSSCOPING]
CSS スコーピングモジュール、T. Atkins 著。W3C。
[CSSSIZING]
CSS ボックスサイジングモジュール、T. Atkins、E. Etemad 著。W3C。
[CSSSCROLLANCHORING]
(非規範的) CSS スクロールアンカー、T. Atkins-Bittner 著。W3C。
[CSSSYNTAX]
CSS 構文、T. Atkins、S. Sapin 著。W3C。
[CSSTRANSITIONS]
(非規範的) CSS トランジション、L. Baron、D. Jackson、B. Birtles 著。W3C。
[CSSTABLE]
CSS テーブル、F. Remy、G. Whitworth 著。W3C。
[CSSTEXT]
CSS テキスト、E. Etemad、K. Ishii 著。W3C。
[CSSVALUES]
CSS3 値と単位、H. Lie、T. Atkins、E. Etemad 著。W3C。
[CSSVIEWTRANSITIONS]
CSS ビュートランジション、T. Atkins Jr.、J. Archibald、K Sagar 著。W3C。
[CSSUI]
CSS3 基本ユーザーインターフェイスモジュール、F. Rivoal 著。W3C。
[CSSWM]
CSS 書字方向モード、E. Etemad、K. Ishii 著。W3C。
[DASH]
Dynamic adaptive streaming over HTTP (DASH)。ISO。
[DEVICEPOSTURE]
(非规范性) Device Posture API、D. Gonzalez-Zuniga、K. Christiansen。W3C。
[DOM]
DOM、A. van Kesteren、A. Gregor、 Ms2ger。 WHATWG。
[DOMPARSING]
DOM Parsing and Serialization、T. Leithead。 W3C。
[DOT]
(非规范性) The DOT Language。 Graphviz。
[E163]
Recommendation E.163 — Numbering Plan for The International Telephone Service、 CCITT Blue Book、 Fascicle II.2、pp. 128-134、November 1988。
[ENCODING]
Encoding、A. van Kesteren、J. Bell。 WHATWG。
[EXECCOMMAND]
execCommand、J. Wilm、A. Gregor。 W3C Editing APIs CG。
[EXIF]
(非规范性) Exchangeable image file format。JEITA。
[FETCH]
Fetch、A. van Kesteren。WHATWG。
[FETCH-METADATA]
フェッチメタデータリクエストヘッダー、M.West 著。W3C。
[FILEAPI]
File API、A. Ranganathan。W3C。
[FILTERS]
Filter Effects、D. Schulze、 D. Jackson、C. Harrelson。W3C。
[FULLSCREEN]
Fullscreen、A. van Kesteren、T. Çelik。 WHATWG。
[GEOMETRY]
Geometry Interfaces。S. Pieters、 D. Schulze、R. Cabanier。W3C。
[GIF]
(非规范性) Graphics Interchange Format。CompuServe。
[GRAPHICS]
(非规范性) Computer Graphics: Principles and Practice in C、Second Edition、J. Foley、A. van Dam、S. Feiner、J. Hughes。Addison-Wesley。ISBN 0-201-84840-6。
[GREGORIAN]
(非规范性) Inter Gravissimas、A. Lilius、C. Clavius。Gregory XIII Papal Bull、 February 1582。
[HRT]
High Resolution Time、I. Grigorik、J. Simonsen、J. Mann。W3C。
[HTMLAAM]
HTML Accessibility API Mappings 1.0、 S. Faulkner、 A. Surkov、S. O'Hara。W3C。
[HTTP]
Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing、R. Fielding、J. Reschke。IETF。
Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content、R. Fielding、J. Reschke。IETF。
Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests、R. Fielding、J. Reschke。IETF。
Hypertext Transfer Protocol (HTTP/1.1): Range Requests、R. Fielding、Y. Lafon、J. Reschke。IETF。
Hypertext Transfer Protocol (HTTP/1.1): Caching、R. Fielding、M. Nottingham、J. Reschke。IETF。
Hypertext Transfer Protocol (HTTP/1.1): Authentication、R. Fielding、J. Reschke。IETF。
[INDEXEDDB]
Indexed Database API、A. Alabbas、 J. Bell。 W3C。
[INBAND]
Sourcing In-band Media Resource Tracks from Media Containers into HTML、S. Pfeiffer、B. Lund。W3C。
[INFRA]
Infra、A. van Kesteren、D. Denicola。 WHATWG。
[INTERSECTIONOBSERVER]
Intersection Observer、 S. Zager。 W3C。
[RESIZEOBSERVER]
Resize Observer、O. Brufau、 E. Álvarez。W3C。
[ISO3166]
ISO 3166: Codes for the representation of names of countries and their subdivisions。ISO。
[ISO4217]
ISO 4217: Codes for the representation of currencies and funds。ISO。
[ISO8601]
(非规范性) ISO8601: Data elements and interchange formats — Information interchange — Representation of dates and times。ISO。
[JAVASCRIPT]
ECMAScript Language Specification。Ecma International。
[JLREQ]
Requirements for Japanese Text Layout。 W3C。
[JPEG]
JPEG File Interchange Format、E. Hamilton。
[JSERRORSTACKS]
(非规范性) Error Stacks。 Ecma International。
[JSDYNAMICCODEBRANDCHECKS]
動的コードブランドチェック. Ecma International.
[JSINTL]
ECMAScript 国際化 API 仕様. Ecma International.
[JSON]
JavaScript オブジェクト記法 (JSON) データ交換フォーマット, T. Bray. IETF.
[JSTEMPORAL]
Temporal. Ecma International.
[LONGTASKS]
ロングタスク, D. Denicola, I. Grigorik, S. Panicker. W3C.
[LONGANIMATIONFRAMES]
ロングアニメーションフレーム, N. Rosenthal. W3C.
[MAILTO]
(非規範的) 'mailto' URI スキーム, M. Duerst, L. Masinter, J. Zawinski. IETF.
[MANIFEST]
Web アプリマニフェスト, M. Caceres, K. Rohde Christiansen, M. Lamouri, A. Kostiainen, M. Giuca, A. Gustafson. W3C.
[MATHMLCORE]
数学的マークアップ言語 (MathML), D. Carlisle, Frédéric Wang. W3C.
[MEDIAFRAG]
メディアフラグメント URI, R. Troncy, E. Mannens, S. Pfeiffer, D. Van Deursen. W3C.
[MEDIASOURCE]
メディアソース拡張機能, A. Colwell, A. Bateman, M. Watson. W3C.
[MEDIASTREAM]
メディアキャプチャと ストリーム, D. Burnett, A. Bergkvist, C. Jennings, A. Narayanan. W3C.
[REPORTING]
レポーティング, D. Creager, I. Clelland, M. West. W3C.
[MFREL]
Microformats Wiki: 既存の rel 値. Microformats.
[MIMESNIFF]
MIME スニッフィング, G. Hemsley. WHATWG.
[MIX]
混合コンテンツ, M. West. W3C.
[MNG]
MNG (複数画像ネットワークグラフィックス) フォーマット. G. Randers-Pehrson.
[MPEG2]
ISO/IEC 13818-1: 情報技術 — 動画像および関連音声情報の一般的なコーディング: システム. ISO/IEC.
[MPEG4]
ISO/IEC 14496-12: ISO ベースメディアファイル形式. ISO/IEC.
[MQ]
メディアクエリ, H. Lie, T. Çelik, D. Glazman, A. van Kesteren. W3C.
[MULTIPLEBUFFERING]
(非規範的) 複数バッファリング. Wikipedia.
[NAVIGATIONTIMING]
ナビゲーションタイミング, Y. Weiss. W3C.
[NPAPI]
(非規範的) Gecko プラグイン API リファレンス. Mozilla.
[OGGSKELETONHEADERS]
SkeletonHeaders. Xiph.Org.
[OPENSEARCH]
HTML/XHTML での自動検出. In OpenSearch 1.1 Draft 6. GitHub.
[ORIGIN]
(非規範的) Web Origin コンセプト, A. Barth. IETF.
[PAINTTIMING]
ペイントタイミング, S. Panicker. W3C.
[PAYMENTREQUEST]
Payment Request API, M. Cáceres, D. Wang, R. Solomakhin, I. Jacobs. W3C.
[PDF]
(非規範的) 文書管理 — ポータブル文書形式 — 第 1 部: PDF. ISO.
[PERFORMANCETIMELINE]
パフォーマンスタイムライン, N. Peña Moreno, W3C.
[PERMISSIONSPOLICY]
パーミッションポリシー, I. Clelland, W3C.
[PICTUREINPICTURE]
(非規範的) ピクチャーインピクチャー, F. Beaufort, M. Lamouri, W3C
[PINGBACK]
Pingback 1.0, S. Langridge, I. Hickson.
[PNG]
ポータブルネットワークグラフィックス (PNG) 仕様, D. Duce. W3C.
[POINTEREVENTS]
ポインターイベント, J. Rossi, M. Brubeck, R. Byers, P. H. Lauke. W3C.
[POINTERLOCK]
ポインターロック, V. Scheib. W3C.
[PPUTF8]
(非規範的) UTF-8 の 特性と約束, M. Dürst. University of Zürich. In Proceedings of the 11th International Unicode Conference.
[PRESENTATION]
プレゼンテーション API, M. Foltz, D. Röttsches. W3C.
[REFERRERPOLICY]
リファラーポリシー, J. Eisinger, E. Stark. W3C.
[REQUESTIDLECALLBACK]
バックグラウンドタスクの協調スケジューリング, R. McIlroy, I. Grigorik. W3C.
[RESOURCETIMING]
リソースタイミング, Yoav Weiss; Noam Rosenthal. W3C.
[RFC1034]
ドメイン名 - 概念と施設, P. Mockapetris. IETF, November 1987.
[RFC1123]
インターネットホストの要件 -- アプリケーションとサポート, R. Braden. IETF, October 1989.
[RFC2046]
マルチパーパス インターネット メール拡張 (MIME) パート 2: メディアタイプ, N. Freed, N. Borenstein. IETF.
[RFC2397]
"data" URL スキーム, L. Masinter. IETF.
[RFC5545]
インターネットカレンダーおよびスケジューリングコアオブジェクト仕様 (iCalendar), B. Desruisseaux. IETF.
[RFC2483]
URN解決に必要なURI解決サービス, M. Mealling, R. Daniel. IETF.
[RFC3676]
Text/PlainフォーマットとDelSpパラメータ, R. Gellens. IETF.
[RFC9239]
ECMAScriptメディアタイプの更新, M. Miller, M. Borins, M. Bynens, B. Farias. IETF.
[RFC4337]
(非規範的) MPEG-4のMIMEタイプ登録, Y. Lim, D. Singer. IETF.
[RFC7595]
URIスキームのガイドラインおよび登録手順, D. Thaler, T. Hansen, T. Hardie. IETF.
[RFC5322]
インターネットメッセージフォーマット, P. Resnick. IETF.
[RFC6381]
"Codecs"および"Profiles"パラメータの「バケット」メディアタイプ, R. Gellens, D. Singer, P. Frojdh. IETF.
[RFC6266]
Hypertext Transfer Protocol (HTTP)におけるContent-Dispositionヘッダーの使用, J. Reschke. IETF.
[RFC6350]
vCardフォーマット仕様, S. Perreault. IETF.
[RFC6596]
カノニカルリンク関係, M. Ohye, J. Kupke. IETF.
[RFC6903]
追加のリンク関係タイプ, J. Snell. IETF.
[RFC7034]
(非規範的) HTTPヘッダーフィールドX-Frame-Options, D. Ross, T. Gondrom. IETF.
[RFC7303]
XMLメディアタイプ, H. Thompson, C. Lilley. IETF.
[RFC7578]
フォームからの値の返却: multipart/form-data, L. Masinter. IETF.
[RFC8297]
ヒントを示すHTTPステータスコード, K. Oku. IETF.
[SCREENORIENTATION]
スクリーンオリエンテーション, M. Cáceres. W3C.
[SCSU]
(非規範的) UTR #6: Unicode用の標準圧縮スキーム, M. Wolf, K. Whistler, C. Wicksteed, M. Davis, A. Freytag, M. Scherer. Unicode Consortium.
[SECURE-CONTEXTS]
セキュアコンテキスト, M. West. W3C.
[SELECTION]
選択API, R. Niwa. W3C.
[SELECTORS]
セレクター, E. Etemad, T. Çelik, D. Glazman, I. Hickson, P. Linss, J. Williams. W3C.
[SMS]
(非規範的) Global System for Mobile Communications (GSM) Short Message Service (SMS)のURIスキーム, E. Wilde, A. Vaha-Sipila. IETF.
[STRUCTURED-FIELDS]
HTTPの構造化フィールド値, M. Nottingham, P-H. Kamp. IETF.
[SRI]
サブリソースインテグリティ, D. Akhawe, F. Braun, F. Marier, J. Weinberger. W3C.
[STORAGE]
ストレージ, A. van Kesteren. WHATWG.
[SVG]
スケーラブルベクターグラフィックス (SVG) 2, N. Andronikos, R. Atanassov, T. Bah, B. Birtles, B. Brinza, C. Concolato, E. Dahlström, C. Lilley, C. McCormack, D. Schepers, R. Schwerdtfeger, D. Storey, S. Takagi, J. Watt. W3C.
[SW]
サービスワーカー, A. Russell, J. Song, J. Archibald. W3C.
[TOR]
(非規範的) Tor.
[TOUCH]
タッチイベント, D. Schepers, S. Moon, M. Brubeck, A. Barstow, R. Byers. W3C.
[TRUSTED-TYPES]
Trusted Types, K. Kotowicz, M. West. W3C.
[TZDATABASE]
(非規範的) タイムゾーンデータベース. IANA.
[UAAG]
(非規範的) ユーザーエージェントアクセシビリティガイドライン (UAAG) 2.0, J. Allan, K. Ford, J. Richards, J. Spellman. W3C.
[UIEVENTS]
UIイベント仕様, G. Kacmarcik, T. Leithead. W3C.
[UNICODE]
Unicode標準. Unicode Consortium.
[UNIVCHARDET]
(非規範的) 言語/エンコーディング検出への複合アプローチ, S. Li, K. Momoi. Netscape. In Proceedings of the 19th International Unicode Conference.
[URL]
URL, A. van Kesteren. WHATWG.
[URN]
URN構文, R. Moats. IETF.
[UTF7]
(非規範的) UTF-7: Unicodeのメール安全な変換形式, D. Goldsmith, M. Davis. IETF.
[UTF8DET]
(非規範的) 多言語フォームエンコーディング, M. Dürst. W3C.
[UTR36]
(非規範的) UTR #36: Unicodeセキュリティ考慮事項, M. Davis, M. Suignard. Unicode Consortium.
[WASM]
WebAssembly Core Specification, A. Rossberg. W3C.
[WASMESM]
WebAssembly JavaScript Interface: ESM Integration, L. Clark, D. Ehrenberg., A. Takikawa., G. Bedford. W3C.
[WASMJS]
(非規範的) WebAssembly JavaScriptインターフェース, D. Ehrenberg. W3C.
[WCAG]
(非規範的) ウェブコンテンツアクセシビリティガイドライン (WCAG), A. Kirkpatrick, J. O Connor, A. Campbell, M. Cooper. W3C.
[WEBANIMATIONS]
Webアニメーション, B. Birtles, S. Stephens, D. Stockwell. W3C.
[WEBAUDIO]
(非規範的) WebオーディオAPI, P. Adenot, H. Choi. W3C.
[WEBAUTHN]
Web認証: 公開鍵資格情報にアクセスするためのAPI, M. Jones, A. Kumar, E. Lundberg, D. Balfanz, V. Bharadwaj, A. Birgisson, A. Czeskis, J. Hodges, J.C. Jones, H. Le Van Gong, A. Liao, R. Lindemann, J. Bradley, C. Brand, T. Cappalli, A. Langley, G. Mandyam, M. Miller, N. Satragno, N. Steele, J. Tan, S. Weeden, M. West, J. Yasskin. W3C.
[WEBCODECS]
WebCodecs API, C. Cunningham, P. Adenot, B. Aboba. W3C.
[WEBCRYPTO]
Web Cryptography API, D. Huigens. W3C.
[WEBDRIVER]
WebDriver, S. Stewart, D. Burns. W3C.
[WEBDRIVERBIDI]
WebDriver BiDi. W3C
[WEBGL]
WebGL Specifications, D. Jackson, J. Gilbert. Khronos Group.
[WEBGPU]
WebGPU, D. Malyshau, K. Ninomiya. W3C.
[WEBIDL]
Web IDL, E. Chen, T. Gu. WHATWG.
Web Linking, M. Nottingham. IETF.
[WEBLOCKS]
(非規範的) Web Locks API, J. Bell, K. Rosylight. W3C.
[WEBMCG]
WebM Container Guidelines. The WebM Project.
[WEBNFC]
(非規範的) Web NFC, F. Beaufort, K. Christiansen, Z. Kis. W3C.
[WEBRTC]
(非規範的) Web RTC, C. Jennings, F. Castelli, H. Boström, J. Bruaroey. W3C.
[WEBSOCKETS]
WebSockets, A. Rice. WHATWG.
[WEBTRANSPORT]
WebTransport, B. Aboba, N. Jaju, V. Vasiliev. W3C.
[WEBVTT]
WebVTT, S. Pieters. W3C.
[WHATWGWIKI]
The WHATWG Wiki. WHATWG.
[X121]
Recommendation X.121 — International Numbering Plan for Public Data Networks, CCITT Blue Book, Fascicle VIII.3, pp. 317-332.
[XFN]
XFN 1.1 profile, T. Çelik, M. Mullenweg, E. Meyer. GMPG.
[XHR]
XMLHttpRequest, A. van Kesteren. WHATWG.
[XKCD1288]
(非規範的) Substitutions, Randall Munroe. xkcd.
[XML]
Extensible Markup Language, T. Bray, J. Paoli, C. Sperberg-McQueen, E. Maler, F. Yergeau. W3C.
[XMLENTITY]
(非規範的) XML Entity Definitions for Characters, D. Carlisle, P. Ion. W3C.
[XMLNS]
Namespaces in XML, T. Bray, D. Hollander, A. Layman, R. Tobin. W3C.
[XMLSSPI]
Associating Style Sheets with XML documents, J. Clark, S. Pieters, H. Thompson. W3C.
[XPATH10]
XML Path Language (XPath) Version 1.0, J. Clark, S. DeRose. W3C.
[XSLT10]
(非規範的) XSL Transformations (XSLT) Version 1.0, J. Clark. W3C.
[XSLTP]
(非規範的) DOM XSLTProcessor, WHATWG Wiki. WHATWG.

謝辞

HTMLを発明したティム・バーナーズ＝リーに感謝します。これがなければ、これらは存在しなかったでしょう。

感謝の意を表します Aankhen, Aaqa Ishtyaq, Aaron Boodman, Aaron Leventhal, Aaron Krajeski, Abhishek Ghaskata, Abhishek Gupta, Adam Barth, Adam de Boor, Adam Hepton, Adam Klein, Adam Rice, Adam Roben, Addison Phillips, Adele Peterson, Adrian Bateman, Adrian Roselli, Adrian Sutton, Agustín Fernández, Aharon (Vladimir) Lanin, Ajai Tirumali, Ajay Poshak, Akash Balenalli, Akatsuki Kitamura, Alan Jeffrey, Alan Plum, Alastair Campbell, Alejandro G. Castro, Alex Bishop, Alex Nicolaou, Alex Nozdriukhin, Alex Rousskov, Alex Soncodi, Alexander Farkas, Alexander J. Vincent, Alexander Kalenik, Alexandre Dieulot, Alexandre Morgaut, Alexey Feldgendler, Алексей Проскуряков (Alexey Proskuryakov), Alexey Shvayka, Alexis Deveria, Alfred Agrell, Ali Juma, Alice Boxhall, Alice Wonder, Allan Clements, Allen Wirfs-Brock, Alex Komoroske, Alex Russell, Alphan Chen, Aman Ansari, Ami Fischman, Amos Jeffries, Amos Lim, Anders Carlsson, André Bargull, André E. Veltstra, Andrea Rendine, Andreas, Andreas Deuschlinger, Andreas Farre, Andreas Kling, Andrei Popescu, Andres Gomez, Andres Rios, Andreu Botella, Andrew Barfield, Andrew Clover, Andrew Gove, Andrew Grieve, Andrew Kaster, Andrew Macpherson, Andrew Oakley, Andrew Paseltiner, Andrew Simons, Andrew Smith, Andrew W. Hagen, Andrew Williams, Andrey V. Lukyanov, Andry Rendy, Andy Davies, Andy Earnshaw, Andy Heydon, Andy Paicu, Andy Palay, Anjana Vakil, Ankur Kaushal, Anna Belle Leiserson, Anna Sidwell, Anthony Boyd, Anthony Bryan, Anthony Hickson, Anthony Ramine, Anthony Ricaud, Anton Vayvod, Antonio Sartori, Antti Koivisto, Arfat Salman, Arkadiusz Michalski, Arne Thomassen, Aron Spohr, Arphen Lin, Arthur Hemery, Arthur Sonzogni, Arthur Stolyar, Arun Patole, Aryeh Gregor, Asanka Herath, Asbjørn Ulsberg, Ashley Gullen, Ashley Sheridan, Asumu Takikawa, Atsushi Takayama, Attila Haraszti, Aurelien Levy, Ave Wrigley, Avi Drissman, Axel Dahmen, 방성범 (Bang Seongbeom), Barry Pollard, Ben Boyle, Ben Godfrey, Ben Golightly, Ben Kelly, Ben Lerner, Ben Leslie, Ben Meadowcroft, Ben Millard, Benjamin Carl Wiley Sittler, Benjamin Hawkes-Lewis, Benji Bilheimer, Benoit Ren, Bert Bos, Bijan Parsia, Bil Corry, Bill Mason, Bill McCoy, Billy Wong, Billy Woods, Bjartur Thorlacius, Björn Höhrmann, Blake Frantz, Bob Lund, Bob Owen, Bobby Holley, Boris Zbarsky, Brad Fults, Brad Neuberg, Brad Spencer, Bradley Meck, Brady Eidson, Brandon Jones, Brendan Eich, Brenton Simpson, Brett Wilson, Brett Zamir, Brian Birtles, Brian Blakely, Brian Campbell, Brian Korver, Brian Kuhn, Brian M. Dube, Brian Ryner, Brian Smith, Brian Wilson, Bryan Sullivan, Bruce Bailey, Bruce D'Arcus, Bruce Lawson, Bruce Miller, Bugs Nash, C. Scott Ananian, C. Williams, Cameron McCormack, Cameron Zemek, Cao Yipeng, Carlos Amengual, Carlos Gabriel Cardona, Carlos Ibarra López, Carlos Perelló Marín, Carolyn MacLeod, Casey Leask, Cătălin Badea, Cătălin Mariș, Cem Turesoy, ceving, Chao Cai, 윤석찬 (Channy Yun), Charl van Niekerk, Charlene Wright, Charles Iliya Krempeaux, Charles McCathie Nevile, Charlie Reis, 白丞祐 (Cheng-You Bai), Chris Apers, Chris Cressman, Chris Dumez, Chris Evans, Chris Harrelson, Chris Markiewicz, Chris Morris, Chris Nardi, Chris Needham, Chris Pearce, Chris Peterson, Chris Rebert, Chris Weber, Chris Wilson, Christian Biesinger, Christian Johansen, Christian Schmidt, Christoph Päper, Christophe Dumez, Christopher Aillon, Christopher Cameron, Christopher Ferris, Chriswa, Clark Buehler, Cole Robison, Colin Fine, Collin Jackson, Corey Farwell, Corprew Reed, Craig Cockburn, Csaba Gabor, Csaba Marton, Cynthia Shelly, Cyrille Tuzi, Daksh Shah, Dan Callahan, Dan Yoder, Dane Foster, Daniel Barclay, Daniel Bratell, Daniel Brooks, Daniel Brumbaugh Keeney, Daniel Buchner, Daniel Cheng, Daniel Clark, Daniel Davis, Daniel Ehrenberg, Daniel Ethridge, Daniel Glazman, Daniel Holbert, Daniel Peng, Daniel Schattenkirchner, Daniel Spång, Daniel Steinberg, Daniel Tan, Daniel Trebbien, Daniel Vogelheim, Danny Sullivan, Daphne Preston-Kendal, Darien Maillet Valentine, Darin Adler, Darin Fisher, Darxus, Dave Camp, Dave Cramer, Dave Hodder, Dave Lampton, Dave Singer, Dave Tapuska, Dave Townsend, David Baron, David Bloom, David Bokan, David Bruant, David Carlisle, David E. Cleary, David Egan Evans, David Fink, David Flanagan, David Gerard, David Grogan, David Hale, David Håsäther, David Hyatt, David I. Lehn, David John Burrowes, David Matja, David Remahl, David Resseguie, David Smith, David Storey, David Vest, David Woolley, David Zbarsky, Dave Methvin, DeWitt Clinton, Dean Edridge, Dean Edwards, Dean Jackson, Debanjana Sarkar, Debi Orton, Delan Azabani, Derek Featherstone, Derek Guenther, Devarshi Pant, Devdatta, Devin Mullins, Devin Rousso, Di Zhang, Diego Ferreiro Val, Diego González Zúñiga, Diego Ponce de León, Dimitri Glazkov, Dimitry Golubovsky, Dirk Pranke, Dirk Schulze, Dirkjan Ochtman, Divya Manian, Dmitry Lazutkin, Dmitry Titov, dolphinling, Dominic Cooney, Dominique Hazaël-Massieux, Don Brutzman, Donovan Glover, Doron Rosenberg, Doug Kramer, Doug Simpkinson, Drew Wilson, Edgar Chen, Edmund Lai, Eduard Pascual, Eduardo Vela, Edward Welbourne, Edward Z. Yang, Ehsan Akhgari, Ehsan Karamad, Eira Monstad, Eitan Adler, Eli Friedman, Eli Grey, Eliot Graff, Elisabeth Robson, Elizabeth Castro, Elliott Sprehn, Elliotte Harold, Emilio Cobos Álvarez, Emily Stark, Eric Carlson, Eric Casler, Eric Lawrence, Eric Portis, Eric Rescorla, Eric Semling, Eric Shepherd, Eric Willigers, Erik Arvidsson, Erik Charlebois, Erik Rose, 栗本 英理子 (Eriko Kurimoto), espretto, Evan Jacobs, Evan Martin, Evan Prodromou, Evan Stade, Evert, Evgeny Kapun, ExE-Boss, Ezequiel Garzón, fantasai, Félix Sanz, Felix Sasaki, Fernando Altomare Serboncini, Forbes Lindesay, Francesco Schwarz, Francis Brosnan Blazquez, Franck 'Shift' Quélain, François Marier, Frank Barchard, Frank Liberato, Franklin Shirley, Frederik Braun, Fredrik Söderquist, 鵜飼文敏 (Fumitoshi Ukai), Futomi Hatano, Gavin Carothers, Gavin Kistner, Gareth Rees, Garrett Smith, Gary Blackwood, Gary Kacmarcik, Gary Katsevman, Geoff Richards, Geoffrey Garen, Georg Neis, George Lund, Gianmarco Armellin, Giovanni Campagna, Giuseppe Pascale, Glenn Adams, Glenn Maynard, Graham Klyne, Greg Botten, Greg Houston, Greg Wilkins, Gregg Tavares, Gregory J. Rosmaita, Gregory Terzian, Grey, guest271314, Guilherme Johansson Tramontina, Guy Bedford, Gytis Jakutonis, Håkon Wium Lie, Habib Virji, Hajime Morrita, Hallvord Reiar Michaelsen Steen, Hanna Laakso, Hans S. Tømmerhalt, Hans Stimer, Harald Alvestrand, Hayato Ito, 何志翔 (HE Zhixiang), Henri Sivonen, Henrik Lied, Henrik Lievonen, Henry Lewis, Henry Mason, Henry Story, Hermann Donfack Zeufack, 中川博貴 (Hiroki Nakagawa), Hiroshige Hayashizaki, Hiroyuki USHITO, Hitoshi Yoshida, Hongchan Choi, 王华 (Hua Wang), Hugh Bellamy, Hugh Guiney, Hugh Winkler, Ian Bicking, Ian Clelland, Ian Davis, Ian Fette, Ian Henderson, Ian Kilpatrick, Ibrahim Ahmed, Ido Green, Ignacio Javier, Igor Oliveira, 安次嶺 一功 (Ikko Ashimine), Ilya Grigorik, Ingvar Stepanyan, isonmad, Iurii Kucherov, Ivan Enderlin, Ivan Nikulin, Ivan Panchenko, Ivo Emanuel Gonçalves, J. King, J.C. Jones, Jackson Ray Hamilton, Jacob Davies, Jacques Distler, Jake Archibald, Jake Verbaten, Jakub Vrána, Jakub Łopuszański, Jakub Wilk, James Craig, James Graham, James Greene, James Justin Harrell, James Kozianski, James M Snell, James Perrett, James Robinson, Jamie Liu, Jamie Lokier, Jamie Mansfield, Jan Kühle, Jan Miksovsky, Janice Shiu, Janusz Majnert, Jan-Ivar Bruaroey, Jan-Klaas Kollhof, Jared Jacobs, Jason Duell, Jason Kersey, Jason Lustig, Jason Orendorff, Jason White, Jasper Bryant-Greene, Jasper St. Pierre, Jatinder Mann, Jay Henry Kao, Jean-Yves Avenard, Jed Hartman, Jeff Balogh, Jeff Cutsinger, Jeff Gilbert, Jeff "=JeffH" Hodges, Jeff Schiller, Jeff Walden, Jeffrey Yasskin, Jeffrey Zeldman, 胡慧鋒 (Jennifer Braithwaite), Jellybean Stonerfish, Jennifer Apacible, Jens Bannmann, Jens Fendler, Jens Oliver Meiert, Jens Widell, Jer Noble, Jeremey Hustman, Jeremy Keith, Jeremy Orlow, Jeremy Roman, Jeroen van der Meer, Jerry Smith, Jesse Renée Beach, Jessica Jong, jfkthame, Jian Li, Jihye Hong, Jim Jewett, Jim Ley, Jim Meehan, Jim Michaels, Jinho Bang, Jinjiang (勾三股四), Jirka Kosek, Jjgod Jiang, Joaquim Medeiros, João Eiras, Jochen Eisinger, Joe Clark, Joe Gregorio, Joel Spolsky, Joel Verhagen, Joey Arhar, Johan Herland, Johanna Herman, John Boyer, John Bussjaeger, John Carpenter, John Daggett, John Fallows, John Foliot, John Harding, John Keiser, John Law, John Musgrave, John Snyders, John Stockton, John-Mark Bell, Johnny Stenback, Jon Coppeard, Jon Ferraiolo, Jon Gibbins, Jon Jensen, Jon Perlow, Jonas Sicking, Jonathan Cook, Jonathan Kew, Jonathan Neal, Jonathan Oddy, Jonathan Rees, Jonathan Watt, Jonathan Worent, Jonny Axelsson, Joram Schrijver, Jordan Tucker, Jorgen Horstink, Joris van der Wel, Jorunn Danielsen Newth, Joseph Kesselman, Joseph Mansfield, Joseph Pecoraro, Josh Aas, Josh Hart, Josh Juran, Josh Levenberg, Josh Matthews, Joshua Bell, Joshua Chen, Joshua Randall, Juan Olvera, Juanmi Huertas, Jukka K. Korpela, Jules Clément-Ripoche, Julian Reschke, Julio Lopez, 小勝　純 (Jun Kokatsu), Jun Yang (harttle), Jungkee Song, Jürgen Jeka, Justin Lebar, Justin Novosad, Justin Rogers, Justin Schuh, Justin Sinclair, Juuso Lapinlampi, Ka-Sing Chou, Kagami Sascha Rosylight, Kai Hendry, Kamishetty Sreeja, 呂康豪 (KangHao Lu), Karl Dubost, Karl Tomlinson, Kartik Arora, Kartikaya Gupta, Kathy Walton, 河童エクマ（Kawarabe Ecma） Keith Cirkel, Keith Rollin, Keith Yeung, Kelly Ford, Kelly Norton, Ken Russell, Kenji Baheux, Kevin Benson, Kevin Cole, Kevin Gadd, Kevin McNee, Kevin Venkiteswaran, Khushal Sagar, Kinuko Yasuda, Koji Ishii, Kornél Pál, Kornel Lesinski, 上野 康平 (UENO, Kouhei), Kris Northfield, Kristian Spangsege, Kristof Zelechovski, Krzysztof Maczyński, 黒澤剛志 (Kurosawa Takeshi), Kyle Barnhart, Kyle Hofmann, Kyle Huey, Léonard Bouchet, Léonie Watson, Lachlan Hunt, Larry Masinter, Larry Page, Lars Gunther, Lars Solberg, Laura Carlson, Laura Granka, Laura L. Carlson, Laura Wisewell, Laurens Holst, Lawrence Forooghian, Lee Kowalkowski, Leif Halvard Silli, Leif Kornstaedt, Lenny Domnitser, Leonard Rosenthol, Leons Petrazickis, Liviu Tinta, Lobotom Dysmon, Logan, Logan Moore, Loune, Lucas Gadani, Łukasz Pilorz, Luke Kenneth Casson Leighton, Luke Warlow, Luke Wilde, Maciej Stachowiak, Magne Andersson, Magnus Kristiansen, Maik Merten, Majid Valipour, Maksim Sadym, Malcolm Rowe, Manish Goregaokar, Manish Tripathi, Manuel Martinez-Almeida, Manuel Rego Casasnovas, Marc Hoyois, Marc-André Choquette, Marc-André Lafortune, Marco Zehe, Marcus Bointon, Marcus Otterström, Marijn Kruisselbrink, Mark Amery, Mark Birbeck, Mark Davis, Mark Green, Mark Miller, Mark Nottingham, Mark Pilgrim, Mark Rogers, Mark Rowe, Mark Schenk, Mark Vickers, Mark Wilton-Jones, Markus Cadonau, Markus Stange, Martijn van der Ven, Martijn Wargers, Martin Atkins, Martin Chaov, Martin Dürst, Martin Honnen, Martin Janecke, Martin Kutschker, Martin Nilsson, Martin Thomson, Masataka Yakura, Masatoshi Kimura, Mason Freed, Mason Mize, Mathias Bynens, Mathieu Henri, Matias Larsson, Matt Brubeck, Matt Di Pasquale, Matt Falkenhagen, Matt Giuca, Matt Harding, Matt Schmidt, Matt Wright, Matthew Gaudet, Matthew Gregan, Matthew Mastracci, Matthew Noorenberghe, Matthew Raymond, Matthew Thomas, Matthew Tylee Atkinson, Mattias Waldau, Max Romantschuk, Maxim Tsoy, Mayeul Cantan, Menachem Salomon, Menno van Slooten, Micah Dubinko, Micah Nerren, Michael 'Ratt' Iannarelli, Michael A. Nachbaur, Michael A. Puls II, Michael Carter, Michael Daskalov, Michael Day, Michael Dyck, Michael Enright, Michael Ficarra, Michael Gratton, Michael Kohler, Michael McKelvey, Michael Nordman, Michael Powers, Michael Rakowski, Michael(tm) Smith, Michael Walmsley, Michal Zalewski, Michel Buffa, Michel Fortin, Michelangelo De Simone, Michiel van der Blonk, Miguel Casas-Sanchez, Mihai Şucan, Mihai Parparita, Mike Brown, Mike Dierken, Mike Dixon, Mike Hearn, Mike Pennisi, Mike Schinkel, Mike Shaver, Mikko Rantalainen, Mingye Wang, Mirko Brodesser, Mohamed Zergaoui, Mohammad Al Houssami, Mohammad Reza Zakerinasab, Momdo Nakamura, Morten Stenshorne, Mounir Lamouri, Ms2ger, mtrootyy, 邱慕安 (Mu-An Chiou), Mukilan Thiyagarajan, Mustaq Ahmed, Myles Borins, Nadia Heninger, Nate Chapin, NARUSE Yui, Navid Zolghadr, Neil Deakin, Neil Rashbrook, Neil Soiffer, Nereida Rondon, networkException, Nicholas Shanks, Nicholas Stimpson, Nicholas Zakas, Nickolay Ponomarev, Nicolas Gallagher, Nicolas Pena Moreno, Nicolò Ribaudo, Nidhi Jaju, Nikki Bee, Niklas Gögge, Nina Satragno, Noah Mendelsohn, Noah Slater, Noam Rosenthal, Noel Gordon, Nolan Waite, NoozNooz42, Norbert Lindenberg, Oisín Nolan, Ojan Vafai, Olaf Hoffmann, Olav Junker Kjær, Oldřich Vetešník, Oli Studholme, Oliver Hunt, Oliver Rigby, Olivia (Xiaoni) Lai, Olivier Gendrin, Olli Pettay, Ondřej Žára, Ori Avtalion, Oriol Brufau, oSand, Pablo Flouret, Patrick Dark, Patrick Garies, Patrick H. Lauke, Patrik Persson, Paul Adenot, Paul Lewis, Paul Norman, Per-Erik Brodin, 一丝 (percyley), Perry Smith, Peter Beverloo, Peter Karlsson, Peter Kasting, Peter Moulder, Peter Occil, Peter Stark, Peter Van der Beken, Peter van der Zee, Peter-Paul Koch, Phil Pickering, Philip Ahlberg, Philip Brembeck, Philip Taylor, Philip TAYLOR, Philippe De Ryck, Pierre-Arnaud Allumé, Pierre-Marie Dartus, Pierre-Yves Gérardy, Piers Wombwell, Pooja Sanklecha, Prashant Hiremath, Prashanth Chandra, Prateek Rungta, Pravir Gupta, Prayag Verma, 李普君 (Pujun Li), Rachid Finge, Rafael Weinstein, Rafał Miłecki, Rahim Abdi, Rahul Purohit, Raj Doshi, Rajas Moonka, Rakina Zata Amni, Ralf Stoltze, Ralph Giles, Raphael Champeimont, Rebecca Star, Remci Mizkur, Remco, Remy Sharp, Rene Saarsoo, Rene Stach, Ric Hardacre, Rich Clark, Rich Doughty, Richa Rupela, Richard Gibson, Richard Ishida, Richard Torres, Ricky Mondello, Rigo Wenning, Rikkert Koppes, Rimantas Liubertas, Riona Macnamara, Rob Buis, Rob Ennals, Rob Jellinghaus, Rob S, Rob Smith, Robert Blaut, Robert Collins, Robert Hogan, Robert Kieffer, Robert Linder, Robert Millan, Robert O'Callahan, Robert Sayre, Robin Berjon, Robin Schaufler, Rodger Combs, Roland Steiner, Roma Matusevich, Romain Deltour, Roman Ivanov, Roy Fielding, Rune Lillesveen, Russell Bicknell, Ruud Steltenpool, Ryan King, Ryan Landay, Ryan Sleevi, Ryo Kajiwara, Ryo Kato, Ryosuke Niwa, S. Mike Dierken, Salvatore Loreto, Sam Atkins, Sam Dutton, Sam Kuper, Sam Ruby, Sam Sneddon, Sam Weinig, Samikshya Chand, Samuel Bronson, Samy Kamkar, Sander van Lambalgen, Sanjoy Pal, Sanket Joshi, Sarah Gebauer, Sarven Capadisli, Satrujit Behera, Sayan Sivakumaran, Schalk Neethling, Scott Beardsley, Scott González, Scott Hess, Scott Miles, Scott O'Hara, Sean B. Palmer, Sean Feng, Sean Fraser, Sean Hayes, Sean Hogan, Sean Knapp, Sebastian Markbåge, Sebastian Schnitzenbaumer, Sendil Kumar N, Seth Call, Seth Dillingham, Shannon Moeller, Shanti Rao, Shaun Inman, Shiino Yuki, 贺师俊 (HE Shi-Jun), Shiki Okasaka, Shivani Sharma, shreyateeza, Shubheksha Jalan, Sidak Singh Aulakh, Sierk Bornemann, Sigbjørn Finne, Sigbjørn Vik, Silver Ghost, Silvia Pfeiffer, Šime Vidas, Simon Fraser, Simon Montagu, Simon Sapin, Yu Han, Simon Spiegel, Simon Wülker, Siye Liu, skeww, Smylers, Srirama Chandra Sekhar Mogali, Stanton McCandlish, stasoid, Stefan Håkansson, Stefan Haustein, Stefan Santesson, Stefan Schumacher, Ştefan Vargyas, Stefan Weiss, Steffen Meschkat, Stephen Chenney, Stephen Ma, Stephen Stewart, Stephen White, Steve Comstock, Steve Faulkner, Steve Fink, Steve Orvell, Steve Runyon, Steven Bennett, Steven Bingler, Steven Garrity, Steven Tate, Stewart Brodie, Stuart Ballard, Stuart Langridge, Stuart Parmenter, Subramanian Peruvemba, Sudhanshu Jaiswal, sudokus999, Sunava Dutta, Surma, Susan Borgrink, Susan Lesch, Sylvain Pasche, T.J. Crowder, Tab Atkins-Bittner, Taiju Tsuiki, Takashi Toyoshima, Takayoshi Kochi, Takeshi Yoshino, Tantek Çelik, 田村健人 (Kent TAMURA), Tawanda Moyo, Taylor Hunt, Ted Mielczarek, Terence Eden, Terrence Wood, Tetsuharu OHZEKI, Theresa O'Connor, Thijs van der Vossen, Thomas Broyer, Thomas Koetter, Thomas O'Connor, Tim Altman, Tim Dresser, Tim Flynn, Tim Johansson, Tim Nguyen, Tim Perry, Tim van der Lippe, TJ VanToll, Tobias Schneider, Tobie Langel, Toby Inkster, Todd Moody, Tom Baker, Tom Pike, Tom Schuster, Tom ten Thij, Tomasz Jakut, Tomek Wytrębowicz, Tommy Thorsen, Tony Ross, Tooru Fujisawa, Toru Kobayashi, Traian Captan, Travis Leithead, Trevor Rowbotham, Trevor Saunders, Trey Eckels, triple-underscore, Tristan Fraipont, Tristan Parisot, 保呂 毅 (Tsuyoshi Horo), Tyler Close, Valentin Gosu, Vardhan Gupta, Vas Sudanagunta, Veli Şenol, Victor Carbune, Victor Costan, Vipul Snehadeep Chawathe, Vitya Muhachev, Vlad Levin, Vladimir Katardjiev, Vladimir Vukićević, Vyacheslav Aristov, voracity, Walter Steiner, Wakaba, Wayne Carr, Wayne Pollock, Wellington Fernando de Macedo, Wenson Hsieh, Weston Ruter, Wilhelm Joys Andersen, Will Levine, Will Ray, William Chen, William Swanson, Willy Martin Aguirre Rodriguez, Wladimir Palant, Wojciech Mach, Wolfram Kriesing, Xan Gregg, xenotheme, XhmikosR, Xida Chen, Xidorn Quan, Xue Fuqiao, Yang Chen, Yao Xiao, Yash Handa, Yay295, Ye-Kui Wang, Yehuda Katz, Yi Xu, Yi-An Huang, Yngve Nysaeter Pettersen, Yoav Weiss, Yonathan Randolph, Yu Huojiang, Yuki Okushi, Yury Delendik, 平野裕 (Yutaka Hirano), Yuzo Fujishima, 西條柚 (Yuzu Saijo), Zhenbin Xu, 张智强 (Zhiqiang Zhang), Zoltan Herczeg, Zyachel, and Øistein E. Andersen, に感謝します。彼らの有益なコメント（大きなものも小さなものも含む）が、この仕様の変更につながりました。

また、HTMLについてブログや公開メーリングリスト、フォーラムに投稿してくださったすべての方々に感謝します。特に、さまざまなW3C HTML WGリストやさまざまなWHATWGリストへの貢献者の皆さんに感謝します。

特に、Safariでcanvasの最初の実装を作成したRichard Williamsonに感謝します。この実装がキャンバス機能の設計に役立ちました。

また、イベントベースのドラッグ＆ドロップメカニズム、contenteditable、およびWindows Internet Explorerブラウザで初めて広く展開されたその他の機能を最初に実装したMicrosoftの社員にも特別な感謝を送ります。

特に、採用機関アルゴリズムの壊れた実装を考案し、エディターがそれを逆アセンブルして修正する必要があったDavid Hyattに感謝します。また、$10,000の寄付も感謝します。

マイクロデータ機能の設計において、彼らの間違いをガイドとして使用することを許可してくださったマイクロデータのユーザビリティ調査の参加者に感謝します。

仕様で使用されている例にインスピレーションを与えてくれた多くのソースにも感謝します。

Microsoftのブログコミュニティからのアイデア、W3C Web Applications and Compound Documentsワークショップの参加者からのインスピレーション、#mrtクルー、#mrt.noクルー、#whatwgクルー、そしてPillarとHedralのアイデアとサポートにも感謝します。

仕様のPDF版を生成してくれたIgor Zhbanovにも感謝します。

また、RICGに感謝します。picture要素と関連機能の開発において、特にAdrian Bateman、Bruce Lawson、David Newton、Ilya Grigorik、John Schoenick、Leon de Rijke、Mat Marquis、Marcos Cáceres、Tab Atkins、Theresa O'Connor、Yoav Weissに感謝します。

また、WPWGに感謝します。カスタム要素機能の育成において、特にDavid HyattとIan HicksonのXBL仕様を通じた影響、Dimitri Glazkovによるカスタム要素仕様の最初のドラフト、そして Alex Komoroske, Alex Russell, Andres Rios, Boris Zbarsky, Brian Kardell, Daniel Buchner, Dominic Cooney, Erik Arvidsson, Elliott Sprehn, Hajime Morrita, Hayato Ito, Jan Miksovsky, Jonas Sicking, Olli Pettay, Rafael Weinstein, Roland Steiner, Ryosuke Niwa, Scott Miles, Steve Faulkner, Steve Orvell, Tab Atkins, Theresa O'Connor, Tim Perry, and William Chen の貢献に感謝します。

特に、CSSWGに感謝します。workletsの開発において、特にIan Kilpatrickが元のworklets仕様のエディターとして行った作業に感謝します。

2003年から約10年間、この標準はほぼ完全にIan Hickson（Google、ian@hixie.ch）によって書かれていました。

2015年から、編集グループは拡大しました。現在は Anne van Kesteren（Apple、annevk@annevk.nl）、 Domenic Denicola（Google、d@domenic.me）、 Dominic Farolino（Google、domfarolino@gmail.com）、 Philip Jägenstedt（Google、philip@foolip.org）、および Simon Pieters（Mozilla、zcorpan@gmail.com）によって維持されています。

知的財産権

紹介に使用されている画像は、写真であり、 Wonderlaneによるものです。 (CC BY 2.0)

埋め込みコンテンツの紹介に使用されているオオカミの画像は、写真であり、 Barry O'Neillによるものです。 (パブリック・ドメイン)

埋め込みコンテンツの紹介に使用されているケトルベルスイングの画像は、写真であり、 kokkarinaによるものです。 (CC0 1.0)

キャンバスデモに使用されているブルーロボットプレイヤースプライトは、作品であり、 JohnColburnによるものです。 (CC BY-SA 3.0)

FIRST Robotics Competition 2013 Silicon Valley Regionalでタワーを登っているロボット148の写真は、作品であり、 Lenore Edmanによるものです。 (CC BY 2.0)

<flag-icon>の例は、カスタム要素に触発されており、Steven Skeltonによるものです。 (MIT)

picture要素と関連機能の改訂履歴の一部は、ResponsiveImagesCG/picture-element リポジトリにあります。このリポジトリはW3Cソフトウェアおよびドキュメントライセンスの下で利用可能です。

theme-colorメタデータ名の改訂履歴の一部は、whatwg/meta-theme-color リポジトリにあります。このリポジトリはCC0の下で利用可能です。

カスタム要素機能の改訂履歴の一部は、w3c/webcomponentsリポジトリにあります。このリポジトリはW3Cソフトウェアおよびドキュメントライセンスの下で利用可能です。

innerTextゲッターおよびセッターの改訂履歴の一部は、rocallahan/innerText-spec リポジトリにあります。このリポジトリはCC0の下で利用可能です。

worklets機能の改訂履歴の一部は、w3c/css-houdini-drafts リポジトリにあります。このリポジトリはW3Cソフトウェアおよびドキュメントライセンスの下で利用可能です。

import maps機能の改訂履歴の一部は、WICG/import-maps リポジトリにあります。このリポジトリはW3Cソフトウェアおよびドキュメントライセンスの下で利用可能です。

ナビゲーションAPI機能の改訂履歴の一部は、WICG/navigation-api リポジトリにあります。このリポジトリはW3Cソフトウェアおよびドキュメントライセンスの下で利用可能です。

クローズリクエストとクローズウォッチャーセクションの改訂履歴の一部は、WICG/close-watcher リポジトリにあります。このリポジトリはW3Cソフトウェアおよびドキュメントライセンスの下で利用可能です。

Copyright © WHATWG (Apple, Google, Mozilla, Microsoft)。この作品はクリエイティブ・コモンズ 表示 4.0 国際ライセンスの下でライセンスされています。ソースコードに組み込まれた部分は、BSD 3-Clauseライセンスの下でライセンスされます。

これは現行標準です。特許審査版に関心がある方は、現行標準レビュー草案をご覧ください。