// Generated by scripts/generate-showcase.mjs. Do not edit directly. page ButtonDetail { layout = "showcase" state playground_label = ctx.url.searchParams.get("pg_label") ?? "Save & Submit" state playground_loadingLabel = ctx.url.searchParams.get("pg_loadingLabel") ?? "Loading…" state playground_description = ctx.url.searchParams.get("pg_description") ?? "" state playground_as = ctx.url.searchParams.get("pg_as") ?? "button" state playground_href = ctx.url.searchParams.get("pg_href") ?? "" state playground_target = ctx.url.searchParams.get("pg_target") ?? "" state playground_rel = ctx.url.searchParams.get("pg_rel") ?? "" state playground_type = ctx.url.searchParams.get("pg_type") ?? "submit" state playground_variant = ctx.url.searchParams.get("pg_variant") ?? "default" state playground_color = ctx.url.searchParams.get("pg_color") ?? "primary" state playground_size = ctx.url.searchParams.get("pg_size") ?? "default" state playground_disabled = (ctx.url.searchParams.get("pg_disabled") ?? "false") === "true" state playground_loading = (ctx.url.searchParams.get("pg_loading") ?? "false") === "true" state playground_pill = (ctx.url.searchParams.get("pg_pill") ?? "false") === "true" state playground_fullWidth = (ctx.url.searchParams.get("pg_fullWidth") ?? "false") === "true" state playground_icon = ctx.url.searchParams.get("pg_icon") ?? "" state playground_iconPosition = ctx.url.searchParams.get("pg_iconPosition") ?? "start" state playground_ariaLabel = ctx.url.searchParams.get("pg_ariaLabel") ?? "" state playground_ariaPressed = ctx.url.searchParams.get("pg_ariaPressed") ?? "" state playground_ariaExpanded = ctx.url.searchParams.get("pg_ariaExpanded") ?? "" state playground_ariaControls = ctx.url.searchParams.get("pg_ariaControls") ?? "" state playground_title = ctx.url.searchParams.get("pg_title") ?? "" state playground_autofocus = (ctx.url.searchParams.get("pg_autofocus") ?? "false") === "true" state playground_controlClass = ctx.url.searchParams.get("pg_controlClass") ?? "" state playground_class = ctx.url.searchParams.get("pg_class") ?? "showcase-instance showcase-instance--1" seo { title = "Button" description = "Theme-aware, responsive button component." } view {
Base component

Button

Theme-aware, responsive button component.

25 props1 slots3 outputsTheme readyResponsive
Interactive playground

Configure Button

Change any prop and inspect the server-rendered component immediately.

Live preview
Component code
<Button
  label="Save & Submit"
  as="button"
  type="submit"
/>
Event outputInteract with the preview to inspect the typed payload.
Component props25 controls
Live examples

Designed for real product surfaces

Compare configurations and resize the browser to check responsive behavior.

Default

Primary action

The standard high-emphasis action for forms and product workflows.

01
Live preview
Component usage.wrn
<Button
  label="Save & Submit"
  as="button"
  type="submit"
/>
Outline · Small

Secondary navigation

A compact link button with an end icon and restrained emphasis.

02
Live preview
Component usage.wrn
<Button
  label="Learn more"
  as="a"
  href="#button-demo"
  variant="outline"
  size="sm"
  icon="icon-[lucide--arrow-right]"
  iconPosition="end"
/>
Secondary · Large · Pill

Prominent rounded action

A large secondary action using the optional pill shape.

03
Live preview
Component usage.wrn
<Button
  label="Upgrade plan"
  as="button"
  variant="secondary"
  size="lg"
  pill="true"
/>
Ghost · Icon

Accessible icon action

An icon-only control with its accessible name supplied through props.

04
Live preview
Component usage.wrn
<Button
  label="Open settings"
  as="button"
  variant="ghost"
  size="icon"
  icon="icon-[lucide--settings]"
  ariaLabel="Open settings"
/>
Destructive

Dangerous action

A destructive treatment for irreversible or high-risk operations.

05
Live preview
Component usage.wrn
<Button
  label="Delete project"
  as="button"
  variant="destructive"
  icon="icon-[lucide--trash-2]"
/>
Link

Inline action

A low-chrome action that behaves and reads like an inline link.

06
Live preview
Component usage.wrn
<Button
  label="Read documentation"
  as="a"
  href="#button-demo"
  variant="link"
/>
Loading

Pending action

The button owns its busy state, loading label, spinner, and disabled behavior.

07
Live preview
Component usage.wrn
<Button
  label="Publish"
  loadingLabel="Publishing…"
  as="button"
  loading="true"
/>
Disabled

Unavailable action

A visibly and semantically disabled control.

08
Live preview
Component usage.wrn
<Button
  label="Unavailable action"
  as="button"
  variant="outline"
  disabled="true"
/>
Component outputs

Receive every typed component output

Use declarative output handlers in .wrn files or register a direct output handler from JavaScript. The canonical API exposes payload and does not require event.detail.

@clickFires when the interactive surface is activated.
@focusFires when the interactive control receives focus.
@blurFires when focus leaves the interactive control.
Declarative handlers.wrn
<Button
  @click='console.log(payload)'
  @focus='console.log(payload)'
  @blur='console.log(payload)'
/>
Direct output handlers.js
import { registerOutputHandler } from "@wrnexus/csr/outputs"

const component = document.querySelector("[data-ui-component=\"Button\"], [data-component=\"Button\"]")

if (component) registerOutputHandler(component, "click", (payload) => {
  console.log("click", payload)
})

if (component) registerOutputHandler(component, "focus", (payload) => {
  console.log("focus", payload)
})

if (component) registerOutputHandler(component, "blur", (payload) => {
  console.log("blur", payload)
})
Component API

Props and configuration

All content and behavior shown above is supplied through these props and slots.

PropTypeDefaultRequired
labelstring"Button"No
loadingLabelstring"Loading…"No
descriptionstring""No
asstring""No
hrefstring""No
targetstring""No
relstring""No
typestring"button"No
variantstring"default"No
colorstring"primary"No
sizestring"default"No
disabledbooleanfalseNo
loadingbooleanfalseNo
pillbooleanfalseNo
fullWidthbooleanfalseNo
iconstring""No
iconPositionstring"start"No
ariaLabelstring""No
ariaPressedstring""No
ariaExpandedstring""No
ariaControlsstring""No
titlestring""No
autofocusbooleanfalseNo
controlClassstring""No
classstring""No
} }