灵活使用vue单文件组件之--最少配置打包.vue组件

时间 2019-11-06

标签灵活使用 vue 文件组件最少配置打包繁體版

原文原文链接

对于vue单文件组件的使用，咱们知道使用vue-cli能够快速生成项目结构，进行.vue单文件组件的编写，使用 npm run build命令会从main.js开始打包项目中的依赖(一般main.js中引用App.vue，做为页面最高层级的组件，咱们本身写的组件会在App.vue中引用)，build的结果会生成打包好的静态js/css文件以及index.html，这对于写单页应用来讲很是方便，可是，变化的需求老是不少的~css

若是我只想在html页面里用到我写的vue组件（同时我的也更加偏向使用html页面的写法），而不是构建一整个单页应用，在vue-cli里能够吗？？？固然能够作到，了解其中的配置，修改为本身想要的样子，咱们能够作到只打包一个组件的效果。html

可是，面对辣么多的配置文件，仍是从0开始本身来吧，毕竟我只想打包一个.vue组件。在正式开始写示例代码以前，为了文章的完整性，先简单介绍一下几个工具。vue

webpack

webpack是干吗的？他是一个模块打包器，他的目标就是将JavaScript文件都打包到一块儿，用于在浏览器中使用，便可以经过<script>标签加载。
换句话说，webpack其实只认识js文件，那咱们其余类型的文件怎么办？这里就要用到loader，loader 能够将文件从不一样的语言（如 TypeScript）转换为 JavaScript，能够用来处理图片、转换sass/less为纯css等，一句话，就是用于文件或资源被webpack加载打包前的预处理。webpack

这里想一下咱们的需求，咱们想要打包一个vue组件，使用webpack，根据上面的说明，不难想到还应该须要一个loader能够用来识别并转换.vue文件，so：web

vue-loader

一句话，就是把按下面格式的编写的vue组件转换为js模块。至于转换后会成为何，下面会说到。end。vue-cli

<template></template>
<script></script>
<style></style>

如今正式开始

先创建一个文件夹：testproject;
命令行进入到testproject ,运行 npm init,根据命令行提示，进行项目的一些初始化操做;

完成以后，咱们的项目中就会有package.json文件，打开package.json，配置打包须要的一些dependence，这里我就是从一个vue-cli项目的package.json文件中拷过来一些基本的依赖，以下：
其中dependencies里就是拷过来依赖的部分npm

{
  "name": "webpacktest",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "lodash": "^4.17.4",
    "css-loader": "^0.28.0",
    "url-loader": "^0.5.8",
    "vue-loader": "^13.3.0",
    "vue-style-loader": "^3.0.1",
    "vue-template-compiler": "^2.5.2",
    "babel-core": "^6.22.1",
    "babel-loader": "^7.1.1",
    "babel-preset-env": "^1.3.2",
    "babel-preset-stage-2": "^6.22.0",
    "babel-register": "^6.22.0",
    "file-loader": "^1.1.4"
  }
}

运行 npm install,稍等片刻，咱们须要的模块就ok了。
这里说明一下，npm包之间也存在依赖关系，若是存在有‘依赖的依赖’ 你没有写到配置的dependencies中，命令行会有提示，注意看。为何说这个，由于我在拷贝依赖的时候，就略过了‘file-loader’，
so sad.^_^json

如今能够写咱们的示例内容了，这里咱们设定咱们要写的组件为hello.vue，组件打包后的名字叫hellobundle.js,咱们在sayhello.html中要引用的组件就是打包后的hellobundle.js，直接在testproject目录下新建相关文件，内容以下：浏览器

<!--sayhello.html-->
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
  <script src="https://cdn.jsdelivr.net/npm/vue"></script>
  <script src="./hellobundle.js"></script>
</head>
<body>
<div id="app">
  <hello></hello>
</div>
<script>
  var vm=new Vue({
    el:'#app',
    components:{
      hello:hello.default    //这里咱们后面会解释为何这样写
    }
  })
</script>
</body>
</html>

<!--hello.vue-->
<template>
  <h1>{{text}}</h1>
</template>
<script>
  export default{
    name:'hello',
    data:function() {
      return  {
        text:'hello~~~'
      }
    }
  }
</script>
<style>
  h1{
    color: #ffb93f;
  }
</style>

很简单的内容，如今咱们想要打包hello.vue这个组件，对于打包咱们选择使用script命令+webpack.config.js的方式（这里不了解能够移至webpack官方指南，说明很详细），仍是在根目录，新建webpack.config.js文件，内容以下：sass

//webpack.config.js
const path = require('path')
module.exports = {
  entry  : './hello.vue',             //入口文件
  output : {
    filename : 'hellobundle.js',     //出口文件名
    path     : path.resolve(__dirname),    //当前目录
    library  : 'hello'       // 打包后模块的名称
  },
  module : {     
    rules : [    //定义不一样类型的文件使用的loader
      {
        test   : /\.vue$/,
        loader : 'vue-loader'
      },
      {
        test   : /\.js$/,
        loader : 'babel-loader'
      }
    ]
  }
}

这里差很少是最简化的配置，hello.vue做为咱们打包的入口文件，配置出口文件的名称、路径以及最终模块对外的名称，写好了这个，再在package.json中加上一条script命令，以下：

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build":"webpack"     //<-------就四这行，，
  },

写好了.vue组件文件、webpack的配置文件，如今咱们运行npm run build, 结果以下：

在testproject目录下，咱们也如愿获得了hello.vue打包后的hellobundle.js，整个testproject结果以下

终于，咱们能够来验证这个打包后的hellobundle.js是否可用了，在浏览器打开sayhello.html:

ofcourse you can see yellow hello,,这里说一下咱们的sayhello页面中，注册组件时用到的是：
components:{

hello:hello.default    //这里咱们后面会解释为何这样写
}

其实在一开始的时候，我用的是webpack配置的hello变量，而后打开sayhello页面时并无出现预期的效果，因而在控制台打印了一下咱们hellobundle.js输出的hello变量：

so,就更正了一下hello的引用。

结语

本着最简原则，示例中的项目结构没有按照src/dist这样规范的目录结构来写，写到这一步以后，咱们能够继续深刻完善咱们的打包功能，对webpack使用命令行参数动态打包文件、hot-reloading等，这样的话，就又复杂了，再也不赘述。--end 欢迎指正^_^