DevExtreme v24.1 is now available.

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

Your search did not match any results.

JavaScript/jQuery Charts - 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
$(() => { const algorithms = ['sliceAndDice', 'squarified', 'strip', 'custom']; let currentAlgorithm = algorithms[2]; const treeMap = $('#treemap').dxTreeMap({ dataSource: populationByAge, layoutAlgorithm: currentAlgorithm, colorizer: { type: 'discrete', colorizeGroups: true, }, title: 'Population by Age Groups', tooltip: { enabled: true, format: 'thousands', customizeTooltip(arg) { const { data } = arg.node; const parentData = arg.node.getParent().data; let result = ''; if (arg.node.isLeaf()) { result = `<span class='country'>${parentData.name}</span><br />${ data.name}<br />${arg.valueText} (${ ((100 * data.value) / parentData.total).toFixed(1)}%)`; } else { result = `<span class='country'>${data.name}</span>`; } return { text: result, }; }, }, }).dxTreeMap('instance'); $('#algorithm').dxSelectBox({ items: algorithms, width: 200, inputAttr: { 'aria-label': 'Algorithm' }, value: currentAlgorithm, onValueChanged(data) { if (data.value === 'custom') { currentAlgorithm = customAlgorithm; } else { currentAlgorithm = data.value; } treeMap.option('layoutAlgorithm', currentAlgorithm); }, }); function customAlgorithm(arg) { let side = 0; const totalRect = arg.rect.slice(); let totalSum = arg.sum; arg.items.forEach((item) => { const size = Math.round(((totalRect[side + 2] - totalRect[side]) * item.value) / totalSum); const rect = totalRect.slice(); totalSum -= item.value; totalRect[side] += size; rect[side + 2] = totalRect[side]; item.rect = rect; side = 1 - side; }); } });
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" 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" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.7/css/dx.light.css" /> <script src="js/dx.all.js"></script> <script src="data.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="treemap"></div> <div class="options"> <div class="caption">Options</div> <div class="option"> <span>Tiling Algorithm</span> <div id="algorithm" class="selectbox"></div> </div> </div> </div> </body> </html>
#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: 10px; } .option > .dx-widget { display: inline-block; vertical-align: middle; }
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, }], }];

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.