确定WebKit
是否可以加载内容
+ (BOOL)handlesURLScheme:(NSString*)urlScheme
返回WebKIT是否支持用特定URL方案加载资源
WKWebView
允许设置请求拦截,但是只允许拦截自定义Scheme
的请求,不允许http
,https
,ftp
,file
的请求,所以可以通过[WKWebView handlesURLScheme:]
来判断scheme是否已经被WKWebView
默认处理了
初始化 webview
1.1 @property(nonatomic, readonly, copy) WKWebViewConfiguration *configuration
用于初始化web视图的配置的副本
用WKWebViewConfiguration您可以确定网页呈现的时间,如何处理媒体回放等其他
只有在初始化WKWebView的时候设置configuration,并不能在WKWebView创建后去修改configuration
WKWebViewConfiguration 介绍
1.2 initWithFrame:configuration:
返回指定frame和配置初始化的Web视图
这是一个接受自定义WKWebVIEW配置的指定初始化器。初始化器复制指定的配置。初始化Web视图之后更改配置对象configuration对Web视图没有影响。可以使用initWithFrame:
方法初始化具有默认配置的实例。查看默认值的WKWebVIEW配置
Inspecting the View Information 查看视图信息
2.1 scrollView
@property(nonatomic, readonly, strong) UIScrollView *scrollView;
只读的,与Web
视图关联的滚动视图
webview
可以滑动的原因就是因为关联的scrollview
2.2 title
页面的标题,一般用于kvo监听得到title用来更新nav标题ui的
代码如下
[self.webView addObserver:self forKeyPath:@"title" options:NSKeyValueObservingOptionNew context:NULL];
2.3 URL
当前的url,要在用户界面中反映的URL,也可以用kvo监听
2.4 customUserAgent
自定义用户代理字符串
如果没有设置自定义用户代理字符串,则将为nil
Setting Delegates 设置代理
3.1 navigationDelegate
@property(nonatomic, weak) id navigationDelegate;
这个协议的方法能够让你实现触发的自定义行为在Web视图接受、加载和完成导航请求的过程中
WKNavigationDelegate
3.2 UIDelegate
UIDelegate
Loading Content 加载内容
4.1 estimatedProgress
当前导航加载的进度
一般用于kvo
监听,监听加载进度,做一些加载的ui处理,它的值是 0.0 - 1.0
,当完全加载完(加载的内容包括包括主要文件及其所有潜在的子资源)的时候它的值就为1.0
4.2 hasOnlySecureContent
一个布尔值,指示页上的所有资源是否已通过安全加密连接加载
也是一般用于kvo
监听
4.2 loadHTMLString:baseURL:
设置网页内容和基本URL
参数1:网页内容的字符串
参数2:用于解析文档中的相对URL
一般我们都是这个方法加载本地的html 内容
WKWebView 在iOS 9 有新的加载本地方法- (nullable WKNavigation *)loadFileURL:(NSURL *)URL allowingReadAccessToURL:(NSURL *)readAccessURL API_AVAILABLE(macosx(10.11), ios(9.0));.但是我看了网上有一些博客说- (nullable WKNavigation *)loadRequest:(NSURLRequest *)request;并不能加载本地html文件.其实两者都能加载.只是需要把路径写对.第一个方法就不过多叙述了.网上有很多的博客.这里我就用第二个方法来看一下如何加载
NSString *path = [[[NSBundle mainBundle] bundlePath] stringByAppendingPathComponent:@"index.html"];
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL fileURLWithPath:path]];
[_mainWebView loadRequest: request];
4.2 loading
指示视图当前是否加载内容的布尔值
可以用于kvo
监听,如果还在加载内容则为true
,加载完成则为flase
4.3 reload
重新加载当前页面,
返回重新加载的网页的新导航
经过测试:如果webview
加载成功完成之后,调用此方法,相当于重新加载,但是如果是加载失败之后调用此方法,此方法就不生效了
4.4 reloadFromOrigin
重新加载当前页面,如果可能,使用缓存验证条件执行端到端重新验证
与reload
不同的是它会比较网络数据是否有变化,没有变化则使用缓存,否则从新请求
经过测试:如果webview
加载成功完成之后,调用此方法,相当于重新加载,但是如果是加载失败之后调用此方法,此方法就不生效了
4.4 stopLoading
停止加载当前页上的所有资源
如果在加载的过程中,调用此方法,会进入
- (void)webView:(WKWebView *)webView didFailNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error
失败回调
4.5 loadData:MIMEType:characterEncodingName:baseURL:
这个方法跟loadHTMLString:baseURL:
类似,只不过一个是html的字符内容,一个是html的data的内容
说下第二个参数: MIMEType 文件类型,一般都用@"text/html"
4.6 loadFileURL:allowingReadAccessToURL:
加载 本地文件系统的url
原因是WKWebView是不允许通过的loadRequest的方法来加载本地根目录的资源文件。
而在iOS9的SDK中加入了以下方法来加载本地的HTML文件:
如果第二个参数
引用单个文件,则只有该文件可以由WebKIT
加载。如果第二个参数
引用一个目录,那么该文件中的文件可以由WebKit加载
Scaling Content 缩放web内容
5.1 allowsMagnification
一个布尔值,指示放大手势是否会改变Web视图的放大率
默认值为NO
这个属性是针对MAC OS
的不是iPhone
的
5.1 magnification
页内容当前缩放的的比例
默认的是1.0
这个属性是针对MAC OS
的不是iPhone
的
5.2 setMagnification:centeredAtPoint:
按指定因子缩放页面内容,并将结果集中在指定点上
这个属性是针对MAC OS
的不是iPhone
的
Navigating 导航相关
6.1 allowsBackForwardNavigationGestures
一个布尔值,指示水平滑动手势是否会触发前向列表导航
只针对侧滑有效
默认为NO
6.2 backForwardList
Web视图的前向列表
是个WKBackForwardList
的数组
6.3 canGoBack
一个布尔值,指示在前退列表中是否存在可以导航到的,如果前退列表中里有可以返回的,则为yes
6.4 canGoForward
一个布尔值,指示后向列表中是否存在可以导航到
6.5 allowsLinkPreview
确定按下链接是否显示链接的目的地的预览
从iOS 9开始,在支持3D Touch的设备中使用WKWebView的allowLinkPreview属性,WKWebView客户端就可以选择基于Peek的链接预览。当allowLinkPreview属性设为true时,使用者可以轻轻的按下链接来查看,然后在app上的另一个视图里加载链接,同时app在背景中模糊显示。
如果使用者用力按下链接,链接会在Safari中弹出
在WKWebView和UIWebView可以设置属性allowsLinkPreview来支持WebView的Peek和Pop。
这个属性是默认设置为
NO
的如果使用WKWebView或者UIWebView,Pop会跳转到Safari
如果希望在APP内部保证Pop,建议使用SFSafariViewController来替代WKWebView
6.6 goBack
返回
6.7 goForward
前进
6.8 goToBackForwardListItem:
返回到指定的item,item属于backForwardList数组中
6.9 loadRequest:
加载请求,加载网络html
Executing JavaScript 执行 JavaScript代码
7.1 evaluateJavaScript:completionHandler:
执行JavaScript
代码
参数1:要被执行的JavaScript
代码的字符串
参数2:执行完成或者失败的block
回调
这个completionHandler
是执行在主线程的
Taking Snapshots 拍摄快照
8.1 takeSnapshotWithConfiguration:completionHandler:
获取视图可见视口的快照