JQHoverMenuContrib

Display a dropdown menu hovering over a button

Description

creates a simple drop down menu

Usage

%JQREQUIRE{"hoverMenu"}%
<ul class="foswikiHoverMenu" data-menu="ul:first" data-sensitivity="3" data-timeout="500">
  <li><a>Menu 1</a>
    <ul>
     <li> [[Link 1]] </li>
     <li> [[Link 2]] </li>
     <li> [[Link 3]] </li>
     <li> [[Link 4]] </li>
    </ul>
  </li>
  <li><a>Menu 2</a>
    <ul>
     <li> [[Link 5]] </li>
     <li> [[Link 6]] </li>
     <li> [[Link 7]] </li>
     <li> [[Link 8]] </li>
    </ul>
  </li>
</ul>

Parameters:

* data-menu: the list for this button * data-sensitivity: the higher the value the more sensitive the hover action is to opening the menu * data-timeout: timeout when the hover event is triggered

See JQueryHoverIntent for more details on the parameters.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -> "Install, Update or Remove extensions" Tab. Click the "Search for Extensions" button. Enter part of the extension name or description and press search. Select the desired extension(s) and click install. If an extension is already installed, it will not show up in the search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)

cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Dependencies

None

Change History

27 Jan 2025

initial release