Vue前端工程化-Vue单文件组件

67 阅读4分钟

1. 传统组件的问题和解决方案

问题:

  1. 字符串模板缺乏语法高亮,在 HTML 有多行的时候,需要用到丑陋的 \
  2. 不支持 CSS 意味着当 HTML 和 JavaScript 组件化时,CSS 明显被遗漏
  3. 没有构建步骤限制,只能使用 HTML 和 ES5 JavaScript,而不能使用预处理器(如:Babel)

解决方案: 针对传统组件的问题,Vue 提供了一个解决方案 —— 使用 Vue 单文件组件。

2. Vue 单文件组件的基本结构

单文件组件的组成结构:

  • template 组件的模板区域
  • script 业务逻辑区域
  • style 样式区域
<template> <!-- 组件的模板区域 -->
</template>

<script> // 业务逻辑区域
  export default { // 默认导出
    data: () { return {} }, // 私有数据
    methods: {} // 处理函数 
    // ... 其它业务逻辑 
  } 
</script>

<style scoped> /* 样式区域 */
  /* 尽量都添加scoped指令,防止组件样式的冲突 * /
</style>

3. webpack 中配置 vue 组件的加载器

在index.js文件中书写如下代码,导入vue单文件组件:

// 导入单文件组件
import App from './components/App.vue'

因为webpack默认解析不了.vue文件,我们在运行npm run dev会报错解析不了.vue文件,所以我们需要配置loader进行解析和转换,如下:

  1. 运行 npm i vue-loader vue-template-compiler -D 命令,其中 vue-template-compilervue-loader 的内置依赖项(在 vue3 中,使用@vue/compiler-sfc代替了vue-template-compiler)。
  2. 在 webpack.config.js 配置文件中,添加 vue-loader 的配置项如下:
const VueLoaderPlugin = require('vue-loader/lib/plugin')
module.exports = {
  module: {
    rules: [
      // ... 其它规则
      { test: /\.vue$/, loader: 'vue-loader' }
    ]
  },
  plugins: [
    // ... 其它插件
    new VueLoaderPlugin() // 请确保引入这个插件!
  ]
}

然后重新执行 npm run dev 即可正常运行项目。

4. 在 webpack 项目中使用 vue

  1. 运行 npm i vue –S 安装 vue
  2. 在 src -> index.js 入口文件中,通过 import Vue from 'vue' 来导入 vue 构造函数
  3. 创建 vue 的实例对象,并指定要控制的 el 区域
  4. 通过 render 函数渲染 App 根组件
// index.js文件代码:

// 1. 导入 Vue 构造函数 
import Vue from 'vue' 
// 2. 导入 App 根组件 
import App from './components/App.vue'

const vm = new Vue({ 
  // 3. 指定 vm 实例要控制的页面区域 
  el: '#app', 
  // 4. 通过 render 函数,把指定的组件渲染到 el 区域中 
  render: h => h(App) 
})

// 注意:在 webpack 项目中使用 vue,导入的Vue并不是最全的Vue,而是阉割版的Vue,只支持使用render渲染组件,就不要使用component或者template了。

执行 npm run dev 运行项目,可以发现,在index.html中,将来要被 vue 控制的区域(也就是<div id="app"></div>),会被App.vue渲染之后的内容给占据。

疑问: 这里项目运行成功之后,报错:[Vue warn]: Cannot find element: #app,但是实际 #app 这个 div 可以正常显示,不知道为什么报错,如下图:

待解答:

5. 为什么有两个id="app"

为什么 index.html 中的 id="app",与 App.vue 中的 id="app" 不会冲突?

  1. 已检查过生成的页面代码,只有一个<div id="app"></div>,下面有一行注释 <-- built files will be auto injected —> ,所以可以判断,此段来自 index.html,所以el:'#app'绑定的是index.html中的id="app"的元素
  2. 由于Vue组件必须有个根元素,所以App.vue里面,根元素<div id="app"></div>与外层被注入框架index.html中的<div id="app"></div>是一致的,两者在运行时指的是同一个DOM元素。
  3. index.html中的<div id="app"></div>是指定绑定元素根路径的,App.vue<div id="app"></div>则是用于具体注入绑定元素的内容,他们作用不一样。

6. webpack 打包发布

上线之前需要通过webpack将应用进行整体打包,可以通过 package.json 文件配置打包命令:

// 在package.json文件中配置 webpack 打包命令
"scripts": {
     // 用于打包的命令 该命令默认加载项目根目录中的 webpack.config.js 配置文件(比如会读取入口文件是谁,出口文件是谁,对应了哪些规则等等)
    "build": "webpack -p",
     // 用于开发调试的命令
    "dev": "webpack-dev-server --open --host 127.0.0.1 --port 3000",
},

开发调试我们使用的指令是 npm run dev ,打包发布使用的指令是 npm run build (执行命令之后,就会默认加载项目根目录中的 webpack.config.js 配置文件,比如会读取入口文件是谁,出口文件是谁,对应了哪些规则等等)。

为了使项目更干净,在打包之前可以先把dist文件夹给删掉,因为执行 npm run build 指令还会生成dist文件夹,里面有以前我们生成的index.html和bundle.js文件,右键浏览器打开index.html文件也可以看到项目运行效果。打包完成之后,我们就可以把dist文件夹交给服务端让他们发布了。

这里只是初步简单的webpack打包发布,目的是体验一下,真正的webpac打包发布比这个复杂多了,以后再学习,体验代码地址:github.com/iamkata/web…