跳到主要内容
版本:0.86

图片样式属性

示例​

图片缩放模式​

图片边框​

图片圆角​

图片色调​

参考

属性​

backfaceVisibility​

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

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

backgroundColor​

类型
颜色

borderBottomLeftRadius​

类型
number

borderBottomRightRadius​

类型
number

borderColor​

类型
颜色

borderRadius​

类型
number

borderTopLeftRadius​

类型
number

borderTopRightRadius​

类型
number

borderWidth​

类型
number

opacity​

为图片设置不透明度值。该数值应在 0.0 到 1.0 的范围内。

类型默认值
number1.0

overflow​

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

overlayColor
Android
​

当图片具有圆角时,指定 overlayColor 会使角落中剩余的空间填充为纯色。这在 Android 对圆角的实现不支持以下情况时非常有用:

  • 某些缩放模式,例如 'contain'
  • 动画 GIF

此属性的一种典型用法是将图片显示在纯色背景上,并将 overlayColor 设置为与背景相同的颜色。

有关其底层工作方式的详细信息,请参阅 Fresco 文档。

类型
string

resizeMode​

决定当框架尺寸与原始图片尺寸不匹配时如何调整图片大小。默认值为 cover。

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

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

  • stretch:独立缩放宽度和高度,这可能会改变 src 的宽高比。

  • repeat:重复图片以覆盖视图的框架。图片将保持其大小和宽高比,除非它大于视图,在这种情况下会按比例缩小,使其包含在视图中。

  • center:在宽高两个维度上都将图片居中显示。如果图片大于视图,则按比例缩小,使其包含在视图中。

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

objectFit​

决定当框架尺寸与原始图片尺寸不匹配时如何调整图片大小。

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

tintColor​

将所有非透明像素的颜色更改为 tintColor。

类型
颜色