广东网站建设制作价格低东莞市城乡建设网
1 卡片介绍
使用ArkTS语言,实现一个导航与内容二级联动的效果。
2 标题
二级联动(ArkTS)
3 介绍
本篇Codelab是主要介绍了如何基于List组件实现一个导航和内容的二级联动效果。样例主要包含以下功能:
- 切换左侧导航,右侧滚动到对应的内容。
 - 滚动右侧的内容,左侧会切换对应的导航。
 
效果如图所示:

相关概念
- List:列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据,例如图片和文本。
 - ListItemGroup:该组件用来展示列表item分组,宽度默认充满List组件,必须配合List组件来使用。
 
4 环境搭建
软件要求
- DevEco Studio版本:DevEco Studio 3.1 Release。
 - OpenHarmony SDK版本:API version 9。
 
硬件要求
- 开发板类型:润和RK3568开发板。
 - OpenHarmony系统:3.2 Release。
 
环境搭建
完成本篇Codelab我们首先要完成开发环境的搭建,本示例以RK3568开发板为例,参照以下步骤进行:
- 获取OpenHarmony系统版本:标准系统解决方案(二进制)。以3.2 Release版本为例:
 

2.搭建烧录环境。
- 完成DevEco Device Tool的安装
 - 完成RK3568开发板的烧录
 
3.搭建开发环境。
- 开始前请参考工具准备,完成DevEco Studio的安装和开发环境配置。
 - 开发环境配置完成后,请参考使用工程向导创建工程(模板选择“Empty Ability”)。
 - 工程创建完成后,选择使用真机进行调测。
 
5 代码结构解读
本篇Codelab只对核心代码进行讲解。
├──entry/src/main/ets                // 代码区
│  ├──common
│  │  └──constants
│  │     └──Constants.ets            // 常量类
│  ├──entryability
│  │  └──EntryAbility.ts             // 程序入口类
│  ├──pages
│  │  └──IndexPage.ets               // 二级联动页面入口
│  ├──view
│  │  ├──ClassifyItem.ets            // 课程分类组件
│  │  └──CourseItem.ets              // 课程信息组件
│  └──viewmodel                          
│     ├──ClassifyModel.ets           // 导航Model
│     ├──ClassifyViewModel.ets       // 导航ViewModel
│     ├──CourseModel.ets             // 课程内容Model
│     └──LinkDataModel.ets           // 数据源Model
└──entry/src/main/resources          // 资源文件 
6 二级联动实现
界面整体使用Row组件实现横向布局,分为左右两部分。均使用List组件实现对导航和内容的数据展示,导航部分固定宽度,内容部分自适应屏幕剩余宽度并用ListItemGroup完成每个导航下的内容布局。

Row() {List({ scroller: this.classifyScroller }) {ForEach(this.classifyList, (item: ClassifyModel, index: number) => {ListItem() {ClassifyItem({classifyName: item.classifyName,isSelected: this.currentClassify === index,onClickAction: () => this.classifyChangeAction(index, true)})}}, (item: ClassifyModel) => item.classifyName + this.currentClassify)}List({ scroller: this.scroller }) {ForEach(this.classifyList, (classifyItem: ClassifyModel) => {ListItemGroup({header: this.ClassifyHeader(classifyItem.classifyName),space: Constants.COURSE_ITEM_PADDING}) {ForEach(classifyItem.courseList, (courseItem: CourseModel) => {ListItem() {CourseItem({ itemStr: JSON.stringify(courseItem) })}}, courseItem => courseItem.courseId)}}, item => item.classifyId)}.sticky(StickyStyle.Header).layoutWeight(1).edgeEffect(EdgeEffect.None).onScrollIndex((start: number) => this.classifyChangeAction(start, false))
} 
点击左侧导航时,右侧内容区域通过scrollToIndex方法跳转到对应的内容页面,并改变导航的选中状态。同理在滚动右侧内容的过程中,如果当前展示的ListItemGroup发生改变时,修改左侧导航的选中状态,并滚到到对应的导航item。
classifyChangeAction(index: number, isClassify: boolean) {if (this.currentClassify !== index) {// change the classify statusthis.currentClassify = index;if (isClassify) {// scroll the course scrollthis.scroller.scrollToIndex(index);} else {// scroll the classify scrollthis.classifyScroller.scrollToIndex(index);}}
} 
7 总结
您已经完成了本次Codelab的学习,并了解到以下知识点:
- 使用List组件实现导航与内容联动的效果。
 - ListItemGroup组件的使用方法。
 
为了帮助大家更深入有效的学习到鸿蒙开发知识点,小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源,获取完整版方式请点击→《HarmonyOS教学视频》
HarmonyOS教学视频:语法ArkTS、TypeScript、ArkUI等.....视频教程


鸿蒙生态应用开发白皮书V2.0PDF:
获取完整版白皮书方式请点击《鸿蒙生态应用开发白皮书V2.0PDF》

鸿蒙 (Harmony OS)开发学习手册
一、入门必看
- 应用开发导读(ArkTS)
 - ……
 
二、HarmonyOS 概念
- 系统定义
 - 技术架构
 - 技术特性
 - 系统安全
 - ........
 
三、如何快速入门?《做鸿蒙应用开发到底学习些啥?》
- 基本概念
 - 构建第一个ArkTS应用
 - ……
 
四、开发基础知识
- 应用基础知识
 - 配置文件
 - 应用数据管理
 - 应用安全管理
 - 应用隐私保护
 - 三方应用调用管控机制
 - 资源分类与访问
 - 学习ArkTS语言
 - ……
 

五、基于ArkTS 开发
- Ability开发
 - UI开发
 - 公共事件与通知
 - 窗口管理
 - 媒体
 - 安全
 - 网络与链接
 - 电话服务
 - 数据管理
 - 后台任务(Background Task)管理
 - 设备管理
 - 设备使用信息统计
 - DFX
 - 国际化开发
 - 折叠屏系列
 - ……
 

更多了解更多鸿蒙开发的相关知识可以参考:《鸿蒙 (Harmony OS)开发学习手册》



