All plotly.js bundles inject an object Plotly into the global scope.
Import plotly.js as:
<script src="plotly.min.js"></script>or the un-minified version as:
<script src="plotly.js" charset="utf-8"></script>Plotly.js defaults to US English (en-US) and includes British English (en) in the standard bundle. Many other localizations are available - here is an example using Swiss-German (de-CH), see the contents of this directory for the full list. Note that the file names are all lowercase, even though the region is uppercase when you apply a locale.
After the plotly.js script tag, add:
<script src="plotly-locale-de-ch.js"></script>
<script>Plotly.setPlotConfig({locale: 'de-CH'})</script>The first line loads and registers the locale definition with plotly.js, the second sets it as the default for all Plotly plots.
You can also include multiple locale definitions and apply them to each plot separately as a config parameter:
Plotly.newPlot(graphDiv, data, layout, {locale: 'de-CH'})The main plotly.js bundle includes all trace modules.
The main plotly.js bundles weight in at:
| plotly.js | plotly.min.js | plotly.min.js + gzip | plotly-with-meta.js |
|---|---|---|---|
| 8.3 MB | 3.5 MB | 1 MB | 8.6 MB |
If you would like to have access to the attribute meta information (including attribute descriptions as on the schema reference page), use dist file
dist/plotly-with-meta.js
plotly.js also ships with several partial bundles:
Each plotly.js partial bundle has a corresponding npm package with no dependencies.
The minified version of each partial bundle is also published to npm in a separate "dist-min" package.
The strict bundle now includes all traces, but the regl-based traces are built differently to avoid function constructors. This results in about a 10% larger bundle size, which is why this method is not used by default. Over time we intend to use the strict bundle to work on other strict CSP issues such as inline CSS.
The basic partial bundle contains trace modules bar, pie and scatter.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 2.7 MB | 1000.7 kB | 334.3 kB |
The cartesian partial bundle contains trace modules bar, box, contour, heatmap, histogram, histogram2d, histogram2dcontour, image, pie, scatter, scatterternary and violin.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 3.4 MB | 1.2 MB | 422.4 kB |
The geo partial bundle contains trace modules choropleth, scatter and scattergeo.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 3.2 MB | 1.1 MB | 377.2 kB |
The gl3d partial bundle contains trace modules cone, isosurface, mesh3d, scatter, scatter3d, streamtube, surface and volume.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 3.6 MB | 1.5 MB | 498.9 kB |
The gl2d partial bundle contains trace modules heatmapgl, parcoords, pointcloud, scatter, scattergl and splom.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 4.4 MB | 1.9 MB | 605.6 kB |
The mapbox partial bundle contains trace modules choroplethmapbox, densitymapbox, scatter and scattermapbox.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 4.4 MB | 1.8 MB | 536.1 kB |
The finance partial bundle contains trace modules bar, candlestick, funnel, funnelarea, histogram, indicator, ohlc, pie, scatter and waterfall.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 2.9 MB | 1.1 MB | 363.7 kB |
The strict partial bundle contains trace modules bar, barpolar, box, candlestick, carpet, choropleth, choroplethmapbox, cone, contour, contourcarpet, densitymapbox, funnel, funnelarea, heatmap, heatmapgl, histogram, histogram2d, histogram2dcontour, icicle, image, indicator, isosurface, mesh3d, ohlc, parcats, parcoords, pie, pointcloud, sankey, scatter, scattergl, scatter3d, scattercarpet, scattergeo, scattermapbox, scatterpolar, scatterpolargl, scattersmith, scatterternary, splom, streamtube, sunburst, surface, table, treemap, violin, volume and waterfall.
| Raw size | Minified size | Minified + gzip size |
|---|---|---|
| 8.7 MB | 3.8 MB | 1.1 MB |
This file is auto-generated by npm run stats. Please do not edit this file directly.