「Mac畅玩鸿蒙与硬件16」鸿蒙UI组件篇6 - List 和 Grid 组件展示数据列表-阿里云开发者社区

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

2024-11-23 36

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

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

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; // 灯具 ID

  build() {
   
    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); // 子项垂直居中
  }
}