弹出框

HarmonyOS next之弹出框（Dialog）简易使用指南

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

一、导入模块

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

import { TipsDialog, SelectDialog, ConfirmDialog, AlertDialog, LoadingDialog, CustomContentDialog } from '@kit.ArkUI';

二、创建弹出框控制器

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

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

三、配置弹出框参数

1. 通用参数

   • controller：弹出框控制器，用于控制弹出框的显示、隐藏等操作。
   • theme（可选，从 API version 12 开始支持）：主题信息，可以是自定义主题或从onWillApplyTheme中获取的主题实例。
   • themeColorMode（可选，从 API version 12 开始支持）：自定义弹窗深浅色模式。

2. 特定类型弹出框参数

   • TipsDialog

     ：

     • imageRes（必填，从 API version 12 + 支持ResourceStr或PixelMap）：展示的图片。
     • 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属性来定义按钮点击时的回调函数。例如：

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

五、显示弹出框

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

dialogController.open();

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