gweb

GWEB：Golang + JS + WASM

GWEB-在SYSCALL/JS之上的严格键入WebAPI库。喜欢流或打字稿，但要去。如果您想与WASM-Compried GO程序中的浏览器进行交互，则需要它。

• 示例：gweb.orsinium.dev
• JS Web API映射到GWEB函数：refs.md

特征

• 严格打字。这是围绕syscall/js包装器，可帮助您避免运行时错误（使用RAW syscall/js您会得到很多错误）。
• 向后兼容。几乎每种类型都是js.Value周围的包装纸。因此，如果错过了什么，您总是可以回到经典的syscall/js电话。
• 手工制作。由于GO是一种没有工会类型的严格键入语言，因此很难成为WebAPI的可用自动化。因此，我们在应用最佳实践时仔细翻译了所有内容。
• 清理干净。该库仅提供WebAPI的有用方法和属性。没有过时的和弃用的方法，也没有仅由少数引擎支持的实验API。只有我们现在真正需要的东西。
• 与JS中的API几乎相同。如果您有Vanilla JS的经验，那么您几乎已经了解了有关库的所有内容。
• 但是更好。 Webapi有悠久的历史，用于毫无成就的梦想。但是，我们可以看到完整的图片，以提供更好的体验和更多的名称空间。
• 记录。记录了每种方法，以节省您的时间并减少谷歌搜索。

安装

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

如果您使用的是VSCODE，建议您在项目中使用以下内容创建一个.vscode/settings.json文件：

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

错误处理

在美丽的JS世界中，任何时候的任何东西都可以null或undefined 。当您不确定时检查它：

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

错过了API

如果错过了什么，请使用syscall/js -like方法（ Get ， Set ， Call等）：

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

软件包

GWEB是一些包装的集合：

• web （文档） - 窗口，使用DOM的操作。
• audio （文档） - 网络音频API。使用web.GetWindow().AudioContext()作为入口点。
• canvas （文档） - 帆布相关的对象。使用web.GetWindow().Document().CreateCanvas()开始。
• css （文档） - 管理HTML元素的样式。

贡献

欢迎捐款！ GWEB是一个开源项目，您可以帮助您改善它。一些想法可以改善：

• 每个功能和对象都应基于MDN Web API文档具有简短的描述。错过了一些描述。
• 同样，每个调用Web API方法的函数都应在该方法中具有文档中的链接。
• 错别字很有可能，如果您发现了一个问题，请不要害羞地修复它。
• 更多对象和方法？当然！我们的目标是涵盖WebAPI中的所有内容！好吧，不包括弃用的事情。请参阅功能部分，以感觉到应该有什么。
• 找到一个错误？修复！

即使您没有空闲时间制作PR，您仍然可以通过与朋友和订户谈论GWEB来提供帮助。谢谢你❤️

类似的项目

• WebAPI-从Webidl自动化的绑定。
• Godom-绑定在Gopherjs之上。