#modJS
简介
modJS是一套的前端模块加载解决方案。与传统的模块加载相比,modJS会根据产品实际使用场景,自动选择一种相应的方案,使最终的实现非常轻量简洁。
使用
模块的定义
- modJS是一个精简版的AMD/CMD规范,并不完全遵守AMD/CMD规范,目的在于希望给使用者提供一个类似nodeJS一样的开发体验,同时具备很好的线上性能。
使用define来定义一个模块:
define (id, factory)
在平常开发中,我们只需写factory中的代码即可,无需手动定义模块。发布工具会自动将模块代码嵌入factory的闭包里。
factory提供了3个参数:require, exports, module,用于模块的引用和导出。
- modJS的发布工具会保证你的程序在使用之前,所有依赖的模块都已加载。因此当我们需要一个模块时,只需提供一个模块名即可获取:
require (id)
和NodeJS里获取模块的方式一样,非常简单。
因为所需的模块都已预先加载,因此require可以立即返回该模块。
- 考虑到有些模块无需在启动时载入,因此modJS提供了可以在运行时异步加载模块的接口:
require.async (names, onload, onerror)
names可以是一个模块名,或者是数组形式的模块名列表。
当所有都加载都完成时,onload被调用,names对应的所有模块实例将作为参数传入。
如果加载错误或者网络超时,onerror将被触发。
超时时间可以通过require.timeout设置,默认为5000(ms)。
使用require.async获取的模块不会被发布工具安排在预加载中,因此在完成回调之前require将会抛出模块未定义错误。
require.loadJs (url)
异步加载脚本文件,不做任何回调
require.loadCss ({url: cssfile})
异步加载CSS文件,并添加到页面
require.loadCss ({content: csstext})
创建一个样式列表并将css内容写入
##说明
modJS只实现了AMD的一个子集,如果需要使用完整兼容AMD规范的版本,请使用amd目录下的esl-mod.js,这个版本是基于esl版本基础之上实现了fis的需求。
相关项目
自动化框架:fis
自动添加define插件:fis-postprocessor-jswrapper