Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Web/API/HTMLAnchorElement/attributionSrc 他1件を新規翻訳 #24051

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 75 additions & 0 deletions files/ja/web/api/htmlanchorelement/attributionsrc/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
title: "HTMLAnchorElement: attributionSrc プロパティ"
short-title: attributionSrc
slug: Web/API/HTMLAnchorElement/attributionSrc
l10n:
sourceCommit: e9e2ec643ac69c132f31427a0b586ab2cf83ed58
---

{{APIRef("Attribution Reporting API")}}{{securecontext_header}}{{SeeCompatTable}}

**`attributionSrc`** は {{domxref("HTMLAnchorElement")}} インターフェイスのプロパティで、{{htmlelement("a")}} 要素の [`attributionsrc`](/ja/docs/Web/HTML/Element/a#attributionsrc) 属性をプログラムから取得および設定ます。`attributionsrc` は、ブラウザーに {{httpheader("Attribution-Reporting-Eligible")}} ヘッダーを送信するように指定します。サーバー側では、レスポンスで {{httpheader("Attribution-Reporting-Register-Source")}} ヘッダーを送信し、[ナビゲーションベースの帰属元](/ja/docs/Web/API/Attribution_Reporting_API/Registering_sources#navigation-based_attribution_sources)を登録するために使用されます。

ブラウザーは、ナビゲーションレスポンスを受信すると、ナビゲーションベースの属性ソース({{httpheader("Attribution-Reporting-Register-Source")}} レスポンスヘッダーで指定されたもの)に関連付けられたソースデータを格納します。

詳細は、[帰属報告 API](/ja/docs/Web/API/Attribution_Reporting_API) を参照してください。

> **メモ:** `<a>` 要素は帰属のトリガーとして使用することはできず、ソースのみです。

## 値

文字列です。このプロパティには、取得や設定ができる 2 つのバージョンがあります。

- 空文字列、すなわち `aElem.attributionSrc=""` です。これは、`href` 属性が指し示すのと同じサーバーに {{httpheader("Attribution-Reporting-Eligible")}} ヘッダーが送信されることを指定します。この点は、帰属元の登録を同じサーバーで処理する場合は問題ありません。
- 1 つ以上の URL を含む値、例えば次のようなものです。

```js
aElem.attributionSrc =
"https://a.example/register-source https://b.example/register-source";
```

これは、リクエストされたリソースが管理下のサーバーにない場合や、別のサーバーでの帰属元の登録を処理したい場合に便利です。この場合、`attributionSrc` の値として 1 つ以上の URL を指定することができます。リソースへのリクエストが発生すると、リソースのオリジンに加えて、attributionSrcで指定された URL に {{httpheader("Attribution-Reporting-Eligible")}} ヘッダーが送信されます。これらの URL は、ソースを登録するために {{httpheader("Attribution-Reporting-Register-Source")}} で応答することができます。

> [!NOTE]
> 複数の URL を指定するということは、同じ機能に複数の属性ソースを登録できるということになります。例えば、成功を測定しようとしているさまざまなキャンペーンが、異なるデータに関する異なるレポートの生成に関与している場合、異なるキャンペーンを行うことができます。

## 例

### 空の attributionSrc の設定

```html
<a href="https://shop.example"> Click to visit our shop </a>
```

```js
const aElem = document.querySelector("a");
aElem.attributionSrc = "";
```

### URL を格納するアトリビューション Src を設定するには

```html
<a href="https://ourshop.example"> Click to visit our shop </a>
```

```js
// encode the URLs in case they contain special characters
// such as '=' that would be improperly parsed.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");

const aElem = document.querySelector("a");
aElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
```

## 仕様書

{{Specifications}}

## ブラウザーの互換性

{{Compat}}

## 関連情報

- [帰属報告 API](/ja/docs/Web/API/Attribution_Reporting_API)
44 changes: 44 additions & 0 deletions files/ja/web/api/htmlanchorelement/ping/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: "HTMLAnchorElement: ping プロパティ"
short-title: ping
slug: Web/API/HTMLAnchorElement/ping
l10n:
sourceCommit: e9e2ec643ac69c132f31427a0b586ab2cf83ed58
---

{{ApiRef("HTML DOM")}}

**`ping`** は {{domxref("HTMLAnchorElement")}} インターフェイスのプロパティで、スペースで区切られた URL のリストです。リンクを追ったとき、ブラウザーは本体に PING と記載された {{HTTPMethod("POST")}} リクエストを URL に送信します。

これは {{HTMLElement("a")}} 要素の `ping` を反映します。

> [!NOTE]
> このプロパティは Firefox では効果を発揮せず、プライバシーやセキュリティ上の懸念から、その使用が制限される可能性があります。

## 例

```html
<a
id="exampleLink"
href="https://example.com"
ping="https://example-tracking.com https://example-analytics.com"
>Example Link</a
>
```

```js
const anchorElement = document.getElementById("exampleLink");
console.log(anchorElement.ping); // Output: "https://example-tracking.com https://example-analytics.com"
```

## 仕様書

{{Specifications}}

## ブラウザーの互換性

{{Compat}}

## 関連情報

- {{domxref("HTMLAreaElement.ping")}} property