跳转到内容

Avatar API

想要学习更多组件属性和 CSS API,可以查阅 React Avatar 组件的 API 文档。

导入

import Avatar from '@mui/material/Avatar';
// 或
import { Avatar } from '@mui/material';
你可以阅读这个关于最小化捆绑包的指南以了解以上二者的差异。

组件名称

在主题中,名称“MuiAvatar”可用于提供默认属性(props),或者样式覆盖

属性

原生(Native) 组件的属性也是可用的。

名称类型默认值描述
altstring
Used in combination with src or srcSet to provide an alt attribute for the rendered img element.
childrennode
Used to render icon or text elements inside the Avatar if src is not set. This can be an element, or just a string.
classesobject
Override or extend the styles applied to the component. See CSS API below for more details.
componentelementType
The component used for the root node. Either a string to use a HTML element or a component.
imgPropsobject
Attributes applied to the img element if the component is used to display an image. It can be used to listen for the loading error event.
sizesstring
The sizes attribute for the img element.
srcstring
The src attribute for the img element.
srcSetstring
The srcSet attribute for the img element. Use this attribute for responsive image display.
sxArray<func
| object
| bool>
| func
| object
The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details.
variant'circular'
| 'rounded'
| 'square'
| string
'circular'
The shape of the avatar.

ref 则会被传递到根元素中。

CSS

规则名称全局类名描述
root.MuiAvatar-rootStyles applied to the root element.
colorDefault.MuiAvatar-colorDefaultStyles applied to the root element if not src or srcSet.
circular.MuiAvatar-circularStyles applied to the root element if variant="circular".
rounded.MuiAvatar-roundedStyles applied to the root element if variant="rounded".
square.MuiAvatar-squareStyles applied to the root element if variant="square".
img.MuiAvatar-imgStyles applied to the img element if either src or srcSet is defined.
fallback.MuiAvatar-fallbackStyles applied to the fallback icon

您可以使用组件自定义选项对组件进行个性化:

演示项目