Security News
NIST Misses 2024 Deadline to Clear NVD Backlog
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.
This project is a Makefile for building Graphviz with Emscripten and a simple wrapper for using it in the browser.
Install with Bower:
bower install viz.js
Or with npm:
npm install viz.js
Or download the viz.js
"binary" from the releases page.
A smaller version of Viz.js can be downloaded from the releases page. viz-lite.js
omits Expat and the NEATO layout plugin.
src
is a string representing the graph to render in the DOT language.options
format
sets the output format, and may be one of "svg"
, "xdot"
, "plain"
, "ps"
, or "png-image-element"
.engine
sets the Graphviz engine to use, and may be one of "circo"
, "dot"
, "neato"
, "osage"
, or "twopi"
.scale
sets the scale factor for the "png-image-element"
format. If this is not specified, window.devicePixelRatio
will be used if available, and 1
if not.Parses src
and renders a graph according to the options
given. Output is a string, except when using the "png-image-element" format, when it is returned as an instance of HTMLImageElement.
For example:
result = Viz("digraph { a -> b; }");
result = Viz("digraph { a -> b; }", { format: "png-image-element", scale: 2 });
result = Viz("graph { n0 -- n1 -- n2 -- n3 -- n0; }", { engine: "neato" });
result = Viz("digraph { x -> y -> z; }", { format: "plain" });
If Graphviz encounters an error, the error message will be thrown as an exception.
svgXml
is an SVG XML string, as may be obtained from the Viz
function using the "svg"
format option.scale
sets the scale factor for the output. If this is not specified, window.devicePixelRatio
will be used if available, and 1
if not.callback
is an optional Node-style callback. If specified, it is given two arguments, (err, image)
. If not specified, Viz.svgXmlToPngImageElement
returns an instance of HTMLImageElement.Converts svgXml
to a PNG HTMLImageElement. If callback
is specfied, image
is loaded by the time the callback is invoked.
svgXml
is an SVG XML string, as may be obtained from the Viz
function using the "svg"
format option.scale
sets the scale factor for the output. If this is given as undefined
, window.devicePixelRatio
will be used if available, and 1
if not.callback
is a Node-style callback. It is given two arguments, (err, data)
.Converts svgXml
to a PNG represented as a Base64 string. This function requires a callback, unlike svgXmlToPngImageElement
.
These engines are supported:
These formats are supported:
Viz.js provides the "png-image-element"
format in addition to the regular Graphviz formats. This returns an HTMLImageElement
which can be inserted into the document.
image = Viz("digraph g { a -> b; }", { format: "png-image-element" });
document.body.appendChild(image);
However, this won't work in a Web Worker context. In that case, ask for the "svg"
format in the worker and convert using the accessory function Viz.svgXmlToPngImageElement
in the window context. See tests/png.js for an example.
Internet Explorer 10 and 11 require Fabric.js as an optional dependency for PNG output. Viz.js will look for a fabric
object as a member of the global object with a loadSVGFromString()
function and use that if present.
To build from source, you will need to install the Emscripten SDK.
To download the sources and build everything:
make
If you find Viz.js useful, please consider a donation. Thank you!
FAQs
A hack to put Graphviz on the web.
The npm package viz.js receives a total of 52,659 weekly downloads. As such, viz.js popularity was classified as popular.
We found that viz.js demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.
Security News
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
Security News
The Socket Research team breaks down a malicious npm package targeting the legitimate DOMPurify library. It uses obfuscated code to hide that it is exfiltrating browser and crypto wallet data.