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
詳細
文字列

(オプション)ionNavBar親に表示される

hide-back-button
タイトル。
ブール値

デフォルトでは、親でionNavBar戻るボタンを非表示にするかどうか。

hide-nav-bar
(オプション)
ブール値

デフォルトでは、親を非表示にするかどうかionNavBar。


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
(オプション)
文字列

このハンドルは$ionicNavBarDelegateこのナビゲーションバーを識別します。

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 文字列

親内のionNavBarボタンを配置する位置。指定可能: 'left' または 'right'。


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 は、戻るビューが存在する場合にビューを戻します。

その他の拡張機能