@angular/material
Version:
Angular Material
86 lines (85 loc) • 3.94 kB
TypeScript
/**
* @license
* Copyright Google LLC All Rights Reserved.
*
* Use of this source code is governed by an MIT-style license that can be
* found in the LICENSE file at https://angular.io/license
*/
import { AfterContentInit, ElementRef, QueryList, TemplateRef, ChangeDetectorRef, EventEmitter, InjectionToken } from '@angular/core';
import { MatOption, MatOptgroup, CanDisableRipple } from '@angular/material/core';
import { ActiveDescendantKeyManager } from '@angular/cdk/a11y';
/** Event object that is emitted when an autocomplete option is selected. */
export declare class MatAutocompleteSelectedEvent {
/** Reference to the autocomplete panel that emitted the event. */
source: MatAutocomplete;
/** Option that was selected. */
option: MatOption;
constructor(
/** Reference to the autocomplete panel that emitted the event. */
source: MatAutocomplete,
/** Option that was selected. */
option: MatOption);
}
/** @docs-private */
export declare class MatAutocompleteBase {
}
export declare const _MatAutocompleteMixinBase: (new (...args: any[]) => CanDisableRipple) & typeof MatAutocompleteBase;
/** Default `mat-autocomplete` options that can be overridden. */
export interface MatAutocompleteDefaultOptions {
/** Whether the first option should be highlighted when an autocomplete panel is opened. */
autoActiveFirstOption?: boolean;
}
/** Injection token to be used to override the default options for `mat-autocomplete`. */
export declare const MAT_AUTOCOMPLETE_DEFAULT_OPTIONS: InjectionToken<MatAutocompleteDefaultOptions>;
export declare class MatAutocomplete extends _MatAutocompleteMixinBase implements AfterContentInit, CanDisableRipple {
private _changeDetectorRef;
private _elementRef;
/** Manages active item in option list based on key events. */
_keyManager: ActiveDescendantKeyManager<MatOption>;
/** Whether the autocomplete panel should be visible, depending on option length. */
showPanel: boolean;
/** Whether the autocomplete panel is open. */
readonly isOpen: boolean;
_isOpen: boolean;
/** @docs-private */
template: TemplateRef<any>;
/** Element for the panel containing the autocomplete options. */
panel: ElementRef;
/** @docs-private */
options: QueryList<MatOption>;
/** @docs-private */
optionGroups: QueryList<MatOptgroup>;
/** Function that maps an option's control value to its display value in the trigger. */
displayWith: ((value: any) => string) | null;
/**
* Whether the first option should be highlighted when the autocomplete panel is opened.
* Can be configured globally through the `MAT_AUTOCOMPLETE_DEFAULT_OPTIONS` token.
*/
autoActiveFirstOption: boolean;
private _autoActiveFirstOption;
/** Event that is emitted whenever an option from the list is selected. */
readonly optionSelected: EventEmitter<MatAutocompleteSelectedEvent>;
/**
* Takes classes set on the host mat-autocomplete element and applies them to the panel
* inside the overlay container to allow for easy styling.
*/
classList: string;
_classList: {
[key: string]: boolean;
};
/** Unique ID to be used by autocomplete trigger's "aria-owns" property. */
id: string;
constructor(_changeDetectorRef: ChangeDetectorRef, _elementRef: ElementRef, defaults?: MatAutocompleteDefaultOptions);
ngAfterContentInit(): void;
/**
* Sets the panel scrollTop. This allows us to manually scroll to display options
* above or below the fold, as they are not actually being focused when active.
*/
_setScrollTop(scrollTop: number): void;
/** Returns the panel's scrollTop. */
_getScrollTop(): number;
/** Panel should hide itself when the option list is empty. */
_setVisibility(): void;
/** Emits the `select` event. */
_emitSelectEvent(option: MatOption): void;
}