TreeMap

Directive

kendo-treemap

Props

data-source Object | Array | kendo.data.HierarchicalDataSource

The data source of the TreeMap for rendering the titles and tiles (dataSource in Kendo UI for jQuery).

You can set data-source to:

  • A JavaScript object which represents any valid data source configuration.
  • A JavaScript array.
  • An existing kendo.data.HierarchicalDataSource instance.

If the dataSource option is set to a JavaScript object or an array, the TreeMap will initialize a new kendo.data.HierarchicalDataSource instance by using that value as a data source configuration. If the dataSource option is an existing kendo.data.HierarchicalDataSource instance, the TreeMap will use that instance and will not initialize a new one.

auto-bind Boolean

If auto-bind is set to false, the TreeMap will not bind to the data source during initialization (autoBind in Kendo UI for jQuery). In such scenarios data binding will occur when the change event of the dataSource instance is fired. By default, auto-bind is set to true and the TreeMap will bind to the data source that is specified in the configuration.

type String

The layout type for the TreeMap (type in Kendo UI for jQuery).

The supported values are:

  • squarified
  • horizontal
  • vertical

theme String

The theme of the TreeMap (theme in Kendo UI for jQuery).

value-field String

The data item field which contains the tile value (valueField in Kendo UI for jQuery).

color-field String

The data item field which contains the tile color (colorField in Kendo UI for jQuery).

text-field String

The data item field which contains the tile title (textField in Kendo UI for jQuery)

template String | Function

The template for rendering the tile content of the TreeMap (template in Kendo UI for jQuery).

The template supports the following fields:

  • dataItem—The original data item for constructing the point.
  • text—The original text of the tile.

colors Array

The default colors for the tiles of the TreeMap (colors in Kendo UI for jQuery). Accepts an array of specific colors or an array of color ranges.

Events

itemcreated: Function

Fired when a tile has been created (itemCreated in Kendo UI for jQuery.

databound: Function

Fired when the widget is bound to data from its dataSource (dataBound in Kendo UI for jQuery.

Methods

kendoWidget

returns

Returns the Kendo UI TreeMap instance.