1. 利用 WKWebView 进行交互(系统 API)
2. 利用 UIWebView 进行交互(系统 API)
3. 苹果的 javascriptcore.framework 框架
4. 跨平台 cordova 框架
5. oc 第三方 webviewJavaScriptBridge
WKWebView 与 JS 交互实战技巧
iOS8中引入的新组件,目的是给出一个新的高性能的 WEB查看解决方案,摆脱过去 UIWebView 老旧笨重特别是内存占用量巨大的问题。
进步
1. 将浏览器内核渲染进程体取出 App,由系统进行统一管理,减少了相当一部分的性能损失
2. js 可以直接使用已经事先注入 js runtime 的 js 接口给原生层传值,不必再通过 iframe 制造页面刷新再解析自定义协议
3. 支持高达60 fps 的滚动刷新频率,内置了手势探测
WKWebView API介绍
WKWebView 的头文件声明
// webview 配置,具体看下面
@property (nonatomic, readonly, copy) WKWebViewConfiguration *configuration;// 导航代理
@property (nullable, nonatomic, weak) idnavigationDelegate;// 用户交互代理
@property (nullable, nonatomic, weak) idUIDelegate;// 页面前进、后退列表
@property (nonatomic, readonly, strong) WKBackForwardList *backForwardList;
// 默认构造器- (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration NS_DESIGNATED_INITIALIZER;
// 已不再使用- (instancetype)initWithCoder:(NSCoder *)coder NS_UNAVAILABLE;
// 与UIWebView一样的加载请求API- (nullable WKNavigation *)loadRequest:(NSURLRequest *)request;
// 加载URL- (nullable WKNavigation *)loadFileURL:(NSURL *)URL allowingReadAccessToURL:(NSURL *)readAccessURL NS_AVAILABLE(10_11, 9_0);
// 直接加载HTML- (nullable WKNavigation *)loadHTMLString:(NSString *)string baseURL:(nullable NSURL *)baseURL;
// 直接加载data- (nullable WKNavigation *)loadData:(NSData *)data MIMEType:(NSString *)MIMEType characterEncodingName:(NSString *)characterEncodingName baseURL:(NSURL *)baseURL NS_AVAILABLE(10_11, 9_0);
// 前进或者后退到某一页面- (nullable WKNavigation *)goToBackForwardListItem:(WKBackForwardListItem *)item;
// 页面的标题,这昆支持KVO的
@property (nullable, nonatomic, readonly, copy) NSString *title;
// 当前请求的URL,它是支持KVO的
@property (nullable, nonatomic, readonly, copy) NSURL *URL;
// 标识当前是否正在加载内容中,它是支持KVO的
@property (nonatomic, readonly, getter=isLoading) BOOL loading;
// 当前加载的进度,范围为[0, 1]
@property (nonatomic, readonly) double estimatedProgress;
// 标识页面中的所有资源是否通过安全加密连接来加载,它是支持KVO的
@property (nonatomic, readonly) BOOL hasOnlySecureContent;
// 当前导航的证书链,支持KVO
@property (nonatomic, readonly, copy) NSArray *certificateChain NS_AVAILABLE(10_11, 9_0);
// 是否可以招待goback操作,它是支持KVO的
@property (nonatomic, readonly) BOOL canGoBack;
// 是否可以执行gofarward操作,支持KVO
@property (nonatomic, readonly) BOOL canGoForward;
// 返回上一页面,如果不能返回,则什么也不干
- (nullable WKNavigation *)goBack;
// 进入下一页面,如果不能前进,则什么也不干
- (nullable WKNavigation *)goForward;
// 重新载入页面
- (nullable WKNavigation *)reload;
// 重新从原始URL载入
- (nullable WKNavigation *)reloadFromOrigin;
// 停止加载数据
- (void)stopLoading;
// 执行JS代码
- (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^ __nullable)(__nullable id, NSError * __nullable error))completionHandler;
// 标识是否支持左、右swipe手势是否可以前进、后退
@property (nonatomic) BOOL allowsBackForwardNavigationGestures;
// 自定义user agent,如果没有则为nil
@property (nullable, nonatomic, copy) NSString *customUserAgent NS_AVAILABLE(10_11, 9_0);
// 在iOS上默认为NO,标识不允许链接预览
@property (nonatomic) BOOL allowsLinkPreview NS_AVAILABLE(10_11, 9_0);
WKWebViewConfiguration 配置
WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
WKPreferences 偏好设置
// 设置偏好设置config.preferences = [[WKPreferences alloc] init];
// 默认为0
config.preferences.minimumFontSize = 10;
// 默认认为YES
config.preferences.javaScriptEnabled = YES;
// 在iOS上默认为NO,表示不能自动通过窗口打开config.preferences.javaScriptCanOpenWindowsAutomatically = NO;
WKUserContentController内容交互控制器通过 JS 与 webview 内容交互,需要用到这个类
// 只读属性,所有添加的WKUserScript都在这里可以获取到
@property (nonatomic, readonly, copy) NSArray*userScripts;
// 注入JS
- (void)addUserScript:(WKUserScript *)userScript;
// 移除所有注入的JS
- (void)removeAllUserScripts;
// 添加scriptMessageHandler到所有的frames中,则都可以通过
// window.webkit.messageHandlers..postMessage()
// 发送消息
// 比如,JS要调用我们原生的方法,就可以通过这种方式了
- (void)addScriptMessageHandler:(id)scriptMessageHandler name:(NSString *)name;
// 根据name移除所注入的scriptMessageHandler
- (void)removeScriptMessageHandlerForName:(NSString *)name;
WKUserScript所注入的 JS 是 WKUserScript 对象
// JS源代码
@property (nonatomic, readonly, copy) NSString *source;
// JS注入时间
@property (nonatomic, readonly) WKUserScriptInjectionTime injectionTime;
// 只读属性,表示JS是否应该注入到所有的frames中还是只有main frame.
@property (nonatomic, readonly, getter=isForMainFrameOnly) BOOL forMainFrameOnly;
// 初始化方法,用于创建WKUserScript对象
// source:JS源代码
// injectionTime:JS注入的时间
// forMainFrameOnly:是否只注入main frame
- (instancetype)initWithSource:(NSString *)source injectionTime:(WKUserScriptInjectionTime)injectionTime forMainFrameOnly:(BOOL)forMainFrameOnly;
WKUserScriptInjectionTime它是一个枚举类型,只有在文档开始加载时注入和加载结束时注入。WKWebsiteDataStore存储的Web内容iOS9.0以后才能使用这个类。它是代表webview不同的数据类型,包括cookies、disk、memory caches、WebSQL、IndexedDB数据库和本地存储。
// 默认数据存储
+ (WKWebsiteDataStore *)defaultDataStore;
// 返回非持久化存储,数据不会写入文件系统
+ (WKWebsiteDataStore *)nonPersistentDataStore;
// 已经不可用- (instancetype)init NS_UNAVAILABLE;
// 只读属性,表示是否是持久化存储
@property (nonatomic, readonly, getter=isPersistent) BOOL persistent;
// 获取所有web内容的数据存储类型集,比如cookies、disk等
+ (NSSet*)allWebsiteDataTypes;
// 获取某些指定数据存储类型的数据
- (void)fetchDataRecordsOfTypes:(NSSet*)dataTypes completionHandler:(void (^)(NSArray*))completionHandler;
// 删除某些指定类型的数据
- (void)removeDataOfTypes:(NSSet*)dataTypes forDataRecords:(NSArray*)dataRecords completionHandler:(void (^)(void))completionHandler;
// 删除某些指定类型的数据且修改日期是指定的日期
- (void)removeDataOfTypes:(NSSet*)websiteDataTypes modifiedSince:(NSDate *)date completionHandler:(void (^)(void))completionHandler;
WKWebsiteDataRecordiOS9.0以后才可用website 的数据存储记录类型
// 通常是域名@property (nonatomic, readonly, copy) NSString *displayName;
// 存储的数据类型集@property (nonatomic, readonly, copy) NSSet*dataTypes;
WKSelectionGranularity选择粒度表示在 webview 上选择内容的粒度
typedef NS_ENUM(NSInteger, WKSelectionGranularity) { WKSelectionGranularityDynamic, WKSelectionGranularityCharacter,} NS_ENUM_AVAILABLE_IOS(8_0);
它是用于webview内容交互时选择内容的粒度类型设置。比如说,当使用WKSelectionGranularityDynamic时,而所选择的内容是单个块,这时候granularity可能会是单个字符;当所选择的web内容不限制于某个块时,granularity可能会是单个块。WKNavigationDelegate
@protocol WKNavigationDelegate@optional
// 决定导航的动作,通常用于处理跨域的链接能否导航。WebKit对跨域进行了安全检查限制,不允许跨域,因此我们要对不能跨域的链接
// 单独处理。但是,对于Safari是允许跨域的,不用这么处理。
// 这个是决定是否Request
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler;
// 决定是否接收响应
// 这个是决定是否接收response
// 要获取response,通过WKNavigationResponse对象获取
- (void)webView:(WKWebView *)webView decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler;
// 当main frame的导航开始请求时,会调用此方法
- (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(null_unspecified WKNavigation *)navigation
;// 当main frame接收到服务重定向时,会回调此方法
- (void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(null_unspecified WKNavigation *)navigation;
// 当main frame开始加载数据失败时,会回调
- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;
// 当main frame的web内容开始到达时,会回调
- (void)webView:(WKWebView *)webView didCommitNavigation:(null_unspecified WKNavigation *)navigation;
// 当main frame导航完成时,会回调
- (void)webView:(WKWebView *)webView didFinishNavigation:(null_unspecified WKNavigation *)navigation;
// 当main frame最后下载数据失败时,会回调
- (void)webView:(WKWebView *)webView didFailNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;
// 这与用于授权验证的API,与AFN、UIWebView的授权验证API是一样的
- (void)webView:(WKWebView *)webView didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *__nullable credential))completionHandler;
// 当web content处理完成时,会回调
- (void)webViewWebContentProcessDidTerminate:(WKWebView *)webView NS_AVAILABLE(10_11, 9_0);@end
WKNavigationActionPolicy导航动作决定策略
typedef NS_ENUM(NSInteger, WKNavigationActionPolicy) { WKNavigationActionPolicyCancel,
//不允许导航 WKNavigationActionPolicyAllow,} NS_ENUM_AVAILABLE(10_10, 8_0);
WKNavigationResponse导航响应类,可以获取相关响应的信息NS_CLASS_AVAILABLE(10_10, 8_0)
@interface WKNavigationResponse : NSObject
// 是否是main frame
@property (nonatomic, readonly, getter=isForMainFrame) BOOL forMainFrame;
// 获取响应response
@property (nonatomic, readonly, copy) NSURLResponse *response;
// 是否显示MIMEType
@property (nonatomic, readonly) BOOL canShowMIMEType;
@end
WKNavigationActionWKNavigationAction对象包含关于导航的action的信息,用于make policy decisions
// 正在请求的导航的frame
@property (nonatomic, readonly, copy) WKFrameInfo *sourceFrame;
// 目标frame,如果这是新的window,它会是nil
@property (nullable, nonatomic, readonly, copy) WKFrameInfo *targetFrame;
// 导航类型,如下面的小标题WKNavigationType
@property (nonatomic, readonly) WKNavigationType navigationType;
// 导航的请求@property (nonatomic, readonly, copy) NSURLRequest *request;
WKNavigationType枚举类型
typedef NS_ENUM(NSInteger, WKNavigationType) {
// 链接已经点击 WKNavigationTypeLinkActivated,
// 表单提交 WKNavigationTypeFormSubmitted,
// 前进、后退 WKNavigationTypeBackForward,
// 重新载入 WKNavigationTypeReload,
// 表单重新提交 WKNavigationTypeFormResubmitted,
// 其它 WKNavigationTypeOther = -1,} NS_ENUM_AVAILABLE(10_10, 8_0);
WKUIDelegate
@protocol WKUIDelegate
@optiona
l// 创建新的webview
// 可以指定配置对象、导航动作对象、window特性
- (nullable WKWebView *)webView:(WKWebView *)webView createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration forNavigationAction:(WKNavigationAction *)navigationAction windowFeatures:(WKWindowFeatures *)windowFeatures;
// webview关闭时回调
- (void)webViewDidClose:(WKWebView *)webView NS_AVAILABLE(10_11, 9_0);
// 调用JS的alert()方法
- (void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler;
// 调用JS的confirm()方法
- (void)webView:(WKWebView *)webView runJavaScriptConfirmPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(BOOL result))completionHandler;
// 调用JS的prompt()方法
- (void)webView:(WKWebView *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(nullable NSString *)defaultText initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(NSString * __nullable result))completionHandler;
@end
WKBackForwardListWKBackForwardList表示webview中可以前进或者后退的页面列表
NS_CLASS_AVAILABLE(10_10, 8_0)
@interface WKBackForwardList : NSObject
// 当前正在显示的item(页面)
@property (nullable, nonatomic, readonly, strong) WKBackForwardListItem *currentItem;
// 后一页,如果没有就是nil
@property (nullable, nonatomic, readonly, strong) WKBackForwardListItem *backItem;
// 前一页,如果没有就是nil
@property (nullable, nonatomic, readonly, strong) WKBackForwardListItem *forwardItem;
// 根据下标获取某一个页面的item
- (nullable WKBackForwardListItem *)itemAtIndex:(NSInteger)index;
// 可以进行goback操作的页面列表
@property (nonatomic, readonly, copy) NSArray*backList;
// 可以进行goforward操作的页面列表
@property (nonatomic, readonly, copy) NSArray *forwardList;
@end
```
WKBackForwardListItem
页面导航前进、后退列表项
```
@interface WKBackForwardListItem : NSObject
// 该页面的URL
@property (readonly, copy) NSURL *URL;
// 该页面的title
@property (nullable, readonly, copy) NSString *title;
// 初始请求该item的请求的URL
@property (readonly, copy) NSURL *initialURL;
@end
```