A simple view controller for navigating web pages using WKWebView. iOS 8.1+.
Supports Swift 3.0 and iOS 10 SDK. For Swift 2 support go here
- A browser-like view controller to support web pages navigation in your Swift app.
- Supports back-forward navigation and page refresh action.
- Supports back-forward swipe gestures.
- Has built-in activity indicators (both progress view and activity indicator).
Just grab two files GDWebViewController.swift
and GDWebViewNavigationToolbar.swift
into your project.
You can download GDWebBrowserClient
project as well to see how it can be used.
CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate GDWebViewController into your Xcode project using CocoaPods, specify it in your Podfile
:
pod 'GDWebViewController'
weak var delegate: GDWebViewControllerDelegate?
An object to serve as a delegate which conforms to GDWebViewNavigationToolbarDelegate protocol.
var progressIndicatorStyle: GDWebViewControllerProgressIndicatorStyle = .Both
The style of progress indication visualization. Can be one of four values: .ActivityIndicator, .ProgressView, .Both, .None
var allowsBackForwardNavigationGestures: Bool
A Boolean value indicating whether horizontal swipe gestures will trigger back-forward list navigations. The default value is false.
var showsToolbar: Bool
A boolean value if set to true shows the toolbar; otherwise, hides it.
var showsStopRefreshControl: Bool
A boolean value if set to true shows the refresh control (or stop control while loading) on the toolbar; otherwise, hides it.
var toolbar: GDWebViewNavigationToolbar
The navigation toolbar object (read-only).
var allowJavaScriptAlerts: Bool
Boolean flag which indicates whether JavaScript alerts are allowed. Default is true
.
func loadURLWithString(_ URLString: String)
Navigates to an URL created from provided string.
func loadURL(_ URL: Foundation.URL, cachePolicy: NSURLRequest.CachePolicy = .useProtocolCachePolicy, timeoutInterval: TimeInterval = 0)
Navigates to the URL.
func showToolbar(_ show: Bool, animated: Bool)
Shows or hides toolbar.
func evaluateJavaScript(_ javaScriptString: String, completionHandler: ((AnyObject?, NSError?) -> Void)?)
Evaluates the given JavaScript string.
@objc public protocol GDWebViewControllerDelegate {
@objc optional func webViewController(_ webViewController: GDWebViewController, didChangeURL newURL: URL?)
@objc optional func webViewController(_ webViewController: GDWebViewController, didChangeTitle newTitle: NSString?)
@objc optional func webViewController(_ webViewController: GDWebViewController, didFinishLoading loadedURL: URL?)
@objc optional func webViewController(_ webViewController: GDWebViewController, decidePolicyForNavigationAction navigationAction: WKNavigationAction, decisionHandler: (WKNavigationActionPolicy) -> Void)
@objc optional func webViewController(_ webViewController: GDWebViewController, decidePolicyForNavigationResponse navigationResponse: WKNavigationResponse, decisionHandler: (WKNavigationResponsePolicy) -> Void)
@objc optional func webViewController(_ webViewController: GDWebViewController, didReceiveAuthenticationChallenge challenge: URLAuthenticationChallenge, completionHandler: (URLSession.AuthChallengeDisposition, URLCredential?) -> Void)
}
Notice:
You must do import WebKit
if you use last three methods from GDWebViewControllerDelegate
description.
var toolbarTintColor: UIColor?
The tint color to apply to the toolbar button items.
var toolbarBackgroundColor: UIColor?
The toolbar's background color.
var toolbarTranslucent: Bool
A Boolean value that indicates whether the toolbar is translucent (true) or not (false).
Published under MIT license. If you have any feature requests, please create an issue. Smart pull requests are also welcome.