playtest-unity/playtest/Library/PackageCache/com.unity.ugui@1.0.0/Documentation~/script-Toggle.md

38 lines
2.1 KiB
Markdown

# Toggle
The **Toggle** control is a checkbox that allows the user to switch an option on or off.
![A Toggle.](images/UI_ToggleExample.png)
![](images/UI_ToggleInspector.png)
## Properties
|**Property:** |**Function:** |
|:---|:---|
|**Interactable** | Will this component will accept input? See [Interactable](script-Selectable.md). |
|**Transition** | Properties that determine the way the control responds visually to user actions. See [Transition Options](script-SelectableTransition.md). |
|**Navigation** | Properties that determine the sequence of controls. See [Navigation Options](script-SelectableNavigation.md).|
|**Is On** | Is the toggle switched on from the beginning? |
|**Toggle Transition** | The way the toggle reacts graphically when its value is changed. The options are _None_ (ie, the checkmark simply appears or disappears) and _Fade_ (ie, the checkmark fades in or out). |
|**Graphic** |The image used for the checkmark. |
|**Group** | The [Toggle Group](script-ToggleGroup.md) (if any) that this Toggle belongs to. |
## Events
|**Property:** |**Function:** |
|:---|:---|
|**On Value Changed** | A [UnityEvent](https://docs.unity3d.com/Manual/UnityEvents.html) that is invoked when the Toggle is clicked. The event can send the current state as a `bool` type dynamic argument. |
## Details
The Toggle control allows the user to switch an option on or off. You can also combine several toggles into a [Toggle Group](script-ToggleGroup.md) in cases where only one of a set of options should be on at once.
The Toggle has a single event called _On Value Changed_ that responds when the user changes the current value. The new value is passed to the event function as a `boolean` parameter. Typical use cases for Toggles include:
* Switching an option on or off (eg, playing music during a game).
* Letting the user confirm they have read a legal disclaimer.
* Choosing one of a set of options (eg, a day of the week) when used in a Toggle Group.
Note that the **Toggle** is a parent that provides a clickable area to children. If the **Toggle** has no children (or they are disabled) then it is not clickable.