WebKit Framework框架的翻译

本文转载自：Z.MJun的 - WebKit Framework

---

翻译于2016年5月25日

---

WebKit Framework

WebKit提供了一系列的类，在界面上显示网络内容和实现了游览器功能，如用户点击链接，管理网络返回列表，和历史访问页。WebKit 大大的简化了复杂的页面加载。从HTTP服务器异步请求网络内容，在随机顺序下增加相应量，或者提供网络错误。WebKit同时简化了显示MIME类型的网络内容和每个复合框架元素都有自己一套滚动条。

CONCURRENCY NOTE
WebKit库的线程并不安全。如果你调用库方法，你必须只能在主线程上。

WebKit 适用于IOS8及以上

---

Classes 类

• NSObject

---

• WKBackForwardList 这个对象是用来管理网页表，以至于可以使用返回和前进。
  • Getting List Items 获取列表项

    • backItem （属性）

      • 描述：马上返回当前Item，如果是空的返回nil（只读）
      • oc:@property(nonatomic, readonly, strong) WKBackForwardListItem *backItem

    • currentItem 当前Item （属性）

      • 描述：当前Item（只读）
      • oc:@property(nonatomic, readonly, strong) WKBackForwardListItem *currentItem

    • forwardItem 当前Item （属性）

      • 描述：马上返回当前Item，如果是空的返回nil（只读）
      • oc:@property(nonatomic, readonly, strong) WKBackForwardListItem *forwardItem
    • • itemAtIndex: 当前Item （方法）
        • 描述：马上返回当前Item，如果是空的返回nil（只读）
        • oc:@property(nonatomic, readonly, strong) WKBackForwardListItem *forwardItem
  • Getting Sublists 获取子列表
    • backList （属性）
      • 描述：一部分当前项的之前列表（只读）
      • oc:@property(nonatomic, readonly, copy) NSArray *backList
      • 这些Item都是最初按顺序访问过的。
    • forwardList （属性）
      • 描述：一部分当前项的之后列表（只读）
      • oc:@property(nonatomic, readonly, copy) NSArray *forwardList
      • 这些Item都是最初按顺序访问过的。

---

• WKBackForwardListItem 这个对象代表一个在之前或之后的网页列表的网页
  • Inspecting Item Information
    • URL （属性）
      • 描述：item的网页URL（只读）
      • oc:@property(readonly, copy) NSURL *URL
    • initialURL （属性）
      • 描述：初始请求URL（只读）
      • oc:@property(readonly, copy) NSURL *initialURL
    • title （属性）
      • 描述：这个Item的网页标题（只读）
      • oc:@property(readonly, copy) NSString *title

---

• WKFrameInfo 这个对象包含了一个网页的框架。这个框架是以数据为准的，并且没有一个唯一标示，即使多个委托方法调用这个框架。
  • Inspecting Item Information
    • mainFrame （属性）
      • 描述：用于判断是否是主框架还是复框架（只读）
      • oc:@property(nonatomic, readonly, getter=isMainFrame) BOOL mainFrame
    • request （属性）
      • 描述：当前框架的请求（只读）
      • oc:@property(nonatomic, readonly, copy) NSURLRequest *request
    • securityOrigin （属性）
      • 描述：这个框架的安全源信息（只读）
      • oc:@property(nonatomic, readonly) WKSecurityOrigin *securityOrigin
      • 具体可以查看WKSecurityOrigin，这个对象包含host名字，协议和端口。

---

• WKNavigation 这个对象包含追踪网页进度信息。一个浏览对象，从web视图加载方法返回，也可以从加载开始到结束，提供给网页唯一的标示浏览代理。这个对象没有方法也没有对象。

---

• WKNavigationAction 这个对象包含了关于导航行为，和指定决策信息

  • Inspecting Navigation Information

    • request （属性）
      • 描述：浏览的请求（只读）
      • oc:@property(nonatomic, readonly, copy) NSURLRequest *request
    • sourceFrame （属性）
      • 描述：请求浏览框架（只读）
      • oc:@property(nonatomic, readonly, copy) WKFrameInfo *sourceFrame
    • targetFrame （属性）
      • 描述：目标框架，如果是新的浏览界面则为nil（只读）
      • oc:@property(nonatomic, readonly, copy) WKFrameInfo *targetFrame

  • Inspecting User Actions

    • navigationType
      （属性）
      • 描述：响应浏览的行动类型（只读）
      • oc:@property(nonatomic, readonly) WKNavigationType navigationType
      • 具体可以查看WKNavigationType

  • Constants

    • WKNavigationType （属性）
      • 描述：响应浏览的行动类型（只读）
      • oc:typedef enum WKNavigationType : NSInteger { } WKNavigationType;
        • WKNavigationTypeLinkActivated 链接的href属性被用户激活。
        • WKNavigationTypeFormSubmitted 一个表单提交。
        • WKNavigationTypeBackForward 回到前面的条目列表请求。
        • WKNavigationTypeReload 网页加载。
        • WKNavigationTypeFormResubmitted 一个表单提交(例如通过前进,后退,或重新加载)。
        • WKNavigationTypeOther 导航是发生一些其他原因。

---

• WKNavigationResponse 这个对象向包含一些浏览解析，使用制定决策。
  • Inspecting Response Information
    • canShowMIMEType （属性）
      • 描述：是否可以显示MIME类型（只读）
      • oc:@property(nonatomic, readonly) BOOL canShowMIMEType
    • forMainFrame （属性）
      • 描述：导航框架是否真实主框架（只读）
      • oc:@property(nonatomic, readonly, getter=isForMainFrame) BOOL forMainFrame
    • response （属性）
      • 描述：框架响应（只读）
      • oc:@property(nonatomic, readonly, copy) NSURLResponse *response
      • 允许与MIME类型的导航响应，不能显示将导致导航失败。