gweb

GWEB: Golang + JS + Wasm

GWEB - Biblioteca WebAPI estrictamente escrita en la parte superior de SYSCALL/JS. Como flujo o mecanografiado pero para ir. Lo necesita si desea interactuar con el navegador del programa WASM-Compiled Go.

• Ejemplos: gweb.orsinium.dev
• Mapeo de las funciones de JS Web API a GWEB: refs.md

Características

• Estrictamente escrito . Es un envoltorio alrededor de syscall/js que lo ayuda a evitar errores de tiempo de ejecución (los obtendrá mucho con syscall/js RAW).
• Compatible con retroceso . Casi todos los tipos son un envoltorio alrededor de js.Value . Entonces, si algo se perdió, siempre puede volver a las clásicas llamadas syscall/js .
• Hecha a mano . Es difícil hacer una autogeneración utilizable de Webapi, ya que GO es un lenguaje estrictamente escrito sin tipos de sindicatos. Así que traducimos cuidadosamente todo mientras aplicamos las mejores prácticas de GO.
• Limpiado . La biblioteca proporciona solo métodos y atributos útiles de WebAPI. No hay métodos obsoletos y desaprobados, sin API experimentales que solo son respaldadas por algunos motores. Solo lo que realmente necesitamos en este momento.
• Casi la misma API que en JS . Si tiene experiencia con Vanilla JS, casi ha aprendido todo sobre el Libray.
• Pero mejor . Webapi tiene una larga historia de cambios y espacios incrementales para sueños no implementados. Sin embargo, podemos ver la imagen completa para proporcionar una mejor experiencia y más espacios de nombres.
• Documentado . Cada método está documentado para ahorrar su tiempo y reducir el Google.

Instalación

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

Si está utilizando VScode, se recomienda crear un archivo .vscode/settings.json en su proyecto con el siguiente contenido:

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

Manejo de errores

En el hermoso mundo de JS, cualquier cosa en cualquier momento puede ser null o undefined . Compruébalo cuando no estés seguro:

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

API perdida

Si se pierde algo, use métodos similares a syscall/js ( Get , Set , Call , etc.):

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

Paquetes

GWEB es una colección de algunos paquetes:

• web (Docs) - Ventana, Manipulaciones con Dom.
• audio (DOCS) - API de audio web. Use web.GetWindow().AudioContext() como punto de entrada.
• canvas (DOCS): objetos relacionados con el lienzo. Use web.GetWindow().Document().CreateCanvas() para comenzar.
• css (DOCS) - Administre estilos para elementos HTML.

Que contribuye

¡Las contribuciones son bienvenidas! GWEB es un proyecto de código abierto y puede ayudar a mejorarlo. Algunas ideas lo que se puede mejorar:

• Cada función y objeto debe tener una descripción breve basada en los documentos de API web MDN. Se pierden algunas descripciones.
• Además, cada función que llame a un método de API web debe tener un enlace en los documentos para ese método.
• Los errores tipográficos son muy posibles, no sea tímido para solucionarlo si ha visto uno.
• ¿Más objetos y métodos? ¡Por supuesto! ¡Nuestro objetivo es cubrir todo en Webapi! Bueno, excluyendo cosas desaprobadas. Consulte la sección de características para sentir lo que debería estar allí.
• Encontrado un error? ¡Arreglalo!

E incluso si no tiene tiempo libre para hacer PRS, aún puede ayudar hablando con sus amigos y suscriptores sobre GWEB. Gracias ❤️

Proyectos similares

• WebAPI: enlaces que se autodografiaron desde WebIDL.
• GODOM - ANIVOS EN COMP GOPHERJS.