富文本

1. 概述

1.1 功能概述

富文本组件支持通过动态文本（含数据绑定与组件联动）实现智能注释与交互引导，并具备跨仪表板、报表、页面及外部链接的多维跳转能力，全面提升数据看板的可读性与交互性。

2. 操作步骤

富文本组件区别于其他可视化组件，兼具自由内容编辑与数据变量绑定能力，实现静态文字与动态数据的融合展示。

本文将指导您在Wyn中创建和使用富文本。

2.1 前提条件

1. 数据要求： 已完成数据连接与数据准备，本文将以本地Excel文件及缓存数据集为例演示操作流程。

2. 界面要求： 已进入仪表板设计界面，且仪表板至少已绑定一个数据集/数据模型（如“Excel数据-缓存数据集”）。

2.2 操作步骤

2.2.1 添加组件

1. 仪表板设计界面最左侧，单击组件按钮展开列表，选择富文本，按住鼠标左键将其拖拽至仪表板设计区域，成功添加一个富文本组件。

   
   

2.2.2 绑定数据

富文本组件支持以下四种方式的数据绑定。

2.2.2.1 绑定自定义文本

1. 单击组件的编辑按钮或双击组件，进入编辑状态。

   
   

2. 在组件中输入文本即可完成自定义数据。

   
   

2.2.2.2 绑定动态文本

富文本组件通过添加表达式来绑定数据字段，从而可以实现动态显示内容。

1. 单击组件的编辑按钮或双击组件，进入编辑状态。

   
   

2. 在富文本编辑状态下，单击，弹出表达式对话框。

   
   

3. 在表达式对话框界面，选择数据集和字段，然后设置其他细节，完成后单击应用或确定按钮即可在光标所在位置插入表达式。

   
   

• 配置项说明：

  属性	说明
  数据集	选择需要的数据集/数据模型
  字段	选择需要展示的字段
  聚合运算	对字段进行统计运算，支持合计、平均数、最大值、最小值、计数、计数（不重复）和第一个值
  数据单位	选择数据的显示单位，比如数据为10000，如选择数据单位为“万”，则显示为“1万”
  格式	设置数据的显示格式，比如货币格式、百分比格式等，支持自定义格式
  快速运算	选择是否基于聚合运算再做快速运算，这里仅支持基于日期的运算 “原始值”代表不进行快速运算，有关基于日期的运算介绍，请参考快速运算
  筛选器	为组件添加数据筛选器。筛选器内部的具体用法请参考数据筛选
  条件格式化	为富文本添加数据格式化，使其能在特定的条件下显示成设定的格式

• 设置完成后，单击应用或确定均可保存。

  • 单击应用，则会保存设置并在对应的图表上体现结果，但不会返回至条件列表画面。用户可继续对该条件进行修改等操作。

  • 单击确定，保存设置并返回到条件列表画面。

    
    

4. 添加条件格式化，可以为销售额添加条件格式化，使其达到某个值时显示为特殊样式，这样可以使阅读者更快速的聚焦重点。

   例如：

   1）进入编辑状态并双击表达式，弹出表达式编辑框，然后切换至条件格式化，并单击新增按钮。

   
   

   2）设置条件格式化的具体内容。选择格式化应用的目标字段，设置条件操作符（等于、不等于、大于、大于或等于、小于、小于或等于、介于、不介于），然后设置一个阈值，可以自定义输入值也可以单击右侧的铅笔按钮使用新聚合数据和已绑定字段。

   例如，我们设置当订单金额大于四百万时显示为特殊格式。格式化样式支持字体设置、背景色调整和圆角半径设置，设置完成下方即可预览效果，满意后单击确定即可。

   
   

   成果展示： 设置完成后单击确定按钮返后富文本原页面，鼠标在组件外的空白区域单击一下即可查看效果，最终效果如下图

   
   

5. 修改动态文本，富文本框的编辑状态下，双击表达式，即可弹出表达式对话框，对表达式以及过滤条件进行修改。

   
   

2.2.2.3 绑定变量

绑定变量一般用于如显示参数值或数据集更新时间等场景。富文本组件支持动态变量绑定，可实时显示仪表板参数、数据更新时间、用户身份及筛选器值等关键信息，实现智能化的上下文提示。

例如，当需要在仪表板中将数据的更新时间显示出来，此时使用富文本即可实现。如下图所示：

1. 单击组件的编辑按钮或双击组件，进入编辑状态。

   
   

2. 在富文本编辑状态下，单击按钮，弹出变量对话框。

   
   

3. 在变量对话框中，选择需要使用的变量，并修改表达式。例如，选择Datasets，即可展示数据集的最后更新时间，该变量中，数据集的名称大小写敏感，其余固定字符大小写不敏感，设置完成后单击确定按钮返后富文本原页面。鼠标在组件外的空白区域单击一下即可查看效果。

   
   

• 变量说明： 详情请参考URL动态变量说明中关于可用变量名称的介绍

  变量	使用说明
  Parameters	Parameters["parameterName"] ，parameterName指仪表板参数名称
  Slicers	Slicers["slicerScenarioName"]，slicerScenarioName指筛选器名称
  Datasets	Datasets["datasetName"]["property"] ，datasetName指数据集/数据模型名称，property指属性，仅支持lastUpdated
  User	User["property"] ，property指属性，支持id、name、email、home、language、theme等
  Document	Document["property"] ，property指属性，支持id和name
  UrlParameters	UrlParameters["urlParameter"] ，urlParameter支持当前页面URL中的所有搜索查询参数

2.2.2.4 绑定仪表板参数

1. 设置仪表板参数。

   
   

2. 单击组件的编辑按钮或双击组件，进入编辑状态。

   
   

3. 在富文本编辑状态下，单击按钮，选择仪表板参数，单击具体参数名称即可将其添加到富文本中，鼠标在组件外的空白区域单击一下即可查看效果。

   此功能可实现动态标题等效果，相关示例可参考动态维度。

   
   

2.2.3 数据处理

1. 组件完成数据绑定后，可自由调整字段属性（如格式修改、重命名、聚合方式切换）并执行快速运算，具体操作步骤请参考数据绑定与动态计算。

   
   

2.2.4 组件属性

1. 数据处理完成后，可通过以下属性配置进一步优化组件展示效果：

   属性	说明	系统图示
   富文本样式	自定义图表数据点样式，例如：设置调色板、自动渐变、圆角半径等属性
   动画	设置组件入场动画、轮播和轮播间隔
   数据交互	配置联动、跳转、刷新等行为
   空白（BLANK）数据样式	自定义空白数据的显示规则
   空白（NULL）数据样式	自定义空值数据的显示规则
   布局大小	调整组件位置于整体尺寸
   外观样式	调整组件外观样式

2. 富文本额外支持以下独有属性：

• 富文本样式： 在属性设置中，可通过富文本样式自动标注内容水平对齐、内容垂直对齐、行间距和超链接下划线属性。

  属性	说明	系统图示
  内容水平对齐	整体控制内容在水平方向的对齐方式
  内容垂直对齐	整体控制内容在垂直方向的对齐方式
  行间距	设置内容行之间的距离
  超链接下划线	设置富文本中超链接的显示方式，支持显示、隐藏和鼠标悬浮显示

• 富文本其他样式： 进入富文本的编辑状态，选中文本或变量后，也可以通过下图的快捷键设置样式。

  
  

2.2.5 数据处理

1. 富文本组件的数据处理功能支持在绑定动态文本时灵活配置字段属性，包括聚合运算方式、数据单位及格式等自定义设置，具体操作步骤请参考数据绑定与动态计算。

   
   

2.2.6 数据探索与分析

1. 组件内置丰富的数据探索与分析功能，从多角度挖掘数据价值，为您的可视化分析提供专业级支持。

   
   

2.2.6.1 添加跳转

1. 富文本编辑状态下，选中文本或表达式，单击操作栏中的跳转按钮。

   
   

2. 单击添加跳转，打开跳转设置对话框，设置跳转文档的名称，选择目标文档类型并根据选择的目标文档类型设置文档、参数、链接等具体信息，然后设置打开方式相关项目。最后单击确定。

   
   

• 跳转属性配置说明：

  • 名称： 为目标文档的命名。该名称将显示在跳转文档列表中。

  • 目标维度： 仅当所选数据点匹配指定维度时，跳转项目才可见/可执行；未设置时则始终可用。

  • 跳转到： 设置目标文档的相关项目。

    • 仪表板/报表： 当选择跳转至仪表板/报表时，需选择具体的目标文档。如果目标文档带参数，则会将参数显示出来。

    • 外部链接： 当选择跳转至外部链接时，需要设定网址。

    • 内部页面： 选择仪表板内部页面进行跳转。

    • 参数设置： 在配置参数传递时，关键是根据需求选择合适的数值类型来确定传递的数据内容：您可直接预定义查询参数，或暂选"未设置"待跳转时再输入（具体数值类型说明请参考跳转至仪表板 页面的数值类型介绍）。

    • 跳转选项： 设置跳转后，新打开的文档中是否显示工具栏，页面缩放模式以及初始页码。

      跳转选项	说明	系统图示
      仪表板	显示工具栏： 可设置为默认值（按目标文档原来的设置显示）、显示或隐藏工具栏，自动隐藏工具栏（默认隐藏，鼠标悬浮时可显示） 页面缩放： 可设置为默认值（按目标文档原来的设置显示）、等比缩放、适应屏幕、宽度自适应和高度自适应 初始页码： 设置跳转仪表板文档，默认打开的文档页的页面
      报表	显示工具栏： 可设置为默认值（按目标文档原来的设置显示）、显示或隐藏工具栏，自动隐藏工具栏（默认隐藏，鼠标悬浮时可显示） 页面缩放： 可设置为默认值（按目标文档原来的设置显示）、等比缩放、适应屏幕、宽度自适应和高度自适应 报表页显示： 设置跳转报表的视图模式，支持默认视图、单页视图、不分页和连续模式

  • 打开方式： 为跳转后的文档选择一个合适的打开方式。支持对话框、内嵌、新页面、重定向以及非模态对话框等方式。关于打开方式的详细介绍，请您参考跳转设置中打开方式内容介绍，功能是一致的。

    
    

    打开方式	说明	系统图示
    对话框	可配置对话框属性，包括对话框尺寸、对话框位置、允许缩放、对话框标题（开启后可配置背景色和前景色）、关闭按钮和图片（关闭按钮图片）
    新页面	无
    内嵌	无
    重定向	可配置重定向区域
    非模态对话框	可配置对话框属性，包括对话框尺寸、对话框位置、允许缩放、对话框标题（默认关闭）、背景色、前景色、关闭按钮和图片（关闭按钮图片）