HTML5 APIs软件工程师指南

有关HTML5中的语法元素相信大家已经看到过不少介绍了，但是关于HTML5的APIs的介绍就不那么常见了，而HTML5规范主要就是由这些APIs构成的。

相信大家都知道，HTML5的标准有两个版本，一个是由W3C发布的，另一个则是由WHATWG发布的。WHATWG现有的HTML5标准中补充了一些W3C标准中没有的APIs（这些APIs其实W3C也有涉及，只是被单独列在一个补充标准中了）。

除了规范中介绍的APIs以外，还有一些相关的APIs也遵循了HTML5的标准，并常常也声称自己是HTML5的API。有些APIs已经被采用了一段时间了，但是仍然没有被明确列入规范之中，而有些HTML5则着手准备对其进行改进。

这篇文章并不准备从代码的角度去介绍这些APIs，而是会分析他们的用途以及进展情况。还会给出一些参考信息方便读者更加深入地了解自己感兴趣的内容。

首先看看W3C的HTML5规范中的APIs。

多媒体API

多媒体API是HTML5的多媒体元素中的一部分，其中包括视频?和音频?元素。这些元素本身实现起来并不复杂，但是这些APIs可以使用JavaScript方法，这是很多人不太了解的。其中包括play() ?，pause()??，load() ?以及canPlayType() 这些方法。许多方法不仅可以使用多媒体类型属性，还可以使用许多其他的属性（例如poster 属性?），这些方法在视频?元素中尤其常见。通过在API中使用合适的事件和属性，开发者能够实现多媒体的自定义控制。

想要了解更多信息，可以看看下面的文章。

• Media Elements, W3C?
  
• Everything you need to know about HTML5 video and audio, dev.opera, Simon Pieters?
  
• HTML5 audio and video: what you must know, NetTuts (a chapter from?Introducing HTML5), Bruce Lawson and Remy Sharp?
  

文本轨迹 API

文本轨迹 API（编者译，原文为text tracks API）常常和多媒体API一起配合使用。这个API可以与视频?和音频?元素的text tracks（例如副标题或是字幕）交互。你可以获取一个多媒体元素的文本轨迹长度或是数量，或者是它的文本轨迹（副标题，字幕，描述，章节以及元数据）类型?（kind ?）、语言?（language ）、状态?（readyState ）、模式?（mode ?）和标签?（label ）。

当浏览器使用本地字幕时，这个API就派上用场了，WebVTT就是一个很好的例子。你还可以快速浏览以下这些资源：

• Text Track API, W3C?
  
• Web Media Text Tracks Community Group?
  
• Media Multiple Text Tracks API Wiki, W3C?
  
• The YouTube Caption API, Speech Recognition, and WebVTT Captions for HTML5, Google I/O 2011, Naomi Black, Cynthia Boedihardjo, and Jeffrey Posnick?
  
• Captionator.js Polyfill?
  
• WebVTT and video subtitles, Ian Devlin?
  
• Video subtitling and WebVTT, HTML5 Doctor, Tom Leadbetter?
  

拖放功能

拖放API一直受到很多关注?。它最初是由Microsoft的IE5推出的，现在Firefox，Safari 和Chrome都已经支持这一功能了。那么这个API究竟是做什么的呢？

就像它的名字所说的，这个APi在浏览器中实现本地的拖放功能。只需要将一个可拖放?属性设置为true?，用户就可以移动浏览器中任意一个元素了。你还可以目标区域加入一些事件句柄，用来告诉浏览器哪些区域能够放置用户拖放的元素。

如果不局限在浏览器内部看这一功能，这个API的作用将更加凸显。使用拖放API，用户可以将桌面上的一副图像直接拖入浏览器中，或是将浏览器中的一个新建图标拖到桌面上，并且能够自动加载相应的内容信息形成一个新的应用程序快捷方式。

下面的文章更加深入地介绍了这一拖放功能。

• Drag and drop API, W3C?
  
• Native, Drag and Drop, HTML5 Doctor, Remy Sharp?
  
• Drag and Drop, MDN?
  
• The drag and drop API, HTML5 Laboratory, Ian Devlin?
  

离线Web Apps/Apps缓存

随着native apps（包括移动和桌面版本）和web apps的界限变得越来越模糊，应用程序支持离线访问已经成为大势所趋。离线Web应用程序（Offline Web Applications）规范详细介绍了这一技术，即应用程序缓存功能。

应 用程序缓存功能是通过一个简单的列表文件实现的，该文件列出了应用程序离线工作所需的文件。这样发布者就能够确保他们的网站可以支持离线访问了。这个列表 文件能够引导浏览器保留一份文件的副本，这样用户下次就可以脱机访问这些内容了。当用户没有连入网络时，浏览器就将本地的副本显示给用户。理论上讲，即使 是在地铁或是其他网络不佳的环境下，你也能完成邮件编写工作了，甚至还可以玩web版的愤怒小鸟。

现在浏览器已经对这一功能有了很好的支持，尤其是在移动领域（Firefox, Safari, Chrome, Opera, iPhone, 和Android），你现在就可以使用这一功能了。下面是一些相关的资料：

• Offline Web Applications, W3C?
  
• Let's take this offline, Dive into HTML5, Mark Pilgrim?
  
• Running your web applications offline with HTML5 AppCache, dev.opera, Shwetank Dixit?
  
• Go offline with application cache, HTML5 Doctor, Mike Robinson?
  
• Offline Browsing in HTML5 with ApplicationCache, Sitepoint, Malcolm Sheridan?
  
• Get off(line), Web Directions, John Allsopp?
  

UI

和离线功能一样，UI也是HTML5核心标准的一部分。其中有些功能有必要在这里提一提，比如contenteditable ?属性，在创建web apps就非常有用。IE浏览器从5.5版本推出以后就一直支持这一属性，还有其他五大主流浏览器都支持这一属性。将该属性设置为true表示相应的元素是可编辑的。发布者可以在本地存储中加入这一属性，从而跟踪文档的变化。

想了解更多信息，可以查看最新的标准?，但是其中有些部分已经被划分给HTML Editing APIs?了。

历史

浏览器的后退按钮是一个使用非常频繁的工具。HTML5的历史API（History API）可以帮助开发者管理用户的浏览器会话的历史状态。

HTML5 以前的历史API只是帮用户回到之前的页面或是之后的页面，以及检查历史信息的长度。而HTML5则加入了增删用户历史信息的方法，可以保存部分数据用于 重构一个页面状态，或是更新URL时无需刷新页面。这个API使用起来非常简单，并且可以用它开发非常复杂的应用程序。

关于历史API的更多信息：

• ?History API, W3C?
  
• Manipulating History for Fun & Profit, Dive into HTML5, Mark Pilgrim?
  
• Introducing the HTML5 History API, dev.opera, Mike Taylor & Chris Mills?
  
• Manipulating the browser history, MDN?
  

MIME类型和协议处理程序注册

这个API允许网站将自己注册成为一些方案的处理程序。下面是一个使用了registerProtocolHandler ?方法的例子：

一个在线电话消息服务可以将自己注册成一个sms方案的处理程序，这样当用户点击这个链接以后，就能访问它的Web网站（W3C HTML协议?）了。

sms?、tel?和irc?这类方案被列入白名单。网站还可以使用registerContentHandler ?方法将自己注册为特定内容的处理程序。

想要了解MIME类型和协议处理程序注册方法，可以先看看HTML5规范?。

现在，已经介绍过W3C和WHATWG两个版本HTML5协议中共有的一些标准了。接着将介绍一些附加的APIs，这些APIs被WHATWG收录在正式的协议文档中，而W3C则将他们细分为一些更加易于管理的协议。这两个版本中的APIs用途和主要内容都是相同的。

• Canvas 2D?环境?―― 可以用来在浏览器中绘图。如果不使用2D Context API，canvas?将无法绘图。它就像是刷子、调色板和颜料，将所有这些绘图工具都集成在了一起。这个API是非常常用的，几乎所有的canvas的 文章中都有它的不同方法和事件的介绍。这里还有更加详细的介绍。WHATWG Canvas Element, 2D Context??以及W3C HTML Canvas 2D Context Spec?。
• 跨文档和通道的消息通讯?――跨文档通讯定义了一种在文档之间通讯的方法，它不受源区域的限制。同样的，通道消息传递使用了独立的代码实现直接通讯。WHATWG HTML, Cross document messaging，WHATWG HTML Cross channel messaging?以及W3C HTML5 Web Messaging spec?。
• Microdata?――在文档中新增了一个语义层，方便搜索引擎，浏览器等可以使用提取网页信息并提高浏览器的服务质量。?WHATWG HTML, Microdata?以及W3C Microdata spec?。
• Web Workers?――这是一个在后台运行的JavaScript调用API。它能够在不影响前端界面的情况下长期运行任务，从而避免任务执行造成的页面响应延迟。WHATWG HTML, Web Workers?和W3C Web Workers Spec?。
• Web?存储?――有点类似于cookies。WHATWG HTML, Web Storage?和W3C Web Storage spec?。
• Web Sockets?――允许页面使用WebSocket协议在浏览器和服务器间发送两路消息。WHATWG Web Sockets?和W3C Web Socket API?。
• Server sent events?服务器端发送事件??――允许服务器以DOM事件的形式向浏览器发送推送通知。WHATWG HTML, Server-sent events?和W3C Server-Sent Events?。

由 于篇幅的限制，这里不会将所有与HTML5相关的APIs都列举出来。其中一些常常被误以为是HTML5标准APIs的内容有地理位置 （Geolocation），索引数据库（Indexed DB），选择器(Selectors)，以及文件系统API(Filesystem API)。

W3C成员Mike Smith?编著了一个全方位介绍web平台和浏览器技术?的综合列表，非常值得一读。

文章之前提到了部分APIs目前得到浏览器支持的情况，但是浏览器对APIs的支持是在不断变化的，想要了解最新的进展，可以查看caniuse?。如果你发现有些APIs目前浏览器尚不支持，也不必灰心。这里还有一个补充功能用来帮助你模拟本地行为。可以查看HTML5 Cross Browser Polyfills?了解这一功能。

可以看看Remy Sharp的?HTML5 Demos?,通过查看这些源码进一步了解文章介绍的APIs。

这 里只是粗略地介绍了一下这些非常有用而且功能强大的APIs。如果想要更加深入地了解这些APIs的细节，你需要通过代码去学习。这将给你带来不一样的体 验。有些APIs目前还没有完全成熟，希望这篇文章能够让你对此更加有兴趣，并对这些将加入到浏览器中的功能更感兴趣。

文章来源：The developer's guide tothe HTML5 APIs

?