UIView:insertSubview() 方法
insertSubview() 方法把一个视图加为子视图,并指定它在叠放顺序里的位置。
语法
insertSubview(view, { atIndex })
insertSubview(view, { belowSubview })
insertSubview(view, { aboveSubview })参数
view
要加入的 UIView。
options.atIndex
放在 subviews 的第几位。从 0 开始的整数,0 是最下层。按整数转换:'0' 得到 0,小数向零取整。
options.belowSubview
一个子视图。view 放在它的下面一层。
options.aboveSubview
一个子视图。view 放在它的上面一层。
三个键选一个。
返回值
无(undefined)。
异常
TypeError
options里三个键都没有:insertSubview needs one of { atIndex } / { belowSubview } / { aboveSubview }。atIndex转不出有限的数:atIndex must be a finite number, got NaN,got后面是收到的值。- 参数不是视图(别的原生对象、
null、数字,或者没传):insertSubview needs a UIView。 - 其余情况和
addSubview()相同。
出错时视图树不变。
说明
view 已经有父视图时,先从原来的父视图里移除。未在模拟器验证。
示例
js
const page = new UIView();
const a = new UIView();
a.frame = new CGRect(40, 300, 120, 120);
a.backgroundColor = 'systemRed';
page.addSubview(a);
const c = new UIView();
c.frame = new CGRect(70, 330, 120, 120);
c.backgroundColor = 'systemOrange';
page.insertSubview(c, { belowSubview: a });
console.log(page.subviews[0] === c);效果:橙色方块加入到红色方块的下面一层,两者重叠的地方显示红色。控制台输出 true。
对应的 iOS API
-[UIView insertSubview:atIndex:]、insertSubview:belowSubview:、insertSubview:aboveSubview: 在 JS 里是同一个方法,第二段写成 options 的键。