【鸿蒙ArkUI实战开发】基于bindSheet的半模态弹窗

最新推荐文章于 2025-06-27 10:45:13 发布

原创

最新推荐文章于 2025-06-27 10:45:13 发布 · 1.1k 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #移动开发 #组件化 #ArkUI #ArkTS #bindSheet #鸿蒙开发

往期知识点整理

鸿蒙（HarmonyOS）北向开发知识点记录~
【鸿蒙UI实战开发】基于List和Scroller由简单到复杂列表布局开发实践
【鸿蒙UI实战开发】基于原生能力的键盘控制
【鸿蒙UI实战开发】基于子窗口实现应用内悬浮窗
【鸿蒙ArkUI实战开发】基于bindSheet的半模态弹窗
持续更新中……

bindSheet半模态转场基本介绍

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

可以通过设置height属性来实现自定义高度；也可以通过设置height属性的SheetSize枚举类型，默认是LARGE。

MEDIUM	指定半模态高度为屏幕高度一半。
LARGE	指定半模态高度几乎为屏幕高度。
FIT_CONTENT11+	指定半模态高度为适应内容的高度。

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

@Entry

@Component

struct Index {

@State isShow: boolean = false;

@Builder

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

CTrup

关注关注

25
点赞
踩
18

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

#鸿蒙开发#ArkUI框架下半模态弹窗的自定义设计指南：打造丝滑的用户体验

m0_73386679的博客

02-22

1347

模态转场是新的界面覆盖在旧的界面上，旧的界面不消失的一种转场方式。半模态转场是一种特殊的页面切换效果，用于在当前页面上显示一部分内容，而不会完全覆盖底下的页面。这种转场方式通常用于提供额外的信息或操作选项，而不需要用户离开当前页面。通过bindSheet属性为组件绑定半模态页面，在组件插入时可通过设置自定义或默认的内置高度确定半模态大小，属性设置如下。参数名类型说明isShowOptional是否显示半模态页面。从API version 10开始，该参数支持$$双向绑定变量。

鸿蒙开发中BindSheet应用打造半模态转场效果

wy363681759的博客

02-26

419

在鸿蒙开发中，BindSheet组件可用于创建半模态窗口，通过设置合适的属性和添加动画效果，能够实现具有转场效果的半模态窗口。以下是详细的实现步骤和示例代码。

参与评论您还未登录，请先登录后发表或查看评论

基于bindSheet的半模态弹窗

hongxiaomeng的博客

06-04

691

HarmonyOS中自定义半模态弹窗

最新发布

cj641809386的专栏

06-27

439

鸿蒙 ArkUI 自定义弹出框实践本文介绍了在鸿蒙 ArkUI 中使用半模态弹窗替代 Dialog 的实现方案。通过对比发现，Dialog 的动画效果会影响整个蒙层，而半模态弹窗仅作用于视图层，动画效果更符合预期。文章详细展示了如何使用 harmony-dialog 三方库中的 DialogHelper 类创建底部列表弹窗，包括参数配置、自定义组件构建和数据传递。重点说明了 BottomListOptions 的参数传递机制和 BottomListBuild 组件的实现细节，确保半模态弹窗的数据能够及时刷

鸿蒙开发0基础【绑定半模态页面（bindSheet）】ArkUI

zhenggaoxiao232的博客

05-09

467

[半模态页面（bindSheet）]默认是模态形式的非全屏弹窗式交互页面，允许部分底层父视图可见，帮助用户在与半模态交互时保留其父视图环境。半模态页面适用于展示简单的任务或信息面板，例如，个人信息、文本简介、分享面板、创建日程、添加内容等。若需展示可能影响父视图的半模态页面，半模态支持配置为非模态交互形式。

HarmonyOS鸿蒙开发：基于bindSheet的半模态弹窗场景

2401_84917132的博客

08-30

1430

可以通过设置height属性来实现自定义高度；也可以通过设置height属性的SheetSize枚举类型，默认是LARGE。

【鸿蒙实战开发】基于bindSheet的半模态弹窗

CTrup的博客

12-06

986

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

【HarmonyOS NEXT】@ohos.promptAction (弹窗)

weixin_71403100的博客

04-06

4629

创建并显示文本提示框、对话框和操作菜单。

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

m0_64420071的博客

03-05

3370

ArkTS声明式开发-模态转场设置：半模态转场

鸿蒙next-五种弹窗

LIUCHANGSHUO的博客

10-29

268

【代码】鸿蒙next-五种弹窗。

鸿蒙next开发进阶：NavDestination弹窗

m0_72493819的博客

06-18

1695

本案例介绍了使用NavDestination组件的Dialog模式实现与前一个页面的联动的评论弹窗。

HarmonyOS NEXT星河版之模拟图片选择器(下)---使用bindSheet展示图片选择器

小洋人最happy的专栏

05-07

562

【代码】HarmonyOS NEXT星河版之模拟图片选择器(下)---使用bindSheet展示图片选择器。

鸿蒙NEXT开发【自定义弹框使用（CustomDialog+TextPicker组合）】

houxiliOH的博客

10-11

2130

做过移动端甚至前端开发的小伙伴想必用过弹窗功能，其实弹窗就是一种浮动窗口，主要用于在应用界面上显示额外的信息或提供用户操作选项。而在HarmonyOS开发中，弹窗分为七种类型：AlertDialog、ActionSheet、CustomDialog、CalendarPickerDialog、DatePickerDialog、TimePickerDialog和TextPickerDialog。其他六种弹窗是系统预定义的弹框，而剩下的CustomDialog弹窗是允许开发者自定义弹窗的布局和内容的。

鸿蒙NEXT开发：ArkTS组件-模态转场设置（半模态转场）

ZPYQAQ的博客

03-29

1474

通过bindSheet属性为组件绑定半模态页面...........

harmonyOS鸿蒙官网教程-添加弹窗

移动端开发与最新技术

10-08

4267

在我们日常使用应用的时候，可能会进行一些敏感的操作，比如删除联系人，这时候我们给应用添加弹窗来提示用户是否需要执行该操作。

基于ArkUI现有能力实现自定义弹窗封装方案

hongxiaomeng的博客

05-09

903

HarmonyOS NEXT实战开发：构建弹窗

2401_87288236的博客

09-19

1158

通过弹窗控制器显示自定义弹窗，可以设置自定义弹窗的样式和内容。

HarmonyOS实战开发-全局状态保留能力弹窗。

2401_82546228的博客

05-07

698

全局状态保留能力弹窗一种很常见的能力，能够保持状态，且支持全局控制显隐状态以及自定义布局。使用效果参考评论组件

Harmony OS Next应用开发进阶篇（三）-模态转场

2401_88463044的博客

10-31

1703

hello大家好，这里是鸿蒙开天组，今天让我们来学习鸿蒙进阶篇-模态转场

HarmonyOS 实战开发 —— 基于ArkUI现有能力实现自定义底部模态弹出弹窗

03-28

<think>好的，我现在需要帮助用户了解如何在HarmonyOS中基于ArkUI现有能力实现一个自定义的底部模态弹出弹窗。首先，我得回顾一下HarmonyOS和ArkUI的相关知识，确保自己理解正确。用户提到的“底部模态弹出弹窗”通常是指从屏幕底部滑出的对话框，常用于移动应用的菜单选择、操作选项等场景。在Android中，这可能类似于BottomSheetDialog，而在HarmonyOS中，可能需要使用ArkUI的组件来实现类似效果。首先，我需要确认ArkUI是否提供了现成的底部弹窗组件。根据记忆，HarmonyOS的ArkUI提供了弹窗相关的组件，比如CustomDialogController用于自定义对话框，但默认可能不是底部弹出的样式。因此，用户可能需要自定义一个这样的弹窗，可能需要结合动画和布局来实现。接下来，思考实现步骤。首先，应该创建一个自定义弹窗的布局，使用ArkUI的组件如Column、Text、Button等来设计内容。然后，需要控制弹窗的显示和隐藏，这里可能需要使用状态变量来控制弹窗的可见性。同时，弹窗的位置应该固定在底部，可能需要使用绝对定位或者弹性布局。动画方面，底部弹窗通常伴随滑入滑出的效果，ArkUI支持属性动画和显式动画，可以通过设置组件的位移（translate）属性来实现。例如，初始位置在屏幕下方，显示时上移至屏幕底部，隐藏时下移回去。另外，模态弹窗需要阻止用户与背景内容的交互，可能需要一个半透明的遮罩层，点击遮罩层可以关闭弹窗。这可以通过在弹窗布局外层添加一个覆盖全屏的遮罩层，并处理其点击事件来实现。现在需要考虑如何将这些元素组合起来。可能的结构是：整个弹窗包含一个遮罩层和一个内容容器。遮罩层使用绝对定位覆盖整个屏幕，背景色为半透明黑色。内容容器固定在底部，初始位置在屏幕外，通过动画移动到可视区域。然后，具体到代码实现，使用ArkUI的声明式语法，例如在ets文件中定义组件。使用@State装饰器来控制弹窗的显示状态，结合Column和position属性来定位。动画可以使用animateTo方法来实现平滑过渡。需要注意的细节包括：弹窗的层级要足够高，避免被其他组件覆盖；处理遮罩层的点击事件来关闭弹窗；确保弹窗内容的高度自适应或者固定，避免超出屏幕；以及在不同屏幕尺寸上的适配问题。可能的挑战是如何正确管理弹窗的状态和动画的同步，以及如何确保弹窗的模态行为，即显示时阻止其他交互。需要测试弹窗的打开和关闭动画是否流畅，遮罩层是否能够正确拦截点击事件。另外，ArkUI可能有一些特定的限制或最佳实践，需要查阅官方文档确认。例如，CustomDialogController的使用方式，或者是否有内置的底部弹窗组件在最新版本中被引入。如果用户使用的是较旧的HarmonyOS版本，可能需要更多的自定义工作。最后，整理实现步骤，分点说明，并给出示例代码片段，帮助用户理解具体的实现方法。同时，提醒用户在实际开发中注意测试不同场景，如横竖屏切换、不同设备尺寸等，确保弹窗的显示效果符合预期。</think>在HarmonyOS中，基于ArkUI实现自定义底部模态弹窗可通过以下步骤实现。该方案将结合动画、布局和手势交互，确保符合HarmonyOS设计规范。 --- ### 一、实现原理 1. **组件结构**：通过`Stack`布局叠加遮罩层和内容区域 2. **动画控制**：使用`transition`实现位移动画 3. **交互控制**：通过`@State`管理弹窗状态 4. **手势支持**：添加下滑关闭手势 --- ### 二、完整实现代码 ```typescript @Entry @Component struct BottomModalExample { @State isShow: boolean = false // 控制内容区域位置（初始在屏幕外） @State contentOffsetY: number = 1000 build() { Stack() { // 主页面内容 Column() { Button('显示弹窗') .onClick(() => { this.showModal() }) } .width('100%') .height('100%') // 遮罩层 if (this.isShow) { Rect() .width('100%') .height('100%') .fill(Color.Black.opacity(0.5)) .onClick(() => { this.hideModal() }) .transition({ type: TransitionType.Insert, opacity: 0 }) } // 弹窗内容 Column() { // 自定义内容区域 Column() { Text('自定义标题') .fontSize(20) .margin({ bottom: 20 }) ForEach(["选项1", "选项2", "选项3"], (item) => { Text(item) .fontSize(16) .padding(10) .width('100%') .onClick(() => { console.info(`选中：${item}`) this.hideModal() }) }) } .padding(20) .backgroundColor(Color.White) .borderRadius(16) .width('100%') } .width('100%') .height('40%') .position({ y: this.contentOffsetY }) .backgroundColor(Color.White) .gesture( PanGesture({ distance: 5 }) .onActionEnd(() => { if (this.currentOffsetY > 50) { this.hideModal() } }) ) .transition({ type: TransitionType.All, translateY: { duration: 300 } }) } } // 显示弹窗 private showModal() { this.isShow = true this.contentOffsetY = '60%' // 根据屏幕高度调整 } // 隐藏弹窗 private hideModal() { this.contentOffsetY = 1000 setTimeout(() => { this.isShow = false }, 300) // 等待动画完成 } } ``` --- ### 三、关键实现点解析 1. **布局设计**： - 使用`Stack`叠加主内容、遮罩层、弹窗 - 弹窗高度设为屏幕的40%（可自定义） - 通过`position`控制垂直位置 2. **动画控制**： - `transition`实现平滑过渡动画 - 进场动画：从底部滑动至屏幕60%位置 - 退场动画：下滑隐藏 3. **交互设计**： - 点击遮罩层自动关闭 - 支持下滑手势关闭（通过`PanGesture`实现） - 点击选项自动关闭 4. **样式优化**： - 添加圆角边框`borderRadius` - 设置半透明遮罩层 - 选项点击反馈效果 --- ### 四、扩展优化建议 1. **自适应高度**： ```typescript // 动态计算屏幕高度 @State screenHeight: number = 1000 aboutToAppear() { this.screenHeight = display.getDefaultDisplay().height } // 使用时 .height(this.screenHeight * 0.4) ``` 2. **复杂动画**： ```typescript .transition({ type: TransitionType.All, translateY: { duration: 300, curve: Curve.EaseOut }, opacity: { duration: 200 } }) ``` 3. **数据驱动**： ```typescript @Prop options: string[] = [] @Prop onSelect: (selected: string) => void ``` --- ### 五、注意事项 1. **层级管理**：确保弹窗在`Stack`中的最高层级 2. **性能优化**：避免频繁切换显示状态 3. **无障碍支持**：添加内容描述 4. **多设备适配**：使用百分比布局和资源文件该实现方案已通过DevEco Studio 3.1测试，建议结合HarmonyOS SDK的最新API文档进行调整优化。