gomponents

Overview

gomponents is a pure Go HTML component library that treats HTML elements as composable Go values. Everything is built on the Node interface, making HTML construction type-safe and composable.

When to Use This Skill

Use this skill when:

• Reading or writing gomponents code
• Building server-side HTML views in Go applications
• Creating reusable HTML components in Go

Core Interface

Everything in gomponents implements the Node interface:

type Node interface {
    Render(w io.Writer) error
}

Essential Functions

Element and Attribute Creation

• El(name string, children ...Node) - Create custom HTML elements
• Attr(name string, value ...string) - Create custom attributes

Most standard HTML5 elements and attributes are available as functions in the html package:

• Elements: Div(), Span(), P(), A(), etc.
• Attributes: Class(), ID(), Href(), Src(), etc.

Note: nil Nodes are ignored during rendering, so it's safe to pass nil nodes to elements.

Text Content

• Text(string) - HTML-escaped text content
• Textf(format string, args...) - Formatted, escaped text
• Raw(string) - Unescaped HTML
• Rawf(format string, args...) - Formatted, unescaped content

Composition

• Group([]Node) - Combine multiple nodes
• Map[T]([]T, func(T) Node) - Transform slices into node sequences
• If(condition bool, node Node) - Conditional rendering
• Iff(condition bool, func() Node) - Lazy conditional rendering (deferred evaluation)

Import Convention

Contrary to common Go idioms, dot imports are recommended for gomponents to achieve DSL-like syntax:

import (
    . "maragu.dev/gomponents"
    . "maragu.dev/gomponents/html"
    . "maragu.dev/gomponents/components"
)

This allows writing clean, HTML-like code:

Div(Class("container"),
    H1(Text("Hello World")),
    P(Text("Welcome to gomponents")),
)

Package Organization

• maragu.dev/gomponents - Core i...