小白上学のWebpack零基础学习指导

前言:

本套教程是零基础学打包工具webpack;后面会结合gulp+webpack搞定所有你得需求;

闲谈:

百度搜了一下,虽然教程多,但是杂乱无章,实用的没多少,都是匆匆了事,所以我就自己学了两天,现在从最底层教大家完成webpack的常用功能,后期我会再写一篇gulp+webpack的前端神器文章,但我也要学好了再给大家发^_^!

nodejs安装:

1.https://nodejs.org/en/download/  选择对应自己的下载安装,命令行工具测试node -v是否成功;

smart-npm优化下载速度:

2.安装完node后再测试一些 npm -v 命令是否成功,由于npm连接外网会经常下载插件会卡,推荐大家使用smart-npm;在CMD命令窗口中输入:npm install --global smart-npm@1 --registry=https://registry.npm.taobao.org/安装完成后会自动替换当前npm,这时候你再试试安装其他的插件是不是很快了^_^?!

webpack全局安装:

3.CMD命令窗口中输入:npm install -g webpack

新建项目:

4.新建文件夹命名为webpack,如果你建立在D:test/webpack 在cmd命令窗口一次输入d: 、cd test 、 cd webpack 现在我们已经进入我们新建的webpack文件夹输入: 

一直按回车;完成后现在项目里面就有一个package.json, 我们多加一点东西;建立以下文件:

/app  index.js  pro.jspackage.jsonwebpack.config.js

添加了两个js文件,添加了最重要的webpack->webpack.config.js的配置文件(文件名字不能更改),我们还是从简单的hello world开始吧,webpack原生直接支持AMD和CommonJS两种模块;

JS代码

pro.js

//我们这里使用CommonJS风格

function generateText() {  var element = document.createElement('h2');  element.innerHTML = "Hello h2 world";  return element;}module.exports = generateText;//module.exports这个函数会把generateText方法暴露给全局在其他js中就可以引用了, exports相当于导出,后面index.js中的require就是导入;

index.js

var pro  = require('./pro');//填写模块路径,导入文件后缀的js可以省略。var app  = document.createElement('div');app.innerHTML = '# Hello World';app.appendChild(pro());document.body.appendChild(app);

以上代码功能很简单,就是把pro.js定义为一个模块,在index.js中引用,最终两文件中要添加的内容都显示在index.html中。

配置Webpack

现在开始配置webpack,目标是把这两个js文件合并成一个文件. 我们可以自己在build文件夹里面手动建一个index.html文件夹,然后再把合并以后的js引用在里面,但是这样有些麻烦,所以我们这里安装一个plugin,可以自动快速的帮我们生成HTML。

npm install html-webpack-plugin --save-dev

好 有了这个插件 开始写webpack.config.js文件

var path = require('path');//node 引入自带方法var HtmlwebpackPlugin = require('html-webpack-plugin');//定义了一些文件夹的路径var ROOT_PATH = path.resolve(__dirname);//__dirname是获取当前文件的绝对路径,注意双下划线var APP_PATH = path.resolve(ROOT_PATH, 'app');var BUILD_PATH = path.resolve(ROOT_PATH, 'build');module.exports = {  //项目的文件夹 可以直接用文件夹名称 默认会找index.js 也可以确定是哪个文件名字  entry: APP_PATH,  //输出的文件名 合并以后的js会命名为bundle.js  output: {    path: BUILD_PATH,    filename: 'bundle.js'  },  //添加我们的插件 会自动生成一个html文件  plugins: [    new HtmlwebpackPlugin({      title: 'Hello World app'    })  ]};

然后在项目根目录运行

D:\test\webpack>webpack

终端显示一堆信息,然后告诉你成功了。

你可以使用webpack --help看看一些运行的时候可选的参数

你会发现多出来一个build文件夹,直接点开里面的html文件,你会发现我们可爱的“hello world”已经插入到页面了。我们的任务完成了,成功生成html,合并js,html引入了js,js被执行了。

配置webpack-dev-server

上面任务虽然完成了,但是我们要不断运行程序然后查看页面,所以最好新建一个开发服务器,可以serve我们pack以后的代码,并且当代码更新的时候自动刷新浏览器。

安装webpack-dev-server

npm install webpack-dev-server --save-dev

安装完毕后 在webpack.config.js中添加配置

module.exports = {  ....  devServer: {    historyApiFallback: true,    hot: true,    inline: true,    progress: true,  }  ...}

然后再package.json里面配置一下运行的命令,npm支持自定义一些命令

..."scripts": {  "start": "webpack-dev-server --hot --inline"},...

好了,在项目根目录下输入npm start,一堆信息后server已经起来了,在浏览器里面输入http://localhost:8080 发现伟大的hello world出现了,在js里面随便修改一些输出然后保存, 浏览器自动刷新,新的结果出现了。

添加CSS样式

现在来添加一些样式,webpack使用loader的方式来处理各种各样的资源,比如说样式文件,我们需要两种loader,css-loader 和 style-loader,css-loader会遍历css文件,找到所有的url(...)并且处理。style-loader会把所有的样式插入到你页面的一个style标签中。

安装我们的loader

npm install css-loader style-loader --save-dev

配置loader,在webpack.config.js中

  devServer: {    historyApiFallback: true,    hot: true,    inline: true,    progress: true,  },  ...  module: {    loaders: [      {        test: /\.css$/,        loaders: ['style', 'css'],        include: APP_PATH      }    ]  },  ...  plugins: [    new HtmlwebpackPlugin({      title: 'Hello World app'    })  ]

看loaders的书写方式,test里面包含一个正则,包含需要匹配的文件,loaders是一个数组,包含要处理这些程序的loaders,这里我们用了css和style,注意loaders的处理顺序是从右到左的,这里就是先运行css-loader然后是style-loader.

新建一个样式文件 main.css

h1 {    color: red;}

记得在入口文件index.js中引用

require('./main.css');

然后发现标题变成红色的了,webpack的理念是基于项目处理的,把对应的文件格式给对应的loader处理,然后你就不用管了,它会决定怎么压缩,编译。

那现在想使用一些有爱的css预编译程序,来点sass吧。 你可能已经想到了,再来个loader就行啦,确实是这样简单。

npm install sass-loader --save-dev

稍微修改一下webpack.config.js,删掉我们先前添加的css规则,加上下面的loader

  {    test: /\.scss$/,    loaders: ['style', 'css', 'sass'],    include: APP_PATH  },

添加两个sass文件,variables.scss和main.scss

variables.scss

$red: red;

main.scss

@import "./variables.scss";h1 {  color: $red;}

在index.js中引用

require('./main.scss');

然后发现标题如愿变红,相当简单吧。

处理图片和其他静态文件

这个和其他一样,也许你也已经会玩了。安装loader,处理文件。诸如图片,字体等等,不过有个神奇的地方它可以根据你的需求将一些图片自动转成base64编码的,为你减轻很多的网络请求。

安装url-loader

npm install url-loader --save-dev

配置config文件

  {    test: /\.(png|jpg)$/,    loader: 'url?limit=40000'  }

注意后面那个limit的参数,当你图片大小小于这个限制的时候,会自动启用base64编码图片。

下面举个栗子。

新建一个imgs文件夹,往里面添加一张崔叔的照片。在scss文件中添加如下的东西。

@import "./variables.scss";h1 {  color: $red;  background: url('./imgs/avatar.jpg');}

npm start, 然后查看图片的url,用浏览器审查元素看到生成了best64位码的图片编码,建议一些图标什么的用此功能。
添加第三方库

有的时候还想来点jquery,moment,undersocre之类的库,webpack可以非常容易的做到这一点,有谣言说Bower即将停止开发了, 作者推荐都使用npm来管理依赖。那么我们现在安装在我们的app中添加jquery和moment的支持。

npm install jquery --save-dev

在js中引用

var pro = require('./pro');var $ = require('jquery');var app  = document.createElement('div');app.innerHTML = '# Hello World it';document.body.appendChild(app);app.appendChild(sub());$('body').append('look at me! now is ' + new Date() + '');

看看浏览器,成功! jquery现在都起作用了!

开发技巧

启用source-map

现在的代码是合并以后的代码,不利于排错和定位,只需要在webpack.config.js中添加

  ...  devtool: 'eval-source-map',  ...

这样出错以后就会采用source-map的形式直接显示你出错代码的位置。

配置webpack-dev-server代理

一个典型的例子就是前后端分离。后端是的server不管用什么写的。假定在本机他是类似http://localhost:5000/api/*这类的请求,现在添加配置让ajax请求可以直接proxy过去。

devServer: {    hot: true,    inline: true,    //其实很简单的,只要配置这个参数就可以了    proxy: {      '/api/*': {          target: 'http://localhost:5000',          secure: false      }    }}

重启以后 发现/api/*的请求都代理到http://localhost:5000去了~
安装jshint检测js语法

npm install jshint-loader --save-dev

在config文件中配置

module: {...    //和loaders一样的语法,很简单    perLoaders: [        {            test: /\.jsx?$/,            include: APP_PATH,            loader: 'jshint-loader'        }    ]}...//配置jshint的选项,支持es6的校验jshint: {  "esnext": true},

好了 现在每次npm run start的时候就可以看到jshint的提示信息咯
有时某些插件都需要全文件使用例如:jquery
webpack提供一个插件 把一个全局变量插入到所有的代码中,在webpack.config.js里面配置

  ...  plugins: [    new HtmlwebpackPlugin({      title: 'Hello World app'    }),    //provide $, jQuery and window.jQuery to every script    new webpack.ProvidePlugin({      $: "jquery",      jQuery: "jquery",      "window.jQuery": "jquery"    })  ]  ...

分离app.js和第三方库

现在我们build出来的只有一个bundle.js 如果第三方库很多的话,会造成这个文件非常大,减慢加载速度,现在我们要把第三方库和我们app本身的代码分成两个文件。

修改entry入口文件

  entry: {    app: path.resolve(APP_PATH, 'index.js'),    //添加要打包在vendors里面的库    vendors: ['jquery', 'moment']  },

添加CommonsChunkPlugin

  plugins: [    //这个使用uglifyJs压缩你的js代码    new webpack.optimize.UglifyJsPlugin({minimize: true}),    //把入口文件里面的数组打包成verdors.js    new webpack.optimize.CommonsChunkPlugin('vendors', 'vendors.js'),    new HtmlwebpackPlugin({      title: 'Hello World app'    })  ]

添加完毕 运行npm run build
在build文件夹中发现如下结构

budle.js
index.html
vendors.js

关键字:JavaScript, html5, node.js, html

版权声明

本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处。如若内容有涉嫌抄袭侵权/违法违规/事实不符,请点击 举报 进行投诉反馈!

相关文章

立即
投稿

微信公众账号

微信扫一扫加关注

返回
顶部