String.prototype.link()

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

String 值的 link() 方法创建一个字符串,将该字符串嵌入到 <a> 元素 (<a href="...">str</a>) 中,以用作指向另一个 URL 的超文本链接。

¥The link() method of String values creates a string that embeds this string in an <a> element (<a href="...">str</a>), to be used as a hypertext link to another URL.

注意:所有 HTML 封装方法 均已弃用,仅出于兼容性目的而进行标准化。使用 DOM API 例如 document.createElement() 代替。

¥Note: All HTML wrapper methods are deprecated and only standardized for compatibility purposes. Use DOM APIs such as document.createElement() instead.

语法

¥Syntax

js
link(url)

参数

¥Parameters

url

指定 <a> 元素的 href 属性的任何字符串;它应该是一个有效的 URL(相对或绝对),任何 & 字符都转义为 &amp;

返回值

¥Return value

<a href="url"> 开始标记(url 中的双引号替换为 &quot;)开头的字符串,然后是文本 str,然后是 </a> 结束标记。

¥A string beginning with an <a href="url"> start tag (double quotes in url are replaced with &quot;), then the text str, and then an </a> end tag.

示例

¥Examples

使用链接()

¥Using link()

下面的代码创建一个 HTML 字符串,然后用它替换文档的正文:

¥The code below creates an HTML string and then replaces the document's body with it:

js
const contentString = "MDN Web Docs";

document.body.innerHTML = contentString.link("https://web.nodejs.cn/");

这将创建以下 HTML:

¥This will create the following HTML:

html
<a href="https://web.nodejs.cn/">MDN Web Docs</a>

你应该使用 DOM API(例如 document.createElement()),而不是使用 link() 并直接创建 HTML 文本。例如:

¥Instead of using link() and creating HTML text directly, you should use DOM APIs such as document.createElement(). For example:

js
const contentString = "MDN Web Docs";
const elem = document.createElement("a");
elem.href = "https://web.nodejs.cn/";
elem.innerText = contentString;
document.body.appendChild(elem);

规范

Specification
ECMAScript Language Specification
# sec-string.prototype.link

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看