创建一个视觉

如何创建视觉对象并将其绑定到数据

创建特定类型的空视觉对象，然后将该视觉对象绑定到数据字段。有关视觉类型的列表，请参阅开箱即用的视觉类型。

备注

未安装在可视化窗格中的视觉对象无法添加到报表中。对于未安装的自定义视觉对象和已卸载的开箱即用视觉对象都是如此。

1. 使用以下参数配置要创建的视觉对象：

• 视觉类型：您要创建的视觉类型，例如barChart.

• 布局（可选）：要应用于新视觉对象的布局。

• autoFocus（可选）：选择页面是否自动滚动到新创建的视觉对象（默认设置为“True”）。

2. 使用以下方法创建您的视觉对象：

   Javascript复制

   createVisual(visualType: string, layout?: models.IVisualLayout, autoFocus?: boolean): Promise
   

返回值包含一个表示新创建的视觉对象的对象。您可以使用视觉数据绑定和视觉属性API 来根据您的需要编辑视觉对象。

例如：

Javascript复制

let createVisualResponse = await page.createVisual('areaChart');let visual = createVisualResponse.visual;

代码示例

以下代码示例展示了如何创建具有不同参数的视觉对象。

备注

有关创建自定义布局的信息，请参阅视觉布局。

创建具有自定义布局且无焦点的面积图视觉对象。

Javascript复制

const customLayout = {    x: 20,    y: 35,    width: 1600,    height: 1200}let createVisualResponse = await page.createVisual('areaChart', customLayout, false /* autoFocus */);

使用默认布局创建面积图。

Javascript复制

let createVisualResponse = await page.createVisual('areaChart');

可用的开箱即用视觉类型

• 动作按钮

• 面积图

• 条形图

• 基本形状

• 卡片

• 聚类条形图

• 簇状柱形图

• 柱状图

• 调试视觉

• 分解树

• 圆环图

• esri可视化

• 填充地图

• 漏斗

• 测量

• 百百分比堆叠条形图

• 百分堆积柱形图

• 图片

• keyDriversVisual

• 关键绩效指标

• 折线图

• lineClusteredColumnComboChart

• lineStackedColumnComboChart

• 地图

• 多排卡

• 饼形图

• 数据透视表

• PowerApps

• python视觉

• qna视觉

• 带状图

• 散点图

• 脚本可视化

• 形状图

• 切片器

• 堆积面积图

• 表例

• 文本框

• 树形图

• 瀑布图

限制

可视化创建 API 仅在报表呈现后可用。侦听报告rendered事件并仅在调用后触发可视化创作 API。有关详细信息，请参阅事件处理。