@synergy-design-system/angular/components/dialog/index.d.ts

Angular wrappers for the Synergy Design System

import * as i0 from '@angular/core';
import { ElementRef, NgZone, EventEmitter } from '@angular/core';
import { SynDialog, SynShowEvent, SynAfterShowEvent, SynHideEvent, SynAfterHideEvent, SynInitialFocusEvent, SynRequestCloseEvent } from '@synergy-design-system/components';
export { SynAfterHideEvent, SynAfterShowEvent, SynHideEvent, SynInitialFocusEvent, SynRequestCloseEvent, SynShowEvent } from '@synergy-design-system/components';

/**
 * @summary Dialogs, sometimes called "modals", appear above the page and require the user's immediate attention.
 * @documentation https://synergy-design-system.github.io/?path=/docs/components-syn-dialog--docs
 * @status stable
 * @since 2.0
 *
 * @dependency syn-icon-button
 *
 * @slot - The dialog's main content.
 * @slot label - The dialog's label. Alternatively, you can use the `label` attribute.
 * @slot header-actions - Optional actions to add to the header. Works best with `<syn-icon-button>`.
 * @slot footer - The dialog's footer, usually one or more buttons representing various options.
 *
 * @event syn-show - Emitted when the dialog opens.
 * @event syn-after-show - Emitted after the dialog opens and all animations are complete.
 * @event syn-hide - Emitted when the dialog closes.
 * @event syn-after-hide - Emitted after the dialog closes and all animations are complete.
 * @event syn-initial-focus - Emitted when the dialog opens and is ready to receive focus. Calling
 *   `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.
 * @event {{ source: 'close-button' | 'keyboard' | 'overlay' }} syn-request-close - Emitted when the user attempts to
 *   close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling
 *   `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in
 *   destructive behavior such as data loss.
 *
 * @csspart base - The component's base wrapper.
 * @csspart overlay - The overlay that covers the screen behind the dialog.
 * @csspart panel - The dialog's panel (where the dialog and its content are rendered).
 * @csspart header - The dialog's header. This element wraps the title and header actions.
 * @csspart header-actions - Optional actions to add to the header. Works best with `<syn-icon-button>`.
 * @csspart title - The dialog's title.
 * @csspart close-button - The close button, an `<syn-icon-button>`.
 * @csspart close-button__base - The close button's exported `base` part.
 * @csspart body - The dialog's body.
 * @csspart footer - The dialog's footer.
 *
 * @cssproperty --width - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens.
 * @cssproperty --header-spacing - The amount of padding to use for the header.
 * @cssproperty --body-spacing - The amount of padding to use for the body.
 * @cssproperty --footer-spacing - The amount of padding to use for the footer.
 *
 * @animation dialog.show - The animation to use when showing the dialog.
 * @animation dialog.hide - The animation to use when hiding the dialog.
 * @animation dialog.denyClose - The animation to use when a request to close the dialog is denied.
 * @animation dialog.overlay.show - The animation to use when showing the dialog's overlay.
 * @animation dialog.overlay.hide - The animation to use when hiding the dialog's overlay.
 *
 * @property modal - Exposes the internal modal utility that controls focus trapping. To temporarily disable focus
 *   trapping and allow third-party modals spawned from an active Synergy modal, call `modal.activateExternal()` when
 *   the third-party modal opens. Upon closing, call `modal.deactivateExternal()` to restore Synergy's focus trapping.
 */
declare class SynDialogComponent {
    nativeElement: SynDialog;
    private _ngZone;
    constructor(e: ElementRef, ngZone: NgZone);
    /**
  * Indicates whether or not the dialog is open.
  * You can toggle this attribute to show and hide the dialog, or you can
  use the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.
   */
    set open(v: '' | SynDialog['open']);
    get open(): SynDialog['open'];
    /**
  * The dialog's label as displayed in the header.
  * You should always include a relevant label even when using
  `no-header`, as it is required for proper accessibility.
  * If you need to display HTML, use the `label` slot instead.
   */
    set label(v: SynDialog['label']);
    get label(): SynDialog['label'];
    /**
  * Disables the header.
  * This will also remove the default close button, so please ensure you provide an easy,
  accessible way for users to dismiss the dialog.
   */
    set noHeader(v: '' | SynDialog['noHeader']);
    get noHeader(): SynDialog['noHeader'];
    /**
     * Emitted when the dialog opens.
     */
    synShowEvent: EventEmitter<SynShowEvent>;
    /**
     * Emitted after the dialog opens and all animations are complete.
     */
    synAfterShowEvent: EventEmitter<SynAfterShowEvent>;
    /**
     * Emitted when the dialog closes.
     */
    synHideEvent: EventEmitter<SynHideEvent>;
    /**
     * Emitted after the dialog closes and all animations are complete.
     */
    synAfterHideEvent: EventEmitter<SynAfterHideEvent>;
    /**
     * Emitted when the dialog opens and is ready to receive focus.
     * Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.
     */
    synInitialFocusEvent: EventEmitter<SynInitialFocusEvent>;
    /**
     * Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape.
     * Calling `event.preventDefault()` will keep the dialog open.
     * Avoid using this unless closing the dialog will result in destructive behavior such as data loss.
     */
    synRequestCloseEvent: EventEmitter<SynRequestCloseEvent>;
    static ɵfac: i0.ɵɵFactoryDeclaration<SynDialogComponent, never>;
    static ɵcmp: i0.ɵɵComponentDeclaration<SynDialogComponent, "syn-dialog", never, { "open": { "alias": "open"; "required": false; }; "label": { "alias": "label"; "required": false; }; "noHeader": { "alias": "noHeader"; "required": false; }; }, { "synShowEvent": "synShowEvent"; "synAfterShowEvent": "synAfterShowEvent"; "synHideEvent": "synHideEvent"; "synAfterHideEvent": "synAfterHideEvent"; "synInitialFocusEvent": "synInitialFocusEvent"; "synRequestCloseEvent": "synRequestCloseEvent"; }, never, ["*"], true, never>;
}

export { SynDialogComponent };