最近有一個(gè)項(xiàng)目使用了 requirejs 來(lái)解決前端的模塊化,但是隨著頁(yè)面和模塊的越來(lái)越多,我發(fā)現(xiàn)我快要hold不住這些可愛(ài)的js文件了,具體表現(xiàn)在每個(gè)頁(yè)面都要設(shè)置一堆 requirejs 的配置( baseUrl , paths 之類(lèi)的)。
不知誰(shuí)說(shuō)過(guò),一些事重復(fù)做了三次,就該考慮一下自動(dòng)化了,于是我小心翼翼的掏出了我的 grunt 。
我們得使用 grunt-contrib-requirejs 這個(gè)插件來(lái)實(shí)現(xiàn)如上所說(shuō)的自動(dòng)化功能,這個(gè)就是根據(jù) r.js 封裝的 grunt 插件。
安裝 grunt-contrib-requirejs
npm i --save-dev grunt-contrib-requirejs
配置 Grantfile
首先我們來(lái)看下項(xiàng)目目錄

src 是每個(gè)頁(yè)面的依賴(lài)文件
modules 和 lib 是一些模塊和庫(kù)
dist 是合并壓縮后的文件
在 Gruntfile 中首先得到需要處理的文件列表,并創(chuàng)建一個(gè)空對(duì)象,用來(lái)裝requirejs的配置
var files = grunt.file.expand('static/js/src/*.js');var requireOptions = {};然后遍歷這個(gè)文件列表數(shù)組,得到j(luò)s文件的名稱(chēng):
files.forEach(function (file) { var filenamelist = file.split('/'); var num = filenamelist.length; var filename = filenamelist[num - 1].replace(//.js$/,'');}接下來(lái)為每個(gè)js文件配置一個(gè)任務(wù),任務(wù)名稱(chēng)就是js的文件名稱(chēng):
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 配置并加載并注冊(cè)任務(wù)
grunt.initConfig({ requirejs: requireOptions})grunt.loadNpmTasks('grunt-contrib-requirejs');grunt.registerTask('require', ['requirejs']);到這里 requirejs 的配置部分就結(jié)束了,在命令行輸入 grunt require 就會(huì)看到 static/js/dist 目錄下面有東西蹦出來(lái)了,而且全部都是合并后并壓縮好的。
在html頁(yè)面中只需要:
<script src="static/js/require.js"></script><script src="static/js/dist/index.js"></script>
就能成功加載了。
增加js文件的版本號(hào)
瀏覽器有時(shí)會(huì)對(duì)加載過(guò)的js或css進(jìn)行緩存,如果你的某些js依賴(lài)發(fā)生改變,那么就可能發(fā)生錯(cuò)誤,解決辦法是在文件后面增加查詢(xún)字符串,例如 a.js?v=dsd712sd
那么如何控制版本,首先我們肯定想到用 new Date() ,但是如果每次發(fā)布都讓瀏覽器重新加載(盡管有些文件根本就沒(méi)有改變),難免會(huì)造成浪費(fèi)。正確的方案是根據(jù)文件內(nèi)容生成MD5值來(lái)作為版本號(hào),這樣當(dāng)文件沒(méi)有改變時(shí),hash就不會(huì)變。
那么如何自動(dòng)解決版本號(hào)的問(wèn)題,我們可以用到 asset-cache-control 這個(gè)grunt插件
首先安裝:
npm i --save-dev asset-cache-control
asset-cache-control 的用法個(gè)很簡(jiǎn)單,只要設(shè)置一個(gè)源文件,再設(shè)置html文件的路徑就可以了
grunt.initConfig({ cache: { demo: { assetUrl: 'js/demo.js', tmp: ['demo.html'] } }})注意的是:html文件中需要引入 js/demo.js
<script src='js/demo.js'></script>
然后加載和注冊(cè) asset-cache-control 插件
grunt.loadNpmTasks('asset-cache-control');grunt.registerTask('cache', ['cache']);接著在命令行敲 grunt cache 就會(huì)發(fā)現(xiàn) index.html 中的 script 標(biāo)簽加上了查詢(xún)字符串。
<script src='js/demo.js?t=92e26c5d'></script>
對(duì)每個(gè)js文件配置 cache 的任務(wù):
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'] } }});檢測(cè)每個(gè)文件的變化,自動(dòng)執(zhí)行任務(wù)
用到 grunt-contrib-watch 這個(gè)官方組件
在 grunt.initConfig 中配置:
watch: { files: ['static/js/src/*.js','static/js/modules/*.js'], tasks: ['requirejs', 'cache'], options: { spawn: false }}這樣,當(dāng)你修改 static/js/src/ 和 static/js/modules/ 下的所有js文件時(shí),就會(huì)執(zhí)行 requirejs 和 cache 任務(wù)。
完整配置清單
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'])};另外,瀏覽器加載一個(gè)大文件比加載n個(gè)小文件的效率要高很多,所以模塊的合并對(duì)性能也有很大的提高。
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持武林網(wǎng)。
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注