詳解webpack引入第三方庫的方式以及注意事項
一般情況下,我們不用擔心所使用的第三方庫,在npm管理倉庫中找不到。
如果需要某一個庫,如:jquery,可以直接運行npm install jquery
腳本命令來安裝這個項目所需要的依賴;
然后,在使用jquery的模塊文件中,通過import $ from 'jquery'
或者var $ = require('jquery')
來引入。
這是常用的在webpack構(gòu)建的項目
中引入第三方庫的方式。
注:為了更好的演示示例代碼,示例是在nodemon
這篇文章的基礎(chǔ)上操作的。
但是,在不同的場景下,對webpack構(gòu)建的項目有不同的需求:
項目的體積足夠小(cdn)
如果是webapck的處理方式,可參考webapck——實現(xiàn)構(gòu)建輸出最小
這篇文章。
使用非webapck的處理方式,如:CDN。
操作也很簡單,如果使用html-webpack-plugin
直接在模板文件template/index.html
中引入某個cdn(如:boot CDN)上的某個第三方庫(如:jquery),參考代碼如下:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>third party</title> </head> <body> <script src="https://cdn.bootcss.com/jquery/3.3.1/jquery.min.js"></script> </body> </html>
然后,在module.js中使用jquery即可,參考代碼如下:
require('./module.css'); module.exports = function() { $(document.body).append('<h1>hello webpack</h1>') }
最后,運行npm run test
,構(gòu)建結(jié)束后,你會在瀏覽器中看到hello webpack
字樣,背景是紅色的頁面效果。
全局環(huán)境下使用第三方庫(provide-plugin or imports-loader)
為了避免每次使用第三方庫,都需要用import
或者require()
引用它們,可以將它們定義為全局的變量。
而webpack的ProvidePlugin
內(nèi)置的插件,可以解決這個問題。詳情可參考ProvidePlugin這篇文章的介紹。
避免于cdn引用的jquery沖突,這里使用lodash。
首先,安裝lodash
依賴,命令如下:
yarn add lodash --dev
然后,在webpack.config.js中,添加如下代碼:
new webpack.ProvidePlugin({ _: 'lodash' }),
其次,在module.js
中添加如下代碼:
... var arr = [1, 2, 3, 4, 5 ,6]; // provide-plugin $(document.body).append('<h1>' + _.concat(arr, '~') + '</h1'); ...
最后,運行npm run test
腳本命令,構(gòu)建完成后,你就可以瀏覽器的頁面中增加了1,2,3,4,5,6,~。
如果,你想指定lodash
的某個工具函數(shù)可以全局使用,如:_.concat,
首先,像下面這樣修改webapck.config.js
,代碼如下:
... new webpack.ProvidePlugin({ // _: 'lodash', _concat: ['lodash', 'concat'] }), ...
然后,修改module.js,代碼如下:
... var arr = [1, 2, 3, 4, 5 ,6]; // provide-plugin // $(document.body).append('<h1>' + _.concat(arr, '~') + '</h1'); $(document.body).append('<h1>' + _concat(arr, '~') + '</h1'); ...
如果不喜歡用插件的,也可以考慮使用import-loader
,它也可以實現(xiàn)相同的目的。
為了避免不必要的干擾,可以使用underscore
來演示。
首先,安裝imports-loader
依賴,命令如下:
yarn add imports-loader --dev
然后,安裝underscore依賴,命令如下:
yarn add underscore
其次,在webapck.config.js中添加如下代碼:
... module: { rules: [ { test: require.resolve('underscore'), use: 'imports-loader?_=underscore' }, ... ] }, ...
注:underscore和lodash都是用的是單例的模式開發(fā)的,它們實例化的構(gòu)造函數(shù)的名字都是_,為了作區(qū)分,需要對其中一個做一下改變。imports-loader對這個標識起別名有點兒困難,而provide-plugin則沒有這個問題,可以定一個個性化的別名。
修改webpack.config.js,代碼如下:
new webpack.ProvidePlugin({ // _: 'lodash', // _concat: ['lodash', 'concat'], __: 'lodash' }),
可以為lodash
定義為__
與underscore
的_
作區(qū)分。
然后,修改module.js,代碼如下:
... // provide-plugin // $(document.body).append('<h1>' + _.concat(arr, '~') + '</h1'); // $(document.body).append('<h1>' + _concat(arr, '~') + '</h1'); $(document.body).append('<h1>' + __.concat(arr, '~') + '</h1'); ...
最后,保存所有的文件,可以下瀏覽器中看到相似的結(jié)果(保存后,nodemon自啟動瀏覽器)。
cdn與externals
之前遇到了一些externals
的問題,為什么要詳細的說,是因為很多人不明白它到底用來干什么的。
場景再現(xiàn):
之前,有一個項目使用了jquery
,由于這個庫的比較經(jīng)典,它在應(yīng)用的各個模塊中被頻繁引用。使用的方式如下:
import $ from 'jquery'
或者
var $ = require('jquery')
結(jié)果是構(gòu)建結(jié)束后,文件比較大。那么考慮使用cdn,如上文描述的那樣。這樣需要刪除import或require的引用,同時刪除安裝的jquery依賴,但是由于項目結(jié)構(gòu)比較亂,模塊比較多,為了避免造成少改或者漏改的問題,會造成應(yīng)用出錯。該怎么辦呢?
有的人說,不刪除jquery依賴,那么使用cdn的目的就沒有意義了。而使用external則可以解決這個問題。
可以在module.js文件中添加如下代碼:
... var $ = require('jquery') ...
然后,保存文件,發(fā)現(xiàn)構(gòu)建輸出提示如下的錯誤:
ERROR in ./module.js Module not found: Error: Can't resolve 'jquery' in 'E:\workspace\me\webpack-play\demo\example-1' @ ./module.js 3:0-23 @ ./main.js @ multi (webpack)-dev-server/client?http://localhost:8080 ./main.js
模塊module.js中的jquery不能被解析。
緊接著,在webpack.config.js
中添加如下代碼:
externals: { jquery: 'jQuery', jquery: '$' },
其中jquery代表的是require('jquery')中的jquery,而jQuery和$代表的是jquery這個庫自身提供的可是實例化的標識符。其它的庫的cdn化,修改類似jquery。
但是,如果在項目一開始就決定用cdn的話,就不要在使用jquery的模塊中,使用var $ = require('jquery')
或 import $ from 'jquery';
,雖然這樣做不會報錯,但是如果出于某方面的考慮,后期可能會引入jquery依賴,那么就必須使用var $ = require('jquery')
或 import $ from 'jquery';
。
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
Layui帶搜索的下拉框的使用以及動態(tài)數(shù)據(jù)綁定方法
今天小編就為大家分享一篇Layui帶搜索的下拉框的使用以及動態(tài)數(shù)據(jù)綁定方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2019-09-09Bootstrap Table 雙擊、單擊行獲取該行及全表內(nèi)容
這篇文章主要介紹了Bootstrap Table 雙擊、單擊行獲取該行內(nèi)容及獲取全表的內(nèi)容,本文通過實例代碼給大家介紹的非常詳細,具有一定的參考借鑒價值,需要的朋友可以參考下2018-08-08Bootstrap 下拉多選框插件Bootstrap Multiselect
這篇文章主要介紹了Bootstrap 下拉多選框插件Bootstrap Multiselect,引入文件及使用方法講解,需要的朋友參考下吧2017-01-01