data-joint

data-joint

Perform data joins with any type of JavaScript objects.

Quick start

import digest from 'data-joint';

or

const digest = require('data-joint');

or even

<script src="//unpkg.com/data-joint"></script>

then

const myData = [{ id: 0, val: 2 }, { id: 1, val: 4 }, { id: 2, val: 7 }];
const myView = new Set();

digest(myData, [...myView], 
    obj => myView.add(obj), // append obj
    obj => myView.remove(obj), // remove obj
    {
        createObj: () => ({}),
        updateObj: (obj, d) => { d.double = d.val * 2 },
        exitObj: obj => { d.double = 0 },
        idAccessor: d => d.id
    }
);

API reference

Syntax

digest(data, existingObjs, appendObjFn, removeObjFn, [{options}]);

Arguments

data: An array of data points. Each point should be an object that supports attribute binding.

existingObjs: An array of view objects to join the data with.

appendObjFn: The method to add a new object to the view. The object is passed as single argument: obj => { ... }.

removeObjFn: The method to remove an existing object from the view. The object is passed as single argument: obj => { ... }.

Options

An optional configuration object supporting the additional arguments:

Option	Description	Default
createObj	The method to create an entering view object for a new data point that does not have a corresponding object. The data point is passed as single argument: d => { ... }. The method should return a new object.	d => ({})
updateObj	The method to update an existing bound object with new data. The object and the data point are passed as arguments: (obj, d) => { ... }. This method is also called for entering objects after createObj.	(obj, d) => {}
exitObj	The method to handle exiting objects which no longer have a corresponding data point. The unbound object is passed as single argument: obj => { ... }. This method is called prior to removing it from the view via removeObjectFn.	obj => {}
objBindAttr	The attribute name used to bind data points to view objects. Each data point passed through the digest will be added this attribute, and it will be used for diffing across multiple iterations.	__obj
dataBindAttr	The attribute name used to bind view objects to data points. Each object maintained by the digest will be added this attribute, and it will be used for diffing across multiple iterations.	__data
idAccessor	A data point accessor function to extract the point unique identifier. This used for comparing data points across multiple iterations. If no idAccessor is supplied the, data point object reference will be used instead for comparisons. The data point is passed as single argument: d => {...}. The method should return a unique identifier.	undefined