&dactyl.host;'s GUI
Although &dactyl.appName; offers access to the most frequently used
&dactyl.host; functionality via Ex and Normal mode commands, there may be
times when direct access to the &dactyl.host; GUI is required. For such
eventualities, there are commands to access menu items and to launch
standard &dactyl.host; dialogs.
Menus
-
:emenu
:emenu menu
Execute menu from the command line. This command provides command-line access
to all menu items available from the main &dactyl.host; menubar. menu is a
hierarchical path to the menu item with each submenu separated by a period.
E.g. :emenu File.Open File… launches the standard
&dactyl.host; ‘Open File’ dialog.
Dialogs
-
:ao :addo :addons
:addons
Opens the add-on list.
-
:dia :dialog
:dialog &dactyl.host;-dialog
Open a &dactyl.host; dialog. Available dialogs include:
-
:dl :downl :downloads
:downloads
Show progress of current downloads. Here, downloads can
be paused, resumed, and canceled.
Available options include:
- -sort
- Sort order (see downloadsort) (short name: -s)
-
:dlc :dlclear
:dlclear
Clear completed downloads.
Add-ons
The following commands manipulate the currently installed
add-ons. With the exception of :extadd, they all except
the following arguments:
- -types
- The types of add-ons to operate on, the most
common types being extension, theme, and plugin (short names -type,
-t)
-
:exta :extadd
:extadd file|url
Install an extension. file|uri must be the local file
path or URL of an XPInstall (.xpi) file.
-
:extrm :extde :extdelete
:extdelete extension
:extdelete!
Uninstall an extension. extension is the extension's name. When ! is given
all extensions are uninstalled.
-
:extd :extdisable
:extdisable extension
:extdisable!
Disable an extension. extension is the extension's name. When ! is given
all extensions are disabled.
-
:exte :extenable
:extenable extension
:extenable!
Enable an extension. extension is the extension's name. When ! is given all
extensions are enabled.
-
:exto :extoptions
:extoptions! extension
:extp :extpreferences
:extpreferences! extension
Open the preferences dialog for an extension. If ! is given, open a dialog,
otherwise open a buffer. See also newtab.
-
:extr :extrehash
:extrehash extension
:extrehash
Toggle an extension's enabled status twice. This is useful for rebooting
a restartless extension.
-
:extt :exttoggle
:exttoggle extension
:exttoggle
Toggle an extension's enabled status.
-
:extu :extupdate
:extupdate extension
:extupdate!
Update an extension. When ! is given, update all
extensions.
Sidebar
-
:sbcl :sbclose
:sbclose
Close the sidebar window.
-
:sbope :sbopen :sb :sbar :sideb :sidebar
:sidebar name
Open the sidebar window. name is any of the menu items listed under the
standard &dactyl.host; View->Sidebar menu. Add-ons, Preferences and Downloads are
also available in the sidebar.
-
:sidebar! name
Toggle the sidebar window. When name is provided, the
semantics are as follows: If the named sidebar is currently open,
it is closed. Otherwise the named sidebar is opened. When
name is not provided, the semantics are as follows: If the
sidebar is currently open, it is closed. Otherwise the previously
open sidebar panel is re-opened.
Status line
The status line appears at the bottom of each window. You can use
guioptions to specify if and when the status line appears, as well
as its relation to the command line and messages.
The status line contains several fields that provide information about the
state of the current buffer. These are, in order:
-
URL: The URL of the currently loaded page. While the page is loading,
progress messages are also output to this field.
-
History and bookmark status ([+-❤⋯]): The position
of the current page in the tab's session history; - and
+ indicate that it is possible to move backwards and forwards
through the history respectively. ❤ indicates that the current page is
bookmarked. Any other character indicates a QuickMark matching the
current page.
-
Tab index ([N/M]): N is the index of the
currently selected tab and M is the total number of tabs in
the current window.
-
Vertical scroll: The vertical scroll percentage of the current buffer,
or Top or Bot for the top and bottom of the buffer respectively.
-
Security: The security information button is displayed when appropriate
as per &dactyl.host;. The color of the status bar also changes to reflect the
current security status of the loaded page.
- black
- The site's identity is unverified and the connection is unencrypted
- red
- The connection is encrypted, but the site's identity has not been verified or it contains unencrypted content
- blue
- The site's domain has been verified and the connection is encrypted
- green
- The site's domain and owner have been fully verified via an Extended Validation certificate and the connection is encrypted
-
Extensions: Any extension buttons that would normally be installed to the
&dactyl.host; status bar are appended to the end of the status line.
Toolbars
-
:tbs :tbshow :toolbars :toolbarshow
:toolbarshow name
Shows the named toolbar.
-
:tbh :tbhide :toolbarh :toolbarhide
:toolbarhide name
Hides the named toolbar.
-
:tbt :tbtoggle :toolbart :toolbartoggle
:toolbartoggle name
Toggles the named toolbar.