跳到主要内容

警告提示

警告提示用于在页面中展示一段需要用户注意的提示信息，支持多种语义类型、图标与横幅样式。

概述​

将「警告提示」拖入画布后，在属性抽屉中配置消息内容、描述、类型、图标与横幅开关。消息与描述均支持系统环境变量占位符，未配置时使用默认文案。

配置项​

配置项说明
消息提示的主内容，即组件的标题
描述提示的补充说明
类型语义类型：success / info / warning / error，默认 info
显示图标是否在提示前显示对应类型的图标，默认关闭
横幅开启后以整行横幅样式展示，适合页面顶部的通栏提示

使用建议​

  1. 页面顶部的通栏提示建议开启「横幅」。
  2. 类型与语义保持一致（成功用 success、警告用 warning），以符合用户的视觉预期。

下一步​

属性明细​

以下内容面向技术实现与 AI 检索。所有 meta 键值均以字符串形式存储。

组件属性（meta）​

属性名类型含义取值/存储值
Messagestring提示主内容文本，支持系统环境变量占位符，默认 这是一个提示
Descriptionstring提示描述文本，支持系统环境变量占位符，默认空
Typestring语义类型success / info（默认） / warning / error
IconVisiblestring(boolean)是否显示图标true / false（默认）
Bannerstring(boolean)是否横幅样式true / false（默认）

GetSidebarItemMeta() 默认仅写入 Message（默认文案）与 Type（info），其余键在用户配置后写入。uid 固定为 36afb862-c0ab-4248-b017-56bd67d9bccb。

存储示例​

组件通常位于列（Column）内，以下为嵌套在行（Row）→ 列（Column）中的完整存储结构：

{
  "id": "a1b2c3d4-0001-4a2b-8c3d-1234567890ab",
  "uid": "5a0f3c1e-9b8d-4f6a-9c2e-7d1b4a8e6f3d",
  "dragType": "Row",
  "originalType": "Row",
  "widgetType": "Row",
  "widgetTypeName": "基础容器",
  "meta": {
    "ColumnSpace": "5"
  },
  "children": [
    {
      "id": "a1b2c3d4-0002-4a2b-8c3d-1234567890ab",
      "uid": "7b9a905e-83d4-452b-83c8-694a3e0935e3",
      "dragType": "Column",
      "originalType": "Column",
      "widgetType": "Column",
      "widgetTypeName": "布局列组件",
      "meta": {
        "LayoutType": "vertical",
        "Align": "default",
        "ItemSpace": "5"
      },
      "children": [
        {
          "id": "a1b2c3d4-0003-4a2b-8c3d-1234567890ab",
          "uid": "36afb862-c0ab-4248-b017-56bd67d9bccb",
          "dragType": "Widget",
          "originalType": "Widget",
          "widgetType": "Alert",
          "widgetTypeName": "警告提示",
          "meta": {
            "Message": "温馨提示",
            "Description": "请核对后再提交。",
            "Type": "info",
            "IconVisible": "true",
            "Banner": "false"
          },
          "children": []
        }
      ]
    }
  ]
}