Жизненный цикл страниц в мобильном приложении
Glossary Item Box
Общие сведения
Во время навигации по мобильному приложению для каждой страницы выполняется ряд этапов — открытие, закрытие, выгрузка, возврат к странице и т. п. Время, прошедшее от загрузки страницы в память мобильного устройства и до ее окончательной выгрузки из памяти, принято называть жизненным циклом страницы.
Для каждого этапа жизненного цикла предусмотрены события страницы. Использование событий дает возможность расширять функциональность. К основным событиям относятся:
- инициализация представления;
- завершение инициализации класса;
- загрузка страницы;
- загрузка данных;
- закрытие страницы.
Понимание этапов выполнения жизненного цикла страницы позволяет качественно и максимально эффективно расширять логику страниц.
Этапы жизненного цикла
ВАЖНО
На экране телефона может отображаться только одна страница. На экране планшета — одна страница в портретной ориентации и две в ландшафтной. В связи с этим жизненный цикл страниц имеет отличия для телефона и планшета.
Открытие страницы
При первом открытии страницы выполняется загрузка скриптов, требуемых для ее работы. Далее инициализируется контроллер и создается представление.
События открытия страницы генерируются в следующей последовательности:
1. initializeView — инициализация представления.
2. pageLoadComplete — событие завершения загрузки страницы.
3. launch — инициирует загрузку данных.
Закрытие страницы
Во время закрытия страницы ее представление удаляется из объектной модели документа (Document object model, DOM), а контроллер удаляется из памяти устройства.
Закрытие страницы происходит в следующих случаях:
- Нажата кнопка [Назад]. В таком случае удаляется последняя страница.
- Выполнен переход в другой раздел. В таком случае удаляются все страницы, которые были открыты ранее.
Событие завершения закрытия страницы — pageUnloadComplete.
Выгрузка страницы
Выгрузка страницы происходит в случае, когда выполняется переход к другой странице в том же разделе. При этом текущая страница становится неактивной. Она может оставаться видимой на экране устройства. Например, если на планшете открыть страницу просмотра из реестра, то страница реестра останется видимой. В такой же ситуации на телефоне страница реестра не будет отображаться, но будет оставаться в памяти. Это и отличает выгрузку от закрытия страницы.
Событие выгрузки страницы — pageUnloadComplete (совпадает с событием закрытия страницы).
Возврат к странице
Возврат к выгруженной ранее странице происходит при нажатии на кнопку [Назад].
Событие возврата к странице — pageLoadComplete.
ВАЖНО
В приложении может использоваться только один экземпляр страницы. Поэтому, если последовательно открыть две одинаковые страницы, то при возврате к первой из них повторно выполняется обработчик события launch. Это следует учитывать при разработке.
Обработчики событий жизненного цикла
Классы контроллеров страниц наследуются от класса Terrasoft.controller.BaseConfigurationPage, который предоставляет методы обработки событий жизненного цикла.
initializeView(view)
Вызывается после того как было создано (но еще не было отрисовано) представление страницы в DOM. На этом этапе можно подписываться на события классов представления, выполнять дополнительные манипуляции с DOM.
pageLoadComplete(isLaunch)
Предоставляет возможность расширения логики, которая выполняется как при загрузке страницы, так и при возврате. Значение параметра isLaunch равное true указывает на то, что страница загружается первый раз.
launch()
Вызывается только при открытии страницы. Метод инициирует начало загрузки данных. Если требуется загрузка дополнительных данных, то правильно будет делать это в методе launch().
pageUnloadComplete()
Предоставляет возможность расширения логики, которая выполняется как при закрытии страницы, так и при ее выгрузке.
Навигация страниц
Управлением жизненным циклом страниц занимается класс Terrasoft.PageNavigator. Класс предоставляет возможности открытия и закрытия страниц, обновления неактуальных данных, а также хранения истории открытых страниц.
forward(openingPageConfig)
Метод открывает страницу с учетом свойств конфигурационного объекта-параметра openingPageConfig. Основные свойства этого объекта представлены в таблице 1.
Табл. 1. — Свойства объекта openingPageConfig
| Свойство | Описание |
|---|---|
| controllerName | Имя класса контроллера. |
| viewXType | Тип представления по xtype. |
| type | Тип страницы из перечисления Terrasoft.core.enums.PageType. |
| modelName | Имя модели страницы. |
| pageSchemaName | Название схемы страницы в конфигурации. |
| isStartPage | Признак, указывающий на то, что страница должна быть первой. Если до этого уже были открыты страницы, то они будут закрыты. |
| isStartRecord | Признак, указывающий на то, что страница карточки просмотра/редактирования должна быть первой после реестра. Если есть другие открытые страницы после реестра, они закрываются. |
| recordId | Идентификатор записи открываемой страницы. |
| detailConfig | Настройки стандартной детали. |
backward()
Метод закрывает страницу.
markPreviousPagesAsDirty(operationConfig)
Метод отмечает все предыдущие страницы как неактуальные. После возврата к предыдущим страницам для каждой из них вызовется метод refreshDirtyData(), который выполняет повторную загрузку данных или актуализирует данные на основании объекта operationConfig.
refreshPreviousPages(operationConfig, currentPageHistoryItem)
Метод выполняет для всех предыдущих страниц повторную загрузку данных или актуализирует данные на основании operationConfig. Если установлено значение для параметра currentPageHistoryItem, метод выполняет те же действия для предшествующих страниц.
refreshAllPages(operationConfig, excludedPageHistoryItems)
Метод выполняет для всех страниц повторную загрузку данных или актуализирует данные на основании operationConfig. Если установлен параметр excludedPageHistoryItems, метод исключает из актуализации указанные страницы.
Навигация с использованием маршрутов
Маршрутизация
Маршрутизация используется для управления визуальными компонентами: страницами, пикерами и др. Маршрут имеет три состояния:
1. Load — выполняет открытие текущего маршрута.
2. Unload — выполняет закрытие текущего маршрута при возврате.
3. Reload — выполнят восстановление предыдущего маршрута при возврате.
Для маршрутизации используется класс Terrasoft.Router и его основные методы add(), route(), back().
add(name, config)
Добавляет маршрут. Параметры:
- name — уникальное имя маршрута. В случае повторного добавления, последний переопределит предыдущий.
- config — описывает имена функций обработчиков состояний маршрута. В свойстве handlers устанавливаются обработчики состояний маршрута.
Пример использования:
Terrasoft.Router.add("record", { handlers: { load: "loadPage", reload: "reloadPage", unload: "unloadLastPage" } });
route(name, scope, args, config)
Выполняет открытие маршрута. Параметры:
- name — имя маршрута.
- scope — контекст функции обработчиков состояний.
- args — параметры функций обработчиков состояний.
- config — дополнительные параметры маршрута.
Пример использования:
var mainPageController = Terrasoft.util.getMainController(); Terrasoft.Router.route("record", mainPageController, [{pageSchemaName: "MobileActivityGridPage"}]);
back()
Выполняет закрытие текущего маршрута и восстановление предыдущего.
