Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dfmuir/KINWebBrowser
A web browser module for your iOS apps.
https://github.com/dfmuir/KINWebBrowser
Last synced: about 2 months ago
JSON representation
A web browser module for your iOS apps.
- Host: GitHub
- URL: https://github.com/dfmuir/KINWebBrowser
- Owner: dfmuir
- License: other
- Created: 2014-02-05T02:19:54.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-10-12T12:12:51.000Z (almost 4 years ago)
- Last Synced: 2024-07-23T06:44:59.619Z (2 months ago)
- Language: Objective-C
- Homepage:
- Size: 157 KB
- Stars: 838
- Watchers: 28
- Forks: 167
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
KINWebBrowser
==========
KINWebBrowser is a web browser module for your apps.
Powered by [WKWebView](https://developer.apple.com/library/IOs/documentation/WebKit/Reference/WKWebView_Ref/index.html) on iOS 8. Backwards compatible with iOS 7 using [UIWebView](https://developer.apple.com/library/ios/documentation/Uikit/reference/UIWebView_Class/index.html).
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](http://cocoapods.org/)
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:**
```objective-c
KINWebBrowserViewController *webBrowser = [KINWebBrowserViewController webBrowser];
[self.navigationController pushViewController:webBrowser animated:YES];
[webBrowser loadURLString:@"http://www.example.com"];
```
**Presenting Modally:**
```objective-c
UINavigationController *webBrowserNavigationController = [KINWebBrowserViewController navigationControllerWithWebBrowser];
[self presentViewController:webBrowserNavigationController animated:YES completion:nil];
KINWebBrowserViewController *webBrowser = [webBrowserNavigationController rootWebBrowser];
[webBrowser loadURLString:@"http://www.example.com"];
```
Installation
------------------------
#### CocoaPods
[CocoaPods](http://cocoapods.org) 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](http://guides.cocoapods.org/using/getting-started.html).
###### Podfile
```ruby
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](https://github.com/davbeck/TUSafariActivity) - a UIActivity subclass that provides an "Open In Safari" action to a UIActivityViewController
* [ARChromeActivity](https://github.com/alextrob/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;
```