弹出框(Dialog)简易使用指南

在 HarmonyOS 应用开发中,弹出框(Dialog)是一种常用的 UI 组件,用于与用户进行交互并提供重要信息或获取用户的操作确认。以下是弹出框的简易使用方法:

一、导入模块

在使用弹出框之前,需要导入相应的模块。通常使用以下语句导入所需的弹出框类型:

javascript 复制代码
import { TipsDialog, SelectDialog, ConfirmDialog, AlertDialog, LoadingDialog, CustomContentDialog } from '@kit.ArkUI';

二、创建弹出框控制器

每种弹出框类型都需要一个对应的控制器来管理其显示和交互。例如,创建一个TipsDialog的控制器:

javascript 复制代码
let dialogController = new CustomDialogController({
    builder: TipsDialog({
        // 弹出框的具体配置参数
    })
});

三、配置弹出框参数

  1. 通用参数

    • controller:弹出框控制器,用于控制弹出框的显示、隐藏等操作。
    • theme(可选,从 API version 12 开始支持):主题信息,可以是自定义主题或从onWillApplyTheme中获取的主题实例。
    • themeColorMode(可选,从 API version 12 开始支持):自定义弹窗深浅色模式。
  2. 特定类型弹出框参数

    • TipsDialog

      • imageRes(必填,从 API version 12 + 支持ResourceStrPixelMap):展示的图片。
      • imageSize(可选):自定义图片尺寸,默认值为64*64vp
      • title(可选):提示弹出框标题。
      • content(可选):提示弹出框内容。
      • checkTips(可选):checkbox 的提示内容。
      • isChecked(可选,默认值为false):checkbox 的初始选中状态。
      • checkAction(可选,从 API version 12 + 推荐使用onCheckedChange):checkbox 选中状态改变时的回调函数。
      • onCheckedChange(可选,从 API version 12+):checkbox 选中状态改变事件。
      • primaryButton(可选):提示框左侧按钮的配置。
      • secondaryButton(可选):提示框右侧按钮的配置。
    • SelectDialog

      • title(必填):选择弹出框标题。
      • content(可选):选择弹出框内容。
      • selectedIndex(可选,默认值为-1):选择弹出框的初始选中项。
      • confirm(可选):选择弹出框底部按钮的配置。
      • radioContent(必填):选择弹出框的子项内容列表,每个子项包含文本和选中回调事件。
    • ConfirmDialog

      • title(必填):确认弹出框标题。
      • content(可选):确认弹出框内容。
      • checkTips(可选):checkbox 的提示内容。
      • isChecked(可选,默认值为false):checkbox 的初始选中状态。
      • onCheckedChange(可选,从 API version 12+):checkbox 选中状态改变事件。
      • primaryButton(可选):确认框左侧按钮的配置。
      • secondaryButton(可选):确认框右侧按钮的配置。
    • AlertDialog

      • primaryTitle(可选,从 API version 12+):确认框一级标题。
      • secondaryTitle(可选,从 API version 12+):确认框二级标题。
      • content(必填):确认弹出框内容。
      • primaryButton(可选):确认框左侧按钮的配置。
      • secondaryButton(可选):确认框右侧按钮的配置。
    • LoadingDialog

      • content(可选):加载弹出框内容。
    • CustomContentDialog(从 API version 12+)

      • contentBuilder(必填):弹出框内容的构建函数。
      • primaryTitle(可选):弹出框标题。
      • secondaryTitle(可选):弹出框辅助文本。
      • contentAreaPadding(可选):弹出框内容区内边距。
      • buttons(可选):弹出框操作区按钮配置数组,最多支持 4 个按钮。

四、处理按钮点击事件

在按钮的配置中,可以设置action属性来定义按钮点击时的回调函数。例如:

javascript 复制代码
primaryButton: {
    value: '取消',
    action: () => {
        console.info('取消按钮被点击');
    }
}

五、显示弹出框

通过调用控制器的open方法来显示弹出框:

javascript 复制代码
dialogController.open();

通过以上步骤,就可以在 HarmonyOS 应用中使用不同类型的弹出框与用户进行交互,提供更好的用户体验。根据具体需求选择合适的弹出框类型,并根据其参数进行配置,以满足各种场景下的信息展示和操作确认需求。

相关推荐
中微子21 分钟前
React Router 面试指南:从基础到实战
前端·react.js·前端框架
3Katrina25 分钟前
深入理解 useLayoutEffect:解决 UI "闪烁"问题的利器
前端·javascript·面试
前端_学习之路1 小时前
React--Fiber 架构
前端·react.js·架构
伍哥的传说2 小时前
React 实现五子棋人机对战小游戏
前端·javascript·react.js·前端框架·node.js·ecmascript·js
qq_424409192 小时前
uniapp的app项目,某个页面长时间无操作,返回首页
前端·vue.js·uni-app
我在北京coding2 小时前
element el-table渲染二维对象数组
前端·javascript·vue.js
布兰妮甜2 小时前
Vue+ElementUI聊天室开发指南
前端·javascript·vue.js·elementui
SevgiliD2 小时前
el-button传入icon用法可能会出现的问题
前端·javascript·vue.js
我在北京coding2 小时前
Element-Plus-全局自动引入图标组件,无需每次import
前端·javascript·vue.js
柚子8162 小时前
scroll-marker轮播组件不再难
前端·css