标记云小组件
标记云小组件为您提供了一种可视化标记使用的方法。使用标记越多,它在云中看起来越大。标记云小组件不执行使用计算;标记使用是在服务器上计算的。为使之生效,标记云需要两列数据集 ['tag label', 'tag count']。标记标签会根据标记计数相应地显示。
标记云提供以下选项:
• 可以针对所显示的标记应用固定样式 (例如,以红色、斜体显示所有标记) 或使其基于状态定义中的样式。
• 可以将样式应用于“单击/选定”标记。
• 可以使用可绑定的单击事件。当用户单击某个标记或对数据集的选定行进行更新时,“单击”事件开始广播。
• 当用户单击某个标记或对数据集的选定行进行更新时,标记云会使用匹配的标记填充可绑定的 SelectedTag 属性。
• 可以指定使用最多的标记的显示尺寸 (以 CSS em 长度表示)。
• 可以根据标记云数据集中的任何列显示每个标记的工具提示。
• 标记云本质上会侦听数据集所绑定到的选定行更新事件。因此,SelectedTag 属性可以更新并重新显示 (如果已定义 SelectedTagStyle),而无需在标记云中进行显式操作。
有关详细信息,请观看以下视频教程:
属性
有关常用小组件属性的信息,请参阅
小组件。特定于标记云小组件的属性将在下表中进行说明。
属性名称 | 说明 | 基本类型 | 默认值 | 是否可绑定?(Y/N) | 是否可本地化?(Y/N) |
---|
CustomClass | 用户定义的 CSS 类,应用于小组件顶层 div。可以输入多个类,以空格作为分隔符。 | STRING | 不适用 | Y | N |
Data | 绑定到小组件的标记数据 | INFOTABLE | 不适用 | Y | N |
MaxFontSize | 云中最大标记的大小 (以 CSS em 长度表示)。从这个尺寸缩小所有其他标记。 | NUMBER | 4 | N | N |
DisplayToolTip | 启用每个标记链接上的工具提示显示 | BOOLEAN | false | N | N |
ToolTipField | DisplayToolTip 为“已选定/true”时,用于表示工具提示值的信息表字段。需要绑定 Data 属性。 | FIELDNAME | 计数 | N | N |
TagStateStyle | 基于已设置格式的状态或指定的样式来设置所呈现标记的样式。 默认情况下,标记云根据标记链接的计数来设置标记链接样式 (计数越高,字体越大)。您可以根据每个标签的另一个数据值 (状态格式) 将样式应用至标记链接,也可以将样式应用至所有标记。例如,“状态格式化程序”应用于标记云数据,以将计数大于 40 的链接格式化为红色且粗体,而计数小于 40 的链接格式化为黑色且斜体。 | STATEFORMATTING | 不适用 | N | N |
TagNameField | 表示标记值的信息表字段。需要绑定 Data 属性。 | FIELDNAME | 不适用 | N | N |
TagCountField | 表示标记计数的信息表字段。需要绑定 Data 属性。 | FIELDNAME | 不适用 | N | N |
标题 | 标记云的标题 | STRING | 不适用 | Y | Y |
事件
DoubleClicked
• 可绑定
• 当单击某个标记时,可以从“数据服务选定行”中检测到 SelectedTag。DoubleClicked 事件可用于触发另一项服务,如链接双击以触发导航链接。
• 如果已定义 SelectedTagStyle 属性,则会根据选择相应地设置“单击”标记的样式。之前的任何已单击/设置样式的标记将被重置。
• 绑定数据的选定行对象将根据当前选定/单击的标记云链接的索引进行更新。
本质上,标记云将侦听其所绑定到的数据的选定行对象更新。对选定行进行更新时 (通过其他小组件或数据操作):
• 标记云 SelectedTag 被设置为由标记云 TagNameField 指定的选定行数据值。
• 如果已定义 SelectedTagStyle 属性,那么将相应地设置 SelectedRow 标记的样式。之前的任何已单击/设置样式的标记将被重置。
• 如果已更新的选定行是并非由标记云显示的值:
之前的任何已单击/设置样式的标记将被重置。
SelectedTag 将被清除。
• 标记云不支持多选。处理来自选定行对象的更新时,将仅处理选定行对象的第一个索引。