jQuery 1.4 正式版即將發布,程式碼也已從 Google Code 搬到 GitHub。jQuery 是我接觸的第一個 JS 類庫,俗話說初戀總讓人難忘——一年前這種難忘還只是一種純感覺,說不出所以然。前幾天重讀了一遍 GitHub 上的原始碼,從純功能角度看,jQuery 其實沒有特別過人之處。那到底是什麼讓我念念不忘?
昨天架 TaskSpeed、檢查 jQuery 的測試程式碼時,我突然明白了一個或許大家都知道的答案:是 API 設計。
以 style 相關的操作為例,YUI3 與 MooTools 採用的是傳統分法:
el.setStyle(prop, val);
el.getStyle(prop);
el.setStyles({ propA: valA, propB: valB });
el.getStyles(propA, propB); // MooTools 支援
在 jQuery 裡,一個 css() 全部搞定:
el.css(prop); // 等同 getStyle
el.css(prop, val); // 等同 setStyle
el.css({ propA: valA, propB: valB }); // 等同 setStyles
el.css(prop, func); // func 是一個回傳 val 的函式
乍看之下 jQuery 顯得不那麼「標準」,同一個方法名承載了四種行為。但從可記憶性與靈活性來看,這個設計更貼近人性:你只需要記住一個名字。
更關鍵的是它符合學習上的漸進式思維。先學最簡單的 el.css(prop);接著發現可以帶第二個參數;再來發現參數可以是 map;然後發現值還能是一個函式。而函式這一步甚至會給人驚喜——原來還能這樣用!jQuery 把漸進與愉悅帶進了學習過程,這點很漂亮。
反觀 YUI3,API 少了這層樂趣。查 jQuery 的文件像尋寶,查 YUI 的文件則像在完成一項工作,有點枯燥。
和 YUI2 相比,YUI3 的 API 做了些調整。YUI2 裡 YAHOO.util.Dom 的方法名嚴格以動詞開頭,雖然有些名字長了點,但規律性強、好記。到了 YUI3,卻出現了 byId、elementByAxis 這類命名;還有一些以名詞命名的方法如 ancestor、docHeight,乍看很難意識到那是方法。純粹為了省幾個字元?這種不一致確實令人困惑。
公平地說,YUI3 整體仍相當出色,例如 Node 的方法命名就非常嚴謹;ancestor 也是為了對應 next、prev 的命名邏輯。也就是說,Y.Dom 其實已轉為內部 API,官方並不鼓勵使用者直接呼叫。
即便如此,我仍覺得 jQuery 的 API 設計高出一個層次。套一句流行的說法:jQuery API 的使用者體驗更好。
這也解釋了為什麼 jQuery 的學習曲線看起來平緩——不是因為功能少,而是因為它把複雜度藏在了「同一個方法的不同呼叫形式」背後,讓使用者按自己的程度逐步深入,隨時都能停在當下夠用的地方。