diff --git a/files/zh-cn/web/api/htmlanchorelement/attributionsrc/index.md b/files/zh-cn/web/api/htmlanchorelement/attributionsrc/index.md new file mode 100644 index 00000000000000..2b3cd8ec2bf72d --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/attributionsrc/index.md @@ -0,0 +1,74 @@ +--- +title: HTMLAnchorElement:attributionSrc 属性 +slug: Web/API/HTMLAnchorElement/attributionSrc +l10n: + sourceCommit: e9e2ec643ac69c132f31427a0b586ab2cf83ed58 +--- + +{{APIRef("Attribution Reporting API")}}{{securecontext_header}}{{SeeCompatTable}} + +{{domxref("HTMLAnchorElement")}} 接口的 **`attributionSrc`** 属性用于以编程方式获取和设置 {{htmlelement("a")}} 元素上的 [`attributionsrc`](/zh-CN/docs/Web/HTML/Element/a#attributionsrc) 属性,反映该属性的值。`attributionsrc` 指定你希望浏览器发送 {{httpheader("Attribution-Reporting-Eligible")}} 标头。在服务器端,这用于触发在响应中发送 {{httpheader("Attribution-Reporting-Register-Source")}} 标头,以注册一个[基于导航的归因来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于导航的归因来源)。 + +当浏览器接收到导航响应时,它会存储与基于导航的归因来源相关联的源数据(如 {{httpheader("Attribution-Reporting-Register-Source")}} 响应标头中所提供的数据)。 + +参见[归因报告 API](/zh-CN/docs/Web/API/Attribution_Reporting_API) 以获取更多详细信息。 + +> **备注:** `` 元素不能用作归因触发器,只能用作归因来源。 + +## 值 + +一个字符串。此属性有两个版本可供获取和设置: + +- 空字符串,即 `aElem.attributionSrc=""`。这表示你希望将 {{httpheader("Attribution-Reporting-Eligible")}} 标头发送到 `href` 属性所指向的同一服务器。当你在同一服务器上处理归因来源注册时,这是合适的。 +- 包含一个或多个 URL 的值,例如: + + ```js + aElem.attributionSrc = + "https://a.example/register-source https://b.example/register-source"; + ``` + + 当请求的资源不在你控制的服务器上,或者你只是想在不同的服务器上处理归因来源注册的情况下非常有用。在这种情况下,你可以指定一个或多个 URL 作为 `attributionSrc` 的值。当资源请求发生时,除了资源来源之外,还会向 `attributionSrc` 中指定的 URL 发送 {{httpheader("Attribution-Reporting-Eligible")}} 标头。然后,这些 URL 可以通过回复 {{httpheader("Attribution-Reporting-Register-Source")}} 来注册来源。 + + > [!NOTE] + > 指定多个 URL 意味着可以在同一功能上注册多个归因来源。例如,你可能有不同的营销活动需要衡量其成功效果,这些活动涉及基于不同数据生成不同的报告。 + +## 示例 + +### 设置空的 attributionSrc + +```html + 点击访问我们的商店 +``` + +```js +const aElem = document.querySelector("a"); +aElem.attributionSrc = ""; +``` + +### 设置包含 URL 的 attributionSrc + +```html + 点击访问我们的商店 +``` + +```js +// 对 URL 进行编码,以防它们包含特殊字符 +// 例如“=”,这种字符可能会被错误地解析。 +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](/zh-CN/docs/Web/API/Attribution_Reporting_API) diff --git a/files/zh-cn/web/api/htmlanchorelement/download/index.md b/files/zh-cn/web/api/htmlanchorelement/download/index.md index 96f40648797ab9..bdb25c1b420bac 100644 --- a/files/zh-cn/web/api/htmlanchorelement/download/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/download/index.md @@ -1,14 +1,16 @@ --- -title: HTMLAnchorElement.download +title: HTMLAnchorElement:download 属性 slug: Web/API/HTMLAnchorElement/download +l10n: + sourceCommit: e9e2ec643ac69c132f31427a0b586ab2cf83ed58 --- {{APIRef("HTML DOM")}} -**`HTMLAnchorElement.download`** 属性是一个{{jsxref("DOMString")}} ,表明链接的资源将被下载,而不是显示在浏览器中。该值表示下载文件的建议名称。如果该名称不是基础操作系统的有效文件名,浏览器将对其进行调整。 +**`HTMLAnchorElement.download`** 属性是一个字符串,表示链接的资源旨在被下载而非在浏览器中显示。如果该属性有值,则指定了在本地文件系统中标记资源时使用的默认文件名。如果名称在底层操作系统中不是有效的文件名,浏览器将会对其进行调整。 > [!NOTE] -> 该值对于下载行为来说不一定是有用的,同时也不能决定下载行为是否发生。 +> 这个值可能不会被用于下载。这个值不能用来确定下载是否会发生。 ## 值 @@ -18,6 +20,6 @@ slug: Web/API/HTMLAnchorElement/download {{Specifications}} -## 浏览器的兼容性 +## 浏览器兼容性 {{Compat}} diff --git a/files/zh-cn/web/api/htmlanchorelement/hash/index.md b/files/zh-cn/web/api/htmlanchorelement/hash/index.md index 0658cdf3b17084..4e523870d71e63 100644 --- a/files/zh-cn/web/api/htmlanchorelement/hash/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/hash/index.md @@ -2,14 +2,14 @@ title: HTMLAnchorElement:hash 属性 slug: Web/API/HTMLAnchorElement/hash l10n: - sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 + sourceCommit: 3e301467a02808e9fc488d7012f1f49eb66a5980 --- {{ APIRef("HTML DOM") }} -**`HTMLHyperlinkElementUtils.hash`** 属性返回一个字符串,其中包含一个 `'#'`,后面是 URL 的片段标识符。 +**`HTMLAnchorElement.hash`** 属性返回一个字符串,该字符串包含一个 `'#'` 符号,后面跟着 URL 的片段标识符。 -片段没有经过[百分号编码](https://zh.wikipedia.org/wiki/百分号编码)。如果 URL 没有包含片段标识符,这个属性为一个空的字符串,`""`。 +片段是[百分号编码](/zh-CN/docs/Glossary/Percent-encoding)的。如果 URL 没有片段标识符,则此属性包含一个空字符串,即 `""`。 ## 值 @@ -17,19 +17,21 @@ l10n: ## 示例 -### 从锚点链接获取 hash 值 +### 从锚点链接中获取哈希值 -给定 HTML 代码如下: +给定 HTML ```html -示例 + + 示例 + ``` -你可以像这样获取锚点的 hash 值: +你可以像这样获取锚点哈希值: ```js const anchor = document.getElementById("myAnchor"); -anchor.hash; // 返回 '#示例' +anchor.hash; // “#%E7%A4%BA%E4%BE%8B” ``` ## 规范 diff --git a/files/zh-cn/web/api/htmlanchorelement/host/index.md b/files/zh-cn/web/api/htmlanchorelement/host/index.md new file mode 100644 index 00000000000000..778fda2ea6ae22 --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/host/index.md @@ -0,0 +1,42 @@ +--- +title: HTMLAnchorElement:host 属性 +slug: Web/API/HTMLAnchorElement/host +l10n: + sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 +--- + +{{ApiRef("HTML DOM")}} + +**`HTMLAnchorElement.host`** 属性是一个字符串,包含主机名,即 _hostname_,并且如果 URL 的*端口号*不为空,则后面会跟一个 `':'` 和 URL 的*端口号*。 + +## 值 + +一个字符串。 + +## 示例 + +```js +const anchor = document.createElement("a"); + +anchor.href = "https://developer.mozilla.org/zh-CN/HTMLAnchorElement"; +anchor.host === "developer.mozilla.org"; + +anchor.href = "https://developer.mozilla.org:443/zh-CN/HTMLAnchorElement"; +anchor.host === "developer.mozilla.org"; +// 不包含端口号,因为 443 是该方案的默认端口 + +anchor.href = "https://developer.mozilla.org:4097/zh-CN/HTMLAnchorElement"; +anchor.host === "developer.mozilla.org:4097"; +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/hostname/index.md b/files/zh-cn/web/api/htmlanchorelement/hostname/index.md new file mode 100644 index 00000000000000..352598fabfea7e --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/hostname/index.md @@ -0,0 +1,34 @@ +--- +title: HTMLAnchorElement:hostname 属性 +slug: Web/API/HTMLAnchorElement/hostname +l10n: + sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 +--- + +{{ApiRef("HTML DOM")}} + +**`HTMLAnchorElement.hostname`** 属性是一个包含 URL 域名的字符串。 + +## 值 + +一个字符串。 + +## 示例 + +```js +// 文档中有一个 元素 +const anchor = document.getElementById("myAnchor"); +anchor.hostname; // 返回“developer.mozilla.org” +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/href/index.md b/files/zh-cn/web/api/htmlanchorelement/href/index.md index 9e2732194e3260..7c49199a268c16 100644 --- a/files/zh-cn/web/api/htmlanchorelement/href/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/href/index.md @@ -1,11 +1,13 @@ --- -title: HTMLAnchorElement.href +title: HTMLAnchorElement:href 属性 slug: Web/API/HTMLAnchorElement/href +l10n: + sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 --- {{ApiRef("HTML DOM")}} -**`HTMLAnchorElement.href`** 属性是一个返回包含整个 URL 的字符串的 {{Glossary("stringifier")}},且允许 href 被更新。 +**`HTMLAnchorElement.href`** 属性是一个{{Glossary("stringifier", "字符串化器")}},它返回一个包含完整 URL 的字符串,并且允许更新 `href` 属性。 ## 值 @@ -14,9 +16,9 @@ slug: Web/API/HTMLAnchorElement/href ## 示例 ```js -// 假设 元素在文档内 +// 文档中有一个 元素 const anchor = document.getElementById("myAnchor"); -anchor.href; // 返回 'https://developer.mozilla.org/en-US/HTMLAnchorElement' +anchor.href; // 返回“https://developer.mozilla.org/zh-CN/HTMLAnchorElement” ``` ## 规范 @@ -29,4 +31,4 @@ anchor.href; // 返回 'https://developer.mozilla.org/en-US/HTMLAnchorElement' ## 参见 -- 所属的 {{domxref("HTMLAnchorElement")}} 接口。 +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/hreflang/index.md b/files/zh-cn/web/api/htmlanchorelement/hreflang/index.md new file mode 100644 index 00000000000000..e579dc5e29f822 --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/hreflang/index.md @@ -0,0 +1,56 @@ +--- +title: HTMLAnchorElement:hreflang 属性 +slug: Web/API/HTMLAnchorElement/hreflang +l10n: + sourceCommit: 5948500efb7d63d514966013adc8ed925ce28f69 +--- + +{{ApiRef("HTML DOM")}} + +{{domxref("HTMLAnchorElement")}} 接口的 **`hreflang`** 属性是一个表示链接资源的语言的字符串。 + +它反映 {{HTMLElement("a")}} 元素的 `hreflang` 属性,如果没有 `hreflang` 属性,则为空字符串(`""`)。 + +Web 浏览器和搜索引擎可能会使用此信息来更好地理解链接内容的语言,但它们并不一定要遵循此信息。为 `hreflang` 属性提供的值应遵循 {{RFC(5646, "用于标识语言的标记(也被称为 BCP 47)")}}中定义的格式。如果不符合该格式,则会被忽略。 + +在获取链接资源后,Web 浏览器并不完全依赖于 `hreflang` 属性。相反,它们会使用与资源直接关联的语言信息(例如,通过 HTTP 标头)来确定资源的语言。 + +## 值 + +一个包含语言标签的字符串,如果没有 `hreflang` 属性,则为空字符串(`""`)。 + +## 示例 + +```html +示例链接 +
+``` + +```css +#exampleLink { + font-size: 1.5rem; +} +``` + +```js +const anchorElement = document.getElementById("exampleLink"); +const pTag = document.querySelector(".hreflang"); +console.log(anchorElement.hreflang); // 输出:“en-IN” +pTag.textContent = anchorElement.hreflang; +``` + +## Result + +{{EmbedLiveSample("示例",100,100)}} + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("HTMLLinkElement.hreflang")}} 属性 diff --git a/files/zh-cn/web/api/htmlanchorelement/index.md b/files/zh-cn/web/api/htmlanchorelement/index.md new file mode 100644 index 00000000000000..fe7e17f2cd342a --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/index.md @@ -0,0 +1,91 @@ +--- +title: HTMLAnchorElement +slug: Web/API/HTMLAnchorElement +l10n: + sourceCommit: dcbb1d99185118360cc84b3a0e935e77fe0a03e3 +--- + +{{APIRef("HTML DOM")}} + +**`HTMLAnchorElement`** 接口表示超链接元素,并为操控此类元素的布局和表现提供特殊的属性和方法(除了常规 {{domxref("HTMLElement")}} 接口之外,它还可以通过继承来使用)。此接口对应于 [``](/zh-CN/docs/Web/HTML/Element/a) 元素;不要与由 [`HTMLLinkElement`](/zh-CN/docs/Web/API/HTMLLinkElement) 表示的 [``](/zh-CN/docs/Web/HTML/Element/link) 元素相混淆。 + +{{InheritanceDiagram}} + +## 实例属性 + +_从其父接口 {{domxref("HTMLElement")}} 继承属性。_ + +- {{domxref("HTMLAnchorElement.attributionSrc")}} {{securecontext_inline}} {{experimental_inline}} + - : 以编程方式获取和设置 {{htmlelement("a")}} 元素上的 [`attributionsrc`](/zh-CN/docs/Web/HTML/Element/a#attributionsrc) 属性,反映该属性的值。`attributionsrc` 指定你希望浏览器发送一个 {{httpheader("Attribution-Reporting-Eligible")}} 标头。在服务器端,这用于触发在响应中发送 {{httpheader("Attribution-Reporting-Register-Source")}} 标头,以注册基于导航的归因来源。 +- {{domxref("HTMLAnchorElement.download")}} + - : 一个字符串,指示链接资源旨在被下载而不是在浏览器中显示。该值表示建议的文件名。如果名称不是底层操作系统的有效文件名,浏览器将对其进行适应调整。 +- {{domxref("HTMLAnchorElement.hash")}} + - : 一个字符串,表示引用 URL 中的片段标识符,如果存在,则包括前导井号 `#`。 +- {{domxref("HTMLAnchorElement.host")}} + - : 一个字符串,表示引用 URL 中的主机名和端口号(如果不是默认端口)。 +- {{domxref("HTMLAnchorElement.hostname")}} + - : 一个字符串,表示引用 URL 中的主机名。 +- {{domxref("HTMLAnchorElement.href")}} + - : 一个字符串,是相对于文档解析 [`href`](/zh-CN/docs/Web/HTML/Element/a#href) HTML 属性的结果,包含链接资源的有效 URL。 +- {{domxref("HTMLAnchorElement.hreflang")}} + - : 一个字符串,反映 [`hreflang`](/zh-CN/docs/Web/HTML/Element/a#hreflang) HTML 属性,指示链接资源的语言。 +- {{domxref("HTMLAnchorElement.origin")}} {{ReadOnlyInline}} + - : 返回一个字符串,包含 URL 的来源,即其协议、域名和端口。 +- {{domxref("HTMLAnchorElement.password")}} + - : 一个字符串,包含域名前指定的密码。 +- {{domxref("HTMLAnchorElement.pathname")}} + - : 一个字符串,包含一个初始的 `/`,后跟 URL 的路径,不包括查询字符串或片段。 +- {{domxref("HTMLAnchorElement.ping")}} + - : 一个由空格分隔的 URL 列表。当链接被点击时,浏览器将向这些 URL 发送带有 PING 正文的 {{HTTPMethod("POST")}} 请求。 +- {{domxref("HTMLAnchorElement.port")}} + - : 一个字符串,表示引用 URL 中的端口组件(如果存在)。 +- {{domxref("HTMLAnchorElement.protocol")}} + - : 一个字符串,表示引用 URL 中的协议组件,包括尾随的冒号(`:`)。 +- {{domxref("HTMLAnchorElement.referrerPolicy")}} + - : 一个字符串,反映 [`referrerpolicy`](/zh-CN/docs/Web/HTML/Element/a#referrerpolicy) HTML 属性,指示应使用哪个来源地址。 +- {{domxref("HTMLAnchorElement.rel")}} + - : 一个字符串,反映 [`rel`](/zh-CN/docs/Web/HTML/Element/a#rel) HTML 属性,指定目标对象与链接对象的关系。 +- {{domxref("HTMLAnchorElement.relList")}} {{ReadOnlyInline}} + - : 返回一个 {{domxref("DOMTokenList")}}(以标记列表的形式),反映 [`rel`](/zh-CN/docs/Web/HTML/Element/a#rel) HTML 属性。 +- {{domxref("HTMLAnchorElement.search")}} + - : 一个字符串,表示引用 URL 中的搜索元素,如果存在,则包括前导问号 `?`。 +- {{domxref("HTMLAnchorElement.target")}} + - : 一个字符串,反映 [`target`](/zh-CN/docs/Web/HTML/Element/a#target) HTML 属性,指示链接资源应在哪里显示。 +- {{domxref("HTMLAnchorElement.text")}} + - : 一个字符串,是 {{domxref("Node.textContent")}} 属性的同义词。 +- {{domxref("HTMLAnchorElement.type")}} + - : 一个字符串,反映 [`type`](/zh-CN/docs/Web/HTML/Element/a#type) HTML 属性,指示链接资源的 MIME 类型。 +- {{domxref("HTMLAnchorElement.username")}} + - : 一个包含域名前指定的用户名的字符串。 + +### 已弃用的属性 + +- `HTMLAnchorElement.charset` {{deprecated_inline}} + - : 表示链接资源的字符编码的字符串。 +- `HTMLAnchorElement.coords` {{deprecated_inline}} + - : 表示逗号分隔的坐标列表的字符串。 +- `HTMLAnchorElement.name` {{deprecated_inline}} + - : 表示锚点名称的字符串。 +- `HTMLAnchorElement.rev` {{deprecated_inline}} + - : 表示 [`rev`](/zh-CN/docs/Web/HTML/Element/a#rev) HTML 属性的字符串,该属性指定链接对象与目标对象的关系。 +- `HTMLAnchorElement.shape` {{deprecated_inline}} + - : 表示活动区域形状的字符串。 + +## 实例方法 + +_从其父接口 {{domxref("HTMLElement")}} 继承方法。_ + +- {{domxref("HTMLAnchorElement.toString()")}} + - : 返回一个包含完整 URL 的字符串。它是 {{domxref("HTMLAnchorElement.href")}} 的同义词,但不能用于修改该值。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 实现此接口的 HTML 元素:{{HTMLElement("a")}} diff --git a/files/zh-cn/web/api/htmlanchorelement/origin/index.md b/files/zh-cn/web/api/htmlanchorelement/origin/index.md index e379221036a5cd..e28d7c47ebd6a4 100644 --- a/files/zh-cn/web/api/htmlanchorelement/origin/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/origin/index.md @@ -1,39 +1,40 @@ --- -title: HTMLHyperlinkElementUtils.origin +title: HTMLAnchorElement:origin 属性 slug: Web/API/HTMLAnchorElement/origin +l10n: + sourceCommit: 59a92ab5609f0a021602f11843f3b00b16e67e6d --- -{{APIRef("URL API")}} +{{APIRef("HTML DOM")}} -**`HTMLHyperlinkElementUtils.origin`** 只读属性是一个 {{domxref("USVString")}} ,其中包含代表 URL 的原始码的 Unicode 序列化,即: +**`HTMLAnchorElement.origin`** 只读属性是一个字符串,包含所表示 URL 的来源的 Unicode 序列化形式。 -- for URL using the `http` or `https`, the scheme followed by `'://'`, followed by the domain, followed by `':'`, followed by the port (the default port, `80` and `443` respectively, if explicitely specified); -- for URL using `file:` scheme, the value is browser dependant; -- for URL using the `blob:` scheme, the origin of the URL following `blob:`. E.g `"blob:https://mozilla.org"` will have `"https://mozilla.org".` +即: -{{AvailableInWorkers}} +- 对于使用 `http` 或 `https` 协议的 URL,协议后跟 `'://'`,然后是域名,再后跟 `':'`,最后是端口号(如果明确指定了端口号,则分别为默认的 `80` 和 `443`); +- 对于使用 `file:` 协议的 URL,值依赖于浏览器; +- 对于使用 `blob:` 协议的 URL,`blob:` 后跟的 URL 的来源。例如,`"blob:https://mozilla.org"` 的 `origin` 将是 `"https://mozilla.org"`。 -## Syntax +## 值 -```plain -string = object.origin; -``` +一个字符串。 -## Examples +## 示例 ```js -// On this page, returns the origin -var result = window.location.origin; // Returns:'https://developer.mozilla.org' +// 文档中有一个 元素 +const anchor = document.getElementById("myAnchor"); +anchor.origin; // 返回“https://developer.mozilla.org” ``` -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 -- The {{domxref("HTMLHyperlinkElementUtils")}} mixin it belongs to. +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/password/index.md b/files/zh-cn/web/api/htmlanchorelement/password/index.md index e1686d3513f16c..f0e49500c3d533 100644 --- a/files/zh-cn/web/api/htmlanchorelement/password/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/password/index.md @@ -7,9 +7,9 @@ l10n: {{ApiRef("HTML DOM")}} -**`HTMLAnchorElement.password`** 属性是一个字符串,包含域名前面指定的密码。 +**`HTMLAnchorElement.password`** 属性是一个字符串,包含域名之前指定的密码。 -如果在没有首先设置 [`username`](/zh-CN/docs/Web/API/HTMLAnchorElement/username) 属性的情况下设置,则会静默失败。 +如果未先设置 [`username`](/zh-CN/docs/Web/API/HTMLAnchorElement/username) 属性就尝试设置此属性,则会静默失败。 ## 值 @@ -18,9 +18,9 @@ l10n: ## 示例 ```js -// 假设文档中有一个这样的元素: +// 文档中有一个 元素 const anchor = document.getElementByID("myAnchor"); -anchor.password; // 返回 'flabada' +anchor.password; // 返回“flabada” ``` ## 规范 diff --git a/files/zh-cn/web/api/htmlanchorelement/pathname/index.md b/files/zh-cn/web/api/htmlanchorelement/pathname/index.md index d55be95b189119..f19d1b43b31a61 100644 --- a/files/zh-cn/web/api/htmlanchorelement/pathname/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/pathname/index.md @@ -7,7 +7,7 @@ l10n: {{ApiRef("HTML DOM")}} -**`HTMLAnchorElement.pathname`** 属性是一个字符串,首先为 `'/'`,后面是不包含查询字符串或片段的 URL 路径(如果没有路径,则为空字符串)。 +**`HTMLAnchorElement.pathname`** 属性是一个字符串,包含一个初始的 `'/'`,后跟 URL 的路径,但不包括查询字符串或片段(如果没有路径,则为空字符串)。 ## 值 @@ -16,9 +16,9 @@ l10n: ## 示例 ```js -// 假设文档中有一个这样的元素: +// 文档中有一个 元素 const anchor = document.getElementById("myAnchor"); -anchor.pathname; // 返回 '/zh-CN/docs/HTMLAnchorElement' +anchor.pathname; // 返回“/zh-CN/docs/HTMLAnchorElement” ``` ## 规范 diff --git a/files/zh-cn/web/api/htmlanchorelement/ping/index.md b/files/zh-cn/web/api/htmlanchorelement/ping/index.md new file mode 100644 index 00000000000000..c2f4661c15673c --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/ping/index.md @@ -0,0 +1,43 @@ +--- +title: HTMLAnchorElement:ping 属性 +slug: Web/API/HTMLAnchorElement/ping +l10n: + sourceCommit: e9e2ec643ac69c132f31427a0b586ab2cf83ed58 +--- + +{{ApiRef("HTML DOM")}} + +{{domxref("HTMLAnchorElement")}} 接口的 **`ping`** 属性是一个由空格分隔的 URL 列表。当链接被点击时,浏览器将向这些 URL 发送带有 PING 正文的 {{HTTPMethod("POST")}} 请求。 + +它反映 {{HTMLElement("a")}} 元素的 `ping` 属性。 + +> [!NOTE] +> 此属性在 Firefox 中无效,并且出于隐私和安全考虑,其使用可能会受到限制。 + +## 示例 + +```html +示例链接 +``` + +```js +const anchorElement = document.getElementById("exampleLink"); +console.log(anchorElement.ping); // 输出:"https://example-tracking.com https://example-analytics.com" +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("HTMLAreaElement.ping")}} 属性 diff --git a/files/zh-cn/web/api/htmlanchorelement/port/index.md b/files/zh-cn/web/api/htmlanchorelement/port/index.md new file mode 100644 index 00000000000000..c3a7d5f378258b --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/port/index.md @@ -0,0 +1,45 @@ +--- +title: HTMLAnchorElement:port 属性 +slug: Web/API/HTMLAnchorElement/port +l10n: + sourceCommit: 354f23773b65bad14192eca53e4a63471061b158 +--- + +{{ApiRef("HTML DOM")}} + +{{domxref("HTMLAnchorElement")}} 接口的 **`port`** 属性是一个字符串,包含 URL 的端口号。如果端口是该协议的默认值,则该属性为空字符串。 + +> [!NOTE] +> 如果 {{domxref("HTMLAnchorElement")}} 对象引用的 URL 不包含明确的端口号(例如,`https://localhost`),或者包含的端口号是 URL 协议部分对应的默认端口号(例如,`https://localhost:443`),那么 `port` 属性将是一个空字符串:`''`。 + +## 值 + +一个字符串。 + +## 示例 + +### 从锚点链接获取端口号 + +```js +// 文档中有一个 元素 +const anchor = document.getElementByID("myAnchor"); +anchor.port; // 返回“” +``` + +```js +// 文档中的另一个 元素 +const anchor = document.getElementByID("myAnchor"); +anchor.port; // 返回“8888” +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/protocol/index.md b/files/zh-cn/web/api/htmlanchorelement/protocol/index.md index d24064211aec7c..da4e08536ab395 100644 --- a/files/zh-cn/web/api/htmlanchorelement/protocol/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/protocol/index.md @@ -1,11 +1,13 @@ --- title: HTMLAnchorElement:protocol 属性 slug: Web/API/HTMLAnchorElement/protocol +l10n: + sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 --- {{ApiRef("HTML DOM")}} -**`HTMLAnchorElement.protocol`** 属性是一个表示 URL 协议方案的字符串,包含结尾的 `':'`。 +**`HTMLAnchorElement.protocol`** 属性是一个字符串,表示 URL 的协议方案,包括末尾的 `':'`。 ## 值 @@ -13,12 +15,12 @@ slug: Web/API/HTMLAnchorElement/protocol ## 示例 -### 从锚点元素的链接中获取协议 +### 获取锚点链接的协议 ```js // 文档中有一个 元素 const anchor = document.getElementById("myAnchor"); -anchor.protocol; // 返回 'https:' +anchor.protocol; // 返回“https:” ``` ## 规范 @@ -31,4 +33,4 @@ anchor.protocol; // 返回 'https:' ## 参见 -- 所属的 {{domxref("HTMLAnchorElement")}} 接口。 +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/referrerpolicy/index.md b/files/zh-cn/web/api/htmlanchorelement/referrerpolicy/index.md index 7050bd7cfaddb1..e1aa08caea7d87 100644 --- a/files/zh-cn/web/api/htmlanchorelement/referrerpolicy/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/referrerpolicy/index.md @@ -1,36 +1,46 @@ --- -title: HTMLAnchorElement.referrer +title: HTMLAnchorElement:referrerPolicy 属性 slug: Web/API/HTMLAnchorElement/referrerPolicy +l10n: + sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 --- {{APIRef}} -**`HTMLAnchorElement.referrer`** 属性对应于 HTML 中 {{HTMLElement("a")}} 标签的 [`referrer`](/zh-CN/docs/Web/HTML/Element/a#referrer) 属性,它可以控制用户在点击这个链接时所发出的 HTTP 请求的 Referer 请求头的值。 - -## 语法 - -```js -refStr = anchorElt.referrer; -anchorElt.referrer = refStr; -``` - -### 属性值 - -- `"no-referrer"` 意味着不要发送 Referer 请求头。 -- `"origin"` 意味着所发送的 Referer 请求头的值为当前页面的源,即 `location.origin` 的值。 -- `"unsafe-url"` 意味着所发送的 Referrer 请求头的值为当前页面完整的 url(即 `location.href`)去掉尾部的哈希(即 `location.hash`)之后的值。正如该选项的名字所言(unsafe),此选项是不安全的,它可以将一个 HTTPS 页面的路径信息透露给第三方。 +**`HTMLAnchorElement.referrerPolicy`** 属性反映 {{HTMLElement("a")}} 元素的 HTML [`referrerpolicy`](/zh-CN/docs/Web/HTML/Element/a#referrerpolicy) 属性,该属性定义获取资源时发送哪个来源地址(referrer)。 + +## 值 + +一个字符串;以下值之一: + +- `no-referrer` + - : {{HTTPHeader("Referer")}} 标头将被完全省略。请求中不会发送任何来源地址。 +- `no-referrer-when-downgrade` + - : 当协议安全级别保持不变时(例如,HTTP → HTTP、HTTPS → HTTPS),该 URL 会作为来源地址发送,但不会发送到安全级别较低的目的地(例如,HTTPS → HTTP)。 +- `origin` + - : 在所有情况下,仅将文档的来源作为来源地址发送。`https://example.com/page.html` 文档将发送来源地址 `https://example.com/`。 +- `origin-when-cross-origin` + - : 在执行同源请求时发送完整的 URL,但在其他情况下仅发送文档的来源。 +- `same-origin` + - : 对于[同源策略](/zh-CN/docs/Web/Security/Same-origin_policy),将会发送来源地址,但跨源请求将不包含任何来源地址信息。 +- `strict-origin` + - : 当协议安全级别保持不变(HTTPS → HTTPS)时仅发送文档的源作为来源地址,但不发送到安全性较低的目的地(HTTPS → HTTP)。 +- `strict-origin-when-cross-origin` (default) + - : 这是用户代理未指定策略时的默认行为。执行同源请求时发送完整的 URL,仅当协议安全级别保持不变(HTTPS → HTTPS)时发送源,并且不向安全性较低的目的地(HTTPS → HTTP)发送任何标头。 +- `unsafe-url` + - : 在执行同源或跨源请求时发送完整的 URL。此策略会将 TLS 保护的资源的来源和路径泄露给不安全的来源。请仔细考虑此设置的影响。 ## 示例 ```js -var elt = document.createElement("a"); -var linkText = document.createTextNode("My link"); +const elt = document.createElement("a"); +const linkText = document.createTextNode("My link"); elt.appendChild(linkText); -elt.href = "https://developer.mozilla.org/en-US/"; -elt.referrer = "no-referrer"; +elt.href = "https://developer.mozilla.org/zh-CN/"; +elt.referrerPolicy = "no-referrer"; -var div = document.getElementById("divAround"); -div.appendChild(elt); // 点击该链接接时不会发送 Referer 请求头 +const div = document.getElementById("divAround"); +div.appendChild(elt); // 点击时,链接将不发送来源地址标头 ``` ## 规范 @@ -43,4 +53,4 @@ div.appendChild(elt); // 点击该链接接时不会发送 Referer 请求头 ## 参见 -- {{domxref("HTMLImageElement.referrerPolicy")}}、{{domxref("HTMLAreaElement.referrerPolicy")}} 和 {{domxref("HTMLIFrameElement.referrerPolicy")}} +- {{domxref("HTMLImageElement.referrerPolicy")}}、{{domxref("HTMLAreaElement.referrerPolicy")}} 和 {{domxref("HTMLIFrameElement.referrerPolicy")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/rel/index.md b/files/zh-cn/web/api/htmlanchorelement/rel/index.md new file mode 100644 index 00000000000000..b3bc10b0198233 --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/rel/index.md @@ -0,0 +1,36 @@ +--- +title: HTMLAnchorElement:rel 属性 +slug: Web/API/HTMLAnchorElement/rel +l10n: + sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18 +--- + +{{APIRef("HTML DOM")}} + +**`HTMLAnchorElement.rel`** 属性反映 [`rel`](/zh-CN/docs/Web/HTML/Attributes/rel) 属性。它是一个字符串,包含由空格分隔的链接类型列表,这些类型指示由 {{HTMLElement("a")}} 元素表示的资源与当前文档之间的关系。 + +## 值 + +一个字符串。 + +## 示例 + +```js +const anchors = document.getElementsByTagName("a"); +for (const anchor of anchors) { + alert(`关系:${anchor.rel}`); +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 在 {{HTMLElement("area")}} 和 {{HTMLElement("link")}} 元素上对应的属性是 {{domxref("HTMLAreaElement.rel")}} 和 {{domxref("HTMLLinkElement.rel")}}。 +- 相同的列表,但以标记形式表示:{{domxref("HTMLAnchorElement.relList")}} diff --git a/files/zh-cn/web/api/htmlanchorelement/rellist/index.md b/files/zh-cn/web/api/htmlanchorelement/rellist/index.md new file mode 100644 index 00000000000000..0bcd3fe0230212 --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/rellist/index.md @@ -0,0 +1,44 @@ +--- +title: HTMLAnchorElement:relList 属性 +slug: Web/API/HTMLAnchorElement/relList +l10n: + sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc +--- + +{{APIRef("HTML DOM")}} + +**`HTMLAnchorElement.relList`** 只读属性反映了 [`rel`](/zh-CN/docs/Web/HTML/Attributes/rel) 属性。它是一个实时的 {{domxref("DOMTokenList")}},包含表示由 {{HTMLElement("a")}} 元素代表的资源与当前文档之间关系的链接类型。 + +该属性本身是只读的,意味着你不能将其替换为另一个 {{domxref("DOMTokenList")}},但其内容仍然可以被修改。 + +## 值 + +一个包含字符串的实时 {{domxref("DOMTokenList")}}。 + +## 示例 + +```js +const anchors = document.getElementsByTagName("a"); +for (const anchor of anchors) { + const list = anchor.relList; + console.log( + `在 relList 中发现了包含 ${list.length} 个链接类型的新锚点节点。`, + ); + list.forEach((relValue) => { + console.log(relValue); + }); +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 在 {{HTMLElement("area")}} 和 {{HTMLElement("link")}} 元素上对应的属性是 {{domxref("HTMLAreaElement.relList")}} 和 {{domxref("HTMLLinkElement.relList")}}。 +- 完全相同的列表,但以一个由空格分隔的标记组成的字符串形式:{{domxref("HTMLAnchorElement.rel")}} diff --git a/files/zh-cn/web/api/htmlanchorelement/search/index.md b/files/zh-cn/web/api/htmlanchorelement/search/index.md index 67cb4381d3ab95..b28c96a3b27a00 100644 --- a/files/zh-cn/web/api/htmlanchorelement/search/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/search/index.md @@ -1,29 +1,37 @@ --- -title: HTMLHyperlinkElementUtils.search +title: HTMLAnchorElement:search 属性 slug: Web/API/HTMLAnchorElement/search +l10n: + sourceCommit: ab007c32f6ef1f5d426f8ff806c67652692e4108 --- -{{ApiRef("URL API")}} +{{ApiRef("HTML DOM")}} -**`HTMLHyperlinkElementUtils.search`** 属性是一个搜索字符串,也叫做查询字符串,它是一个 {{domxref("USVString")}} ,包含 `'?'` 和随后的 URL 参数。 +**`HTMLAnchorElement.search`** 属性是一个搜索字符串,也称为*查询字符串*,它是一个包含 `'?'` 后跟 URL 参数的字符串。 -## 语法 +现代浏览器提供了 [`URLSearchParams`](/zh-CN/docs/Web/API/URLSearchParams/get#examples) 和 [`URL.searchParams`](/zh-CN/docs/Web/API/URL/searchParams#examples),以便轻松地从查询字符串中解析出参数。 -```plain -string = object.search; -object.search = string; -``` +## 值 + +一个字符串。 ## 示例 +### 从锚点链接中获取搜索字符串 + ```js -// 让一个 -// -// 元素在文档里 +// 文档中有一个 元素 +const anchor = document.getElementById("myAnchor"); +anchor.search; // 返回“?q=123” +``` -let anchor = document.getElementById("myAnchor"); -let result = anchor.search; -// 返回:'?q=123' +### 使用 URLSearchParams 进行高级解析 + +另外,也可以使用 [`URLSearchParams`](/zh-CN/docs/Web/API/URLSearchParams/get#examples): + +```js +let params = new URLSearchParams(queryString); +let q = parseInt(params.get("q")); // 返回数字 123 ``` ## 规范 @@ -34,6 +42,6 @@ let result = anchor.search; {{Compat}} -## 相关链接 +## 参见 -- 它属于{{domxref("HTMLHyperlinkElementUtils")}} mixin。 +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/target/index.md b/files/zh-cn/web/api/htmlanchorelement/target/index.md new file mode 100644 index 00000000000000..3ad06aa8ac123d --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/target/index.md @@ -0,0 +1,44 @@ +--- +title: HTMLAnchorElement:target 属性 +slug: Web/API/HTMLAnchorElement/target +l10n: + sourceCommit: bb48907e64eb4bf60f17efd7d39b46c771d220a0 +--- + +{{ApiRef("HTML DOM")}} + +{{domxref("HTMLAnchorElement")}} 接口的 **`target`** 属性是一个字符串,用于指示在何处显示链接的资源。 + +它反映 {{HTMLElement("a")}} 元素的 [`target`](/zh-CN/docs/Web/HTML/Element/a#target) 属性。 + +## 值 + +表示目标的字符串,它的值可以是: + +- {{HTMLElement("frame")}} 的名字。 +- [特定值的关键字](/zh-CN/docs/Web/HTML/Element/a#target)之一:`_blank`、`_self`、`_parent` 或 `_top`。 + +## 示例 + +```html +示例 1 +``` + +```js +const link = document.querySelector(".link1"); +console.log(link.target); // 输出:“_blank” +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("HTMLBaseElement.target")}} 属性 +- {{domxref("HTMLFormElement.target")}} 属性 +- {{domxref("HTMLAreaElement.target")}} 属性 diff --git a/files/zh-cn/web/api/htmlanchorelement/text/index.md b/files/zh-cn/web/api/htmlanchorelement/text/index.md new file mode 100644 index 00000000000000..1e90c7c3a1a0f2 --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/text/index.md @@ -0,0 +1,50 @@ +--- +title: HTMLAnchorElement:text 属性 +slug: Web/API/HTMLAnchorElement/text +l10n: + sourceCommit: 5d670c42df8ede57e3d6341cb15d8251eb188dc4 +--- + +{{ApiRef("HTML DOM")}} + +{{domxref("HTMLAnchorElement")}} 的 **`text`** 属性表示元素内部的文本。此属性与 {{domxref("Node.textContent")}} 表示的信息相同。 + +## 值 + +一个字符串。 + +## 示例 + +```html +示例链接 + +``` + +```css +#exampleLink { + font-size: 1.5rem; +} +``` + +```js +const anchorElement = document.getElementById("exampleLink"); +const pTag = document.querySelector(".text"); +pTag.textContent = `文本属性:${anchorElement.text}`; +``` + +### 结果 + +{{EmbedLiveSample("示例",100,100)}} + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("HTMLScriptElement.text")}} 属性 +- {{domxref("HTMLOptionElement.text")}} 属性 diff --git a/files/zh-cn/web/api/htmlanchorelement/tostring/index.md b/files/zh-cn/web/api/htmlanchorelement/tostring/index.md index 9fc44b60fce124..999418664f981e 100644 --- a/files/zh-cn/web/api/htmlanchorelement/tostring/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/tostring/index.md @@ -1,29 +1,36 @@ --- -title: HTMLHyperlinkElementUtils.toString() +title: HTMLAnchorElement:toString() 方法 slug: Web/API/HTMLAnchorElement/toString +l10n: + sourceCommit: b829b2fae917b5b931011ddeb6a0d1b2d2b81c54 --- {{ApiRef("URL API")}} -**`HTMLHyperlinkElementUtils.toString()`** 方法返回一个包含整个 URL 的 {{domxref("USVString")}} 。它是{{domxref("HTMLHyperlinkElementUtils.href")}} 的一个只读版本。 +**`HTMLAnchorElement.toString()`** {{Glossary("stringifier", "字符串化器")}}方法返回一个包含完整 URL 的字符串。它是 {{domxref("HTMLAnchorElement.href")}} 的只读版本。 -## 句法 +## 语法 -```plain -string = object.toString(); +```js-nolint +toString() ``` -## 范例 +### 参数 + +无。 + +### 返回值 + +一个包含元素完整 URL 的字符串。 + +## 示例 + +### 在锚点元素上调用 toString ```js -/* -Let's imagine an - - element is in the document -*/ -var anchor = document.getElementById("myAnchor"); -var result = anchor.toString(); -// Returns: 'https://developer.mozilla.org/zh-CN/docs/HTMLHyperlinkElementUtils/toString' +// 文档中有一个 元素 +const anchor = document.getElementById("myAnchor"); +anchor.toString(); // 返回“https://developer.mozilla.org/zh-CN/docs/HTMLAnchorElement” ``` ## 规范 @@ -36,4 +43,4 @@ var result = anchor.toString(); ## 参见 -- The {{domxref("HTMLHyperlinkElementUtils")}} mixin it belongs to. +- 所属接口 {{domxref("HTMLAnchorElement")}}。 diff --git a/files/zh-cn/web/api/htmlanchorelement/type/index.md b/files/zh-cn/web/api/htmlanchorelement/type/index.md new file mode 100644 index 00000000000000..dc1ad3530c7c3b --- /dev/null +++ b/files/zh-cn/web/api/htmlanchorelement/type/index.md @@ -0,0 +1,52 @@ +--- +title: HTMLAnchorElement:type 属性 +slug: Web/API/HTMLAnchorElement/type +l10n: + sourceCommit: 10346c8cf5dfe6e030bd1cdc32f04461afaa8c64 +--- + +{{ApiRef("HTML DOM")}} + +{{domxref("HTMLAnchorElement")}} 接口的 **`type`** 属性是一个字符串,用于指示链接资源的 MIME 类型。 + +它反映 {{HTMLElement("a")}} 元素的 `type` 属性。 + +## 值 + +一个字符串。 + +## 示例 + +```html +示例链接 + +``` + +```css +#exampleLink { + font-size: 1.5rem; +} +``` + +```js +const anchorElement = document.getElementById("exampleLink"); +const pTag = document.querySelector(".type"); +console.log(anchorElement.type); // 输出:“text/html” +pTag.textContent = anchorElement.type; +``` + +{{EmbedLiveSample("示例",100,100)}} + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("HTMLLinkElement.type")}} 属性 +- {{domxref("HTMLSourceElement.type")}} 属性 +- {{domxref("HTMLEmbedElement.type")}} 属性 diff --git a/files/zh-cn/web/api/htmlanchorelement/username/index.md b/files/zh-cn/web/api/htmlanchorelement/username/index.md index 27f592fe44bb04..e1eab4f179a0a3 100644 --- a/files/zh-cn/web/api/htmlanchorelement/username/index.md +++ b/files/zh-cn/web/api/htmlanchorelement/username/index.md @@ -20,7 +20,7 @@ l10n: ```js // 假设文档中含有这样的元素: const anchor = document.getElementByID("myAnchor"); -anchor.username; // 返回 'anonymous' +anchor.username; // 返回“anonymous” ``` ## 规范