跳到主要内容
版本:0.83

图片样式属性

示例​

图片缩放模式​

图片边框​

图片圆角​

图片颜色覆盖(Tint)​

参考

属性​

backfaceVisibility​

该属性定义旋转图像的背面是否可见。

类型默认值
枚举 ('visible', 'hidden')'visible'

backgroundColor​

类型
颜色

borderBottomLeftRadius​

类型
数字

borderBottomRightRadius​

类型
数字

borderColor​

类型
颜色

borderRadius​

类型
数字

borderTopLeftRadius​

类型
数字

borderTopRightRadius​

类型
数字

borderWidth​

类型
数字

opacity​

为图片设置透明度值。取值范围为 0.0 到 1.0。

类型默认值
数字1.0

overflow​

类型默认值
枚举 ('visible', 'hidden')'visible'

overlayColor
Android
​

当图像有圆角时,指定 overlayColor 会导致圆角剩余部分用纯色填充。这在 Android 圆角实现不支持的情况下很有用:

  • 某些缩放模式,如 'contain'
  • 动态 GIF 图

通常使用这种属性的方式是在纯色背景上显示图片,并将 overlayColor 设置为与背景相同的颜色。

有关底层实现细节,请参见 Fresco 文档。

类型
字符串

resizeMode​

确定当框架尺寸与原始图像尺寸不符时如何缩放图片。默认值为 cover。

  • cover: 按比例缩放图像(保持长宽比),使得:

    • 图像的宽度和高度都大于等于视图对应尺寸(减去内边距)
    • 缩放后的图像至少有一个维度等于视图对应维度(减去内边距)
  • contain: 按比例缩放图像(保持长宽比),使图像宽度和高度都小于等于视图对应尺寸(减去内边距)。

  • stretch: 独立缩放宽度和高度,可能改变图片长宽比。

  • repeat: 重复图像以覆盖视图区域。图像会保持大小和长宽比,除非图像比视图大,则按比例缩小以包含在视图内。

  • center: 将图像在视图中央显示。如果图像比视图大,则按比例缩小使其包含于视图内。

类型默认值
枚举 ('cover', 'contain', 'stretch', 'repeat', 'center')'cover'

objectFit​

确定当框架尺寸与原始图像尺寸不符时如何缩放图片。

类型默认值
枚举 ('cover', 'contain', 'fill', 'scale-down')'cover'

tintColor​

将所有非透明像素的颜色更改为指定的色调颜色。

类型
颜色