JumarWeb.AvatarComponents (Jumar v0.1.0)

View Source

Provides avatar components for displaying user profile pictures or initials.

Summary

Functions

Renders an avatar image or initials.

Renders a button with an avatar.

Renders an avatar image based on gravatar email address.

Functions

avatar(assigns)

Renders an avatar image or initials.

This component displays a circular or square avatar. It can show an image from a given src URL, or display initials if no src is provided.

Examples

<.avatar src="/images/user.png" alt="User avatar" />
<.avatar initials="BTK" />
<.avatar src="/images/user.png" square />

Attributes

  • src (:string) - Defaults to nil.
  • square (:boolean) - Defaults to false.
  • initials (:string) - Defaults to nil.
  • alt (:string) - Defaults to "".
  • class (:string) - Defaults to nil.
  • Global attributes are accepted.

avatar_button(assigns)

Renders a button with an avatar.

This component can be used as a button or a link, wrapping an avatar. It's useful for profile buttons that open a dropdown menu, for example.

Examples

<.avatar_button src="/images/user.png" alt="User avatar" />
<.avatar_button initials="BTK" navigate={~p"/profile"} />

Attributes

  • src (:string) - Defaults to nil.
  • square (:boolean) - Defaults to false.
  • initials (:string) - Defaults to nil.
  • alt (:string) - Defaults to "".
  • class (:string) - Defaults to nil.
  • Global attributes are accepted. Supports all globals plus: ["href", "navigate", "patch", "method"].

gravatar(assigns)

Renders an avatar image based on gravatar email address.

This component displays a circular or square avatar.

Examples

<.gravatar email="test@example.com" />

Attributes

  • email (:string) (required)
  • size (:string) - Defaults to "64".
  • square (:boolean) - Defaults to false.
  • class (:string) - Defaults to nil.
  • Global attributes are accepted.