Skip to content
Pauta5.0.0

Window shell

Editora's Welcome tab
Editora's Welcome page: Start actions with their chords, Recent Projects, Recent Files and Customize.
Rules on this page 7
IDLevelRule
WIN-01MUST
A status bar is always present (it can be toggled). Its left side is the echo area: one line of feedback for the last action, errors in red and warnings in amber. Clicking it opens the Message Log.
WIN-03MUST
On Windows and Linux the menu bar sits in the title bar by default: JavaFX 27’s HeaderBar with StageStyle.EXTENDED carries the menu or tabs, and a setting that starts on lets the user fall back to a decorated window. On macOS the menus are in the system menu bar (useSystemMenuBar), in a decorated window.
WIN-04SHOULD
Native dialogs go through one helper that attaches the app stylesheet and the UI font.
WIN-11MUST
A dialog’s buttons are in the same order on every OS, with Cancel to the left of the action, as the Confirm dialog draws them: the dialog’s ButtonBar gets one fixed order, never JavaFX’s default for the OS. See Same on every OS.
WIN-08SHOULD
Window size, position, maximized state and open items are restored on the next launch. --no-session skipping the restore is CLI-04.
WIN-09SHOULD
UI and content zoom from the keyboard (Ctrl/Cmd +, -, 0), kept across launches. The UI zoom scales the whole chrome, the menus (MENU-16), toolbar, tabs and status bar included, so a person who needs larger text gets it everywhere.
WIN-10MAY
Modes: Zen (no chrome), Simple (fewer menus for new users), Expert.
  • WIN-01 MUST A status bar is always present (it can be toggled). Its left side is the echo area: one line of feedback for the last action, errors in red and warnings in amber. Clicking it opens the Message Log.
    • Check (code): the echo label switches between an error and a warning style class, and its click handler runs the Message Log command.
    • Reference: Editora ui/StatusBar.java (status-echo-error, status-echo-warn; a click runs view.messageLog) and the Message Log template.
  • WIN-03 MUST On Windows and Linux the menu bar sits in the title bar by default: JavaFX 27’s HeaderBar with StageStyle.EXTENDED carries the menu or tabs, and a setting that starts on lets the user fall back to a decorated window. On macOS the menus are in the system menu bar (useSystemMenuBar), in a decorated window.
    • Why: the family looks the same on every OS only if every app starts with the same title bar; an app that ships it off looks like another family.
    • Check (code): the main stage is created StageStyle.EXTENDED with a HeaderBar; the setting that falls back to a decorated window defaults to on (in the title bar) on Windows and Linux; the menu bar sets useSystemMenuBar on macOS.
    • Reference: the app template (config/Settings.java, titleBarMenus = true) and Mirada, whose title bar is always a HeaderBar. Editora (ui/ExtendedWindow.java, ui/MainMenuBar.java), Torrenta and Termina have the setting but start it off.
  • WIN-04 SHOULD Native dialogs go through one helper that attaches the app stylesheet and the UI font.
    • Why: a dialog is its own scene and inherits neither.
    • Check (code): every Alert and Dialog the app builds passes through the helper.
    • Reference: Editora ui/Dialogs.java (Dialogs.styled).
  • WIN-11 MUST A dialog’s buttons are in the same order on every OS, with Cancel to the left of the action, as the Confirm dialog draws them: the dialog’s ButtonBar gets one fixed order, never JavaFX’s default for the OS. See Same on every OS.
    • Why: JavaFX orders a ButtonBar by the OS it runs on (BUTTON_ORDER_WINDOWS, _MAC_OS, _LINUX), so the same confirmation puts its action on the left on Windows and on the right on macOS and Linux.
    • Check (code): the dialog helper (WIN-04), or each dialog, calls setButtonOrder on the dialog pane’s ButtonBar with one constant.
    • Reference: no app yet. Editora’s Git confirmations give their buttons the OK_DONE and CANCEL_CLOSE roles and leave the order to JavaFX.
  • WIN-08 SHOULD Window size, position, maximized state and open items are restored on the next launch. --no-session skipping the restore is CLI-04.
  • WIN-09 SHOULD UI and content zoom from the keyboard (Ctrl/Cmd +, -, 0), kept across launches. The UI zoom scales the whole chrome, the menus (MENU-16), toolbar, tabs and status bar included, so a person who needs larger text gets it everywhere.
    • Check (code): zoom in, out and reset are commands bound in every keymap, the zoom level is a saved setting, and the chrome’s fixed sizes are multiplied by the UI zoom rather than written as absolute pixels.
    • Reference: Editora zooms content only: view.textZoomIn, view.textZoomOut and view.textZoomReset, kept in Settings.fontZoom.
  • WIN-10 MAY Modes: Zen (no chrome), Simple (fewer menus for new users), Expert.

The rest of the window has its own pages. Light and dark themes switched at run time, the “follow the system” choice and what the state colors mean are ICON-15, ICON-16 and ICON-18. A destructive action asks first through the Confirm dialog (CONF-01 to CONF-04). The Welcome page is WELC-01, and the About window is ABOUT-02 and ABOUT-09.

Mirada with its file name and folder in a HeaderBar title bar, an info panel and a thumbnail strip
Mirada's HeaderBar title bar carries the file name and folder; the info panel and thumbnails are commands too.
Termina window with tabs in the title bar and a tab context menu
Termina puts its tabs in the title bar with JavaFX 27's HeaderBar.
Editora's View menu open with toggle commands and their chords
Every menu item is a command and shows its chord.

Pauta 5.0.0 · · Changelog · This page in the latest edition