@layer5/cytoscape-node-html-label
v3.0.0
Published
Add html labels to cytoscape nodes
Downloads
420
Readme
cytoscape-node-html-label
Description
This extension provides ability to add labels for Cytoscape nodes. Simple example:
cyInstance.nodeHtmlLabel( [{ tpl: d => '<div>' + d + '</div>' }] );
Features
- optimized for high performance with high number of nodes, for smooth panning and zooming.
- customizable labels with different templates.
Dependencies
- Cytoscape.js ^3.0.0
Usage instructions
Download the library:
- via npm:
npm install cytoscape-node-html-label
, - via bower:
bower install cytoscape-node-html-label
, or - via direct download from the repository (probably from a tag).
Plain HTML/JS has extension registered for you automatically:
<script src="http://cytoscape.github.io/cytoscape.js/api/cytoscape.js-latest/cytoscape.min.js"></script>
<script src="cytoscape-node-html-label.js"></script>
RequireJs approach:
require()
the library as appropriate for your project:
CommonJS:
var cytoscape = require('cytoscape');
var nodeHtmlLabel = require('cytoscape-node-html-label');
nodeHtmlLabel( cytoscape ); // register extension
AMD:
require(['cytoscape', 'cytoscape-node-html-label'], function( cytoscape, nodeHtmlLabel ){
nodeHtmlLabel( cytoscape ); // register extension
});
API
nodeHtmlLabel
parameter is an array of options:
cyInstance.nodeHtmlLabel([
{
query: 'node', // cytoscape query selector
halign: 'center', // title vertical position. Can be 'left',''center, 'right'
valign: 'center', // title vertical position. Can be 'top',''center, 'bottom'
halignBox: 'center', // title vertical position. Can be 'left',''center, 'right'
valignBox: 'center', // title relative box vertical position. Can be 'top',''center, 'bottom'
cssClass: '', // any classes will be as attribute of <div> container for every title
tpl(data) {
return '<span>' + data + '</span>'; // your html template here
}
}
]);
To make links clickable inside your labels, you need to pass enablePointerEvents: true
as the 3rd argument to nodeHtmlLabel
:
cyInstance.nodeHtmlLabel([
{
...
}
], {
enablePointerEvents: true
});
Usage example
Code example:
// create Cy instance
var cyInstance = cytoscape({
container: document.getElementById('cy'),
layout: {
name: 'random'
},
elements: [ // your cy elements
{ group: "nodes", data: { id: 'a1', name: 'a10' }, classes: 'l1' },
{ group: "nodes", data: { id: 'a1', name: 'a10' }, classes: 'l1' },
{ group: "nodes", data: { id: 'a1', name: 'a10' }, classes: 'l1' },
{ group: "nodes", data: { id: 'a5', name: 'a5' }, classes: 'l2' }
]
});
// set nodeHtmlLabel for your Cy instance
cyInstance.nodeHtmlLabel([{
query: '.l1',
valign: "top",
halign: "left",
valignBox: "top",
halignBox: "left",
tpl: function(data) {
return '<p class="cy-title__p1">' + data.id + '</p>' + '<p class="cy-title__p2">' + data.name + '</p>';
}
},
{
query: '.l2',
tpl: function(data) {
return '<p class="cy-title__p1">' + data.id + '</p>' + '<p class="cy-title__p2">' + data.name + '</p>';
}
}
]);
How to build and develop:
- Run
npm start
- Create change in src/cytoscape-node-html-label.ts
- When finished =>
npm run test
- Prepare js and min files:
npm run build
git commit
Then, for version update and publish:
- Create new npm version:
gulp patch
,gulp feature
orgulp release
npm publish
Join the Layer5 community!
Our projects are community-built and welcome collaboration. 👍 Be sure to see the Layer5 Community Welcome Guide for a tour of resources available to you and jump into our Slack!
Find out more on the Layer5 community.