data.h
Tables, lists, trees and display parts from the kit, reached through isolenui/kit/kit.h. The badge overload that takes a tone lives here too.


#include "isolenui/kit/data.h". The guide starts at Tables and data tables.
Tables
Explained in Tables and data tables.
ui::col_sizeui::col_flagui::col_sortui::col_resizeui::col_filterui::col_numberui::columnui::cell_fnui::cell_posUI_TABLE_COLSUI_CELL_TEXTui::tableui::table_beginui::table_rowui::table_row_beginui::table_cell_beginui::table_cell_endui::table_row_endui::table_endData tables
Explained in Tables and data tables.
ui::data_sourceui::sort_dirui::data_eventui::data_modelui::data_model_createui::data_model_destroyui::data_model_viewui::data_model_selectedui::data_model_selected_countui::data_model_selectui::data_model_clearui::data_model_sortui::data_model_cursorui::data_model_widthui::data_tableItems and lists
Explained in Items, lists and trees.
ui::item_specui::itemui::item_beginui::item_endui_itemui::item_fill_fnui::list_viewTrees
Explained in Items, lists and trees.
ui::tree_sourceui::tree_eventui::tree_viewui::tree_openui::tree_is_openCards, alerts and empty states
Explained in Cards, alerts and display parts.
ui::card_beginui::card_headerui::card_content_beginui::card_footer_beginui::card_section_endui::card_endui_cardui_card_contentui_card_footerui::toneui::alertui::alert_beginui::alert_endui_alertui::empty_stateui::empty_beginui::empty_endTypography, badges and marks
Explained in Cards, alerts and display parts.
ui::h1ui::h2ui::h3ui::h4ui::leadui::largeui::mutedui::blockquoteui::inline_codeui::kbdui::separatorLoading and avatars
Explained in Cards, alerts and display parts.
ui::skeletonui::skeleton_textui::spinnerui::progress_indeterminateui::progress_ringui::presenceui::avatarNavigation and shape
Explained in Cards, alerts and display parts.
ui::breadcrumbui::paginationui::aspect_beginui::aspect_endui_aspectExample
library.cpp
#include "isolenui/ui/ui.h"
#include "isolenui/kit/kit.h"
#include <stdio.h>
struct track {
const char* title;
const char* artist;
double seconds;
};
struct library {
const track* rows;
uint32_t count;
uint64_t version;
char query[64];
ui::cell_pos at;
ui::data_model* model;
};
// a cell writes into buf or returns memory it already owns
static const char* cell(uint32_t row, uint32_t col, char* buf, uint32_t cap, void* user)
{
const library* l = static_cast<const library*>(user);
const track& t = l->rows[row];
if (col == 0u) {
return t.title;
}
if (col == 1u) {
return t.artist;
}
snprintf(buf, cap, "%u:%02u", unsigned(t.seconds) / 60u, unsigned(t.seconds) % 60u);
return buf;
}
static double number(uint32_t row, uint32_t, void* user)
{
return static_cast<const library*>(user)->rows[row].seconds;
}
static const ui::column cols[] = {
{ "title", ui::col_size::grow, 2.0f, text_font_left, ui::col_sort | ui::col_filter | ui::col_resize },
{ "artist", ui::col_size::fit, 120.0f, text_font_left, ui::col_sort | ui::col_filter },
{ "length", ui::col_size::fixed, 72.0f, text_font_right, ui::col_sort | ui::col_number },
};
static void library_view(ui::ctx* u, library* l)
{
// a plain table, cells come from the callback and arrows move the cell
if (ui::table(u, "recent", cols, 3u, l->count, cell, l, &l->at)) {
printf("play %s\n", l->rows[l->at.row].title);
}
// the same rows declared by hand, only the visible ones
uint32_t first = 0u;
const uint32_t n = ui::table_begin(u, "manual", cols, 3u, l->count, nullptr, &first);
for (uint32_t r = first; r < first + n; ++r) {
char len[16];
const char* cells[3] = { l->rows[r].title, l->rows[r].artist, cell(r, 2u, len, 16u, l) };
ui::table_row(u, r, cells);
}
ui::table_end(u);
// sorted and filtered over an index, the caller owns the model
if (!l->model) {
l->model = ui::data_model_create();
}
ui::data_source src = {};
src.rows = l->count;
src.version = l->version;
src.text = cell;
src.number = number;
src.user = l;
ui::data_event ev = {};
if (ui::data_table(u, "library", cols, 3u, src, l->query, &ev, l->model)) {
printf("play %s\n", l->rows[ev.row].title);
}
if (ev.selection) {
printf("%u picked\n", ui::data_model_selected_count(l->model));
}
}
static void library_free(library* l)
{
ui::data_model_destroy(l->model);
l->model = nullptr;
}