UIImageView:tintColor 属性
tintColor 属性是图片视图给模板图上色用的颜色。模板图是只使用形状、不使用自身颜色的图片:图片里不透明的部分全部显示成这个颜色。
值
颜色字符串。
- 可读,可写。
- 默认值是系统默认的强调色。默认值读出来的字符串未在模拟器验证。
- 写入时接受颜色字符串,也接受
UIColor对象。写null恢复成默认值。 - 读出来的字符串和写入的相同:写入
'systemPink'读回'systemPink'。 - 只对模板图起作用。SF Symbols 图标在图片视图里按模板图处理;自己的图片默认显示原来的颜色,要先用
imageWithRenderingMode('alwaysTemplate')转成模板图。图片的renderingMode是'alwaysOriginal'时这个颜色不起作用。见渲染模式和tintColor。
写错时
写入不合法的颜色时不抛异常。控制台输出一条警告,颜色保持原值:
[Nacre] tintColor: "#GGG" is not a valid color, ignored示例
js
const iv = new UIImageView();
iv.image = UIImage.systemImageNamed('star.fill');
iv.tintColor = '#FF3B30';
console.log(iv.tintColor);效果
- 星形显示为红色。未在模拟器验证。
- 控制台输出
#FF3B30。
对应的 iOS API
UIView.tintColor。原生里它是所有视图的属性,这里只在图片视图上提供。
参见
UIColor:颜色字符串的全部写法renderingMode