Base component

Avatar

Theme-aware, responsive avatar component.

18 props0 slots3 outputsTheme readyResponsive

Interactive playground

Configure Avatar

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

Live preview

A polished default avatar for a modern application.

Component code

<Avatar
  statusLabel="Avatar"
  badgeLabel="Avatar"
  description="A polished default avatar for a modern application."
/>

Event outputInteract with the preview to inspect the typed payload.

Live examples

Designed for real product surfaces

Compare configurations and resize the browser to check responsive behavior.

Recommended

Production default

Balanced spacing, hierarchy, and content for the most common product workflow.

Live preview

A polished default avatar for a modern application.

Component usage.wrn

<Avatar
  statusLabel="Avatar"
  badgeLabel="Avatar"
  description="A polished default avatar for a modern application."
/>

Dense UI

Compact application

A tighter variation for dashboards, side panels, tables, and operational interfaces.

Live preview

A compact configuration for dashboards and dense product surfaces.

Component usage.wrn

<Avatar
  size="sm"
  variant="secondary"
  statusLabel="Compact example"
  badgeLabel="Compact example"
  description="A compact configuration for dashboards and dense product surfaces."
/>

Extended

Rich configuration

A more expressive variation using additional data, stronger emphasis, and optional states.

Live preview

A richer configuration demonstrating additional content and hierarchy.

Component usage.wrn

<Avatar
  size="lg"
  variant="success"
  statusLabel="Advanced example"
  badgeLabel="Advanced example"
  description="A richer configuration demonstrating additional content and hierarchy."
/>

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.

@loadFires after remote or deferred content loads successfully.

@errorFires when the component cannot complete an operation.

@clickFires when the interactive surface is activated.

Declarative handlers.wrn

<Avatar
  @load='console.log(payload)'
  @error='console.log(payload)'
  @click='console.log(payload)'
/>

Direct output handlers.js

import { registerOutputHandler } from "@wrnexus/csr/outputs"

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

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

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

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

Component API

Props and configuration

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

Prop	Type	Default	Required
`src`	string	`""`	No
`alt`	string	`""`	No
`initials`	string	`""`	No
`size`	string	`"md"`	No
`color`	string	`"primary"`	No
`variant`	string	`"solid"`	No
`shape`	string	`"circle"`	No
`status`	string	`""`	No
`statusLabel`	string	`""`	No
`statusPosition`	string	`"bottom"`	No
`badge`	string	`""`	No
`badgeIcon`	string	`""`	No
`badgeLabel`	string	`""`	No
`tooltip`	string	`""`	No
`name`	string	`""`	No
`description`	string	`""`	No
`loading`	string	`"lazy"`	No
`class`	string	`""`	No