JKWKWebViewHandler 0.4.6

JKWKWebViewHandler 0.4.6

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2021

Maintained by jack.



  • By
  • HHL110120

JKWKWebViewHandler

CI Status Version License Platform

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Installation

JKWKWebViewHandler is available through CocoaPods. To install it, simply add the following line to your Podfile:

Object-C

pod "JKWKWebViewHandler"

Swift

pod "JKWKWebViewHandler_Swift"

article

Author

HHL110120, [email protected]

QQ Contact group

if you use QQ you can use this Qrcode to contact with us

developer guide

step 1

you should config the JKEventHandler

WKUserScript *usrScript = [[WKUserScript alloc] initWithSource:[JKEventHandler shareInstance].handlerJS injectionTime:WKUserScriptInjectionTimeAtDocumentEnd forMainFrameOnly:YES];
    
    // 通过JS与webview内容交互
    config.userContentController = [[WKUserContentController alloc] init];
    
    [config.userContentController addUserScript:usrScript];
    // 注入JS对象名称AppModel,当JS通过AppModel来调用时,
    // 我们可以在WKScriptMessageHandler代理中接收到
    [config.userContentController addScriptMessageHandler:[JKEventHandler shareInstance] name:EventHandler];
   
    
    
    
    //通过默认的构造器来创建对象
    _webView = [[WKWebView alloc] initWithFrame:self.view.bounds
                                  configuration:config];
    [_webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:_url]]];
    [self.view addSubview:_webView];

step 2

this is for JS developer

exec:function(plugin,funcName,params,successCallBack,failureCallBack){
 //when you want to call native function ,you should call this function with params.
 //plugin:the native className to handle the js func
 //funcName:the native funcName
 
 //params:this is the data you want to send to native.

 //successCallBack:this is the success block

 //failureCallBack:this is  the failure block

}

for Example:

function getInfoFromNative(){
var params = {'name':'我是jack!!!'};
JKEventHandler.exec('JKPluginA','getNativeInfo',params,function(data){
console.log('succedss block');
alert(data);
},
function(data){
console.log('fail block');
alert(data);
});
}

step 3

this is for native developer if you want interect with H5,you should create a plugin class and create the function the H5 specified to interected with you. for example:

#import <Foundation/Foundation.h>

@interface JKPluginA : NSObject
+ (void)getNativeInfo:(NSDictionary *)params :(void(^)(id response))successCallBack :(void(^)(id response))failureCallBack;
@end


#import "JKPluginA.h"

@implementation JKPluginA
+ (void)getNativeInfo:(NSDictionary *)params :(void(^)(id response))successCallBack :(void(^)(id response))failureCallBack{
NSLog(@"getNativeInfo %@",params);
if (successCallBack) {
successCallBack(@"success !!!");
}
if (failureCallBack) {
failureCallBack(@"failure !!!");
}
}
@end

swift guide

//step 1
func configureWKWebView() -> Void {
    self.eventHandler = JKEventHandlerSwift.init(webView, self)
    let config:WKWebViewConfiguration = WKWebViewConfiguration.init()
    config.preferences = WKPreferences.init()
    config.preferences.minimumFontSize = 10
    config.preferences.javaScriptEnabled = true
    config.preferences.javaScriptCanOpenWindowsAutomatically = true
    config.processPool = WKProcessPool.init()
    
    let usrScript:WKUserScript = WKUserScript.init(source: JKEventHandlerSwift.handleJS()!, injectionTime: .atDocumentEnd, forMainFrameOnly: true)
    config.userContentController = WKUserContentController.init()
    config.userContentController.addUserScript(usrScript)
    config.userContentController.add(self.eventHandler, name: JKEventHandlerNameSwift)
    
    self.webView = WKWebView.init(frame: self.view.bounds, configuration: config)
    self.webView?.load(URLRequest.init(url: URL.init(string: self.url!)!))
    self.view.addSubview(self.webView!)
    self.eventHandler.webView = self.webView
    self.webView?.uiDelegate = self;
}

//step2
//MARK:JKEventHandlerProtocol
func nativeHandle(plugin: String?, funcName: inout String!, params: Dictionary<String, Any>?, success: ((Any?) -> Void)?, failure: ((Any?) -> Void)?) {
    if plugin == "JKPluginA" {
        JKPluginA.getNativeInfo(params: params ?? [:], successCallBack: success, failureCallBack: failure)
    }
}

//step3
class JKPluginA: NSObject {
     class func getNativeInfo(params:Dictionary<String,Any>, successCallBack:((_ response:Any?) -> Void)?, failureCallBack:((_ response:Any?) -> Void)?) -> Void {
        print("params:%@",params)
        if successCallBack != nil {
            successCallBack!("success !")
        }
        
        if failureCallBack != nil {
            failureCallBack!("failure !")
        }
    }
    
    
}

实现历程博客

《WKWebView与js交互之完美解决方案》

License

JKWKWebViewHandler is available under the MIT license. See the LICENSE file for more info.