Crafter.CppDOM/README.md

About

Crafter.CppDOM is a C++ library that exposes the browser DOM api's to C++ WebAssembly.

How to use

Please view the samples folder, this is a snippit from the HelloElement sample:

import Crafter.CppDOM;
using namespace Crafter::CppDOM;

int main(){
    HtmlElement body("body");
    body.SetInnerHTML("Hello World!");
}

You can also view the wiki for more detailed information.

It is highly recommended to use this with Crafter.WebBuild, but it is not strictly required if the same way of injecting the env is followed. The following instructions will be for Crafter.WebBuild.

Quickstart

create a project.json in an empty folder, open it in your preferred text editor. Create a basic project file, that describes your web project.

{
    "name": "sample-project",
    "configurations": [
        {
            "name": "debug",
            "standard": "c++26",
            "source_files": ["main"],
            "module_files": [],
            "build_dir": "./build",
            "output_dir": "./bin",
            "optimization_level": "0",
            "target": "wasm32-unknown-wasi",
            "type": "executable",
            "dependencies": [
                {
                    "path":"https://github.com/Catcrafts/Crafter.CppDOM.git",
                    "configuration":"debug"
                }
            ]
        }
    ]
}

Save and close the file, create a main.cpp

import Crafter.CppDOM;
using namespace Crafter::CppDOM;

int main(){
    HtmlElement body("body");
    body.SetInnerHTML("Hello World!");
}

Save and close, then run crafter-webbuild serve -c debug. Now you can open the browser at http://localhost:8080/ and Hello World! will appear in the browser.

This sample can also be viewed in the HelloElement sample