Menus and dialogs
Every menu in the application works the same way, and so does every dialog: learn the keys once and they hold for the menu bar, the places list and the context menu alike, and for every question the application asks.
Text too long for its room — in a menu, a dialog, the viewer’s top line or the status line — is cut
with a … where the rest was: a path loses its middle, so both where it starts and where it
ends still show, and anything else its end.
Menus
The menu bar’s menus, the places list, a pane’s history, the favorites, the user menu and the menu about a file all take the same keys.
| Press | And |
|---|---|
| ↑ ↓ | Move, round from either end, stepping over rules and gray rows |
| Page Up Page Down Home End | Jump, stopping at the ends |
| Enter | Does the row chosen |
| Esc | Closes the menu |
| Letters | Narrow the menu to the rows whose names contain what you typed, which is shown in its frame — Places: do. ⌫ takes a letter back |
| A row’s digit or symbol | Does that row |
| ⌥ with a row’s letter | Does that row. A letter alone narrows the menu, so a row’s letter needs ⌥ |
| → ← | Open the submenu of a row that ends in ►, and close it again |
- A row’s letter is marked in red in its name, and only a digit or a symbol is written before the name. A key at a row’s right edge is the one that does the same with the menu closed — inside the menu, that key does nothing.
- A digit keeps the modifier it has outside the menu where the row answers to it there: a favorite in the places list is ⌘1, as it is over the panes.
- Where several rows share a letter, ⌥ with it moves from one to the next rather than doing any, and Enter does the one chosen. A gray row counts, so what a letter does never changes as rows gray and come back.
- A gray row cannot be done here now. It keeps its place and its key, so a menu reads the same wherever it is opened.
- The key that opened a menu, pressed again, can open something fuller in its place: the places list becomes Go to folder.
- A menu longer than the window shows what fits, scrolled to the row chosen, with a scroll bar down
the right of its frame: the thumb says how much shows and how far down it is, and
▲or▼is lit while there is more that way. - While a menu is up, no key reaches what is under it — except the size of the text.
The mouse. Click a row to do it. Click anywhere off the menu to close it. The wheel scrolls the
rows without doing one; so does the scroll bar, a row at a time on ▲ and ▼, and a page on the
track above or below the thumb. A row scrolled out of sight is never the chosen one: the choice
moves to the nearest row still showing.
Dialogs
A dialog asks something, or shows something being done, in the middle of the window.
| Press | And |
|---|---|
| Tab ⇧Tab | The next field or button, or the one before, round from either end |
| ↓ ↑ | The same, where the field has no use for them |
| ← → | Along the buttons, once a button has the focus |
| ⌥ with an underlined letter | That field, from anywhere in the dialog — or that button, check box or choice, pressed |
| Space | Presses the button, ticks the check box or opens the dropdown with the focus |
| Enter | Presses the button with the focus; anywhere else, the dialog’s main button, in yellow. A question about something that cannot be undone may have none |
| Esc | Closes it without doing what it asks |
- A gray button cannot be pressed now, and Tab passes over it.
- While a dialog is open, the last row of the screen names the keys that work in it, in place of the
key bar and in its very cells. The first is always Enter
with the button it presses, drawn as
⏎:⏎Copy. The keys of the field you are in follow, where it has some of its own —⌥↓Historyand⌘OBrowsein a field that takes a path,⌨Findin a list longer than it shows, where typing finds a row. Keys that go without saying, Esc, Tab, the arrows that only move and ⌥ with an underlined letter, are not named. The cells stay where they are as you move from field to field, and only what they say changes: a key that does nothing in the field you are in is gray, and a word already said by Enter is gray beside the other key. A click on a cell presses its key. - Where something is waiting on the answer — a copy asking about a name that is taken — Esc skips that one thing. Where you have chosen things that are not set until you accept — the settings, the view options — Esc asks before it throws them away.
- A yellow dialog is about something that will be stopped or replaced: quitting while a copy runs, putting a backup back.
- While a dialog is up, no key reaches what is under it — except the size of the text.
In a small window
A dialog is never taller or wider than the window: its frame and its buttons are always in view, and what is between them gives way.
- Too tall, its lists and text boxes get shorter first. If that is not enough the content scrolls, with a scrollbar on the frame’s right edge, and follows the focus as Tab moves through it.
- Page Up and Page Down scroll it where the field with the focus has no use for them. The wheel scrolls it from anywhere but over a list, which scrolls itself, and a click on the scrollbar pages toward the click.
- Too wide, its fields, lists and text boxes narrow, and text wraps again or ends in
…. Buttons too many for one row take a second. - File types, Key bindings, User menu and Checksums fit a window 80 columns wide.
- Send feedback and Report a problem can be sent at any size.
What is in them
- Check box
[x] - Space, a click or its letter ticks it and unticks it.
- A list of check boxes
- Space ticks the row the cursor is on; the arrows and the page keys move.
- Choice
(*) - All the options are shown. ←, → or Space change it, a click picks one, and an option with an underlined letter is picked by ⌥ and that letter.
- Dropdown
▼ - Shows the choice made. Space, ⌥↓, a click or its letter opens the list. ↑, ↓, ← and → change the choice without opening it — so move off it with Tab.
- Field that remembers
[ ↺ ] - A text field, with what you typed there before behind the button: the last five, newest first, shared by every field that asks the same question. ⌥↓ or a click on the button opens them, and picking one puts it in the field, to use or to change. Typing does not narrow the list.
- Field with
[ ▼ ] - A text field offering words it is often given. Anything you type is taken as well.
- Field that takes a path
-
Wherever a file or a folder is asked for — Go to folder, where a copy goes, the files to compare, where a search starts, Save as — what the path could become is offered as you type.
- The rest of the best match is in gray after the cursor. →, End or / takes it.
- Whatever fits is listed under the field, a single match too. ↓ goes into the list, and the field shows each row you land on, with what you typed in one color and what was filled in in another. Tab or Enter takes the row and leaves you in the field; a click on a row takes it too.
- ↑ past the top of the list, or ↓ past its end, gives back what you typed. So does Esc, which also puts the list away; a second Esc closes the dialog.
- Out of the list, Tab moves to the next field and Enter accepts what you typed.
~is your home folder, upper and lower case are not told apart, and a name starting with a dot is offered once you type the dot.- A folder typed in other capitals takes its own spelling, as the disk has it, in Go to folder, a favorite’s folder and where a copy goes.
- A pasted
file://address, or a path quoted or escaped as a terminal writes one, becomes a plain path. - Where the field already knows the path will not do — nothing by that name, where something has to be there — it says so under the field before you press anything.
[ … ]at its end, or ⌘O, opens the picker.
- The picker
[ … ] -
The folders along a path side by side, each a list headed by its folder’s name, with the path under them. It opens on what the field holds.
- ↑ and ↓ move in the last list, with the page keys, Home and End.
- With the cursor on a folder, marked
►, the next list shows what it holds, with nothing chosen in it. → goes into it and ← comes back out. Going deeper slides the lists along. - Typing letters finds the names that start with them in the last list. Its border shows what
you typed and which match the cursor is on —
doc · 1 of 3— and the rows that do not match are dimmed. ↑ and ↓ go from match to match, and Backspace takes a letter back. Esc, ←, →, Tab, a click, or Backspace over the last letter ends it and leaves the cursor where it is; that Esc does not close the picker. - The path line under the lists follows as you move. Typing or pasting a path there moves the lists, and →, End or / takes the gray part as in any path field.
- Enter or Choose puts what the path line names into the field you came from, and Esc or Cancel leaves the field as it was. Where a file is asked for, Enter on a folder goes into it; where a folder is asked for, Enter chooses it and → goes inside.
- For a name that is not there yet — saving under a new name — type it on the path line, after the folder it goes in. Where a file may be new, as in Save as, the picker opens on the path line.
- What cannot be chosen is gray, and the line under the path says why. That line otherwise gives the name, the size and the date of what the path names, and says so where Enter would go into a folder.
- Hidden files shows names starting with a dot. Where only some kinds of file are taken, Show lists those kinds or all files.
- F7 makes a new folder in the last list and goes to it.
- A click puts the cursor on a row of any list, so one click on a folder shows what it holds. A double-click does what Enter does on that row.
- Number
▲▼ - ↑ and ↓ step it by one, or click the arrows; digits type it. It stays within its range.
- Text field
- ← and →, with ⌥ a word at a time; ⌘← and ⌘→, or Home and End, to either end. ⇧ with an arrow, Home or End selects. ⌘A, ⌘C, ⌘X and ⌘V as anywhere. What you type replaces what is selected, and a double-click selects a word.
- List
- The arrows and the page keys move; typing jumps to the first row containing what you type.
The mouse. Click a field to put the focus there, or a button to press it. Drag a dialog by its frame, or by anything in it that is not a field, to move it; it stays where you put it when the window changes size. The wheel scrolls the list under the pointer.