1# Popup控制 2 3给组件绑定popup弹窗，并设置弹窗内容，交互逻辑和显示状态。 4 5> **说明：** 6> 7> - 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8> 9> - popup弹窗的显示状态在onStateChange事件回调中反馈，其显隐与组件的创建或销毁无强对应关系。 10 11## bindPopup 12 13bindPopup(show: boolean, popup: PopupOptions | CustomPopupOptions) 14 15给组件绑定Popup弹窗。 16 17**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 18 19**系统能力：** SystemCapability.ArkUI.ArkUI.Full 20 21**参数：** 22 23| 参数名 | 类型 | 必填 | 说明 | 24| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 25| show | boolean | 是 | 弹窗显示状态，默认值为false，隐藏弹窗。popup弹窗必须等待页面全部构建完成才能展示，因此show不能在页面构建中设置为true，否则会导致popup弹窗显示位置及形状错误。该参数支持[!!语法](../../../quick-start/arkts-new-binding.md#组件参数双向绑定)双向绑定变量。 | 26| popup | [PopupOptions](#popupoptions类型说明) \| [CustomPopupOptions](#custompopupoptions8类型说明)<sup>8+</sup> | 是 | 配置弹出弹窗的参数。 | 27 28## PopupOptions类型说明 29 30| 名称 | 类型 | 必填 | 描述 | 31| ------------------------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 32| message | string | 是 | 弹窗信息内容。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 33| placementOnTop<sup>(deprecated)</sup> | boolean | 否 | 是否在组件上方显示，默认值为false。<br />**说明：**<br />从 API version 10 开始废弃，建议使用`placement`替代。 | 34| primaryButton | {<br/>value: string,<br/>action: () => void<br/>} | 否 | 第一个按钮。<br/>value: 弹窗里主按钮的文本。<br/>action: 点击主按钮的回调函数。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 35| secondaryButton | {<br/>value: string,<br/>action: () => void<br/>} | 否 | 第二个按钮。<br/>value: 弹窗里辅助按钮的文本。<br/>action: 点击辅助按钮的回调函数。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 36| onStateChange | (event: { isVisible: boolean }) => void | 否 | 弹窗状态变化事件回调，参数isVisible为弹窗当前的显示状态。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 37| arrowOffset<sup>9+</sup> | [Length](ts-types.md#length) | 否 | popup箭头在弹窗处的偏移。箭头在气泡上下方时，数值为0表示箭头居最左侧，偏移量为箭头至最左侧的距离，默认居中。箭头在气泡左右侧时，偏移量为箭头至最上侧的距离，默认居中。如果显示在屏幕边缘，气泡会自动左右偏移，数值为0时箭头始终指向绑定组件。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 38| showInSubWindow<sup>9+</sup> | boolean | 否 | 是否在子窗口显示气泡，默认值为false。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 39| mask<sup>10+</sup> | boolean \| { color : [ResourceColor](ts-types.md#resourcecolor) }| 否 | 设置气泡是否有遮罩层及遮罩颜色。如果设置为false，则没有遮罩层；如果设置为true，则设置有遮罩层并且颜色为透明色；如果设置为Color，则为遮罩层的颜色。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 40| messageOptions<sup>10+</sup> | [PopupMessageOptions](#popupmessageoptions10类型说明) | 否 | 设置弹窗信息文本参数。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 41| targetSpace<sup>10+</sup> | [Length](ts-types.md#length) | 否 | 设置popup与目标的间隙。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 42| placement<sup>10+</sup> | [Placement](ts-appendix-enums.md#placement8) | 否 | 设置popup组件相对于目标的显示位置，默认值为Placement.Bottom。<br />如果同时设置了`placementOnTop`和`placement`，则以`placement`的设置生效。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 43| offset<sup>10+</sup> | [Position](ts-types.md#position) | 否 | 设置popup组件相对于placement设置的显示位置的偏移。<br />**说明：**<br />不支持设置百分比。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 44| enableArrow<sup>10+</sup> | boolean | 否 | 设置是否显示箭头。<br/>默认值：true<br/>**说明：** <br/>当页面可用空间无法让气泡完全避让时，气泡会覆盖到组件上并且不显示箭头。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 45| popupColor<sup>11+</sup> | [Color](ts-appendix-enums.md#color) \| string \| number \| [Resource](ts-types.md#resource) | 否 | 提示气泡的颜色。如需去除模糊背景填充效果，需将backgroundBlurStyle设置为BlurStyle.NONE。<br/>默认值：透明色[TRANSPARENT](ts-appendix-enums.md#color)加模糊背景填充效果[COMPONENT_ULTRA_THICK](ts-universal-attributes-background.md#blurstyle9)。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 46| autoCancel<sup>11+</sup> | boolean | 否 | 页面有操作时，是否自动关闭气泡。<br/>默认值：true <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 47| width<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 弹窗宽度。<br />**说明：**<br />showInSubWindow=true时最大高度为设备屏幕高度，showInSubWindow=false时最大高度为应用窗口高度。高度限定逻辑=最大高度-状态栏高度（没有时高度为0）-dock栏高度（没有时高度为0）-40VP-40VP。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 48| arrowPointPosition<sup>11+</sup> | [ArrowPointPosition](ts-appendix-enums.md#arrowpointposition11) | 否 | 气泡尖角相对于父组件显示位置，气泡尖角在垂直和水平方向上有 ”Start“、”Center“、”End“三个位置点可选。以上所有位置点均位于父组件区域的范围内，不会超出父组件的边界范围。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 49| arrowWidth<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置箭头宽度。若所设置的箭头宽度超过所在边的长度减去两倍的气泡圆角大小，则不绘制气泡箭头。<br/>默认值：16<br/>单位：vp<br/>**说明：**<br />不支持设置百分比。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 50| arrowHeight<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置箭头高度。<br/>默认值：8<br/>单位：vp<br/>**说明：**<br />不支持设置百分比。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 51| radius<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置气泡圆角半径。<br/>默认值：20<br/>单位：vp<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 52| shadow<sup>11+</sup> | [ShadowOptions](ts-universal-attributes-image-effect.md#shadowoptions对象说明) \| [ShadowStyle](ts-universal-attributes-image-effect.md#shadowstyle10枚举说明) | 否 | 设置气泡阴影。<br/>默认值：ShadowStyle.OUTER_DEFAULT_MD <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 53| backgroundBlurStyle<sup>11+</sup> | [BlurStyle](ts-universal-attributes-background.md#blurstyle9) | 否 | 设置气泡模糊背景参数。<br />默认值：BlurStyle.COMPONENT_ULTRA_THICK<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 54| transition<sup>12+</sup> | [TransitionEffect](ts-transition-animation-component.md#transitioneffect10对象说明) | 否 | 自定义设置popup弹窗显示和退出的动画效果。<br/>**说明：**<br/>1.如果不设置，则使用默认的显示/退出动效。<br/>2.显示动效中按back键，打断显示动效，执行退出动效，动画效果为显示动效与退出动效的曲线叠加后的效果。<br/>3.退出动效中按back键，不会打断退出动效，退出动效继续执行，back键不被响应。 <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 55| onWillDismiss<sup>12+</sup> | boolean\|(dismissPopupAction: [DismissPopupAction](#dismisspopupaction12类型说明)) => void | 否 | 设置popup交互式关闭拦截开关及拦截回调函数，默认值为true，popup响应点击、左滑/右滑、三键back。<br />1.当为boolean类型时，如果设置为false，则不响应点击、左滑/右滑、三键back或键盘ESC退出事件，仅当设置“弹窗显示状态”参数show值为false时才退出；如果设置为true，则正常响应退出事件；<br />2.如果设置为函数类型，则拦截退出事件且执行回调函数。<br />**说明：**<br />在onWillDismiss回调中，不能再做onWillDismiss拦截。 <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 56| followTransformOfTarget<sup>13+</sup> | boolean | 否 | 气泡绑定的宿主组件或其宿主组件的父容器添加了旋转、缩放等变换时，气泡是否能显示在对应变化后的位置上。<br/>默认值：false <br/>**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | 57 58## PopupMessageOptions<sup>10+</sup>类型说明 59 60**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 61 62| 名称 | 类型 | 必填 | 描述 | 63| --------- | ------------------------------------------ | ---- | ------------------------------------------------------------ | 64| textColor | [ResourceColor](ts-types.md#resourcecolor) | 否 | 设置弹窗信息文本颜色。 | 65| font | [Font](ts-types.md#font) | 否 | 设置弹窗信息字体属性。<br/>**说明：** <br/>不支持设置family。 | 66 67## DismissPopupAction<sup>12+</sup>类型说明 68 69**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 70 71| 名称 | 类型 | 必填 | 描述 | 72| ------- | ----------------------------------------- | ---- | --------------------------------------------------------------- | 73| dismiss | function | 是 | popup关闭回调函数。开发者需要退出时调用，不需要退出时无需调用。 | 74| reason | [DismissReason](#dismissreason12枚举说明) | 是 | 关闭原因，返回本次拦截popup消失的事件原因。 | 75 76## DismissReason<sup>12+</sup>枚举说明 77 78 79| 名称 | 参数描述 | 80| ------------- | ------------------ | 81| PRESS_BACK | 点击Back键。 | 82| TOUCH_OUTSIDE | 点击组件外部区域。 | 83 84## CustomPopupOptions<sup>8+</sup>类型说明 85 86| 名称 | 类型 | 必填 | 描述 | 87| ---------------------------- | ---------------------------------------- | ---- | ---------------------------------------- | 88| builder | [CustomBuilder](ts-types.md#custombuilder8) | 是 | 提示气泡内容的构造器。<br />**说明：**<br />popup为通用属性，自定义popup中不支持再次弹出popup。对builder下的第一层容器组件不支持使用position属性，如果使用将导致气泡不显示。builder中若使用自定义组件，自定义组件的aboutToAppear和aboutToDisappear生命周期与popup弹窗的显隐无关，不能使用其生命周期判断popup弹窗的显隐。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 89| placement | [Placement](ts-appendix-enums.md#placement8) | 否 | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。<br/>默认值：Placement.Bottom<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 90| popupColor | number \| [Color](ts-types.md#color) \| string \| [Resource](ts-types.md#resource) | 否 | 提示气泡的颜色。如需去除模糊背景填充效果，需将backgroundBlurStyle设置为BlurStyle.NONE。<br/>API version 10，默认值：'#4d4d4d'<br />API version 11及以后，默认值：透明色[TRANSPARENT](ts-appendix-enums.md#color)加模糊背景填充效果[COMPONENT_ULTRA_THICK](ts-universal-attributes-background.md#blurstyle9)<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 91| enableArrow | boolean | 否 | 是否显示箭头。<br/>从API Version 9开始，如果箭头所在方位侧的气泡长度不足以显示下箭头，则会默认不显示箭头。比如：placement设置为Left，此时如果气泡高度小于箭头的宽度（32vp）与气泡圆角两倍（48vp）之和（80vp），则实际不会显示箭头。<br/>默认值：true<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 92| autoCancel | boolean | 否 | 页面有操作时，是否自动关闭气泡。<br/>默认值：true<br />**说明：**<br />如果要实现点击气泡内消失需要在builder中先放一个布局组件，然后再将Popup高级组件放在布局组件里面，再在布局组件的onClick事件中修改的传入bindPopup的变量（show: boolean）值。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 93| onStateChange | (event: { isVisible: boolean }) => void | 否 | 弹窗状态变化事件回调，参数为弹窗当前的显示状态。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 94| arrowOffset<sup>9+</sup> | [Length](ts-types.md#length) | 否 | popup箭头在弹窗处的偏移。箭头在气泡上下方时，数值为0表示箭头居最左侧，偏移量为箭头至最左侧的距离，默认居中。箭头在气泡左右侧时，偏移量为箭头至最上侧的距离，默认居中。如果显示在屏幕边缘，气泡会自动左右偏移，数值为0时箭头始终指向绑定组件。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 95| showInSubWindow<sup>9+</sup> | boolean | 否 | 是否在子窗口显示气泡，默认值为false。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 96| maskColor<sup>(deprecated)</sup> | [Resource](ts-types.md#resource) \| string \| number \| [Color](ts-types.md#color) | 否 | 设置气泡遮罩层颜色。<br />**说明：**<br />从 API version 10 开始废弃，建议使用`mask`替代。 | 97| mask<sup>10+</sup> | boolean \| { color : [ResourceColor](ts-types.md#resourcecolor) }| 否 | 设置气泡是否有遮罩层及遮罩颜色。如果设置为false，则没有遮罩层；如果设置为true，则设置有遮罩层并且颜色为透明色；如果设置为Color，则为遮罩层的颜色。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 98| targetSpace<sup>10+</sup> | [Length](ts-types.md#length) | 否 | 设置popup与目标的间隙。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 99| offset<sup>10+</sup> | [Position](ts-types.md#position) | 否 | 设置popup组件相对于placement设置的显示位置的偏移。<br />**说明：**<br />不支持设置百分比。<br />**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 100| width<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 弹窗宽度。<br />**说明：**<br />showInSubWindow=true时最大高度为设备屏幕高度，showInSubWindow=false时最大高度为应用窗口高度。高度限定逻辑=最大高度-状态栏高度（没有时高度为0）-dock栏高度（没有时高度为0）-40VP-40VP。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 101| arrowPointPosition<sup>11+</sup> | [ArrowPointPosition](ts-appendix-enums.md#arrowpointposition11) | 否 | 气泡尖角相对于父组件显示位置，气泡尖角在垂直和水平方向上有 ”Start“、”Center“、”End“三个位置点可选。以上所有位置点均位于父组件区域的范围内，不会超出父组件的边界范围。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 102| arrowWidth<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置箭头宽度。若所设置的箭头宽度超过所在边的长度减去两倍的气泡圆角大小，则不绘制气泡箭头。<br/>默认值：16<br/>单位：vp<br />**说明：**<br />不支持设置百分比。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 103| arrowHeight<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置箭头高度。<br/>默认值：8<br/>单位：vp<br />**说明：**<br />不支持设置百分比。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 104| radius<sup>11+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置气泡圆角半径。<br/>默认值：20<br/>单位：vp<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 105| shadow<sup>11+</sup> | [ShadowOptions](ts-universal-attributes-image-effect.md#shadowoptions对象说明) \| [ShadowStyle](ts-universal-attributes-image-effect.md#shadowstyle10枚举说明) | 否 | 设置气泡阴影。<br/>默认值：ShadowStyle.OUTER_DEFAULT_MD <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 106| backgroundBlurStyle<sup>11+</sup> | [BlurStyle](ts-universal-attributes-background.md#blurstyle9) | 否 | 设置气泡模糊背景参数。<br />默认值：BlurStyle.COMPONENT_ULTRA_THICK <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 107| focusable<sup>11+</sup> | boolean | 否 | 设置气泡弹出后是否获焦。<br />默认值：false <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 108| transition<sup>12+</sup> | [TransitionEffect](ts-transition-animation-component.md#transitioneffect10对象说明) | 否 | 自定义设置popup弹窗显示和退出的动画效果。<br/>**说明：**<br/>如果不设置，则使用默认的显示/退出动效。<br/>2.显示动效中按back键，打断显示动效，执行退出动效，动画效果为显示动效与退出动效的曲线叠加后的效果。<br/>3.退出动效中按back键，不会打断退出动效，退出动效继续执行，back键不被响应。 <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 109| onWillDismiss<sup>12+</sup> | boolean\|(dismissPopupAction: [DismissPopupAction](#dismisspopupaction12类型说明)) => void | 否 | 设置popup交互式关闭拦截开关及拦截回调函数，默认值为true，popup响应点击、左滑/右滑、三键back。<br />1.当为boolean类型时，如果设置为false，则不响应点击、左滑/右滑、三键back或键盘ESC退出事件，仅当设置“弹窗显示状态”参数show值为false时才退出；如果设置为true，则正常响应退出事件；<br />2.如果设置为函数类型，则拦截退出事件且执行回调函数。<br />**说明：**<br />在onWillDismiss回调中，不能再做onWillDismiss拦截。 <br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 110| followTransformOfTarget<sup>13+</sup> | boolean | 否 | 气泡绑定的宿主组件或其宿主组件的父容器添加了旋转、缩放等变换时，气泡是否能显示在对应变化后的位置上。<br/>默认值：false <br/>**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 | 111 112## 示例 113 114### 示例1（弹出不同类型的气泡） 115 116该示例为bindPopup通过配置popup弹出PopupOptions、CustomPopupOptions类型的气泡。 117 118```ts 119// xxx.ets 120@Entry 121@Component 122struct PopupExample { 123 @State handlePopup: boolean = false 124 @State customPopup: boolean = false 125 126 // popup构造器定义弹框内容 127 @Builder popupBuilder() { 128 Row({ space: 2 }) { 129 Image($r("app.media.icon")).width(24).height(24).margin({ left: -5 }) 130 Text('Custom Popup').fontSize(10) 131 }.width(100).height(50).padding(5) 132 } 133 134 build() { 135 Flex({ direction: FlexDirection.Column }) { 136 // PopupOptions 类型设置弹框内容 137 Button('PopupOptions') 138 .onClick(() => { 139 this.handlePopup = !this.handlePopup 140 }) 141 .bindPopup(this.handlePopup, { 142 message: 'This is a popup with PopupOptions', 143 placementOnTop: true, 144 showInSubWindow:false, 145 primaryButton: { 146 value: 'confirm', 147 action: () => { 148 this.handlePopup = !this.handlePopup 149 console.info('confirm Button click') 150 } 151 }, 152 // 第二个按钮 153 secondaryButton: { 154 value: 'cancel', 155 action: () => { 156 this.handlePopup = !this.handlePopup 157 console.info('cancel Button click') 158 } 159 }, 160 onStateChange: (e) => { 161 console.info(JSON.stringify(e.isVisible)) 162 if (!e.isVisible) { 163 this.handlePopup = false 164 } 165 } 166 }) 167 .position({ x: 100, y: 150 }) 168 169 170 // CustomPopupOptions 类型设置弹框内容 171 Button('CustomPopupOptions') 172 .onClick(() => { 173 this.customPopup = !this.customPopup 174 }) 175 .bindPopup(this.customPopup, { 176 builder: this.popupBuilder, 177 placement: Placement.Top, 178 mask: {color:'#33000000'}, 179 popupColor: Color.Yellow, 180 enableArrow: true, 181 showInSubWindow: false, 182 onStateChange: (e) => { 183 if (!e.isVisible) { 184 this.customPopup = false 185 } 186 } 187 }) 188 .position({ x: 80, y: 300 }) 189 }.width('100%').padding({ top: 5 }) 190 } 191} 192``` 193 194 195 196### 示例2（设置气泡的文本样式） 197 198该示例为bindPopup通过配置messageOptions弹出自定义文本样式的气泡。 199 200```ts 201// xxx.ets 202 203@Entry 204@Component 205struct PopupExample { 206 @State handlePopup: boolean = false 207 208 build() { 209 Column({ space: 100 }) { 210 Button('PopupOptions').margin(100) 211 .onClick(() => { 212 this.handlePopup = !this.handlePopup 213 }) 214 .bindPopup(this.handlePopup, { 215 // PopupOptions类型气泡的内容 216 message: 'This is a popup with PopupOptions', 217 messageOptions: { 218 // 气泡的文本样式 219 textColor: Color.Red, 220 font: { 221 size: '14vp', 222 style: FontStyle.Italic, 223 weight: FontWeight.Bolder 224 } 225 }, 226 placement: Placement.Bottom, 227 enableArrow: false, // 气泡弹出时不显示箭头 228 targetSpace: '15vp', 229 onStateChange: (e) => { 230 console.info(JSON.stringify(e.isVisible)) 231 if (!e.isVisible) { 232 this.handlePopup = false 233 } 234 } 235 }) 236 }.margin(20) 237 } 238} 239``` 240 241 242 243### 示例3（设置气泡的样式） 244 245该示例为bindPopup通过配置arrowHeight、arrowWidth、radius、shadow、popupColor，实现气泡箭头以及气泡本身的样式。 246 247```ts 248// xxx.ets 249 250@Entry 251@Component 252struct PopupExample { 253 @State customPopup: boolean = false 254 @State handlePopup: boolean = false 255 256 build() { 257 Column({ space: 100 }) { 258 Button("popup") 259 .margin({ top: 50 }) 260 .onClick(() => { 261 this.customPopup = !this.customPopup 262 }) 263 .bindPopup(this.customPopup, { 264 message: "this is a popup", 265 arrowHeight: 20, // 设置气泡箭头高度 266 arrowWidth: 20, // 设置气泡箭头宽度 267 radius: 20, // 设置气泡的圆角 268 shadow: ShadowStyle.OUTER_DEFAULT_XS, // 设置气泡的阴影 269 }) 270 271 Button('PopupOptions') 272 .onClick(() => { 273 this.handlePopup = !this.handlePopup 274 }) 275 .bindPopup(this.handlePopup, { 276 width: 300, 277 message: 'This is a popup with PopupOptions', 278 arrowPointPosition: ArrowPointPosition.START, // 设置箭头的位置 279 backgroundBlurStyle: BlurStyle.NONE, // 关闭气泡的模糊背景 280 popupColor: Color.Red, // 设置气泡的背景色 281 autoCancel: true, 282 }) 283 } 284 .width('100%') 285 } 286} 287``` 288 289 290 291### 示例4（设置气泡的动效） 292 293该示例为bindPopup通过配置transition，实现气泡的显示和退出动效。 294 295```ts 296// xxx.ets 297@Entry 298@Component 299struct PopupExample { 300 @State handlePopup: boolean = false 301 @State customPopup: boolean = false 302 303 // popup构造器定义弹框内容 304 @Builder popupBuilder() { 305 Row() { 306 Text('Custom Popup with transitionEffect').fontSize(10) 307 }.height(50).padding(5) 308 } 309 310 build() { 311 Flex({ direction: FlexDirection.Column }) { 312 // PopupOptions 类型设置弹框内容 313 Button('PopupOptions') 314 .onClick(() => { 315 this.handlePopup = !this.handlePopup 316 }) 317 .bindPopup(this.handlePopup, { 318 message: 'This is a popup with transitionEffect', 319 placementOnTop: true, 320 showInSubWindow: false, 321 onStateChange: (e) => { 322 console.info(JSON.stringify(e.isVisible)) 323 if (!e.isVisible) { 324 this.handlePopup = false 325 } 326 }, 327 // 设置弹窗显示动效为透明度动效与平移动效的组合效果，无退出动效 328 transition:TransitionEffect.asymmetric( 329 TransitionEffect.OPACITY.animation({ duration: 1000, curve: Curve.Ease }).combine( 330 TransitionEffect.translate({ x: 50, y: 50 })), 331 TransitionEffect.IDENTITY) 332 }) 333 .position({ x: 100, y: 150 }) 334 335 // CustomPopupOptions 类型设置弹框内容 336 Button('CustomPopupOptions') 337 .onClick(() => { 338 this.customPopup = !this.customPopup 339 }) 340 .bindPopup(this.customPopup, { 341 builder: this.popupBuilder, 342 placement: Placement.Top, 343 showInSubWindow: false, 344 onStateChange: (e) => { 345 if (!e.isVisible) { 346 this.customPopup = false 347 } 348 }, 349 // 设置弹窗显示动效与退出动效为缩放动效 350 transition:TransitionEffect.scale({ x: 1, y: 0 }).animation({ duration: 500, curve: Curve.Ease }) 351 }) 352 .position({ x: 80, y: 300 }) 353 }.width('100%').padding({ top: 5 }) 354 } 355} 356``` 357 358 359 360### 示例5（为气泡添加事件） 361 362该示例为bindPopup通过配置onWillDismiss，实现当气泡退出时，拦截退出事件并执行回调函数。 363 364```ts 365// xxx.ets 366 367@Entry 368@Component 369struct PopupExample { 370 @State handlePopup: boolean = false 371 build() { 372 Column() { 373 Button('PopupOptions') 374 .onClick(() => { 375 this.handlePopup = true 376 }) 377 .bindPopup(this.handlePopup, { 378 message: 'This is a popup with PopupOptions', 379 messageOptions: { 380 textColor: Color.Red, 381 font: { 382 size: '14vp', 383 style: FontStyle.Italic, 384 weight: FontWeight.Bolder 385 } 386 }, 387 placement: Placement.Bottom, 388 enableArrow: false, 389 targetSpace: '15vp', 390 onStateChange: (e) => { 391 if (!e.isVisible) { 392 this.handlePopup = false 393 } 394 }, 395 onWillDismiss: ( 396 (dismissPopupAction: DismissPopupAction) => { 397 console.info("dismissReason:" + JSON.stringify(dismissPopupAction.reason)) 398 if (dismissPopupAction.reason == DismissReason.PRESS_BACK) { 399 dismissPopupAction.dismiss() 400 } 401 } 402 ) 403 }) 404 }.margin(20) 405 } 406} 407``` 408 409 410 411### 示例6（为气泡拦截退出事件） 412 413该示例通过配置onWillDismiss的boolean类型为false时，拦截气泡的退出事件。 414 415```ts 416// xxx.ets 417 418@Entry 419@Component 420struct PopupExample { 421 @State handlePopup: boolean = false 422 build() { 423 Column() { 424 Button('PopupOptions') 425 .onClick(() => { 426 this.handlePopup = true 427 }) 428 .bindPopup(this.handlePopup, { 429 message: 'This is a popup with PopupOptions', 430 messageOptions: { 431 textColor: Color.Red, 432 font: { 433 size: '14vp', 434 style: FontStyle.Italic, 435 weight: FontWeight.Bolder 436 } 437 }, 438 placement: Placement.Bottom, 439 enableArrow: false, 440 targetSpace: '15vp', 441 followTransformOfTarget: true, 442 onStateChange: (e) => { 443 let timer = setTimeout(()=>{this.handlePopup = false},6000) 444 if (!e.isVisible) { 445 this.handlePopup = false 446 clearTimeout(timer) 447 } 448 }, 449 onWillDismiss: false 450 }) 451 }.margin(20) 452 } 453} 454``` 455 456 457
