精通gulp常用插件

本文主要展示的是gulp常用插件的使用方法和用途，通過對插件的熟練運用達到精通gulp。不定期更新。可以到github上面下載DEMO。

• 博客地址：blog
• demo地址：gulp-plugins

原文作者：林鑫，作者博客：https://github.com/lin-xin/blog

匹配符 *、**、！、{}

gulp.src('./js/*.js')               // * 匹配js文件夾下所有.js格式的文件
gulp.src('./js/**/*.js')            // ** 匹配js文件夾的0個或多個子文件夾
gulp.src(['./js/*.js','!./js/index.js'])    // ! 匹配除了index.js之外的所有js文件
gulp.src('./js/**/{omui,common}.js')        // {} 匹配{}里的文件名

文件操作

del (替代gulp-clean)

var del = require('del');

del('./dist');                      // 刪除整個dist文件夾

gulp-rename

描述：重命名文件。

var rename = require("gulp-rename");

gulp.src('./hello.txt')
  .pipe(rename('gb/goodbye.md'))    // 直接修改文件名和路徑
  .pipe(gulp.dest('./dist')); 
 
gulp.src('./hello.txt')
  .pipe(rename({
    dirname: "text",                // 路徑名
    basename: "goodbye",            // 主文件名
    prefix: "pre-",                 // 前綴
    suffix: "-min",                 // 后綴
    extname: ".html"                // 擴展名
  }))
  .pipe(gulp.dest('./dist'));

gulp-concat

描述：合並文件。

var concat = require('gulp-concat');

gulp.src('./js/*.js')
    .pipe(concat('all.js'))         // 合並all.js文件
    .pipe(gulp.dest('./dist'));
    
gulp.src(['./js/demo1.js','./js/demo2.js','./js/demo2.js'])
    .pipe(concat('all.js'))         // 按照[]里的順序合並文件
    .pipe(gulp.dest('./dist'));

gulp-filter

描述：在虛擬文件流中過濾文件。

var filter = require('gulp-filter');

const f = filter(['**', '!*/index.js']);
gulp.src('js/**/*.js')
    .pipe(f)                        // 過濾掉index.js這個文件
    .pipe(gulp.dest('dist'));

const f1 = filter(['**', '!*/index.js'], {restore: true});
gulp.src('js/**/*.js')
    .pipe(f1)                       // 過濾掉index.js這個文件
    .pipe(uglify())                 // 對其他文件進行壓縮
    .pipe(f1.restore)               // 返回到未過濾執行的所有文件
    .pipe(gulp.dest('dist'));       // 再對所有文件操作，包括index.js

壓縮

gulp-uglify

描述：壓縮js文件大小。

var uglify = require("gulp-uglify");

gulp.src('./hello.js')
    .pipe(uglify())                 // 直接壓縮hello.js
    .pipe(gulp.dest('./dist'))
    
 gulp.src('./hello.js')
    .pipe(uglify({
        mangle: true,               // 是否修改變量名，默認為 true
        compress: true,             // 是否完全壓縮，默認為 true
        preserveComments: 'all'     // 保留所有注釋
    }))
    .pipe(gulp.dest('./dist'))

gulp-csso

描述：壓縮優化css。

var csso = require('gulp-csso');

gulp.src('./css/*.css')
    .pipe(csso())
    .pipe(gulp.dest('./dist/css'))

gulp-html-minify

描述：壓縮HTML。

var htmlminify = require('gulp-html-minify');

gulp.src('index.html')
    .pipe(htmlminify())
    .pipe(gulp.dest('./dist'))

gulp-imagemin

描述：壓縮圖片。

var imagemin = require('gulp-imagemin');

gulp.src('./img/*.{jpg,png,gif,ico}')
    .pipe(imagemin())
    .pipe(gulp.dest('./dist/img'))

gulp-zip

描述：ZIP壓縮文件。

var zip = require('gulp-zip');

gulp.src('./src/*')
    .pipe(zip('all.zip'))                   // 壓縮成all.zip文件
    .pipe(gulp.dest('./dist'))

JS/CSS自動注入

gulp-autoprefixer

描述：自動為css添加瀏覽器前綴。

var autoprefixer = require('gulp-autoprefixer');

gulp.src('./css/*.css')
    .pipe(autoprefixer())           // 直接添加前綴
    .pipe(gulp.dest('dist'))

gulp.src('./css/*.css')
    .pipe(autoprefixer({
        browsers: ['last 2 versions'],      // 瀏覽器版本
        cascade：true                       // 美化屬性，默認true
        add: true                           // 是否添加前綴，默認true
        remove: true                        // 刪除過時前綴，默認true
        flexbox: true                       // 為flexbox屬性添加前綴，默認true
    }))
    .pipe(gulp.dest('./dist'))

查看更多配置：options

更多瀏覽器版本：browsers

gulp-useref

描述：解析構建塊在HTML文件來代替引用未經優化的腳本和樣式表。

// index.html

<!-- build:css /css/all.css -->
<link rel="stylesheet" href="css/normalize.css">
<link rel="stylesheet" href="css/main.css">
<!-- endbuild -->

// gulpfile.js

var useref = require('gulp-useref');

gulp.src('index.html')
    .pipe(useref())
    .pipe(gulp.dest('./dist'))

替換之后的index.html中就會變成：

<link rel="stylesheet" href="css/all.css">  // 之前的兩個<link>替換成一個了

gulp-rev

描述：給靜態資源文件名添加hash值:unicorn.css => unicorn-d41d8cd98f.css

var rev = require('gulp-rev');

gulp.src('./css/*.css')
    .pipe(rev())
    .pipe(gulp.dest('./dist/css'))

gulp-rev-replace

描述：重寫被gulp-rev重命名的文件名。

var rev = require('gulp-rev');
var revReplace = require('gulp-rev-replace');
var useref = require('gulp-useref');

gulp.src('index.html')
    .pipe(useref())                         // 替換HTML中引用的css和js
    .pipe(rev())                            // 給css,js,html加上hash版本號
    .pipe(revReplace())                     // 把引用的css和js替換成有版本號的名字
    .pipe(gulp.dest('./dist'))

gulp-html-replace

描述：替換html中的構建塊。

// index.html

<!-- build:css -->                          // css是buildName,可以自己定義
<link rel="stylesheet" href="css/normalize.css">
<link rel="stylesheet" href="css/main.css">
<!-- endbuild -->

// gulpfile.js

var htmlreplace = require('gulp-html-replace');

gulp.src('index.html')
    .pipe(htmlreplace({
        'css':'all.css'                     // css是index.html中定義的buildName
    }))
    .pipe(gulp.dest('./dist'))

替換之后的index.html中就會變成：

<link rel="stylesheet" href="all.css">      // 之前的兩個<link>替換成一個了

流控制

gulp-if

描述：有條件地運行一個任務。

var gulpif = require('gulp-if');
var uglify = require('gulp-uglify');
var concat = require('gulp-concat');
var condition = true; 

gulp.src('./js/*.js')
    .pipe(gulpif(condition, uglify(), concat('all.js')))  // condition為true時執行uglify(), else 執行concat('all.js')
    .pipe(gulp.dest('./dist/'));

工具

gulp-load-plugins

描述：從包的依賴和附件里加載gulp插件到一個對象里給你選擇。

// package.json 

"devDependencies": {
    "gulp": "^3.9.1",
    "gulp-concat": "^2.6.1",
    "gulp-rename": "^1.2.2",
    "gulp-uglify": "^2.0.1"
}

// gulpfile.js

var $ = require('gulp-load-plugins')();     // $ 是一個對象,加載了依賴里的插件

gulp.src('./**/*.js')
    .pipe($.concat('all.js'))               // 使用插件就可以用$.PluginsName()
    .pipe($.uglify())
    .pipe($.rename('all.min.js'))
    .pipe(gulp.dest('./dist'))

gulp-sass

描述：編譯sass。

var sass = require('gulp-sass');

gulp.src('./sass/**/*.scss')
    .pipe(sass({
        outputStyle: 'compressed'           // 配置輸出方式,默認為nested
    }))
    .pipe(gulp.dest('./dist/css'));
    
gulp.watch('./sass/**/*.scss', ['sass']);   // 實時監聽sass文件變動,執行sass任務

gulp-babel

描述：將ES6代碼編譯成ES5。

var babel = require('gulp-babel');

gulp.src('./js/index.js')
    .pipe(babel({
        presets: ['es2015']
    }))
    .pipe(gulp.dest('./dist'))