本篇Codelab使用常用组件、页面路由router实现购物应用,包含以下功能:
- 使用toolbar、toolbar-item组件实现“首页”,“新品”,“购物车”,“我的”页面切换。
- 使用list组件,展示购物车里的商品。
- 使用swiper组件,实现图片自动轮播。
- 使用panel组件,展示商品规格。
- 使用自定义组件,提高代码的可读性。
相关概念
- swiper:滑动容器,提供切换子组件显示的能力。
- input:交互式组件,包括单选框,多选框,按钮和单行文本输入框。
- search:搜索框组件,用于提供用户搜索内容的输入区域。
- toolbar:工具栏。放在界面底部,用于展示针对当前界面的操作选项。
- toolbar-item:工具栏toolbar子组件。 用于展示工具栏上的一个操作选项。
- 自定义组件:自定义组件是用户根据业务需求,将已有的组件组合,封装成的新组件,可以在工程中多次调用,从而提高代码的可读性。
环境搭建
软件要求
- DevEco Studio版本:DevEco Studio 3.1 Release及以上版本。
- OpenHarmony SDK版本:API version 9及以上版本。
硬件要求
- 开发板类型:润和RK3568开发板。
- OpenHarmony系统:3.2 Release及以上版本。
环境搭建
完成本篇Codelab我们首先要完成开发环境的搭建,本示例以RK3568开发板为例,参照以下步骤进行:
-
获取OpenHarmony系统版本:标准系统解决方案(二进制)。以3.2 Release版本为例:
-
搭建烧录环境。
-
搭建开发环境。
代码结构解读
本篇Codelab只对核心代码进行讲解,对于完整代码,我们会在gitee中提供。由于本篇Codelab页面较多,因此component和pages目录下只展示“购物主页面”的hml、js、css。
├──entry/src/main/js // 代码区
│ └──MainAbility
│ ├──common
│ │ ├──constant
│ │ │ └──commonConstants.js // 公共常量类
│ │ └──images // 图片区
│ ├──component
│ │ ├──backComponent // 后退子组件
│ │ ├──commonButton // 支付按钮子组件
│ │ ├──commonToolbar // 导航栏子组件
│ │ ├──home // 购物主页子组件
│ │ ├──likedCards // 猜你喜欢卡片子组件
│ │ ├──myInfo // 我的子组件
│ │ ├──newProduct // 新品子组件
│ │ ├──orderReusableCom // 用户商品信息子组件
│ │ ├──productBuyInfo // 购买商品卡片子组件
│ │ ├──shoppingCart // 购物车子组件
│ │ └──subtitle // 副标题子组件
│ ├──i18n
│ │ ├──en-US.json // 英文国际化
│ │ └──zh-CN.json // 中文国际化
│ ├──pages
│ │ ├──allOrders // 全部订单页
│ │ ├──homePage // 购物主页
│ │ │ ├──homePage.css // 购物主页面样式
│ │ │ ├──homePage.hml // 购物主页面
│ │ │ └──homePage.js // 购物主页面逻辑
│ │ ├──launchPage // 启动页
│ │ ├──pendingPayment // 待支付页
│ │ ├──productDetails // 产品详情页
│ │ └──sureOrder // 确定订单页
│ └──app.js // 程序入口
└──entry/src/main/resources // 应用资源目录
构建购物应用首页
本篇Codelab选取购物应用的主页面、购物车页面、以及导航栏进行详细的讲解,对于完整代码,可在gitee源码中进行查看。
购物应用的主页面主要由界面底部导航栏和导航栏上的内容组成。效果如图所示:
<!-- homePage.hml -->
<element name="home" src="../../component/home/home.hml"></element>
<element name="new-product" src="../../component/newProduct/newProduct.hml"></element>
<element name="shopping-cart" src="../../component/shoppingCart/shoppingCart.hml"></element>
<element name="my-info" src="../../component/myInfo/myInfo.hml"></element>
<element name="common-toolbar" src="../../component/commonToolbar/commonToolbar.hml"></element>
<div class="container">
<!-- 主页面 -->
<home if="{{ tag === homePageIndex }}"></home>
<!-- 新品页面 -->
<new-product if="{{ tag === newProductIndex }}"></new-product>
<!-- 购物车页面 -->
<shopping-cart if="{{ tag === shoppingCartIndex }}"></shopping-cart>
<!-- 我的页面 -->
<my-info if="{{ tag === myInfoIndex }}"></my-info>
<!-- 导航栏 -->
<common-toolbar tag="{{ tag }}" @switch-toolbar="switchToolbar"></common-toolbar>
</div>
底部导航栏:由“主页”、“新品”、“购物车”以及“我的”页面组成,点击导航栏内容,展示所点击模块的内容。
// homePage.js
import CommonConstants from '../../common/constant/commonConstants';
export default {
data: {
// 页面默认展示主页,tag是主页面的索引
tag: 1,
// 主页面索引
homePageIndex: CommonConstants.HOME_PAGE_INDEX,
// 新品页面索引
newProductIndex: CommonConstants.NEW_PRODUCT_INDEX,
// 购物车页面索引
shoppingCartIndex: CommonConstants.SHOPPING_CART_INDEX,
// 我的页面索引
myInfoIndex: CommonConstants.MY_INFO_INDEX
},
/**
* 切换导航栏内容
*
* @param value 子组件传过来的索引
*/
switchToolbar(value) {
this.tag = value.detail.index;
}
}
子组件:导航栏的使用
导航栏由“主页”、“新品”、“购物车”以及“我的”组成,点击导航栏对应的子组件,页面会展示对应模块的内容。效果如图所示:
在父组件homePage.hml中使用@switch-toolbar="switchToolbar"绑定子组件的事件,用于接收子组件传过来的索引,通过if判断,从而展示索引对应的页面。
<!-- homePage.hml -->
...
<div class="container">
<!-- 主页面 -->
<home if="{{ tag === homePageIndex }}"></home>
<!-- 新品页面 -->
<new-product if="{{ tag === newProductIndex }}"></new-product>
<!-- 购物车页面 -->
<shopping-cart if="{{ tag === shoppingCartIndex }}"></shopping-cart>
<!-- 我的页面 -->
<my-info if="{{ tag === myInfoIndex }}"></my-info>
<!-- 导航栏 -->
<common-toolbar tag="{{ tag }}" @switch-toolbar="switchToolbar"></common-toolbar>
</div>
<!-- commonToolbar.hml -->
<div class="container">
<toolbar class="toolbar">
<toolbar-item value="{{ $t(toolbarName.home) }}" @click="switchToolbar(homePageIndex)"
icon="{{ tag === homePageIndex ? commonIcon.home : commonIcon.homeDisable }}">
</toolbar-item>
<toolbar-item value="{{ $t(toolbarName.newProduct) }}" @click="switchToolbar(newProductIndex)"
icon="{{ tag === newProductIndex ? commonIcon.newProduct : commonIcon.newProductDisable }}">
</toolbar-item>
<toolbar-item value="{{ $t(toolbarName.shoppingCart) }}" @click="switchToolbar(shoppingCartIndex)"
icon="{{ tag === shoppingCartIndex ? commonIcon.shoppingCart : commonIcon.shoppingCartDisable }}">
</toolbar-item>
<toolbar-item value="{{ $t(toolbarName.me) }}" @click="switchToolbar(myInfoIndex)"
icon="{{ tag === myInfoIndex ? commonIcon.me : commonIcon.meDisable }}">
</toolbar-item>
</toolbar>
</div>
在子组件commonToolbar.js中通过this.$emit('switchToolbar', {info: value})触发事件并向上传递参数,homePage.js中的switchToolbar方法接收子组件传过来的索引。在子组件commonToolbar.js文件中定义props,props用于组件之间的数据通信,当父组件中的tag发生变化的时候,子组件也会随之响应,然后改变toolbar-item中icon的颜色。
// homePage.js
import CommonConstants from '../../common/constant/commonConstants';
export default {
data: {
// 页面默认展示主页,tag是主页面的索引
tag: 1,
...
},
/**
* 切换导航栏内容
*
* @param value 子组件传过来的索引
*/
switchToolbar(value) {
this.tag = value.detail.index;
}
}
// commonToolbar.js
import CommonConstants from '../../common/constant/commonConstants';
export default {
props: ['tag'],
data: {
commonIcon: CommonConstants.COMMON_TOOLBAR_ICON,
toolbarName: CommonConstants.COMMON_TOOLBAR_NAME,
// 主页面索引
homePageIndex: CommonConstants.HOME_PAGE_INDEX,
// 新品页面索引
newProductIndex: CommonConstants.NEW_PRODUCT_INDEX,
// 购物车页面索引
shoppingCartIndex: CommonConstants.SHOPPING_CART_INDEX,
// 我的页面索引
myInfoIndex: CommonConstants.MY_INFO_INDEX
},
/**
* 向父组件传值
*
* @param index 选中子模块的索引
*/
switchToolbar(index) {
this.$emit('switchToolbar', {
index: index
});
}
}
构建购物车页面
购物车页面由顶部标题栏、购物车商品列表、猜你喜欢的商品列表三部分组成,并以子组件的形式显示在主页面中。其中,购物车商品列表使用list组件和for循环,实现对多条商品数据进行展示。猜你喜欢的商品列表是通过引用自定义组件实现的。效果如图所示:
<!-- shoppingCart.hml -->
<element name="liked-cards" src="../../component/likedCards/likedCards.hml"></element>
<div class="container">
<div class="top">
<!-- 顶部导航标题栏 -->
<div class="top-title">
<text class="shopping-cart">{{ $t('strings.shopping_cart') }}</text>
<text class="edit">{{ $t('strings.edit') }}</text>
</div>
<!-- 购物车商品列表 -->
<div class="top-list">
<div class="list-title">
<input class="all-checkbox" type="checkbox" checked="{{ isAllSelect }}" @change="checkboxOnChange">
</input>
<image class="my-icon-size" src="{{ person }}"></image>
<text class="mall-self-operated">{{ $t('strings.mall_self_operated') }}</text>
</div>
<list class="list">
<list-item for="{{ (index, item) in shoppingListData }}" class="list-item">
<div class="list-content">
<input class="checkbox" type="checkbox" checked="{{ item.isSelect }}"></input>
<image class="product-pictures" src="{{ item.image }}"></image>
<div class="box-content">
<text class="product-title">{{ $t(item.title) }}</text>
<text class="product-subtitle">{{ $t(item.subtitle) }}</text>
<div class="content-price">
<text class="product-price">{{ item.price }}</text>
<div class="price-num">
<image class="my-icon-size" @click="subtractNum(index)" src="{{ item.num === 0 ?
commonIcon.decreaseDisableIcon : commonIcon.decreaseIcon }}">
</image>
<text class="product-num">{{ item.num }}</text>
<image class="my-icon-size" src="{{ commonIcon.increaseIcon }}"
@click="addNum(index)">
</image>
</div>
</div>
</div>
</div>
</list-item>
</list>
</div>
</div>
<!-- 猜你喜欢商品列表 -->
<div class="middle-card">
<liked-cards></liked-cards>
</div>
</div>
- 点击“商品自营”头像前的多选框,会触发checkboxOnChange()方法,页面会勾选/不勾选购物车的中所有商品。
- 点击“+”按钮会触发addNum()方法,增加单件商品的数量。
- 点击“-”按钮会触发subtractNum()方法,减少单件商品的数量。
// shoppingCart.js
import CommonConstants from '../../common/constant/commonConstants';
export default {
data: {
isAllSelect: false,
shoppingListData: CommonConstants.SHOPPING_LIST_DATA,
commonIcon: CommonConstants.SHOPPING_CART_ICON,
person: CommonConstants.COMMON_ICON.person
},
/**
* 购物车商品全选/非全选
*/
checkboxOnChange() {
this.isAllSelect = !this.isAllSelect;
this.shoppingListData.filter((item) => {
item.isSelect = this.isAllSelect;
});
},
/**
* 勾选单个商品
*
* @param subscript 选中商品的索引
* @param event 单选框事件
*/
singleAnswer(subscript, event) {
// 修改商品的选择状态
this.shoppingListData.forEach((item, index) => {
if (index === subscript) {
item.isSelect = event.checked;
}
})
// 检查购物车中的所有商品是否都被选中
let selectAll = this.shoppingListData.every(item => item.isSelect === true);
if (selectAll === true) {
this.isAllSelect = true;
} else {
this.isAllSelect = false;
}
},
/**
* 减少商品数量逻辑
*
* @param value 当前商品的数量
*/
subtractNum(value) {
if (this.shoppingListData[value].num > 0) {
this.shoppingListData[value].num--;
}
},
/**
* 增加商品数量逻辑
*
* @param value 当前商品的数量
*/
addNum(value) {
this.shoppingListData[value].num++;
}
}
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员,可以直接领取这份资料
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。