String.prototype.link()

已弃用:此功能不再推荐。尽管某些浏览器可能仍支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表,以指导您的决策。请注意,此功能可能随时停止工作。

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

注意:所有 HTML 包装器方法 均已弃用,仅出于兼容性目的而标准化。请改用 DOM API,例如 document.createElement()

语法

js
link(url)

参数

url

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

返回值

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

示例

以下代码创建了一个 HTML 字符串,然后用它替换文档的主体

js
const contentString = "MDN Web Docs";

document.body.innerHTML = contentString.link("https://mdn.org.cn/");

这将创建以下 HTML

html
<a href="https://mdn.org.cn/">MDN Web Docs</a>

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

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

规范

规范
ECMAScript 语言规范
# sec-string.prototype.link

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅