Skip to content

UIImageView ​

UIImageView 表示显示图片的视图,称为图片视图。把一个 UIImage 赋给它的 image 属性,图片就显示出来;给的是动图时自动播放。

图片视图不会自己加载图片。显示一张图分两步:先用 UIImage 的静态方法取到图片对象,再把它赋给图片视图。

图片怎么摆放(拉伸、等比缩放、裁剪)由继承自 UIView 的 contentMode 和 clipsToBounds 决定,见图片会不会变形。

UIImageView 自己不派发任何事件。它的属性只会被 App 的代码修改,所以没有变化通知。

继承关系:EventTarget → NSObject → UIResponder → UIView → UIImageView

怎么显示打包的图、网络图片、动图,见指南显示图片。

构造函数 ​

UIImageView()

创建一个没有图片、宽高是 0 的图片视图。

实例属性 ​

还继承 UIView 的属性。图片视图常用的继承属性是 contentMode、clipsToBounds、frame、backgroundColor、layer。

属性说明
image显示的图片
highlightedImage高亮状态下显示的图片
isHighlighted是否处于高亮状态
tintColor模板图的上色颜色
isAnimating 只读是否在播放用一组图片设置的逐帧动画

实例方法 ​

UIImageView 自己没有声明方法。还继承 UIView 的方法。

图片会不会变形 ​

会。图片和图片视图的宽高比不一致时,默认的做法是把图片拉伸到填满视图,图片会变形。怎么摆放由视图的 contentMode 属性决定:

想要的结果写法
完整显示图片,不变形,视图里可以留空contentMode = 'scaleAspectFit'
填满视图,不变形,超出的部分裁掉contentMode = 'scaleAspectFill',并且 clipsToBounds = true
填满视图,允许变形默认值 'scaleToFill'

以 100 × 100 pt 的图片放进 300 × 200 pt 的视图为例:

contentMode结果
'scaleToFill'(默认)图片拉伸成 300 × 200 pt,变形
'scaleAspectFit'图片等比放大到 200 × 200 pt,左右各空出 50 pt
'scaleAspectFill'图片等比放大到 300 × 300 pt,上下各超出 50 pt
'center'图片不缩放,按 100 × 100 pt 显示在视图正中

表里的尺寸是按各取值的定义算出来的,屏幕上的显示未在模拟器验证。contentMode 的全部 13 个取值见 UIView。

注意:contentMode 只决定图片怎么摆,不负责裁剪。用 'scaleAspectFill' 时不设 clipsToBounds = true,超出视图的部分会显示在视图外面,盖住旁边的内容。

图片视图的大小 ​

图片视图有固有尺寸,等于图片的 size。用哪种方式定位,决定要不要写宽高:

定位方式不写宽高时
Auto Layout 约束视图和图片一样大(验收用例验证过)
直接写 frame视图宽高是 0,看不到图片

宽和高都被约束确定之后,图片的尺寸不再影响视图的大小。

动图的播放 ​

image 是动图(多帧的 GIF、APNG、WebP)时,图片视图自动播放它,不需要调用任何方法。

  • 每帧的时长和播放的遍数按文件里写的来。 文件里写着一直循环的,一直播放。写着播放 2 遍的,播完 2 遍后停在最后一帧。
  • 换成别的图就停。 给 image 赋一张静态图或 null,播放停止。
  • 图片视图从父视图移除再加回去,不用重新赋值。 验收用例检查了移除 0.4 秒后播放用的动画还在。加回去之后画面是否接着播放,未在模拟器验证。
  • 帧的切换由系统完成,不占用 JS 所在的线程。 这和图层动画相同。JS 长时间运行期间动图是否继续播放,未在模拟器验证。
  • 播放期间,图片视图的图层上有一个名字是 'nacreImageFrames' 的关键帧动画,用 iv.layer.animationForKey('nacreImageFrames') 可以读到它。播放遍数有限的动图播完之后,这个动画仍然在图层上。
  • 播放不反映在 isAnimating 上。
  • 图片视图上的动图不能暂停,播完了也没有通知。需要这些时,把帧交给一个图层自己播放,见指南显示图片。

示例 ​

显示打包在 App 里的图 ​

从空白 App 开始,在屏幕正中显示项目 assets/ 里的 dot 图片,宽高各 120 pt,不变形。

js
application.addEventListener('sceneconnect', (e) => {
  const win = new UIWindow(e.scene);
  const page = new UIViewController();
  page.view.backgroundColor = 'systemBackground';
  win.rootViewController = page;
  win.makeKeyAndVisible();

  const iv = new UIImageView();
  iv.image = UIImage.imageNamed('JS/assets/dot');
  iv.contentMode = 'scaleAspectFit';

  iv.translatesAutoresizingMaskIntoConstraints = false;
  page.view.addSubview(iv);
  NSLayoutConstraint.activateConstraints([
    iv.centerXAnchor.constraintEqualToAnchor(page.view.centerXAnchor),
    iv.centerYAnchor.constraintEqualToAnchor(page.view.centerYAnchor),
    iv.widthAnchor.constraintEqualToConstant(120),
    iv.heightAnchor.constraintEqualToConstant(120),
  ]);
});

效果:屏幕正中 120 × 120 pt 的区域里显示 dot 图片,保持宽高比放大。项目里没有这张图时,image 是 null,什么都不显示,也不报错。这段代码未在模拟器验证。

更多写法见指南显示图片。

对应的 iOS API ​

ObjCJS
[[UIImageView alloc] init]new UIImageView()
iv.image = imgiv.image = img
iv.highlighted = YESiv.isHighlighted = true
iv.tintColor = UIColor.systemPinkColoriv.tintColor = 'systemPink'
iv.contentMode = UIViewContentModeScaleAspectFilliv.contentMode = 'scaleAspectFill'

与浏览器写法的对照 ​

HTML / CSS这里
<img>UIImageView
<img> 显示 GIF、APNG、WebP 动图时自动播放相同。动图赋给 image 后自动播放
src 属性,由元素自己加载没有。先取到 UIImage,再赋给 image;网络图片用 fetch 下载
srcset 列出多个倍率的文件文件按 名字@2x.png、名字@3x.png 命名,系统自动选
object-fit: fillcontentMode = 'scaleToFill'(默认值)
object-fit: containcontentMode = 'scaleAspectFit'
object-fit: covercontentMode = 'scaleAspectFill' 加 clipsToBounds = true
object-fit: nonecontentMode = 'center'
用 currentColor 上色的 SVG 图标模板图加 tintColor
浏览器自动缓存图片运行时不提供图片缓存

参见 ​