ionic ナビゲーション
ion-nav-view
ユーザーがアプリ内を閲覧するとき、ionic は閲覧履歴を検出できます。閲覧履歴を検出することで、左または右へのスワイプ時にビューを正しく遷移できます。
AngularUI ルーターモジュールなどのアプリケーションインターフェースを使用すると、異なる $state(状態)に分割できます。Angular の核心はルーティングサービスであり、URL を使用してビューを制御できます。
AngularUI ルーターはより強力な状態管理を提供します。つまり、状態は命名、ネスト、およびビューのマージが可能で、複数のテンプレートを同じページに表示できます。
さらに、各状態は URL にバインドする必要がなく、データをより柔軟に各状態へプッシュできます。
以下の例では、異なる状態を含むナビゲーションビューを持つアプリケーションを作成します。
マークアップでは ionNavView をトップレベルディレクティブとして選択します。ヘッダーバーを表示するには、ionNavBar ディレクティブを使用してナビゲーションで更新します。
次に、レンダリングする状態値を設定する必要があります。
var app = angular.module('myApp', ['ionic']);
app.config(function($stateProvider) {
$stateProvider
.state('index', {
url: '/',
templateUrl: 'home.html'
})
.state('music', {
url: '/music',
templateUrl: 'music.html'
});
});
アプリを再度開くと、$stateProvider は URL を照会し、index 状態値と一致するかどうかを確認し、index.html を <ion-nav-view> に読み込みます。
ページの読み込みはすべて URL で設定されます。Angular でテンプレートを作成する最も簡単な方法は、それを html テンプレートファイルに直接配置し、<script type="text/ng-template"> で含めることです。したがって、これは Home.html をアプリに含める方法の一つでもあります:
<script id="home" type="text/ng-template">
<!-- ion-view 标题将显示在 navbar 中 -->
<ion-view view-title="Home">
<ion-content ng-controller="HomeCtrl">
<!-- The content of the page -->
<a href="../index.html">Go to music page!</a>
</ion-content>
</ion-view>
</script>
これは良い方法です。テンプレートはすぐに読み込まれてキャッシュされるため、ネットワーク経由で再度読み込む必要がありません。
キャッシュ
通常、ビューはキャッシュされてパフォーマンスが向上します。ビューから離れると、その要素は DOM に保持され、そのスコープは $watch からも削除されます。キャッシュされたビューに移動すると、ビューはアクティブ化され、そのスコープが再接続され、DOM にもその要素が保存されます。これにより、以前のビューのスクロール位置を維持することもできます。
キャッシュは多くの方法で有効/無効にできます。デフォルトでは、Ionic は最大キャッシュページ数を 10 に設定しています。これはカスタマイズ可能な唯一の点ではなく、アプリケーションは明示的な状態でビューをキャッシュすべきかどうかを設定できます。
注意:ビューをキャッシュしているため、スコープは破棄されません。代わりに、そのスコープは $watch から削除されます。
後続のビューのスコープは破棄および再構築されず、コントローラーも再度読み込まれないためです。アプリ/コントローラーがビューに入る/離れるタイミングを知る必要がある場合、ionView スコープ内から発行されるビューイベント(例:$ionicView.enter)が役立つことがあります。
グローバルにキャッシュを無効化
$ionicConfigProvider を使用して、キャッシュを許可する最大ビュー数を設定できます。0 に設定するとすべてのキャッシュを無効にできます。
$ionicConfigProvider.views.maxCache(0);
ステートプロバイダーでキャッシュを無効化
$stateProvider.state('myState', {
cache: false,
url : '/myUrl',
templateUrl : 'my-template.html'
})
属性によるキャッシュの無効化
<ion-view cache-view="false" view-title="My Title!"> ... </ion-view>
AngularUI ルーター
アクセスしてくださいAngularUI Router's docs詳細をご覧ください。
API
| 属性 | タイプ | 詳細 |
|---|---|---|
|
name
(オプション)
|
文字列
|
ビューの名前。この名前は、同じ状態内の他のビュー間で一意である必要があります。異なる状態では同じ名前のビューを持つことができます。詳細は、ui-router のui-view ドキュメント。 |
ion-view
ionNavView に属します。
ビューまたはナビゲーションバー情報を表示するためのコンテンツコンテナです。
<ion-nav-bar></ion-nav-bar>
<ion-nav-view class="slide-left-right">
<ion-view title="我的页面">
<ion-content>
你好!
</ion-content>
</ion-view>
</ion-nav-view>
API
| 以下は「マイページ」というタイトルのナビゲーションバーをページに読み込む例です。 | 属性 | タイプ |
|---|---|---|
|
title
詳細
|
文字列
|
(オプション) |
|
hide-back-button
タイトル。
|
ブール値
|
デフォルトでは、親で |
|
hide-nav-bar
(オプション)
|
ブール値
|
デフォルトでは、親を非表示にするかどうか |
ion-nav-bar
プログラムの状態が変わったときに更新されるトップツールバーを作成します。
使い方
<body ng-app="starter"> <!-- 当我们浏览时,导航栏会随之更新。 --> <ion-nav-bar class="bar-positive nav-title-slide-ios7"> </ion-nav-bar> <!-- 初始化时渲染视图模板 --> <ion-nav-view></ion-nav-view> </body>
API
| 属性 | タイプ | 詳細 |
|---|---|---|
|
delegate-handle
(オプション)
|
文字列
|
このハンドルは |
|
align-title
(オプション)
|
文字列
|
ナビゲーションバーのタイトルの配置位置。指定可能: 'left', 'right', 'center'。 デフォルトは 'center'。 |
ion-nav-buttons
ionNavView に属します
ionView 内の ionNavBar 上で ionNavButtons を使用してボタンを設定します。
設定したボタンはすべてナビゲーションバーの対応する位置に配置され、ユーザーが親ビューから離れると破棄されます。
使い方
<ion-nav-bar>
</ion-nav-bar>
<ion-nav-view>
<ion-view>
<ion-nav-buttons side="left">
<button class="button" ng-click="doSomething()">
我是一个在导航栏左侧的按钮!
</button>
</ion-nav-buttons>
<ion-content>
这里是一些内容!
</ion-content>
</ion-view>
</ion-nav-view>
API
| 属性 | タイプ | 詳細 |
|---|---|---|
| side |
文字列
|
親内の |
ion-nav-back-button
ionNavBar 内にボタンを作成します。
ユーザーが現在のナビゲーションで戻れる場合、戻るボタンが表示されます。
使い方
デフォルトのボタンアクション:
<ion-nav-bar>
<ion-nav-back-button class="button-clear">
<i class="ion-arrow-left-c"></i> 后退
</ion-nav-back-button>
</ion-nav-bar>
$ionicNavBarDelegate を使用したカスタムクリックアクション:
<ion-nav-bar ng-controller="MyCtrl">
<ion-nav-back-button class="button-clear"
ng-click="canGoBack && goBack()">
<i class="ion-arrow-left-c"></i> 后退
</ion-nav-back-button>
</ion-nav-bar>
function MyCtrl($scope, $ionicNavBarDelegate) {
$scope.goBack = function() {
$ionicNavBarDelegate.back();
};
}
戻るボタンに前のタイトルを表示するには、$ionicNavBarDelegate も使用します。
<ion-nav-bar ng-controller="MyCtrl">
<ion-nav-back-button class="button-icon">
<i class="icon ion-arrow-left-c"></i>{{getPreviousTitle() || 'Back'}}
</ion-nav-back-button>
</ion-nav-bar>
function MyCtrl($scope, $ionicNavBarDelegate) {
$scope.getPreviousTitle = function() {
return $ionicNavBarDelegate.getPreviousTitle();
};
}
nav-clear
nav-clear は、ビュー上の要素(例: <a href> や <button ui-sref>)をクリックしたときに使用される属性ディレクティブです。
クリックすると、nav-clear は指定された要素に対して、次のビューへの遷移を無効にします。このディレクティブは、例えばサイドバーメニュー内のリンクなどで役立ちます。
使い方
以下は、サイドバーメニュー内に nav-clear ディレクティブを追加したリンクの例です。このリンクをクリックすると、ビュー間のアニメーションがすべて無効になります。
<a nav-clear menu-close href="../index.html" class="item">首页</a>
ion-nav-title
ion-nav-title は ion-view テンプレート内のタイトルを設定するために使用します。
使い方
<ion-nav-bar>
</ion-nav-bar>
<ion-nav-view>
<ion-view>
<ion-nav-title>
<img src="logo.svg.html">
</ion-nav-title>
<ion-content>
Some super content here!
</ion-content>
</ion-view>
</ion-nav-view>
nav-transition
使用するトランジションタイプを設定します。指定可能: ios, android, none。
使い方
<a nav-transition="none" href="../index.html">Home</a>
nav-direction
ナビゲーションビュー内のトランジションアニメーションの方向を設定します。指定可能: forward, back, enter, exit, swap。
使い方
<a nav-direction="forward" href="../index.html">Home</a>
$ionicNavBarDelegate
ion-nav-bar ディレクティブの制御を委任します。
使い方
<body ng-controller="MyCtrl">
<ion-nav-bar>
<button ng-click="setNavTitle('banana')">
Set title to banana!
</button>
</ion-nav-bar>
</body>
function MyCtrl($scope, $ionicNavBarDelegate) {
$scope.setNavTitle = function(title) {
$ionicNavBarDelegate.title(title);
}
}
メソッド
align([direction])
閲覧履歴を遡ります。
| パラメータ | タイプ | 詳細 |
|---|---|---|
|
event
(オプション)
|
DOMEvent
|
イベントオブジェクト(クリックイベントなど) |
align([direction])
ボタンのタイトルを指定した方向に整列します。
| パラメータ | タイプ | 詳細 |
|---|---|---|
|
direction
(オプション)
|
文字列
|
タイトルテキストを整列する方向。指定可能: 'left', 'right', 'center'。 デフォルト: 'center'。 |
戻り値:戻るボタンを表示するかどうかを示すブール値。
showBar(show)
ion-nav-bar を表示するかどうかを設定または取得します。
| パラメータ | タイプ | 詳細 |
|---|---|---|
| show |
ブール値
|
ナビゲーションバーを表示するかどうか。 |
戻り値:ナビゲーションバーを表示するかどうかを示すブール値。
showBackButton([show])
ion-nav-back-button を表示するかどうかを設定または取得します。
| パラメータ | タイプ | 詳細 |
|---|---|---|
|
show
(オプション)
|
ブール値
|
戻るボタンを表示するかどうか |
title(title)
ion-nav-bar のタイトルを設定します。
| パラメータ | タイプ | 詳細 |
|---|---|---|
| title |
文字列
|
新しいタイトルを表示します。 |
$ionicHistory
$ionicHistory は、アプリ内でのユーザーの閲覧履歴を追跡するために使用します。
メソッド
viewHistory()
履歴を表示するために使用します。
currentView()
アプリの現在のビュー。
currentHistoryId()履歴スタックの ID。現在のビューの親コンテナです。
currentTitle([val])
現在のビューのタイトルを取得または設定します。
backView()
最後に閲覧したビューを返します。
backTitle()
最後に閲覧したビューのタイトルを取得します。
forwardView()
履歴スタック内の現在のビューの前のビューに戻る。
currentStateName()
現在の状態名を返す。
goBack([backCount])
app は、戻るビューが存在する場合にビューを戻します。
その他の拡張機能