Боковое меню 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();
Другие расширения