Package 'htmxr'

Title: Build Modern Web Applications with 'htmx' and 'plumber2'
Description: A lightweight framework for building server-driven web applications in 'R'. 'htmxr' combines the simplicity of 'htmx' for partial page updates with the power of 'plumber2' for non-blocking HTTP endpoints. Build interactive dashboards and data applications without writing 'JavaScript', using familiar 'R' patterns inspired by 'Shiny'. For more information on 'htmx', see <https://htmx.org>.
Authors: Arthur Bréant [aut, cre]
Maintainer: Arthur Bréant <[email protected]>
License: MIT + file LICENSE
Version: 0.3.1
Built: 2026-10-09 10:59:50 UTC
Source: https://github.com/hyperverse-r/htmxr

Help Index

The htmx serializer

Description

htmxr registers a plumber2 serializer named htmx, which sends any htmltools object as text/html. Use it on every route that returns markup built with htmxr, whether that is a full page or a fragment:

Details

#* @get /rows
#* @serializer htmx
function(query) {
  hx_table_rows(diamonds, columns = c("cut", "price"))
}

The serializer plumber2 ships as html only understands a bare string or a single htmltools::tags element. A tagList — what hx_table_rows() and most fragment helpers return — matches neither, so it falls through to plumber2's XML branch and is sent as unusable markup, with a 200 status and no error. Reaching for ⁠@serializer none⁠ sidesteps that, but labels the response text/plain.

htmx handles both, and always sets text/html:

  • tagList and single tags (as returned by hx_page(), hx_table_rows())

  • strings marked with htmltools::HTML()

  • plain character vectors, concatenated as-is

  • NULL, sent as an empty body — useful for a swap that clears its target

Anything else is an error rather than malformed markup. Content that is not htmltools output — an SVG device string, JSON — belongs on the matching plumber2 serializer instead.

The serializer is registered when htmxr is loaded, so library(htmxr) at the top of your API file is enough to make ⁠@serializer htmx⁠ resolve.

See Also

hx_table_rows(), hx_page()

Button element

Description

Creates a ⁠<button>⁠ element with optional htmx attributes.

Usage

hx_button(
  id,
  label = NULL,
  class = NULL,
  get = NULL,
  post = NULL,
  put = NULL,
  patch = NULL,
  delete = NULL,
  target = NULL,
  swap = NULL,
  trigger = NULL,
  indicator = NULL,
  swap_oob = NULL,
  confirm = NULL,
  params = NULL,
  include = NULL,
  push_url = NULL,
  select = NULL,
  vals = NULL,
  encoding = NULL,
  headers = NULL,
  ...
)

Arguments

id

Element id.
label

Button label (text or HTML content). Pass NULL for icon-only buttons — in that case supply an aria-label via ....
class

Optional CSS class(es).
get

URL for hx-get.
post

URL for hx-post.
put

URL for hx-put.
patch

URL for hx-patch.
delete

URL for hx-delete. Note: parameters are sent in the URL query string (not the request body) — read them via the injected query argument (e.g. function(query) query$id) or via request$query if you are using the full request object in your route.
target

CSS selector for hx-target.
swap

Swap strategy for hx-swap.
trigger

Trigger specification for hx-trigger.
indicator

CSS selector for hx-indicator.
swap_oob

Out-of-band swap targets for hx-swap-oob.
confirm

Confirmation message for hx-confirm.
params

Parameters to submit for hx-params. Use "*" to include all parameters (equivalent to omitting this argument), "none" to send none, or a comma-separated list of names (e.g. "id, name"). Prefix with not to exclude specific parameters (e.g. "not id, name").
include

CSS selector for hx-include. Additional elements whose values are included in the request. htmx relative selectors are valid: "closest form", "find input", "next .sibling". Note: params = "none" does not suppress values sourced via include.
push_url

Push a URL into the browser history for hx-push-url. Use "true" to push the request URL, "false" to disable, or a custom URL.
select

CSS selector for hx-select. Extracts a specific element from the server response before swapping (e.g. "#data-table").
vals

JSON string of extra values to include in the request for hx-vals (e.g. '{"id": 42}'). Values are passed as-is. Avoid ⁠js:⁠ expressions with HTML-special characters — htmltools will escape them.
encoding

Encoding type for hx-encoding. Use "multipart/form-data" to enable file uploads.
headers

JSON string of request headers for hx-headers (e.g. '{"X-Custom-Header": "value"}'). Values are passed as-is. Do not embed sensitive tokens in HTML attributes.
...

Additional HTML attributes passed to the ⁠<button>⁠ element.

Value

An htmltools::tags object.

Examples

# Simple button
hx_button("btn1", "Click me")

# Button with htmx GET request
hx_button("load-btn", "Load data", get = "/api/data", target = "#result")

# Button with confirmation
hx_button("del-btn", "Delete", post = "/api/delete", confirm = "Are you sure?")

Specify additional head elements for an htmxr page

Description

Wraps tags to be included in the page head when passed to hx_page().

Usage

hx_head(..., title = "htmxr page")

Arguments

...

tags to include in the head (stylesheets, scripts, meta, etc.)
title

page title

Value

A list with class hx_head, to be passed to hx_page().

Examples

hx_head(title = "My app")

hx_head(
  title = "My app",
  tags$link(rel = "stylesheet", href = "/style.css")
)

Detect if a request comes from htmx

Description

Checks whether the incoming HTTP request was made by htmx by inspecting the HX-Request header. htmx sends this header with every AJAX request.

Usage

hx_is_htmx(request)

Arguments

request

A request object, typically the request argument of a plumber2 handler. Objects exposing a get_header() accessor (such as plumber2 / reqres requests) are queried through it; otherwise the headers element is used — a named list or character vector of HTTP headers.

Details

plumber2 requests are reqres::Request objects, which normalise header names to lowercase snake_case: request$headers holds hx_request, never hx-request. Their get_header() accessor handles that normalisation itself and accepts the original HTTP name, so it is used whenever it is available. When falling back to headers — for hand-built lists in tests and examples — both hx-request and hx_request are accepted.

Value

TRUE if the request was made by htmx, FALSE otherwise.

Examples

# Simulated htmx request
req <- list(headers = list(`hx-request` = "true"))
hx_is_htmx(req)

# Same request with the plumber2 header naming convention
req <- list(headers = list(hx_request = "true"))
hx_is_htmx(req)

# Regular request
req <- list(headers = list())
hx_is_htmx(req)

Generate a complete HTML page with htmx

Description

Generate a complete HTML page with htmx

Usage

hx_page(..., lang = "en", html_attrs = list())

Arguments

...

page content. Use hx_head() to add elements to the head.
lang

language code for the ⁠<html>⁠ element (default "en").
html_attrs

a named list of additional attributes to set on the ⁠<html>⁠ element (e.g. list("data-theme" = "cupcake") for DaisyUI).

Value

A length-one character string containing the full HTML document (including ⁠<!DOCTYPE html>⁠), ready to be served as an HTTP response.

Examples

hx_page(tags$h1("Hello, htmxr!"))

hx_page(
  hx_head(title = "My app"),
  tags$p("Hello, world!")
)

Run an htmxr example

Description

Launches an example API that demonstrates htmxr features. Call hx_run_example() without arguments to list available examples.

Usage

hx_run_example(example = NULL, port = 8080)

Arguments

example

name of the example to run. If NULL, lists available examples.
port

port to run the API on.

Value

Called for side effects. When example is NULL, returns the available example names invisibly. Otherwise does not return (the server blocks).

Examples

hx_run_example() # list available examples
if (interactive()) {
  hx_run_example("hello") # run the hello example
}

Select input

Description

Creates a ⁠<select>⁠ element with optional htmx attributes. When label is provided, the input is wrapped in a ⁠<div>⁠ containing a ⁠<label>⁠ element linked via the for attribute.

Usage

hx_select_input(
  id,
  label = NULL,
  choices,
  selected = NULL,
  multiple = FALSE,
  name = id,
  class = NULL,
  get = NULL,
  post = NULL,
  put = NULL,
  patch = NULL,
  delete = NULL,
  target = NULL,
  swap = NULL,
  trigger = NULL,
  indicator = NULL,
  swap_oob = NULL,
  confirm = NULL,
  params = NULL,
  include = NULL,
  push_url = NULL,
  select = NULL,
  vals = NULL,
  encoding = NULL,
  headers = NULL,
  ...
)

Arguments

id

Element id. Also used as name by default.
label

Optional label text. When provided, the input is wrapped in a ⁠<div>⁠ with a ⁠<label>⁠.
choices

Named or unnamed character vector of choices. If unnamed, values are used as labels. If named, names are used as labels and values as option values (same convention as Shiny).
selected

Optional value(s) to pre-select.
multiple

Logical. If TRUE, adds the multiple attribute to allow multi-selection.
name

Form field name. Defaults to id.
class

Optional CSS class(es) for the ⁠<select>⁠ element.
get

URL for hx-get.
post

URL for hx-post.
put

URL for hx-put.
patch

URL for hx-patch.
delete

URL for hx-delete. Note: parameters are sent in the URL query string (not the request body) — read them via the injected query argument (e.g. function(query) query$id) or via request$query if you are using the full request object in your route.
target

CSS selector for hx-target.
swap

Swap strategy for hx-swap.
trigger

Trigger specification for hx-trigger.
indicator

CSS selector for hx-indicator.
swap_oob

Out-of-band swap targets for hx-swap-oob.
confirm

Confirmation message for hx-confirm.
params

Parameters to submit for hx-params. Use "*" to include all parameters (equivalent to omitting this argument), "none" to send none, or a comma-separated list of names (e.g. "id, name"). Prefix with not to exclude specific parameters (e.g. "not id, name").
include

CSS selector for hx-include. Additional elements whose values are included in the request. htmx relative selectors are valid: "closest form", "find input", "next .sibling". Note: params = "none" does not suppress values sourced via include.
push_url

Push a URL into the browser history for hx-push-url. Use "true" to push the request URL, "false" to disable, or a custom URL.
select

CSS selector for hx-select. Extracts a specific element from the server response before swapping (e.g. "#data-table").
vals

JSON string of extra values to include in the request for hx-vals (e.g. '{"id": 42}'). Values are passed as-is. Avoid ⁠js:⁠ expressions with HTML-special characters — htmltools will escape them.
encoding

Encoding type for hx-encoding. Use "multipart/form-data" to enable file uploads.
headers

JSON string of request headers for hx-headers (e.g. '{"X-Custom-Header": "value"}'). Values are passed as-is. Do not embed sensitive tokens in HTML attributes.
...

Additional HTML attributes passed to the ⁠<select>⁠ element.

Value

An htmltools::tags object.

Examples

# Simple select without label
hx_select_input("cut", choices = c("Fair", "Good", "Ideal"))

# Select with label and named choices
hx_select_input(
  "cut",
  label = "Filter by cut:",
  choices = c("All" = "all", "Fair", "Good", "Ideal"),
  selected = "all"
)

# Select with htmx attributes
hx_select_input(
  "cut",
  label = "Filter by cut:",
  choices = c("All" = "all", "Fair", "Good"),
  get = "/rows",
  trigger = "change",
  target = "#tbody"
)

Serve htmxr static assets

Description

Configures a plumber2 API to serve htmxr's static assets (htmx JavaScript library) at ⁠/htmxr/assets/⁠.

Usage

hx_serve_assets(api)

Arguments

api

a plumber2 API object

Value

the API object (modified, for piping)

Examples

plumber2::api() |>
  hx_serve_assets()

Add htmx attributes to any HTML tag

Description

A generic modifier that appends htmx attributes to an existing htmltools::tags object. Works with any HTML element.

Usage

hx_set(
  tag,
  get = NULL,
  post = NULL,
  put = NULL,
  patch = NULL,
  delete = NULL,
  target = NULL,
  swap = NULL,
  trigger = NULL,
  indicator = NULL,
  swap_oob = NULL,
  confirm = NULL,
  params = NULL,
  include = NULL,
  push_url = NULL,
  select = NULL,
  vals = NULL,
  encoding = NULL,
  headers = NULL,
  ...
)

Arguments

tag

An htmltools::tags object to modify.
get

URL for hx-get.
post

URL for hx-post.
put

URL for hx-put.
patch

URL for hx-patch.
delete

URL for hx-delete. Note: parameters are sent in the URL query string (not the request body) — read them via the injected query argument (e.g. function(query) query$id) or via request$query if you are using the full request object in your route.
target

CSS selector for hx-target.
swap

Swap strategy for hx-swap.
trigger

Trigger specification for hx-trigger.
indicator

CSS selector for hx-indicator.
swap_oob

Out-of-band swap targets for hx-swap-oob.
confirm

Confirmation message for hx-confirm.
params

Parameters to submit for hx-params. Use "*" to include all parameters (equivalent to omitting this argument), "none" to send none, or a comma-separated list of names (e.g. "id, name"). Prefix with not to exclude specific parameters (e.g. "not id, name").
include

CSS selector for hx-include. Additional elements whose values are included in the request. htmx relative selectors are valid: "closest form", "find input", "next .sibling", "previous .sibling". Note: params = "none" does not suppress values sourced via include — the two operate independently.
push_url

Push a URL into the browser history for hx-push-url. Use "true" to push the request URL, "false" to disable (e.g. to override inheritance), or a custom URL string.
select

CSS selector for hx-select. Extracts a specific element from the server response before swapping — useful when the server returns a full HTML page but only a fragment is needed (e.g. "#data-table").
vals

JSON string of extra values to include in the request for hx-vals (e.g. '{"id": 42}'). Values are passed as-is — no serialisation is performed. The ⁠js:⁠ prefix for dynamic expressions is supported by htmx but expressions containing HTML-special characters (<, >, &, ⁠"⁠) will be escaped by htmltools and silently corrupted at runtime — avoid them or use DOM-based lookups instead.
encoding

Encoding type for hx-encoding. Use "multipart/form-data" to enable file uploads via ⁠<input type="file">⁠.
headers

JSON string of request headers for hx-headers (e.g. '{"X-Custom-Header": "value"}'). Values are passed as-is. Do not embed sensitive tokens (auth headers, API keys) in HTML attributes — they are readable by any script on the page.
...

Additional htmx attributes passed as-is (e.g. `hx-disabled-elt` = "this", `hx-prompt` = "Raison ?"). All arguments must be named. Names must start with ⁠hx-⁠ or ⁠data-hx-⁠ — a warning is emitted otherwise. Values are passed without transformation: use "true"/"false" (not TRUE/FALSE) for boolean htmx attributes, and pre-serialized JSON strings for hx-vals or hx-headers.

Value

The input tag with htmx attributes appended.

Examples

tags$div(id = "plot") |>
  hx_set(get = "/plot", trigger = "load", target = "#plot", swap = "innerHTML")

hx_set(
  tags$div(id = "result", class = "container"),
  get = "/data",
  trigger = "load"
)

Slider input

Description

Creates an ⁠<input type="range">⁠ element with optional htmx attributes. When label is provided, the input is wrapped in a ⁠<div>⁠ containing a ⁠<label>⁠ element linked via the for attribute.

Usage

hx_slider_input(
  id,
  label = NULL,
  value = 50,
  min = 0,
  max = 100,
  step = 1,
  name = id,
  class = NULL,
  get = NULL,
  post = NULL,
  put = NULL,
  patch = NULL,
  delete = NULL,
  target = NULL,
  swap = NULL,
  trigger = NULL,
  indicator = NULL,
  swap_oob = NULL,
  confirm = NULL,
  params = NULL,
  include = NULL,
  push_url = NULL,
  select = NULL,
  vals = NULL,
  encoding = NULL,
  headers = NULL,
  ...
)

Arguments

id

Element id. Also used as name by default.
label

Optional label text. When provided, the input is wrapped in a ⁠<div>⁠ with a ⁠<label>⁠.
value

Initial value (default 50).
min

Minimum value (default 0).
max

Maximum value (default 100).
step

Step increment (default 1).
name

Form field name. Defaults to id.
class

Optional CSS class(es) for the ⁠<input>⁠ element.
get

URL for hx-get.
post

URL for hx-post.
put

URL for hx-put.
patch

URL for hx-patch.
delete

URL for hx-delete. Note: parameters are sent in the URL query string (not the request body) — read them via the injected query argument (e.g. function(query) query$id) or via request$query if you are using the full request object in your route.
target

CSS selector for hx-target.
swap

Swap strategy for hx-swap.
trigger

Trigger specification for hx-trigger.
indicator

CSS selector for hx-indicator.
swap_oob

Out-of-band swap targets for hx-swap-oob.
confirm

Confirmation message for hx-confirm.
params

Parameters to submit for hx-params. Use "*" to include all parameters (equivalent to omitting this argument), "none" to send none, or a comma-separated list of names (e.g. "id, name"). Prefix with not to exclude specific parameters (e.g. "not id, name").
include

CSS selector for hx-include. Additional elements whose values are included in the request. htmx relative selectors are valid: "closest form", "find input", "next .sibling". Note: params = "none" does not suppress values sourced via include.
push_url

Push a URL into the browser history for hx-push-url. Use "true" to push the request URL, "false" to disable, or a custom URL.
select

CSS selector for hx-select. Extracts a specific element from the server response before swapping (e.g. "#data-table").
vals

JSON string of extra values to include in the request for hx-vals (e.g. '{"id": 42}'). Values are passed as-is. Avoid ⁠js:⁠ expressions with HTML-special characters — htmltools will escape them.
encoding

Encoding type for hx-encoding. Use "multipart/form-data" to enable file uploads.
headers

JSON string of request headers for hx-headers (e.g. '{"X-Custom-Header": "value"}'). Values are passed as-is. Do not embed sensitive tokens in HTML attributes.
...

Additional HTML attributes passed to the ⁠<input>⁠ element.

Value

An htmltools::tags object.

Examples

# Simple slider
hx_slider_input("bins", label = "Number of bins:", min = 1, max = 50)

# Slider with htmx attributes
hx_slider_input(
  "bins",
  label = "Number of bins:",
  value = 30, min = 1, max = 50,
  get = "/plot",
  trigger = "input changed delay:300ms",
  target = "#plot"
)

Table with htmx-powered tbody

Description

Builds a complete ⁠<table>⁠ element with a ⁠<thead>⁠ and a ⁠<tbody>⁠. htmx attributes are applied to the ⁠<tbody>⁠, making it the swap target. When data is NULL (the default), the ⁠<tbody>⁠ is empty and its content is loaded lazily via htmx (e.g. trigger = "load").

Usage

hx_table(
  columns,
  data = NULL,
  tbody_id = NULL,
  col_labels = NULL,
  col_classes = NULL,
  class = NULL,
  thead_class = NULL,
  get = NULL,
  post = NULL,
  put = NULL,
  patch = NULL,
  delete = NULL,
  target = NULL,
  swap = NULL,
  trigger = NULL,
  indicator = NULL,
  swap_oob = NULL,
  confirm = NULL,
  params = NULL,
  include = NULL,
  push_url = NULL,
  select = NULL,
  vals = NULL,
  encoding = NULL,
  headers = NULL,
  ...
)

Arguments

columns

Character vector of column names to display. Defines the ⁠<thead>⁠ structure (required).
data

Optional data frame. If provided, rows are rendered in the ⁠<tbody>⁠ via hx_table_rows(). If NULL, the ⁠<tbody>⁠ is empty.
tbody_id

id attribute applied to the ⁠<tbody>⁠ — not the ⁠<table>⁠.
col_labels

Labels for the ⁠<thead>⁠. If NULL, column names are used as-is. Can be a named vector (c(price = "Price ($)")) to override specific columns, or an unnamed positional vector to replace all labels.
col_classes

Named list of CSS classes for ⁠<td>⁠ cells, passed to hx_table_rows() when data is provided.
class

CSS class(es) for the ⁠<table>⁠ element.
thead_class

CSS class(es) for the ⁠<thead>⁠ element.
get

URL for hx-get (applied to ⁠<tbody>⁠).
post

URL for hx-post (applied to ⁠<tbody>⁠).
put

URL for hx-put (applied to ⁠<tbody>⁠).
patch

URL for hx-patch (applied to ⁠<tbody>⁠).
delete

URL for hx-delete (applied to ⁠<tbody>⁠). Note: parameters are sent in the URL query string — read them via the injected query argument (e.g. function(query) query$id) or via request$query if you are using the full request object in your route.
target

CSS selector for hx-target (applied to ⁠<tbody>⁠).
swap

Swap strategy for hx-swap (applied to ⁠<tbody>⁠).
trigger

Trigger specification for hx-trigger (applied to ⁠<tbody>⁠).
indicator

CSS selector for hx-indicator (applied to ⁠<tbody>⁠).
swap_oob

Out-of-band swap targets for hx-swap-oob (applied to ⁠<tbody>⁠).
confirm

Confirmation message for hx-confirm (applied to ⁠<tbody>⁠).
params

Parameters to submit for hx-params. Use "*" to include all parameters (equivalent to omitting this argument), "none" to send none, or a comma-separated list of names (e.g. "id, name"). Prefix with not to exclude specific parameters (e.g. "not id, name").
include

CSS selector for hx-include. Additional elements whose values are included in the request. htmx relative selectors are valid: "closest form", "find input", "next .sibling". Note: params = "none" does not suppress values sourced via include.
push_url

Push a URL into the browser history for hx-push-url (applied to ⁠<tbody>⁠). Use "true", "false", or a custom URL.
select

CSS selector for hx-select (applied to ⁠<tbody>⁠). Extracts a specific element from the server response before swapping.
vals

JSON string of extra values for hx-vals (applied to ⁠<tbody>⁠). Values are passed as-is (e.g. '{"id": 42}'). Avoid ⁠js:⁠ expressions with HTML-special characters — htmltools will escape them.
encoding

Encoding type for hx-encoding (applied to ⁠<tbody>⁠). Use "multipart/form-data" to enable file uploads.
headers

JSON string of request headers for hx-headers (applied to ⁠<tbody>⁠). Values are passed as-is. Do not embed sensitive tokens in HTML attributes.
...

Additional HTML attributes passed to the ⁠<table>⁠ element.

Value

An htmltools::tags object (⁠<table>⁠).

Examples

# Lazy-load table (empty tbody, content loaded on trigger)
hx_table(
  columns = c("cut", "color", "price"),
  col_labels = c("Cut", "Color", "Price"),
  tbody_id = "tbody",
  get = "/rows",
  trigger = "load",
  swap = "innerHTML"
)

# Table with data pre-rendered
df <- data.frame(cut = c("Fair", "Good"), price = c(326L, 400L))
hx_table(columns = c("cut", "price"), data = df)

Table rows fragment

Description

Converts a data frame into a tagList of ⁠<tr>⁠ elements, one per row. Designed to be used as a fragment endpoint response — the output replaces a ⁠<tbody>⁠ via htmx swap.

Usage

hx_table_rows(data, columns = NULL, col_classes = NULL)

Arguments

data

A data frame.
columns

Character vector of column names to include (and their order). If NULL, all columns are used.
col_classes

Named list of CSS classes to add to ⁠<td>⁠ elements, keyed by column name. Example: list(price = "text-end fw-bold").

Value

A htmltools::tagList of ⁠<tr>⁠ tags.

Serving the fragment

Annotate the route with ⁠@serializer htmx⁠. plumber2's own html serializer does not understand a tagList and would send unusable markup. See htmx-serializer.

See Also

htmx-serializer

Examples

df <- data.frame(cut = c("Fair", "Good"), price = c(326L, 400L))
hx_table_rows(df, columns = c("cut", "price"))

# With CSS classes on specific columns
hx_table_rows(df, col_classes = list(price = "text-end fw-bold"))

Trigger client-side htmx events via response headers

Description

Adds an HX-Trigger, HX-Trigger-After-Swap, or HX-Trigger-After-Settle header to a plumber2 response, causing htmx to fire one or more client-side events after the response is received.

Usage

hx_trigger(response, event)

hx_trigger_after_swap(response, event)

hx_trigger_after_settle(response, event)

Arguments

response

A plumber2 response object. The parameter must be named response in route handlers — it is the only name plumber2 recognises for injecting the response object.
event

One of:

  • A character string — fires a single event: "myEvent".

  • A character vector — fires multiple events: c("event1", "event2").

  • A named list — fires events with detail payloads: list(showMessage = list(level = "info"), confetti = NULL). Each name is an event; each value is its detail (use NULL for no detail).

Details

Timing variants

  • hx_trigger() — fires immediately when the response is received (HX-Trigger).

  • hx_trigger_after_swap() — fires after htmx swaps the new content into the DOM (HX-Trigger-After-Swap). Use this when the event handler needs to interact with the freshly-swapped elements.

  • hx_trigger_after_settle() — fires after htmx settles (CSS transitions complete) (HX-Trigger-After-Settle).

Detail serialisation

When event is a named list, values are serialised to JSON using a minimal built-in serialiser that supports NULL, logicals, numbers, strings, and named lists of the above. No external dependency required.

Value

The response object response, invisibly.

Examples

## Not run: 
#* @post /submit
function(response) {
  # Simple event
  hx_trigger(response, "formSubmitted")

  # Multiple events
  hx_trigger(response, c("formSubmitted", "refresh"))

  # Event with detail payload
  hx_trigger(response, list(showMessage = list(level = "info", text = "Saved!")))

  list(status = "ok")
}

## End(Not run)