@vaadin/dialog 25.0.0-alpha2 → 25.0.0-alpha20

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/dialog",
-  "version": "25.0.0-alpha2",
+  "version": "25.0.0-alpha20",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -16,12 +16,12 @@
       "elements": [
         {
           "name": "vaadin-dialog",
-          "description": "`<vaadin-dialog>` is a Web Component for creating customized modal dialogs.\n\n### Rendering\n\nThe content of the dialog can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `dialog` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `dialog`. Before generating new content,\nusers are able to check if there is already content in `root` for reusing it.\n\n```html\n<vaadin-dialog id=\"dialog\"></vaadin-dialog>\n```\n```js\nconst dialog = document.querySelector('#dialog');\ndialog.renderer = function(root, dialog) {\n  root.textContent = \"Sample dialog\";\n};\n```\n\nRenderer is called on the opening of the dialog.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n### Styling\n\n`<vaadin-dialog>` uses `<vaadin-dialog-overlay>` internal\nthemable component as the actual visible dialog overlay.\n\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/25.0.0-alpha2/#/elements/vaadin-overlay) documentation.\nfor `<vaadin-dialog-overlay>` parts.\n\nIn addition to `<vaadin-overlay>` parts, the following parts are available for styling:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`header`         | Element wrapping title and header content\n`header-content` | Element wrapping the header content slot\n`title`          | Element wrapping the title slot\n`footer`         | Element wrapping the footer slot\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|--------------------------------------------\n`has-title`      | Set when the element has a title\n`has-header`     | Set when the element has header renderer\n`has-footer`     | Set when the element has footer renderer\n`overflow`       | Set to `top`, `bottom`, none or both\n\nNote: the `theme` attribute value set on `<vaadin-dialog>` is\npropagated to the internal `<vaadin-dialog-overlay>` component.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
+          "description": "`<vaadin-dialog>` is a Web Component for creating customized modal dialogs.\n\n### Rendering\n\nThe content of the dialog can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `dialog` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `dialog`. Before generating new content,\nusers are able to check if there is already content in `root` for reusing it.\n\n```html\n<vaadin-dialog id=\"dialog\"></vaadin-dialog>\n```\n```js\nconst dialog = document.querySelector('#dialog');\ndialog.renderer = function(root, dialog) {\n  root.textContent = \"Sample dialog\";\n};\n```\n\nRenderer is called on the opening of the dialog.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`backdrop`       | Backdrop of the overlay\n`overlay`        | The overlay container\n`content`        | The overlay content\n`header`         | Element wrapping title and header content\n`header-content` | Element wrapping the header content slot\n`title`          | Element wrapping the title slot\n`footer`         | Element wrapping the footer slot\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|--------------------------------------------\n`has-title`      | Set when the element has a title\n`has-header`     | Set when the element has header renderer\n`has-footer`     | Set when the element has footer renderer\n`overflow`       | Set to `top`, `bottom`, none or both\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
           "extension": true,
           "attributes": [
             {
               "name": "?opened",
-              "description": "True if the overlay is currently displayed.",
+              "description": "True if the dialog is visible and available for interaction.",
               "value": {
                 "kind": "expression"
               }
@@ -63,35 +63,21 @@
             },
             {
               "name": ".top",
-              "description": "Set the distance of the overlay from the top of its container.\nIf a unitless number is provided, pixels are assumed.\n\nNote that the overlay top edge may not be the same as the viewport\ntop edge (e.g. the Lumo theme defines some spacing to prevent the\noverlay from stretching all the way to the top of the viewport).",
+              "description": "Set the distance of the dialog from the top of the viewport.\nIf a unitless number is provided, pixels are assumed.\n\nNote that the dialog uses an internal container that has some\nadditional spacing, which can be overridden by the theme.",
               "value": {
                 "kind": "expression"
               }
             },
             {
               "name": ".left",
-              "description": "Set the distance of the overlay from the left of its container.\nIf a unitless number is provided, pixels are assumed.\n\nNote that the overlay left edge may not be the same as the viewport\nleft edge (e.g. the Lumo theme defines some spacing to prevent the\noverlay from stretching all the way to the left of the viewport).",
-              "value": {
-                "kind": "expression"
-              }
-            },
-            {
-              "name": ".width",
-              "description": "Set the width of the overlay.\nIf a unitless number is provided, pixels are assumed.",
-              "value": {
-                "kind": "expression"
-              }
-            },
-            {
-              "name": ".height",
-              "description": "Set the height of the overlay.\nIf a unitless number is provided, pixels are assumed.",
+              "description": "Set the distance of the dialog from the left of the viewport.\nIf a unitless number is provided, pixels are assumed.\n\nNote that the dialog uses an internal container that has some\nadditional spacing, which can be overridden by the theme.",
               "value": {
                 "kind": "expression"
               }
             },
             {
               "name": ".overlayRole",
-              "description": "The `role` attribute value to be set on the overlay. Defaults to \"dialog\".",
+              "description": "The `role` attribute value to be set on the dialog. Defaults to \"dialog\".",
               "value": {
                 "kind": "expression"
               }
@@ -105,35 +91,35 @@
             },
             {
               "name": ".headerTitle",
-              "description": "String used for rendering a dialog title.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerTitle` is set, the attribute `has-title` is added to the overlay element.",
+              "description": "String used for rendering a dialog title.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerTitle` is set, the attribute `has-title` is set on the dialog.",
               "value": {
                 "kind": "expression"
               }
             },
             {
               "name": ".headerRenderer",
-              "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is added to the overlay element.",
+              "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is set on the dialog.",
               "value": {
                 "kind": "expression"
               }
             },
             {
               "name": ".footerRenderer",
-              "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is added to the overlay element.",
+              "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is set on the dialog.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".overlayClass",
-              "description": "A space-delimited list of CSS class names to set on the overlay element.\nThis property does not affect other CSS class names set manually via JS.\n\nNote, if the CSS class name was set with this property, clearing it will\nremove it from the overlay, even if the same class name was also added\nmanually, e.g. by using `classList.add()` in the `renderer` function.",
+              "name": ".width",
+              "description": "Set the width of the dialog.\nIf a unitless number is provided, pixels are assumed.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".ariaLabel",
-              "description": "Set the `aria-label` attribute for assistive technologies like\nscreen readers. An empty string value for this property (the\ndefault) means that the `aria-label` attribute is not present.",
+              "name": ".height",
+              "description": "Set the height of the dialog.\nIf a unitless number is provided, pixels are assumed.",
               "value": {
                 "kind": "expression"
               }

package/src/vaadin-dialog-styles.js

@@ -1,181 +0,0 @@
-/**
- * @license
- * Copyright (c) 2017 - 2025 Vaadin Ltd.
- * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
- */
-import { css } from 'lit';
-
-export const dialogOverlay = css`
-  [part='header'],
-  [part='header-content'],
-  [part='footer'] {
-    display: flex;
-    align-items: center;
-    flex-wrap: wrap;
-    flex: none;
-    pointer-events: none;
-    z-index: 1;
-  }
-
-  [part='header'] {
-    flex-wrap: nowrap;
-  }
-
-  ::slotted([slot='header-content']),
-  ::slotted([slot='title']),
-  ::slotted([slot='footer']) {
-    display: contents;
-    pointer-events: auto;
-  }
-
-  ::slotted([slot='title']) {
-    font: inherit !important;
-    overflow-wrap: anywhere;
-  }
-
-  [part='header-content'] {
-    flex: 1;
-  }
-
-  :host([has-title]) [part='header-content'],
-  [part='footer'] {
-    justify-content: flex-end;
-  }
-
-  :host(:not([has-title]):not([has-header])) [part='header'],
-  :host(:not([has-header])) [part='header-content'],
-  :host(:not([has-title])) [part='title'],
-  :host(:not([has-footer])) [part='footer'] {
-    display: none !important;
-  }
-
-  :host(:is([has-title], [has-header], [has-footer])) [part='content'] {
-    height: auto;
-  }
-
-  @media (min-height: 320px) {
-    :host(:is([has-title], [has-header], [has-footer])) .resizer-container {
-      overflow: hidden;
-      display: flex;
-      flex-direction: column;
-    }
-
-    :host(:is([has-title], [has-header], [has-footer])) [part='content'] {
-      flex: 1;
-      overflow: auto;
-    }
-  }
-
-  /*
-      NOTE(platosha): Make some min-width to prevent collapsing of the content
-      taking the parent width, e. g., <vaadin-grid> and such.
-    */
-  [part='content'] {
-    min-width: 12em; /* matches the default <vaadin-text-field> width */
-  }
-
-  :host([has-bounds-set]) [part='overlay'] {
-    max-width: none;
-  }
-
-  @media (forced-colors: active) {
-    [part='overlay'] {
-      outline: 3px solid !important;
-    }
-  }
-`;
-
-export const resizableOverlay = css`
-  [part='overlay'] {
-    position: relative;
-    overflow: visible;
-    max-height: 100%;
-    display: flex;
-  }
-
-  [part='content'] {
-    box-sizing: border-box;
-    height: 100%;
-  }
-
-  .resizer-container {
-    overflow: auto;
-    flex-grow: 1;
-    border-radius: inherit; /* prevent child elements being drawn outside part=overlay */
-  }
-
-  [part='overlay'][style] .resizer-container {
-    min-height: 100%;
-    width: 100%;
-  }
-
-  :host(:not([resizable])) .resizer {
-    display: none;
-  }
-
-  :host([resizable]) [part='title'] {
-    cursor: move;
-    -webkit-user-select: none;
-    user-select: none;
-  }
-
-  .resizer {
-    position: absolute;
-    height: 16px;
-    width: 16px;
-  }
-
-  .resizer.edge {
-    height: 8px;
-    width: 8px;
-    inset: -4px;
-  }
-
-  .resizer.edge.n {
-    width: auto;
-    bottom: auto;
-    cursor: ns-resize;
-  }
-
-  .resizer.ne {
-    top: -4px;
-    right: -4px;
-    cursor: nesw-resize;
-  }
-
-  .resizer.edge.e {
-    height: auto;
-    left: auto;
-    cursor: ew-resize;
-  }
-
-  .resizer.se {
-    bottom: -4px;
-    right: -4px;
-    cursor: nwse-resize;
-  }
-
-  .resizer.edge.s {
-    width: auto;
-    top: auto;
-    cursor: ns-resize;
-  }
-
-  .resizer.sw {
-    bottom: -4px;
-    left: -4px;
-    cursor: nesw-resize;
-  }
-
-  .resizer.edge.w {
-    height: auto;
-    right: auto;
-    cursor: ew-resize;
-  }
-
-  .resizer.nw {
-    top: -4px;
-    left: -4px;
-    cursor: nwse-resize;
-  }
-`;

package/theme/lumo/vaadin-dialog-styles.d.ts

@@ -1,3 +0,0 @@
-import '@vaadin/vaadin-lumo-styles/spacing.js';
-declare const dialogOverlay: import("lit").CSSResult;
-export { dialogOverlay };

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

@@ -1,109 +0,0 @@
-import '@vaadin/vaadin-lumo-styles/spacing.js';
-import { overlay } from '@vaadin/vaadin-lumo-styles/mixins/overlay.js';
-import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-
-const dialogOverlay = css`
-  /* Optical centering */
-  :host::before,
-  :host::after {
-    content: '';
-    flex-basis: 0;
-    flex-grow: 1;
-  }
-
-  :host::after {
-    flex-grow: 1.1;
-  }
-
-  [part='overlay'] {
-    border-radius: var(--lumo-border-radius-l);
-    box-shadow:
-      0 0 0 1px var(--lumo-shade-5pct),
-      var(--lumo-box-shadow-xl);
-    background-image: none;
-    outline: none;
-    -webkit-tap-highlight-color: transparent;
-  }
-
-  [part='content'] {
-    padding: var(--lumo-space-l);
-  }
-
-  :host(:is([has-header], [has-title])) [part='header'] + [part='content'] {
-    padding-top: 0;
-  }
-
-  [part='header'],
-  [part='header-content'],
-  [part='footer'] {
-    gap: var(--lumo-space-xs) var(--lumo-space-s);
-    line-height: var(--lumo-line-height-s);
-  }
-
-  [part='header'] {
-    padding: var(--lumo-space-m);
-    background-color: var(--lumo-base-color);
-    border-radius: var(--lumo-border-radius-l) var(--lumo-border-radius-l) 0 0; /* Needed for Safari */
-  }
-
-  [part='footer'] {
-    padding: var(--lumo-space-s) var(--lumo-space-m);
-    background-color: var(--lumo-contrast-5pct);
-    border-radius: 0 0 var(--lumo-border-radius-l) var(--lumo-border-radius-l); /* Needed for Safari */
-  }
-
-  [part='title'] {
-    font-size: var(--lumo-font-size-xl);
-    font-weight: 600;
-    color: var(--lumo-header-text-color);
-    margin-inline-start: calc(var(--lumo-space-l) - var(--lumo-space-m));
-  }
-
-  /* No padding */
-  :host([theme~='no-padding']) [part='content'] {
-    padding: 0 !important;
-  }
-
-  @media (min-height: 320px) {
-    :host([overflow~='top']) [part='header'] {
-      box-shadow: 0 1px 0 0 var(--lumo-contrast-10pct);
-    }
-  }
-
-  /* Animations */
-
-  :host([opening]),
-  :host([closing]) {
-    animation: 0.25s lumo-overlay-dummy-animation;
-  }
-
-  :host([opening]) [part='overlay'] {
-    animation: 0.12s 0.05s vaadin-dialog-enter cubic-bezier(0.215, 0.61, 0.355, 1) both;
-  }
-
-  @keyframes vaadin-dialog-enter {
-    0% {
-      opacity: 0;
-      transform: scale(0.95);
-    }
-  }
-
-  :host([closing]) [part='overlay'] {
-    animation: 0.1s 0.03s vaadin-dialog-exit cubic-bezier(0.55, 0.055, 0.675, 0.19) both;
-  }
-
-  :host([closing]) [part='backdrop'] {
-    animation-delay: 0.05s;
-  }
-
-  @keyframes vaadin-dialog-exit {
-    100% {
-      opacity: 0;
-      transform: scale(1.02);
-    }
-  }
-`;
-
-registerStyles('vaadin-dialog-overlay', [overlay, dialogOverlay], { moduleId: 'lumo-dialog' });
-
-export { dialogOverlay };

package/theme/lumo/vaadin-dialog.d.ts

@@ -1,2 +0,0 @@
-import './vaadin-dialog-styles.js';
-import '../../src/vaadin-dialog.js';

package/theme/lumo/vaadin-dialog.js

@@ -1,2 +0,0 @@
-import './vaadin-dialog-styles.js';
-import '../../src/vaadin-dialog.js';