Toggle
Toggle はユーザーがオプションのオンとオフを切り替えることができるチェックボックスです。
プロパティー
| プロパティー | 機能 |
|---|---|
| Interactable | コンポーネントが入力を受け付けるかどうか。詳しくは Selectable 基底クラス を参照してください。 |
| Transition | ユーザーのアクションに対して視覚的な反応の仕方を決定するプロパティーです。詳しくは遷移オプション を参照してください。 |
| Navigation | 制御の一連の流れを決定するプロパティーです。詳しくは ナビゲーション操作 を参照してください。 |
| Is On | トグルのスイッチが初めからオンになっているかどうか |
| Toggle Transition | 値が変更されたときのトグルの視覚的な反応の仕方です。オプションは None (例:単純に表示と非表示)と Fade (例:フェードインもしくはフェードアウト)があります。 |
| Graphic | チェックマークで使用する画像 |
| Group | Toggle Group はトグルが属するグループです |
イベント
| プロパティー | 機能 |
|---|---|
| On Value Changed |
UnityEvent はトグルがクリックされたときに呼び出されるイベントです。イベントは bool 型のダイナミック引数として送ることが可能です。 |
説明
複数のトグルを一つの Toggle Groupに結合させることも可能です。オプションの一つを使って、複数のトグルを一度にオンにすることができます。
トグルには On Value Changed と呼ばれるシングルイベントがあります。これはユーザーが現在の値を変更したときに発火します。新しい値は boolean パラメーターとしてイベントファンクションに渡されます。トグルの含まれる一般的な使用例は
- オプションのオンとオフの切り替え(例:ゲーム中の音楽再生)
- ユーザーが法的放棄声明文を読んだ事を認証させる。
- トグルグループ使用時にオプションのうちの一つ(例:一週間の中の 1 日)を選択する。
トグル は、クリック可能な領域を子に提供する親だということに気を付けてください。もし、トグル に子がない場合 (もしくは子が使用不可になっている場合) は、クリック出来ないようになっています。