NV Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles Custom Elements Golang Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Combobox

stable:  0.2.4 Coverage: 91.73% Bundle: 35.27kb Lighthouse: 100 Axe Core Released: 0.17.0
Overview API Examples

<nve-combobox>

Properties

Property Attribute Description Values prominence prominence

Controls the visual prominence to establish hierarchy and guide user attention.
muted Reduces visual weight for supporting content that should remain subtle and unobtrusive.
 i18n i18n

Enables updating internal string values for internationalization.
fitContent fit-content

Sets the input to match native default content block
true
false
fitText fit-text

Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)
true
false
layout layout

Controls the directional arrangement and spacing behavior of the element's content.
vertical Arranges content in a vertical stack with block-level spacing.
vertical-inline Arranges content vertically with compact inline spacing for dense layouts.
horizontal Arranges content in a horizontal row with block-level spacing.
horizontal-inline Arranges content horizontally with compact inline spacing.
 status status

Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
warning Indicates cautionary actions that require careful consideration before proceeding.
success Represents positive outcomes, confirmations, or constructive actions.
error
disabled
selectAll none

Select all options provided
reset none

Resets control value to initial attribute value and clears any active validation rules.
behaviorCreate behavior-create

Enable creation of new options when the input value doesn't match any existing option. Dispatches a create event with { value } detail.
true
false
tagLayout tag-layout

Manage inline tag rendering for many-item select
hidden
wrap
container container

Demonstrates different container styles to accommodate visual weight and context.
flat Element has white space bounds but reduced visual container.

Events

Event Description reset
scroll

Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. detail: { scrollTop, scrollHeight, clientHeight }.

 create

Fires when the user confirms a value that doesn't match any existing option and the behavior-create attribute exists. detail: { value }.

Slots

Slot Description label

Label element

 footer

slot for dropdown footer content

 prefix-icon

slot for icon before the input

 default

default slot for an input and a datalist/select element

CSS Properties

Css-property Description --control-height --control-width --label-font-size --label-font-weight --label-width --label-color --accent-color --text-transform --max-height --border-color --width --font-weight --cursor --border --border-radius --color --background --height --font-size --padding --scroll-height

CSS Parts

Css-part Description create-option

The menu item element for creating new options

 icon

The icon element

 checkbox

The checkbox element

 menu-item

The menu item elements

 menu

The menu element

 dropdown

The dropdown popup element

 tag

The tag element for selected items