title: Alert 提示 description: type: 0 group: ⚙ 组件 menuName: Alert 提示 icon:

order: 27

用来做文字特殊提示,分为四类:提示类、成功类、警告类和危险类。

基本使用

level属性支持 4 种预设样式:info, success, warning, danger

```schema: scope=”body” [ { “type”: “alert”, “body”: “提示类文案”, “level”: “info”, “className”: “mb-1” }, { “type”: “alert”, “title”: “提示类标题”, “body”: “提示类文案”, “level”: “info”, “className”: “mb-3” }, { “type”: “alert”, “body”: “成功类文案”, “level”: “success”, “className”: “mb-1” }, { “type”: “alert”, “title”: “成功类标题”, “body”: “成功类文案”, “level”: “success”, “className”: “mb-3” }, { “type”: “alert”, “body”: “警告类文案”, “level”: “warning”, “className”: “mb-1” }, { “type”: “alert”, “title”: “警告类标题”, “body”: “警告类文案”, “level”: “warning”, “className”: “mb-3” }, { “type”: “alert”, “body”: “危险类文案”, “level”: “danger”, “className”: “mb-1” }, { “type”: “alert”, “title”: “危险类标题”, “body”: “危险类文案”, “level”: “danger”, }, ]

  1. ## 图标
  2. 配置`"showIcon": true`后展示图标让信息更加醒目。可以通过`icon`属性自定义设置 icon 内容,如果`icon`属性为空,则根据`level`值添加默认 icon
  3. ```schema: scope="body"
  4. [
  5. {
  6. "type": "alert",
  7. "body": "提示类文案",
  8. "level": "info",
  9. "showIcon": true,
  10. "className": "mb-1"
  11. },
  12. {
  13. "type": "alert",
  14. "title": "提示类标题",
  15. "body": "提示类文案",
  16. "level": "info",
  17. "showIcon": true,
  18. "className": "mb-3"
  19. },
  20. {
  21. "type": "alert",
  22. "body": "成功类文案",
  23. "level": "success",
  24. "showIcon": true,
  25. "className": "mb-1"
  26. },
  27. {
  28. "type": "alert",
  29. "title": "成功类标题",
  30. "body": "成功类文案",
  31. "level": "success",
  32. "showIcon": true,
  33. "className": "mb-3"
  34. },
  35. {
  36. "type": "alert",
  37. "body": "警告类文案",
  38. "level": "warning",
  39. "showIcon": true,
  40. "className": "mb-1"
  41. },
  42. {
  43. "type": "alert",
  44. "title": "警告类标题",
  45. "body": "警告类文案",
  46. "level": "warning",
  47. "showIcon": true,
  48. "className": "mb-3"
  49. },
  50. {
  51. "type": "alert",
  52. "body": "危险类文案",
  53. "level": "danger",
  54. "showIcon": true,
  55. "className": "mb-1"
  56. },
  57. {
  58. "type": "alert",
  59. "title": "危险类标题",
  60. "body": "危险类文案",
  61. "level": "danger",
  62. "showIcon": true,
  63. "className": "mb-3"
  64. },
  65. {
  66. "type": "alert",
  67. "body": "自定义ICON文案",
  68. "showIcon": true,
  69. "icon": "info-circle",
  70. "className": "mb-1"
  71. },
  72. {
  73. "type": "alert",
  74. "title": "自定义ICON标题",
  75. "body": "自定义ICON文案",
  76. "showIcon": true,
  77. "icon": "fa fa-list"
  78. }
  79. ]

level 支持表达式

1.6.4 及以上版本

修改下面例子的 status 值为 2 就能看到变化

  1. {
  2. "type": "page",
  3. "data": {
  4. "status": 1
  5. },
  6. "body": [
  7. {
  8. "type": "alert",
  9. "level": "${IFS(status===1, 'danger', status===2, 'warning')}",
  10. "body": "这是内容区"
  11. }
  12. ]
  13. }

同时 icon 和 showIcon 也都支持表达式

显示关闭按钮

配置"showCloseButton": true实现显示关闭按钮。

schema: scope="body" [ { "type": "alert", "body": "显示关闭按钮的提示", "level": "info", "showCloseButton": true, "showIcon": true, "className": "mb-2" }, { "type": "alert", "title": "可关闭提示", "body": "显示关闭按钮的提示", "level": "success", "showCloseButton": true, "showIcon": true } ]

属性表

属性名 类型 默认值 说明
type string "alert" 指定为 alert 渲染器
className string 外层 Dom 的类名
level string info 级别,可以是:infosuccesswarning 或者 danger
body SchemaNode 显示内容
showCloseButton boolean false 是否显示关闭按钮
closeButtonClassName string 关闭按钮的 CSS 类名
showIcon boolean false 是否显示 icon
icon string 自定义 icon
iconClassName string icon 的 CSS 类名