ReactAvatar
An image with an accessible fallback for a person or team.
Give your AI assistant this page as context.
Connect your library with MCPui/avatarUsage
Get this component from a saved library export or the connected CLI. The imports below refer to local files installed in your app.
Import styles/components.css, then styles/theme.css once. Wrap your app in ThemeScope from components/ui/utils so typography, focus and overlays share the theme. The installation guide covers runtime dependencies and React/Next.js setup.
import { Avatar } from './components/ui/avatar';
<Avatar name="Alex Morgan"/>Design system
This component consumes your semantic colors, spacing, typography and shape tokens. Import the compiled styles and your theme once as described in Export.
Behavior and accessibility
- Provide meaningful labels for interactive controls.
- Connect action callbacks to your application logic.
- Verify keyboard navigation and contrast in your application.
Status: experimental during early access. Sample previews do not send emails, process payments or upload files to a service.
Source and props
This is the exported source, using the same implementation as the editor.
"use client";
import type { ComponentProps, CSSProperties } from "react";
import { Avatar as Base } from "@base-ui/react/avatar";
import { cx } from "./utils";
export function Avatar({
src,
name,
size = 36,
className,
style,
...props
}: Omit<
ComponentProps<typeof Base.Root>,
"className" | "children" | "style"
> & {
src?: string;
name: string;
size?: number;
className?: string;
style?: CSSProperties;
}) {
const initials =
name
.trim()
.split(/\s+/)
.slice(0, 2)
.map((word) => Array.from(word)[0] ?? "")
.join("")
.toLocaleUpperCase() || "?";
return (
<Base.Root
{...props}
className={cx("cr-avatar", className)}
style={{ width: size, height: size, ...style }}
>
<Base.Image src={src} alt={name} className="cr-avatar-image" />
<Base.Fallback role="img" aria-label={name || "Avatar"}>
{initials}
</Base.Fallback>
</Base.Root>
);
}