web

Overview ¶

Package web provides HTTP utilities for lix applications.

Form Handling ¶

The Form type is in the web/form subpackage:

cs := changeset.Cast[User](nil, params, []string{"name", "email"})
cs.ValidateRequired("name", "email")

import "codeberg.org/lixgo/lix/web/form"
f := form.ToForm(cs, "user")

// In templates:
// form.Value("name")      - get field value
// form.Error("name")      - get error message (respects touched state)
// form.HasError("name")   - check if field has visible error
// form.InputName("name")  - "user[name]"
// form.InputID("name")    - "user_name"
// form.Field("name")      - get complete Field struct with all info

Field Configuration ¶

Customize fields with ConfigureField:

f := form.ToForm(cs, "user").
    ConfigureField("email", form.Placeholder("[email protected]")).
    ConfigureField("bio", form.Label("Biography"), form.InputType("textarea"))

Form Parsing ¶

Parse extracts form parameters from HTTP requests into nested maps:

params, err := web.Parse(r)
// "user[name]" -> params["user"]["name"]
// "user[address][city]" -> params["user"]["address"]["city"]

Both bracket notation (user[name]) and dot notation (user.name) are supported.

Datastar Validation ¶

For Datastar live validation endpoints:

func HandleValidate(w http.ResponseWriter, r *http.Request) {
    err := web.ValidateAndRespond(w, r, (*User)(nil), []string{"name", "email"},
        func(cs *changeset.Changeset[User]) *changeset.Changeset[User] {
            return cs.ValidateRequired("name", "email").
                ValidateFormat("email", emailRegex)
        })
    if err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
    }
}

ValidateAndRespond handles the full flow:

• Read Datastar signals from request
• Create changeset and apply validation
• Respect touched state from client
• Send SSE response with validation results

Flash Messages ¶

FlashStore provides cookie-based flash messages:

flash := web.NewFlashStore(secretKey)

// In handler after successful action:
flash.Set(w, r, "success", "User created!")
http.Redirect(w, r, "/users", http.StatusSeeOther)

// In next request:
flashes := flash.Get(w, r) // map[string][]string
// flashes["success"] = ["User created!"]
// Messages are auto-cleared after Get

Supported levels: "info", "success", "warning", "error"