Time Picker

OverviewCopy Anchor Link

Time Picker selects a time of day on hour, minute, and AM/PM wheels. The wheels turn like a drum, keep spinning after a flick, and settle on a row. Hours and minutes loop endlessly.

UsageCopy Anchor Link

CustomizationCopy Anchor Link

Text StyleCopy Anchor Link

Each wheel draws all of its rows from one Item template. The other rows are hidden copies that are never saved, so editing the template restyles the whole wheel. To restyle the picker at once, press Style > Select Text Items on the Time Picker; it selects every template and the separator for editing together.

Text color and font come from the Styler Object’s Color ID and Font ID. Set size, spacing, and alignment on the text component.

Format and LabelsCopy Anchor Link

Hour Format can be 12-hour, 24-hour, or Auto, which follows the device’s regional format. The AM/PM wheel is hidden in the 24-hour format. In the 12-hour format, turning the hours past 11 and 12 also turns AM/PM, as on iOS.

Minute Interval can be any divisor of 60 up to 30 minutes. Times in between round down. The AM and PM labels can use Evo Localization when the integration is enabled.

WheelsCopy Anchor Link

Row Height sets the row height of every wheel and the selection indicator. The height of a wheel sets how strongly its drum curves. On each Picker Wheel, Unselected Alpha sets how much the rows away from the center fade, and Deceleration Rate sets how far a flick spins.

Sound Effects in Effects plays a tick as rows pass the center while the user turns a wheel.

NotesCopy Anchor Link

Wheels respond to dragging, flicking, the mouse wheel (one row per notch), clicking a row, and up and down navigation from a keyboard or gamepad. Touching a spinning wheel stops it. Sideways drags and scrolls pass to a parent scroll view.

On Time Changed is invoked once on start, when a wheel settles on a new time, and when a notifying SetTime() changes it. While a wheel is still turning, SelectedTime returns the previous value.

In Edit Mode, Current previews 9:41 so that opening a scene does not modify it.

PerformanceCopy Anchor Link

Each wheel keeps only the rows it can show and reuses them while turning, so only rows entering the view change their text. Turning, landing, and ticking allocate no memory.

Public APICopy Anchor Link

Use TimePicker in the Evo.UI namespace.

Hours range from 0 to 23 in every format. The wheels only change how they are shown.

PropertiesCopy Anchor Link

FieldsCopy Anchor Link

MethodsCopy Anchor Link

EventsCopy Anchor Link

Picker WheelCopy Anchor Link

PickerWheel is the wheel used by Time Picker, and it works on its own for any list of options. Its labels come from Items in the Inspector, or from SetItems(). onValueChanged is a UnityEvent<int> invoked with the item index when the wheel settles on another item. Enable Loop to make the list endless. Picker Wheel has no tick sound of its own.

ExampleCopy Anchor Link

using UnityEngine;
using Evo.UI;

public class TimePickerExample : MonoBehaviour
{
    [SerializeField] private TimePicker target;

    private void Start()
    {
        target.Format = TimePicker.HourFormat.Auto;
        target.Interval = TimePicker.MinuteInterval.Five;
        target.SetTime(7, 30, false, false);
        target.onTimeChanged.AddListener(time => Debug.Log($"Alarm set for {time:hh\\:mm}"));
    }
}

using UnityEngine;
using Evo.UI;

public class PickerWheelExample : MonoBehaviour
{
    [SerializeField] private PickerWheel target;

    private static readonly string[] Sizes = { "Small", "Medium", "Large" };

    private void Start()
    {
        target.Loop = false;
        target.SetItems(Sizes);
        target.SetIndex(1, false, false);
        target.onValueChanged.AddListener(index => Debug.Log($"Size: {Sizes[index]}"));
    }
}