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

首先必须先安装与配置好 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

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

  • vue@2.6.8
  • vue-loader@15.7.0
  • vue-style-loader@4.1.2
  • vue-template-compiler@2.6.8
  • vue-hot-reload-api@2.3.3
  • babel@6.23.0
  • babel-loader@7.1.5
  • babel-core@6.26.3
  • babel-plugin-transform-runtime@6.23.0
  • babel-preset-es2015@6.24.1
  • babel-runtime@6.26.0

注意: 因为我们安装的 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~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,802评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,109评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,683评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,458评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,452评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,505评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,901评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,550评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,763评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,556评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,629评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,330评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,898评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,897评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,140评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,807评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,339评论 2 342

推荐阅读更多精彩内容