interactive

func AnimateOnSignal ¶

func AnimateOnSignal(html render.HTML, signalName, cssClass string) render.HTML

AnimateOnSignal wraps an element so it gets a CSS class when a signal is truthy and loses it when falsy. Used for CSS transition-driven animations like slide-down, fade, etc.

Panics if signalName or cssClass is empty.

func CancelEdit ¶

func CancelEdit(html render.HTML, signalName string) render.HTML

CancelEdit wraps an element so clicking it sets a signal to false, closing the inline-edit mode. Typically used on a cancel button inside the edit form.

func Dropdown ¶

func Dropdown(trigger, panel render.HTML) render.HTML

func EditToggle ¶

func EditToggle(html render.HTML, signalName string) render.HTML

EditToggle wraps an element so clicking it toggles a boolean signal. Semantic alias for ToggleLocal used in inline-edit patterns: clicking the text span enters edit mode.

func IncLocal ¶

func IncLocal(html render.HTML, signalName string, delta int) render.HTML

IncLocal wraps an HTML element so clicking it increments a numeric signal by delta (default 1). No RPC is fired.

func LiveSearch ¶

func LiveSearch(form render.HTML, action Action, debounceMs int) render.HTML

LiveSearch wraps a form element so input changes fire debounced RPCs. The search input should be the first <input> inside the form. Results are written into the signal named by the action's OnSuccess effect (typically via SetSignal).

debounceMs controls the delay between keystrokes and the RPC call. If debounceMs is 0, a default of 300ms is used.

func OnClick ¶

func OnClick(html render.HTML, action Action) render.HTML

OnClick wraps an HTML element so that clicking it fires the action. The element must be a clickable element (button, a, etc.).

func OnSubmit ¶

func OnSubmit(html render.HTML, action Action) render.HTML

OnSubmit wraps a form element so that submitting it fires the action.

func OptimisticUpdate ¶

func OptimisticUpdate(action Action, idle, success render.HTML) render.HTML

─── Optimistic update ─────────────────────────────────────────────

OptimisticUpdate renders a button that flips to its "success" visual state immediately on click, fires an RPC in the background, and reverts to idle if the RPC fails (non-2xx or network error).

The runtime module optimisticaction.js handles the full lifecycle: idle → pending (optimistic flip) → committed (RPC 2xx) or error → idle.

The caller provides two visual states:

• idle: the default appearance (e.g. "♡ Like")
• success: the committed appearance (e.g. "♥ Liked")

Example:

OptimisticUpdate(
    interactive.Post("/api/like/42"),
    render.HTML(`<span class="icon">♡</span> Like`),
    render.HTML(`<span class="icon">♥</span> Liked`),
)

Produces:

<button data-fui-comp="ui-optimistic-action"
        data-state="idle"
        data-fui-optimistic-endpoint="/api/like/42"
        data-fui-optimistic-method="POST">
  <span data-fui-optimistic-idle><span class="icon">♡</span> Like</span>
  <span hidden data-fui-optimistic-success><span class="icon">♥</span> Liked</span>
</button>

func Reveal ¶

func Reveal(html render.HTML, animationType string) render.HTML

Reveal wraps an element so it animates in when it enters the viewport. The animationType determines the direction ("fade-up", "fade-in", "slide-left", "slide-right"). Empty → "fade-in". The element renders visible without JS (progressive enhancement); reveal.js adds the hidden state on boot and removes it on intersection.

func SectionMenu ¶

func SectionMenu(cfg SectionMenuConfig) render.HTML

SectionMenu renders the desktop rail plus the mobile trigger button. Mount the matching drawer once with SectionMenuDrawer.

func SectionMenuDrawer ¶

func SectionMenuDrawer(cfg SectionMenuConfig) *widget.Builder

SectionMenuDrawer returns the mobile drawer widget for a SectionMenu — a left-edge preset.Drawer (backdrop + click-outside / Escape close + scroll lock + focus trap) carrying the same menu body. Mount it once at startup:

widget.MountBuilder(router, interactive.SectionMenuDrawer(cfg))

func SetLocal ¶

func SetLocal(html render.HTML, signalName, value string) render.HTML

SetLocal wraps an HTML element so clicking it sets a signal to a fixed value. No RPC is fired — the update is instant.

func ToggleLocal ¶

func ToggleLocal(html render.HTML, signalName string) render.HTML

ToggleLocal wraps an HTML element so clicking it toggles a boolean signal. No RPC is fired.