@angular/material
Version:
Angular Material
557 lines (547 loc) • 20.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 { InjectionToken, Component, ViewChild, ElementRef, ChangeDetectionStrategy, ViewEncapsulation, ChangeDetectorRef, EventEmitter, Inject, Optional, TemplateRef, Injectable, Injector, SkipSelf, NgModule } from '@angular/core';
import { ESCAPE } from '@angular/cdk/keycodes';
import { merge, Subject, of } from 'rxjs';
import { filter, take } from 'rxjs/operators';
import { animate, state, style, transition, trigger } from '@angular/animations';
import { AnimationCurves, AnimationDurations, MatCommonModule } from '@angular/material/core';
import { BasePortalOutlet, CdkPortalOutlet, ComponentPortal, TemplatePortal, PortalInjector, PortalModule } from '@angular/cdk/portal';
import { BreakpointObserver, Breakpoints } from '@angular/cdk/layout';
import { DOCUMENT, CommonModule } from '@angular/common';
import { FocusTrapFactory } from '@angular/cdk/a11y';
import { Overlay, OverlayConfig, OverlayModule } from '@angular/cdk/overlay';
import { Directionality } from '@angular/cdk/bidi';
/**
* @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 bottom sheet.
*/
const /** @type {?} */ MAT_BOTTOM_SHEET_DATA = new InjectionToken('MatBottomSheetData');
/**
* Configuration used when opening a bottom sheet.
* @template D
*/
class MatBottomSheetConfig {
constructor() {
/**
* Data being injected into the child component.
*/
this.data = null;
/**
* Whether the bottom sheet has a backdrop.
*/
this.hasBackdrop = true;
/**
* Whether the user can use escape or clicking outside to close the bottom sheet.
*/
this.disableClose = false;
/**
* Aria label to assign to the bottom sheet element.
*/
this.ariaLabel = null;
}
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Reference to a bottom sheet dispatched from the bottom sheet service.
* @template T, R
*/
class MatBottomSheetRef {
/**
* @param {?} containerInstance
* @param {?} _overlayRef
*/
constructor(containerInstance, _overlayRef) {
this._overlayRef = _overlayRef;
/**
* Subject for notifying the user that the bottom sheet has been dismissed.
*/
this._afterDismissed = new Subject();
/**
* Subject for notifying the user that the bottom sheet has opened and appeared.
*/
this._afterOpened = new Subject();
this.containerInstance = containerInstance;
// Emit when opening animation completes
containerInstance._animationStateChanged.pipe(filter(event => event.phaseName === 'done' && event.toState === 'visible'), take(1))
.subscribe(() => {
this._afterOpened.next();
this._afterOpened.complete();
});
// Dispose overlay when closing animation is complete
containerInstance._animationStateChanged.pipe(filter(event => event.phaseName === 'done' && event.toState === 'hidden'), take(1))
.subscribe(() => {
this._overlayRef.dispose();
this._afterDismissed.next(this._result);
this._afterDismissed.complete();
});
if (!containerInstance.bottomSheetConfig.disableClose) {
merge(_overlayRef.backdropClick(), _overlayRef._keydownEvents.pipe(filter(event => event.keyCode === ESCAPE))).subscribe(() => this.dismiss());
}
}
/**
* Dismisses the bottom sheet.
* @param {?=} result Data to be passed back to the bottom sheet opener.
* @return {?}
*/
dismiss(result) {
if (!this._afterDismissed.closed) {
// Transition the backdrop in parallel to the bottom sheet.
this.containerInstance._animationStateChanged.pipe(filter(event => event.phaseName === 'start'), take(1)).subscribe(() => this._overlayRef.detachBackdrop());
this._result = result;
this.containerInstance.exit();
}
}
/**
* Gets an observable that is notified when the bottom sheet is finished closing.
* @return {?}
*/
afterDismissed() {
return this._afterDismissed.asObservable();
}
/**
* Gets an observable that is notified when the bottom sheet has opened and appeared.
* @return {?}
*/
afterOpened() {
return this._afterOpened.asObservable();
}
/**
* Gets an observable that emits when the overlay's backdrop has been clicked.
* @return {?}
*/
backdropClick() {
return this._overlayRef.backdropClick();
}
/**
* Gets an observable that emits when keydown events are targeted on the overlay.
* @return {?}
*/
keydownEvents() {
return this._overlayRef.keydownEvents();
}
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Animations used by the Material bottom sheet.
*/
const /** @type {?} */ matBottomSheetAnimations = {
/** Animation that shows and hides a bottom sheet. */
bottomSheetState: trigger('state', [
state('void, hidden', style({ transform: 'translateY(100%)' })),
state('visible', style({ transform: 'translateY(0%)' })),
transition('visible => void, visible => hidden', animate(`${AnimationDurations.COMPLEX} ${AnimationCurves.ACCELERATION_CURVE}`)),
transition('void => visible', animate(`${AnimationDurations.EXITING} ${AnimationCurves.DECELERATION_CURVE}`)),
])
};
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Internal component that wraps user-provided bottom sheet content.
* \@docs-private
*/
class MatBottomSheetContainer extends BasePortalOutlet {
/**
* @param {?} _elementRef
* @param {?} _changeDetectorRef
* @param {?} _focusTrapFactory
* @param {?} breakpointObserver
* @param {?} _document
*/
constructor(_elementRef, _changeDetectorRef, _focusTrapFactory, breakpointObserver, _document) {
super();
this._elementRef = _elementRef;
this._changeDetectorRef = _changeDetectorRef;
this._focusTrapFactory = _focusTrapFactory;
this._document = _document;
/**
* The state of the bottom sheet animations.
*/
this._animationState = 'void';
/**
* Emits whenever the state of the animation changes.
*/
this._animationStateChanged = new EventEmitter();
/**
* Element that was focused before the bottom sheet was opened.
*/
this._elementFocusedBeforeOpened = null;
this._breakpointSubscription = breakpointObserver
.observe([Breakpoints.Medium, Breakpoints.Large, Breakpoints.XLarge])
.subscribe(() => {
this._toggleClass('mat-bottom-sheet-container-medium', breakpointObserver.isMatched(Breakpoints.Medium));
this._toggleClass('mat-bottom-sheet-container-large', breakpointObserver.isMatched(Breakpoints.Large));
this._toggleClass('mat-bottom-sheet-container-xlarge', breakpointObserver.isMatched(Breakpoints.XLarge));
});
}
/**
* Attach a component portal as content to this bottom sheet container.
* @template T
* @param {?} portal
* @return {?}
*/
attachComponentPortal(portal) {
this._validatePortalAttached();
this._setPanelClass();
this._savePreviouslyFocusedElement();
return this._portalOutlet.attachComponentPortal(portal);
}
/**
* Attach a template portal as content to this bottom sheet container.
* @template C
* @param {?} portal
* @return {?}
*/
attachTemplatePortal(portal) {
this._validatePortalAttached();
this._setPanelClass();
this._savePreviouslyFocusedElement();
return this._portalOutlet.attachTemplatePortal(portal);
}
/**
* Begin animation of bottom sheet entrance into view.
* @return {?}
*/
enter() {
if (!this._destroyed) {
this._animationState = 'visible';
this._changeDetectorRef.detectChanges();
}
}
/**
* Begin animation of the bottom sheet exiting from view.
* @return {?}
*/
exit() {
if (!this._destroyed) {
this._animationState = 'hidden';
this._changeDetectorRef.markForCheck();
}
}
/**
* @return {?}
*/
ngOnDestroy() {
this._breakpointSubscription.unsubscribe();
this._destroyed = true;
}
/**
* @param {?} event
* @return {?}
*/
_onAnimationDone(event) {
if (event.toState === 'visible') {
this._trapFocus();
}
else if (event.toState === 'hidden') {
this._restoreFocus();
}
this._animationStateChanged.emit(event);
}
/**
* @param {?} event
* @return {?}
*/
_onAnimationStart(event) {
this._animationStateChanged.emit(event);
}
/**
* @param {?} cssClass
* @param {?} add
* @return {?}
*/
_toggleClass(cssClass, add) {
const /** @type {?} */ classList = this._elementRef.nativeElement.classList;
add ? classList.add(cssClass) : classList.remove(cssClass);
}
/**
* @return {?}
*/
_validatePortalAttached() {
if (this._portalOutlet.hasAttached()) {
throw Error('Attempting to attach bottom sheet content after content is already attached');
}
}
/**
* @return {?}
*/
_setPanelClass() {
const /** @type {?} */ element = this._elementRef.nativeElement;
const /** @type {?} */ panelClass = this.bottomSheetConfig.panelClass;
if (Array.isArray(panelClass)) {
// Note that we can't use a spread here, because IE doesn't support multiple arguments.
panelClass.forEach(cssClass => element.classList.add(cssClass));
}
else if (panelClass) {
element.classList.add(panelClass);
}
}
/**
* Moves the focus inside the focus trap.
* @return {?}
*/
_trapFocus() {
if (!this._focusTrap) {
this._focusTrap = this._focusTrapFactory.create(this._elementRef.nativeElement);
}
this._focusTrap.focusInitialElementWhenReady();
}
/**
* Restores focus to the element that was focused before the bottom sheet opened.
* @return {?}
*/
_restoreFocus() {
const /** @type {?} */ toFocus = this._elementFocusedBeforeOpened;
// We need the extra check, because IE can set the `activeElement` to null in some cases.
if (toFocus && typeof toFocus.focus === 'function') {
toFocus.focus();
}
if (this._focusTrap) {
this._focusTrap.destroy();
}
}
/**
* Saves a reference to the element that was focused before the bottom sheet was opened.
* @return {?}
*/
_savePreviouslyFocusedElement() {
this._elementFocusedBeforeOpened = /** @type {?} */ (this._document.activeElement);
Promise.resolve().then(() => this._elementRef.nativeElement.focus());
}
}
MatBottomSheetContainer.decorators = [
{ type: Component, args: [{selector: 'mat-bottom-sheet-container',
template: "<ng-template cdkPortalOutlet></ng-template>",
styles: [".mat-bottom-sheet-container{box-shadow:0 8px 10px -5px rgba(0,0,0,.2),0 16px 24px 2px rgba(0,0,0,.14),0 6px 30px 5px rgba(0,0,0,.12);padding:8px 16px;min-width:100vw;box-sizing:border-box;display:block;outline:0;max-height:80vh;overflow:auto}@media screen and (-ms-high-contrast:active){.mat-bottom-sheet-container{outline:1px solid}}.mat-bottom-sheet-container-medium{min-width:384px;max-width:calc(100vw - 128px)}.mat-bottom-sheet-container-large{min-width:512px;max-width:calc(100vw - 256px)}.mat-bottom-sheet-container-xlarge{min-width:576px;max-width:calc(100vw - 384px)}"],
changeDetection: ChangeDetectionStrategy.OnPush,
encapsulation: ViewEncapsulation.None,
animations: [matBottomSheetAnimations.bottomSheetState],
host: {
'class': 'mat-bottom-sheet-container',
'tabindex': '-1',
'role': 'dialog',
'[attr.aria-label]': 'bottomSheetConfig?.ariaLabel',
'[@state]': '_animationState',
'(@state.start)': '_onAnimationStart($event)',
'(@state.done)': '_onAnimationDone($event)'
},
},] },
];
/** @nocollapse */
MatBottomSheetContainer.ctorParameters = () => [
{ type: ElementRef, },
{ type: ChangeDetectorRef, },
{ type: FocusTrapFactory, },
{ type: BreakpointObserver, },
{ type: Document, decorators: [{ type: Optional }, { type: Inject, args: [DOCUMENT,] },] },
];
MatBottomSheetContainer.propDecorators = {
"_portalOutlet": [{ type: ViewChild, args: [CdkPortalOutlet,] },],
};
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* Service to trigger Material Design bottom sheets.
*/
class MatBottomSheet {
/**
* @param {?} _overlay
* @param {?} _injector
* @param {?} _parentBottomSheet
*/
constructor(_overlay, _injector, _parentBottomSheet) {
this._overlay = _overlay;
this._injector = _injector;
this._parentBottomSheet = _parentBottomSheet;
this._bottomSheetRefAtThisLevel = null;
}
/**
* Reference to the currently opened bottom sheet.
* @return {?}
*/
get _openedBottomSheetRef() {
const /** @type {?} */ parent = this._parentBottomSheet;
return parent ? parent._openedBottomSheetRef : this._bottomSheetRefAtThisLevel;
}
/**
* @param {?} value
* @return {?}
*/
set _openedBottomSheetRef(value) {
if (this._parentBottomSheet) {
this._parentBottomSheet._openedBottomSheetRef = value;
}
else {
this._bottomSheetRefAtThisLevel = value;
}
}
/**
* @template T, D, R
* @param {?} componentOrTemplateRef
* @param {?=} config
* @return {?}
*/
open(componentOrTemplateRef, config) {
const /** @type {?} */ _config = _applyConfigDefaults(config);
const /** @type {?} */ overlayRef = this._createOverlay(_config);
const /** @type {?} */ container = this._attachContainer(overlayRef, _config);
const /** @type {?} */ ref = new MatBottomSheetRef(container, overlayRef);
if (componentOrTemplateRef instanceof TemplateRef) {
container.attachTemplatePortal(new TemplatePortal(componentOrTemplateRef, /** @type {?} */ ((null)), /** @type {?} */ ({
$implicit: _config.data,
bottomSheetRef: ref
})));
}
else {
const /** @type {?} */ portal = new ComponentPortal(componentOrTemplateRef, undefined, this._createInjector(_config, ref));
const /** @type {?} */ contentRef = container.attachComponentPortal(portal);
ref.instance = contentRef.instance;
}
// When the bottom sheet is dismissed, clear the reference to it.
ref.afterDismissed().subscribe(() => {
// Clear the bottom sheet ref if it hasn't already been replaced by a newer one.
if (this._openedBottomSheetRef == ref) {
this._openedBottomSheetRef = null;
}
});
if (this._openedBottomSheetRef) {
// If a bottom sheet is already in view, dismiss it and enter the
// new bottom sheet after exit animation is complete.
this._openedBottomSheetRef.afterDismissed().subscribe(() => ref.containerInstance.enter());
this._openedBottomSheetRef.dismiss();
}
else {
// If no bottom sheet is in view, enter the new bottom sheet.
ref.containerInstance.enter();
}
this._openedBottomSheetRef = ref;
return ref;
}
/**
* Dismisses the currently-visible bottom sheet.
* @return {?}
*/
dismiss() {
if (this._openedBottomSheetRef) {
this._openedBottomSheetRef.dismiss();
}
}
/**
* Attaches the bottom sheet container component to the overlay.
* @param {?} overlayRef
* @param {?} config
* @return {?}
*/
_attachContainer(overlayRef, config) {
const /** @type {?} */ containerPortal = new ComponentPortal(MatBottomSheetContainer, config.viewContainerRef);
const /** @type {?} */ containerRef = overlayRef.attach(containerPortal);
containerRef.instance.bottomSheetConfig = config;
return containerRef.instance;
}
/**
* Creates a new overlay and places it in the correct location.
* @param {?} config The user-specified bottom sheet config.
* @return {?}
*/
_createOverlay(config) {
const /** @type {?} */ overlayConfig = new OverlayConfig({
direction: config.direction,
hasBackdrop: config.hasBackdrop,
maxWidth: '100%',
scrollStrategy: this._overlay.scrollStrategies.block(),
positionStrategy: this._overlay.position()
.global()
.centerHorizontally()
.bottom('0')
});
if (config.backdropClass) {
overlayConfig.backdropClass = config.backdropClass;
}
return this._overlay.create(overlayConfig);
}
/**
* Creates an injector to be used inside of a bottom sheet component.
* @template T
* @param {?} config Config that was used to create the bottom sheet.
* @param {?} bottomSheetRef Reference to the bottom sheet.
* @return {?}
*/
_createInjector(config, bottomSheetRef) {
const /** @type {?} */ userInjector = config && config.viewContainerRef && config.viewContainerRef.injector;
const /** @type {?} */ injectionTokens = new WeakMap();
injectionTokens.set(MatBottomSheetRef, bottomSheetRef);
injectionTokens.set(MAT_BOTTOM_SHEET_DATA, config.data);
if (!userInjector || !userInjector.get(Directionality, null)) {
injectionTokens.set(Directionality, {
value: config.direction,
change: of()
});
}
return new PortalInjector(userInjector || this._injector, injectionTokens);
}
}
MatBottomSheet.decorators = [
{ type: Injectable },
];
/** @nocollapse */
MatBottomSheet.ctorParameters = () => [
{ type: Overlay, },
{ type: Injector, },
{ type: MatBottomSheet, decorators: [{ type: Optional }, { type: SkipSelf },] },
];
/**
* Applies default options to the bottom sheet config.
* @param {?=} config The configuration to which the defaults will be applied.
* @return {?} The new configuration object with defaults applied.
*/
function _applyConfigDefaults(config) {
return Object.assign({}, new MatBottomSheetConfig(), config);
}
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
class MatBottomSheetModule {
}
MatBottomSheetModule.decorators = [
{ type: NgModule, args: [{
imports: [
CommonModule,
OverlayModule,
MatCommonModule,
PortalModule,
],
exports: [MatBottomSheetContainer, MatCommonModule],
declarations: [MatBottomSheetContainer],
entryComponents: [MatBottomSheetContainer],
providers: [MatBottomSheet],
},] },
];
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
/**
* @fileoverview added by tsickle
* @suppress {checkTypes} checked by tsc
*/
export { MatBottomSheetModule, MatBottomSheet, MAT_BOTTOM_SHEET_DATA, MatBottomSheetConfig, MatBottomSheetContainer, matBottomSheetAnimations, MatBottomSheetRef };
//# sourceMappingURL=bottom-sheet.js.map