diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md index d202ce94948d7..61c4b00e03a9e 100644 --- a/docs/api/browser-window.md +++ b/docs/api/browser-window.md @@ -392,6 +392,10 @@ It creates a new `BrowserWindow` with native properties as set by the `options`. contain the layout of the document—without requiring scrolling. Enabling this will cause the `preferred-size-changed` event to be emitted on the `WebContents` when the preferred size changes. Default is `false`. + * `titleBarOverlay` Boolean (optional) - On macOS, when using a frameless window in conjunction with + `win.setWindowButtonVisibility(true)` or using a `titleBarStyle` so that the traffic lights are visible, + this property enables the Window Controls Overlay [JavaScript APIs][overlay-javascript-apis] and + [CSS Environment Variables][overlay-css-env-vars]. Default is `false`. When setting minimum or maximum window size with `minWidth`/`maxWidth`/ `minHeight`/`maxHeight`, it only constrains the users. It won't prevent you from @@ -1815,3 +1819,5 @@ removed in future Electron releases. [window-levels]: https://developer.apple.com/documentation/appkit/nswindow/level [chrome-content-scripts]: https://developer.chrome.com/extensions/content_scripts#execution-environment [event-emitter]: https://nodejs.org/api/events.html#events_class_eventemitter +[overlay-javascript-apis]: https://github.com/WICG/window-controls-overlay/blob/main/explainer.md#javascript-apis +[overlay-css-env-vars]: https://github.com/WICG/window-controls-overlay/blob/main/explainer.md#css-environment-variables diff --git a/docs/api/frameless-window.md b/docs/api/frameless-window.md index 8bb253e1948c2..7a73c8925e200 100644 --- a/docs/api/frameless-window.md +++ b/docs/api/frameless-window.md @@ -61,6 +61,21 @@ const win = new BrowserWindow({ titleBarStyle: 'customButtonsOnHover', frame: fa win.show() ``` +## Windows Control Overlay + +On macOS, when using a frameless window in conjuction with `win.setWindowButtonVisibility(true)` or using one of the `titleBarStyle`s described above so +that the traffic lights are visible, you can access the Window Controls Overlay [JavaScript APIs][overlay-javascript-apis] and +[CSS Environment Variables][overlay-css-env-vars] by setting the `titleBarOverlay` option to true: + +```javascript +const { BrowserWindow } = require('electron') +const win = new BrowserWindow({ + titleBarStyle: 'hiddenInset', + titleBarOverlay: true +}) +win.show() +``` + ## Transparent window By setting the `transparent` option to `true`, you can also make the frameless @@ -186,3 +201,5 @@ behave correctly on all platforms you should never use a custom context menu on draggable areas. [ignore-mouse-events]: browser-window.md#winsetignoremouseeventsignore-options +[overlay-javascript-apis]: https://github.com/WICG/window-controls-overlay/blob/main/explainer.md#javascript-apis +[overlay-css-env-vars]: https://github.com/WICG/window-controls-overlay/blob/main/explainer.md#css-environment-variables diff --git a/shell/browser/api/electron_api_browser_window.cc b/shell/browser/api/electron_api_browser_window.cc index 1ed0d9a52dcb0..d8533305dcfa7 100644 --- a/shell/browser/api/electron_api_browser_window.cc +++ b/shell/browser/api/electron_api_browser_window.cc @@ -57,6 +57,17 @@ BrowserWindow::BrowserWindow(gin::Arguments* args, web_preferences.Set(options::kShow, show); } + bool titleBarOverlay = false; + options.Get(options::ktitleBarOverlay, &titleBarOverlay); + if (titleBarOverlay) { + std::string enabled_features = ""; + if (web_preferences.Get(options::kEnableBlinkFeatures, &enabled_features)) { + enabled_features += ","; + } + enabled_features += features::kWebAppWindowControlsOverlay.name; + web_preferences.Set(options::kEnableBlinkFeatures, enabled_features); + } + // Copy the webContents option to webPreferences. This is only used internally // to implement nativeWindowOpen option. if (options.Get("webContents", &value)) { @@ -312,6 +323,11 @@ void BrowserWindow::OnWindowLeaveFullScreen() { BaseWindow::OnWindowLeaveFullScreen(); } +void BrowserWindow::UpdateWindowControlsOverlay( + const gfx::Rect& bounding_rect) { + web_contents()->UpdateWindowControlsOverlay(bounding_rect); +} + void BrowserWindow::CloseImmediately() { // Close all child windows before closing current window. v8::Locker locker(isolate()); diff --git a/shell/browser/api/electron_api_browser_window.h b/shell/browser/api/electron_api_browser_window.h index a985a60c3c07f..987fdcffb8351 100644 --- a/shell/browser/api/electron_api_browser_window.h +++ b/shell/browser/api/electron_api_browser_window.h @@ -71,6 +71,7 @@ class BrowserWindow : public BaseWindow, void RequestPreferredWidth(int* width) override; void OnCloseButtonClicked(bool* prevent_default) override; void OnWindowIsKeyChanged(bool is_key) override; + void UpdateWindowControlsOverlay(const gfx::Rect& bounding_rect) override; // BaseWindow: void OnWindowBlur() override; diff --git a/shell/browser/api/electron_api_web_contents.cc b/shell/browser/api/electron_api_web_contents.cc index 9a6db7190e649..796ee69157c78 100644 --- a/shell/browser/api/electron_api_web_contents.cc +++ b/shell/browser/api/electron_api_web_contents.cc @@ -1677,6 +1677,10 @@ void WebContents::ReadyToCommitNavigation( void WebContents::DidFinishNavigation( content::NavigationHandle* navigation_handle) { + if (owner_window_) { + owner_window_->NotifyLayoutWindowControlsOverlay(); + } + if (!navigation_handle->HasCommitted()) return; bool is_main_frame = navigation_handle->IsInMainFrame(); diff --git a/shell/browser/native_window.cc b/shell/browser/native_window.cc index 9bfd5a36f7ddc..435b007835686 100644 --- a/shell/browser/native_window.cc +++ b/shell/browser/native_window.cc @@ -53,6 +53,7 @@ NativeWindow::NativeWindow(const gin_helper::Dictionary& options, options.Get(options::kFrame, &has_frame_); options.Get(options::kTransparent, &transparent_); options.Get(options::kEnableLargerThanScreen, &enable_larger_than_screen_); + options.Get(options::ktitleBarOverlay, &titlebar_overlay_); if (parent) options.Get("modal", &is_modal_); @@ -394,6 +395,14 @@ void NativeWindow::PreviewFile(const std::string& path, void NativeWindow::CloseFilePreview() {} +gfx::Rect NativeWindow::GetWindowControlsOverlayRect() { + return overlay_rect_; +} + +void NativeWindow::SetWindowControlsOverlayRect(const gfx::Rect& overlay_rect) { + overlay_rect_ = overlay_rect; +} + void NativeWindow::NotifyWindowRequestPreferredWith(int* width) { for (NativeWindowObserver& observer : observers_) observer.RequestPreferredWidth(width); @@ -493,6 +502,7 @@ void NativeWindow::NotifyWindowWillMove(const gfx::Rect& new_bounds, } void NativeWindow::NotifyWindowResize() { + NotifyLayoutWindowControlsOverlay(); for (NativeWindowObserver& observer : observers_) observer.OnWindowResize(); } @@ -591,6 +601,14 @@ void NativeWindow::NotifyWindowSystemContextMenu(int x, observer.OnSystemContextMenu(x, y, prevent_default); } +void NativeWindow::NotifyLayoutWindowControlsOverlay() { + gfx::Rect bounding_rect = GetWindowControlsOverlayRect(); + if (!bounding_rect.IsEmpty()) { + for (NativeWindowObserver& observer : observers_) + observer.UpdateWindowControlsOverlay(bounding_rect); + } +} + #if defined(OS_WIN) void NativeWindow::NotifyWindowMessage(UINT message, WPARAM w_param, diff --git a/shell/browser/native_window.h b/shell/browser/native_window.h index 0c166612ab1e5..dfceeb1338754 100644 --- a/shell/browser/native_window.h +++ b/shell/browser/native_window.h @@ -254,6 +254,9 @@ class NativeWindow : public base::SupportsUserData, return weak_factory_.GetWeakPtr(); } + virtual gfx::Rect GetWindowControlsOverlayRect(); + virtual void SetWindowControlsOverlayRect(const gfx::Rect& overlay_rect); + // Methods called by the WebContents. virtual void HandleKeyboardEvent( content::WebContents*, @@ -298,6 +301,7 @@ class NativeWindow : public base::SupportsUserData, const base::DictionaryValue& details); void NotifyNewWindowForTab(); void NotifyWindowSystemContextMenu(int x, int y, bool* prevent_default); + void NotifyLayoutWindowControlsOverlay(); #if defined(OS_WIN) void NotifyWindowMessage(UINT message, WPARAM w_param, LPARAM l_param); @@ -342,6 +346,8 @@ class NativeWindow : public base::SupportsUserData, [&browser_view](NativeBrowserView* n) { return (n == browser_view); }); } + bool titlebar_overlay_ = false; + private: std::unique_ptr widget_; @@ -390,6 +396,8 @@ class NativeWindow : public base::SupportsUserData, // Accessible title. std::u16string accessible_title_; + gfx::Rect overlay_rect_; + base::WeakPtrFactory weak_factory_{this}; DISALLOW_COPY_AND_ASSIGN(NativeWindow); diff --git a/shell/browser/native_window_mac.h b/shell/browser/native_window_mac.h index 52d052a7be348..3ba33127e5ffd 100644 --- a/shell/browser/native_window_mac.h +++ b/shell/browser/native_window_mac.h @@ -146,6 +146,7 @@ class NativeWindowMac : public NativeWindow, void CloseFilePreview() override; gfx::Rect ContentBoundsToWindowBounds(const gfx::Rect& bounds) const override; gfx::Rect WindowBoundsToContentBounds(const gfx::Rect& bounds) const override; + gfx::Rect GetWindowControlsOverlayRect() override; void NotifyWindowEnterFullScreen() override; void NotifyWindowLeaveFullScreen() override; void SetActive(bool is_key) override; diff --git a/shell/browser/native_window_mac.mm b/shell/browser/native_window_mac.mm index 9c8b3438184a1..afad4e8f595e4 100644 --- a/shell/browser/native_window_mac.mm +++ b/shell/browser/native_window_mac.mm @@ -1453,6 +1453,7 @@ void ViewDidMoveToSuperview(NSView* self, SEL _cmd) { void NativeWindowMac::SetWindowButtonVisibility(bool visible) { window_button_visibility_ = visible; InternalSetWindowButtonVisibility(visible); + NotifyLayoutWindowControlsOverlay(); } bool NativeWindowMac::GetWindowButtonVisibility() const { @@ -1470,6 +1471,7 @@ void ViewDidMoveToSuperview(NSView* self, SEL _cmd) { if (buttons_view_) { [buttons_view_ setMargin:traffic_light_position_]; [buttons_view_ viewDidMoveToWindow]; + NotifyLayoutWindowControlsOverlay(); } } @@ -1809,6 +1811,27 @@ void ViewDidMoveToSuperview(NSView* self, SEL _cmd) { [window_ setAcceptsMouseMovedEvents:forward]; } +gfx::Rect NativeWindowMac::GetWindowControlsOverlayRect() { + gfx::Rect bounding_rect; + if (titlebar_overlay_ && !has_frame() && buttons_view_ && + ![buttons_view_ isHidden]) { + NSRect button_frame = [buttons_view_ frame]; + gfx::Point buttons_view_margin = [buttons_view_ getMargin]; + const int overlay_width = GetContentSize().width() - NSWidth(button_frame) - + buttons_view_margin.x(); + CGFloat overlay_height = + NSHeight(button_frame) + buttons_view_margin.y() * 2; + if (base::i18n::IsRTL()) { + bounding_rect = gfx::Rect(0, 0, overlay_width, overlay_height); + } else { + bounding_rect = + gfx::Rect(button_frame.size.width + buttons_view_margin.x(), 0, + overlay_width, overlay_height); + } + } + return bounding_rect; +} + // static NativeWindow* NativeWindow::Create(const gin_helper::Dictionary& options, NativeWindow* parent) { diff --git a/shell/browser/native_window_observer.h b/shell/browser/native_window_observer.h index 4f33570de4b02..caa38e4ffa121 100644 --- a/shell/browser/native_window_observer.h +++ b/shell/browser/native_window_observer.h @@ -104,6 +104,8 @@ class NativeWindowObserver : public base::CheckedObserver { // Called on Windows when App Commands arrive (WM_APPCOMMAND) // Some commands are implemented on on other platforms as well virtual void OnExecuteAppCommand(const std::string& command_name) {} + + virtual void UpdateWindowControlsOverlay(const gfx::Rect& bounding_rect) {} }; } // namespace electron diff --git a/shell/browser/ui/cocoa/window_buttons_view.h b/shell/browser/ui/cocoa/window_buttons_view.h index 0adb34ac1be36..d1941bcb4276f 100644 --- a/shell/browser/ui/cocoa/window_buttons_view.h +++ b/shell/browser/ui/cocoa/window_buttons_view.h @@ -26,6 +26,7 @@ - (void)setMargin:(const absl::optional&)margin; - (void)setShowOnHover:(BOOL)yes; - (void)setNeedsDisplayForButtons; +- (gfx::Point)getMargin; @end #endif // SHELL_BROWSER_UI_COCOA_WINDOW_BUTTONS_VIEW_H_ diff --git a/shell/browser/ui/cocoa/window_buttons_view.mm b/shell/browser/ui/cocoa/window_buttons_view.mm index 5ed4a2d14c69d..c51aff3f5d3ac 100644 --- a/shell/browser/ui/cocoa/window_buttons_view.mm +++ b/shell/browser/ui/cocoa/window_buttons_view.mm @@ -116,4 +116,8 @@ - (void)mouseExited:(NSEvent*)event { [self setNeedsDisplayForButtons]; } +- (gfx::Point)getMargin { + return margin_; +} + @end diff --git a/shell/common/options_switches.cc b/shell/common/options_switches.cc index 1f036963feef5..da619b9f5fe15 100644 --- a/shell/common/options_switches.cc +++ b/shell/common/options_switches.cc @@ -194,6 +194,8 @@ const char kEnableWebSQL[] = "enableWebSQL"; const char kEnablePreferredSizeMode[] = "enablePreferredSizeMode"; +const char ktitleBarOverlay[] = "titleBarOverlay"; + } // namespace options namespace switches { diff --git a/shell/common/options_switches.h b/shell/common/options_switches.h index e26ad90712976..47d0db155bfbc 100644 --- a/shell/common/options_switches.h +++ b/shell/common/options_switches.h @@ -57,6 +57,7 @@ extern const char kVibrancyType[]; extern const char kVisualEffectState[]; extern const char kTrafficLightPosition[]; extern const char kRoundedCorners[]; +extern const char ktitleBarOverlay[]; // WebPreferences. extern const char kZoomFactor[]; diff --git a/spec-main/api-browser-window-spec.ts b/spec-main/api-browser-window-spec.ts index 4eb8ba6d42c63..bccf2fa11134e 100644 --- a/spec-main/api-browser-window-spec.ts +++ b/spec-main/api-browser-window-spec.ts @@ -1863,7 +1863,36 @@ describe('BrowserWindow module', () => { }); ifdescribe(process.platform === 'darwin' && parseInt(os.release().split('.')[0]) >= 14)('"titleBarStyle" option', () => { + const testWindowsOverlay = async (style: any) => { + const w = new BrowserWindow({ + show: false, + width: 400, + height: 400, + titleBarStyle: style, + webPreferences: { + nodeIntegration: true, + contextIsolation: false + }, + titleBarOverlay: true + }); + const overlayHTML = path.join(__dirname, 'fixtures', 'pages', 'overlay.html'); + await w.loadFile(overlayHTML); + const overlayEnabled = await w.webContents.executeJavaScript('navigator.windowControlsOverlay.visible'); + expect(overlayEnabled).to.be.true('overlayEnabled'); + const overlayRect = await w.webContents.executeJavaScript('getJSOverlayProperties()'); + expect(overlayRect.y).to.equal(0); + expect(overlayRect.x).to.be.greaterThan(0); + expect(overlayRect.width).to.be.greaterThan(0); + expect(overlayRect.height).to.be.greaterThan(0); + const cssOverlayRect = await w.webContents.executeJavaScript('getCssOverlayProperties();'); + expect(cssOverlayRect).to.deep.equal(overlayRect); + const geometryChange = emittedOnce(ipcMain, 'geometrychange'); + w.setBounds({ width: 800 }); + const [, newOverlayRect] = await geometryChange; + expect(newOverlayRect.width).to.equal(overlayRect.width + 400); + }; afterEach(closeAllWindows); + afterEach(() => { ipcMain.removeAllListeners('geometrychange'); }); it('creates browser window with hidden title bar', () => { const w = new BrowserWindow({ show: false, @@ -1884,6 +1913,12 @@ describe('BrowserWindow module', () => { const contentSize = w.getContentSize(); expect(contentSize).to.deep.equal([400, 400]); }); + it('sets Window Control Overlay with hidden title bar', async () => { + await testWindowsOverlay('hidden'); + }); + it('sets Window Control Overlay with hidden inset title bar', async () => { + await testWindowsOverlay('hiddenInset'); + }); }); ifdescribe(process.platform === 'darwin')('"enableLargerThanScreen" option', () => { diff --git a/spec-main/fixtures/pages/overlay.html b/spec-main/fixtures/pages/overlay.html new file mode 100644 index 0000000000000..ef7408e53331d --- /dev/null +++ b/spec-main/fixtures/pages/overlay.html @@ -0,0 +1,84 @@ + + + + + + + + + +
+
+ Title goes here + +
+
+
+ + +