进击中的Vue 3——“新能源车电池范围计算器”开源项目

骑猪看日落 2023-01-17 12:00 208阅读 0赞

> 转载请注明出处：葡萄城官网，葡萄城为开发者提供专业的开发工具、解决方案和服务，赋能开发者。

今天，我们给大家带来的是一个基于vue3的开源项目：新能源车电池范围计算器。这是一个workshop，通过完成该项目，我们可以直观的感受到vue3的强大，了解一些项目最佳实践。

项目的背景是当前备受关注的电动车。经历了近6年的发展，新能源车在市场上得到大规模普及，从“大玩具”变为未来交通的基石。项目以新能源车行业最受关注的续航能力为例，使用vue3技术构建一个电池范围计算器，来展示用Vue.js制作仪表盘的开发方式和体验。

# 环境准备 #

在开始阅读本教程之前，我们需要做以下准备，搭建好项目环境：

1.  安装稳定的Node.js版本8.9或者更高版本（https：// nodejs.org/en/download/）
2.  安装Yarn (https://yarnpkg.com)
3.  克隆此Github存储库https://github.com/petereijgermans11/workshop-reactjs-vuejs

环境准备完毕，我们可以读取README.md了解项目的概况。

与常见的开发项目不同，这个项目最有意思的地方在于，它不是一个最终的应用程序，而是一个存在缺陷的应用程序，即workshop。我们需要对它进行修复完善并进一步开发，并在这个过程中掌握vue开发技巧。

在正式开始工作之前，让我们先一起来了解一下这个项目的结构。

# 项目结构介绍 #

workshop-reactjs-vuejs/vuejs-app/src是workshop的源码目录，结构如下图所示。main.js是应用程序的入口点，App.vue是应用程序的输入组件。

![1.png][]  
（项目源代码结构）

## 项目入口 ##

相比于vue2，Vue3应用程序的创建方式已更改，需要导入新的createApp（）方法，而不是使用new Vue（），然后调用这个方法来传递App.vue组件（入口组件）。

紧接着我们将在createApp上调用mount方法，并传递一个CSS选择器标识mount元素，这个过程和在Vue 2中操作$ mount示例方法一样

![2.png][]

（项目入口）

## App.vue组件详解 ##

![3.png][]  
（app.vue组件）

App.vue是应用程序的入口组件，由以下部分组成。

**1. 脚本**  
在上图中，name property 表示组件的名称（名称为“ app”）。该组件使用的子组件在中定义components-property。在这里，TeslaBattery是App.vue组件的子组件，后面会介绍到。要使用TeslaBattery组件，必须首先将其导入（import Tesla-Battery from “…” ）

在中data()-function，我们可以定义和初始化状态变量，例如导入的徽标和greeting属性。要呈现徽标和问候语，必须在模板中定义它们。最终必须（通过export default \{ \} ）导出整个组件，以便可以将其再次导入到其他组件和main.js中。  
**2. 模板**  
模板负责定义组件生成的输出。Vue.js 使用基于HTML的模板语法可以使数据通过data ()-function进行绑定并轻松呈现。数据绑定的最简单形式是使用Mustache语法（双括号）的文本插值：\{ \{greeting\}\}

在上面的示例中，\{ \{greeting\}\} 替换Hello Tesla !!! 成为和data()-function相关的值。在此问候语上方，用img-tag来呈现徽标。要将徽标分配给img src-attribute，用属性进行绑定。在此应用程序中经常使用属性绑定，可以使用： v-bind <img :src=“logo” 进行绑定

最后，使用-tag来实例化TeslaBattery组件并进行渲染。对于此标签必须使用Kebab case，这一部分我们会在后面详细讨论  
**3. 样式**  
在Vue中，我们使用SCSS文件对整个应用进行样式设置，这里不展开介绍。

# Container vs Presentation组件 #

介绍完基础的项目架构，我们来看项目的UI部分是怎么运行的。该应用程序包含一个入口应用程序组件，该组件包含一个子组件TeslaBattery。TeslaBattery子组件包含以下二级子组件：

\-TeslaCar：使用车轮动画渲染TeslaCar图像。  
\-TeslaStats：用于渲染每个Tesla模型的最大电池范围。涉及以下型号：60、60D，75、75D，90D和P100D。  
\-TeslaCounter：手动控制速度和外部温度。

*  TeslaClimate：当外部温度超过20度时，将供暖改为空调。
 *  TeslaWheels：手动将车轮尺寸从19英寸调整为20英寸。

这些组件最终构成了用户看到的仪表盘。

![4.png][]  
（最终展示的仪表盘）

以下代码块清晰的显示了组件的层级关系，项目中同时用到了Container组件和Presentation组件。“ Tesla电池组件”是容器组件。基础子组件是Presentation组件。这样可将组件分为两类，有利于我们在开发过程中重复使用。

![5.png][]  
（组件层级）

两种组件的特点对比如下：

Container组件  
\-可以同时包含表示和容器组件。  
\-通过“道具”创建数据并将数据传输到子组件。  
\-基于传入事件执行逻辑。  
\-进行状态管理，并知道进行组件渲染的时间。  
\-具有状态属性，并倾向于充当数据源。

Presentation组件  
\-演示组件也称为“哑组件”，用户界面是其重点部分。  
\-TeslaCar是一个哑组件，可确保渲染TeslaCar图像。  
\-通过“ props”接收数据，并通过事件将数据返回给父组件。  
\-通常没有状态，也不依赖于其余的应用程序。

![6.png][]

（组件树）

此划分方法具有以下优点，值得推荐。  
\-重用性高  
\-哑组件更易于测试：仅接收“道具”，发出事件并返回一部分UI  
\-可读性高：代码少且组织清晰，容易理解和进行调整  
\-内容提供一致并防止了代码重复

# 通过Props将数据传递给子组件 #

在下图中可以看出，我们使用props，将stats-data（源自stats（）函数）从TeslaBattery组件传递到TeslaStats组件，链接起上下级组件。

![7.png][]

（使用props传递数据）

具体操作上，你需要在TeslaBattery组件模板中使用v-bind或冒号操作符。

![7.1.png][]

（传递stats数据）

该组件在脚本部分包含一个props-property，用于接收stats-data。该属性的数据类型为数组。在本例中，我们使用来自Vue.js的v-for指令来遍历统计信息，按照特定顺序进行展示。

我们可以在filters-property中定义自定义过滤器。例如，过滤器“lowercase”，可以用小写呈现模型名。在项目中，我们自定义了一个过滤器，把英里转换为公里。

# 代替filters-property的Composition API #

在Vue 3中，我们无法再使用filters-property。为了开发“把英里转换为公里”的过滤器，我们需要使用Compostion API。Compostion API是基于函数的API，通常用于组合与重用各组件的逻辑。

首先，我们需要创建一个JavaScript文件composable.js，export出我们需要使用的数据和方法如，“把英里转换为公里”的过滤器。

![8.png][]

（封装过滤器的代码）

然后，我们将composable.js导入到需要使用该过滤器的组件中，就可以在其中使用这些过滤器了。

![图片9.png][9.png]

（导入并启用过滤器的代码）

# 使用v-model实现双向数据绑定 #

在Vue3中，我们可以使用各组件的模板中的v-model指令实现双向数据绑定。

在这个项目中， TeslaCounter组件需要将速度（speed）绑定到TeslaBattery组件。

![图片10.png][10.png]

（组件间的双向数据绑定）

我们在TeslaBattery组件模板中使用v-model指令将speed属性（车速）绑定到TeslaCounter组件。

![图片11.png][11.png]

（使用v-model传递数据的代码）

作为接收组件，TeslaCounter则需要在props中接受modelValue属性。此外，还需要emit出@update:modelValue事件，用于通知数据变更。emit操作在increment()方法中触发，在速度发生变化时，将最新的数据“推送”给其绑定的TeslaBattery组件。

![图片12.png][12.png]

（emit事件通知的代码）

# 总结 #

以上就是开源项目新能源车电池范围计算器中源代码的核心介绍，项目中还有更多优秀的实践值得大家学习和参考。

除此之外，项目中还添加了一个PPT文件，详细说明了诸如通过v-model指令进行双向数据绑定、使用按钮向事件分配事件以及创建其他组件之类的做法。

后续我们还会为大家推荐更多有意思的开源项目，一起了解vue等前端技术的发展与实战。

# 阅读拓展： #

如果您已经很熟悉 Vue3 的用法，想要了解其他 Vue3 项目实例，这里可以[阅读此文][Link 1],了解关于 Vuede 全新脚手架工具：Vite 。Vite 是一个由原生 ESM 驱动的 Web 开发构建工具。在开发环境下基于浏览器原生 ES imports 开发，在生产环境下基于 Rollup 打包。

[1.png]: /images/20221021/29e8b7fe73f641bfb6086c53af13b558.png
[2.png]: /images/20221021/838d8ef5e6234058a8680488a6d822b1.png
[3.png]: /images/20221021/0c403c208fee402eb86b21cae0f22fe2.png
[4.png]: /images/20221021/388cab5c204f4e21864935eeb3be9576.png
[5.png]: /images/20221021/9180f33709f24ebbb3a75b146bd9d86e.png
[6.png]: /images/20221021/94edcca83d6645cebef45a4230b75946.png
[7.png]: /images/20221021/ee2c1c3e0cfe4c4f96f3d51283e1b1b3.png
[7.1.png]: /images/20221021/98da906e72f14c72973be851bd29a8b5.png
[8.png]: /images/20221021/8c782385cd9e40f3aa7df91ff4365673.png
[9.png]: /images/20221021/f76d6454dc754b009a9c7d038db7edeb.png
[10.png]: /images/20221021/8d10237536bf47b88eb71129a5c15b2b.png
[11.png]: /images/20221021/01e97cafadc949f4b65df69c1468b2fc.png
[12.png]: /images/20221021/1ac73b53e9e74497afff4cf3be939a8d.png
[Link 1]: https://www.grapecity.com.cn/blogs/spreadjs-vue3-component-development-combat-part1