当前位置：首页 > news >正文

「Mac畅玩鸿蒙与硬件16」鸿蒙UI组件篇6 - List 和 Grid 组件展示数据列表

news 2025/8/10 9:29:20

List 和 Grid 是鸿蒙开发中的核心组件，用于展示动态数据。List 适合展示垂直或水平排列的数据列表，而 Grid 则适用于展示商品或图片的网格布局。本篇将展示如何封装组件，并通过按钮实现布局切换，提升界面的灵活性和用户体验。

在这里插入图片描述

关键词

List 组件
Grid 组件
数据展示
自定义列表项
布局切换
删除功能
动态加载

一、List 组件基础

1.1 基本用法

List 组件通过 @State 数据渲染一个基础的纵向列表。

@Entry
@Component
struct ListExample {@State items: string[] = ['Item 1', 'Item 2', 'Item 3']; // 初始化数据build() {Column() {List() {// 遍历数据并渲染每个列表项ForEach(this.items, (item: string) => {ListItem() {Text(item) // 显示文本.fontSize(28) // 设置字体大小.padding(20); // 设置内边距}});}}.width('100%') // 设置列宽为 100%.height('100%') // 设置列高为 100%.justifyContent(FlexAlign.Center); // 子项垂直居中对齐}
}

效果示例

1.2 设置列表方向

通过 listDirection 设置列表的滚动方向。

List() {ForEach(this.items, (item: string) => {ListItem() {Text(item) // 显示文本.fontSize(28).padding(20); // 设置内边距}})
}
.listDirection(Axis.Horizontal); // Axis.Horizontal 可实现横向滚动；Axis.Vertical 可实现纵向滚动

1.3 添加分隔线

为列表项添加分隔线，提高视觉层次感。

List() {ForEach(this.items, (item: string) => {ListItem() {Text(item).fontSize(28).padding(20); // 设置内边距}})
}
.divider({ color: Color.Blue, strokeWidth: 1 }); // 蓝色分隔线

二、封装 LightItem 组件

将灯具的图片和名称封装为 LightItem 组件，供 List 和 Grid 使用。组件通过 @Prop 接收数据，并在按钮点击事件中执行删除操作。

@Component
export struct LightItem {@Prop item: number; // 灯具 IDbuild() {Column() {// 显示灯具图片Image($r(`app.media.light_on_${this.item}`)).width(100) // 设置图片宽度.height(100); // 设置图片高度// 显示灯具名称Text(`灯${this.item}`).fontSize(18) // 设置字体大小.fontWeight(FontWeight.Bold) // 加粗.padding(10); // 设置文本内边距Button('删除') // 删除按钮.backgroundColor(Color.Red) // 按钮背景色.fontColor(Color.White); // 按钮文字颜色}.padding(10); // 设置组件外边距}
}

三、实现布局切换

新增一个按钮，通过点击按钮在 List 和 Grid 两种布局之间切换。删除功能则在父组件中实现。

import { LightItem } from './LightItem'; // 导入 LightItem 组件@Entry
@Component
struct LayoutSwitcherExample {@State items: Array<number> = [1, 2, 3, 4, 5, 6]; // 初始化数据@State isGridLayout: boolean = false; // 控制布局状态// 切换布局的方法toggleLayout() {this.isGridLayout = !this.isGridLayout;}// 删除列表项的方法deleteItem(item: number) {this.items = this.items.filter(i => i !== item); // 从列表中移除当前项}build() {Column() {// 布局切换按钮Button(this.isGridLayout ? '切换到列表布局' : '切换到网格布局').onClick(() => this.toggleLayout()) // 切换布局状态.padding(10) // 设置按钮内边距.backgroundColor(Color.Gray) // 设置按钮背景颜色.fontColor(Color.White); // 设置按钮文字颜色// 根据状态动态渲染布局if (this.isGridLayout) {Grid() {ForEach(this.items, (item: number) => {GridItem() {Column() {LightItem({ item: item }) // 渲染 LightItem 组件.onClick(() => this.deleteItem(item)) // 删除项}}});}.columnsTemplate('1fr 1fr') // 每行两列.columnsGap(10) // 设置列间距.rowsGap(10); // 设置行间距} else {List() {ForEach(this.items, (item: number) => {ListItem() {Column() {LightItem({ item: item }) // 渲染 LightItem 组件.onClick(() => this.deleteItem(item)) // 删除项}}});}.listDirection(Axis.Horizontal); // 设置为横向滚动}}.width('100%') // 设置宽度.height('100%') // 设置高度.alignItems(HorizontalAlign.Center) // 子项水平居中.justifyContent(FlexAlign.Center); // 子项垂直居中}
}