From 9c79eebec3a523898cf92450c4615427fa47f841 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 18 Oct 2024 13:20:35 +0900
Subject: [PATCH] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9=E3=81=AE?=
 =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?=
 =?UTF-8?q?=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3=20(#24051)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/07/26 時点の英語版に基づき新規翻訳

* 2024/07/26 時点の英語版に基づき更新
---
 .../htmlanchorelement/attributionsrc/index.md | 75 +++++++++++++++++++
 .../web/api/htmlanchorelement/ping/index.md   | 44 +++++++++++
 2 files changed, 119 insertions(+)
 create mode 100644 files/ja/web/api/htmlanchorelement/attributionsrc/index.md
 create mode 100644 files/ja/web/api/htmlanchorelement/ping/index.md

diff --git a/files/ja/web/api/htmlanchorelement/attributionsrc/index.md b/files/ja/web/api/htmlanchorelement/attributionsrc/index.md
new file mode 100644
index 00000000000000..639d18b0d251bd
--- /dev/null
+++ b/files/ja/web/api/htmlanchorelement/attributionsrc/index.md
@@ -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)
diff --git a/files/ja/web/api/htmlanchorelement/ping/index.md b/files/ja/web/api/htmlanchorelement/ping/index.md
new file mode 100644
index 00000000000000..67d40b42533552
--- /dev/null
+++ b/files/ja/web/api/htmlanchorelement/ping/index.md
@@ -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