KINWebBrowser

KINWebBrowser is a web browser module for your apps.

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 rootWebBrowser];
[webBrowser loadURLString:@"http://www.example.com"];

Installation

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'

Dependencies

These dependency projects should be also installed with KINWebBrowser. They are installed automatically when installing KINWebBrowser with CocoaPods.

TUSafariActivity - a UIActivity subclass that provides an "Open In Safari" action to a UIActivityViewController
ARChromeActivity - a UIActivity subclass that provides an "Open In Google Chrome" action to a UIActivityViewController

Customizing the User Interface

Tint Color

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

webBrowser.tintColor = [UIColor blueColor];
webBrowser.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.

webBrowser.showsURLInNavigationBar = NO;
webBrowser.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;

MuhammadAhmedBaig/KINWebBrowser