鸿蒙5.0开发进阶:JS组件-list

鸿蒙OpenHarmony【list】JS容器组件 列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据,例如图片和文本。 阅读详情

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


list

说明

从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据,例如图片和文本。

权限列表

无

子组件

仅支持<list-item-group>和<list-item>。

属性

除支持通用属性外,还支持如下属性:

名称类型默认值必填描述
scrollpagebooleanfalse否设置为true时,将 list 顶部页面中非 list 部分随 list 一起滑出可视区域,当list方向为row时,不支持此属性。
cachedcountnumber0否

长列表延迟加载时list-item最少缓存数量。

可视区域外缓存的list-item数量少于该值时,会触发requestitem事件。

scrollbarstringoff否

侧边滑动栏的显示模式(当前只支持纵向):

- off:不显示。

- auto:按需显示(触摸时显示,2s后消失)。

- on:常驻显示。

scrolleffectstringspring否

滑动效果,目前支持如下滑动效果:

- spring:弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。

- fade:渐隐物理动效,滑动到边缘后展示一个波浪形的渐隐,根据速度和滑动距离的变化渐隐也会发送一定的变化。

- no:滑动到边缘后无效果。

indexerboolean | Array<string>false否

是否展示侧边栏快速字母索引栏。设置为true或者自定义索引时,索引栏会显示在列表右边界处。示例:

"indexer" : "true"表示使用默认字母索引表。

"indexer" : "false"表示无索引。

"indexer" : ['#',‘1’,'2',‘3’,'4',‘5’,'6',‘7’,'8']表示自定义索引表。自定义时"#"必须要存在。

indexer属性生效需要flex-direction属性配合设置为column,且columns属性设置为1。

点击索引条进行列表项索引需要list-item子组件配合设置相应的section属性。

indexercircle5+boolean-否

是否为环形索引。

穿戴设备默认为true,其他为false。indexer为false时不生效。

indexermulti5+booleanfalse否

是否开启索引条多语言功能。

indexer为false时不生效。

indexerbubble5+booleantrue否

是否开启索引切换的气泡提示。

indexer为false时不生效。

divider5+booleanfalse否

item是否自带分隔线。

其样式参考样式列表的divider-color、divider-height、divider-length、divider-origin。

shapemodestringdefault否

侧边滑动栏的形状类型。

- default:不指定,跟随主题;

- rect:矩形;

- round:圆形。

updateeffectbooleanfalse否

用于设置当list内部的item发生删除或新增时是否支持动效。

- false:新增删除item时无过渡动效。

- true:新增删除item时播放过程动效。

chainanimation5+booleanfalse否

用于设置当前list是否启用链式联动动效,开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果:list内的list-item间隔一定距离,在基本的滑动交互行为下,主动对象驱动从动对象进行联动,驱动效果遵循弹簧物理动效。

- false:不启用链式联动

- true:启用链式联动

不支持动态修改。

同时配置了indexer,链式动效不生效。

如配置了链式动效,list-item的sticky不生效。

initialindexnumber0否用于设置当前List初次加载时视口起始位置显示的item,默认为0,即显示第一个item,如设置的序号超过了最后一个item的序号,则设置不生效,当同时设置了initialoffset属性时,当前属性不生效。当indexer为true或者scrollpage为true时,不生效。
initialoffset<length>0否用于设置当前List初次加载时视口的起始偏移量,偏移量无法超过当前List可滑动的范围,如果超过会被截断为可滑动范围的极限值。当indexer为true或者scrollpage为true时,不生效。
selected5+string-否指定当前列表中被选中激活的项,可选值为list-item的section属性值。

样式

除支持通用样式外,还支持如下样式:

名称类型默认值必填描述
divider-color5+<color>transparent否item分隔线颜色,仅当list的divider属性为true时生效。
divider-height5+<length>1否item分隔线高度,仅当list的divider属性为true时生效。
divider-length5+<length>主轴宽度否item分隔线长度,不设置时最大长度为主轴宽度,具体长度取决于divider-origin,仅当list的divider属性为true时生效。
divider-origin5+<length>0否item分隔线相对于item主轴起点位置的偏移量,仅当list的divider属性为true时生效。
flex-directionstringcolumn否

设置flex容器主轴的方向,指定flex项如何放置在flex容器中,可选值为:

- column:主轴为纵向。

- row:主轴为横向。

其他组件默认值为row,在list组件中默认值为column。

columnsnumber1否

list交叉轴方向的显示列数,默认为1列。

设置多列时,在list交叉轴上进行均分,每一列大小相同。

align-itemsstringstretch否

list每一列交叉轴上的对齐格式,可选值为:

- stretch:弹性元素被在交叉轴方向被拉伸到与容器相同的高度或宽度。

- flex-start:元素向交叉轴起点对齐。

- flex-end:元素向交叉轴终点对齐。

- center:元素在交叉轴居中。

align-items样式作用在每一列的子元素上,列与列之间采用均分方式布局。

item-extent<length> | <percentage>-否设置内部item为固定大小,设置为百分比格式时,指相对于list的视口主轴方向长度的百分比。
fade-color<color>grey否设置渐隐物理动效的颜色。当滑动效果设置为渐隐物理动效时生效。
scrollbar-color6+<color>-否设置滚动条的颜色。
scrollbar-width6+<length>-否设置滚动条的宽度。
scrollbar-offset6+<length>0否设置滚动条距离List默认位置的偏移量,只支持正数,默认位置在List右边缘,可以通过这个偏移量调整滚动条的水平位置,如果滚动条绘制在list外部,而list父组件有裁剪,会导致滚动条被裁剪。

事件

除支持通用事件外,还支持如下事件:

名称参数描述
indexerchange5+{ local: booleanValue }

多语言索引条切换事件,仅当indexer属性为true,indexermulti为true时生效。booleanValue可能值为true或者false:

- true: 当前展示本地索引。

- false: 当前展示字母索引。

scroll{ scrollX: scrollXValue, scrollY: scrollYValue, scrollState: stateValue }

列表滑动的偏移量和状态回调。

stateValue: 0表示列表滑动已经停止。

stateValue: 1表示列表正在用户触摸状态下滑动。

stateValue: 2表示列表正在用户松手状态下滑动。

scrollbottom-当前列表已滑动到底部位置。
scrolltop-当前列表已滑动到顶部位置。
scrollend-列表滑动已经结束。
scrolltouchup-手指已经抬起且列表仍在惯性滑动。
requestitem-

请求创建新的list-item。

长列表延迟加载时,可视区域外缓存的list-item数量少于cachedcount时,会触发该事件。

rotation7+{ rotateValue: number }返回表冠旋转角度增量值,仅智能穿戴支持。

方法

支持通用方法外,还支持如下方法:

名称参数描述
scrollTo{ index: number(指定位置) }list滑动到指定index的item位置。
scrollTop{ smooth: boolean }

smooth缺省为false,表示直接滚动到顶部。

smooth为true,表示平滑滚动到顶部。

scrollBottom{ smooth: boolean }

smooth缺省为false,表示直接滚动到底部。

smooth为true,表示平滑滚动到底部。

scrollPage{ reverse: boolean, smooth: boolean }

reverse缺省值为false,表示下一页,无完整页则滚动到底部。

reverse为true,表示上一页,无完整页则滚动到顶部。

smooth缺省值为false,表示直接滚动一页。

smooth为true,表示平滑滚动一页。

scrollArrow{ reverse: boolean, smooth: boolean }

reverse缺省值为false,表示向底部方向滑动一段距离,无足够距离则滚动到底部。

reverse为true,表示向顶部方向滑动一段距离,无足够距离则滚动到顶部。

smooth缺省值为false,表示直接滚动。

smooth为true,表示平滑滚动。

collapseGroup{ groupid: string }

收拢指定的group。

groupid:需要收拢的group的id。

当groupid未指定时收拢所有的group。

expandGroup{ groupid: string }

展开指定的group。

groupid:需要展开的group的id。

当groupid未指定时展开所有的group。

currentOffset-返回当前滑动的偏移量。返回值类型是Object,返回值说明请见表 currentOffset返回对象属性说明。

表1 currentOffset返回对象属性说明

名称类型备注
xnumber当前x轴滑动偏移量,单位为px。
ynumber当前y轴滑动偏移量,单位为px。

示例

<!-- index.hml -->
<div class="container">
  <list class="todo-wrapper">
    <list-item for="{{todolist}}" class="todo-item">
      <div style="flex-direction: column;align-items: center;justify-content: center;">
        <text class="todo-title">{{$item.title}}</text>
        <text class="todo-title">{{$item.date}}</text>
      </div>
    </list-item>
  </list>
</div>
/* index.css */
.container {
  display: flex;
  justify-content: center;
  align-items: center;
  width: 100%;
  height: 100%;
}
.todo-wrapper {
  width: 100%;
  height: 300px;
}
.todo-item {
  width: 100%;
  height: 120px;
  justify-content:center;
}
.todo-title {
  width: 100%;
  height: 80px;
  text-align: center;
}
// index.js
export default {
  data: {
    todolist: [{
      title: '刷题',
      date: '2021-12-31 10:00:00'
    }, {
      title: '看电影',
      date: '2021-12-31 20:00:00'
    }],
  },
}

OpenHarmony实战开发-List组件的使用之设置项 在本篇CodeLab中,我们将使用List组件、Toggle组件以及Router接口,实现一个简单的设置页,点击将跳转到对应的详细设置页面。效果图如下: 阅读详情

相关推荐

鸿蒙开发笔记(十七): 列表 List

鸿蒙os中List列表组件的使用

Waruler的博客 3958

鸿蒙5.0开发进阶:JS组件-容器组件(list)

列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据,例如图片和文本。

Androidbye的博客 827

鸿蒙开发实践——List组件的使用与AlphabetIndexer联动实践

在鸿蒙应用开发中,List组件是一个非常重要的元素,它用于展示一系列数据项,非常适合构建列表界面,例如商品列表、联系人列表、消息列表等,可以轻松高效地显示结构化、可滚动的信息。

android__bye的博客 941

鸿蒙5.0开发进阶:JS组件-list-item

<list>的子组件,用来展示列表具体item。

Androidbye的博客 903

鸿蒙5.0版开发:UI框架JS组件-容器组件(list-item-group)

的子组件,用来展示分组,宽度默认充满list组件。

m0_69424697的博客 1059

鸿蒙HarmonyOS兼容JS的类Web开发-开发指导

设置scale样式属性实现涟漪动画,先使用定位确定元素的位置,确定坐标后创建多个组件实现重合效果,再设置opacity属性改变组件不透明度实现组件隐藏与显示,同时设置scale值使组件可以一边放大一边隐藏,最后设置两个组件不同的动画执行时间,实现扩散的效果。通过设置x(x轴坐标)、y(y轴坐标)、dx(文本x轴偏移)、dy(文本y轴偏移)、fill(字体填充颜色)、stroke(文本边框颜色)、stroke-width(文本边框宽度)等属性实现文本的不同展示样式。

特创数字 1717

鸿蒙5.0开发进阶:JS组件-list-item-group

<list>的子组件,用来展示分组,宽度默认充满list组件。

Androidbye的博客 1071

鸿蒙5.0版开发:UI框架JS组件-容器组件(list-item)

的子组件,用来展示列表具体item。

m0_69424697的博客 805

鸿蒙5.0开发进阶:JS组件-容器组件(list-item)

<list>的子组件,用来展示列表具体item.

Androidbye的博客 662

HarmonyOS—低代码开发Demo示例

鸿蒙开发学习是一个系统化的过程,从基础知识的学习到实战技能的锤炼,再到对前沿技术的探索,每一环节都至关重要。希望这份教程资料能帮助您快速入门并在鸿蒙开发之路上步步攀升,成就一番事业。让我们一起乘风破浪,拥抱鸿蒙生态的广阔未来!,才是我创造的动力。关注我,同时可以期待后续文章ing,不定期分享原创知识。想要获取更多完整鸿蒙最新VIP学习资料,请点击→《鸿蒙 (Harmony OS)开发学习手册。

2401_82546228的博客 2240

Mac上Ollama服务IP访问失败的3种修复方法(含永久生效配置)

本文详细介绍了Mac上Ollama服务IP访问失败的3种修复方法,包括临时环境变量覆盖、永久Shell配置修改及进阶排查技巧。重点解析了OLLAMA_HOST环境变量的配置原理,帮助开发者解决Connection refused问题,实现局域网IP访问Ollama服务的需求。

weixin_29209805的博客 210

鸿蒙5.0开发进阶:ArkUI框架-JS容器组件(list)

适合连续、多行呈现同类数据,例如图片和文本。

Androidbye的博客 687

Lede(OpenWrt)安装和双宽带叠加

LEDE是一个专为路由器和嵌入式设备设计的自由和开源的操作系统。LEDE是OpenWRT项目的一个分支项目。LEDE操作系统包括许多路由器有用的功能,如网络地址转换、防火墙、端口转发、DHCP服务器等。

我的博客 6443

鸿蒙5.0开发进阶:ArkUI框架-JS容器组件(list-item)

<list>的子组件,用来展示列表具体item。

Androidbye的博客 726

【GD32篇】驱动AD7616完成数据采集

GD32F10X驱动AD7616完成数据采集

we_long的博客 1万+

飞牛fnNAS搭建Web网页版OFFICE(WPS)软件

本文介绍了如何在飞牛NAS上通过Docker容器部署WPS Office办公软件。主要内容包括:启用Docker服务、准备项目文件夹结构、使用Compose方式构建容器、解决端口冲突问题、配置中文输入法和字体库,以及通过ZeroTier实现远程访问。文章详细说明了每个步骤的操作方法,包括容器启动、输入法设置、字体添加和文件存储位置配置。最后还介绍了使用ZeroTier内网穿透技术实现远程访问NAS上WPS服务的方法,让用户可以在不同设备上随时编辑NAS中的文件。整个部署过程完整清晰,为NAS用户提供了便捷的

dgnankai的专栏 1705

鸿蒙5.0版开发:UI框架JS组件-容器组件(list)

列表包含一系列相同宽度的列表项。

m0_69424697的博客 777

PCL学习笔记(四)——点云曲面重建

文章目录一、凸包算法二、 单纯的点云数据固然很好,但仅仅是点的话仍是不够的,因为这不利于我们后续对实体对象的渲染与各种应用,如计算实体的表面积、体积等等,所以这就需要我们对实体进行点云的曲面重建。 一、凸包算法 在计算机图形学中,凸包是指在任意维空间中包含某一有限点集P的最小凸集,它由凸包顶点构成,在二维上其表现形式为一个凸多边形,而在三维上则表现为一个凸多面体。在二维层面上来讲,最常用的凸包算法有Graham扫描法和Jarvis卷包裹法,但前者并不适用于三维层面,后者倒是可以扩展到三维。除此之外,在

dayuhaitang1的博客 6912

【鸿蒙next开发】JS组件:容器组件(list)

本文介绍了鸿蒙5.0开发中list组件的使用指南,包含核心属性、事件、样式设置及示例代码。

m0_73088370的博客 852

30.Labview如何读懂别人程序、修改程序?

之前写过一次教大家的文章,这次教大家如何学习别人的程序,和如何搭建一套适合自己的程序框架。这里事先说明一下:要想搭好程序框架,一定要先把自己的系统,逻辑是什么!这非常重要,是决定你程序的关键因素。废话不多扯,直接说重点。

关注我,更多技术问题欢迎私聊~ 2448

国社科“选题设计论证”部分不再难!用AI快速梳理五大核心板块,轻松撰写出高质量的基金申报书(附AI提示词)

七哥给大家推荐的高校都在用的AI平台——高级学术版专业应用平台,集成了ChatGPT、Claude、Gemini、Grok等Al大模型的PLUS版本平台,包括 ChatGPT-5、4o、o3、4.1、4.5、Gemini 2.5 Pro、Claude 3.7、Claude 4、DeepSeek 满血版、Grok 3 、Grok 4等原生线路,还有国际主流的GPTs学术应用,可以辅助大家高效完成科研和学术写作任务,当然撰写硕博论文,课题、职称论文、国社科、国自然基金本子也是手拿把掐。

智能AI让学术科研更容易 935
上一篇: 鸿蒙5.0开发进阶:JS组件-form
下一篇: 鸿蒙5.0开发进阶:JS组件-list-item
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值