import * as i0 from '@angular/core'; import { InjectionToken, AfterContentInit, OnChanges, OnDestroy, OnInit, DoCheck, ChangeDetectorRef, ElementRef, QueryList, EventEmitter, SimpleChanges } from '@angular/core'; import * as i2 from '@angular/cdk/overlay'; import { ScrollStrategy, Overlay, ConnectedPosition, CdkOverlayOrigin, CdkConnectedOverlay } from '@angular/cdk/overlay'; import { M as MatOptionModule } from './index.d-CwEYxGJi.js'; import { M as MatCommonModule } from './common-module.d-C8xzHJDr.js'; import { ActiveDescendantKeyManager } from '@angular/cdk/a11y'; import { SelectionModel } from '@angular/cdk/collections'; import * as i5 from '@angular/cdk/scrolling'; import { ViewportRuler } from '@angular/cdk/scrolling'; import { ControlValueAccessor, NgControl } from '@angular/forms'; import { Subject, Observable } from 'rxjs'; import { E as ErrorStateMatcher } from './error-options.d-CGdTZUYk.js'; import { M as MatOption, a as MatOptgroup, b as MatOptionSelectionChange } from './option.d-BVGX3edu.js'; import { M as MatFormField } from './form-field.d-CMA_QQ0R.js'; import { M as MatFormFieldControl } from './form-field-control.d-QxD-9xJ3.js'; import { a as MatFormFieldModule } from './module.d-1ZCYe5BH.js'; /** Injection token that determines the scroll handling while a select is open. */ declare const MAT_SELECT_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>; /** * @docs-private * @deprecated No longer used, will be removed. * @breaking-change 21.0.0 */ declare function MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay: Overlay): () => ScrollStrategy; /** Object that can be used to configure the default options for the select module. */ interface MatSelectConfig { /** Whether option centering should be disabled. */ disableOptionCentering?: boolean; /** Time to wait in milliseconds after the last keystroke before moving focus to an item. */ typeaheadDebounceInterval?: number; /** Class or list of classes to be applied to the menu's overlay panel. */ overlayPanelClass?: string | string[]; /** Whether icon indicators should be hidden for single-selection. */ hideSingleSelectionIndicator?: boolean; /** * Width of the panel. If set to `auto`, the panel will match the trigger width. * If set to null or an empty string, the panel will grow to match the longest option's text. */ panelWidth?: string | number | null; /** * Whether nullable options can be selected by default. * See `MatSelect.canSelectNullableOptions` for more information. */ canSelectNullableOptions?: boolean; } /** Injection token that can be used to provide the default options the select module. */ declare const MAT_SELECT_CONFIG: InjectionToken; /** * @docs-private * @deprecated No longer used, will be removed. * @breaking-change 21.0.0 */ declare const MAT_SELECT_SCROLL_STRATEGY_PROVIDER: { provide: InjectionToken<() => ScrollStrategy>; deps: (typeof Overlay)[]; useFactory: typeof MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY; }; /** * Injection token that can be used to reference instances of `MatSelectTrigger`. It serves as * alternative token to the actual `MatSelectTrigger` class which could cause unnecessary * retention of the class and its directive metadata. */ declare const MAT_SELECT_TRIGGER: InjectionToken; /** Change event object that is emitted when the select value has changed. */ declare class MatSelectChange { /** Reference to the select that emitted the change event. */ source: MatSelect; /** Current value of the select that emitted the event. */ value: T; constructor( /** Reference to the select that emitted the change event. */ source: MatSelect, /** Current value of the select that emitted the event. */ value: T); } declare class MatSelect implements AfterContentInit, OnChanges, OnDestroy, OnInit, DoCheck, ControlValueAccessor, MatFormFieldControl { protected _viewportRuler: ViewportRuler; protected _changeDetectorRef: ChangeDetectorRef; readonly _elementRef: ElementRef; private _dir; private _idGenerator; private _renderer; protected _parentFormField: MatFormField | null; ngControl: NgControl; private _liveAnnouncer; protected _defaultOptions: MatSelectConfig | null; protected _animationsDisabled: boolean; private _initialized; private _cleanupDetach; /** All of the defined select options. */ options: QueryList; /** All of the defined groups of options. */ optionGroups: QueryList; /** User-supplied override of the trigger element. */ customTrigger: MatSelectTrigger; /** * This position config ensures that the top "start" corner of the overlay * is aligned with with the top "start" of the origin by default (overlapping * the trigger completely). If the panel cannot fit below the trigger, it * will fall back to a position above the trigger. */ _positions: ConnectedPosition[]; /** Scrolls a particular option into the view. */ _scrollOptionIntoView(index: number): void; /** Called when the panel has been opened and the overlay has settled on its final position. */ private _positioningSettled; /** Creates a change event object that should be emitted by the select. */ private _getChangeEvent; /** Factory function used to create a scroll strategy for this select. */ private _scrollStrategyFactory; /** Whether or not the overlay panel is open. */ private _panelOpen; /** Comparison function to specify which option is displayed. Defaults to object equality. */ private _compareWith; /** Unique id for this input. */ private _uid; /** Current `aria-labelledby` value for the select trigger. */ private _triggerAriaLabelledBy; /** * Keeps track of the previous form control assigned to the select. * Used to detect if it has changed. */ private _previousControl; /** Emits whenever the component is destroyed. */ protected readonly _destroy: Subject; /** Tracks the error state of the select. */ private _errorStateTracker; /** * Emits whenever the component state changes and should cause the parent * form-field to update. Implemented as part of `MatFormFieldControl`. * @docs-private */ readonly stateChanges: Subject; /** * Disable the automatic labeling to avoid issues like #27241. * @docs-private */ readonly disableAutomaticLabeling = true; /** * Implemented as part of MatFormFieldControl. * @docs-private */ userAriaDescribedBy: string; /** Deals with the selection logic. */ _selectionModel: SelectionModel; /** Manages keyboard events for options in the panel. */ _keyManager: ActiveDescendantKeyManager; /** Ideal origin for the overlay panel. */ _preferredOverlayOrigin: CdkOverlayOrigin | ElementRef | undefined; /** Width of the overlay panel. */ _overlayWidth: string | number; /** `View -> model callback called when value changes` */ _onChange: (value: any) => void; /** `View -> model callback called when select has been touched` */ _onTouched: () => void; /** ID for the DOM node containing the select's value. */ _valueId: string; /** Strategy that will be used to handle scrolling while the select panel is open. */ _scrollStrategy: ScrollStrategy; _overlayPanelClass: string | string[]; /** Whether the select is focused. */ get focused(): boolean; private _focused; /** A name for this control that can be used by `mat-form-field`. */ controlType: string; /** Trigger that opens the select. */ trigger: ElementRef; /** Panel containing the select options. */ panel: ElementRef; /** Overlay pane containing the options. */ protected _overlayDir: CdkConnectedOverlay; /** Classes to be passed to the select panel. Supports the same syntax as `ngClass`. */ panelClass: string | string[] | Set | { [key: string]: any; }; /** Whether the select is disabled. */ disabled: boolean; /** Whether ripples in the select are disabled. */ disableRipple: boolean; /** Tab index of the select. */ tabIndex: number; /** Whether checkmark indicator for single-selection options is hidden. */ get hideSingleSelectionIndicator(): boolean; set hideSingleSelectionIndicator(value: boolean); private _hideSingleSelectionIndicator; /** Placeholder to be shown if no value has been selected. */ get placeholder(): string; set placeholder(value: string); private _placeholder; /** Whether the component is required. */ get required(): boolean; set required(value: boolean); private _required; /** Whether the user should be allowed to select multiple options. */ get multiple(): boolean; set multiple(value: boolean); private _multiple; /** Whether to center the active option over the trigger. */ disableOptionCentering: boolean; /** * Function to compare the option values with the selected values. The first argument * is a value from an option. The second is a value from the selection. A boolean * should be returned. */ get compareWith(): (o1: any, o2: any) => boolean; set compareWith(fn: (o1: any, o2: any) => boolean); /** Value of the select control. */ get value(): any; set value(newValue: any); private _value; /** Aria label of the select. */ ariaLabel: string; /** Input that can be used to specify the `aria-labelledby` attribute. */ ariaLabelledby: string; /** Object used to control when error messages are shown. */ get errorStateMatcher(): ErrorStateMatcher; set errorStateMatcher(value: ErrorStateMatcher); /** Time to wait in milliseconds after the last keystroke before moving focus to an item. */ typeaheadDebounceInterval: number; /** * Function used to sort the values in a select in multiple mode. * Follows the same logic as `Array.prototype.sort`. */ sortComparator: (a: MatOption, b: MatOption, options: MatOption[]) => number; /** Unique id of the element. */ get id(): string; set id(value: string); private _id; /** Whether the select is in an error state. */ get errorState(): boolean; set errorState(value: boolean); /** * Width of the panel. If set to `auto`, the panel will match the trigger width. * If set to null or an empty string, the panel will grow to match the longest option's text. */ panelWidth: string | number | null; /** * By default selecting an option with a `null` or `undefined` value will reset the select's * value. Enable this option if the reset behavior doesn't match your requirements and instead * the nullable options should become selected. The value of this input can be controlled app-wide * using the `MAT_SELECT_CONFIG` injection token. */ canSelectNullableOptions: boolean; /** Combined stream of all of the child options' change events. */ readonly optionSelectionChanges: Observable; /** Event emitted when the select panel has been toggled. */ readonly openedChange: EventEmitter; /** Event emitted when the select has been opened. */ readonly _openedStream: Observable; /** Event emitted when the select has been closed. */ readonly _closedStream: Observable; /** Event emitted when the selected value has been changed by the user. */ readonly selectionChange: EventEmitter>; /** * Event that emits whenever the raw value of the select changes. This is here primarily * to facilitate the two-way binding for the `value` input. * @docs-private */ readonly valueChange: EventEmitter; constructor(...args: unknown[]); ngOnInit(): void; ngAfterContentInit(): void; ngDoCheck(): void; ngOnChanges(changes: SimpleChanges): void; ngOnDestroy(): void; /** Toggles the overlay panel open or closed. */ toggle(): void; /** Opens the overlay panel. */ open(): void; /** * Track which modal we have modified the `aria-owns` attribute of. When the combobox trigger is * inside an aria-modal, we apply aria-owns to the parent modal with the `id` of the options * panel. Track the modal we have changed so we can undo the changes on destroy. */ private _trackedModal; /** * If the autocomplete trigger is inside of an `aria-modal` element, connect * that modal to the options panel with `aria-owns`. * * For some browser + screen reader combinations, when navigation is inside * of an `aria-modal` element, the screen reader treats everything outside * of that modal as hidden or invisible. * * This causes a problem when the combobox trigger is _inside_ of a modal, because the * options panel is rendered _outside_ of that modal, preventing screen reader navigation * from reaching the panel. * * We can work around this issue by applying `aria-owns` to the modal with the `id` of * the options panel. This effectively communicates to assistive technology that the * options panel is part of the same interaction as the modal. * * At time of this writing, this issue is present in VoiceOver. * See https://github.com/angular/components/issues/20694 */ private _applyModalPanelOwnership; /** Clears the reference to the listbox overlay element from the modal it was added to. */ private _clearFromModal; /** Closes the overlay panel and focuses the host element. */ close(): void; /** Triggers the exit animation and detaches the overlay at the end. */ private _exitAndDetach; /** Detaches the current overlay directive. */ private _detachOverlay; /** * Sets the select's value. Part of the ControlValueAccessor interface * required to integrate with Angular's core forms API. * * @param value New value to be written to the model. */ writeValue(value: any): void; /** * Saves a callback function to be invoked when the select's value * changes from user input. Part of the ControlValueAccessor interface * required to integrate with Angular's core forms API. * * @param fn Callback to be triggered when the value changes. */ registerOnChange(fn: (value: any) => void): void; /** * Saves a callback function to be invoked when the select is blurred * by the user. Part of the ControlValueAccessor interface required * to integrate with Angular's core forms API. * * @param fn Callback to be triggered when the component has been touched. */ registerOnTouched(fn: () => {}): void; /** * Disables the select. Part of the ControlValueAccessor interface required * to integrate with Angular's core forms API. * * @param isDisabled Sets whether the component is disabled. */ setDisabledState(isDisabled: boolean): void; /** Whether or not the overlay panel is open. */ get panelOpen(): boolean; /** The currently selected option. */ get selected(): MatOption | MatOption[]; /** The value displayed in the trigger. */ get triggerValue(): string; /** Refreshes the error state of the select. */ updateErrorState(): void; /** Whether the element is in RTL mode. */ _isRtl(): boolean; /** Handles all keydown events on the select. */ _handleKeydown(event: KeyboardEvent): void; /** Handles keyboard events while the select is closed. */ private _handleClosedKeydown; /** Handles keyboard events when the selected is open. */ private _handleOpenKeydown; /** Handles keyboard events coming from the overlay. */ protected _handleOverlayKeydown(event: KeyboardEvent): void; _onFocus(): void; /** * Calls the touched callback only if the panel is closed. Otherwise, the trigger will * "blur" to the panel when it opens, causing a false positive. */ _onBlur(): void; /** Returns the theme to be used on the panel. */ _getPanelTheme(): string; /** Whether the select has a value. */ get empty(): boolean; private _initializeSelection; /** * Sets the selected option based on a value. If no option can be * found with the designated value, the select trigger is cleared. */ private _setSelectionByValue; /** * Finds and selects and option based on its value. * @returns Option that has the corresponding value. */ private _selectOptionByValue; /** Assigns a specific value to the select. Returns whether the value has changed. */ private _assignValue; private _skipPredicate; /** Gets how wide the overlay panel should be. */ private _getOverlayWidth; /** Syncs the parent state with the individual options. */ _syncParentProperties(): void; /** Sets up a key manager to listen to keyboard events on the overlay panel. */ private _initKeyManager; /** Drops current option subscriptions and IDs and resets from scratch. */ private _resetOptions; /** Invoked when an option is clicked. */ private _onSelect; /** Sorts the selected values in the selected based on their order in the panel. */ private _sortValues; /** Emits change event to set the model value. */ private _propagateChanges; /** * Highlights the selected item. If no option is selected, it will highlight * the first *enabled* option. */ private _highlightCorrectOption; /** Whether the panel is allowed to open. */ protected _canOpen(): boolean; /** Focuses the select element. */ focus(options?: FocusOptions): void; /** Gets the aria-labelledby for the select panel. */ _getPanelAriaLabelledby(): string | null; /** Determines the `aria-activedescendant` to be set on the host. */ _getAriaActiveDescendant(): string | null; /** Gets the aria-labelledby of the select component trigger. */ private _getTriggerAriaLabelledby; /** * Implemented as part of MatFormFieldControl. * @docs-private */ setDescribedByIds(ids: string[]): void; /** * Implemented as part of MatFormFieldControl. * @docs-private */ onContainerClick(): void; /** * Implemented as part of MatFormFieldControl. * @docs-private */ get shouldLabelFloat(): boolean; static ɵfac: i0.ɵɵFactoryDeclaration; static ɵcmp: i0.ɵɵComponentDeclaration; static ngAcceptInputType_disabled: unknown; static ngAcceptInputType_disableRipple: unknown; static ngAcceptInputType_tabIndex: unknown; static ngAcceptInputType_hideSingleSelectionIndicator: unknown; static ngAcceptInputType_required: unknown; static ngAcceptInputType_multiple: unknown; static ngAcceptInputType_disableOptionCentering: unknown; static ngAcceptInputType_typeaheadDebounceInterval: unknown; static ngAcceptInputType_canSelectNullableOptions: unknown; } /** * Allows the user to customize the trigger that is displayed when the select has a value. */ declare class MatSelectTrigger { static ɵfac: i0.ɵɵFactoryDeclaration; static ɵdir: i0.ɵɵDirectiveDeclaration; } declare class MatSelectModule { static ɵfac: i0.ɵɵFactoryDeclaration; static ɵmod: i0.ɵɵNgModuleDeclaration; static ɵinj: i0.ɵɵInjectorDeclaration; } export { MatSelectModule as M, MAT_SELECT_SCROLL_STRATEGY as a, MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY as b, MAT_SELECT_CONFIG as d, MAT_SELECT_SCROLL_STRATEGY_PROVIDER as e, MAT_SELECT_TRIGGER as f, MatSelectChange as g, MatSelect as h, MatSelectTrigger as i }; export type { MatSelectConfig as c };