### File

`src/modal/modal.component.ts`

### Description

Component to create modals for presenting content.

See demo

Using a modal in your application requires `ibm-placeholder` which would generally be placed near the end of your app component template (app.component.ts or app.component.html) as:

    <ibm-modal-placeholder></ibm-modal-placeholder>

A more complete example for `Modal` is given as follows:

Example modal definition:

    @Component({
        selector: "app-sample-modal",
        template: `
            <ibm-modal size="xl" (overlaySelected)="closeModal()">
                <ibm-modal-header (closeSelect)="closeModal()">Header text</ibm-modal-header>
                    <section class="modal-body">
                        <h1>Sample modal works.</h1>
                        <button class="btn--icon-link" nPopover="Hello there" title="Popover title" placement="right" appendInline="true">
                            <ibm-icon icon="info" size="sm"></ibm-icon>
                        </button>
                        {{modalText}}
                    </section>
                <ibm-modal-footer><button ibmButton="primary" (click)="closeModal()">Close</button></ibm-modal-footer>
            </ibm-modal>`,
        styleUrls: ["./sample-modal.component.scss"]
    })
    export class SampleModal extends BaseModal {
        modalText: string;
        constructor(protected injector: Injector) {
            super();
            this.modalText = this.injector.get("modalText");
        }
    }

Example of opening the modal:

    @Component({
        selector: "app-modal-demo",
        template: `
            <button ibmButton="primary" (click)="openModal('drill')">Drill-down modal</button>
            <ibm-placeholder></ibm-placeholder>`
    })
    export class ModalDemo {
        openModal() {
            this.modalService.create({component: SampleModal, inputs: {modalText: "Hello universe."}});
        }
    }

../../iframe.html?id=modal--basic

### Implements

`AfterViewInit` `OnInit` `OnDestroy`

### Example

### Metadata

selector | `ibm-modal`

template

    <ibm-overlay [theme]="theme" (overlaySelect)="overlaySelected.emit()">
    	<div
    		class="bx--modal-container"
    		[@modalState]="modalState"
    		role="dialog"
    		aria-modal="true"
    		style="z-index:1;"
    		[attr.aria-label]="modalLabel"
    		#modal>
    		<ng-content></ng-content>
    	</div>
    </ibm-overlay>

### Index

###### Properties

- modal
- Public modalService
- modalState
- selectorPrimaryFocus

###### Methods

- ngAfterViewInit
- ngOnDestroy
- ngOnInit

###### Inputs

- modalLabel
- size
- theme

###### Outputs

- close
- overlaySelected

###### HostListeners

- keydown

### Constructor

`constructor(modalService: ModalService)`
Defined in src/modal/modal.component.ts:153

Creates an instance of `Modal`.

Parameters :

Name | Type | Optional
modalService | `ModalService` | No

### Inputs

`modalLabel` | Label for the modal. Default value : `"default"`
Defined in src/modal/modal.component.ts:130

`size` | Size of the modal to display. Type : `"sm" | "md" | "lg" | "xl" | "xxl"` Default value : `"md"`
Defined in src/modal/modal.component.ts:121

`theme` | Classification of the modal. Type : `"default" | "danger"` Default value : `"default"`
Defined in src/modal/modal.component.ts:125

### Outputs

`close` | To emit the closing event of the modal window. `$event` Type: `EventEmitter`
Defined in src/modal/modal.component.ts:139

`overlaySelected` | Emits event when click occurs within `n-overlay` element. This is to track click events occurring outside bounds of the `Modal` object. `$event` Type: `EventEmitter`
Defined in src/modal/modal.component.ts:135

### HostListeners

keydown
Arguments : `'$event'`
`keydown(event: KeyboardEvent)`
Defined in src/modal/modal.component.ts:194
Handle keyboard events to close modal and tab through the content within the modal.

### Methods

ngAfterViewInit
`ngAfterViewInit()`
Defined in src/modal/modal.component.ts:170
Set document focus to be on the modal component after it is initialized. Returns : `void`

ngOnDestroy
`ngOnDestroy()`
Defined in src/modal/modal.component.ts:186
Emit the close event when the modal component is destroyed. Returns : `void`

ngOnInit
`ngOnInit()`
Defined in src/modal/modal.component.ts:163
Set modalState on the modal component when it is initialized. Returns : `void`

### Properties

modal
`modal: `ElementRef``
Type : `ElementRef`
Decorators : `@ViewChild('modal')`
Defined in src/modal/modal.component.ts:143
Maintains a reference to the view DOM element of the `Modal`.

Public modalService
`modalService: `ModalService``
Type : `ModalService`
Defined in src/modal/modal.component.ts:158

modalState
`modalState: `"in" | "out"``
Type : `"in" | "out"`
Default value : `"out"`
Defined in src/modal/modal.component.ts:148
Controls the transitions of the `Modal` component.

selectorPrimaryFocus
`selectorPrimaryFocus: `string``
Type : `string`
Default value : `"[modal-primary-focus]"`
Defined in src/modal/modal.component.ts:153
An element should have 'modal-primary-focus' as an attribute to receive initial focus within the `Modal` component.

    import { ModalService } from "./modal.service";
    import {
    	AfterViewInit,
    	Component,
    	EventEmitter,
    	HostListener,
    	Input,
    	OnDestroy,
    	OnInit,
    	Output,
    	ElementRef,
    	ViewChild
    } from "@angular/core";
    import {
    	trigger,
    	state,
    	style,
    	transition,
    	animate
    } from "@angular/animations";
    import { cycleTabs, getFocusElementList } from "./../common/tab.service";

    /**
     * Component to create modals for presenting content.
     *
     * [See demo](../../?path=/story/modal--basic)
     *
     * Using a modal in your application requires `ibm-placeholder` which would generally be
     * placed near the end of your app component template (app.component.ts or app.component.html) as:
     *
    ```html
    <ibm-modal-placeholder></ibm-modal-placeholder>
    ```
     *
     * A more complete example for `Modal` is given as follows:
     *
     * Example modal definition:
     *
    ```typescript
    @Component({
    	selector: "app-sample-modal",
    	template: `
    				<ibm-modal size="xl" (overlaySelected)="closeModal()">
    					<ibm-modal-header (closeSelect)="closeModal()">Header text</ibm-modal-header>
    						<section class="modal-body">
    							<h1>Sample modal works.</h1>
    							<button class="btn--icon-link" nPopover="Hello there" title="Popover title" placement="right" appendInline="true">
    								<ibm-icon icon="info" size="sm"></ibm-icon>
    							</button>
    							{{modalText}}
    						</section>
    					<ibm-modal-footer><button ibmButton="primary" (click)="closeModal()">Close</button></ibm-modal-footer>
    				</ibm-modal>`,
    	styleUrls: ["./sample-modal.component.scss"]
    })
    export class SampleModal extends BaseModal {
    	modalText: string;
    	constructor(protected injector: Injector) {
    		super();
    		this.modalText = this.injector.get("modalText");
    	}
    }
    ```
     *
     * Example of opening the modal:
     *
    ```typescript
    @Component({
    	selector: "app-modal-demo",
    	template: `
    				<button ibmButton="primary" (click)="openModal('drill')">Drill-down modal</button>
    				<ibm-placeholder></ibm-placeholder>`
    })
    export class ModalDemo {
    	openModal() {
    		this.modalService.create({component: SampleModal, inputs: {modalText: "Hello universe."}});
    	}
    }
    ```
     *
     * <example-url>../../iframe.html?id=modal--basic</example-url>
     *
     * @export
     * @class Modal
     * @implements {AfterViewInit}
     * @implements {OnInit}
     * @implements {OnDestroy}
     */
    @Component({
    	selector: "ibm-modal",
    	template: `
    		<ibm-overlay [theme]="theme" (overlaySelect)="overlaySelected.emit()">
    			<div
    				class="bx--modal-container"
    				[@modalState]="modalState"
    				role="dialog"
    				aria-modal="true"
    				style="z-index:1;"
    				[attr.aria-label]="modalLabel"
    				#modal>
    				<ng-content></ng-content>
    			</div>
    		</ibm-overlay>
    	`,
    	animations: [
    		trigger("modalState", [
    			state("void", style({transform: "translate(0, 5%)", opacity: 0})),
    			transition(":enter", [
    				animate("200ms ease-in")
    			]),
    			transition(":leave", [
    				animate(200, style({transform: "translate(0, 5%)", opacity: 0}))
    			])
    		])
    	]
    })
    export class Modal implements AfterViewInit, OnInit, OnDestroy {
    	/**
    	 * Size of the modal to display.
    	 */
    	@Input() size: "sm" | "md" | "lg" | "xl" | "xxl" = "md";
    	/**
    	 * Classification of the modal.
    	 */
    	@Input() theme: "default" | "danger" = "default";

    	/**
    	 * Label for the modal.
    	 */
    	@Input() modalLabel = "default";

    	/**
    	 * Emits event when click occurs within `n-overlay` element. This is to track click events occurring outside bounds of the `Modal` object.
    	 */
    	@Output() overlaySelected = new EventEmitter();
    	/**
    	 * To emit the closing event of the modal window.
    	 */
    	@Output() close = new EventEmitter();
    	/**
    	 * Maintains a reference to the view DOM element of the `Modal`.
    	 */
    	@ViewChild("modal") modal: ElementRef;

    	/**
    	 * Controls the transitions of the `Modal` component.
    	 */
    	modalState: "in" | "out" = "out";

    	/**
    	 * An element should have 'modal-primary-focus' as an attribute to receive initial focus within the `Modal` component.
    	 */
    	selectorPrimaryFocus = "[modal-primary-focus]";

    	/**
    	 * Creates an instance of `Modal`.
    	 */
    	constructor(public modalService: ModalService) {}

    	/**
    	 * Set modalState on the modal component when it is initialized.
    	 */
    	ngOnInit() {
    		this.modalState = "in";
    	}

    	/**
    	 * Set document focus to be on the modal component after it is initialized.
    	 */
    	ngAfterViewInit() {
    		const primaryFocusElement = this.modal.nativeElement.querySelector(this.selectorPrimaryFocus);
    		if (primaryFocusElement && primaryFocusElement.focus) {
    			setTimeout(() => primaryFocusElement.focus());
    			return;
    		}
    		if (getFocusElementList(this.modal.nativeElement).length > 0) {
    			setTimeout(() => getFocusElementList(this.modal.nativeElement)[0].focus());
    		} else {
    			setTimeout(() => this.modal.nativeElement.focus());
    		}
    	}

    	/**
    	 * Emit the close event when the modal component is destroyed.
    	 */
    	ngOnDestroy() {
    		this.modalState = "out";
    	}

    	/**
    	 * Handle keyboard events to close modal and tab through the content within the modal.
    	 */
    	@HostListener("keydown", ["$event"])
    	handleKeyboardEvent(event: KeyboardEvent) {
    		switch (event.key) {
    			case "Escape": {
    				event.stopImmediatePropagation();  // prevents events being fired for multiple modals if more than 2 open
    				this.modalService.destroy();  // destroy top (latest) modal
    				break;
    			}

    			case "Tab": {
    				cycleTabs(event, this.modal.nativeElement);
    				break;
    			}
    		}
    	}
    }

Legend
Html element
Component
Html element with directive

# result-matching ""

# No results matching ""