当前位置:   article > 正文

鸿蒙Harmony应用开发—ArkTS声明式开发(模态转场设置:半模态转场)_鸿蒙bindsheet的用法

鸿蒙bindsheet的用法

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

说明:

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

不支持路由跳转。

bindSheet

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

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

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

参数:

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

说明:

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

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

SheetOptions

继承自BindOptions

名称类型必填描述
heightSheetSize | Length半模态高度,默认是LARGE。
说明:
底部弹窗竖屏时,当设置sheetDetents时,该属性设置无效。
底部弹窗竖屏时,最大高度为距离信号栏8vp。
底部弹窗横屏时,该属性设置无效,高度为距离屏幕顶部8vp。
居中弹窗和跟手弹窗设置类型为SheetSize.LARGE和SheetSize.MUDIUM无效,显示默认高度560vp。居中弹窗和跟手弹窗最小高度为320vp,最大高度为窗口短边的90%。当使用Length设置的高度和使用SheetSize.FIT_CONTENT自适应的高度大于最大高度,则显示最大高度,小于最小高度,则显示最小高度。
detents11+[(SheetSize | Length), ( SheetSize | Length)?, (SheetSize | Length)?]半模态页面的切换高度档位。
说明:
底部弹窗竖屏生效,元组中第一个高度为初始高度。
面板可跟手滑动切换档位,松手后是否滑动至目标档位有两个判断条件:速度和距离。速度超过阈值,则执行滑动至与手速方向一致的目标档位;速度小于阈值,则引入距离判断条件,当位移距离>当前位置与目标位置的1/2,滑动至与手速方向一致的目标档位,位移距离当前位置与目标位置的1/2,返回至当前档位。速度阈值:1000,距离阈值:50%。
preferType11+SheetType.CENTER | SheetType.POPUP半模态页面的样式。
说明:
preferType不可设置为SheetType.BOTTOM。
showClose11+boolean | Resource是否显示关闭图标,默认显示。
说明:
Resource需要为boolean类型。
dragBarboolean是否显示控制条。
说明:
半模态面板的dentents属性设置多个不同高度并且设置生效时,默认显示控制条。否则不显示控制条。
backgroundColorResourceColor半模态页面的背板颜色。
blurStyle11+BlurStyle半模态面板的模糊背景。默认无模糊背景。
maskColorResourceColor半模态页面的背景蒙层颜色。
title11+SheetTitleOptions | CustomBuilder半模态面板的标题。
enableOutsideInteractive11+boolean半模态所在页面是否允许交互。
说明:
设置为true时允许交互,不显示蒙层;设置为false时不允许交互,显示蒙层;若不进行设置,默认底部弹窗与居中弹窗不允许交互,跟手弹窗允许交互。当设置为true时,maskColor设置无效。
onAppear() => void半模态页面显示回调函数。
onDisappear() => void半模态页面回退回调函数。
shouldDismiss11+(sheetDismiss: SheetDismiss) => void半模态页面交互式关闭回调函数。
说明:
当用户执行下拉关闭/back事件/点击蒙层关闭/关闭按钮关闭交互操作时,如果注册该回调函数,则不会立刻关闭。

SheetSize枚举说明

名称参数描述
MEDIUM指定半模态高度为屏幕高度一半。
LARGE指定半模态高度几乎为屏幕高度。
FIT_CONTENT11+指定半模态高度为适应内容的高度。

BindOptions

名称类型必填说明
backgroundColorResourceColor半模态页面的背板颜色。
onAppear() => void半模态页面显示回调函数。
onDisappear() => void半模态页面回退回调函数。

SheetType11+枚举说明

名称参数描述
BOTTOM底部弹窗。
CENTER居中弹窗。
POPUP跟手弹窗。跟手弹窗面板不支持跟手滑动,下滑面板不关闭。

SheetDismiss11+

名称类型必填描述
dismiss() => void半模态面板关闭回调函数。开发者需要退出时调用,不需要退出时无需调用。

SheetTitleOptions11+

名称类型必填描述
titleResourceStr半模态面板的主标题。
subtitleResourceStr半模态面板的副标题。

示例1

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct SheetTransitionExample {
  5. @State isShow:boolean = false
  6. @State isShow2:boolean = false
  7. @State sheetHeight:number = 300;
  8. @State showDragBar:boolean = true;
  9. @Builder myBuilder() {
  10. Column() {
  11. Button("change height")
  12. .margin(10)
  13. .fontSize(20)
  14. .onClick(()=>{
  15. this.sheetHeight = 500;
  16. })
  17. Button("Set Illegal height")
  18. .margin(10)
  19. .fontSize(20)
  20. .onClick(()=>{
  21. this.sheetHeight = -1;
  22. })
  23. Button("close dragBar")
  24. .margin(10)
  25. .fontSize(20)
  26. .onClick(()=>{
  27. this.showDragBar = false;
  28. })
  29. Button("close modal 1")
  30. .margin(10)
  31. .fontSize(20)
  32. .onClick(()=>{
  33. this.isShow = false;
  34. })
  35. }
  36. .width('100%')
  37. .height('100%')
  38. }
  39. build() {
  40. Column() {
  41. Button("transition modal 1")
  42. .onClick(() => {
  43. this.isShow = true
  44. })
  45. .fontSize(20)
  46. .margin(10)
  47. .bindSheet($$this.isShow, this.myBuilder(), {height: this.sheetHeight, dragBar: this.showDragBar, backgroundColor: Color.Green, onAppear: () => {console.log("BindSheet onAppear.")}, onDisappear: () => {console.log("BindSheet onDisappear.")}})
  48. }
  49. .justifyContent(FlexAlign.Center)
  50. .width('100%')
  51. .height('100%')
  52. }
  53. }

zh-cn_sheet

示例2

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct SheetTransitionExample {
  5. @State isShow:boolean = false
  6. @Builder myBuilder() {
  7. Column() {
  8. Button("content1")
  9. .margin(10)
  10. .fontSize(20)
  11. Button("content2")
  12. .margin(10)
  13. .fontSize(20)
  14. }
  15. .width('100%')
  16. }
  17. build() {
  18. Column() {
  19. Button("transition modal 1")
  20. .onClick(() => {
  21. this.isShow = true
  22. })
  23. .fontSize(20)
  24. .margin(10)
  25. .bindSheet($$this.isShow, this.myBuilder(),{
  26. detents:[SheetSize.MEDIUM,SheetSize.LARGE,200],
  27. backgroundColor:Color.Gray,
  28. blurStyle:BlurStyle.Thick,
  29. showClose:true,
  30. title:{title:"title", subtitle:"subtitle"},
  31. preferType: SheetType.CENTER,
  32. shouldDismiss:((sheetDismiss: SheetDismiss)=> {
  33. console.log("bind sheet shouldDismiss")
  34. sheetDismiss.dismiss()
  35. })
  36. })
  37. }
  38. .justifyContent(FlexAlign.Start)
  39. .width('100%')
  40. .height('100%')
  41. }
  42. }

zh-cn_sheet

最后,有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(Harmony NEXT)资料用来跟着学习是非常有必要的。 

这份鸿蒙(Harmony NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(Harmony NEXT)技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!

 获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙(Harmony NEXT)最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/你好赵伟/article/detail/849440
推荐阅读
  

闽ICP备14008679号