DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Tiling Algorithms

Layout algorithms determine the position and size of tiles and groups. In this demo, you can use the drop-down menu below the component to apply different algorithms.

www.wikipedia.org
Backend API
<template> <div> <DxTreeMap id="treemap" :data-source="populationByAge" :layout-algorithm="currentAlgorithm" title="Population by Age Groups" > <DxColorizer :colorize-groups="true" type="discrete" /> <DxTooltip :enabled="true" :customize-tooltip="customizeTooltip" format="thousands" /> </DxTreeMap> <div class="options"> <div class="caption">Options</div> <div class="option"> <span>Tiling Algorithm</span> <DxSelectBox :data-source="algorithms" :input-attr="{ 'aria-label': 'Algorithm' }" :width="200" v-model:value="selectedAlgorithm" /> </div> </div> </div> </template> <script setup lang="ts"> import { computed, ref } from 'vue'; import DxTreeMap, { DxColorizer, DxTooltip, } from 'devextreme-vue/tree-map'; import { DxSelectBox } from 'devextreme-vue/select-box'; import { populationByAge } from './data.ts'; const algorithms = ['sliceAndDice', 'squarified', 'strip', 'custom']; const selectedAlgorithm = ref(algorithms[2]); const currentAlgorithm = computed(() => ((selectedAlgorithm.value === 'custom') ? customAlgorithm : selectedAlgorithm.value)); function customizeTooltip({ node, node: { data: { name, value } }, valueText }) { const parentData = node.getParent().data; return { text: node.isLeaf() ? `<span class='country'>${parentData.name}</span><br />${name}<br />${valueText}(${((100 * value) / parentData.total).toFixed(1)}%)` : `<span class='country'>${name}</span>`, }; } function customAlgorithm({ rect, sum, items }) { const totalRect = rect.slice(); let totalSum = sum; let side = 0; items.forEach((item) => { const size = Math.round(((totalRect[side + 2] - totalRect[side]) * item.value) / totalSum); const itemRect = totalRect.slice(); totalSum -= item.value; totalRect[side] += size; itemRect[side + 2] = totalRect[side]; item.rect = itemRect; side = 1 - side; }); } </script> <style scoped> #treemap { height: 460px; } .country { font-weight: 500; } .options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } .option { margin-top: 10px; } .caption { font-size: 18px; font-weight: 500; } .option > span { margin-right: 14px; } .option > .dx-widget { display: inline-block; vertical-align: middle; } </style>
window.exports = window.exports || {}; window.config = { transpiler: 'plugin-babel', meta: { '*.vue': { loader: 'vue-loader', }, '*.ts': { loader: 'demo-ts-loader', }, '*.svg': { loader: 'svg-loader', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'root:': '../../../../', 'npm:': 'https://unpkg.com/', }, map: { 'vue': 'npm:vue@3.2.47/dist/vue.esm-browser.js', 'vue-loader': 'npm:dx-systemjs-vue-browser@1.1.1/index.js', 'demo-ts-loader': 'root:utils/demo-ts-loader.js', 'svg-loader': 'root:utils/svg-loader.js', 'mitt': 'npm:mitt/dist/mitt.umd.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@24.1.3/cjs', 'devextreme-vue': 'npm:devextreme-vue@24.1.3/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.8/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', 'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme-vue': { main: 'index.js', }, 'devextreme': { defaultExtension: 'js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.13/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, }, }; System.config(window.config);
export const populationByAge = [{ name: 'Brazil', total: 200050486, items: [{ name: 'Age 0-14', value: 48058462, }, { name: 'Age 15-44', value: 96036995, }, { name: 'Age 45-64', value: 40715296, }, { name: 'Age 65+', value: 15239733, }], }, { name: 'Japan', total: 126345237, items: [{ name: 'Age 0-14', value: 16593766, }, { name: 'Age 15-44', value: 45455276, }, { name: 'Age 45-64', value: 32845790, }, { name: 'Age 65+', value: 31450405, }], }, { name: 'United States', total: 318497627, items: [{ name: 'Age 0-14', value: 63968935, }, { name: 'Age 15-44', value: 127217843, }, { name: 'Age 45-64', value: 83145484, }, { name: 'Age 65+', value: 44165365, }], }];
import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#app');
<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="dx-theme" data-theme="generic.light" href="https://cdn3.devexpress.com/jslib/24.1.3/css/dx.light.css" /> <script src="https://unpkg.com/typescript@4.9.5/lib/typescript.js"></script> <script type="module"> import * as vueCompilerSFC from "https://unpkg.com/@vue/compiler-sfc@3.4.16/dist/compiler-sfc.esm-browser.js"; window.vueCompilerSFC = vueCompilerSFC; </script> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.ts"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"> </div> </div> </body> </html>

The TreeMap component supports three layout algorithms out of the box:

  • Squarified (default)
    This algorithm lays the items out so that the aspect ratio will be closer to 1. In other words, this algorithm tries to make items as square as possible.

  • Strip
    This algorithm is a modification of the "Squarified" algorithm. At the beginning, the algorithm has an available area divided into several strips and a set of items to distribute between the strips. Throughout the layout process, the current strip is maintained. For each item to be arranged, the algorithm checks whether or not adding the item to the current strip improves the average aspect ratios of the rectangles in the current strip. If so, the item is added to the current strip. Otherwise, it is added to the next strip.

  • Slice and Dice
    This algorithm uses parallel lines to divide an available area into rectangles that visualize items. In a hierarchical structure, each rectangle that visualizes an item is further divided into smaller rectangles that visualize its children, and so on.

Use the layoutAlgorithm property to specify the tile layout. You can also implement your own algorithm. For this purpose, assign a function to the layoutAlgorithm property. This function calculates the coordinates of two diagonally-opposing points that define a rectangle and assigns them to the required item.