iOS WKUserContentController

WKUserContentController

---

---

一、WKUserContentController是什么？

WKUserContentController对象为JavaScript提供了一种发布消息并将用户脚本注入webView的方法。

二、详解

1.属性方法

iOS 8.0+

// 添加name的脚本消息处理。 H5调用原生
func add(WKScriptMessageHandler, name: String)

// 移除name的脚本消息处理
func removeScriptMessageHandler(forName: String)

// 注入JS方法，供前端调用。 原生调用H5
func addUserScript(_ userScript: WKUserScript)

// 移除所有关联的用户脚本
func removeAllUserScripts()

// 与UserContentController(用户内容控制器)关联的用户脚本
var userScripts: [WKUserScript]

*****************添加和删除内容规则 iOS 11.0+ *****************
// 添加内容规则列表。
func add(_ contentRuleList: WKContentRuleList)

// 移除内容规则列表。
func remove(WKContentRuleList)

// 移除所有的内容规则列表
func removeAllContentRuleLists()


***************** 实例方法 iOS 14.0+ *****************
// 用命名空间来区分不同环境的消息事件
func add(WKScriptMessageHandler, contentWorld: WKContentWorld, name: String)

func addScriptMessageHandler(WKScriptMessageHandlerWithReply, contentWorld: WKContentWorld, name: String)

func removeAllScriptMessageHandlers()

func removeAllScriptMessageHandlers(from: WKContentWorld)

func removeScriptMessageHandler(forName: String, contentWorld: WKContentWorld)

1.1 WKUserScript

WKUserScript对象表示可以注入网页的脚本。

// 初始化一个可以添加到用户内容控制器的用户脚本。
// source：脚本的源代码。
// injectionTime： 应将脚本注入网页的时间。WKUserScriptInjectionTime枚举
// forMainFrameOnly：应将脚本注入到主框架（true）还是应注入所有框架（false）。
init(source: String, injectionTime: WKUserScriptInjectionTime, forMainFrameOnly: Bool)

var source: String
var injectionTime: WKUserScriptInjectionTime
var isForMainFrameOnly: Bool

enum WKUserScriptInjectionTime : Int
case atDocumentStart // 在创建document元素之后但在加载任何其他内容之前注入脚本。
case atDocumentEnd // 在document完成加载之后但在其他子资源完成加载之前注入脚本。

// 初始化一个指定命名空间的、可以添加到用户内容控制器的用户脚本iOS 14.0+
init(source: String, injectionTime: WKUserScriptInjectionTime, forMainFrameOnly: Bool, in: WKContentWorld)

1.2 WKContentRuleList、WKContentRuleListStore

适用于Web内容的已编译规则列表。

2.Demo

未完待续。。。

---

总结

。