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.club.tw/");

這將建立以下 HTML

html
<a href="https://mdn.club.tw/">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.club.tw/";
elem.innerText = contentString;
document.body.appendChild(elem);

規範

規範
ECMAScript® 2026 語言規範
# sec-string.prototype.link

瀏覽器相容性

另見