@base-ui-components/react
Version:
Base UI is a library of headless ('unstyled') React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.
45 lines (43 loc) • 1.52 kB
JavaScript
'use client';
import * as React from 'react';
import { useTimeout } from '@base-ui-components/utils/useTimeout';
import { useRenderElement } from "../../utils/useRenderElement.js";
import { useAvatarRootContext } from "../root/AvatarRootContext.js";
import { avatarStateAttributesMapping } from "../root/stateAttributesMapping.js";
/**
* Rendered when the image fails to load or when no image is provided.
* Renders a `<span>` element.
*
* Documentation: [Base UI Avatar](https://base-ui.com/react/components/avatar)
*/
export const AvatarFallback = /*#__PURE__*/React.forwardRef(function AvatarFallback(componentProps, forwardedRef) {
const {
className,
render,
delay,
...elementProps
} = componentProps;
const {
imageLoadingStatus
} = useAvatarRootContext();
const [delayPassed, setDelayPassed] = React.useState(delay === undefined);
const timeout = useTimeout();
React.useEffect(() => {
if (delay !== undefined) {
timeout.start(delay, () => setDelayPassed(true));
}
return timeout.clear;
}, [timeout, delay]);
const state = React.useMemo(() => ({
imageLoadingStatus
}), [imageLoadingStatus]);
const element = useRenderElement('span', componentProps, {
state,
ref: forwardedRef,
props: elementProps,
stateAttributesMapping: avatarStateAttributesMapping,
enabled: imageLoadingStatus !== 'loaded' && delayPassed
});
return element;
});
if (process.env.NODE_ENV !== "production") AvatarFallback.displayName = "AvatarFallback";