python绘制组织结构图_OrgChart.js 这是一个简单直接的组织结构图插件-CSDN博客

本文链接：https://blog.csdn.net/weixin_39696518/article/details/112962719

Foreword

First of all, thanks a lot for wesnolte's great work

😊 -- jOrgChart. The thought that using nested tables to build out the tree-like orgonization chart is amazing. This idea is more simple and direct than its counterparts based on svg.

Unfortunately, it's long time not to see the update of jOrgChart. on the other hand, I got some interesting ideas to add, so I choose to create a new repo.

Font Awesome provides us with administration icon, second level menu icon and loading spinner.

Features

Supports both local data and remote data (JSON).

Smooth expand/collapse effects based on CSS3 transitions.

Align the chart in 4 orientations.

Allows user to change orgchart structure by drag/drop nodes.

Allows user to edit orgchart dynamically and save the final hierarchy as a JSON object.

Supports exporting chart as a picture.

Supports pan and zoom

Users can adopt multiple solutions to build up a huge organization chart(please refer to multiple-layers or hybrid layout sections)

touch-enabled plugin for mobile divice

Getting started

Build

npm install

gulp build

Serve

gulp serve

Now, you can try out all the demos on http://localhost:3000.

Note: your nodejs version should be 4+.

Demo

Lao Lao
- Bo Miao
- Su Miao
  - Tie Hua
  - Hei Hei
    - Pang Pang
    - Xiang Xiang

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : '#ul-data'

});

let datascource = {

'name': 'Lao Lao',

'title': 'general manager',

'children': [

{ 'name': 'Bo Miao', 'title': 'department manager' },

{ 'name': 'Su Miao', 'title': 'department manager',

'children': [

{ 'name': 'Tie Hua', 'title': 'senior engineer' },

{ 'name': 'Hei Hei', 'title': 'senior engineer',

'children': [

{ 'name': 'Pang Pang', 'title': 'engineer' },

{ 'name': 'Xiang Xiang', 'title': 'UE engineer' }

]

}

]

{ 'name': 'Yu Jie', 'title': 'department manager' },

{ 'name': 'Yu Li', 'title': 'department manager' },

{ 'name': 'Hong Miao', 'title': 'department manager' },

{ 'name': 'Yu Wei', 'title': 'department manager' },

{ 'name': 'Chun Miao', 'title': 'department manager' },

{ 'name': 'Yu Tie', 'title': 'department manager' }

]

orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'depth': 2,

'nodeContent': 'title'

});

I wanna align orgchart with different orientation(this feature comes from the good idea of fvlima and badulesia

😊)

Top to Bottom -- default direction, as you can see all other examples on this page.

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'direction': 'b2t'

});

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'direction': 'l2r'

});

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'direction': 'r2l'

});

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'toggleSiblingsResp': true

});

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : '/orgchart/initdata',

'depth': 2,

'nodeContent': 'title'

});

Note: when users use ajaxURL option to build orghchart, they must use json datasource(both local and remote are OK) and set the relationship property of datasource by themselves. All of these staff are used to generate the correct expanding/collapsing arrows for nodes.

// sample of core source code

let datascource = {

'id': '1',

'name': 'Su Miao',

'title': 'department manager',

'relationship': '111',

'children': [

{ 'id': '2','name': 'Tie Hua', 'title': 'senior engineer', 'relationship': '110' },

{ 'id': '3','name': 'Hei Hei', 'title': 'senior engineer', 'relationship': '111' }

]

ajaxURLs = {

'children': '/orgchart/children/',

'parent': '/orgchart/parent/',

'siblings': function(nodeData) {

return '/orgchart/siblings/' + nodeData.id;

'families': function(nodeData) {

return '/orgchart/families/' + nodeData.id;

}

orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'ajaxURL': ajaxURLs,

'nodeContent': 'title',

'nodeId': 'id'

});

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'depth': 2,

'nodeContent': 'title',

'nodeID': 'id',

'createNode': function(node, data) {

let secondMenuIcon = document.createElement('i'),

secondMenu = document.createElement('div');

secondMenuIcon.setAttribute('class', 'fa fa-info-circle second-menu-icon');

secondMenuIcon.addEventListener('click', (event) => {

event.target.nextElementSibling.classList.toggle('hidden');

});

secondMenu.setAttribute('class', 'second-menu hidden');

secondMenu.innerHTML = ``;

node.appendChild(secondMenuIcon)

node.appendChild(secondMenu);

}

});

Here, we need the help from html2canvas.

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'depth': 2,

'nodeContent': 'title',

'exportButton': true,

'exportFilename': 'MyOrgChart'

});

Here, we fall back on OpenLayers. It's the most aewsome open-source js library for Web GIS you sholdn't miss.

// sample of core source code

let map = new ol.Map({

layers: [

new ol.layer.Tile({

source: new ol.source.Stamen({

layer: 'watercolor'

}),

preload: 4

}),

new ol.layer.Tile({

source: new ol.source.Stamen({

layer: 'terrain-labels'

}),

preload: 1

})

target: 'pageBody',

view: new ol.View({

center: ol.proj.transform([-87.6297980, 41.8781140], 'EPSG:4326', 'EPSG:3857'),

zoom: 10

})

});

document.body.insertBefore(document.querySelector('#chart-container'), map.getViewport());

let datascource = {

'name': 'Lao Lao',

'title': 'President Office',

'position': [-87.6297980, 41.8781140],

'children': [

{ 'name': 'Bo Miao', 'title': 'Administration Dept.', 'position': [-83.0457540, 42.3314270]},

{ 'name': 'Su Miao', 'title': 'R & D Dept.', 'position': [-81.6943610, 41.4993200]},

{ 'name': 'Yu Jie', 'title': 'Product Dept.', 'position': [-71.0588800, 42.3600820]},

{ 'name': 'Yu Li', 'title': 'Legal Dept.', 'position': [-74.0059410, 40.7127840]},

{ 'name': 'Hong Miao', 'title': 'Finance Dept.', 'position': [-80.8431270, 35.2270870]},

{ 'name': 'Yu Wei', 'title': 'Security Dept.', 'position': [-81.6556510, 30.3321840]},

{ 'name': 'Chun Miao', 'title': 'HR Dept. ', 'position': [-81.3792360, 28.5383350]},

{ 'name': 'Yu Tie', 'title': 'Marketing Dept.', 'position': [-80.1917900, 25.7616800] }

]

orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'createNode': function(node, data) {

node.addEventListener('click', () => {

let view = map.getView(),

duration = 2000,

start = +new Date(),

pan = ol.animation.pan({

'duration': duration,

'source': view.getCenter(),

'start': start

}),

bounce = ol.animation.bounce({

'duration': duration,

'resolution': 4 * view.getResolution(),

'start': start

});

map.beforeRender(pan, bounce);

view.setCenter(ol.proj.transform(data.position, 'EPSG:4326', 'EPSG:3857'));

});

}

});

With the help of exposed core methods(addParent(), addSiblings(), addChildren(), removeNodes()) of orgchart plugin, we can finish this task easily.

import OrgChart from '../js/orgchart.min.js';

function addNodes(orgchart) {

let chartContainer = document.getElementById('chart-container'),

nodeVals = [];

Array.from(document.getElementById('new-nodelist').querySelectorAll('.new-node'))

.forEach(item => {

let validVal = item.value.trim();

if (validVal) {

nodeVals.push(validVal);

}

});

let selectedNode = document.getElementById(document.getElementById('selected-node').dataset.node);

if (!nodeVals.length) {

alert('Please input value for new node');

return;

}

let nodeType = document.querySelector('input[name="node-type"]:checked');

if (!nodeType) {

alert('Please select a node type');

return;

}

if (nodeType.value !== 'parent' && !document.querySelector('.orgchart')) {

alert('Please creat the root node firstly when you want to build up the orgchart from the scratch');

return;

}

if (nodeType.value !== 'parent' && !selectedNode) {

alert('Please select one node in orgchart');

return;

}

if (nodeType.value === 'parent') {

if (!chartContainer.children.length) {// if the original chart has been deleted

orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : { 'name': nodeVals[0] },

'exportButton': true,

'exportFilename': 'SportsChart',

'parentNodeSymbol': 'fa-th-large',

'createNode': function(node, data) {

node.id = getId();

}

});

orgchart.chart.classList.add('view-state');

} else {

orgchart.addParent(chartContainer.querySelector('.node'), { 'name': nodeVals[0], 'Id': getId() });

}

} else if (nodeType.value === 'siblings') {

orgchart.addSiblings(selectedNode, {

'siblings': nodeVals.map(item => {

return { 'name': item, 'relationship': '110', 'Id': getId() };

})

});

} else {

let hasChild = selectedNode.parentNode.colSpan > 1;

if (!hasChild) {

let rel = nodeVals.length > 1 ? '110' : '100';

orgchart.addChildren(selectedNode, {

'children': nodeVals.map(item => {

return { 'name': item, 'relationship': rel, 'Id': getId() };

})

});

} else {

orgchart.addSiblings(closest(selectedNode, el => el.nodeName === 'TABLE').querySelector('.nodes').querySelector('.node'),

{ 'siblings': nodeVals.map(function(item) { return { 'name': item, 'relationship': '110', 'Id': getId() }; })

});

}

document.addEventListener('DOMContentLoaded', function () {

let orgchart,

datascource = {

'name': 'Ball game',

'children': [

{ 'name': 'Football' },

{ 'name': 'Basketball' },

{ 'name': 'Volleyball' }

]

};

orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'exportButton': true,

'exportFilename': 'SportsChart',

'parentNodeSymbol': 'fa-th-large',

'createNode': function(node, data) {

node.id = getId();

}

});

document.getElementById('btn-add-nodes').addEventListener('click', () => addNodes(orgchart));

});

Users are allowed to drag & drop the nodes of orgchart when option "draggable" is assigned to true(Note: this feature doesn't work on IE due to its poor support for HTML5 drag & drop API).

Furthermore, users can make use of option dropCriteria to inject their custom limitations on drag & drop. As shown below, we don't want an manager employee to be under a engineer under no circumstance.

// sample of core source code

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'draggable': true,

'dropCriteria': function(draggedNode, dragZone, dropZone) {

if(draggedNode.querySelector(':scope > .content').textContent.includes('manager') &&

dropZone.querySelector(':scope > .content').textContent.includes('engineer')) {

return false;

}

return true;

}

});

That's where getHierarchy() comes in.

Lao Lao
- Bo Miao
- Su Miao
  - Tie Hua
  - Hei Hei
    - Pang Pang
    - Xiang Xiang

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : '#ul-data'

});

document.querySelector('#btn-export-hier').addEventListener('click', () => {

if (!document.querySelector('pre')) {

let pre = document.createElement('pre'),

hierarchy = orgchart.getHierarchy();

pre.innerHTML = JSON.stringify(hierarchy, null, 2);

document.querySelector('body').insertBefore(pre, document.querySelector('.home-link'));

}

});

It's a so easy task, we just need to append id or className property to node data.

let datasource = {

'name': 'Lao Lao',

'title': 'general manager',

'className': 'top-level',

'children': [

{ 'name': 'Bo Miao', 'title': 'department manager', 'className': 'middle-level',

'children': [

{ 'name': 'Li Jing', 'title': 'senior engineer', 'className': 'bottom-level' },

{ 'name': 'Li Xin', 'title': 'senior engineer', 'className': 'bottom-level' }

]

}

};

.orgchart .top-level .title {

background-color: #006699;

}

.orgchart .top-level .content {

border-color: #006699;

}

.orgchart .middle-level .title {

background-color: #009933;

}

.orgchart .middle-level .content {

border-color: #009933;

}

.orgchart .bottom-level .title {

background-color: #993366;

}

.orgchart .bottom-level .content {

border-color: #993366;

}

In fact, this is a wonderful solution to display a orgchart which includes a huge number of node data.

This feature is inspired by the issues(Aligning Children Vertical, Hybrid(horizontal + vertical) OrgChart). Thank mfahadi and Destructrix for their constructive suggestions

😊

From now on, users never have to worry about how to align a huge of nodes in one screen of browser. The option "verticalDepth" allows users to align child nodes vertically from the given depth.

Note: currently, this option is incompatible with many other options or methods, like direction, drag&drop, addChildren(), removeNodes(), getHierarchy() and so on. These conflicts will be solved one by one in the later versions.

let orgchart = new OrgChart({

'chartContainer': '#chart-container',

'data' : datascource,

'nodeContent': 'title',

'verticalDepth': 3, // From the 3th level of orgchart, nodes will be aligned vertically.

'depth': 4

});

Usage

Instantiation Statement

let orgchart = new OrgChart(options);

Structure of Datasource

{

'id': 'rootNode', // It's a optional property which will be used as id attribute of node

// and data-parent attribute, which contains the id of the parent node

'className': 'top-level', // It's a optional property which will be used as className attribute of node.

'nodeTitlePro': 'Lao Lao',

'nodeContentPro': 'general manager',

'relationship': relationshipValue, // Note: when you activate ondemand loading nodes feature,

// you should use json datsource (local or remote) and set this property.

// This property implies that whether this node has parent node, siblings nodes or children nodes.

// relationshipValue is a string composed of three "0/1" identifier.

// First character stands for wether current node has parent node;

// Scond character stands for wether current node has siblings nodes;

// Third character stands for wether current node has children node.

'children': [ // The property stands for nested nodes. "children" is just default name you can override.

{ 'nodeTitlePro': 'Bo Miao', 'nodeContentPro': 'department manager', 'relationship': '110' },

{ 'nodeTitlePro': 'Su Miao', 'nodeContentPro': 'department manager', 'relationship': '111',

'children': [

{ 'nodeTitlePro': 'Tie Hua', 'nodeContentPro': 'senior engineer', 'relationship': '110' },

{ 'nodeTitlePro': 'Hei Hei', 'nodeContentPro': 'senior engineer', 'relationship': '110' }

]

{ 'nodeTitlePro': 'Yu Jie', 'nodeContentPro': 'department manager', 'relationship': '110' }

'otherPro': anyValue

};

Options

Name

Type

Required

Default

Description

chartContainer

string

yes

selector usded to query the wrapper element of orgchart. It could be an id or an unique className.

data

json or string

yes

datasource usded to build out structure of orgchart. It could be a json object or a string containing the URL to which the ajax request is sent.

pan

boolean

false

Users could pan the orgchart by mouse drag&drop if they enable this option.

zoom

boolean

false

Users could zoomin/zoomout the orgchart by mouse wheel if they enable this option.

direction

string

"t2b"

The available values are t2b(implies "top to bottom", it's default value), b2t(implies "bottom to top"), l2r(implies "left to right"), r2l(implies "right to left").

verticalDepth

integer

Users can make use of this option to align the nodes vertically from the specified depth.

toggleSiblingsResp

boolean

false

Once enable this option, users can show/hide left/right sibling nodes respectively by clicking left/right arrow.

ajaxURL

json

It inclueds four properites -- parent, children, siblings, families(ask for parent node and siblings nodes). As their names imply, different propety provides the URL to which ajax request for different nodes is sent.

depth

positive integer

999

It indicates the level that at the very beginning orgchart is expanded to.

nodeTitle

string

"name"

It sets one property of datasource as text content of title section of orgchart node. In fact, users can create a simple orghcart with only nodeTitle option.

parentNodeSymbol

string

"fa-users"

Using font awesome icon to imply that the node has child nodes.

nodeContent

string

It sets one property of datasource as text content of content section of orgchart node.

nodeId

string

"id"

It sets one property of datasource as unique identifier of every orgchart node.

createNode

function

It's a callback function used to customize every orgchart node. It recieves two parament: "$node" stands for jquery object of single node div; "data" stands for datasource of single node.

exportButton

boolean

false

It enable the export button for orgchart.

exportFilename

string

"Orgchart"

It's filename when you export current orgchart as a picture.

chartClass

string

when you wanna instantiate multiple orgcharts on one page, you should add diffent classname to them in order to distinguish them.

draggable

boolean

false

Users can drag & drop the nodes of orgchart if they enable this option. **Note**: this feature doesn't work on IE due to its poor support for HTML5 drag & drop API.

dropCriteria

function

Users can construct their own criteria to limit the relationships between dragged node and drop zone. Furtherly, this function accept three arguments(draggedNode, dragZone, dropZone) and just only return boolen values.

Methods

I'm sure that you can grasp the key points of the methods below after you try out demo -- edit orgchart.

let orgchart = new OrgChart(options);

Embeds an organization chart in designated container. Accepts an options object and you can go through the "options" section to find which options are required.

.addParent(root, data)

Adds parent node(actullay it's always root node) for current orgchart.

Name

Type

Required

Default

Description

root

dom node

yes

root node of designated orgchart

options used for overriding initial options

data

json object

yes

datasource for building root node ##### .addSiblings(node, data) Adds sibling nodes for designated node.

Name

Type

Required

Default

Description

node

dom node

yes

we'll add sibling nodes based on this node

data

json object

yes

datasource for building sibling nodes ##### .addChildren(node, data) Adds child nodes for designed node.

Name

Type

Required

Default

Description

node

dom node

yes

we'll add child nodes based on this node

data

json object

yes

datasource for building child nodes ##### .removeNodes(node) Removes the designated node and its descedant nodes.

Name

Type

Required

Default

Description

node

dom node

yes

node to be removed ##### .getHierarchy() This method is designed to get the hierarchy relationships of orgchart for further processing. For example, after editing the orgchart, you could send the returned value of this method to server-side and save the new state of orghcart. ##### .hideChildren(node) This method allows you to hide programatically the children of any specific node(.node element), if it has

Name

Type

Required

Default

Description

node

dom node

Yes

None

It's the desired dom node that we'll hide its children nodes ##### .showChildren(node) This method allows you to show programatically the children of any specific node(.node element), if it has

Name

Type

Required

Default

Description

node

dom node

Yes

None

It's the desired dom node that we'll show its children nodes ##### .hideSiblings(node, direction) This method allows you to hide programatically the siblings of any specific node(.node element), if it has

Name

Type

Required

Default

Description

node

dom node

Yes

None

It's the desired dom node that we'll hide its siblings nodes

direction

string

None

Possible values:"left","rigth". Specifies if hide the siblings at left or rigth. If not defined hide both of them. ##### .showSiblings(node, direction) This method allows you to show programatically the siblings of any specific node(.node element), if it has

Name

Type

Required

Default

Description

node

dom node

Yes

None

It's the desired dom node that we'll show its siblings nodes

direction

string

None

Possible values:"left","rigth". Specifies if hide the siblings at left or rigth. If not defined hide both of them. ##### .getNodeState(node, relation) This method returns you the display state of the related nodes.

Name

Type

Required

Default

Description

node

dom node

Yes

None

It's the desired dom node that we wanna know its related nodes' display state.

relation

String

Yes

None

Possible values: "parent", "children" and "siblings". Specifies the desired relation to return. The returning object will have the next structure: ```js { "exists": true|false, //Indicates if has parent|children|siblings "visible":true|false, //Indicates if the related nodes are visible } ``` ##### .getRelatedNodes(node, relation) This method returns you the nodes related to the specified node

Name

Type

Required

Default

Description

node

dom node

Yes

None

It's the desired that we wanna get its related nodes

relation

String