跳到主要内容

评论

评论组件用于在页面中提供评论互动能力，用户可发表评论并 @ 提及他人，常用于详情页的协作讨论。

概述​

将「评论」拖入画布后，在属性抽屉中配置输入框占位文案。运行时组件会：

  • 展示评论输入框，支持 @ 提及用户（用户列表来自平台内置的数据源）。
  • 在下方按时间顺序列出该数据下的评论。
  • 评论作者本人可编辑、删除自己的评论。

评论与页面上下文中的数据 ID 关联，因此适合放在详情页中展示某条数据下的讨论。

配置项​

配置项说明
占位提示评论输入框的占位文案，为空时使用默认文案

运行行为​

评论必须绑定到「某条数据」，因此组件在运行时完全依赖页面上下文中的归属信息：

  • 评论按所属页面（MetaPageId）与数据 ID（DataId）归属；页面上下文中需能解析出数据 ID，评论才会按当前数据分组展示。
  • @ 提及的用户列表来自平台内置的用户信息数据源，输入时按关键字实时检索。
  • 评论作者本人可编辑、删除自己的评论。

使用建议​

  1. 评论组件通常放置在详情页底部。
  2. 页面上下文中需包含数据 ID，评论才会按当前数据归属展示。

下一步​

属性明细​

以下内容面向技术实现与 AI 检索。组件的全部配置项均存放在节点的 meta 中，且所有 meta 值统一以字符串形式存储。

组件属性（meta）​

属性名类型含义取值/存储值
Placeholderstring输入框占位文案文本，为空时使用组件默认文案

存储示例​

以下为一个完整的 WidgetItem 节点，其中 uid 为该组件在侧边栏中的固定 GUID：

{
  "id": "7d2b4f6a-8c31-4e59-9a02-6b3c5d7e8f90",
  "uid": "1baaf54c-d81f-47da-b820-4d279a4bfb4f",
  "dragType": "Widget",
  "originalType": "Widget",
  "widgetType": "Comment",
  "widgetTypeName": "评论",
  "meta": {
    "Placeholder": "写下你的评论…"
  },
  "children": []
}

相关接口​

接口说明
POST /api/Comment/GetList获取当前数据的评论列表，入参含 MetaPageId、DataId
POST /api/Comment/Add新增评论
POST /api/Comment/Update更新评论
POST /api/Comment/Delete删除评论