寻求Swift版macOS简易SplitView模板及NSSplitViewController视图切换实现方案

Hey there! I’ve run into this exact issue when building my own macOS utility apps, so let’s walk through how to fix it step by step.

1. Fixing the Right Panel View Controller Switching #

First, let’s make sure we’re correctly loading the view controllers from your storyboard/NIB and updating the split view item. Here’s a concrete implementation:

Step 1: Set Up Storyboard IDs #

In your storyboard, assign unique identifiers to each of your content view controllers:

• HomeViewController → HomeVC
• DashboardViewController → DashboardVC
• SettingsViewController → SettingsVC

Step 2: Handle Sidebar Selection #

Assuming your sidebar is an NSTableView inside a SidebarViewController, add this code to handle row selection changes:

import Cocoa

class SidebarViewController: NSViewController, NSTableViewDataSource, NSTableViewDelegate {
    
    @IBOutlet weak var tableView: NSTableView!
    // Cache view controllers to avoid reloading them every time
    private var vcCache: [String: NSViewController] = [:]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        tableView.delegate = self
        tableView.dataSource = self
        // Select the first row by default
        tableView.selectRowIndexes(IndexSet(integer: 0), byExtendingSelection: false)
    }
    
    // MARK: - Table View Data Source
    func numberOfRows(in tableView: NSTableView) -> Int {
        return 3 // Home, Dashboard, Settings
    }
    
    func tableView(_ tableView: NSTableView, viewFor tableColumn: NSTableColumn?, row: Int) -> NSView? {
        guard let cell = tableView.makeView(withIdentifier: NSUserInterfaceItemIdentifier("SidebarCell"), owner: self) as? NSTableCellView else { return nil }
        switch row {
        case 0: cell.textField?.stringValue = "Home"
        case 1: cell.textField?.stringValue = "Dashboard"
        case 2: cell.textField?.stringValue = "Settings"
        default: break
        }
        return cell
    }
    
    // MARK: - Handle Selection Change
    override func tableViewSelectionDidChange(_ notification: Notification) {
        guard let splitVC = parent as? NSSplitViewController else {
            print("Could not access parent split view controller")
            return
        }
        guard let selectedRow = tableView.selectedRow, selectedRow >= 0 else { return }
        
        let vcID: String
        switch selectedRow {
        case 0: vcID = "HomeVC"
        case 1: vcID = "DashboardVC"
        case 2: vcID = "SettingsVC"
        default: vcID = "HomeVC"
        }
        
        // Get or create the target view controller
        let targetVC: NSViewController
        if let cachedVC = vcCache[vcID] {
            targetVC = cachedVC
        } else {
            targetVC = storyboard!.instantiateViewController(withIdentifier: vcID)
            vcCache[vcID] = targetVC
        }
        
        // Update the right split view item
        let rightSplitItem = splitVC.splitViewItems[1]
        rightSplitItem.viewController = targetVC
        
        // Force layout update to ensure the new view displays correctly
        splitVC.view.layoutSubtreeIfNeeded()
    }
}

If You’re Using NIBs Instead of Storyboards #

Replace the instantiation line with:

targetVC = NSViewController(nibName: vcID, bundle: nil)

2. Swift macOS SplitView Template Development Direction #

Here are some key practices to build a robust split view template:

• Sidebar Flexibility:
  • Use NSOutlineView instead of NSTableView if you plan to add nested menu items later.
  • Add custom styling for selected rows (e.g., background color change) to improve UX.
• ViewController Management:
  • Use the caching pattern above to avoid reinitializing view controllers repeatedly (preserves state if needed).
  • Implement a delegate protocol if your sidebar is a separate component, instead of directly accessing the parent split VC.
• State Persistence:
  • Save the last selected sidebar row to UserDefaults so the app remembers the user’s last view on launch:

    // Save selection
    UserDefaults.standard.set(selectedRow, forKey: "LastSelectedSidebarRow")
    // Load on launch
    let lastRow = UserDefaults.standard.integer(forKey: "LastSelectedSidebarRow")
    tableView.selectRowIndexes(IndexSet(integer: lastRow), byExtendingSelection: false)
    

• Responsive Layout:
  • Set a minimum width for the sidebar in the split view to prevent it from being dragged too small.
  • Use auto layout in your content view controllers to ensure they adapt to window resizing.

Common Pitfalls to Avoid #

• Forgetting to set the storyboard ID for your view controllers (this will cause a crash when instantiating).
• Not casting the parent view controller correctly to NSSplitViewController (always add a guard clause to handle this safely).
• Skipping the layoutSubtreeIfNeeded() call, which can lead to the new view not displaying immediately.

内容的提问来源于stack exchange，提问作者Peter Van de Put