2011-09-28 28 views
6

我正在寫一個在線教程,裏面有一些附註或者他們稱之爲「訓誡」,類似於Django中的教程: https://docs.djangoproject.com/en/dev/intro/tutorial01/(我的意思是帶有綠色框和註釋圖標的框)。哪個語義HTML標籤用於顯示旁註和警告?

我應該使用哪個HTML標籤來附加這些註釋以添加註釋的語義,這對於在教程的給定點閱讀可能有用,但不是主教程流的一部分?

值得注意的是,標籤必須允許封閉塊元素。

+1

xhtml或html5? –

+0

爲什麼選擇XHTML?那麼,也許我應該至少指定HTML版本 - 但很高興知道HTML4和5的解決方案。 – jan

+0

因爲,正如Ben Lee回答的那樣,xhtml沒有這種內容的語義標籤,而html5的標籤=) –

回答

5

在HTML5(受所有現代瀏覽器支持)下,標籤爲aside

http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html#the-aside-element

的一邊元素表示由 內容是相切關係到一旁 元件周圍的內容的頁面的部分,並且其可以被認爲是來自該內容是分開的。 這些部分通常以印刷字體的側邊欄表示。

該元素可用於印刷效果,如拉引號或用於廣告的導出欄,用於導航元素組的頁面,以及與頁面的主要內容分開的其他 內容。

僅將括號用於括號, 是不合適的,因爲它們是文檔主流程的一部分。

這是一個塊級元素和包圍任何一個塊級元素可以通常(即幾乎所有的東西)。它本質上是一個「語義分支」。

+1

更好的描述在[規範](http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html#the-aside-element)中。爲什麼要在源文件寫得很好時閱讀次要評論? – Arsen7

+0

@ Arsen7,好點。更新。 –

6

我相信接受的答案是不完全正確的。按照HTML5 working draft,該<aside>元素可以用來標記在某些方面的筆記,但並非所有的案件:

  1. <aside>是合適的,如果側面說明「可以從內容視爲單獨的」,對於在更長的新聞報道中提供關於瑞士的背景材料的示例,或更長的文章中的拉引語。 (來自W3C文檔的示例)
  2. <aside>如果旁註是「括號」,則不適用。 W3C沒有舉例說明它的含義。狹義的解釋是任何放在括號內,逗號之間或破折號之間的內容。

如果要嚴格解釋W3C規範,並不是所有的圖片的標題說明在Django tutorial可以用<aside>標記起來。例如,標題爲「與您所看到的內容不符的註釋」「無法真正被視爲與內容分離,因爲如果沒有內容旁邊的內容,它就沒有任何意義。可以說,「此代碼應該在哪裏生存?」也不是<aside>,因爲它提到了「此代碼」,它將其與內容綁定在一起。

在我看來,W3C的定義是不必要的混淆和限制。旁邊的的字典定義是「暫時偏離主題或主題」,規範應該堅持這一點,而不是引入微妙的區別。當然,如果你的代碼更簡單,沒有理由不能爲所有的註釋使用<aside>。把它看作公民不服從。 :)


相關報價:

的aside元素代表由 內容頁面的部分,其相切關係到一旁 元件周圍的內容,並可以考慮與該內容分開。 這些部分通常以印刷字體的側邊欄表示。

該元素可用於印刷效果,如拉引號或用於廣告的導出欄,用於導航元素組的頁面,以及與頁面的主要內容分開的其他 內容。

注意:僅爲括號使用拋開元素是不合適的,因爲這些屬性是文檔主流程的一部分。