Skip to main content

Module domkit

Module domkit 

Source
Expand description

The DOM widget catalog (CSS-styled controls, select popover, chat blocks). The DOM widget catalog: ready-made El trees for the common controls and chat building blocks, styled by KIT_CSS (every look is a CSS rule an app may override by appending its own sheet, see sheet_with).

widgetbuilderelement / classeshit ids
buttonbuttonbutton.k-btn (.primary, .ghost)id
switchswitchbutton.k-switch + Control::Switch (:checked)id
checkboxcheckboxdiv.k-check > span.k-box + Control::Checkboxid
text inputinputdiv.k-input + Control::Input (:focus)id
spinnerspinnerspan.k-spinner + Control::Spinner—
select triggerselect_triggerselect.k-select (.open)id
select popoverselect_popoverfixed div.k-pop > div.k-opt (.sel, .dis) > label + div.k-sub{id}:opt:{i} (enabled rows only)
message bubblebubblediv.k-msg.me / .them > div.k-who, div.k-body (runs), div.k-timeid
hover action rowaction_rowdiv.k-actions > button.k-act{id}:{key}
collapsible cardcarddiv.k-card (.open) > div.k-card-head + div.k-card-bodyid (the head)
chip / filterchipbutton.k-chip (.on)id
bannerbannerdiv.k-banner.info / .warn / .error{id}:act, {id}:close
side panelside_panelfixed div.k-side > div.k-side-head + div.k-side-body{id}:close

Inline markdown for bubbles is inline_md; long lists render only their visible rows with VirtualList. Kit widgets from uzor-framework go inside a DOM tree through an embed slot (El::slot + Dom::slots); a DOM tree goes inside a kit panel by laying it out in the panel’s rect.

Modules§

icons
Icon bodies used by the catalog.

Structs§

ListView
What part of a long option list a popover shows. The select’s own model (keyboard, wheel, type-to-filter) keeps it; the popover only draws it.
SelectOpt
One option of a select.
VirtualList
A virtualized list: only the rows in (or near) the viewport are built and laid out; spacers stand for the rest. Row heights start at an estimate and are learned from laid-out rows (VirtualList::measure), so long chats stay cheap.
Window
The rows a VirtualList shows and the space around them.

Constants§

KIT_CSS
The catalog’s default look (dark, 13px Inter). Variables on :root theme it: --k-accent, --k-bg, --k-fg, --k-muted, --k-line, --k-panel.

Functions§

action_row
A hover action row (reply, react, copy, more…): (key, icon body, name) per button, hits {id}:{key}.
banner
A banner (kind: info, warn, error) with an optional action button ({id}:act) and a close button ({id}:close).
bubble
A chat message bubble: optional sender line, markdown body (inline_md), time.
button
A push button.
card
A collapsible card: the head (hit id) toggles open; the body shows when open.
checkbox
A checkbox with its label; the row is the hit.
chip
A filter chip.
icon
A 24×24 stroke icon (currentColor) from its path markup.
inline_md
Inline markdown to DOM runs: **bold**, *italic* / _italic_, ***both***, `code` (verbatim), http(s) links (a.link, hit url:…) and @nick mentions (a.mention, hit nick:…). Unclosed markers stay literal; _ only opens at a word start and closes at a word end (snake_case stays as is).
input
A single-line text input showing edit.
picked_opt
The option index a select popover hit id names ({id}:opt:{i}).
popover_at
Where a popover h tall goes for a trigger at anchor in viewport: below it, or above when it does not fit below and fits better above; at least the trigger’s width.
select_list
select_popover for a windowed, searchable list: rows view.top .. of opts (the already filtered options; hits keep their index in opts), the highlighted row, a search line and a scroll thumb. “No matches” when opts is empty. The popover is position: fixed at at, so at is in the coordinates of the viewport given to lay_out_in (the window, origin 0,0). Its rows’ --k-accent (the chosen row’s tick) can be set inline on the returned element.
select_popover
The open select’s list as a position: fixed popover at at (see popover_at): it paints above the page and does not scroll with it. Enabled rows are hits {id}:opt:{i}; chosen is marked .sel (with a tick).
select_trigger
The closed select: the chosen label and a chevron.
sheet
KIT_CSS parsed.
sheet_with
KIT_CSS followed by the app’s own rules (later rules of equal specificity win).
side_panel
A side panel docked right (position: fixed: it stays while the page scrolls), with a title row and a close button ({id}:close).
slot
An embed slot box (div.k-slot) named key, w × h: a kit widget or canvas goes in its content box (see Dom::slots).
spinner
A busy spinner at time t seconds.
switch
A switch (role="switch"): the track is the button’s box, the knob its control.
switch_at
A switch whose knob is at pos (0 … 1) while it slides.