HarmonyOS实战开发-使用List组件实现导航与内容联动的效果。-编程知识

1 卡片介绍

使用ArkTS语言，实现一个导航与内容二级联动的效果。

2 标题

二级联动（ArkTS）

3 介绍

本篇Codelab是主要介绍了如何基于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);}}
}