鸿蒙Harmony应用开发—ArkTS声明式开发（模态转场设置：半模态转场）

最新推荐文章于 2025-06-12 18:00:00 发布

原创

最新推荐文章于 2025-06-12 18:00:00 发布 · 3.2k 阅读

CC 4.0 BY-SA版权

文章标签：

通过bindSheet属性为组件绑定半模态页面，在组件插入时可通过设置自定义或默认的内置高度确定半模态大小。

说明：

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

不支持路由跳转。

bindSheet(isShow: boolean, builder: CustomBuilder, options?: SheetOptions)

给组件绑定半模态页面，点击后显示模态页面。

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

参数：

参数名	类型	必填	说明
isShow	boolean	是	是否显示半模态页面。从API version 10开始，该参数支持$$双向绑定变量。
builder	CustomBuilder	是	配置半模态页面内容。
options	SheetOptions	否	配置半模态页面的可选属性。

说明：

在非双向绑定情况下，以拖拽方式关闭半模态页面不会改变isShow参数的值。

为了使isShow参数值与半模态界面的状态同步，建议使用$$双向绑定isShow参数。

继承自BindOptions。

名称	类型	必填	描述
height	SheetSize \| Length	否	半模态高度，默认是LARGE。说明：底部弹窗竖屏时，当设置sheetDetents时，该属性设置无效。底部弹窗竖屏时，最大高度为距离信号栏8vp。底部弹窗横屏时，该属性设置无效，高度为距离屏幕顶部8vp。居中弹窗和跟手弹窗设置类型为SheetSize.LARGE和SheetSize.MUDIUM无效，显示默认高度560vp。居中弹窗和跟手弹窗最小高度为320vp，最大高度为窗口短边的90%。当使用Length设置的高度和使用SheetSize.FIT_CONTENT自适应的高度大于最大高度，则显示最大高度，小于最小高度，则显示最小高度。
detents11+	[(SheetSize \| Length), (