UIView
UIView 表示屏幕上的一块矩形区域,称为视图。视图做三件事:显示内容(底色,以及子类提供的文字、图片),包含别的视图,接收触摸。按钮、文字、图片、滚动区域都是 UIView 的子类,这一页的成员在所有视图上都能用。
视图组成一棵树。每个视图最多有一个父视图,可以有任意多个子视图,树的根是窗口(UIWindow)。视图连到窗口之后才显示在屏幕上;没有连到窗口的视图可以照常创建、设置属性、加子视图,只是屏幕上看不到。
视图的位置和大小不会自动得出,要由 App 的代码给出:直接写一个矩形(frame),或者写约束让系统计算。长度的单位是点(pt),一个点在屏幕上对应 2 × 2 或 3 × 3 个像素,见单位。
外观用属性设置,比如 backgroundColor、alpha。圆角、边框、阴影在视图的图层 view.layer 上,见 CALayer。
继承关系:EventTarget → NSObject → UIResponder → UIView
UIView 的子类:UIWindow、UILabel、UIImageView、UIControl(UIButton、UITextField)、UIScrollView、UIStackView。
怎么创建视图、摆放、隐藏、移除,见指南在屏幕上摆放视图;动画见让视图动起来;约束见用约束排版。
构造函数
创建一个视图。新视图的 frame 是 (0, 0, 0, 0),没有底色,没有父视图。UIView 不能被继承。
静态方法
| 方法 | 说明 |
|---|---|
UIView.animateWithDuration() | 带动画地改视图的属性。返回 Promise,动画结束时兑现 |
UIView.performWithoutAnimation() | 执行一段代码,里面的改动不带动画 |
实例属性
还继承 UIResponder 的 isFirstResponder、canBecomeFirstResponder,说明见输入框和键盘。
位置和大小。单位都是 pt:
| 属性 | 说明 |
|---|---|
frame | 在父视图坐标系里的位置和大小 |
bounds | 在自己坐标系里的矩形 |
center | 中心点在父视图坐标系里的位置 |
transform | 二维仿射变换 |
anchorPoint | 变换绕的那个点,用比例表示 |
safeAreaInsets 只读 | 安全区的四条边到视图四条边的距离 |
directionalLayoutMargins | 内边距,左右按文字方向区分 |
layoutMargins | 同一份内边距,左右固定 |
insetsLayoutMarginsFromSafeArea | 内边距是否加上安全区 |
preservesSuperviewLayoutMargins | 父视图的内边距大时是否采用父视图的 |
intrinsicContentSize 只读 | 按内容算出的固有大小 |
alignmentRectInsets 只读 | 对齐矩形比 frame 往里缩了多少 |
contentScaleFactor | 1 pt 对应几个像素 |
autoresizingMask | 父视图大小变化时,按 frame 定位的视图怎么跟着变 |
autoresizesSubviews | 大小变化时是否调整子视图 |
视图树:
| 属性 | 说明 |
|---|---|
superview 只读 | 父视图 |
subviews 只读 | 子视图,按绘制顺序 |
window 只读 | 所在的窗口 |
tag | 自己定的整数编号 |
外观:
| 属性 | 说明 |
|---|---|
backgroundColor | 底色 |
alpha | 不透明度,0 到 1 |
isHidden | 是否隐藏 |
clipsToBounds | 是否裁掉超出范围的子视图 |
isOpaque | 给系统的绘制提示:内容是否完全不透明 |
contentMode | 内容和视图大小不一致时怎么摆放 |
layer 只读 | 视图的图层:圆角、边框、阴影 |
maskView | 遮罩视图 |
tintColor | 强调色 |
tintAdjustmentMode | 强调色正常显示还是变暗 |
clearsContextBeforeDrawing | 重新绘制前是否先清掉原来的内容 |
外观特征和书写方向:
| 属性 | 说明 |
|---|---|
traitCollection 只读 | 所处环境的外观特征:深浅色、屏幕倍数、文字大小 |
overrideUserInterfaceStyle | 强制用浅色或深色 |
semanticContentAttribute | 从右往左的语言里要不要左右翻转 |
effectiveUserInterfaceLayoutDirection 只读 | 实际使用的书写方向 |
appliedContentSizeCategoryLimitsDescription 只读 | 调试用:哪些文字大小被限制了 |
触摸和焦点:
| 属性 | 说明 |
|---|---|
isUserInteractionEnabled | 是否接收触摸 |
isMultipleTouchEnabled | 是否接收多根手指 |
isExclusiveTouch | 被触摸时是否独占触摸 |
gestureRecognizers 只读 | 视图上的手势识别器 |
canBecomeFocused 只读 | 能不能得到焦点 |
isFocused 只读 | 此刻是否有焦点 |
focusGroupIdentifier | 焦点分组的名字 |
约束(Auto Layout)。锚点用来建约束,见 NSLayoutAnchor:
| 属性 | 说明 |
|---|---|
translatesAutoresizingMaskIntoConstraints | 按 frame 定位还是由约束定位。用约束的视图必须设成 false |
leadingAnchor 只读 | 起始边 |
trailingAnchor 只读 | 结束边 |
leftAnchor 只读 | 左边 |
rightAnchor 只读 | 右边 |
centerXAnchor 只读 | 水平中心线 |
topAnchor 只读 | 上边 |
bottomAnchor 只读 | 下边 |
centerYAnchor 只读 | 垂直中心线 |
firstBaselineAnchor 只读 | 第一行文字的基线 |
lastBaselineAnchor 只读 | 最后一行文字的基线 |
widthAnchor 只读 | 宽度 |
heightAnchor 只读 | 高度 |
safeAreaLayoutGuide 只读 | 代表安全区的 layout guide |
layoutMarginsGuide 只读 | 按内边距缩进之后的区域 |
readableContentGuide 只读 | 适合阅读长文字的宽度范围 |
keyboardLayoutGuide 只读 | 键盘占的区域 |
layoutGuides 只读 | 自己加上的 layout guide |
constraints 只读 | 存放在这个视图上的约束 |
hasAmbiguousLayout 只读 | 约束够不够 |
viewForFirstBaselineLayout 只读 | 第一条基线取自哪个视图 |
viewForLastBaselineLayout 只读 | 最后一条基线取自哪个视图 |
辅助功能和状态恢复。读屏(VoiceOver,系统设置里叫「旁白」)是 iOS 自带的屏幕阅读器,怎么让它念对界面见指南让读屏念对你的界面:
| 属性 | 说明 |
|---|---|
isAccessibilityElement | 读屏是否把它当成一个元素停下来念 |
accessibilityLabel | 读屏念的名字:它是什么 |
accessibilityHint | 读屏念完名字后的提示:操作它会怎样 |
accessibilityValue | 读屏念的当前值 |
accessibilityTraits | 它是什么样的东西、处在什么状态:按钮、标题、已选中…… |
accessibilityIdentifier | 给界面自动化测试找元素用的标识,读屏不念 |
accessibilityElementsHidden | 读屏是否跳过它里面的全部元素 |
accessibilityViewIsModal | 读屏是否只在它里面转,跳过兄弟视图。弹层用 |
shouldGroupAccessibilityChildren | 读屏是否把它里面的元素当成一组连续念完 |
accessibilityIgnoresInvertColors | 智能反转颜色时是否保持原样 |
showsLargeContentViewer | 长按时是否显示放大的版本 |
largeContentTitle | 放大显示时的文字 |
largeContentImage | 放大显示时的图片 |
scalesLargeContentImage | 放大显示时是否放大图片 |
largeContentImageInsets | 放大显示时图片四周的边距 |
restorationIdentifier | 系统恢复界面状态时认出它的名字 |
实例方法
还继承 UIResponder 的 becomeFirstResponder()、resignFirstResponder(),说明见输入框和键盘。
视图树:
| 方法 | 说明 |
|---|---|
addSubview() | 加为子视图,放在最上层 |
insertSubview() | 加为子视图,放在指定的位置 |
removeFromSuperview() | 从父视图里移除 |
bringSubviewToFront() | 把子视图调到最上层 |
sendSubviewToBack() | 把子视图调到最下层 |
exchangeSubviewAtIndex() | 交换两个子视图的位置 |
isDescendantOfView() | 是不是另一个视图的后代 |
viewWithTag() | 按编号找视图 |
几何:
| 方法 | 说明 |
|---|---|
sizeThatFits() | 显示全部内容需要多大 |
sizeToFit() | 把大小改成刚好容纳内容 |
convertPoint() | 把点换算到另一个视图的坐标系 |
convertRect() | 把矩形换算到另一个视图的坐标系 |
hitTest() | 某个位置上最上层的、能接收触摸的视图 |
alignmentRectForFrame() | frame 换算成对齐矩形 |
frameForAlignmentRect() | 对齐矩形换算成 frame |
effectiveRadiusForCorner() | 某个角实际的圆角半径 |
手势识别器:
| 方法 | 说明 |
|---|---|
addGestureRecognizer() | 加一个手势识别器 |
removeGestureRecognizer() | 拿掉一个手势识别器 |
布局、重绘和更新。系统不会在每次属性变化后立刻重新布局,而是做一个标记,稍后统一处理。日常只会用到 layoutIfNeeded():
| 方法 | 说明 |
|---|---|
layoutIfNeeded() | 有待处理的布局时立刻完成。激活约束后要立刻读 frame 时调它 |
setNeedsLayout() | 标记需要重新布局 |
setNeedsDisplay() | 标记需要重新绘制 |
setNeedsDisplayInRect() | 标记一块矩形需要重新绘制 |
setNeedsUpdateConstraints() | 标记约束需要更新 |
updateConstraintsIfNeeded() | 有待处理的约束更新时立刻完成 |
needsUpdateConstraints() | 有没有待处理的约束更新 |
setNeedsUpdateProperties() | 标记需要更新属性 |
updatePropertiesIfNeeded() | 有待处理的属性更新时立刻完成 |
updateTraitsIfNeeded() | 有待处理的外观特征更新时立刻完成 |
约束(Auto Layout):
| 方法 | 说明 |
|---|---|
addLayoutGuide() | 加一个 layout guide |
removeLayoutGuide() | 移除一个 layout guide |
contentHuggingPriorityForAxis() | 读「不愿被拉大」的优先级 |
setContentHuggingPriority() | 设「不愿被拉大」的优先级 |
contentCompressionResistancePriorityForAxis() | 读「不愿被压小」的优先级 |
setContentCompressionResistancePriority() | 设「不愿被压小」的优先级 |
invalidateIntrinsicContentSize() | 通知系统固有大小变了 |
systemLayoutSizeFittingSize() | 按约束算出视图应该多大 |
constraintsAffectingLayoutForAxis() | 实际影响这个视图的约束 |
exerciseAmbiguityInLayout() | 约束不够时在几种结果之间切换一次 |
快照和键盘:
| 方法 | 说明 |
|---|---|
snapshotViewAfterScreenUpdates() | 拍一张快照,返回显示快照的新视图 |
resizableSnapshotViewFromRect() | 拍一块可以拉伸的快照 |
endEditing() | 让正在输入的输入框失去焦点,收起键盘 |
事件
| 事件 | 什么时候派发 |
|---|---|
traitchange | 外观特征(深浅色、文字大小等)变化时 |
UIView 自己派发的事件只有这一个。触摸不产生 UIView 的事件,要响应触摸,用手势识别器或 UIControl 的子类。
除了 traitchange,本页的属性都没有变化通知:位置、大小、父视图变了,没有事件。
普通的 UIView 上可以监听和派发自定义名字的事件,用法和普通的 EventTarget 一样。有自己一套事件的子类(比如 UIControl)也一样:不是系统会派发的名字,就当自定义事件。
概念
frame、bounds 和 center
三个属性都描述视图的位置和大小,区别在于参照的坐标系。
| 属性 | 参照谁的坐标系 | 是什么 |
|---|---|---|
frame | 父视图 | 视图在父视图里占的矩形 |
bounds | 自己 | 视图自己的矩形。左上角通常是 (0, 0),宽高和 frame 相同 |
center | 父视图 | 视图中心点的位置 |
坐标原点在左上角,x 向右增大,y 向下增大。
子视图的 frame 相对父视图的左上角,不是相对屏幕。移动父视图,子视图跟着移动,子视图的 frame 不变。
该用哪一个,按要做的事选:
| 要做的事 | 用哪个 | 原因 |
|---|---|---|
| 把视图摆在父视图里的某个位置 | 写它的 frame | frame 用的是父视图的坐标系 |
| 知道一个视图有多大,或者让子视图铺满它 | 读它的 bounds | 子视图的坐标相对它的左上角,bounds 正是这个坐标系里的矩形。读父视图的 frame 会把父视图自己的位置带进来 |
| 只移动、不改大小 | 写 center | 不用重复写宽高 |
视图设了 transform | 用 bounds 和 center,不用 frame | 见变换和 frame |
三个属性是同一份数据:写其中一个,另外两个读出来跟着变。用约束定位的视图,三个都只读不写,见两种定位方式。
视图树和叠放顺序
视图组成一棵树。每个视图最多有一个父视图(superview),可以有任意多个子视图(subviews)。
subviews的顺序就是绘制顺序,排在后面的画在上面。叠放顺序只由这个顺序决定,没有单独的层级数值。不同父视图下的两个视图谁在上面,由它们各自的祖先在共同父视图里的顺序决定。- 一个视图同一时刻只能有一个父视图。把一个已经有父视图的视图加到另一个父视图上,它从原来的父视图里移走,不会出现在两处。未在模拟器验证。
- 树的根是窗口(
UIWindow)。视图加到窗口下面才会显示,这时它的window属性有值;否则是null。 - 页面(
UIViewController)自带一个根视图page.view,页面的内容都加在它下面。
视图树不能成环。把视图加成它自己的子视图时抛 TypeError,视图树不变,这个视图之后照常可用:
const lone = new UIView();
try {
lone.addSubview(lone);
} catch (err) {
console.log(String(err));
}
console.log(lone.subviews.length);效果:控制台输出 TypeError: addSubview: raised NSInvalidArgumentException: Can't add self as subview,然后输出 0。
把视图加到它自己的后代上(比如 dot.addSubview(card),而 dot 是 card 的子视图)会怎样,未在模拟器验证。可以先用 isDescendantOfView() 判断。
视图加到树上之后由父视图保管,不用保存在变量里。移除之后是否被回收,见视图由谁保管。
两种定位方式
| 方式 | 写法 | 特点 |
|---|---|---|
直接写 frame | view.frame = new CGRect(…) | 位置和大小是固定的数值。父视图的大小变了,要由代码重新赋值 |
| 约束(Auto Layout) | NSLayoutConstraint.activateConstraints([…]) | 描述视图之间的关系,系统算出 frame,并在尺寸变化时重算 |
推荐用约束,理由见指南里的推荐的做法。
一个视图只用其中一种:
- 用约束的视图,先设
translatesAutoresizingMaskIntoConstraints = false。这个属性默认是true,意思是「按frame摆放」。不改的话,系统按frame生成的约束会和代码写的约束冲突,表现是约束写对了但位置不变。冲突时系统不在控制台输出任何信息。 - 用了约束的视图,可以读
frame,不要写frame。写入不报错,但下一次布局时系统用约束的结果覆盖它。要改位置就改约束的constant,或者换一组约束。「写入的frame被覆盖」未在模拟器验证。 - 页面的根视图
page.view和窗口由系统摆放,不要改它们的这个属性,也不要给它们写frame。
两种方式可以在同一棵树里混用:父视图用约束,它里面的某个子视图用 frame。子视图的 frame 相对父视图的左上角,父视图被约束移动时子视图跟着移动。
约束里用到两种对象:
- 锚点(anchor):代表视图的一条边、中心线或宽高,比如
view.leadingAnchor。约束写的是两个锚点之间的关系。 - layout guide:一个不显示的矩形,只用来对齐。
view.safeAreaLayoutGuide就是代表安全区的那一个。
详见 NSLayoutConstraint 和指南用约束排版。
安全区
安全区是视图里不会被刘海、状态栏、屏幕圆角和底部横条遮挡的区域。
每个视图都有自己的一份安全区,数值按这个视图的范围计算:贴着屏幕顶端的视图上边有一段安全区,完全位于屏幕中间的视图四边都是 0 pt。
读取方式有两种:
| 方式 | 用在哪里 |
|---|---|
view.safeAreaInsets | 用 frame 定位时。四个数值,单位 pt |
view.safeAreaLayoutGuide | 用约束定位时。直接和它的锚点对齐 |
推荐用 safeAreaLayoutGuide。safeAreaInsets 在视图显示到屏幕上之前读到的是 0 pt,读早了数值不对;对齐 safeAreaLayoutGuide 的约束没有这个问题。安全区变化时没有事件通知,约束会自动跟着重算,读数值的写法要自己重新读。
底色和背景图通常铺满整个屏幕,文字和按钮放在安全区内。
内边距
每个视图有一组内边距,表示内容应该离视图的四条边多远。关于它有四件事要知道:
- 它不会自动缩进子视图。 用到它的只有两处:对齐
layoutMarginsGuide的约束,以及开了isLayoutMarginsRelativeArrangement的UIStackView。用frame定位的子视图不受影响。 - 默认值不是 0。 新建的视图四边各 8 pt。
- 视图伸到安全区外面时,系统会把安全区加到内边距上。 写 16 pt、上方的安全区是 68 pt,读出来的上边距是 84 pt。要写多少就是多少,把
insetsLayoutMarginsFromSafeArea设成false。 - 页面的根视图有系统规定的最小边距。 给
page.view写的内边距小于最小值时,读出来是最小值。未在模拟器验证。
内边距有两个属性,是同一份数据的两种读法,写其中一个,另一个跟着变:
| 属性 | 类型 | 四个字段 | 左右怎么算 |
|---|---|---|---|
directionalLayoutMargins | NSDirectionalEdgeInsets | top、leading、bottom、trailing | leading 是文字开始的一侧,trailing 是文字结束的一侧。中文和英文里 leading 在左,阿拉伯语这类从右往左写的语言里在右 |
layoutMargins | UIEdgeInsets | top、left、bottom、right | 固定的左和右 |
优先用 directionalLayoutMargins,界面在从右往左的语言里会自动左右对调。
const box = new UIView();
box.directionalLayoutMargins = new NSDirectionalEdgeInsets(1, 2, 3, 4);
String(box.layoutMargins); // 'UIEdgeInsets(1, 2, 3, 4)',语言是从左往右时
box.layoutMargins = { top: 5, left: 6, bottom: 7, right: 8 };
String(box.directionalLayoutMargins); // 'NSDirectionalEdgeInsets(5, 6, 7, 8)'变换和 frame
transform 是一个二维仿射变换:平移、缩放、旋转以及它们的组合。变换以视图的中心为原点,只改变画出来的样子,不改变 bounds 和 center。
transform 不是单位矩阵时,frame 读出来的是变换后图形的外接矩形,不再是视图原本的矩形:
const box = new UIView();
box.frame = new CGRect(24, 304, 40, 40);
box.transform = CGAffineTransform.scale(1.2)
.concat(CGAffineTransform.rotation(Math.PI / 6));
box.bounds.width; // 40,不变
box.center.x; // 44,不变
box.frame.width; // 65.57,等于 40 × (|a| + |c|),a 和 c 是变换矩阵的字段所以变换期间要改位置用 center,要改大小用 bounds,不读写 frame。把 transform 设回 CGAffineTransform.identity 之后,frame 恢复成 40 × 40。
变换的构造方法见 CGAffineTransform。
结构体是只读的值
frame、bounds、center、transform、safeAreaInsets、layoutMargins、directionalLayoutMargins 的类型是 CGRect、CGPoint 这类结构体。结构体是值,不是对视图的引用:
- 每次读属性得到一个新的对象。
- 字段不能改。写
view.frame.x = 10抛TypeError: x is read-only: structs are values, assign a whole new one instead。 - 要改就给属性整体赋一个新值。赋值时可以用
new CGRect(…),也可以用字段齐全的普通对象。
详见结构体。
出错时会怎样
写错的地方不同,结果不同。
| 写错的地方 | 结果 |
|---|---|
数值属性给了别的类型(view.alpha = '0.5') | 按 Number() 转换,'0.5' 得到 0.5,null 得到 0。转不出有限的数时抛 TypeError,原值不变 |
布尔属性给了别的类型(view.isHidden = 'false') | 按 Boolean() 转换。非空字符串都是 true,所以 'false' 得到 true |
该传视图的地方传了别的值(view.addSubview(5)) | 抛 TypeError,视图树不变。不做转换 |
颜色写错(view.backgroundColor = '#GGG') | 不抛错。控制台输出一条警告,颜色保持原值 |
枚举属性写错(view.contentMode = 'cover') | 不抛错。控制台输出一条警告,警告里列出全部可用的值,属性保持原值 |
方法参数里的枚举写错(view.setContentHuggingPriority('defaultHigh', { forAxis: 'diagonal' })) | 抛 TypeError,报错里列出全部可用的值 |
写只读属性(view.superview = null) | 抛 TypeError |
属性名拼错(view.backgroundColour = 'red') | 不报错,视图不变。类型检查能发现 |
| 把视图加成它自己的子视图 | 抛 TypeError,视图树不变 |
| 情况 | 报错 |
|---|---|
在还没有绑定场景的窗口上读写属性或调方法(new UIWindow() 不传参数,并且还没给 windowScene 赋值) | TypeError: frame: this object is not connected to a scene yet, so no native object exists,开头是属性名或方法名 |
在不是由构造函数创建的对象上调用(比如 Object.create(UIView.prototype)) | TypeError: frame: Illegal invocation |
| 该传原生对象的参数传了别的值 | TypeError: addSubview needs a UIView,开头是方法名,结尾是要求的类。参数可以是 null 的,结尾多一个 or null |
| 数值参数或属性转不出有限的数 | TypeError: alpha must be a finite number, got "abc",开头是属性名或参数名 |
| 方法参数里的枚举写了不认识的值 | TypeError: forAxis has no value "diagonal"; expected one of: … |
出错时被写的属性保持原值,视图树不变。这些错误都可以用 try / catch 捕获。
枚举属性(contentMode、overrideUserInterfaceStyle)写了不认识的值不属于出错:不抛异常,属性保持原值,控制台输出一条警告 [Nacre] contentMode has no value "cover"; expected one of: …, ignored。
各成员自己的报错原文在它的成员页上。几种「没有原生对象」的报错详见原生类。
注意:属性名拼错时不报错。
view.backgroundColour = 'red'只是在 JS 对象上加了一个普通属性,视图不变。类型检查能发现这种错误:它报错并提示Did you mean 'backgroundColor'?。
示例
矩形里放一个小方块
下面的代码从空白 App 开始,在屏幕上放一个靛蓝色的矩形,矩形里面再放一个橙色的小方块。
application.addEventListener('sceneconnect', (e) => {
// 建窗口和页面。每个 App 都要有这几行
const win = new UIWindow(e.scene);
const page = new UIViewController();
page.view.backgroundColor = 'systemBackground';
win.rootViewController = page;
win.makeKeyAndVisible();
// 1. 创建视图
const card = new UIView();
// 2. 设置位置和大小:左上角在 (40, 120),宽 200,高 120
card.frame = new CGRect(40, 120, 200, 120);
// 3. 设置底色
card.backgroundColor = 'systemIndigo';
// 4. 放到页面上。page.view 是页面自带的根视图
page.view.addSubview(card);
// 5. 在 card 里面再放一个子视图。它的坐标相对 card 的左上角
const dot = new UIView();
dot.frame = new CGRect(16, 16, 40, 40);
dot.backgroundColor = 'systemOrange';
card.addSubview(dot);
// 6. 把 dot 的左上角换算成页面坐标
const p = dot.convertPoint(new CGPoint(0, 0), { toView: page.view });
console.log(p.x, p.y);
});效果
- 屏幕上出现一个靛蓝色矩形,宽 200 pt、高 120 pt,左边缘距屏幕左边 40 pt,上边缘距屏幕顶端 120 pt。
- 矩形的左上角里面有一个 40 × 40 pt 的橙色方块,距矩形的左边和上边各 16 pt。
- 控制台输出
56 176,即 40 + 16 和 120 + 16。
这段代码没有作为一个整体在模拟器运行过。其中用到的每个 API 都在验收用例里运行过。
四个基本步骤是:创建、给位置和大小、设外观、加到父视图上。回调结束后 card 和 dot 这两个变量不再存在,两个视图仍然显示:它们在视图树上,由父视图保管。更多写法见指南在屏幕上摆放视图。
对应的 iOS API
如果你在看 Apple 的文档或 iOS 的示例代码,按这张表换成 JS 的写法。
| ObjC | JS |
|---|---|
[[UIView alloc] init] | new UIView() |
[[UIView alloc] initWithFrame:rect] | new UIView() 之后赋 frame |
view.frame = CGRectMake(40, 120, 200, 120) | view.frame = new CGRect(40, 120, 200, 120) |
view.center = CGPointMake(100, 100) | view.center = new CGPoint(100, 100) |
view.transform = CGAffineTransformMakeRotation(a) | view.transform = CGAffineTransform.rotation(a) |
view.backgroundColor = UIColor.systemIndigoColor | view.backgroundColor = 'systemIndigo' |
[view addSubview:box] | view.addSubview(box) |
[view insertSubview:box atIndex:0] | view.insertSubview(box, { atIndex: 0 }) |
[view insertSubview:box belowSubview:other] | view.insertSubview(box, { belowSubview: other }) |
[view convertPoint:p toView:other] | view.convertPoint(p, { toView: other }) |
[view convertRect:r fromView:other] | view.convertRect(r, { fromView: other }) |
view.directionalLayoutMargins = NSDirectionalEdgeInsetsMake(8, 16, 8, 16) | view.directionalLayoutMargins = new NSDirectionalEdgeInsets(8, 16, 8, 16) |
view.layoutMargins = UIEdgeInsetsMake(8, 16, 8, 16) | view.layoutMargins = new UIEdgeInsets(8, 16, 8, 16) |
view.insetsLayoutMarginsFromSafeArea = NO | view.insetsLayoutMarginsFromSafeArea = false |
[view sizeThatFits:CGSizeMake(300, 999)] | view.sizeThatFits(new CGSize(300, 999)) |
[view hitTest:p withEvent:nil] | view.hitTest(p) |
[view endEditing:YES] | view.endEditing(true) |
[view addGestureRecognizer:tap] | view.addGestureRecognizer(tap) |
[UIView animateWithDuration:0.3 animations:^{ view.alpha = 0; }] | UIView.animateWithDuration(0.3, { animations() { view.alpha = 0; } }) |
[UIView animateWithDuration:0.3 animations:^{ … } completion:^(BOOL finished) { … }] | const finished = await UIView.animateWithDuration(0.3, { animations() { … } }) |
[UIView animateWithDuration:0.3 delay:0.1 options:UIViewAnimationOptionCurveEaseOut animations:^{ … } completion:nil] | UIView.animateWithDuration(0.3, { delay: 0.1, options: ['curveEaseOut'], animations() { … } }) |
[UIView animateWithDuration:0.5 delay:0 usingSpringWithDamping:0.6 initialSpringVelocity:0 options:0 animations:^{ … } completion:nil] | UIView.animateWithDuration(0.5, { usingSpringWithDamping: 0.6, initialSpringVelocity: 0, animations() { … } }) |
[UIView performWithoutAnimation:^{ … }] | UIView.performWithoutAnimation(() => { … }) |
view.hidden = YES | view.isHidden = true |
view.opaque = NO | view.isOpaque = false |
view.userInteractionEnabled = NO | view.isUserInteractionEnabled = false |
view.contentMode = UIViewContentModeScaleAspectFit | view.contentMode = 'scaleAspectFit' |
[view setContentHuggingPriority:UILayoutPriorityDefaultLow forAxis:UILayoutConstraintAxisHorizontal] | view.setContentHuggingPriority('defaultLow', { forAxis: 'horizontal' }) |
view.accessibilityTraits = UIAccessibilityTraitButton | UIAccessibilityTraitSelected | view.accessibilityTraits = ['button', 'selected'] |
规则有三条:
- ObjC 里声明成
getter=isXxx的布尔属性,JS 用isXxx这个名字读和写,比如isHidden。 - 多段的方法名,第一段是 JS 的方法名,其余各段是
options对象的键。 - ObjC 的四个
animateWithDuration:…在 JS 里是同一个方法。completion:这个参数换成了返回的 Promise。
参见
- 在屏幕上摆放视图、让视图动起来、用约束排版
NSLayoutConstraint:约束- 结构体:
CGRect、CGPoint、CGSize、UIEdgeInsets、CGAffineTransform - 手势识别器:让普通视图响应点按、长按、拖动、捏合、旋转、轻扫
- Core Animation:直接在图层上做动画,能做关键帧、沿路径运动、动画组
CALayer:圆角、边框、阴影、渐变- 颜色:
backgroundColor能写哪些值 - 单位:pt 是什么
UIWindow和UIViewController:视图树的根和页面UIStackView:把一组视图排成一行或一列,可以按内边距缩进- 外观特征:
traitCollection、overrideUserInterfaceStyle和traitchange事件 UIControl和UIButton:自带点按事件的视图UIWindowScene:场景被销毁后界面怎样被回收- 让读屏念对你的界面:标签、提示、值、特征和弹层
- 原生类:为什么不能继承,以及几种「没有原生对象」的报错