UNPKG

@angular/material

Version:
1,146 lines (1,138 loc) 43.3 kB
/** * @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 { ActiveDescendantKeyManager } from '@angular/cdk/a11y'; import { coerceBooleanProperty } from '@angular/cdk/coercion'; import { ChangeDetectionStrategy, ChangeDetectorRef, Component, ContentChildren, ElementRef, EventEmitter, Inject, InjectionToken, Input, Output, TemplateRef, ViewChild, ViewEncapsulation, Directive, forwardRef, Host, NgZone, Optional, ViewContainerRef, NgModule } from '@angular/core'; import { MAT_OPTION_PARENT_COMPONENT, MatOptgroup, MatOption, mixinDisableRipple, _countGroupLabelsBeforeOption, _getOptionScrollPosition, MatOptionSelectionChange, MatOptionModule, MatCommonModule } from '@angular/material/core'; import { Directionality } from '@angular/cdk/bidi'; import { DOWN_ARROW, ENTER, ESCAPE, TAB, UP_ARROW } from '@angular/cdk/keycodes'; import { Overlay, OverlayConfig, OverlayModule } from '@angular/cdk/overlay'; import { _supportsShadowDom } from '@angular/cdk/platform'; import { TemplatePortal } from '@angular/cdk/portal'; import { ViewportRuler } from '@angular/cdk/scrolling'; import { DOCUMENT, CommonModule } from '@angular/common'; import { NG_VALUE_ACCESSOR } from '@angular/forms'; import { MatFormField } from '@angular/material/form-field'; import { defer, fromEvent, merge, of, Subject, Subscription } from 'rxjs'; import { delay, filter, map, switchMap, take, tap } from 'rxjs/operators'; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc */ /** * Autocomplete IDs need to be unique across components, so this counter exists outside of * the component definition. * @type {?} */ let _uniqueAutocompleteIdCounter = 0; /** * Event object that is emitted when an autocomplete option is selected. */ class MatAutocompleteSelectedEvent { /** * @param {?} source * @param {?} option */ constructor(source, option) { this.source = source; this.option = option; } } // Boilerplate for applying mixins to MatAutocomplete. /** * \@docs-private */ class MatAutocompleteBase { } /** @type {?} */ const _MatAutocompleteMixinBase = mixinDisableRipple(MatAutocompleteBase); /** * Injection token to be used to override the default options for `mat-autocomplete`. * @type {?} */ const MAT_AUTOCOMPLETE_DEFAULT_OPTIONS = new InjectionToken('mat-autocomplete-default-options', { providedIn: 'root', factory: MAT_AUTOCOMPLETE_DEFAULT_OPTIONS_FACTORY, }); /** * \@docs-private * @return {?} */ function MAT_AUTOCOMPLETE_DEFAULT_OPTIONS_FACTORY() { return { autoActiveFirstOption: false }; } class MatAutocomplete extends _MatAutocompleteMixinBase { /** * @param {?} _changeDetectorRef * @param {?} _elementRef * @param {?} defaults */ constructor(_changeDetectorRef, _elementRef, defaults) { super(); this._changeDetectorRef = _changeDetectorRef; this._elementRef = _elementRef; /** * Whether the autocomplete panel should be visible, depending on option length. */ this.showPanel = false; this._isOpen = false; /** * Function that maps an option's control value to its display value in the trigger. */ this.displayWith = null; /** * Event that is emitted whenever an option from the list is selected. */ this.optionSelected = new EventEmitter(); /** * Event that is emitted when the autocomplete panel is opened. */ this.opened = new EventEmitter(); /** * Event that is emitted when the autocomplete panel is closed. */ this.closed = new EventEmitter(); this._classList = {}; /** * Unique ID to be used by autocomplete trigger's "aria-owns" property. */ this.id = `mat-autocomplete-${_uniqueAutocompleteIdCounter++}`; this._autoActiveFirstOption = !!defaults.autoActiveFirstOption; } /** * Whether the autocomplete panel is open. * @return {?} */ get isOpen() { return this._isOpen && this.showPanel; } /** * Whether the first option should be highlighted when the autocomplete panel is opened. * Can be configured globally through the `MAT_AUTOCOMPLETE_DEFAULT_OPTIONS` token. * @return {?} */ get autoActiveFirstOption() { return this._autoActiveFirstOption; } /** * @param {?} value * @return {?} */ set autoActiveFirstOption(value) { this._autoActiveFirstOption = coerceBooleanProperty(value); } /** * Takes classes set on the host mat-autocomplete element and applies them to the panel * inside the overlay container to allow for easy styling. * @param {?} value * @return {?} */ set classList(value) { if (value && value.length) { this._classList = value.split(' ').reduce((/** * @param {?} classList * @param {?} className * @return {?} */ (classList, className) => { classList[className.trim()] = true; return classList; }), (/** @type {?} */ ({}))); } else { this._classList = {}; } this._setVisibilityClasses(this._classList); this._elementRef.nativeElement.className = ''; } /** * @return {?} */ ngAfterContentInit() { this._keyManager = new ActiveDescendantKeyManager(this.options).withWrap(); // Set the initial visibility state. this._setVisibility(); } /** * 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. * @param {?} scrollTop * @return {?} */ _setScrollTop(scrollTop) { if (this.panel) { this.panel.nativeElement.scrollTop = scrollTop; } } /** * Returns the panel's scrollTop. * @return {?} */ _getScrollTop() { return this.panel ? this.panel.nativeElement.scrollTop : 0; } /** * Panel should hide itself when the option list is empty. * @return {?} */ _setVisibility() { this.showPanel = !!this.options.length; this._setVisibilityClasses(this._classList); this._changeDetectorRef.markForCheck(); } /** * Emits the `select` event. * @param {?} option * @return {?} */ _emitSelectEvent(option) { /** @type {?} */ const event = new MatAutocompleteSelectedEvent(this, option); this.optionSelected.emit(event); } /** * Sets the autocomplete visibility classes on a classlist based on the panel is visible. * @private * @param {?} classList * @return {?} */ _setVisibilityClasses(classList) { classList['mat-autocomplete-visible'] = this.showPanel; classList['mat-autocomplete-hidden'] = !this.showPanel; } } MatAutocomplete.decorators = [ { type: Component, args: [{selector: 'mat-autocomplete', template: "<ng-template><div class=\"mat-autocomplete-panel\" role=\"listbox\" [id]=\"id\" [ngClass]=\"_classList\" #panel><ng-content></ng-content></div></ng-template>", styles: [".mat-autocomplete-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;visibility:hidden;max-width:none;max-height:256px;position:relative;width:100%;border-bottom-left-radius:4px;border-bottom-right-radius:4px}.mat-autocomplete-panel.mat-autocomplete-visible{visibility:visible}.mat-autocomplete-panel.mat-autocomplete-hidden{visibility:hidden}.mat-autocomplete-panel-above .mat-autocomplete-panel{border-radius:0;border-top-left-radius:4px;border-top-right-radius:4px}.mat-autocomplete-panel .mat-divider-horizontal{margin-top:-1px}@media (-ms-high-contrast:active){.mat-autocomplete-panel{outline:solid 1px}}"], encapsulation: ViewEncapsulation.None, changeDetection: ChangeDetectionStrategy.OnPush, exportAs: 'matAutocomplete', inputs: ['disableRipple'], host: { 'class': 'mat-autocomplete' }, providers: [ { provide: MAT_OPTION_PARENT_COMPONENT, useExisting: MatAutocomplete } ] },] }, ]; /** @nocollapse */ MatAutocomplete.ctorParameters = () => [ { type: ChangeDetectorRef }, { type: ElementRef }, { type: undefined, decorators: [{ type: Inject, args: [MAT_AUTOCOMPLETE_DEFAULT_OPTIONS,] }] } ]; MatAutocomplete.propDecorators = { template: [{ type: ViewChild, args: [TemplateRef, { static: true },] }], panel: [{ type: ViewChild, args: ['panel', { static: false },] }], options: [{ type: ContentChildren, args: [MatOption, { descendants: true },] }], optionGroups: [{ type: ContentChildren, args: [MatOptgroup,] }], displayWith: [{ type: Input }], autoActiveFirstOption: [{ type: Input }], panelWidth: [{ type: Input }], optionSelected: [{ type: Output }], opened: [{ type: Output }], closed: [{ type: Output }], classList: [{ type: Input, args: ['class',] }] }; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc */ /** * Directive applied to an element to make it usable * as a connection point for an autocomplete panel. */ class MatAutocompleteOrigin { /** * @param {?} elementRef */ constructor(elementRef) { this.elementRef = elementRef; } } MatAutocompleteOrigin.decorators = [ { type: Directive, args: [{ selector: '[matAutocompleteOrigin]', exportAs: 'matAutocompleteOrigin', },] }, ]; /** @nocollapse */ MatAutocompleteOrigin.ctorParameters = () => [ { type: ElementRef } ]; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc */ /** * The height of each autocomplete option. * @type {?} */ const AUTOCOMPLETE_OPTION_HEIGHT = 48; /** * The total height of the autocomplete panel. * @type {?} */ const AUTOCOMPLETE_PANEL_HEIGHT = 256; /** * Injection token that determines the scroll handling while the autocomplete panel is open. * @type {?} */ const MAT_AUTOCOMPLETE_SCROLL_STRATEGY = new InjectionToken('mat-autocomplete-scroll-strategy'); /** * \@docs-private * @param {?} overlay * @return {?} */ function MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY(overlay) { return (/** * @return {?} */ () => overlay.scrollStrategies.reposition()); } /** * \@docs-private * @type {?} */ const MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY_PROVIDER = { provide: MAT_AUTOCOMPLETE_SCROLL_STRATEGY, deps: [Overlay], useFactory: MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY, }; /** * Provider that allows the autocomplete to register as a ControlValueAccessor. * \@docs-private * @type {?} */ const MAT_AUTOCOMPLETE_VALUE_ACCESSOR = { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef((/** * @return {?} */ () => MatAutocompleteTrigger)), multi: true }; /** * Creates an error to be thrown when attempting to use an autocomplete trigger without a panel. * \@docs-private * @return {?} */ function getMatAutocompleteMissingPanelError() { return Error('Attempting to open an undefined instance of `mat-autocomplete`. ' + 'Make sure that the id passed to the `matAutocomplete` is correct and that ' + 'you\'re attempting to open it after the ngAfterContentInit hook.'); } class MatAutocompleteTrigger { /** * @param {?} _element * @param {?} _overlay * @param {?} _viewContainerRef * @param {?} _zone * @param {?} _changeDetectorRef * @param {?} scrollStrategy * @param {?} _dir * @param {?} _formField * @param {?} _document * @param {?=} _viewportRuler */ constructor(_element, _overlay, _viewContainerRef, _zone, _changeDetectorRef, scrollStrategy, _dir, _formField, _document, _viewportRuler) { this._element = _element; this._overlay = _overlay; this._viewContainerRef = _viewContainerRef; this._zone = _zone; this._changeDetectorRef = _changeDetectorRef; this._dir = _dir; this._formField = _formField; this._document = _document; this._viewportRuler = _viewportRuler; this._componentDestroyed = false; this._autocompleteDisabled = false; /** * Whether or not the label state is being overridden. */ this._manuallyFloatingLabel = false; /** * Subscription to viewport size changes. */ this._viewportSubscription = Subscription.EMPTY; /** * Whether the autocomplete can open the next time it is focused. Used to prevent a focused, * closed autocomplete from being reopened if the user switches to another browser tab and then * comes back. */ this._canOpenOnNextFocus = true; /** * Stream of keyboard events that can close the panel. */ this._closeKeyEventStream = new Subject(); /** * Event handler for when the window is blurred. Needs to be an * arrow function in order to preserve the context. */ this._windowBlurHandler = (/** * @return {?} */ () => { // If the user blurred the window while the autocomplete is focused, it means that it'll be // refocused when they come back. In this case we want to skip the first focus event, if the // pane was closed, in order to avoid reopening it unintentionally. this._canOpenOnNextFocus = this._document.activeElement !== this._element.nativeElement || this.panelOpen; }); /** * `View -> model callback called when value changes` */ this._onChange = (/** * @return {?} */ () => { }); /** * `View -> model callback called when autocomplete has been touched` */ this._onTouched = (/** * @return {?} */ () => { }); /** * Position of the autocomplete panel relative to the trigger element. A position of `auto` * will render the panel underneath the trigger if there is enough space for it to fit in * the viewport, otherwise the panel will be shown above it. If the position is set to * `above` or `below`, the panel will always be shown above or below the trigger. no matter * whether it fits completely in the viewport. */ this.position = 'auto'; /** * `autocomplete` attribute to be set on the input element. * \@docs-private */ this.autocompleteAttribute = 'off'; this._overlayAttached = false; /** * Stream of autocomplete option selections. */ this.optionSelections = (/** @type {?} */ (defer((/** * @return {?} */ () => { if (this.autocomplete && this.autocomplete.options) { return merge(...this.autocomplete.options.map((/** * @param {?} option * @return {?} */ option => option.onSelectionChange))); } // If there are any subscribers before `ngAfterViewInit`, the `autocomplete` will be undefined. // Return a stream that we'll replace with the real one once everything is in place. return this._zone.onStable .asObservable() .pipe(take(1), switchMap((/** * @return {?} */ () => this.optionSelections))); })))); this._scrollStrategy = scrollStrategy; } /** * Whether the autocomplete is disabled. When disabled, the element will * act as a regular input and the user won't be able to open the panel. * @return {?} */ get autocompleteDisabled() { return this._autocompleteDisabled; } /** * @param {?} value * @return {?} */ set autocompleteDisabled(value) { this._autocompleteDisabled = coerceBooleanProperty(value); } /** * @return {?} */ ngAfterViewInit() { if (typeof window !== 'undefined') { this._zone.runOutsideAngular((/** * @return {?} */ () => { window.addEventListener('blur', this._windowBlurHandler); })); if (_supportsShadowDom()) { /** @type {?} */ const element = this._element.nativeElement; /** @type {?} */ const rootNode = element.getRootNode ? element.getRootNode() : null; // We need to take the `ShadowRoot` off of `window`, because the built-in types are // incorrect. See https://github.com/Microsoft/TypeScript/issues/27929. this._isInsideShadowRoot = rootNode instanceof ((/** @type {?} */ (window))).ShadowRoot; } } } /** * @param {?} changes * @return {?} */ ngOnChanges(changes) { if (changes['position'] && this._positionStrategy) { this._setStrategyPositions(this._positionStrategy); if (this.panelOpen) { (/** @type {?} */ (this._overlayRef)).updatePosition(); } } } /** * @return {?} */ ngOnDestroy() { if (typeof window !== 'undefined') { window.removeEventListener('blur', this._windowBlurHandler); } this._viewportSubscription.unsubscribe(); this._componentDestroyed = true; this._destroyPanel(); this._closeKeyEventStream.complete(); } /** * Whether or not the autocomplete panel is open. * @return {?} */ get panelOpen() { return this._overlayAttached && this.autocomplete.showPanel; } /** * Opens the autocomplete suggestion panel. * @return {?} */ openPanel() { this._attachOverlay(); this._floatLabel(); } /** * Closes the autocomplete suggestion panel. * @return {?} */ closePanel() { this._resetLabel(); if (!this._overlayAttached) { return; } if (this.panelOpen) { // Only emit if the panel was visible. this.autocomplete.closed.emit(); } this.autocomplete._isOpen = this._overlayAttached = false; if (this._overlayRef && this._overlayRef.hasAttached()) { this._overlayRef.detach(); this._closingActionsSubscription.unsubscribe(); } // Note that in some cases this can end up being called after the component is destroyed. // Add a check to ensure that we don't try to run change detection on a destroyed view. if (!this._componentDestroyed) { // We need to trigger change detection manually, because // `fromEvent` doesn't seem to do it at the proper time. // This ensures that the label is reset when the // user clicks outside. this._changeDetectorRef.detectChanges(); } } /** * Updates the position of the autocomplete suggestion panel to ensure that it fits all options * within the viewport. * @return {?} */ updatePosition() { if (this._overlayAttached) { (/** @type {?} */ (this._overlayRef)).updatePosition(); } } /** * A stream of actions that should close the autocomplete panel, including * when an option is selected, on blur, and when TAB is pressed. * @return {?} */ get panelClosingActions() { return merge(this.optionSelections, this.autocomplete._keyManager.tabOut.pipe(filter((/** * @return {?} */ () => this._overlayAttached))), this._closeKeyEventStream, this._getOutsideClickStream(), this._overlayRef ? this._overlayRef.detachments().pipe(filter((/** * @return {?} */ () => this._overlayAttached))) : of()).pipe( // Normalize the output so we return a consistent type. map((/** * @param {?} event * @return {?} */ event => event instanceof MatOptionSelectionChange ? event : null))); } /** * The currently active option, coerced to MatOption type. * @return {?} */ get activeOption() { if (this.autocomplete && this.autocomplete._keyManager) { return this.autocomplete._keyManager.activeItem; } return null; } /** * Stream of clicks outside of the autocomplete panel. * @private * @return {?} */ _getOutsideClickStream() { return merge((/** @type {?} */ (fromEvent(this._document, 'click'))), (/** @type {?} */ (fromEvent(this._document, 'touchend')))) .pipe(filter((/** * @param {?} event * @return {?} */ event => { // If we're in the Shadow DOM, the event target will be the shadow root, so we have to // fall back to check the first element in the path of the click event. /** @type {?} */ const clickTarget = (/** @type {?} */ ((this._isInsideShadowRoot && event.composedPath ? event.composedPath()[0] : event.target))); /** @type {?} */ const formField = this._formField ? this._formField._elementRef.nativeElement : null; return this._overlayAttached && clickTarget !== this._element.nativeElement && (!formField || !formField.contains(clickTarget)) && (!!this._overlayRef && !this._overlayRef.overlayElement.contains(clickTarget)); }))); } // Implemented as part of ControlValueAccessor. /** * @param {?} value * @return {?} */ writeValue(value) { Promise.resolve(null).then((/** * @return {?} */ () => this._setTriggerValue(value))); } // Implemented as part of ControlValueAccessor. /** * @param {?} fn * @return {?} */ registerOnChange(fn) { this._onChange = fn; } // Implemented as part of ControlValueAccessor. /** * @param {?} fn * @return {?} */ registerOnTouched(fn) { this._onTouched = fn; } // Implemented as part of ControlValueAccessor. /** * @param {?} isDisabled * @return {?} */ setDisabledState(isDisabled) { this._element.nativeElement.disabled = isDisabled; } /** * @param {?} event * @return {?} */ _handleKeydown(event) { /** @type {?} */ const keyCode = event.keyCode; // Prevent the default action on all escape key presses. This is here primarily to bring IE // in line with other browsers. By default, pressing escape on IE will cause it to revert // the input value to the one that it had on focus, however it won't dispatch any events // which means that the model value will be out of sync with the view. if (keyCode === ESCAPE) { event.preventDefault(); } if (this.activeOption && keyCode === ENTER && this.panelOpen) { this.activeOption._selectViaInteraction(); this._resetActiveItem(); event.preventDefault(); } else if (this.autocomplete) { /** @type {?} */ const prevActiveItem = this.autocomplete._keyManager.activeItem; /** @type {?} */ const isArrowKey = keyCode === UP_ARROW || keyCode === DOWN_ARROW; if (this.panelOpen || keyCode === TAB) { this.autocomplete._keyManager.onKeydown(event); } else if (isArrowKey && this._canOpen()) { this.openPanel(); } if (isArrowKey || this.autocomplete._keyManager.activeItem !== prevActiveItem) { this._scrollToOption(); } } } /** * @param {?} event * @return {?} */ _handleInput(event) { /** @type {?} */ let target = (/** @type {?} */ (event.target)); /** @type {?} */ let value = target.value; // Based on `NumberValueAccessor` from forms. if (target.type === 'number') { value = value == '' ? null : parseFloat(value); } // If the input has a placeholder, IE will fire the `input` event on page load, // focus and blur, in addition to when the user actually changed the value. To // filter out all of the extra events, we save the value on focus and between // `input` events, and we check whether it changed. // See: https://connect.microsoft.com/IE/feedback/details/885747/ if (this._previousValue !== value) { this._previousValue = value; this._onChange(value); if (this._canOpen() && this._document.activeElement === event.target) { this.openPanel(); } } } /** * @return {?} */ _handleFocus() { if (!this._canOpenOnNextFocus) { this._canOpenOnNextFocus = true; } else if (this._canOpen()) { this._previousValue = this._element.nativeElement.value; this._attachOverlay(); this._floatLabel(true); } } /** * In "auto" mode, the label will animate down as soon as focus is lost. * This causes the value to jump when selecting an option with the mouse. * This method manually floats the label until the panel can be closed. * @private * @param {?=} shouldAnimate Whether the label should be animated when it is floated. * @return {?} */ _floatLabel(shouldAnimate = false) { if (this._formField && this._formField.floatLabel === 'auto') { if (shouldAnimate) { this._formField._animateAndLockLabel(); } else { this._formField.floatLabel = 'always'; } this._manuallyFloatingLabel = true; } } /** * If the label has been manually elevated, return it to its normal state. * @private * @return {?} */ _resetLabel() { if (this._manuallyFloatingLabel) { this._formField.floatLabel = 'auto'; this._manuallyFloatingLabel = false; } } /** * Given that we are not actually focusing active options, we must manually adjust scroll * to reveal options below the fold. First, we find the offset of the option from the top * of the panel. If that offset is below the fold, the new scrollTop will be the offset - * the panel height + the option height, so the active option will be just visible at the * bottom of the panel. If that offset is above the top of the visible panel, the new scrollTop * will become the offset. If that offset is visible within the panel already, the scrollTop is * not adjusted. * @private * @return {?} */ _scrollToOption() { /** @type {?} */ const index = this.autocomplete._keyManager.activeItemIndex || 0; /** @type {?} */ const labelCount = _countGroupLabelsBeforeOption(index, this.autocomplete.options, this.autocomplete.optionGroups); if (index === 0 && labelCount === 1) { // If we've got one group label before the option and we're at the top option, // scroll the list to the top. This is better UX than scrolling the list to the // top of the option, because it allows the user to read the top group's label. this.autocomplete._setScrollTop(0); } else { /** @type {?} */ const newScrollPosition = _getOptionScrollPosition(index + labelCount, AUTOCOMPLETE_OPTION_HEIGHT, this.autocomplete._getScrollTop(), AUTOCOMPLETE_PANEL_HEIGHT); this.autocomplete._setScrollTop(newScrollPosition); } } /** * This method listens to a stream of panel closing actions and resets the * stream every time the option list changes. * @private * @return {?} */ _subscribeToClosingActions() { /** @type {?} */ const firstStable = this._zone.onStable.asObservable().pipe(take(1)); /** @type {?} */ const optionChanges = this.autocomplete.options.changes.pipe(tap((/** * @return {?} */ () => this._positionStrategy.reapplyLastPosition())), // Defer emitting to the stream until the next tick, because changing // bindings in here will cause "changed after checked" errors. delay(0)); // When the zone is stable initially, and when the option list changes... return merge(firstStable, optionChanges) .pipe( // create a new stream of panelClosingActions, replacing any previous streams // that were created, and flatten it so our stream only emits closing events... switchMap((/** * @return {?} */ () => { /** @type {?} */ const wasOpen = this.panelOpen; this._resetActiveItem(); this.autocomplete._setVisibility(); if (this.panelOpen) { (/** @type {?} */ (this._overlayRef)).updatePosition(); // If the `panelOpen` state changed, we need to make sure to emit the `opened` // event, because we may not have emitted it when the panel was attached. This // can happen if the users opens the panel and there are no options, but the // options come in slightly later or as a result of the value changing. if (wasOpen !== this.panelOpen) { this.autocomplete.opened.emit(); } } return this.panelClosingActions; })), // when the first closing event occurs... take(1)) // set the value, close the panel, and complete. .subscribe((/** * @param {?} event * @return {?} */ event => this._setValueAndClose(event))); } /** * Destroys the autocomplete suggestion panel. * @private * @return {?} */ _destroyPanel() { if (this._overlayRef) { this.closePanel(); this._overlayRef.dispose(); this._overlayRef = null; } } /** * @private * @param {?} value * @return {?} */ _setTriggerValue(value) { /** @type {?} */ const toDisplay = this.autocomplete && this.autocomplete.displayWith ? this.autocomplete.displayWith(value) : value; // Simply falling back to an empty string if the display value is falsy does not work properly. // The display value can also be the number zero and shouldn't fall back to an empty string. /** @type {?} */ const inputValue = toDisplay != null ? toDisplay : ''; // If it's used within a `MatFormField`, we should set it through the property so it can go // through change detection. if (this._formField) { this._formField._control.value = inputValue; } else { this._element.nativeElement.value = inputValue; } this._previousValue = inputValue; } /** * This method closes the panel, and if a value is specified, also sets the associated * control to that value. It will also mark the control as dirty if this interaction * stemmed from the user. * @private * @param {?} event * @return {?} */ _setValueAndClose(event) { if (event && event.source) { this._clearPreviousSelectedOption(event.source); this._setTriggerValue(event.source.value); this._onChange(event.source.value); this._element.nativeElement.focus(); this.autocomplete._emitSelectEvent(event.source); } this.closePanel(); } /** * Clear any previous selected option and emit a selection change event for this option * @private * @param {?} skip * @return {?} */ _clearPreviousSelectedOption(skip) { this.autocomplete.options.forEach((/** * @param {?} option * @return {?} */ option => { if (option != skip && option.selected) { option.deselect(); } })); } /** * @private * @return {?} */ _attachOverlay() { if (!this.autocomplete) { throw getMatAutocompleteMissingPanelError(); } /** @type {?} */ let overlayRef = this._overlayRef; if (!overlayRef) { this._portal = new TemplatePortal(this.autocomplete.template, this._viewContainerRef); overlayRef = this._overlay.create(this._getOverlayConfig()); this._overlayRef = overlayRef; // Use the `keydownEvents` in order to take advantage of // the overlay event targeting provided by the CDK overlay. overlayRef.keydownEvents().subscribe((/** * @param {?} event * @return {?} */ event => { // Close when pressing ESCAPE or ALT + UP_ARROW, based on the a11y guidelines. // See: https://www.w3.org/TR/wai-aria-practices-1.1/#textbox-keyboard-interaction if (event.keyCode === ESCAPE || (event.keyCode === UP_ARROW && event.altKey)) { this._resetActiveItem(); this._closeKeyEventStream.next(); // We need to stop propagation, otherwise the event will eventually // reach the input itself and cause the overlay to be reopened. event.stopPropagation(); event.preventDefault(); } })); if (this._viewportRuler) { this._viewportSubscription = this._viewportRuler.change().subscribe((/** * @return {?} */ () => { if (this.panelOpen && overlayRef) { overlayRef.updateSize({ width: this._getPanelWidth() }); } })); } } else { // Update the trigger, panel width and direction, in case anything has changed. this._positionStrategy.setOrigin(this._getConnectedElement()); overlayRef.updateSize({ width: this._getPanelWidth() }); } if (overlayRef && !overlayRef.hasAttached()) { overlayRef.attach(this._portal); this._closingActionsSubscription = this._subscribeToClosingActions(); } /** @type {?} */ const wasOpen = this.panelOpen; this.autocomplete._setVisibility(); this.autocomplete._isOpen = this._overlayAttached = true; // We need to do an extra `panelOpen` check in here, because the // autocomplete won't be shown if there are no options. if (this.panelOpen && wasOpen !== this.panelOpen) { this.autocomplete.opened.emit(); } } /** * @private * @return {?} */ _getOverlayConfig() { return new OverlayConfig({ positionStrategy: this._getOverlayPosition(), scrollStrategy: this._scrollStrategy(), width: this._getPanelWidth(), direction: this._dir }); } /** * @private * @return {?} */ _getOverlayPosition() { /** @type {?} */ const strategy = this._overlay.position() .flexibleConnectedTo(this._getConnectedElement()) .withFlexibleDimensions(false) .withPush(false); this._setStrategyPositions(strategy); this._positionStrategy = strategy; return strategy; } /** * Sets the positions on a position strategy based on the directive's input state. * @private * @param {?} positionStrategy * @return {?} */ _setStrategyPositions(positionStrategy) { /** @type {?} */ const belowPosition = { originX: 'start', originY: 'bottom', overlayX: 'start', overlayY: 'top' }; /** @type {?} */ const abovePosition = { originX: 'start', originY: 'top', overlayX: 'start', overlayY: 'bottom', // The overlay edge connected to the trigger should have squared corners, while // the opposite end has rounded corners. We apply a CSS class to swap the // border-radius based on the overlay position. panelClass: 'mat-autocomplete-panel-above' }; /** @type {?} */ let positions; if (this.position === 'above') { positions = [abovePosition]; } else if (this.position === 'below') { positions = [belowPosition]; } else { positions = [belowPosition, abovePosition]; } positionStrategy.withPositions(positions); } /** * @private * @return {?} */ _getConnectedElement() { if (this.connectedTo) { return this.connectedTo.elementRef; } return this._formField ? this._formField.getConnectedOverlayOrigin() : this._element; } /** * @private * @return {?} */ _getPanelWidth() { return this.autocomplete.panelWidth || this._getHostWidth(); } /** * Returns the width of the input element, so the panel width can match it. * @private * @return {?} */ _getHostWidth() { return this._getConnectedElement().nativeElement.getBoundingClientRect().width; } /** * Resets the active item to -1 so arrow events will activate the * correct options, or to 0 if the consumer opted into it. * @private * @return {?} */ _resetActiveItem() { this.autocomplete._keyManager.setActiveItem(this.autocomplete.autoActiveFirstOption ? 0 : -1); } /** * Determines whether the panel can be opened. * @private * @return {?} */ _canOpen() { /** @type {?} */ const element = this._element.nativeElement; return !element.readOnly && !element.disabled && !this._autocompleteDisabled; } } MatAutocompleteTrigger.decorators = [ { type: Directive, args: [{ selector: `input[matAutocomplete], textarea[matAutocomplete]`, host: { 'class': 'mat-autocomplete-trigger', '[attr.autocomplete]': 'autocompleteAttribute', '[attr.role]': 'autocompleteDisabled ? null : "combobox"', '[attr.aria-autocomplete]': 'autocompleteDisabled ? null : "list"', '[attr.aria-activedescendant]': '(panelOpen && activeOption) ? activeOption.id : null', '[attr.aria-expanded]': 'autocompleteDisabled ? null : panelOpen.toString()', '[attr.aria-owns]': '(autocompleteDisabled || !panelOpen) ? null : autocomplete?.id', '[attr.aria-haspopup]': '!autocompleteDisabled', // Note: we use `focusin`, as opposed to `focus`, in order to open the panel // a little earlier. This avoids issues where IE delays the focusing of the input. '(focusin)': '_handleFocus()', '(blur)': '_onTouched()', '(input)': '_handleInput($event)', '(keydown)': '_handleKeydown($event)', }, exportAs: 'matAutocompleteTrigger', providers: [MAT_AUTOCOMPLETE_VALUE_ACCESSOR] },] }, ]; /** @nocollapse */ MatAutocompleteTrigger.ctorParameters = () => [ { type: ElementRef }, { type: Overlay }, { type: ViewContainerRef }, { type: NgZone }, { type: ChangeDetectorRef }, { type: undefined, decorators: [{ type: Inject, args: [MAT_AUTOCOMPLETE_SCROLL_STRATEGY,] }] }, { type: Directionality, decorators: [{ type: Optional }] }, { type: MatFormField, decorators: [{ type: Optional }, { type: Host }] }, { type: undefined, decorators: [{ type: Optional }, { type: Inject, args: [DOCUMENT,] }] }, { type: ViewportRuler } ]; MatAutocompleteTrigger.propDecorators = { autocomplete: [{ type: Input, args: ['matAutocomplete',] }], position: [{ type: Input, args: ['matAutocompletePosition',] }], connectedTo: [{ type: Input, args: ['matAutocompleteConnectedTo',] }], autocompleteAttribute: [{ type: Input, args: ['autocomplete',] }], autocompleteDisabled: [{ type: Input, args: ['matAutocompleteDisabled',] }] }; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc */ class MatAutocompleteModule { } MatAutocompleteModule.decorators = [ { type: NgModule, args: [{ imports: [MatOptionModule, OverlayModule, MatCommonModule, CommonModule], exports: [ MatAutocomplete, MatOptionModule, MatAutocompleteTrigger, MatAutocompleteOrigin, MatCommonModule ], declarations: [MatAutocomplete, MatAutocompleteTrigger, MatAutocompleteOrigin], providers: [MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY_PROVIDER], },] }, ]; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc */ /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc */ export { MAT_AUTOCOMPLETE_DEFAULT_OPTIONS_FACTORY, MatAutocompleteSelectedEvent, MAT_AUTOCOMPLETE_DEFAULT_OPTIONS, MatAutocomplete, MatAutocompleteModule, MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY, getMatAutocompleteMissingPanelError, AUTOCOMPLETE_OPTION_HEIGHT, AUTOCOMPLETE_PANEL_HEIGHT, MAT_AUTOCOMPLETE_SCROLL_STRATEGY, MAT_AUTOCOMPLETE_SCROLL_STRATEGY_FACTORY_PROVIDER, MAT_AUTOCOMPLETE_VALUE_ACCESSOR, MatAutocompleteTrigger, MatAutocompleteOrigin }; //# sourceMappingURL=autocomplete.js.map