UI listener - Factor Documentation (original) (raw)
The graphical listener adds input history and word and vocabulary completion. A summary with any outstanding error conditions is displayed before every prompt (see UI error list tool for details).
If the file ~/.factor-history exists, input history is made persistent by appending history once the graphical listener closes and reading it back in upon (re)starting.
See The listener for general information on the listener.
Toolbar commands
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| Restart Listener | restart-listener | ||
| ⌘U | Auto Use | com-auto-use | |
| ⌘K | Clear Output | clear-output | |
| ⇧⌘K | Clear Stack | clear-stack | |
| F1 | Help | com-help |
Completion commands
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| TAB | Code Completion Popup | code-completion-popup | |
| ⌃P | Recall Previous | recall-previous | |
| ⌃N | Recall Next | recall-next | |
| ⌃R | History Completion Popup | history-completion-popup | |
| ⌃S | History Completion Popup | history-completion-popup |
Interactor commands
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| RET | Evaluate Input | evaluate-input | |
| ⌃D | Delete Next Character/Eof | delete-next-character/eof |
Scrolling commands
The listener's scroller can be scrolled from the keyboard.
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| ⌘UP | Scroll Up | com-scroll-up | |
| ⌘DOWN | Scroll Down | com-scroll-down | |
| ⌘PAGE_UP | Page Up | com-page-up | |
| ⌘PAGE_DOWN | Page Down | com-page-down |
Multi Touch commands
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| Swipe up | Refresh All | refresh-all |
Word commands
These words operate on the word at the cursor.
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| Inspector | inspector | ||
| Prettyprint | com-prettyprint | ||
| Push | com-push | ||
| Unparse | com-unparse | ||
| Copy Object | com-copy-object | ||
| ⌃E | Edit | edit | |
| Forget | com-forget | ||
| ⌃H | Browse | com-browse | |
| Browse New | com-browse-new | ||
| ⌃U | Usage | usage. | |
| ⌃F | Fix | fix | |
| Watch | watch | ||
| Breakpoint | breakpoint | ||
| See | see | ||
| Copy Json | copy-json | ||
| Speak | speak |
Vocabulary commands
These words operate on the vocabulary at the cursor.
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| Inspector | inspector | ||
| Prettyprint | com-prettyprint | ||
| Push | com-push | ||
| Unparse | com-unparse | ||
| Copy Object | com-copy-object | ||
| ⌃E | Edit | edit | |
| Forget | com-forget | ||
| ⌃H | Browse | com-browse | |
| Browse New | com-browse-new | ||
| Use Vocab | com-use-vocab | ||
| Run | run | ||
| Deploy Tool | deploy-tool | ||
| Copy Json | copy-json |
Quotation commands
These commands operate on the entire contents of the input area.
| Shortcut | Command | Word | Notes |
|---|---|---|---|
| Inspector | inspector | ||
| Prettyprint | com-prettyprint | ||
| Push | com-push | ||
| Unparse | com-unparse | ||
| Copy Object | com-copy-object | ||
| ⌃I | Stack Effect | com-stack-effect | |
| ⌃W | Walk | walk | |
| ⌃T | Time | time | |
| ⌃M | Expand Macros | com-expand-macros |
Editing commands
The text editing commands are standard; see Editor gadget commands.
Implementation
Listeners are instances of listener-gadget. The listener consists of an output area (instance of pane) and an input area (instance of interactor). Clickable presentations can also be printed to the listener; see Presentations in the UI.