CharDesk Docs

Core Host Icon Controls

Icon, geometry, state, and association contract.

HEAD a63778e
Read this page whenYou add or review a core Host icon or icon-only control.
First answerCore controls use shared iconology, fixed geometry, explicit state props, and the common focus ring.
BoundaryThis page owns control vocabulary and geometry; feature actions remain owned by their Host surface.
Follow-upRead Visual vocabulary, then verify the control snapshots and interaction tests.
  • Resolve core Host icons through HOST_ICONOLOGY.
  • Compose text actions with Button and icon-only actions with IconButton. Express state through active, pressed, open, and subordinate props.
  • Icon controls are 32 by 32 pixels with 16 pixel icons. Text controls are 32 pixels high.
  • Idle is transparent and muted; persistent state strength is active > pressed > open > hover; focus uses the shared 2 pixel ring.
  • Core controls are borderless, shadowless, padding-free, and use the 6px control radius unless compound geometry joins controls.
  • A subordinate control uses the shared subordinate behavior and never owns local opacity state classes.
  • Pair icon-only controls with an accessible name and the shared Tooltip. Control groups share one handle and popup; native title tooltips are prohibited.
  • Surface and elevation selection belongs to the Visual system.

Authority and evidence