KMeleonWiki > Documentation > MouseGestures

Mouse Gestures Plugin

The Gestures plugin is a versatile new addition to K-Meleon 0.8.1.

This new feature is enabled by default. It is as simple to use as right-clicking while sliding your mouse left or right. You need to make a quick sweep left while right-clicking to navigate back to the previous page. Or move your mouse to the right while right-clicking for forward navigation.

Of course this is not all this feature can do. K-Meleon gives you the ability to customise your own functions by adding preferences to your user.js file.

Default Preferences

user_pref("kmeleon.plugins.gestures.left", "ID_NAV_BACK?");
user_pref("kmeleon.plugins.gestures.right", "ID_NAV_FORWARD?");

Customisable Preferences

user_pref("kmeleon.plugins.gestures.down", "macro/commandID/pluginMsg?");
user_pref("kmeleon.plugins.gestures.downleft", "macro/commandID/pluginMsg?");
user_pref("kmeleon.plugins.gestures.downright", "macro/commandID/pluginMsg?");
user_pref("kmeleon.plugins.gestures.up", "macro/commandID/pluginMsg?");
user_pref("kmeleon.plugins.gestures.upleft", "macro/commandID/pluginMsg?");
user_pref("kmeleon.plugins.gestures.upright", "macro/commandID/pluginMsg?");
user_pref("kmeleon.plugins.gestures.mindist", "pixels?");
user_pref("kmeleon.plugins.gestures.split", "percent?");
user_pref("kmeleon.plugins.gestures.maxslip", "percent?");
user_pref("kmeleon.plugins.gestures.maxtime", "milliseconds?");

Movements less than "mindist" are normal clicks. The "split" tells how big slice of the pie to give for the axes (100% = only axes, no diagonals; 0% = no axes only diagonals). With "maxslip" you can set how sloppy you may draw (0% = not a pixel wrong; 100% = always produces a direction). After "maxtime" milliseconds the gesture times-out and you get a normal click.

New Customisable Preferences in K-Meleon 0.8.2

You can now have actions that depend on whether Shift, Control or Alt in pressed; whether the Left, Middle or Right mouse buttons is used; and whether you click on an Image or Link or not. (left and middle mouse button require at least one of shift, control or alt)
Add one or more of [S,C,A] and [L,M,R] before the direction (in that order) and one, two or none of [L,I] (in that order) after the direction to get the preference name. Use "nomove" for simple clicks.

user_pref("kmeleon.plugins.gestures.S,C,A?L,M,R?Direction?L,I?",
              "macro/commandID/pluginMsg?");

[Direction] : up, down, left, right, upleft, upright, downleft, downright, nomove

Examples

user_pref("kmeleon.plugins.gestures.upleft", "layers(Open)");
user_pref("kmeleon.plugins.gestures.up", "ID_NAV_HOME?");

# workaround for bug 547
user_pref("kmeleon.plugins.gestures.SLnomoveI", "ID_SAVE_IMAGE_AS?");
user_pref("kmeleon.plugins.gestures.SLnomoveLI", "ID_SAVE_IMAGE_AS?");

# gestures like StrokeIt? for KM
user_pref("kmeleon.plugins.gestures.RdownL", "ID_OPEN_LINK_IN_NEW_WINDOW?");
user_pref("kmeleon.plugins.gestures.RdownrightL", "ID_OPEN_LINK_IN_BACKGROUND?");

user_pref("kmeleon.plugins.gestures.SRdownL", "layers(OpenLink?)");
user_pref("kmeleon.plugins.gestures.SRdownrightL", "layers(OpenLinkBg?)");