画像リソース

1. はじめに

ウェブアプリケーションは、HTMLドキュメント外（OSやブラウザーUIなど）で表示される画像リソースを開発者から受け取ることがよくあります。この仕様は、画像を記述し、その画像リソースの取得先を示すWebIDL辞書型を定義します。ユーザーエージェントは、この追加情報を利用することで、エンドユーザーの端末に最適、またはユーザーの嗜好や環境にもっとも近い画像を選択できます。

2. プライバシーとセキュリティの考慮事項

画像リソースの取得時、ユーザーのIPアドレスが判明することがあります。 ユーザーエージェントは、開発者から提供された画像リソースを取得し、必要に応じて再利用できるよう保存することが推奨されます。 これにより、ユーザーの位置情報の長期的な追跡が制限されます。

3. 画像リソース

画像リソースは次の要素から構成されます:

src

画像データの取得元となるURL。

sizes

画像のサイズを表すオプションの文字列であり、 link要素の sizes 属性と同じ構文を使用します。

type

オプションの画像MIMEタイプ。

label

画像のアクセシブル・ネームを表す文字列。

APIでは、画像リソースはImageResource辞書として表されます。

[JSON]では、画像リソースはオブジェクトとして表現されます。

4. ImageResource 辞書型

WebIDLdictionary ImageResource {
  required USVString src;
  DOMString sizes;
  DOMString type;
  DOMString label;
};

const image = {
  src: "path/to/image.ico",
  sizes: "16x16 32x32 64x64",
  type: "image/vnd.microsoft.icon",
};
some.api.doSomething(image);

5. APIからのImageResource処理

APIからのImageResourceの処理は、次のアルゴリズムで示されます。このアルゴリズムは ImageResource inputを受け取り、画像リソースを返します。

1. base URLを、この辞書が使われている関連する設定オブジェクトのAPIベースURLとする。
2. image を新しい 画像リソース とする。
3. image の src を、URLパースで input.src とbase URLを使った結果に設定する。 パース失敗時はTypeErrorを投げる。
4. input のsizesメンバーが存在する場合:
   1. image のsizesを、input.sizes を、sizes 属性のようにパースした結果とする。このパースに失敗した場合は TypeErrorを投げる。
5. input のtypeメンバーが存在し、空文字列でない場合:
   1. typeが画像MIMEタイプでなければ、 TypeErrorを投げる。
   2. image の type を input.type に設定する。
6. image のlabelにアクセシブル・ネームの導出の結果を設定する。
7. imageを返す。

6. JSONからの画像リソースの処理

JSONから画像リソースを処理するには、JSONオブジェクトinputおよびURLbaseを与える。返り値は順序付きマップ。

1. inputがobject型でない場合、失敗を返す。
2. input["src"]が文字列型でない場合、失敗を返す。
3. srcを、input["src"]をbaseを基準URLとしてパースした結果とする。
4. srcが失敗の場合、失敗を返す。
5. imageを新しい順序付きマップとする。
6. image["src"]にsrcを設定する。
7. input["sizes"]の型が文字列型かつ長さが0より大きい場合:
   1. sizesに、input["sizes"]を sizes 属性を持つ link 要素の属性としてパースした結果を設定する。rel 属性がiconを含むとする。
   2. sizesが失敗の場合、失敗を返す。
   3. image["sizes"]にsizesを設定する。
8. input["type"]が文字列型で、長さが0より大きい場合:
   1. mimeを、input["type"]を MIMEタイプとしてパース した結果とする。
   2. mimeが失敗の場合、失敗を返す。
   3. image["type"]にmimeの本質部分を設定する。
9. image["label"]にアクセシブル・ネームの導出の結果を設定する。
10. imageを返す。

7. 画像リソースの取得

画像リソースの取得の手順は次のアルゴリズムで示される。アルゴリズムは画像リソースimageと、オプションでRequestrequestを受け取り、返り値はResponse。

1. requestがundefinedの場合:
   1. requestを新規のRequestとする。
   2. URLをimageのsrcに設定する。
   3. Destinationを"image"に設定する。
   4. Clientをコンテキストオブジェクトの関連設定オブジェクトに設定する。
2. requestのClientがnullの場合、TypeErrorを投げる。
3. requestでfetchを行い、Responseを返す。

8. アクセシブル・ネームの導出

アクセシブル・ネームの導出は画像リソースresourceに対し次の手順で行う。返り値は文字列。

1. resource["label"]が文字列の場合、input["label"]を返す。
2. それ以外で、imageが埋込型アクセシブル・ネームを提供する場合、その埋込型アクセシブル・ネームを返す。
3. それ以外で、外部ラベルが代替可能であれば、該当外部ラベルを返す。
4. ""（空文字列）を返す。

9. 埋込型アクセシブル・ネーム対応グラフィクスフォーマット例

画像内容の一部として埋込型アクセシブル・ネームを含められるグラフィックス形式もある。たとえば次のようなものがある:

• title要素（SVG内）
• ラスター画像のメタデータ（例: tiff:ImageDescription, XMP:Description）

10. 適合性

この仕様の中で非規範的と明示されたセクション、著者ガイドライン、図、例および注記はすべて非規範的です。それ以外は規範的です。

本文書中の MAY、MUST、RECOMMENDED というキーワードは、BCP 14 [RFC2119] [RFC8174] で説明されたとおり、大文字で現れた場合に限り、規範的な意味を持ちます。