详解使用grunt完成requirejs的合并压缩和js文件的版本控制
最近有一个项目使用了 requirejs
来解决前端的模块化,但是随着页面和模块的越来越多,我发现我快要hold不住这些可爱的js文件了,具体表现在每个页面都要设置一堆 requirejs
的配置( baseUrl
, paths
之类的)。
不知谁说过,一些事重复做了三次,就该考虑一下自动化了,于是我小心翼翼的掏出了我的 grunt
。
我们得使用 grunt-contrib-requirejs
这个插件来实现如上所说的自动化功能,这个就是根据 r.js
封装的 grunt
插件。
安装 grunt-contrib-requirejs
npm i --save-dev grunt-contrib-requirejs
配置 Grantfile
首先我们来看下项目目录
src
是每个页面的依赖文件
modules
和 lib
是一些模块和库
dist
是合并压缩后的文件
在 Gruntfile
中首先得到需要处理的文件列表,并创建一个空对象,用来装requirejs的配置
var files = grunt.file.expand('static/js/src/*.js'); var requireOptions = {};
然后遍历这个文件列表数组,得到js文件的名称:
files.forEach(function (file) { var filenamelist = file.split('/'); var num = filenamelist.length; var filename = filenamelist[num - 1].replace(/\.js$/,''); }
接下来为每个js文件配置一个任务,任务名称就是js的文件名称:
files.forEach(function (file) { requireOptions[filename] = { options: { baseUrl: 'static/js', paths: { jquery: 'lib/jquery.min', lrz: 'lib/lrz.all.bundle', zepto: 'lib/zepto.min', ajax: 'modules/ajax', validators: 'modules/validators', page: 'modules/mixins/to_page', dialog: 'modules/mixins/toggle_login_dialog', }, optimizeAllPluginResources: true, name: 'src/' + filename, out: 'static/js/dist/' + filename + '.js' } }; }
接着初始化 grunt
配置并加载并注册任务
grunt.initConfig({ requirejs: requireOptions }) grunt.loadNpmTasks('grunt-contrib-requirejs'); grunt.registerTask('require', ['requirejs']);
到这里 requirejs
的配置部分就结束了,在命令行输入 grunt require
就会看到 static/js/dist
目录下面有东西蹦出来了,而且全部都是合并后并压缩好的。
在html页面中只需要:
<script src="/UploadFiles/2021-04-02/require.js">就能成功加载了。
增加js文件的版本号
浏览器有时会对加载过的js或css进行缓存,如果你的某些js依赖发生改变,那么就可能发生错误,解决办法是在文件后面增加查询字符串,例如
a.js"htmlcode">
npm i --save-dev asset-cache-control
asset-cache-control
的用法个很简单,只要设置一个源文件,再设置html文件的路径就可以了grunt.initConfig({ cache: { demo: { assetUrl: 'js/demo.js', tmp: ['demo.html'] } } })注意的是:html文件中需要引入
js/demo.js
<script src='js/demo.js'></script>然后加载和注册
asset-cache-control
插件grunt.loadNpmTasks('asset-cache-control'); grunt.registerTask('cache', ['cache']);接着在命令行敲
grunt cache
就会发现index.html
中的script
标签加上了查询字符串。<script src='js/demo.js"htmlcode">var files = grunt.file.expand('static/js/src/*.js'); var cacheOptions ={}; files.forEach(function (file) { var filenamelist = file.split('/'); var num = filenamelist.length; var filename = filenamelist[num - 1].replace(/\.js$/,''); cacheOptions[filename] = { assetUrl: 'static/js/dist/' + filename +'.js', files: { 'tmp': [filename+'.php'] } } });检测每个文件的变化,自动执行任务
用到
grunt-contrib-watch
这个官方组件在
grunt.initConfig
中配置:watch: { files: ['static/js/src/*.js','static/js/modules/*.js'], tasks: ['requirejs', 'cache'], options: { spawn: false } }这样,当你修改
static/js/src/
和static/js/modules/
下的所有js文件时,就会执行requirejs
和cache
任务。完整配置清单
module.exports = function (grunt) { var files = grunt.file.expand('static/js/src/*.js'); var requireOptions = {}; var cacheOptions ={}; files.forEach(function (file) { var filenamelist = file.split('/'); var num = filenamelist.length; var filename = filenamelist[num - 1].replace(/\.js$/,''); requireOptions[filename] = { options: { baseUrl: 'static/js', paths: { jquery: 'lib/jquery.min', lrz: 'lib/lrz.all.bundle', zepto: 'lib/zepto.min', ajax: 'modules/ajax', validators: 'modules/validators', page: 'modules/mixins/to_page', dialog: 'modules/mixins/toggle_login_dialog', }, optimizeAllPluginResources: true, name: 'src/' + filename, out: 'static/js/dist/' + filename + '.js' } }; cacheOptions[filename] = { assetUrl: 'static/js/dist/' + filename +'.js', files: { 'tmp': [filename+'.php'] } } }); grunt.initConfig({ requirejs: requireOptions, cache: cacheOptions, watch: { files: ['static/js/src/*.js','static/js/modules/*.js'], tasks: ['requirejs', 'cache'], options: { spawn: false } } }); grunt.loadNpmTasks('asset-cache-control'); grunt.loadNpmTasks('grunt-contrib-requirejs'); grunt.loadNpmTasks('grunt-contrib-watch'); grunt.registerTask('require', ['requirejs','cache']) };另外,浏览器加载一个大文件比加载n个小文件的效率要高很多,所以模块的合并对性能也有很大的提高。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
下一篇:jQuery上传多张图片带进度条样式(DEMO)