メインコンテンツまでスキップ

ダッシュボードのテーマ設定

定義済みのテーマ​

Reveal SDK には、適用できる 4 つの定義済みテーマが付属しています。

テーマRevealView
Mountain Light
Mountain Dark
Ocean Light
Ocean Dark

テーマの適用​

定義済みのテーマを適用するには、RevealSdkSetting.theme プロパティに、希望するテーマのインスタンスを割り当てる必要があります。

Mountain Light​
RevealSdkSettings.theme = new MountainLightTheme();
Mountain Dark​
RevealSdkSettings.theme = new MountainDarkTheme();
Ocean Light​
RevealSdkSettings.theme = new OceanLightTheme();
Ocean Dark​
RevealSdkSettings.theme = new OceanDarkTheme();
備考

RevealSdkSetting.theme プロパティは静的プロパティであり、アプリケーション内の RevealView のすべてのインスタンスに適用されます。

カスタム テーマ​

Reveal SDK を既存のアプリケーションに埋め込む場合、ダッシュボードがアプリケーションのルックアンドフィールと一致していることが重要です。定義済みの Reveal SDK テーマのいずれかがアプリケーションのテーマと一致しない場合は、アプリケーションのルックアンドフィールにより近いカスタム テーマを作成できます。

テーマは、RevealTheme 型のクラスです。これにより、Reveal SDK UI コントロールのさまざまな要素の色とフォントを定義できます。

RevealTheme には次のプロパティがあります:

名前説明
chartColors表示形式でシリーズを示すために使用される色。色の数に制限はありません。すべての色が表示形式で使用されると、Reveal はこれらの色の新しい色合いを自動生成します。これにより、色が重複せず、各値に独自の色が設定されます。
accentColorReveal のデフォルトのアクセント色は、[+ ダッシュボード] ボタンやその他のインタラクティブなアクションで確認することができる青の色合いです。アプリケーションで使用するのと同じアクセント色に一致するように色を変更できます。
dashboardBackgroundColorダッシュボードの背景色を設定します。これはメインの背景色です。
visualizationBackgroundColor表示形式の背景色を設定します。これは二番目の背景色です。
conditionalFormatting条件付き書式を使用するときに設定できる境界のデフォルトの色を変更します。
regularFont通常のフォント スタイルを設定します。
boldFont太字のフォント スタイルを設定します。
mediumFont中くらいの太さのフォント スタイルを設定します。
italicFont斜体のフォント スタイルを設定します。
boldItalicFont太字斜体のフォント スタイルを設定します。
fontColorフォントの色を設定します。
highlightColor特定のダッシュボード シナリオ (予測および外れ値の統計関数) の強調色を設定します。
visualizationMargin表示形式間のマージン サイズをピクセル単位で設定します。
useRoundedCornersボタン、ツールチップ、コンテナ、表示形式などの隅の丸め有無を設定します。false に設定すると、コーナーは四角になります。
備考

各フォント プロパティにはフォント ファミリの名前を指定し、Reveal はそれを標準の太さとスタイルで描画します。フォント プロパティの解決方法と、すべてのスタイルに 1 つのフォント ファミリを使用する方法については、テーマのフォントを参照してください。

備考

テーマのプロパティを更新するとき、または実行時に新しいテーマを適用するときは、テーマの変更を RevealView に適用するために、RevealView.refreshTheme メソッドを呼び出す必要があります。

既存のテーマのクローン​

既存のテーマの値に基づいてテーマを作成する場合は、変更を加える前に現在の RevealTheme のクローンを作成できます。 テーマのクローンを作成するには、RevealTheme.clone() メソッドを使用するだけです。テーマのクローンを作成したら、テーマのプロパティを設定して、新しいテーマとして使用できます。

function cloneCurrentTheme() {
    const theme = RevealSdkSettings.theme.clone();

    theme.fontColor = "#0000cc";
    theme.accentColor = "#009900";
    theme.dashboardBackgroundColor = "#ffff66";
    theme.visualizationBackgroundColor = "#cccccc";

    theme.chartColors = ["rgb(192, 80, 77)", "rgb(101, 197, 235)", "rgb(232, 77, 137)"];

    return theme;
}

テーマのクローンを作成して変更し、既存のテーマを変更したら、テーマを適用できます。

RevealSdkSettings.theme = this.cloneCurrentTheme();
備考

rgb(255, 255, 255) (RGB) または #000000 (HEX) 色のいずれかを使用して、色の値を指定できます。

カスタム テーマの作成​

より保守しやすく、再利用と共有が容易なテーマが必要な場合は、カスタム テーマを作成することをお勧めします。カスタム テーマの作成は、RevealTheme の新しいクラス インスタンスを作成し、そのプロパティを変更することで実現できます。

カスタム テーマの例を次に示します:

function createCustomTheme(){
    const theme = new RevealTheme();

    theme.fontColor = "#ff0000";
    theme.accentColor = "rgb(192, 80, 77)";
    theme.dashboardBackgroundColor = "#000000";
    theme.visualizationBackgroundColor = "rgb(153, 255, 255)";

    theme.chartColors = ["rgb(192, 80, 77)", "rgb(101, 197, 235)", "rgb(232, 77, 137)"]

    theme.mediumFont = "Gabriola";
    theme.boldFont = "Wingdings";

    return theme;
};

カスタム テーマを作成したら、テーマを適用できます。

RevealSdkSettings.theme = this.createCustomTheme();
コードの取得

このサンプルのソース コードは GitHub にあります。

注記

テーマは、グリッド表示形式のすべての要素にも適用されます。ヘッダーとセルの背景、区切り線、スクロールバー、選択セルの強調表示、集計行、列オプション メニューが対象です。グリッド チャート を参照してください。