定义看板
点击主页左侧导航菜单的【看板】菜单项,打开看板管理页面,点击【添加】按钮,
填写基本信息,点击【保存并设计】按钮,打开看板设计页面。
设计好看板后,点击【保存并展示】按钮,即可打开看板展示页面。
企业版支持扫码打开看板展示页面,在看板管理页面点击【展示】按钮右侧下拉箭头,在下拉菜单中点击【扫码展示】,
扫描面板中的二维码即可。
看板
一个看板中可以定义任意多个看板模板,一个看板模板即是一个原生的HTML页面。
在看板模板中,可以任意编辑HTML,也可以引入任意JavaScript/CSS库,
为其中任意
<div>元素添加一个dg-chart-widget属性,
即可将此<div>定义为一个图表元素。
在展示看板时,所有的图表元素都将被绘制成它所选定类型的图表。
看板模板示例:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>
<div dg-chart-widget="【图表部件ID】" style="width:300px;height:300px;"></div>
</body>
</html>
【图表部件ID】应设置为具体ID值(图表管理页面内的某行ID值)。
导入看板
在看板管理页面点击【添加】按钮右侧下拉菜单中的【导入】项,即可将任意HTML导入为看板。
导入文件可以是单个HTML文件,也可以是包含HTML文件及其依赖所有资源的
ZIP压缩包。
示例:
index.html
或者
my-dashboard.zip
|--index.html
|--content.html
|--style
|--dashboard.css
|--images
|--bg.png
|--icon.png
|--script
|--dashboard.js
导入
ZIP压缩包前,确保看板文件、文件夹都直接位于压缩包根目录下,不要再内嵌一级目录。
API版本
在新建和导入看板时,需要设置看板API版本,用于指定看板展示页面加载和提供的API版本。
系统目前有
2.0和1.0两个API版本,新建看板时应选用最新2.0的API版本,
1.0的API版本仅用于支持系统中已存在的旧版看板功能。
不同版本的API是不兼容的,在看板中插入的图表,其对应的图表插件必须声明了相同的API版本(通过
也可以在看板源码设计模式中通过优先级更高的dg-api-version指定看板API版本。
apiVersion属性声明)。
也可以在看板源码设计模式中通过优先级更高的dg-api-version指定看板API版本。
设计看板
看板设计功能支持源码设计模式和可视设计模式,点击设计页面看板模板页签下的【源码模式】/【可视模式】可以互相切换,其中:
源码设计模式
HTML纯文本编辑模式,可以自由编辑HTML/JavaScript/CSS文本,也可以引入任意JavaScript/CSS库,能够使用全部看板功能,
适用于熟悉前端开发的技术人员,详细参考看板源码设计模式章节。
可视设计模式
HTML网页元素编辑模式,通过点选元素的方式插入图表、编辑样式、设计布局,所见即所得,仅能够使用部分看板功能,
适用于不熟悉前端开发的设计人员,详细参考看板可视设计模式章节。
管理看板资源
点击看板设计页面右侧【本地资源】下的【+】按钮,可以新建
*.html、*.js、*.css文件,
点击上传按钮,可以上传*.html、*.js、*.css文件,以及任意其他资源文件(比如图片、视频、音频等)。
比如,上传
jQuery库至lib/jquery-4.0.0.min.js目录,作为看板DOM操作支持库:
...
<script src="lib/jquery-4.0.0.min.js"></script>
<script>
$(()=>{
$("#btn").click(()=>{ $("#panel").toggle(); });
});
</script>
...
<body>
<button id="btn">显示/隐藏图表</button>
<div id="panel">
...
</div>
...
</body>
...
上传一个名称为
bg.png的图片后,将它设置为看板背景:
...
<style type="text/css">
.my-dashboard{
background: url(bg.png);
}
</style>
...
<body class="my-dashboard">
...
</body>
...
上传一个名称为
custom-map.json的GeoJSON地图文件,将它设置为图表地图:
...
<div dg-chart-options="{mapName:'custom-map.json'}" dg-chart-widget="..."></div>
...
使用全局资源
点击看板设计页面右上角的【全局资源】按钮,可以打开系统全局看板资源对话框,
选中后点击【确定】按钮,全局资源URL将会被复制到剪切板,可以在看板模板中引入使用。
在看板模板中,全局资源是以
global/前缀的方式引入使用的。
比如,对于全局资源:
css/common.css img/logo.png script/util.js
可以在看板模板中以如下方式引用:
<!DOCTYPE html> <html> <head> <link type="text/css" href="global/css/common.css" rel="stylesheet" /> <script src="global/script/util.js"></script> </head> <body> <div class="logo"> <img src="global/img/logo.png"> </div> ... <div dg-chart-widget="..."></div> ... </body> </html>
以
global/前缀方式引入全局资源比较直观和易于理解,但是在浏览器端,可能无法对全局资源跨看板缓存,从而导致看板加载时间增加。
为了解决这个问题,可以使用../global/前缀方式引入全局资源,比如:
<!DOCTYPE html> <html> <head> <link type="text/css" href="../global/css/common.css" rel="stylesheet" /> <script src="../global/script/util.js"></script> </head> <body> <div class="logo"> <img src="../global/img/logo.png"> </div> ... <div dg-chart-widget="..."></div> ... </body> </html>
管理员登录后,可在右上角设置菜单【数据分析 - 看板全局资源】中打开看板全局资源管理功能,新建或者上传全局资源。
内置看板库
在看板展示时,系统会自动为看板页面引入一些Javascript库,
主要封装在
window.chartFactory和window.dashboardFactory变量中,用于支持看板功能。
请勿在看板中使用这些内置库,它们没有版本兼容支持,每个版本都可能有破坏性更新。
企业版自
1.3.0版本起,支持管理员自定义内置看板库,
登录后,点击主页面右上角设置菜单的【数据分析 - 看板全局库】项,
可设置看板全局库,它们也将在系统的所有看板展示页内自动引入。
分享看板
在看板管理页面,选中一条记录后,点击【分享】按钮,可以将看板分享给指定用户/角色。
如果看板加入了项目,将会继承项目的分享设置。