Menú lateral de ionic

Un elemento contenedor contiene el menú lateral y el contenido principal. Al arrastrar el área de contenido principal de un lado al otro, se alterna el menú lateral izquierdo o derecho.

La imagen del efecto se muestra a continuación:

Uso

Para usar el menú lateral, agregue un elemento padre `<ion-side-menus>`, un contenido intermedio `<ion-side-menu-content>` y una o más directivas `<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

Atributos Tipo Detalles
enable-menu-with-back-views
(Opcional)
Valor booleano

Confirma si se habilita el menú lateral cuando se muestra el botón de retroceso.

delegate-handle Cadena Este identificador (handle) se utiliza para identificar la vista de desplazamiento con `$ionicScrollDelegate`.

ion-side-menu-content

Un contenedor para el contenido principal visible, con una o más directivas `ionSideMenu` al mismo nivel.

Uso

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

API

Atributos Tipo Detalles
drag-content
(Opcional)
Valor booleano

Si el contenido se puede arrastrar. Por defecto es true.


ion-side-menu

Un contenedor para un menú lateral, con una directiva `ion-side-menu-content` al mismo nivel.

Uso

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

API

Atributos Tipo Detalles
side Cadena

En qué lado se encuentra actualmente el menú lateral. Los valores posibles son: 'left' o 'right'.

is-enabled
(Opcional)
Valor booleano

Si este menú lateral está disponible.

width
(Opcional)
Valor numérico

Cuántos píxeles de ancho debe tener el menú lateral. Por defecto es 275.


menu-toggle

Alterna el menú en un panel lateral especificado.

Uso

A continuación se muestra un ejemplo de un enlace dentro de la barra de navegación. Al hacer clic en este enlace se abrirá automáticamente el menú lateral especificado.

<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

Cierra el menú lateral actualmente abierto.

Uso

A continuación se muestra un ejemplo de un enlace dentro de la barra de navegación. Al hacer clic en este enlace se abrirá automáticamente el menú lateral especificado.

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

$ionicSideMenuDelegate

Este método activa directamente el servicio `$ionicSideMenuDelegate` para controlar todos los menús laterales. Use el método `$getByHandle` para controlar los `ionSideMenus` en casos específicos.

Uso

<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étodos

toggleLeft([isOpen])

Alterna el menú lateral izquierdo (si existe).

Parámetros Tipo Detalles
isOpen
(Opcional)
Valor booleano

Si abrir o cerrar el menú. Por defecto: alternar el menú.

toggleRight([isOpen])

Alterna el menú lateral derecho (si existe).

Parámetros Tipo Detalles
isOpen
(Opcional)
Valor booleano

Si abrir o cerrar el menú. Por defecto: alternar el menú.

getOpenRatio()

Obtiene la proporción en que el contenido del menú abierto supera el ancho del menú. Por ejemplo, un menú de 100px de ancho abierto al 50% (50px) devolverá un valor de proporción de 0.5.

Valor de retorno:Flotante 0 indica que no está abierto; de 0 a 1 si el menú izquierdo está abierto o abriéndose; de 0 a -1 si el menú derecho está abierto o abriéndose.

isOpen()

Valor de retorno:Booleano que indica si el menú izquierdo o derecho ya está abierto.

isOpenLeft()

Valor de retorno:Booleano que indica si el menú izquierdo ya está abierto.

isOpenRight()

Valor de retorno:Booleano que indica si el menú derecho ya está abierto.

canDragContent([canDrag])
Parámetros Tipo Detalles
canDrag
(Opcional)
Valor booleano

Establece si se puede arrastrar el contenido para abrir el menú lateral.

Valor de retorno:Booleano que indica si se puede arrastrar el contenido para abrir el menú lateral.

$getByHandle(handle)
Parámetros Tipo Detalles
handle Cadena

Por ejemplo:

$ionicSideMenuDelegate.$getByHandle('my-handle').toggleLeft();
Otras extensiones