Навигация 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
|
Отображается на родительском элементе |
|
hide-back-button
(Необязательно)
|
boolean
|
По умолчанию, находится ли на родительском |
|
hide-nav-bar
(Необязательно)
|
boolean
|
По умолчанию, скрывать ли родительскую |
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
|
Этот дескриптор используется для того, чтобы |
|
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
|
У родительского элемента |
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])
Приложение откатывается к представлению, если резервное представление существует.
Другие расширения