Microfotmats 讓網站可以提供語意化的資料給瀏覽器,這是為了讓瀏覽器不需知道如何剖析(parse)文件就可以呈現網頁資訊的摘要。Firefox 3 實做了一個全域的 microformats 物件(global microformats object) 以提供 microformats 的存取。這個物件與其 API 簡化了尋找、讀取 microfotmats 的工作。
載入 microformats API
Microformats 物件是用 Firefox 3 新加入的 JavaScript script loader 建立的。要使用這個 API,你首先需要載入這個物件:
Components.utils.import("resource://gre/modules/Microformats.js");
一旦載入了這個 microformats API,你就可以使用列在這裡的方式來管理 microformats,詳見 Parsing microformats in JavaScript。
預先定義好的 microformats
Firefox 3 實做了好幾種常見的 microformats,以下是其定義:
- adr
- 代表住址 (例如一條街或郵寄住址)。
- geo
- 代表使用緯度、經度表示的地理位置。
- hCard
- 代表個人的聯絡方式。
- hCalendar
- 代表行事曆上的一個約會。
- tag
-
用於新增標籤給其他 microformats。
方式
add()
新增一個 microformat 到一個 microformat module。
如果指定的名稱和現存的 microformat 相同,這個原來存在的 microformat 會被新增的所取代。
add(name, definition);
Parameters
- name
- 新增到 microformat module 的 microformat 名稱。
- definition
- 描述 microformat 的 JavaScript 結構,詳見 Describing microformats in JavaScript
count()
計算文件中符合我們指定的類型的 microformats 的數量
numMicroformats = Microformats.count(name, rootElement, recurseFrames)
Parameters
- name
- 要計算的 microformat 名稱。
- rootElement
- 可加可不加。代表由此開始搜尋的 DOM 元素,預設是 content.document (換句話說,也就是整份文件)。
- recurseFrames
- 可加可不加。如果是 true,搜尋時會連 child frames 一起搜尋,預設是 true
回傳值 (Return value)
是一個整數值,代表符合指定類型的 microformats 數量。
debug()
get()
getNamesFromNode()
getParent()
isMicroformat()