文章配图:AlertDialog 的使用方法

页面预览

前言

在应用交互中,确认对话框是最基础的弹窗形式——用于让用户确认删除、退出等关键操作。HarmonyOS 提供了 AlertDialog 系统弹窗,支持标题、内容、按钮的快速配置。

本文以「猫猫大作战」的删除战绩确认和退出游戏确认为锚点,讲解 AlertDialog 的使用方法。

提示:本系列不讲 ArkTS 基础语法与环境搭建,假设你已跟完第 1–93 篇。本篇是阶段三第 94 篇。

一、AlertDialog 基本用法

1.1 确认对话框

AlertDialog.show({
  title: '确认退出',
  message: '游戏正在进行中,确定要退出吗?',
  autoCancel: false,
  alignment: DialogAlignment.Center,
  primaryButton: {
    value: '继续游戏',
    action: () => {
      console.info('继续游戏')
    }
  },
  secondaryButton: {
    value: '退出',
    action: () => {
      console.info('退出游戏')
    }
  }
})

1.2 参数说明

参数 类型 说明
title string/ResourceStr 标题
message string/ResourceStr 内容
autoCancel boolean 点击遮罩是否关闭
alignment DialogAlignment 弹窗位置
primaryButton object 主按钮
secondaryButton object 次按钮

二、删除确认

confirmDelete(recordId: number) {
  AlertDialog.show({
    title: '删除战绩',
    message: '确定要删除这条战绩记录吗?此操作不可恢复。',
    primaryButton: {
      value: '取消',
      action: () => {}
    },
    secondaryButton: {
      value: '删除',
      fontColor: '#E74C3C',
      action: () => {
        this.deleteRecord(recordId)
      }
    }
  })
}

三、总结

AlertDialog 是系统级弹窗,适合简单的确认/提示场景。

核心要点

  • AlertDialog.show() 静态方法快速弹出
  • 支持主按钮/次按钮配置
  • 适合确认删除、退出确认等场景

下一篇预告:第 95 篇将深入 Toast 提示——操作成功/失败的轻量反馈。

如果这篇文章对你有帮助,欢迎点赞👍、收藏⭐、关注🔔,你的支持是我持续创作的动力!


相关资源:

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐