swift

Preview Document File sử dụng Quick Look Framework

Đối với một Dev iOS chắc hẳn chung ta đã sử dụng qua rất nhiều các famework, trong số có Quick Look Framework. Chỉ cần thông qua tên gọi chúng ta cũng có thể tưởng tượng được nó được dùng với mục đích gì, đó là xem các file tài liệu mà ứng dụng xử lý. Quck Look rất dễ dàng để sử dụng và nó hỗ trợ các file tài liệu như:

  • iWork
  • Microsoft Office document
  • PDF
  • Images
  • Rick - Text format document
  • Comma - separated value file (csv)

Quick Look Framework cung cấp cho chúng ta datasource để chứa file sẽ preview. Nó thực chất là danh sách các NSURL lưu path tới các file document. Ngoài ra framework này còn cung cấp một Viewcontroller có tên là QLPreviewController để hỗ trợ việc preview. Nó sẽ yêu cầu chúng ta implementation hai phương thức của QLPreviewControllerDataSource protocol. Bên cạnh đó, nó còn có các phương thức hỗ trợ được chứa trong QLPreviewControllerDelegate protocol. Giờ hãy bắt đầu bắt tay vào thử nghiệm nó 😄

1. Khởi tạo project

Tạo một project demo, tiếp đó chúng ta sử dụng một UITableView để hiển thị danh sách các file sẽ preview

Tiến hành add các file demo vào trong project

2. Khởi tạo TableView để hiển thị danh sách

Triển khải UITableViewDatasource để hiển thị

import UIKit

class ViewController: UIViewController {

    // Outlet
    
    @IBOutlet private weak var tableView: UITableView!
    
    // Property
    
    let fileNames = ["Demo-Image.jpeg",
                     "Demo-Keynote.key",
                     "Demo-Pages.pages",
                     "Demo-PDF.pdf",
                     "Demo-Text.txt",
                     "Demo-Word.docx"]
    
    // Life circle
    
    override func viewDidLoad() {
        super.viewDidLoad()
        title = "Demo Preview"
    }
}
extension ViewController: UITableViewDataSource, UITableViewDelegate {
    
    func numberOfSections(in tableView: UITableView) -> Int {
        return 1
    }
    
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return fileNames.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        guard let cell = tableView.dequeueReusableCell(withIdentifier: "cell") else {
            return UITableViewCell()
        }
        cell.textLabel?.text = fileNames[indexPath.row]
        return cell
    }
    
    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
        return 80.0
    }
    
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
          // TODO: next step
    }
}

Kết quả:

3. Khởi tạo QLPreviewController để hiển thị file

  • Chuyển đổi File name sang URL Khởi tạo thêm thuộc tính fileURLs để lưu trữ path các file. Tiếp theo chúng ta tạo hàm get listURL vào gọi nó trong viewDidLoad
    func prepareFileURLs() {
        for file in fileNames {
            let fileParts = file.components(separatedBy: ".")
            if let fileURL = Bundle.main.url(forResource: fileParts[0], withExtension: fileParts[1]) {
                if FileManager.default.fileExists(atPath: fileURL.path) {
                    fileURLs.append(fileURL)
                }
            }
        }
    }
  • Khai báo thuộc tính qlPreviewController để hỗ trợ preview
     let quickLookController = QLPreviewController()

Bạn đừng quên setDatasource cho QLPreview để có thể tiến hành chuẩn bị cho việc Preview

    override func viewDidLoad() {
        super.viewDidLoad()
        quickLookController.dataSource = self
        prepareFileURLs()
        title = "Demo Preview"
    }
  • Triển khai các phương thức trong QLPreviewControllerDataSource:
 extension ViewController: QLPreviewControllerDataSource {
    func numberOfPreviewItems(in controller: QLPreviewController) -> Int {
        return fileNames.count
    }
    
    func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
        return fileURLs[index] as QLPreviewItem
    }
}
  • Trong hàm didSelectRowAt của UITableViewDelegate xử lý push qlPreview để hiển thị
 func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        if QLPreviewController.canPreview(fileURLs[indexPath.row] as QLPreviewItem) {
            quickLookController.currentPreviewItemIndex = indexPath.row
            navigationController?.pushViewController(quickLookController, animated: true)
        }
    }

4. Kết quả

Trong khi preview chúng ta có thêm một số chức năng như chia sẻ hay xem danh sách các file

Ngoài ra các bạn có thể thử thêm các hàm xử lý với QLPreviewControllerDelegate 😄

Link demo Project: https://github.com/thanhlong12312/DemoPreviewFile

Cảm ơn các bạn đã dành thời gian để theo dõi !

Registration Login
Sign in with social account
or
Lost your Password?
Registration Login
Sign in with social account
or
A password will be send on your post
Registration Login
Registration