n-avatar

Render and manage user avatars in Naive UI applications.

8|3|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/jiaiyan/naive-ui-skills --skill n-avatar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: n-avatar
Source: https://github.com/jiaiyan/naive-ui-skills/tree/main/components/n-avatar
Command: npx skills add https://github.com/jiaiyan/naive-ui-skills --skill n-avatar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Avatar rendering and management for user profiles, teams, and content requiring recognizable identity across UI.

Core Features & Use Cases

  • Multiple Sizes: small, medium, large, or custom pixel size
  • Shape Options: square or round
  • Image & Fallback: load from src with optional fallback-src
  • Lazy Loading & Groups: lazy loading and avatar groups with max display
  • Color & Icon Content: support for text, icons, and color customization

Quick Start

Instantiate an avatar component with a URL and optional round shape to display a user image.

Frequently Asked Questions about n-avatar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render user avatars with fallback images in Vue?

To render user avatars in Vue, you can use a UI component that supports a primary src and an optional fallback-src to display placeholder images if the original fails to load.

Can I display an avatar group with a maximum limit in Naive UI?

Yes, you can display avatar groups in Naive UI with a maximum display limit. This feature handles overflow by showing a set number of avatars and indicating remaining members.

How does lazy loading work for avatar components?

Lazy loading for avatar components defers image loading until the element enters the viewport, optimizing page performance by avoiding unnecessary network requests for off-screen images.

How do I customize avatar shapes and sizes for a user profile?

You can customize avatar shapes and sizes by configuring round or square options and selecting small, medium, large, or custom pixel dimensions to fit your profile layout.

What can I display inside an avatar if the user image is missing?

If the user image is missing, you can display text initials, icons, or color-customized content within the avatar using built-in slots and styling properties.

Does this avatar component support object-fit for responsive images?

Yes, the avatar component supports object-fit properties, ensuring profile images maintain their aspect ratio and scale correctly within dynamic container sizes.