documentation/handy-standard-firefox-features.md

   1 <!--
   2 This is part of the VimFx documentation.
   3 Copyright Simon Lydell 2015, 2016.
   4 See the file README.md for copying conditions.
   5 -->
   6
   7 # Handy standard Firefox features
   8
   9 One of VimFx’s key features is embracing standard Firefox features. That is
  10 preferred over re-implementing similar functionality.
  11
  12 This section lists a few handy such standard features.
  13
  14
  15 ## The location bar
  16
  17 Firefox’s location bar is sometimes called the “Awesomebar” because it is so
  18 powerful. Other than simply entering URLs, you can also use it to:
  19
  20 - Search through bookmarks. `*`
  21 - Search through history. `^`
  22 - Search through open tabs. `%`
  23 - Search using search engines.
  24
  25 Type a lone `*`, `^` or `%` to search for _only_ bookmarks, history or tabs,
  26 respectively. If you use this a lot, you might be interested in adding a [custom
  27 command as a shortcut][location-bar-custom-command].
  28
  29 Use `<c-enter>` to open results in new tabs.
  30
  31 Here’s [documentation for all of the cool Awesomebar features][location-bar].
  32
  33 [location-bar]: http://kb.mozillazine.org/Location_Bar_search
  34 [location-bar-custom-command]: https://github.com/akhodakivskiy/VimFx/wiki/Custom-Commands#search-bookmarks--search-open-tabs
  35
  36
  37 ## Menus
  38
  39 Use the `ec` command to open the context menu of elements. (If that fails, try
  40 and see if the element can be focused using the `ef` command—if so, you should
  41 be able to open the context menu using the `<menu>` key.)
  42
  43 Instead of clicking on menus, you can press `<a-accesskey>` where “accesskey” is
  44 the underlined letter of the menu name. Sometimes the underlines aren’t visible
  45 until you hold the `<alt>` key. In already open menus, you can type the access
  46 key _without_ holding `<alt>`. If there is no access key for the menu item you
  47 want to activate, you can usually start typing the name of the menu item to go
  48 to it. This is a nice alternative to using the arrow keys. This is true for most
  49 programs, not just Firefox.
  50
  51 Here are two examples where the above comes especially in handy for VimFx:
  52
  53 - You can use the `ec` command to open the context menu of an image, a link or a
  54   video, providing you a plethora of things to do with the focused target, such
  55   as saving an image or the target of a link. For videos, the access key for the
  56   “Play/Pause” menu item is often `p`. This allows you, for example, to control
  57   some video players using the keyboard.
  58
  59 - When using the `gH` command (which opens the back/forward button menu), or the
  60   `gX` command (which opens the Recently Closed Tabs menu), you can start typing
  61   the name of one the entries of the list to go to it (if you don’t feel like
  62   using the good ol’ arrow keys and `<enter>`).