进击中的Vue 3——“电动车电池范围计算器”开源项目
转载请注明出处:葡萄城官网,葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。
原文参考://dzone.com/articles/build-a-tesla-battery-range-calculator-yourself-it
今天,我们给大家带来的是一个基于vue3的开源项目:电动车电池范围计算器。这是一个workshop,通过完成该项目,我们可以直观的感受到vue3的强大,了解一些项目最佳实践。
项目的背景是当前备受关注的电动车。经历了近6年的发展,电动车在市场上得到大规模普及,从“大玩具”变为未来交通的基石。项目以电动车行业最受关注的续航能力为例,使用vue3技术构建一个电池范围计算器,来展示用Vue.js制作仪表盘的开发方式和体验。
环境准备
在开始阅读本教程之前,我们需要做以下准备,搭建好项目环境:
- 安装稳定的Node.js版本8.9或者更高版本(https:// nodejs.org/en/download/)
- 安装Yarn (//yarnpkg.com)
- 克隆此Github存储库//github.com/petereijgermans11/workshop-reactjs-vuejs
环境准备完毕,我们可以读取README.md了解项目的概况。
与常见的开发项目不同,这个项目最有意思的地方在于,它不是一个最终的应用程序,而是一个存在缺陷的应用程序,即workshop。我们需要对它进行修复完善并进一步开发,并在这个过程中掌握vue开发技巧。
在正式开始工作之前,让我们先一起来了解一下这个项目的结构。
项目结构介绍
workshop-reactjs-vuejs/vuejs-app/src是workshop的源码目录,结构如下图所示。main.js是应用程序的入口点,App.vue是应用程序的输入组件。
(项目源代码结构)
项目入口
相比于vue2,Vue3应用程序的创建方式已更改,需要导入新的createApp()方法,而不是使用new Vue(),然后调用这个方法来传递App.vue组件(入口组件)。
紧接着我们将在createApp上调用mount方法,并传递一个CSS选择器标识mount元素,这个过程和在Vue 2中操作$ mount示例方法一样
(项目入口)
App.vue组件详解
(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”<img v-bind:src=”logo”> 进行绑定
最后,使用<tesla battery>-tag来实例化TeslaBattery组件并进行渲染。对于此标签必须使用Kebab case,这一部分我们会在后面详细讨论
3. 样式
在Vue中,我们使用SCSS文件对整个应用进行样式设置,这里不展开介绍。
Container vs Presentation组件
介绍完基础的项目架构,我们来看项目的UI部分是怎么运行的。该应用程序包含一个入口应用程序组件,该组件包含一个子组件TeslaBattery。TeslaBattery子组件包含以下二级子组件:
l TeslaCar:使用车轮动画渲染TeslaCar图像。
l TeslaStats:用于渲染每个Tesla模型的最大电池范围。涉及以下型号:60、60D,75、75D,90D和P100D。
l TeslaCounter:手动控制速度和外部温度。
l TeslaClimate:当外部温度超过20度时,将供暖改为空调。
l TeslaWheels:手动将车轮尺寸从19英寸调整为20英寸。
这些组件最终构成了用户看到的仪表盘。
(最终展示的仪表盘)
以下代码块清晰的显示了组件的层级关系,项目中同时用到了Container组件和Presentation组件。“ Tesla电池组件”是容器组件。基础子组件是Presentation组件。这样可将组件分为两类,有利于我们在开发过程中重复使用。
(组件层级)
两种组件的特点对比如下:
Container组件
l 可以同时包含表示和容器组件。
l 通过“道具”创建数据并将数据传输到子组件。
l 基于传入事件执行逻辑。
l 进行状态管理,并知道进行组件渲染的时间。
l 具有状态属性,并倾向于充当数据源。
Presentation组件
l 演示组件也称为“哑组件”,用户界面是其重点部分。
l TeslaCar是一个哑组件,可确保渲染TeslaCar图像。
l 通过“ props”接收数据,并通过事件将数据返回给父组件。
l 通常没有状态,也不依赖于其余的应用程序。
(组件树)
此划分方法具有以下优点,值得推荐。
l 重用性高
l 哑组件更易于测试:仅接收“道具”,发出事件并返回一部分UI
l 可读性高:代码少且组织清晰,容易理解和进行调整
l 内容提供一致并防止了代码重复
通过Props将数据传递给子组件
在下图中可以看出,我们使用props,将stats-data(源自stats()函数)从TeslaBattery组件传递到TeslaStats组件,链接起上下级组件。
(使用props传递数据)
具体操作上,你需要在TeslaBattery组件模板中使用v-bind或冒号操作符。
(传递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出我们需要使用的数据和方法如,“把英里转换为公里”的过滤器。
(封装过滤器的代码)
然后,我们将composable.js导入到需要使用该过滤器的组件中,就可以在其中使用这些过滤器了。
(导入并启用过滤器的代码)
使用v-model实现双向数据绑定
在Vue3中,我们可以使用各组件的模板中的v-model指令实现双向数据绑定。
在这个项目中, TeslaCounter组件需要将速度(speed)绑定到TeslaBattery组件。
(组件间的双向数据绑定)
我们在TeslaBattery组件模板中使用v-model指令将speed属性(车速)绑定到TeslaCounter组件。
(使用v-model传递数据的代码)
作为接收组件,TeslaCounter则需要在props中接受modelValue属性。此外,还需要emit出@update:modelValue事件,用于通知数据变更。emit操作在increment()方法中触发,在速度发生变化时,将最新的数据“推送”给其绑定的TeslaBattery组件。
(emit事件通知的代码)
总结
以上就是开源项目电动车电池范围计算器中源代码的核心介绍,项目中还有更多优秀的实践值得大家学习和参考。
除此之外,项目中还添加了一个PPT文件,详细说明了诸如通过v-model指令进行双向数据绑定、使用按钮向事件分配事件以及创建其他组件之类的做法。
后续我们还会为大家推荐更多有意思的开源项目,一起了解vue等前端技术的发展与实战。