background image

jQuery 最出色的是 API 设计

jQuery 将马上发布 1.4 正式版,代码也从 googlecode 上迁移到了 github. jQuery 是我接

触的第一个

 JS 类库,俗话说初恋总是让人难以忘记。一年以前,这种难以忘记仅仅是一种

纯感觉,说不出来具体原因。前几天重新看了一遍

 github 上的源码。从纯功能上说,jQuery 

并没有特别出色的地方。究竟是什么让我如此恋恋不舍呢?

昨天搭建

 taskspeed, 检查 jQuery 的测试代码时,突然明晓了一个也许大家都已知道的

秘密:

jQuery 最出色最让人恋恋不舍的是它的 API 设计。

比如

 dom-style 的 api, 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 值的函数

对比以上两种

 API 设计,乍一看 jQuery 显得不那么“标准”。但从可记忆性和灵活性上

讲,我觉得

 jQuery 的设计都更人性化。jQuery 的 API 还符合学习上的渐进式思维:先学会

最简单的情况

el.css(prop), 再了解到还可以有两个参数,接着发现参数可以是 map, 更进一

步发现

 val 还可以是一个函数。func 参数甚至能带给学习者一种惊喜:居然还可以这样用!

jQuery 把一种渐进和愉悦带进了学习和使用的过程中,实在漂亮!

YUI3 的 API 缺少这种乐趣。查询 jQuery 的 API, 会有一种探寻秘密的寻宝感觉。YUI 的