On this page

inputs.h

Form rows, grouped choices, button matrices, range controls, text areas and the on screen keyboard, reached through isolenui/kit/kit.h.

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

#include "isolenui/kit/inputs.h". The guide starts at Forms and text areas.

Forms and input groups

Explained in Forms and text areas.

ui::field_specui::field_ofui::form_beginui::form_endui_formui::labelui::addonui::addon_kindui::addon_textui::addon_iconui::addon_buttonui::addon_ofui::addon_markui::addon_pressui::input_groupui::input_group_outui::input_group_beginui::input_group_endui_input_groupui::native_select

Text areas

Explained in Forms and text areas.

ui::textareaui::textarea_runui::textarea_specui::textarea_ofui::textarea_flagui::textarea_nowrapui::textarea_tabsui::textarea_growui::textarea_countui::textarea_read_onlyui::textarea_editorui::textarea_reload

Groups and switches

Explained in Groups, toggles and matrices.

ui::check_stateui::check_offui::check_onui::check_mixedui::checkbox_mixedui::checkbox_groupui::radio_groupui::switch_sizeui::switch_smallui::switch_normalui::switch_largeui::switch_specui::switch_ofui::switch_ex

Toggles and matrices

Explained in Groups, toggles and matrices.

ui::toggle_buttonui::toggle_groupui::toggle_group_multiui::button_groupui::matrixui::matrix_specui::matrix_outui::matrix_buttonsui::matrix_cellui::matrix_noneui::cell_flagui::cell_widthui::cell_hiddenui::cell_disabledui::cell_checkableui::cell_checkedui::cell_accentui::cell_repeatui::matrix_flagui::matrix_one_checkui::matrix_attachedui::matrix_no_wrapui::matrix_fitui::matrix_no_focus

Ranges and arcs

Explained in Ranges, arcs and scales.

ui::slider_rangeui::slider_verticalui::arcui::arc_specui::arc_ofui::arc_modeui::arc_normalui::arc_reverseui::arc_symmetricui::arc_drawui::arc_t_atui::arc_labelui::arc_label_specui::arc_label_ofui::arc_label_drawui::arc_textui::arc_text_startui::arc_text_centreui::arc_text_endui::arc_label_spec::inside

Scales

Explained in Ranges, arcs and scales.

ui::scaleui::scale_specui::scale_ofui::scale_modeui::scale_bottomui::scale_topui::scale_leftui::scale_rightui::scale_round_inui::scale_round_outui::scale_sectionui::scale_lookui::scale_drawui::scale_point

Keyboard

Explained in On screen keyboard.

ui::keyboardui::keyboard_modeui::keyboard_lowerui::keyboard_upperui::keyboard_symbolsui::keyboard_numberui::keyboard_out

Example

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

#include <string.h>

struct signup {
    char email[128] = "";
    char site[128] = "";
    char bio[4096] = "";
    uint32_t plan = 0;
    bool bad_email = false;
    bool check_site = false;
};

static void form(ui::ctx* u, signup* s)
{
    // a label, the control, then a note or an error under it
    ui::field_spec email = ui::field_of("email").needed().about("we never share it");
    if (s->bad_email) {
        email.fails("that address has no @");
    }
    ui_form(u, email)
    {
        if (ui::text_box(u, "you@example.com", s->email, sizeof(s->email))) {
            s->bad_email = s->email[0] && !strchr(s->email, '@');
        }
    }

    // a prefix and a button round one bare field, all in one frame
    const ui::addon lead[] = { ui::addon_of("https://") };
    const ui::addon trail[] = { ui::addon_press("check") };
    ui::input_group_out out;
    ui_form(u, ui::field_of("website").beside(120.0f))
    {
        ui::input_group(u, "site", s->site, sizeof(s->site), lead, 1u, trail, 1u, 0u, &out);
    }
    // lead addons count first, so the trailing check is 1
    s->check_site = out.pressed == 1u;

    // grows from three rows to eight and shows a counter
    ui_form(u, ui::field_of("about you"))
    {
        ui::textarea(u, "bio", s->bio, sizeof(s->bio),
                     ui::textarea_of().hint("a few lines").lines(3u, 8u).grows().counted(500u));
    }

    static const char* const plans[] = { "free", "team", "studio" };
    ui_form(u, ui::field_of("plan"))
    {
        ui::native_select(u, "plan", plans, 3u, &s->plan);
    }
}

Last updated 23 October 2026