Modal Component - Goshtoso UI Library for Go

Focused overlay content with Modal and AlertDialog primitives, plus optional HTMX or JavaScript actions.

Default Rendered example

Usage Example

@modal.Modal(modal.Config{
    ID:            "offer",
    Title:         "Special Offer",
    Body:          "Upgrade your account now to unlock premium features.",
    TriggerLabel:   "Open Modal",
    PrimaryLabel:   "Upgrade Now",
    SecondaryLabel: "Remind me later",
})

Alert Dialogs

AlertDialog renders a compact, icon-led alert dialog with one action and a semantic Tone.

Alert Dialogs Rendered example

Alert Dialogs

@modal.AlertDialog(modal.AlertDialogConfig{
    ID:          "txComplete",
    Title:       "Transaction Complete",
    Body:        "Your funds transfer was successful.",
    TriggerLabel: "Success Modal",
    ActionLabel: "Go to My Balance",
    Tone:        modal.ToneSuccess,
})

With HTMX Action

Give a button a PrimaryAction with hx-* fields to fire a server request on confirm.

With HTMX Action Rendered example

With HTMX Action

@modal.Modal(modal.Config{
    ID:            "htmxDemo",
    Title:         "Confirm Action",
    Body:          "This will send a request to the server.",
    TriggerLabel:   "HTMX Modal",
    PrimaryLabel:   "Confirm",
    SecondaryLabel: "Cancel",
    PrimaryAction: &modal.ButtonAction{
        HTMX: &modal.HTMXConfig{Post: "/api/hello", Target: "#modal-htmx-result", Swap: "innerHTML"},
    },
})

With JavaScript Action

Use PrimaryAction.OnClick for a client-side handler.

With JavaScript Action Rendered example

With JavaScript Action

@modal.Modal(modal.Config{
    ID:            "jsDemo",
    Title:         "Confirm Delete",
    Body:          "Are you sure? This cannot be undone.",
    TriggerLabel:   "JS Action Modal",
    PrimaryLabel:   "Delete",
    SecondaryLabel: "Cancel",
    PrimaryAction: &modal.ButtonAction{OnClick: "alert('Deleted!')"},
})

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/modal

Open v0.2.7 API

Toast Drawer