# 表单组件/编辑器

来源快照：`result_data_new_260518.json`

- 来源 ID：`1222951861374672939`
- 模块：表单引擎
- 目录：表单设计 - 组件介绍
- space ID：`1965872943020001469`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、背景与概述

在使用表单搭建应用的过程中，可能会处于合同、档案等特殊业务场景需求，需要在表单中直接编辑文档内容，则可直接使用各类编辑器组件，目前支持使用的编辑器类型有：组合编辑器、内容编辑器、富文本编辑器。

二、

# 功能概述及使用说明

字段属性及布局属性通用设置不在这里详细说明，具体可以查看[组件介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002/page/1152863419640021002?freepass_doc=1&id=1966729212616030837&space_id=1965872943020001469 "组件介绍")。

（一）

## 组合编辑器

1、

### 高度

支持设置组件高度：指编辑器在前台显示的高度，该设置作用于所有编辑器，其中当设置便器类型为富文本编辑器时，此时的高度仅为内容高度，非组件高度。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098389987450889&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2、

### 编辑器设置

展示富文本编辑器、内容编辑器、markdown编辑器，若当前租户有可用的office在线编辑插件，则还需要展示word、excel、ppt，支持设置默认的编辑器、以及编辑器的排序、启用或禁用编辑器。（**需要注意，office编辑器需要相关的插件采购后才支持启用并使用** ）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098394200489992&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

富文本和内容编辑器启用后，开关后支持单个设置编辑器，点击设置按钮后弹出相应编辑器的设置面板，其中设置项的功能可直接参考下文中编辑器内的单独说明。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098394199416842&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3、

### 运行效果

当启用多个编辑器时，前台会显示切换图标，切换编辑器类型将丢失未保存的内容。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098394199416835&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（二）

## 内容编辑器

1、

### 启用默认值

该开关默认关闭，启用后，表单设计阶段在编辑器中填写的内容将作为默认值，新建表单数据时，将会把默认值自动带入到编辑器中。

若在业务场景中需要使用模版功能，比如合同管理等，此开关必须开启！才可以将设计器中搭建的模版显示在运行页面。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098389987450887&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2、

### 高度

编辑器高度支持自定义高度，以及继承容器高度，默认为自定义高度600px，支持修改其他高度，但是最小高度为300px。

继承容器高度：需要搭配【框架】组件一起使用，需要先设置外层容器高度。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098402847186957&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3、

### 菜单设置以及工具栏设置

#### 3.1 支持导出、导出功能

菜单设置支持导出、导入、保存版本、历史版本，以及自定义工具，显示位置在编辑器左上角。

其中保存版本、历史版本为版本管理功能，启用后，前台运行时需要先生成表单数据后，才显示相关的工具栏，支持当前内容存为新版本，点击历史版本按钮，可以查看历史保存的版本以及进行版本还原操作。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098394196410369&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098419944054807&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

工具栏设置，支持设置系统工具以及自定义工具，系统工具下拉框支持选择范文库、条款库、插入对象，同时也支持设置分组。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098377103433730&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 3.2 支持设置默认字体字号

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098381458194436&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

4、

### 左侧面板展开状态

支持设置预览状态下编辑器内左侧目录（大纲）默认展开/收起状态

有数据时默认展开，无数据时默认收起：左侧“文件/目录/参数”面板中任意一个页签有数据，则默认展开，所有页签均无数据，则默认收起

默认展开：打开编辑器始终展开左侧面板

默认收起：打开编辑器始终收起左侧面板

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098411393056769&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

5、

### 编辑助手

默认关闭，启用后，在编辑区域输入 “//” 或选中内容点击编辑助手，即可唤起，协助快速写作，此功能依赖AI服务，若AI不可用，则该功能不支持使用，系统内配置了默认智能体，同时也支持自定义配置智能体。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098407175708681&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

6、

### 智能对话

默认关闭，开启后将会在工具栏新增智能对话 工具，点击后在右侧划出AI对话组件，编辑器默认内置写作、润色、纠错、问答四个智能体，编辑助手以及智能对话都受AI连接器license控制，且采购服务的情况下，智能体也需要配置大模型才可正常使用

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098377087729673&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

7、

### 文档保护

该开关默认关闭，启用后，在使用编辑器时，仅“可编辑区域”允许编辑，其余内容均不允许编辑，若不存在可编辑区域，则编辑器内均为禁用模式。

在开启文档保护的同时，可搭配使用工具栏中的【纯文本控件】、【富文本控件】去添加可编辑区域。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098402769567745&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

8、

### 评论

开关默认关闭，启用后，在编辑器内选中内容，将在快捷工具栏和行末展示评论按钮，点击后即可对选中内容进行评论。

点击评论按钮后，在选中内容右侧展示评论框，并带入选中的文档内容，点击文档内容支持快速定位到相关评论，点击评论支持快速定位到原文。需要注意，运行时需要先保存表单，生成数据id后，选中文本后才显示评论按钮。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098389859500038&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

9、

### 字段组件可编辑

开关默认关闭，启用后，切换为可编辑模式后，内容编辑器里的表单组件可直接编辑。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098389987450890&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

10、

### 保存方式

跟随表单设置：即内容编辑器跟随表单设置的保存方式（默认）

自动保存：内容编辑器失去光标或操作Ctrl/Command+S ，内容将会自动进行保存

切换自动保存后，前台运行时，内容编辑器失去光标或操作Ctrl/Command+S ，内容将会自动进行保存

11、

### 修订留痕

设计页面不支持审阅功能，仅支持运行时对编辑器内容进行修订，支持接受修订、拒绝修订，同时修订内容支持多版本查看，复原

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098394299195394&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

12、

### 设计模版、一文双屏

参考：[ _https://www.e-cology.com.cn/sp/doc/docDetail/8143225495166118849_](https://www.e-cology.com.cn/sp/doc/docDetail/8143225495166118849)

13、

### 动作流相关

内容编辑器导出文件

附件字段联动，赋值至内容编辑

内容编辑器导出文件后，赋值到附件字段

以上动作流相关配置可参考：[ _https://www.e-cology.com.cn/sp/doc/docDetail/8143225495166118849_](https://www.e-cology.com.cn/sp/doc/docDetail/8143225495166118849)

##  （三）富文本编辑器

### 1、支持设置默认值

多行文本现有功能，交互调整为弹窗输入默认值，输入默认值的编辑器内的工具栏，沿用原先多行文本-富文本默认值的相关逻辑

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098389929615374&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1、

### 内容高度相关

默认内容高度为150px，支持自定义高度

允许高度自撑

默认关闭，开启后，在编辑状态下若内容超过自定义的高度，编辑器将会自动撑高，直至达到最大高度；预览状态不受当前开关控制，始终根据内容自动撑高。

自撑最大高度

最大高度需要大于内容高度，支持设置不限制。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098385634648064&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2、

### 自动获得光标、光标默认位置

默认关闭，开启后，进入页面编辑器将自动获得光标，可以直接进行输入

在开启自动获得光标时才展示光标默认位置设置项，主要设置自动获得的光标定位位置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098381479280654&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3、

### 粘贴设置

保留源格式：复制的文字、图片、表格等均按照源格式粘贴

不保留格式：复制的文字、图片、表格中的内容去除格式后粘贴

只粘贴文本：只保留复制的文字，并且去除格式，图片和表格直接不粘贴

4、

### 解析超链接

多行文本组件现有功能，不在这里详细说明，具体可以查看组件介绍。

 

5、

### PC端设置

#### 6.1工具栏

默认显示支持的工具栏，支持自定义工具栏，可设置需要启用的工具栏，且支持设置默认字体、字号

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098398652882960&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 6.2工具栏折行展示

未启用，则仅展示一行，超出的编辑工具通过左右滚动查看

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098419944054798&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1224098420119330823&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 6.3工具栏显示设置

多行文本组件现有功能，不在这里详细说明，具体可以查看组件介绍。

#### 6.4启用@功能

开关默认关闭，开启后，在输入框中输入 “@” ，可以快速唤起@面板，@相关人员/部门

#### 6.5启用AI文档助手

开关默认关闭，开启后，pc端输入框中输入 “//” 可以快速唤起AI文档助手，pc端选中内容，也可以快速唤起AI文档助手。

6、

### 移动端设置

#### 7.1 新页面编辑

未打开新页面编辑，则直接在表单一级页面进行编辑

打开新页面编辑，则跳转新页面编辑

#### 7.2 工具栏

设置页面的交互与PC端工具栏的设置保持一致，部分不支持的工具栏隐藏

#### 7.3 工具栏折行展示

启用后当一行展示不下所有工具时，将折行进行展示；未启用，则通过左右滚动工具栏展示区域，以查看更多工具，跟PC一致。

#### 7.4 语音输入

多行文本组件现有功能，不在这里详细说明，具体可以查看组件介绍。

#### 7.5 移动端适配展示

启用后，组件在移动端只读时，将智能根据移动端屏幕对富文本样式做一定的过滤处理，便于移动端展示。

 

## 三、更多参考资料

内容编辑器原始参考文档链接（持续更新，有搭建场景以及基线迭代功能等，可持续关注下面文档链接）

https://www.e-cology.com.cn/sp/doc/docDetail/8143225495166118849
