Firefox 3 Using Microformat

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()