Ionic Menu latéral

Un élément conteneur contient le menu latéral et le contenu principal. En faisant glisser la zone de contenu principale d'un côté à l'autre, le menu latéral gauche ou droit est basculé.

L'effet est présenté ci-dessous :

Utilisation

Pour utiliser le menu latéral, ajoutez un élément parent `<ion-side-menus>`, un contenu intermédiaire `<ion-side-menu-content>`, et une ou plusieurs directives `<ion-side-menu>`.

<ion-side-menus>
  <!-- 中间内容 -->
  <ion-side-menu-content ng-controller="ContentController">
  </ion-side-menu-content>

  <!-- 左侧菜单 -->
  <ion-side-menu side="left">
  </ion-side-menu>

  <!-- 右侧菜单 -->
  <ion-side-menu side="right">
  </ion-side-menu>
</ion-side-menus>
function ContentController($scope, $ionicSideMenuDelegate) {
  $scope.toggleLeft = function() {
    $ionicSideMenuDelegate.toggleLeft();
  };
}

API

Attributes Type Détails
enable-menu-with-back-views
(Facultatif)
Boolean value

Indique s'il faut activer le menu latéral lorsque le bouton de retour est affiché.

delegate-handle String Ce handle est utilisé pour identifier la vue de défilement avec $ionicScrollDelegate.

ion-side-menu-content

Un conteneur pour le contenu principal visible, avec une ou plusieurs directives `ionSideMenu` comme éléments frères.

Utilisation

<ion-side-menu-content
  drag-content="true">
</ion-side-menu-content>

API

Attributes Type Détails
drag-content
(Facultatif)
Boolean value

Indique si le contenu peut être glissé. La valeur par défaut est true.


ion-side-menu

Un conteneur pour un menu latéral, avec une directive `ion-side-menu-content` comme élément frère.

Utilisation

<ion-side-menu
  side="left"
  width="myWidthValue + 20"
  is-enabled="shouldLeftSideMenuBeEnabled()">
</ion-side-menu>

API

Attributes Type Détails
side String

De quel côté se trouve actuellement le menu latéral. Les valeurs possibles sont : `'left'` ou `'right'`.

is-enabled
(Facultatif)
Boolean value

Indique si le menu latéral est activé.

width
(Facultatif)
Numeric value

Largeur en pixels du menu latéral. La valeur par défaut est 275.


menu-toggle

Afficher/masquer le menu dans un menu latéral spécifié.

Utilisation

Voici un exemple de lien dans la barre de navigation. Cliquer sur ce lien ouvrira automatiquement le menu latéral spécifié.

<ion-view>
  <ion-nav-buttons side="left">
   <button menu-toggle="left" class="button button-icon icon ion-navicon"></button>
  </ion-nav-buttons>
 ...
</ion-view>

menu-close

Fermer le menu latéral actuellement ouvert.

Utilisation

Voici un exemple de lien dans la barre de navigation. Cliquer sur ce lien ouvrira automatiquement le menu latéral spécifié.

<a menu-close href="../index.html" class="item">首页</a>

$ionicSideMenuDelegate

Cette méthode déclenche directement le service $ionicSideMenuDelegate pour contrôler tous les menus latéraux. Utilisez la méthode $getByHandle pour contrôler les ionSideMenus dans des cas spécifiques.

Utilisation

<body ng-controller="MainCtrl">
  <ion-side-menus>
    <ion-side-menu-content>
      内容!
      <button ng-click="toggleLeftSideMenu()">
        切换左侧侧栏菜单
      </button>
    </ion-side-menu-content>
    <ion-side-menu side="left">
      左侧菜单!
    <ion-side-menu>
  </ion-side-menus>
</body>
function MainCtrl($scope, $ionicSideMenuDelegate) {
  $scope.toggleLeftSideMenu = function() {
    $ionicSideMenuDelegate.toggleLeft();
  };
}

Méthodes

toggleLeft([isOpen])

Afficher/masquer le menu latéral gauche (s'il existe).

Parameters Type Détails
isOpen
(Facultatif)
Boolean value

Indique si le menu doit être ouvert ou fermé. Par défaut : afficher/masquer le menu.

toggleRight([isOpen])

Afficher/masquer le menu latéral droit (s'il existe).

Parameters Type Détails
isOpen
(Facultatif)
Boolean value

Indique si le menu doit être ouvert ou fermé. Par défaut : afficher/masquer le menu.

getOpenRatio()

Obtenez la proportion du contenu du menu ouvert qui dépasse la largeur du menu. Par exemple, un menu d'une largeur de 100px ouvert à 50% (50px) renverra une valeur de ratio de 0.5.

Valeur de retour :Float. 0 signifie non ouvert. Si le menu de gauche est ouvert ou en cours d'ouverture, il est compris entre 0 et 1 ; si le menu de droite est ouvert ou en cours d'ouverture, il est compris entre 0 et -1.

isOpen()

Valeur de retour :Boolean, détermine si le menu de gauche ou de droite est déjà ouvert.

isOpenLeft()

Valeur de retour :Boolean, indique si le menu de gauche est déjà ouvert.

isOpenRight()

Valeur de retour :Boolean, indique si le menu de droite est déjà ouvert.

canDragContent([canDrag])
Parameters Type Détails
canDrag
(Facultatif)
Boolean value

Définit si le contenu peut être glissé pour ouvrir le menu latéral.

Valeur de retour :Boolean, indique si le contenu peut être glissé pour ouvrir le menu latéral.

$getByHandle(handle)
Parameters Type Détails
handle String

Par exemple :

$ionicSideMenuDelegate.$getByHandle('my-handle').toggleLeft();
Autres extensions