pagebeforechange

При получении со значением data.toPage в виде строки, событие указывает на то, что навигация вот-вот начнется. Значение, хранящееся в data.toPage, — это URL страницы, которая будет загружена.

При получении со значением data.toPage в виде объекта jQuery, событие указывает на то, что целевая страница загружена, и навигация продолжится.

Если цикл изменения страницы был инициирован программно, и вместо URL был передан объект jQuery, содержащий страницу, то событие будет вызываться дважды со значением data.toPage, установленным в объект jQuery, содержащий целевую страницу.

Событие pagebeforechange вызывается либо при явной навигации со стороны пользователя (например, при нажатии на ссылку или при выполнении кода, который приводит к вызову метода pagecontainer change()), либо при неявной навигации, вызванной нажатием пользователем кнопок «Назад» или «Вперёд» браузера.

При явной навигации оба события pagebeforechange вызываются перед добавлением новой записи в историю навигации браузера.

При неявной навигации оба события pagebeforechange вызываются после обновления истории навигации браузера.

В дополнение к параметру event, обработчики этого события получат второй параметр, data. Второй параметр — это объект, содержащий следующие свойства:

• toPage (объект или строка)
  • Это свойство представляет страницу, которую вызывающая сторона хочет активировать. Это может быть либо объект jQuery, содержащий элемент DOM страницы, либо абсолютный/относительный URL для внутренней или внешней страницы. Значение точно соответствует 1-му аргументу вызова changePage(), который вызвал событие.
• options (объект)
  • Этот объект содержит параметры конфигурации, которые будут использоваться для текущего вызова changePage().

Следует отметить, что обратные вызовы могут изменять свойства toPage и options, чтобы изменить поведение текущего вызова changePage(). Например, toPage может быть сопоставлен с другим URL из обратного вызова для выполнения некоторого вида перенаправления.