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之上。