@angular/material
Version:
Angular Material
1,274 lines (1,271 loc) • 55 kB
JavaScript
/**
* @license
* Copyright Google Inc. 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 { Attribute, ChangeDetectionStrategy, ChangeDetectorRef, Component, ContentChild, ContentChildren, Directive, ElementRef, EventEmitter, Inject, InjectionToken, Input, NgModule, Optional, Output, Renderer2, Self, ViewChild, ViewEncapsulation, isDevMode } from '@angular/core';
import { CommonModule } from '@angular/common';
import { FocusKeyManager } from '@angular/cdk/a11y';
import { Directionality } from '@angular/cdk/bidi';
import { coerceBooleanProperty } from '@angular/cdk/coercion';
import { SelectionModel } from '@angular/cdk/collections';
import { DOWN_ARROW, END, ENTER, HOME, SPACE, UP_ARROW } from '@angular/cdk/keycodes';
import { ConnectedOverlayDirective, Overlay, OverlayModule, ViewportRuler } from '@angular/cdk/overlay';
import { Platform } from '@angular/cdk/platform';
import { filter, startWith } from '@angular/cdk/rxjs';
import { FormGroupDirective, NgControl, NgForm } from '@angular/forms';
import { MD_PLACEHOLDER_GLOBAL_OPTIONS, MdCommonModule, MdOptgroup, MdOption, MdOptionModule, mixinColor, mixinDisabled, mixinTabIndex } from '@angular/material/core';
import { merge } from 'rxjs/observable/merge';
import { Subscription } from 'rxjs/Subscription';
import { animate, state, style, transition, trigger } from '@angular/animations';
/**
* This animation shrinks the placeholder text to 75% of its normal size and translates
* it to either the top left corner (ltr) or top right corner (rtl) of the trigger,
* depending on the text direction of the application.
*/
const transformPlaceholder = trigger('transformPlaceholder', [
state('floating-ltr', style({
top: '-22px',
left: '-2px',
transform: 'scale(0.75)'
})),
state('floating-rtl', style({
top: '-22px',
left: '2px',
transform: 'scale(0.75)'
})),
transition('* => *', animate('400ms cubic-bezier(0.25, 0.8, 0.25, 1)'))
]);
/**
* 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.
*/
const transformPanel = trigger('transformPanel', [
state('showing', style({
opacity: 1,
minWidth: 'calc(100% + 32px)',
transform: 'scaleY(1)'
})),
state('showing-multiple', style({
opacity: 1,
minWidth: 'calc(100% + 64px)',
transform: 'scaleY(1)'
})),
transition('void => *', [
style({
opacity: 0,
minWidth: '100%',
transform: 'scaleY(0)'
}),
animate('150ms cubic-bezier(0.25, 0.8, 0.25, 1)')
]),
transition('* => void', [
animate('250ms 100ms linear', 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.
*/
const fadeInContent = trigger('fadeInContent', [
state('showing', style({ opacity: 1 })),
transition('void => showing', [
style({ opacity: 0 }),
animate('150ms 100ms cubic-bezier(0.55, 0, 0.55, 0.2)')
])
]);
/**
* Returns an exception to be thrown when attempting to change a select's `multiple` option
* after initialization.
* \@docs-private
* @return {?}
*/
function getMdSelectDynamicMultipleError() {
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 getMdSelectNonArrayValueError() {
return Error('Cannot assign truthy non-array value to select in `multiple` 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 getMdSelectNonFunctionValueError() {
return Error('Cannot assign a non-function value to `compareWith`.');
}
/**
* The fixed height of every option element (option, group header etc.).
*/
const SELECT_ITEM_HEIGHT = 48;
/**
* The max height of the select's overlay panel
*/
const SELECT_PANEL_MAX_HEIGHT = 256;
/**
* The max number of options visible at once in the select panel.
*/
const SELECT_MAX_OPTIONS_DISPLAYED = Math.floor(SELECT_PANEL_MAX_HEIGHT / SELECT_ITEM_HEIGHT);
/**
* The fixed height of the select's trigger element.
*/
const SELECT_TRIGGER_HEIGHT = 30;
/**
* Must adjust for the difference in height between the option and the trigger,
* so the text will align on the y axis.
*/
const SELECT_OPTION_HEIGHT_ADJUSTMENT = (SELECT_ITEM_HEIGHT - SELECT_TRIGGER_HEIGHT) / 2;
/**
* The panel's padding on the x-axis
*/
const SELECT_PANEL_PADDING_X = 16;
/**
* The panel's x axis padding if it is indented (e.g. there is an option group).
*/
const SELECT_PANEL_INDENT_PADDING_X = SELECT_PANEL_PADDING_X * 2;
/**
* Distance between the panel edge and the option text in
* multi-selection mode.
*
* (SELECT_PADDING * 1.75) + 20 = 48
* The padding is multiplied by 1.75 because the checkbox's margin is half the padding, and
* the browser adds ~4px, because we're using inline elements.
* The checkbox width is 20px.
*/
const SELECT_MULTIPLE_PANEL_PADDING_X = SELECT_PANEL_PADDING_X * 1.75 + 20;
/**
* The panel's padding on the y-axis. This padding indicates there are more
* options available if you scroll.
*/
const SELECT_PANEL_PADDING_Y = 16;
/**
* The select panel will only "fit" inside the viewport if it is positioned at
* this value or more away from the viewport boundary.
*/
const SELECT_PANEL_VIEWPORT_PADDING = 8;
/**
* Default minimum width of the trigger based on the CSS.
* Used as a fallback for server-side rendering.
* \@docs-private
*/
const SELECT_TRIGGER_MIN_WIDTH = 112;
/**
* Injection token that determines the scroll handling while a select is open.
*/
const MD_SELECT_SCROLL_STRATEGY = new InjectionToken('md-select-scroll-strategy');
/**
* \@docs-private
* @param {?} overlay
* @return {?}
*/
function MD_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay) {
return () => overlay.scrollStrategies.reposition();
}
/**
* \@docs-private
*/
const MD_SELECT_SCROLL_STRATEGY_PROVIDER = {
provide: MD_SELECT_SCROLL_STRATEGY,
deps: [Overlay],
useFactory: MD_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY,
};
/**
* Change event object that is emitted when the select value has changed.
*/
class MdSelectChange {
/**
* @param {?} source
* @param {?} value
*/
constructor(source, value) {
this.source = source;
this.value = value;
}
}
/**
* \@docs-private
*/
class MdSelectBase {
/**
* @param {?} _renderer
* @param {?} _elementRef
*/
constructor(_renderer, _elementRef) {
this._renderer = _renderer;
this._elementRef = _elementRef;
}
}
const _MdSelectMixinBase = mixinTabIndex(mixinColor(mixinDisabled(MdSelectBase), 'primary'));
/**
* Allows the user to customize the trigger that is displayed when the select has a value.
*/
class MdSelectTrigger {
}
MdSelectTrigger.decorators = [
{ type: Directive, args: [{
selector: 'md-select-trigger, mat-select-trigger'
},] },
];
/**
* @nocollapse
*/
MdSelectTrigger.ctorParameters = () => [];
class MdSelect extends _MdSelectMixinBase {
/**
* @param {?} _viewportRuler
* @param {?} _changeDetectorRef
* @param {?} _platform
* @param {?} renderer
* @param {?} elementRef
* @param {?} _dir
* @param {?} _parentForm
* @param {?} _parentFormGroup
* @param {?} _control
* @param {?} tabIndex
* @param {?} placeholderOptions
* @param {?} _scrollStrategyFactory
*/
constructor(_viewportRuler, _changeDetectorRef, _platform, renderer, elementRef, _dir, _parentForm, _parentFormGroup, _control, tabIndex, placeholderOptions, _scrollStrategyFactory) {
super(renderer, elementRef);
this._viewportRuler = _viewportRuler;
this._changeDetectorRef = _changeDetectorRef;
this._platform = _platform;
this._dir = _dir;
this._parentForm = _parentForm;
this._parentFormGroup = _parentFormGroup;
this._control = _control;
this._scrollStrategyFactory = _scrollStrategyFactory;
/**
* Whether or not the overlay panel is open.
*/
this._panelOpen = false;
/**
* Subscriptions to option events.
*/
this._optionSubscription = Subscription.EMPTY;
/**
* Subscription to changes in the option list.
*/
this._changeSubscription = Subscription.EMPTY;
/**
* Subscription to tab events while overlay is focused.
*/
this._tabSubscription = Subscription.EMPTY;
/**
* 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 = (o1, o2) => o1 === o2;
/**
* The animation state of the placeholder.
*/
this._placeholderState = '';
/**
* View -> model callback called when value changes
*/
this._onChange = () => { };
/**
* View -> model callback called when select has been touched
*/
this._onTouched = () => { };
/**
* 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';
/**
* Whether the panel's animation is done.
*/
this._panelDoneAnimating = false;
/**
* Strategy that will be used to handle scrolling while the select panel is open.
*/
this._scrollStrategy = this._scrollStrategyFactory();
/**
* 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',
},
];
this._disableRipple = false;
/**
* Aria label of the select. If not specified, the placeholder will be used as label.
*/
this.ariaLabel = '';
/**
* Input that can be used to specify the `aria-labelledby` attribute.
*/
this.ariaLabelledby = '';
/**
* Event emitted when the select has been opened.
*/
this.onOpen = new EventEmitter();
/**
* Event emitted when the select has been closed.
*/
this.onClose = new EventEmitter();
/**
* Event emitted when the selected value has been changed by the user.
*/
this.change = new 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 EventEmitter();
if (this._control) {
this._control.valueAccessor = this;
}
this.tabIndex = parseInt(tabIndex) || 0;
this._placeholderOptions = placeholderOptions ? placeholderOptions : {};
this.floatPlaceholder = this._placeholderOptions.float || 'auto';
}
/**
* Placeholder to be shown if no value has been selected.
* @return {?}
*/
get placeholder() { return this._placeholder; }
/**
* @param {?} value
* @return {?}
*/
set placeholder(value) {
this._placeholder = value;
// Must wait to record the trigger width to ensure placeholder width is included.
Promise.resolve(null).then(() => this._setTriggerWidth());
}
/**
* Whether the component is required.
* @return {?}
*/
get required() { return this._required; }
/**
* @param {?} value
* @return {?}
*/
set required(value) { this._required = coerceBooleanProperty(value); }
/**
* Whether the user should be allowed to select multiple options.
* @return {?}
*/
get multiple() { return this._multiple; }
/**
* @param {?} value
* @return {?}
*/
set multiple(value) {
if (this._selectionModel) {
throw getMdSelectDynamicMultipleError();
}
this._multiple = coerceBooleanProperty(value);
}
/**
* A 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 {?}
*/
get compareWith() { return this._compareWith; }
/**
* @param {?} fn
* @return {?}
*/
set compareWith(fn) {
if (typeof fn !== 'function') {
throw getMdSelectNonFunctionValueError();
}
this._compareWith = fn;
if (this._selectionModel) {
// A different comparator means the selection could change.
this._initializeSelection();
}
}
/**
* Whether to float the placeholder text.
* @return {?}
*/
get floatPlaceholder() { return this._floatPlaceholder; }
/**
* @param {?} value
* @return {?}
*/
set floatPlaceholder(value) {
this._floatPlaceholder = value || this._placeholderOptions.float || 'auto';
}
/**
* Value of the select control.
* @return {?}
*/
get value() { return this._value; }
/**
* @param {?} newValue
* @return {?}
*/
set value(newValue) {
this.writeValue(newValue);
this._value = newValue;
}
/**
* Whether ripples for all options in the select are disabled.
* @return {?}
*/
get disableRipple() { return this._disableRipple; }
/**
* @param {?} value
* @return {?}
*/
set disableRipple(value) {
this._disableRipple = coerceBooleanProperty(value);
this._setOptionDisableRipple();
}
/**
* Combined stream of all of the child options' change events.
* @return {?}
*/
get optionSelectionChanges() {
return merge(...this.options.map(option => option.onSelectionChange));
}
/**
* @return {?}
*/
ngOnInit() {
this._selectionModel = new SelectionModel(this.multiple, undefined, false);
}
/**
* @return {?}
*/
ngAfterContentInit() {
this._initKeyManager();
this._changeSubscription = startWith.call(this.options.changes, null).subscribe(() => {
this._resetOptions();
this._initializeSelection();
});
}
/**
* @return {?}
*/
ngOnDestroy() {
this._dropSubscriptions();
this._changeSubscription.unsubscribe();
this._tabSubscription.unsubscribe();
}
/**
* Toggles the overlay panel open or closed.
* @return {?}
*/
toggle() {
this.panelOpen ? this.close() : this.open();
}
/**
* Opens the overlay panel.
* @return {?}
*/
open() {
if (this.disabled || !this.options.length) {
return;
}
if (!this._triggerWidth) {
this._setTriggerWidth();
}
this._calculateOverlayPosition();
this._placeholderState = this._floatPlaceholderState();
this._panelOpen = true;
this._changeDetectorRef.markForCheck();
}
/**
* Closes the overlay panel and focuses the host element.
* @return {?}
*/
close() {
if (this._panelOpen) {
this._panelOpen = false;
if (this._selectionModel.isEmpty()) {
this._placeholderState = '';
}
this._changeDetectorRef.markForCheck();
this.focus();
}
}
/**
* 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 {?}
*/
writeValue(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.
* @return {?}
*/
registerOnChange(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.
* @return {?}
*/
registerOnTouched(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.
* @return {?}
*/
setDisabledState(isDisabled) {
this.disabled = isDisabled;
this._changeDetectorRef.markForCheck();
}
/**
* Whether or not the overlay panel is open.
* @return {?}
*/
get panelOpen() {
return this._panelOpen;
}
/**
* The currently selected option.
* @return {?}
*/
get selected() {
return this.multiple ? this._selectionModel.selected : this._selectionModel.selected[0];
}
/**
* The value displayed in the trigger.
* @return {?}
*/
get triggerValue() {
if (!this._selectionModel || this._selectionModel.isEmpty()) {
return '';
}
if (this._multiple) {
const /** @type {?} */ selectedOptions = this._selectionModel.selected.map(option => 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;
}
/**
* Whether the element is in RTL mode.
* @return {?}
*/
_isRtl() {
return this._dir ? this._dir.value === 'rtl' : false;
}
/**
* Sets the width of the trigger element. This is necessary to match
* the overlay width to the trigger width.
* @return {?}
*/
_setTriggerWidth() {
this._triggerWidth = this._platform.isBrowser ? this._getTriggerRect().width :
SELECT_TRIGGER_MIN_WIDTH;
this._changeDetectorRef.markForCheck();
}
/**
* Handles the keyboard interactions of a closed select.
* @param {?} event
* @return {?}
*/
_handleClosedKeydown(event) {
if (!this.disabled) {
if (event.keyCode === ENTER || event.keyCode === SPACE) {
event.preventDefault(); // prevents the page from scrolling down when pressing space
this.open();
}
else if (event.keyCode === UP_ARROW || event.keyCode === DOWN_ARROW) {
this._handleArrowKey(event);
}
}
}
/**
* Handles keypresses inside the panel.
* @param {?} event
* @return {?}
*/
_handlePanelKeydown(event) {
if (event.keyCode === HOME || event.keyCode === END) {
event.preventDefault();
event.keyCode === HOME ? this._keyManager.setFirstItemActive() :
this._keyManager.setLastItemActive();
}
else {
this._keyManager.onKeydown(event);
}
}
/**
* When the panel element is finished transforming in (though not fading in), it
* emits an event and focuses an option if the panel is open.
* @return {?}
*/
_onPanelDone() {
if (this.panelOpen) {
this._focusCorrectOption();
this.onOpen.emit();
}
else {
this.onClose.emit();
this._panelDoneAnimating = false;
this.overlayDir.offsetX = 0;
this._changeDetectorRef.markForCheck();
}
}
/**
* When the panel content is done fading in, the _panelDoneAnimating property is
* set so the proper class can be added to the panel.
* @return {?}
*/
_onFadeInDone() {
this._panelDoneAnimating = this.panelOpen;
this._changeDetectorRef.markForCheck();
}
/**
* 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 {?}
*/
_onBlur() {
if (!this.disabled && !this.panelOpen) {
this._onTouched();
this._changeDetectorRef.markForCheck();
}
}
/**
* Callback that is invoked when the overlay panel has been attached.
* @return {?}
*/
_onAttached() {
this._calculateOverlayOffsetX();
this._setScrollTop();
}
/**
* Whether the select has a value.
* @return {?}
*/
_hasValue() {
return this._selectionModel && this._selectionModel.hasValue();
}
/**
* Whether the select is in an error state.
* @return {?}
*/
_isErrorState() {
const /** @type {?} */ isInvalid = this._control && this._control.invalid;
const /** @type {?} */ isTouched = this._control && this._control.touched;
const /** @type {?} */ isSubmitted = (this._parentFormGroup && this._parentFormGroup.submitted) ||
(this._parentForm && this._parentForm.submitted);
return !!(isInvalid && (isTouched || isSubmitted));
}
/**
* Sets the scroll position of the scroll container. This must be called after
* the overlay pane is attached or the scroll container element will not yet be
* present in the DOM.
* @return {?}
*/
_setScrollTop() {
const /** @type {?} */ scrollContainer = this.overlayDir.overlayRef.overlayElement.querySelector('.mat-select-panel'); /** @type {?} */
((scrollContainer)).scrollTop = this._scrollTop;
}
/**
* @return {?}
*/
_initializeSelection() {
// Defer setting the value in order to avoid the "Expression
// has changed after it was checked" errors from Angular.
Promise.resolve().then(() => {
this._setSelectionByValue(this._control ? this._control.value : this._value);
});
}
/**
* Sets the selected option based on a value. If no option can be
* found with the designated value, the select trigger is cleared.
* @param {?} value
* @param {?=} isUserInput
* @return {?}
*/
_setSelectionByValue(value, isUserInput = false) {
const /** @type {?} */ isArray = Array.isArray(value);
if (this.multiple && value && !isArray) {
throw getMdSelectNonArrayValueError();
}
this._clearSelection();
if (isArray) {
value.forEach((currentValue) => this._selectValue(currentValue, isUserInput));
this._sortValues();
}
else {
const /** @type {?} */ correspondingOption = this._selectValue(value, isUserInput);
// 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(this.options.toArray().indexOf(correspondingOption));
}
}
this._setValueWidth();
if (this._selectionModel.isEmpty()) {
this._placeholderState = '';
}
this._changeDetectorRef.markForCheck();
}
/**
* Finds and selects and option based on its value.
* @param {?} value
* @param {?=} isUserInput
* @return {?} Option that has the corresponding value.
*/
_selectValue(value, isUserInput = false) {
const /** @type {?} */ correspondingOption = this.options.find((option) => {
try {
// Treat null as a special reset value.
return option.value != null && this._compareWith(option.value, value);
}
catch (error) {
if (isDevMode()) {
// Notify developers of errors in their comparator.
console.warn(error);
}
return false;
}
});
if (correspondingOption) {
isUserInput ? correspondingOption._selectViaInteraction() : correspondingOption.select();
this._selectionModel.select(correspondingOption);
}
return correspondingOption;
}
/**
* Clears the select trigger and deselects every option in the list.
* @param {?=} skip Option that should not be deselected.
* @return {?}
*/
_clearSelection(skip) {
this._selectionModel.clear();
this.options.forEach(option => {
if (option !== skip) {
option.deselect();
}
});
}
/**
* @return {?}
*/
_getTriggerRect() {
return this.trigger.nativeElement.getBoundingClientRect();
}
/**
* Sets up a key manager to listen to keyboard events on the overlay panel.
* @return {?}
*/
_initKeyManager() {
this._keyManager = new FocusKeyManager(this.options).withTypeAhead();
this._tabSubscription = this._keyManager.tabOut.subscribe(() => this.close());
}
/**
* Drops current option subscriptions and IDs and resets from scratch.
* @return {?}
*/
_resetOptions() {
this._dropSubscriptions();
this._listenToOptions();
this._setOptionIds();
this._setOptionMultiple();
this._setOptionDisableRipple();
}
/**
* Listens to user-generated selection events on each option.
* @return {?}
*/
_listenToOptions() {
this._optionSubscription = filter.call(this.optionSelectionChanges, event => event.isUserInput).subscribe(event => {
this._onSelect(event.source);
this._setValueWidth();
if (!this.multiple) {
this.close();
}
});
}
/**
* Invoked when an option is clicked.
* @param {?} option
* @return {?}
*/
_onSelect(option) {
const /** @type {?} */ wasSelected = this._selectionModel.isSelected(option);
// TODO(crisbeto): handle blank/null options inside multi-select.
if (this.multiple) {
this._selectionModel.toggle(option);
wasSelected ? option.deselect() : option.select();
this._sortValues();
}
else {
this._clearSelection(option.value == null ? undefined : option);
if (option.value == null) {
this._propagateChanges(option.value);
}
else {
this._selectionModel.select(option);
}
}
if (wasSelected !== this._selectionModel.isSelected(option)) {
this._propagateChanges();
}
}
/**
* Sorts the model values, ensuring that they keep the same
* order that they have in the panel.
* @return {?}
*/
_sortValues() {
if (this._multiple) {
this._selectionModel.clear();
this.options.forEach(option => {
if (option.selected) {
this._selectionModel.select(option);
}
});
}
}
/**
* Unsubscribes from all option subscriptions.
* @return {?}
*/
_dropSubscriptions() {
this._optionSubscription.unsubscribe();
}
/**
* Emits change event to set the model value.
* @param {?=} fallbackValue
* @return {?}
*/
_propagateChanges(fallbackValue) {
let /** @type {?} */ valueToEmit = null;
if (Array.isArray(this.selected)) {
valueToEmit = this.selected.map(option => option.value);
}
else {
valueToEmit = this.selected ? this.selected.value : fallbackValue;
}
this._value = valueToEmit;
this._onChange(valueToEmit);
this.change.emit(new MdSelectChange(this, valueToEmit));
this.valueChange.emit(valueToEmit);
}
/**
* Records option IDs to pass to the aria-owns property.
* @return {?}
*/
_setOptionIds() {
this._optionIds = this.options.map(option => option.id).join(' ');
}
/**
* Sets the `multiple` property on each option. The promise is necessary
* in order to avoid Angular errors when modifying the property after init.
* @return {?}
*/
_setOptionMultiple() {
if (this.multiple) {
Promise.resolve(null).then(() => {
this.options.forEach(option => option.multiple = this.multiple);
});
}
}
/**
* Sets the `disableRipple` property on each option.
* @return {?}
*/
_setOptionDisableRipple() {
if (this.options) {
this.options.forEach(option => option.disableRipple = this.disableRipple);
}
}
/**
* Must set the width of the selected option's value programmatically
* because it is absolutely positioned and otherwise will not clip
* overflow. The selection arrow is 9px wide, add 4px of padding = 13
* @return {?}
*/
_setValueWidth() {
this._selectedValueWidth = this._triggerWidth - 13;
this._changeDetectorRef.markForCheck();
}
/**
* Focuses the selected item. If no option is selected, it will focus
* the first item instead.
* @return {?}
*/
_focusCorrectOption() {
if (this._selectionModel.isEmpty()) {
this._keyManager.setFirstItemActive();
}
else {
this._keyManager.setActiveItem(/** @type {?} */ ((this._getOptionIndex(this._selectionModel.selected[0]))));
}
}
/**
* Focuses the select element.
* @return {?}
*/
focus() {
this._elementRef.nativeElement.focus();
}
/**
* Gets the index of the provided option in the option list.
* @param {?} option
* @return {?}
*/
_getOptionIndex(option) {
return this.options.reduce((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.
* @return {?}
*/
_calculateOverlayPosition() {
const /** @type {?} */ items = this._getItemCount();
const /** @type {?} */ panelHeight = Math.min(items * SELECT_ITEM_HEIGHT, SELECT_PANEL_MAX_HEIGHT);
const /** @type {?} */ scrollContainerHeight = items * SELECT_ITEM_HEIGHT;
// The farthest the panel can be scrolled before it hits the bottom
const /** @type {?} */ maxScroll = scrollContainerHeight - panelHeight;
if (this._hasValue()) {
let /** @type {?} */ selectedOptionOffset = ((this._getOptionIndex(this._selectionModel.selected[0])));
selectedOptionOffset += MdOption.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.
const /** @type {?} */ scrollBuffer = panelHeight / 2;
this._scrollTop = this._calculateOverlayScroll(selectedOptionOffset, scrollBuffer, maxScroll);
this._offsetY = this._calculateOverlayOffsetY(selectedOptionOffset, scrollBuffer, maxScroll);
}
else {
// If no option is selected, the panel centers on the first option. In this case,
// we must only adjust for the height difference between the option element
// and the trigger element, then multiply it by -1 to ensure the panel moves
// in the correct direction up the page.
let /** @type {?} */ groupLabels = MdOption.countGroupLabelsBeforeOption(0, this.options, this.optionGroups);
this._offsetY = (SELECT_ITEM_HEIGHT - SELECT_TRIGGER_HEIGHT) / 2 * -1 -
(groupLabels * SELECT_ITEM_HEIGHT);
}
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.
* @param {?} selectedIndex
* @param {?} scrollBuffer
* @param {?} maxScroll
* @return {?}
*/
_calculateOverlayScroll(selectedIndex, scrollBuffer, maxScroll) {
const /** @type {?} */ optionOffsetFromScrollTop = SELECT_ITEM_HEIGHT * selectedIndex;
const /** @type {?} */ halfOptionHeight = SELECT_ITEM_HEIGHT / 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.
const /** @type {?} */ optimalScrollPosition = optionOffsetFromScrollTop - scrollBuffer + halfOptionHeight;
return clampValue(0, optimalScrollPosition, maxScroll);
}
/**
* Figures out the appropriate animation state for the placeholder.
* @return {?}
*/
_getPlaceholderAnimationState() {
if (this.floatPlaceholder === 'never') {
return '';
}
if (this.floatPlaceholder === 'always') {
return this._floatPlaceholderState();
}
return this._placeholderState;
}
/**
* Determines the CSS `opacity` of the placeholder element.
* @return {?}
*/
_getPlaceholderOpacity() {
return (this.floatPlaceholder !== 'never' || this._selectionModel.isEmpty()) ? '1' : '0';
}
/**
* Returns the aria-label of the select component.
* @return {?}
*/
get _ariaLabel() {
// If an ariaLabelledby value has been set, the select should not overwrite the
// `aria-labelledby` value by setting the ariaLabel to the placeholder.
return this.ariaLabelledby ? null : this.ariaLabel || this.placeholder;
}
/**
* 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.
* @return {?}
*/
_calculateOverlayOffsetX() {
const /** @type {?} */ overlayRect = this.overlayDir.overlayRef.overlayElement.getBoundingClientRect();
const /** @type {?} */ viewportRect = this._viewportRuler.getViewportRect();
const /** @type {?} */ isRtl = this._isRtl();
const /** @type {?} */ paddingWidth = this.multiple ? SELECT_MULTIPLE_PANEL_PADDING_X + SELECT_PANEL_PADDING_X :
SELECT_PANEL_PADDING_X * 2;
let /** @type {?} */ offsetX;
// Adjust the offset, depending on the option padding.
if (this.multiple) {
offsetX = SELECT_MULTIPLE_PANEL_PADDING_X;
}
else {
let /** @type {?} */ 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.
const /** @type {?} */ leftOverflow = 0 - (overlayRect.left + offsetX - (isRtl ? paddingWidth : 0));
const /** @type {?} */ rightOverflow = overlayRect.right + offsetX - viewportRect.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.
this.overlayDir.offsetX = 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.
* @param {?} selectedIndex
* @param {?} scrollBuffer
* @param {?} maxScroll
* @return {?}
*/
_calculateOverlayOffsetY(selectedIndex, scrollBuffer, maxScroll) {
let /** @type {?} */ optionOffsetFromPanelTop;
if (this._scrollTop === 0) {
optionOffsetFromPanelTop = selectedIndex * SELECT_ITEM_HEIGHT;
}
else if (this._scrollTop === maxScroll) {
const /** @type {?} */ firstDisplayedIndex = this._getItemCount() - SELECT_MAX_OPTIONS_DISPLAYED;
const /** @type {?} */ selectedDisplayIndex = selectedIndex - firstDisplayedIndex;
// 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 * SELECT_ITEM_HEIGHT + SELECT_PANEL_PADDING_Y;
}
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 - SELECT_ITEM_HEIGHT / 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.
return optionOffsetFromPanelTop * -1 - SELECT_OPTION_HEIGHT_ADJUSTMENT;
}
/**
* 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.
* @param {?} maxScroll
* @return {?}
*/
_checkOverlayWithinViewport(maxScroll) {
const /** @type {?} */ viewportRect = this._viewportRuler.getViewportRect();
const /** @type {?} */ triggerRect = this._getTriggerRect();
const /** @type {?} */ topSpaceAvailable = triggerRect.top - SELECT_PANEL_VIEWPORT_PADDING;
const /** @type {?} */ bottomSpaceAvailable = viewportRect.height - triggerRect.bottom - SELECT_PANEL_VIEWPORT_PADDING;
const /** @type {?} */ panelHeightTop = Math.abs(this._offsetY);
const /** @type {?} */ totalPanelHeight = Math.min(this._getItemCount() * SELECT_ITEM_HEIGHT, SELECT_PANEL_MAX_HEIGHT);
const /** @type {?} */ panelHeightBottom = totalPanelHeight - panelHeightTop - 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.
* @param {?} panelHeightBottom
* @param {?} bottomSpaceAvailable
* @return {?}
*/
_adjustPanelUp(panelHeightBottom, bottomSpaceAvailable) {
const /** @type {?} */ distanceBelowViewport = 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.
* @param {?} panelHeightTop
* @param {?} topSpaceAvailable
* @param {?} maxScroll
* @return {?}
*/
_adjustPanelDown(panelHeightTop, topSpaceAvailable, maxScroll) {
const /** @type {?} */ distanceAboveViewport = 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.
* @return {?}
*/
_getOriginBasedOnOption() {
const /** @type {?} */ originY = Math.abs(this._offsetY) - SELECT_OPTION_HEIGHT_ADJUSTMENT + SELECT_ITEM_HEIGHT / 2;
return `50% ${originY}px 0px`;
}
/**
* Figures out the floating placeholder state value.
* @return {?}
*/
_floatPlaceholderState() {
return this._isRtl() ? 'floating-rtl' : 'floating-ltr';
}
/**
* Handles the user pressing the arrow keys on a closed select.
* @param {?} event
* @return {?}
*/
_handleArrowKey(event) {
if (this._multiple) {
event.preventDefault();
this.open();
}
else {
const /** @type {?} */ prevActiveItem = this._keyManager.activeItem;
// Cycle though the select options even when the select is closed,
// matching the behavior of the native select element.
// TODO(crisbeto): native selects also cycle through the options with left/right arrows,
// however the key manager only supports up/down at the moment.
this._keyManager.onKeydown(event);
const /** @type {?} */ currentActiveItem = (this._keyManager.activeItem);
if (currentActiveItem !== prevActiveItem) {
this._clearSelection();
this._setSelectionByValue(currentActiveItem.value, true);
this._propagateChanges();
}
}
}
/**
* Calculates the amount of items in the select. This includes options and group labels.
* @return {?}
*/
_getItemCount() {
return this.options.length + this.optionGroups.length;
}
}
MdSelect.decorators = [
{ type: Component, args: [{selector: 'md-select, mat-select',
template: "<div cdk-overlay-origin class=\"mat-select-trigger\" aria-hidden=\"true\" (click)=\"toggle()\" #origin=\"cdkOverlayOrigin\" #trigger><span class=\"mat-select-placeholder\" [class.mat-floating-placeholder]=\"_hasValue()\" [@transformPlaceholder]=\"_getPlaceholderAnimationState()\" [style.opacity]=\"_getPlaceholderOpacity()\" [style.width.px]=\"_selectedValueWidth\">{{ placeholder }}</span> <span class=\"mat-select-value\" *ngIf=\"_hasValue()\"><span class=\"mat-select-value-text\" [ngSwitch]=\"!!customTrigger\"><span *ngSwitchDefault>{{ triggerValue }}</span><ng-content select=\"md-select-trigger, mat-select-trigger\" *ngSwitchCase=\"true\"></ng-content></span></span><span class=\"mat-select-arrow\"></span> <span class=\"mat-select-underline\"></span></div><ng-template cdk-connected-overlay hasBackdrop backdropClass=\"cdk-overlay-transparent-backdrop\" [scrollStrategy]=\"_scrollStrategy\" [origin]=\"origin\" [open]=\"panelOpen\" [positions]=\"_positions\" [minWidth]=\"_triggerWidth\" [offsetY]=\"_offsetY\" (backdropClick)=\"close()\" (attach)=\"_onAttached()\" (detach)=\"close()\"><div class=\"mat-select-panel {{ 'mat-' + color }}\" [ngClass]=\"panelClass\" [@transformPanel]=\"multiple ? 'showing-multiple' : 'showing'\" (@transformPanel.done)=\"_onPanelDone()\" (keydown)=\"_handlePanelKeydown($event)\" [style.transformOrigin]=\"_transformOrigin\" [class.mat-select-panel-done-animating]=\"_panelDoneAnimating\"><div class=\"mat-select-content\" [@fadeInContent]=\"'showing'\" (@fadeInContent.done)=\"_onFadeInDone()\"><ng-content></ng-content></div></div></ng-template>",
styles: [".mat-select{display:inline-block;outline:0}.mat-select-trigger{display:flex;align-items:center;height:30px;min-width:112px;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-underline{position:absolute;bottom:0;left:0;right:0;height:1px}.mat-select:focus .mat-select-underline{height:2px}.mat-select-disabled .mat-select-underline{background-color:transparent;background-position:0 bottom}.mat-select-placeholder{position:relative;padding:0 2px;transform-origin:left top;flex-grow:1}.mat-select-placeholder.mat-floating-placeholder{top:-22px;left:-2px;text-align:left;transform:scale(.75)}[dir=rtl] .mat-select-placeholder{transform-origin:right top}[dir=rtl] .mat-select-placeholder.mat-floating-placeholder{left:2px;text-align:right}.mat-select-required .mat-select-placeholder::after{content:' *'}.mat-select-value{position:absolute;max-width:calc(100% - 18px);flex-grow:1;top:0;left:0;bottom:0;display:flex;align-items:center}[dir=rtl] .mat-select-value{left:auto;right:0}.mat-select-value-text{white-space:nowrap;overflow:hidden;text-overflow:ellipsis;line-height:30px}.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{min-width:112px;max-width:280px;overflow:auto;-webkit-overflow-scrolling:touch;padding-top:0;padding-bottom:0;max-height:256px;min-width:100%}.mat-select-panel:not([class*=mat-elevation-z]){box-shadow:0 5px 5px -3px rgba(0,0,0,.2),0 8px 10px 1px rgba(0,0,0,.14),0 3px 14px 2px rgba(0,0,0,.12)}@media screen and