50 lines
2.1 KiB
C++
50 lines
2.1 KiB
C++
/*
|
|
Crafter®.Graphics
|
|
Copyright (C) 2026 Catcrafts®
|
|
catcrafts.net
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License version 3.0 as published by the Free Software Foundation;
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
// History / SPA routing. Thin C++ wrapper over the browser's
|
|
// `history.pushState` / `popstate` and `window.location.pathname` —
|
|
// exists so a single-page app written against this library can manage
|
|
// its own URL without going through the DOM partition. Re-homed under
|
|
// the `Crafter::Router` namespace (cleaner than CppDOM's bare free
|
|
// functions; symmetric with `Crafter::Gamepad`).
|
|
|
|
export module Crafter.Graphics:Router;
|
|
#ifdef CRAFTER_GRAPHICS_WINDOW_DOM
|
|
import std;
|
|
|
|
export namespace Crafter::Router {
|
|
|
|
// Push a new history entry. `data` is a JSON string serialized by
|
|
// the caller — the browser stores it on the entry but the popstate
|
|
// listener in V1 receives no payload (matches CppDOM's surface).
|
|
// `url` is browser-relative, e.g. "/blog/post-1".
|
|
void PushState(std::string_view data, std::string_view title, std::string_view url);
|
|
|
|
// Subscribe to the browser's `popstate` event (back/forward button,
|
|
// programmatic history.go). Returns an opaque id usable with
|
|
// `RemovePopStateListener`. Multiple subscribers OK.
|
|
std::int32_t AddPopStateListener(std::function<void()> callback);
|
|
void RemovePopStateListener(std::int32_t id);
|
|
|
|
// Current `window.location.pathname` as a freshly-allocated string.
|
|
// Allocates per call — cache the result in the caller if used in
|
|
// hot paths.
|
|
std::string GetPath();
|
|
}
|
|
#endif // CRAFTER_GRAPHICS_WINDOW_DOM
|