@angular/material
Version:
Angular Material
715 lines (704 loc) • 26.2 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 { Subject } from 'rxjs';
import { InjectionToken, Component, ViewEncapsulation, Inject, ChangeDetectionStrategy, ChangeDetectorRef, ElementRef, NgZone, ViewChild, Injectable, Injector, Optional, SkipSelf, TemplateRef, NgModule } from '@angular/core';
import { animate, state, style, transition, trigger } from '@angular/animations';
import { AnimationCurves, AnimationDurations, MatCommonModule } from '@angular/material/core';
import { BasePortalOutlet, CdkPortalOutlet, ComponentPortal, PortalInjector, TemplatePortal, PortalModule } from '@angular/cdk/portal';
import { take, takeUntil } from 'rxjs/operators';
import { LiveAnnouncer } from '@angular/cdk/a11y';
import { BreakpointObserver, Breakpoints } from '@angular/cdk/layout';
import { Overlay, OverlayConfig, OverlayModule } from '@angular/cdk/overlay';
import { CommonModule } from '@angular/common';
import { MatButtonModule } from '@angular/material/button';
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Reference to a snack bar dispatched from the snack bar service.
* @template T
*/
class MatSnackBarRef {
/**
* @param {?} containerInstance
* @param {?} _overlayRef
*/
constructor(containerInstance, _overlayRef) {
this._overlayRef = _overlayRef;
/**
* Subject for notifying the user that the snack bar has been dismissed.
*/
this._afterDismissed = new Subject();
/**
* Subject for notifying the user that the snack bar has opened and appeared.
*/
this._afterOpened = new Subject();
/**
* Subject for notifying the user that the snack bar action was called.
*/
this._onAction = new Subject();
/**
* Whether the snack bar was dismissed using the action button.
*/
this._dismissedByAction = false;
this.containerInstance = containerInstance;
// Dismiss snackbar on action.
this.onAction().subscribe(() => this.dismiss());
containerInstance._onExit.subscribe(() => this._finishDismiss());
}
/**
* Dismisses the snack bar.
* @return {?}
*/
dismiss() {
if (!this._afterDismissed.closed) {
this.containerInstance.exit();
}
clearTimeout(this._durationTimeoutId);
}
/**
* Marks the snackbar action clicked.
* @return {?}
*/
dismissWithAction() {
if (!this._onAction.closed) {
this._dismissedByAction = true;
this._onAction.next();
this._onAction.complete();
}
}
/**
* Marks the snackbar action clicked.
* @deprecated Use `dismissWithAction` instead.
* \@deletion-target 7.0.0
* @return {?}
*/
closeWithAction() {
this.dismissWithAction();
}
/**
* Dismisses the snack bar after some duration
* @param {?} duration
* @return {?}
*/
_dismissAfter(duration) {
this._durationTimeoutId = setTimeout(() => this.dismiss(), duration);
}
/**
* Marks the snackbar as opened
* @return {?}
*/
_open() {
if (!this._afterOpened.closed) {
this._afterOpened.next();
this._afterOpened.complete();
}
}
/**
* Cleans up the DOM after closing.
* @return {?}
*/
_finishDismiss() {
this._overlayRef.dispose();
if (!this._onAction.closed) {
this._onAction.complete();
}
this._afterDismissed.next({ dismissedByAction: this._dismissedByAction });
this._afterDismissed.complete();
this._dismissedByAction = false;
}
/**
* Gets an observable that is notified when the snack bar is finished closing.
* @return {?}
*/
afterDismissed() {
return this._afterDismissed.asObservable();
}
/**
* Gets an observable that is notified when the snack bar has opened and appeared.
* @return {?}
*/
afterOpened() {
return this.containerInstance._onEnter;
}
/**
* Gets an observable that is notified when the snack bar action is called.
* @return {?}
*/
onAction() {
return this._onAction.asObservable();
}
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Injection token that can be used to access the data that was passed in to a snack bar.
*/
const /** @type {?} */ MAT_SNACK_BAR_DATA = new InjectionToken('MatSnackBarData');
/**
* Configuration used when opening a snack-bar.
* @template D
*/
class MatSnackBarConfig {
constructor() {
/**
* The politeness level for the MatAriaLiveAnnouncer announcement.
*/
this.politeness = 'assertive';
/**
* Message to be announced by the MatAriaLiveAnnouncer
*/
this.announcementMessage = '';
/**
* The length of time in milliseconds to wait before automatically dismissing the snack bar.
*/
this.duration = 0;
/**
* Data being injected into the child component.
*/
this.data = null;
/**
* The horizontal position to place the snack bar.
*/
this.horizontalPosition = 'center';
/**
* The vertical position to place the snack bar.
*/
this.verticalPosition = 'bottom';
}
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Animations used by the Material snack bar.
*/
const /** @type {?} */ matSnackBarAnimations = {
/** Animation that slides the dialog in and out of view and fades the opacity. */
contentFade: trigger('contentFade', [
transition(':enter', [
style({ opacity: '0' }),
animate(`${AnimationDurations.COMPLEX} ${AnimationCurves.STANDARD_CURVE}`)
])
]),
/** Animation that shows and hides a snack bar. */
snackBarState: trigger('state', [
state('visible-top, visible-bottom', style({ transform: 'translateY(0%)' })),
transition('visible-top => hidden-top, visible-bottom => hidden-bottom', animate(`${AnimationDurations.EXITING} ${AnimationCurves.ACCELERATION_CURVE}`)),
transition('void => visible-top, void => visible-bottom', animate(`${AnimationDurations.ENTERING} ${AnimationCurves.DECELERATION_CURVE}`)),
])
};
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* A component used to open as the default snack bar, matching material spec.
* This should only be used internally by the snack bar service.
*/
class SimpleSnackBar {
/**
* @param {?} snackBarRef
* @param {?} data
*/
constructor(snackBarRef, data) {
this.snackBarRef = snackBarRef;
this.data = data;
}
/**
* Performs the action on the snack bar.
* @return {?}
*/
action() {
this.snackBarRef.dismissWithAction();
}
/**
* If the action button should be shown.
* @return {?}
*/
get hasAction() {
return !!this.data.action;
}
}
SimpleSnackBar.decorators = [
{ type: Component, args: [{selector: 'simple-snack-bar',
template: "{{data.message}}<div class=\"mat-simple-snackbar-action\" *ngIf=\"hasAction\"><button mat-button (click)=\"action()\">{{data.action}}</button></div>",
styles: [".mat-simple-snackbar{display:flex;justify-content:space-between;line-height:20px;opacity:1}.mat-simple-snackbar-action{display:flex;flex-direction:column;flex-shrink:0;justify-content:space-around;margin:-8px 0 -8px 8px}.mat-simple-snackbar-action button{flex:1;max-height:36px}[dir=rtl] .mat-simple-snackbar-action{margin-left:0;margin-right:8px}"],
encapsulation: ViewEncapsulation.None,
changeDetection: ChangeDetectionStrategy.OnPush,
animations: [matSnackBarAnimations.contentFade],
host: {
'[@contentFade]': '',
'class': 'mat-simple-snackbar',
}
},] },
];
/** @nocollapse */
SimpleSnackBar.ctorParameters = () => [
{ type: MatSnackBarRef, },
{ type: undefined, decorators: [{ type: Inject, args: [MAT_SNACK_BAR_DATA,] },] },
];
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Internal component that wraps user-provided snack bar content.
* \@docs-private
*/
class MatSnackBarContainer extends BasePortalOutlet {
/**
* @param {?} _ngZone
* @param {?} _elementRef
* @param {?} _changeDetectorRef
*/
constructor(_ngZone, _elementRef, _changeDetectorRef) {
super();
this._ngZone = _ngZone;
this._elementRef = _elementRef;
this._changeDetectorRef = _changeDetectorRef;
/**
* Whether the component has been destroyed.
*/
this._destroyed = false;
/**
* Subject for notifying that the snack bar has exited from view.
*/
this._onExit = new Subject();
/**
* Subject for notifying that the snack bar has finished entering the view.
*/
this._onEnter = new Subject();
/**
* The state of the snack bar animations.
*/
this._animationState = 'void';
}
/**
* Attach a component portal as content to this snack bar container.
* @template T
* @param {?} portal
* @return {?}
*/
attachComponentPortal(portal) {
this._assertNotAttached();
this._applySnackBarClasses();
return this._portalOutlet.attachComponentPortal(portal);
}
/**
* Attach a template portal as content to this snack bar container.
* @template C
* @param {?} portal
* @return {?}
*/
attachTemplatePortal(portal) {
this._assertNotAttached();
this._applySnackBarClasses();
return this._portalOutlet.attachTemplatePortal(portal);
}
/**
* Handle end of animations, updating the state of the snackbar.
* @param {?} event
* @return {?}
*/
onAnimationEnd(event) {
const { fromState, toState } = event;
if ((toState === 'void' && fromState !== 'void') || toState.startsWith('hidden')) {
this._completeExit();
}
if (toState.startsWith('visible')) {
// Note: we shouldn't use `this` inside the zone callback,
// because it can cause a memory leak.
const /** @type {?} */ onEnter = this._onEnter;
this._ngZone.run(() => {
onEnter.next();
onEnter.complete();
});
}
}
/**
* Begin animation of snack bar entrance into view.
* @return {?}
*/
enter() {
if (!this._destroyed) {
this._animationState = `visible-${this.snackBarConfig.verticalPosition}`;
this._changeDetectorRef.detectChanges();
}
}
/**
* Begin animation of the snack bar exiting from view.
* @return {?}
*/
exit() {
this._animationState = `hidden-${this.snackBarConfig.verticalPosition}`;
return this._onExit;
}
/**
* Makes sure the exit callbacks have been invoked when the element is destroyed.
* @return {?}
*/
ngOnDestroy() {
this._destroyed = true;
this._completeExit();
}
/**
* Waits for the zone to settle before removing the element. Helps prevent
* errors where we end up removing an element which is in the middle of an animation.
* @return {?}
*/
_completeExit() {
this._ngZone.onMicrotaskEmpty.asObservable().pipe(take(1)).subscribe(() => {
this._onExit.next();
this._onExit.complete();
});
}
/**
* Applies the various positioning and user-configured CSS classes to the snack bar.
* @return {?}
*/
_applySnackBarClasses() {
const /** @type {?} */ element = this._elementRef.nativeElement;
const /** @type {?} */ panelClasses = this.snackBarConfig.panelClass;
if (panelClasses) {
if (Array.isArray(panelClasses)) {
// Note that we can't use a spread here, because IE doesn't support multiple arguments.
panelClasses.forEach(cssClass => element.classList.add(cssClass));
}
else {
element.classList.add(panelClasses);
}
}
if (this.snackBarConfig.horizontalPosition === 'center') {
element.classList.add('mat-snack-bar-center');
}
if (this.snackBarConfig.verticalPosition === 'top') {
element.classList.add('mat-snack-bar-top');
}
}
/**
* Asserts that no content is already attached to the container.
* @return {?}
*/
_assertNotAttached() {
if (this._portalOutlet.hasAttached()) {
throw Error('Attempting to attach snack bar content after content is already attached');
}
}
}
MatSnackBarContainer.decorators = [
{ type: Component, args: [{selector: 'snack-bar-container',
template: "<ng-template cdkPortalOutlet></ng-template>",
styles: [".mat-snack-bar-container{border-radius:2px;box-sizing:border-box;display:block;margin:24px;max-width:568px;min-width:288px;padding:14px 24px;transform:translateY(100%) translateY(24px)}.mat-snack-bar-container.mat-snack-bar-center{margin:0;transform:translateY(100%)}.mat-snack-bar-container.mat-snack-bar-top{transform:translateY(-100%) translateY(-24px)}.mat-snack-bar-container.mat-snack-bar-top.mat-snack-bar-center{transform:translateY(-100%)}@media screen and (-ms-high-contrast:active){.mat-snack-bar-container{border:solid 1px}}.mat-snack-bar-handset{width:100%}.mat-snack-bar-handset .mat-snack-bar-container{margin:0;max-width:inherit;width:100%}"],
changeDetection: ChangeDetectionStrategy.OnPush,
encapsulation: ViewEncapsulation.None,
animations: [matSnackBarAnimations.snackBarState],
host: {
'role': 'alert',
'class': 'mat-snack-bar-container',
'[@state]': '_animationState',
'(@state.done)': 'onAnimationEnd($event)'
},
},] },
];
/** @nocollapse */
MatSnackBarContainer.ctorParameters = () => [
{ type: NgZone, },
{ type: ElementRef, },
{ type: ChangeDetectorRef, },
];
MatSnackBarContainer.propDecorators = {
"_portalOutlet": [{ type: ViewChild, args: [CdkPortalOutlet,] },],
};
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Injection token that can be used to specify default snack bar.
*/
const /** @type {?} */ MAT_SNACK_BAR_DEFAULT_OPTIONS = new InjectionToken('mat-snack-bar-default-options', {
providedIn: 'root',
factory: () => new MatSnackBarConfig(),
});
/**
* Service to dispatch Material Design snack bar messages.
*/
class MatSnackBar {
/**
* @param {?} _overlay
* @param {?} _live
* @param {?} _injector
* @param {?} _breakpointObserver
* @param {?} _parentSnackBar
* @param {?} _defaultConfig
*/
constructor(_overlay, _live, _injector, _breakpointObserver, _parentSnackBar, _defaultConfig) {
this._overlay = _overlay;
this._live = _live;
this._injector = _injector;
this._breakpointObserver = _breakpointObserver;
this._parentSnackBar = _parentSnackBar;
this._defaultConfig = _defaultConfig;
/**
* Reference to the current snack bar in the view *at this level* (in the Angular injector tree).
* If there is a parent snack-bar service, all operations should delegate to that parent
* via `_openedSnackBarRef`.
*/
this._snackBarRefAtThisLevel = null;
}
/**
* Reference to the currently opened snackbar at *any* level.
* @return {?}
*/
get _openedSnackBarRef() {
const /** @type {?} */ parent = this._parentSnackBar;
return parent ? parent._openedSnackBarRef : this._snackBarRefAtThisLevel;
}
/**
* @param {?} value
* @return {?}
*/
set _openedSnackBarRef(value) {
if (this._parentSnackBar) {
this._parentSnackBar._openedSnackBarRef = value;
}
else {
this._snackBarRefAtThisLevel = value;
}
}
/**
* Creates and dispatches a snack bar with a custom component for the content, removing any
* currently opened snack bars.
*
* @template T
* @param {?} component Component to be instantiated.
* @param {?=} config Extra configuration for the snack bar.
* @return {?}
*/
openFromComponent(component, config) {
return /** @type {?} */ (this._attach(component, config));
}
/**
* Creates and dispatches a snack bar with a custom template for the content, removing any
* currently opened snack bars.
*
* @param {?} template Template to be instantiated.
* @param {?=} config Extra configuration for the snack bar.
* @return {?}
*/
openFromTemplate(template, config) {
return this._attach(template, config);
}
/**
* Opens a snackbar with a message and an optional action.
* @param {?} message The message to show in the snackbar.
* @param {?=} action The label for the snackbar action.
* @param {?=} config Additional configuration options for the snackbar.
* @return {?}
*/
open(message, action = '', config) {
const /** @type {?} */ _config = Object.assign({}, this._defaultConfig, config);
// Since the user doesn't have access to the component, we can
// override the data to pass in our own message and action.
_config.data = { message, action };
_config.announcementMessage = message;
return this.openFromComponent(SimpleSnackBar, _config);
}
/**
* Dismisses the currently-visible snack bar.
* @return {?}
*/
dismiss() {
if (this._openedSnackBarRef) {
this._openedSnackBarRef.dismiss();
}
}
/**
* Attaches the snack bar container component to the overlay.
* @param {?} overlayRef
* @param {?} config
* @return {?}
*/
_attachSnackBarContainer(overlayRef, config) {
const /** @type {?} */ containerPortal = new ComponentPortal(MatSnackBarContainer, config.viewContainerRef);
const /** @type {?} */ containerRef = overlayRef.attach(containerPortal);
containerRef.instance.snackBarConfig = config;
return containerRef.instance;
}
/**
* Places a new component or a template as the content of the snack bar container.
* @template T
* @param {?} content
* @param {?=} userConfig
* @return {?}
*/
_attach(content, userConfig) {
const /** @type {?} */ config = Object.assign({}, this._defaultConfig, userConfig);
const /** @type {?} */ overlayRef = this._createOverlay(config);
const /** @type {?} */ container = this._attachSnackBarContainer(overlayRef, config);
const /** @type {?} */ snackBarRef = new MatSnackBarRef(container, overlayRef);
if (content instanceof TemplateRef) {
const /** @type {?} */ portal = new TemplatePortal(content, /** @type {?} */ ((null)), /** @type {?} */ ({
$implicit: config.data,
snackBarRef
}));
snackBarRef.instance = container.attachTemplatePortal(portal);
}
else {
const /** @type {?} */ injector = this._createInjector(config, snackBarRef);
const /** @type {?} */ portal = new ComponentPortal(content, undefined, injector);
const /** @type {?} */ contentRef = container.attachComponentPortal(portal);
// We can't pass this via the injector, because the injector is created earlier.
snackBarRef.instance = contentRef.instance;
}
// Subscribe to the breakpoint observer and attach the mat-snack-bar-handset class as
// appropriate. This class is applied to the overlay element because the overlay must expand to
// fill the width of the screen for full width snackbars.
this._breakpointObserver.observe(Breakpoints.Handset).pipe(takeUntil(overlayRef.detachments().pipe(take(1)))).subscribe(state$$1 => {
if (state$$1.matches) {
overlayRef.overlayElement.classList.add('mat-snack-bar-handset');
}
else {
overlayRef.overlayElement.classList.remove('mat-snack-bar-handset');
}
});
this._animateSnackBar(snackBarRef, config);
this._openedSnackBarRef = snackBarRef;
return this._openedSnackBarRef;
}
/**
* Animates the old snack bar out and the new one in.
* @param {?} snackBarRef
* @param {?} config
* @return {?}
*/
_animateSnackBar(snackBarRef, config) {
// When the snackbar is dismissed, clear the reference to it.
snackBarRef.afterDismissed().subscribe(() => {
// Clear the snackbar ref if it hasn't already been replaced by a newer snackbar.
if (this._openedSnackBarRef == snackBarRef) {
this._openedSnackBarRef = null;
}
});
if (this._openedSnackBarRef) {
// If a snack bar is already in view, dismiss it and enter the
// new snack bar after exit animation is complete.
this._openedSnackBarRef.afterDismissed().subscribe(() => {
snackBarRef.containerInstance.enter();
});
this._openedSnackBarRef.dismiss();
}
else {
// If no snack bar is in view, enter the new snack bar.
snackBarRef.containerInstance.enter();
}
// If a dismiss timeout is provided, set up dismiss based on after the snackbar is opened.
if (config.duration && config.duration > 0) {
snackBarRef.afterOpened().subscribe(() => snackBarRef._dismissAfter(/** @type {?} */ ((config.duration))));
}
if (config.announcementMessage) {
this._live.announce(config.announcementMessage, config.politeness);
}
}
/**
* Creates a new overlay and places it in the correct location.
* @param {?} config The user-specified snack bar config.
* @return {?}
*/
_createOverlay(config) {
const /** @type {?} */ overlayConfig = new OverlayConfig();
overlayConfig.direction = config.direction;
let /** @type {?} */ positionStrategy = this._overlay.position().global();
// Set horizontal position.
const /** @type {?} */ isRtl = config.direction === 'rtl';
const /** @type {?} */ isLeft = (config.horizontalPosition === 'left' ||
(config.horizontalPosition === 'start' && !isRtl) ||
(config.horizontalPosition === 'end' && isRtl));
const /** @type {?} */ isRight = !isLeft && config.horizontalPosition !== 'center';
if (isLeft) {
positionStrategy.left('0');
}
else if (isRight) {
positionStrategy.right('0');
}
else {
positionStrategy.centerHorizontally();
}
// Set horizontal position.
if (config.verticalPosition === 'top') {
positionStrategy.top('0');
}
else {
positionStrategy.bottom('0');
}
overlayConfig.positionStrategy = positionStrategy;
return this._overlay.create(overlayConfig);
}
/**
* Creates an injector to be used inside of a snack bar component.
* @template T
* @param {?} config Config that was used to create the snack bar.
* @param {?} snackBarRef Reference to the snack bar.
* @return {?}
*/
_createInjector(config, snackBarRef) {
const /** @type {?} */ userInjector = config && config.viewContainerRef && config.viewContainerRef.injector;
const /** @type {?} */ injectionTokens = new WeakMap();
injectionTokens.set(MatSnackBarRef, snackBarRef);
injectionTokens.set(MAT_SNACK_BAR_DATA, config.data);
return new PortalInjector(userInjector || this._injector, injectionTokens);
}
}
MatSnackBar.decorators = [
{ type: Injectable },
];
/** @nocollapse */
MatSnackBar.ctorParameters = () => [
{ type: Overlay, },
{ type: LiveAnnouncer, },
{ type: Injector, },
{ type: BreakpointObserver, },
{ type: MatSnackBar, decorators: [{ type: Optional }, { type: SkipSelf },] },
{ type: MatSnackBarConfig, decorators: [{ type: Inject, args: [MAT_SNACK_BAR_DEFAULT_OPTIONS,] },] },
];
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
class MatSnackBarModule {
}
MatSnackBarModule.decorators = [
{ type: NgModule, args: [{
imports: [
OverlayModule,
PortalModule,
CommonModule,
MatButtonModule,
MatCommonModule,
],
exports: [MatSnackBarContainer, MatCommonModule],
declarations: [MatSnackBarContainer, SimpleSnackBar],
entryComponents: [MatSnackBarContainer, SimpleSnackBar],
providers: [MatSnackBar]
},] },
];
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
export { MatSnackBarModule, MAT_SNACK_BAR_DEFAULT_OPTIONS, MatSnackBar, MatSnackBarContainer, MAT_SNACK_BAR_DATA, MatSnackBarConfig, MatSnackBarRef, SimpleSnackBar, matSnackBarAnimations };
//# sourceMappingURL=snack-bar.js.map