React Dashboard Tile (ダッシュボード タイル) の概要

    React Dashboard Tile は、データ ソース コレクション/配列または単一のデータ ポイントを分析して、表示する最も適切な視覚化を決定する自動データ視覚化コンポーネントです。また、埋め込みの IgrToolbar で提供される一連のツールを使用して、さまざまな方法で表示される視覚化を変更できます。

    提供されたデータの形状に応じて、以下を含む多種多様な視覚化が選択可能です。これには以下が含まれますが、これらに限定されません: カテゴリ チャート、`ラジアル チャートと極座標チャート、散布図、地理マップ、ラジアル ゲージとリニア ゲージ、ファイナンシャル チャート、積層型チャート。

    ツールバー内のチャート タイプ メニューを操作すると、候補リストの中から異なる視覚化を選択できます。

    React Dashboard Tile の例

    依存関係

    Ignite UI for React ツールセットに次のパッケージをインストールします:

    npm install igniteui-react-charts
npm install igniteui-react-core
npm install igniteui-react-dashboards
npm install igniteui-react-gauges
npm install igniteui-react-grids
npm install igniteui-react-inputs
npm install igniteui-react-layouts
npm install igniteui-react-maps

    Dashboard Tile コンポーネントを使用する場合、以下のモジュールを使用することをお勧めします:

    import { IgrDashboardTileModule, IgrDataChartDashboardTileModule, IgrRadialGaugeDashboardTileModule,
         IgrLinearGaugeDashboardTileModule, IgrGeographicMapDashboardTileModule,
         IgrPieChartDashboardTileModule } from "igniteui-react-dashboards";

IgrDataChartDashboardTileModule.register();
IgrRadialGaugeDashboardTileModule.register();
IgrLinearGaugeDashboardTileModule.register();
IgrGeographicMapDashboardTileModule.register();
IgrPieChartDashboardTileModule.register();
IgrDashboardTileModule.register();

    使用方法

    コントロールはバインドしたデータを評価し、Ignite UI for React ツールセットから表示する視覚エフェクトを選択するため、Dashboard Tile の DataSource プロパティを何にバインドするかによって、デフォルトで表示される視覚エフェクトが決まります。Dashboard Tile に表示されるデータ視覚化コントロールは次のとおりです。

    デフォルトで選択されるデータ視覚化は、主にスキーマとバインドした DataSource の数によって決まります。たとえば、単一の数値をバインドすると IgrRadialGauge が取得されますが、互いに区別しやすい値とラベルのペアのコレクションをバインドすると XamDataPieChart が取得されます。より多くの値パスを持つ DataSource をバインドすると、バインドされたコレクションの数に応じて、複数の列シリーズまたは線シリーズを持つ DataChart を受け取ります。また、IgrGeographicMap を取得するために、ShapeDataSource または地理的ポイントを含むデータにバインドすることもできます。

    DataSource をバインドするときに単一の視覚化にロックされることはなく、VisualizationType プロパティを設定することで、特定の視覚化を表示することをコントロールに指示できます。たとえば、特に折れ線チャートを表示したい場合は、次のように Dashboard Tile を定義できます。

    視覚化または視覚化のプロパティも、コントロールの上部にある IgrToolbar を使用して構成できます。この IgrToolbar には、現在の視覚化の既定のツールに加えて、以下で強調表示されている 4 つの Dashboard Tile 固有のツールが含まれています。

    左から右へ:

    • 最初のツールは、コントロールに提供された DataSource を含むデータ グリッドを表示します。これは切り替えツールなので、グリッドを表示した後にもう一度クリックすると、視覚化に戻ります。
    • 2 番目のツールを使用すると、現在のデータ視覚化の設定を構成できます。
    • 3 番目のツールを使用すると、現在の視覚化を変更して、異なるシリーズ タイプをプロットしたり、まったく異なるタイプの視覚化を表示したりすることができます。これは、前述の VisualizationType プロパティを設定することによってコントロール上で設定できます。
    • 最後のツールを使用すると、基になるデータ項目のどのプロパティをコントロールに含めるかを構成できます。これを構成するには、コントロールに includedProperties または excludedProperties コレクションを設定します。

    このデモでは、ダッシュボード タイルと React 円チャートの統合を示します。右上のツールバー オプションを使用すると、スタイル設定やデータ視覚化の変更にアクセスできます。

    このデモでは、ダッシュボード タイルと React 地理マップの統合を示します。右上のツールバー オプションを使用すると、スタイル設定やデータ視覚化の変更にアクセスできます。

    API リファレンス

    その他のリソース