WKWebView- 基本属性介绍2

2018-11-15 本文已影响30人 edison0428

确定`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<WKNavigationDelegate> 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中弹出

image.png

在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:

获取视图可见视口的快照