ionic サイドメニュー
コンテナ要素にはサイドメニューとメインコンテンツが含まれます。メインコンテンツ領域を一方からもう一方へドラッグすることで、左または右のサイドメニューを切り替えます。
イメージ図は以下の通りです:
使い方
サイドメニューを使用するには、親要素<ion-side-menus>、中間コンテンツ<ion-side-menu-content>、および1つ以上の<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
| 属性 | 型 | 詳細 |
|---|---|---|
|
enable-menu-with-back-views
(オプション)
|
ブール値
|
戻るボタンが表示されているときに、サイドメニューを有効にするかどうかを確認します。 |
| delegate-handle | 文字列 | このハンドルは、$ionicScrollDelegateを持つスクロールビューを識別するために使用されます。 |
ion-side-menu-content
表示されるメインコンテンツのコンテナであり、同じ階層に1つ以上のionSideMenuディレクティブを持ちます。
使い方
<ion-side-menu-content drag-content="true"> </ion-side-menu-content>
API
| 属性 | 型 | 詳細 |
|---|---|---|
|
drag-content
(オプション)
|
ブール値
|
コンテンツをドラッグできるかどうか。デフォルトはtrueです。 |
ion-side-menu
サイドメニューのコンテナであり、同じ階層にion-side-menu-contentディレクティブを持ちます。
使い方
<ion-side-menu side="left" width="myWidthValue + 20" is-enabled="shouldLeftSideMenuBeEnabled()"> </ion-side-menu>
API
| 属性 | 型 | 詳細 |
|---|---|---|
| side |
文字列
|
サイドメニューが現在どちら側にあるか。指定可能な値: 'left' または 'right'。 |
|
is-enabled
(オプション)
|
ブール値
|
このサイドメニューが使用可能かどうか。 |
|
width
(オプション)
|
数値
|
サイドメニューの幅(ピクセル単位)。デフォルトは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])
左側のサイドメニューを切り替えます(存在する場合)。
| パラメータ | 型 | 詳細 |
|---|---|---|
|
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();
その他の拡張