UI listener
Factor handbook » UI developer tools

Prev:Definition icons
Next:UI browser


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
ShortcutCommandWordNotes
Restart Listenerrestart-listener
⌘UAuto Usecom-auto-use
⌘KClear Outputclear-output
⇧⌘KClear Stackclear-stack
F1Helpcom-help



Completion commands
ShortcutCommandWordNotes
TABCode Completion Popupcode-completion-popup
⌃PRecall Previousrecall-previous
⌃NRecall Nextrecall-next
⌃RHistory Completion Popuphistory-completion-popup
⌃SHistory Completion Popuphistory-completion-popup



Interactor commands
ShortcutCommandWordNotes
RETEvaluate Inputevaluate-input
⌃DDelete Next Character/Eofdelete-next-character/eof



Scrolling commands
The listener's scroller can be scrolled from the keyboard.
ShortcutCommandWordNotes
⌘UPScroll Upcom-scroll-up
⌘DOWNScroll Downcom-scroll-down
⌘PAGE_UPPage Upcom-page-up
⌘PAGE_DOWNPage Downcom-page-down



Multi Touch commands
ShortcutCommandWordNotes
Swipe upRefresh Allrefresh-all



Word commands
These words operate on the word at the cursor.
ShortcutCommandWordNotes
Inspectorinspector
Prettyprintcom-prettyprint
Pushcom-push
Unparsecom-unparse
Copy Objectcom-copy-object
⌃EEditedit
Forgetcom-forget
⌃HBrowsecom-browse
Browse Newcom-browse-new
⌃UUsageusage.
⌃FFixfix
Watchwatch
Breakpointbreakpoint
Seesee
Copy Jsoncopy-json
Speakspeak



Vocabulary commands
These words operate on the vocabulary at the cursor.
ShortcutCommandWordNotes
Inspectorinspector
Prettyprintcom-prettyprint
Pushcom-push
Unparsecom-unparse
Copy Objectcom-copy-object
⌃EEditedit
Forgetcom-forget
⌃HBrowsecom-browse
Browse Newcom-browse-new
Use Vocabcom-use-vocab
Runrun
Deploy Tooldeploy-tool
Copy Jsoncopy-json



Quotation commands
These commands operate on the entire contents of the input area.
ShortcutCommandWordNotes
Inspectorinspector
Prettyprintcom-prettyprint
Pushcom-push
Unparsecom-unparse
Copy Objectcom-copy-object
⌃IStack Effectcom-stack-effect
⌃WWalkwalk
⌃TTimetime
⌃MExpand Macroscom-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.