当前位置:   article > 正文

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:Popup控制)

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:Popup控制)

给组件绑定popup弹窗,并设置弹窗内容,交互逻辑和显示状态。

说明:

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

  • popup弹窗的显示状态在onStateChange事件回调中反馈,其显隐与组件的创建或销毁无强对应关系。

bindPopup

bindPopup(show: boolean, popup: PopupOptions | CustomPopupOptions)

给组件绑定Popup弹窗。

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

参数:

参数名类型必填说明
showboolean弹窗显示状态,默认值为false,隐藏弹窗。
show: 弹窗显示状态,默认值为false,隐藏弹窗。popup弹窗必须等待页面全部构建完成才能展示,因此show不能在页面构建中设置为true,否则会导致popup弹窗显示位置及形状错误。
popup: 配置当前弹窗提示的参数。
popupPopupOptions | CustomPopupOptions8+配置弹出弹窗的参数。

PopupOptions类型说明

名称类型必填描述
messagestring弹窗信息内容。
placementOnTop(deprecated)boolean是否在组件上方显示,默认值为false。
说明:
从 API version 10 开始废弃,建议使用placement替代。
primaryButton{
value: string,
action: () => void
}
第一个按钮。
value: 弹窗里主按钮的文本。
action: 点击主按钮的回调函数。
secondaryButton{
value: string,
action: () => void
}
第二个按钮。
value: 弹窗里辅助按钮的文本。
action: 点击辅助按钮的回调函数。
onStateChange(event: { isVisible: boolean }) => void弹窗状态变化事件回调,参数isVisible为弹窗当前的显示状态。
arrowOffset9+Lengthpopup箭头在弹窗处的偏移。箭头在气泡上下方时,数值为0表示箭头居最左侧,偏移量为箭头至最左侧的距离,默认居中。箭头在气泡左右侧时,偏移量为箭头至最上侧的距离,默认居中。如果显示在屏幕边缘,气泡会自动左右偏移,数值为0时箭头始终指向绑定组件。
showInSubWindow9+boolean是否在子窗口显示气泡,默认值为false。
mask10+boolean | ResourceColor设置气泡是否有遮罩层及遮罩颜色。如果设置为false,则没有遮罩层;如果设置为true,则设置有遮罩层并且颜色为透明色;如果设置为Color,则为遮罩层的颜色。
messageOptions10+PopupMessageOptions设置弹窗信息文本参数。
targetSpace10+Length设置popup与目标的间隙。
placement10+Placement设置popup组件相对于目标的显示位置,默认值为Placement.Bottom。
如果同时设置了placementOnTopplacement,则以placement的设置生效。
offset10+Position设置popup组件相对于placement设置的显示位置的偏移。
说明:
不支持设置百分比。
enableArrow10+boolean设置是否显示箭头。
默认值:true
popupColor11+Color | string | number |  Resource提示气泡的颜色。
默认值:透明色TRANSPARENT加模糊背景填充效果COMPONENT_ULTRA_THICK
autoCancel11+boolean页面有操作时,是否自动关闭气泡。
默认值:true
width11+Dimension弹窗宽度。
arrowPointPosition11+ArrowPointPosition气泡尖角相对于父组件显示位置,气泡尖角在垂直和水平方向上有 ”Start“、”Center“、”End“三个位置点可选。以上所有位置点均位于父组件区域的范围内,不会超出父组件的边界范围。

PopupMessageOptions10+类型说明

名称类型必填描述
textColorResourceColor设置弹窗信息文本颜色。
fontFont设置弹窗信息字体属性。

CustomPopupOptions8+类型说明

名称类型必填描述
builderCustomBuilder提示气泡内容的构造器。
说明:
popup为通用属性,自定义popup中不支持再次弹出popup。对builder下的第一层容器组件不支持使用position属性,如果使用将导致气泡不显示。builder中若使用自定义组件,自定义组件的aboutToAppear和aboutToDisappear生命周期与popup弹窗的显隐无关,不能使用其生命周期判断popup弹窗的显隐。
placementPlacement气泡组件优先显示的位置,当前位置显示不下时,会自动调整位置。
默认值:Placement.Bottom
popupColorResourceColor提示气泡的颜色。
API version 10,默认值:'#4d4d4d'
API version 11及以后,默认值:透明色TRANSPARENT加模糊背景填充效果COMPONENT_ULTRA_THICK
enableArrowboolean是否显示箭头。
从API Version 9开始,如果箭头所在方位侧的气泡长度不足以显示下箭头,则会默认不显示箭头。比如:placement设置为Left,此时如果气泡高度小于箭头的宽度(32vp)与气泡圆角两倍(48vp)之和(80vp),则实际不会显示箭头。
默认值:true
autoCancelboolean页面有操作时,是否自动关闭气泡。
默认值:true
说明:
如果要实现点击气泡内消失需要在builder中先放一个布局组件,然后再将Popup高级组件放在布局组件里面,再在布局组件的onClick事件中修改的传入bindPopup的变量(show: boolean)值。
onStateChange(event: { isVisible: boolean }) => void弹窗状态变化事件回调,参数为弹窗当前的显示状态。
arrowOffset9+Lengthpopup箭头在弹窗处的偏移。箭头在气泡上下方时,数值为0表示箭头居最左侧,偏移量为箭头至最左侧的距离,默认居中。箭头在气泡左右侧时,偏移量为箭头至最上侧的距离,默认居中。如果显示在屏幕边缘,气泡会自动左右偏移,数值为0时箭头始终指向绑定组件。
showInSubWindow9+boolean是否在子窗口显示气泡,默认值为false。
maskColor(deprecated)ResourceColor设置气泡遮罩层颜色。
说明:
从 API version 10 开始废弃,建议使用mask替代。
mask10+boolean | ResourceColor设置气泡是否有遮罩层及遮罩颜色。如果设置为false,则没有遮罩层;如果设置为true,则设置有遮罩层并且颜色为透明色;如果设置为Color,则为遮罩层的颜色。
targetSpace10+Length设置popup与目标的间隙。
offset10+Position设置popup组件相对于placement设置的显示位置的偏移。
说明:
不支持设置百分比。
width11+Dimension弹窗宽度。
arrowPointPosition11+ArrowPointPosition气泡尖角相对于父组件显示位置,气泡尖角在垂直和水平方向上有 ”Start“、”Center“、”End“三个位置点可选。以上所有位置点均位于父组件区域的范围内,不会超出父组件的边界范围。

示例

示例1

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PopupExample {
  5. @State handlePopup: boolean = false
  6. @State customPopup: boolean = false
  7. // popup构造器定义弹框内容
  8. @Builder popupBuilder() {
  9. Row({ space: 2 }) {
  10. Image($r("app.media.image")).width(24).height(24).margin({ left: -5 })
  11. Text('Custom Popup').fontSize(10)
  12. }.width(100).height(50).padding(5)
  13. }
  14. build() {
  15. Flex({ direction: FlexDirection.Column }) {
  16. // PopupOptions 类型设置弹框内容
  17. Button('PopupOptions')
  18. .onClick(() => {
  19. this.handlePopup = !this.handlePopup
  20. })
  21. .bindPopup(this.handlePopup, {
  22. message: 'This is a popup with PopupOptions',
  23. placementOnTop: true,
  24. showInSubWindow:false,
  25. primaryButton: {
  26. value: 'confirm',
  27. action: () => {
  28. this.handlePopup = !this.handlePopup
  29. console.info('confirm Button click')
  30. }
  31. },
  32. // 第二个按钮
  33. secondaryButton: {
  34. value: 'cancel',
  35. action: () => {
  36. this.handlePopup = !this.handlePopup
  37. console.info('cancel Button click')
  38. }
  39. },
  40. onStateChange: (e) => {
  41. console.info(JSON.stringify(e.isVisible))
  42. if (!e.isVisible) {
  43. this.handlePopup = false
  44. }
  45. }
  46. })
  47. .position({ x: 100, y: 50 })
  48. // CustomPopupOptions 类型设置弹框内容
  49. Button('CustomPopupOptions')
  50. .onClick(() => {
  51. this.customPopup = !this.customPopup
  52. })
  53. .bindPopup(this.customPopup, {
  54. builder: this.popupBuilder,
  55. placement: Placement.Top,
  56. mask: {color:'0x33000000'},
  57. popupColor: Color.Yellow,
  58. enableArrow: true,
  59. showInSubWindow: false,
  60. onStateChange: (e) => {
  61. if (!e.isVisible) {
  62. this.customPopup = false
  63. }
  64. }
  65. })
  66. .position({ x: 80, y: 200 })
  67. }.width('100%').padding({ top: 5 })
  68. }
  69. }

figures/popup.gif

示例2

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PopupExample {
  5. @State handlePopup: boolean = false
  6. build() {
  7. Column() {
  8. Button('PopupOptions')
  9. .onClick(() => {
  10. this.handlePopup = !this.handlePopup
  11. })
  12. .bindPopup(this.handlePopup, {
  13. message: 'This is a popup with PopupOptions',
  14. messageOptions: {
  15. textColor: Color.Red,
  16. font: {
  17. size: '14vp',
  18. style: FontStyle.Italic,
  19. weight: FontWeight.Bolder
  20. }
  21. },
  22. placement: Placement.Bottom,
  23. enableArrow: false,
  24. targetSpace: '15vp',
  25. onStateChange: (e) => {
  26. console.info(JSON.stringify(e.isVisible))
  27. if (!e.isVisible) {
  28. this.handlePopup = false
  29. }
  30. }
  31. })
  32. }.margin(20)
  33. }
  34. }

示例3

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PopupExample {
  5. @State customPopup: boolean = false
  6. // popup构造器定义弹框内容
  7. @Builder popupBuilder() {
  8. Row() {
  9. Text('Custom Popup Message').fontSize(10)
  10. }.height(50).padding(5)
  11. }
  12. build() {
  13. Column() {
  14. // CustomPopupOptions 类型设置弹框内容
  15. Button('CustomPopupOptions')
  16. .onClick(() => {
  17. this.customPopup = !this.customPopup
  18. })
  19. .bindPopup(this.customPopup, {
  20. builder: this.popupBuilder,
  21. targetSpace: '15vp',
  22. enableArrow: false,
  23. onStateChange: (e) => {
  24. if (!e.isVisible) {
  25. this.customPopup = false
  26. }
  27. }
  28. })
  29. }.margin(20)
  30. }
  31. }

示例4

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PopupExample {
  5. @State handlePopup: boolean = false
  6. build() {
  7. Column() {
  8. Button('PopupOptions')
  9. .position({ x: 100, y: 50 })
  10. .onClick(() => {
  11. this.handlePopup = !this.handlePopup
  12. })
  13. .bindPopup(this.handlePopup, {
  14. width: 300,
  15. message: 'This is a popup with PopupOptions',
  16. arrowPointPosition: ArrowPointPosition.START,
  17. popupColor: Color.Red,
  18. autoCancel: true,
  19. })
  20. }
  21. .width('100%')
  22. .height('100%')
  23. }
  24. }

示例5

  1. // xxx.ets
  2. import { Popup , PopupOptions,PopupTextOptions, PopupButtonOptions, PopupIconOptions } from '@ohos.arkui.advanced.Popup';
  3. @Entry
  4. @Component
  5. struct PopupExample {
  6. @State customPopup: boolean = false
  7. @Builder
  8. popupBuilder() {
  9. // popup 自定义高级组件
  10. Popup({
  11. //PopupIconOptions 类型设置图标内容
  12. icon: {
  13. image: $r('app.media.icon'),
  14. width:32,
  15. height:32,
  16. fillColor:Color.White,
  17. borderRadius: 16,
  18. } as PopupIconOptions,
  19. // PopupTextOptions 类型设置文字内容
  20. title: {
  21. text: 'This is a popup with CustomPopupOptions',
  22. fontSize: 20,
  23. fontColor: Color.Black,
  24. fontWeight: FontWeight.Normal,
  25. } as PopupTextOptions,
  26. //PopupTextOptions 类型设置文字内容
  27. message: {
  28. text: 'This is the message',
  29. fontSize: 15,
  30. fontColor: Color.Black,
  31. fontWeight: FontWeight.Normal,
  32. } as PopupTextOptions,
  33. showClose: false,
  34. onClose: () => {
  35. console.info('close Button click')
  36. this.customPopup = false
  37. },
  38. // PopupButtonOptions 类型设置按钮内容
  39. buttons: [{
  40. text: 'confirm',
  41. action: () => {
  42. console.info('confirm button click')
  43. this.customPopup = false
  44. },
  45. fontSize: 15,
  46. fontColor: Color.Black,
  47. },
  48. {
  49. text: 'cancel',
  50. action: () => {
  51. console.info('cancel button click')
  52. this.customPopup = false
  53. },
  54. fontSize: 15,
  55. fontColor: Color.Black,
  56. },] as [PopupButtonOptions?, PopupButtonOptions?],
  57. })
  58. }
  59. build() {
  60. Column() {
  61. Button('CustomPopupOptions')
  62. .onClick(() => {
  63. this.customPopup = !this.customPopup
  64. })
  65. .position({ x: 80, y: 200 })
  66. .bindPopup(this.customPopup, {
  67. builder: this.popupBuilder,
  68. width: 300,
  69. arrowPointPosition: ArrowPointPosition.END,
  70. })
  71. }
  72. .width('100%')
  73. .height('100%')
  74. }
  75. }

示例6

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PopupExample {
  5. @State cursorPopup: boolean = false
  6. build() {
  7. Column() {
  8. TextInput({placeholder:'我是提示文本',text:'我是当前文本内容'})
  9. .position({ x: 0, y: 350 })
  10. .onFocus(() => {
  11. this.cursorPopup = !this.cursorPopup
  12. })
  13. .selectionMenuHidden(true)
  14. .bindPopup(this.cursorPopup, {
  15. width: 300,
  16. message: 'This is a pop-up window that appears with the cursor',
  17. arrowPointPosition: ArrowPointPosition.CENTER,
  18. popupColor: Color.Green,
  19. autoCancel: true,
  20. })
  21. }
  22. .width('100%')
  23. .height('100%')
  24. }
  25. }

最后,有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(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/248130?site
推荐阅读
相关标签
  

闽ICP备14008679号