Skip to content
Velkin LogoVelkin Logo
Velkin
VELKIN/UI

Modern UI components for product teams and their AI agents. Lit core, typed wrappers, live MCP.

sales@velkinui.com

Product

  • Docs
  • Components
  • Studio
  • Pricing

Resources

  • Quick start
  • Blog
  • Changelog
  • Roadmap
  • Status

Project

  • About
  • Contact
  • License
  • Privacy
  • Terms

© 2026 Velkin. MIT core · Pro licenses available.

VELKIN

Adaptive Bar

A responsive toolbar component that overflows extra items into a menu.

vu-adaptive-bar · @velkin/react/adaptive-bar

Copy page

Import

React
npm i @velkin/react

import { VuAdaptiveBar } from "@velkin/react/adaptive-bar";

Examples

API

Tables match the member selected under Import.

Props

PropTypeDefaultDescription
variantVuAdaptiveBarVariant"flat"Bar surface treatment. Default: `"flat"`.
toneVuAdaptiveBarTone"normal"Neutral bar surface weight. Default: `"normal"`.
sizeVuAdaptiveBarSize"md"Bar padding, gap, and minimum height. Default: `"md"`.
justifyVuAdaptiveBarJustify"start"Inline alignment of visible items. Default: `"start"`.
itemSizeVuAdaptiveItemSize"md"Size forwarded to `<vu-adaptive-item>` children without their own `size`. Default: `"md"`.
menuOpenbooleanfalseWhether the overflow menu is open.
fullyOverflowedboolean—Read-only — true when every item is in the overflow menu.
gapThresholdnumber0Extra px buffer subtracted during measurement (padding/gaps are computed automatically). Default: `0`.
moreLabelstring"More"Accessible name for the overflow trigger. Default: `"More"`.
placementVuAdaptiveBarPlacement"bottom"Preferred overflow popover side. Default: `"bottom"`.

Events

EventDetailDescription
vu-open-changeVuAdaptiveBarOpenChangeDetailFired when the overflow menu opens or closes.

Slots

SlotDescription
—- Default slot for bar items. Use `<vu-adaptive-item>` or any element with `data-adaptive-item`.
overflowReceives items that no longer fit in the main bar (assigned automatically).

CSS parts

PartDescription
barOuter paint surface (background, border, shadow).
containerInner flex row (padding, gap, item alignment).
itemsVisible-item list wrapper (`role="list"`).
overflow-buttonThe overflow toggle button.
menuThe dropdown menu container.
menu-innerWrapper inside the dropdown menu.

Methods

MethodDescription
openMenuOpens the overflow menu.
closeMenuCloses the overflow menu.
toggleMenuToggles the overflow menu state.
recalculateLayoutRe-runs layout and overflow measurement.

Types

NameDefinition
VuAdaptiveBarJustify
"start" | "center" | "end"
VuAdaptiveBarOpenChangeDetail
{ open: boolean; }
VuAdaptiveBarPlacement
"top" | "bottom" | "left" | "right"
VuAdaptiveBarSize
"sm" | "md" | "lg"
VuAdaptiveBarTone
"subtle" | "normal" | "strong"
VuAdaptiveBarVariant
"outline" | "flat" | "elevated"
VuAdaptiveItemSize
"sm" | "md" | "lg"

Related

Companions

  • Adaptive Item`vu-adaptive-item`

Navigation

  • AppbarAn application bar component with start, center, and end slots.
  • BreadcrumbA breadcrumb component for navigation trails with optional collapse.
  • Context MenuA context menu component with grouped actions and icons.
  • DropdownA dropdown menu component with trigger slot and keyboard navigation.
  • MenubarA menubar component with nested submenus and keyboard navigation.
  • Nav PanelA navigation panel component for drawer bodies with icon-rail collapse.

Guides

  • AccessibilityFocus and naming
  • SlotsHeader, body, and item slots

Browse

  • Previous: Carousel ItemEarlier in the sidebar
  • Next: AppbarLater in the sidebar
  • All componentsBrowse the full index