鸿蒙5.0开发进阶:UI框架-ArkTS组件(ListItemGroup)

鸿蒙Harmony应用开发—ArkTS声明式开发(容器组件:ListItemGroup) ArkTS声明式开发(容器组件:ListItemGroup) 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


ListItemGroup

该组件用来展示列表item分组,宽度默认充满List组件,必须配合List组件来使用。

说明

  • 该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
  • 该组件的父组件只能是List。
  • ListItemGroup组件不支持设置通用属性aspectRatio。
  • 当ListItemGroup的父组件List的listDirection属性为Axis.Vertical时,设置通用属性height属性不生效。ListItemGroup的高度为header高度、footer高度和所有ListItem布局后总高度之和。
  • 当父组件List的listDirection属性为Axis.Horizontal时,设置通用属性width属性不生效。ListItemGroup的宽度为header宽度、footer宽度和所有ListItem布局后总宽度之和。
  • 当前ListItemGroup内部的ListItem组件不支持编辑、拖拽功能,即ListItem组件的editable属性不生效。
  • ListItemGroup使用direction属性设置布局方向不生效,ListItemGroup组件布局方向跟随父容器List组件的布局方向。

子组件

包含ListItem子组件。

接口

ListItemGroup(options?: ListItemGroupOptions)

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
optionsListItemGroupOptions否列表item分组组件参数。

ListItemGroupOptions对象说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
headerCustomBuilder否

设置ListItemGroup头部组件。

说明:

可以放单个子组件或不放子组件。

footerCustomBuilder否

设置ListItemGroup尾部组件。

说明:

可以放单个子组件或不放子组件。

spacenumber | string否

列表项间距。只作用于ListItem与ListItem之间,不作用于header与ListItem、footer与ListItem之间。

默认值:0

单位:vp

style10+ListItemGroupStyle否

设置List组件卡片样式。

默认值: ListItemGroupStyle.NONE

设置为ListItemGroupStyle.NONE时无样式。

设置为ListItemGroupStyle.CARD时,建议配合ListItem的ListItemStyle.CARD同时使用,显示默认卡片样式。

卡片样式下,ListItemGroup默认规格:左右外边距12vp,上下左右内边距4vp。

卡片样式下, 为卡片内的列表选项提供了默认的focus、hover、press、selected和disable样式。

说明:

当前卡片模式下,使用默认Axis.Vertical排列方向,如果listDirection属性设置为Axis.Horizontal,会导致显示混乱;List属性alignListItem默认为ListItemAlign.Center,居中对齐显示。

属性

divider

divider(value: {strokeWidth: Length; color?: ResourceColor; startMargin?: Length; endMargin?: Length;} | null,)

设置ListItem分割线样式,默认无分割线。

strokeWidth, startMargin和endMargin不支持设置百分比。

ListItem设置多态样式时,被按压的子组件上下的分割线不绘制。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
value

{

strokeWidth: Length,

color?:ResourceColor,

startMargin?: Length,

endMargin?: Length

} | null

是

ListItem分割线样式。

- strokeWidth: 分割线的线宽。

- color: 分割线的颜色。

默认值:0x08000000

- startMargin: 分割线与列表侧边起始端的距离。

默认值:0,单位:vp

- endMargin: 分割线与列表侧边结束端的距离。

默认值:0,单位:vp

childrenMainSize12+

childrenMainSize(value: ChildrenMainSize)

设置ListItemGroup组件的子组件在主轴方向的大小信息。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueChildrenMainSize是

1.通过ChildrenMainSize对象向ListItemGroup组件准确提供所有ListItem在主轴方向的大小信息。

2.提供的主轴方向大小必须与子组件实际在主轴方向的大小一致。

3. 必须同时设置List的childrenMainSize属性使用。

4.子组件主轴方向大小变化或者增删子组件时都必须通过ChildrenMainSize对象方法通知ListItemGroup组件。

ListItemGroupStyle10+枚举说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称枚举值描述
NONE0无样式。
CARD1显示默认卡片样式。

示例

示例1(设置吸顶/吸底)

该示例通过stick实现了Header吸顶和Footer吸底的效果。

// xxx.ets
@Entry
@Component
struct ListItemGroupExample {
  private timeTable: TimeTable[] = [
    {
      title: '星期一',
      projects: ['语文', '数学', '英语']
    },
    {
      title: '星期二',
      projects: ['物理', '化学', '生物']
    },
    {
      title: '星期三',
      projects: ['历史', '地理', '政治']
    },
    {
      title: '星期四',
      projects: ['美术', '音乐', '体育']
    }
  ]

  @Builder
  itemHead(text: string) {
    Text(text)
      .fontSize(20)
      .backgroundColor(0xAABBCC)
      .width("100%")
      .padding(10)
  }

  @Builder
  itemFoot(num: number) {
    Text('共' + num + "节课")
      .fontSize(16)
      .backgroundColor(0xAABBCC)
      .width("100%")
      .padding(5)
  }

  build() {
    Column() {
      List({ space: 20 }) {
        ForEach(this.timeTable, (item: TimeTable) => {
          ListItemGroup({ header: this.itemHead(item.title), footer: this.itemFoot(item.projects.length) }) {
            ForEach(item.projects, (project: string) => {
              ListItem() {
                Text(project)
                  .width("100%")
                  .height(100)
                  .fontSize(20)
                  .textAlign(TextAlign.Center)
                  .backgroundColor(0xFFFFFF)
              }
            }, (item: string) => item)
          }
          .divider({ strokeWidth: 1, color: Color.Blue }) // 每行之间的分界线
        })
      }
      .width('90%')
      .sticky(StickyStyle.Header | StickyStyle.Footer)
      .scrollBar(BarState.Off)
    }.width('100%').height('100%').backgroundColor(0xDCDCDC).padding({ top: 5 })
  }
}

interface TimeTable {
  title: string;
  projects: string[];
}

示例2(设置卡片样式)

该示例展示了ListItemGroup的卡片样式效果。

// xxx.ets
@Entry
@Component
struct ListItemGroupExample2 {
  private arr: ArrObject[] = [
    {
      style: ListItemGroupStyle.CARD,
      itemStyles: [ListItemStyle.CARD, ListItemStyle.CARD, ListItemStyle.CARD]
    },
    {
      style: ListItemGroupStyle.CARD,
      itemStyles: [ListItemStyle.CARD, ListItemStyle.CARD, ListItemStyle.NONE]
    },
    {
      style: ListItemGroupStyle.CARD,
      itemStyles: [ListItemStyle.CARD, ListItemStyle.NONE, ListItemStyle.CARD]
    },
    {
      style: ListItemGroupStyle.NONE,
      itemStyles: [ListItemStyle.CARD, ListItemStyle.CARD, ListItemStyle.NONE]
    }
  ]

  build() {
    Column() {
      List({ space: "4vp", initialIndex: 0 }) {
        ForEach(this.arr, (item: ArrObject, index?: number) => {
          ListItemGroup({ style: item.style }) {
            ForEach(item.itemStyles, (itemStyle: number, itemIndex?: number) => {
              ListItem({ style: itemStyle }) {
                if (index != undefined && itemIndex != undefined) {
                  Text("第" + (index + 1) + "个Group中第" + (itemIndex + 1) + "个item")
                    .width("100%")
                    .textAlign(TextAlign.Center)
                }
              }
            }, (item: string) => item)
          }
        })
      }
      .width('100%')
      .multiSelectable(true)
      .backgroundColor(0xDCDCDC)
    }
    .width('100%')
    .padding({ top: 5 })
  }
}

interface ArrObject {
  style: number;
  itemStyles: number[];
}

鸿蒙5.0版开发:ArkTS容器组件(ListItemGroup) 该组件用来展示列表item分组,宽度默认充满List组件,必须配合List组件来使用。 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS组件-ListItemGroup

该组件用来展示列表item分组,宽度默认充满List组件,必须配合List组件来使用。

m0_69424697的博客 1163

鸿蒙HarmonyOS开发:List列表组件的使用详解及案例演示

在我们常用的手机应用中,经常会见到一些数据列表,如设置页面、通讯录、商品列表等。下图中两个页面都包含列表,“首页”页面中包含两个网格布局,“商城”页面中包含一个商品列表。列表中都包含一系列相同宽度的列表项,连续、多行呈现同类数据,例如图片和文本。常见的列表有线性列表(List列表)和网格布局(Grid列表)。为了帮助开发者构建包含列表的应用,ArkUI提供了List组件和Grid组件,开发者使用List和Grid组件能够很轻松的完成一些列表页面。

在这里,我乐于倾囊相授,分享我的技术心得、项目实战经验、技术技巧。希望能够惠及更多的开发者,助力大家在技术的海洋中扬帆远航。 1万+

HarmonyOS开发实战:ArkUI案例-按字母分组展示联系人示例

在通讯录中,需要将联系人按照姓氏的首字母进行分组排列

DMZDAMS的博客 1358

【鸿蒙开发】系统组件List,ListItem,ListItemGroup

鸿蒙开发arkui组件,List组件,ListItem组件,ListItemGroup组件

d312697510的博客 3071

AI重塑跨端开发:从设计稿到多端代码的工程化实践与鸿蒙实战

在软件开发领域,跨端开发旨在实现一套代码在多个终端(如Web、移动端、鸿蒙)的高效运行,其核心挑战在于处理不同平台的生态差异与保持UI一致性。其技术原理通常依赖于统一的渲染引擎或声明式UI框架,通过抽象层屏蔽底层平台细节,从而实现代码复用。这一技术能显著提升开发效率、降低维护成本,并加速产品在多端市场的统一交付。随着AI大模型技术的突破,AI辅助编程正成为解决跨端开发中高重复性、强规范性任务的新范式。它通过理解设计稿、转换代码语法、生成符合特定框架规范的组件,将开发者从繁重的适配与还原工作中解放出来,尤其在

weixin_33836874的博客 376

鸿蒙HarmonyOS开发实战:ListItemGroup组件使用指南

通过使用ListItemGroup和AlphabetIndexer两种类型组件,实现带标题分类和右侧导航栏的页面

v_maniu110的博客 474

HarmonyOS6 ArkTS ListItemGroup设置卡片样式

/ 分组样式枚举NONE, // 无样式(默认)CARD // 卡片样式// 列表项样式枚举NONE, // 无样式CARD // 卡片样式ListItemGroup卡片样式通过开启,是分组卡片化的核心配置;支持与ListItem样式自由组合,实现多样化的分组列表UI;无需自定义样式代码,系统自动提供标准卡片视觉效果;仅支持在List中直接使用,遵循组件层级约束即可稳定生效。

qq_37048082的博客 4489

解决倍福ADS通信错误1861和6:一次完整的TwinCAT3路由配置与故障排查实录

本文详细解析了在Linux系统上解决倍福ADS通信错误1861和6的完整流程,包括TwinCAT3路由配置与故障排查。通过实例演示了如何正确配置AMS NetID、使用adstool工具添加静态路由,以及高级网络抓包分析技巧,帮助工程师快速定位和解决通信问题。

weixin_30875157的博客 523

HarmonyOS6 ArkTS ListItem设置卡片样式

ListItem 卡片样式是 HarmonyOS 官方提供的标准化UI能力通过开启卡片样式支持 CARD(卡片)/ NONE(无样式)两种形态可与实现分组卡片效果支持同列表混合使用,灵活适配界面设计。

qq_37048082的博客 4585

避开SAM3安装大坑:手把手教你用国内镜像和Modelscope权重快速跑通Demo

本文详细介绍了如何在国内环境下快速部署SAM3视觉大模型,包括使用国内镜像加速Python包安装、通过Modelscope获取权重文件以及解决CUDA 11.8等低版本适配问题。手把手教你避开常见安装陷阱,实现高效Demo运行。

weixin_30642561的博客 1407

写给音响工程师的科普文章(二)——从模电角度去了解调音台话放

    上一篇讲到调音台第一级放大电路为差分放大器,关于差分放大器的基础知识可以参考以下资料:https://wenku.baidu.com/view/e6a46aaa2af90242a995e537 在教材中的差分放大器基本形式是这样子的,在实际电路中把RE电阻换成两个2倍RE,于是变成这样 然后我们现在来对比调音台中的差分放大器和教材中的有什么区别,我就拿yamaha 01V 96来说...

huanghaoAudio的博客 7707

鸿蒙HarmonyOS ArkTS设置页面布局深度解析:列表 + Switch + 分组

Builder装饰器用于定义可复用的 UI 片段,可以在组件内部或全局范围内定义。在 HarmonyOS NEXT 中,页面导航使用Router模块。从 API 18 开始,推荐使用获取 Router 实例。布局组件开关控件:Toggle(Switch 类型)状态管理:@State 装饰器UI 复用:@Builder 装饰器路由导航:Router 模块数据持久化理解设置页面的布局设计思路掌握核心组件的使用方法实现状态管理和 UI 响应式更新编写可复用的 UI 代码。

2601_96525998的博客 535

VTK实战完整教程介绍

该专栏以VTK提供的Example为基础,讲解VTK中的相关接口和使用方法。订阅该专栏,带你了解所有VTK的功能,以便VTK更好的解决工作中遇到的问题。一起学习起来吧!

qq_40041064的博客 2512

HarmonyOS6 ArkTS List编辑模式开发指南

在移动应用开发中,列表组件是实现数据展示和交互的核心控件,其编辑功能直接影响用户体验。ArkTS作为HarmonyOS的声明式开发语言,通过状态管理和UI响应机制,可以高效实现列表的多选、拖拽排序等复杂交互。本文以HarmonyOS6的List组件为例,详细解析如何利用@State装饰器管理编辑状态,实现包括滑动删除、批量操作等企业级功能。针对实际开发中的性能优化要点,如ListItemGroup分组和cachedCount参数调优也进行了深入探讨,帮助开发者构建高性能的鸿蒙应用列表界面。

weixin_33423874的博客 303

海康VisionMaster与西门子Smart 200进行S7通信

海康VisionMaster与西门子Smart 200进行S7通信

haier123888的博客 8191

机器学习之多种算法优缺点总结及优化方法

一、无监督算法: 1、聚类算法:Kmeans 2、关联规则算法:Apriori 二、有监督算法 1、分类算法 决策树(Decision Tree) 支持向量机(SVM) K近邻(kNN,k-NearestNeighbor) 朴素贝叶斯 逻辑回归 2、回归算法 线性回归 多项式回归 3、集成算法 a、bagging(Bootstrapped Aggregation) 随机森林 ...

平原的博客 7081

HarmonyOS应用开发实战:小事记 - List 组件与 ListItem 复用:@Reusable 装饰器与全局复用池

本文深入解析了 HarmonyOS 中 List 组件的复用机制与性能优化策略。主要内容包括: List 与 Scroll 组件的对比分析,突出 List 在长列表场景的懒加载优势 @Reusable 装饰器的实现原理与使用方式,通过组件复用提升性能 LazyForEach 数据源实现与 cachedCount 缓存策略配置 复杂列表场景的解决方案:多类型列表项、分组吸顶等 性能优化实践建议:组件复用、固定高度、合理缓存等关键策略 文章结合 WitnessListPage 等实际案例,演示了如何通过技术组合

少湖说 518

深度学习笔记——前向传播与反向传播、神经网络(前馈神经网络与反馈神经网络)、常见算法概要汇总

本文简要介绍深度学习的前向传播与反向传播,以及前馈神经网络与反馈神经网络。

haopinglianlian的博客 3044

HarmonyOS ArkTS App 关于页面实战:InfoRow 组件与功能网格布局

关于」页面通常是用户了解应用的窗口,展示版本号、开发者信息、功能列表等内容。InfoRow 信息区:展示应用图标、名称、版本号、开发者、版权等信息Feature Grid 功能区:使用 Grid 组件构建 3 列网格,展示 30 个功能入口项页面布局结构│ 应用 Logo + 名称 │ ← 应用头部│ 版本号 v1.0.0 ││ 开发者:HarmonyOS Team │ ← InfoRow 信息行│ 更新时间:2025-01-15 ││ 联系我们:support@example │。

2403_87838053的博客 164

数据结构之博弈树搜索(深度优先搜索)

数据结构之博弈树搜索(深度优先搜索)

LucianaiB的博客 1527

IDEA的使用指南

IDEA基于java的使用手册,可以最快速的上手,在使用中不断的丰富自己的使用技巧.

【HarmonyOS开发】ArkTs实现侧栏联动

侧栏联动功能模块:1、切换左侧导航,右侧滚动到对应的内容。2、滚动右侧的内容,左侧会切换对应的导航。

qq_23334071的博客 1654

ssm框架搭建

这个是一个在idea上成功跑起来的ssm框架项目,保存在这里方便以后使用直接下载

鸿蒙应用开发-ArkUI入门创建LIST-1

Grid和WaterFlow也可以实现单列、多列布局,如果布局每列等宽,且不需要跨行跨列布局,相比Grid和WaterFlow,则更推荐使用List。List的子组件必须是ListItemGroup或ListItem,ListItem和ListItemGroup必须配合List来使用。在List组件中,ForEach除了可以用来循环渲染ListItem,也可以用来循环渲染ListItemGroup。话不多说写代码看注解查效果!提供了组件的循环渲染能力。

238

efm32 入门.pdf

本PDF共计22页,介绍的是操作驱动API,下载与否自己斟酌。

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

《宝宝成长记录时间轴》四、ArkTS开发避坑与修复指南

ArkTS严格模式虽然增加了开发约束,但也帮助我们在编译阶段发现潜在问题。类型显式化:对象字面量、枚举值、变量类型都要显式声明API先查后用:不要凭直觉假设组件属性,先查官方文档数据简单化:跨页面传递数据优先使用基本类型状态规范化:正确使用装饰器,筛选逻辑放在数据层而非UI层掌握这些原则,你的HarmonyOS开发效率将大幅提升!关键词。

army16的专栏 310

【每日学点HarmonyOS Next知识】发送通知、弹窗刷新、主动触发输入框焦点、分页列表实现、富文本编辑器控制输入状态

【每日学点HarmonyOS Next知识】发送通知、弹窗刷新、主动触发输入框焦点、分页列表实现、富文本编辑器控制输入状态

轻口味的专栏 521

吸顶效果与粘性头部——从原生实现到自定义手势联动

在移动端应用开发中,吸顶效果(Sticky Header)是提升长列表浏览体验的核心交互模式之一。当用户向上滚动页面时,分组头部或导航栏固定在视口顶部,既保证了上下文信息的持续可见,又避免了频繁回滚的繁琐操作。HarmonyOS ArkTS 提供了从原生声明式到自定义布局的多层次吸顶实现方案,覆盖从简单分组列表到复杂电商详情页的全场景需求。本文基于ListItemGroup 原生吸顶Scroll + Stack 自定义吸顶,以及Tabs + nestedScroll 嵌套联动吸顶。

从事移动开发八年,csdn博客专家,阿里云特邀专家,华为云云享专家,高级网络信息安全工程师,大数据工程师(高级),python技术开发(高级),HarmonyOS 应用开发者高级认证,现在某学校任教。 6111

写给初学者的 HarmonyOS 教程 -- ArkTS 容器组件(List)

使用列表可以轻松高效地显示结构化、可滚动的信息。通过在 List 组件中按垂直或者水平方向线性排列子组件 ListItemGroup 或 ListItem,为列表中的行或列提供单个视图,或使用ForEach 迭代一组行或列,或混合任意数量的单个视图和 ForEach 结构,构建一个列表。

Fucking Android & Compose & Harmony & Spring Boot ... 7614
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(ListItem)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(Grid)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值