CngxSelectConfig
projects/forms/select/shared/config.ts
Referenced by#
Import#
import { CngxSelectConfig } from '@cngx/forms/select'
Description#
Resolved select-family configuration cascade. Built by composing
with* features through provideSelectConfig /
provideSelectConfigAt; consumed via the CNGX_SELECT_CONFIG
injection token. Every field is optional - unset keys fall back to
the library defaults.
Index#
Properties
Instance Properties#
CngxSelectAriaLabelsARIA-label overrides. Partial. Per-instance input wins.
"wrap" | "scroll-x" | "truncate"Chip-strip overflow for multi-value triggers.
'wrap'(default) - chips wrap, trigger grows.'scroll-x'- single row, horizontal scroll.'truncate'- firstmaxVisibleChipschips ++Nbadge.
CngxCommitErrorAnnouncePolicy | nullForces the scalar-commit error announce policy. null keeps each
variant's baseline (CngxSelect verbose/assertive, Typeahead +
ActionSelect soft). Array-commit variants don't read this.
CngxSelectCommitErrorDisplayDefault surface for commitAction errors: banner, inline, or none.
"outside" | "escape" | "both"Dismiss strategy: click outside, Escape, or both.
"enter" | "done" | "go" | "next" | "previous" | "search" | "send" | nullenterkeyhint forced across input-trigger variants. null keeps
each variant's baseline (Typeahead 'done', Combobox 'enter',
ActionSelect 'go', ActionMultiSelect 'enter').
CngxSelectFallbackLabelsPanel-shell async-view fallback labels. Per-instance template wins.
"search" | "text" | "email" | "url" | "tel" | "numeric" | "decimal" | "none"inputmode for input-trigger variants. Default 'search'.
Button-trigger variants don't read this.
"trigger" | number | nullPanel width strategy:
'trigger'(default): panel min-width matches trigger width viaanchor-size(width).number: fixed px min-width.null: natural - panel sizes to content.
PopoverPlacementPopover placement for every flat variant. Default 'bottom'. Action
organisms read CngxActionSelectConfig.popoverPlacement instead.
CngxSelectRefreshingVariantDefault subsequent-load (refreshing) indicator variant.
CngxSelectSelectionIndicatorPositionPosition of the per-option selection indicator relative to the label
inside a panel row. Defaults to 'before'.
CngxSelectSelectionIndicatorVariantVisual form of the per-option selection indicator. 'auto' picks
'checkbox' for multi-select / combobox and 'checkmark' for
single-select. Defaults to 'auto'.
Whether the default selected-indicator (checkmark) is shown at all.
Number of skeleton rows rendered when loadingVariant === 'skeleton'.
literal typeDefault template overrides applied when no per-instance slot is projected.
Whether typeahead commits value while panel is closed (native <select> parity).
CngxSelectVirtualizationConfig | nullOpt-in recycler virtualisation. Custom virtualisation pipelines
provide CNGX_PANEL_RENDERER_FACTORY directly - that token wins.