Боковое меню Ionic

Элемент-контейнер содержит боковое меню и основное содержимое. Перетаскивая область основного содержимого с одной стороны в другую, вы переключаете левое или правое боковое меню.

Эффект показан ниже:

Использование

Чтобы использовать боковое меню, добавьте родительский элемент `<ion-side-menus>`, промежуточное содержимое `<ion-side-menu-content>` и одну или несколько директив `<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

Атрибуты Type Подробности
enable-menu-with-back-views
(Необязательно)
Boolean value

Включать ли боковое меню, когда отображается кнопка возврата.

delegate-handle String Этот дескриптор используется для идентификации прокручиваемого представления с помощью $ionicScrollDelegate.

ion-side-menu-content

Контейнер для видимого основного содержимого, с одной или несколькими директивами `ionSideMenu` в качестве соседних элементов.

Использование

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

API

Атрибуты Type Подробности
drag-content
(Необязательно)
Boolean value

Можно ли перетаскивать содержимое. По умолчанию — true.


ion-side-menu

Контейнер для бокового меню, с директивой `ion-side-menu-content` в качестве соседнего элемента.

Использование

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

API

Атрибуты Type Подробности
side String

На какой стороне сейчас находится боковое меню. Возможные значения: `'left'` или `'right'`.

is-enabled
(Необязательно)
Boolean value

Включено ли боковое меню.

width
(Необязательно)
Numeric value

Насколько широким в пикселях должно быть боковое меню. По умолчанию — 275.


menu-toggle

Переключает меню в указанном боковом меню.

Использование

Ниже приведён пример ссылки в панели навигации. Нажатие на эту ссылку автоматически откроет указанное боковое меню.

<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

Закрывает текущее открытое боковое меню.

Использование

Ниже приведён пример ссылки в панели навигации. Нажатие на эту ссылку автоматически откроет указанное боковое меню.

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

$ionicSideMenuDelegate

Этот метод напрямую вызывает сервис $ionicSideMenuDelegate для управления всеми боковыми меню. Используйте метод $getByHandle для управления ionSideMenus в конкретных случаях.

Использование

<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();
  };
}

Методы

toggleLeft([isOpen])

Переключает левое боковое меню (если оно существует).

Parameters Type Подробности
isOpen
(Необязательно)
Boolean value

Открыть или закрыть меню. По умолчанию: переключить меню.

toggleRight([isOpen])

Переключает правое боковое меню (если оно существует).

Parameters Type Подробности
isOpen
(Необязательно)
Boolean value

Открыть или закрыть меню. По умолчанию: переключить меню.

getOpenRatio()

Получить долю открытого содержимого меню, превышающую ширину меню. Например, меню шириной 100px, открытое на 50% (50px), вернёт значение отношения 0.5.

Возвращаемое значение:Float. 0 означает, что меню не открыто. Если левое меню открыто или открывается, значение от 0 до 1; если правое меню открыто или открывается, значение от 0 до -1.

isOpen()

Возвращаемое значение:Boolean, определяет, открыто ли уже левое или правое меню.

isOpenLeft()

Возвращаемое значение:Boolean, открыто ли уже левое меню.

isOpenRight()

Возвращаемое значение:Boolean, открыто ли уже правое меню.

canDragContent([canDrag])
Parameters Type Подробности
canDrag
(Необязательно)
Boolean value

Задаёт, можно ли перетаскивать содержимое для открытия бокового меню.

Возвращаемое значение:Boolean, можно ли перетаскивать содержимое для открытия бокового меню.

$getByHandle(handle)
Parameters Type Подробности
handle String

Например:

$ionicSideMenuDelegate.$getByHandle('my-handle').toggleLeft();
Другие расширения