好像是macOS10.10之后,以及iOS8之后,新出现的WKWebview组件就迅速的替代了Webview及UIWebView。后者的确存在一些无法解决的bug,诸如架构导致的速度缓慢和内存泄漏。 但无法避免的问题总是有的,比如有些客户端软件,仍然要求兼容老版本的系统,这时候,很不想使用,但也不得不仍然把Webview塞到自己的代码中。 互联网是个喜新厌旧的圈子,网上搜索,几乎只有两类。一是WKWebview的文档,二是iOS类的文档。想要的macOS下面Webview的资料缈如黄鹤。 经过部分只言片语的资料指导和大量的实验,终于完成了工作。所以决定来烧烧冷灶,写出来记录一下。
最简单添加webview的方法就是直接在Interface Builder中把Webview拖入到窗口并且用鼠标拖动到指定位置和指定大小,随后在程序中加上对应的变量:
@IBOutlet weak var webView: WebView!
如果必须动态程序实现,可以使用window.contentView?.addSubview(webView)
把webview控件插入到界面中。
假定在网页中有如下内容:
<script>
function callFromSwift(msg){
document.getElementById('msgbox').innerHTML=msg;
return("msg return from js");
}
</script>
<div id='msgbox'></div>
其中定义了一个函数callFromSwift,当被调用的时候,在下面预定义的div中显示传入的字符串,并且返回一个字符串“msg return from js”。 在swift中调用网页中的callFromSwift函数并获取其返回值可以这样做:
let s=webView.windowScriptObject.evaluateWebScript("callFromSwift('Hello, JavaScript')")
NSLog(s as! String) //s是js函数的返回结果,可以是多种类型,本例要求是string
前面的3部分都比较容易,跟WKWebview也大同小异。从JS到swift的调用要复杂的多了。 首先在初始化的时候,要加上一句:
webView!.frameLoadDelegate=self;
对应的,要在类声明的位置加上一个继承:WebFrameLoadDelegate
,随后加入代码:
//为js对象声明一个接口
func webView(_ webView: WebView!, didClearWindowObject windowObject: WebScriptObject!, for frame: WebFrame!) {
self.webView.windowScriptObject.setValue(self, forKey: "swiftHost")
}
//这个是基本框架,声明了本类中有两个函数会开放给js对象,并供其调用
//这里示例了两个,一个是callFromJS1,另一个是quit
//注意swift中的函数名跟js中的函数名可以不一样,
//#selector中指明的是swift中声明的函数名,因为selector是object-c中的机制,
//所以后面在声明真正函数的时候,前面必须加@objc的标志
//在后面return "xxx"的部分,返回的字符串js中会使用的名字,
//本例中,swift中函数名跟js中函数名使用了相同的名字,我认为这是好习惯
override class func webScriptName(for aSelector: Selector) -> String?
{
//NSLog("%@",aSelector.description)
if aSelector == #selector(callFromJS1)
{
return "callFromJS1"
}
else
if aSelector == #selector(quit)
{
return "quit"
}
else
{
return nil
}
}
//这个函数顾名思义,应当是不允许在js中调用的,对所有的来值都返回false表示全部允许调用
override class func isSelectorExcluded(fromWebScript aSelector: Selector) -> Bool
{
//NSLog("%@",aSelector.description)
return false
}
//具体的函数
@objc
func callFromJS1(message:String)
{
NSLog(message)
}
@objc
func quit()
{
NSLog("call for quit")
NSApp.terminate(self);
}
前三个函数是基本的框架,其中第二个麻烦一些,随后实际上工作的函数没有什么特别。 接着来看看js的部分:
<a href='javascript:testCallSwift();'>testCallSwift</a><p>
<a href='javascript:needQuit();'>Quit</a><p>
<script>
function testCallSwift(){
//注意调用方式,window是js的对象
//swiftHost是swift的接口
//其后则是声明的swift函数
window.swiftHost.callFromJS1("hello swift");
}
function needQuit(){
window.swiftHost.quit();
}
</script>
跟上面类似,要再增加一个代理:
//初始化的时候增加:
webView!.policyDelegate=self;
并且声明类的时候多一个继承:WebPolicyDelegate
。随后代码中可以实现一个接口:
func webView(_ webView: WebView!,
decidePolicyForNavigationAction actionInformation: [AnyHashable : Any]!,
request: URLRequest!,
frame: WebFrame!,
decisionListener listener: WebPolicyDecisionListener!) {
NSLog("nav to %@",request.url!.absoluteString) //这里是将要转向的网址
listener.use() //允许访问这个网址
//listener.ignore() //不允许访问这个网址则调用这个
}
也有些程序中为了简化从js调用swift的工作量,会用链接的方式,在链接地址中传入一些指令,就可以用这个函数截获网址并且处理,被处理的网址通常使用listener.ignore()来禁止本次浏览器转向,免得影响当前页面。
通常的webview都是不允许js中的alert警告窗的,一方面是为了应用程序整体的效果;另一方面,webview作为一个空间,自己没有UI的控制权,所以类似的工作,是要有应用程序自己实现警告框窗口的。实现警告窗依然要给类增加一个集成WebUIDelegate
,并在初始化中增加:
webView!.uiDelegate=self;
//随后可以实现一个接口:
func webView(_ sender: WebView!,
runJavaScriptAlertPanelWithMessage message: String!,
initiatedBy frame: WebFrame!){
NSLog("msg of alert: %@",message)
}
如果不满足于只是得到警告消息,要自己在这个函数中使用cocoa的警告窗来显示相关的信息。
还可以实现从js中访问swift中的变量功能。使用isKeyExcludedFromWebScript
和webScriptNameForKey
函数,我用得少,如果需要,参考上面定义函数的方法,查一查官方文档自己来试试吧。