Swift中能否为UIBarItem使用PDF矢量图及实现方法问询

核心优势 #

使用PDF矢量图替代PNG的最大好处就是无损缩放，不管屏幕分辨率多高，图标都能保持清晰锐利，完美解决小尺寸位图画质损失的问题。

步骤1：准备并配置PDF资源 #

首先你需要确保你的PDF是纯矢量格式（不是位图转的PDF），并且是单页、无多余空白的。然后在Xcode中导入PDF到Asset Catalog，做以下配置：

• 选中Asset里的PDF文件，在右侧属性面板将Scales设置为Single Scale
• 根据需求设置Render As：
  • 选Template Image：可以通过tintColor修改图标颜色，适配App主题
  • 选Original Image：保留PDF本身的颜色

步骤2：代码示例 #

下面分两种常见场景给出代码，涵盖Swift和Objective-C：

场景1：直接创建UIBarButtonItem（无需导航栏引用）

大多数情况下，你不需要单独创建导航栏的引用，通过navigationItem就能直接设置按钮：

// Swift示例
override func viewDidLoad() {
    super.viewDidLoad()
    
    // 从Asset加载PDF图片，设置渲染模式为Template（支持tintColor）
    guard let pdfIcon = UIImage(named: "YourPDFIcon")?.withRenderingMode(.alwaysTemplate) else { return }
    
    // 创建UIBarButtonItem
    let customBarButton = UIBarButtonItem(image: pdfIcon, style: .plain, target: self, action: #selector(barButtonTapped))
    
    // 添加到导航栏右侧（也可以设置为leftBarButtonItem）
    navigationItem.rightBarButtonItem = customBarButton
    
    // 统一设置导航栏图标颜色（可选）
    navigationController?.navigationBar.tintColor = .systemBlue
}

@objc private func barButtonTapped() {
    // 按钮点击事件逻辑
    print("Bar button tapped!")
}

// Objective-C示例
- (void)viewDidLoad {
    [super viewDidLoad];
    
    // 加载PDF图片并设置渲染模式
    UIImage *pdfIcon = [[UIImage imageNamed:@"YourPDFIcon"] imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
    
    // 创建UIBarButtonItem
    UIBarButtonItem *customBarButton = [[UIBarButtonItem alloc] initWithImage:pdfIcon style:UIBarButtonItemStylePlain target:self action:@selector(barButtonTapped)];
    
    // 添加到导航栏右侧
    self.navigationItem.rightBarButtonItem = customBarButton;
    
    // 设置导航栏图标颜色
    self.navigationController.navigationBar.tintColor = [UIColor systemBlueColor];
}

- (void)barButtonTapped {
    NSLog(@"Bar button tapped!");
}

场景2：修改已有导航栏按钮（需要导航栏引用的情况）

如果你需要修改导航栏本身的属性，或者访问导航栏的子视图，才需要获取导航栏的引用：

// Swift示例
if let navBar = navigationController?.navigationBar {
    // 修改导航栏背景色
    navBar.backgroundColor = .systemBackground
    
    // 更新左侧按钮为PDF图标
    guard let pdfIcon = UIImage(named: "BackIconPDF")?.withRenderingMode(.alwaysTemplate) else { return }
    let backButton = UIBarButtonItem(image: pdfIcon, style: .plain, target: self, action: #selector(goBack))
    navigationItem.leftBarButtonItem = backButton
}

是否需要创建导航栏引用？ #

大多数情况下不需要。你可以直接通过navigationItem来添加或修改UIBarItem，无需单独持有导航栏的引用。只有当你需要调整导航栏的整体样式（比如背景色、透明度），或者需要操作导航栏的子视图时，才需要获取navigationController?.navigationBar的引用。

额外注意事项 #

• 确保你的PDF是纯矢量图：如果是用位图导出的PDF，依然会有画质损失
• iOS 13及以上系统对矢量PDF的支持更完善，无需额外兼容处理
• 如果需要保留PDF的原始颜色，记得将Render As设置为Original Image，并且不要使用withRenderingMode(.alwaysTemplate)

内容的提问来源于stack exchange，提问作者Pietro Messineo