ionic 侧栏菜单

一个容器元素包含侧边菜单和主要内容。通过把主要内容区域从一边拖动到另一边，来让左侧或右侧的侧栏菜单进行切换。

效果图如下所示：

用法

要使用侧栏菜单，添加一个父元素，一个中间内容 ，和一个或更多 指令。

function ContentController($scope, $ionicSideMenuDelegate) { $scope.toggleLeft = function() { $ionicSideMenuDelegate.toggleLeft(); }; }

API

属性	类型	详情
enable-menu-with-back-views (可选)	布尔值	在返回按钮显示时，确认是否启用侧边栏菜单。
delegate-handle	字符串	该句柄用于标识带有$ionicScrollDelegate的滚动视图。

---

ion-side-menu-content

一个可见主体内容的容器，同级的一个或多个ionSideMenu 指令。

用法

API

属性	类型	详情
drag-content (可选)	布尔值	内容是否可被拖动。默认为true。

---

ion-side-menu

一个侧栏菜单的容器，同级的一个ion-side-menu-content 指令。

用法

API

属性	类型	详情
side	字符串	侧栏菜单当前在哪一边。可选的值有: 'left' 或 'right'。
is-enabled (可选)	布尔值	该侧栏菜单是否可用。
width (可选)	数值	侧栏菜单应该有多少像素的宽度。默认为275。

---

menu-toggle

在一个指定的侧栏中切换菜单。

用法

下面是一个在导航栏内链接的例子。点击此链接会自动打开指定的侧栏菜单。

    ... 

menu-close

关闭当前打开的侧栏菜单。

用法

下面是一个在导航栏内链接的例子。点击此链接会自动打开指定的侧栏菜单。

首页

---

$ionicSideMenuDelegate

该方法直接触发$ionicSideMenuDelegate服务，来控制所有侧栏菜单。用$getByHandle方法控制特定情况下的ionSideMenus。

用法

   内容!  切换左侧侧栏菜单    左侧菜单!   

function MainCtrl($scope, $ionicSideMenuDelegate) { $scope.toggleLeftSideMenu = function() { $ionicSideMenuDelegate.toggleLeft(); }; }

方法

toggleLeft([isOpen])

切换左侧侧栏菜单（如果存在）。

参数	类型	详情
isOpen (可选)	布尔值	是否打开或关闭菜单。默认：切换菜单。

toggleRight([isOpen])

切换右侧侧栏菜单（如果存在）。

参数	类型	详情
isOpen (可选)	布尔值	是否打开或关闭菜单。默认：切换菜单。

getOpenRatio()

获取打开菜单内容超出菜单宽度的比例。比如，一个宽度为100px的菜单被宽度为50px以50%的比例打开，将会返回一个比例值为0.5。

返回值:浮点 0 表示没被打开，如果左侧菜单处于已打开或正在打开为0 到 1，如果右侧菜单处于已打开或正在打开为0 到-1。

isOpen()

返回值:布尔值，判断左侧或右侧菜单是否已经打开。

isOpenLeft()

返回值:布尔值左侧菜单是否已经打开。

isOpenRight()

返回值:布尔值右侧菜单是否已经打开。

canDragContent([canDrag])

参数	类型	详情
canDrag (可选)	布尔值	设置是否可以拖动内容打开侧栏菜单。

返回值:布尔值，是否可以拖动内容打开侧栏菜单。

$getByHandle(handle)

参数	类型	详情
handle	字符串

例如:

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