Skip to main content

이미지 스타일 속성

예제

이미지 리사이즈 모드

이미지 테두리

이미지 테두리 둥글게 만들기

이미지 틴트

참조

Props

backfaceVisibility

이 속성은 회전된 이미지의 뒷면이 보이는지 여부를 정의한다.

타입기본값
enum('visible', 'hidden')'visible'

backgroundColor

타입
color

borderBottomLeftRadius

타입
number

borderBottomRightRadius

타입
number

borderColor

타입
color

borderRadius

타입
number

borderTopLeftRadius

타입
number

borderTopRightRadius

타입
number

borderWidth

타입
number

opacity

이미지의 투명도 값을 설정한다. 값은 0.0에서 1.0 사이의 숫자로 지정한다.

타입기본값
number1.0

overflow

타입기본값
enum('visible', 'hidden')'visible'

overlayColor
Android

이미지에 둥근 모서리를 적용할 때, overlayColor를 지정하면 모서리의 남은 공간이 단색으로 채워진다. 이 기능은 안드로이드에서 둥근 모서리를 구현할 때 지원되지 않는 경우에 유용하다:

  • 'contain'과 같은 특정 리사이즈 모드
  • 애니메이션 GIF

이 속성은 일반적으로 단색 배경 위에 이미지를 표시할 때 사용하며, overlayColor를 배경색과 동일하게 설정한다.

내부적으로 이 기능이 어떻게 동작하는지 자세히 알고 싶다면 Fresco 문서를 참고한다.

타입
string

resizeMode

이미지의 원본 크기와 프레임 크기가 일치하지 않을 때, 이미지를 어떻게 조정할지 결정한다. 기본값은 cover이다.

  • cover: 이미지의 가로세로 비율을 유지하면서 균일하게 크기를 조정한다. 이때:

    • 이미지의 가로와 세로 크기는 모두 뷰의 해당 크기(패딩을 뺀 값)보다 크거나 같아진다.
    • 크기가 조정된 이미지의 가로 또는 세로 중 하나는 뷰의 해당 크기(패딩을 뺀 값)와 동일해진다.
  • contain: 이미지의 가로세로 비율을 유지하면서 균일하게 크기를 조정한다. 이때 이미지의 가로와 세로 크기는 모두 뷰의 해당 크기(패딩을 뺀 값)보다 작거나 같아진다.

  • stretch: 가로와 세로 크기를 독립적으로 조정한다. 이때 이미지의 가로세로 비율이 변경될 수 있다.

  • repeat: 이미지를 반복하여 뷰의 프레임을 채운다. 이미지는 원래 크기와 가로세로 비율을 유지하지만, 뷰보다 큰 경우 균일하게 축소되어 뷰 안에 포함된다.

  • center: 이미지를 뷰의 가운데에 위치시킨다. 이미지가 뷰보다 큰 경우 균일하게 축소되어 뷰 안에 포함된다.

타입기본값
enum('cover', 'contain', 'stretch', 'repeat', 'center')'cover'

objectFit

이미지 프레임과 원본 이미지의 크기가 일치하지 않을 때, 이미지를 어떻게 조정할지 결정한다.

타입기본값
열거형('cover', 'contain', 'fill', 'scale-down')'cover'

tintColor

투명하지 않은 모든 픽셀의 색상을 tintColor로 변경한다.

타입
color