Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dtylman/gowd
Build cross platform GUI apps with GO and HTML/JS/CSS (powered by nwjs)
https://github.com/dtylman/gowd
desktop golang nwjs-application
Last synced: 10 days ago
JSON representation
Build cross platform GUI apps with GO and HTML/JS/CSS (powered by nwjs)
- Host: GitHub
- URL: https://github.com/dtylman/gowd
- Owner: dtylman
- License: mit
- Created: 2017-03-29T14:50:53.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-24T18:58:10.000Z (over 1 year ago)
- Last Synced: 2024-10-25T05:22:38.851Z (11 days ago)
- Topics: desktop, golang, nwjs-application
- Language: Go
- Homepage:
- Size: 11.4 MB
- Stars: 430
- Watchers: 25
- Forks: 43
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - gowd - Rapid and simple desktop UI development with GO, HTML, CSS and NW.js. Cross platform. (GUI / Search and Analytic Databases)
- awesome-go - gowd - Build cross platform GUI apps with GO and HTML/JS/CSS (powered by nwjs) - ★ 149 (GUI)
README
# gowd
Build cross platform GUI apps with GO and HTML/JS/CSS (powered by [nwjs](https://nwjs.io/))
[](https://circleci.com/gh/dtylman/gowd)
[](https://goreportcard.com/report/github.com/dtylman/gowd)
[](http://godoc.org/github.com/dtylman/gowd)
### How to use this library:
1. Download and install [nwjs](https://nwjs.io/)
1. Install this library `go get github.com/dtylman/gowd`
1. Clone this repo.
1. Place `package.json`, `index.html`, `main.go` and `main.js` from [template](cmd/template/) in a new folder.
1. `go build`
1. Edit `main.js` and set `goBinary` to your your executable name:
```javascript
var goBinary = "./template"; //or template.exe
```
1. Run `nw .`, the hello world template should appear:
### Usage
Simplest "hello world":
```go
import "github.com/dtylman/gowd"
func main() {
body, err := gowd.ParseElement("
Hello world
", nil)
if err != nil {
panic(err)
}
gowd.Run(body)
}
```
Adding a button:
```go
import (
"github.com/dtylman/gowd"
)
func main() {
body, err := gowd.ParseElement("
Hello world
", nil)
if err != nil {
panic(err)
}
p := body.AddElement(gowd.NewElement("p"))
btn := p.AddElement(gowd.NewElement("button"))
btn.SetText("Click me")
btn.OnEvent(gowd.OnClick, btnClicked)
gowd.Run(body)
}
func btnClicked(sender *gowd.Element, event *gowd.EventElement) {
sender.SetText("Clicked!")
}
```
Creating and binding from HTML:
```go
import (
"github.com/dtylman/gowd"
"fmt"
)
func main() {
body, err := gowd.ParseElement("
Hello world
", nil)
if err != nil {
panic(err)
}
p := body.AddElement(gowd.NewElement("p"))
em := gowd.NewElementMap()
p.AddHtml(`
Please select a name
One
Two
`, em)
em["select1"].OnEvent(gowd.OnChange, btnClicked)
em["select1"].Object = body
gowd.Run(body)
}
func btnClicked(sender *gowd.Element, event *gowd.EventElement) {
body := sender.Object.(*gowd.Element)
body.AddElement(gowd.NewStyledText(fmt.Sprintf("Selected %s", event.GetValue()), gowd.BoldText))
body.AddElement(gowd.NewElement("br"))
}
```
Using bootstrap:
'gowd' supports creating bootstrap elements using the [bootstrap](bootstrap/) package.
First, add bootsrap css and js to your `index.html` file:
```html
```
Then you can create bootsrap items:
```go
import (
"github.com/dtylman/gowd"
"github.com/dtylman/gowd/bootstrap"
"time"
"fmt"
)
var body *gowd.Element
func main() {
//creates a new bootstrap fluid container
body = bootstrap.NewContainer(false)
// add some elements using the object model
div := bootstrap.NewElement("div", "well")
row := bootstrap.NewRow(bootstrap.NewColumn(bootstrap.ColumnLarge, 6, div))
body.AddElement(row)
// add some other elements from HTML
div.AddHTML(`
Dropdown Example
`, nil)
// add a button to show a progress bar
btn := bootstrap.NewButton(bootstrap.ButtonPrimary, "Start")
btn.OnEvent(gowd.OnClick, btnClicked)
row.AddElement(bootstrap.NewColumn(bootstrap.ColumnLarge, 4, bootstrap.NewElement("div", "well", btn)))
//start the ui loop
gowd.Run(body)
}
// happens when the 'start' button is clicked
func btnClicked(sender *gowd.Element, event *gowd.EventElement) {
// adds a text and progress bar to the body
text := body.AddElement(gowd.NewStyledText("Working...", gowd.BoldText))
progressBar := bootstrap.NewProgressBar()
body.AddElement(progressBar.Element)
// makes the body stop responding to user events
body.Disable()
// clean up - remove the added elements
defer func() {
body.RemoveElement(text)
body.RemoveElement(progressBar.Element)
body.Enable()
}()
// render the progress bar
for i := 0; i <= 123; i++ {
progressBar.SetValue(i, 123)
text.SetText(fmt.Sprintf("Working %v", i))
time.Sleep(time.Millisecond * 20)
// this will cause the body to be refreshed
body.Render()
}
}
```
This will yield the following app:
More a more advanced usage, see the [Todo](cmd/todomvc/readme.md) sample
