gulp教程之gulp中文API

Ooo_My_God发表于 分类:构建工具 阅读(17501) 评论(31)

简介:

本文主要翻译gulp官方API,加上自己一点点理解。

gulp API docs

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.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方法是指定处理完后文件输出的路径;

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,该任务依赖的任务(注意:被依赖的任务需要返回当前任务的事件流,请参看下面示例);

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 每个文件变化执行的回调函数;

5、结束语

5.1、本文有任何错误,或有任何疑问,欢迎留言说明。

如果觉得我的文章对您有用,请随意打赏。您的支持将是我继续创作的动力! ¥ 打赏支持 ¥

本站文章除注明转载外,均为原创文章,会经常更新知识点以及修正一些错误,因此转载请保留原出处,方便溯源,避免陈旧错误知识的误导,同时有更好的阅读体验。

http://www.ydcss.com/archives/424

相关推荐

评论

网友最新评论 (31)

  1. 受教

    CCC 08-16 14:46 回复
  2. 不够详细

    宇哥 09-05 15:10 回复
  3. .pipe()有什么作用?

    • Unix操作系统的管道(pipe)思想,前一级的输出,直接变成后一级的输入。通常命令和命令之间的衔接就是用pipe。类似jQuery的链式编程。

      YDCSS 11-23 09:13
    • Unix操作系统的管道(pipe)思想,前一级的输出,直接变成后一级的输入。通常命令和命令之间的衔接就是用pipe。类似jQuery的链式编程。

      YDCSS 11-23 09:13
  4. 为什么我用cnpm install gulp-less –save-dev命令提示符安装glup-less,会在node_modules文件夹下生成一大堆文件夹,这些文件夹的文件有用吗?看你项目的node_modules文件夹下只有安装的那几个插件,很清晰明了。

    快乐小神仙 12-07 16:00 回复
    • 你好,其实是一样的,旧版npm的每个包所依赖的包在其文件夹内,新版的npm换了一种方式,统一放一级目录啦。

      YDCSS 12-08 09:44
    • 那现在用新版npm的安装,还能像你这样分类,每个插件都存放在自己独立一个目录里,而不是所有插件的文件都分摊在node_modules文件夹里,不然不太好管理。

      快乐小神仙 12-08 14:23
    • 你好,其实是一样的,旧版npm的每个包所依赖的包在其文件夹内,新版的npm换了一种方式,统一放一级目录啦。

      YDCSS 12-08 09:44
    • 你好,其实是一样的,旧版npm的每个包所依赖的包在其文件夹内,新版的npm换了一种方式,统一放一级目录啦。

      YDCSS 12-08 09:44
  5. 1.您能再详细说下 gulp.src option参数中的Base用法吗 ? 2、如果gulp.dest 输出换个名字,应该是怎样的语法

    HelloWorld_Wys 01-05 13:59 回复
    • 1. 你可以尝试同时操作不同文件夹的文件,例如:src/test1/lalala/1.js src/test2/yoyoyo/2.js; => gulp.src(‘src/**/*.js’) ,不设置base,看文件生成后的路径是怎么样的;然后设置base: ‘src’,在看看结果。2. 换个名字,可以尝试使用gulp-rename插件。https://www.npmjs.com/package/gulp-rename

      YDCSS 01-05 22:28
    • 某个路径的某个组成部分,有点难以理解了点。具体点跟更好了。不过作者写教程真是厉害,思路清晰,大赞~

      墨尔本,阳光 04-16 09:31
    • 1. 你可以尝试同时操作不同文件夹的文件,例如:src/test1/lalala/1.js src/test2/yoyoyo/2.js; => gulp.src(‘src/**/*.js’) ,不设置base,看文件生成后的路径是怎么样的;然后设置base: ‘src’,在看看结果。2. 换个名字,可以尝试使用gulp-rename插件。https://www.npmjs.com/package/gulp-rename

      YDCSS 01-05 22:28
    • 1. 你可以尝试同时操作不同文件夹的文件,例如:src/test1/lalala/1.js src/test2/yoyoyo/2.js; => gulp.src(‘src/**/*.js’) ,不设置base,看文件生成后的路径是怎么样的;然后设置base: ‘src’,在看看结果。2. 换个名字,可以尝试使用gulp-rename插件。https://www.npmjs.com/package/gulp-rename

      YDCSS 01-05 22:28
  6. 真的是爱上楼主了,么么哒

    Seven 08-18 11:21 回复
输入关键字