gowd

Build cross platform GUI apps with GO and HTML/JS/CSS (powered bynwjs)

How to use this library:

1. Download and installnwjs
2. Install this librarygo get github.com/dtylman/gowd
3. Clone this repo.
4. Placepackage.json,index.html,main.go andmain.js fromtemplate in a new folder.
5. go build
6. Editmain.js and setgoBinary to your your executable name:

   var goBinary = "./template"; //or template.exe

7. Runnw ., the hello world template should appear:

Usage

Simplest "hello world":

import "github.com/dtylman/gowd"func main() {body, err := gowd.ParseElement("<h1>Hello world</h1>", nil)if err != nil {panic(err)}gowd.Run(body)}

Adding a button:

import ("github.com/dtylman/gowd")func main() {body, err := gowd.ParseElement("<h1>Hello world</h1>", 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:

import ("github.com/dtylman/gowd""fmt")func main() {body, err := gowd.ParseElement("<h1>Hello world</h1>", nil)if err != nil {panic(err)}p := body.AddElement(gowd.NewElement("p"))em := gowd.NewElementMap()p.AddHtml(`<select id="select1"><option value="" disabled="disabled" selected="selected">Please select a name</option><option value="1">One</option><option value="2">Two</option></select>`, em)em["select1"].OnEvent(gowd.OnChange, btnClicked)em["select1"].Object = bodygowd.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 thebootstrap package.

First, add bootsrap css and js to yourindex.html file:

    <script type="text/javascript" src="js/jquery.min.js"></script>    <link rel="stylesheet" type="text/css" href="css/bootstrap.min.css"/>    <script type="text/javascript" src="js/bootstrap.min.js"></script>

Then you can create bootsrap items:

import ("github.com/dtylman/gowd""github.com/dtylman/gowd/bootstrap""time""fmt")var body *gowd.Elementfunc main() {//creates a new bootstrap fluid containerbody = bootstrap.NewContainer(false)// add some elements using the object modeldiv := bootstrap.NewElement("div", "well")row := bootstrap.NewRow(bootstrap.NewColumn(bootstrap.ColumnLarge, 6, div))body.AddElement(row)// add some other elements from HTMLdiv.AddHTML(`<div class="dropdown"><button class="btn btn-primary dropdown-toggle" type="button" data-toggle="dropdown">Dropdown Example<span class="caret"></span></button><ul class="dropdown-menu" id="dropdown-menu"><li><a href="#">HTML</a></li><li><a href="#">CSS</a></li><li><a href="#">JavaScript</a></li></ul></div>`, nil)// add a button to show a progress barbtn := 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 loopgowd.Run(body)}// happens when the 'start' button is clickedfunc 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 eventsbody.Disable()// clean up - remove the added elementsdefer func() {body.RemoveElement(text)body.RemoveElement(progressBar.Element)body.Enable()}()// render the progress barfor 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 refreshedbody.Render()}}

This will yield the following app:

More a more advanced usage, see theTodo sample

Constants¶

const (//OnClick onclick eventOnClick = "onclick"//OnChange onchange eventOnChange = "onchange"//OnKeyPress onkeypress eventOnKeyPress = "onkeypress")

const (//BoldText <b>BoldText = "b"//StrongText <strong>StrongText = "strong"//ItalicText <i>ItalicText = "i"//EmphasizedText <em>EmphasizedText = "em"//MarkedText <mark>MarkedText = "mark"//SmallText <small>SmallText = "small"//DeletedText <del>DeletedText = "del"//InsertedText <ins>InsertedText = "ins"//SubscriptText <sub>SubscriptText = "sub"//SuperscriptText <sup>SuperscriptText = "sup"//TitleText <title>TitleText = "title"//Paragraph <p>Paragraph = "p"//Heading1 <h1>Heading1 = "h1"//Heading2 <h2>Heading2 = "h2"//Heading3 <h3>Heading3 = "h3"//Heading4 <h4>Heading4 = "h4"//Heading5 <h5>Heading5 = "h5"//Heading6 <h6>Heading6 = "h6")

Variables¶

var (//Order counts the number of elements rendered (for generating auto-ids)Orderint//Output output render target (configurable for unit-tests)Outputio.Writer =os.Stdout)

Functions¶

func Alert(textstring)

func ExecJS(jsstring)

func ExecJSNow(jsstring)

func Run(body *Element)error

Types¶

type Element struct {//Parent the parent elementParent *Element//Kids child elementsKids []*Element//Attributes element attributes...Attributes []html.Attribute//Object arbitrary user object that can be associated with element.Object interface{}//Hidden if true the element will not be renderedHiddenbool// contains filtered or unexported fields}

func NewElement(tagstring) *Element

func NewElementFromNode(node *html.Node, emElementsMap) *Element

func NewStyledText(textstring, stylestring) *Element

func NewText(textstring) *Element

func ParseElement(innerHTMLstring, emElementsMap) (*Element,error)

func ParseElementFromFile(fileNamestring, emElementsMap) (*Element,error)

func ParseElements(rio.Reader, emElementsMap) ([]*Element,error)

func (e *Element) AddElement(elem *Element) *Element

func (e *Element) AddHTML(innerHTMLstring, emElementsMap) ([]*Element,error)

func (e *Element) AutoFocus()

func (e *Element) Disable()

func (e *Element) Enable()

func (e *Element) Find(idstring) *Element

func (e *Element) GetAttribute(keystring) (string,bool)

func (e *Element) GetID()string

func (e *Element) GetValue()string

func (e *Element) Hide()

func (e *Element) OnEvent(eventstring, handlerEventHandler)

func (e *Element) OnKeyPressEvent(eventstring, keyCodeint, handlerEventHandler)

func (e *Element) ProcessEvent(event *Event)

func (e *Element) RemoveAttribute(keystring)

func (e *Element) RemoveElement(elem *Element)

func (e *Element) RemoveElements()

func (e *Element) Render()error

func (e *Element) SetAttribute(key, valstring)

func (e *Element) SetAttributes(event *EventElement)

func (e *Element) SetClass(classstring)

func (e *Element) SetElement(elem *Element) *Element

func (e *Element) SetID(idstring)

func (e *Element) SetText(textstring)

func (e *Element) SetValue(valstring)

func (e *Element) Show()

func (e *Element) UnsetClass(classstring)

type ElementsMap map[string]*Element

func NewElementMap()ElementsMap

type Event struct {Namestring         `json:"name"`SenderEventElement   `json:"sender"`Inputs []EventElement `json:"inputs"`}

type EventElement struct {Properties map[string]string `json:"properties"`}

func (e *EventElement) GetID()string

func (e *EventElement) GetValue()string

type EventHandler func(sender *Element, event *EventElement)