WAlert 提示组件
提示组件,基于 WinDesignNext Alert 封装,用于页面中展示警告、成功、错误等反馈信息。
基础用法
API
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
component | string | WAlert | 组件类型(必填) |
title | string | DataBindingValue | — | 提示标题 |
description | string | DataBindingValue | — | 提示描述 |
type | string | primary | 类型:primary / success / warning / info / error / danger |
effect | string | light | 主题:light / dark |
closable | boolean | true | 是否可关闭 |
closeText | string | DataBindingValue | — | 关闭按钮文字 |
showIcon | boolean | false | 是否显示图标 |
center | boolean | false | 文字是否居中 |
showAfter | number | 0 | 延迟显示(ms) |
hideAfter | number | 200 | 关闭动画时长(ms) |
autoClose | number | 0 | 自动关闭延时(ms),0 不自动关闭 |
action | object | — | 关闭事件配置 |
child | string | — | 自定义内容子组件 ID |
事件
| 事件 | type | 说明 |
|---|---|---|
| 关闭提示 | close | 用户点击关闭按钮时触发 |
json
{
"action": {
"event": {
"name": "onAlertClose",
"type": "close"
}
}
}path 支持说明
| 属性 | path 支持 | 说明 |
|---|---|---|
title | ✅ | 动态标题 |
description | ✅ | 动态描述正文 |
type | ✅ | 动态提示类型 |
closeText | ✅ | 动态关闭按钮文字 |
动态描述
json
{
"component": "WAlert",
"type": { "path": "/alertType" },
"title": "系统通知",
"description": { "path": "/alertMessage" }
}使用场景
| 场景 | 推荐配置 |
|---|---|
| 操作成功提示 | type: "success" + showIcon: true |
| 警告/风险提示 | type: "warning" + path 绑定描述 |
| 可关闭通知 | closable: true + action close 事件 |
| 自动消失 | autoClose: 3000 |
注意事项
description与child二选一:简单文本用description,复杂内容用child引用子组件icon、title插槽无法在 A2UI JSON 中配置,请使用属性或child