Avatar
사용자의 프로필 이미지를 표시하는 컴포넌트입니다.
Installation
의존성 설치
아래 코드를 복사 후 붙여넣고 사용하세요
Usage
이미지가 로딩 중이거나 실패한 동안 fallback을 표시합니다. src가 바뀌면 새 요청을 시작하며, 이전 요청의 이벤트는 상태에 반영하지 않습니다.
onLoadingStatusChange로 로딩 상태를 관찰할 수 있습니다. native 이미지 이벤트와 접근성 속성은 imageProps에 전달합니다.
Props
Avatar
Prop
Type
src?string | undefinedalt?string | undefinedfallback?React.ReactNodeonLoadingStatusChange?((status: ImageLoadingStatus) => void) | undefinedAvatarBadge
고유 prop이 없습니다. native view 속성과 children, className, style을 받습니다.
AvatarStack
Prop
Type
Examples
Size
Badge & Badge Mask
badgeMask는 이미지와 fallback에서 배지 주변을 "circle", "flower", "shield" 모양으로 잘라냅니다. 기본값인 "none"은 Avatar를 자르지 않습니다. size="20"에서는 배지와 마스크를 모두 표시하지 않습니다.
AvatarBadge에는 선택한 마스크 모양에 맞는 에셋을 넣습니다. 다른 모양의 콘텐츠에는 badgeMask="none"을 사용하고 필요한 테두리를 직접 지정하세요.
직접 만든 배지는 badgeMask="none"과 children으로 구성합니다.
Stack
AvatarStack은 자식 Avatar에 size를 전달합니다. 개별 Avatar에 지정한 size가 우선합니다.
Fallback Image
fallback에는 이미지가 로드되지 않았을 때 표시할 요소를 지정합니다. 문자열과 숫자도 사용할 수 있으며, 주로 IdentityPlaceholder를 사용합니다.
로딩에 성공하면 fallback을 언마운트합니다. 다시 표시할 때 유지해야 하는 상태는 부모에서 관리하세요.
웹 버전과의 차이
- DOM
<img>대신 native<image mode="aspectFill">을 사용합니다.alt는accessibility-label로 전달합니다. onLoad와onError대신imageProps.bindload와imageProps.binderror를 사용합니다.- Stack에서 영역 밖 콘텐츠를 함께 사용하면 React와 겹침 결과가 다를 수 있습니다.
asChild,srcSet, DOM 이벤트와 속성은 지원하지 않습니다.
Last updated on