Skip to content

UINavigationController:pushViewController() 方法 ​

pushViewController() 方法把一个页面推入栈顶,屏幕切换到这个页面。

语法 ​

pushViewController(viewController)
pushViewController(viewController, { animated })

参数 ​

viewController

要推入的页面,UIViewController。

options.animated

布尔值,可选。true:从右边滑入。false 或不写:直接换过去,没有动画。

返回值 ​

无(undefined)。

异常 ​

TypeError

  • 参数不是页面:pushViewController: expects a UIViewController。
  • 推入的页面正在做窗口的根页面:信息以 pushViewController: 开头,后面是系统给出的原因。窗口和栈都保持原样。

说明 ​

  • 推入之后不用保存页面:导航控制器保管它,见栈里的页面由谁保管。
  • 同一个页面对象不能在栈里出现两次。把已经在栈里的页面再推入一次的结果未在模拟器验证。要显示两个内容相同的页面,建两个页面对象。
  • 推入时派发 beforeshow 和 show(实测)。

示例 ​

js
const nav = new UINavigationController(new UIViewController());
const detail = new UIViewController();
detail.title = '详情';
nav.pushViewController(detail, { animated: true });

console.log(nav.topViewController === detail);
console.log(detail.navigationController === nav);

效果:nav 在屏幕上时,屏幕带着动画切换到 detail。控制台输出 true 和 true。

对应的 iOS API ​

-[UINavigationController pushViewController:animated:]。

参见 ​