gweb

Gweb: Golang + JS + Wasm

GWEB - Biblioteca Webapi estritamente digitada em cima do Syscall/JS. Como fluxo ou texto datilografado, mas para Go. Você precisa se quiser interagir com o navegador do programa GO compilado WASM.

• Exemplos: gweb.orsinium.dev
• Mapeamento da API da Web JS para as funções GWEB: refs.md

Características

• Estritamente digitado . É um invólucro em torno syscall/js que ajuda você a evitar erros de tempo de execução (você os receberá muito com syscall/js cru).
• Compatível para trás . Quase todo tipo é um invólucro em torno de js.Value . Portanto, se algo perdido, você sempre pode voltar às chamadas clássicas syscall/js .
• Manualmente criado . É difícil fazer uma autogeração utilizável de webapi, já que o GO é um idioma estritamente digitado sem tipos de sindicatos. Por isso, traduzimos cuidadosamente tudo enquanto aplicamos as melhores práticas.
• Limpo . A biblioteca fornece apenas métodos e atributos úteis da Webapi. Não há métodos obsoletos e depreciados, nenhuma APIs experimental que seja suportada apenas por alguns motores. Apenas o que realmente precisamos agora.
• Quase a mesma API que em JS . Se você tem experiência com JS de baunilha, quase aprendeu tudo sobre o Libray.
• Mas melhor . Webapi tem uma longa história de mudanças e espaços incrementais para sonhos não implementados. No entanto, podemos ver a imagem completa para fornecer uma melhor experiência e mais espaços para nome.
• Documentado . Todo método é documentado para economizar seu tempo e reduzir o Google.

Instalação

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

Se você estiver usando o VSCODE, é recomendável criar um arquivo .vscode/settings.json em seu projeto com o seguinte conteúdo:

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

Manuseio de erros

No belo mundo JS, qualquer coisa a qualquer momento pode ser null ou undefined . Verifique quando não tiver certeza:

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

API perdida

Se algo for perdido, use métodos semelhantes syscall/js ( Get , Set , Call etc):

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

Pacotes

GWEB é uma coleção de alguns pacotes:

• web (docs) - Janela, manipulações com DOM.
• audio (DOCs) - API da Web Audio. Use web.GetWindow().AudioContext() como ponto de entrada.
• canvas (DOCs)-Objetos relacionados à tela. Use web.GetWindow().Document().CreateCanvas() para começar.
• css (DOCs) - Gerenciar estilos para elementos HTML.

Contribuindo

As contribuições são bem -vindas! O GWeb é um projeto de código aberto e você pode ajudar a melhorar. Algumas idéias o que pode ser melhorado:

• Toda função e objeto devem ter uma descrição curta com base nos documentos da API da Web do MDN. Algumas descrições são perdidas.
• Além disso, todas as funções que chamam um método da API da Web devem ter um link nos documentos para esse método.
• Erros de digitação são muito possíveis, não tenha vergonha de corrigi -lo se você viu um.
• Mais objetos e métodos? Claro! Nosso objetivo é cobrir tudo no webapi! Bem, excluindo coisas depreciadas. Consulte a seção Recursos para sentir o que deveria estar lá.
• Encontrou um bug? Conserte!

E mesmo que você não tenha tempo livre para fazer PRs, ainda poderá ajudar conversando com seus amigos e assinantes sobre o GWeb. Obrigado ❤️

Projetos semelhantes

• Webapi - Liglas que autogeneradas do WebIDL.
• Godom - ligações no topo de Gopherjs.