转载

iOS 8 WebKit框架概览(下)

(原文: A Look at the WebKit Framework in iOS 8 – Part 2 作者:Joyce Echessa 译者:ibenjamin)

在 第一部分 (中译版)中,我们了解了WebKit框架的基础部分。在本篇文章中,我们会深入了解WebKit框架并学习如何在原生App中定制网页。我们也会学习如何从网页中获得数据,并在App中使用数据。

接下来我们将建立一个专门浏览appcoda.com的App。首先,请 下载 初始项目。初始项目就是一个名为Coda的简单浏览器,跟我们在第一个部分编写的App差不多。唯一的区别就是没有textfield控件给用户输入url,而且我也将前进、后退和刷新按钮更换成了图片。

iOS 8 WebKit框架概览(下)

处理外部链接

如果你运行这个App并点击了一个外部链接,webview会加载这个链接。但是这个App使用来浏览Appcoda的,所以我们需要防止加载外部链接。如果用户点击了外部链接,这个链接的内容就会在Safari中打开。

我们需要的是定制网页加载的方式。达到这个目标,我们需要干涉加载网页的正常过程。在完成这个目标之前,让我们先来了解一下网页加载的过程。

网页加载由一个动作(Action)触发。这可能是任何导致网页加载的动作,比如:触碰一个链接、点击后退、前进和刷新按钮,JavaScript 设置了window.location属性,子窗口的加载或者对WKWebView的loadRequest()方法的调用。然后一个请求被发送到了服务 器,我们会得到一个响应(可能是有意义的也可能是错误状态码,比如:404)。最后服务器会发送更多地数据,并结束加载过程。

iOS 8 WebKit框架概览(下)

WebKit允许你的App在动作(Action)和响应(Response)阶段之间注入代码,并决定是否继续加载,取消或是做你想做的事情。

iOS 8 WebKit框架概览(下)

在ViewController中加入如下方法。

func webView(webView: WKWebView!, decidePolicyForNavigationAction navigationAction: WKNavigationAction!, decisionHandler: ((WKNavigationActionPolicy) -> Void)!) {     if (navigationAction.navigationType == WKNavigationType.LinkActivated && !navigationAction.request.URL.host!.lowercaseString.hasPrefix("www.appcoda.com")) {         UIApplication.sharedApplication().openURL(navigationAction.request.URL)         decisionHandler(WKNavigationActionPolicy.Cancel)     } else {         decisionHandler(WKNavigationActionPolicy.Allow)     } }

上述是一个WKNavigationDelegate代理方法,在网页加载时会被多次调用。其中一个参数WKNavigationAction对象 包含了帮助你决定是否让一个网页被加载的信息。在上面的代码中,我们使用其中两个属性,navigationType和request。我们只想中断被用户点击的外部链接的加载过程,所以我们检查了navigationType。然后我们检查了request的url来确认它是否是一个外部链接。如果两个条件都满足,这个url就会在用户的浏览器中打开(通常都是Safari)并且WKNavigationActionPolicy.Cancel终止了 App加载网页的过程。否则这个网页就会被加载并显示。

运行这个程序,点击任何外部链接,这个链接都会在Safari中被加载。

设置网页标题

如果网页能有标题来提示用户在哪里的话,这将会非常有用。在前面的文章中,我们学习了一些WKWebView的KVO属性比如loading和estimatedProgress。title也是一个KVO属性,我们将用它来获得当前网页的标题。

在viewDidLoad()其他addObserver()方法下面加入如下代码:

webView.addObserver(self, forKeyPath: "title", options: .New, context: nil)

然后在observeValueForKeyPath(_:, ofObject:)方法其他if语句下方加入如下代码。

if (keyPath == "title") {     title = webView.title }

运行程序,随便逛逛,你将发现navigationbar的title会被正确地更新。

iOS 8 WebKit框架概览(下)

修改网页内容

现在这个Coda App是一个Appcoda的专用浏览器,但是我们还可以做几样事情来提升一下用户体验。

因为设备的特性,移动App以简明的方式展示数据和信息。用户希望能看到他们想看的东西,而且不用做大量的滑动来获得信息。

目前为止,这个App展示了Appcoda网页的所有内容。我们想忽略某些和网页内容相关程度不大的东西。我们将会移除侧边栏和底部展示《Appcoda Swift book》的栏目。

为了达到这个目标,我们使用JavaScript向网页注入CSS规则以隐藏这些栏目。首先,我们需要检查网页然后决定规则。

为了检查网页,我们使用大多数浏览器都支持的开发者工具。你也可以自己以插件(plugins)或者add-ons的形式安装到你的浏览器,比如火狐的 Firebug 。我将使用Chrome的开发者工具,但你可以使用任何你喜欢的。其过程大致一样。

打开Chrome开发者工具,View->Developer->Developer Tools。

这将在浏览器底部打开一个开发者窗口。开发者窗口将和上半部分左边的网页源码和邮编的CSS样式查看分离开来。在底部,是JavaScript命令行,这里你可以输入你的代码,它将会在网页执行。

我们需要检查id属性然后标记处我们想要隐藏的栏目。

侧边栏会在所有的网页中显示,而底部的书籍栏目只会在文章页面显示。点击任意一篇文章,打开开发者工具。首先,右击侧边栏并选择检查元素。在开发者 窗口中,会高亮显示对应的元素代码。如果你将你的鼠标移动到对应的代码,网页部分相对应的区域也会高亮显示。我们希望得到包含了整个侧边栏的根元素 id(或者class)。

根据你选择审查元素时所处的位置,向上折叠标签直到只有侧边栏在页面中被高亮显示。上一个被折叠的标签就是我们要的根元素。在这里,他是一个div标签,id为’sidebar‘。

在将代码写入你的App之前,你最好在浏览器中测试一下它。因为如果发生了什么错误的话,在App中调试会非常困难。我们首先在浏览器中测试CSS和JavaScript。

点击我们在上面找到的div标签。在窗口的右边你将会看见它的CSS布局。点击+按钮添加一条CSS规则,如下所示。

div#sidebar { }

在上面的代码中添加如下代码:

display:none;

在你添加完上述代码后,侧边栏应该会从页面消失。

现在删除这条布局规则以显示侧边栏。现在我们要使用JavaScript往DOM中添加代码。在html页面之下,是运行JavaScript的命令行。将如下代码粘贴到命令行。

var styleTag = document.createElement("style");

上述代码创建了一个元素并赋值给了一个变量。接下来我们如下代码,他将会给这个元素添加css规则。我也把底部书籍栏目也添加了进去。

styleTag.textContent = 'div#sidebar, .after-post.widget-area {display:none;}';

最后,使用下面的代码给DOM添加样式标签。这段代码会马上执行,侧边栏和底部的书籍栏目会消失。

document.documentElement.appendChild(styleTag);

上面的几个过程是隐藏页面元素的必须过程。

回到Xcode,创建一个新文件File->New->File->iOS->Other->Empty并命名为hideSection.js。添加如下代码。

var styleTag = document.createElement("style"); styleTag.textContent = 'div#sidebar, .after-post.widget-area {display:none;}'; document.documentElement.appendChild(styleTag);

在ViewController中,替换init()中方法为如下:

required init(coder aDecoder: NSCoder) {  let config = WKWebViewConfiguration()  let scriptURL = NSBundle.mainBundle().pathForResource("hideSections", ofType: "js")  let scriptContent = String(contentsOfFile:scriptURL!, encoding:NSUTF8StringEncoding, error: nil)  let script = WKUserScript(source: scriptContent!, injectionTime: .AtDocumentStart, forMainFrameOnly: true)  config.userContentController.addUserScript(script)  self.webView = WKWebView(frame: CGRectZero, configuration: config)  super.init(coder: aDecoder)  self.webView.navigationDelegate = self } 

上述代码创建了一个WKWebViewConfiguration对象,它拥有一些属性来作为原生代码和网页之间沟通的桥梁。JavaScript 代码被一个WKUserScript对象加载和包装。然后这个脚本被赋值给WKWebViewConfiguration对象的 userContentController属性,接着webView使用这个配置来初始化。

当创建WKUserScript对象时,我们决定这个脚本什么时候应该被注入,和被作用于整个页面或者某个特定的frame。

运行程序,你不在会看到侧边栏(在iPhone中,它将会在页面底部以下的区域显示)和底部书籍栏目了。

提取网页数据

Appcoda的主页显示最近的10篇文章。当我们在设备上浏览主页时,你必须滑动许多次以看到底部的内容。我们希望有一个更简单地方式来获取最近的文章。我们将创建一个tableview来保存最近的文章。

我们通过提取网页数据来创建这个tableview。这里我不再会注入html了。我将会给出一段我所使用的用来获得文章的JavaScript代码,并解释它如何工作。

如果你在主页运行如下JavaScript代码,一列包含这些文章的标题和url的数据将会被打印到命令行。

var postsWrapper = document.querySelector('#content') var posts = postsWrapper.querySelectorAll('.post.type-post.status-publish')  for (var i = 0; i < posts.length; i++) {     var post = posts[i];     var postTitle = post.querySelector('h2.entry-title a').textContent;     var postURL = post.querySelector('h2.entry-title a').getAttribute('href');     console.log("Title: ", postTitle, " URL: ", postURL); }

如果你观察网页文章部分的html结构,你回发现类似下面的东西。

iOS 8 WebKit框架概览(下)

在上面的JavaScript代码中,我们通过‘content’id获得元素。这个是一个div元素,文章列表的中间父元素。我们将会获得这个 div下的所有子元素,然后赋值给posts变量。它将会持有一个class为post的div数组。我们遍历这个数组,获得每个h2标签中得得文本。我 们也通过另外一个链接标记的href属性来获得每个文章的URL。然后我们打印这些内容。

打开Xcode,创建一个新文件File->New->File->iOS->Other->Empth。命名为getPost.js。粘贴如下代码。

var postsWrapper = document.querySelector('#content') var posts = postsWrapper.querySelectorAll('.post.type-post.status-publish') function parsePosts() {  pos = []  for (var i = 0; i < posts.length; i++) {   var post = posts[i];   var postTitle = post.querySelector('h2.entry-title a').textContent;   var postURL = post.querySelector('h2.entry-title a').getAttribute('href');   pos.push({'postTitle' : postTitle, 'postURL' : postURL});  }  return pos } var postsList = parsePosts(); webkit.messageHandlers.didGetPosts.postMessage(postsList); 

上面的代码获得了所有文章的标题和url并把他们保存到了一个数组。最后一行代码是的JavaScript和原生代码之间能够交流。 webkit.messageHandlers是一个全局对象,用来帮助触发原生代码回调。didGetPosts代表了和一个原生代码方法一样名字的消 息。postMessage向回调中传递了postsList数组。

在故事板中,拖放一个导航栏按钮到导航栏的左边。并改变它的名称为‘Recent’。然后创建一个它的outlet并命名为recentPostsButton。你应该会看到如下代码。

@IBOutlet weak var recentPostsButton: UIBarButtonItem!

在viewDidLoad()方法底部,添加如下代码。我们希望这个按钮一直不可点,直到posts数组有了数据。

recentPostsButton.enabled = false

在ViewController,import语句下面添加如下代码。

let MessageHandler = "didGetPosts"

在类文件中添加如下属性。

var postsWebView: WKWebView?

在viewDidLoad()底部添加如下代码。

let config = WKWebViewConfiguration() let scriptURL = NSBundle.mainBundle().pathForResource("getPosts", ofType: "js") let scriptContent = String(contentsOfFile:scriptURL!, encoding:NSUTF8StringEncoding, error: nil) let script = WKUserScript(source: scriptContent!, injectionTime: .AtDocumentEnd, forMainFrameOnly: true) config.userContentController.addUserScript(script) config.userContentController.addScriptMessageHandler(self, name: MessageHandler) postsWebView = WKWebView(frame: CGRectZero, configuration: config) postsWebView!.loadRequest(NSURLRequest(URL:NSURL(string:"http://www.appcoda.com")!))

这里我们像之前一样导入一个JavaScript文件,我们只希望DOM被构建好时及.AtDocumentEnd时被注入一次。我们也将MessageHandler加入了WKWebViewConfiguration作为WKWebView初始化的配置。

更新类声明,遵循WKScriptMessageHandler协议。

class ViewController: UIViewController, WKNavigationDelegate, WKScriptMessageHandler

我们建立一个模型(model)文件来保存文章数据。创建一个文件File->New->File->iOS->Source->Cocoa Touch Class。命名为Post并作为NSObject的子类。在类中粘贴如下代码。

import UIKit class Post: NSObject {  var postTitle: String = ""  var postURL: String = ""  init(dictionary: Dictionary) {   self.postTitle = dictionary["postTitle"]!   self.postURL = dictionary["postURL"]!   super.init()  } } 

在ViewController类中添加如下变量。

var posts: [Post] = []

添加WKScripMessageHandler协议必须遵守的方法。

func userContentController(userContentController: WKUserContentController, didReceiveScriptMessage message: WKScriptMessage) {  if (message.name == MessageHandler) {   if let postsList = message.body as? [Dictionary] {    for ps in postsList {     let post = Post(dictionary: ps)     posts.append(post)    }    recentPostsButton.enabled = true   }  } } 

上面的代码首先将检查接收到得消息是否是我们想要的,如果是,就会将消息中的数据提取成一个字典数组,然后使用其中的字典创建Post对象,并将这些Post对象依次添加到posts数组中,最后recentPostsButton就可被点击了。

打开故事版,在画板中添加一个Table View Controller。选择它,使用Editor->Embed In->Navigation Controller将它嵌入一个navigation controller。

按下Control,点击View Controller中得Recent按钮,拖到这个新的navigation controller中,选择popover presentation from the popup。选择这个被新创建了segue,设置它的Identifier为‘recentPosts’。

创建一个新文件File->New->File->iOS->Source->Cocoa Touch class。命名为PostsTableViewController并选择为UITableViewController的子类。

在故事板中,选择创建的Table View Controller,选择 Identity Inspector,设置class为PostsTableViewController。选择table view的prototype cell,在Attributes Inspector中设置Identifier为postCell。

向PostTableViewController添加如下代码。

import UIKit class PostsTableViewController: UITableViewController {  var posts: [Post] = []  override init(style: UITableViewStyle) {   super.init(style: style)  }  required init(coder aDecoder: NSCoder) {   super.init(coder: aDecoder)  }  override func viewDidLoad() {   super.viewDidLoad()   self.title = "Recent Articles"   tableView.reloadData()  }  override func numberOfSectionsInTableView(tableView:   UITableView?) -> Int {   return 1  }  override func tableView(tableView: UITableView?, numberOfRowsInSection section: Int) -> Int {   return posts.count  }  override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {   let cell = tableView.dequeueReusableCellWithIdentifier("postCell", forIndexPath: indexPath) as UITableViewCell   let post = posts[indexPath.row]   cell.textLabel?.text = post.postTitle   return cell  } } 

这里我们实现了tableview的数据源,他将会显示文章的标题。

添加下面代码到ViewController。

override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject!) {     if (segue.identifier == "recentPosts") {         let navigationController = segue.destinationViewController as UINavigationController         let postsViewController = navigationController.topViewController as PostsTableViewController         postsViewController.posts = posts     } }

当点击Recent按钮时,此方法会被调用。在显示tableview View controller之前,它将posts数组传递给了tableview view controller。

运行程序。点击Recent按钮,你会看到一个充满了文章列表的tableview。在iPhone上,它已满屏显示,在iPad在一个popover中显示。

iOS 8 WebKit框架概览(下)

当你点击一个cell的时候,没有任何事情发生。我们希望被点击的文章被加载到web view上面。

在ViewController中,添加如下代码到import语句下面。

let PostSelected = "postSelected"

当点击一个cell的时候,我们将发送一个通知。上面的常量就是这个通知的名字。

在PostsTableViewController中添加如下方法。

override func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {     let post = posts[indexPath.row]     NSNotificationCenter.defaultCenter().postNotificationName(PostSelected, object: post)     dismissViewControllerAnimated(true, completion: nil) }

在上述方法中,每当一个cell被点击的时候会发送一个通知并隐藏(dismiss)这个tableview controller。

在ViewController类中,viewDidLoad()方法底部添加如下代码。

NSNotificationCenter.defaultCenter().addObserver(self, selector: "postSelected:", name: PostSelected, object: nil)

上述代码将这个ViewController设置为了cell点击发送的通知的观察者(observer)。

在ViewController中添加如下方法。

func postSelected(notification:NSNotification) {     webView.loadRequest(NSURLRequest())     let post = notification.object as Post     webView.loadRequest(NSURLRequest(URL:NSURL(string:post.postURL)!)) }

通过上面的方法我们得到了通知中附加的post,然后加载了post中的url。

运行程序,你应该可以在tableview中的任意文章之间切换了。

到目前为止,当我们点击Recent按钮时,我们无法隐藏(dismissing)tableview,除非我们选择并点击一篇文章。我们需要添加一个取消按钮。

在故事版中,在Table view controller的导航栏(navigationbar)的右边添加一个按钮。设置它的Identifier为Cancel。

打开Assistan Editor,按下Control点击Cancel按钮拖动到PostTableViewController类中创建一个方法。命名为cancel,确保其参数类型为UIBarButtonItem。按照下面的代码编辑这个方法。

@IBAction func cancel(sender: UIBarButtonItem) {     dismissViewControllerAnimated(true, completion: nil) }

现在你应该有一个取消按钮了,它可以用来隐藏这个Table view。

iOS 8 WebKit框架概览(下)

结论

新的WebKit框架使得开发者能够让App和网页内容之间实现无缝交互。我们学习了如何自定义网页样式。从网页中提取数据,并在App中使用这些数据。

如果你的App只是一个网页版App的容器,使用WebKit框架吧!它将带来如原生App般的性能和操作体验。WebKit框架将会为这些体验不好的App力挽狂澜。

如果你想了解更多关于此框架的内容,这个 WWDC 视频将是个非常好的开始。

你可以在 这里 下载完整项目。

(本文为CocoaChina组织翻译,本译文权利归译者所有,未经允许禁止转载。)

正文到此结束
Loading...