3.0.9 • Published 3 years ago

@kevinbaubet/togglemenu v3.0.9

Weekly downloads
1
License
MIT
Repository
github
Last release
3 years ago

Documentation ToggleMenu

ToggleMenu est un gestionnaire de menu. Il permet de gérer plusieurs types de menu (hover, megamenu, menu overlay, etc...). Chaque type de menu correspond à un fichier JS à charger. Le principe est de d'abord initialiser le gestionnaire (ToggleMenu), puis ensuite d'initialiser un type de menu, par exemple hover.

  • Compatibilité : IE10+
  • Dépendance : jQuery

Initialiser ToggleMenu

var toggleMenu = new $.ToggleMenu([options]);
  • @param {object} options (optionnel) Options de ToggleMenu

      var toggleMenu = new $.ToggleMenu({
          menuComplete: function () {
              console.log(this.type + ' loaded');
          }
      });
      
      

Initialiser un menu

toggleMenu.addMenu('hover', [options]);

Menus

Liste des menus présents dans ToggleMenu :

Menu supplémentaire

Options ToggleMenu

OptionTypeValeur par défautDescription
classesobjectVoir ci-dessousObjet pour l'option ci-dessous
    prefixstring'togglemenu'Préfix de classe
    openstring'is-{prefix}-open'Nom de la classe lorsque le menu est ouvert
    activestring'is-active'Nom de la classe lorsque un élément parent est actif
menuBeforeLoadfunctionundefinedCallback au début du chargement du menu
menuCompletefunctionundefinedCallback à la fin du chargement du menu
menuUnloadfunctionundefinedCallback à la suppression du menu

API ToggleMenu

API utilisable seulement avec l'objet ToggleMenu.

setOptions()

Enregistre les options pour un menu

  • @param {string} type Type de menu
  • @param {object} options Options du menu

      toggleMenu.setOptions('push', {
          onToggle: function () {
              console.log('open/close menu');
          }
      });

toggleMenu()

Switch le menu courant vers un nouveau

  • @param {string} type Type de menu
  • @param {object=undefined} options Options du menu

      toggleMenu.toggleMenu('push');

addMenu()

Ajout d'un menu

  • @param {string} type Type de menu
  • @param {object=undefined} options Options du menu

      toggleMenu.addMenu('hover');
      toggleMenu.addMenu('push');

removeMenu()

Suppression du menu courant

  • @param {string=undefined} type Type de menu

      toggleMenu.removeMenu(); // remove current menu
      toggleMenu.removeMenu('hover');

isCurrentMenu()

Détermine si c'est le menu courant

  • @param {string} type Type de menu
  • @return {boolean}

      if (toggleMenu.isCurrentMenu('hover')) {
          toggleMenu.removeMenu();
      }

getMenuClassName()

Récupère le nom de la classe du menu correspondant

  • @param {string} type Type de menu
  • @return {string}

getInstances()

Récupère les instances en cours

  • @return {object}

API Menus

API globale à tous les menus de ToggleMenu.

getItemsParent()

Récupère les éléments parents en fonction d'un contexte

  • @param {object} search Élément jQuery dans lequel la recherche d'éléments parents sera effectée
  • @return {object}

onReady()

Une fois ToggleMenu prêt

  • @param {function} callback Fonction à exécuter

getElements()

Retourne tous les éléments de toggleMenu

  • @return {object}

getContentElements()

Retourne tous les éléments de contenu

  • @return {object}

getWrapper()

Retourne le wrapper global

  • @return {object}

setLog()

Créer un log

  • @param {string} log
  • @param {string=undefined} type

      toggleMenu.setLog('information message');
      toggleMenu.setLog('warning!', 'warn');
      toggleMenu.setLog('error message', 'error');
      
      

replacePrefixClass()

Remplace la chaine {prefix} par la classe de préfix dans toutes les classes

3.0.9

3 years ago

3.0.8

4 years ago

3.0.7

4 years ago

3.0.6

4 years ago

3.0.5

4 years ago

3.0.4

4 years ago

3.0.3

4 years ago

3.0.2

5 years ago

3.0.1

5 years ago

3.0.0

5 years ago