Components
Every datui component, grouped by purpose. Use the sidebar search to filter.
Providers & app
- AdaptivityProviderExposes viewport size classes and input capabilities via
useAdaptivity(). Values are detected from media queries; the provider overrides them for a subtree. - AppRootRoot container that applies theme, density, direction and locale to the DOM and hosts the portal layer overlays render into.
- ConfigProviderApp-wide settings: color scheme, locale, text direction and transition motion.
ColorSchemeProvider,LocaleProviderandDirectionProviderare also available on their own.
Primitives
- FocusTrapKeeps keyboard focus inside its children. datui overlays use it internally; use it for custom popups.
- Tappable & Clickable
Clickablerenders the right interactive element for its props;Tappableadds hover, press, focus and disabled feedback. Buttons, cells and tabs are built on them. - VisuallyHiddenHides content visually while keeping it available to assistive technology.
Layout
- AspectRatioBox locked to an aspect ratio; children stretch to fill.
- BoxGeneric layout element with padding, margin and size props on the spacing scale.
- CardGridResponsive grid of cards.
- FixedLayoutPins content (a search bar, a bottom action) to the top or bottom of its panel while the rest scrolls.
- FlexFlexbox container with gaps on the spacing scale, plus
FlexItemfor sizing children. - FooterCentered secondary text at the end of a list or section.
- GradientBackground fade block toward the top or bottom.
- GroupContent section — card or plain — with header, description and separators between siblings.
- HeaderSection heading with subtitle, indicator and before/after slots.
- HorizontalScrollA horizontal strip that scrolls natively and adds prev/next arrows for pointer users. Arrows hide at the start and end.
- SeparatorThin divider line, horizontal or vertical, optionally inset with the standard gutter.
- SimpleGridCSS grid with a fixed number of equal columns, or as many columns as fit a minimum width.
- SpacingEmpty vertical spacer on the spacing scale (
3xs…4xl), a px number or any CSS length. - SplitLayoutMulti-column app shell: a sidebar and content columns with width bounds, an optional header row and sticky columns.
Typography
Buttons
- ButtonThe main action control. Renders a native button, or a link when given
href. - ButtonGroupLays out related buttons in a row or column with a consistent gap.
- CellButtonFull-width list-row button with the cell layout.
CellButtonGroupstacks several into one rounded block. - IconButtonSquare icon-only button.
- LinkInline text link with optional icons, hover underline and visited state.
- ToolButtonToolbar button with a density-adaptive icon and optional text.
Navigation
- EpicTabbed app shell: shows the active story (a View or Root) and a bottom Tabbar. Switching is instant and keeps scroll per story.
- PaginationPage navigation with previous/next buttons, boundary and sibling pages and ellipses.
- PanelOne screen inside a View. Plain on phones, a card on tablet width and up.
- PanelHeaderTop bar of a Panel: a title plus
before/afterslots for preset buttons. - PanelHeaderContextDrop-down sheet that slides out under the PanelHeader, e.g. to switch modes or filters.
- RootTop-level stack of Views. Shows one at a time and slides between them — a later child counts as forward, an earlier one as back.
- SubnavigationBarHorizontally scrolling row of chip-like SubnavigationButtons for filters and sub-sections.
- TabbarBottom navigation bar with icon destinations, labels and indicators. Usually passed to
Epic'stabbarslot. - TabsHorizontal tabs with an underline or pill style. Scrolls horizontally when items overflow and keeps the selected tab in view.
- ViewA stack of Panels with forward/back slide transitions, per-panel scroll restore and touch swipe-back.
Forms
- CalendarMonth grid date picker with month/year pickers, disabled dates, locale-aware labels and optional time. CalendarHeader is its navigation bar.
- CalendarRangeRange picker: first click sets the start, second the end, with a hover preview of the pending range. Two months on wide screens.
- CheckboxLabelled checkbox row with description and indeterminate state, plus a bare
CheckboxInput. - ChipCompact token with optional slots and a remove button. Used by ChipsInput and ChipsSelect.
- ChipsInputFree-form tag input: Enter or a delimiter turns typed text into chips.
- ChipsSelectMulti-select with chips and a filterable dropdown, optionally creatable.
- CustomSelectStyled select / combobox with a positioned listbox: type-ahead, optional search, async loading, groups, custom options and a clear button.
- DateInputSegmented date (and optional time) field with a calendar popover.
- DateRangeInputSegmented start – end date field with a range calendar popover.
- DropZoneDrag-and-drop target that highlights while files are dragged over it.
- FileButton that opens the native file picker.
- FormFieldBordered shell shared by text-like controls, with
before/afterslots, status and plain mode. - FormItemField wrapper with label, helper or error text, required marker and optional remove action.
- FormLayoutGroupGroups FormItems vertically or side by side, optionally joined into one segmented field.
- FormStatusForm-level message such as a submit error.
- InputSingle-line native text input inside a FormField.
- NativeSelectStyled native
<select>with placeholder and select types. - RadioGroupSingle choice between labelled
Radiooptions with roving arrow-key focus. - RemovableWraps a row or field with a remove action: a trailing ✕ button, or a two-step
revealthat shows a destructive Remove button. - SearchSearch field with clear button, trailing icon button, find button and an
afterslot. - SegmentedControlExclusive choice between a few options with a sliding indicator.
- SelectAdaptive select driven by an
optionsarray: CustomSelect with a mouse, the platform picker (NativeSelect) on touch devices. - SelectMimicryLooks like a select but is a button that opens something else, e.g. a modal picker.
- SliderSingle value or range slider with optional value tooltip.
- SwitchOn/off toggle.
- TextareaMulti-line native textarea that grows with its content.
- WriteBarMessage composer: an auto-growing textarea with action slots and preset icon buttons.
Data display
- AccordionA single expandable section: an
Accordion.Summaryrow that toggles an animatedAccordion.Contentbody. - AvatarRound image for a person or entity, with initials or icon fallback.
- BadgeTiny dot indicator placed next to a title or icon.
- BannerPromo or announcement block with actions and dismiss/chevron.
- CardPlain surface for grouping content.
- CardScrollA horizontally scrolling list of cards with snapping, optional gutters and arrows that move by one card. Built on HorizontalScroll.
- CellA SimpleCell with list-editing modes: selectable (checkbox or radio), removable, and draggable reordering inside
List. - ContentBadgeLabel pill for status or category, with optional icons.
- ContentCardCard with an optional cover image, title, description and caption; optionally a button or link.
- CounterSmall count pill used in tabs, buttons and cells.
- GalleryA swipeable carousel of slides with snapping, bullets, arrows, looping and optional autoplay. Built on embla-carousel.
- GridAvatarRound avatar built from up to four images, for group chats.
- HorizontalCellVertical tile — media on top, text below — for horizontally scrolling lists.
- ImageRounded-rectangle thumbnail with fallback icon, badges, overlay and floating elements.
- InfoRowLabel and value pair.
- MiniInfoCellCompact info line with a small icon, for profile details, "Add info" and "Show more" rows.
- PlaceholderEmpty state with icon, title, description and action.
- RichCellTaller row for rich content: large media, title with meta, subtitles, a bottom slot and action buttons below.
- SimpleCellBase list row with before/after slots, title, subtitles, indicator and chevron. Becomes a button with
onClickor a link withhref. - UsersStackOverlapping avatars with a "+N" counter and caption.
Overlays
- ActionSheetA list of actions: a menu anchored to its toggle on regular width, a bottom sheet with a Cancel row on compact width.
- AlertBlocking confirmation dialog with a title, description and a row of actions.
- ModalCardSmall modal for one message or decision: icon, title, description and actions. A centered card on regular width, docked to the bottom on compact width.
- ModalPageModal panel with header, scrollable content and footer. A centered dialog on regular width and a draggable bottom sheet on compact width.
- OnboardingTooltipSpotlight hint for onboarding: points at an element and blocks the page until dismissed.
- PopoverFloating panel anchored to a trigger, for arbitrary interactive content.
- TooltipShort hint shown on hover and focus of its anchor. Not for essential content.
Feedback
- PanelSpinnerSpinner centered in a full-width block for a loading panel or section.
- ProgressDeterminate linear progress bar.
- PullToRefreshPull-down-to-refresh for touch devices. Calls
onRefreshafter a long enough pull at the top of the page and shows a spinner untilisFetchingturns false. - ScreenSpinnerFull-screen blocking loader that can turn into a done, error or custom icon, or offer cancel.
- SkeletonShimmering placeholder for content that is loading.
- SnackbarTemporary notification with an optional action. Hides after
duration; swipe or Escape dismisses it. - SpinnerIndeterminate loading indicator that inherits the current text color.