PBWebViewController 0.5.0

PBWebViewController 0.5.0

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Feb 2016

Maintained by Mikael Konutgan.



  • By
  • Mikael Konutgan

PBWebViewController is a light-weight, simple and customizable web browser component for iOS. It's just 2 source files, image-free, around 300 lines of code and has been built with modern Cocoa development techniques.

PBWebViewController Screenshot

Installation

Just drag the PBWebViewController folder to your project or add pod 'PBWebViewController' to your Podfile.

Usage

PBWebViewController works on iPhone and iPad, in all orientations and is meant to be used in a UINavigationController. All you need to do is set up it's properties and then push it. Here's a simple example:

// Initialize the web view controller and set it's URL
self.webViewController = [[PBWebViewController alloc] init];
self.webViewController.URL = [NSURL URLWithString:@"http://www.apple.com"];

// These are custom UIActivity subclasses that will show up in the UIActivityViewController
// when the action button is clicked
PBSafariActivity *activity = [[PBSafariActivity alloc] init];
self.webViewController.applicationActivities = @[activity];

// This property also corresponds to the same one on UIActivityViewController
// Both properties do not need to be set unless you want custom actions
self.webViewController.excludedActivityTypes = @[UIActivityTypeMail, UIActivityTypeMessage, UIActivityTypePostToWeibo];

// Push it
[self.navigationController pushViewController:self.webViewController animated:YES];

See the example project for more advanced usage.

Subclassing Notes

PBWebViewController can safely be subclassed to implement custom behavior. Override load and the UIWebViewDelegate methods to hook in, just don't forget to call super to take advantage of what PBWebViewController provides.

A simple subclass is used in the example project.

Notes on custom activity items and application activities

PBWebViewController sets the current URL as the only activity item, if none or provided, otherwise the activity items you provide are used. You can fully customize everything that shows up when the action button is clicked this way.

Another way to achieve the same result is to override activityItems and applicationActivities in a subclass.

Check out the action: method in PBWebViewController.m for more details.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request