Print Data-Cubes in HTML documents.

See docs/index.html for examples.

The module adds two methods to Array.prototype:

• print: print a cube (or a standard array)

• info: print summary information about a cube (or a standard array)

These methods return a <div> containing the printed cube/array. Typically, we use the to option (see below) to specify where the array/cube should be printed; this is slightly simpler than adding the <div> to the document explicitly.

Notes:

• The module exports a function that can be used to change how entries, indices, keys and labels are formatted — see Format. When a <script> tag is used to load the module, the exported function is assigned to the global variable setFormat. See the Data-Cube plugins page for further usage instructions.

• There are example styles in docs/styles. Using one of these is an easy way to get started (though the styles are currently rather minimal so be wary of other CSS leaking in).

• print will generate the same HTML for the standard array [5,6,7] and the vector [5,6,7].toCube(). However, print and info do not convert a standard array to a cube like core Data-Cube methods do.

print takes a single 'options' object as an argument. The object can include the properties:

The info method also accepts an options argument, but only uses the properties to and id.

print adds the following classes to the HTML elements that it creates:

When the type option is truthy, each entry <td> contains an additional class; one of: number, string, boolean, undefined, null, date, function, cube, array, other.

Notes:

• Some table elements may not exist. For example, if row indices/keys are not being printed (see the indexKey option), the HTML tables for each page will not contain the associated <td> elements.

• Use data attributes to get the <td> element for an individual entry or a group of entries — see the entryAttr and tableAttr options.

The <div> returned by info also has the data-cube-wrap class. The <table> inside the <div> has the info-table class.

Every printed entry, index, key and label is passed through a 'format function'. This module exports a single function that can be used to alter the default format functions. For example:

//if the module is loaded in a <script> tag, the
//exported function is the global variable setFormat
setFormat({
  number: x => '$' + Math.round(x),        //print numbers as dollars
  rowLabel: label => label.toUpperCase()   //print row labels in uppercase
});

The format functions are:

Notes:

• The default format functions do not escape HTML strings.

• The default string format function does replace \n with <br>.

There are also some high-level formatting properties that can be modified using the exported function:

Call the exported function with no arguments to reset all format functions and properties to their defaults.