Навигация Ionic


ion-nav-view

Когда пользователи перемещаются по вашему приложению, Ionic может обнаруживать историю просмотров. Благодаря обнаружению истории просмотров представления могут правильно переключаться при свайпе влево или вправо.

Используя модуль AngularUI Router, интерфейсы приложения можно разделить на различные $states (состояния). В основе Angular лежит служба маршрутизации, с помощью которой URL-адреса могут использоваться для управления представлениями.

AngularUI Router предоставляет более мощное управление состояниями: состояния можно именовать, вкладывать, а представления объединять, что позволяет отображать на одной странице более одного шаблона.

Кроме того, каждое состояние не обязательно привязывать к 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 Router

Пожалуйста, посетитедокументацию AngularUI Router, чтобы узнать больше.

API

Атрибуты Type Подробности
name
(Необязательно)
string

Имя представления. Это имя должно быть уникальным среди других представлений в одном и том же состоянии. Вы можете иметь представления с одинаковым именем в разных состояниях. Для получения дополнительных сведений см. документацию поui-view в ui-router。


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

Атрибуты Type Подробности
title
(Необязательно)
string

Отображается на родительском элементеionNavBarзаголовок.

hide-back-button
(Необязательно)
boolean

По умолчанию, находится ли на родительскомionNavBarскрыть кнопку «Назад».

hide-nav-bar
(Необязательно)
boolean

По умолчанию, скрывать ли родительскую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

Атрибуты Type Подробности
delegate-handle
(Необязательно)
string

Этот дескриптор используется для того, чтобы$ionicNavBarDelegateидентифицировать эту панель навигации.

align-title
(Необязательно)
string

Позиция выравнивания заголовка панели навигации. Варианты: 'left', 'right', 'center'. По умолчанию: 'center'.


ion-nav-buttons

Принадлежит ionNavView

Используйте ionNavButtons, чтобы установить кнопки на ionNavBar внутри ionView.

Любые кнопки, которые вы установите, будут размещены в соответствующих позициях на панели навигации и будут уничтожены, когда пользователь покинет родительское представление.

Использование

<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

Атрибуты Type Подробности
side string

У родительского элемента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])

Вернуться назад в истории навигации.

Parameters Type Подробности
event
(Необязательно)
DOMEvent

Объект события (например, из события click)

align([direction])

Выравнивает заголовок с кнопками по указанному направлению.

Parameters Type Подробности
Направление
(Необязательно)
string

Направление выравнивания текста заголовка. Варианты: 'left', 'right', 'center'. По умолчанию: 'center'.

Возвращаемое значение:Boolean, отображается ли кнопка возврата.

showBar(show)

Задаёт или возвращает, отображается ли ion-nav-bar.

Parameters Type Подробности
show boolean

Отображается ли панель навигации.

Возвращаемое значение:Логическое значение, отображается ли панель навигации.

showBackButton([show])

Задать или получить, отображается ли ion-nav-back-button.

Parameters Type Подробности
show
(Необязательно)
boolean

Показывать ли кнопку «Назад»

title(title)

Устанавливает заголовок для ion-nav-bar.

Parameters Type Подробности
title string

Новый отображаемый заголовок.


$ionicHistory

$ionicHistory используется для отслеживания истории просмотров пользователя в приложении.

Методы

viewHistory()

Используется для просмотра записей истории.

currentView()

Текущее представление приложения.

currentHistoryId()
Идентификатор стека истории, который является родительским контейнером текущего представления.
currentTitle([val])

Получить или задать заголовок текущего представления.

backView()

Возвращает последнее просмотренное представление.

backTitle()

Получить заголовок последнего просмотренного представления.

forwardView()

Вернуться к предыдущему представлению относительно текущего представления в стеке истории.

currentStateName()

Возвращает имя текущего состояния.

goBack([backCount])

Приложение откатывается к представлению, если резервное представление существует.

Другие расширения