If you’re using a WebViewController to display a webpage in your app and have a navigation bar, it’s possible to change the Google-inspired progress bar that sits there. You can have two different types of progress bar, and customize the look and feel of the bar using styles.

Progress bars are one of the most powerful and useful technologies in any web application. However, they are often missing from web apps that don’t provide a good user experience. This is why we want to introduce a new progress bar to make it easier to add a progress bar to your web application.


A WebViewController implemented by WKWebView with a progress bar in the navigation bar. The WebViewController is safari-like web browser.


  • Progress bar in navigation bar
  • Bypass SSL according to the assigned hosts.( i.e., you can access the self-signed certificate websites with ProgressWebViewController)
  • Customize bar button items
  • Assign cookies to the web view
  • Browse the local html files
  • Support large titles for navigation bars in iOS 11
  • Support custom headers
  • Support custom user agent
  • Open the special urls including the app store, tel, mailto, sms, and _blank with other apps
  • Support the pull-to-refresh
  • Support the push navigation way





Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

Once you have your Swift package set up, adding ProgressWebViewController as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
.package(url: “https://github.com/kf99916/ProgressWebViewController.git”)


CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate ProgressWebViewController into your Xcode project using CocoaPods, specify it in your Podfile:

pod ‘ProgressWebViewController’



import ProgressWebViewController



A view controller with WKWebView and a progress bar in the navigation bar

var url: URL? the url to request
var tintColor: UIColor? the tint color for the progress bar, navigation bar, and tool bar
var delegate: ProgressWebViewControllerDelegate? the delegate for ProgressWebViewController
var scrollViewDelegate: ProgressWebViewControllerScrollViewDelegate? the delegate for scroll view
var bypassedSSLHosts: [String]? the bypassed SSL hosts. The hosts must also be disabled in the App Transport Security.
var cookies: [HTTPCookie]? the assigned cookies
var headers: [String: String]? the custom headers
var userAgent: String? the custom user agent
var urlsHandledByApp: [String: Any] configure the urls handled by other apps (default [ “hosts”: [“itunes.apple.com”], “schemes”: [“tel”, “mailto”, “sms”], “_blank”: true ])
var websiteTitleInNavigationBar = true show the website title in the navigation bar
var doneBarButtonItemPosition: NavigationBarPosition the position for the done bar button item. the done barbutton item is added automatically if the view controller is presented.(default .left)
var leftNavigaionBarItemTypes: [BarButtonItemType] configure the bar button items in the left navigation bar (default [])
var rightNavigaionBarItemTypes: [BarButtonItemType] configure the bar button items in the right navigation bar (default [])
var toolbarItemTypes: [BarButtonItemType] configure the bar button items in the toolbar of navigation controller (default [.back, .forward, .reload, .activity])
var navigationWay: [NavigationWay] configure the navigation way for clicking links (default .browser)
var pullToRefresh: Bool enable/disable the pull-to-refresh (default false)


You should set up the webview in loadView() and set up others in viewDidLoad()

class MyWebViewController: ProgressWebViewController {
override open func loadView() {

// set up webview, including cookies, headers, user agent, and so on.

override func viewDidLoad() {

// Do any additional setup after loading the view.

// Other methods


The delegate for ProgressWebViwController

optional func progressWebViewController(_ controller: ProgressWebViewController, canDismiss url: URL) -> Bool
optional func progressWebViewController(_ controller: ProgressWebViewController, didStart url: URL)
optional func progressWebViewController(_ controller: ProgressWebViewController, didFinish url: URL)
optional func progressWebViewController(_ controller: ProgressWebViewController, didFail url: URL, withError error: Error)
optional func progressWebViewController(_ controller: ProgressWebViewController, decidePolicy url: URL) -> Bool
optional func initPushedProgressWebViewController(url: URL) -> ProgressWebViewController


The delegate for scroll view

optional func scrollViewDidScroll(_ scrollView: UIScrollView)


The enum for bar button item

enum BarButtonItemType {
case back
case forward
case reload
case stop
case activity
case done
case flexibleSpace

The enum for position of bar button item in the navigation bar

enum NavigationBarPosition {
case none
case left
case right

The enum for navigation way

enum NavigationWay {
case browser
case push

Apps using ProgressWebViewController

If you are using ProgressWebViewController in your app and want to be listed here, simply create a pull request.

I am always curious who is using my projects 🙂

Hikingbook – by Zheng-Xiang Ke


ProgressWebViewControllerDemo is a simple demo app which browse the Apple website with ProgressWebViewController.


Zheng-Xiang Ke, [email protected]



stepped progress bar swift githubhorizontal progress bar ios githubcustom progress bar in swiftcircular progress bar ios swift githubjxwebviewcontrollertowebviewcontroller,People also search for,Privacy settings,How Search works,stepped progress bar swift github,circular progress bar with percentage display ios-swift github,horizontal progress bar ios github,custom progress bar in swift,circular progress bar ios swift github,jxwebviewcontroller,towebviewcontroller,wkwebview swift github

You May Also Like

How To Disable the Oracle WebLogic Server Default Welcome Page – The Geek Diary

Oracle has a default welcome page for their WebLogic Server (portal). I’m…

🥇 Privacy in WhatsApp Business  How does it work? ▷ 2021

WhatsApp Business has become an application specifically designed for the needs of…

16 Solutions To Fix Windows Spotlight Not Working Issue

The Windows Spotlight search feature is a fantastic tool, and it’s the…

How to configure Application Control for Macs on Sophos Central –

1. The purpose of This article explains how to manage access to…