紀錄工作經驗、相關知識,解決技術相關問題。

HTML

HTML blockquote 標籤:引用區塊與 cite 屬性

HTML blockquote 標籤:引用區塊與 cite 屬性 特色圖片

HTML blockquote 標籤用來標示「從別的地方引用過來的一段話」,瀏覽器預設會把它縮排顯示。

白話一點,<blockquote> 像是把別人說的話框成獨立一塊,讓讀者一眼看出這段不是自己寫的。

blockquote 的基本寫法

<blockquote> 是區塊元素,開頭與結尾標籤都不能省略。裡面可以放段落、清單等流動內容(flow content),所以引用多段文字時,每段各用一個 <p>:

<p>他在報告中寫道:</p>
<blockquote cite="https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element">
  <p>Content inside a blockquote must be quoted from another source.</p>
</blockquote>
<p>— WHATWG HTML Living Standard</p>

規格要求 blockquote 裡的內容必須是引用自其他來源。引用很短時,也可以不包 <p>,直接把文字放在 <blockquote> 裡。

下圖是這段寫法在瀏覽器的渲染結果:

blockquote 的預設縮排、figure 搭配 figcaption 的寫法,以及用 CSS 改成左側色線的引用區塊

圖為 Windows 11、無頭 Chrome 158 的渲染畫面:第 1 組是預設樣式,引用文字左右縮排;第 2 組是 figure 搭配 figcaption;第 3 組是用 CSS 清掉縮排並加上左側色線。

cite 屬性:來源網址,不會顯示在畫面上

blockquote 除了全域屬性,只有一個專屬屬性 cite。它的值是引用來源文件或訊息的網址,規格要求必須是有效的 URL。

要注意的是,cite 屬性不會顯示在畫面上。規格說明,這類連結主要是給私下使用的,例如伺服器端的腳本統計網站的引用情況,並不是給讀者看的;瀏覽器可以讓使用者跳到這個網址,但不是必要行為。

下面這段腳本可以讀到 cite 的值,但畫面上的引用文字裡並沒有網址:

const quote = document.querySelector('blockquote');
console.log(quote.cite); // 絕對網址
console.log(quote.innerText.includes('https://')); // false

所以想讓讀者看到出處、點得到連結,要自己在 blockquote 外面寫出來,下一節說明寫法。

出處要放在 blockquote 外面

規格明確規定:引用的出處(attribution),如果有的話,必須放在 blockquote 元素的外面。MDN 的用法說明也這樣寫。

規格列出幾種做法,最簡單的是在引用後面另起一個段落:

<blockquote>
  <p>I contend that we are both atheists. I just believe in one fewer god than you do.</p>
</blockquote>
<p>— Stephen Roberts</p>

比較完整的做法是用 <figure> 包住引用,再用 <figcaption> 寫出處。出處不屬於引用的內容,所以 <figcaption> 要放在 <blockquote> 外面,而書名、文章名可以用 <cite> 標示:

<figure>
  <blockquote>
    <p>Cleverly designed experiments are the key.</p>
  </blockquote>
  <figcaption>Carl Sagan,<cite>Wonder and Skepticism</cite></figcaption>
</figure>

補充說明:<cite> 元素與 cite 屬性是兩個不同的東西。<cite> 元素標示作品的標題(MDN 的定義是 creative work 的標題),放在畫面上給讀者看;cite 屬性則是 blockquote(以及 q、ins、del)上的網址,不顯示。

引用可以縮短或補充說明

規格允許 blockquote 的內容依該語言的慣例被縮短,或加上補充的上下文。例如英文傳統上用方括號:原句是「Jane ate the cracker. She then said she liked apples and fish.」,可以引用成:

<blockquote>
  <p>[Jane] then said she liked [...] fish.</p>
</blockquote>

不論怎麼縮短或補充,規格的前提不變:blockquote 裡的內容必須是引用自其他來源。

預設樣式與用 CSS 調整

HTML 規格的渲染章節給 blockquote 的預設樣式是區塊顯示,上下邊距 1em,左右邊距 40px:

blockquote, figure { margin-inline: 40px; }
blockquote, figure, listing, p, plaintext, pre, xmp { margin-block: 1em; }

上面兩段 CSS 是規格列出的預設值。MDN 也建議要改縮排時,用 CSS 的 margin-left、margin-right 或簡寫 margin。例如清掉左右邊距,改用左側色線標示引用:

blockquote {
  margin-inline: 0;
  padding-inline-start: 1em;
  border-inline-start: 4px solid #4a7;
}

預設值也是用 Chrome 讀 getComputedStyle 得到的:一般 blockquote 的 margin-left 與 margin-right 都是 40px、上下是 16px;套上面的 CSS 後左右邊距變成 0px。

blockquote 與 q 怎麼選

兩者都是引用,差別在長度與呈現方式:

元素用在哪裡預設呈現
<blockquote>較長的引用,獨立成一個區塊區塊顯示、左右縮排
<q>不需要分段的短引用,放在句子裡多數現代瀏覽器會加上引號

MDN 說明 <q> 用於不需要分段的短引用,較長的引用則用 <blockquote>。兩個元素在 DOM 中都是 HTMLQuoteElement,也都有 cite 屬性。

另外,規格提醒:表示對話內容時,不適合用 cite 與 blockquote,規格另有專門的對話寫法。

小結

  • <blockquote> 標示從其他來源引用的內容,預設縮排顯示。
  • cite 屬性放來源網址,不會顯示在畫面上;要給讀者看的出處,寫在 blockquote 外面。
  • 出處可以用段落,或用 figure 與 figcaption 搭配 <cite> 標示作品名稱。
  • 想改縮排或外觀,用 CSS 的 margin 等屬性調整。
  • 不需要分段的短引用改用 <q>。

想了解語意化標籤如何選用與搭配,可以參考站內另一篇:HTML 語意化標籤的邊界:談 section、article 與 aside 的巢狀邏輯陷阱。

參考資料與延伸閱讀

發佈留言