Skip to content

AvatarImage

Le composant AvatarImage affiche une image d’avatar avec différentes tailles, un arrondi optionnel et un anneau coloré autour de l’image. Il utilise getBoxSize et getRingColor pour générer automatiquement les classes liées à la taille et à la couleur de l’anneau.


Props

PropTypeDefaultDescription
sizeString'md'Définit la taille de l’avatar (xs, sm, md, lg, xl).
srcStringundefinedChemin de l’image affichée.
altString'Avatar'Texte alternatif de l’image.
roundedFullBooleanfalseSi true, applique un arrondi complet (rounded-full).
ringBooleanfalseActive l’anneau autour de l’image (ring-2).
ringVariantString'neutral'Détermine la couleur de l’anneau (via getRingColor).

Tailles disponibles

TailleDescription
xsTrès petit avatar
smPetit
mdMoyen (par défaut)
lgLarge
xlTrès large

Les classes de dimensions (width, height) sont générées via getBoxSize.


Génération dynamique

  • getBoxSize(size) : retourne les classes Tailwind correspondant à la largeur et à la hauteur de l’avatar.
  • getRingColor(ringVariant) : génère les classes de couleur prêtes pour l’anneau (ring-primary, ring-success, etc.).

Les classes générées se combinent automatiquement avec les classes statiques du composant.


Exemple d'utilisation

Avatar image par défaut

vue
<AvatarImage src="/users/john.png" />

Avatar avec taille personnalisée

vue
<AvatarImage src="/img/hero.png" size="lg" />

Avatar arrondi complet

vue
<AvatarImage src="/img/profile.jpg" roundedFull />

Avatar avec anneau coloré

vue
<AvatarImage src="/img/user.png" ring ringVariant="primary" />

Avatar avec tous les paramètres

vue
<AvatarImage size="xl" src="/img/user.png" ring ringVariant="success" roundedFull />

Fonctionnement interne

  • sizeClasses Généré via getBoxSize(props.size) et appliqué directement à l’image.

  • roundedClass Ajoute soit rounded-full, soit rounded-sm selon la prop roundedFull.

  • ringClass & ringColor

    • ringClass ajoute ring-2 lorsque ring = true.
    • ringColor provient de getRingColor(ringVariant) pour la couleur du contour.