Hierarchical Data Structure

The TreeMap component visualizes data as a set of rectangles (tiles). The tile size corresponds to a data point value relative to other data points.

The TreeMap component works with collections of objects. If objects in your collection have a plain structure, the component visualizes them as tiles. If your data is hierarchical, the TreeMap displays it as a group of nested tiles.

To bind data to the component, assign the collection of objects to the TreeMap's dataSource property.

Once you assign the data source, specify the valueField and labelField properties. If you specify these properties, the component can determine the object fields that indicate TreeMap labels and values in the collection. The default values for these properties are value and name, respectively.

If your data is hierarchical, you also need to specify the childrenField property. The default childrenField property value is items. You can use these data field names to arrange your collection as shown in this demo.

For example, one of the objects in this demo data source looks as follows:

{
    name: 'Australia',
    items: [{
        value: 4840600,
        name: 'Sydney',
        country: 'Australia',
    }, {
        value: 4440000,
        name: 'Melbourne',
        country: 'Australia',
    }],
}

This object produces a tile with the Australia label. The Australia tile has two nested tiles labeled Sydney and Melbourne.

To make the TreeMap more informative, you can specify a title and implement a tooltip.