vue+webpack 入门实战(五)加载 vue 单文件组件

2,515 阅读4分钟
原文链接: guowenfh.github.io

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

需要什么?

在经过前面的四个练习,相信已经对于webapck有了一定的了解,现在我们就来一个综合案例,进一步加深对于webpack的理解。

首先我们应该思考要解析.vue类型的文件,需要什么样的东西?应该按照什么样的步骤来?我们应该怎么去搭建这个项目?

开始

第一步:初始化项目目录

我们需要创建如下目录及文件夹,最终目录结构如下:

- dist 
    -- 
    - node_module 
    -- ...
    - src 
    -- components 
        -- app.vue 
    -- main.js 
    - index.html 
- package.json 
- webpack.cofig.js 

第二步:安装项目依赖

如果你上面没有创建package.json文件的话,可以直接使用npm init来初始化我们的package.json文件的配置。

想要去编译其他的文件比如reactcoffce等等,就必须要加载很多对应的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"
    }, 
    "dependencies": { 
        "vue": "^1.0.18"
    },
    "devDependencies": { 
        "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');
module.exports = {
    entry: './src/main',
    output: {
        path: path.join(__dirname, './dist'),
        filename: '[name].js',
        publicPath: '/dist/'
    },
    devServer: {
        historyApiFallback: true,
        hot: false,
        inline: true,
        grogress: true,
    },
    module: {
        loaders: [
            { test: /\.vue$/, loader: 'vue' },
            { test: /\.js$/, loader: 'babel', exclude: /node_modules/ },
            { test: /\.css$/, loader: 'style!css!autoprefixer'},
            { test: /\.scss$/, loader: 'style!css!sass?sourceMap'},
            { test: /\.(png|jpg|gif)$/, loader: 'url-loader?limit=8192'},
            { test: /\.(html|tpl)$/, loader: 'html-loader' },
        ]
    },
    vue: {
        loaders: {
            css: 'style!css!autoprefixer',
        }
    },
    babel: {
        presets: ['es2015'],
        plugins: ['transform-runtime']
    },
    resolve: {
        extensions: ['', '.js', '.vue'],
        alias: {
            filter: path.join(__dirname, './src/filters'),
            components: path.join(__dirname, './src/components')
        }
    },
    devtool: 'eval-source-map'
    };

请详细查看这里面的设置,我这里都是很简单的配置,在你的项目中,还可以更进一步的对于入口文件和输出文件进行更加深入的定制。(注意:好像node-sass的包有问题,有很多人解析不了sass

并且在这里生成的css文件还会插到js中,有时我们需要更进一步的把它独立出来,然后在html中引入这时就会用到webpack的插件,在这里先不说(因为我暂时没用到,没有试验过,好像也不麻烦,可以的话下篇再试试)

第四步:编写代码

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

index.html:




    
    webpack vue
            #app {            margin: 20px auto;            width: 800px;            height: 600px;        }
    
    

这里是main.js的内容:


import Vue from "../node_modules/vue/dist/vue.min.js";
import app from './components/app';
Vue.config.debug = true;
new Vue(app);

这里是app.vue:



    

姓名:{{name}}

{{age}}

/*一定要加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; } }

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

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

注意点一: 首先我们看到package.jsonscripts字段中的"start": "webpack-dev-server --inline"。这里如果按照网上的方法在后面再添加上--hot的话,只会对于app.vue中的</code>标签内的css起效果。</p> <p><strong>注意点二:</strong> 因为我们没有加<code>--hot</code>,所以在<code>webpack.cofig.js</code>中需要对于<code>devServer</code>进行一些配置,如下:(主要是是<code>hot</code>设置为了false)。</p> <pre><code>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包安装没有错误的话,应该就能成功了。

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