构建工具gulp之主要API

构建工具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也算是掌握了。 下一篇文章我们将逐步去了解各种任务的插件使用。

posted @ 2020-04-13 23:48  灰锅  阅读(322)  评论(0编辑  收藏  举报