On this page

pickers.h

The picker components: calendars, date, range, time and date time pickers, a colour picker and its parts, rollers, code cells and spin boxes. They come in through isolenui/kit/kit.h.

The pickers group of the kit, drawn by isolenThe pickers group of the kit, drawn by isolen

#include "isolenui/kit/pickers.h". The guide starts at Calendars and dates.

Day numbers

Explained in Calendars and dates.

ui::k_no_dayui::civilui::days_from_civilui::civil_from_daysui::weekday_ofui::leap_yearui::month_daysui::month_indexui::month_firstui::todayui::date_namesui::date_names_english

Calendars

Explained in Calendars and dates.

ui::calendar_specui::calendar_defaultsui::day_testui::day_paintui::calendarui::calendar_range

Date pickers

Explained in Calendars and dates.

ui::date_orderui::date_ymdui::date_dmyui::date_mdyui::date_specui::date_defaultsui::date_formatui::date_parseui::date_pickerui::date_range_picker

Time

Explained in Time and date time.

ui::time_specui::time_defaultsui::time_pickerui::date_time_picker

Colour

Explained in Colour picker.

ui::hsvui::hsv_ofui::rgba_ofui::hex_parseui::hex_formatui::colour_specui::colour_defaultsui::colour_pickerui::colour_buttonui::colour_areaui::hue_stripui::alpha_stripui::swatches

Rollers, codes and spin boxes

Explained in Rollers, codes and spin boxes.

ui::roller_specui::roller_defaultsui::rollerui::roller_fnui::roller_textui::otp_specui::otp_defaultsui::input_otpui::spinbox_specui::spinbox_defaultsui::spinbox

Example

booking.cpp
#include "isolenui/ui/ui.h"
#include "isolenui/kit/kit.h"

struct booking {
    int32_t day = ui::k_no_day;
    int32_t from = ui::k_no_day;
    int32_t to = ui::k_no_day;
};

static bool weekend(int32_t day, void*)
{
    const uint32_t wd = ui::weekday_of(day);
    return wd == 0u || wd == 6u;
}

static void booking_view(ui::ctx* u, booking* b)
{
    // one month, weeks start on sunday, every day pickable
    if (ui::calendar(u, "delivery", &b->day)) {
        // a day was clicked or picked with enter or space
    }

    // two months side by side, monday first, no weekends, nothing in the past
    ui::calendar_spec spec = ui::calendar_defaults();
    spec.week_start = 1u;
    spec.months = 2u;
    spec.min_day = ui::today(u);
    spec.disabled = weekend;

    bool done = false;
    ui::calendar_range(u, "stay", &b->from, &b->to, &spec, &done);
    if (done) {
        // the second pick landed, from and to are ordered
    }
}

Last updated 23 October 2026