CharDesk Docs

Dialog Surfaces

Contract for Dialog, AlertDialog, Sheet, and modal Host elevation.

HEAD a63778e
  • Use shared Dialog section components. Instances may set width but do not redefine shell, spacing, or close geometry.
  • The shell owns spacing and padding. Header, body, and footer add no surface, divider, or elevation.
  • Group content through spacing and typography, not accent panels or cards.
  • AlertDialog shares the surface contract without close-control space. Destructive semantics belong to its confirmation action.
  • Sheet and mobile Sidebar panels retain the modal surface and elevation defined by the Visual system.
  • Embedded controls do not add nested shadows.
  • Navigation settings use one Dialog with sidebar navigation from medium widths upward and Select navigation on phones. Navigation does not own a scroll area; long labels truncate within their item.
  • Settings sections render content panels, not nested Dialog shells. Each panel owns its vertical scroll region while the navigation and close control remain visible. Settings data tables fit the panel width; cells truncate instead of creating panel-level horizontal scrolling. The Dialog title is visually hidden; the active section heading is the only visible heading. Settings rows stay single-line and use spacing and hover state instead of decorative separators.

Close-control geometry belongs to Core Host icon controls.

Authority and evidence