documentation/button.md

   1 <!--
   2 This is part of the VimFx documentation.
   3 Copyright Simon Lydell 2015.
   4 See the file README.md for copying conditions.
   5 -->
   6
   7 # Button
   8
   9 VimFx has a toolbar button. It looks like this: ![VimFx button icon].
  10
  11 When in Normal mode, clicking it opens VimFx’s Keyboard Shortcuts dialog, just
  12 like the `?` shortcut does.
  13
  14 In other modes, clicking it returns you to normal mode. If you feel like VimFx
  15 does not respond to any of your key presses, it might be because you’re not in
  16 Normal mode. If you don’t know how to exit that mode (or have accidentally
  17 removed the keyboard shortcut to do so), clicking the button is the way to
  18 “escape” back to Normal mode. (On such occasions, you can hover the button and
  19 its tooltip will say what mode you’re currently in.)
  20
  21 In Ignore mode, the icon also turns red, like this: ![VimFx button icon red].
  22 ([Blacklisted] sites enter Ignore mode automatically.) The reason is that the
  23 whole point of Ignore mode is to “ignore” all of VimFx’s commands, passing your
  24 key presses to the page instead. It is helpful to know that you’re really in
  25 Ignore mode, so you can be confident that your key presses do what you expect
  26 them to. (See [Styling] if you’d like to highlight Ignore mode, or any mode for
  27 that matter, some other way.)
  28
  29 Other modes are easily detectable. You know that you’re in Find mode if the find
  30 bar is focued. If there are hint markers visible for the page, you’re in Hints
  31 mode.
  32
  33 A quick takeaway from this part of the documentation: **If you don’t know what’s
  34 going on, look for VimFx’s toolbar button.** It can often help you.
  35
  36 [VimFx button icon]: ../extension/skin/icon16.png
  37 [VimFx button icon red]: ../extension/skin/icon16-red.png
  38 [Blacklisted]: options.md#blacklist
  39 [Styling]: styling.md