Dialog

A window overlaid on either the primary window or another dialog window, rendering the content underneath inert.

Loading...
 
 import { Component } from '@angular/core';
import {
    RdxDialogCloseDirective,
    RdxDialogContentDirective,
    RdxDialogDescriptionDirective,
    RdxDialogTitleDirective,
    RdxDialogTriggerDirective
} from '@radix-ng/primitives/dialog';
import { LucideAngularModule, X } from 'lucide-angular';
 
@Component({
    selector: 'dialog-demo',
    standalone: true,
    imports: [
        RdxDialogTriggerDirective,
        RdxDialogContentDirective,
        RdxDialogTitleDirective,
        RdxDialogCloseDirective,
        RdxDialogDescriptionDirective,
        LucideAngularModule
    ],
    styleUrl: 'dialog-demo.css',
    template: `
        <button class="Button violet" [rdxDialogTrigger]="dialog">Open Dialog</button>
 
        <ng-template #dialog>
            <div class="DialogContent" rdxDialogContent>
                <h2 class="DialogTitle" rdxDialogTitle>Edit profile</h2>
                <p class="DialogDescription" rdxDialogDescription>
                    Make changes to your profile here. Click save when you're done.
                </p>
                <fieldset class="Fieldset">
                    <label class="Label" htmlFor="name">Name</label>
                    <input class="Input" id="name" defaultValue="Pedro Duarte" />
                </fieldset>
                <fieldset class="Fieldset">
                    <label class="Label" htmlFor="username">Username</label>
                    <input class="Input" id="username" defaultValue="@peduarte" />
                </fieldset>
                <div style="display:flex; margin-top: 25px; justify-content: flex-end;">
                    <button class="Button green" rdxDialogClose>Save changes</button>
                </div>
                <button class="IconButton" rdxDialogClose aria-label="Close">
                    <lucide-angular [img]="XIcon" size="16" strokeWidth="2" />
                </button>
            </div>
        </ng-template>
    `
})
export class DialogDemoComponent {
    readonly XIcon = X;
}
  
 /* reset */
button,
fieldset,
input {
    all: unset;
}
 
.DialogOverlay {
    background-color: var(--black-a9);
    position: fixed;
    inset: 0;
    animation: overlayShow 150ms cubic-bezier(0.16, 1, 0.3, 1);
}
 
.DialogContent {
    background-color: white;
    border-radius: 6px;
    box-shadow:
        hsl(206 22% 7% / 35%) 0px 10px 38px -10px,
        hsl(206 22% 7% / 20%) 0px 10px 20px -15px;
    position: fixed;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
    width: 90vw;
    max-width: 450px;
    max-height: 85vh;
    padding: 25px;
    animation: contentShow 150ms cubic-bezier(0.16, 1, 0.3, 1);
}
 
.DialogContent:focus {
    outline: none;
}
 
.DialogTitle {
    margin: 0;
    font-weight: 500;
    color: var(--mauve-12);
    font-size: 17px;
}
 
.DialogDescription {
    margin: 10px 0 20px;
    color: var(--mauve-11);
    font-size: 15px;
    line-height: 1.5;
}
 
.Button {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    border-radius: 4px;
    padding: 0 15px;
    font-size: 15px;
    line-height: 1;
    font-weight: 500;
    height: 35px;
}
 
.Button.violet {
    background-color: white;
    color: var(--violet-11);
    box-shadow: 0 2px 10px var(--black-a7);
}
 
.Button.violet:hover {
    background-color: var(--mauve-3);
}
 
.Button.violet:focus {
    box-shadow: 0 0 0 2px black;
}
 
.Button.green {
    background-color: var(--green-4);
    color: var(--green-11);
}
 
.Button.green:hover {
    background-color: var(--green-5);
}
 
.Button.green:focus {
    box-shadow: 0 0 0 2px var(--green-7);
}
 
.IconButton {
    font-family: inherit;
    border-radius: 100%;
    height: 25px;
    width: 25px;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    color: var(--violet-11);
    position: absolute;
    top: 10px;
    right: 10px;
}
 
.IconButton:hover {
    background-color: var(--violet-4);
}
 
.IconButton:focus {
    box-shadow: 0 0 0 2px var(--violet-7);
}
 
.Fieldset {
    display: flex;
    gap: 20px;
    align-items: center;
    margin-bottom: 15px;
}
 
.Label {
    font-size: 15px;
    color: var(--violet-11);
    width: 90px;
    text-align: right;
}
 
.Input {
    width: 100%;
    flex: 1;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    border-radius: 4px;
    padding: 0 10px;
    font-size: 15px;
    line-height: 1;
    color: var(--violet-11);
    box-shadow: 0 0 0 1px var(--violet-7);
    height: 35px;
}
 
.Input:focus {
    box-shadow: 0 0 0 2px var(--violet-8);
}

Features

  • Supports modal and non-modal modes.
  • Focus is automatically trapped when modal.
  • Can be controlled or uncontrolled.
  • Esc closes the component automatically.

Installation

Provider

The initial configuration is defined by the provideRdxDialogConfig provider during application startup. 

 import { ApplicationConfig } from '@angular/core';
import { provideRdxDialogConfig } from '@radix-ng/primitives/dialog';
 
export const appConfig: ApplicationConfig = {
    providers: [
        provideRdxDialogConfig()
    ]
};

In the component that will open the dialog, call provideRdxDialog in the providers: 

  
import { provideRdxDialog } from '@radix-ng/primitives/dialog';
 
@Component({
  selector: 'app-dialog-component',
  providers: [provideRdxDialog()]
})
export class AppDialogComponent {}

API Reference

Trigger

Prop Default Type
id
—
InputSignal<string>

dialog
—
TemplateRef<void>

dialogConfig
—
Omit<RdxBaseDialogConfig<unknown>, "data">

Data Attribute Value
[data-state]
"open" | "closed"

Content

Data Attribute Value
[data-state]
"open" | "closed"

Accessibility

Adheres to the Dialog WAI-ARIA design pattern .

Usage

Service

To open a dialog via the service, simply call the RdxDialogService.open() 

 @Component({...})
export class AppComponent {
    #dialog = inject(RdxDialogService);
 
    openDialog() {
        const dialogRef = this.#dialog.open({
            content: MyDialogContentComponent,
        });
    }
}

Inject Data to the Dialog 

 this.#dialog.open({
  content: MyDialogContentComponent,
  data: { name: 'Pedro Duarte' }
});

This ensures all type definitions are centralized in the component.

  • Use injectDialogData to retrieve data and let the service infer the expected data type.
  • Use injectDialogRef to declare the return type for better typing in DialogRef . 
 @Component({
  selector: 'app-custom-dialog'
})
export class AppCustomDialogComponent {
 
  readonly data = injectDialogData<{ name: string; username?: string }>();
 
  readonly ref = injectDialogRef<boolean>();
 
  close(): void {
    this.ref.close(true);
  }
}