String.prototype.link()

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

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® 2026 语言规范
# sec-string.prototype.link

浏览器兼容性

另见