タブ

タブウィジェットには、モジュール内のページやオーバーレイ間を移動するための Workshop イベントをトリガーする、設定可能なタブが表示されます。

設定オプション

タブウィジェットの設定の概要を以下に示します。

タブ
- 項目を追加： 新規タブを追加します。作成後、タブを含むボックスを選択して設定します。
  - ラベル： タブのラベルを設定します。
  - クリック時
    - イベントを追加： タブを選択したときにトリガーされる Workshop イベントを追加します。
  - アイコン： タブのラベルの左側に表示するアイコンを追加します。
  - バッジ： タブのラベルの右側にバッジを表示します。デフォルトでは、タブにバッジは表示されません。ビルダーがタブにバッジを表示する場合は、文字列変数でテキストを表示するか、数値変数で数値を表示するかを選択できます。
  - 条件付き表示設定： オンにすると、設定したブール変数の値に応じて、タブの有効/無効または表示/非表示を制御できます。
    - ブール変数： タブを有効、無効、または非表示にする条件を制御するブール変数を設定します。
    - 無効： 選択すると、設定したブール変数の値が true のときにタブが有効になり、false のときに無効になります。
    - 非表示： 選択すると、設定したブール変数の値が true のときにタブが表示され、false のときに非表示になります。
表示と書式設定
- デザイン： ウィジェット内の設定済みのすべてのタブに適用するスタイルのプリセットを選択します。アウトライン、ブロック、強調、またはグループ化から選択します。
- アウトライン
  - サイズ： タブの表示値のサイズをデフォルトまたは大に設定します。
- ブロック
  - 控え目なスタイル： オンにすると、タブに控え目なブロックスタイルが適用されます。この設定では、アクティブなタブに使用されるアクティブ時の色（以下を参照）が薄くなります。
  - サイズ： タブの表示値のサイズを設定します。サイズの選択肢はデフォルトまたは大です。
- 強調
  - 幅：ウィジェットの幅を設定します。
  - サイズ： タブの表示値のサイズをデフォルトまたは大に設定します。
- グループ化
  - サイズ： タブの表示値のサイズを小、デフォルト、または大に設定します。
アクティブ時の色： * アクティブなタブの色を設定します。
タブの高さ： タブウィジェットのセクションヘッダーの高さを、事前定義された値に設定します。
- カスタム： カスタムのピクセル値を入力して、ウィジェット内のタブの高さを設定します。
- 自動： タブの高さをコンテナの高さに合わせて自動設定することを選択します。
  - いっぱいに広げる： オンにすると、ウィジェット内のタブの高さがウィジェットの高さに設定されます。
方向
- 横方向： ウィジェット内のタブを横方向に表示します。
- 縦方向： ウィジェット内のタブを縦方向に表示します。
  - 配置
    - 左寄せ： ウィジェット内のすべてのタブを左寄せにします。
    - 中央寄せ： ウィジェット内のすべてのタブを中央寄せにします。

選択状態

タブウィジェットは、独自の選択状態を保持しません。代わりに、ウィジェットに設定されたイベントから選択状態が決まります。レイアウト状態が変わらないタブに切り替えイベントとページに切り替えイベントが、選択中のタブを決めるために使用されます。デフォルトで選択するタブまたはページは、タブ付きセクションの変数ベースのタブ選択項目、または設定パネルの変数ベースのページ選択項目で、文字列変数をタブ名またはページ名に設定することで指定できます。

モジュールにタブウィジェットを追加しても、タブに切り替えイベントやページに切り替えイベントは生成されません。タブウィジェットで使用するこれらのイベントを生成する方法については、タブに切り替えおよびページに切り替えを参照してください。

レイアウト状態が変わらないイベント

レイアウト状態を変更しないイベント、つまり「レイアウト状態が変わらない」イベントとは、現在のレイアウト状態と一致する、選択中のタブまたはページに切り替えるように設定されたレイアウトイベントです。たとえば、タブ A に切り替えイベントが設定されたタブは、現在のレイアウト状態で Tab A が選択されている場合、選択中として表示されます。

制限事項

複数のレイアウトイベントが設定されている場合は、「レイアウト状態が変わらない」イベントが最も多いタブが選択中のタブになります。同数の場合は、先にあるタブが優先されます。
変数の値を設定イベントは、現在、タブの選択状態の確認には使用されません。
- 選択中のタブが変数に基づく場合は、タブに切り替えイベントを使用できます。このイベントは、タブの選択状態を設定するだけでなく、選択中のタブを表す変数の状態も更新します。
- 選択中のページが変数に基づく場合は、ページに切り替えイベントに加えて、変数の値を設定イベントを使用する必要があります。ページ変更イベントでは、選択中のページを表す変数の値は自動更新されないためです。