Banner

A prominent page or section message for announcements, promotions, and alerts. Dismissible by default, with optional CTAs and semantic tones.

Default Rendered example

Usage Example

@banner.Banner(banner.Config{
    Description: "Limited Time Offer! Explore exclusive deals & savings",
})

Persistent (Non-dismissible)

Persistent: true removes the dismiss control so the message stays put.

Persistent (Non-dismissible) Rendered example

Persistent (Non-dismissible)

@banner.Banner(banner.Config{
    Description:       "This banner cannot be dismissed by users",
    Persistent: true,
})

With CTA Button

Use Href for native navigation or HTMX for a server action, with optional OnClick for local enhancement.

With CTA Button Rendered example

With CTA Button

@banner.Banner(banner.Config{
    Description: "Get Fit Anywhere, Anytime 💪",
    CTA: &banner.CTAConfig{
        ActionLabel: "Start free trial",
		HTMX: &banner.HTMXConfig{
			Post:   "/api/components/banner/action",
			Target: "#banner-cta-result",
			Swap:   "innerHTML",
		},
		// Optional local enhancement after HTMX begins.
		OnClick: "trackTrialStart()",
    },
})

Semantic Tones

Set Tone for semantic coloring: Default, Primary, Info, Success, Warning, or Danger.

Semantic Tones Rendered example

Semantic Tones

@banner.Banner(banner.Config{Description: "Success! Your changes have been saved", Tone: banner.ToneSuccess})
@banner.Banner(banner.Config{Description: "Warning: Please review your settings", Tone: banner.ToneWarning})

CookieBanner is a separate corner-anchored dialog with consent-specific content and accept/reject actions.

Cookie Consent Rendered example

Cookie Consent

@banner.CookieBanner(banner.CookieBannerConfig{
    Title:        "Cookie Settings",
    Description:  "We use cookies to improve your experience.",
    AcceptLabel:  "Accept All",
    RejectLabel:  "Decline",
	AcceptAction: "show = false",
	RejectAction: "show = false",
})

Go API

v0.2.7

The examples above cover behavior and composition. pkg.go.dev is the canonical reference for exported types, functions, methods, and Go documentation.

github.com/araihu/goshtoso/components/banner

Open v0.2.7 API

Badge Card