README.md

vizzu-webpack-demo

This project is a showcase of bundling the Vizzu library with Webpack.

Vizzu lib comes with a WebAssembly module. Unfortunately Webpack cannot handle this out of box. To solve this problem Webpack and the Javascript code using Vizzu needs to be tweaked.

Steps to be done:

• In the JS code Vizzu's WebAssembly module location needs to be configured for Vizzu.
• Custom Webpack rule should be set for Vizzu's WebAssembly module.

Usage

If you merely want to try out this project, then clone the project and run the following commands to build and host it on localhost:

npm install
npm run build
npx serve -s dist

You will find the generated output in the dist folder.

Adding Vizzu to a project which using Webpack

Install Vizzu

If you'd like to use Vizzu in a project bundled using Webpack, the first thing you need to do is installing the Vizzu package from NPM:

npm install --save vizzu

Basic example

To create a simple bar chart, you can put the following code to your HTML and Javascript file.

<div id="myVizzu" style="width:800px; height:480px;"></div>

import Vizzu from 'vizzu';

// This is the place where you will place the code from the next paragraph
// to fix this example

let chart = new Vizzu('myVizzu', { data: {
	series: [ { name: 'Foo', values: ['Alice', 'Bob', 'Ted'] },
		  { name: 'Bar', values: [15, 32, 12] } ]
}});

chart.animate({ x: 'Foo', y: 'Bar' });

The code above won't yet work, because Vizzu will search for it's Webassembly module (cvizzu.wasm) in the same folder the library's Javascript file was included from.

Setting the WebAssemby module location for Vizzu

To solve this problem, we should show Vizzu, where can it find its Webassembly file by adding the following lines before the Vizzu constructor call:

import VizzuModule from 'vizzu/dist/cvizzu.wasm';

Vizzu.options({ wasmUrl: VizzuModule });

Setting Webpack rule for the WebAssemby module

We also need to change the default behaviour of Webpack for the WebAssembly module by adding the following configs into its project local config file webpack.config.js in the project root:

module.exports = {
	module: {
		rules: [
			{
				test: /cvizzu\.wasm$/,
				type: "javascript/auto",
				loader: "file-loader",
			}
		]
	}
};