HarmonyOS开发案例：【购物APP】

介绍

本篇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版本为例：
  
  
  
  
• 搭建烧录环境。
  
  
  
  • [完成DevEco Device Tool的安装]
    
  • [完成RK3568开发板的烧录]
    
  
  
• 搭建开发环境。
  
  
  
  • 开始前请参考[工具准备]，完成DevEco Studio的安装和开发环境设置。
    
  • 开发环境设置完成后，请参考[使用工程向导]创建工程（模板选择“Empty Ability”）。
    
  • 工程创建完成后，选择使用[真机举行调测]。
    
  • 鸿蒙开发引导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
    
  
  

代码结构解读

本篇Codelab只对核心代码举行讲解，对于完备代码，我们会在【gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md】中提供。由于本篇Codelab页面较多，因此component和pages目录下只展示“购物主页面”的hml、js、css。

1. `HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`
3. ├──entry/src/main/js                     // 代码区
4. │  └──MainAbility
5. │     ├──common
6. │     │  ├──constant
7. │     │  │  └──commonConstants.js    // 公共常量类
8. │     │  └──images                   // 图片区
9. │     ├──component
10. │     │  ├──backComponent            // 后退子组件
11. │     │  ├──commonButton             // 支付按钮子组件
12. │     │  ├──commonToolbar            // 导航栏子组件
13. │     │  ├──home                     // 购物主页子组件
14. │     │  ├──likedCards               // 猜你喜欢卡片子组件
15. │     │  ├──myInfo                   // 我的子组件
16. │     │  ├──newProduct               // 新品子组件
17. │     │  ├──orderReusableCom         // 用户商品信息子组件
18. │     │  ├──productBuyInfo           // 购买商品卡片子组件
19. │     │  ├──shoppingCart             // 购物车子组件
20. │     │  └──subtitle                 // 副标题子组件
21. │     ├──i18n
22. │     │  ├──en-US.json               // 英文国际化                       
23. │     │  └──zh-CN.json               // 中文国际化       
24. │     ├──pages
25. │     │  ├──allOrders                // 全部订单页
26. │     │  ├──homePage                 // 购物主页
27. │     │  │  ├──homePage.css          // 购物主页面样式
28. │     │  │  ├──homePage.hml          // 购物主页面
29. │     │  │  └──homePage.js           // 购物主页面逻辑
30. │     │  ├──launchPage               // 启动页
31. │     │  ├──pendingPayment           // 待支付页
32. │     │  ├──productDetails           // 产品详情页
33. │     │  └──sureOrder                // 确定订单页
34. │     └──app.js                      // 程序入口
35. └──entry/src/main/resources          // 应用资源目录

复制代码

构建购物应用首页

本篇Codelab选取购物应用的主页面、购物车页面、以及导航栏举行详细的讲解，对于完备代码，可在gitee源码中举行查看。
购物应用的主页面主要由界面底部导航栏和导航栏上的内容组成。效果如图所示：

1. <!-- homePage.hml -->
2. <element name="home" src="../../component/home/home.hml"></element>
3. <element name="new-product" src="../../component/newProduct/newProduct.hml"></element>
4. <element name="shopping-cart" src="../../component/shoppingCart/shoppingCart.hml"></element>
5. <element name="my-info" src="../../component/myInfo/myInfo.hml"></element>
6. <element name="common-toolbar" src="../../component/commonToolbar/commonToolbar.hml"></element>
8. <div class="container">
9.     <!-- 主页面 -->
10.     <home if="{{ tag === homePageIndex }}"></home>
12.     <!-- 新品页面 -->
13.     <new-product if="{{ tag === newProductIndex }}"></new-product>
15.     <!-- 购物车页面 -->
16.     <shopping-cart if="{{ tag === shoppingCartIndex }}"></shopping-cart>
18.     <!-- 我的页面 -->
19.     <my-info if="{{ tag === myInfoIndex }}"></my-info>
21.     <!-- 导航栏 -->
22.     <common-toolbar tag="{{ tag }}" @switch-toolbar="switchToolbar"></common-toolbar>
23. </div>

复制代码

底部导航栏：由“主页”、“新品”、“购物车”以及“我的”页面组成，点击导航栏内容，展示所点击模块的内容。

1. // homePage.js
2. import CommonConstants from '../../common/constant/commonConstants';
4. export default {
5.   data: {
6.     // 页面默认展示主页，tag是主页面的索引
7.     tag: 1,
8.     // 主页面索引
9.     homePageIndex: CommonConstants.HOME_PAGE_INDEX,
10.     // 新品页面索引
11.     newProductIndex: CommonConstants.NEW_PRODUCT_INDEX,
12.     // 购物车页面索引
13.     shoppingCartIndex: CommonConstants.SHOPPING_CART_INDEX,
14.     // 我的页面索引
15.     myInfoIndex: CommonConstants.MY_INFO_INDEX
16.   },
18.   /**
19.    * 切换导航栏内容
20.    *
21.    * @param value 子组件传过来的索引
22.    */
23.   switchToolbar(value) {
24.     this.tag = value.detail.index;
25.   }
26. }

复制代码

子组件：导航栏的使用

导航栏由“主页”、“新品”、“购物车”以及“我的”组成，点击导航栏对应的子组件，页面会展示对应模块的内容。效果如图所示：

在父组件homePage.hml中使用@switch-toolbar="switchToolbar"绑定子组件的事件，用于接收子组件传过来的索引，通过if判定，从而展示索引对应的页面。

1. <!-- homePage.hml -->
2. ...
3. <div class="container">
4.     <!-- 主页面 -->
5.     <home if="{{ tag === homePageIndex }}"></home>
7.     <!-- 新品页面 -->
8.     <new-product if="{{ tag === newProductIndex }}"></new-product>
10.     <!-- 购物车页面 -->
11.     <shopping-cart if="{{ tag === shoppingCartIndex }}"></shopping-cart>
13.     <!-- 我的页面 -->
14.     <my-info if="{{ tag === myInfoIndex }}"></my-info>
16.     <!-- 导航栏 -->
17.     <common-toolbar tag="{{ tag }}" @switch-toolbar="switchToolbar"></common-toolbar>
18. </div>
20. <!-- commonToolbar.hml -->
21. <div class="container">
22.     <toolbar class="toolbar">
23.         <toolbar-item value="{{ $t(toolbarName.home) }}" @click="switchToolbar(homePageIndex)"
24.                       icon="{{ tag === homePageIndex ? commonIcon.home : commonIcon.homeDisable }}">
25.         </toolbar-item>
26.         <toolbar-item value="{{ $t(toolbarName.newProduct) }}" @click="switchToolbar(newProductIndex)"
27.                       icon="{{ tag === newProductIndex ? commonIcon.newProduct : commonIcon.newProductDisable }}">
28.         </toolbar-item>
29.         <toolbar-item value="{{ $t(toolbarName.shoppingCart) }}" @click="switchToolbar(shoppingCartIndex)"
30.                       icon="{{ tag === shoppingCartIndex ? commonIcon.shoppingCart : commonIcon.shoppingCartDisable }}">
31.         </toolbar-item>
32.         <toolbar-item value="{{ $t(toolbarName.me) }}" @click="switchToolbar(myInfoIndex)"
33.                       icon="{{ tag === myInfoIndex ? commonIcon.me : commonIcon.meDisable }}">
34.         </toolbar-item>
35.     </toolbar>
36. </div>

复制代码

在子组件commonToolbar.js中通过this.$emit(‘switchToolbar’, {info: value})触发事件并向上传递参数，homePage.js中的switchToolbar方法接收子组件传过来的索引。在子组件commonToolbar.js文件中定义props，props用于组件之间的数据通信，当父组件中的tag发生变革的时候，子组件也会随之相应，然后改变toolbar-item中icon的颜色。

1. // homePage.js
2. import CommonConstants from '../../common/constant/commonConstants';
4. export default {
5.   data: {
6.     // 页面默认展示主页，tag是主页面的索引
7.     tag: 1,
8.     ...
9.   },
11.   /**
12.    * 切换导航栏内容
13.    *
14.    * @param value 子组件传过来的索引
15.    */
16.   switchToolbar(value) {
17.     this.tag = value.detail.index;
18.   }
19. }
21. // commonToolbar.js
22. import CommonConstants from '../../common/constant/commonConstants';
24. export default {
25.   props: ['tag'],
26.   data: {
27.     commonIcon: CommonConstants.COMMON_TOOLBAR_ICON,
28.     toolbarName: CommonConstants.COMMON_TOOLBAR_NAME,
29.     // 主页面索引
30.     homePageIndex: CommonConstants.HOME_PAGE_INDEX,
31.     // 新品页面索引
32.     newProductIndex: CommonConstants.NEW_PRODUCT_INDEX,
33.     // 购物车页面索引
34.     shoppingCartIndex: CommonConstants.SHOPPING_CART_INDEX,
35.     // 我的页面索引
36.     myInfoIndex: CommonConstants.MY_INFO_INDEX
37.   },
39.   /**
40.    * 向父组件传值
41.    *
42.    * @param index 选中子模块的索引
43.    */
44.   switchToolbar(index) {
45.     this.$emit('switchToolbar', {
46.       index: index
47.     });
48.   }
49. }

复制代码

构建购物车页面

购物车页面由顶部标题栏、购物车商品列表、猜你喜好的商品列表三部分组成，并以子组件的形式显示在主页面中。其中，购物车商品列表使用list组件和for循环，实现对多条商品数据举行展示。猜你喜好的商品列表是通过引用自定义组件实现的。效果如图所示：

1. <!-- shoppingCart.hml -->
2. <element name="liked-cards" src="../../component/likedCards/likedCards.hml"></element>
4. <div class="container">
5.     <div class="top">
6.         <!-- 顶部导航标题栏 -->
7.         <div class="top-title">
8.             <text class="shopping-cart">{{ $t('strings.shopping_cart') }}</text>
9.             <text class="edit">{{ $t('strings.edit') }}</text>
10.         </div>
11.         <!-- 购物车商品列表 -->
12.         <div class="top-list">
13.             <div class="list-title">
14.                 <input class="all-checkbox" type="checkbox" checked="{{ isAllSelect }}" @change="checkboxOnChange">
15.                 </input>
16.                 <image class="my-icon-size" src="{{ person }}"></image>
17.                 <text class="mall-self-operated">{{ $t('strings.mall_self_operated') }}</text>
18.             </div>
19.             <list class="list">
20.                 <list-item for="{{ (index, item) in shoppingListData }}" class="list-item">
21.                     <div class="list-content">
22.                         <input class="checkbox" type="checkbox" checked="{{ item.isSelect }}"></input>
23.                         <image class="product-pictures" src="{{ item.image }}"></image>
24.                         <div class="box-content">
25.                             <text class="product-title">{{ $t(item.title) }}</text>
26.                             <text class="product-subtitle">{{ $t(item.subtitle) }}</text>
27.                             <div class="content-price">
28.                                 <text class="product-price">{{ item.price }}</text>
29.                                 <div class="price-num">
30.                                     <image class="my-icon-size" @click="subtractNum(index)" src="{{ item.num === 0 ?
31.                                             commonIcon.decreaseDisableIcon : commonIcon.decreaseIcon }}">
32.                                     </image>
33.                                     <text class="product-num">{{ item.num }}</text>
34.                                     <image class="my-icon-size" src="{{ commonIcon.increaseIcon }}"
35.                                            @click="addNum(index)">
36.                                     </image>
37.                                 </div>
38.                             </div>
39.                         </div>
40.                     </div>
41.                 </list-item>
42.             </list>
43.         </div>
44.     </div>
45.     <!-- 猜你喜欢商品列表 -->
46.     <div class="middle-card">
47.         <liked-cards></liked-cards>
48.     </div>
49. </div>

复制代码

• 点击“商品自营”头像前的多选框，会触发checkboxOnChange()方法，页面会勾选/不勾选购物车的中所有商品。
  
• 点击“+”按钮会触发addNum()方法，增加单件商品的数目。
  
• 点击“-”按钮会触发subtractNum()方法，减少单件商品的数目。
  

1. // shoppingCart.js
2. import CommonConstants from '../../common/constant/commonConstants';
4. export default {
5.   data: {
6.     isAllSelect: false,
7.     shoppingListData: CommonConstants.SHOPPING_LIST_DATA,
8.     commonIcon: CommonConstants.SHOPPING_CART_ICON,
9.     person: CommonConstants.COMMON_ICON.person
10.   },
12.   /**
13.    * 购物车商品全选/非全选
14.    */
15.   checkboxOnChange() {
16.     this.isAllSelect = !this.isAllSelect;
17.     this.shoppingListData.filter((item) => {
18.       item.isSelect = this.isAllSelect;
19.     });
20.   },
22.   /**
23.    * 勾选单个商品
24.    *
25.    * @param subscript 选中商品的索引
26.    * @param event 单选框事件
27.    */
28.   singleAnswer(subscript, event) {
29.     // 修改商品的选择状态
30.     this.shoppingListData.forEach((item, index) => {
31.       if (index === subscript) {
32.         item.isSelect = event.checked;
33.       }
34.     })
35.     // 检查购物车中的所有商品是否都被选中
36.     let selectAll = this.shoppingListData.every(item => item.isSelect === true);
37.     if (selectAll === true) {
38.       this.isAllSelect = true;
39.     } else {
40.       this.isAllSelect = false;
41.     }
42.   },
44.   /**
45.    * 减少商品数量逻辑
46.    *
47.    * @param value 当前商品的数量
48.    */
49.   subtractNum(value) {
50.     if (this.shoppingListData[value].num > 0) {
51.       this.shoppingListData[value].num--;
52.     }
53.   },
55.   /**
56.    * 增加商品数量逻辑
57.    *
58.    * @param value 当前商品的数量
59.    */
60.   addNum(value) {
61.     this.shoppingListData[value].num++;
62.   }
63. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。