繼續往微格式的世界裡衝。依照原本的規劃,這篇大約落在整個系列的中段——前面我們已經談過三種微格式的用法:
rel 描述基於連結的關系;進度還不錯,但要完整介紹微格式,還有距離。所以今天我們來看 hCalendar——它替那些關於事件、以及依時間或地點舉辦的活動資訊,提供了語意與結構化的表達方式。
iCalendar(iCal)是分享日曆數據的標準,最常見的應用場景是電子郵件中的行程交換,但並不限於此。與 hCard 類似,開發者可以透過 hCalendar 把 iCalendar 格式的數據嵌入網頁之中。兩者之間是 1:1 的對應關系,因此解析器能直接從網頁提取資訊,交給日曆應用使用。
歷史補充:iCalendar 建立在 vCalendar 之上,而 vCalendar 是一套開源的線上日曆應用,用來發布與維護事件和時間表,並與 vCard 電子名片格式一同發展。
hCalendar 用來描述日曆中的事件(或任何以日期/時間為基礎的活動),包括但不限於:
與 hCard 相同,hCalendar 遵守幾條基本原則:
class 來標示;vevent);<p class="vevent summary"> 是無效寫法。還有一點雖不算規則,但值得牢記:用什麼標籤並不重要,決定 hCalendar 的是 class 的值。話雖如此,我仍強烈建議使用具語意性的標籤。
和其他微格式一樣,建議在頁面 <head> 中加上 profile 宣告:
<head profile="https://purl.org/uF/hCalendar/1.0/">
W3C 允許以空格分隔宣告多個 profile,因此你可以同時帶上多個:
<head profile="https://gmpg.org/xfn/11
https://purl.org/uF/hCard/1.0/
https://purl.org/uF/hCalendar/1.0/">
此外,由於 hCalendar 属于非提案微格式,你也可以改用涵蓋全部非提案微格式的組合 profile URL:
<head profile="https://purl.org/uF/2008/03/">
若你同時使用提案與非提案微格式,同樣可以採用上面這條組合宣告。
這個部落格還很新,能舉的實例不多。以下改寫自我近期一篇關於 BarCamp Albuquerque 3 的文章,裡面就用了 hCalendar:
<div class="vevent">
<p>Yes, it's short notice, but mark your calendars:
<a href="https://barcamp.org/BarCampAlbuquerque" class="url summary">
<span class="category">BarCamp</span> Albuquerque 3
</a> is this weekend.</p>
<dl>
<dt>When:</dt>
<dd>
<abbr class="dtstart" title="2008-09-13T09:00:00">September 13</abbr>–
<abbr class="dtend" title="2008-09-14T18:00:00">14</abbr>,
from 9am–6pm both days
</dd>
<dt>Where:</dt>
<dd class="location vcard">
<a class="fn org url" href="https://www.chefwhite.com/cjw_cafe.php">CJW Cafe</a>
on <a href="https://maps.google.com/maps" class="adr">
<span class="street-address">4801 Alameda
<abbr title="Boulevard">Blvd</abbr>
<abbr title="Northeast">NE</abbr></span>,
<span class="locality">Albuquerque</span>,
<abbr class="region" title="New Mexico">NM</abbr>
<span class="postal-code">87113</span>
</a>
</dd>
<dt>What:</dt>
<dd class="description">
A <abbr class="duration" title="P2D">two-day</abbr> event all about the web —
design (visual, experience, information architecture), technology
(infrastructure, programming), social and new media, and other stuff
that is just plain cool.
</dd>
</dl>
</div>
你可能注意到,例子的根屬性是 vevent 而不是 vcalendar。這是因為 hCalendar 的 vcalendar 是可選的根元素,只有在同一頁面需要描述多個日曆事件時才需要它。若頁面只有一個事件,就假設 vcalendar 已存在,直接把事件資訊包進 vevent 即可。
包覆的元素可以是任何標籤(<dl>、<ul>、<p>、<span> 皆可),這裡用 <div> 只是剛好合適。
除了根元素,hCalendar 的必要屬性只有 summary 與 dtstart 兩個。
summary 描述事件的概要,內容通常就是日曆應用裡顯示的名稱。例中「BarCamp Albuquerque 3」被包在 summary 裡,也就是我個人日曆上會看到的標題。
dtstart 描述事件的開始時間/日期,例中是「September 13」。
注意包著 dtstart 的是 <abbr>:顯示給人看的是「September 13」,而 title 屬性放的是機器可讀的「2008-09-13T09:00:00」。
這是目前微格式中標示日期時間的建議做法,稱為日期時間設計模式(abbr 設計模式的延伸)。它回應了微格式的核心原則之一:先為人類閱讀設計,機器其次,最終讓兩者都能讀懂。因此瀏覽器顯示 <abbr> 的內容,而程式則讀取 title。
同時,title 中的日期時間需遵循 ISO 8601:
YYYY-MM-DDThh:mm:ss — Y 年、M 月、D 日、h 時、m 分、s 秒YYYY-MM-DDThh:mm:ssZ — Z 代表 GMT(格林威治)時間YYYY-MM-DDThh:mm:ss+hh(或 -hh)— 表示相對於格林威治時間的偏移量舉例來說,2008-09-30T13:00:00 就是 2008 年 9 月 30 日下午 1 點(當地時間)。中間的字母 T 用來分隔日期與時間;只有日期時,把 T 與後面的時間省略即可;只有時間時 likewise 省略前面的日期。
dtend 描述事件結束的日期/時間,例中為「September 14」。
duration 描述事件的持續時間,例中是兩天,寫成 title="P2D"。它同樣使用日期時間設計模式,並遵循 ISO 8601,只是前面要加上「P」表示一段期間,可用單位包括年(Y)、月(M)、週(W)、日(D)、時(H)、分(M)、秒(S):
日期時間設計模式目前存在一個無障礙問題:螢幕閱讀器會朗讀 title 屬性。當 title 裡放的是 ISO 8601 格式的機器可讀字串時,它就會照字面唸出來——例如 <abbr title="2008-09-30"> 會被讀成「Two thousand eight dash zero nine dash thirty」。時間資訊更長時,體驗只會更糟。
這個問題目前尚未有完美解法。社群已收到若干候選方案,仍在討論更好的途徑。就我個人部落格而言,統計數據顯示沒有使用螢幕閱讀器的訪客,但我仍期待找到兼顧兩者的做法。
url 描述事件的連結(<a>)。例中我把它與 summary 寫在同一個標籤上,純屬巧合——因為該連結的文字正好就是日曆裡要顯示的標題。
category 描述事件的類型,例中為「BarCamp」。與前面幾個屬性不同,category 可以使用無限次數,常見值如 Meeting、Expo、Vacation、Anniversary、Conference。某種意義上它等同事件的「標籤」,因此可以與 rel-tag 微格式併用(rel-tag 只能用在 <a> 上):
<p>You may be wondering what is
<a href="https://barcamp.org/" class="category" rel="tag">BarCamp</a> anyway?</p>
location 描述事件發生的地點(見上方完整示例)。
description 描述比 summary 更詳細的事件說明。
還有一些常用屬性沒有出現在示例中:
dtstamp — hCalendar 資訊產生的日期與時間last-modified — 資訊最近更新的日期與時間status — 事件確認狀態,可用值包含 cancelled、confirmed、tentativeclass — 事件等級,可用值包含 private、public、confidentialrrule — 事件重復發生的規則,需搭配 freq 說明頻率,並可搭配 count 或 interval 等子屬性rdate — 事件非固定週期重復發生的日期更多屬性可參考 hCalendar 的 wiki 範例頁面。
你應該已經發現,上面的標記中嵌入了 hCard 的屬性:
<dd class="location vcard">
<a class="fn org url" href="…">CJW Cafe</a>
on <a href="…" class="adr">
<span class="street-address">4801 Alameda …</span>,
<span class="locality">Albuquerque</span>,
<abbr class="region" title="New Mexico">NM</abbr>
<span class="postal-code">87113</span>
</a>
</dd>
組合微格式非常簡單,卻能在特定範圍內大幅提升語意價值,同時讓使用者取得更多可被再利用的數據——例如把場地資訊直接存進通訊錄。在這個例子中,location 裡帶上 vcard 格外有意義;即使我只想標到城市層級,也同樣能借用 hCard 的屬性。
hCalendar 也可以直接嵌進通順的句子裡,而不必硬塞進 <dl>:
<div class="vevent">
<p>Yes, it's short notice, but mark your calendars:
<a href="https://barcamp.org/BarCampAlbuquerque" class="url summary">
<span class="category">BarCamp</span> Albuquerque 3
</a> is this weekend,
<abbr class="dtstart" title="2008-09-13T09:00:00">September 13</abbr>–
<abbr class="dtend" title="2008-09-14T18:00:00">14</abbr>,
from 9am–6pm
<abbr class="duration" title="P2D">both days</abbr>.</p>
<p class="description">This year's BarCamp is all about the web: design,
technology, social and new media, and other stuff that is just plain cool.</p>
<p class="location vcard">…</p>
</div>
在該篇文章中,我提供了一個讓讀者直接把行程加入日曆應用的連結:

這個連結可以指向任何 iCalendar 檔案的 URL(.ics、.ical、.ifb、.icalendar)。我這裡使用的是 Technorati 的活動服務:只要在含 hCalendar 的頁面網址前接上 https://feeds.technorati.com/events/,把拼接後的字串當作連結目標即可。
<a href="https://feeds.technorati.com/events/https://www.ablognotlimited.com/articles/barcampalbuquerque-around-the-corner"
title="Download .ics file">Add to your calendar</a>
使用者點擊後,.ics 檔案便會自動產生並提供下載:

再強調一次:標籤本身並不重要(但應該有效且具語意),真正決定 hCalendar 的是 class 的值。因此建議直接針對這些 class 值撰寫 CSS,而不是為了 styling 另外加上一堆 class。相關的樣式化技巧可以參考社群中關於日曆資訊美化的討論。總之,hCalendar 的呈現方式,只受限於你的 CSS 功力。
原因說過很多次,但還值得再說:微格式在極簡單的前提下,提供了非常強大的潛能。用的人越多,支援它的工具與應用就會越多。
微格式使用既有的標準(例如 XHTML 元素),為其中包含的內容補上更多語意資訊。這讓網站作者能做出對人與機器(例如搜尋引擎)都友善的網站。擁抱語意、採用標準化的開發方式,不只對使用者有益,對設計者與開發團隊同樣有益——它為語意網路打好基礎,同時讓我們能充分利用今日既有的網路與技術。
如果你覺得語意與標準的討論偏哲學,那不妨直接看工具。以下工具都能在你今天寫的 hCalendar 上派上用場。
瀏覽器擴充:



其他服務:
如果上面的理由還不夠說服你,那麼看看已經採用 hCalendar 的服務吧:
除此之外還有大量實際案例。試著在自己的專案裡用一次,你大概會喜歡上它。