@polymer-vis/vega-elements
v3.0.4
Published
Custom elements to visualize Vega and Vega-Lite views.
Downloads
4
Readme
@polymer-vis/vega-elements
@polymer-vis/vega-elements
is a suite of custom elements to render and interact with [Vega](https://vega.github.io/vega)
and [Vega-Lite](https://vega.github.io/vega-lite)
specifications and views.
More API documentation and Demos can be found on the web components page for vega-elements. More examples can also be found in the Github page.
Versions details
v3 is a breaking change, where the components are moved to npm
, and developed in typescript and inherits from lit-element
instead of polymer-element
.
- v3 Build with Typescript and inherits from Lit-Element (instead of Polymer-Element).
- v2 Supports Polymer 2.0, Vega 3.0, and Vega-Lite 2.0
- v1 Supports Polymer 1.0 and Vega 2.0
Components
Currently, only vega-embed
is available.
@polymer-vis/vega-elements/vega-embed.js
vega-embed
is a custom element that wraps around the vega-embed micro-lib.
Usage
Installation
npm i @polymer-vis/vega-elements --save
Usage in html
<vega-embed spec="/path/to/some/vega/spec.json"></vega-embed>
Usage in online code sharing hosts (e.g. jsfiddle, gist, etc)
<!-- Import Vega 4 & Vega-Lite 2 (as needed) -->
<script src="https://cdn.jsdelivr.net/npm/vega@[VERSION]"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-lite@[VERSION]"></script>
<!-- Load a bundled version of vega-embed custom element with jsdelivr -->
<script src="https://cdn.jsdelivr.net/npm/@polymer-vis/vega-elements/dist/vega-embed.bundled.min.js"></script>
<vega-embed spec="/path/to/some/vega/spec.json"></vega-embed>
<script>
// create a new vega-embed element programmatically
const ele = new VegaElements.VegaEmbed();
// set attribute
ele.setAttribute("show-export", true);
// set property
ele.showSource = true;
// set some spec
ele.spec = {...};
// attach to DOM
document.body.appendChild(ele);
</script>
Usage with lit-html
// import lit-html
import {render, html} from "lit-html";
// import the vega-embed element
import "./node_modules/vega-elements/vega-embed.js";
// vega-lite specification
conse scatterplot = {
"$schema": "https://vega.github.io/schema/vega-lite/v2.json",
"description": "A scatterplot showing horsepower and miles per gallons for various cars.",
"data": {"url": "data/cars.json"},
"mark": {"type": "point", "tooltip": {"content": "data"}},
"encoding": {
"x": {"field": "Horsepower", "type": "quantitative"},
"y": {"field": "Miles_per_Gallon", "type": "quantitative"},
"tooltip": [
{"field": "Horsepower", "type": "quantitative"},
{"field": "Miles_per_Gallon", "type": "quantitative"}
]
}
};
// create the factory method to create a html template result
const embedTmpl = (spec, opts) => html`<vega-embed spec=${spec} opts=${opts}></vega-embed>`;
// render the template result to document body
render(embedTmpl(scatterplot, {tooltip: true, renderer: "canvas"}), document.body);
UMD bundles
vega-elements
provides 2 pre-build UMD distributions (under the named scope VegaElements
) for vega-embed
custom element.
./dist/vega-embed.min.js
: Minimal bundle with only@polymer/lit-element
and@polymer-vis/vega-elements
. Vega, Vega-Lite, andvega-embed
should be imported separately../dist/vega-embed.bundled.min.js
: Bundle with@polymer/lit-element
,vega-embed
, and@polymer-vis/vega-elements
. Vega or/and Vega-Lite should be imported separately.
Disclaimer
PolymerVis is a personal project and is NOT in any way affliated with Vega, Vega-Lite, Polymer or Google.