Changelog

When updating from an older version, have a look at the problem solving page and try using the debugger.

The changelog

• Version 8.2 (July 10, 2019)
  1. Replaced the initPanels API method (for initiating multiple panels) with initPanel (for initiating a single panel).
  2. Added the option expanded.initial to the sidebar add-on to control the initial state of the sidebar.
  3. Improved the scrollBugFix add-on.
  4. Improved the navbar add-on.
  5. Improved the toggles add-on.
  6. Deprecated the next content for the navbars add-on.
  7. Fixed a bug in the columns add-on.
  8. Fixed a bug where the plugin was not exported as a module.
• Version 8.1 (June 3, 2019)
  1. Moved the clone configuration option to the offCanvas add-on.
  2. Bugfixes in searchfield add-on.
  3. Made contents and types for navbars extendable in the navbars add-on.
• Version 8.0 (March 31, 2019)
  1. jQuery is no longer a dependency, a plugin for it (or for Zepto) is automatically created when available.
  2. All API methods and hooks that took a jQuery object as an argument, now take a HTMLElement or an array of HTMLElements as an argument.
  3. The plugin is now written and can be used as an EcmaScript 2015 module.
  4. The plugin is now written as an EcmaScript 2015 class.
  5. All JavaScript in the plugin is now typed.
  6. All JavaScript in the plugin is now annotated.
  7. The script targets modern browsers, polyfills are needed for older browsers.
  8. Imporved and simplyfied CSS for Toggles and Checks.
  9. Improved and simplified CSS for Panels, Listviews and Navbars.
  10. Navbars in the navbars add-on can now be en-/disabled based on a media query.
  11. Added the use option for a navbar in the navbars add-on.
  12. Removed the navbar.height option in favor of using a different --mm-navbar-size CSS variable for each navbar.
  13. The iconbar can now be en-/disabled based on a media query.
  14. Renamed the iconbar.add option to iconbar.use.
  15. Added the iconbar.position option.
  16. Removed the dividers.fixed option, all dividers are now sticky by default.
  17. Removed the pageScroll.scrollOffset configuration option in favor of using the native element.scrollIntoView method.
  18. Renamed the mm_include_listviews_spacer SCSS variable to mm_include_listview_spacer.
  19. Moved all CSS variables to the global scope (:root).
  20. Moved CSS for Spacer listitems to the listview extension.
  21. Moved CSS for Dividers to the dividers add-on.
  22. Removed bower support.
  23. Restructured files.
  24. Replaced the fixedElements.elemInsertMethod configuration option with fixedElements.fixed.insertMethod.
  25. Replaced the fixedElements.elemInsertSelector configuration option with fixedElements.fixed.insertselector.
  26. Removed the offCanvas.page.wrapIfNeeded configuration option, the page is now always wrapped if needed.
  27. Updated Gulp to version 4 for the build process.
  28. Changed the build proces in favor of the ES6 module.
  29. Changed the custom build proces in favor of the ES6 module.
  30. Removed jQuery mobile framework wrapper.
  31. Removed bootstrap 3 framework wrapper.
• Version 7.2 (September 23, 2018)
  1. Added CSS variables for colors.
  2. Added SCSS and CSS variables for top/right/bottom/left offset.
  3. Added shadow-menu to the shadows extension.
  4. Bugfixes
• Version 7.1 (September 14, 2018)
  1. Moved RTL support from separate add-on into core, extension and add-on files.
  2. Removed RTL add-on
  3. Added language configuration option.
  4. Added Russian translations.
  5. Changed the configuration for the offCanvas add-on.
  6. Replaced some SCSS variables with CSS variables with SCSS variables as a fallback.
  7. Changes in SCSS variables.
  8. Added fitViewport option in the dropdown add-on.
  9. Removed some of the core $mm_opt_ SCSS variables.
  10. Updated the screenReader add-on with adding text to the page-blocker.
  11. Improved the keyboardNavigation add-on.
  12. Bugfixes.
• Version 7.0 (January 4, 2018)
  1. Added the iconbar add-on.
  2. Replaced the iconbar and widescreen extensions with the sidebar add-on.
  3. Added tab like styling for the navbars add-on.
  4. Updated the iconPanels add-on with new options.
  5. Updated the backButton add-on with now options.
  6. Updated the searchfield add-on with new options.
  7. Removed the initPanels and initMenu options in favor of the hooks option.
  8. Implemented a (sort of) B.E.M. structure for the CSS framework.
  9. Added type option in the dividers add-on.
  10. Improved matchMedia for responsive extensions and options.
  11. Completely extracted the positioning extension out of the offCanvas add-on.
  12. Option navbar.title can now be a function.
  13. Removed dividers.collapse option in favor of using vertical submenus.
  14. Removed the offCanvas.zposition: "next" option.
  15. Moved divider and spacer css out of listview extension into core.
  16. Split up SCSS variables and mixins per extension and addon.
  17. Added SCSS variables to opt out of almost all CSS.
  18. Styling inherits more from website styles.
• Version 6.1 (May 16, 2017)
  1. Using Typescript.
  2. Using gulp-sass instead of gulp-ruby-sass.
  3. Removed "toggles" and "checks" from search results in resultsPanel.
  4. Added support for sticky elements in the fixedElements add-on.
  5. Delayed opening the menu via the URL hash till API hooks are added.
  6. Disabled the keyboardNavigation add-on for touchscreens.
  7. Added sticky.offset configuration option for the fixedElements add-on.
  8. Bugfix lazySubmenus add-on with selected item.
  9. Bugfix autoHeight add-on with vertical submenus.
  10. Bugfix in the screenReader add-on.
  11. Optionally UMD custom build.
• Version 6.0 (March 20, 2017)
  1. Added responsive option for extensions.
  2. Added pageScroll add-on.
  3. Plugin is now translatable.
  4. Added translations for Dutch and German.
  5. Easy custom builds with Gulp.
  6. Added screenReader add-on to the core and turned on by default.
  7. Added "nolistview" and "nopanel" to classNames configuration option.
  8. Changed file structure for the core JS and CSS.
  9. Enabled opting out parts of CSS.
  10. Added listview extension.
  11. Refactored justifiedListview extension in the listview extension.
  12. Made the UMD file the default.
  13. Improved the navbars add-on.
  14. Improved the keyboardNavigation add-on.
  15. Improved the screenReader add-on.
  16. Added and renamed a lot of API methods and hooks.
  17. Removed the update method from the API.
  18. Changed update option to count for the counters add-on.
  19. Removed "panel" value for the navbar.titleLink option.
  20. Added "fx-panels-slide-up" and "fx-panels-none" to the effects extionsion.
  21. Added $mm_pagedimOpacity SCSS variable for the pageDim extension.
  22. Renamed effects in the effects extension.
  23. CSS changes.
  24. Updated the turbolinks framework wrapper.
  25. offCanvas.menuInjectMethod is no longer restricted to "append" or "prepend".
  26. Replaced the offCanvas.menuInjectMethod configuration option with offCanvas.menuInsertMethod.
  27. Replaced the offCanvas.menuWrapperSelector configuration option with offCanvas.menuInsertSelector.
  28. Added fixedElements.elemInsertMethod and fixedElements.elemInsertSelector configuration options.
  29. A lot of refactoring.
• Version 5.7 (August 20, 2016)
  1. Added keyboardNavigation add-on.
  2. Added lazySubmenus add-on.
  3. Added Bootstrap framework wrapper.
  4. Added initMenu and initPanels options.
  5. Renamed init API method to initPanels.
  6. Added RTL add-on.
  7. Integrated the leftSubpanels extension into the RTL add-on.
  8. Integrated the currentItem add-on into the setSelected add-on.
  9. Combined the dragOpen and dragClose add-ons into the drag add-on.
  10. Combined the pageshadow and panelshadow extensions into the shadows extension.
  11. Removed hideNavbars option for the columns add-on.
  12. Removed hideNavbars option for the iconPanels add-on.
  13. Added scss color for navbars.
  14. Improved WordPress framework wrapper.
  15. Improved support for IE9.
  16. Fixed issue with opening a menu from within a second menu.
• Version 5.6 (January 16, 2016)
  1. Fixed issue with on-canvas menus.
  2. Changed license to CC-BY-NC-4.0.
  3. Added justiedListview extension.
  4. Added popup extension.
  5. Added columns add-on.
  6. Added dropdown add-on.
  7. Added screenReader add-on.
  8. Added setSelected add-on.
  9. Added AngularJS framework wrapper.
  10. Added Magento framework wrapper.
  11. Added "highest" as a value for the autoHeight.height option.
  12. Added counters.addTo option.
  13. Added searchfield.resultsPanel option.
  14. Searchfield searches the data-mm-searchtext attribute first.
  15. Added configuration options for the searchfield addon.
  16. Added openingPanel, openedPanel, closingPanel and closedPanel callback methods to the API.
  17. Menu opens if menu ID in URL hash.
  18. Improved the debugger.
  19. Switched to Gulp as task runner.
  20. Set the UMD file as the main file in bower.json en package.json
  21. Optimized css vendor prefixes with Gulp Autoprefixer.
  22. Changed file structure and directory names.
  23. Fixed issues and bugs.
• Version 5.5 (September 29, 2015)
  1. Replaced option offCanvas.modal with offCanvas.blockUI.
  2. Removed option onClick.blockUI.
  3. Added pageDim extension.
  4. Added style "border-offset" to the borderStyle extension.
  5. Added effects "listitems-fade" and "listitems-drop" to the effects extension.
  6. Changed names for the effects extension.
• Version 5.4 (August 15, 2015)
  1. Added jQuery Mobile framework wrapper.
  2. Added Olark framework wrapper.
  3. Added Turbolinks framework wrapper.
  4. Added WordPress framework wrapper.
  5. Changed HTML markup for panels.
  6. Added offCanvas.noPageSelector configuration option.
  7. Rearranged file structure.
  8. Small bugfixes and changes.
• Version 5.3 (June 16, 2015)
  1. Added breadcrubs for navar content.
  2. Added tileview extension.
  3. Added iconPanels add-on.
  4. Added navbar.add option.
  5. Simplified colors SCSS mixins.
  6. Small improvements to the CSS framework.
• Version 5.2 (May 11, 2015)
  1. Added effects "fade-menu" and "slide-listitems".
  2. Added iconPanels add-on.
  3. Added support for multiple navbars in one menu.
  4. Added navbars.height option.
  5. Integrated the searchfield add-on in the navbars add-on.
  6. Added options navbar.title and navbar.titleLink for usage without the navbars add-on.
  7. Added navbar to main panel for usage without the navbars add-on.
  8. Added support for "inset" lists.
  9. Added offCanvas.wrapPageIfNeeded configuration option.
  10. Improved closing multiple panels simultatiously.
  11. Restored support for checks and toggles in vertical submenus.
• Version 5.1 (April 20, 2015)
  1. Replaced the header, footer and buttonbars add-ons with the navbars add-on.
  2. Changed effect "slide" to "slide-menu".
  3. Added effects "slide-panels-0" and "slide-panels-100".
  4. Added utility classname mm-arrow.
  5. Improved non-listview navigation.
• Version 5.0 (March 21, 2015)
  1. Standardized HTML markup for panels and listviews.
  2. Changes in styling, colors and sizes.
  3. Moved custom event to API methods.
  4. Added closeAllPanels API method.
  5. Added pageShadow extension.
  6. Added multiline extension.
  7. Added borderStyle extension.
  8. Added sectionIndexer add-on.
  9. Added backButton add-on.
  10. Replaced labels add-on with dividers add-on.
  11. Added add, addTo and fixed options for the dividers add-on.
  12. Added titleLink option for the header add-on.
  13. Changed showLinksOnly option to showTextItems for the searchfield add-on.
  14. Added showSubPanels option for the searchfield add-on.
  15. Made vertical submenus possible per panel.
  16. Changed classname "mm-label" and "Label" to "mm-divider" and "Divider".
  17. Changed classname "mm-list" to "mm-listview".
  18. Replaced "classes" option with "extensions" array.
  19. iconbar and widescreen extensions require to be added to the "extensions" option.
  20. Merged styling and functionality from the header add-on into default subtitle.
  21. Removed mm_colors_header SCSS mixin.
  22. Added ontouchmove on overlay to close menu.
  23. data-target Is added to anchors for bootstrap support.
  24. Extended add-on structure.
  25. Moved minified .js and generated .css files to the "dist" folder.
  26. Added support for turbolinks.
  27. Bugfix searchfield in DIV panel.
  28. Extended event namespaces with add-on name.
• Version 4.7 (November 10, 2014)
  1. Fixed issues with anchors.
  2. Rewrote add-on structure.
  3. Rewrote fixed elements add-on.
  4. Added searchfield.form configuration setting.
• Version 4.6 (October 24, 2014)
  1. Introduced an external debugging script.
  2. Added support for variable buttons/content in the header.
  3. Added support for a close button in the header.
  4. Added object for vendor-specific options.
  5. Small CSS fixes.
• Version 4.5 (August 29, 2014)
  1. Removed support for the "zoom page" effect.
  2. Moved from using left/top/right/bottom to translate for all CSS transitions.
  3. Added buttonbars add-on.
  4. Added option to create checkmarks in the toggles add-on.
  5. Added footer add-on.
  6. Moved support for fixed elements inside the page to an add-on.
• Version 4.4 (August 18, 2014)
  1. Added option to put text/html in the header previous- and next buttons.
  2. Updated the dragOpen add-on with the latest version of the Hammer library (and no longer requiring the jQuery.hammer plugin).
  3. Added a template file for add-ons to the download pack.
  4. Removed unnecessary vendor prefixes in the CSS framework.
  5. Added option to load and initiate new content in the menu.
  6. Changed panel offset when opening a subpanel from 40% to 30%.
  7. Small CSS improvements.
• Version 4.3 (June 3, 2014)
  1. Prefixed SCSS mixins and variables.
  2. Improved performance issue with larger menu's.
  3. Added JS files with support for umd patterns.
  4. Added option to add a searchfield per panel.
  5. Added toggles add-on.
  6. Added support for on-canvas menus.
  7. Split up default behavior into an on-canvas menu with off-canvas add-on.
  8. Removed labels.fixed due to bad performance.
  9. Removed support for IE8.
  10. Moved modal and moveBackground options to offCanvas object.
  11. Moved pageNodetype, pageSelector, menuWrapperSelector and menuInjectMethod config options to offCanvas object.
  12. Moved classnames config to classNames object.
• Version 4.2 (March 5, 2014)
  1. Improved CSS framework to remove opening glitch.
  2. Deprecated using position: "top"/"bottom" in combination with zposition: "back"/"next" in favor of the improved CSS framework.
  3. Removed older deprecated warnings.
  4. Small JS and CSS improvements.
  5. Removed config option preventTabbing.
  6. Added config option menuInjectMethod.
  7. Added config option menuWrapperSelector.
• Version 4.1 (November 14, 2013)
  1. Added labels option for fixed labels and labels that collapse the subsequent listitems as an add-on.
  2. Added support for the header add-on in vertical menus.
  3. Added header.content option to pre-define the contents of the header.
  4. Introduced classname Spacer to add spacing between listitems in the menu.
  5. Labels use an ellipsis for overflowing text.
  6. Small bugfixes.
• Version 4.0 (October 29, 2013)
  1. Completely rewrote plugin to an OO class.
  2. Adapted styling to iOS7.
  3. Started using SCSS.
  4. Using SCSS framework to automatically create CSS for customized colors.
  5. Using SCSS framework to automatically create CSS for customized min- and max width/height.
  6. Moved JS and CSS files for counters, searchfield and dragOpen to separate add-on files.
  7. Renamed JS and CSS files.
  8. Improved HTML markup and CSS framework.
  9. Improved CSS for variable item heights.
  10. Improved non-menu options and behavior.
  11. Added header option for a fixed menu-header as an add-on.
  12. Added option classes.
  13. Added option dragOpen.maxStartPos.
  14. Changed option counters.count to counters.update.
  15. Added fullscreen CSS extension.
  16. Added effects CSS extension.
  17. Added default themes white and black CSS extensions.
  18. Plugin adds classname mm-current to currently opened menu and currently opened panel.
  19. Introduced classname mm-fixed-top and mm-fixed-bottom for moving fixed elements with the page.
  20. Added support for ordered lists (OL).
  21. Removed onClick.callback and onClick.delayLocationHref options.
  22. Removed support for onClick = true/false.
  23. Renamed onClick.setLocationHref option to onClick.preventDefault (with opposite behavior).
  24. Removed toggle custom event for menu.
  25. Removed close and toggle custom events for horizontal sliding panels.
  26. Replaced default hardware acceleration configuration (true) with a optional CSS extension.
  27. Removed useIphoneAddressbarFix method as it has no effect on the iOS7 addressbar.