Skip to main content

Crate avatar

Crate avatar 

Source
Expand description

Β§πŸ‘¦ Avatar

Crates.io Crates.io Downloads Crates.io License made-with-rust Rust Maintenance

Open SASS Discord

logo

§🎬 Demo

FrameworkLive Demo
YewNetlify Status
DioxusNetlify Status
LeptosNetlify Status

Β§πŸ“œ Intro

A highly customizable, accessible avatar component for WASM frameworks: Yew, Dioxus, and Leptos. Supports image loading with automatic fallback content, multiple sizes, color themes, and full WCAG compliance.

Β§πŸ€” Why Avatar?

  1. 🎨 Fully Customizable: Control every attribute, class, style, size, color, variant, ARIA labels and more.
  2. πŸ–ΌοΈ Smart Image Loading: Tracks idle β†’ loading β†’ loaded/error status with context. Fallback is shown until the image is ready.
  3. ⏱ Delay Support: Prevent flash-of-fallback on fast connections with delay_ms.
  4. β™Ώ Accessible by Default: role="img", aria-label, aria-hidden wired up automatically.
  5. 🧩 Framework Agnostic: Same API semantics across Yew, Dioxus, and Leptos.

Β§Y Yew Usage

Refer to our guide to integrate this component into your Yew app.

§🧬 Dioxus Usage

Refer to our guide to integrate this component into your Dioxus app.

§🌱 Leptos Usage

Refer to our guide to integrate this component into your Leptos app.

§🀝 Contributions

Contributions are welcome! Whether it’s bug fixes, feature requests, or examples, we would love your help to make Avatar better.

  1. Fork the repository.
  2. Create a new branch for your feature/bugfix.
  3. Submit a pull request for review.

Β§πŸ“œ License

Avatar is licensed under the MIT License. You are free to use, modify, and distribute this library in your projects.

Re-exportsΒ§

pub use common::Color;
pub use common::ImageLoadingStatus;
pub use common::Overlap;
pub use common::Size;
pub use common::Variant;

ModulesΒ§

common
dioxusdio
🧬 Avatar Dioxus Usage
leptoslep
🌱 Avatar Leptos Usage
yewyew
Y Avatar Yew Usage