blob: 0346802767becd142a1061770bbe7b098df43321 [file] [log] [blame]
/**
* @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
*/
(function (global, factory) {
typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/animations'), require('@angular/cdk/a11y'), require('@angular/cdk/bidi'), require('@angular/cdk/coercion'), require('@angular/cdk/collections'), require('@angular/cdk/keycodes'), require('@angular/cdk/overlay'), require('@angular/cdk/scrolling'), require('@angular/core'), require('@angular/forms'), require('@angular/material/core'), require('@angular/material/form-field'), require('rxjs'), require('rxjs/operators'), require('@angular/common')) :
typeof define === 'function' && define.amd ? define('@angular/material/select', ['exports', '@angular/animations', '@angular/cdk/a11y', '@angular/cdk/bidi', '@angular/cdk/coercion', '@angular/cdk/collections', '@angular/cdk/keycodes', '@angular/cdk/overlay', '@angular/cdk/scrolling', '@angular/core', '@angular/forms', '@angular/material/core', '@angular/material/form-field', 'rxjs', 'rxjs/operators', '@angular/common'], factory) :
(factory((global.ng = global.ng || {}, global.ng.material = global.ng.material || {}, global.ng.material.select = {}),global.ng.animations,global.ng.cdk.a11y,global.ng.cdk.bidi,global.ng.cdk.coercion,global.ng.cdk.collections,global.ng.cdk.keycodes,global.ng.cdk.overlay,global.ng.cdk.scrolling,global.ng.core,global.ng.forms,global.ng.material.core,global.ng.material.formField,global.rxjs,global.rxjs.operators,global.ng.common));
}(this, (function (exports,animations,a11y,bidi,coercion,collections,keycodes,overlay,scrolling,core,forms,core$1,formField,rxjs,operators,common) { 'use strict';
/*! *****************************************************************************
Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at http://www.apache.org/licenses/LICENSE-2.0
THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
MERCHANTABLITY OR NON-INFRINGEMENT.
See the Apache Version 2.0 License for specific language governing permissions
and limitations under the License.
***************************************************************************** */
/* global Reflect, Promise */
var extendStatics = function(d, b) {
extendStatics = Object.setPrototypeOf ||
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
return extendStatics(d, b);
};
function __extends(d, b) {
extendStatics(d, b);
function __() { this.constructor = d; }
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* The following are all the animations for the mat-select component, with each
* const containing the metadata for one animation.
*
* The values below match the implementation of the AngularJS Material mat-select animation.
* \@docs-private
* @type {?}
*/
var matSelectAnimations = {
/**
* This animation ensures the select's overlay panel animation (transformPanel) is called when
* closing the select.
* This is needed due to https://github.com/angular/angular/issues/23302
*/
transformPanelWrap: animations.trigger('transformPanelWrap', [
animations.transition('* => void', animations.query('@transformPanel', [animations.animateChild()], { optional: true }))
]),
/**
* This animation transforms the select's overlay panel on and off the page.
*
* When the panel is attached to the DOM, it expands its width by the amount of padding, scales it
* up to 100% on the Y axis, fades in its border, and translates slightly up and to the
* side to ensure the option text correctly overlaps the trigger text.
*
* When the panel is removed from the DOM, it simply fades out linearly.
*/
transformPanel: animations.trigger('transformPanel', [
animations.state('void', animations.style({
transform: 'scaleY(0.8)',
minWidth: '100%',
opacity: 0
})),
animations.state('showing', animations.style({
opacity: 1,
minWidth: 'calc(100% + 32px)',
// 32px = 2 * 16px padding
transform: 'scaleY(1)'
})),
animations.state('showing-multiple', animations.style({
opacity: 1,
minWidth: 'calc(100% + 64px)',
// 64px = 48px padding on the left + 16px padding on the right
transform: 'scaleY(1)'
})),
animations.transition('void => *', animations.animate('120ms cubic-bezier(0, 0, 0.2, 1)')),
animations.transition('* => void', animations.animate('100ms 25ms linear', animations.style({ opacity: 0 })))
]),
/**
* This animation fades in the background color and text content of the
* select's options. It is time delayed to occur 100ms after the overlay
* panel has transformed in.
* @deprecated Not used anymore. To be removed.
* \@breaking-change 8.0.0
*/
fadeInContent: animations.trigger('fadeInContent', [
animations.state('showing', animations.style({ opacity: 1 })),
animations.transition('void => showing', [
animations.style({ opacity: 0 }),
animations.animate('150ms 100ms cubic-bezier(0.55, 0, 0.55, 0.2)')
])
])
};
/**
* @deprecated
* \@breaking-change 8.0.0
* \@docs-private
* @type {?}
*/
var transformPanel = matSelectAnimations.transformPanel;
/**
* @deprecated
* \@breaking-change 8.0.0
* \@docs-private
* @type {?}
*/
var fadeInContent = matSelectAnimations.fadeInContent;
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Returns an exception to be thrown when attempting to change a select's `multiple` option
* after initialization.
* \@docs-private
* @return {?}
*/
function getMatSelectDynamicMultipleError() {
return Error('Cannot change `multiple` mode of select after initialization.');
}
/**
* Returns an exception to be thrown when attempting to assign a non-array value to a select
* in `multiple` mode. Note that `undefined` and `null` are still valid values to allow for
* resetting the value.
* \@docs-private
* @return {?}
*/
function getMatSelectNonArrayValueError() {
return Error('Value must be an array in multiple-selection mode.');
}
/**
* Returns an exception to be thrown when assigning a non-function value to the comparator
* used to determine if a value corresponds to an option. Note that whether the function
* actually takes two values and returns a boolean is not checked.
* @return {?}
*/
function getMatSelectNonFunctionValueError() {
return Error('`compareWith` must be a function.');
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/** @type {?} */
var nextUniqueId = 0;
/**
* The max height of the select's overlay panel
* @type {?}
*/
var SELECT_PANEL_MAX_HEIGHT = 256;
/**
* The panel's padding on the x-axis
* @type {?}
*/
var SELECT_PANEL_PADDING_X = 16;
/**
* The panel's x axis padding if it is indented (e.g. there is an option group).
* @type {?}
*/
var SELECT_PANEL_INDENT_PADDING_X = SELECT_PANEL_PADDING_X * 2;
/**
* The height of the select items in `em` units.
* @type {?}
*/
var SELECT_ITEM_HEIGHT_EM = 3;
// TODO(josephperrott): Revert to a constant after 2018 spec updates are fully merged.
/**
* Distance between the panel edge and the option text in
* multi-selection mode.
*
* Calculated as:
* (SELECT_PANEL_PADDING_X * 1.5) + 20 = 44
* The padding is multiplied by 1.5 because the checkbox's margin is half the padding.
* The checkbox width is 16px.
* @type {?}
*/
exports.SELECT_MULTIPLE_PANEL_PADDING_X = 0;
/**
* The select panel will only "fit" inside the viewport if it is positioned at
* this value or more away from the viewport boundary.
* @type {?}
*/
var SELECT_PANEL_VIEWPORT_PADDING = 8;
/**
* Injection token that determines the scroll handling while a select is open.
* @type {?}
*/
var MAT_SELECT_SCROLL_STRATEGY = new core.InjectionToken('mat-select-scroll-strategy');
/**
* \@docs-private
* @param {?} overlay
* @return {?}
*/
function MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay$$1) {
return (/**
* @return {?}
*/
function () { return overlay$$1.scrollStrategies.reposition(); });
}
/**
* \@docs-private
* @type {?}
*/
var MAT_SELECT_SCROLL_STRATEGY_PROVIDER = {
provide: MAT_SELECT_SCROLL_STRATEGY,
deps: [overlay.Overlay],
useFactory: MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY,
};
/**
* Change event object that is emitted when the select value has changed.
*/
var /**
* Change event object that is emitted when the select value has changed.
*/
MatSelectChange = /** @class */ (function () {
function MatSelectChange(source, value) {
this.source = source;
this.value = value;
}
return MatSelectChange;
}());
// Boilerplate for applying mixins to MatSelect.
/**
* \@docs-private
*/
var
// Boilerplate for applying mixins to MatSelect.
/**
* \@docs-private
*/
MatSelectBase = /** @class */ (function () {
function MatSelectBase(_elementRef, _defaultErrorStateMatcher, _parentForm, _parentFormGroup, ngControl) {
this._elementRef = _elementRef;
this._defaultErrorStateMatcher = _defaultErrorStateMatcher;
this._parentForm = _parentForm;
this._parentFormGroup = _parentFormGroup;
this.ngControl = ngControl;
}
return MatSelectBase;
}());
/** @type {?} */
var _MatSelectMixinBase = core$1.mixinDisableRipple(core$1.mixinTabIndex(core$1.mixinDisabled(core$1.mixinErrorState(MatSelectBase))));
/**
* Allows the user to customize the trigger that is displayed when the select has a value.
*/
var MatSelectTrigger = /** @class */ (function () {
function MatSelectTrigger() {
}
MatSelectTrigger.decorators = [
{ type: core.Directive, args: [{
selector: 'mat-select-trigger'
},] },
];
return MatSelectTrigger;
}());
var MatSelect = /** @class */ (function (_super) {
__extends(MatSelect, _super);
function MatSelect(_viewportRuler, _changeDetectorRef, _ngZone, _defaultErrorStateMatcher, elementRef, _dir, _parentForm, _parentFormGroup, _parentFormField, ngControl, tabIndex, scrollStrategyFactory, _liveAnnouncer) {
var _this = _super.call(this, elementRef, _defaultErrorStateMatcher, _parentForm, _parentFormGroup, ngControl) || this;
_this._viewportRuler = _viewportRuler;
_this._changeDetectorRef = _changeDetectorRef;
_this._ngZone = _ngZone;
_this._dir = _dir;
_this._parentFormField = _parentFormField;
_this.ngControl = ngControl;
_this._liveAnnouncer = _liveAnnouncer;
/**
* Whether or not the overlay panel is open.
*/
_this._panelOpen = false;
/**
* Whether filling out the select is required in the form.
*/
_this._required = false;
/**
* The scroll position of the overlay panel, calculated to center the selected option.
*/
_this._scrollTop = 0;
/**
* Whether the component is in multiple selection mode.
*/
_this._multiple = false;
/**
* Comparison function to specify which option is displayed. Defaults to object equality.
*/
_this._compareWith = (/**
* @param {?} o1
* @param {?} o2
* @return {?}
*/
function (o1, o2) { return o1 === o2; });
/**
* Unique id for this input.
*/
_this._uid = "mat-select-" + nextUniqueId++;
/**
* Emits whenever the component is destroyed.
*/
_this._destroy = new rxjs.Subject();
/**
* The cached font-size of the trigger element.
*/
_this._triggerFontSize = 0;
/**
* `View -> model callback called when value changes`
*/
_this._onChange = (/**
* @return {?}
*/
function () { });
/**
* `View -> model callback called when select has been touched`
*/
_this._onTouched = (/**
* @return {?}
*/
function () { });
/**
* The IDs of child options to be passed to the aria-owns attribute.
*/
_this._optionIds = '';
/**
* The value of the select panel's transform-origin property.
*/
_this._transformOrigin = 'top';
/**
* Emits when the panel element is finished transforming in.
*/
_this._panelDoneAnimatingStream = new rxjs.Subject();
/**
* The y-offset of the overlay panel in relation to the trigger's top start corner.
* This must be adjusted to align the selected option text over the trigger text.
* when the panel opens. Will change based on the y-position of the selected option.
*/
_this._offsetY = 0;
/**
* 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.
*/
_this._positions = [
{
originX: 'start',
originY: 'top',
overlayX: 'start',
overlayY: 'top',
},
{
originX: 'start',
originY: 'bottom',
overlayX: 'start',
overlayY: 'bottom',
},
];
/**
* Whether the component is disabling centering of the active option over the trigger.
*/
_this._disableOptionCentering = false;
_this._focused = false;
/**
* A name for this control that can be used by `mat-form-field`.
*/
_this.controlType = 'mat-select';
/**
* Aria label of the select. If not specified, the placeholder will be used as label.
*/
_this.ariaLabel = '';
/**
* Combined stream of all of the child options' change events.
*/
_this.optionSelectionChanges = (/** @type {?} */ (rxjs.defer((/**
* @return {?}
*/
function () {
/** @type {?} */
var options = _this.options;
if (options) {
return options.changes.pipe(operators.startWith(options), operators.switchMap((/**
* @return {?}
*/
function () { return rxjs.merge.apply(void 0, options.map((/**
* @param {?} option
* @return {?}
*/
function (option) { return option.onSelectionChange; }))); })));
}
return _this._ngZone.onStable
.asObservable()
.pipe(operators.take(1), operators.switchMap((/**
* @return {?}
*/
function () { return _this.optionSelectionChanges; })));
}))));
/**
* Event emitted when the select panel has been toggled.
*/
_this.openedChange = new core.EventEmitter();
/**
* Event emitted when the select has been opened.
*/
_this._openedStream = _this.openedChange.pipe(operators.filter((/**
* @param {?} o
* @return {?}
*/
function (o) { return o; })), operators.map((/**
* @return {?}
*/
function () { })));
/**
* Event emitted when the select has been closed.
*/
_this._closedStream = _this.openedChange.pipe(operators.filter((/**
* @param {?} o
* @return {?}
*/
function (o) { return !o; })), operators.map((/**
* @return {?}
*/
function () { })));
/**
* Event emitted when the selected value has been changed by the user.
*/
_this.selectionChange = new core.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
*/
_this.valueChange = new core.EventEmitter();
if (_this.ngControl) {
// Note: we provide the value accessor through here, instead of
// the `providers` to avoid running into a circular import.
_this.ngControl.valueAccessor = _this;
}
_this._scrollStrategyFactory = scrollStrategyFactory;
_this._scrollStrategy = _this._scrollStrategyFactory();
_this.tabIndex = parseInt(tabIndex) || 0;
// Force setter to be called in case id was not specified.
_this.id = _this.id;
return _this;
}
Object.defineProperty(MatSelect.prototype, "focused", {
/** Whether the select is focused. */
get: /**
* Whether the select is focused.
* @return {?}
*/
function () {
return this._focused || this._panelOpen;
},
/**
* @deprecated Setter to be removed as this property is intended to be readonly.
* @breaking-change 8.0.0
*/
set: /**
* @deprecated Setter to be removed as this property is intended to be readonly.
* \@breaking-change 8.0.0
* @param {?} value
* @return {?}
*/
function (value) {
this._focused = value;
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "placeholder", {
/** Placeholder to be shown if no value has been selected. */
get: /**
* Placeholder to be shown if no value has been selected.
* @return {?}
*/
function () { return this._placeholder; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._placeholder = value;
this.stateChanges.next();
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "required", {
/** Whether the component is required. */
get: /**
* Whether the component is required.
* @return {?}
*/
function () { return this._required; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._required = coercion.coerceBooleanProperty(value);
this.stateChanges.next();
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "multiple", {
/** Whether the user should be allowed to select multiple options. */
get: /**
* Whether the user should be allowed to select multiple options.
* @return {?}
*/
function () { return this._multiple; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
if (this._selectionModel) {
throw getMatSelectDynamicMultipleError();
}
this._multiple = coercion.coerceBooleanProperty(value);
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "disableOptionCentering", {
/** Whether to center the active option over the trigger. */
get: /**
* Whether to center the active option over the trigger.
* @return {?}
*/
function () { return this._disableOptionCentering; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._disableOptionCentering = coercion.coerceBooleanProperty(value);
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "compareWith", {
/**
* 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: /**
* 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.
* @return {?}
*/
function () { return this._compareWith; },
set: /**
* @param {?} fn
* @return {?}
*/
function (fn) {
if (typeof fn !== 'function') {
throw getMatSelectNonFunctionValueError();
}
this._compareWith = fn;
if (this._selectionModel) {
// A different comparator means the selection could change.
this._initializeSelection();
}
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "value", {
/** Value of the select control. */
get: /**
* Value of the select control.
* @return {?}
*/
function () { return this._value; },
set: /**
* @param {?} newValue
* @return {?}
*/
function (newValue) {
if (newValue !== this._value) {
this.writeValue(newValue);
this._value = newValue;
}
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "id", {
/** Unique id of the element. */
get: /**
* Unique id of the element.
* @return {?}
*/
function () { return this._id; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._id = value || this._uid;
this.stateChanges.next();
},
enumerable: true,
configurable: true
});
/**
* @return {?}
*/
MatSelect.prototype.ngOnInit = /**
* @return {?}
*/
function () {
var _this = this;
this._selectionModel = new collections.SelectionModel(this.multiple);
this.stateChanges.next();
// We need `distinctUntilChanged` here, because some browsers will
// fire the animation end event twice for the same animation. See:
// https://github.com/angular/angular/issues/24084
this._panelDoneAnimatingStream
.pipe(operators.distinctUntilChanged(), operators.takeUntil(this._destroy))
.subscribe((/**
* @return {?}
*/
function () {
if (_this.panelOpen) {
_this._scrollTop = 0;
_this.openedChange.emit(true);
}
else {
_this.openedChange.emit(false);
_this.overlayDir.offsetX = 0;
_this._changeDetectorRef.markForCheck();
}
}));
this._viewportRuler.change()
.pipe(operators.takeUntil(this._destroy))
.subscribe((/**
* @return {?}
*/
function () {
if (_this._panelOpen) {
_this._triggerRect = _this.trigger.nativeElement.getBoundingClientRect();
_this._changeDetectorRef.markForCheck();
}
}));
};
/**
* @return {?}
*/
MatSelect.prototype.ngAfterContentInit = /**
* @return {?}
*/
function () {
var _this = this;
this._initKeyManager();
this._selectionModel.onChange.pipe(operators.takeUntil(this._destroy)).subscribe((/**
* @param {?} event
* @return {?}
*/
function (event) {
event.added.forEach((/**
* @param {?} option
* @return {?}
*/
function (option) { return option.select(); }));
event.removed.forEach((/**
* @param {?} option
* @return {?}
*/
function (option) { return option.deselect(); }));
}));
this.options.changes.pipe(operators.startWith(null), operators.takeUntil(this._destroy)).subscribe((/**
* @return {?}
*/
function () {
_this._resetOptions();
_this._initializeSelection();
}));
};
/**
* @return {?}
*/
MatSelect.prototype.ngDoCheck = /**
* @return {?}
*/
function () {
if (this.ngControl) {
this.updateErrorState();
}
};
/**
* @param {?} changes
* @return {?}
*/
MatSelect.prototype.ngOnChanges = /**
* @param {?} changes
* @return {?}
*/
function (changes) {
// Updating the disabled state is handled by `mixinDisabled`, but we need to additionally let
// the parent form field know to run change detection when the disabled state changes.
if (changes['disabled']) {
this.stateChanges.next();
}
};
/**
* @return {?}
*/
MatSelect.prototype.ngOnDestroy = /**
* @return {?}
*/
function () {
this._destroy.next();
this._destroy.complete();
this.stateChanges.complete();
};
/** Toggles the overlay panel open or closed. */
/**
* Toggles the overlay panel open or closed.
* @return {?}
*/
MatSelect.prototype.toggle = /**
* Toggles the overlay panel open or closed.
* @return {?}
*/
function () {
this.panelOpen ? this.close() : this.open();
};
/** Opens the overlay panel. */
/**
* Opens the overlay panel.
* @return {?}
*/
MatSelect.prototype.open = /**
* Opens the overlay panel.
* @return {?}
*/
function () {
var _this = this;
if (this.disabled || !this.options || !this.options.length || this._panelOpen) {
return;
}
this._triggerRect = this.trigger.nativeElement.getBoundingClientRect();
// Note: The computed font-size will be a string pixel value (e.g. "16px").
// `parseInt` ignores the trailing 'px' and converts this to a number.
this._triggerFontSize = parseInt(getComputedStyle(this.trigger.nativeElement).fontSize || '0');
this._panelOpen = true;
this._keyManager.withHorizontalOrientation(null);
this._calculateOverlayPosition();
this._highlightCorrectOption();
this._changeDetectorRef.markForCheck();
// Set the font size on the panel element once it exists.
this._ngZone.onStable.asObservable().pipe(operators.take(1)).subscribe((/**
* @return {?}
*/
function () {
if (_this._triggerFontSize && _this.overlayDir.overlayRef &&
_this.overlayDir.overlayRef.overlayElement) {
_this.overlayDir.overlayRef.overlayElement.style.fontSize = _this._triggerFontSize + "px";
}
}));
};
/** Closes the overlay panel and focuses the host element. */
/**
* Closes the overlay panel and focuses the host element.
* @return {?}
*/
MatSelect.prototype.close = /**
* Closes the overlay panel and focuses the host element.
* @return {?}
*/
function () {
if (this._panelOpen) {
this._panelOpen = false;
this._keyManager.withHorizontalOrientation(this._isRtl() ? 'rtl' : 'ltr');
this._changeDetectorRef.markForCheck();
this._onTouched();
}
};
/**
* 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.
*/
/**
* 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.
* @return {?}
*/
MatSelect.prototype.writeValue = /**
* 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.
* @return {?}
*/
function (value) {
if (this.options) {
this._setSelectionByValue(value);
}
};
/**
* 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.
*/
/**
* 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.
* @return {?}
*/
MatSelect.prototype.registerOnChange = /**
* 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.
* @return {?}
*/
function (fn) {
this._onChange = fn;
};
/**
* 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.
*/
/**
* 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.
* @return {?}
*/
MatSelect.prototype.registerOnTouched = /**
* 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.
* @return {?}
*/
function (fn) {
this._onTouched = fn;
};
/**
* 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.
*/
/**
* 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.
* @return {?}
*/
MatSelect.prototype.setDisabledState = /**
* 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.
* @return {?}
*/
function (isDisabled) {
this.disabled = isDisabled;
this._changeDetectorRef.markForCheck();
this.stateChanges.next();
};
Object.defineProperty(MatSelect.prototype, "panelOpen", {
/** Whether or not the overlay panel is open. */
get: /**
* Whether or not the overlay panel is open.
* @return {?}
*/
function () {
return this._panelOpen;
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "selected", {
/** The currently selected option. */
get: /**
* The currently selected option.
* @return {?}
*/
function () {
return this.multiple ? this._selectionModel.selected : this._selectionModel.selected[0];
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatSelect.prototype, "triggerValue", {
/** The value displayed in the trigger. */
get: /**
* The value displayed in the trigger.
* @return {?}
*/
function () {
if (this.empty) {
return '';
}
if (this._multiple) {
/** @type {?} */
var selectedOptions = this._selectionModel.selected.map((/**
* @param {?} option
* @return {?}
*/
function (option) { return option.viewValue; }));
if (this._isRtl()) {
selectedOptions.reverse();
}
// TODO(crisbeto): delimiter should be configurable for proper localization.
return selectedOptions.join(', ');
}
return this._selectionModel.selected[0].viewValue;
},
enumerable: true,
configurable: true
});
/** Whether the element is in RTL mode. */
/**
* Whether the element is in RTL mode.
* @return {?}
*/
MatSelect.prototype._isRtl = /**
* Whether the element is in RTL mode.
* @return {?}
*/
function () {
return this._dir ? this._dir.value === 'rtl' : false;
};
/** Handles all keydown events on the select. */
/**
* Handles all keydown events on the select.
* @param {?} event
* @return {?}
*/
MatSelect.prototype._handleKeydown = /**
* Handles all keydown events on the select.
* @param {?} event
* @return {?}
*/
function (event) {
if (!this.disabled) {
this.panelOpen ? this._handleOpenKeydown(event) : this._handleClosedKeydown(event);
}
};
/** Handles keyboard events while the select is closed. */
/**
* Handles keyboard events while the select is closed.
* @private
* @param {?} event
* @return {?}
*/
MatSelect.prototype._handleClosedKeydown = /**
* Handles keyboard events while the select is closed.
* @private
* @param {?} event
* @return {?}
*/
function (event) {
/** @type {?} */
var keyCode = event.keyCode;
/** @type {?} */
var isArrowKey = keyCode === keycodes.DOWN_ARROW || keyCode === keycodes.UP_ARROW ||
keyCode === keycodes.LEFT_ARROW || keyCode === keycodes.RIGHT_ARROW;
/** @type {?} */
var isOpenKey = keyCode === keycodes.ENTER || keyCode === keycodes.SPACE;
/** @type {?} */
var manager = this._keyManager;
// Open the select on ALT + arrow key to match the native <select>
if ((isOpenKey && !keycodes.hasModifierKey(event)) || ((this.multiple || event.altKey) && isArrowKey)) {
event.preventDefault(); // prevents the page from scrolling down when pressing space
this.open();
}
else if (!this.multiple) {
/** @type {?} */
var previouslySelectedOption = this.selected;
if (keyCode === keycodes.HOME || keyCode === keycodes.END) {
keyCode === keycodes.HOME ? manager.setFirstItemActive() : manager.setLastItemActive();
event.preventDefault();
}
else {
manager.onKeydown(event);
}
/** @type {?} */
var selectedOption = this.selected;
// Since the value has changed, we need to announce it ourselves.
// @breaking-change 8.0.0 remove null check for _liveAnnouncer.
if (this._liveAnnouncer && selectedOption && previouslySelectedOption !== selectedOption) {
// We set a duration on the live announcement, because we want the live element to be
// cleared after a while so that users can't navigate to it using the arrow keys.
this._liveAnnouncer.announce(((/** @type {?} */ (selectedOption))).viewValue, 10000);
}
}
};
/** Handles keyboard events when the selected is open. */
/**
* Handles keyboard events when the selected is open.
* @private
* @param {?} event
* @return {?}
*/
MatSelect.prototype._handleOpenKeydown = /**
* Handles keyboard events when the selected is open.
* @private
* @param {?} event
* @return {?}
*/
function (event) {
/** @type {?} */
var keyCode = event.keyCode;
/** @type {?} */
var isArrowKey = keyCode === keycodes.DOWN_ARROW || keyCode === keycodes.UP_ARROW;
/** @type {?} */
var manager = this._keyManager;
if (keyCode === keycodes.HOME || keyCode === keycodes.END) {
event.preventDefault();
keyCode === keycodes.HOME ? manager.setFirstItemActive() : manager.setLastItemActive();
}
else if (isArrowKey && event.altKey) {
// Close the select on ALT + arrow key to match the native <select>
event.preventDefault();
this.close();
}
else if ((keyCode === keycodes.ENTER || keyCode === keycodes.SPACE) && manager.activeItem &&
!keycodes.hasModifierKey(event)) {
event.preventDefault();
manager.activeItem._selectViaInteraction();
}
else if (this._multiple && keyCode === keycodes.A && event.ctrlKey) {
event.preventDefault();
/** @type {?} */
var hasDeselectedOptions_1 = this.options.some((/**
* @param {?} opt
* @return {?}
*/
function (opt) { return !opt.disabled && !opt.selected; }));
this.options.forEach((/**
* @param {?} option
* @return {?}
*/
function (option) {
if (!option.disabled) {
hasDeselectedOptions_1 ? option.select() : option.deselect();
}
}));
}
else {
/** @type {?} */
var previouslyFocusedIndex = manager.activeItemIndex;
manager.onKeydown(event);
if (this._multiple && isArrowKey && event.shiftKey && manager.activeItem &&
manager.activeItemIndex !== previouslyFocusedIndex) {
manager.activeItem._selectViaInteraction();
}
}
};
/**
* @return {?}
*/
MatSelect.prototype._onFocus = /**
* @return {?}
*/
function () {
if (!this.disabled) {
this._focused = true;
this.stateChanges.next();
}
};
/**
* 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.
*/
/**
* 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.
* @return {?}
*/
MatSelect.prototype._onBlur = /**
* 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.
* @return {?}
*/
function () {
this._focused = false;
if (!this.disabled && !this.panelOpen) {
this._onTouched();
this._changeDetectorRef.markForCheck();
this.stateChanges.next();
}
};
/**
* Callback that is invoked when the overlay panel has been attached.
*/
/**
* Callback that is invoked when the overlay panel has been attached.
* @return {?}
*/
MatSelect.prototype._onAttached = /**
* Callback that is invoked when the overlay panel has been attached.
* @return {?}
*/
function () {
var _this = this;
this.overlayDir.positionChange.pipe(operators.take(1)).subscribe((/**
* @return {?}
*/
function () {
_this._setPseudoCheckboxPaddingSize();
_this._changeDetectorRef.detectChanges();
_this._calculateOverlayOffsetX();
_this.panel.nativeElement.scrollTop = _this._scrollTop;
}));
};
/** Returns the theme to be used on the panel. */
/**
* Returns the theme to be used on the panel.
* @return {?}
*/
MatSelect.prototype._getPanelTheme = /**
* Returns the theme to be used on the panel.
* @return {?}
*/
function () {
return this._parentFormField ? "mat-" + this._parentFormField.color : '';
};
// TODO(josephperrott): Remove after 2018 spec updates are fully merged.
/** Sets the pseudo checkbox padding size based on the width of the pseudo checkbox. */
// TODO(josephperrott): Remove after 2018 spec updates are fully merged.
/**
* Sets the pseudo checkbox padding size based on the width of the pseudo checkbox.
* @private
* @return {?}
*/
MatSelect.prototype._setPseudoCheckboxPaddingSize =
// TODO(josephperrott): Remove after 2018 spec updates are fully merged.
/**
* Sets the pseudo checkbox padding size based on the width of the pseudo checkbox.
* @private
* @return {?}
*/
function () {
if (!exports.SELECT_MULTIPLE_PANEL_PADDING_X && this.multiple) {
/** @type {?} */
var pseudoCheckbox = this.panel.nativeElement.querySelector('.mat-pseudo-checkbox');
if (pseudoCheckbox) {
exports.SELECT_MULTIPLE_PANEL_PADDING_X = SELECT_PANEL_PADDING_X * 1.5 + pseudoCheckbox.offsetWidth;
}
}
};
Object.defineProperty(MatSelect.prototype, "empty", {
/** Whether the select has a value. */
get: /**
* Whether the select has a value.
* @return {?}
*/
function () {
return !this._selectionModel || this._selectionModel.isEmpty();
},
enumerable: true,
configurable: true
});
/**
* @private
* @return {?}
*/
MatSelect.prototype._initializeSelection = /**
* @private
* @return {?}
*/
function () {
var _this = this;
// Defer setting the value in order to avoid the "Expression
// has changed after it was checked" errors from Angular.
Promise.resolve().then((/**
* @return {?}
*/
function () {
_this._setSelectionByValue(_this.ngControl ? _this.ngControl.value : _this._value);
_this.stateChanges.next();
}));
};
/**
* Sets the selected option based on a value. If no option can be
* found with the designated value, the select trigger is cleared.
*/
/**
* Sets the selected option based on a value. If no option can be
* found with the designated value, the select trigger is cleared.
* @private
* @param {?} value
* @return {?}
*/
MatSelect.prototype._setSelectionByValue = /**
* Sets the selected option based on a value. If no option can be
* found with the designated value, the select trigger is cleared.
* @private
* @param {?} value
* @return {?}
*/
function (value) {
var _this = this;
if (this.multiple && value) {
if (!Array.isArray(value)) {
throw getMatSelectNonArrayValueError();
}
this._selectionModel.clear();
value.forEach((/**
* @param {?} currentValue
* @return {?}
*/
function (currentValue) { return _this._selectValue(currentValue); }));
this._sortValues();
}
else {
this._selectionModel.clear();
/** @type {?} */
var correspondingOption = this._selectValue(value);
// Shift focus to the active item. Note that we shouldn't do this in multiple
// mode, because we don't know what option the user interacted with last.
if (correspondingOption) {
this._keyManager.setActiveItem(correspondingOption);
}
}
this._changeDetectorRef.markForCheck();
};
/**
* Finds and selects and option based on its value.
* @returns Option that has the corresponding value.
*/
/**
* Finds and selects and option based on its value.
* @private
* @param {?} value
* @return {?} Option that has the corresponding value.
*/
MatSelect.prototype._selectValue = /**
* Finds and selects and option based on its value.
* @private
* @param {?} value
* @return {?} Option that has the corresponding value.
*/
function (value) {
var _this = this;
/** @type {?} */
var correspondingOption = this.options.find((/**
* @param {?} option
* @return {?}
*/
function (option) {
try {
// Treat null as a special reset value.
return option.value != null && _this._compareWith(option.value, value);
}
catch (error) {
if (core.isDevMode()) {
// Notify developers of errors in their comparator.
console.warn(error);
}
return false;
}
}));
if (correspondingOption) {
this._selectionModel.select(correspondingOption);
}
return correspondingOption;
};
/** Sets up a key manager to listen to keyboard events on the overlay panel. */
/**
* Sets up a key manager to listen to keyboard events on the overlay panel.
* @private
* @return {?}
*/
MatSelect.prototype._initKeyManager = /**
* Sets up a key manager to listen to keyboard events on the overlay panel.
* @private
* @return {?}
*/
function () {
var _this = this;
this._keyManager = new a11y.ActiveDescendantKeyManager(this.options)
.withTypeAhead()
.withVerticalOrientation()
.withHorizontalOrientation(this._isRtl() ? 'rtl' : 'ltr')
.withAllowedModifierKeys(['shiftKey']);
this._keyManager.tabOut.pipe(operators.takeUntil(this._destroy)).subscribe((/**
* @return {?}
*/
function () {
// Restore focus to the trigger before closing. Ensures that the focus
// position won't be lost if the user got focus into the overlay.
_this.focus();
_this.close();
}));
this._keyManager.change.pipe(operators.takeUntil(this._destroy)).subscribe((/**
* @return {?}
*/
function () {
if (_this._panelOpen && _this.panel) {
_this._scrollActiveOptionIntoView();
}
else if (!_this._panelOpen && !_this.multiple && _this._keyManager.activeItem) {
_this._keyManager.activeItem._selectViaInteraction();
}
}));
};
/** Drops current option subscriptions and IDs and resets from scratch. */
/**
* Drops current option subscriptions and IDs and resets from scratch.
* @private
* @return {?}
*/
MatSelect.prototype._resetOptions = /**
* Drops current option subscriptions and IDs and resets from scratch.
* @private
* @return {?}
*/
function () {
var _this = this;
/** @type {?} */
var changedOrDestroyed = rxjs.merge(this.options.changes, this._destroy);
this.optionSelectionChanges.pipe(operators.takeUntil(changedOrDestroyed)).subscribe((/**
* @param {?} event
* @return {?}
*/
function (event) {
_this._onSelect(event.source, event.isUserInput);
if (event.isUserInput && !_this.multiple && _this._panelOpen) {
_this.close();
_this.focus();
}
}));
// Listen to changes in the internal state of the options and react accordingly.
// Handles cases like the labels of the selected options changing.
rxjs.merge.apply(void 0, this.options.map((/**
* @param {?} option
* @return {?}
*/
function (option) { return option._stateChanges; }))).pipe(operators.takeUntil(changedOrDestroyed))
.subscribe((/**
* @return {?}
*/
function () {
_this._changeDetectorRef.markForCheck();
_this.stateChanges.next();
}));
this._setOptionIds();
};
/** Invoked when an option is clicked. */
/**
* Invoked when an option is clicked.
* @private
* @param {?} option
* @param {?} isUserInput
* @return {?}
*/
MatSelect.prototype._onSelect = /**
* Invoked when an option is clicked.
* @private
* @param {?} option
* @param {?} isUserInput
* @return {?}
*/
function (option, isUserInput) {
/** @type {?} */
var wasSelected = this._selectionModel.isSelected(option);
if (option.value == null && !this._multiple) {
option.deselect();
this._selectionModel.clear();
this._propagateChanges(option.value);
}
else {
option.selected ? this._selectionModel.select(option) : this._selectionModel.deselect(option);
if (isUserInput) {
this._keyManager.setActiveItem(option);
}
if (this.multiple) {
this._sortValues();
if (isUserInput) {
// In case the user selected the option with their mouse, we
// want to restore focus back to the trigger, in order to
// prevent the select keyboard controls from clashing with
// the ones from `mat-option`.
this.focus();
}
}
}
if (wasSelected !== this._selectionModel.isSelected(option)) {
this._propagateChanges();
}
this.stateChanges.next();
};
/** Sorts the selected values in the selected based on their order in the panel. */
/**
* Sorts the selected values in the selected based on their order in the panel.
* @private
* @return {?}
*/
MatSelect.prototype._sortValues = /**
* Sorts the selected values in the selected based on their order in the panel.
* @private
* @return {?}
*/
function () {
var _this = this;
if (this.multiple) {
/** @type {?} */
var options_1 = this.options.toArray();
this._selectionModel.sort((/**
* @param {?} a
* @param {?} b
* @return {?}
*/
function (a, b) {
return _this.sortComparator ? _this.sortComparator(a, b, options_1) :
options_1.indexOf(a) - options_1.indexOf(b);
}));
this.stateChanges.next();
}
};
/** Emits change event to set the model value. */
/**
* Emits change event to set the model value.
* @private
* @param {?=} fallbackValue
* @return {?}
*/
MatSelect.prototype._propagateChanges = /**
* Emits change event to set the model value.
* @private
* @param {?=} fallbackValue
* @return {?}
*/
function (fallbackValue) {
/** @type {?} */
var valueToEmit = null;
if (this.multiple) {
valueToEmit = ((/** @type {?} */ (this.selected))).map((/**
* @param {?} option
* @return {?}
*/
function (option) { return option.value; }));
}
else {
valueToEmit = this.selected ? ((/** @type {?} */ (this.selected))).value : fallbackValue;
}
this._value = valueToEmit;
this.valueChange.emit(valueToEmit);
this._onChange(valueToEmit);
this.selectionChange.emit(new MatSelectChange(this, valueToEmit));
this._changeDetectorRef.markForCheck();
};
/** Records option IDs to pass to the aria-owns property. */
/**
* Records option IDs to pass to the aria-owns property.
* @private
* @return {?}
*/
MatSelect.prototype._setOptionIds = /**
* Records option IDs to pass to the aria-owns property.
* @private
* @return {?}
*/
function () {
this._optionIds = this.options.map((/**
* @param {?} option
* @return {?}
*/
function (option) { return option.id; })).join(' ');
};
/**
* Highlights the selected item. If no option is selected, it will highlight
* the first item instead.
*/
/**
* Highlights the selected item. If no option is selected, it will highlight
* the first item instead.
* @private
* @return {?}
*/
MatSelect.prototype._highlightCorrectOption = /**
* Highlights the selected item. If no option is selected, it will highlight
* the first item instead.
* @private
* @return {?}
*/
function () {
if (this._keyManager) {
if (this.empty) {
this._keyManager.setFirstItemActive();
}
else {
this._keyManager.setActiveItem(this._selectionModel.selected[0]);
}
}
};
/** Scrolls the active option into view. */
/**
* Scrolls the active option into view.
* @private
* @return {?}
*/
MatSelect.prototype._scrollActiveOptionIntoView = /**
* Scrolls the active option into view.
* @private
* @return {?}
*/
function () {
/** @type {?} */
var activeOptionIndex = this._keyManager.activeItemIndex || 0;
/** @type {?} */
var labelCount = core$1._countGroupLabelsBeforeOption(activeOptionIndex, this.options, this.optionGroups);
this.panel.nativeElement.scrollTop = core$1._getOptionScrollPosition(activeOptionIndex + labelCount, this._getItemHeight(), this.panel.nativeElement.scrollTop, SELECT_PANEL_MAX_HEIGHT);
};
/** Focuses the select element. */
/**
* Focuses the select element.
* @return {?}
*/
MatSelect.prototype.focus = /**
* Focuses the select element.
* @return {?}
*/
function () {
this._elementRef.nativeElement.focus();
};
/** Gets the index of the provided option in the option list. */
/**
* Gets the index of the provided option in the option list.
* @private
* @param {?} option
* @return {?}
*/
MatSelect.prototype._getOptionIndex = /**
* Gets the index of the provided option in the option list.
* @private
* @param {?} option
* @return {?}
*/
function (option) {
return this.options.reduce((/**
* @param {?} result
* @param {?} current
* @param {?} index
* @return {?}
*/
function (result, current, index) {
return result === undefined ? (option === current ? index : undefined) : result;
}), undefined);
};
/** Calculates the scroll position and x- and y-offsets of the overlay panel. */
/**
* Calculates the scroll position and x- and y-offsets of the overlay panel.
* @private
* @return {?}
*/
MatSelect.prototype._calculateOverlayPosition = /**
* Calculates the scroll position and x- and y-offsets of the overlay panel.
* @private
* @return {?}
*/
function () {
/** @type {?} */
var itemHeight = this._getItemHeight();
/** @type {?} */
var items = this._getItemCount();
/** @type {?} */
var panelHeight = Math.min(items * itemHeight, SELECT_PANEL_MAX_HEIGHT);
/** @type {?} */
var scrollContainerHeight = items * itemHeight;
// The farthest the panel can be scrolled before it hits the bottom
/** @type {?} */
var maxScroll = scrollContainerHeight - panelHeight;
// If no value is selected we open the popup to the first item.
/** @type {?} */
var selectedOptionOffset = this.empty ? 0 : (/** @type {?} */ (this._getOptionIndex(this._selectionModel.selected[0])));
selectedOptionOffset += core$1._countGroupLabelsBeforeOption(selectedOptionOffset, this.options, this.optionGroups);
// We must maintain a scroll buffer so the selected option will be scrolled to the
// center of the overlay panel rather than the top.
/** @type {?} */
var scrollBuffer = panelHeight / 2;
this._scrollTop = this._calculateOverlayScroll(selectedOptionOffset, scrollBuffer, maxScroll);
this._offsetY = this._calculateOverlayOffsetY(selectedOptionOffset, scrollBuffer, maxScroll);
this._checkOverlayWithinViewport(maxScroll);
};
/**
* Calculates the scroll position of the select's overlay panel.
*
* Attempts to center the selected option in the panel. If the option is
* too high or too low in the panel to be scrolled to the center, it clamps the
* scroll position to the min or max scroll positions respectively.
*/
/**
* Calculates the scroll position of the select's overlay panel.
*
* Attempts to center the selected option in the panel. If the option is
* too high or too low in the panel to be scrolled to the center, it clamps the
* scroll position to the min or max scroll positions respectively.
* @param {?} selectedIndex
* @param {?} scrollBuffer
* @param {?} maxScroll
* @return {?}
*/
MatSelect.prototype._calculateOverlayScroll = /**
* Calculates the scroll position of the select's overlay panel.
*
* Attempts to center the selected option in the panel. If the option is
* too high or too low in the panel to be scrolled to the center, it clamps the
* scroll position to the min or max scroll positions respectively.
* @param {?} selectedIndex
* @param {?} scrollBuffer
* @param {?} maxScroll
* @return {?}
*/
function (selectedIndex, scrollBuffer, maxScroll) {
/** @type {?} */
var itemHeight = this._getItemHeight();
/** @type {?} */
var optionOffsetFromScrollTop = itemHeight * selectedIndex;
/** @type {?} */
var halfOptionHeight = itemHeight / 2;
// Starts at the optionOffsetFromScrollTop, which scrolls the option to the top of the
// scroll container, then subtracts the scroll buffer to scroll the option down to
// the center of the overlay panel. Half the option height must be re-added to the
// scrollTop so the option is centered based on its middle, not its top edge.
/** @type {?} */
var optimalScrollPosition = optionOffsetFromScrollTop - scrollBuffer + halfOptionHeight;
return Math.min(Math.max(0, optimalScrollPosition), maxScroll);
};
/** Returns the aria-label of the select component. */
/**
* Returns the aria-label of the select component.
* @return {?}
*/
MatSelect.prototype._getAriaLabel = /**
* Returns the aria-label of the select component.
* @return {?}
*/
function () {
// If an ariaLabelledby value has been set by the consumer, the select should not overwrite the
// `aria-labelledby` value by setting the ariaLabel to the placeholder.
return this.ariaLabelledby ? null : this.ariaLabel || this.placeholder;
};
/** Returns the aria-labelledby of the select component. */
/**
* Returns the aria-labelledby of the select component.
* @return {?}
*/
MatSelect.prototype._getAriaLabelledby = /**
* Returns the aria-labelledby of the select component.
* @return {?}
*/
function () {
if (this.ariaLabelledby) {
return this.ariaLabelledby;
}
// Note: we use `_getAriaLabel` here, because we want to check whether there's a
// computed label. `this.ariaLabel` is only the user-specified label.
if (!this._parentFormField || !this._parentFormField._hasFloatingLabel() ||
this._getAriaLabel()) {
return null;
}
return this._parentFormField._labelId || null;
};
/** Determines the `aria-activedescendant` to be set on the host. */
/**
* Determines the `aria-activedescendant` to be set on the host.
* @return {?}
*/
MatSelect.prototype._getAriaActiveDescendant = /**
* Determines the `aria-activedescendant` to be set on the host.
* @return {?}
*/
function () {
if (this.panelOpen && this._keyManager && this._keyManager.activeItem) {
return this._keyManager.activeItem.id;
}
return null;
};
/**
* Sets the x-offset of the overlay panel in relation to the trigger's top start corner.
* This must be adjusted to align the selected option text over the trigger text when
* the panel opens. Will change based on LTR or RTL text direction. Note that the offset
* can't be calculated until the panel has been attached, because we need to know the
* content width in order to constrain the panel within the viewport.
*/
/**
* Sets the x-offset of the overlay panel in relation to the trigger's top start corner.
* This must be adjusted to align the selected option text over the trigger text when
* the panel opens. Will change based on LTR or RTL text direction. Note that the offset
* can't be calculated until the panel has been attached, because we need to know the
* content width in order to constrain the panel within the viewport.
* @private
* @return {?}
*/
MatSelect.prototype._calculateOverlayOffsetX = /**
* Sets the x-offset of the overlay panel in relation to the trigger's top start corner.
* This must be adjusted to align the selected option text over the trigger text when
* the panel opens. Will change based on LTR or RTL text direction. Note that the offset
* can't be calculated until the panel has been attached, because we need to know the
* content width in order to constrain the panel within the viewport.
* @private
* @return {?}
*/
function () {
/** @type {?} */
var overlayRect = this.overlayDir.overlayRef.overlayElement.getBoundingClientRect();
/** @type {?} */
var viewportSize = this._viewportRuler.getViewportSize();
/** @type {?} */
var isRtl = this._isRtl();
/** @type {?} */
var paddingWidth = this.multiple ? exports.SELECT_MULTIPLE_PANEL_PADDING_X + SELECT_PANEL_PADDING_X :
SELECT_PANEL_PADDING_X * 2;
/** @type {?} */
var offsetX;
// Adjust the offset, depending on the option padding.
if (this.multiple) {
offsetX = exports.SELECT_MULTIPLE_PANEL_PADDING_X;
}
else {
/** @type {?} */
var selected = this._selectionModel.selected[0] || this.options.first;
offsetX = selected && selected.group ? SELECT_PANEL_INDENT_PADDING_X : SELECT_PANEL_PADDING_X;
}
// Invert the offset in LTR.
if (!isRtl) {
offsetX *= -1;
}
// Determine how much the select overflows on each side.
/** @type {?} */
var leftOverflow = 0 - (overlayRect.left + offsetX - (isRtl ? paddingWidth : 0));
/** @type {?} */
var rightOverflow = overlayRect.right + offsetX - viewportSize.width
+ (isRtl ? 0 : paddingWidth);
// If the element overflows on either side, reduce the offset to allow it to fit.
if (leftOverflow > 0) {
offsetX += leftOverflow + SELECT_PANEL_VIEWPORT_PADDING;
}
else if (rightOverflow > 0) {
offsetX -= rightOverflow + SELECT_PANEL_VIEWPORT_PADDING;
}
// Set the offset directly in order to avoid having to go through change detection and
// potentially triggering "changed after it was checked" errors. Round the value to avoid
// blurry content in some browsers.
this.overlayDir.offsetX = Math.round(offsetX);
this.overlayDir.overlayRef.updatePosition();
};
/**
* Calculates the y-offset of the select's overlay panel in relation to the
* top start corner of the trigger. It has to be adjusted in order for the
* selected option to be aligned over the trigger when the panel opens.
*/
/**
* Calculates the y-offset of the select's overlay panel in relation to the
* top start corner of the trigger. It has to be adjusted in order for the
* selected option to be aligned over the trigger when the panel opens.
* @private
* @param {?} selectedIndex
* @param {?} scrollBuffer
* @param {?} maxScroll
* @return {?}
*/
MatSelect.prototype._calculateOverlayOffsetY = /**
* Calculates the y-offset of the select's overlay panel in relation to the
* top start corner of the trigger. It has to be adjusted in order for the
* selected option to be aligned over the trigger when the panel opens.
* @private
* @param {?} selectedIndex
* @param {?} scrollBuffer
* @param {?} maxScroll
* @return {?}
*/
function (selectedIndex, scrollBuffer, maxScroll) {
/** @type {?} */
var itemHeight = this._getItemHeight();
/** @type {?} */
var optionHeightAdjustment = (itemHeight - this._triggerRect.height) / 2;
/** @type {?} */
var maxOptionsDisplayed = Math.floor(SELECT_PANEL_MAX_HEIGHT / itemHeight);
/** @type {?} */
var optionOffsetFromPanelTop;
// Disable offset if requested by user by returning 0 as value to offset
if (this._disableOptionCentering) {
return 0;
}
if (this._scrollTop === 0) {
optionOffsetFromPanelTop = selectedIndex * itemHeight;
}
else if (this._scrollTop === maxScroll) {
/** @type {?} */
var firstDisplayedIndex = this._getItemCount() - maxOptionsDisplayed;
/** @type {?} */
var selectedDisplayIndex = selectedIndex - firstDisplayedIndex;
// The first item is partially out of the viewport. Therefore we need to calculate what
// portion of it is shown in the viewport and account for it in our offset.
/** @type {?} */
var partialItemHeight = itemHeight - (this._getItemCount() * itemHeight - SELECT_PANEL_MAX_HEIGHT) % itemHeight;
// Because the panel height is longer than the height of the options alone,
// there is always extra padding at the top or bottom of the panel. When
// scrolled to the very bottom, this padding is at the top of the panel and
// must be added to the offset.
optionOffsetFromPanelTop = selectedDisplayIndex * itemHeight + partialItemHeight;
}
else {
// If the option was scrolled to the middle of the panel using a scroll buffer,
// its offset will be the scroll buffer minus the half height that was added to
// center it.
optionOffsetFromPanelTop = scrollBuffer - itemHeight / 2;
}
// The final offset is the option's offset from the top, adjusted for the height difference,
// multiplied by -1 to ensure that the overlay moves in the correct direction up the page.
// The value is rounded to prevent some browsers from blurring the content.
return Math.round(optionOffsetFromPanelTop * -1 - optionHeightAdjustment);
};
/**
* Checks that the attempted overlay position will fit within the viewport.
* If it will not fit, tries to adjust the scroll position and the associated
* y-offset so the panel can open fully on-screen. If it still won't fit,
* sets the offset back to 0 to allow the fallback position to take over.
*/
/**
* Checks that the attempted overlay position will fit within the viewport.
* If it will not fit, tries to adjust the scroll position and the associated
* y-offset so the panel can open fully on-screen. If it still won't fit,
* sets the offset back to 0 to allow the fallback position to take over.
* @private
* @param {?} maxScroll
* @return {?}
*/
MatSelect.prototype._checkOverlayWithinViewport = /**
* Checks that the attempted overlay position will fit within the viewport.
* If it will not fit, tries to adjust the scroll position and the associated
* y-offset so the panel can open fully on-screen. If it still won't fit,
* sets the offset back to 0 to allow the fallback position to take over.
* @private
* @param {?} maxScroll
* @return {?}
*/
function (maxScroll) {
/** @type {?} */
var itemHeight = this._getItemHeight();
/** @type {?} */
var viewportSize = this._viewportRuler.getViewportSize();
/** @type {?} */
var topSpaceAvailable = this._triggerRect.top - SELECT_PANEL_VIEWPORT_PADDING;
/** @type {?} */
var bottomSpaceAvailable = viewportSize.height - this._triggerRect.bottom - SELECT_PANEL_VIEWPORT_PADDING;
/** @type {?} */
var panelHeightTop = Math.abs(this._offsetY);
/** @type {?} */
var totalPanelHeight = Math.min(this._getItemCount() * itemHeight, SELECT_PANEL_MAX_HEIGHT);
/** @type {?} */
var panelHeightBottom = totalPanelHeight - panelHeightTop - this._triggerRect.height;
if (panelHeightBottom > bottomSpaceAvailable) {
this._adjustPanelUp(panelHeightBottom, bottomSpaceAvailable);
}
else if (panelHeightTop > topSpaceAvailable) {
this._adjustPanelDown(panelHeightTop, topSpaceAvailable, maxScroll);
}
else {
this._transformOrigin = this._getOriginBasedOnOption();
}
};
/** Adjusts the overlay panel up to fit in the viewport. */
/**
* Adjusts the overlay panel up to fit in the viewport.
* @private
* @param {?} panelHeightBottom
* @param {?} bottomSpaceAvailable
* @return {?}
*/
MatSelect.prototype._adjustPanelUp = /**
* Adjusts the overlay panel up to fit in the viewport.
* @private
* @param {?} panelHeightBottom
* @param {?} bottomSpaceAvailable
* @return {?}
*/
function (panelHeightBottom, bottomSpaceAvailable) {
// Browsers ignore fractional scroll offsets, so we need to round.
/** @type {?} */
var distanceBelowViewport = Math.round(panelHeightBottom - bottomSpaceAvailable);
// Scrolls the panel up by the distance it was extending past the boundary, then
// adjusts the offset by that amount to move the panel up into the viewport.
this._scrollTop -= distanceBelowViewport;
this._offsetY -= distanceBelowViewport;
this._transformOrigin = this._getOriginBasedOnOption();
// If the panel is scrolled to the very top, it won't be able to fit the panel
// by scrolling, so set the offset to 0 to allow the fallback position to take
// effect.
if (this._scrollTop <= 0) {
this._scrollTop = 0;
this._offsetY = 0;
this._transformOrigin = "50% bottom 0px";
}
};
/** Adjusts the overlay panel down to fit in the viewport. */
/**
* Adjusts the overlay panel down to fit in the viewport.
* @private
* @param {?} panelHeightTop
* @param {?} topSpaceAvailable
* @param {?} maxScroll
* @return {?}
*/
MatSelect.prototype._adjustPanelDown = /**
* Adjusts the overlay panel down to fit in the viewport.
* @private
* @param {?} panelHeightTop
* @param {?} topSpaceAvailable
* @param {?} maxScroll
* @return {?}
*/
function (panelHeightTop, topSpaceAvailable, maxScroll) {
// Browsers ignore fractional scroll offsets, so we need to round.
/** @type {?} */
var distanceAboveViewport = Math.round(panelHeightTop - topSpaceAvailable);
// Scrolls the panel down by the distance it was extending past the boundary, then
// adjusts the offset by that amount to move the panel down into the viewport.
this._scrollTop += distanceAboveViewport;
this._offsetY += distanceAboveViewport;
this._transformOrigin = this._getOriginBasedOnOption();
// If the panel is scrolled to the very bottom, it won't be able to fit the
// panel by scrolling, so set the offset to 0 to allow the fallback position
// to take effect.
if (this._scrollTop >= maxScroll) {
this._scrollTop = maxScroll;
this._offsetY = 0;
this._transformOrigin = "50% top 0px";
return;
}
};
/** Sets the transform origin point based on the selected option. */
/**
* Sets the transform origin point based on the selected option.
* @private
* @return {?}
*/
MatSelect.prototype._getOriginBasedOnOption = /**
* Sets the transform origin point based on the selected option.
* @private
* @return {?}
*/
function () {
/** @type {?} */
var itemHeight = this._getItemHeight();
/** @type {?} */
var optionHeightAdjustment = (itemHeight - this._triggerRect.height) / 2;
/** @type {?} */
var originY = Math.abs(this._offsetY) - optionHeightAdjustment + itemHeight / 2;
return "50% " + originY + "px 0px";
};
/** Calculates the amount of items in the select. This includes options and group labels. */
/**
* Calculates the amount of items in the select. This includes options and group labels.
* @private
* @return {?}
*/
MatSelect.prototype._getItemCount = /**
* Calculates the amount of items in the select. This includes options and group labels.
* @private
* @return {?}
*/
function () {
return this.options.length + this.optionGroups.length;
};
/** Calculates the height of the select's options. */
/**
* Calculates the height of the select's options.
* @private
* @return {?}
*/
MatSelect.prototype._getItemHeight = /**
* Calculates the height of the select's options.
* @private
* @return {?}
*/
function () {
return this._triggerFontSize * SELECT_ITEM_HEIGHT_EM;
};
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
/**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @param {?} ids
* @return {?}
*/
MatSelect.prototype.setDescribedByIds = /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @param {?} ids
* @return {?}
*/
function (ids) {
this._ariaDescribedby = ids.join(' ');
};
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
/**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
MatSelect.prototype.onContainerClick = /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () {
this.focus();
this.open();
};
Object.defineProperty(MatSelect.prototype, "shouldLabelFloat", {
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () {
return this._panelOpen || !this.empty;
},
enumerable: true,
configurable: true
});
MatSelect.decorators = [
{ type: core.Component, args: [{selector: 'mat-select',
exportAs: 'matSelect',
template: "<div cdk-overlay-origin class=\"mat-select-trigger\" aria-hidden=\"true\" (click)=\"toggle()\" #origin=\"cdkOverlayOrigin\" #trigger><div class=\"mat-select-value\" [ngSwitch]=\"empty\"><span class=\"mat-select-placeholder\" *ngSwitchCase=\"true\">{{placeholder || '\u00A0'}}</span> <span class=\"mat-select-value-text\" *ngSwitchCase=\"false\" [ngSwitch]=\"!!customTrigger\"><span *ngSwitchDefault>{{triggerValue || '\u00A0'}}</span><ng-content select=\"mat-select-trigger\" *ngSwitchCase=\"true\"></ng-content></span></div><div class=\"mat-select-arrow-wrapper\"><div class=\"mat-select-arrow\"></div></div></div><ng-template cdk-connected-overlay cdkConnectedOverlayLockPosition cdkConnectedOverlayHasBackdrop cdkConnectedOverlayBackdropClass=\"cdk-overlay-transparent-backdrop\" [cdkConnectedOverlayScrollStrategy]=\"_scrollStrategy\" [cdkConnectedOverlayOrigin]=\"origin\" [cdkConnectedOverlayOpen]=\"panelOpen\" [cdkConnectedOverlayPositions]=\"_positions\" [cdkConnectedOverlayMinWidth]=\"_triggerRect?.width\" [cdkConnectedOverlayOffsetY]=\"_offsetY\" (backdropClick)=\"close()\" (attach)=\"_onAttached()\" (detach)=\"close()\"><div class=\"mat-select-panel-wrap\" [@transformPanelWrap]><div #panel class=\"mat-select-panel {{ _getPanelTheme() }}\" [ngClass]=\"panelClass\" [@transformPanel]=\"multiple ? 'showing-multiple' : 'showing'\" (@transformPanel.done)=\"_panelDoneAnimatingStream.next($event.toState)\" [style.transformOrigin]=\"_transformOrigin\" [style.font-size.px]=\"_triggerFontSize\" (keydown)=\"_handleKeydown($event)\"><ng-content></ng-content></div></div></ng-template>",
styles: [".mat-select{display:inline-block;width:100%;outline:0}.mat-select-trigger{display:inline-table;cursor:pointer;position:relative;box-sizing:border-box}.mat-select-disabled .mat-select-trigger{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:default}.mat-select-value{display:table-cell;max-width:0;width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.mat-select-value-text{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.mat-select-arrow-wrapper{display:table-cell;vertical-align:middle}.mat-form-field-appearance-fill .mat-select-arrow-wrapper{transform:translateY(-50%)}.mat-form-field-appearance-outline .mat-select-arrow-wrapper{transform:translateY(-25%)}.mat-form-field-appearance-standard.mat-form-field-has-label .mat-select:not(.mat-select-empty) .mat-select-arrow-wrapper{transform:translateY(-50%)}.mat-form-field-appearance-standard .mat-select.mat-select-empty .mat-select-arrow-wrapper{transition:transform .4s cubic-bezier(.25,.8,.25,1)}._mat-animation-noopable.mat-form-field-appearance-standard .mat-select.mat-select-empty .mat-select-arrow-wrapper{transition:none}.mat-select-arrow{width:0;height:0;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid;margin:0 4px}.mat-select-panel-wrap{flex-basis:100%}.mat-select-panel{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;padding-top:0;padding-bottom:0;max-height:256px;min-width:100%;border-radius:4px}@media (-ms-high-contrast:active){.mat-select-panel{outline:solid 1px}}.mat-select-panel .mat-optgroup-label,.mat-select-panel .mat-option{font-size:inherit;line-height:3em;height:3em}.mat-form-field-type-mat-select:not(.mat-form-field-disabled) .mat-form-field-flex{cursor:pointer}.mat-form-field-type-mat-select .mat-form-field-label{width:calc(100% - 18px)}.mat-select-placeholder{transition:color .4s .133s cubic-bezier(.25,.8,.25,1)}._mat-animation-noopable .mat-select-placeholder{transition:none}.mat-form-field-hide-placeholder .mat-select-placeholder{color:transparent;-webkit-text-fill-color:transparent;transition:none;display:block}"],
inputs: ['disabled', 'disableRipple', 'tabIndex'],
encapsulation: core.ViewEncapsulation.None,
changeDetection: core.ChangeDetectionStrategy.OnPush,
host: {
'role': 'listbox',
'[attr.id]': 'id',
'[attr.tabindex]': 'tabIndex',
'[attr.aria-label]': '_getAriaLabel()',
'[attr.aria-labelledby]': '_getAriaLabelledby()',
'[attr.aria-required]': 'required.toString()',
'[attr.aria-disabled]': 'disabled.toString()',
'[attr.aria-invalid]': 'errorState',
'[attr.aria-owns]': 'panelOpen ? _optionIds : null',
'[attr.aria-multiselectable]': 'multiple',
'[attr.aria-describedby]': '_ariaDescribedby || null',
'[attr.aria-activedescendant]': '_getAriaActiveDescendant()',
'[class.mat-select-disabled]': 'disabled',
'[class.mat-select-invalid]': 'errorState',
'[class.mat-select-required]': 'required',
'[class.mat-select-empty]': 'empty',
'class': 'mat-select',
'(keydown)': '_handleKeydown($event)',
'(focus)': '_onFocus()',
'(blur)': '_onBlur()',
},
animations: [
matSelectAnimations.transformPanelWrap,
matSelectAnimations.transformPanel
],
providers: [
{ provide: formField.MatFormFieldControl, useExisting: MatSelect },
{ provide: core$1.MAT_OPTION_PARENT_COMPONENT, useExisting: MatSelect }
],
},] },
];
/** @nocollapse */
MatSelect.ctorParameters = function () { return [
{ type: scrolling.ViewportRuler },
{ type: core.ChangeDetectorRef },
{ type: core.NgZone },
{ type: core$1.ErrorStateMatcher },
{ type: core.ElementRef },
{ type: bidi.Directionality, decorators: [{ type: core.Optional }] },
{ type: forms.NgForm, decorators: [{ type: core.Optional }] },
{ type: forms.FormGroupDirective, decorators: [{ type: core.Optional }] },
{ type: formField.MatFormField, decorators: [{ type: core.Optional }] },
{ type: forms.NgControl, decorators: [{ type: core.Self }, { type: core.Optional }] },
{ type: String, decorators: [{ type: core.Attribute, args: ['tabindex',] }] },
{ type: undefined, decorators: [{ type: core.Inject, args: [MAT_SELECT_SCROLL_STRATEGY,] }] },
{ type: a11y.LiveAnnouncer }
]; };
MatSelect.propDecorators = {
trigger: [{ type: core.ViewChild, args: ['trigger', { static: false },] }],
panel: [{ type: core.ViewChild, args: ['panel', { static: false },] }],
overlayDir: [{ type: core.ViewChild, args: [overlay.CdkConnectedOverlay, { static: false },] }],
options: [{ type: core.ContentChildren, args: [core$1.MatOption, { descendants: true },] }],
optionGroups: [{ type: core.ContentChildren, args: [core$1.MatOptgroup,] }],
panelClass: [{ type: core.Input }],
customTrigger: [{ type: core.ContentChild, args: [MatSelectTrigger, { static: false },] }],
placeholder: [{ type: core.Input }],
required: [{ type: core.Input }],
multiple: [{ type: core.Input }],
disableOptionCentering: [{ type: core.Input }],
compareWith: [{ type: core.Input }],
value: [{ type: core.Input }],
ariaLabel: [{ type: core.Input, args: ['aria-label',] }],
ariaLabelledby: [{ type: core.Input, args: ['aria-labelledby',] }],
errorStateMatcher: [{ type: core.Input }],
sortComparator: [{ type: core.Input }],
id: [{ type: core.Input }],
openedChange: [{ type: core.Output }],
_openedStream: [{ type: core.Output, args: ['opened',] }],
_closedStream: [{ type: core.Output, args: ['closed',] }],
selectionChange: [{ type: core.Output }],
valueChange: [{ type: core.Output }]
};
return MatSelect;
}(_MatSelectMixinBase));
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
var MatSelectModule = /** @class */ (function () {
function MatSelectModule() {
}
MatSelectModule.decorators = [
{ type: core.NgModule, args: [{
imports: [
common.CommonModule,
overlay.OverlayModule,
core$1.MatOptionModule,
core$1.MatCommonModule,
],
exports: [formField.MatFormFieldModule, MatSelect, MatSelectTrigger, core$1.MatOptionModule, core$1.MatCommonModule],
declarations: [MatSelect, MatSelectTrigger],
providers: [MAT_SELECT_SCROLL_STRATEGY_PROVIDER]
},] },
];
return MatSelectModule;
}());
exports.MatSelectModule = MatSelectModule;
exports.MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY = MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY;
exports.SELECT_PANEL_MAX_HEIGHT = SELECT_PANEL_MAX_HEIGHT;
exports.SELECT_PANEL_PADDING_X = SELECT_PANEL_PADDING_X;
exports.SELECT_PANEL_INDENT_PADDING_X = SELECT_PANEL_INDENT_PADDING_X;
exports.SELECT_ITEM_HEIGHT_EM = SELECT_ITEM_HEIGHT_EM;
exports.SELECT_PANEL_VIEWPORT_PADDING = SELECT_PANEL_VIEWPORT_PADDING;
exports.MAT_SELECT_SCROLL_STRATEGY = MAT_SELECT_SCROLL_STRATEGY;
exports.MAT_SELECT_SCROLL_STRATEGY_PROVIDER = MAT_SELECT_SCROLL_STRATEGY_PROVIDER;
exports.MatSelectChange = MatSelectChange;
exports.MatSelectTrigger = MatSelectTrigger;
exports.MatSelect = MatSelect;
exports.matSelectAnimations = matSelectAnimations;
exports.transformPanel = transformPanel;
exports.fadeInContent = fadeInContent;
Object.defineProperty(exports, '__esModule', { value: true });
})));
//# sourceMappingURL=material-select.umd.js.map