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