gweb

GWEB: Golang + JS + Wasm

GWEB - Perpustakaan Webapi yang diketik secara ketat di atas Syscall/JS. Seperti aliran atau naskah tetapi untuk pergi. Anda membutuhkannya jika Anda ingin berinteraksi dengan browser dari program GO yang dikompilasi Wasm.

• Contoh: gweb.orsinium.dev
• Pemetaan JS Web API ke GWEB Functions: Refs.MD

Fitur

• Diketik secara ketat . Ini adalah pembungkus di sekitar syscall/js yang membantu Anda menghindari kesalahan runtime (Anda akan mendapatkannya banyak dengan syscall/js mentah).
• Kompatibel ke belakang . Hampir setiap jenis adalah pembungkus di sekitar js.Value . Jadi jika sesuatu terlewatkan, Anda selalu dapat kembali ke panggilan syscall/js klasik.
• Tangan dibuat . Sulit untuk membuat autogenerasi webapi yang dapat digunakan sejak Go adalah bahasa yang diketik secara ketat tanpa jenis serikat. Jadi kami dengan hati -hati menerjemahkan segalanya sambil menerapkan praktik terbaik.
• Dibersihkan . Perpustakaan hanya menyediakan metode dan atribut yang berguna dari WebAPI. Tidak ada metode yang usang dan sudah usang, tidak ada API eksperimental yang hanya didukung oleh beberapa mesin. Hanya yang benar -benar kita butuhkan sekarang.
• API yang hampir sama seperti di JS . Jika Anda memiliki pengalaman dengan Vanilla JS, Anda hampir belajar segalanya tentang perpustakaan.
• Tapi lebih baik . Webapi memiliki sejarah panjang perubahan dan ruang tambahan untuk mimpi yang tidak diterapkan. Namun, kita dapat melihat gambaran lengkapnya untuk memberikan pengalaman yang lebih baik dan lebih banyak ruang nama.
• Didokumentasikan . Setiap metode didokumentasikan untuk menghemat waktu Anda dan mengurangi Googling.

Instalasi

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

Jika Anda menggunakan vscode, disarankan untuk membuat file .vscode/settings.json dalam proyek Anda dengan konten berikut:

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

Penanganan kesalahan

Di dunia JS yang indah apa saja kapan saja bisa null atau undefined . Periksa saat Anda tidak yakin:

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

API yang terlewatkan

Jika ada sesuatu yang terlewatkan, gunakan metode seperti syscall/js ( Get , Set , Call dll):

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

Paket

GWEB adalah kumpulan beberapa paket:

• web (Dokumen) - Jendela, manipulasi dengan DOM.
• audio (Dokumen) - Web Audio API. Gunakan web.GetWindow().AudioContext() sebagai titik masuk.
• canvas (DOCS)-Objek terkait kanvas. Gunakan web.GetWindow().Document().CreateCanvas() untuk memulai.
• css (DOCS) - Kelola gaya untuk elemen HTML.

Berkontribusi

Kontribusi dipersilakan! GWEB adalah proyek open-source dan Anda dapat membantu membuatnya lebih baik. Beberapa ide apa yang bisa ditingkatkan:

• Setiap fungsi dan objek harus memiliki deskripsi singkat berdasarkan dokumen API Web MDN. Beberapa deskripsi terlewatkan.
• Juga, setiap fungsi yang memanggil metode API Web harus memiliki tautan dalam dokumen untuk metode itu.
• Kesalahan ketik sangat mungkin, jangan malu untuk memperbaikinya jika Anda melihatnya.
• Lebih banyak objek dan metode? Tentu saja! Tujuan kami adalah mencakup semuanya di Webapi! Nah, tidak termasuk hal -hal yang sudah usang. Lihat bagian fitur untuk merasakan apa yang seharusnya ada.
• Menemukan bug? Perbaiki!

Dan bahkan jika Anda tidak memiliki waktu luang untuk membuat PR, Anda masih dapat membantu dengan berbicara dengan teman dan pelanggan Anda tentang GWEB. Terima kasih ❤️

Proyek serupa

• WEBAPI - Binding yang autogenerasi dari webidl.
• GODOM - Binding di atas gopherjs.