富文本


富文本组件用于在仪表盘页面上展示排版丰富的文本,支持字体、颜色、链接、表情符号等样式,还可插入数据字段让文本内容随数据实时变化。


../_images/rich_text.png


有关标题、背景、内边距和样式复制等通用配置,参见 图表通用配置。

富文本的数据


富文本可添加 不限数量 的 指标 字段。添加后,字段可在文本中通过占位符引用,数值随数据源刷新自动更新。

有关数据源、数据项的通用配置信息,参见 图表通用配置 > 配置数据。

编辑文本内容


在组件的文本编辑器中撰写内容。工具栏提供以下能力:

  • 基础排版:加粗、倾斜、下划线等行内样式,段落类型,字号,字体,文字颜色,行高,对齐方式,项目符号与编号列表,清除格式,撤销与重做。

  • 链接与表情:插入超链接、插入表情符号。

  • 格式刷:先选中已设置好格式的文字点击格式刷,再选中目标文字即可套用相同格式。

  • 多语言:为同一段文本按语言分别撰写内容。页面按终端用户的语言显示对应版本,未填写的语言回退到默认内容。

插入数据字段


点击工具栏的 插入字段 按钮,从已添加的数据项中选择字段插入到文本中。插入时可一并指定该字段的展示方式:

  • 数值类型:可设置小数位数、是否展示千分位,以及单位的换算方式。

  • 时间类型:可设置时间格式。

插入后编辑器中显示为一段占位符,运行时替换为字段的实际取值。


备注

  • 推荐使用 插入字段 按钮插入,以便同时配置格式;早期版本手写的 ${字段名} 占位符仍然可用。

  • 当组件取不到数据时,占位符会尝试用同名的页面参数取值;仍取不到时显示为 -。

富文本的样式

字段样式


该区块仅在已添加数据项后显示,为每个字段生成一张配置卡。

颜色规则


点击 新增 为该字段添加规则,使插入到文本中的该字段值按取值改变文字颜色。每条规则包含 从、至 和颜色。


备注

富文本的颜色规则按 字符串 匹配,而非数值区间,因此适合状态类文本(例如把「故障」显示为红色)。规则按从上到下的顺序匹配,首个命中的规则生效。颜色规则只作用于通过占位符插入的字段值,不影响手写的固定文字。

轮播间隔


设置滚动一轮所需的时间,单位为秒,默认 10。数值越小滚动越快。

运行时交互


以下行为由组件在运行时提供,不需要配置:

  • 自动判断是否滚动:组件在渲染后比较内容高度与组件高度,仅在内容溢出时启用滚动;窗口尺寸或数据变化后重新判断。

  • 链接跳转:文本中插入的超链接在运行时可直接点击。


备注

富文本不支持 导出组件数据。