1# 列表选择弹窗 (ActionSheet) 2 3列表弹窗。 4 5> **说明:** 6> 7> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 8> 9> 本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见[UIContext](../js-apis-arkui-UIContext.md#uicontext)说明。 10> 11> 从API version 10开始,可以通过使用[UIContext](../js-apis-arkui-UIContext.md#uicontext)中的[showActionSheet](../js-apis-arkui-UIContext.md#showactionsheet)来明确UI的执行上下文。 12 13## ActionSheet 14 15### show 16 17static show(value: ActionSheetOptions) 18 19定义列表弹窗并弹出。 20 21**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 22 23**系统能力:** SystemCapability.ArkUI.ArkUI.Full 24 25**参数:** 26 27| 参数名 | 类型 | 必填 | 说明 | 28| ------ | ------------------------------------------------- | ---- | ------------------------ | 29| value | [ActionSheetOptions](#actionsheetoptions对象说明) | 是 | 配置列表选择弹窗的参数。 | 30 31## ActionSheetOptions对象说明 32 33**系统能力:** SystemCapability.ArkUI.ArkUI.Full 34 35| 名称 | 类型 | 必填 | 说明 | 36| ---------- | -------------------------- | ------- | ----------------------------- | 37| title | string \| [Resource](ts-types.md#resource) | 是 | 弹窗标题。<br/>当文本内容过长无法显示时,用省略号代替未显示的部分。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 38| subtitle<sup>10+</sup> | [ResourceStr](ts-types.md#resourcestr) | 否 | 弹窗副标题。<br/>当文本内容过长无法显示时,用省略号代替未显示的部分。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 39| message | string \| [Resource](ts-types.md#resource) | 是 | 弹窗内容。<br/>文本超长时会触发滚动条。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 40| autoCancel | boolean | 否 | 点击遮障层时,是否关闭弹窗。<br>默认值:true<br>值为true时,点击遮障层关闭弹窗,值为false时,点击遮障层不关闭弹窗。 <br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。| 41| confirm | {<br/>enabled<sup>10+</sup>?: boolean,<br/>defaultFocus<sup>10+</sup>?: boolean,<br />style<sup>10+</sup>?: [DialogButtonStyle](ts-appendix-enums.md#dialogbuttonstyle10),<br />value: string \| [Resource](ts-types.md#resource),<br/>action: () => void<br/>} | 否 | 确认Button的使能状态、默认焦点、按钮风格、文本内容和点击回调。在弹窗获焦且未进行tab键走焦时,该按钮默认响应Enter键,且多重弹窗可自动获焦连续响应。默认响应Enter键能力在defaultFocus为true时不生效。<br>enabled:点击Button是否响应,true表示Button可以响应,false表示Button不可以响应。<br />默认值:true<br />defaultFocus:设置Button是否是默认焦点,true表示Button是默认焦点,false表示Button不是默认焦点。<br />默认值:false<br />style:设置Button的风格样式。<br />默认值:DialogButtonStyle.DEFAULT<br/>value:Button文本内容。当文本内容过长无法显示时,用省略号代替未显示的部分。<br/>action: Button选中时的回调。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 42| cancel | () => void | 否 | 点击遮障层关闭dialog时的回调。 <br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | 43| alignment | [DialogAlignment](ts-methods-alert-dialog-box.md#dialogalignment枚举说明) | 否 | 弹窗在竖直方向上的对齐方式。<br>默认值:DialogAlignment.Bottom <br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。<br/>**说明**:<br/>若在UIExtension中设置showInSubWindow为true, 弹窗将基于UIExtension的宿主窗口对齐。| 44| offset | {<br/>dx: number \| string \| [Resource](ts-types.md#resource),<br/>dy: number \| string \| [Resource](ts-types.md#resource)<br/>} | 否 | 需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。<br/>不指定像素单位时,默认单位vp,如'10',等同于10。<br>弹窗相对alignment所在位置的偏移量。<br/>默认值:<br/>1.alignment设置为Top、TopStart、TopEnd时默认值为{dx: 0,dy: "40vp"} <br/>2.alignment设置为其他时默认值为{dx: 0,dy: "-40vp"} <br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。| 45| sheets | Array<[SheetInfo](#sheetinfo对象说明)> | 是 | 设置选项内容,每个选择项支持设置图片、文本和选中的回调。 <br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。| 46| maskRect<sup>10+</sup> | [Rectangle](ts-methods-alert-dialog-box.md#rectangle8类型说明) | 否 | 弹窗遮蔽层区域,在遮蔽层区域内的事件不透传,在遮蔽层区域外的事件透传。<br/>默认值:{ x: 0, y: 0, width: '100%', height: '100%' } <br/>**说明:**<br/>showInSubWindow为true时,maskRect不生效。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。| 47| showInSubWindow<sup>11+</sup> | boolean | 否 | 某弹框需要显示在主窗口之外时,是否在子窗口显示此弹窗。<br/>默认值:false,弹窗显示在应用内,而非独立子窗口。<br/>**说明**:showInSubWindow为true的弹窗无法触发显示另一个showInSubWindow为true的弹窗。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 48| isModal<sup>11+</sup> | boolean | 否 | 弹窗是否为模态窗口,模态窗口有蒙层,非模态窗口无蒙层。<br/>默认值:true,此时弹窗有蒙层。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 49| backgroundColor<sup>11+</sup> | [ResourceColor](ts-types.md#resourcecolor) | 否 | 弹窗背板颜色。<br/>默认值:Color.Transparent<br/>**说明:** <br/>当设置了backgroundColor为非透明色时,backgroundBlurStyle需要设置为BlurStyle.NONE,否则颜色显示将不符合预期效果。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 50| backgroundBlurStyle<sup>11+</sup> | [BlurStyle](ts-universal-attributes-background.md#blurstyle9) | 否 | 弹窗背板模糊材质。<br/>默认值:BlurStyle.COMPONENT_ULTRA_THICK<br/>**说明:** <br/>设置为BlurStyle.NONE即可关闭背景虚化。当设置了backgroundBlurStyle为非NONE值时,则不要设置backgroundColor,否则颜色显示将不符合预期效果。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 51| onWillDismiss<sup>12+</sup> | Callback<[DismissDialogAction](#dismissdialogaction12)> | 否 | 交互式关闭回调函数。<br/>**说明:**<br/>1.当用户执行点击遮障层关闭、左滑/右滑、三键back、键盘ESC关闭交互操作时,如果注册该回调函数,则不会立刻关闭弹窗。在回调函数中可以通过reason得到阻拦关闭弹窗的操作类型,从而根据原因选择是否能关闭弹窗。当前组件返回的reason中,暂不支持CLOSE_BUTTON的枚举值。<br/>2.在onWillDismiss回调中,不能再做onWillDismiss拦截。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 52| cornerRadius<sup>12+</sup> | [Dimension](ts-types.md#dimension10) \| [BorderRadiuses](ts-types.md#borderradiuses9) \| [LocalizedBorderRadiuses](ts-types.md#localizedborderradiuses12) | 否 | 设置背板的圆角半径。<br />可分别设置4个圆角的半径。<br />默认值:{ topLeft: '32vp', topRight: '32vp', bottomLeft: '32vp', bottomRight: '32vp' }<br /> 圆角大小受组件尺寸限制,最大值为组件宽或高的一半,若值为负,则按照默认值处理。 <br /> 百分比参数方式:以父元素弹窗宽和高的百分比来设置弹窗的圆角。<br/>**说明:**<br/>当cornerRadius属性类型为LocalizedBorderRadiuses时,支持随语言习惯改变布局顺序。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 53| borderWidth<sup>12+</sup> | [Dimension](ts-types.md#dimension10) \| [EdgeWidths](ts-types.md#edgewidths9) \| [LocalizedEdgeWidths](ts-types.md#localizededgewidths12) | 否 | 设置弹窗背板的边框宽度。<br />可分别设置4个边框宽度。<br />默认值:0<br /> 百分比参数方式:以父元素弹窗宽的百分比来设置弹窗的边框宽度。<br />当弹窗左边框和右边框大于弹窗宽度,弹窗上边框和下边框大于弹窗高度,显示可能不符合预期。<br/>**说明:**<br/>当borderWidth属性类型为LocalizedEdgeWidths时,支持随语言习惯改变布局顺序。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 54| borderColor<sup>12+</sup> | [ResourceColor](ts-types.md#resourcecolor) \| [EdgeColors](ts-types.md#edgecolors9) \| [LocalizedEdgeColors](ts-types.md#localizededgecolors12) | 否 | 设置弹窗背板的边框颜色。<br/>默认值:Color.Black<br/> 如果使用borderColor属性,需要和borderWidth属性一起使用。<br/>**说明:**<br/>当borderColor属性类型为LocalizedEdgeColors时,支持随语言习惯改变布局顺序。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 55| borderStyle<sup>12+</sup> | [BorderStyle](ts-appendix-enums.md#borderstyle) \| [EdgeStyles](ts-types.md#edgestyles9) | 否 | 设置弹窗背板的边框样式。<br/>默认值:BorderStyle.Solid。<br/> 如果使用borderStyle属性,需要和borderWidth属性一起使用。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | 56| width<sup>12+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置弹窗背板的宽度。<br />**说明:**<br>- 弹窗宽度默认最大值:400vp。<br />- 百分比参数方式:弹窗参考宽度为所在窗口的宽度,在此基础上调小或调大。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 57| height<sup>12+</sup> | [Dimension](ts-types.md#dimension10) | 否 | 设置弹窗背板的高度。<br />**说明:**<br />- 弹窗高度默认最大值:0.9 *(窗口高度 - 安全区域)。<br />- 百分比参数方式:弹窗参考高度为(窗口高度 - 安全区域),在此基础上调小或调大。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 58| shadow<sup>12+</sup> | [ShadowOptions](ts-universal-attributes-image-effect.md#shadowoptions对象说明) \| [ShadowStyle](ts-universal-attributes-image-effect.md#shadowstyle10枚举说明) | 否 | 设置弹窗背板的阴影。 <br /> 当设备为2in1时,默认场景下获焦阴影值为ShadowStyle.OUTER_FLOATING_MD,失焦为ShadowStyle.OUTER_FLOATING_SM<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 59| transition<sup>12+</sup> | [TransitionEffect](ts-transition-animation-component.md#transitioneffect10) | 否 | 设置弹窗显示和退出的过渡效果。<br/>**说明:**<br/>1.如果不设置,则使用默认的显示/退出动效。<br/>2.显示动效中按back键,打断显示动效,执行退出动效,动画效果为显示动效与退出动效的曲线叠加后的效果。<br/>3.退出动效中按back键,不会打断退出动效,退出动效继续执行,继续按back键退出应用。 <br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。| 60| enableHoverMode<sup>14+</sup> | boolean | 否 | 是否响应悬停态。<br />默认值:false,默认不响应。<br/>**原子化服务API:** 从API version 14开始,该接口支持在原子化服务中使用。| 61| hoverModeArea<sup>14+</sup> | [HoverModeAreaType](ts-appendix-enums.md#hovermodeareatype14) | 否 | 悬停态下弹窗默认展示区域。<br />默认值:HoverModeAreaType.BOTTOM_SCREEN。<br/>**原子化服务API:** 从API version 14开始,该接口支持在原子化服务中使用。| 62| levelMode<sup>15+</sup> | [LevelMode](#levelmode15) | 否 | 设置弹窗显示层级。<br />**说明:**<br />- 默认值:LevelMode.OVERLAY。<br />- 当且仅当showInSubWindow属性设置为false时生效。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。| 63| levelUniqueId<sup>15+</sup> | number | 否 | 设置页面级弹窗需要显示的层级下的[节点 uniqueId](../js-apis-arkui-frameNode.md#getuniqueid12)。<br />**说明:**<br />- 当且仅当levelMode属性设置为LevelMode.EMBEDDED时生效。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。| 64| immersiveMode<sup>15+</sup> | [ImmersiveMode](#immersivemode15) | 否 | 设置页面内弹窗蒙层效果。<br />**说明:**<br />- 默认值:ImmersiveMode.DEFAULT <br />- 当且仅当levelMode属性设置为LevelMode.EMBEDDED时生效。<br/>**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。| 65 66## SheetInfo对象说明 67 68**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 69 70**系统能力:** SystemCapability.ArkUI.ArkUI.Full 71 72| 名称 | 类型 | 必填 | 说明 | 73| ------ | ------------------------------------------------------------ | ---- | ----------------- | 74| title | string \| [Resource](ts-types.md#resource) | 是 | 选项的文本内容。<br/>文本超长时会触发滚动条。| 75| icon | string \| [Resource](ts-types.md#resource) | 否 | 选项的图标,默认无图标显示。<br>string格式可用于加载网络图片和本地图片,常用于加载网络图片。当使用相对路径引用本地图片时,例如Image("common/test.jpg")。| 76| action | ()=>void | 是 | 选项选中的回调。 | 77 78## levelMode<sup>15+</sup> 79 80type LevelMode = LevelMode 81 82弹窗的显示层级。 83 84**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 85 86**系统能力:** SystemCapability.ArkUI.ArkUI.Full 87 88| 类型 | 说明 | 89| ----------------------------------------------------------- | -------------------- | 90| [LevelMode](../js-apis-promptAction.md#levelmode15枚举说明) | 设置弹窗的显示层级。 | 91 92## ImmersiveMode<sup>15+</sup> 93 94type ImmersiveMode = ImmersiveMode 95 96弹窗的蒙层效果。 97 98**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。 99 100**系统能力:** SystemCapability.ArkUI.ArkUI.Full 101 102| 类型 | 说明 | 103| ------------------------------------------------------------ | -------------------------- | 104| [ImmersiveMode](../js-apis-promptAction.md#immersivemode15枚举说明) | 设置页面内弹窗的蒙层效果。 | 105 106## DismissDialogAction<sup>12+</sup> 107 108Dialog关闭的信息。 109 110**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 111 112**系统能力:** SystemCapability.ArkUI.ArkUI.Full 113 114### 属性 115 116| 名称 | 类型 | 可读 | 可写 | 说明 | 117| ------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | 118| dismiss | Callback<void> | 否 | 否 | Dialog关闭回调函数。开发者需要退出时调用,不需要退出时无需调用。 | 119| reason | [DismissReason](../js-apis-promptAction.md#dismissreason12枚举说明) | 否 | 否 | Dialog无法关闭原因。根据开发者需要选择不同操作下,Dialog是否需要关闭。 | 120 121## 示例 122 123> **说明:** 124> 125> 推荐通过使用[UIContext](../js-apis-arkui-UIContext.md#uicontext)中的[showActionSheet](../js-apis-arkui-UIContext.md#showactionsheet)来明确UI的执行上下文。 126 127### 示例1(弹出列表选择弹窗) 128 129该示例通过点击按钮弹窗列表选择弹窗。 130 131```ts 132@Entry 133@Component 134struct ActionSheetExample { 135 build() { 136 Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { 137 Button('Click to Show ActionSheet') 138 .onClick(() => { 139 ActionSheet.show({ // 建议使用 this.getUIContext().showActionSheet()接口 140 title: 'ActionSheet title', 141 subtitle: 'ActionSheet subtitle', 142 message: 'message', 143 autoCancel: true, 144 confirm: { 145 defaultFocus: true, 146 value: 'Confirm button', 147 action: () => { 148 console.log('Get Alert Dialog handled') 149 } 150 }, 151 cancel: () => { 152 console.log('actionSheet canceled') 153 }, 154 onWillDismiss:(dismissDialogAction: DismissDialogAction)=> { 155 console.info("reason=" + JSON.stringify(dismissDialogAction.reason)) 156 console.log("dialog onWillDismiss") 157 if (dismissDialogAction.reason == DismissReason.PRESS_BACK) { 158 dismissDialogAction.dismiss() 159 } 160 if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) { 161 dismissDialogAction.dismiss() 162 } 163 }, 164 alignment: DialogAlignment.Bottom, 165 offset: { dx: 0, dy: -10 }, 166 sheets: [ 167 { 168 title: 'apples', 169 action: () => { 170 console.log('apples') 171 } 172 }, 173 { 174 title: 'bananas', 175 action: () => { 176 console.log('bananas') 177 } 178 }, 179 { 180 title: 'pears', 181 action: () => { 182 console.log('pears') 183 } 184 } 185 ] 186 }) 187 }) 188 }.width('100%') 189 .height('100%') 190 } 191} 192``` 193 194 195 196### 示例2(可在主窗外弹出的弹窗) 197 198在2in1设备上设置showInSubWindow为true时,可以弹出在主窗外显示的弹窗。 199 200```ts 201@Entry 202@Component 203struct ActionSheetExample { 204 build() { 205 Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { 206 Button('Click to Show ActionSheet') 207 .onClick(() => { 208 ActionSheet.show({ 209 title: 'ActionSheet title', 210 subtitle: 'ActionSheet subtitle', 211 message: 'message', 212 autoCancel: true, 213 showInSubWindow: true, 214 isModal: true, 215 confirm: { 216 defaultFocus: true, 217 value: 'Confirm button', 218 action: () => { 219 console.log('Get Alert Dialog handled') 220 } 221 }, 222 cancel: () => { 223 console.log('actionSheet canceled') 224 }, 225 onWillDismiss:(dismissDialogAction: DismissDialogAction)=> { 226 console.info("reason=" + JSON.stringify(dismissDialogAction.reason)) 227 console.log("dialog onWillDismiss") 228 if (dismissDialogAction.reason == DismissReason.PRESS_BACK) { 229 dismissDialogAction.dismiss() 230 } 231 if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) { 232 dismissDialogAction.dismiss() 233 } 234 }, 235 alignment: DialogAlignment.Center, 236 offset: { dx: 0, dy: -10 }, 237 sheets: [ 238 { 239 title: 'apples', 240 action: () => { 241 console.log('apples') 242 } 243 }, 244 { 245 title: 'bananas', 246 action: () => { 247 console.log('bananas') 248 } 249 }, 250 { 251 title: 'pears', 252 action: () => { 253 console.log('pears') 254 } 255 } 256 ] 257 }) 258 }) 259 }.width('100%') 260 .height('100%') 261 } 262} 263``` 264 265 266 267### 示例3(设置弹窗的动画) 268该示例通过配置transition实现弹窗的显示和消失动画。 269 270```ts 271@Entry 272@Component 273struct ActionSheetExample { 274 build() { 275 Column({ space: 5 }) { 276 Button('ActionSheet Set Duration') 277 .onClick(() => { 278 ActionSheet.show({ 279 title: 'ActionSheet 1', 280 message: 'Set Animation Duration open 3 second, close 100 ms', 281 autoCancel: true, 282 alignment: DialogAlignment.Top, 283 transition:TransitionEffect.asymmetric(TransitionEffect.OPACITY 284 .animation({ duration: 3000, curve: Curve.Sharp }).combine(TransitionEffect.scale({x: 1.5, y: 1.5}).animation({duration: 3000, curve: Curve.Sharp})), 285 TransitionEffect.OPACITY.animation({ duration: 100, curve: Curve.Smooth }) 286 .combine(TransitionEffect.scale({x: 0.5, y: 0.5}).animation({duration: 100, curve: Curve.Smooth}))), 287 offset: { dx: 0, dy: -20 }, 288 confirm: { 289 value: 'button', 290 action: () => { 291 console.info('Button-clicking callback') 292 } 293 }, 294 cancel: () => { 295 console.info('Closed callbacks') 296 }, 297 sheets: [ 298 { 299 title: 'apples', 300 action: () => { 301 console.log('apples') 302 } 303 }, 304 { 305 title: 'bananas', 306 action: () => { 307 console.log('bananas') 308 } 309 }, 310 { 311 title: 'pears', 312 action: () => { 313 console.log('pears') 314 } 315 } 316 ] 317 }) 318 }).backgroundColor(0x317aff).height("88px") 319 }.width('100%').margin({ top: 5 }) 320 } 321} 322``` 323 324 325 326### 示例4(设置弹窗的样式) 327该示例定义了ActionSheet的样式,如宽度、高度、背景色、阴影等等。 328```ts 329@Entry 330@Component 331struct ActionSheetExample { 332 build() { 333 Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center }) { 334 Button('Click to Show ActionSheet') 335 .onClick(() => { 336 ActionSheet.show({ 337 title: 'ActionSheet title', 338 subtitle: 'ActionSheet subtitle', 339 message: 'message', 340 autoCancel: true, 341 width: 300, 342 height: 350, 343 cornerRadius: 20, 344 borderWidth: 1, 345 borderStyle: BorderStyle.Solid,//使用borderStyle属性,需要和borderWidth属性一起使用 346 borderColor: Color.Blue,//使用borderColor属性,需要和borderWidth属性一起使用 347 backgroundColor: Color.White, 348 shadow: ({ radius: 20, color: Color.Grey, offsetX: 50, offsetY: 0}), 349 confirm: { 350 defaultFocus: true, 351 value: 'Confirm button', 352 action: () => { 353 console.log('Get Alert Dialog handled') 354 } 355 }, 356 cancel: () => { 357 console.log('actionSheet canceled') 358 }, 359 onWillDismiss:(dismissDialogAction: DismissDialogAction)=> { 360 console.info("reason=" + JSON.stringify(dismissDialogAction.reason)) 361 console.log("dialog onWillDismiss") 362 if (dismissDialogAction.reason == DismissReason.PRESS_BACK) { 363 dismissDialogAction.dismiss() 364 } 365 if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) { 366 dismissDialogAction.dismiss() 367 } 368 }, 369 alignment: DialogAlignment.Bottom, 370 offset: { dx: 0, dy: -10 }, 371 sheets: [ 372 { 373 title: 'apples', 374 action: () => { 375 console.log('apples') 376 } 377 }, 378 { 379 title: 'bananas', 380 action: () => { 381 console.log('bananas') 382 } 383 }, 384 { 385 title: 'pears', 386 action: () => { 387 console.log('pears') 388 } 389 } 390 ] 391 }) 392 }) 393 }.width('100%') 394 } 395} 396``` 397 398 399 400### 示例5(悬停态弹窗) 401 402该示例展示了在折叠屏悬停态下设置dialog布局区域的效果。 403 404```ts 405@Entry 406@Component 407struct ActionSheetExample { 408 build() { 409 Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { 410 Button('Click to Show ActionSheet') 411 .onClick(() => { 412 ActionSheet.show({ // 建议使用 this.getUIContext().showActionSheet()接口 413 title: 'ActionSheet title', 414 subtitle: 'ActionSheet subtitle', 415 message: 'message', 416 autoCancel: true, 417 confirm: { 418 defaultFocus: true, 419 value: 'Confirm button', 420 action: () => { 421 console.log('Get Alert Dialog handled') 422 } 423 }, 424 cancel: () => { 425 console.log('actionSheet canceled') 426 }, 427 onWillDismiss:(dismissDialogAction: DismissDialogAction)=> { 428 console.info("reason=" + JSON.stringify(dismissDialogAction.reason)) 429 console.log("dialog onWillDismiss") 430 if (dismissDialogAction.reason == DismissReason.PRESS_BACK) { 431 dismissDialogAction.dismiss() 432 } 433 if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) { 434 dismissDialogAction.dismiss() 435 } 436 }, 437 alignment: DialogAlignment.Bottom, 438 offset: { dx: 0, dy: -10 }, 439 enableHoverMode: true, 440 hoverModeArea: HoverModeAreaType.TOP_SCREEN, 441 sheets: [ 442 { 443 title: 'apples', 444 action: () => { 445 console.log('apples') 446 } 447 }, 448 { 449 title: 'bananas', 450 action: () => { 451 console.log('bananas') 452 } 453 }, 454 { 455 title: 'pears', 456 action: () => { 457 console.log('pears') 458 } 459 } 460 ] 461 }) 462 }) 463 }.width('100%') 464 .height('100%') 465 } 466} 467``` 468 469 470