Ionic-Navigation


ion-nav-view

Wenn Benutzer durch Ihre App navigieren, ist Ionic in der Lage, den Browserverlauf zu erkennen. Durch die Erkennung des Browserverlaufs können Ansichten beim Wischen nach links oder rechts korrekt übergehen.

Mit dem AngularUI Router-Modul können die Anwendungsoberflächen in verschiedene $states (Zustände) unterteilt werden. Im Kern von Angular steht der Routing-Dienst, mit dem URLs zur Steuerung von Ansichten verwendet werden können.

AngularUI Router bietet eine leistungsfähigere Zustandsverwaltung, d. h. Zustände können benannt, verschachtelt und Ansichten kombiniert werden, sodass mehr als ein Template auf derselben Seite gerendert werden kann.

Außerdem muss nicht jeder Zustand an eine URL gebunden sein, und Daten können flexibler an jeden Zustand übergeben werden.

Im folgenden Beispiel erstellen wir eine Anwendung, die Navigationsansichten mit verschiedenen Zuständen enthält.

In unserem Markup wählen wir ionNavView als Direktive der obersten Ebene. Um eine Kopfleiste anzuzeigen, verwenden wir die Direktive ionNavBar, die durch die Navigation aktualisiert wird.

Als Nächstes müssen wir den Zustandswert festlegen, den unsere App rendern wird.

var app = angular.module('myApp', ['ionic']);
app.config(function($stateProvider) {
  $stateProvider
  .state('index', {
    url: '/',
    templateUrl: 'home.html'
  })
  .state('music', {
    url: '/music',
    templateUrl: 'music.html'
  });
});

Wenn die App geöffnet wird, fragt $stateProvider die URL ab, um zu prüfen, ob sie mit dem index-Zustand übereinstimmt, und lädt dann index.html in `<ion-nav-view>`.

Das Laden von Seiten wird über URLs konfiguriert. In Angular ist eine der einfachsten Möglichkeiten, ein Template zu erstellen, es direkt in eine HTML-Template-Datei zu legen und mit `<script type="text/ng-template">` einzubinden.

Das ist also auch eine Möglichkeit, Home.html in unsere App einzubinden:

<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>

Ausprobieren »

Das ist ein guter Ansatz, weil das Template schnell geladen und zwischengespeichert wird, sodass es nicht erneut über das Netzwerk geladen werden muss.


Cache

Normalerweise werden Views zwischengespeichert, um die Leistung zu verbessern. Wenn man eine View verlässt, bleiben ihre Elemente im DOM erhalten, und ihr Scope wird aus $watch entfernt.

Wenn wir zu einer View navigieren, die bereits zwischengespeichert wurde, wird die View aktiviert, ihr Scope wird wieder verbunden, und ihre Elemente bleiben im DOM erhalten. Dadurch kann auch die vorherige Scrollposition der View beibehalten werden.

Das Zwischenspeichern kann auf vielfältige Weise aktiviert und deaktiviert werden. Standardmäßig begrenzt Ionic die Anzahl zwischengespeicherter Seiten auf 10, und das ist nicht das Einzige, was angepasst werden kann; Anwendungen können explizit festlegen, ob eine View zwischengespeichert werden soll.

Beachten Sie, dass wir beim Zwischenspeichern dieser Views die Scopes nicht zerstören. Stattdessen wird ihr Scope ebenfalls aus $watch entfernt.

Da die Scopes dieser Views nicht zerstört und neu aufgebaut werden, werden die Controller nicht erneut geladen. Wenn eine App/ein Controller wissen muss, wann eine View betreten oder verlassen wird, können View-Events, die innerhalb des ionView-Scopes emittiert werden, wie $ionicView.enter, nützlich sein.

Caching global deaktivieren

$ionicConfigProvider kann verwendet werden, um die maximale Anzahl erlaubter zwischengespeicherter Views festzulegen, und durch Setzen auf 0 kann das gesamte Caching deaktiviert werden.

$ionicConfigProvider.views.maxCache(0);

Caching im State Provider deaktivieren

$stateProvider.state('myState', {
   cache: false,
   url : '/myUrl',
   templateUrl : 'my-template.html'
})

Caching über Attribute deaktivieren

<ion-view cache-view="false" view-title="My Title!">
  ...
</ion-view>

AngularUI Router

Bitte besuchen SieAngularUI Routers Dokumentation, um mehr zu erfahren.

API

Attribute Type Details
name
(Optional)
string

Ein Name der View. Dieser Name sollte unter anderen Views im selben State eindeutig sein. Sie können Views mit demselben Namen in verschiedenen States haben. Für weitere Details siehe dieui-view-Dokumentation des ui-routers。


ion-view

Gehört zu ionNavView. Ein Inhaltscontainer zum Anzeigen von Views oder Navigationsleisteninformationen.

Unten sehen Sie ein Beispiel für eine Seite, die mit einer Navigationsleiste mit dem Titel "Meine Seite" geladen wurde.

<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

Attribute Type Details
title
(Optional)
string

Wird auf dem übergeordneten Element angezeigtionNavBarTitel.

hide-back-button
(Optional)
boolean

Standardmäßig, ob auf dem übergeordneten ElementionNavBardie Zurück-Schaltfläche ausblenden.

hide-nav-bar
(Optional)
boolean

Standardmäßig, ob das übergeordnete Element ausgeblendet werden sollionNavBar。


ion-nav-bar

Erstellt eine obere Symbolleiste, die aktualisiert wird, wenn sich der App-Status ändert.

Nutzung

<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

Attribute Type Details
delegate-handle
(Optional)
string

Dieser Handle wird verwendet, um$ionicNavBarDelegatediese Navigationsleiste zu identifizieren.

align-title
(Optional)
string

Die Ausrichtungsposition des Titels der Navigationsleiste. Optionen: 'left', 'right', 'center'. Standard ist 'center'.


ion-nav-buttons

Gehört zu ionNavView

Verwenden Sie ionNavButtons, um Buttons auf der ionNavBar innerhalb einer ionView zu setzen.

Alle Buttons, die Sie setzen, werden an den entsprechenden Positionen in der Navigationsleiste platziert und werden zerstört, wenn der Benutzer die übergeordnete Ansicht verlässt.

Nutzung

<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

Attribute Type Details
side string

Am übergeordneten ElementionNavBardie Position, an der Buttons platziert werden. Optionen: 'left' oder 'right'.


ion-nav-back-button

Erstellt einen Button innerhalb eines ionNavBar.

Der Zurück-Button wird angezeigt, wenn der Benutzer in der aktuellen Navigation zurückgehen kann.

Nutzung

Standardverhalten des Buttons:

<ion-nav-bar>
  <ion-nav-back-button class="button-clear">
    <i class="ion-arrow-left-c"></i> 后退
  </ion-nav-back-button>
</ion-nav-bar>

Benutzerdefinierte Klickaktion unter Verwendung von $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();
  };
}

Verwenden Sie außerdem $ionicNavBarDelegate, um den vorherigen Titel auf dem Zurück-Button anzuzeigen.

<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 ist eine Attributdirektive, die beim Klicken auf Elemente in einer Ansicht verwendet wird, wie z. B. ein `<a href>` oder ein `<button ui-sref>`.

Beim Anklicken bewirkt nav-clear, dass das angegebene Element den nächsten Ansichtsübergang deaktiviert. Diese Direktive ist beispielsweise für Links in einem Sidebar-Menü nützlich.

Nutzung

Unten sehen Sie einen Link in einem Sidebar-Menü, dem die Direktive nav-clear hinzugefügt wurde. Wenn Sie auf diesen Link klicken, werden alle Animationen zwischen Ansichten deaktiviert.

<a nav-clear menu-close href="../index.html" class="item">首页</a>

ion-nav-title

ion-nav-title wird verwendet, um den Titel in der ion-view-Vorlage festzulegen.

Nutzung

<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

Legt den verwendeten Übergangstyp fest; möglich sind: ios, android und none.

Nutzung

<a nav-transition="none" href="../index.html">Home</a>

nav-direction

Legt die Richtung der Übergangsanimation in der Navigationsansicht fest; möglich sind forward, back, enter, exit, swap.

Nutzung

<a nav-direction="forward" href="../index.html">Home</a>

$ionicNavBarDelegate

Delegat zur Steuerung der ion-nav-bar-Direktive.

Nutzung

<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);
  }
}

Methoden

align([direction])

Im Browserverlauf zurückgehen.

Parameters Type Details
event
(Optional)
DOMEvent

Ereignisobjekt (z. B. von einem Klickereignis)

align([direction])

Richtet den Titel mit den Schaltflächen an der angegebenen Richtung aus.

Parameters Type Details
direction
(Optional)
string

Die Richtung zum Ausrichten des Titeltexts. Optionen: 'left', 'right', 'center'. Standard: 'center'.

Rückgabewert:Boolean, ob die Zurück-Schaltfläche angezeigt wird.

showBar(show)

Legt fest oder ruft ab, ob die ion-nav-bar angezeigt wird.

Parameters Type Details
show boolean

Ob die Navigationsleiste angezeigt wird.

Rückgabewert:Boolean, ob die Navigationsleiste angezeigt wird.

showBackButton([show])

Legt fest oder ruft ab, ob ion-nav-back-button angezeigt wird.

Parameters Type Details
show
(Optional)
boolean

Ob die Zurück-Schaltfläche angezeigt werden soll

title(title)

Legt den Titel für ion-nav-bar fest.

Parameters Type Details
title string

Der neue Titel, der angezeigt werden soll.


$ionicHistory

$ionicHistory wird verwendet, um den Browserverlauf des Benutzers innerhalb der App zu verfolgen.

Methoden

viewHistory()

Dient zum Anzeigen der Verlaufseinträge.

currentView()

Die aktuelle Ansicht der App.

currentHistoryId()
Die ID des Verlaufsstapels, der der übergeordnete Container der aktuellen Ansicht ist.
currentTitle([val])

Ruft den Titel der aktuellen Ansicht ab oder legt ihn fest.

backView()

Gibt die zuletzt angezeigte Ansicht zurück.

backTitle()

Ruft den Titel der zuletzt angezeigten Ansicht ab.

forwardView()

Zur vorherigen Ansicht der aktuellen Ansicht im Verlaufsstapel zurückkehren.

currentStateName()

Gibt den Namen des aktuellen Zustands zurück.

goBack([backCount])

Die App greift auf die Ansicht zurück, wenn die Fallback-Ansicht existiert.

Weitere Erweiterungen