KNAXWebViewController
➜ AXWebViewController git:(master) ✗ kngit 0.7.4
➜ AXWebViewController git:(master) git tag -a 0.7.4 -m "0.7.4"
➜ AXWebViewController git:(master) git push origin --tags
➜ AXWebViewController git:(master) ✗ pod lib lint KNAXWebViewController.podspec --allow-warnings --no-clean
pod trunk push KNAXWebViewController.podspec --allow-warnings
参见
确保在 Xcode -> 窗口 -> 设备中至少列出了一个 ios 模拟器或在验证过程中添加一个.
➜ AXWebViewController git:(master) ✗ sudo gem install cocoapods
摘要
AXWebViewController 是一款基于 WKWebView(WebKit) 封装的 view controller，高度集成，一行代码即可使用；能够满足大部分的 App 加载 html 网页的场景，AXWebViewController 实现了 WKUIDelegate 和 WKNavigationDelegate 两个协议，在使用过程中，若需要自定义功能，可自行 Overrides 相关方法予以实现；
AXWebViewController 可实现 微信样式 的网页浏览导航控制，可在导航栏显示 返回 和 关闭 两个功能按钮，这个功能主要基于 AXNavigationBackItemInjection 而实现，AXNavigationBackItemInjection 可以拦截点击返回导航或者手势滑动返回，有兴趣的朋友可以了解了解！
特性
- 手势滑动返回上一页面
- 微信样式导航返回、关闭
- 网页加载失败提示
- 网页加载进度提示
- 网页来源host提示
- 支持__Peek__和__Pop__浏览网页，并且提交后在本网页进行加载，无需跳转到Safari进行浏览，这里使用了众多运行时方法，因此，请谨慎使用！
需求
AXWebViewController 对系统版本支持到iOS7.0；版本0.7.0以后仅支持Xcode9，需要使用到：
- Foundation.framework
- UIKit.framework
使用时最好使用最新版Xcode。
将AXWebViewController添加到项目中
CocoaPods
CocoaPods 是将AXWebViewController添加到项目的推荐方式。
- 在你的Podfile中添加
AXWebViewController的引用：pod 'AXWebViewController', '~> 0.6.0' - 通过运行
pod install来安装pod。 - 在你的项目中任何需要的地方添加
AXWebViewController，方式为#import "AXWebViewController.h"。
源文件
或者，你可以直接将路径 */AXWebViewController/下的源文件添加到你的项目中。
- 下载最新代码版本 （点击此处） 或者将仓库作为git子模块添加到你的git跟踪项目。
- 在Xcode中打开你的项目，然后拖动源文件到项目中（使用“Product Navigator view”）。如果你在项目外提取了代码存档，请确保选择复制项目。
- 在你的项目中任何需要的地方添加
AXWebViewController，方式为#import "AXWebViewController.h"。
许可证
本代码遵循MIT许可证的条款和条件进行分发。
使用方法
将AXWebViewController的使用与普通UIViewController一样简单，只需在需要使用的地方使用URL初始化即可：
AXWebViewController *webVC = [[AXWebViewController alloc] initWithAddress:@"http://www.baidu.com"];
webVC.showsToolBar = NO;
webVC.navigationController.navigationBar.translucent = NO;
self.navigationController.navigationBar.tintColor = [UIColor colorWithRed:0.100f green:0.100f blue:0.100f alpha:0.800f];
self.navigationController.navigationBar.barTintColor = [UIColor colorWithRed:0.996f green:0.867f blue:0.522f alpha:1.00f];
[self.navigationController pushViewController:webVC animated:YES];
使用工具条导航
使用工具条只需在AXWebViewController初始化之后加入一句代码：
webVC.navigationType = AXWebViewControllerNavigationToolItem;
webVC.showsToolBar = YES;
注意，设置navigationType为AXWebViewControllerNavigationToolItem后，需要确保showsToolBar为YES才能生效。
使用微信样式导航
在AXWebViewController初始化之后加入一句代码：
webVC.navigationType = AXWebViewControllerNavigationBarItem;
即可生效。
Peek & Pop
Peek和Pop使用原生的系统功能，在使用时只需要将webView.allowsLinkPreview设置为YES即可。需要注意的是，在实现Peek和Pop时，使用了Runtime的相关知识，并且使用了AOP框架__Aspects__进行编程，使用过程中可能会遇到错误，当然，出错的可能性也很小（苹果不太可能频繁修改自家的私有API）。实现原理就不再详述，基本上就是运行时的一些知识，代码如下：
- (void)hookWebContentCommitPreviewHandler {
// Find the `WKContentView` in the webview.
__weak typeof(self) wself = self;
for (UIView *_view in _webView.scrollView.subviews) {
if ([_view isKindOfClass:NSClassFromString(@"WKContentView")]) {
id _previewItemController = object_getIvar(_view, class_getInstanceVariable([_view class], "_previewItemController"));
Class _class = [_previewItemController class];
SEL _performCustomCommitSelector = NSSelectorFromString(@"previewInteractionController:interactionProgress:forRevealAtLocation:inSourceView:containerView:");
[_previewItemController aspect_hookSelector:_performCustomCommitSelector withOptions:AspectPositionAfter usingBlock:^() {
UIViewController *pred = [_previewItemController valueForKeyPath:@"presentedViewController"];
[pred aspect_hookSelector:NSSelectorFromString(@"_addRemoteView") withOptions:AspectPositionAfter usingBlock:^() {
UIViewController *_remoteViewController = object_getIvar(pred, class_getInstanceVariable([pred class], "_remoteViewController"));
[_remoteViewController aspect_hookSelector:@selector(viewDidLoad) withOptions:AspectPositionAfter usingBlock:^() {
_remoteViewController.view.tintColor = wself.navigationController.navigationBar.tintColor;
} error:NULL];
} error:NULL];
NSArray *ddActions = [pred valueForKeyPath:@"ddActions"];
id openURLAction = [ddActions firstObject];
[openURLAction aspect_hookSelector:NSSelectorFromString(@"perform") withOptions:AspectPositionInstead usingBlock:^ () {
NSURL *_url = object_getIvar(openURLAction, class_getInstanceVariable([openURLAction class], "_url"));
[wself loadURL:_url];
} error:NULL];
id _lookupItem = object_getIvar(_previewItemController, class_getInstanceVariable([_class class], "_lookupItem"));
[_lookupItem aspect_hookSelector:NSSelectorFromString(@"commit") withOptions:AspectPositionInstead usingBlock:^() {
NSURL *_url = object_getIvar(_lookupItem, class_getInstanceVariable([_lookupItem class], "_url"));
[wself loadURL:_url];
} error:NULL];
[_lookupItem aspect_hookSelector:NSSelectorFromString(@"commitWithTransitionForPreviewViewController:inViewController:completion:") withOptions:AspectPositionInstead usingBlock:^() {
NSURL *_url = object_getIvar(_lookupItem, class_getInstanceVariable([_lookupItem class], "_url"));
[wself loadURL:_url];
} error:NULL];
/*
UIWindow
-UITransitionView
--UIVisualEffectView
---_UIVisualEffectContentView
----UIView
-----_UIPreviewActionSheetView
*/
/*
for (UIView * transitionView in [UIApplication sharedApplication].keyWindow.subviews) {
if ([transitionView isMemberOfClass:NSClassFromString(@"UITransitionView")]) {
transitionView.tintColor = wself.navigationController.navigationBar.tintColor;
for (UIView *__view in transitionView.subviews) {
if ([__view isMemberOfClass:NSClassFromString(@"UIVisualEffectView")]) {
for (UIView *___view in __view.subviews) {
if ([___view isMemberOfClass:NSClassFromString(@"_UIVisualEffectContentView")]) {
for (UIView *____view in ___view.subviews) {
if ([____view isMemberOfClass:NSClassFromString(@"UIView")]) {
__weak typeof(____view) w____view = ____view;
[____view aspect_hookSelector:@selector(addSubview:) withOptions:AspectPositionAfter usingBlock:^() {
for (UIView *actionSheet in w____view.subviews) {
if ([actionSheet isMemberOfClass:NSClassFromString(@"_UIPreviewActionSheetView")]) {
break;
}
}
} error:NULL];
}
}break;
}
}break;
}
}break;
}
}
*/
} error:NULL];
break;
}
}
}
致谢
RxWebViewController为我提供了灵感，有些地方做了参考。
在iOS8.0以下版本中，使用了NJKWebViewProgress作为进度条，感谢！
更新日志
0.1.10
使用基于UIWebView的实现，进度条使用NJKWebViewProgress实现。
0.2.0
iOS8.0以上版本使用WKWebView实现，进度条使用UIProgressView实现，实现了本页面Peek & Pop而无需跳转到Safari进行浏览。
0.3.0
使用AXNavigationBackItemInjection实现微信导航样式，也可以自定义返回操作，只需几行代码即可完成！