vistar941/inappsafarikit

[日本語はこちら](README-ja.md)

Features

Opens URLs from Link within the app using SFSafariViewController.
Allows customization of various settings and presentation styles of SFSafariViewController.
Default settings can be changed with @Environment(\.customSafariStyle).

Requirements

iOS 15.0+
Xcode 16.0+

Installation

You can install InAppSafariKit using Swift Package Manager (SPM).

Open your project in Xcode.
Select File > Add Package Dependency...
Enter https://github.com/Chronos2500/InAppSafariKit.git.
Set the version rule and other settings, then click Add Package.

Usage

Basic Usage

import SwiftUI
import InAppSafariKit

struct ContentView: View {
    private let url = URL(string: "https://www.apple.com")!
    var body: some View {
        NavigationStack{
            Form{
                Link("Open Default Browser", destination: url)
                Link("Open by InAppSafariKit (Default)", destination: url)
                    .OpenURLInAppSafari()
                
            }
        }
    }
}

Simply add the .OpenURLInAppSafari() modifier to a Link to open the link within the app using SFSafariViewController. To apply it to all links within the app, add the .OpenURLInAppSafari() modifier to the parent View. By default, SFSafariViewController is configured as follows:

entersReaderIfAvailable: false
barCollapsingEnabled: true
dismissButtonStyle: .done
preferredBarTintColor: nil
preferredControlTintColor: nil
modalPresentationStyle: .fullScreen

For a detailed example, see the project in the Examples folder.

Customization

You can customize the settings and presentation animation of SFSafariViewController using the .OpenURLInAppSafari() modifier.

Link("Custom Bar Colors", destination: url)
    .OpenURLInAppSafari(
        preferredBarTintColor: .purple,
        preferredControlTintColor: .white
    )

Customization Examples

<table> <tr> <td align="center"><img src="Assets/Demo01.gif" width="150"></td> <td align="center"><img src="Assets/Demo02.gif" width="150"></td> </tr> <tr> <td align="center">Open by InAppSafariKit (Default)</td> <td align="center"><code>preferredBarTintColor = .purple</code></td> </tr> </table>

<table> <tr> <td align="center"><img src="Assets/Demo03.gif" width="150"></td> <td align="center"><img src="Assets/Demo04.gif" width="150"></td> </tr> <tr> <td align="center"><code>modalPresentationStyle = .pageSheet</code></td> <td align="center"><code>modalPresentationStyle = .overFullScreen</code></td> </tr> </table>

Default Settings

You can change the default style for child views and beyond by using the customSafariStyle environment variable on the parent view.

@main
struct InAppSafariKitExampleApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.customSafariStyle,CustomSafariStyle(dismissButtonStyle: .cancel,preferredBarTintColor: .gray))
        }
    }
}

License

This project is released under the MIT License.

Package Metadata

Repository: vistar941/inappsafarikit

Default branch: main

README: README.md