React ツリーマップの概要

Ignite UI for React ツリーマップは、ネストされた一連のノードとして階層 (ツリー構造) データを表示します。ツリーの各ブランチにはツリーマップ ノードが提供されて、サブマップを表す小さなノードでタイル化されます。各ノードの長方形には、データ上の指定されたディメンションに比例した領域があります。多くの場合、ノードは色分けされて、データの個別のディメンションを示します。

React ツリーマップの例

Edit on CodeSandbox

色とサイズのディメンションが何らかの方法でツリー構造と関連付けられている場合、他の方法では見つけにくいパターンを簡単に識別できます。ツリーマップは、より効率的にスペースを使用します。このため、数千の項目を同時に画面に表示することが可能となります。

ツリーマップは、数値の表示ではなく相対的順位の表示に向いています。ツリーマップは、データ ポイントを分類し、値の相対的な差異の表示が円チャートや他のエリア チャートよりも効果的です。

データの要件

IgrTreemap のバインドは以下のデータ要件があります。

  • データソースはデータ項目の配列またはリストである必要があります。
  • データソースにはデータ項目を少なくとも 1 つ含む必要があり、含まれない場合はマップでノードがレンダリングされません。
  • すべてのデータ項目には、labelMemberPath プロパティにマッピングする必要があるデータ列 (文字列など) を少なくとも 1 列含める必要があります。
  • すべてのデータ項目には、valueMemberPath プロパティにマッピングする必要がある数値データ列を少なくとも 1 列含める必要があります。
  • データを整理されたタイルに分類するには、オプションで parentIdMemberPath および idMemberPath を使用できます。

レイアウトのタイプ

Ignite UI for React ツリーマップ コンポーネントは、以下のタイプのアルゴリズムをサポートします。

型は TreemapLayoutType プロパティの設定により定義されます。TreemapLayoutType プロパティが指定されていない場合は、既定では Stripped 型が表示されます。データを表示するようになる時にはさまざまなタイル アルゴリズムがあります。すべてのアルゴリズムには、ユーザーのニーズに基づいて利点があります。最適なアスペクト比を得ることを目的とするものもあります。ノードは可能な限り長方形に近くなります。その他のアルゴリズムは、要素の初期順序を保持することを目的としています。データソース内で互いに近いオブジェクトは、ツリーマップ上で互いに近くに配置されます。

  • Stripped タイプのアルゴリズムは、最適な縦横比を描画しますが、オブジェクトがサイズによってソートされます。

  • SliceAndDice レイアウトのアルゴリズムは、縦横比を代わりに最初の順番を維持するようにします。

  • Squarified レイアウトのタイル アルゴリズムでは、SliceAndDice より縦横比がより正確で、Squarified より適切にソートされます。

レイアウトの方向

layoutOrientation プロパティによってユーザーは階層のノードが展開される方向を設定できます。

LayoutOrientation プロパティがレイアウト タイプ SliceAndDice および Strip と動作することに注意してください。

  • Horizontal – 子ノードは水平に積み重ねられます (SliceAndDice)。

  • Vertical – 子ノードは垂直に積み重ねられます (SliceAndDice)。

依存関係

chart コンポーネントをインストールするときに core パッケージもインストールする必要があります。

npm install --save igniteui-react-core
npm install --save igniteui-react-charts

モジュールの要件

IgrTreemap を作成するには、以下のモジュールが必要です。

import { IgrTreemapModule } from "igniteui-react-charts";
import { IgrTreemapComponent } from 'igniteui-react-charts';

IgrTreeMapModule.register();

コード スニペット

以下のコードは、Treemap を設定する方法を示します。

<igr-treemap
    height="100%"
    width="100%"
    layoutType="stripped"
    layoutOrientation="horizontal"
    parentIdMemberPath="parent"
    idMemberPath="id"
    labelMemberPath="name"
    valueMemberPath="pop"
    transitionDuration="500"
    rootTitle="Countries" >
</igr-treemap>

塗りつぶしスケール

以下のコードは、Treemap の塗りつぶしスケールを設定する方法を示します。

import { TreemapFillScaleMode } from 'igniteui-react-charts';
// ...
this.treeMap = new IgrTreemapComponent({ name: "treeMap" })
this.treeMap.fillScaleMode = TreemapFillScaleMode.Value;
this.treeMap.fillScaleMinimumValue = 0;
this.treeMap.fillScaleMaximumValue = 1500000000; // 1.5B
this.treeMap.fillBrushes = "#4e62cf #8a58d6" as any;
this.treeMap.isFillScaleLogarithmic = false;