Installation
Install package with NPM and add it to your development dependencies:
npm install --save-dev gulp-nui
Usage
var nui = ;var babel = ; gulp;
Options
参数 | 类型 | 说明 |
---|---|---|
base | String | 项目根目录,必须为硬盘绝对路径,默认值为gulpfile.js所在目录,设置后将会覆盖paths中的base |
paths | Object {别名:路径,别名:路径,..} | 设置路径别名,和Nui.config中的paths对应录 |
alias | Object {别名:路径,别名:路径,..} | 设置模块别名,和Nui.config中的alias对应 |
url | String | Nui配置文件路径,设置后会读取文件中paths和alias属性作为参数选项,使用该参数可以省略paths和alias设置 |
verlen | Number | 默认值为7,设置版本号长度,会对页面中所有的静态资源路径后面增加“?v=xxxx”,设置为0将不会更新版本号 |
vermap | Boolean | 默认值为true,是否在配置文件中生成版本映射,此设置将不会添加静态资源版本号 |
mintype | String | 默认为空,值为空压缩css和js,为css时仅合并压缩css模块,为js时仅合并压缩js模块,在watch监听任务时设置该参数可以有效解决合并压缩任务过慢的问题 |
cssmin | Boolean, Function | 默认true,是否合并依赖模块并压缩,会在入口模块所在文件夹的同级style文件夹中(没有则自动创建)生成“入口模块名-min.css”,当设置为对象时,为css压缩选项,当值为null时仅合并模块不压缩,也不会生成sourcemap文件 参考clean-css,默认advanced为false,compatibility为ie7。 |
cssdebug | Boolean | 默认true,是否生成sourcemap调试文件,方便压缩文件调试 |
syncAsset | Boolean, Array, String, Object | 默认false,是否在合并css时将资源文件(图片、字体等)同步到项目中,需在paths中配置目录别名,当值为字符串只能配置一个别名,当为数组时可配置多个别名,当值为对象时有2个属性{paths:配置别名(传递数组或者字符串), rename:是否对同步的文件进行重命名,若为false则不重新命名,若为数值型则可以设置文件名的长度,默认值为10} |
jsmin | Boolean, Object | 默认true,是否合并依赖模块并压缩,会在入口模块同目录生成“入口模块名-min.js”,当值为对象时,可配置压缩选项,当值为null时仅合并模块不压缩,也不会生成sourcemap文件查看参数配置 |
jsdebug | Boolean | 默认true,是否生成sourcemap调试文件,方便压缩文件调试 |
changed | Boolean | 默认true,是否只输出修改过的文件流 |
filterPath | Function(资源路径, 引入资源的文件路径) | 默认null,当资源路径为非http开头的绝对路径,例如“/a/b/c”或者包含特殊变量(例如jsp文件中后台开发会使用<%=basepath%>引入路径)时才启用,可以用于过滤特殊符号,返回资源在硬盘中的路径 |
watcher | Object | 默认null,当该参数值为gulp-nuiwatch模块的返回值时,将会修改css文件内资源文件的版本号,该模块options中的usePolling必须为true,否则如果做监听css文件任务的话可能会造成死循环! |
babel | Array, Object | 默认null,当babel值为数组时,第0个值为babel-core模块返回值,第1个值为参数选项,参数是presets和plugins;当babel值为对象时,为babel-core模块返回值,默认参数presets值为es2015、stage-2。 |
Versions
v2.3.3
1.修复es6导出值为空对象时报错问题
v2.3.2
1.修复设置vermap后,修改样式文件,页面入口模块添加版本号的问题
v2.3.0
1.拓展es6导出功能
;;
v2.2.9
1.修复一些bug
v2.2.8
1.修复模块打包不全的bug
v2.2.7
1.修复require模块名中包含“./extend”,模块不打包问题
v2.2.6
1.修复css模块依赖加载顺序错误bug,依赖的文件应该被先加载
//a.js; //a { color:#000}; //b.js; //a { color:#fff} //打包文件结果//修复前:a color:#000a color:#fff //修复后:a color:#fffa color:#000
v2.2.5
1.优化代码
v2.2.4
1.图片打包优化
v2.2.3
1.初始化删除打包目录改为第一次任务执行时
v2.2.2
1.初始化gulp-nui时默认会删除打包目录
v2.2.1
1.修复css不能打包的bug
v2.1.4
1.imports加入对资源文件导入的支持,返回文件绝对路径
; console //http://domain/pages/images/test.jpg
2.如果导入的资源文件属于syncAsset配置项的目录中,会自动将该资源文件同步到项目中
; console //http://domain/pages/images/packs/test-f81365499b.jpg
v2.1.3
1.imports引入样式文件时,如果没有加扩展名,默认加载css文件变更为less文件
v2.1.2
1.修复css打包后内部引入的资源文件没有版本号的问题
v2.1.1
1.增加css文件中的资源打包功能