タブ

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

設定オプション

タブウィジェットの設定項目は次のとおりです。

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

選択状態

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

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

ステッパーウィジェットは、以下の制限事項を含む同じイベントとルールを使用して、アクティブなステップを判定します。メトリックカードウィジェットもこれらのイベントを使用しますが、選択されているメトリクスを1つ選ぶのではなく、メトリクスごとに個別に確認します。

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

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

制限事項

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