Catcrafts/Crafter.Graphics
Watch
2
0
Fork
You've already forked Crafter.Graphics
 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions

wasm improvements

Browse source
This commit is contained in:
Jorijn van der Graaf 2026-08-05 04:08:13 +02:00
commit 6aa0338c0f
9 changed files with 603 additions and 70 deletions
Download patch file Download diff file Expand all files Collapse all files

102
interfaces/Crafter.Graphics-Dom.cppm
View file

@ -61,7 +61,12 @@ export namespace Crafter::Dom {
// DOM ops ─────────────────────────────────────────────────────
void SetInnerHTML(const std::string_view html);
void SetStyle(const std::string_view style);
// WARNING: SetProperty sets a *CSS* property (el.style.setProperty).
// It is NOT setAttribute — the name is historical. For href / src /
// disabled / aria-* / data-*, use SetAttribute below.
void SetProperty(const std::string_view property, const std::string_view value);
void AddClass(const std::string_view className);
void RemoveClass(const std::string_view className);
void ToggleClass(const std::string_view className);
@ -69,28 +74,80 @@ export namespace Crafter::Dom {
std::string GetValue();
void SetValue(const std::string_view value);
// Attributes ──────────────────────────────────────────────────
//
// Real setAttribute/getAttribute access. Before these existed the
// only way to change an href or toggle `disabled` was to re-render
// the parent's innerHTML, which destroys every descendant and every
// listener attached to them just to change one string.
void SetAttribute(const std::string_view name, const std::string_view value);
void RemoveAttribute(const std::string_view name);
// nullopt = attribute absent. Distinct from an empty string, which
// means present-with-no-value (`alt=""`, `disabled=""`) — for
// boolean attributes presence alone is the signal.
std::optional<std::string> GetAttribute(const std::string_view name);
bool HasAttribute(const std::string_view name);
// Checkbox / radio state. GetValue cannot express this: `el.value`
// on a checkbox is "on" whether or not it is ticked.
bool GetChecked();
void SetChecked(bool checked);
// Move keyboard focus to / away from this element. AddFocusListener
// could already observe focus, but nothing could set it, which makes
// an accessible "jump to first invalid field" impossible.
void Focus();
void Blur();
// Listener API — each Add* returns an opaque id that can be
// passed to the matching Remove*. The destructor automatically
// removes every handler still registered, so manual removal is
// optional. Returns 0 only if registration failed at the JS
// boundary (the element was already collected). The 23 event
// types are 1:1 with CppDOM's surface.
std::int32_t AddClickListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
//
// `preventDefault` (mouse / key / wheel kinds only — the others are
// not cancelable events, so the flag would be a silent no-op and is
// deliberately absent):
// Cancels the browser's default action. The JS bridge applies it
// BEFORE dispatching into wasm, so a trap in the callback cannot let
// the default action through anyway.
//
// This is what makes client-side routing over real, crawlable
// `<a href="/foo">` links possible: take the click, cancel the
// navigation, then Router::PushState. Without it the handler runs
// *and* the browser performs a full page load. It is also mandatory
// on dragover/drop — a drop target does not function at all unless
// the default is cancelled.
//
// Wheel additionally registers with `{ passive: false }` when set,
// or the browser drops the cancellation with a console warning.
//
// AddSubmitListener has no flag: its handler always preventDefaults,
// because a native form POST would navigate away from the wasm app.
std::int32_t AddClickListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveClickListener(std::int32_t id);
std::int32_t AddMouseOverListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddMouseOverListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveMouseOverListener(std::int32_t id);
std::int32_t AddMouseOutListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddMouseOutListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveMouseOutListener(std::int32_t id);
std::int32_t AddMouseMoveListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddMouseMoveListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveMouseMoveListener(std::int32_t id);
std::int32_t AddMouseDownListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddMouseDownListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveMouseDownListener(std::int32_t id);
std::int32_t AddMouseUpListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddMouseUpListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveMouseUpListener(std::int32_t id);
std::int32_t AddFocusListener(std::function<void(Crafter::Dom::FocusEvent)> callback);
@ -99,13 +156,16 @@ export namespace Crafter::Dom {
std::int32_t AddBlurListener(std::function<void(Crafter::Dom::FocusEvent)> callback);
void RemoveBlurListener(std::int32_t id);
std::int32_t AddKeyDownListener(std::function<void(Crafter::Dom::KeyboardEvent)> callback);
std::int32_t AddKeyDownListener(std::function<void(Crafter::Dom::KeyboardEvent)> callback,
bool preventDefault = false);
void RemoveKeyDownListener(std::int32_t id);
std::int32_t AddKeyUpListener(std::function<void(Crafter::Dom::KeyboardEvent)> callback);
std::int32_t AddKeyUpListener(std::function<void(Crafter::Dom::KeyboardEvent)> callback,
bool preventDefault = false);
void RemoveKeyUpListener(std::int32_t id);
std::int32_t AddKeyPressListener(std::function<void(Crafter::Dom::KeyboardEvent)> callback);
std::int32_t AddKeyPressListener(std::function<void(Crafter::Dom::KeyboardEvent)> callback,
bool preventDefault = false);
void RemoveKeyPressListener(std::int32_t id);
std::int32_t AddChangeListener(std::function<void(Crafter::Dom::ChangeEvent)> callback);
@ -123,28 +183,36 @@ export namespace Crafter::Dom {
std::int32_t AddScrollListener(std::function<void(Crafter::Dom::ScrollEvent)> callback);
void RemoveScrollListener(std::int32_t id);
std::int32_t AddContextMenuListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddContextMenuListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveContextMenuListener(std::int32_t id);
std::int32_t AddDragStartListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddDragStartListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveDragStartListener(std::int32_t id);
std::int32_t AddDragEndListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddDragEndListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveDragEndListener(std::int32_t id);
std::int32_t AddDropListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddDropListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveDropListener(std::int32_t id);
std::int32_t AddDragOverListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddDragOverListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveDragOverListener(std::int32_t id);
std::int32_t AddDragEnterListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddDragEnterListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveDragEnterListener(std::int32_t id);
std::int32_t AddDragLeaveListener(std::function<void(Crafter::Dom::MouseEvent)> callback);
std::int32_t AddDragLeaveListener(std::function<void(Crafter::Dom::MouseEvent)> callback,
bool preventDefault = false);
void RemoveDragLeaveListener(std::int32_t id);
std::int32_t AddWheelListener(std::function<void(Crafter::Dom::WheelEvent)> callback);
std::int32_t AddWheelListener(std::function<void(Crafter::Dom::WheelEvent)> callback,
bool preventDefault = false);
void RemoveWheelListener(std::int32_t id);
protected: