跳到主要内容

弹窗

适用场景

用于实现基础的弹窗(对话框)展示效果

基础能力说明

弹窗内容搭建

弹窗组件内容提供了插槽,用户可直接拖拽文本等组件放入其中,按需构建内容

通过组件内置方法控制弹窗关闭/开启

  1. 在组件的「事件」属性的其他触发事件中,提供了点击关闭按钮、点击底部默认按钮 2 个事件触发条件

  2. 点击关闭按钮:点击弹窗右上角关闭按钮时触发

  3. 点击底部默认按钮:点击弹窗底部预置的按钮时触发

  4. 以下说明仅演示「点击弹窗左上角触发弹窗关闭的方法」,如需通过点击底部默认按钮或其他操作触发弹窗的关闭/开启,与本操作配置同理

  5. 设置事件:点击关闭按钮时,触发组件方法,组件 ID 选择当前弹窗组件,执行方法选择「关闭弹窗」,保存该设置,则可以实现关闭弹窗(当前页面的任意组件的任一事件,均可触发弹窗组件中打开窗口、关闭窗口、切换窗口开关状态这几个方法,可按需配置)

通过组件内置方法控制弹窗关闭

扩展场景说明

使用变量控制弹窗的开启/关闭

在实际应用搭建过程中,我们经常会遇到点击按钮后弹出弹窗的场景,实现方式如下:

  1. 创建一个 boolean 类型的普通变量,并将默认值设置为 false

  1. 将弹窗组件的”显示窗口“属性与上一步中创建的普通变量进行绑定,可以看到绑定完成后弹窗组件变为了隐藏状态

  1. 创建一个按钮组件,并为按钮组件配置点击时触发变量赋值方法,配置方式如下图所示:

  1. 配置完成后,在预览区点击按钮组件,可以看到弹窗成功被调起

弹窗组件同样需要通过变量实现关闭,实现方式与上文相似,通过弹窗的 close 事件进行变量赋值,实现弹窗的关闭

属性介绍

组件接收的外部传入的属性

属性名
属性标识
类型
属性分组
默认值
说明
文案contentstring基础属性""更改弹窗内展示的文案内容
显示窗口visibleboolean基础属性true开启后,将会展示弹窗窗口
显示按钮isDefaultButtonboolean基础属性true开启后,弹窗下方按钮将会展示

事件介绍

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
点击关闭按钮close兼容三端-
点击底部默认按钮comfirm兼容三端-