自定义UIDocumentPickerViewController导航栏失效问题咨询

原因说明 #

UIDocumentPickerViewController本质是UIViewController，其内部自带的导航栏属于私有视图组件，不会遵从你全局设置的UINavigationBar.appearance()配置。只有tintColor作为UIView的通用属性可沿视图层级继承，其余导航栏样式配置默认不会生效。你用到的UIImagePickerViewController本身是UINavigationController的子类，所以会正常继承全局导航栏外观配置，二者的继承结构差异导致了配置生效的区别。

推荐解决方案 #

方案1：临时切换全局导航栏外观（适配所有iOS版本） #

在弹出UIDocumentPicker前覆盖全局导航栏样式，控制器关闭后还原原有全局配置：

// 1. 先保存原有的全局导航栏配置
let originalBarTintColor = UINavigationBar.appearance().barTintColor
let originalTitleTextAttributes = UINavigationBar.appearance().titleTextAttributes
let originalBackgroundImage = UINavigationBar.appearance().backgroundImage(for: .default)

// 2. 设置UIDocumentPicker需要的导航栏样式
UINavigationBar.appearance().barTintColor = .systemBlue
UINavigationBar.appearance().titleTextAttributes = [.foregroundColor: UIColor.white]

// 3. 初始化并弹出UIDocumentPicker
let documentPicker = UIDocumentPickerViewController(forOpeningContentTypes: [.image])
documentPicker.delegate = self
present(documentPicker, animated: true) {
    // 4. 弹出完成后立即还原全局配置，不影响后续其他页面
    UINavigationBar.appearance().barTintColor = originalBarTintColor
    UINavigationBar.appearance().titleTextAttributes = originalTitleTextAttributes
    UINavigationBar.appearance().setBackgroundImage(originalBackgroundImage, for: .default)
}

该方案适配全版本iOS系统，注意还原操作要在弹出动画完成后立即执行，避免影响其他页面的导航栏样式。

方案2：嵌入自定义UINavigationController（更稳定，无全局污染） #

将UIDocumentPickerViewController作为根控制器放入你自行创建的UINavigationController中，完全自定义该导航控制器的样式，不受系统限制：

let documentPicker = UIDocumentPickerViewController(forOpeningContentTypes: [.image])
documentPicker.delegate = self

// 创建自定义导航控制器
let customNav = UINavigationController(rootViewController: documentPicker)
// 直接自定义当前导航控制器的导航栏，完全可控
customNav.navigationBar.barTintColor = .systemBlue
customNav.navigationBar.titleTextAttributes = [.foregroundColor: UIColor.white]
customNav.navigationBar.tintColor = .white

// 弹出自定义的导航控制器即可
present(customNav, animated: true)

该方案不需要修改全局外观，不会影响其他页面，样式修改完全可控，适配iOS11及以上所有版本，不会因为系统升级失效。

注意事项 #

• 不要尝试直接遍历UIDocumentPicker的私有子视图修改导航栏，该操作可能触发苹果审核拒绝，且iOS版本升级后容易失效
• 若需要自定义导航栏按钮，可通过documentPicker.navigationItem设置左右按钮，会自动显示在自定义或者系统的导航栏上

内容的提问来源于stack exchange，提问作者Yash Jadhav