UIViewController:addChildViewController() 方法
addChildViewController() 方法把一个页面收成这个页面的子控制器。它只建立父子关系,不动视图。
语法
addChildViewController(child)参数
child
一个 UIViewController。它已经有父控制器时,先从那边移除。
返回值
无(undefined)。
异常
TypeError
- 给的不是页面:
addChildViewController needs a UIViewController。 - 把页面加成它自己的子控制器,或者把它的祖先加成它的子控制器:
addChildViewController: a view controller cannot be added as a child of itself or of one of its own descendants。原来的关系不变。
说明
完整的加入是三句,顺序固定:
parent.addChildViewController(child):建立父子关系。这一句会自动调child.willMoveToParentViewController(parent)。parent.view.addSubview(child.view):把它的视图放进来。child.didMoveToParentViewController(parent):告诉它已经放好了。
只做第 2 句,屏幕上看起来一样,但 child 不知道自己属于谁:它的 parentViewController 是 null,也没有被父页面保管。没有变量保存 child 时,页面对象会被回收,而它的视图还留在屏幕上。所以三句都要写。只做第 2 句的后果未在模拟器验证。
加入之后父控制器保管子控制器,不需要另外保存 child 变量。
示例
js
const page = new UIViewController();
const panel = new UIViewController();
panel.view.backgroundColor = 'systemTeal';
page.addChildViewController(panel);
panel.view.frame = new CGRect(20, 120, 280, 160);
page.view.addSubview(panel.view);
panel.didMoveToParentViewController(page);
console.log(page.childViewControllers.length);
console.log(panel.parentViewController === page);效果:page 上出现一块青色的矩形,宽 280 pt、高 160 pt。控制台输出 1 和 true。
对应的 iOS API
-[UIViewController addChildViewController:]。原生不检查成环,之后会崩溃;这里当场抛 TypeError。