gweb

Gweb: golang + js + wasm

GWEB - Bibliothèque WebAPI typique strictement au-dessus de Syscall / JS. Comme le flux ou le type de type mais pour aller. Vous en avez besoin si vous souhaitez interagir avec le navigateur du programme GO compilé WASM.

• Exemples: gweb.orsinium.dev
• Cartographie de JS Web API aux fonctions GWEB: Refs.md

Caractéristiques

• Strictement typé . C'est un wrapper autour de syscall/js qui vous aide à éviter les erreurs d'exécution (vous les obtiendrez beaucoup avec Raw syscall/js ).
• Compatible en arrière . Presque tous les types sont un emballage autour de js.Value . Donc, si quelque chose manquait, vous pouvez toujours retomber aux appels classiques syscall/js .
• Fabriqué à la main . Il est difficile de faire une autogénération utilisable de WebAPI, car GO est une langue strictement dactylographiée sans type d'union. Nous avons donc tout traduit soigneusement tout lors de l'application des meilleures pratiques.
• Nettoyé . La bibliothèque ne fournit que des méthodes et des attributs utiles de WebAPI. Pas de méthodes obsolètes et obsolètes, pas d'API expérimentales qui ne sont soutenues que par quelques moteurs. Seulement ce dont nous avons vraiment besoin en ce moment.
• Presque la même API que dans JS . Si vous avez de l'expérience avec Vanilla JS, vous avez presque tout appris sur le libray.
• Mais mieux . Webapi a une longue histoire de changements incrémentiels et d'espaces pour les rêves non implémentés. Cependant, nous pouvons voir l'image complète pour offrir une meilleure expérience et plus d'espaces de noms.
• Documenté . Chaque méthode est documentée pour gagner du temps et réduire la recherche sur Google.

Installation

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

Si vous utilisez VScode, il est recommandé de créer un fichier .vscode/settings.json dans votre projet avec le contenu suivant:

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

Gestion des erreurs

Dans le beau monde JS, tout peut à tout moment, tout ce qui peut être null ou undefined . Vérifiez lorsque vous n'êtes pas sûr:

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

API manqué

Si quelque chose est manqué, utilisez des méthodes de type syscall/js ( Get , Set , Call , etc.):

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

Packages

GWEB est une collection de quelques packages:

• web (docs) - fenêtre, manipulations avec Dom.
• audio (DOCS) - API audio Web. Utilisez web.GetWindow().AudioContext() comme point d'entrée.
• canvas (DOC) - objets liés au canevas. Utilisez web.GetWindow().Document().CreateCanvas() pour commencer.
• css (DOCS) - Gérer les styles pour les éléments HTML.

Contributif

Les contributions sont les bienvenues! GWEB est un projet open-source et vous pouvez aider à l'améliorer. Quelques idées ce qui peut être amélioré:

• Chaque fonction et objet doit avoir une brève description basée sur les documents API Web MDN. Certaines descriptions sont manquées.
• De plus, chaque fonction qui appelle une méthode API Web doit avoir un lien dans DOCS pour cette méthode.
• Les fautes de frappe sont très possibles, n'hésitez pas à le réparer si vous en avez repéré une.
• Plus d'objets et de méthodes? Bien sûr! Notre objectif est de tout couvrir dans Webapi! Eh bien, à l'exclusion des choses obsolètes. Voir la section des fonctionnalités pour ressentir ce qui devrait être là.
• Vous avez trouvé un bug? Réparez-le!

Et même si vous n'avez pas de temps libre pour faire des PR, vous pouvez toujours vous aider en parlant à vos amis et aux abonnés de GWEB. Merci ❤️

Projets similaires

• Webapi - liaisons autoogène à partir de webidl.
• GODOM - Bonneries au-dessus de Gopherjs.