5.13. 使用看板API

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

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

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

  1. ...
  2. <head>
  3. <script type="text/javascript">
  4. $(document).ready(function()
  5. {
  6.   $("#button1").click(function()
  7.   {
  8.     var chart1 = dashboard.getChart("chart1");
  9.     chart1.refreshData();
  10.   });
  11. });
  12. </script>
  13. </head>
  14. <body>
  15. ...
  16.   <button id="button1" type="button">刷新</button>
  17.   <div id="chart1" dg-chart-widget="..."></div>
  18. ...
  19. </body>
  20. </html>

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

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