gulp API
1、gulp.src(globs[, options])
1.1、说明:src方法是指定需要处理的源文件的路径,gulp借鉴了Unix操作系统的管道(pipe)思想,前一级的输出,直接变成后一级的输入,gulp.src返回当前文件流至可用插件;
1.2、globs: 需要处理的源文件匹配符路径。类型(必填):String or StringArray;
通配符路径匹配示例:
“src/a.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文件);
1 var gulp = require('gulp'), 2 less = require('gulp-less'); 3 4 gulp.task('testLess', function () { 5 //gulp.src('less/test/style.less') 6 gulp.src(['less/**/*.less','!less/{extend,page}/*.less']) 7 .pipe(less()) 8 .pipe(gulp.dest('./css')); 9 });
1.3、options: 类型(可选):Object,有3个属性buffer、read、base;
options.buffer: 类型:Boolean 默认:true 设置为false,将返回file.content的流并且不缓冲文件,处理大文件时非常有用;
options.read: 类型:Boolean 默认:true 设置false,将不执行读取文件操作,返回null;
options.base: 类型:String 设置输出路径以某个路径的某个组成部分为基础向后拼接,具体看下面示例:
2、gulp.dest(path[, options])
2.1、说明:dest方法是指定处理完后文件输出的路径;
1 gulp.src('./client/templates/*.jade') 2 .pipe(jade()) 3 .pipe(gulp.dest('./build/templates')) 4 .pipe(minify()) 5 .pipe(gulp.dest('./build/minified_templates'));
2.2、path: 类型(必填):String or Function 指定文件输出路径,或者定义函数返回文件输出路径亦可;
2.3、options: 类型(可选):Object,有2个属性cwd、mode;
options.cwd: 类型:String 默认:process.cwd():前脚本的工作目录的路径 当文件输出路径为相对路径将会用到;
options.mode: 类型:String 默认:0777 指定被创建文件夹的权限;
3、gulp.task(name[, deps], fn)
3.1、说明:task定义一个gulp任务;
3.2、name: 类型(必填):String 指定任务的名称(不应该有空格);
3.3、deps: 类型(可选):StringArray,该任务依赖的任务(注意:被依赖的任务需要返回当前任务的事件流,请参看下面示例);
1 gulp.task('testLess', function () { 2 return gulp.src(['less/style.less']) 3 .pipe(less()) 4 .pipe(gulp.dest('./css')); 5 }); 6 7 gulp.task('minicss', ['testLess'], function () { //执行完testLess任务后再执行minicss任务 8 gulp.src(['css/*.css']) 9 .pipe(minifyCss()) 10 .pipe(gulp.dest('./dist/css')); 11 });
3.4、fn: 类型(必填):Function 该任务调用的插件操作;
4、gulp.watch(glob [, opts], tasks) or gulp.watch(glob [, opts, cb])
4.1、说明:watch方法是用于监听文件变化,文件一修改就会执行指定的任务;
4.2、glob: 需要处理的源文件匹配符路径。类型(必填):String or StringArray;
4.3、opts: 类型(可选):Object 具体参看https://github.com/shama/gaze;
4.4、tasks: 类型(必填):StringArray 需要执行的任务的名称数组;
4.5、cb(event): 类型(可选):Function 每个文件变化执行的回调函数;
1 gulp.task('watch1', function () { 2 gulp.watch('less/**/*.less', ['testLess']); 3 }); 4 5 gulp.task('watch2', function () { 6 gulp.watch('js/**/*.js', function (event) { 7 console.log('File ' + event.path + ' was ' + event.type + ', running tasks...'); 8 }); 9 });