On this page

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.

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

#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_end

Data 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_table

Items and lists

Explained in Items, lists and trees.

ui::item_specui::itemui::item_beginui::item_endui_itemui::item_fill_fnui::list_view

Trees

Explained in Items, lists and trees.

ui::tree_sourceui::tree_eventui::tree_viewui::tree_openui::tree_is_open

Cards, 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_end

Typography, badges and marks

Explained in Cards, alerts and display parts.

ui::h1ui::h2ui::h3ui::h4ui::leadui::largeui::mutedui::blockquoteui::inline_codeui::kbdui::separator

Loading and avatars

Explained in Cards, alerts and display parts.

ui::skeletonui::skeleton_textui::spinnerui::progress_indeterminateui::progress_ringui::presenceui::avatar

Explained in Cards, alerts and display parts.

ui::breadcrumbui::paginationui::aspect_beginui::aspect_endui_aspect

Example

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;
}

Last updated 23 October 2026