跳到主要内容

Rich Text 控件介绍

Rich Text 编辑带格式的长文本内容。它会加入所在 Form 的字段状态、校验和提交范围。

1. 适用场景​

常见用途:

  • 公告、说明和知识内容
  • 需要标题、列表或链接的正文
  • 后台可清洗并安全展示的 HTML 内容

2. 添加与配置​

  1. 把 Rich Text 添加到 Form Section 的 Fields 区域。
  2. 设置稳定且唯一的 Field Key / Name,并让它与后端 DTO 属性一致。
  3. 配置本页列出的组件属性,再按需要设置 Required、Help Text、Full row 和条件表达式。
  4. 在设计预览中检查初始值和布局,并使用 Form 的 Validate / Submit 验证完整数据链路。

3. 主要属性​

属性作用
Default Text设置该字段使用的初始值、内容或格式。
Max Characters限制允许的数量、长度或取值范围。
Validator定义表单绑定、提交或返回的数据形状。
Full row控制字段在设计预览和运行态中的显示方式。
Required启用或关闭该行为。

Field Key、Required、Help Text、Full row、Visible When 等通用属性由 Form 字段契约提供;本表列出的是使用 Rich Text 时最需要关注的配置。

4. 表单值与后端契约​

该字段提交的值: 一个字符串。

"<p>Please review the <strong>policy</strong>.</p>"

示例仅说明数据形状;接口仍应按业务 DTO 校验类型、范围和权限。

5. 校验、条件与交互​

所有字段都可使用 Form 的 Required、Visible When、Disabled When、Required When、Dependencies 和 Clear When Hidden。条件表达式只控制交互,不代替后端权限与校验。

组件能力: 支持 setValue,可由按钮、步骤或其他动作写入字段值。

6. 使用建议​

配置建议: 限制内容大小,并根据业务场景做转义、清洗或 Schema 校验;不要直接执行用户输入的代码或 HTML。

返回 Form 总览,了解布局、校验、提交、草稿和后端协议。