chrome:shell.skip

generated:catalog.entry.combobox.title

generated:catalog.entry.combobox.description

@xngui/components/combobox
@xngui/components/combobox

chrome:demo.section

chrome:demo.preview

demo-preview:combobox.filter-hint

Value: —

demo-preview:hints.category.navigation:
↑ ↓
demo-preview:hints.category.shortcuts:
TypeEnterEscape
demo-preview:projection.slots-label:
[xStart] [xEnd]
import { Component } from '@angular/core';
import { XCombobox } from '@xngui/components/combobox';
import { XForm } from '@xngui/components/form';
import { XFormField } from '@xngui/components/form-field';
 
@Component({
selector: 'app-example',
imports: [XCombobox, XForm, XFormField],
templateUrl: './combobox.component.html',
})
export class ExampleComponent {}

chrome:demo.events.title

chrome:demo.events.empty

chrome:demo.api.title

x-combobox

chrome:demo.api.col.property
chrome:demo.api.col.type
chrome:demo.api.col.default
chrome:demo.api.col.description
dataSource chrome:demo.api.required
XComboboxDataSource
—
Option pipeline — XDataSource for static, remote, or filtered lists.
size
XSize
—
Visual size tier — falls back to XConfigService when unset.
density
XDensity
—
Spacing offsets — orthogonal to `size`; falls back to XConfigService when unset.
look
XFormLook
—
Field chrome — outline, fill, flat, or none; falls back to XForm then XConfigService.
placeholder
string
—
Placeholder text in the search field.
debounceMs
number
300
Debounce duration in milliseconds before filtering options.
mask
XTextMaskInput
—
As-you-type mask on the search field — preset, Maskito options, or config with `unmask`. Query text stays unmasked (digits-only for presets).
disabled
boolean
false
Prevents interaction and sets `aria-disabled` on the search field.
readonly
boolean
false
Value-only input — user cannot change when true.
invalid
boolean
false
Marks the control invalid for styling and ARIA.
required
boolean
false
Marks the control as required for validation and ARIA.
name
string
''
Native form control `name` attribute.
controlId
string
—
Native `id` on the inner search field; falls back to `name`, then a generated id.
emptyLabel
string
—
Text shown when filtering returns no options.