Contents

william-weng/wwsafariviewui

English | 繁體中文

✨ 功能特色

  • 使用 SFSafariViewController 在 App 內開啟網頁，保留 Safari 的標準瀏覽體驗與安全性。
  • 提供 SwiftUI 友善的 API，直接以 View 方式整合到 sheet、fullScreenCover 等畫面流程中。
  • 支援 entersReaderIfAvailable，在 Safari Reader 模式可用時自動進入閱讀模式。
  • 支援 onFinish 回呼，可在使用者關閉 Safari 畫面時收到通知。

📦 安裝方式

Swift Package Manager

在 Xcode 中選擇：

  • File > Add Package Dependencies...
  • 輸入你的套件 Git URL
  • 選擇版本後加入專案

也可以手動加入 Package.swift：

.dependencies: [
    .package(url: "https://github.com/William-Weng/WWSafariViewUI.git", from: "1.1.0")
]

接著把套件產品加入 target：

targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "WWSafariViewUI", package: "WWSafariViewUI")
        ]
    )
]

🚀 快速開始

匯入套件

import SwiftUI
import WWSafariViewUI

基本用法

import SwiftUI
import WWSafariViewUI

struct ContentView: View {
    @State private var showSafari = false
    
    var body: some View {
        Button("開啟 Apple") {
            showSafari = true
        }
        .sheet(isPresented: $showSafari) {
            WWSafariViewUI(url: URL(string: "https://www.apple.com")!)
        }
    }
}

這種用法很適合用在說明頁、隱私權政策、幫助中心或外部文章連結，讓使用者不需要離開 App 就能瀏覽內容。

🎛️ 進階用法

自動進入閱讀模式

WWSafariViewUI(
    url: URL(string: "https://example.com/article")!,
    entersReaderIfAvailable: true
)

entersReaderIfAvailable 只有在 Safari Reader 模式支援該頁面時才會生效，通常適合一般文章頁，而不是 PDF 或原始 Markdown 檔案。

監聽事件

struct ContentView: View {
    
    @State private var showSafari = false
    
    var body: some View {
        Button("開啟 Apple") {
            showSafari = true
        }
        .sheet(isPresented: $showSafari) {
            WWSafariViewUI(url: URL(string: "https://www.apple.com")!)
                .onLoadComplete({ controller, didLoadSuccessfully in
                    print(didLoadSuccessfully)
                })
                .onFinish { controller in
                    print(controller)
                }
        }
    }
}

當使用者關閉 SFSafariViewController 時，delegate 會收到完成事件，你可以在這裡做收尾處理。

搭配 item-based sheet

struct IdentifiableURL: Identifiable {
    let id = UUID()
    let url: URL
}

struct ContentView: View {
    @State private var selectedURL: IdentifiableURL?
    
    var body: some View {
        Button("開啟網站") {
            selectedURL = .init(url: URL(string: "https://developer.apple.com")!)
        }
        .sheet(item: $selectedURL) { item in
            WWSafariViewUI(url: item.url)
        }
    }
}

這種寫法很適合和列表、卡片、書籤頁等情境搭配，能用狀態直接驅動畫面呈現。

🧩 API

初始化

public init(
    url: URL,
    entersReaderIfAvailable: Bool = false
)

| 參數 | 型別 | 說明 | |---|---|---| | url | URL | 要開啟的網址。 | | entersReaderIfAvailable | Bool | 是否在支援時自動進入閱讀器模式。 | | onLoadComplete | ((controller, didLoadSuccessfully) -> Void)? | Safari 載入完成時的回呼變數。 | | onFinish | ((controller) -> Void)? | Safari 畫面關閉時執行的回呼。 |

🎯 使用情境

WWSafariViewUI 適合以下場景：

  • App 內開啟外部文章或官方網站
  • 顯示隱私權政策、服務條款、幫助中心
  • 書籤、新聞、文件入口頁等需要快速開網頁的功能

如果你需要的是完整自訂網頁互動、注入 JavaScript 或控制瀏覽內容，WKWebView 會更適合；如果你要的是系統原生 Safari 體驗，SFSafariViewController 會是更好的選擇。

Package Metadata

Repository: william-weng/wwsafariviewui

Default branch: main

README: README.md