タブコントロール
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
TabControlは1つ以上のタブを表示します。
TabControlのタブは、Tabテンプレート(「タブ設定項目」)に基づいて設定項目で定義します。これらのタブにコンテンツを追加するには、タブ設定項目にコンポーネントを追加します。慣例として、タブ設定項目はPageSettingsのフォルダ内に作成します。
タブをTabControlに追加する方法は3つあります:
- タブ設定項目をフォルダに入れ、 TabControl のDataSourceプロパティをそのフォルダに割り当てます。 TabControl はタブをフォルダ内の出現順に表示します。 TabControl は常にこのフォルダ内のすべてのタブ項目を表示します。
- タブ設定項目IDを TabControlのTabs プロパティにパイプ('|')分離リストに追加します。 TabControl はリストした順番でタブを表示します。
- コードから動的にタブを追加します。タブ項目のリストを作成し、そのリストをTabControlのtabsメンバーに追加します。TabControlはリスト内の順序でタブを表示します。
TabControlは常にタブ設定項目のDisplayNamesをタブラベルとして使用します。
タブ設定項目
タブ設定項目には任意のコンポーネントを含めることができます。タブに追加するコンポーネントのプレースホルダーを指定する必要はありません。プレースホルダーなしでタブ設定項目で定義されたコンポーネントは、タブのコンテンツエリアに表示されます。もしプレースホルダーをタブに導入するコンポーネントを追加した場合、通常通りこれらのプレースホルダーにコンポーネントを割り当てることができます。
タブ設定項目にはIsHiddenというフィールドがあります。このフィールドは設計時に設定できます。 TabControlのViewモデルが提供する2つのメンバー、hideTabとshowTabで実行時にフィールドを変更できます。これらの方法を使って、タブの可視性を動的に変更できます。
これらの手法は、ボタンコントロールのClickプロパティの例と同じように使います:
javascript
.TabStrip4.viewModel.showTab('{C29A2AFE-1762-49AB-89CB-BEAF077C152C}')" })メソッドはタブの引数として表示または隠れるSitecore IDを期待しています。
ツールチップは、タブ設定項目のツールチップ欄で個別のタブに追加できます。
ネストされたタブ
タブ構成アイテムレイアウトにTabControlを追加すれば、タブ内に複数のタブを追加できます。タブは入れ子状です。
!注タブ項目を含むフォルダのネストされたタブ項目サブフォルダは追加すべきではありません(SPEAKはフォルダを再帰読み取りするため、タブ項目が混同されます)。
TabTypeプロパティはタブボタンのスタイルを定義します。有効なオプションには以下があります:
-
ノーマル
個々のタブは背景色の長方形ボタンとして表示されます。
-
プログレッシブ
個々のタブは背景色の「矢印」ボタンとして表示されます。これを使って、ユーザーにシーケンス内のステップの視覚的な手がかりを与えることができます。
TabControl自体はステップの順序に関するロジックを提供していません。PageCodeでこのロジックを実装するには、SelectTabプロパティ/メンバーとSelectedTabIndexメンバーを使用できます。
-
サブタブ
各タブは異なる外観を持つため、囲まれたTabControlと親タブを区別しやすくなります。ネストされたTabControlのTabTypeプロパティをSubTabに設定すると、最良の視覚体験が得られます。
性質
名称
概要
デフォルト
外見
タブタイプ
Normal、Progressive、またはSubTabに設定されています。
ノーマル
データ
SelectedTab
選択したタブのItem IDです。このプロパティを読み書きできます。
このプロパティが設定されていない場合、TabControlは最初に最初のタブ(フォルダ内またはリストの最初のタブ)を選択します。
タブ
タブのアイテムIDのリストです。
構成
TabControlのパラメータテンプレートに基づいてアイテムを作成することで、TabControlの設定項目を作成できます。
設定項目には以下の特定のフィールドがあります:
- タブ
- SelectedTab
- タブタイプ
以下の場を継承します:
- IsVisible(見えるもの)
- アクセスキー
- ツールチップ
- 行動
- ID