说说如何利用 Webpack 来搭建 Vue 单文件组件环境

版权声明:如果喜欢,就点个赞呗 O(∩_∩)O~ https://blog.csdn.net/deniro_li/article/details/88619078

首先必须先安装与配置好 Webpack。可参考以下内容:

  1. 说说如何安装 Webpack
  2. 说说如何配置 Webpack

.vue 单文件组件:是一个后缀名为 .vue 的文件,我们可以利用 Webpack 的 vue-loader 插件来处理 *.vue 的文件。

1 安装加载器

使用 npm 安装 vue-loader、vue-style-loader、babel 以及 babel-loader 等加载器(之所以要加载最后两个加载器,是为了支持 ES6 语法)。

npm install --save vue
npm install --save-dev vue-loader
npm install --save-dev vue-style-loader
npm install --save-dev vue-template-compiler
npm install --save-dev vue-hot-reload-api
npm install --save-dev babel
npm install --save-dev babel-loader@7
npm install --save-dev babel-core
npm install --save-dev babel-plugin-transform-runtime
npm install --save-dev babel-preset-es2015
npm install --save-dev babel-runtime

对应安装的加载器版本是:

注意: 因为我们安装的 babel 是 6.x 版本,而它所对应的 babe-loaderl 版本必须是 7.x,所以在命令行中,我们明确指定了版本号。如果版本不对应,就会抛出 Cannot find module '@babel/core' 错误。

2 配置 webpack

在 webpack.config.js 中,新增对 .vue 文件以及 ES6 语法的解析支持:

//插件
const ExtractTextPlugin = require('extract-text-webpack-plugin');

//Vue Loader v15+
const VueLoaderPlugin = require('vue-loader/lib/plugin');

var config = {
    module: {
        rules: [
            {//vue 解析
                test: /\.vue$/,
                loader: 'vue-loader',
                options: {
                    loaders: {
                        css: ExtractTextPlugin.extract({
                            use: 'css-loader',
                            fallback: 'vue-style-loader'
                        })
                    }
                }
            },
            {//js 解析
                test: /\.js$/,
                loader: 'babel-loader',
                exclude: /node_modules/
            },
            {//css 解析
                test: /\.css$/,
                use: ExtractTextPlugin.extract({//插件
                    use: 'css-loader',
                    fallback: 'style-loader'
                })
            }
        ]
    },
    entry: {
        main: './main'
    },
    output: {
        //目标输出目录
        path: '/public/assets',
        //资源文件引用目录
        publicPath: '/dist/',
        //输出文件的文件名
        filename: 'main.js'
    },
    plugins: [//插件
        new ExtractTextPlugin('main.css'),
        new VueLoaderPlugin()
    ]
};
module.exports = config;
  • 针对 .vue 文件,使用 vue-loader 来解析。注意:如果 Vue Loader 版本为 15+,那么必须在此配置 VueLoaderPlugin。
  • 因为 vue-loader 在编译 .vue 文件时,会对 <template><script> 以及 <style> 标签分别处理,所以我们在 vue-loader 之后,又配置了 options 属性,用来指定 CSS 解析器。
  • 也可以对 <template><script> 以及 <style> 标签分别指定不同的前端技术,比如 <style lang="less">,然后在配置文件的 loaders 中指定想要的 loader 就可以咯O(∩_∩)O~

3 配置 babel

babel 是新一代 JavaScript 语法的编译器 。 因为新,所以浏览器会因版本不同而存在兼容性问题。但是新语法实在太诱人咯,它不但能够减少代码量,从而减轻代码维护成本,而且还拥有 async,await 等新特性。

Babel 可以让我们放心地使用大部分 JavaScript 新的标准语法,代码会通过编译,生成兼容绝大多数主流浏览器的代码 。 在项目工程脚手架中,一般会使用 .babelrc 文件,来配置一些基本参数,配合 webpack 进行打包压缩 。

在项目根目录,创建 .babelrc 文件,内容如下:

{
  "presets": [
    "es2015"
  ],
  "plugins": [
    "transform-runtime"
  ],
  "comments": false
}
属性 说明
presets 指定预设转码器;babel6 有这些值可选:es2015 ,stage-0 , stage-1 ,stage-2 , stage-3 ,react。
plugins 插件。这里安装了 transform-runtime 插件。
comments 在生成的文件中,是否带注释。

之所以使用了 transform-runtime 插件,是因为 babel 在转换 ES2015 语法为 ECMAScript 5 的语法时,它需要一些辅助函数,例如 _extend。babel 默认会将这些辅助函数内联到每一个 js 文件里,这样文当件多的时候,项目就会很大。所以 babel 提供了 transform-runtime 插件来将这些辅助函数 “搬” 到一个单独的模块 babel-runtime 中,通过这种方式就能有效地减少项目文件。

4 编写 *.vue 文件

每个 *.vue 文件代表一个组件,组件之间可以相互依赖。

我们在主工程根目录下,新建一个 hello.vue:

<template>
    <div>您好,{{name}}</div>
</template>

<script>
    export default {
        data() {
            return {
                name: 'Deniro'
            }
        }
    }
</script>
<style scoped>
    div {
        color: #3399ff;
        font-size: 18px;
    }
</style>

这里使用了 ES 6 语法:

data () {}

就是:

data:function () {
}
  • <template> 标签中写 H5 代码,就是畅快O(∩_∩)O~,Webpack 会把它编译为 Render 函数。
  • 因为配置了extract-text-webpack-plugin 插件,所以写在 <style> 中的样式,会被打包到 main.css 中。因为加了 scoped 属性,所以这里定义的样式只对当前组件(hello.vue)有效。

5 引用 *.vue 组件

在父组件中引用 *.vue 组件时,可以自定义组件名称。现在让我们在 main.js 中引用刚刚定义的 hello.vue 组件:

// 引入 Vue 框架
import Vue from 'vue'

//引入 hello.vue 组件
import Hello from './hello.vue'

new Vue({
    el: '#app',
    render: h => h(Hello)
})

这里使用了 ES6 的箭头函数:

 render: h => h(Hello)

相当于:

render: function (h){
  return h(Hello)
}

注意: 箭头函数中的 this 对象指向的是定义时所在的对象。请看下面的例子:

function Timer() {
    this.id = 10;

    var that = this;

    setTimeout(function () {
        console.log('普通 this=' + this.id);//undefined
        console.log('普通 that=' + that.id);//10

    }, 1000)

    setTimeout(() => {
        console.log('箭头函数=' + this.id);//10
    }, 1000)
}

new Timer();

运行结果:

使用箭头函数之后,我们就不需要再额外定义一个 that 来保存父函数的 this 对象咯,代码将因此变得更简洁O(∩_∩)O~


6 运行

在安装了 Webpack 环境下的工程根目录,执行 npm run dev,执行成功后,就会自动打开浏览器:

F12 打开浏览器调试器:

可以看到,<div id="app"> 被替换为

<div data-v-3548c998="">您好,Deniro</div>

对应的 CSS 也加上了我们定义的样式。

之所以加了 -v-xxx,是因为我们在 <style> 加了 scoped 属性。

7 扩展

我们再定义两个组件(标题与按钮组件),把它们引入 hello.vue。

title.vue:

<template>
    <h1>
        <a :href="'#'+title">{{title}}</a>
    </h1>
</template>

<script>
    export default {
        props: {
            title: {
                type: String
            }
        }
    }
</script>

<style scoped>
    h1 a {
        color: #3399ff;
        font-size: 16px;
    }
</style>

button.vue:

<template>
    <button @click="handleClick" :style="styles">
        <slot></slot>
    </button>
</template>

<script>
    export default {
        props: {
            color: {
                type: String,
                default: '#00cc66'
            }
        },
        computed: {
            styles() {
                return {
                    background: this.color
                }
            }
        },
        methods: {
            handleClick(e) {
                this.$emit('click', e);
            }
        }
    }
</script>

<style scoped>
    button {
        border: 0;
        outline: none;
        color: #fff;
        padding: 4px 8px;
    }

    button:active {
        position: relative;
        top: 1px;
        left: 1px;
    }
</style>

在根实例 hello.vue 组件中,引入刚刚定义的两个组件:

<template>
    <div>
        <v-title title="电子烟大限将至?"></v-title>
        <v-button @click="handleClick">请点击</v-button>
    </div>
</template>

<script>
    //导入组件
    import vTitle from './title.vue';
    import vButton from './button.vue';

    export default {
        data() {
          ...
        },
        components: {
            vTitle,
            vButton
        },
        methods: {
            handleClick(e) {
                console.log(e);
            }
        }
    }
</script>
<style scoped>
  ...
</style>

这里也用了 ES6 对象字面量缩写语法:

 components: {
            vTitle,
            vButton
        }

相当于:

 components: {
            vTitle: vTitle,
            vButton: vButton
        }

当对象的 key 与 value 同名时,就可以采用这种简洁的写法咯O(∩_∩)O~

注意: 这些导入的组件,都是局部注册且可以自定义名称的组件。

渲染结果:

点击按钮组件后的运行结果:


至此,Vue 单文件组件环境搭建成功O(∩_∩)O~

猜你喜欢

转载自blog.csdn.net/deniro_li/article/details/88619078