@angular/material
Version:
Angular Material
1,491 lines (1,486 loc) • 59.4 kB
JavaScript
/**
* @license
* Copyright Google LLC All Rights Reserved.
*
* Use of this source code is governed by an MIT-style license that can be
* found in the LICENSE file at https://angular.io/license
*/
import { ChangeDetectionStrategy, ChangeDetectorRef, Component, ContentChildren, Directive, ElementRef, EventEmitter, Input, NgModule, Optional, Output, Self, ViewEncapsulation } from '@angular/core';
import { ErrorStateMatcher, mixinColor, mixinDisabled, mixinErrorState } from '@angular/material/core';
import { __extends } from 'tslib';
import * as tslib_1 from 'tslib';
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 { BACKSPACE, DELETE, ENTER, SPACE } from '@angular/cdk/keycodes';
import { startWith } from 'rxjs/operators/startWith';
import { FormGroupDirective, NgControl, NgForm } from '@angular/forms';
import { MatFormFieldControl } from '@angular/material/form-field';
import { merge } from 'rxjs/observable/merge';
import { Subscription } from 'rxjs/Subscription';
import { Subject } from 'rxjs/Subject';
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Represents an event fired on an individual `mat-chip`.
* @record
*/
/**
* Event object emitted by MatChip when selected or deselected.
*/
var MatChipSelectionChange = /** @class */ (function () {
function MatChipSelectionChange(source, selected, isUserInput) {
if (isUserInput === void 0) { isUserInput = false; }
this.source = source;
this.selected = selected;
this.isUserInput = isUserInput;
}
return MatChipSelectionChange;
}());
/**
* \@docs-private
*/
var MatChipBase = /** @class */ (function () {
function MatChipBase(_elementRef) {
this._elementRef = _elementRef;
}
return MatChipBase;
}());
var _MatChipMixinBase = mixinColor(mixinDisabled(MatChipBase), 'primary');
/**
* Dummy directive to add CSS class to basic chips.
* \@docs-private
*/
var MatBasicChip = /** @class */ (function () {
function MatBasicChip() {
}
MatBasicChip.decorators = [
{ type: Directive, args: [{
selector: "mat-basic-chip, [mat-basic-chip]",
host: { 'class': 'mat-basic-chip' },
},] },
];
/** @nocollapse */
MatBasicChip.ctorParameters = function () { return []; };
return MatBasicChip;
}());
/**
* Material design styled Chip component. Used inside the MatChipList component.
*/
var MatChip = /** @class */ (function (_super) {
__extends(MatChip, _super);
function MatChip(_elementRef) {
var _this = _super.call(this, _elementRef) || this;
_this._elementRef = _elementRef;
/**
* Whether the chip has focus.
*/
_this._hasFocus = false;
_this._selected = false;
_this._selectable = true;
_this._removable = true;
/**
* Emits when the chip is focused.
*/
_this._onFocus = new Subject();
/**
* Emits when the chip is blured.
*/
_this._onBlur = new Subject();
/**
* Emitted when the chip is selected or deselected.
*/
_this.selectionChange = new EventEmitter();
/**
* Emitted when the chip is destroyed.
*/
_this.destroyed = new EventEmitter();
/**
* Emitted when the chip is destroyed.
* @deprecated Use 'destroyed' instead.
* \@deletion-target 6.0.0
*/
_this.destroy = _this.destroyed;
/**
* Emitted when a chip is to be removed.
*/
_this.removed = new EventEmitter();
/**
* Emitted when a chip is to be removed.
* @deprecated Use `removed` instead.
* \@deletion-target 6.0.0
*/
_this.onRemove = _this.removed;
return _this;
}
Object.defineProperty(MatChip.prototype, "selected", {
get: /**
* Whether the chip is selected.
* @return {?}
*/
function () { return this._selected; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._selected = coerceBooleanProperty(value);
this.selectionChange.emit({
source: this,
isUserInput: false,
selected: value
});
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChip.prototype, "value", {
get: /**
* The value of the chip. Defaults to the content inside `<mat-chip>` tags.
* @return {?}
*/
function () {
return this._value != undefined
? this._value
: this._elementRef.nativeElement.textContent;
},
set: /**
* @param {?} value
* @return {?}
*/
function (value) { this._value = value; },
enumerable: true,
configurable: true
});
Object.defineProperty(MatChip.prototype, "selectable", {
get: /**
* Whether or not the chips are selectable. When a chip is not selectable,
* changes to it's selected state are always ignored.
* @return {?}
*/
function () { return this._selectable; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._selectable = coerceBooleanProperty(value);
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChip.prototype, "removable", {
get: /**
* Determines whether or not the chip displays the remove styling and emits (remove) events.
* @return {?}
*/
function () { return this._removable; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._removable = coerceBooleanProperty(value);
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChip.prototype, "ariaSelected", {
/** The ARIA selected applied to the chip. */
get: /**
* The ARIA selected applied to the chip.
* @return {?}
*/
function () {
return this.selectable ? this.selected.toString() : null;
},
enumerable: true,
configurable: true
});
/**
* @return {?}
*/
MatChip.prototype.ngOnDestroy = /**
* @return {?}
*/
function () {
this.destroyed.emit({ chip: this });
};
/** Selects the chip. */
/**
* Selects the chip.
* @return {?}
*/
MatChip.prototype.select = /**
* Selects the chip.
* @return {?}
*/
function () {
this._selected = true;
this.selectionChange.emit({
source: this,
isUserInput: false,
selected: true
});
};
/** Deselects the chip. */
/**
* Deselects the chip.
* @return {?}
*/
MatChip.prototype.deselect = /**
* Deselects the chip.
* @return {?}
*/
function () {
this._selected = false;
this.selectionChange.emit({
source: this,
isUserInput: false,
selected: false
});
};
/** Select this chip and emit selected event */
/**
* Select this chip and emit selected event
* @return {?}
*/
MatChip.prototype.selectViaInteraction = /**
* Select this chip and emit selected event
* @return {?}
*/
function () {
this._selected = true;
// Emit select event when selected changes.
this.selectionChange.emit({
source: this,
isUserInput: true,
selected: true
});
};
/** Toggles the current selected state of this chip. */
/**
* Toggles the current selected state of this chip.
* @param {?=} isUserInput
* @return {?}
*/
MatChip.prototype.toggleSelected = /**
* Toggles the current selected state of this chip.
* @param {?=} isUserInput
* @return {?}
*/
function (isUserInput) {
if (isUserInput === void 0) { isUserInput = false; }
this._selected = !this.selected;
this.selectionChange.emit({
source: this,
isUserInput: isUserInput,
selected: this._selected
});
return this.selected;
};
/** Allows for programmatic focusing of the chip. */
/**
* Allows for programmatic focusing of the chip.
* @return {?}
*/
MatChip.prototype.focus = /**
* Allows for programmatic focusing of the chip.
* @return {?}
*/
function () {
this._elementRef.nativeElement.focus();
this._onFocus.next({ chip: this });
};
/**
* Allows for programmatic removal of the chip. Called by the MatChipList when the DELETE or
* BACKSPACE keys are pressed.
*
* Informs any listeners of the removal request. Does not remove the chip from the DOM.
*/
/**
* Allows for programmatic removal of the chip. Called by the MatChipList when the DELETE or
* BACKSPACE keys are pressed.
*
* Informs any listeners of the removal request. Does not remove the chip from the DOM.
* @return {?}
*/
MatChip.prototype.remove = /**
* Allows for programmatic removal of the chip. Called by the MatChipList when the DELETE or
* BACKSPACE keys are pressed.
*
* Informs any listeners of the removal request. Does not remove the chip from the DOM.
* @return {?}
*/
function () {
if (this.removable) {
this.removed.emit({ chip: this });
}
};
/** Ensures events fire properly upon click. */
/**
* Ensures events fire properly upon click.
* @param {?} event
* @return {?}
*/
MatChip.prototype._handleClick = /**
* Ensures events fire properly upon click.
* @param {?} event
* @return {?}
*/
function (event) {
// Check disabled
if (this.disabled) {
return;
}
event.preventDefault();
event.stopPropagation();
this.focus();
};
/** Handle custom key presses. */
/**
* Handle custom key presses.
* @param {?} event
* @return {?}
*/
MatChip.prototype._handleKeydown = /**
* Handle custom key presses.
* @param {?} event
* @return {?}
*/
function (event) {
if (this.disabled) {
return;
}
switch (event.keyCode) {
case DELETE:
case BACKSPACE:
// If we are removable, remove the focused chip
this.remove();
// Always prevent so page navigation does not occur
event.preventDefault();
break;
case SPACE:
// If we are selectable, toggle the focused chip
if (this.selectable) {
this.toggleSelected(true);
}
// Always prevent space from scrolling the page since the list has focus
event.preventDefault();
break;
}
};
/**
* @return {?}
*/
MatChip.prototype._blur = /**
* @return {?}
*/
function () {
this._hasFocus = false;
this._onBlur.next({ chip: this });
};
MatChip.decorators = [
{ type: Directive, args: [{
selector: "mat-basic-chip, [mat-basic-chip], mat-chip, [mat-chip]",
inputs: ['color', 'disabled'],
exportAs: 'matChip',
host: {
'class': 'mat-chip',
'[attr.tabindex]': 'disabled ? null : -1',
'role': 'option',
'[class.mat-chip-selected]': 'selected',
'[attr.disabled]': 'disabled || null',
'[attr.aria-disabled]': 'disabled.toString()',
'[attr.aria-selected]': 'ariaSelected',
'(click)': '_handleClick($event)',
'(keydown)': '_handleKeydown($event)',
'(focus)': '_hasFocus = true',
'(blur)': '_blur()',
},
},] },
];
/** @nocollapse */
MatChip.ctorParameters = function () { return [
{ type: ElementRef, },
]; };
MatChip.propDecorators = {
"selected": [{ type: Input },],
"value": [{ type: Input },],
"selectable": [{ type: Input },],
"removable": [{ type: Input },],
"selectionChange": [{ type: Output },],
"destroyed": [{ type: Output },],
"destroy": [{ type: Output },],
"removed": [{ type: Output },],
"onRemove": [{ type: Output, args: ['remove',] },],
};
return MatChip;
}(_MatChipMixinBase));
/**
* Applies proper (click) support and adds styling for use with the Material Design "cancel" icon
* available at https://material.io/icons/#ic_cancel.
*
* Example:
*
* `<mat-chip>
* <mat-icon matChipRemove>cancel</mat-icon>
* </mat-chip>`
*
* You *may* use a custom icon, but you may need to override the `mat-chip-remove` positioning
* styles to properly center the icon within the chip.
*/
var MatChipRemove = /** @class */ (function () {
function MatChipRemove(_parentChip) {
this._parentChip = _parentChip;
}
/** Calls the parent chip's public `remove()` method if applicable. */
/**
* Calls the parent chip's public `remove()` method if applicable.
* @return {?}
*/
MatChipRemove.prototype._handleClick = /**
* Calls the parent chip's public `remove()` method if applicable.
* @return {?}
*/
function () {
if (this._parentChip.removable) {
this._parentChip.remove();
}
};
MatChipRemove.decorators = [
{ type: Directive, args: [{
selector: '[matChipRemove]',
host: {
'class': 'mat-chip-remove',
'(click)': '_handleClick()',
}
},] },
];
/** @nocollapse */
MatChipRemove.ctorParameters = function () { return [
{ type: MatChip, },
]; };
return MatChipRemove;
}());
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* \@docs-private
*/
var MatChipListBase = /** @class */ (function () {
function MatChipListBase(_defaultErrorStateMatcher, _parentForm, _parentFormGroup, ngControl) {
this._defaultErrorStateMatcher = _defaultErrorStateMatcher;
this._parentForm = _parentForm;
this._parentFormGroup = _parentFormGroup;
this.ngControl = ngControl;
}
return MatChipListBase;
}());
var _MatChipListMixinBase = mixinErrorState(MatChipListBase);
// Increasing integer for generating unique ids for chip-list components.
var nextUniqueId = 0;
/**
* Change event object that is emitted when the chip list value has changed.
*/
var MatChipListChange = /** @class */ (function () {
function MatChipListChange(source, value) {
this.source = source;
this.value = value;
}
return MatChipListChange;
}());
/**
* A material design chips component (named ChipList for it's similarity to the List component).
*/
var MatChipList = /** @class */ (function (_super) {
__extends(MatChipList, _super);
function MatChipList(_elementRef, _changeDetectorRef, _dir, _parentForm, _parentFormGroup, _defaultErrorStateMatcher, /** @docs-private */
ngControl) {
var _this = _super.call(this, _defaultErrorStateMatcher, _parentForm, _parentFormGroup, ngControl) || this;
_this._elementRef = _elementRef;
_this._changeDetectorRef = _changeDetectorRef;
_this._dir = _dir;
_this.ngControl = ngControl;
/**
* Implemented as part of MatFormFieldControl.
* \@docs-private
*/
_this.controlType = 'mat-chip-list';
/**
* When a chip is destroyed, we track the index so we can focus the appropriate next chip.
*/
_this._lastDestroyedIndex = null;
/**
* Track which chips we're listening to for focus/destruction.
*/
_this._chipSet = new WeakMap();
/**
* Subscription to tabbing out from the chip list.
*/
_this._tabOutSubscription = Subscription.EMPTY;
/**
* Uid of the chip list
*/
_this._uid = "mat-chip-list-" + nextUniqueId++;
/**
* Tab index for the chip list.
*/
_this._tabIndex = 0;
/**
* User defined tab index.
* When it is not null, use user defined tab index. Otherwise use _tabIndex
*/
_this._userTabIndex = null;
/**
* Function when touched
*/
_this._onTouched = function () { };
/**
* Function when changed
*/
_this._onChange = function () { };
_this._multiple = false;
_this._compareWith = function (o1, o2) { return o1 === o2; };
_this._required = false;
_this._disabled = false;
/**
* Orientation of the chip list.
*/
_this.ariaOrientation = 'horizontal';
_this._selectable = true;
/**
* Event emitted when the selected chip list value has been changed by the user.
*/
_this.change = new EventEmitter();
/**
* Event that emits whenever the raw value of the chip-list changes. This is here primarily
* to facilitate the two-way binding for the `value` input.
* \@docs-private
*/
_this.valueChange = new EventEmitter();
if (_this.ngControl) {
_this.ngControl.valueAccessor = _this;
}
return _this;
}
Object.defineProperty(MatChipList.prototype, "selected", {
/** The array of selected chips inside chip list. */
get: /**
* The array of selected chips inside chip list.
* @return {?}
*/
function () {
return this.multiple ? this._selectionModel.selected : this._selectionModel.selected[0];
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "role", {
/** The ARIA role applied to the chip list. */
get: /**
* The ARIA role applied to the chip list.
* @return {?}
*/
function () { return this.empty ? null : 'listbox'; },
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "multiple", {
get: /**
* Whether the user should be allowed to select multiple chips.
* @return {?}
*/
function () { return this._multiple; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._multiple = coerceBooleanProperty(value);
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "compareWith", {
get: /**
* 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 {?}
*/
function () { return this._compareWith; },
set: /**
* @param {?} fn
* @return {?}
*/
function (fn) {
this._compareWith = fn;
if (this._selectionModel) {
// A different comparator means the selection could change.
this._initializeSelection();
}
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "value", {
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () { return this._value; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this.writeValue(value);
this._value = value;
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "id", {
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () { return this._id || this._uid; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._id = value;
this.stateChanges.next();
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "required", {
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () { return this._required; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._required = coerceBooleanProperty(value);
this.stateChanges.next();
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "placeholder", {
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () {
return this._chipInput ? this._chipInput.placeholder : this._placeholder;
},
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._placeholder = value;
this.stateChanges.next();
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "focused", {
/** Whether any chips or the matChipInput inside of this chip-list has focus. */
get: /**
* Whether any chips or the matChipInput inside of this chip-list has focus.
* @return {?}
*/
function () {
return this.chips.some(function (chip) { return chip._hasFocus; }) ||
(this._chipInput && this._chipInput.focused);
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "empty", {
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () {
return (!this._chipInput || this._chipInput.empty) && this.chips.length === 0;
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "shouldLabelFloat", {
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () { return !this.empty || this.focused; },
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "disabled", {
get: /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () { return this.ngControl ? !!this.ngControl.disabled : this._disabled; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) { this._disabled = coerceBooleanProperty(value); },
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "selectable", {
get: /**
* Whether or not this chip is selectable. When a chip is not selectable,
* its selected state is always ignored.
* @return {?}
*/
function () { return this._selectable; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) { this._selectable = coerceBooleanProperty(value); },
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "tabIndex", {
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
this._userTabIndex = value;
this._tabIndex = value;
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "chipSelectionChanges", {
/** Combined stream of all of the child chips' selection change events. */
get: /**
* Combined stream of all of the child chips' selection change events.
* @return {?}
*/
function () {
return merge.apply(void 0, this.chips.map(function (chip) { return chip.selectionChange; }));
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "chipFocusChanges", {
/** Combined stream of all of the child chips' focus change events. */
get: /**
* Combined stream of all of the child chips' focus change events.
* @return {?}
*/
function () {
return merge.apply(void 0, this.chips.map(function (chip) { return chip._onFocus; }));
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "chipBlurChanges", {
/** Combined stream of all of the child chips' blur change events. */
get: /**
* Combined stream of all of the child chips' blur change events.
* @return {?}
*/
function () {
return merge.apply(void 0, this.chips.map(function (chip) { return chip._onBlur; }));
},
enumerable: true,
configurable: true
});
Object.defineProperty(MatChipList.prototype, "chipRemoveChanges", {
/** Combined stream of all of the child chips' remove change events. */
get: /**
* Combined stream of all of the child chips' remove change events.
* @return {?}
*/
function () {
return merge.apply(void 0, this.chips.map(function (chip) { return chip.destroy; }));
},
enumerable: true,
configurable: true
});
/**
* @return {?}
*/
MatChipList.prototype.ngAfterContentInit = /**
* @return {?}
*/
function () {
var _this = this;
this._keyManager = new FocusKeyManager(this.chips)
.withWrap()
.withVerticalOrientation()
.withHorizontalOrientation(this._dir ? this._dir.value : 'ltr');
// Prevents the chip list from capturing focus and redirecting
// it back to the first chip when the user tabs out.
this._tabOutSubscription = this._keyManager.tabOut.subscribe(function () {
_this._tabIndex = -1;
setTimeout(function () { return _this._tabIndex = _this._userTabIndex || 0; });
});
// When the list changes, re-subscribe
this._changeSubscription = this.chips.changes.pipe(startWith(null)).subscribe(function () {
_this._resetChips();
// Reset chips selected/deselected status
// Reset chips selected/deselected status
_this._initializeSelection();
// Check to see if we need to update our tab index
// Check to see if we need to update our tab index
_this._updateTabIndex();
// Check to see if we have a destroyed chip and need to refocus
// Check to see if we have a destroyed chip and need to refocus
_this._updateFocusForDestroyedChips();
});
};
/**
* @return {?}
*/
MatChipList.prototype.ngOnInit = /**
* @return {?}
*/
function () {
this._selectionModel = new SelectionModel(this.multiple, undefined, false);
this.stateChanges.next();
};
/**
* @return {?}
*/
MatChipList.prototype.ngDoCheck = /**
* @return {?}
*/
function () {
if (this.ngControl) {
// We need to re-evaluate this on every change detection cycle, because there are some
// error triggers that we can't subscribe to (e.g. parent form submissions). This means
// that whatever logic is in here has to be super lean or we risk destroying the performance.
this.updateErrorState();
}
};
/**
* @return {?}
*/
MatChipList.prototype.ngOnDestroy = /**
* @return {?}
*/
function () {
this._tabOutSubscription.unsubscribe();
if (this._changeSubscription) {
this._changeSubscription.unsubscribe();
}
this._dropSubscriptions();
this.stateChanges.complete();
};
/** Associates an HTML input element with this chip list. */
/**
* Associates an HTML input element with this chip list.
* @param {?} inputElement
* @return {?}
*/
MatChipList.prototype.registerInput = /**
* Associates an HTML input element with this chip list.
* @param {?} inputElement
* @return {?}
*/
function (inputElement) {
this._chipInput = inputElement;
};
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
/**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @param {?} ids
* @return {?}
*/
MatChipList.prototype.setDescribedByIds = /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @param {?} ids
* @return {?}
*/
function (ids) { this._ariaDescribedby = ids.join(' '); };
// Implemented as part of ControlValueAccessor.
/**
* @param {?} value
* @return {?}
*/
MatChipList.prototype.writeValue = /**
* @param {?} value
* @return {?}
*/
function (value) {
if (this.chips) {
this._setSelectionByValue(value, false);
}
};
// Implemented as part of ControlValueAccessor.
/**
* @param {?} fn
* @return {?}
*/
MatChipList.prototype.registerOnChange = /**
* @param {?} fn
* @return {?}
*/
function (fn) {
this._onChange = fn;
};
// Implemented as part of ControlValueAccessor.
/**
* @param {?} fn
* @return {?}
*/
MatChipList.prototype.registerOnTouched = /**
* @param {?} fn
* @return {?}
*/
function (fn) {
this._onTouched = fn;
};
// Implemented as part of ControlValueAccessor.
/**
* @param {?} isDisabled
* @return {?}
*/
MatChipList.prototype.setDisabledState = /**
* @param {?} isDisabled
* @return {?}
*/
function (isDisabled) {
this.disabled = isDisabled;
this._elementRef.nativeElement.disabled = isDisabled;
this.stateChanges.next();
};
/**
* Implemented as part of MatFormFieldControl.
* @docs-private
*/
/**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
MatChipList.prototype.onContainerClick = /**
* Implemented as part of MatFormFieldControl.
* \@docs-private
* @return {?}
*/
function () { this.focus(); };
/**
* Focuses the the first non-disabled chip in this chip list, or the associated input when there
* are no eligible chips.
*/
/**
* Focuses the the first non-disabled chip in this chip list, or the associated input when there
* are no eligible chips.
* @return {?}
*/
MatChipList.prototype.focus = /**
* Focuses the the first non-disabled chip in this chip list, or the associated input when there
* are no eligible chips.
* @return {?}
*/
function () {
// TODO: ARIA says this should focus the first `selected` chip if any are selected.
// Focus on first element if there's no chipInput inside chip-list
if (this._chipInput && this._chipInput.focused) {
// do nothing
}
else if (this.chips.length > 0) {
this._keyManager.setFirstItemActive();
this.stateChanges.next();
}
else {
this._focusInput();
this.stateChanges.next();
}
};
/** Attempt to focus an input if we have one. */
/**
* Attempt to focus an input if we have one.
* @return {?}
*/
MatChipList.prototype._focusInput = /**
* Attempt to focus an input if we have one.
* @return {?}
*/
function () {
if (this._chipInput) {
this._chipInput.focus();
}
};
/**
* Pass events to the keyboard manager. Available here for tests.
*/
/**
* Pass events to the keyboard manager. Available here for tests.
* @param {?} event
* @return {?}
*/
MatChipList.prototype._keydown = /**
* Pass events to the keyboard manager. Available here for tests.
* @param {?} event
* @return {?}
*/
function (event) {
var /** @type {?} */ target = /** @type {?} */ (event.target);
// If they are on an empty input and hit backspace, focus the last chip
if (event.keyCode === BACKSPACE && this._isInputEmpty(target)) {
this._keyManager.setLastItemActive();
event.preventDefault();
}
else if (target && target.classList.contains('mat-chip')) {
this._keyManager.onKeydown(event);
this.stateChanges.next();
}
};
/**
* Check the tab index as you should not be allowed to focus an empty list.
*/
/**
* Check the tab index as you should not be allowed to focus an empty list.
* @return {?}
*/
MatChipList.prototype._updateTabIndex = /**
* Check the tab index as you should not be allowed to focus an empty list.
* @return {?}
*/
function () {
// If we have 0 chips, we should not allow keyboard focus
this._tabIndex = this._userTabIndex || (this.chips.length === 0 ? -1 : 0);
};
/**
* Update key manager's active item when chip is deleted.
* If the deleted chip is the last chip in chip list, focus the new last chip.
* Otherwise focus the next chip in the list.
* Save `_lastDestroyedIndex` so we can set the correct focus.
*/
/**
* Update key manager's active item when chip is deleted.
* If the deleted chip is the last chip in chip list, focus the new last chip.
* Otherwise focus the next chip in the list.
* Save `_lastDestroyedIndex` so we can set the correct focus.
* @param {?} chip
* @return {?}
*/
MatChipList.prototype._updateKeyManager = /**
* Update key manager's active item when chip is deleted.
* If the deleted chip is the last chip in chip list, focus the new last chip.
* Otherwise focus the next chip in the list.
* Save `_lastDestroyedIndex` so we can set the correct focus.
* @param {?} chip
* @return {?}
*/
function (chip) {
var /** @type {?} */ chipIndex = this.chips.toArray().indexOf(chip);
if (this._isValidIndex(chipIndex)) {
if (chip._hasFocus) {
// Check whether the chip is not the last item
if (chipIndex < this.chips.length - 1) {
this._keyManager.setActiveItem(chipIndex);
}
else if (chipIndex - 1 >= 0) {
this._keyManager.setActiveItem(chipIndex - 1);
}
}
if (this._keyManager.activeItemIndex === chipIndex) {
this._lastDestroyedIndex = chipIndex;
}
}
};
/**
* Checks to see if a focus chip was recently destroyed so that we can refocus the next closest
* one.
*/
/**
* Checks to see if a focus chip was recently destroyed so that we can refocus the next closest
* one.
* @return {?}
*/
MatChipList.prototype._updateFocusForDestroyedChips = /**
* Checks to see if a focus chip was recently destroyed so that we can refocus the next closest
* one.
* @return {?}
*/
function () {
var /** @type {?} */ chipsArray = this.chips;
if (this._lastDestroyedIndex != null && chipsArray.length > 0) {
// Check whether the destroyed chip was the last item
var /** @type {?} */ newFocusIndex = Math.min(this._lastDestroyedIndex, chipsArray.length - 1);
this._keyManager.setActiveItem(newFocusIndex);
var /** @type {?} */ focusChip = this._keyManager.activeItem;
// Focus the chip
if (focusChip) {
focusChip.focus();
}
}
// Reset our destroyed index
this._lastDestroyedIndex = null;
};
/**
* Utility to ensure all indexes are valid.
*
* @param {?} index The index to be checked.
* @return {?} True if the index is valid for our list of chips.
*/
MatChipList.prototype._isValidIndex = /**
* Utility to ensure all indexes are valid.
*
* @param {?} index The index to be checked.
* @return {?} True if the index is valid for our list of chips.
*/
function (index) {
return index >= 0 && index < this.chips.length;
};
/**
* @param {?} element
* @return {?}
*/
MatChipList.prototype._isInputEmpty = /**
* @param {?} element
* @return {?}
*/
function (element) {
if (element && element.nodeName.toLowerCase() === 'input') {
var /** @type {?} */ input = /** @type {?} */ (element);
return !input.value;
}
return false;
};
/**
* @param {?} value
* @param {?=} isUserInput
* @return {?}
*/
MatChipList.prototype._setSelectionByValue = /**
* @param {?} value
* @param {?=} isUserInput
* @return {?}
*/
function (value, isUserInput) {
var _this = this;
if (isUserInput === void 0) { isUserInput = true; }
this._clearSelection();
this.chips.forEach(function (chip) { return chip.deselect(); });
if (Array.isArray(value)) {
value.forEach(function (currentValue) { return _this._selectValue(currentValue, isUserInput); });
this._sortValues();
}
else {
var /** @type {?} */ correspondingChip = 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 chip the user interacted with last.
if (correspondingChip) {
var /** @type {?} */ correspondingChipIndex = this.chips.toArray().indexOf(correspondingChip);
if (isUserInput) {
this._keyManager.setActiveItem(correspondingChipIndex);
}
else {
this._keyManager.updateActiveItemIndex(correspondingChipIndex);
}
}
}
};
/**
* Finds and selects the chip based on its value.
* @param {?} value
* @param {?=} isUserInput
* @return {?} Chip that has the corresponding value.
*/
MatChipList.prototype._selectValue = /**
* Finds and selects the chip based on its value.
* @param {?} value
* @param {?=} isUserInput
* @return {?} Chip that has the corresponding value.
*/
function (value, isUserInput) {
var _this = this;
if (isUserInput === void 0) { isUserInput = true; }
var /** @type {?} */ correspondingChip = this.chips.find(function (chip) {
return chip.value != null && _this._compareWith(chip.value, value);
});
if (correspondingChip) {
isUserInput ? correspondingChip.selectViaInteraction() : correspondingChip.select();
this._selectionModel.select(correspondingChip);
}
return correspondingChip;
};
/**
* @return {?}
*/
MatChipList.prototype._initializeSelection = /**
* @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(function () {
if (_this.ngControl || _this._value) {
_this._setSelectionByValue(_this.ngControl ? _this.ngControl.value : _this._value, false);
_this.stateChanges.next();
}
});
};
/**
* Deselects every chip in the list.
* @param {?=} skip Chip that should not be deselected.
* @return {?}
*/
MatChipList.prototype._clearSelection = /**
* Deselects every chip in the list.
* @param {?=} skip Chip that should not be deselected.
* @return {?}
*/
function (skip) {
this._selectionModel.clear();
this.chips.forEach(function (chip) {
if (chip !== skip) {
chip.deselect();
}
});
this.stateChanges.next();
};
/**
* Sorts the model values, ensuring that they keep the same
* order that they have in the panel.
* @return {?}
*/
MatChipList.prototype._sortValues = /**
* Sorts the model values, ensuring that they keep the same
* order that they have in the panel.
* @return {?}
*/
function () {
var _this = this;
if (this._multiple) {
this._selectionModel.clear();
this.chips.forEach(function (chip) {
if (chip.selected) {
_this._selectionModel.select(chip);
}
});
this.stateChanges.next();
}
};
/**
* Emits change event to set the model value.
* @param {?=} fallbackValue
* @return {?}
*/
MatChipList.prototype._propagateChanges = /**
* Emits change event to set the model value.
* @param {?=} fallbackValue
* @return {?}
*/
function (fallbackValue) {
var /** @type {?} */ valueToEmit = null;
if (Array.isArray(this.selected)) {
valueToEmit = this.selected.map(function (chip) { return chip.value; });
}
else {
valueToEmit = this.selected ? this.selected.value : fallbackValue;
}
this._value = valueToEmit;
this.change.emit(new MatChipListChange(this, valueToEmit));
this.valueChange.emit(valueToEmit);
this._onChange(valueToEmit);
this._changeDetectorRef.markForCheck();
};
/** When blurred, mark the field as touched when focus moved outside the chip list. */
/**
* When blurred, mark the field as touched when focus moved outside the chip list.
* @return {?}
*/
MatChipList.prototype._blur = /**
* When blurred, mark the field as touched when focus moved outside the chip list.
* @return {?}
*/
function () {
var _this = this;
if (!this.disabled) {
if (this._chipInput) {
// If there's a chip input, we should check whether the focus moved to chip input.
// If the focus is not moved to chip input, mark the field as touched. If the focus moved
// to chip input, do nothing.
// Timeout is needed to wait for the focus() event trigger on chip input.
setTimeout(function () {
if (!_this.focused) {
_this._markAsTouched();
}
});
}
else {
// If there's no chip input, then mark the field as touched.
this._markAsTouched();
}
}
};
/** Mark the field as touched */
/**
* Mark the field as touched
* @return {?}
*/
MatChipList.prototype._markAsTouched = /**
* Mark the field as touched
* @return {?}
*/
function () {
this._onTouched();
this._changeDetectorRef.markForCheck();
this.stateChanges.next();
};
/**
* @return {?}
*/
MatChipList.prototype._resetChips = /**
* @return {?}
*/
function () {
this._dropSubscriptions();
this._listenToChipsFocus();
this._listenToChipsSelection();
this._listenToChipsRemoved();
};
/**
* @return {?}
*/
MatChipList.prototype._dropSubscriptions = /**
* @return {?}
*/
function () {
if (this._chipFocusSubscription) {
this._chipFocusSubscription.unsubscribe();
this._chipFocusSubscription = null;
}
if (this._chipBlurSubscription) {
this._chipBlurSubscription.unsubscribe();
this._chipBlurSubscription = null;
}
if (this._chipSelectionSubscription) {
this._chipSelectionSubscription.unsubscribe();
this._chipSelectionSubscription = null;
}
};
/**
* Listens to user-generated selection events on each chip.
* @return {?}
*/
MatChipList.prototype._listenToChipsSelection = /**
* Listens to user-generated selection events on each chip.
* @return {?}
*/
function () {
var _this = this;
this._chipSelectionSubscription = this.chipSelectionChanges.subscribe(function (event) {
event.source.selected
? _this._selectionModel.select(event.source)
: _this._selectionModel.deselect(event.source);
// For single selection chip list, make sure the deselected value is unselected.
if (!_this.multiple) {
_this.chips.forEach(function (chip) {
if (!_this._selectionModel.isSelected(chip) && chip.selected) {
chip.deselect();
}
});
}
if (event.isUserInput) {
_this._propagateChanges();
}
});
};
/**
* Listens to user-generated selection events on each chip.
* @return {?}
*/
MatChipList.prototype._listenToChipsFocus = /**
* Listens to user-generated selection events on each chip.
* @return {?}
*/
function () {
var _this = this;
this._chipFocusSubscription = this.chipFocusChanges.subscribe(function (event) {
var /** @type {?} */ chipIndex = _this.chips.toArray().indexOf(event.chip);
if (_this._isValidIndex(chipIndex)) {
_this._keyManager.updateActiveItemIndex(chipIndex);
}
_this.stateChanges.next();
});
this._chipBlurSubscription = this.chipBlurChanges.subscribe(function () {
_this._blur();
_this.stateChanges.next();
});
};
/**
* @return {?}
*/
MatChipList.prototype._listenToChipsRemoved = /**
* @return {?}
*/
function () {
var _this = this;
this._chipRemoveSubscription = this.chipRemoveChanges.subscribe(function (event) {
_this._updateKeyManager(event.chip);
});
};
MatChipList.decorators = [
{ type: Component, args: [{selector: 'mat-chip-list',
template: "<div class=\"mat-chip-list-wrapper\"><ng-content></ng-content></div>",
exportAs: 'matChipList',
host: {
'[attr.tabindex]': '_tabIndex',
'[attr.aria-describedby]': '_ariaDescribedby || null',
'[attr.aria-required]': 'required.toString()',
'[attr.aria-disabled]': 'disabled.toString()',
'[attr.aria-invalid]': 'errorState',
'[attr.aria-multiselectable]': 'multiple',
'[attr.role]': 'role',
'[class.mat-chip-list-disabled]': 'disabled',
'[class.mat-chip-list-invalid]': 'errorState',
'[class.mat-chip-list-required]': 'required',
'[attr.aria-orientation]': 'ariaOrientation',
'class': 'mat-chip-list',
'(focus)': 'focus()',
'(blur)': '_blur()',
'(keydown)': '_keydown($event)'
},
providers: [{ provide: MatFormFieldControl, useExisting: MatChipList }],
styles: [".mat-chip-list-wrapper{display:flex;flex-direction:row;flex-wrap:wrap;align-items:baseline}.mat-chip:not(.mat-basic-chip){transition:box-shadow 280ms cubic-bezier(.4,0,.2,1);display:inline-flex;padding:7px 12px;border-radius:24px;align-items:center;cursor:default}.mat-chip:not(.mat-basic-chip)+.mat-chip:not(.mat-basic-chip){margin:0 0 0 8px}[dir=rtl] .mat-chip:not(.mat-basic-chip)+.mat-chip:not(.mat-basic-chip){margin:0 8px 0 0}.mat-form-field-prefix .mat-chip:not(.mat-basic-chip):last-child{margin-right:8px}[dir=rtl] .mat-form-field-prefix .mat-chip:not(.mat-basic-chip):las