augmify / kinwebbrowser

A web browser module for your iOS apps.

KINWebBrowser

KINWebBrowser is a web browser module for your apps.

Powered by WKWebView on iOS 8. Backwards compatible with iOS 7 using UIWebView.

Features

• iOS 7 & 8 support for iPhone and iPad devices
• Safari-like interface
• Animated progress bar
• Customizable UI including tint color
• Portrait and landscape orientation support
• Use with existing UINavigationController or present modally
• Delegate protocol for status callbacks
• Action button to allow users to copy URL, share, or open in Safari & Google Chrome
• Supports subclassing
• Installation with CocoaPods

Overview

KINWebBrowser consists of a single component:

KINWebBrowserViewController - a UIViewController that contains a full featured web browser.

KINWebBrowserViewController must be contained in a UINavigationController.

Pushing to the navigation stack:

KINWebBrowserViewController *webBrowser = [KINWebBrowserViewController webBrowser];
[self.navigationController pushViewController:webBrowser animated:YES];
[webBrowser loadURLString:@"http://www.example.com"];

Presenting Modally:

UINavigationController *webBrowserNavigationController = [KINWebBrowserViewController navigationControllerWithWebBrowser];
[self presentViewController:webBrowserNavigationController animated:YES completion:nil];

KINWebBrowserViewController *webBrowser = [webBrowserNavigationController rootWebBrowserViewController];
[webBrowser loadURLString:@"http://www.example.com"];

Installation With CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects. See the "Getting Started" for more information.

Podfile

platform :ios, '7.0'
pod 'KINWebBrowser'

Customizing the User Interface

Tint Color

The tint color of the toolbars and toolbar items can be customized.

webBrowserViewController.tintColor = [UIColor blueColor];
webBrowserViewController.barTintColor = [UIColor blackColor];

Title Bar Content

The URL can be shown in the UINavigationBar while loading. The <title> of the page can be shown when loading completes.

webBrowserViewController.showsURLInNavigationBar = NO;
webBrowserViewController.showsPageTitleInNavigationBar = YES;

Implementing KINWebBrowserDelegate Protocol

KINWebBrowserDelegate is a set of @optional callback methods to inform the delegate of status changes.

- (void)webBrowser:(KINWebBrowserViewController *)webBrowser didStartLoadingURL:(NSURL *)URL;
- (void)webBrowser:(KINWebBrowserViewController *)webBrowser didFinishLoadingURL:(NSURL *)URL;
- (void)webBrowser:(KINWebBrowserViewController *)webBrowser didFailToLoadURL:(NSURL *)URL withError:(NSError *)error;