@angular/material
Version:
Angular Material
1,370 lines (1,350 loc) • 121 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
*/
(function (global, factory) {
typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/core'), require('@angular/platform-browser'), require('@angular/cdk/bidi'), require('@angular/cdk'), require('@angular/cdk/coercion'), require('rxjs'), require('@angular/cdk/platform'), require('rxjs/operators'), require('@angular/cdk/a11y'), require('@angular/platform-browser/animations'), require('@angular/cdk/keycodes'), require('@angular/common')) :
typeof define === 'function' && define.amd ? define('@angular/material/core', ['exports', '@angular/core', '@angular/platform-browser', '@angular/cdk/bidi', '@angular/cdk', '@angular/cdk/coercion', 'rxjs', '@angular/cdk/platform', 'rxjs/operators', '@angular/cdk/a11y', '@angular/platform-browser/animations', '@angular/cdk/keycodes', '@angular/common'], factory) :
(factory((global.ng = global.ng || {}, global.ng.material = global.ng.material || {}, global.ng.material.core = {}),global.ng.core,global.ng.platformBrowser,global.ng.cdk.bidi,global.ng.cdk,global.ng.cdk.coercion,global.rxjs,global.ng.cdk.platform,global.rxjs.operators,global.ng.cdk.a11y,global.ng.platformBrowser.animations,global.ng.cdk.keycodes,global.ng.common));
}(this, (function (exports,core,platformBrowser,bidi,cdk,coercion,rxjs,platform,operators,a11y,animations,keycodes,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 __());
}
var __assign = function() {
__assign = Object.assign || function __assign(t) {
for (var s, i = 1, n = arguments.length; i < n; i++) {
s = arguments[i];
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
}
return t;
};
return __assign.apply(this, arguments);
};
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Current version of Angular Material.
* @type {?}
*/
var VERSION$1 = new core.Version('8.2.3');
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* \@docs-private
*/
var AnimationCurves = /** @class */ (function () {
function AnimationCurves() {
}
AnimationCurves.STANDARD_CURVE = 'cubic-bezier(0.4,0.0,0.2,1)';
AnimationCurves.DECELERATION_CURVE = 'cubic-bezier(0.0,0.0,0.2,1)';
AnimationCurves.ACCELERATION_CURVE = 'cubic-bezier(0.4,0.0,1,1)';
AnimationCurves.SHARP_CURVE = 'cubic-bezier(0.4,0.0,0.6,1)';
return AnimationCurves;
}());
/**
* \@docs-private
*/
var AnimationDurations = /** @class */ (function () {
function AnimationDurations() {
}
AnimationDurations.COMPLEX = '375ms';
AnimationDurations.ENTERING = '225ms';
AnimationDurations.EXITING = '195ms';
return AnimationDurations;
}());
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
// Private version constant to circumvent test/build issues,
// i.e. avoid core to depend on the @angular/material primary entry-point
// Can be removed once the Material primary entry-point no longer
// re-exports all secondary entry-points
/** @type {?} */
var VERSION$2 = new core.Version('8.2.3');
/**
* \@docs-private
* @return {?}
*/
function MATERIAL_SANITY_CHECKS_FACTORY() {
return true;
}
/**
* Injection token that configures whether the Material sanity checks are enabled.
* @type {?}
*/
var MATERIAL_SANITY_CHECKS = new core.InjectionToken('mat-sanity-checks', {
providedIn: 'root',
factory: MATERIAL_SANITY_CHECKS_FACTORY,
});
/**
* Module that captures anything that should be loaded and/or run for *all* Angular Material
* components. This includes Bidi, etc.
*
* This module should be imported to each top-level component module (e.g., MatTabsModule).
*/
var MatCommonModule = /** @class */ (function () {
function MatCommonModule(_sanityChecksEnabled, _hammerLoader) {
this._sanityChecksEnabled = _sanityChecksEnabled;
this._hammerLoader = _hammerLoader;
/**
* Whether we've done the global sanity checks (e.g. a theme is loaded, there is a doctype).
*/
this._hasDoneGlobalChecks = false;
/**
* Whether we've already checked for HammerJs availability.
*/
this._hasCheckedHammer = false;
/**
* Reference to the global `document` object.
*/
this._document = typeof document === 'object' && document ? document : null;
/**
* Reference to the global 'window' object.
*/
this._window = typeof window === 'object' && window ? window : null;
if (this._areChecksEnabled() && !this._hasDoneGlobalChecks) {
this._checkDoctypeIsDefined();
this._checkThemeIsPresent();
this._checkCdkVersionMatch();
this._hasDoneGlobalChecks = true;
}
}
/** Whether any sanity checks are enabled */
/**
* Whether any sanity checks are enabled
* @private
* @return {?}
*/
MatCommonModule.prototype._areChecksEnabled = /**
* Whether any sanity checks are enabled
* @private
* @return {?}
*/
function () {
return this._sanityChecksEnabled && core.isDevMode() && !this._isTestEnv();
};
/** Whether the code is running in tests. */
/**
* Whether the code is running in tests.
* @private
* @return {?}
*/
MatCommonModule.prototype._isTestEnv = /**
* Whether the code is running in tests.
* @private
* @return {?}
*/
function () {
/** @type {?} */
var window = (/** @type {?} */ (this._window));
return window && (window.__karma__ || window.jasmine);
};
/**
* @private
* @return {?}
*/
MatCommonModule.prototype._checkDoctypeIsDefined = /**
* @private
* @return {?}
*/
function () {
if (this._document && !this._document.doctype) {
console.warn('Current document does not have a doctype. This may cause ' +
'some Angular Material components not to behave as expected.');
}
};
/**
* @private
* @return {?}
*/
MatCommonModule.prototype._checkThemeIsPresent = /**
* @private
* @return {?}
*/
function () {
// We need to assert that the `body` is defined, because these checks run very early
// and the `body` won't be defined if the consumer put their scripts in the `head`.
if (!this._document || !this._document.body || typeof getComputedStyle !== 'function') {
return;
}
/** @type {?} */
var testElement = this._document.createElement('div');
testElement.classList.add('mat-theme-loaded-marker');
this._document.body.appendChild(testElement);
/** @type {?} */
var computedStyle = getComputedStyle(testElement);
// In some situations the computed style of the test element can be null. For example in
// Firefox, the computed style is null if an application is running inside of a hidden iframe.
// See: https://bugzilla.mozilla.org/show_bug.cgi?id=548397
if (computedStyle && computedStyle.display !== 'none') {
console.warn('Could not find Angular Material core theme. Most Material ' +
'components may not work as expected. For more info refer ' +
'to the theming guide: https://material.angular.io/guide/theming');
}
this._document.body.removeChild(testElement);
};
/** Checks whether the material version matches the cdk version */
/**
* Checks whether the material version matches the cdk version
* @private
* @return {?}
*/
MatCommonModule.prototype._checkCdkVersionMatch = /**
* Checks whether the material version matches the cdk version
* @private
* @return {?}
*/
function () {
if (VERSION$2.full !== cdk.VERSION.full) {
console.warn('The Angular Material version (' + VERSION$2.full + ') does not match ' +
'the Angular CDK version (' + cdk.VERSION.full + ').\n' +
'Please ensure the versions of these two packages exactly match.');
}
};
/** Checks whether HammerJS is available. */
/**
* Checks whether HammerJS is available.
* @return {?}
*/
MatCommonModule.prototype._checkHammerIsAvailable = /**
* Checks whether HammerJS is available.
* @return {?}
*/
function () {
if (this._hasCheckedHammer || !this._window) {
return;
}
if (this._areChecksEnabled() && !((/** @type {?} */ (this._window)))['Hammer'] && !this._hammerLoader) {
console.warn('Could not find HammerJS. Certain Angular Material components may not work correctly.');
}
this._hasCheckedHammer = true;
};
MatCommonModule.decorators = [
{ type: core.NgModule, args: [{
imports: [bidi.BidiModule],
exports: [bidi.BidiModule],
},] },
];
/** @nocollapse */
MatCommonModule.ctorParameters = function () { return [
{ type: Boolean, decorators: [{ type: core.Optional }, { type: core.Inject, args: [MATERIAL_SANITY_CHECKS,] }] },
{ type: undefined, decorators: [{ type: core.Optional }, { type: core.Inject, args: [platformBrowser.HAMMER_LOADER,] }] }
]; };
return MatCommonModule;
}());
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Mixin to augment a directive with a `disabled` property.
* @template T
* @param {?} base
* @return {?}
*/
function mixinDisabled(base) {
return /** @class */ (function (_super) {
__extends(class_1, _super);
function class_1() {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
var _this = _super.apply(this, args) || this;
_this._disabled = false;
return _this;
}
Object.defineProperty(class_1.prototype, "disabled", {
get: /**
* @return {?}
*/
function () { return this._disabled; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) { this._disabled = coercion.coerceBooleanProperty(value); },
enumerable: true,
configurable: true
});
return class_1;
}(base));
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Mixin to augment a directive with a `color` property.
* @template T
* @param {?} base
* @param {?=} defaultColor
* @return {?}
*/
function mixinColor(base, defaultColor) {
return /** @class */ (function (_super) {
__extends(class_1, _super);
function class_1() {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
var _this = _super.apply(this, args) || this;
// Set the default color that can be specified from the mixin.
_this.color = defaultColor;
return _this;
}
Object.defineProperty(class_1.prototype, "color", {
get: /**
* @return {?}
*/
function () { return this._color; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
/** @type {?} */
var colorPalette = value || defaultColor;
if (colorPalette !== this._color) {
if (this._color) {
this._elementRef.nativeElement.classList.remove("mat-" + this._color);
}
if (colorPalette) {
this._elementRef.nativeElement.classList.add("mat-" + colorPalette);
}
this._color = colorPalette;
}
},
enumerable: true,
configurable: true
});
return class_1;
}(base));
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Mixin to augment a directive with a `disableRipple` property.
* @template T
* @param {?} base
* @return {?}
*/
function mixinDisableRipple(base) {
return /** @class */ (function (_super) {
__extends(class_1, _super);
function class_1() {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
var _this = _super.apply(this, args) || this;
_this._disableRipple = false;
return _this;
}
Object.defineProperty(class_1.prototype, "disableRipple", {
/** Whether the ripple effect is disabled or not. */
get: /**
* Whether the ripple effect is disabled or not.
* @return {?}
*/
function () { return this._disableRipple; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) { this._disableRipple = coercion.coerceBooleanProperty(value); },
enumerable: true,
configurable: true
});
return class_1;
}(base));
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Mixin to augment a directive with a `tabIndex` property.
* @template T
* @param {?} base
* @param {?=} defaultTabIndex
* @return {?}
*/
function mixinTabIndex(base, defaultTabIndex) {
if (defaultTabIndex === void 0) { defaultTabIndex = 0; }
return /** @class */ (function (_super) {
__extends(class_1, _super);
function class_1() {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
var _this = _super.apply(this, args) || this;
_this._tabIndex = defaultTabIndex;
return _this;
}
Object.defineProperty(class_1.prototype, "tabIndex", {
get: /**
* @return {?}
*/
function () { return this.disabled ? -1 : this._tabIndex; },
set: /**
* @param {?} value
* @return {?}
*/
function (value) {
// If the specified tabIndex value is null or undefined, fall back to the default value.
this._tabIndex = value != null ? value : defaultTabIndex;
},
enumerable: true,
configurable: true
});
return class_1;
}(base));
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Mixin to augment a directive with updateErrorState method.
* For component with `errorState` and need to update `errorState`.
* @template T
* @param {?} base
* @return {?}
*/
function mixinErrorState(base) {
return /** @class */ (function (_super) {
__extends(class_1, _super);
function class_1() {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
var _this = _super.apply(this, args) || this;
/**
* Whether the component is in an error state.
*/
_this.errorState = false;
/**
* Stream that emits whenever the state of the input changes such that the wrapping
* `MatFormField` needs to run change detection.
*/
_this.stateChanges = new rxjs.Subject();
return _this;
}
/**
* @return {?}
*/
class_1.prototype.updateErrorState = /**
* @return {?}
*/
function () {
/** @type {?} */
var oldState = this.errorState;
/** @type {?} */
var parent = this._parentFormGroup || this._parentForm;
/** @type {?} */
var matcher = this.errorStateMatcher || this._defaultErrorStateMatcher;
/** @type {?} */
var control = this.ngControl ? (/** @type {?} */ (this.ngControl.control)) : null;
/** @type {?} */
var newState = matcher.isErrorState(control, parent);
if (newState !== oldState) {
this.errorState = newState;
this.stateChanges.next();
}
};
return class_1;
}(base));
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* Mixin to augment a directive with an initialized property that will emits when ngOnInit ends.
* @template T
* @param {?} base
* @return {?}
*/
function mixinInitialized(base) {
return /** @class */ (function (_super) {
__extends(class_1, _super);
function class_1() {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
var _this = _super.apply(this, args) || this;
/**
* Whether this directive has been marked as initialized.
*/
_this._isInitialized = false;
/**
* List of subscribers that subscribed before the directive was initialized. Should be notified
* during _markInitialized. Set to null after pending subscribers are notified, and should
* not expect to be populated after.
*/
_this._pendingSubscribers = [];
/**
* Observable stream that emits when the directive initializes. If already initialized, the
* subscriber is stored to be notified once _markInitialized is called.
*/
_this.initialized = new rxjs.Observable((/**
* @param {?} subscriber
* @return {?}
*/
function (subscriber) {
// If initialized, immediately notify the subscriber. Otherwise store the subscriber to notify
// when _markInitialized is called.
if (_this._isInitialized) {
_this._notifySubscriber(subscriber);
}
else {
(/** @type {?} */ (_this._pendingSubscribers)).push(subscriber);
}
}));
return _this;
}
/**
* Marks the state as initialized and notifies pending subscribers. Should be called at the end
* of ngOnInit.
* @docs-private
*/
/**
* Marks the state as initialized and notifies pending subscribers. Should be called at the end
* of ngOnInit.
* \@docs-private
* @return {?}
*/
class_1.prototype._markInitialized = /**
* Marks the state as initialized and notifies pending subscribers. Should be called at the end
* of ngOnInit.
* \@docs-private
* @return {?}
*/
function () {
if (this._isInitialized) {
throw Error('This directive has already been marked as initialized and ' +
'should not be called twice.');
}
this._isInitialized = true;
(/** @type {?} */ (this._pendingSubscribers)).forEach(this._notifySubscriber);
this._pendingSubscribers = null;
};
/** Emits and completes the subscriber stream (should only emit once). */
/**
* Emits and completes the subscriber stream (should only emit once).
* @param {?} subscriber
* @return {?}
*/
class_1.prototype._notifySubscriber = /**
* Emits and completes the subscriber stream (should only emit once).
* @param {?} subscriber
* @return {?}
*/
function (subscriber) {
subscriber.next();
subscriber.complete();
};
return class_1;
}(base));
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/**
* InjectionToken for datepicker that can be used to override default locale code.
* @type {?}
*/
var MAT_DATE_LOCALE = new core.InjectionToken('MAT_DATE_LOCALE', {
providedIn: 'root',
factory: MAT_DATE_LOCALE_FACTORY,
});
/**
* \@docs-private
* @return {?}
*/
function MAT_DATE_LOCALE_FACTORY() {
return core.inject(core.LOCALE_ID);
}
/**
* No longer needed since MAT_DATE_LOCALE has been changed to a scoped injectable.
* If you are importing and providing this in your code you can simply remove it.
* @deprecated
* \@breaking-change 8.0.0
* @type {?}
*/
var MAT_DATE_LOCALE_PROVIDER = { provide: MAT_DATE_LOCALE, useExisting: core.LOCALE_ID };
/**
* Adapts type `D` to be usable as a date by cdk-based components that work with dates.
* @abstract
* @template D
*/
var /**
* Adapts type `D` to be usable as a date by cdk-based components that work with dates.
* @abstract
* @template D
*/
DateAdapter = /** @class */ (function () {
function DateAdapter() {
this._localeChanges = new rxjs.Subject();
}
Object.defineProperty(DateAdapter.prototype, "localeChanges", {
/** A stream that emits when the locale changes. */
get: /**
* A stream that emits when the locale changes.
* @return {?}
*/
function () { return this._localeChanges; },
enumerable: true,
configurable: true
});
/**
* Attempts to deserialize a value to a valid date object. This is different from parsing in that
* deserialize should only accept non-ambiguous, locale-independent formats (e.g. a ISO 8601
* string). The default implementation does not allow any deserialization, it simply checks that
* the given value is already a valid date object or null. The `<mat-datepicker>` will call this
* method on all of its `@Input()` properties that accept dates. It is therefore possible to
* support passing values from your backend directly to these properties by overriding this method
* to also deserialize the format used by your backend.
* @param value The value to be deserialized into a date object.
* @returns The deserialized date object, either a valid date, null if the value can be
* deserialized into a null date (e.g. the empty string), or an invalid date.
*/
/**
* Attempts to deserialize a value to a valid date object. This is different from parsing in that
* deserialize should only accept non-ambiguous, locale-independent formats (e.g. a ISO 8601
* string). The default implementation does not allow any deserialization, it simply checks that
* the given value is already a valid date object or null. The `<mat-datepicker>` will call this
* method on all of its `\@Input()` properties that accept dates. It is therefore possible to
* support passing values from your backend directly to these properties by overriding this method
* to also deserialize the format used by your backend.
* @param {?} value The value to be deserialized into a date object.
* @return {?} The deserialized date object, either a valid date, null if the value can be
* deserialized into a null date (e.g. the empty string), or an invalid date.
*/
DateAdapter.prototype.deserialize = /**
* Attempts to deserialize a value to a valid date object. This is different from parsing in that
* deserialize should only accept non-ambiguous, locale-independent formats (e.g. a ISO 8601
* string). The default implementation does not allow any deserialization, it simply checks that
* the given value is already a valid date object or null. The `<mat-datepicker>` will call this
* method on all of its `\@Input()` properties that accept dates. It is therefore possible to
* support passing values from your backend directly to these properties by overriding this method
* to also deserialize the format used by your backend.
* @param {?} value The value to be deserialized into a date object.
* @return {?} The deserialized date object, either a valid date, null if the value can be
* deserialized into a null date (e.g. the empty string), or an invalid date.
*/
function (value) {
if (value == null || this.isDateInstance(value) && this.isValid(value)) {
return value;
}
return this.invalid();
};
/**
* Sets the locale used for all dates.
* @param locale The new locale.
*/
/**
* Sets the locale used for all dates.
* @param {?} locale The new locale.
* @return {?}
*/
DateAdapter.prototype.setLocale = /**
* Sets the locale used for all dates.
* @param {?} locale The new locale.
* @return {?}
*/
function (locale) {
this.locale = locale;
this._localeChanges.next();
};
/**
* Compares two dates.
* @param first The first date to compare.
* @param second The second date to compare.
* @returns 0 if the dates are equal, a number less than 0 if the first date is earlier,
* a number greater than 0 if the first date is later.
*/
/**
* Compares two dates.
* @param {?} first The first date to compare.
* @param {?} second The second date to compare.
* @return {?} 0 if the dates are equal, a number less than 0 if the first date is earlier,
* a number greater than 0 if the first date is later.
*/
DateAdapter.prototype.compareDate = /**
* Compares two dates.
* @param {?} first The first date to compare.
* @param {?} second The second date to compare.
* @return {?} 0 if the dates are equal, a number less than 0 if the first date is earlier,
* a number greater than 0 if the first date is later.
*/
function (first, second) {
return this.getYear(first) - this.getYear(second) ||
this.getMonth(first) - this.getMonth(second) ||
this.getDate(first) - this.getDate(second);
};
/**
* Checks if two dates are equal.
* @param first The first date to check.
* @param second The second date to check.
* @returns Whether the two dates are equal.
* Null dates are considered equal to other null dates.
*/
/**
* Checks if two dates are equal.
* @param {?} first The first date to check.
* @param {?} second The second date to check.
* @return {?} Whether the two dates are equal.
* Null dates are considered equal to other null dates.
*/
DateAdapter.prototype.sameDate = /**
* Checks if two dates are equal.
* @param {?} first The first date to check.
* @param {?} second The second date to check.
* @return {?} Whether the two dates are equal.
* Null dates are considered equal to other null dates.
*/
function (first, second) {
if (first && second) {
/** @type {?} */
var firstValid = this.isValid(first);
/** @type {?} */
var secondValid = this.isValid(second);
if (firstValid && secondValid) {
return !this.compareDate(first, second);
}
return firstValid == secondValid;
}
return first == second;
};
/**
* Clamp the given date between min and max dates.
* @param date The date to clamp.
* @param min The minimum value to allow. If null or omitted no min is enforced.
* @param max The maximum value to allow. If null or omitted no max is enforced.
* @returns `min` if `date` is less than `min`, `max` if date is greater than `max`,
* otherwise `date`.
*/
/**
* Clamp the given date between min and max dates.
* @param {?} date The date to clamp.
* @param {?=} min The minimum value to allow. If null or omitted no min is enforced.
* @param {?=} max The maximum value to allow. If null or omitted no max is enforced.
* @return {?} `min` if `date` is less than `min`, `max` if date is greater than `max`,
* otherwise `date`.
*/
DateAdapter.prototype.clampDate = /**
* Clamp the given date between min and max dates.
* @param {?} date The date to clamp.
* @param {?=} min The minimum value to allow. If null or omitted no min is enforced.
* @param {?=} max The maximum value to allow. If null or omitted no max is enforced.
* @return {?} `min` if `date` is less than `min`, `max` if date is greater than `max`,
* otherwise `date`.
*/
function (date, min, max) {
if (min && this.compareDate(date, min) < 0) {
return min;
}
if (max && this.compareDate(date, max) > 0) {
return max;
}
return date;
};
return DateAdapter;
}());
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
/** @type {?} */
var MAT_DATE_FORMATS = new core.InjectionToken('mat-date-formats');
/**
* @fileoverview added by tsickle
* @suppress {checkTypes,extraRequire,missingOverride,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
*/
// TODO(mmalerba): Remove when we no longer support safari 9.
/**
* Whether the browser supports the Intl API.
* @type {?}
*/
var SUPPORTS_INTL_API;
// We need a try/catch around the reference to `Intl`, because accessing it in some cases can
// cause IE to throw. These cases are tied to particular versions of Windows and can happen if
// the consumer is providing a polyfilled `Map`. See:
// https://github.com/Microsoft/ChakraCore/issues/3189
// https://github.com/angular/components/issues/15687
try {
SUPPORTS_INTL_API = typeof Intl != 'undefined';
}
catch (_a) {
SUPPORTS_INTL_API = false;
}
/**
* The default month names to use if Intl API is not available.
* @type {?}
*/
var DEFAULT_MONTH_NAMES = {
'long': [
'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September',
'October', 'November', 'December'
],
'short': ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
'narrow': ['J', 'F', 'M', 'A', 'M', 'J', 'J', 'A', 'S', 'O', 'N', 'D']
};
var ɵ0 = /**
* @param {?} i
* @return {?}
*/
function (i) { return String(i + 1); };
/**
* The default date names to use if Intl API is not available.
* @type {?}
*/
var DEFAULT_DATE_NAMES = range(31, (ɵ0));
/**
* The default day of the week names to use if Intl API is not available.
* @type {?}
*/
var DEFAULT_DAY_OF_WEEK_NAMES = {
'long': ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
'short': ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
'narrow': ['S', 'M', 'T', 'W', 'T', 'F', 'S']
};
/**
* Matches strings that have the form of a valid RFC 3339 string
* (https://tools.ietf.org/html/rfc3339). Note that the string may not actually be a valid date
* because the regex will match strings an with out of bounds month, date, etc.
* @type {?}
*/
var ISO_8601_REGEX = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|(?:(?:\+|-)\d{2}:\d{2}))?)?$/;
/**
* Creates an array and fills it with values.
* @template T
* @param {?} length
* @param {?} valueFunction
* @return {?}
*/
function range(length, valueFunction) {
/** @type {?} */
var valuesArray = Array(length);
for (var i = 0; i < length; i++) {
valuesArray[i] = valueFunction(i);
}
return valuesArray;
}
/**
* Adapts the native JS Date for use with cdk-based components that work with dates.
*/
var NativeDateAdapter = /** @class */ (function (_super) {
__extends(NativeDateAdapter, _super);
function NativeDateAdapter(matDateLocale, platform$$1) {
var _this = _super.call(this) || this;
/**
* Whether to use `timeZone: 'utc'` with `Intl.DateTimeFormat` when formatting dates.
* Without this `Intl.DateTimeFormat` sometimes chooses the wrong timeZone, which can throw off
* the result. (e.g. in the en-US locale `new Date(1800, 7, 14).toLocaleDateString()`
* will produce `'8/13/1800'`.
*
* TODO(mmalerba): drop this variable. It's not being used in the code right now. We're now
* getting the string representation of a Date object from its utc representation. We're keeping
* it here for sometime, just for precaution, in case we decide to revert some of these changes
* though.
*/
_this.useUtcForDisplay = true;
_super.prototype.setLocale.call(_this, matDateLocale);
// IE does its own time zone correction, so we disable this on IE.
_this.useUtcForDisplay = !platform$$1.TRIDENT;
_this._clampDate = platform$$1.TRIDENT || platform$$1.EDGE;
return _this;
}
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.getYear = /**
* @param {?} date
* @return {?}
*/
function (date) {
return date.getFullYear();
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.getMonth = /**
* @param {?} date
* @return {?}
*/
function (date) {
return date.getMonth();
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.getDate = /**
* @param {?} date
* @return {?}
*/
function (date) {
return date.getDate();
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.getDayOfWeek = /**
* @param {?} date
* @return {?}
*/
function (date) {
return date.getDay();
};
/**
* @param {?} style
* @return {?}
*/
NativeDateAdapter.prototype.getMonthNames = /**
* @param {?} style
* @return {?}
*/
function (style) {
var _this = this;
if (SUPPORTS_INTL_API) {
/** @type {?} */
var dtf_1 = new Intl.DateTimeFormat(this.locale, { month: style, timeZone: 'utc' });
return range(12, (/**
* @param {?} i
* @return {?}
*/
function (i) {
return _this._stripDirectionalityCharacters(_this._format(dtf_1, new Date(2017, i, 1)));
}));
}
return DEFAULT_MONTH_NAMES[style];
};
/**
* @return {?}
*/
NativeDateAdapter.prototype.getDateNames = /**
* @return {?}
*/
function () {
var _this = this;
if (SUPPORTS_INTL_API) {
/** @type {?} */
var dtf_2 = new Intl.DateTimeFormat(this.locale, { day: 'numeric', timeZone: 'utc' });
return range(31, (/**
* @param {?} i
* @return {?}
*/
function (i) { return _this._stripDirectionalityCharacters(_this._format(dtf_2, new Date(2017, 0, i + 1))); }));
}
return DEFAULT_DATE_NAMES;
};
/**
* @param {?} style
* @return {?}
*/
NativeDateAdapter.prototype.getDayOfWeekNames = /**
* @param {?} style
* @return {?}
*/
function (style) {
var _this = this;
if (SUPPORTS_INTL_API) {
/** @type {?} */
var dtf_3 = new Intl.DateTimeFormat(this.locale, { weekday: style, timeZone: 'utc' });
return range(7, (/**
* @param {?} i
* @return {?}
*/
function (i) { return _this._stripDirectionalityCharacters(_this._format(dtf_3, new Date(2017, 0, i + 1))); }));
}
return DEFAULT_DAY_OF_WEEK_NAMES[style];
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.getYearName = /**
* @param {?} date
* @return {?}
*/
function (date) {
if (SUPPORTS_INTL_API) {
/** @type {?} */
var dtf = new Intl.DateTimeFormat(this.locale, { year: 'numeric', timeZone: 'utc' });
return this._stripDirectionalityCharacters(this._format(dtf, date));
}
return String(this.getYear(date));
};
/**
* @return {?}
*/
NativeDateAdapter.prototype.getFirstDayOfWeek = /**
* @return {?}
*/
function () {
// We can't tell using native JS Date what the first day of the week is, we default to Sunday.
return 0;
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.getNumDaysInMonth = /**
* @param {?} date
* @return {?}
*/
function (date) {
return this.getDate(this._createDateWithOverflow(this.getYear(date), this.getMonth(date) + 1, 0));
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.clone = /**
* @param {?} date
* @return {?}
*/
function (date) {
return new Date(date.getTime());
};
/**
* @param {?} year
* @param {?} month
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.createDate = /**
* @param {?} year
* @param {?} month
* @param {?} date
* @return {?}
*/
function (year, month, date) {
// Check for invalid month and date (except upper bound on date which we have to check after
// creating the Date).
if (month < 0 || month > 11) {
throw Error("Invalid month index \"" + month + "\". Month index has to be between 0 and 11.");
}
if (date < 1) {
throw Error("Invalid date \"" + date + "\". Date has to be greater than 0.");
}
/** @type {?} */
var result = this._createDateWithOverflow(year, month, date);
// Check that the date wasn't above the upper bound for the month, causing the month to overflow
if (result.getMonth() != month) {
throw Error("Invalid date \"" + date + "\" for month with index \"" + month + "\".");
}
return result;
};
/**
* @return {?}
*/
NativeDateAdapter.prototype.today = /**
* @return {?}
*/
function () {
return new Date();
};
/**
* @param {?} value
* @return {?}
*/
NativeDateAdapter.prototype.parse = /**
* @param {?} value
* @return {?}
*/
function (value) {
// We have no way using the native JS Date to set the parse format or locale, so we ignore these
// parameters.
if (typeof value == 'number') {
return new Date(value);
}
return value ? new Date(Date.parse(value)) : null;
};
/**
* @param {?} date
* @param {?} displayFormat
* @return {?}
*/
NativeDateAdapter.prototype.format = /**
* @param {?} date
* @param {?} displayFormat
* @return {?}
*/
function (date, displayFormat) {
if (!this.isValid(date)) {
throw Error('NativeDateAdapter: Cannot format invalid date.');
}
if (SUPPORTS_INTL_API) {
// On IE and Edge the i18n API will throw a hard error that can crash the entire app
// if we attempt to format a date whose year is less than 1 or greater than 9999.
if (this._clampDate && (date.getFullYear() < 1 || date.getFullYear() > 9999)) {
date = this.clone(date);
date.setFullYear(Math.max(1, Math.min(9999, date.getFullYear())));
}
displayFormat = __assign({}, displayFormat, { timeZone: 'utc' });
/** @type {?} */
var dtf = new Intl.DateTimeFormat(this.locale, displayFormat);
return this._stripDirectionalityCharacters(this._format(dtf, date));
}
return this._stripDirectionalityCharacters(date.toDateString());
};
/**
* @param {?} date
* @param {?} years
* @return {?}
*/
NativeDateAdapter.prototype.addCalendarYears = /**
* @param {?} date
* @param {?} years
* @return {?}
*/
function (date, years) {
return this.addCalendarMonths(date, years * 12);
};
/**
* @param {?} date
* @param {?} months
* @return {?}
*/
NativeDateAdapter.prototype.addCalendarMonths = /**
* @param {?} date
* @param {?} months
* @return {?}
*/
function (date, months) {
/** @type {?} */
var newDate = this._createDateWithOverflow(this.getYear(date), this.getMonth(date) + months, this.getDate(date));
// It's possible to wind up in the wrong month if the original month has more days than the new
// month. In this case we want to go to the last day of the desired month.
// Note: the additional + 12 % 12 ensures we end up with a positive number, since JS % doesn't
// guarantee this.
if (this.getMonth(newDate) != ((this.getMonth(date) + months) % 12 + 12) % 12) {
newDate = this._createDateWithOverflow(this.getYear(newDate), this.getMonth(newDate), 0);
}
return newDate;
};
/**
* @param {?} date
* @param {?} days
* @return {?}
*/
NativeDateAdapter.prototype.addCalendarDays = /**
* @param {?} date
* @param {?} days
* @return {?}
*/
function (date, days) {
return this._createDateWithOverflow(this.getYear(date), this.getMonth(date), this.getDate(date) + days);
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.toIso8601 = /**
* @param {?} date
* @return {?}
*/
function (date) {
return [
date.getUTCFullYear(),
this._2digit(date.getUTCMonth() + 1),
this._2digit(date.getUTCDate())
].join('-');
};
/**
* Returns the given value if given a valid Date or null. Deserializes valid ISO 8601 strings
* (https://www.ietf.org/rfc/rfc3339.txt) into valid Dates and empty string into null. Returns an
* invalid date for all other values.
*/
/**
* Returns the given value if given a valid Date or null. Deserializes valid ISO 8601 strings
* (https://www.ietf.org/rfc/rfc3339.txt) into valid Dates and empty string into null. Returns an
* invalid date for all other values.
* @param {?} value
* @return {?}
*/
NativeDateAdapter.prototype.deserialize = /**
* Returns the given value if given a valid Date or null. Deserializes valid ISO 8601 strings
* (https://www.ietf.org/rfc/rfc3339.txt) into valid Dates and empty string into null. Returns an
* invalid date for all other values.
* @param {?} value
* @return {?}
*/
function (value) {
if (typeof value === 'string') {
if (!value) {
return null;
}
// The `Date` constructor accepts formats other than ISO 8601, so we need to make sure the
// string is the right format first.
if (ISO_8601_REGEX.test(value)) {
/** @type {?} */
var date = new Date(value);
if (this.isValid(date)) {
return date;
}
}
}
return _super.prototype.deserialize.call(this, value);
};
/**
* @param {?} obj
* @return {?}
*/
NativeDateAdapter.prototype.isDateInstance = /**
* @param {?} obj
* @return {?}
*/
function (obj) {
return obj instanceof Date;
};
/**
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype.isValid = /**
* @param {?} date
* @return {?}
*/
function (date) {
return !isNaN(date.getTime());
};
/**
* @return {?}
*/
NativeDateAdapter.prototype.invalid = /**
* @return {?}
*/
function () {
return new Date(NaN);
};
/** Creates a date but allows the month and date to overflow. */
/**
* Creates a date but allows the month and date to overflow.
* @private
* @param {?} year
* @param {?} month
* @param {?} date
* @return {?}
*/
NativeDateAdapter.prototype._createDateWithOverflow = /**
* Creates a date but allows the month and date to overflow.
* @private
* @param {?} year
* @param {?} month
* @param {?} date
* @return {?}
*/
function (year, month, date) {
/** @type {?} */
var result = new Date(year, month, date);
// We need to correct for the fact that JS native Date treats years in range [0, 99] as
// abbreviations for 19xx.
if (year >= 0 && year < 100) {
result.setFullYear(this.getYear(result) - 1900);
}
return result;
};
/**
* Pads a number to make it two digits.
* @param n The number to pad.
* @returns The padded number.
*/
/**
* Pads a number to make it two digits.
* @private
* @param {?} n The number to pad.
* @return {?} The padded number.
*/
NativeDateAdapter.prototype._2digit = /**
* Pads a number to make it two digits.
* @private
* @param {?} n The number to pad.
* @return {?} The padded number.
*/
function (n) {
return ('00' + n).slice(-2);
};
/**
* Strip out unicode LTR and RTL characters. Edge and IE insert these into formatted dates while
* other browsers do not. We remove them to make output consistent and because they interfere with
* date parsing.
* @param str The string to strip direction characters from.
* @returns The stripped string.
*/
/**
* Strip out unicode LTR and RTL characters. Edge and IE insert these into formatted dates while
* other browsers do not. We remove them to make output consistent and because they interfere with
* date parsing.
* @private
* @param {?} str The string to strip direction characters from.
* @return {?} The stripped string.
*/
NativeDateAdapter.prototype._stripDirectionalityCharacters = /**
* Strip out unicode LTR and RTL characters. Edge and IE insert these into formatted dates while
* other browsers do not. We remove them to make output consistent and because they interfere with
* date parsing.
* @private
* @param {?} str The string to strip direction characters from.
* @return {?} The stripped string.
*/
function (str) {
return str.replace(/[\u200e\u200f]/g, '');
};
/**
* When converting Date object to string, javascript built-in functions may return wrong
* results because it applies its internal DST rules. The DST rules around the world change
* very frequently, and the current valid rule is not always valid in previous years though.
* We work around this problem building a new Date object which has its internal UTC
* representation with the local date and time.
* @param dtf Intl.DateTimeFormat object, containg the desired string format. It must have
* timeZone set to 'utc' to work fine.
* @param date Date from which we want to get the string representation according to dtf
* @returns A Date object with its UTC representation based on the passed i