MacOS应用：如何实现NSPageController垂直导航及替代方案？

首先明确：NSPageController本身不支持垂直导航，它的设计原生基于水平方向页面切换，没有提供类似iOS中UIPageViewController的navigationOrientation属性来修改导航方向。

如果要实现左侧菜单触发右侧面板切换的需求，可以考虑以下几种替代方案：

方案一：自定义容器视图控制器 #

手动管理子视图控制器的生命周期和切换逻辑，同时可自定义垂直方向的过渡动画，灵活性最高。

示例Swift代码：

class VerticalPanelContainer: NSViewController {
    private var currentPanelVC: NSViewController?

    // 切换到目标面板视图控制器
    func switchToPanel(_ targetVC: NSViewController) {
        // 移除当前面板
        currentPanelVC?.view.removeFromSuperview()
        currentPanelVC?.removeFromParent()

        // 添加新面板
        addChild(targetVC)
        targetVC.view.frame = view.bounds
        targetVC.view.autoresizingMask = [.width, .height]
        
        // 自定义垂直滑入动画（从下方进入）
        targetVC.view.animator().frame.origin.y = view.bounds.height
        view.addSubview(targetVC.view)
        targetVC.view.animator().frame.origin.y = 0

        currentPanelVC = targetVC
    }
}

方案二：使用NSSplitViewController #

你的「左侧固定菜单+右侧动态面板」场景，非常贴合NSSplitViewController的设计定位。左侧作为固定的split item，右侧的split item可直接替换视图控制器，无需额外处理复杂切换逻辑，也符合MacOS人机交互规范。

示例Swift代码：

// 假设已初始化splitViewController，左侧菜单是第一个split item
func updateRightPanel(with vc: NSViewController) {
    guard let rightSplitItem = splitViewController.splitViewItems.last else { return }
    rightSplitItem.viewController = vc
}

方案三：NSStackView配合视图切换 #

如果面板数量不多，可将所有面板视图添加到垂直方向的NSStackView中，通过隐藏/显示目标视图或调整arrangedSubviews数组实现切换。这种方式实现简单，但面板过多时会占用额外内存。

示例Swift代码：

// 假设stackView是垂直方向的NSStackView，已提前添加所有面板视图
func showPanel(at index: Int) {
    stackView.arrangedSubviews.enumerated().forEach { idx, view in
        view.isHidden = idx != index
        // 可选：添加淡入淡出动画
        view.animator().alphaValue = idx == index ? 1.0 : 0.0
    }
}

内容的提问来源于stack exchange，提问作者Kyung Lee