js

JKWKWebViewHandler_Swift

This is a Tool, it use WKWebView to interact with H5

Showing:

Popularity

Downloads/wk

0

GitHub Stars

100

Maintenance

Last Commit

8mos ago

Contributors

3

Package

Dependencies

0

License

MIT

Categories

Readme

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, 929097264@qq.com

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 !")
        }
    }
    
    
}

License

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100