gweb

GWEB: Golang + JS + WASM

GWEB - Строго напечатана библиотека WebAPI на вершине SYSCALL/JS. Как поток или типография, но для Go. Вам это нужно, если вы хотите взаимодействовать с браузером из программы WASM-Compilled GO.

• Примеры: gweb.orsinium.dev
• Картирование JS Web API на функции GWEB: refs.md

Функции

• Строго напечатано . Это обертка вокруг syscall/js , которая помогает вам избежать ошибок времени выполнения (вы получите их много с Raw syscall/js ).
• Обратно совместимо . Почти каждый тип - это обертка вокруг js.Value . Так что, если что -то пропустило, вы всегда можете вернуться к классическим вызовам syscall/js .
• Ручная работа . Трудно сделать полезную аутогенерацию WebAPI, так как GO - это строго напечатанный язык без типов союзов. Таким образом, мы тщательно перевели все при применении лучших практик.
• Вычистил . Библиотека предоставляет только полезные методы и атрибуты от Webapi. Нет устаревших и устаревших методов, нет экспериментальных API, которые поддерживаются только несколькими двигателями. Только то, что нам действительно нужно прямо сейчас.
• Почти тот же API, что и в JS . Если у вас есть опыт работы с Vanilla JS, вы почти узнали все о Libray.
• Но лучше . У Webapi есть долгая история постепенных изменений и пространств для невыполненных снов. Тем не менее, мы можем увидеть полную картину, чтобы обеспечить лучший опыт и больше пространств имен.
• Документирован . Каждый метод задокументирован, чтобы сэкономить ваше время и сократить Googling.

Установка

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 -подобные ( Get , Set , Call и т. Д.):

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

Пакеты

GWEB - это коллекция из нескольких пакетов:

• web (Docs) - окно, манипуляции с Dom.
• audio (Docs) - Web Audio API. Используйте web.GetWindow().AudioContext() в качестве точки входа.
• canvas (документы)-объекты, связанные с холстом. Используйте web.GetWindow().Document().CreateCanvas() чтобы начать.
• css (DOCS) - Управление стилями для элементов HTML.

Внося

Взносы приветствуются! GWEB-это проект с открытым исходным кодом, и вы можете помочь сделать его лучше. Некоторые идеи, что можно улучшить:

• Каждая функция и объект должны иметь краткое описание на основе документов MDN Web API. Некоторые описания пропущены.
• Кроме того, каждая функция, которая вызывает метод веб -API, должна иметь ссылку в DOCS для этого метода.
• Опечатки очень возможны, не стесняйтесь исправить это, если вы заметили один.
• Больше объектов и методов? Конечно! Наша цель - охватить все в Webapi! Ну, за исключением устаревших вещей. Смотрите раздел «Особенности», чтобы почувствовать, что должно быть там.
• Нашел ошибку? Исправьте!

И даже если у вас нет свободного времени для создания PRS, вы все равно можете помочь, поговорив со своими друзьями и подписчиками о GWEB. Спасибо ❤

Подобные проекты

• webapi - привязки, которые автогенерировали из webidl.
• Godom - привязки на вершине Gopherjs.