5. 数据可视化分析 - 5.13. 使用看板API - 《DataGear 1.12 使用教程》

5.13. 使用看板API

5.13. 使用看板API

每一个看板在展示时，页面都会自动添加一个看板对象，用于为渲染看板页面提供支持。另外，它也封装了很多可扩展看板功能的API，比如：获取图表、删除图表、异步加载图表等等。

看板对象的默认变量名为：window.dashboard。

下面的示例，在点击button1按钮时，调用看板对象的 getChart()函数，获取图表元素ID为chart1的图表对象，然后调用它的refreshData()函数刷新图表数据：

...
<head>
<script type="text/javascript">
$(document).ready(function()
{
  $("#button1").click(function()
  {
    var chart1 = dashboard.getChart("chart1");
    chart1.refreshData();
  });
});
</script>
</head>
<body>
...
  <button id="button1" type="button">刷新</button>
  <div id="chart1" dg-chart-widget="..."></div>
...
</body>
</html>

刷新图表数据可使用更便捷的dashboard.refreshData()函数。

可通过dg-dashboard-var 自定义看板对象变量名。