以大膽連結的方式沒有任何人連結:文字片段

文字片段可讓您在網址片段中指定文字片段。前往含有這類文字片段的網址時,瀏覽器可以強調該片段,吸引使用者注意。

片段 ID

Chrome 80 是重大版本。其中包含許多備受期待的功能,例如 Web Worker 中的 ECMAScript 模組、空值聯合、選用鏈結等。一如往常,我們在 Chromium 網誌上發布網誌文章,宣布推出新版本。您可以在下方螢幕截圖中看到網誌文章的摘錄。

Chromium 網誌文章,其中含有 id 屬性的元素周圍有紅色方塊。

您可能會想知道所有紅色方塊代表什麼意思。這些是您在開發人員工具中執行下列程式碼片段的結果。系統會醒目顯示所有具有 id 屬性的元素。

document.querySelectorAll('[id]').forEach((el) => {
  el.style.border = 'solid 2px red';
});

我可以使用片段 ID,在網頁網址的雜湊中使用,為任何以紅色方塊醒目顯示的元素放置深層連結。假設我想在側邊欄中深層連結至「在產品論壇中提供意見」方塊,可以手動建立網址 https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#HTML1。如開發人員工具的「Elements」面板所示,有問題的元素具有 id 屬性,值為 HTML1。

開發人員工具顯示元素的 id。

如果使用 JavaScript 的 URL() 建構函式剖析這個網址,就會顯示不同的元件。請注意,hash 屬性的值為 #HTML1。

new URL('https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#HTML1');
/* Creates a new `URL` object
URL {
  hash: "#HTML1"
  host: "blog.chromium.org"
  hostname: "blog.chromium.org"
  href: "https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#HTML1"
  origin: "https://blog.chromium.org"
  password: ""
  pathname: "/2019/12/chrome-80-content-indexing-es-modules.html"
  port: ""
  protocol: "https:"
  search: ""
  searchParams: URLSearchParams {}
  username: ""
}
*/

不過,我必須開啟開發人員工具才能找到元素的 id,這充分說明瞭網誌文章作者可能不打算連結到網頁的這個特定部分。

如果我想連結到沒有 id 的內容,該怎麼辦?假設我想連結至「ECMAScript Modules in Web Workers」標題。如以下螢幕截圖所示,有問題的 <h1> 沒有 id 屬性,因此無法連結至這個標題。文字片段就是為瞭解決這個問題。

開發人員工具顯示沒有 id 的標題。

文字片段

文字片段提案新增了在網址雜湊中指定文字片段的支援。前往含有這類文字片段的網址時,使用者代理程式可以強調該片段,並吸引使用者注意。

瀏覽器相容性

Browser Support

  • Chrome: 89.
  • Edge: 89.
  • Firefox: 131.
  • Safari: 18.2.

Source

基於安全性考量,這項功能要求在 noopener 情境中開啟連結。因此,請務必在 <a> 錨定標記中加入 rel="noopener",或在 Window.open() 視窗功能清單中加入 noopener。

start

文字片段的語法最簡單的形式如下:井字號 # 後面接著 :~:text=,最後是 start,代表我要連結的百分比編碼文字。

#:~:text=start

舉例來說,假設我想連結至宣布 Chrome 80 功能的網誌文章中的「ECMAScript Modules in Web Workers」標題,則網址會是:

https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=ECMAScript%20Modules%20in%20Web%20Workers

文字片段會像這樣醒目顯示。 如果您在 Chrome 等支援的瀏覽器中點選連結,文字片段會醒目顯示,並捲動到畫面中:

捲動至特定文字片段並醒目顯示。

start和end

現在,如果我想連結到標題為「Web Worker 中的 ECMAScript 模組」的整個部分,而不只是標題,該怎麼辦?如果對整個章節的文字進行百分比編碼,產生的網址會過長,不切實際。

幸好,有更好的方法。我可以使用 start,end 語法,將特定部分文字框起來,而不是整個文字。我指定了文字片段開頭的幾個百分比編碼字詞,以及文字片段結尾的幾個百分比編碼字詞,並以半形逗號分隔。

如下所示:

https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=ECMAScript%20Modules%20in%20Web%20Workers,ES%20Modules%20in%20Web%20Workers.。

在 start 中,我輸入 ECMAScript%20Modules%20in%20Web%20Workers,接著輸入逗號,然後輸入 ES%20Modules%20in%20Web%20Workers. 做為 end。在 Chrome 等支援的瀏覽器中點選連結時,系統會醒目顯示整個區段,並捲動至該區段:

捲動至特定文字片段並醒目顯示。

您可能會好奇,為什麼我選擇 start 和 end。事實上,稍微短一點的網址 https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=ECMAScript%20Modules,Web%20Workers. (每邊只有兩個字詞) 也可以。比較 start 和 end 與先前的值。

如果我更進一步,現在只用一個字詞來代表 start 和 end,您就會發現我遇到麻煩了。網址 https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=ECMAScript,Workers. 現在更短了,但醒目顯示的文字片段不再是原本選擇的文字片段。醒目顯示會在第一次出現 Workers. 這個字時停止,這是正確的,但不是我想醒目顯示的內容。問題在於,目前的單字 start 和 end 值無法唯一識別所選部分:

非預期的文字片段捲動至畫面中並醒目顯示。

prefix-和-suffix

為 start 和 end 使用夠長的值,是取得不重複連結的一種解決方案。不過,在某些情況下,這是不可能的。順帶一提,為什麼我選擇 Chrome 80 版本網誌文章做為範例?答案是,這個版本推出了文字片段:

網誌文章文字:文字網址片段。使用者或作者現在可以使用網址中提供的文字片段,連結至頁面的特定部分。網頁載入後,瀏覽器會醒目顯示文字,並捲動至該片段。舉例來說,下列網址會載入「Cat」的維基百科頁面,並捲動至 `text` 參數中列出的內容。
Text Fragments announcement blog post excerpt.

請注意,在上方螢幕截圖中,「text」一詞出現了四次。第四個出現位置則以綠色程式碼字型顯示。如要連結至這個特定字詞,請將 start 設為 text。由於「text」這個字只有一個字,因此不能有 end。接下來該怎麼做?網址 https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=text 會在標題中首次出現「Text」一詞時比對成功:

文字片段比對,比對到第一個出現的「Text」。

幸好,我們有解決方案。在這種情況下,我可以指定 prefix- 和 -suffix。綠色程式碼字型「text」前面的字是「the」,後面的字是「parameter」。「text」一詞的其他三個出現位置,前後都沒有相同的字詞。有了這項資訊,我就可以調整先前的網址,並新增 prefix- 和 -suffix。與其他參數一樣,這些參數也需要經過百分比編碼,且可以包含多個字詞。https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=the-,text,-parameter。 為讓剖析器清楚識別 prefix- 和 -suffix,必須使用破折號 - 將兩者與 start 和選用的 end 分隔開來。

文字片段與所選「文字」相符。

完整語法

文字片段的完整語法如下。(方括號表示選用參數)。所有參數的值都必須經過百分比編碼。這對破折號 -、和號 & 和逗號 , 字元尤為重要,以免系統將這些字元解讀為文字指令語法的一部分。

#:~:text=[prefix-,]start[,end][,-suffix]

prefix-、start、end 和 -suffix 只能比對單一區塊層級元素中的文字,但完整的 start,end 範圍「可以」跨越多個區塊。舉例來說,在以下範例中,:~:text=The quick,lazy dog 無法比對,因為起始字串「The quick」並未出現在單一、不中斷的區塊層級元素中:

<div>
  The
  <div></div>
  quick brown fox
</div>
<div>jumped over the lazy dog</div>

不過,在以下範例中,兩者會相符:

<div>The quick brown fox</div>
<div>jumped over the lazy dog</div>

使用瀏覽器擴充功能建立文字片段網址

手動建立文字片段網址相當繁瑣,尤其是要確保網址不重複。如果您真的想這麼做,規格中提供了一些提示,並列出產生文字片段網址的確切步驟。我們提供名為 Link to Text Fragment 的開放原始碼瀏覽器擴充功能,可讓您選取任何文字,然後在內容選單中按一下「Copy Link to Selected Text」,即可連結至該文字。這項擴充功能適用於下列瀏覽器:

Link to Text Fragment 瀏覽器擴充功能。

單一網址中有多個文字片段

請注意,一個網址中可以出現多個文字片段。特定文字片段必須以和號字元 & 分隔。以下是含有三個文字片段的連結範例:https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#:~:text=Text%20URL%20Fragments&text=text,-parameter&text=:~:text=On%20islands,%20birds%20can%20contribute%20as%20much%20as%2060%25%20of%20a%20cat's%20diet。

一個網址中的三個文字片段。

混合元素和文字片段

傳統元素片段可以與文字片段合併使用。在同一個網址中同時使用這兩者完全沒問題,例如在網頁上的原始文字變更時提供有意義的備用文字,這樣文字片段就不會再相符。連結至「Give us feedback in our Product Forums」部分的網址 https://blog.chromium.org/2019/12/chrome-80-content-indexing-es-modules.html#HTML1:~:text=Give%20us%20feedback%20in%20our%20Product%20Forums. 同時包含元素片段 (HTML1) 和文字片段 (text=Give%20us%20feedback%20in%20our%20Product%20Forums.):

同時連結元素片段和文字片段。

片段指令

語法中還有一個元素尚未說明:片段指令 :~:。為避免與現有網址元素片段發生相容性問題,文字片段規格導入了片段指令。片段指令是網址片段的一部分,以程式碼序列 :~: 分隔。這個字串保留給使用者代理程式指令 (例如 text=),並在載入期間從網址中移除,因此作者指令碼無法直接與其互動。使用者代理程式指令也稱為「指令」。在具體案例中,text= 因此稱為「文字指令」。

特徵偵測

如要偵測支援,請測試 document 上的唯讀 fragmentDirective 屬性。片段指令是一種網址機制,可指定導向瀏覽器 (而非文件) 的指令。這是為了避免與作者指令碼直接互動,以便日後新增使用者代理程式指令,而不必擔心對現有內容造成破壞性變更。未來可能新增的功能之一是翻譯提示。

if ('fragmentDirective' in document) {
  // Text Fragments is supported.
}

功能偵測主要用於動態產生連結的情況 (例如搜尋引擎),避免向不支援的瀏覽器提供文字片段連結。

設定文字片段樣式

根據預設,瀏覽器會以與 mark 相同的方式設定文字片段樣式 (通常是黃底黑字,即 mark 的 CSS 系統顏色)。使用者代理程式樣式表包含如下的 CSS:

:root::target-text {
  color: MarkText;
  background: Mark;
}

如您所見,瀏覽器會公開虛擬選取器 ::target-text,您可以使用該選取器自訂套用的醒目顯示。舉例來說,您可以將文字片段設計為紅色背景上的黑色文字。請務必檢查顏色對比度,確保覆寫樣式不會造成無障礙問題,並確保醒目顯示的內容在視覺上與其他內容有所區別。

:root::target-text {
  color: black;
  background-color: red;
}

Polyfill

文字片段功能在某種程度上可以進行 polyfill。我們提供 polyfill,由擴充功能在內部使用,適用於不提供內建文字片段支援的瀏覽器,其中功能是以 JavaScript 實作。

polyfill 包含 fragment-generation-utils.js 檔案,您可以匯入並使用該檔案產生文字片段連結。程式碼範例如下:

const { generateFragment } = await import('https://unpkg.com/text-fragments-polyfill/dist/fragment-generation-utils.js');
const result = generateFragment(window.getSelection());
if (result.status === 0) {
  let url = `${location.origin}${location.pathname}${location.search}`;
  const fragment = result.fragment;
  const prefix = fragment.prefix ?
    `${encodeURIComponent(fragment.prefix)}-,` :
    '';
  const suffix = fragment.suffix ?
    `,-${encodeURIComponent(fragment.suffix)}` :
    '';
  const start = encodeURIComponent(fragment.textStart);
  const end = fragment.textEnd ?
    `,${encodeURIComponent(fragment.textEnd)}` :
    '';
  url += `#:~:text=${prefix}${start}${end}${suffix}`;
  console.log(url);
}

取得文字片段,用於分析

許多網站會使用片段進行轉送,因此瀏覽器會移除文字片段,以免破壞這些網頁。公認有必要向網頁公開文字片段連結 (例如用於數據分析),但提議的解決方案尚未實作。目前可行的解決方法是使用下列程式碼擷取資訊。

new URL(performance.getEntries().find(({ type }) => type === 'navigate').name).hash;

安全性

文字片段指令只會在使用者啟動後,在完整 (非同頁) 導覽中叫用。此外,如果導覽的來源與目的地不同,則必須在 noopener 情境中進行導覽,確保目的地頁面已充分隔離。文字片段指令只會套用至主頁框。也就是說,系統不會在 iframe 內搜尋文字,且 iframe 導覽不會叫用文字片段。

隱私權

請務必確保文字片段規格的實作方式不會洩漏是否在網頁上找到文字片段。元素片段完全由原始網頁作者控制,但文字片段可由任何人建立。還記得在我的範例中,由於 <h1> 沒有 id,因此無法連結至「ECMAScript Modules in Web Workers」標題,但任何人 (包括我) 只要仔細設計文字片段,就能連結至任何位置嗎?

假設我經營一個惡意廣告聯播網 evil-ads.example.com。再假設,在其中一個廣告 iframe 中,我動態建立了一個隱藏的跨源 iframe,在使用者與廣告互動後,使用文字片段網址 dating.example.com#:~:text=Log%20Out dating.example.com。如果找到「登出」文字,我就知道受害者已登入 dating.example.com,並可利用這項資訊建立使用者個人資料。由於單純的文字片段實作可能會決定成功比對應導致焦點切換,因此在 evil-ads.example.com 上,我可以監聽 blur 事件,進而得知何時發生比對。在 Chrome 中,我們實作文字片段的方式可避免這種情況發生。

另一種攻擊可能是根據捲動位置,利用網路流量。假設我有權存取受害者的網路流量記錄,例如公司內部網路的管理員。現在,假設有一份很長的人力資源文件,標題是「如果您有以下症狀,處置方式…」,然後列出「倦怠」、「焦慮」等症狀。我可以在清單中的每個項目旁邊放置追蹤像素。如果我判斷載入文件與載入追蹤像素 (例如「burn out」項目旁) 的時間點重疊,身為內部網路管理員,我就可以判斷員工點選了含有 :~:text=burn%20out 的文字片段連結,而員工可能認為這是機密資訊,不會被任何人看到。由於這個範例一開始就有些牽強,且需要滿足「非常」特定的前提條件才能利用,因此 Chrome 安全團隊評估後認為,實作捲動導覽功能的風險在可控範圍內。其他使用者代理程式可能會決定改為顯示手動捲動 UI 元素。

如果網站想選擇不採用,Chromium 支援可傳送的文件政策標頭值,讓使用者代理程式不會處理文字片段網址。

Document-Policy: force-load-at-top

停用文字片段

如要停用這項功能,最簡單的方法是使用可插入 HTTP 回應標頭的擴充功能,例如 ModHeader (非 Google 產品),插入回應 (而非要求) 標頭,如下所示:

Document-Policy: force-load-at-top

另一種較複雜的停用方式是使用企業設定 ScrollToTextFragmentEnabled。如要在 macOS 執行這項操作,請在終端機中貼上下列指令。

defaults write com.google.Chrome ScrollToTextFragmentEnabled -bool false

在 Windows 上,請按照 Google Chrome Enterprise 說明支援網站上的說明文件操作。

在某些搜尋中,Google 搜尋引擎會提供快速解答或摘要,並附上相關網站的內容片段。如果搜尋內容是問題形式,就最有可能顯示精選摘要。按一下精選摘要後,系統會將使用者直接引導至來源網頁上的精選摘要文字。這項功能是透過自動建立的文字片段網址運作。

Google 搜尋結果網頁顯示精選摘要。狀態列會顯示文字片段網址。
點選後,系統會捲動至網頁的相關部分。

結論

文字片段網址是一項強大功能,可連結至網頁上的任意文字。學術社群可使用這項功能,提供高度準確的引用或參考連結。搜尋引擎可使用這項功能,深層連結至網頁上的文字結果。社群網站可使用這項功能,讓使用者分享網頁的特定段落,而非無法存取的螢幕截圖。希望您開始使用文字片段網址,並發現它們和我一樣實用。請務必安裝連結至文字片段瀏覽器擴充功能。

特別銘謝

文字片段由 Nick Burris 和 David Bokan 實作及指定,並由 Grant Wang 協助。感謝 Joe Medley 仔細審查這份文件。