微格式系列走到這裡,剛好來到一半。前面我們陸續談過三件事:用 rel 定義基於連結的關係、用 XFN 為連結補上人際關係的描述、再用 hCard 描述人、組織與地點。這次換 hCalendar 登場,它負責的是事件,以及一切依附於時間或地點的活動。
源頭:iCalendar
iCalendar(iCal)是交換行事曆資料的通用標準,最常見的場景是電子郵件裡的會議邀請,但應用遠不止於此。hCalendar 的角色和 hCard 之於 vCard 一樣,是把 iCalendar 的資料模型搬進 HTML。兩者之間是一對一的映射關係,解析器因此能從普通網頁裡把事件資料抽出來,交給行事曆軟體使用。
往上追溯,iCalendar 建立在 vCalendar 之上。vCalendar 是一套開源的行事曆實作,用來線上發布與維護事件、時刻表,當初是與 vCard 電子名片格式一起發展起來的。
hCalendar 能描述什麼
凡是行事曆裡會出現的條目,都可以交給它:概要、日期與時間、地點、詳細說明、重複規則等等。以下逐一拆解。
四條基本規則
- 屬性與子屬性一律透過 class 表達。
- 因為與 iCalendar 一對一對應,屬性名稱直接沿用 iCalendar 的命名(例如 vevent)。
- 屬性名稱區分大小寫。
- 「根」屬性不可與其他屬性寫在同一個 class 值裡,
<p class="vevent summary"> 這種寫法無效。
還有一條不算規則、但值得牢記:用什麼標籤並不重要,真正決定 hCalendar 的是 class 的值。話雖如此,我仍然偏好挑選語意貼切的元素。
在 head 中宣告 Profile
和所有微格式一樣,建議在 <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/">
另外,若要引用尚未定案的「非提案微格式」,可以改用涵蓋全部的組合 URL:
<head profile="https://purl.org/uF/2008/03/">
一個完整範例
我拿自己寫過的 BarCamp Albuquerque 3 公告當素材:
- <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
你會發現範例的根是 vevent 而非 vcalendar。這是因為 hCalendar 的 vcalendar 屬於選用的根,只有在同一頁要描述多個事件時才需要它。單一事件的頁面,解析器會假設 vcalendar 已存在,直接把 vevent 當成根即可。包在外面的元素可以是任何標籤,<div>、<dl>、<p> 都行。
必填:summary 與 dtstart
summary 是事件的概要,通常就是行事曆裡顯示的那行標題,範例中是「BarCamp Albuquerque 3」。
dtstart 是事件開始的時間,範例中是「September 13」。
日期時間設計模式
注意 dtstart 的容器是 <abbr>:人眼看到「September 13」,機器讀到的則是 title 裡的 2008-09-13T09:00:00。
這是微格式目前推薦的日期寫法,稱為「日期時間設計模式」(abbr 設計模式的延伸)。它體現了微格式的核心原則:先為人類設計,再讓機器讀懂,最終兩者都能讀。瀏覽器呈現 <abbr> 的內容,應用程式則取用 title。
title 的值需遵循 ISO 8601:
- YYYY-MM-DDThh:mm:ss—年、月、日、時、分、秒
- YYYY-MM-DDThh:mm:ssZ—
Z 代表 GMT 時間
- YYYY-MM-DDThh:mm:ss+hh(或 -hh)—與 GMT 的偏移量
舉例來說,2008-09-30T13:00:00 就是 2008 年 9 月 30 日下午一點。字母 T 用來分隔日期與時間;只有日期時把 T 之後拿掉,只有時間時把 T 之前拿掉即可。
其餘時間屬性
dtend 表示結束時間,範例是「September 14」。
duration 表示持續長度,範例是兩天。它同樣走日期時間設計模式,只是 title 前面要加一個 P,後面接單位:年(Y)、月(M)、週(W)、日(D)、時(H)、分(M)、秒(S)。
- P2Y=兩年
- P10D=十天
- P3H=三小時
- P2W=兩週
- P12DT8H30M=十二天八小時三十分鐘
關於無障礙
這個模式有個尚未解決的問題:螢幕閱讀器會把 title 的內容照字念出來。想像它讀 <abbr title="2008-09-30"> 時變成「Two thousand eight dash zero nine dash thirty」,時間愈長愈難以忍受。目前社群仍在討論更好的解法,我也很期待能有兼顧機器可讀與無障礙的方案出現。
其他常用屬性
url:事件的連結。範例中它剛好和 summary 寫在同一個 <a> 上,因為連結文字正好就是事件名稱,純屬巧合。
category:事件類型,範例是「BarCamp」。它與其他屬性不同,可以重複使用任意次數,常見值如 Meeting、Expo、Vacation、Anniversary、Conference,某種程度就像事件的標籤。若這個分類同時是個連結,還可以搭配 rel-tag:
<a href="https://barcamp.org/" class="category" rel="tag">BarCamp</a>
(rel-tag 只能用在 <a> 上。)
location:事件地點。範例中直接嵌入了完整的 hCard,包含場地名稱與 adr 地址結構。
description:比 summary 更完整的說明。
範例裡沒用到的屬性
- dtstamp:這份 hCalendar 資料產生的時間
- last-modified:最後更新時間
- status:事件狀態,可用 cancelled、confirmed、tentative
- class:事件機密等級,可用 private、public、confidential
- rrule:重複規則,需搭配 freq 等子屬性說明頻率
- rdate:非固定週期的不定期重複
還有更多,可參考 hCalendar 的 wiki 範例頁。
hCalendar 遇上 hCard
回頭看範例的 location 部分:class="location vcard" 裡塞的是 fn org url、adr、street-address、locality、region、postal-code——全是 hCard 的語彙。組合微格式就這麼簡單,卻能在特定範圍內疊加大量語意,同時讓使用者能把地點直接存進通訊簿。即使我只想標一個城市名稱,用 hCard 屬性也完全合理。
融入自然語句
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, <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"><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>) is hosting this event.</p>
- </div>
讓使用者一鍵加入行事曆
我在那篇文章裡附了個下載入口:

連結可以指向任何 iCalendar 檔案(.ics、.ical、.ifb、.icalendar)。我當時用的是 Technorati 的事件服務,只要在頁面網址前面拼上 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 檔便會即時產生供下載:

外觀交給 CSS
再說一次:標籤不重要,class 才重要。幫 hCalendar 上妝時,我建議直接針對這些既有的 class 寫 CSS,而不是為了 styling 另外堆一堆 class。Jeremy Keith 有篇寫得很棒的文章,示範如何美化行事曆資訊,值得參考。剩下的,就看你 CSS 功力了。
值得嗎?值得
微格式的可愛之處在於:門檻極低,潛力極大。用的人愈多,支援它的工具與服務就會愈多。
其一是語意
微格式不發明新東西,它拿 XHTML 這些既有標準,替包住的內容補上更精確的語意。這讓網站對人與機器(例如搜尋引擎)都更友善,也順道推動標準化的開發方式——受益的不只是使用者,還有設計者與團隊。這些基礎設施,正是語意網的地基。
其二是工具
如果你覺得語意有點哲學,那就看看今天已經能做出什麼:
- Firefox 的 Operator 外掛可擷取 hCalendar,直接塞進你慣用的行事曆

- Tails Export 同樣是 Firefox 外掛,能偵測並匯出 hCalendar 資料

- Safari 的微格式外掛,功能與前者類似
- 與瀏覽器無關的微格式 bookmarklet,也能抽出 hCalendar

- Brian Suda 的 X2V:一份能從網頁萃取 hCalendar 的 XSLT 樣式表
- Technorati 的微格式搜尋引擎,會索引提交的 URL 中的 hCalendar、hCard、hReview
- Elias Torres 的 Greasemonkey 腳本,把 hCalendar 送進 Google Calendar 提醒
- Les Orchard 的 Magic Microformat Forms,把 Firefox 的 textarea 變成 hCalendar 產生器
其三是同儕壓力
已經採用 hCalendar 的服務不少:Yahoo! Upcoming 讓使用者瀏覽活動時直接匯入行事曆;MapQuest Local 同時支援 hCalendar、hCard 與地理微格式;TripIt 用它標記行程;Last.fm 用它描述演唱會資訊;Facebook 則用它標示活動。名單還很長。
偷懶工具
- 微格式社群提供的 hCalendar 產生器,填表單就有 markup
- pnh_mf 與 JMC_Event_Manager 外掛
- WordPress 生態的 Structured Blogging(也有 Movable Type 版)與 WP-Microformats
- WaSP 出品、支援 Dreamweaver 8 的微格式擴充
- Conference Schedule Creator,用 hCalendar 產出整份議程表
試一次,你大概會喜歡上它。