Tabs (タブ)
Ignite UI for Blazor Tabs コンポーネントは、同じ階層レベルの関連するコンテンツをタブに整理し、選択したタブのコンテンツを表示します。
各タブは、ヘッダーとコンテンツを 1 つの要素に保持します。Tabs コンポーネントはキーボード ナビゲーションをサポートし、タブ ヘッダーが収まらない場合にスクロール ボタンを表示します。
ライブ デモ
構造
Blazor Tabs コンポーネントは、タブ項目を含むコンテナー、任意のスクロール ボタン、および選択したタブのコンテンツ領域で構成されます。
2. ヘッダー ボタン (任意): タブ コンテナーに表示されていないタブに移動するための矢印が表示されます
3. ラベル: タブの名前を示し、どのコンテンツが開くかを示すテキストです
4. アクティブなタブ項目: アクティブな、選択可能な単一のタブ要素です
5. 左アイコン (任意): タブにコンテキストを加えるため、ラベルの前に表示されるアイコンです
6. 上アイコン (任意): タブにコンテキストを加えるため、ラベルの上に表示されるアイコンです
7. 右アイコン (任意): タブにコンテキストを加えるため、ラベルの後に表示されるアイコンです
8. コンテンツ領域: 選択したタブのコンテンツが表示されるパネルです
igc-tabs 要素は、ヘッダー ストリップとスクロール ボタンをレンダリングします。各 igc-tab は自身のヘッダーとコンテンツをレンダリングし、Tabs コンポーネントはすべてのタブのコンテンツをヘッダー ストリップの下に配置します:
igc-tabs[role="tablist"]
└─ #shadow-root
└─ div[part="tabs"] // the scrollable header strip
└─ div[part="inner"]
├─ igc-icon-button[part="start-scroll-button"] // rendered when the headers overflow
├─ slot // the igc-tab elements
│ └─ igc-tab
│ └─ #shadow-root
│ ├─ div[part="tab-header"][role="tab"]
│ │ └─ div[part="base"]
│ │ ├─ slot[name="prefix"][part="prefix"]
│ │ ├─ div[part="content"]
│ │ │ └─ slot[name="label"] // falls back to the label property
│ │ └─ slot[name="suffix"][part="suffix"]
│ └─ div[part="tab-body"][role="tabpanel"] // visible only for the selected tab
│ └─ slot // the content of the tab
├─ igc-icon-button[part="end-scroll-button"] // rendered when the headers overflow
└─ div[part="selected-indicator"]
└─ span // follows the selected tab header
はじめに
Blazor Tabs を使用するには、基本的なプロジェクト セットアップについて Ignite UI for Blazor はじめに トピックに従い、その後、対象プラットフォーム用のコンポーネントを追加します。
Ignite UI for Blazor サービスを登録します:
// in Program.cs file
builder.Services.AddIgniteUIBlazor();
IgbTabs のクライアント リソース モジュールである IgbTabsModule の登録は任意です。コンポーネントは最初にレンダリングされるときにリソースを読み込みます。builder.Services.AddIgniteUIBlazor(typeof(IgbTabsModule)) のように指定すると、リソースをプリロードしたり、クライアント上でのみ作成される要素をサポートしたりできます (コンポーネント モジュールを参照)。
次に、アプリのホスト ページでテーマ CSS ファイルをリンクします (スタンドアロンの Blazor WebAssembly アプリまたは Blazor Hybrid アプリでは wwwroot/index.html、Blazor Server アプリでは Pages/_Host.cshtml、Blazor Web アプリでは Components/App.razor):
<link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />
登録後、セクションごとに IgbTab を含む IgbTabs をレンダリングします。タブのラベルがそのヘッダーになり、タブの子要素がそのコンテンツになります:
<IgbTabs>
<IgbTab Label="Overview">
<p>The overview content.</p>
</IgbTab>
<IgbTab Label="Details">
<p>The details content.</p>
</IgbTab>
</IgbTabs>
最初のレンダリングでタブが選択されていない場合、Blazor Tabs コンポーネントは最初の有効なタブを選択します。その後、選択されているタブの selected を false に設定すると、どのタブも選択されません。
使用方法
Blazor Tabs を使用して、同じ情報の異なるビューを整理したり、類似または関連するデータ セットを切り替えたりします。
タイプ
Tabs には 2 つのタイプがあります。Short は既定ではテキストのみを表示し、プレフィックス アイコンとサフィックス アイコンを追加することもできます。Tall は、テキストの上にさらに 3 つ目のアイコンを表示します。
Short タブにするには、タブの label を設定します。Tall タブにするには、代わりに Icon と <span> を label スロットに配置すると、Tabs コンポーネントはテキストの上にアイコンを表示します。label スロットは label プロパティより優先されます。Icon トピックで説明されているように、最初にアイコンを登録します:
<IgbTabs>
<IgbTab Label="Cart" />
<IgbTab Label="Shipping" />
</IgbTabs>
<IgbTabs>
<IgbTab>
<IgbIcon slot="label" IconName="shopping_basket" Collection="material" />
<span slot="label">Cart</span>
</IgbTab>
<IgbTab>
<IgbIcon slot="label" IconName="delivery" Collection="material" />
<span slot="label">Shipping</span>
</IgbTab>
</IgbTabs>
アイコンやバッジなど、ラベルの前後にコンテンツを表示するには、タブの prefix スロットと suffix スロットに配置します:
<IgbTab>
<IgbIcon slot="prefix" IconName="inbox" Collection="material" />
<span slot="label">Inbox</span>
<IgbBadge slot="suffix">12</IgbBadge>
</IgbTab>
レスポンシブ対応
Tabs は、幅を調整して使用可能な水平方向のスペースを埋める Content Fit にすることも、多数のタブ項目間を移動するためのスクロール ボタンを備えた Fixed にすることもできます。これにより、もう一方のモードと同じ合計スペースで、通常より多くのコンテンツを収めることができます。
alignment プロパティは、Blazor Tabs コンポーネントがタブ ヘッダーを配置する方法を設定します:
start(既定): 各タブ ヘッダーはコンテンツと同じ幅になり、ヘッダーは Tabs の開始端から並びます。center: 各タブ ヘッダーはコンテンツと同じ幅になり、ヘッダーは中央に配置されます。end: 各タブ ヘッダーはコンテンツと同じ幅になり、ヘッダーは Tabs の終了端に揃います。justify: タブ ヘッダーは Tabs の幅を埋めるように伸びます。Content Fit モードで使用します。
<IgbTabs Alignment="TabsAlignment.Justify">
<IgbTab Label="Podcasts" />
<IgbTab Label="Playlists" />
<IgbTab Label="Genres" />
</IgbTabs>
タブ ヘッダーが収まらない場合、Blazor Tabs コンポーネントはヘッダー ストリップの両端にスクロール ボタンを表示します。これが Fixed モードです。スクロール ボタンは、その方向で表示範囲外にある次のタブ ヘッダーまでストリップをスクロールし、ストリップがその端までスクロールされると無効になります。ユーザーがタブを選択すると、Tabs コンポーネントはそのヘッダーが表示されるようにスクロールします。
タブの数
ほとんどのシナリオでは、Tabs には 2 から 5 個の項目を含める必要があります。ユースケースで 6 個以上のタブが必要な場合は、上記の Fixed モードを検討してください。
実行時にタブを追加および削除できます。selected を設定して追加したタブは選択されたタブになり、選択されているタブを削除すると、Blazor Tabs コンポーネントは最初の有効なタブを選択します。
状態
タブ項目は、Active、Inactive、Active & Hover、Inactive & Hover、および Disabled の状態をサポートします。Tabs では、常に 1 つの Active タブと、任意の数の Inactive タブおよび Disabled タブがあります。
タブの selected を設定するとそのタブがアクティブなタブになり、disabled を設定するとオフになります。ユーザーは無効なタブを選択できず、キーボード ナビゲーションでもスキップされます。 選択されているタブを無効にすると、Blazor Tabs コンポーネントは最初の有効なタブを選択します。
<IgbTabs>
<IgbTab Label="Overview" />
<IgbTab Label="Activity" Selected="true" />
<IgbTab Label="Billing" Disabled="true" />
</IgbTabs>
選択
Blazor Tabs コンポーネントは、ユーザーがクリックまたはキーでタブを選択すると、新しく選択されたタブとともに Change を発生させます。コードでタブを選択するには、タブの id または Label を指定して SelectAsync を呼び出します:
<IgbTabs @ref="Tabs" Change="OnTabChange">
<IgbTab Label="Overview" />
<IgbTab Label="Details" />
</IgbTabs>
<button @onclick="ShowDetails">Show details</button>
@code {
private IgbTabs Tabs { get; set; }
private async Task ShowDetails()
{
await Tabs.SelectAsync("Details");
}
private void OnTabChange(IgbTabComponentEventArgs e)
{
Console.WriteLine(e.Detail.Label);
}
}
コードでタブを選択するか、タブの selected を設定すると、change イベントなしで選択が変更されます。Tabs コンポーネントは、無効なタブとどのタブにも一致しない値を無視します。
アクティブ化
既定では、Blazor Tabs コンポーネントは、矢印キー、Home、または End でフォーカスがタブのヘッダーに移動するとすぐに、そのタブを選択します。これらのキーでフォーカスのみを移動し、フォーカスされたタブを Enter または Space で選択するには、activation を manual に設定します。タブのコンテンツの表示に時間がかかる場合 (たとえばデータを読み込む場合) は、手動アクティブ化を使用します。
<IgbTabs Activation="TabsActivation.Manual">
<IgbTab Label="Overview" />
<IgbTab Label="Reports" />
</IgbTabs>
推奨事項と非推奨事項
Tabs は情報を整理するのに適しており、チェックアウト プロセスや構成ウィザードのような、論理的な順序で進むワークフローやアクションの設計には使用しないでください。Short タブを使用する場合、同じバーでテキスト タブとアイコン タブを組み合わせないでください。2 つのコンテンツ モードのいずれかを選択し、バー内のすべての項目で一貫して使用します。
タブを使用して関連情報を整理します。
チェックアウト プロセスなど、順次ワークフローのステップにタブを使用しないでください。
バー内のすべてのタブで、テキストまたはアイコンのいずれか同じコンテンツ モードを使用します。
同じバーでテキスト タブとアイコン タブを組み合わせないでください。
プロパティ
Blazor Tabs コンポーネントは、次のプロパティを公開します。完全な型定義については、API リファレンスを参照してください。
| 名前 | 型 | 既定値 | 説明 |
|---|---|---|---|
Alignment |
TabsAlignment |
Start |
タブ ヘッダーをヘッダー ストリップ内に配置する方法。 |
Activation |
TabsActivation |
Auto |
キーボードでタブ ヘッダーにフォーカスを移動したときに、そのタブも選択するかどうか。 |
IgbTab.Label |
string |
— | タブ ヘッダーのテキスト。label スロットが優先されます。 |
IgbTab.Selected |
bool |
false |
タブが選択されているかどうか。 |
IgbTab.Disabled |
bool |
false |
タブが無効かどうか。 |
メソッド
Blazor Tabs コンポーネントは、次のメソッドを公開します。各メソッドには、Async サフィックスのない同期バージョンもあります。
| メソッド | 説明 |
|---|---|
SelectAsync |
渡した文字列に一致する id または Label を持つタブを、Change を発生させずに選択します。無効なタブとどのタブにも一致しない文字列は無視されます。 |
GetSelectedAsync |
選択されているタブの Label を返します。タブに Label がない場合は id を返します。 |
イベント
Blazor Tabs コンポーネントは、次のイベントを発行します。
| 名前 | 型 | 説明 |
|---|---|---|
Change |
EventCallback<IgbTabComponentEventArgs> |
ユーザーがクリックまたはキーでタブを選択したときに発行されます。イベントの detail には、選択されたタブが含まれます。 |
スタイル設定
Blazor Tabs コンポーネントは、テーマから色を取得します。次の CSS 変数で色を変更します:
| 変数 | 変更内容 |
|---|---|
--ig-tabs-item-background |
タブ ヘッダーの背景。 |
--ig-tabs-item-text-color |
タブ ヘッダーのテキストの色。 |
--ig-tabs-item-icon-color |
タブ ヘッダーのアイコンの色。 |
--ig-tabs-item-hover-background |
ホバーまたはフォーカスされたタブ ヘッダーの背景。 |
--ig-tabs-item-hover-color |
ホバーまたはフォーカスされたタブ ヘッダーのテキストの色。 |
--ig-tabs-item-active-background |
選択されたタブ ヘッダーの背景。 |
--ig-tabs-item-active-color |
選択されたタブ ヘッダーのテキストの色。 |
--ig-tabs-item-active-icon-color |
選択されたタブ ヘッダーのアイコンの色。 |
--ig-tabs-item-disabled-color |
無効なタブ ヘッダーのテキストの色。 |
--ig-tabs-item-disabled-icon-color |
無効なタブ ヘッダーのアイコンの色。 |
--ig-tabs-indicator-color |
選択されたタブ ヘッダーのインジケーターの色。 |
--ig-tabs-button-background |
スクロール ボタンの背景。 |
--ig-tabs-button-color |
スクロール ボタンのアイコンの色。 |
--ig-tabs-button-hover-background |
ホバーされたスクロール ボタンの背景。 |
--ig-tabs-button-disabled-color |
無効なスクロール ボタンのアイコンの色。 |
igc-tabs 要素は、次の CSS パーツを公開します:
| パーツ | スタイル設定の対象 |
|---|---|
start-scroll-button |
開始スクロール ボタン。 |
end-scroll-button |
終了スクロール ボタン。 |
selected-indicator |
選択されたタブ ヘッダーのインジケーター。 |
igc-tab 要素は、次の CSS パーツを公開します:
| パーツ | スタイル設定の対象 |
|---|---|
tab-header |
タブのヘッダー。 |
prefix |
prefix スロットのコンテナー。 |
content |
label スロットのコンテナー。 |
suffix |
suffix スロットのコンテナー。 |
tab-body |
タブのコンテンツ。選択されているタブでのみ表示されます。 |
Sass テーマ
プライマリ プロパティを変更すると、関連するすべての依存プロパティが自動的に更新され、変更が反映されます。tabs-theme 関数のプライマリ パラメーターは、テーマがすべてのタブ状態の色を導出する $item-background と、インジケーターの色を導出する $item-active-color です。この関数でテーマを作成し、tokens() ミックスインでインクルードします。これにより、インクルードしたスコープに、対応する --ig-tabs-* 変数が出力されます。
Sass 関数は igniteui-theming パッケージに含まれています。Sass のセットアップについては、テーマトピックを参照してください。
@use "igniteui-theming" as *;
$custom-tabs-theme: tabs-theme(
$item-background: #292826,
$item-active-color: #f4d45c
);
:root {
@include tokens($custom-tabs-theme);
}
CSS 変数
Sass のビルド手順なしでローカルにスタイルを設定する必要がある場合は、Tabs コンポーネントまたはコンテナーに CSS 変数を設定します:
.profile-tabs {
--ig-tabs-item-active-color: #e41c77;
--ig-tabs-indicator-color: #e41c77;
}
その他のスタイルには CSS パーツを使用します:
igc-tab::part(tab-header) {
font-weight: 600;
}
igc-tabs::part(selected-indicator) {
opacity: 0.8;
}
Tailwind によるスタイル設定
カスタム Tailwind ユーティリティ クラスを使用して、Blazor Tabs のスタイルを設定できます。最初に Tailwind をセットアップ してください。
Tailwind の任意のプロパティで --ig-tabs-* CSS 変数を設定します:
<IgbTabs Class="[--ig-tabs-item-background:#011627] [--ig-tabs-item-active-color:#FF8040] [--ig-tabs-indicator-color:#FF8040]">
...
</IgbTabs>
アクセシビリティ
Blazor Tabs コンポーネントは、WAI-ARIA タブ パターンのロールを使用します。ユーザーは Tab キーでタブ ヘッダーに移動し、矢印キーでヘッダー間を移動し、タブを選択してそのコンテンツを表示します。
キーボード操作
Blazor Tabs コンポーネントのヘッダー ストリップは単一のタブ ストップです。タブ順序に含まれるのは、選択されているタブ ヘッダーのみ、またはタブが選択されていない場合は最初の有効なタブ ヘッダーです。選択されているタブのコンテンツが次のタブ ストップです。タブ ヘッダーにフォーカスがある間は、次のキーが機能します:
| キー | 動作 |
|---|---|
| Tab / Shift + Tab | フォーカスをヘッダー ストリップの外へ、選択されているタブのコンテンツまたは前のフォーカス可能な要素に移動します。Tabs コンポーネントはこれらのキーを処理しません。 |
| Arrow Right | フォーカスを次の有効なタブ ヘッダーに移動し、最後のヘッダーからは最初のヘッダーに移動します。右から左へのレイアウトでは、前のヘッダーに移動します。auto アクティブ化では、そのタブも選択します。 |
| Arrow Left | フォーカスを前の有効なタブ ヘッダーに移動し、最初のヘッダーからは最後のヘッダーに移動します。右から左へのレイアウトでは、次のヘッダーに移動します。auto アクティブ化では、そのタブも選択します。 |
| Home | フォーカスを最初の有効なタブ ヘッダーに移動します。auto アクティブ化では、そのタブも選択します。 |
| End | フォーカスを最後の有効なタブ ヘッダーに移動します。auto アクティブ化では、そのタブも選択します。 |
| Enter / Space | フォーカスされたタブを選択します。 |
Blazor Tabs コンポーネントは、keydown でこれらのキーを次のように処理します:
- 既定の動作を抑止するため、フォーカスを移動する矢印キー、Home、End、Space でページはスクロールしません。
- 押し続けたキーは、動作を繰り返しません。
- Shift、Ctrl、Alt、Meta キーと同時に押したキーは、何も行いません。
- Tabs コンポーネントは、フォーカスを受け取ったヘッダーが表示されるようにスクロールします。
ポインターでは、タブ ヘッダーをクリックすると、そのタブにフォーカスが移動して選択されます。無効なタブはクリックを無視します。スクロール ボタンはタブ順序に含まれません。
スクリーン リーダー / ARIA
Blazor Tabs コンポーネントは、次のロールと属性をレンダリングします:
| 要素 | ロール | 属性 |
|---|---|---|
igc-tabs |
tablist |
aria-orientation="horizontal"。要素の内部機能を通じて設定されます |
各タブの tab-header パーツ |
tab |
aria-selected、aria-disabled、タブのコンテンツを指す aria-controls、aria-posinset、aria-setsize |
各タブの tab-body パーツ |
tabpanel |
タブのヘッダーを指す aria-labelledby |
Blazor Tabs コンポーネントは、支援技術に対して次のように動作します:
- タブは、ヘッダーのコンテンツ (
labelプロパティまたはlabelスロット、およびprefixスロットとsuffixスロットのコンテンツ) からアクセシブル名を取得します。 - 選択されていないタブのコンテンツは非表示かつ
inertになるため、支援技術とキーボードはそれをスキップします。 - 各タブ ヘッダーの
aria-posinset属性とaria-setsize属性により、スクリーン リーダーにセット内のタブの位置 (「3 個中 2 番目」など) が伝えられます。 - Tabs コンポーネントはライブ リージョンを使用しません。選択の変更は、
aria-selected状態とフォーカスを通じて支援技術に伝わります。
アクセシビリティ準拠
Infragistics は、Section 508 と WCAG 2.1 ガイドラインの各領域に対する Ignite UI for Blazor のアクセシビリティ サポートを、アクセシビリティ準拠トピックで説明しています。
| 基準 | コンポーネントの準拠方法 |
|---|---|
| 1.3.1 情報及び関係性 | tablist、tab、tabpanel ロールが構造を公開し、各タブ パネルは aria-labelledby によってタブ ヘッダーでラベル付けされます。 |
| 1.4.1 色の使用 | Material、Fluent、Indigo テーマでは、選択されたタブ ヘッダーの下にインジケーター ラインが表示されるため、選択状態が色だけに依存しません。 |
| 2.1.1 キーボード | 矢印キー、Home、End でタブ ヘッダー間を移動し、Enter と Space でフォーカスされたタブを選択します。 |
| 2.1.2 キーボード トラップなし | Tabs コンポーネントは Tab キーを処理しないため、Tab と Shift + Tab でフォーカスをヘッダー ストリップの外へ移動できます。 |
| 2.4.3 フォーカス順序 | ヘッダー ストリップは単一のタブ ストップで、その次が選択されているタブのコンテンツです。 |
| 2.4.7 フォーカスの可視化 | フォーカスされたタブ ヘッダーにはテーマのホバー色が適用されるため、他のタブ ヘッダーと区別できます。 |
| 4.1.2 名前 (name)・役割 (role)・値 (value) | 各タブ ヘッダーは、tab ロール、コンテンツからの名前、および aria-selected と aria-disabled による選択状態と無効状態を公開します。 |
ユーザーの責任:
- すべてのタブに、そのコンテンツを示すテキスト ラベルを指定します。タブはヘッダーのコンテンツからアクセシブル名を取得するため、アイコンのみのヘッダーにはテキストの代替が必要です。タイプを参照してください。
- テーマの色をオーバーライドする場合は、1.4.11 非テキストのコントラストで求められているように、選択インジケーターと背景の間で 3:1 以上のコントラスト比を維持し、フォーカスされたタブ ヘッダーが他のヘッダーと区別できるようにします。
- 順次プロセスのステップに Tabs を使用しないでください。ステップの順序を伝える Stepper を使用します。
API リファレンス
Blazor Tabs の API リファレンスには、対象プラットフォームの API サーフェス全体が一覧表示されます。
依存関係
Blazor Tabs コンポーネントが色とサイズを適用するには、テーマが必要です。フレームワーク固有のセットアップについては、はじめにを参照してください。
IgbIconModule など、タブ内に配置するコンポーネントのモジュールは別途登録してください。
その他のリソース
次のリソースでは、Blazor Tabs のその他のガイダンスとプロジェクトのサポートを提供しています:
関連コンポーネント
Blazor Tabs コンポーネントは、一度に関連するコンテンツの 1 つのセクションを表示します。コンテンツに異なる構造が必要な場合は、次のコンポーネントを使用します:
- Stepper - チェックアウト プロセスなど、ユーザーが一連のステップを完了する場合は、Stepper (ステッパー) を使用します。
- Accordion - ユーザーが縦方向のリストの複数のセクションを同時に展開する必要がある場合は、Accordion (アコーディオン) を使用します。
FAQ
これらの質問では、Blazor Tabs の一般的なセットアップ、アクセシビリティ、使用シナリオを取り上げます。
Blazor Tabs の SelectAsync メソッドを、タブの id または Label を指定して呼び出すか、タブの Selected を設定します。Blazor Tabs コンポーネントは、コードで行った選択に対して Change を発生させません。
Blazor Tabs コンポーネントの change イベントは、選択が変更された後に発行されるため、キャンセルできません。ユーザーが開いてはならないタブには disabled を設定し、使用可能になったときに有効にします。
はい。Blazor Tabs コンポーネントはすべてのタブのコンテンツを DOM に保持し、選択されていないタブのコンテンツを非表示にして inert にするため、そのタブが選択されるまで、ユーザーと支援技術はそれにアクセスできません。
いいえ。Blazor Tabs コンポーネントは、ユーザーが任意の順序で開くことができる関連情報を整理するものであり、ステップの順序を伝えません。チェックアウトや構成ウィザードなどの順次プロセスには、Blazor Stepper を使用します。