Skip to content

Document secondary window modality and the JFrame modality hint - #5774

Open
taefi wants to merge 1 commit into
mainfrom
secondary-jframe-dialogs
Open

taefi wants to merge 1 commit into
mainfrom
secondary-jframe-dialogs

Conversation

@taefi

@taefi taefi commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Description

Documents how SwingBridge renders secondary Swing windows and how to control the modality of a secondary JFrame.

  • New Secondary Windows page (swing-bridge/secondary-windows.adoc): how JDialog, JFrame, and JWindow surface as overlays; JDialog follows its real isModal(); JFrame/JWindow are modeless by default and can opt into modal rendering via the WindowHints.MODALITY root-pane client property, with a full example and the required dependency. Includes a behavior-change note (secondary JFrame was previously modal by default).
  • Reference page: added a WindowHints API table.
  • FAQ: added an entry explaining the modal-to-modeless default change and how to restore blocking behavior.

Documents the feature implemented in vaadin/vaadin-swing-bridge#220. Code PR: vaadin/vaadin-swing-bridge#226.

@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Preview Deployment

This PR has been deployed for preview.

URL: https://docs-preview-pr-5774.fly.dev

Changed pages

Added content is highlighted in green; removed content is marked in red on each page.

Built from 993ab5c

Add a Secondary Windows page explaining how SwingBridge renders secondary
JDialog, JFrame, and JWindow instances, and how a secondary JFrame/JWindow
is modeless by default but can opt into modal rendering via the
WindowHints.MODALITY client-property hint. Document WindowHints in the
Reference page and add an FAQ entry about the modal-to-modeless default change.
@taefi
taefi force-pushed the secondary-jframe-dialogs branch from 20c8805 to 49d817d Compare July 1, 2026 16:21
@taefi
taefi requested a review from eftunv July 1, 2026 16:27
@peholmst peholmst added the target/v25.3 Automatically cherry-pick to the v25.3 branch label Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

target/v25.3 Automatically cherry-pick to the v25.3 branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants