文章目录概述依赖导入核心结构异常提示条配置详解1. 基础配置对象 PromptOptions2. 交互事件配置代码总结概述ExceptionPrompt是 HarmonyOS ArkUI 提供的顶部异常提示条组件用于页面顶部轻量提示异常/状态信息如网络异常、权限不足、加载失败等场景。组件内置图标、提示文本、操作按钮支持自定义边距与交互事件可快速实现系统标准的异常提示效果无需自定义布局。依赖导入import{ExceptionPrompt,PromptOptions,MarginType}fromkit.ArkUI;核心结构异常提示条组件采用图标 提示文本 操作按钮的标准布局通过PromptOptions配置全部样式与状态ExceptionPrompt({options:this.options,onTipClick:提示文本点击事件,onActionTextClick:操作按钮点击事件})配置详解1. 基础配置对象 PromptOptionsStateoptions:PromptOptions{icon:$r(sys.media.ohos_ic_public_fail),// 异常图标tip:异常提示,// 提示文本marginType:MarginType.DEFAULT_MARGIN,// 边距类型actionText:设置网络,// 右侧操作按钮文本marginTop:80,// 顶部边距避免被状态栏遮挡isShown:true,// 是否显示提示条}属性作用icon提示条左侧图标系统内置失败图标也可替换为自定义资源tip中间提示文本描述异常原因如“网络连接失败”marginType边距模式DEFAULT_MARGIN为默认安全边距也可自定义actionText右侧操作按钮文本如“设置网络”“重试”marginTop顶部边距设置为80vp可避免被系统状态栏/标题栏遮挡isShown控制提示条显示/隐藏true为默认显示2. 交互事件配置onTipClick:(){// 单击左侧的文本切换到连接状态},onActionTextClick:(){// 点击“设置网络”按钮打开设置网络弹窗界面}onTipClick提示文本点击回调可用于展开详情、刷新状态onActionTextClick右侧操作按钮点击回调如跳转设置、重试加载代码import{ExceptionPrompt,PromptOptions,MarginType}fromkit.ArkUI;EntryComponentstruct Index{Stateoptions:PromptOptions{icon:$r(sys.media.ohos_ic_public_fail),tip:异常提示,marginType:MarginType.DEFAULT_MARGIN,actionText:设置网络,marginTop:80,isShown:true,}build(){Column(){ExceptionPrompt({options:this.options,onTipClick:(){// 单击左侧的文本切换到连接状态},onActionTextClick:(){// 点击“设置网络”按钮打开设置网络弹窗界面},})}}}运行效果如图总结API 版本从API 11开始支持适用模型仅支持Stage 模型设备限制不支持 Wearable 设备边距设置marginTop建议设置为状态栏高度通常为80vp左右避免被系统UI遮挡显示控制通过isShown控制提示条的显示与隐藏无需销毁组件交互限制onTipClick仅点击文本区域触发onActionTextClick仅点击右侧按钮触发如果这篇文章对你有帮助欢迎点赞、收藏、关注你的支持是持续创作的动力