Skip to content

UIImage:renderingMode 属性 ​

renderingMode 属性决定图片显示时用不用它自身的颜色。

值 ​

字符串,下面三个之一:

取值效果
'automatic'由使用图片的地方决定。新取到的图片都是这个值
'alwaysOriginal'始终显示图片自身的颜色,tintColor 不起作用
'alwaysTemplate'始终当作模板图:忽略图片自身的颜色,只用它的形状,整张按 tintColor 上色

SF Symbols 图标也是 'automatic'。要改,用 imageWithRenderingMode() 生成一张新图。

  • 只读。给它赋值抛 TypeError。
  • 图片不可变,这个值不会变,所以没有变化通知。

示例 ​

js
const star = UIImage.systemImageNamed('star.fill');
if (star) {
  const original = star.imageWithRenderingMode('alwaysOriginal');
  console.log(original.renderingMode, star.renderingMode);
}

结果:控制台输出 alwaysOriginal automatic。原图不变。

对应的 iOS API ​

UIImage.renderingMode。

参见 ​