Skip to content

ツールチップの概要

App Builder のツールチップ コンポーネントを使用すると、アプリケーション内のターゲット要素にユーザーがカーソルを合わせるかフォーカスを当てたときに、コンテキスト ヘルプや補足情報を表示できます。ツールチップはプロパティ パネルを通じてビジュアルに設定でき、トリガーとコンテンツはすべてコードを記述せずにカスタマイズできます。

ツールチップは基盤となる Ignite UI ツールチップ コンポーネントを使用し、Angular、React、Blazor、Web Components 向けのクリーンなフレームワーク固有のコードを生成します。

主な機能

コンポーネントへのツールチップの追加

ツールチップは、ターゲット コンポーネントのプロパティ パネルから直接有効化します。ツールチップを追加するには:

  1. デザイン キャンバスでターゲット コンポーネントを選択します。
  2. プロパティ パネルで「ツールチップ」セクションまでスクロールします。
  3. ツールチップを有効にする トグルをオンにします。
  4. 表示される ツールチップを編集 リンクをクリックしてツールチップを開き、プロパティ (ターゲット、モード、表示遅延、非表示遅延、矢印) を設定します。

また、コンポーネント ツールボックスからツールチップをドラッグするか、クイック追加ショートカット Ctrl+E (Mac の場合は ⌘+E) で「ツールチップ」を検索して追加することもできます。

ツールチップ コンテンツ

ツールチップのコンテンツを変数や接続されたデータ ソースのデータ フィールドにバインドすることで、実行時に動的でコンテキストに応じたヒントを提供できます。

表示 / 非表示の遅延

以下を設定してツールチップの応答性を制御します:

  • 表示遅延 — ユーザーがターゲットにカーソルを合わせてからツールチップが表示されるまでの時間 (ミリ秒)。デフォルト値は 300 ms。
  • 非表示遅延 — カーソルがターゲットから離れてからツールチップが消えるまでの時間 (ミリ秒)。デフォルト値は 0 ms。

これらの遅延はユーザービリティを向上させ、ユーザーが複数の要素間でカーソルを素早く移動する際のツールチップのチラツきを防ぎます。

モード

モード プロパティはツールチップの閉じ方を制御します:

  • デフォルト — ツールチップはホバー/フォーカス時に表示され、カーソルまたはフォーカスがターゲットから離れると自動的に消えます。
  • スティッキー — ツールチップはユーザーが明示的に閉じるまで表示されたままになります。

矢印

矢印 インジケーターの表示/非表示を切り替えます。有効の場合、小さな矢印がツールチップからターゲット要素を指し示し、ツールチップとターゲット間の関連を視覚的に明確にします。

ツールチップ トリガー

デフォルトでは、ツールチップはホバー (マウス) とフォーカス (キーボード) でトリガーされます。この二重動作により、WCAG ガイドラインへのアクセシビリティ準拠が確保されます。

サポートされているプロパティ

プロパティ説明
ターゲットツールチップが関連付けられているコンポーネント
モードツールチップの閉じ方: デフォルト (自動) または スティッキー (手動)
表示遅延ツールチップが表示されるまでの遅延 (ミリ秒)。デフォルト値: 300
非表示遅延ツールチップが非表示になるまでの遅延 (ミリ秒)。デフォルト値: 0
矢印方向指示矢印インジケーターの表示/非表示を切り替える

アクセシビリティ

ツールチップ コンポーネントはアクセシビリティを考慮して構築されています:

  • ターゲット要素は、ツールチップ コンテンツにリンクする aria-describedby を受け取ります。
  • ツールチップはフォーカス イベントを介してキーボード アクセスが可能です。
  • 適切な ARIA ロールによるスクリーン リーダー サポートが含まれています。

コードの生成

App Builder はビジュアル設定に基づいてフレームワーク固有のツールチップ コードを生成します:

  • Angular: Ignite UI for Angular の igxTooltip および igxTooltipTarget ディレクティブを使用します。
  • React: Ignite UI for React の IgrTooltip コンポーネントを使用します。
  • Blazor: Ignite UI for Blazor の IgbTooltip を使用します。
  • Web Components: Ignite UI for Web Components の igc-tooltip を使用します。
Note

変数またはデータ フィールドにバインドされたツールチップのコンテンツは、各フレームワーク固有の動的バインディングとして生成されたコードに反映されます。

既知の問題と制限事項

  • ネストされたツールチップは使用できません。
  • 生成コードにおけるループ内のツールチップのサポート:
    • Angular ✔️
    • React、Blazor、Web Components 🚧 — ツールチップがループで生成されたターゲットに正しく関連付けられません。
  • ループで生成される Select アイテムのツールチップ: ループで生成される Select アイテムに関連付けられたツールチップは、Select アイテムをラップする ng-container に ngProjectAs 属性を追加しない限り、Angular では機能しません。以下に例を示します:
<igx-select type="border" class="user-input">
  @for (item of northwindCategories; track item) {
    <ng-container ngProjectAs="igx-select-item">
      <igx-select-item value="Option" #selectItem [igxTooltipTarget]="tooltip4" [showDelay]="300" [hideDelay]="0">
        {{ item.name }}
      </igx-select-item>
      <div #tooltip4="tooltip" igxTooltip>
        <div class="column-layout group_1">
          <p class="ig-typography__body-2 text">
            {{ item.description }}
          </p>
        </div>
      </div>
    </ng-container>
  }
  <label igxLabel>Label/Placeholder</label>
</igx-select>

その他のリソース