On this page

containers.h

Containers that page, split, fold and scroll, reached through isolenui/kit/kit.h.

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

#include "isolenui/kit/containers.h". The guide starts at Pagers, carousels, tabs and tiles.

Explained in Splits, accordions and sidebars.

ui::nav_groupui::nav_itemui::nav_item_spec

Pager

Explained in Pagers, carousels, tabs and tiles.

ui::pager_specui::pager_spec::acrossui::pager_spec::showingui::pager_spec::spacedui::pager_spec::swipesui::pager_spec::loopsui::pager_spec::keyedui::pagerui::pager_beginui::pager_pageui::pager_page_endui::pager_endui_page

Explained in Pagers, carousels, tabs and tiles.

ui::carousel_specui::carousel_spec::showingui::carousel_spec::spacedui::carousel_spec::playsui::carousel_spec::loopsui::carousel_spec::arrowedui::carousel_spec::dottedui::carouselui::carousel_beginui::slideui::slide_endui::carousel_endui_slide

Tab view and tile view

Explained in Pagers, carousels, tabs and tiles.

ui::tab_bar_atui::tabs_topui::tabs_bottomui::tabs_leftui::tabs_rightui::tab_view_beginui::tab_paneui::tab_pane_endui::tab_view_endui_tab_paneui::tile_view_beginui::tileui::tile_endui::tile_view_endui_tile

Split

Explained in Splits, accordions and sidebars.

ui::split_specui::split_spec::columnui::split_spec::atui::split_spec::firstui::split_spec::secondui::split_spec::gripui::split_spec::foldableui::split_spec::ownedui::splitui::split_beginui::split_nextui::split_end

Accordion and scroll area

Explained in Splits, accordions and sidebars.

ui::accordion_beginui::accordion_itemui::accordion_item_endui::accordion_endui_accordion_itemui::scroll_area_beginui::scroll_area_endui_scroll_area

Explained in Splits, accordions and sidebars.

ui::sidebar_specui::sidebar_spec::wideui::sidebar_spec::railedui::sidebar_spec::on_rightui::sidebarui::sidebar_beginui::sidebar_groupui::sidebar_itemui::sidebar_toggleui::sidebar_end

Example

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

struct editor {
    bool folded = false;
    uint32_t section = 1u;
    float split = 0.3f;
    uint64_t open = 1u;
};

static void editor_view(ui::ctx* u, editor* e, gfx_svg files_icon, gfx_svg search_icon)
{
    ui_box(u, ui::row().grow())
    {
        // a navigation sidebar that folds to an icon rail
        if (ui::sidebar_begin(u, "nav", ui::col().grow(), &e->folded, ui::sidebar())) {
            ui::sidebar_toggle(u, &e->folded);
            ui::sidebar_group(u, "workspace");
            ui::sidebar_item(u, files_icon, "files", 1u, &e->section);
            ui::sidebar_item(u, search_icon, "search", 2u, &e->section);
            ui::sidebar_end(u);
        }

        // two panes, the app keeps the fraction, a double click folds the first
        const ui::split_spec sp = ui::split().first(160.0f).second(240.0f).owned(&e->split);
        if (ui::split_begin(u, "panes", ui::row().grow(), sp)) {
            // the first pane, an accordion with one section open at a time
            if (ui::accordion_begin(u, "outline", &e->open, true)) {
                ui_accordion_item(u, "symbols") { ui::text(u, "main"); }
                ui_accordion_item(u, "notes") { ui::text(u, "none yet"); }
                ui::accordion_end(u);
            }

            ui::split_next(u);

            // the second pane scrolls under thin themed bars
            ui_scroll_area(u, "body", ui::col().grow().pad(12.0f))
            {
                for (uint32_t i = 0; i < 200u; ++i) {
                    ui::key(u, uint64_t(i));
                    ui::textf(u, ui::mono(u), "%4u  line", i + 1u);
                }
            }
            ui::split_end(u);
        }
    }
}

Last updated 23 October 2026