VSL raw DOM bindings communicating using WASM/IDL interface
This library allows you to communicate with all and every JS API however it is
recommended to use the Web library which offers high-level bindings and is a
lot more user-friendly.
The DOM library is, for default installations, in the VSL prefix so you do not
need to install it, just import it using import DOM.
VSL aims to provide an interface to the WHATWG or W3C standards. VSL's DOM library current integrates with the following specifications:
- (full) DOM
- (full) Console: prefer VSL stdio
- (in progress) CSSOM
- (in progress) HTML 5.3
- (none) XMLHttpRequest: prefer VSL's
HTTPlibrary which has WASM support.
This exports DOM primitives but the VSL STL's WASM standard dispatch API offers
hooks and connectivity to JS. That exports a JSValue which is the root class
for all JS items. Additionally important globals that are exported are
JS_GLOBAL, JS_UNDEFINED, and JS_NULL.
Given the export of JSValue, you can use .dispatchAccess("property") and
.dispatchAnon("method") however if you wish to call a method with parameters,
this requires creating a stack frame which is a bit complex which is why it is
recommended to create a WebIDL or TypeScript decl for any additional properties
which you wish to access.
The dispatch API automatically performs bridging between VSL and JS types for
functions from the bindgen but given that certain types such as ints, strings,
and arrays can't be directly cast to JSValue. You may use the JSValue.from
functions to perform these transforms.
Additionally to get the metaclass. For example the Element metaclass, you can
use Element.toJSValue().
import DOM
console.log(JSValue.from("Hello from VSL!"))import DOM
document.getElementById("root").setAttribute("style", "background-color: red;")