GET STARTED

Import

The standalone host and injectable service share one granular entry point.

import {
  NeuralConfirmDialog,
  NeuralConfirmationService,
} from '@neural-ng/core/confirm-dialog';

@Component({ imports: [NeuralConfirmDialog] })
export class WorkspacePage {
  private readonly confirmation = inject(NeuralConfirmationService);
}

Service-driven confirmation

Render the host once. Any descendant service consumer can open it without owning a duplicate visible model.

Async action guard

While an action is pending, buttons are disabled and the accept action exposes aria-busy. Returning false deliberately keeps the dialog open.

Independent keyed hosts

Keys create deterministic channels for different layout regions or policies. Requests only reach a host with the same normalized key.

Latest same-key request wins

A new request replaces only the active request sharing its key. The previous ref completes as dismissed · replaced; no hidden queue accumulates.

Per-request options

Labels, icons, action visibility and dismissal policies can be overridden per request without changing the host.

Action errors

A thrown async action emits actionError, returns the dialog to an interactive state and leaves closing policy to the application.

Unstyled and typed slots

Native dialog behavior, modal focus, ARIA links and service state remain while every ConfirmDialog and inherited Dialog visual class is removed.

Contract boundaries

Native top layer

The underlying native dialog enters the browser top layer, blocks background interaction and remains stable during page scrolling.

Name and description

The generated heading and message IDs wire aria-labelledby and aria-describedby automatically.

Focus policy and restoration

defaultFocus selects accept, reject or no action. On close, focus returns to the element that opened the native dialog.

Keyboard

Tab remains within the modal. Shift+Tab reverses focus order. Escape follows the effective request or host policy.

Busy actions

Processing disables both choices, prevents duplicate invocation and exposes busy state on the accepting action.

Explicit dismissal policy

Close button, Escape and backdrop dismissal are independent. Destructive confirmations default to no close button and a non-dismissible backdrop.

Component inputs

Component outputs

NeuralConfirmationInput

Service API

runAction and complete are host integration methods; ordinary consumers should use the returned ref and close().

Signal-backed reference

Results and close reasons

Results

Close reasons

Typed class slots

Public types

Component tokens

Inherited Dialog tokens