myusernamejeep / superfish

Superfish is a jQuery plugin that adds usability enhancements to existing multi-level drop-down menus.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

jQuery Superfish Dropdown Menu Plugin

Our favourite aquatic superhero returns from his sojourn across the galaxy infused with astonishing, hitherto unseen new powers. In his modern incarnation (wearing a rather spiffy cape) Superfish is dedicated to keeping dropdown/flyout menus accessible across browsers great and small, in addition to adding support for newer touch devices (running Android, iOS, Windows, etc). All this and a pretty face.

Documentation and Demos

Please use the existing Superfish documentation where you will find full explanations of the customisable features and plenty of examples to get you started.

Download

###Important notes before you download:

  • For your existing Superfish menus, you may prefer to stick with your earlier version unless you are prepared to alter your CSS to hide submenus using display:none rather than off-canvas (eg. top:-999em), otherwise you may lose closing animations (the submenus will be off-canvas while the animation happens). Also, the arrow CSS has changed completely to use pseudo-elements.
  • As of Superfish v1.5.1 if you wish to enhance your menu with Brian Cherne's hoverIntent plugin (highly recommended) you will need to use the latest version (r7) which now supports event delegation.
  • Follow this link if you need an easy solution to address a hoverIntent conflict with WordPress.

Recently added features

  • v1.7.3: You can now use Superfish to create mega-menus. CSS file and example page included. Regardless of whether mega-menus are evil, at least now they'll be touch-compatible.
  • v1.7.2: "Fastclicks" for Android browsers and IE10 touch interactions.
  • v1.7.1: Added basic tests (require "Testem" and CoffeeScript to run).
  • v1.7: Full code restructure to use best-practice method access. Use .superfish('show') and .superfish('hide') instead of deprecated showSuperfishUl() and hideSuperfishUl() (which will be removed soon).
  • v1.7: Added destroy method.
  • v1.7: Replaced autoArrows feature with pure CSS arrows for easier customisation and performance (no image http request).
  • v1.7: Removed useClick feature. Should be a separate plugin (feel free to beat me to creating it). See issue #47.
  • v1.6: Full CSS refactor for easier customisation. Supports unlimited levels of nested submenus.
  • v1.6: Supersubs plugin replaced by a couple of lines of CSS. The width of each submenu will be determined by its widest child list item. To disable, just remove the white-space rule in the main CSS file.
  • Full support for touch devices. Android browsers, iOS Safari, IE9 on Windows Phone 7, Windows 8 IE10 with touchscreen. Touch to open submenus, touch again to follow the link. Be sure to include hoverIntent for widest support.

Need help?

Superfish menus have been in use since the dawn of time (let's say 7 years or so) and many are the places where you can find help with your Superfish implementations. Check out the support options.

About

Superfish is a jQuery plugin that adds usability enhancements to existing multi-level drop-down menus.

License:Other