Skip to content

respond.md

Latest commit

 

History

History
60 lines (43 loc) · 1.57 KB

respond.md

File metadata and controls

60 lines (43 loc) · 1.57 KB
Raw

respond

Return a partial HTML response, a status code, or a file from disk.
Kind Attribute
Since 0.1.0

Syntax

respond [fragment <selector> | status <code> | file <path> [as <name>] [inline|attachment]]

Description

Three forms:

  • Without arguments: renders the body's HTML normally.
  • fragment <selector>: returns an htmx swap.
  • status <code>: returns an explicit HTTP status.
  • file <path> [as <name>] [inline | attachment]: streams a disk file. <path> accepts :param substitution. Default disposition is attachment; as <name> overrides the filename= portion of Content-Disposition. Requires serve-roots in the config block listing allowed directories.

Used in

Examples

Replace a row via htmx

action /users/:id/toggle method POST
  query: UPDATE user SET active = NOT active WHERE id = :id
  respond fragment ".user-row" query: SELECT * FROM user WHERE id = :id

Serve a generated PDF as download

action get /review/:id/pdf
  query: SELECT pdf_path FROM review_job WHERE id = :id
  respond file :pdf_path as relatorio.pdf

Provenance
Spec last touched 18cf488 (2026-05-20)
Source last touched af278bb (2026-05-20)
Source files internal/parser/parser.go