gearbox
gearbox copied to clipboard
API 文档 - `dom` 模块
API 文档 - dom 模块
JavaScript 变量
为减少业务层对常用 DOM 元素的重复获取和包装,dom 模块预先缓存了这些元素的 Zepto 包装对象。在业务层可以直接使用。
.$win
window 对象的 Zepto 包装对象。
示例
监听 resize 事件:
gearbox.dom.$win.on('resize', function (ev) {
//...
})
.$root
document.documentElement 对象(即 <html> 元素)的 Zepto 包装对象。
.$body
document.body 对象(即 <body> 元素)的 Zepto 包装对象。
注意事项
为确保对 document.body 对象的正确获取,加载 Gearbox 的脚本标签须放置在页面的 <body> 标签内。当然,根据前端性能的最佳实践,所有外链脚本也确实应该放置在页面的最底部:
<html>
<head>...</head>
<body>
...
<script src="gearbox.js"></script>
</body>
</html>
JavaScript 接口
.is$Element(obj)
判断是否为 Zepto 包装对象(或 Zepto 集合)。
如果外部环境没有加载 Zepto 但有 jQuery,则理论上此方法也可以判断 jQuery 包装对象(或 jQuery 集合)。
参数
obj-- 任意类型。需要判断的对象。
返回值
布尔值。判断结果。
示例
gearbox.dom.is$Element(gearbox.dom.$win) // => true
与 Underscore.ext 的差异:
gearbox.dom.$rootvs_.dom.$doc