HTMLImageElement: crossOrigin プロパティ
HTMLImageElement
インターフェイスの crossOrigin
属性は、画像を取得する際に使用するオリジン間リソース共有 (CORS) 設定を指定するための文字列です。
値
画像リソースを取得する際に使用する CORS モードを指定するキーワードの文字列です。 crossOrigin
を指定しない場合、画像は CORS なしで取得されます(no-cors
フェッチモード)。
許可されている値は次の通りです。
anonymous
-
<img>
要素によるリクエストは、mode
がcors
に、credentials
モードがsame-origin
に設定されて行われます。これは、CORS が有効であり、文書が読み込まれたのと同じオリジンから画像が取得された場合に、クレデンシャルが送信されることを意味します。 use-credentials
-
HTMLImageElement
によるリクエストはcors
モードとinclude
認証モードを使用します。この要素によるすべての画像リクエストは、取得元のドメインに関係なく CORS を使用します。
crossOrigin
が空の文字列 (""
) の場合、anonymous
モードが選択されます。
例
この例では、新しい <img>
要素が作成されて文書に追加され、匿名状態の画像が読み込まれます。画像は CORS を使用して読み込まれ、資格情報がオリジンをまたいだすべての読み込みに使用されます。
JavaScript
以下のコードでは、 <img>
要素に crossOrigin
プロパティを設定して、新しく作成された画像のフェッチに対する CORS アクセスを設定する例を示しています。
js
const imageUrl = "clock-demo-400px.png";
const container = document.querySelector(".container");
function loadImage(url) {
const image = new Image(200, 200);
image.addEventListener("load", () => container.prepend(image));
image.addEventListener("error", () => {
const errMsg = document.createElement("output");
errMsg.value = `Error loading image at ${url}`;
container.append(errMsg);
});
image.crossOrigin = "anonymous";
image.alt = "";
image.src = url;
}
loadImage(imageUrl);
HTML
html
<div class="container">
<p>
ここに 1 つの段落があります。とても面白い段落です。
あなたはこの段落に魅了されています。 この段落を読み続けてください。
じゃあ、もうこの段落を読むのはやめていいよ。 読んでくれてありがとう。
</p>
</div>
CSS
css
body {
font:
1.125rem/1.5,
Helvetica,
sans-serif;
}
.container {
display: flow-root;
width: 37.5em;
border: 1px solid #d2d2d2;
}
img {
float: left;
padding-right: 1.5em;
}
output {
background: rgba(100, 100, 100, 0.1);
font-family: Courier, monospace;
width: 95%;
}
結果
仕様書
Specification |
---|
HTML Standard # dom-img-crossorigin |
ブラウザーの互換性
BCD tables only load in the browser