文档开发者中心
我的
|

HarmonyOS 5

HarmonyOS List 组件在折叠屏展开后,怎么自动调整列数?

HarmonyOS List 组件在折叠屏展开后,怎么自动调整列数?
点赞
收藏
回复
3
分享
举报
浏览17 发布于5天前河北
全部评论
最多点赞
最新发布
最早发布
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 能力。
展开全部
6楼回复于4天前 来自广东
anes 属性用于设置 List 组件交叉轴方向的布局数量和间距:List 垂直滚动时设置的是列数和列间距,水平滚动时设置的是行数和行间距,默认按一列(或一行)显示。折叠屏展开的本质是窗口宽度变大并跨越宽度断点(sm/md/lg),因此列数调整的核心思路是 让 lanes 跟随宽度断点或折叠状态联动。
2楼回复于5天前 来自四川
需要根据宽度进行适配
1楼回复于5天前 来自浙江
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。