构建工具gulp之主要API
1. gulp.src(globs[, options])
src
方法用于产生数据流。它的参数表示所要处理的文件,这些指定的文件会转换成数据流。
src
方法的参数可以是一个字符串:
gulp.src(‘images/*.{png,jpg,gif,ico}‘)
.pipe(imagemin())
.pipe(gulp.dest(‘dist/images‘));
src
方法的参数还可以是一个数组,用来指定多个成员:
gulp.src([‘js/**/*.js‘, ‘!js/**/*.min.js‘])
● globs参数通配符路径匹配规则如下:
js/app.js
:指定具体的文件名;
*
:匹配所有文件,例:src/*.js(包含src下的所有js文件);
**
:匹配0个或多个子文件夹,例:src/**/*.js(包含src下0个或多个子文件夹下的js文件);
{}
:匹配多个属性,例:src/{a,b}.js(包含a.js和b.js文件),src/*.{jpg,png,gif}(src下的所有jpg/png/gif文件);
!
:排除文件,例:!src/a.js(不包含src下的a.js文件);
?
:匹配文件路径中的一个字符,例:js/a?.js 能匹配 js/ab.js,不能匹配 js/a.js;
[...]
:匹配方括号中出现的字符中的任意一个,当方括号中第一个字符为^或!时,则表示不匹配方括号中出现的其他字符中的任意一个,类似js正则表达式中的用法。例:js/a[0-3].js
,匹配js目录下以a开头,第二个字符为0-3之间(包括0和3)的js文件。若改为 ["js/[^ab].js"],则匹配 js/c.js,不匹配 js/cd.js、js/ac.js;
?(pattern|pattern|pattern)
:匹配多个 pattern 中 0 或 1 个(精确匹配,不可以组合)。例:js/?(a|b).js,匹配 js 目录下的 a.js、b.js,不匹配 ab.js
+(pattern|pattern|pattern)
:至少匹配多个 pattern 中的一个。例:js/+(a|b)b.js,匹配 js 目录下的 ab.js、bb.js、ababab.js,不能匹配 abcd.js(也就是说:只允许匹配出现在范围内的字符) ,也不能像 js/*(a|b)b.js 那样匹配 b.js。
*(a|b|c)
:匹配括号中多个 pattern 中0或任意多个(pattern可相互组合)。例:js/*(a|b|c).js,匹配 js 目录下的 a.js、ab.js、abc.js、ba.js,不匹配 abcd.js(也就是说:只允许匹配出现在范围内的字符)。
@(pattern|pattern|pattern)
:匹配多个 pattern 中的任意一个(即不可以组合,且不能为空或大于1个)。例:js/@(a|b)b.js,匹配 js 目录下的 ab.js、bb.js,不匹配 b.js、abb.js、abc.js。
● options类型(可选),有3个属性buffer、read、base;
options.buffer
:(默认:true)设置为false,将返回file.content的流并且不缓冲文件,处理大文件时非常有用;
options.read
:(默认:true)设置false,将不执行读取文件操作,返回null;
options.base
:设置输出路径以某个路径的某个组成部分为基础向后拼接;
2. gulp.dest(path[, options])
dest方法是指定处理完后文件输出的路径;
gulp.src(‘images/*.{png,jpg,gif,ico}‘)
.pipe(imagemin())
.pipe(gulp.dest(‘dist/images‘));
●path
文件将被写入的路径(输出目录)。也可以传入一个函数,在函数中返回相应路径;
●options
配置对象,有2个属性cwd、mode;
options.cwd
:类型:String,默认:process.cwd():前脚本的工作目录的路径 当文件输出路径为相对路径将会用到;
options.mode
:类型:String,默认:0777 指定被创建文件夹的权限;
3. gulp.task(name[, deps], fn)
task
定义一个gulp
任务;
gulp.task(‘taskname‘, function() {
// do something
});
●name
任务的名字,如果你需要在命令行中运行你的某些任务,那么,请不要在名字中使用空格。
●deps
一个包含任务列表的数组,这些任务会在你当前任务运行之前完成。
gulp.task(‘mytask‘, [‘array‘, ‘of‘, ‘task‘, ‘names‘], function() {
// do something
})
fn 该函数定义任务所需要执行的一些操作。通常来说,它会是这样中形式
gulp.src().pipe(taskFn())
4. gulp.watch(glob [, opts], tasks)/gulp.watch(glob [, opts, cb])
watch监视文件,并且可以在文件发生改动时候做一些事情。
●glob
需要处理的源文件匹配符路径
●opts
类型(可选):Object 具体参看gaze https://github.com/shama/gaze
●tasks
类型(Array):需要在文件变动后执行的一个或者多个通过 gulp.task() 创建的 task 的名字
●cb(event)
类型(可选):Function 每个文件变化执行的回调函数,callback 会被传入一个名为 event 的对象,这个对象描述了所监控到的变动
gulp.watch(‘js/**/*.js‘, function(event) {
console.log(‘File ‘ + event.path + ‘ was ‘ + event.type + ‘, running tasks...‘);
});
event.type
发生的变动的类型:added, changed 或者 deleted。
event.path
触发了该事件的文件的路径。
本文中主要把gulp的api介绍完了,基本上gulp也算是掌握了。 下一篇文章我们将逐步去了解各种任务的插件使用。