enes

Avatar

Un Avatar es una representación gráfica de un usuario, equipo o entidad.

Avatar puede mostrar una imagen, un ícono o iniciales, y admite distintos tamaños, formas e indicadores de estado.

Uso

<script>
	import { Avatar } from 'fluentui-svelte';
</script>

<Avatar size={40} name="FluentUI Svelte" />

API del componente

Una breve explicación de las props que realmente necesitan explicación. Puedes ver el resto de las props aquí.

Imagen

Un avatar puede mostrar una imagen. También se recomienda incluir un nombre además de la imagen: las iniciales del nombre se muestran mientras la imagen se carga, y el nombre hace que Avatar sea accesible para los lectores de pantalla.

Ícono

Un avatar puede mostrar un ícono. El ícono solo se mostrará cuando no haya una imagen o iniciales disponibles.

Badge

Un avatar puede tener un badge para indicar el estado de presencia. Consulta el componente PresenceBadge para más información.

Forma

Un avatar puede tener forma cuadrada, circular o redondeada.

Color: colorido

Un avatar puede tener el color elegido automáticamente en función de la prop name, o se puede usar idForColor si no hay un nombre disponible.

Props del componente

NameTypeDescription
namestringEl nombre de la persona o entidad representada por este Avatar. Se usa para determinar las iniciales y para herramientas de accesibilidad.
image{ src: string }La imagen del Avatar. Solo puede ser una única URL de imagen.
refHTMLDivElementLa referencia del DOM del elemento avatar.
sizenumberTamaño del avatar en píxeles.
shapestringLa forma del avatar. Valores posibles: 'circular', 'rounded', 'square'.
colorstringEl color que se usa al mostrar un ícono o iniciales. Admite colores del sistema. Valores posibles: 'information', 'attention', 'warning', 'success', 'critical', 'colorful'.
activestringIndicador opcional de actividad. Valores posibles: 'active', 'inactive'. Active decora el avatar según activeAppearance. Inactive reduce el tamaño y lo hace parcialmente transparente.
activeAppearancestringLa apariencia que se usa cuando active está configurado como active. Valores posibles: 'ring', 'shadow', 'ring-shadow'.
initialsstringIniciales personalizadas. De forma predeterminada, las iniciales se derivan de la prop name usando la función getInitials. Se muestran cuando no hay imagen.
idForColorstringUna cadena que se usa en lugar del nombre para determinar el color cuando color está configurado como colorful. Es útil cuando no hay un nombre disponible pero existe otro identificador único.
iconSnippet | ComponentEl ícono que se muestra cuando el avatar no tiene imagen ni iniciales.
badgeobjectEl badge que se muestra como indicador de estado. Puede incluir un ícono personalizado.