QuickOpen picker
SHOULD serve every “choose one from a list” moment: recent files, themes, keymaps,
a setting’s values, a branch to compare with. It is the Command Palette card with a title over
the field and a prompt in it, so a list choice is made the way a command is run: type a few letters, Enter. Reference:
Editora’s ui/QuickOpen.java (one generic class, instantiated about sixty times), driven by PickerKeys and shown
by OverlayHost. The keyboard page states the rule; this page is the shape.
Anatomy
Section titled “Anatomy”1 Jump to Recent File
mai2
4MainController.java~/src/Editora/src/main/java/com/editora/ui5
6MainMenuBar.java~/src/Editora/src/main/java/com/editora/ui
messages_it.properties~/src/Editora/src/main/resources/com/editora/i18n3
Domain.java~/src/Editora/src/main/java/com/editora/lsp
mirada.css unsaved~/src/Mirada/src/main/resources/com/mirada/styles
7 ↵ select
- 1Title. The command that opened the picker ("Jump to Recent File", "Set App Theme"), bold 12 px in the muted color. This is what tells the picker apart from the palette, which has no title.
- 2Query field with a prompt per picker: "Type to filter recent files…", "Type to filter themes…". The Emacs caret keys work in it (
TextInputKeymap.installShared). - 3Match highlight. The characters the fuzzy matcher scored, bold in the accent color; the same
MatchText.runsas the palette, so the highlight and the rank never disagree. - 4Selected row. The first match, or with nothing typed the value in force when the picker knows it (
setCurrentItem), so a settings picker opens on the current value. - 5Detail, right-aligned and muted: the file's folder, a branch's upstream, "current". It gives way with an ellipsis; the title keeps its width and never wraps.
- 6Icon (optional,
setItemIcon): a file-type glyph fromFileIcons. A per-row class marks state (an unsaved buffer in amber). - 7Key legend. "↵ select" plus any row action's key, rebuilt from the active keymap on every showing.
| Property | Value | Reference |
|---|---|---|
| Kind | The palette’s card in the shared in-scene OverlayHost, over the same scrim; never a javafx.stage.Popup | QuickOpen.setOverlayHost, OverlayHost |
| Width | 620 px; a picker may ask for its own width and a minimum number of rows (a registry browser with one entry still gets a roomy box) | DEFAULT_WIDTH, setPreferredSize |
| Rows | 26 px fixed cells; the list hugs its match count, at least 1 row, 12 before it scrolls | CELL_HEIGHT, MAX_VISIBLE, resizeList |
| Title | Bold 12 px, -color-fg-muted, over the field | .command-palette .palette-title |
| Row | Title as matched runs, an optional icon before it, the detail in the palette’s muted right-detail style | ItemCell, .keybinding |
| Legend | 11 px muted under the list | .command-palette .palette-hint |
| Card | -color-bg-overlay, radius 12, 1 px -color-border-default, padding 6: the palette’s | .command-palette |
| Ranking | FuzzyMatch over the search key (the label unless the picker names another, a note’s body for instance); equal scores keep the supplier’s order | filter |
Behavior
Section titled “Behavior”- Open from a command. The items are read fresh on every showing and snapshotted, so typing filters a stable
list; a source that answers late (an outline the language server has not returned yet) calls
reload(). - Nothing typed: the supplier’s own order, which is the meaningful one (recency for recent files, document order for symbols), with the current value pre-selected when there is one. Typing ranks by fuzzy score; ties keep their order so rows do not shuffle under the cursor between keystrokes.
- Move: the active keymap’s line and page chords (
nav.lineDown,nav.pageUp, …) plus ↑ ↓, Page Up/Down, Home and End, which always work. Choose: Enter, or a click on a row. The card hides first, then the choice runs, so focus is already back where it belongs. - Cancel: Esc,
C-g, or a click on the scrim. The host restores focus. A picker that previewed something undoes it. - Preview MAY.
setPreview(onPreview, onCancelled)previews the highlighted row as the selection moves and undoes it on cancel: Recent Locations shows each place and returns to the origin on Esc. A preview without an undo is worse than none. Nothing is previewed for the row the picker opens on, only for one the user moved to. The theme and keymap pickers do not preview; they apply on Enter. - Row actions MAY.
addRowAction(key, legend, action)acts on the highlighted row and keeps the picker open (the breakpoints picker enables or removes one), re-reading the list afterwards and keeping the cursor in place. - Empty list: a placeholder sentence in the list (
setPlaceholder), never a blank card. - One card at a time. The host shows one card; opening a picker replaces whatever card was up.
- Relatives. The Open Files
Switcherlists tabs in tab order, opens on the current one and closes a file withC-dor Backspace.FileFinderis the Emacsfind-filefield with Tab completion.MultiSelectPickerticks several rows with Space where exactly one would be wrong.BranchPopupandGitStashPopupare sectioned pickers with their own actions. All of them usePickerKeys, so they move, accept and cancel alike.
| App | Picked with it | Reference |
|---|---|---|
| Recent files (with file icons), recent locations (previewed), bookmarks, the structure outline, tool windows, open files, projects, keymap, app and editor theme, spell language, a setting’s values (opened on the current value), branches, tags and commits to compare with, remotes, commit message history, the kill ring, Occur lines, external tools, macros, the debug main class, breakpoints, agent models | NavigationCoordinator, EditorSettingsCoordinator, DiffCoordinator, DebugCoordinator, BreakpointsPicker | |
| Go to bookmark…, Open recent folder…: the palette shown over a list of names with a detail per row and an “open” legend | CommandPalette.Choices, ViewerWindow | |
| Termina, Torrenta, Modula, nux | Commands only; profiles and other lists are menus or combo boxes today | CommandPalette in each |
| Key | English |
|---|---|
nav.recentFiles.title / .prompt | Jump to Recent File / Type to filter recent files… |
palette.theme.appTitle, palette.theme.editorTitle / palette.theme.prompt | Set App Theme, Set Editor Theme / Type to filter themes… |
command.keymap.select / palette.keymap.prompt | Keymap: Select… / Type to filter keymaps… |
palette.setting.pick | Type to filter… |
pickerKeys.select, pickerKeys.open, pickerKeys.cancel | {0} select, {0} open, {0} cancel |
switcher.header | Open Files |
A title names the command; a prompt starts with “Type to filter” and ends with an ellipsis. A placeholder says what is missing and what to do (“No breakpoints set. Click a line number to add one.”).
In the apps
Section titled “In the apps”

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