gweb

GWEB: Golang + JS + WASM

GWEB - Streng geschriebene Webapi -Bibliothek über Syscall/JS. Wie Fluss oder Typenkript, aber für Go. Sie brauchen es, wenn Sie mit dem Browser aus dem WASM-Compiled Go-Programm interagieren möchten.

• Beispiele: gweb.orsinium.dev
• Zuordnung der JS -Web -API zu GWEB -Funktionen: Refs.md

Merkmale

• Streng tippt . Es ist eine Wrapper um syscall/js , die Ihnen hilft, Laufzeitfehler zu vermeiden (Sie erhalten sie viel mit rohen syscall/js ).
• Rückwärts kompatibel . Fast jeder Typ ist ein Wrapper um js.Value . Wenn etwas verpasst wird, können Sie immer auf die klassischen syscall/js -Anrufe zurückgreifen.
• Handgefertigt . Es ist schwierig, eine nutzbare Autogeneration von Webapi zu erstellen, da Go eine streng getippte Sprache ohne Gewerkschaftstypen ist. Deshalb haben wir alles sorgfältig übersetzt, während wir GO -Best Practices anwenden.
• Aufgeräumt . Die Bibliothek bietet nur nützliche Methoden und Attribute von WebAPI. Keine veralteten und veralteten Methoden, keine experimentellen APIs, die nur von wenigen Motoren unterstützt werden. Nur das, was wir gerade wirklich brauchen.
• Fast die gleiche API wie in JS . Wenn Sie Erfahrung mit Vanilla JS haben, haben Sie fast alles über das Libray gelernt.
• Aber besser . Webapi hat eine lange Geschichte von inkrementellen Änderungen und Räumen für nicht implementierte Träume. Wir können jedoch das vollständige Bild sehen, um eine bessere Erfahrung und mehr Namespaces zu bieten.
• Dokumentiert . Jede Methode ist dokumentiert, um Ihre Zeit zu speichern und das Googeln zu reduzieren.

Installation

GOOS=js GOARCH=wasm go get github.com/life4/gweb

Wenn Sie VSCODE verwenden, empfehlen Sie, in Ihrem Projekt eine .vscode/settings.json -Datei mit folgenden Inhalten zu erstellen:

{
    "go.toolsEnvVars" : {
        "GOARCH" : " wasm " ,
        "GOOS" : " js " ,
    },
    "go.testEnvVars" : {
        "GOARCH" : " wasm " ,
        "GOOS" : " js " ,
    },
}

Fehlerbehandlung

In der schönen JS -Welt kann jederzeit alles null oder undefined werden. Überprüfen Sie es, wenn Sie sich nicht sicher sind:

 doc := web . GetWindow (). Document ()
el := doc . Element ( "some-element-id" )
if el . Type () == js . TypeNull {
    // handle error
}

Verpasste API

Wenn etwas übersehen wird, verwenden Sie syscall/js -ähnliche Methoden ( Get , Set , Call usw.):

 doc := web . GetWindow (). Document ()
el := doc . Element ( "some-element-id" )
name = el . Get ( "name" ). String ()

Pakete

GWEB ist eine Sammlung einiger Pakete:

• web (DOCS) - Fenster, Manipulationen mit DOM.
• audio (DOCS) - Web Audio -API. Verwenden Sie web.GetWindow().AudioContext() als Einstiegspunkt.
• canvas (DOCS)-Canvas-bezogene Objekte. Verwenden Sie web.GetWindow().Document().CreateCanvas() um loszulegen.
• css (DOCS) - Verwalten Sie Stile für HTML -Elemente.

Beitragen

Beiträge sind willkommen! GWEB ist ein Open-Source-Projekt und Sie können helfen, es besser zu machen. Einige Ideen, was verbessert werden kann:

• Jede Funktion und jedes Objekt sollte eine kurze Beschreibung auf der Grundlage von MDN -Web -API -Dokumenten haben. Einige Beschreibungen werden übersehen.
• Jede Funktion, die eine Web -API -Methode aufruft, sollte einen Link in DOCs für diese Methode haben.
• Tippfehler sind sehr gut möglich. Seien Sie nicht schüchtern, um es zu reparieren, wenn Sie einen entdeckt haben.
• Weitere Objekte und Methoden? Natürlich! Unser Ziel ist es, alles in Webapi zu behandeln! Nun, ohne veraltete Dinge. Siehe Features -Abschnitt, um das Gefühl zu haben, was dort sein soll.
• Einen Fehler gefunden? Repariere es!

Und selbst wenn Sie keine Freizeit für die Herstellung von PRs haben, können Sie trotzdem helfen, indem Sie mit Ihren Freunden und Abonnenten über GWEB sprechen. Danke ❤️

Ähnliche Projekte

• WebAPI - Bindungen, die aus WebIdl autogenerisch sind.
• Godom - Bindungen über Gopherjs.