AXWebViewController 0.7.2

AXWebViewController 0.7.2

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
发布最新发布2018年2月

devedbox 维护。



 
依赖关系
AXPracticalHUD>= 0
AXNavigationBackItemInjection>= 0
NJKWebViewProgress>= 0
方面>= 0
 

  • 作者
  • 艾星

摘要

AXWebViewController 是一款基于 WKWebView(WebKit) 封装的 视图控制器,高度集成,一行代码即可使用;能够满足大部分的 App 加载 html 网页的场景,AXWebViewController 实现了 WKUIDelegateWKNavigationDelegate 两个协议,在使用过程中,若需要自定义功能,可自行 重写 相关方法来实现;

AXWebViewController 可实现 微信样式 的网页浏览导航控制,可在导航栏显示 返回关闭 两个功能按钮,这个功能主要基于 AXNavigationBackItemInjection 而实现,AXNavigationBackItemInjection 可以拦截点击返回导航或手势滑动返回,有兴趣的朋友可以了解一下!

sample2 sample

视频链接

功能

  • 手势滑动返回上一个页面
  • 微信样式导航返回、关闭
  • 网页加载失败提示
  • 网页加载进度提示
  • 网页来源 host 提示
  • 支持 PeekPop 浏览网页,并且在 commit 之后在本网页进行加载,无需跳转到 Safari进行浏览,这里使用到了很多运行时的方法,因此,请谨慎使用!

要求

AXWebViewController 对系统版本支持到 iOS7.0;版本 0.7.0 以后仅支持 Xcode9,需要使用到:

  • Foundation.framework
  • UIKit.framework

使用时最好使用最新版 Xcode。

将 AXWebViewController 添加到您的项目中

源文件

或者您可以直接将路径下 */AXWebViewController/ 下的源文件直接添加到您的项目中。

  1. 下载最新代码版本 最新代码版本 或将仓库作为 git 子模块添加到您的 git 追踪的项目中。
  2. 在 Xcode 中打开您的项目,然后将源文件拖放到项目中(如果在项目外部解压缩了代码存档,确保选择复制项目)。
  3. 在任何需要 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;

注意,在设置 navigationTypeAXWebViewControllerNavigationToolItem 之后,必须确保 showsToolBarYES 才能生效.

使用微信样式导航

AXWebViewController 初始化之后加入一句代码:

webVC.navigationType = AXWebViewControllerNavigationBarItem;

即可生效。

Peek & Pop

Peek 和 Pop 使用的是原生的系统功能,在使用时只需要将 webView.allowsLinkPreview 设置为 YES 即可使用,这里需要注意下,在实现 Peek 和 Pop 的过程中,使用了 Runtime 的相关知识,并且使用 AOP 的一个框架 __Aspects__ 进行了编程,在使用的过程中可能会出错,当然,出错的几率也是很小的(苹果不可能隔三差五的去修改自家的 Private 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 实现微信导航样式,也可以自定义返回的操作,只需几行代码就可以搞定!

更多日志请查看 最新发布.