webpack入坑之旅（五）加载vue单文件组件

时间 2019-12-05

标签 webpack 之旅加载 vue 文件组件繁體版

原文原文链接

转自我的博客：原地址javascript

这是一系列文章，此系列全部的练习都存在了个人github仓库中vue-webpack，在本人有了新的理解与认识以后,会对文章有不定时的更正与更新。下面是目前完成的列表：css

须要什么？

在通过前面的四个练习，相信已经对于webapck有了必定的了解，如今咱们就来一个综合案例，进一步加深对于webpack的理解。jquery

首先咱们应该思考要解析.vue类型的文件，须要什么样的东西？应该按照什么样的步骤来？咱们应该怎么去搭建这个项目？webpack

开始

第一步：初始化项目目录

咱们须要建立以下目录及文件夹，最终目录结构以下：git

- dist //文件生成目录
    -- //自动生成
- node_module //自动安装
    -- ...
- src //文件入口
    -- components //组件存放
        -- app.vue //主.vue
    -- main.js //主.js
- index.html //主.html
- package.json //npm 配置
- webpack.cofig.js // webpack配置

第二步：安装项目依赖

若是你上面没有建立package.json文件的话，能够直接使用npm init来初始化咱们的package.json文件的配置。

想要去编译其余的文件好比react，coffce等等，就必需要加载不少对应的loader。要想加载一个.vue文件。固然也是一样的道理。
建议用npm install xxx-loader --save-dev这样的命令一条一条的敲。在命令行中，会有提示，能够帮助理解webpack的中的依赖管理关系。个人配置清单以下：
在实际项目中，json文件中不能出现注释，在这里为了方便你们了解里面设置项的含义，就直接使用注释的方式加载后面了。

{
    "name": "05-five-vue", //项目名称
    "version": "1.0.0", //版本
    "description": "vue+webapck", //描述
    "main": "index.js", //主文件
    "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1",
        "start": "webpack-dev-server --inline"
    }, //scripts指定了运行脚本命令的npm命令行缩写，好比这是的start指定了运行npm run start时，所要执行的命令。
    "dependencies": { //项目依赖
        "vue": "^1.0.18"
    },
    "devDependencies": { //各类各样的loader，用来解析想相应的文件格式。要解析vue而且完成相应的功能，这些基本都是必须的。
        "autoprefixer-loader": "^2.0.0",
        "babel": "^6.3.13",
        "babel-core": "^6.3.21",
        "babel-loader": "^6.2.0",
        "babel-plugin-transform-runtime": "^6.3.13",
        "babel-preset-es2015": "^6.3.13",
        "babel-runtime": "^5.8.34",
        "css-loader": "^0.16.0",
        "file-loader": "^0.8.5",
        "html-loader": "^0.3.0",
        "node-sass": "^3.4.2",
        "sass-loader": "^3.2.0",
        "style-loader": "^0.12.3",
        "url-loader": "^0.5.6",
        "vue-html-loader": "^1.2.0",
        "vue-loader": "^7.2.0",
        "webpack": "^1.12.0",
        "webpack-dev-server": "^1.14.0"
    },
    "author": "guowenfh", //做者
    "license": "MIT", //开源协议
    "keywords": [ //关键字
        "vue",
        "webpack"
    ]
}

若是你想省事的话，直接复制上面的devDependencies,dependencies字段，而且填写到你的package.json文件中。而后运行npm install就会自动安装全部的模块以及依赖。

第三步：配置webpack

文件已经设置好了，接下来就到了咱们关键的一步，配置webpack.config.js,清单以下：

var path = require('path');
// NodeJS中的Path对象，用于处理目录的对象，提升开发效率。
// 模块导入
module.exports = {
    // 入口文件地址，不须要写完，会自动查找
    entry: './src/main',
    // 输出
    output: {
        path: path.join(__dirname, './dist'),
        // 文件地址，使用绝对路径形式
        filename: '[name].js',
        //[name]这里是webpack提供的根据路口文件自动生成的名字
        publicPath: '/dist/'
        // 公共文件生成的地址
    },
    // 服务器配置相关，自动刷新!
    devServer: {
        historyApiFallback: true,
        hot: false,
        inline: true,
        grogress: true,
    },
    // 加载器
    module: {
        // 加载器
        loaders: [
        // 解析.vue文件
            { test: /\.vue$/, loader: 'vue' },
        // 转化ES6的语法
            { test: /\.js$/, loader: 'babel', exclude: /node_modules/ },
        // 编译css并自动添加css前缀
            { test: /\.css$/, loader: 'style!css!autoprefixer'},
        //.scss 文件想要编译，scss就须要这些东西！来编译处理
        //install css-loader style-loader sass-loader node-sass --save-dev
            { test: /\.scss$/, loader: 'style!css!sass?sourceMap'},
        // 图片转化，小于8K自动转化为base64的编码
            { test: /\.(png|jpg|gif)$/, loader: 'url-loader?limit=8192'},
        //html模板编译？
            { test: /\.(html|tpl)$/, loader: 'html-loader' },
        ]
    },
    // .vue的配置。须要单独出来配置，其实没什么必要--由于我删了也没保错，不过这里就留这把，由于官网文档里是能够有单独的配置的。
    vue: {
        loaders: {
            css: 'style!css!autoprefixer',
        }
    },
    // 转化成es5的语法
    babel: {
        presets: ['es2015'],
        plugins: ['transform-runtime']
    },
    resolve: {
        // require时省略的扩展名，如：require('module') 不须要module.js
        extensions: ['', '.js', '.vue'],
        // 别名，能够直接使用别名来表明设定的路径以及其余
        alias: {
            filter: path.join(__dirname, './src/filters'),
            components: path.join(__dirname, './src/components')
        }
    },
    // 开启source-map，webpack有多种source-map，在官网文档能够查到
    devtool: 'eval-source-map'
};

请详细查看这里面的设置，我这里都是很简单的配置，在你的项目中，还能够更进一步的对于入口文件和输出文件进行更加深刻的定制。

而且在这里生成的css文件还会插到js中，有时咱们须要更进一步的把它独立出来，而后在html中引入这时就会用到webpack的插件，在这里先不说（由于我暂时没用到，没有试验过，好像也不麻烦，能够的话下篇再试试）

第四步：编写代码

接下来就是咱们要展现的文件的编写了，我直接把代码贴上来了。

index.html：

<!DOCTYPE html>
    <html lang="en">

    <head>
        <meta charset="UTF-8">
        <title>webpack vue</title>
        <style>
            #app {
                margin: 20px auto;
                width: 800px;
                height: 600px;
            }
        </style>
    </head>

    <body>
        <div id="app"></div>
        <script src="dist/main.js"></script>
    </body>

    </html>

这里是main.js的内容：

//es6语法：
import Vue from "../node_modules/vue/dist/vue.min.js";//其实不用写完，会自动查找。
//外部引入别的库均可以用这样的方式，好比jquery等。。
//引入咱们编写的测试用vue文件。
import app from './components/app';

Vue.config.debug = true;//开启错误提示

new Vue(app);

这里是app.vue：

<script>
    //es6
    export default {
        el:"#app",
         //data:function(){}，下面是es6写法
         data () {
            return {
                name:"guowenfh",
                age:"2q1"
            }
        }
    }
</script>
<template>
    <div>
        <h1>姓名：{{name}}</h1>
        <h2>{{age}}</h2>
    </div>
</template>
<style lang="sass">
    /*必定要加lang否则没法编译*/
    /*测试一下对sass的编译*/
    $qwe:#098;
    body{
        background-color: $qwe;
        h1{
            background-color: #eee;
            color: red;
            transform: translate(10%, 10%);/*测试自动添加前缀*/
        }
        h1:hover{
            height:100px;
        }

        h2{
            background-color: #999;
        }
    }
</style>

第五步：修改自动刷新设置

下面再单独的再谈一下关于自动刷新的实现，首先须要说明，在上一篇博客中的自动刷新实现，是有问题的。只能改变css样式，使颜色进行变化。对于html里面的内容改变时，浏览器并不会自动刷新。

注意点一：

首先咱们看到package.json中scripts字段中的"start": "webpack-dev-server --inline"。这里若是按照网上的方法在后面再添加上--hot的话，只会对于app.vue中的<style>标签内的css起效果。

注意点二：

由于咱们没有加--hot，因此在webpack.cofig.js中须要对于devServer进行一些配置，以下：（主要是是hot设置为了false）。

devServer: {
    historyApiFallback: true,
    hot: false,
    inline: true,
    grogress: true,
}

这样设置了以后按下保存至关于按下了F5浏览器整个刷新。而不是局部刷新。（若是你实现了局部刷新，而且没有其余问题，那请教教我^_^）

注意点三：

注意package.json的loader安装中的"vue-hot-reload-api": "^1.2.2"。它有多是致使你不能自动刷新的凶手(我如今都没搞明白到底该安装，仍是取消)

结束

步骤都走完了，由于在上面的package.json中已经进行了scripts项的配置。运行npm start，打开localhost:8080

能够看到设置的背景色已经出来了,去改变一下背景颜色？data？template？

看看浏览器会不会自动刷新？

若是你按照个人步骤，而且，npm包安装没有错误的话，应该就能成功了。

不行的话，请再仔细对照去看看有什么地方没有编写对吧！