From 3384908da139fe027d1a289d46826854c354ee05 Mon Sep 17 00:00:00 2001 From: Jeremy Rose Date: Fri, 24 Feb 2023 11:10:27 -0800 Subject: [PATCH] docs: document change in draggable region behavior on macOS (#37396) --- docs/breaking-changes.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/breaking-changes.md b/docs/breaking-changes.md index e6898e9eba96..22dc3a62f9c6 100644 --- a/docs/breaking-changes.md +++ b/docs/breaking-changes.md @@ -54,6 +54,14 @@ if (ret === null) { ## Planned Breaking API Changes (23.0) +### Behavior Changed: Draggable Regions on macOS + +The implementation of draggable regions (using the CSS property `-webkit-app-region: drag`) has changed on macOS to bring it in line with Windows and Linux. Previously, when a region with `-webkit-app-region: no-drag` overlapped a region with `-webkit-app-region: drag`, the `no-drag` region would always take precedence on macOS, regardless of CSS layering. That is, if a `drag` region was above a `no-drag` region, it would be ignored. Beginning in Electron 23, a `drag` region on top of a `no-drag` region will correctly cause the region to be draggable. + +Additionally, the `customButtonsOnHover` BrowserWindow property previously created a draggable region which ignored the `-webkit-app-region` CSS property. This has now been fixed (see [#37210](https://github.com/electron/electron/issues/37210#issuecomment-1440509592) for discussion). + +As a result, if your app uses a frameless window with draggable regions on macOS, the regions which are draggable in your app may change in Electron 23. + ### Removed: Windows 7 / 8 / 8.1 support [Windows 7, Windows 8, and Windows 8.1 are no longer supported](https://www.electronjs.org/blog/windows-7-to-8-1-deprecation-notice). Electron follows the planned Chromium deprecation policy, which will [deprecate Windows 7 support beginning in Chromium 109](https://support.google.com/chrome/thread/185534985/sunsetting-support-for-windows-7-8-8-1-in-early-2023?hl=en).