⚙️

History API — уникальные URL для попапов

XPopup поддерживает History API: каждый попап может иметь уникальный URL. Это позволяет делиться ссылкой на открытое окно и использовать кнопки браузера «Назад»/«Вперёд» для навигации по истории попапов.

Изменение URL при открытии (changeUrl) #

Опция changeUrl: true добавляет хэш в адресную строку при открытии попапа. Формат хэша: #xpopup=type:inline,content:...,skin:....

Попробуйте: откройте попап и посмотрите на адресную строку браузера. Скопируйте URL и откройте в новой вкладке — попап откроется автоматически.

Сравните: первая кнопка меняет URL, вторая — нет.

Сохранение в истории браузера (changeUrlHistory) #

Опция changeUrlHistory: true сохраняет изменения URL в истории браузера. Это позволяет использовать кнопки «Назад»/«Вперёд» для управления попапами.

Попробуйте: откройте несколько попапов последовательно, затем нажимайте «Назад» и «Вперёд» в браузере — попапы будут открываться и закрываться.

Цепочка попапов с историей #

При совместном использовании changeUrlHistory и backBtn работает как кнопка «Назад» в шапке, так и кнопка браузера.

Попробуйте: откройте цепочку из 3 окон. Возвращайтесь как через кнопку «Назад» в шапке, так и через кнопку браузера. История сохраняется для каждого окна.

Прямая ссылка на попап #

Вы можете создать прямую ссылку на попап, просто указав правильный хэш в URL. При загрузке страницы XPopup автоматически откроет попап.

Пример прямой ссылки:

#xpopup=type:inline,content:%23direct-link-content,headerCaption:Прямая ссылка,skin:default

Открыть по прямой ссылке

Все параметры History API #

Обзор всех опций, связанных с History API.

Опция Тип По умолчанию Описание
changeUrl boolean false Менять URL при открытии попапа. Добавляет хэш #xpopup=...
changeUrlHistory boolean false Сохранять изменения URL в истории браузера. Требует changeUrl: true. Включает поддержку кнопок «Назад»/«Вперёд» браузера.
Важно: при использовании changeUrlHistory: true URL каждого попапа сохраняется в истории браузера. При большом количестве открытий это может засорить историю.