@vaadin/dialog 25.1.0-alpha2 → 25.1.0-alpha4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/dialog",
-  "version": "25.1.0-alpha2",
+  "version": "25.1.0-alpha4",
   "publishConfig": {
     "access": "public"
   },
@@ -36,24 +36,24 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/component-base": "25.1.0-alpha2",
-    "@vaadin/lit-renderer": "25.1.0-alpha2",
-    "@vaadin/overlay": "25.1.0-alpha2",
-    "@vaadin/vaadin-themable-mixin": "25.1.0-alpha2",
+    "@vaadin/component-base": "25.1.0-alpha4",
+    "@vaadin/lit-renderer": "25.1.0-alpha4",
+    "@vaadin/overlay": "25.1.0-alpha4",
+    "@vaadin/vaadin-themable-mixin": "25.1.0-alpha4",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/a11y-base": "25.1.0-alpha2",
-    "@vaadin/aura": "25.1.0-alpha2",
-    "@vaadin/chai-plugins": "25.1.0-alpha2",
-    "@vaadin/test-runner-commands": "25.1.0-alpha2",
+    "@vaadin/a11y-base": "25.1.0-alpha4",
+    "@vaadin/aura": "25.1.0-alpha4",
+    "@vaadin/chai-plugins": "25.1.0-alpha4",
+    "@vaadin/test-runner-commands": "25.1.0-alpha4",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "25.1.0-alpha2",
+    "@vaadin/vaadin-lumo-styles": "25.1.0-alpha4",
     "sinon": "^21.0.0"
   },
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "dfeb6e14643ec923e5505ca645f7354c6dc170ec"
+  "gitHead": "4fb917150617231c1acf27faabf386560dcd3bc5"
 }

package/src/vaadin-dialog-base-mixin.d.ts

@@ -32,6 +32,12 @@ export declare class DialogBaseMixinClass {
    */
   modeless: boolean;
 
+  /**
+   * Set to true to disable focus trapping.
+   * @attr {boolean} no-focus-trap
+   */
+  noFocusTrap: boolean;
+
   /**
    * The `role` attribute value to be set on the dialog. Defaults to "dialog".
    *

package/src/vaadin-dialog-base-mixin.js

@@ -52,6 +52,16 @@ export const DialogBaseMixin = (superClass) =>
           value: false,
         },
 
+        /**
+         * Set to true to disable focus trapping.
+         * @attr {boolean} no-focus-trap
+         * @type {boolean}
+         */
+        noFocusTrap: {
+          type: Boolean,
+          value: false,
+        },
+
         /**
          * Set the distance of the dialog from the top of the viewport.
          * If a unitless number is provided, pixels are assumed.

package/src/vaadin-dialog-draggable-mixin.d.ts

@@ -21,4 +21,12 @@ export declare class DialogDraggableMixinClass {
    * "`draggable-leaf-only`" class name.
    */
   draggable: boolean;
+
+  /**
+   * Set to true to prevent dragging the dialog outside the viewport bounds.
+   * When enabled, all four edges of the dialog will remain visible during dragging.
+   * The dialog may still become partially hidden when the viewport is resized.
+   * @attr {boolean} keep-in-viewport
+   */
+  keepInViewport: boolean;
 }

package/src/vaadin-dialog-draggable-mixin.js

@@ -31,6 +31,19 @@ export const DialogDraggableMixin = (superClass) =>
           reflectToAttribute: true,
         },
 
+        /**
+         * Set to true to prevent dragging the dialog outside the viewport bounds.
+         * When enabled, all four edges of the dialog will remain visible during dragging.
+         * The dialog may still become partially hidden when the viewport is resized.
+         * @attr {boolean} keep-in-viewport
+         * @type {boolean}
+         */
+        keepInViewport: {
+          type: Boolean,
+          value: false,
+          reflectToAttribute: true,
+        },
+
         /** @private */
         _touchDevice: {
           type: Boolean,
@@ -93,11 +106,15 @@ export const DialogDraggableMixin = (superClass) =>
           window.addEventListener('touchend', this._stopDrag);
           window.addEventListener('mousemove', this._drag);
           window.addEventListener('touchmove', this._drag);
+
+          const { top, left, width, height } = this._originalBounds;
           if (this.$.overlay.$.overlay.style.position !== 'absolute') {
-            const { top, left } = this._originalBounds;
             this.top = top;
             this.left = left;
           }
+          this.dispatchEvent(
+            new CustomEvent('drag-start', { bubbles: true, composed: true, detail: { width, height, top, left } }),
+          );
         }
       }
     }
@@ -106,8 +123,22 @@ export const DialogDraggableMixin = (superClass) =>
     _drag(e) {
       const event = getMouseOrFirstTouchEvent(e);
       if (eventInWindow(event)) {
-        const top = this._originalBounds.top + (event.pageY - this._originalMouseCoords.top);
-        const left = this._originalBounds.left + (event.pageX - this._originalMouseCoords.left);
+        let top = this._originalBounds.top + (event.pageY - this._originalMouseCoords.top);
+        let left = this._originalBounds.left + (event.pageX - this._originalMouseCoords.left);
+
+        if (this.keepInViewport) {
+          const { width, height } = this._originalBounds;
+          // Get the overlay container's position to account for its offset from the viewport
+          const containerBounds = this.$.overlay.getBoundingClientRect();
+          // Calculate bounds so the dialog's visual edges stay within the viewport
+          const minLeft = -containerBounds.left;
+          const maxLeft = window.innerWidth - containerBounds.left - width;
+          const minTop = -containerBounds.top;
+          const maxTop = window.innerHeight - containerBounds.top - height;
+          left = Math.max(minLeft, Math.min(left, maxLeft));
+          top = Math.max(minTop, Math.min(top, maxTop));
+        }
+
         this.top = top;
         this.left = left;
       }
@@ -124,6 +155,12 @@ export const DialogDraggableMixin = (superClass) =>
       window.removeEventListener('touchmove', this._drag);
     }
 
+    /**
+     * Fired when the dialog drag is started.
+     *
+     * @event drag-start
+     */
+
     /**
      * Fired when the dialog drag is finished.
      *

package/src/vaadin-dialog-resizable-mixin.js

@@ -74,6 +74,9 @@ export const DialogResizableMixin = (superClass) =>
         window.addEventListener('touchend', this._resizeListeners.stop[direction]);
         this.$.overlay.setBounds(this._originalBounds);
         this.$.overlay.setAttribute('has-bounds-set', '');
+
+        const { width, height, top, left } = this._originalBounds;
+        this.dispatchEvent(new CustomEvent('resize-start', { detail: { width, height, top, left } }));
       }
     }
 
@@ -148,6 +151,12 @@ export const DialogResizableMixin = (superClass) =>
       return { width, height, top, left };
     }
 
+    /**
+     * Fired when the dialog resize is started.
+     *
+     * @event resize-start
+     */
+
     /**
      * Fired when the dialog resize is finished.
      *

package/src/vaadin-dialog.d.ts

@@ -34,11 +34,21 @@ export type DialogPosition = {
  */
 export type DialogOpenedChangedEvent = CustomEvent<{ value: boolean }>;
 
+/**
+ * Fired when the dialog resize is started.
+ */
+export type DialogResizeStartEvent = CustomEvent<DialogResizeDimensions>;
+
 /**
  * Fired when the dialog resize is finished.
  */
 export type DialogResizeEvent = CustomEvent<DialogResizeDimensions>;
 
+/**
+ * Fired when the dialog drag is started.
+ */
+export type DialogDragStartEvent = CustomEvent<DialogResizeDimensions>;
+
 /**
  * Fired when the dialog drag is finished.
  */
@@ -54,8 +64,12 @@ export interface DialogCustomEventMap {
 
   closed: DialogClosedEvent;
 
+  'resize-start': DialogResizeStartEvent;
+
   resize: DialogResizeEvent;
 
+  'drag-start': DialogDragStartEvent;
+
   dragged: DialogDraggedEvent;
 }
 
@@ -131,7 +145,9 @@ export type DialogEventMap = DialogCustomEventMap & HTMLElementEventMap;
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
+ * @fires {CustomEvent} resize-start - Fired when the dialog resize is started.
  * @fires {CustomEvent} resize - Fired when the dialog resize is finished.
+ * @fires {CustomEvent} drag-start - Fired when the dialog drag is started.
  * @fires {CustomEvent} dragged - Fired when the dialog drag is finished.
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  * @fires {CustomEvent} closed - Fired when the dialog is closed.

package/src/vaadin-dialog.js

@@ -88,7 +88,9 @@ export { DialogOverlay } from './vaadin-dialog-overlay.js';
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
+ * @fires {CustomEvent} resize-start - Fired when the dialog resize is started.
  * @fires {CustomEvent} resize - Fired when the dialog resize is finished.
+ * @fires {CustomEvent} drag-start - Fired when the dialog drag is started.
  * @fires {CustomEvent} dragged - Fired when the dialog drag is finished.
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  * @fires {CustomEvent} closed - Fired when the dialog is closed.
@@ -154,7 +156,7 @@ class Dialog extends DialogSizeMixin(
         .withBackdrop="${!this.modeless}"
         ?resizable="${this.resizable}"
         restore-focus-on-close
-        focus-trap
+        ?focus-trap="${!this.noFocusTrap}"
         exportparts="backdrop, overlay, header, title, header-content, content, footer"
       >
         <slot name="title" slot="title"></slot>

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/dialog",
-  "version": "25.1.0-alpha2",
+  "version": "25.1.0-alpha4",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -46,6 +46,15 @@
                 ]
               }
             },
+            {
+              "name": "no-focus-trap",
+              "description": "Set to true to disable focus trapping.",
+              "value": {
+                "type": [
+                  "boolean"
+                ]
+              }
+            },
             {
               "name": "top",
               "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.",
@@ -88,6 +97,15 @@
                 ]
               }
             },
+            {
+              "name": "keep-in-viewport",
+              "description": "Set to true to prevent dragging the dialog outside the viewport bounds.\nWhen enabled, all four edges of the dialog will remain visible during dragging.\nThe dialog may still become partially hidden when the viewport is resized.",
+              "value": {
+                "type": [
+                  "boolean"
+                ]
+              }
+            },
             {
               "name": "header-title",
               "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.",
@@ -180,6 +198,15 @@
                   ]
                 }
               },
+              {
+                "name": "noFocusTrap",
+                "description": "Set to true to disable focus trapping.",
+                "value": {
+                  "type": [
+                    "boolean"
+                  ]
+                }
+              },
               {
                 "name": "top",
                 "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.",
@@ -222,6 +249,15 @@
                   ]
                 }
               },
+              {
+                "name": "keepInViewport",
+                "description": "Set to true to prevent dragging the dialog outside the viewport bounds.\nWhen enabled, all four edges of the dialog will remain visible during dragging.\nThe dialog may still become partially hidden when the viewport is resized.",
+                "value": {
+                  "type": [
+                    "boolean"
+                  ]
+                }
+              },
               {
                 "name": "renderer",
                 "description": "Custom function for rendering the content of the dialog.\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.",
@@ -300,6 +336,10 @@
                 "name": "closed",
                 "description": "Fired when the dialog is closed."
               },
+              {
+                "name": "drag-start",
+                "description": "Fired when the dialog drag is started."
+              },
               {
                 "name": "dragged",
                 "description": "Fired when the dialog drag is finished."
@@ -308,6 +348,10 @@
                 "name": "resize",
                 "description": "Fired when the dialog resize is finished."
               },
+              {
+                "name": "resize-start",
+                "description": "Fired when the dialog resize is started."
+              },
               {
                 "name": "opened-changed",
                 "description": "Fired when the `opened` property changes."

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/dialog",
-  "version": "25.1.0-alpha2",
+  "version": "25.1.0-alpha4",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -47,6 +47,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": "?noFocusTrap",
+              "description": "Set to true to disable focus trapping.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": "?draggable",
               "description": "Set to true to enable repositioning the dialog by clicking and dragging.\n\nBy default, only the overlay area can be used to drag the element. But,\na child element can be marked as a draggable area by adding a\n\"`draggable`\" class to it, this will by default make all of its children draggable also.\nIf you want a child element to be draggable\nbut still have its children non-draggable (by default), mark it with\n\"`draggable-leaf-only`\" class name.",
@@ -54,6 +61,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": "?keepInViewport",
+              "description": "Set to true to prevent dragging the dialog outside the viewport bounds.\nWhen enabled, all four edges of the dialog will remain visible during dragging.\nThe dialog may still become partially hidden when the viewport is resized.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": "?resizable",
               "description": "Set to true to enable resizing the dialog by dragging the corners and edges.",
@@ -131,6 +145,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": "@drag-start",
+              "description": "Fired when the dialog drag is started.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": "@dragged",
               "description": "Fired when the dialog drag is finished.",
@@ -145,6 +166,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": "@resize-start",
+              "description": "Fired when the dialog resize is started.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": "@opened-changed",
               "description": "Fired when the `opened` property changes.",