Avatar
An image element with a fallback for representing the user.
AQ
Installation
Install the following dependencies:
pnpm add @radix-ui/react-avatar
Copy and paste the following code into your project.
"use client";
import * as React from "react";
import * as AvatarPrimitive from "@radix-ui/react-avatar";
import { cn } from "~/utils/tailwind";
const Avatar = React.forwardRef<
React.ElementRef<typeof AvatarPrimitive.Root>,
React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>
>(({ className, ...props }, ref) => (
<AvatarPrimitive.Root
ref={ref}
className={cn(
"relative flex size-10 shrink-0 overflow-hidden rounded-full",
className,
)}
{...props}
/>
));
Avatar.displayName = AvatarPrimitive.Root.displayName;
const AvatarImage = React.forwardRef<
React.ElementRef<typeof AvatarPrimitive.Image>,
React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Image>
>(({ className, ...props }, ref) => (
<AvatarPrimitive.Image
ref={ref}
className={cn("aspect-square size-full", className)}
{...props}
/>
));
AvatarImage.displayName = AvatarPrimitive.Image.displayName;
const AvatarFallback = React.forwardRef<
React.ElementRef<typeof AvatarPrimitive.Fallback>,
React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Fallback>
>(({ className, ...props }, ref) => (
<AvatarPrimitive.Fallback
ref={ref}
className={cn(
"flex size-full items-center justify-center rounded-full bg-muted",
className,
)}
{...props}
/>
));
AvatarFallback.displayName = AvatarPrimitive.Fallback.displayName;
export { Avatar, AvatarImage, AvatarFallback };
Update the import paths to match your project setup.
Usage
import { Avatar, AvatarFallback, AvatarImage } from "~/components/ui/Avatar";
<Avatar>
<AvatarImage src="https://github.com/qiaoandrew.png" alt="@qiaoandrew" />
<AvatarFallback>AQ</AvatarFallback>
</Avatar>
Examples
Fallback
<AvatarFallback>
is rendered while <AvatarImage>
is loading.
AQ
Initials
Remove <AvatarImage>
to display static content, like initials in this case.
AQ
Tooltip
AQ