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


#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_selectText 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_reloadGroups 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_exToggles 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_focusRanges 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::insideScales
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_pointKeyboard
Explained in On screen keyboard.
ui::keyboardui::keyboard_modeui::keyboard_lowerui::keyboard_upperui::keyboard_symbolsui::keyboard_numberui::keyboard_outExample
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);
}
}