✨ 关于 relation-graph
relation-graph是支持Vue2、Vue3、React的关系数据展示组件,支持通过【插槽】让使用者使用"普通HTML元素、Vue组件、React组件"来完全自定义图形元素,并提供实用的API接口让使用者轻松构建可交互的图形应用。
官网文档:https://www.relation-graph.com/#/index
✨ 基本使用:(Vue3.0)
第一步:在项目中安装对应的插件
npm install --save relation-graph-vue3
第二步:创建对应SFC组件
<template>
<div>
<div style="border: #efefef solid 1px; height: calc(100vh - 100px);width: 100%;">
<relation-graph ref="graphRef$" :options="options" >
<template #node="{node}">
<div class="node-item" @click="showNodeTips(node, $event)">
//自定义节点中显示内容
<div class="node-item-info">
<div class="node-item-info-item">
<div class="item-label">所属部门:</div>
<div class="item-value">部门编号+部门名称</div>
</div>
<div class="node-item-info-item">
<div class="item-label">工作电话:</div>
<div class="item-value">00-1234 1234</div>
</div>
<div class="node-item-info-item">
<div class="item-label">工作邮箱:</div>
<div class="item-value">Pall.Lin.123@manpowergrc.com</div>
</div>
<div class="node-item-info-item">
<div class="item-label">下属人数:</div>
<div class="item-value">198人</div>
</div>
</div>
</div>
</template>
</relation-graph>
</div>
</div>
</template>
<script setup name="RelationGraph">
import RelationGraph from 'relation-graph-vue3'
const options = {
"backgroundImage": "https://ssl.relation-graph.com/images/relatioon-graph-canvas-bg.png",
"backgroundImageNoRepeat": true,
"disableDragNode": true,
"defaultFocusRootNode": false,
"disableNodeClickEffect": true,
"disableLineClickEffect": true,
"defaultExpandHolderPosition": "bottom",
"defaultNodeBorderWidth": 1,
"defaultNodeColor": "#ffffff",
"defaultNodeBorderColor": "#D8D8D8",
"defaultNodeFontColor": "#303133",
"defaultLineColor": "#999",
"checkedLineColor": null,
"defaultLineShape": 4,
"defaultNodeShape": 1,
"defaultNodeWidth": 340,
"defaultNodeHeight": 148,
"defaultJunctionPoint": "tb",
"layouts": [
{
"label": "中心",
"layoutName": "tree",
"centerOffset_x": 0,
"centerOffset_y": 0,
"distance_coefficient": 1,
"layoutDirection": "v",
"from": "top",
"levelDistance": "",
"min_per_width": "360",
"max_per_width": 500,
"min_per_height": "300",
"max_per_height": 500
}
]
}
const jsonData = {
rootId: 'a',
nodes: [
{ id: 'a', text: 'a', },
{ id: 'b', text: 'b', },
{ id: 'c', text: 'c', },
{ id: 'd', text: 'd', },
{ id: 'e', text: 'e', },
{ id: 'f', text: 'f', },
],
lines: [
{ from: 'a', to: 'b', },
{ from: 'a', to: 'c', },
{ from: 'a', to: 'd', },
{ from: 'a', to: 'e', },
{ from: 'a', to: 'f', },
],
}
//点击当前节点
const showNodeTips = (nodeObject, $event) => {
isShowNodeTipsPanel.value = true
}
// 点击画布事件
const onCanvasClick = ($event) => {
isShowNodeTipsPanel.value = false
}
onMounted(()=>{
//初始化画布
const graphInstance = graphRef.value?.getInstance()
if (graphInstance) {
graphInstance.setOptions(options)
graphInstance.setJsonData(jsonData)
graphInstance.moveToCenter()
graphInstance.zoomToFit()
}
})
第三步:自定义配置界面
基本配置json
const options = {
"backgroundImage": "https://ssl.relation-graph.com/images/relatioon-graph-canvas-bg.png",
"backgroundImageNoRepeat": true,
"disableDragNode": true,
"defaultFocusRootNode": false,
"disableNodeClickEffect": true,
"disableLineClickEffect": true,
"defaultExpandHolderPosition": "bottom",
"defaultNodeBorderWidth": 1,
"defaultNodeColor": "#ffffff",
"defaultNodeBorderColor": "#D8D8D8",
"defaultNodeFontColor": "#303133",
"defaultLineColor": "#999",
"checkedLineColor": null,
"defaultLineShape": 4,
"defaultNodeShape": 1,
"defaultNodeWidth": 340,
"defaultNodeHeight": 148,
"defaultJunctionPoint": "tb",
"layouts": [
{
"label": "中心",
"layoutName": "tree",
"centerOffset_x": 0,
"centerOffset_y": 0,
"distance_coefficient": 1,
"layoutDirection": "v",
"from": "top",
"levelDistance": "",
"min_per_width": "360",
"max_per_width": 500,
"min_per_height": "300",
"max_per_height": 500
}
]
}
数据格式:
const jsonData = {
rootId: 'a',
nodes: [
{ id: 'a', text: 'a', },
{ id: 'b', text: 'b', },
{ id: 'c', text: 'c', },
{ id: 'd', text: 'd', },
{ id: 'e', text: 'e', },
{ id: 'f', text: 'f', },
],
lines: [
{ from: 'a', to: 'b', },
{ from: 'a', to: 'c', },
{ from: 'a', to: 'd', },
{ from: 'a', to: 'e', },
{ from: 'a', to: 'f', },
],
}
数据赋值:
graphRef$.value.setJsonData(jsonData)
完成这些之后我们就可以得到一个基本的关系图谱
✨ 如何自定义图谱结构以及样式
1.配置界面进行可视化配置
2.完成之后点击此处,copy 出我们的json对象,替换到我们自定义组件中即可
3.具有丰富的事件与交互供大家使用
常用的事件:
- node-click 节点点击事件
- line-click 节点连线点击事件
- canvas-click 画布点击事件
4.自定义图表动画效果