@vaadin/confirm-dialog 24.2.0-beta1 → 24.2.0-beta3

package/src/vaadin-confirm-dialog.d.ts

@@ -6,23 +6,9 @@
 import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
+import { type ConfirmDialogEventMap, ConfirmDialogMixin } from './vaadin-confirm-dialog-mixin.js';
 
-/**
- * Fired when the `opened` property changes.
- */
-export type ConfirmDialogOpenedChangedEvent = CustomEvent<{ value: boolean }>;
-
-export interface ConfirmDialogCustomEventMap {
-  'opened-changed': ConfirmDialogOpenedChangedEvent;
-
-  confirm: Event;
-
-  cancel: Event;
-
-  reject: Event;
-}
-
-export type ConfirmDialogEventMap = ConfirmDialogCustomEventMap & HTMLElementEventMap;
+export * from './vaadin-confirm-dialog-mixin.js';
 
 /**
  * `<vaadin-confirm-dialog>` is a Web Component for showing alerts and asking for user confirmation.
@@ -72,103 +58,7 @@ export type ConfirmDialogEventMap = ConfirmDialogCustomEventMap & HTMLElementEve
  * @fires {Event} reject - Fired when Reject button was pressed.
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  */
-declare class ConfirmDialog extends ElementMixin(ThemePropertyMixin(ControllerMixin(HTMLElement))) {
-  /**
-   * Sets the `aria-describedby` attribute of the overlay element.
-   *
-   * By default, all elements inside the message area are linked
-   * through the `aria-describedby` attribute. However, there are
-   * cases where this can confuse screen reader users (e.g. the dialog
-   * may present a password confirmation form). For these cases,
-   * it's better to associate only the elements that will help describe
-   * the confirmation dialog through this API.
-   * @attr {string} accessible-description-ref
-   */
-  accessibleDescriptionRef: string | null | undefined;
-
-  /**
-   * True if the overlay is currently displayed.
-   */
-  opened: boolean;
-
-  /**
-   * Set the confirmation dialog title.
-   */
-  header: string;
-
-  /**
-   * Set the message or confirmation question.
-   */
-  message: string | null | undefined;
-
-  /**
-   * Text displayed on confirm-button.
-   * This only affects the default button, custom slotted buttons will not be altered.
-   * @attr {string} confirm-text
-   */
-  confirmText: string;
-
-  /**
-   * Theme for a confirm-button.
-   * This only affects the default button, custom slotted buttons will not be altered.
-   * @attr {string} confirm-theme
-   */
-  confirmTheme: string;
-
-  /**
-   * Set to true to disable closing dialog on Escape press
-   * @attr {boolean} no-close-on-esc
-   */
-  noCloseOnEsc: boolean;
-
-  /**
-   * Whether to show reject button or not.
-   * @attr {boolean} reject-button-visible
-   */
-  rejectButtonVisible: boolean;
-
-  /**
-   * Text displayed on reject-button.
-   * This only affects the default button, custom slotted buttons will not be altered.
-   * @attr {string} reject-text
-   */
-  rejectText: string;
-
-  /**
-   * Theme for a reject-button.
-   * This only affects the default button, custom slotted buttons will not be altered.
-   * @attr {string} reject-theme
-   */
-  rejectTheme: string;
-
-  /**
-   * Whether to show cancel button or not.
-   * @attr {boolean} cancel-button-visible
-   */
-  cancelButtonVisible: boolean;
-
-  /**
-   * Text displayed on cancel-button.
-   * This only affects the default button, custom slotted buttons will not be altered.
-   * @attr {string} cancel-text
-   */
-  cancelText: string;
-
-  /**
-   * Theme for a cancel-button.
-   * This only affects the default button, custom slotted buttons will not be altered.
-   * @attr {string} cancel-theme
-   */
-  cancelTheme: string;
-
-  /**
-   * A space-delimited list of CSS class names
-   * to set on the underlying overlay element.
-   *
-   * @attr {string} overlay-class
-   */
-  overlayClass: string;
-
+declare class ConfirmDialog extends ConfirmDialogMixin(ElementMixin(ThemePropertyMixin(ControllerMixin(HTMLElement)))) {
   addEventListener<K extends keyof ConfirmDialogEventMap>(
     type: K,
     listener: (this: ConfirmDialog, ev: ConfirmDialogEventMap[K]) => void,

package/src/vaadin-confirm-dialog.js

@@ -3,15 +3,14 @@
  * Copyright (c) 2018 - 2023 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
+import '@vaadin/button/src/vaadin-button.js';
 import './vaadin-confirm-dialog-overlay.js';
 import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
-import { setAriaIDReference } from '@vaadin/a11y-base/src/aria-id-reference.js';
 import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
-import { SlotController } from '@vaadin/component-base/src/slot-controller.js';
-import { generateUniqueId } from '@vaadin/component-base/src/unique-id-utils.js';
 import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
+import { ConfirmDialogMixin } from './vaadin-confirm-dialog-mixin.js';
 
 /**
  * `<vaadin-confirm-dialog>` is a Web Component for showing alerts and asking for user confirmation.
@@ -63,11 +62,12 @@ import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-p
  *
  * @customElement
  * @extends HTMLElement
+ * @mixes ConfirmDialogMixin
  * @mixes ControllerMixin
  * @mixes ElementMixin
  * @mixes ThemePropertyMixin
  */
-class ConfirmDialog extends ElementMixin(ThemePropertyMixin(ControllerMixin(PolymerElement))) {
+class ConfirmDialog extends ConfirmDialogMixin(ElementMixin(ThemePropertyMixin(ControllerMixin(PolymerElement)))) {
   static get template() {
     return html`
       <style>
@@ -103,422 +103,13 @@ class ConfirmDialog extends ElementMixin(ThemePropertyMixin(ControllerMixin(Poly
     return 'vaadin-confirm-dialog';
   }
 
-  static get properties() {
-    return {
-      /**
-       * Sets the `aria-describedby` attribute of the overlay element.
-       *
-       * By default, all elements inside the message area are linked
-       * through the `aria-describedby` attribute. However, there are
-       * cases where this can confuse screen reader users (e.g. the dialog
-       * may present a password confirmation form). For these cases,
-       * it's better to associate only the elements that will help describe
-       * the confirmation dialog through this API.
-       */
-      accessibleDescriptionRef: {
-        type: String,
-      },
-      /**
-       * True if the overlay is currently displayed.
-       * @type {boolean}
-       */
-      opened: {
-        type: Boolean,
-        value: false,
-        notify: true,
-      },
-
-      /**
-       * Set the confirmation dialog title.
-       * @type {string}
-       */
-      header: {
-        type: String,
-        value: '',
-      },
-
-      /**
-       * Set the message or confirmation question.
-       */
-      message: {
-        type: String,
-        value: '',
-      },
-
-      /**
-       * Text displayed on confirm-button.
-       * This only affects the default button, custom slotted buttons will not be altered.
-       * @attr {string} confirm-text
-       * @type {string}
-       */
-      confirmText: {
-        type: String,
-        value: 'Confirm',
-      },
-
-      /**
-       * Theme for a confirm-button.
-       * This only affects the default button, custom slotted buttons will not be altered.
-       * @attr {string} confirm-theme
-       * @type {string}
-       */
-      confirmTheme: {
-        type: String,
-        value: 'primary',
-      },
-
-      /**
-       * Set to true to disable closing dialog on Escape press
-       * @attr {boolean} no-close-on-esc
-       * @type {boolean}
-       */
-      noCloseOnEsc: {
-        type: Boolean,
-        value: false,
-      },
-
-      /**
-       * Whether to show reject button or not.
-       * @attr {boolean} reject-button-visible
-       * @type {boolean}
-       */
-      rejectButtonVisible: {
-        type: Boolean,
-        reflectToAttribute: true,
-        value: false,
-      },
-
-      /**
-       * Text displayed on reject-button.
-       * This only affects the default button, custom slotted buttons will not be altered.
-       * @attr {string} reject-text
-       * @type {string}
-       */
-      rejectText: {
-        type: String,
-        value: 'Reject',
-      },
-
-      /**
-       * Theme for a reject-button.
-       * This only affects the default button, custom slotted buttons will not be altered.
-       * @attr {string} reject-theme
-       * @type {string}
-       */
-      rejectTheme: {
-        type: String,
-        value: 'error tertiary',
-      },
-
-      /**
-       * Whether to show cancel button or not.
-       * @attr {boolean} cancel-button-visible
-       * @type {boolean}
-       */
-      cancelButtonVisible: {
-        type: Boolean,
-        reflectToAttribute: true,
-        value: false,
-      },
-
-      /**
-       * Text displayed on cancel-button.
-       * This only affects the default button, custom slotted buttons will not be altered.
-       * @attr {string} cancel-text
-       * @type {string}
-       */
-      cancelText: {
-        type: String,
-        value: 'Cancel',
-      },
-
-      /**
-       * Theme for a cancel-button.
-       * This only affects the default button, custom slotted buttons will not be altered.
-       * @attr {string} cancel-theme
-       * @type {string}
-       */
-      cancelTheme: {
-        type: String,
-        value: 'tertiary',
-      },
-
-      /**
-       * A space-delimited list of CSS class names
-       * to set on the underlying overlay element.
-       *
-       * @attr {string} overlay-class
-       */
-      overlayClass: {
-        type: String,
-      },
-
-      /**
-       * A reference to the "Cancel" button which will be teleported to the overlay.
-       * @private
-       */
-      _cancelButton: {
-        type: Object,
-      },
-
-      /**
-       * A reference to the "Confirm" button which will be teleported to the overlay.
-       * @private
-       */
-      _confirmButton: {
-        type: Object,
-      },
-
-      /**
-       * A reference to the "header" node which will be teleported to the overlay.
-       * @private
-       */
-      _headerNode: {
-        type: Object,
-      },
-
-      /**
-       * A list of message nodes which will be placed in the overlay default slot.
-       * @private
-       */
-      _messageNodes: {
-        type: Array,
-        value: () => [],
-      },
-
-      /**
-       * A reference to the "Reject" button which will be teleported to the overlay.
-       * @private
-       */
-      _rejectButton: {
-        type: Object,
-      },
-
-      /**
-       * Height to be set on the overlay content.
-       * @protected
-       */
-      _contentHeight: {
-        type: String,
-      },
-
-      /**
-       * Width to be set on the overlay content.
-       * @protected
-       */
-      _contentWidth: {
-        type: String,
-      },
-    };
-  }
-
-  static get observers() {
-    return [
-      '__updateConfirmButton(_confirmButton, confirmText, confirmTheme)',
-      '__updateCancelButton(_cancelButton, cancelText, cancelTheme, cancelButtonVisible)',
-      '__updateHeaderNode(_headerNode, header)',
-      '__updateMessageNodes(_messageNodes, message)',
-      '__updateRejectButton(_rejectButton, rejectText, rejectTheme, rejectButtonVisible)',
-      '__accessibleDescriptionRefChanged(_overlayElement, accessibleDescriptionRef)',
-    ];
-  }
-
-  constructor() {
-    super();
-
-    this.__cancel = this.__cancel.bind(this);
-    this.__confirm = this.__confirm.bind(this);
-    this.__reject = this.__reject.bind(this);
-  }
-
-  get __slottedNodes() {
-    return [this._headerNode, ...this._messageNodes, this._cancelButton, this._confirmButton, this._rejectButton];
-  }
-
   /** @protected */
   ready() {
     super.ready();
 
     this._overlayElement = this.$.dialog.$.overlay;
-    this._overlayElement.addEventListener('vaadin-overlay-escape-press', this._escPressed.bind(this));
-    this._overlayElement.addEventListener('vaadin-overlay-open', () => this.__onDialogOpened());
-    this._overlayElement.addEventListener('vaadin-overlay-closed', () => this.__onDialogClosed());
-    this._overlayElement.setAttribute('role', 'alertdialog');
-
-    this._headerController = new SlotController(this, 'header', 'h3', {
-      initializer: (node) => {
-        this._headerNode = node;
-      },
-    });
-    this.addController(this._headerController);
-
-    this._messageController = new SlotController(this, '', 'div', {
-      // Allow providing multiple custom nodes in the default slot
-      multiple: true,
-      observe: false,
-      initializer: (node) => {
-        const wrapper = document.createElement('div');
-        wrapper.style.display = 'contents';
-        const wrapperId = `confirm-dialog-message-${generateUniqueId()}`;
-        wrapper.id = wrapperId;
-        this.appendChild(wrapper);
-        wrapper.appendChild(node);
-        setAriaIDReference(this._overlayElement, 'aria-describedby', { newId: wrapperId });
-        this._messageNodes = [...this._messageNodes, wrapper];
-      },
-    });
-    this.addController(this._messageController);
-
-    // NOTE: order in which buttons are added should match the order of slots in template
-    this._cancelController = new SlotController(this, 'cancel-button', 'vaadin-button', {
-      initializer: (button) => {
-        this.__setupSlottedButton('cancel', button);
-      },
-    });
-    this.addController(this._cancelController);
-
-    this._rejectController = new SlotController(this, 'reject-button', 'vaadin-button', {
-      initializer: (button) => {
-        this.__setupSlottedButton('reject', button);
-      },
-    });
-    this.addController(this._rejectController);
-
-    this._confirmController = new SlotController(this, 'confirm-button', 'vaadin-button', {
-      initializer: (button) => {
-        this.__setupSlottedButton('confirm', button);
-      },
-    });
-    this.addController(this._confirmController);
-  }
-
-  /** @private */
-  __accessibleDescriptionRefChanged(_overlayElement, accessibleDescriptionRef) {
-    if (!_overlayElement || (!accessibleDescriptionRef && !this.__oldAccessibleDescriptionRef)) {
-      return;
-    }
-    setAriaIDReference(this._overlayElement, 'aria-describedby', {
-      newId: accessibleDescriptionRef,
-      oldId: this.__oldAccessibleDescriptionRef,
-      fromUser: true,
-    });
-    this.__oldAccessibleDescriptionRef = accessibleDescriptionRef;
-  }
-
-  /** @private */
-  __onDialogOpened() {
-    const overlay = this._overlayElement;
-
-    // Teleport slotted nodes to the overlay element.
-    this.__slottedNodes.forEach((node) => {
-      overlay.appendChild(node);
-    });
-
-    const confirmButton = overlay.querySelector('[slot="confirm-button"]');
-    if (confirmButton) {
-      confirmButton.focus();
-    }
-  }
-
-  /** @private */
-  __onDialogClosed() {
-    // Move nodes from the overlay back to the host.
-    this.__slottedNodes.forEach((node) => {
-      this.appendChild(node);
-    });
-  }
-
-  /** @private */
-  __setupSlottedButton(type, button) {
-    const property = `_${type}Button`;
-    const listener = `__${type}`;
-
-    if (this[property] && this[property] !== button) {
-      this[property].remove();
-    }
-
-    button.addEventListener('click', this[listener]);
-    this[property] = button;
-  }
-
-  /** @private */
-  __updateCancelButton(button, cancelText, cancelTheme, showCancel) {
-    if (button) {
-      if (button === this._cancelController.defaultNode) {
-        button.textContent = cancelText;
-        button.setAttribute('theme', cancelTheme);
-      }
-      button.toggleAttribute('hidden', !showCancel);
-    }
-  }
-
-  /** @private */
-  __updateConfirmButton(button, confirmText, confirmTheme) {
-    if (button && button === this._confirmController.defaultNode) {
-      button.textContent = confirmText;
-      button.setAttribute('theme', confirmTheme);
-    }
-  }
-
-  /** @private */
-  __updateHeaderNode(headerNode, header) {
-    // Only update text content for the default header node.
-    if (headerNode && headerNode === this._headerController.defaultNode) {
-      headerNode.textContent = header;
-    }
-  }
-
-  /** @private */
-  __updateMessageNodes(nodes, message) {
-    if (nodes && nodes.length > 0) {
-      const defaultWrapperNode = nodes.find(
-        (node) => this._messageController.defaultNode && node === this._messageController.defaultNode.parentElement,
-      );
-      if (defaultWrapperNode) {
-        defaultWrapperNode.firstChild.textContent = message;
-      }
-    }
-  }
-
-  /** @private */
-  __updateRejectButton(button, rejectText, rejectTheme, showReject) {
-    if (button) {
-      if (button === this._rejectController.defaultNode) {
-        button.textContent = rejectText;
-        button.setAttribute('theme', rejectTheme);
-      }
-      button.toggleAttribute('hidden', !showReject);
-    }
-  }
-
-  /** @private */
-  _escPressed(event) {
-    if (!event.defaultPrevented) {
-      this.__cancel();
-    }
-  }
-
-  /** @private */
-  __confirm() {
-    this.dispatchEvent(new CustomEvent('confirm'));
-    this.opened = false;
-  }
-
-  /** @private */
-  __cancel() {
-    this.dispatchEvent(new CustomEvent('cancel'));
-    this.opened = false;
-  }
-
-  /** @private */
-  __reject() {
-    this.dispatchEvent(new CustomEvent('reject'));
-    this.opened = false;
-  }
 
-  /** @private */
-  _getAriaLabel(header) {
-    return header || 'confirmation';
+    this._initOverlay(this._overlayElement);
   }
 
   /**

package/theme/lumo/vaadin-confirm-dialog-styles.js

@@ -1,3 +1,4 @@
+import '@vaadin/button/theme/lumo/vaadin-button-styles.js';
 import '@vaadin/vaadin-lumo-styles/color.js';
 import '@vaadin/vaadin-lumo-styles/spacing.js';
 import { dialogOverlay } from '@vaadin/dialog/theme/lumo/vaadin-dialog-styles.js';

package/theme/material/vaadin-confirm-dialog-styles.js

@@ -1,3 +1,4 @@
+import '@vaadin/button/theme/material/vaadin-button-styles.js';
 import { dialogOverlay } from '@vaadin/dialog/theme/material/vaadin-dialog-styles.js';
 import { overlay } from '@vaadin/vaadin-material-styles/mixins/overlay.js';
 import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';

package/web-types.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/confirm-dialog",
-  "version": "24.2.0-beta1",
+  "version": "24.2.0-beta3",
   "description-markup": "markdown",
   "contributions": {
     "html": {
       "elements": [
         {
           "name": "vaadin-confirm-dialog",
-          "description": "`<vaadin-confirm-dialog>` is a Web Component for showing alerts and asking for user confirmation.\n\n```\n<vaadin-confirm-dialog cancel-button-visible>\n  There are unsaved changes. Do you really want to leave?\n</vaadin-confirm-dialog>\n```\n\n### Styling\n\nThe `<vaadin-confirm-dialog>` is not themable. Apply styles to `<vaadin-confirm-dialog-overlay>`\ncomponent and use its shadow parts for styling.\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.2.0-beta1/#/elements/vaadin-overlay) for the overlay styling documentation.\n\nIn addition to `<vaadin-overlay>` parts, the following parts are available for theming:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`header`         | The header element wrapper\n`message`        | The message element wrapper\n`footer`         | The footer element that wraps the buttons\n`cancel-button`  | The \"Cancel\" button wrapper\n`confirm-button` | The \"Confirm\" button wrapper\n`reject-button`  | The \"Reject\" button wrapper\n\nUse `confirmTheme`, `cancelTheme` and `rejectTheme` properties to customize buttons theme.\nAlso, the `theme` attribute value set on `<vaadin-confirm-dialog>` is propagated to the\n`<vaadin-confirm-dialog-overlay>` component.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Custom content\n\nThe following slots are available for providing custom content:\n\nSlot name         | Description\n------------------|---------------------------\n`header`          | Slot for header element\n`cancel-button`   | Slot for \"Cancel\" button\n`confirm-button`  | Slot for \"Confirm\" button\n`reject-button`   | Slot for \"Reject\" button",
+          "description": "`<vaadin-confirm-dialog>` is a Web Component for showing alerts and asking for user confirmation.\n\n```\n<vaadin-confirm-dialog cancel-button-visible>\n  There are unsaved changes. Do you really want to leave?\n</vaadin-confirm-dialog>\n```\n\n### Styling\n\nThe `<vaadin-confirm-dialog>` is not themable. Apply styles to `<vaadin-confirm-dialog-overlay>`\ncomponent and use its shadow parts for styling.\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.2.0-beta3/#/elements/vaadin-overlay) for the overlay styling documentation.\n\nIn addition to `<vaadin-overlay>` parts, the following parts are available for theming:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`header`         | The header element wrapper\n`message`        | The message element wrapper\n`footer`         | The footer element that wraps the buttons\n`cancel-button`  | The \"Cancel\" button wrapper\n`confirm-button` | The \"Confirm\" button wrapper\n`reject-button`  | The \"Reject\" button wrapper\n\nUse `confirmTheme`, `cancelTheme` and `rejectTheme` properties to customize buttons theme.\nAlso, the `theme` attribute value set on `<vaadin-confirm-dialog>` is propagated to the\n`<vaadin-confirm-dialog-overlay>` component.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Custom content\n\nThe following slots are available for providing custom content:\n\nSlot name         | Description\n------------------|---------------------------\n`header`          | Slot for header element\n`cancel-button`   | Slot for \"Cancel\" button\n`confirm-button`  | Slot for \"Confirm\" button\n`reject-button`   | Slot for \"Reject\" button",
           "attributes": [
             {
               "name": "accessible-description-ref",

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/confirm-dialog",
-  "version": "24.2.0-beta1",
+  "version": "24.2.0-beta3",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -16,7 +16,7 @@
       "elements": [
         {
           "name": "vaadin-confirm-dialog",
-          "description": "`<vaadin-confirm-dialog>` is a Web Component for showing alerts and asking for user confirmation.\n\n```\n<vaadin-confirm-dialog cancel-button-visible>\n  There are unsaved changes. Do you really want to leave?\n</vaadin-confirm-dialog>\n```\n\n### Styling\n\nThe `<vaadin-confirm-dialog>` is not themable. Apply styles to `<vaadin-confirm-dialog-overlay>`\ncomponent and use its shadow parts for styling.\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.2.0-beta1/#/elements/vaadin-overlay) for the overlay styling documentation.\n\nIn addition to `<vaadin-overlay>` parts, the following parts are available for theming:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`header`         | The header element wrapper\n`message`        | The message element wrapper\n`footer`         | The footer element that wraps the buttons\n`cancel-button`  | The \"Cancel\" button wrapper\n`confirm-button` | The \"Confirm\" button wrapper\n`reject-button`  | The \"Reject\" button wrapper\n\nUse `confirmTheme`, `cancelTheme` and `rejectTheme` properties to customize buttons theme.\nAlso, the `theme` attribute value set on `<vaadin-confirm-dialog>` is propagated to the\n`<vaadin-confirm-dialog-overlay>` component.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Custom content\n\nThe following slots are available for providing custom content:\n\nSlot name         | Description\n------------------|---------------------------\n`header`          | Slot for header element\n`cancel-button`   | Slot for \"Cancel\" button\n`confirm-button`  | Slot for \"Confirm\" button\n`reject-button`   | Slot for \"Reject\" button",
+          "description": "`<vaadin-confirm-dialog>` is a Web Component for showing alerts and asking for user confirmation.\n\n```\n<vaadin-confirm-dialog cancel-button-visible>\n  There are unsaved changes. Do you really want to leave?\n</vaadin-confirm-dialog>\n```\n\n### Styling\n\nThe `<vaadin-confirm-dialog>` is not themable. Apply styles to `<vaadin-confirm-dialog-overlay>`\ncomponent and use its shadow parts for styling.\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.2.0-beta3/#/elements/vaadin-overlay) for the overlay styling documentation.\n\nIn addition to `<vaadin-overlay>` parts, the following parts are available for theming:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`header`         | The header element wrapper\n`message`        | The message element wrapper\n`footer`         | The footer element that wraps the buttons\n`cancel-button`  | The \"Cancel\" button wrapper\n`confirm-button` | The \"Confirm\" button wrapper\n`reject-button`  | The \"Reject\" button wrapper\n\nUse `confirmTheme`, `cancelTheme` and `rejectTheme` properties to customize buttons theme.\nAlso, the `theme` attribute value set on `<vaadin-confirm-dialog>` is propagated to the\n`<vaadin-confirm-dialog-overlay>` component.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Custom content\n\nThe following slots are available for providing custom content:\n\nSlot name         | Description\n------------------|---------------------------\n`header`          | Slot for header element\n`cancel-button`   | Slot for \"Cancel\" button\n`confirm-button`  | Slot for \"Confirm\" button\n`reject-button`   | Slot for \"Reject\" button",
           "extension": true,
           "attributes": [
             {