文档开发者中心
我的
|

ArkUI (方舟UI框架)

UI

HarmonyOS 5

HarmonyOS Sheet组件(API12+)

HarmonyOS Sheet组件(API12+)

点赞
收藏
回复
1
分享
举报
浏览145 发布于2026-02-03 09:35未知归属地
全部评论
最多点赞
最新发布
最早发布

根据HarmonyOS系统的设计逻辑和实际开发经验,Sheet组件的底部避让处理策略需要根据具体场景灵活调整。以下是针对不同场景的详细分析及处理建议:

一、系统默认行为与场景差异

  1. 基础避让机制

竖屏模式:当内容高度未超出安全区时(如示例中的480vp),系统默认不会主动触发避让。此时若内容未遮挡底部导航条,开发者无需额外处理。

横屏模式:若内容高度超过安全区最大阈值(API 14+中定义为距离状态栏8vp),系统会自动启用滚动并避让安全区域,此时无需开发者干预。

宽屏模式:当屏幕宽度≥840vp时,居中弹窗(SheetType.CENTER)或跟手弹窗(SheetType.SPRING)默认脱离底部区域,因此无需避让。

  1. 设计理念验证

系统确实内置了安全区适配逻辑,但仅在特定条件下生效:

底部弹窗横屏时,有状态栏则最大高度为距离状态栏8vp。

当Sheet内容高度超过安全区时,滚动行为会自动触发避让。

若开发者仅设置固定边距(如margin(16vp)),可能无法覆盖所有设备差异(如不同尺寸屏幕、横竖屏切换)。

二、需开发者主动处理的情况

  1. 动态布局场景

输入框交互:若Sheet内包含输入框,键盘弹出时需动态避让。可通过setKeyboardAvoidMode配置:

收起
自动换行
深色代码主题
复制
windowClass.setKeyboardAvoidMode(KeyboardAvoidMode.OFFSET); // 键盘抬起时页面上移

沉浸式效果:全屏模式下需手动获取避让区域高度(如导航条)并调整布局:

收起
自动换行
深色代码主题
复制
let avoidArea = window.getWindowAvoidArea(window.AvoidAreaType.TYPE_NAVIGATION_INDICATOR);
let bottomMargin = avoidArea.bottomRect.height;
  1. 宽屏设备适配

中轴避让(API 14+):在2-in-1设备或横屏模式下,可通过SheetOptions控制避让行为:

收起
自动换行
深色代码主题
复制
bindSheet($$this.isShow, this.myBuilder(), {
  height: 300,
  enableHoverMode: true,  // 开启中轴避让
  hoverModeArea: HoverModeAreaType.BOTTOM_SCREEN // 指定避让区域
})

三、实践建议

  1. 统一布局策略

若需要跨设备一致性,建议固定底部边距,而非依赖系统默认行为:

收起
自动换行
深色代码主题
复制
Column() {
  // Sheet内容
}
.padding({ bottom: 24 }) // 固定边距
  1. 安全区扩展

当内容需延伸到安全区外(如全屏背景色),使用expandSafeArea:

收起
自动换行
深色代码主题
复制
bindSheetContent()
  .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.BOTTOM])
  1. 动态高度计算

结合SheetSize.FIT_CONTENT实现自适应高度,避免内容溢出:

收起
自动换行
深色代码主题
复制
bindSheet($$this.isShow, this.myBuilder(), {
  height: SheetSize.FIT_CONTENT, // 内容高度自适应
  detents: [SheetHeight.LARGE, SheetHeight.MEDIUM] // 允许用户手势调整高度
})

总结

无需处理的情况:当内容高度未超出安全区、设备默认适配合理时,无需额外操作。

必须处理的情况:涉及动态布局(键盘交互)、沉浸式效果或特定设备适配时,需通过getWindowAvoidArea、expandSafeArea等接口主动干预。

最佳实践:优先采用SheetSize.FIT_CONTENT自适应高度,并添加固定边距(如padding(24vp))以覆盖多场景适配。

展开全部
1楼回复于2026-02-03 09:35 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

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