前言
在应用交互中,确认对话框是最基础的弹窗形式——用于让用户确认删除、退出等关键操作。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 提示——操作成功/失败的轻量反馈。
如果这篇文章对你有帮助,欢迎点赞👍、收藏⭐、关注🔔,你的支持是我持续创作的动力!
相关资源:
- AlertDialog API 参考
- 开源鸿蒙跨平台社区
- 第 93 篇:Stack 暂停遮罩
- 第 95 篇:Toast 提示