112 lines
No EOL
3.9 KiB
TypeScript
112 lines
No EOL
3.9 KiB
TypeScript
import * as React from 'react';
|
|
import { SxProps } from '@mui/system';
|
|
import { OverridableStringUnion } from '@mui/types';
|
|
import { Theme } from "../styles/index.js";
|
|
import { OverridableComponent, OverrideProps } from "../OverridableComponent/index.js";
|
|
import { AvatarClasses } from "./avatarClasses.js";
|
|
import { CreateSlotsAndSlotProps, SlotProps } from "../utils/types.js";
|
|
import { SvgIconProps } from "../SvgIcon/index.js";
|
|
export interface AvatarSlots {
|
|
/**
|
|
* The component that renders the root slot.
|
|
* @default 'div'
|
|
*/
|
|
root: React.ElementType;
|
|
/**
|
|
* The component that renders the img slot.
|
|
* @default 'img'
|
|
*/
|
|
img: React.ElementType;
|
|
/**
|
|
* The component that renders the fallback slot.
|
|
* @default Person icon
|
|
*/
|
|
fallback: React.ElementType;
|
|
}
|
|
export interface AvatarPropsVariantOverrides {}
|
|
export interface AvatarRootSlotPropsOverrides {}
|
|
export interface AvatarImgSlotPropsOverrides {}
|
|
export interface AvatarFallbackSlotPropsOverrides {}
|
|
export type AvatarSlotsAndSlotProps = CreateSlotsAndSlotProps<AvatarSlots, {
|
|
/**
|
|
* Props forwarded to the root slot.
|
|
* By default, the avaible props are based on the div element.
|
|
*/
|
|
root: SlotProps<'div', AvatarRootSlotPropsOverrides, AvatarOwnProps>;
|
|
/**
|
|
* Props forwarded to the img slot.
|
|
* By default, the avaible props are based on the img element.
|
|
*/
|
|
img: SlotProps<'img', AvatarImgSlotPropsOverrides, AvatarOwnProps>;
|
|
/**
|
|
* Props forwarded to the fallback slot.
|
|
* By default, the avaible props are based on the [SvgIcon](https://mui.com/material-ui/api/svg-icon/#props) component.
|
|
*/
|
|
fallback: SlotProps<React.ElementType<SvgIconProps>, AvatarFallbackSlotPropsOverrides, AvatarOwnProps>;
|
|
}>;
|
|
export interface AvatarOwnProps {
|
|
/**
|
|
* Used in combination with `src` or `srcSet` to
|
|
* provide an alt attribute for the rendered `img` element.
|
|
*/
|
|
alt?: string;
|
|
/**
|
|
* Used to render icon or text elements inside the Avatar if `src` is not set.
|
|
* This can be an element, or just a string.
|
|
*/
|
|
children?: React.ReactNode;
|
|
/**
|
|
* Override or extend the styles applied to the component.
|
|
*/
|
|
classes?: Partial<AvatarClasses>;
|
|
/**
|
|
* [Attributes](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#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.
|
|
* @deprecated Use `slotProps.img` instead. This prop will be removed in a future major release. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
|
|
*/
|
|
imgProps?: React.ImgHTMLAttributes<HTMLImageElement> & {
|
|
sx?: SxProps<Theme>;
|
|
};
|
|
/**
|
|
* The `sizes` attribute for the `img` element.
|
|
*/
|
|
sizes?: string;
|
|
/**
|
|
* The `src` attribute for the `img` element.
|
|
*/
|
|
src?: string;
|
|
/**
|
|
* The `srcSet` attribute for the `img` element.
|
|
* Use this attribute for responsive image display.
|
|
*/
|
|
srcSet?: string;
|
|
/**
|
|
* The system prop that allows defining system overrides as well as additional CSS styles.
|
|
*/
|
|
sx?: SxProps<Theme>;
|
|
/**
|
|
* The shape of the avatar.
|
|
* @default 'circular'
|
|
*/
|
|
variant?: OverridableStringUnion<'circular' | 'rounded' | 'square', AvatarPropsVariantOverrides>;
|
|
}
|
|
export interface AvatarTypeMap<AdditionalProps = {}, RootComponent extends React.ElementType = 'div'> {
|
|
props: AdditionalProps & AvatarOwnProps & AvatarSlotsAndSlotProps;
|
|
defaultComponent: RootComponent;
|
|
}
|
|
|
|
/**
|
|
*
|
|
* Demos:
|
|
*
|
|
* - [Avatar](https://mui.com/material-ui/react-avatar/)
|
|
*
|
|
* API:
|
|
*
|
|
* - [Avatar API](https://mui.com/material-ui/api/avatar/)
|
|
*/
|
|
declare const Avatar: OverridableComponent<AvatarTypeMap>;
|
|
export type AvatarProps<RootComponent extends React.ElementType = AvatarTypeMap['defaultComponent'], AdditionalProps = {}> = OverrideProps<AvatarTypeMap<AdditionalProps, RootComponent>, RootComponent> & {
|
|
component?: React.ElementType;
|
|
};
|
|
export default Avatar; |