详解webpack 如何集成第三方js库

程序员文章站 2022-06-03 13:50:45

webpack系列目录 webpack 系列五：webpack loaders 模块加载器基于webpack搭建纯静态页面型前端工程解决...

webpack系列目录

webpack 系列五：webpack loaders 模块加载器

基于webpack搭建纯静态页面型前端工程解决方案模板，最终形态源码见github:

正文

本篇主要介绍如何集成常用的js库，以avalon 和jquery 为例，同理可扩展到其他js库。更高级的功能见后续文章。更高级的功能见后续文章

avalon 是国内的一个轻量级 mvvm js框架，只是以此为例并不仅限于它

集成avalon

由于项目用到了avalon这个mvvm框架，webpack是兼容多种类型的加载器(amd,cmd)，平常用的avalon.js是自带加载器，用webpack打包时avalon，只能选用avalon的shim无加载器版本，而avalon 目前只有1.4有shim的版本，且不能通过npm install，所以只好到github 下载shim版本的avalon。其中avalon1.4 有3个version，可以根据项目需要下载相应的shim版本到项目中：

avalon.js 支持ie6+ 和现代浏览器
avalon.modern.js 合适于ie10+ 和html5 标准浏览器
avalon.mobile.js 支持移动设备（增加了touch event，pointer，event，fastclick）

基础结构和准备工作

首先得安装上npm，再其次安装webpack

npm install webpack -g

新建项目，项目的目录结构说明

.
├── package.json  # 项目配置
├── src   # 源码目录
│ ├── pagea.html  # 入口文件a
│ ├── pageb.html  # 入口文件b
│ ├── css/   # css资源
│ ├── img/   # 图片资源
│ ├── js   # js&jsx资源
│ │ ├── pagea.js  # a页面入口
│ │ ├── pageb.js  # b页面入口
│ │ ├── lib/  # 没有存放在npm的第三方库或者下载存放到本地的基础库，如jquery、zepto、avalon
│ ├── pathmap.json  # 手动配置某些模块的路径，可以加快webpack的编译速度
├── webpack.config.js  # webpack配置入口

新建package.json文件，复制以下内容执行npm install

{
 "name": "webpack-template",
 "version": "1.0.0",
 "description": "webpack-template"
 "scripts": {
 "test": "echo \"error: no test specified\" && exit 1"
 },
 "author": "sloong",
 "license": "mit",
 "devdependencies": {
 "css-loader": "^0.21.0",
 "file-loader": "^0.8.5",
 "style-loader": "^0.13.0",
 "url-loader": "^0.5.7",
 "webpack": "^1.13.1",
 "webpack-dev-server": "^1.14.1"
 }
}

集成avalon

1.下载的avalon.shim.js 放到 src/js/lib 下（同理jquery，zepto）

2.在src目录下增加 pathmap.json，手动配置某些模块的路径，可以加快webpack的编译速度

{
"avalon": "js/lib/avalon.shim.js"
}

备注：其他依赖js模块同理，例如：avalon + jquery(或者zepto等等)

{
"jquery": "js/lib/jquery-1.12.4.js",
"avalon": "js/lib/avalon.shim.js"
}

3.配置webpack.config.js

var webpack = require("webpack");
var path = require("path");
var pathmap = require('./src/pathmap.json');
var srcdir = path.resolve(process.cwd(), 'src');
var nodemodpath = path.resolve(__dirname, './node_modules');
module.exports = {
entry: "./src/js/index.js",//入口js，可为数组
output: {
 path: path.join(__dirname, "dist"),
 filename: "bundle.js"
},
module: {
 loaders: [
 {test: /\.css$/, loader: 'style-loader!css-loader'}
 ]
},
resolve: {
 extensions: ['.js',"",".css"],
 root: [srcdir,nodemodpath],
 alias: pathmap,
 publicpath: '/'
}
}

4.新增index.html,引用了 dist/bundle.js（webpack 会解析入口文件index.js,将依赖项全部打包到bundle.js中）

<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>test avalon</title>
</head>
<body>
<div ms-controller="avalonctrl">
<h1>{{name}}</h1>
</div>
<script src="../dist/bundle.js"></script>
</body>
</html>

5.新增index.js。需要用哪个js库，就require('3rd-jslib')进来，webpack会将根据依赖项将所需的lib库打包到目标js文件中

var avalon = require('avalon');
avalon.define({
$id: "avalonctrl",
name: "hello avalon!"
});
//jquery 测试
var $ = require("jquery")
$("<div>这是jquery生成的</div>").appendto("body")

6.在项目路径下，执行webpack 打包指令