Awesome
Tired of complex template languages?
<img src="logo.png" alt="Logo" width="300" align="right">Try HTML components in pure Go.
gomponents are HTML components written in pure Go. They render to HTML 5, and make it easy for you to build reusable components. So you can focus on building your app instead of learning yet another templating language.
go get maragu.dev/gomponents
Made with ✨sparkles✨ by maragu.
Does your company depend on this project? Contact me at markus@maragu.dk to discuss options for a one-time or recurring invoice to ensure its continued thriving.
Features
Check out www.gomponents.com for an introduction.
- Build reusable HTML components
- Write declarative HTML 5 in Go without all the strings, so you get
- Type safety from the compiler
- Auto-completion from the IDE
- Easy debugging with the standard Go debugger
- Automatic formatting with
gofmt
/goimports
- Simple API that's easy to learn and use (you know most already if you know HTML)
- Useful helpers like
Text
andTextf
that insert HTML-escaped text,Raw
andRawf
for inserting raw strings,Map
for mapping data to components andGroup
for grouping components,- and
If
/Iff
for conditional rendering.
- No external dependencies
- Mature and stable, no breaking changes
Usage
go get maragu.dev/gomponents
package main
import (
. "maragu.dev/gomponents"
. "maragu.dev/gomponents/components"
. "maragu.dev/gomponents/html"
)
func Navbar(authenticated bool, currentPath string) Node {
return Nav(
NavbarLink("/", "Home", currentPath),
NavbarLink("/about", "About", currentPath),
If(authenticated, NavbarLink("/profile", "Profile", currentPath)),
)
}
func NavbarLink(href, name, currentPath string) Node {
return A(Href(href), Classes{"is-active": currentPath == href}, g.Text(name))
}
(Some people don't like dot-imports, and luckily it's completely optional.)
For a more complete example, see the examples directory. There's also the gomponents-starter-kit for a full application template.
What's up with the specially named elements and attributes?
Unfortunately, there are some name clashes in HTML elements and attributes, so they need an El
or Attr
suffix,
to be able to co-exist in the same package in Go.
I've chosen one or the other based on what I think is the common usage. In either case, the less-used variant also exists in the codebase:
cite
(Cite
/CiteAttr
,CiteEl
also exists)data
(DataEl
/Data
,DataAttr
also exists)form
(Form
/FormAttr
,FormEl
also exists)label
(Label
/LabelAttr
,LabelEl
also exists)style
(StyleEl
/Style
,StyleAttr
also exists)title
(TitleEl
/Title
,TitleAttr
also exists)