郭周瀚HarmonyOS 5
HarmonyOS List 组件在折叠屏展开后,怎么自动调整列数?
AI助手List 组件的 lanes 属性支持传入 LengthConstrain(即 minLength/maxLength 约束),List 会根据自身可用宽度自动计算列数。折叠屏展开或折叠时,List 宽度发生变化,列数会随之自动重新计算,无需开发者手动监听屏幕状态并切换列数,这是实现该需求最简洁的方式。此外,从 API version 22 开始,lanes 还支持基于断点(PresetFillType)配置列数,也可以结合媒体查询在断点变化时动态修改列数。
方案一:lanes 传入 LengthConstrain,按列宽自动计算列数(推荐)
lanes({ minLength, maxLength }) 中,minLength 和 maxLength 表示每一列的最小、最大宽度,List 会在该约束范围内根据当前宽度自动决定列数。折叠态(窄屏)显示较少列,展开态(宽屏)自动增加列数。
// 适用版本:HarmonyOS 5.0.0(12) 及以上
@Entry
@Component
struct FoldableListDemo {
@State items: number[] = []
aboutToAppear(): void {
// 初始化列表数据
for (let i = 0; i < 30; i++) {
this.items.push(i)
}
}
build() {
Column() {
List({ space: 10 }) {
ForEach(this.items, (item: number) => {
ListItem() {
Text(item.toString())
.width('100%')
.height(100)
.fontSize(16)
.textAlign(TextAlign.Center)
.borderRadius(10)
.backgroundColor(0xFFFFFF)
}
}, (item: number) => item.toString())
}
// 每列最小宽度 45%、最大宽度 60%(相对 List 宽度的百分比)
// 折叠态:一列宽度在 45%~60% 之间,显示 1~2 列
// 展开态:宽度变大,自动计算出更多列
.lanes({ minLength: '45%', maxLength: '60%' })
.width('100%')
.layoutWeight(1)
}
.width('100%')
.height('100%')
.backgroundColor(0xDCDCDC)
}
}
方案二:基于断点配置列数(API version 22 起)
lanes 的第一个参数支持传入 PresetFillType,List 会根据自身宽度所属的断点区间自动确定列数,例如 BREAKPOINT_SM2MD3LG5 表示 sm 及以下断点 2 列、md 断点 3 列、lg 及以上断点 5 列:
// 适用版本:API version 22 及以上
List({ space: 10 }) {
// ... ListItem 内容同上
}
// sm 及以下 2 列,md 3 列,lg 及以上 5 列;第二个参数 10 为列间距
.lanes({ fillType: PresetFillType.BREAKPOINT_SM2MD3LG5 }, 10)
.width('100%')
.layoutWeight(1)
方案三:监听断点变化,动态修改列数
若需要完全自定义不同宽度下的列数,可使用媒体查询监听窗口宽度变化,通过状态变量驱动 lanes 更新:
import { mediaquery } from '@kit.ArkUI'
@Entry
@Component
struct BreakpointLanesDemo {
@State lanesCount: number = 1
private listener: mediaquery.MediaQueryListener =
mediaquery.matchMediaSync('(min-width: 600vp)')
aboutToAppear(): void {
// 根据初始断点设置列数
this.onBreakpoint(this.listener.matches)
this.listener.on('change', (result: mediaquery.MediaQueryResult) => {
this.onBreakpoint(result.matches)
})
}
aboutToDisappear(): void {
this.listener.off('change')
}
// 宽度 >= 600vp(折叠屏展开、平板等)显示 2 列,否则 1 列
private onBreakpoint(isMediumOrLarger: boolean): void {
this.lanesCount = isMediumOrLarger ? 2 : 1
}
build() {
List({ space: 10 }) {
ForEach([0, 1, 2, 3, 4, 5, 6, 7, 8, 9], (item: number) => {
ListItem() {
Text(item.toString())
.width('100%')
.height(100)
.textAlign(TextAlign.Center)
.borderRadius(10)
.backgroundColor(0xFFFFFF)
}
}, (item: number) => item.toString())
}
.lanes(this.lanesCount)
.width('100%')
.height('100%')
}
}
补充说明
- 方案一中的 minLength/maxLength 支持数字、字符串(如
'100vp')和百分比,百分比是相对 List 自身宽度计算的,因此列数会随折叠屏展开、窗口大小调整、分屏等场景自动重算。 - 断点判定基于组件宽度而非设备类型,折叠屏展开后 List 宽度进入 md/lg 区间即可触发列数切换,与窗口旋转、分屏等场景天然兼容。
- 若列表使用
LazyForEach加载数据,列数变化会触发子项重新布局,建议保持 item 键值稳定,避免折叠切换时出现内容重排或滚动位置异常;若对滚动位置有强依赖,可在列数变化后通过 Scroller 重新定位。 - 如果业务上需要"部分条目独占一行"这类不规则布局,List 的 lanes 无法实现,可改用 Grid 的
regularSize/irregularIndexes能力。
Z
匿名用户- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 如何实现两个List横向联动滑动过程中不抖动?(API12+)
HarmonyOS react-native长列表sectionList渲染性能差(API12+)
HarmonyOS Swiper垂直滑动 和list垂直滑动组合使用,如何使list垂直滑动 不受swiper影响,并且list上推到底部继续上推 swiper就会切换,list下拉到顶部继续下拉会使swiper切换,这个如何实现? (API12+)
HarmonyOS List的onScrollVisibleContentChange和onDidScroll回调顺序是什么?(API12+)
HarmonyOS Grid组件如何根据不同界面的宽,自动设置列数?(API12+)
HarmonyOS List组件设置lanes为2时,可以让指定ListItem占两列么?(API12+)
HarmonyOS 如何适配折叠屏实现展开态左右分栏 (API12+)
HarmonyOS折叠屏折叠与展开状态如何监听?(API12+)




































苏公安网备 32011402010933号