为了配合标记的变化,HTML5 规范也用显著篇幅定义了很多 JavaScript API。定义这些 API的用意就是简化此前实现起来困 难重重的任务,最终简化创建动态 Web 界面的工作。
1 跨文档消息传递
跨文档消息传送(cross-document messaging),有时候简称为XDM,指的是在来自不同域的页面间 传递消息。例如,www.wrox.com域中的页面与位于一个内嵌框架中的 p2p.wrox.com域中的页面通信。 在 XDM 机制出现之前,要稳妥地实现这种通信需要花很多工夫。XDM 把这种机制规范化,让我们能 既稳妥又简单地实现跨文档通信。
XDM的核心是 postMessage()方法。在 HTML5规范中,除了 XDM部分之外的其他部分也会提 到这个方法名,但都是为了同一个目的:向另一个地方传递数据。对于 XDM而言,“另一个地方”指的 是包含在当前页面中的
postMessage()方法接收两个参数:一条消息和一个表示消息接收方来自哪个域的字符串。第二 个参数对保障安全通信非常重要,可以防止浏览器把消息发送到不安全的地方。
//注意:所有支持 XDM 的浏览器也支持 iframe 的 contentWindow 属性
var iframeWindow = document.getElementById("myframe").contentWindow;
iframeWindow.postMessage("A secret", "http://www.wrox.com");
最后一行代码尝试向内嵌框架中发送一条消息,并指定框架中的文档必须来源于"http:// www.wrox.com"域。如果来源匹配,消息会传递到内嵌框架中;否则,postMessage()什么也不做。 这一限制可以避免窗口中的位置在你不知情的情况下发生改变。如果传给 postMessage()的第二个参 数是"*",则表示可以把消息发送给来自任何域的文档,但我们不推荐这样做。
接收到 XDM消息时,会触发 window 对象的 message 事件。这个事件是以异步形式触发的,因此 从发送消息到接收消息(触发接收窗口的 message 事件)可能要经过一段时间的延迟。触发 message 事件后,传递给 onmessage 处理程序的事件对象包含以下三方面的重要信息。
data:作为 postMessage()第一个参数传入的字符串数据。
origin:发送消息的文档所在的域,例如"http://www.wrox.com"。
source:发送消息的文档的 window 对象的代理。这个代理对象主要用于在发送上一条消息的 窗口中调用 postMessage()方法。如果发送消息的窗口来自同一个域,那这个对象就是 window
接收到消息后验证发送窗口的来源是至关重要的。就像给 postMessage()方法指定第二个参数, 以确保浏览器不会把消息发送给未知页面一样,在 onmessage 处理程序中检测消息来源可以确保传入 的消息来自已知的页面。
还是要提醒大家,event.source 大多数情况下只是 window 对象的代理,并非实际的 window 对 象。换句话说,不能通过这个代理对象访问 window 对象的其他任何信息。记住,只通过这个代理调用 postMessage()就好,这个方法永远存在,永远可以调用。
XDM还有一些怪异之处。首先,postMessage()的第一个参数最早是作为“永远都是字符串”来实 现的。但后来这个参数的定义改了,改成允许传入任何数据结构。可是,并非所有浏览器都实现了这一 变化。为保险起见,使用 postMessage()时,最好还是只传字符串。如果你想传入结构化的数据,最 佳选择是先在要传入的数据上调用 JSON.stringify(),通过 postMessage()传入得到的字符串,然 后再在 onmessage 事件处理程序中调用 JSON.parse()。
在通过内嵌框架加载其他域的内容时,使用 XDM是非常方便的。因此,在混搭(mashup)和社交 网络应用中,这种传递消息的方法极为常用。有了 XDM,包含
2 原生拖放
最早在网页中引入 JavaScript 拖放功能的是 IE4。当时,网页中只有两种对象可以拖放:图像和某 些文本。拖动图像时,把鼠标放在图像上,按住鼠标不放就可以拖动它。拖动文本时,要先选中文本, 然后可以像拖动图像一样拖动被选中的文本。在 IE 4中,唯一有效的放置目标是文本框。到了 IE5,拖 放功能得到扩展,添加了新的事件,而且几乎网页中的任何元素都可以作为放置目标。IE5.5更进一步, 让网页中的任何元素都可以拖放。(IE6同样也支持这些功能。)HTML5以 IE的实例为基础制定了拖放 规范。Firefox 3.5、Safari 3+和 Chrome也根据 HTML5规范实现了原生拖放功能。
说到拖放,最有意思的恐怕就是能够在框架间、窗口间,甚至在应用间拖放网页元素了。浏览器对 拖放的支持为实现这些功能提供了便利
2.1 拖放事件
通过拖放事件,可以控制拖放相关的各个方面。其中最关键的地方在于确定哪里发生了拖放事件, 有些事件是在被拖动的元素上触发的,而有些事件是在放置目标上触发的。拖动某元素时,将依次触发 下列事件:
(1) dragstart
(2) drag
(3) dragend
按下鼠标键并开始移动鼠标时,会在被拖放的元素上触发 dragstart 事件。此时光标变成“不能放” 符号(圆环中有一条反斜线),表示不能把元素放到自己上面。拖动开始时,可以通过 ondragstart 事件处理程序来运行 JavaScript代码。
触发 dragstart 事件后,随即会触发 drag 事件,而且在元素被拖动期间会持续触发该事件。这 个事件与 mousemove 事件相似,在鼠标移动过程中,mousemove 事件也会持续发生。当拖动停止时(无 论是把元素放到了有效的放置目标,还是放到了无效的放置目标上),会触发 dragend 事件。
上述三个事件的目标都是被拖动的元素。默认情况下,浏览器不会在拖动期间改变被拖动元素的外 观,但你可以自己修改。不过,大多数浏览器会为正被拖动的元素创建一个半透明的副本,这个副本始 终跟随着光标移动。
当某个元素被拖动到一个有效的放置目标上时,下列事件会依次发生:
(1) dragenter
(2) dragover
(3) dragleave 或 drop
只要有元素被拖动到放置目标上,就会触发 dragenter 事件(类似于 mouseover 事件)。紧随其 后的是 dragover 事件,而且在被拖动的元素还在放置目标的范围内移动时,就会持续触发该事件。如 果元素被拖出了放置目标,dragover 事件不再发生,但会触发 dragleave 事件(类似于 mouseout 事件)。如果元素被放到了放置目标中,则会触发 drop 事件而不是 dragleave 事件。上述三个事件的 目标都是作为放置目标的元素。
2.2 自定义放置目标
在拖动元素经过某些无效放置目标时,可以看到一种特殊的光标(圆环中有一条反斜线),表示不 能放置。虽然所有元素都支持放置目标事件,但这些元素默认是不允许放置的。如果拖动元素经过不允 许放置的元素,无论用户如何操作,都不会发生 drop 事件。不过,你可以把任何元素变成有效的放置 目标,方法是重写 dragenter 和 dragover 事件的默认行为。例如,假设有一个 ID为"droptarget" 的
var droptarget = document.getElementById("droptarget");
EventUtil.addHandler(droptarget, "dragover", function(event){
EventUtil.preventDefault(event);
});
EventUtil.addHandler(droptarget, "dragenter", function(event){
EventUtil.preventDefault(event);
});
以上代码执行后,你就会发现当拖动着元素移动到放置目标上时,光标变成了允许放置的符号。当 然,释放鼠标也会触发 drop 事件。
2.3 dataTransfer对象
只有简单的拖放而没有数据变化是没有什么用的。为了在拖放操作时实现数据交换,IE 5 引入了 dataTransfer 对象,它是事件对象的一个属性,用于从被拖动元素向放置目标传递字符串格式的数据。 因为它是事件对象的属性,所以只能在拖放事件的事件处理程序中访问 dataTransfer 对象。在事件 处理程序中,可以使用这个对象的属性和方法来完善拖放功能。目前,HTML5 规范草案也收入了 dataTransfer 对象。
dataTransfer 对象有两个主要方法:getData()和 setData()。不难想象,getData()可以取 得由 setData()保存的值。setData()方法的第一个参数,也是 getData()方法唯一的一个参数,是 一个字符串,表示保存的数据类型,取值为"text"或"URL"
IE只定义了"text"和"URL"两种有效的数据类型,而HTML5则对此加以扩展,允许指定各种MIME 类型。考虑到向后兼容,HTML5 也支持"text"和"URL",但这两种类型会被映射为"text/plain"和 "text/uri-list"。
实际上,dataTransfer 对象可以为每种 MIME 类型都保存一个值。换句话说,同时在这个对象 中保存一段文本和一个 URL不会有任何问题。不过,保存在 dataTransfer 对象中的数据只能在 drop 事件处理程序中读取。如果在 ondrop 处理程序中没有读到数据,那就是 dataTransfer 对象已经被 销毁,数据也丢失了。
在拖动文本框中的文本时,浏览器会调用 setData()方法,将拖动的文本以"text"格式保存在 dataTransfer 对象中。类似地,在拖放链接或图像时,会调用 setData()方法并保存 URL。然后, 在这些元素被拖放到放置目标时,就可以通过 getData()读到这些数据。当然,作为开发人员,你也 可以在 dragstart 事件处理程序中调用 setData(),手工保存自己要传输的数据,以便将来使用。
将数据保存为文本和保存为 URL 是有区别的。如果将数据保存为文本格式,那么数据不会得到任 何特殊处理。而如果将数据保存为 URL,浏览器会将其当成网页中的链接。换句话说,如果你把它放置 到另一个浏览器窗口中,浏览器就会打开该 URL。
2.4 dropEffect与effectAllowed
利用 dataTransfer 对象,可不光是能够传输数据,还能通过它来确定被拖动的元素以及作为放 置目标的元素能够接收什么操作。为此,需要访问 dataTransfer 对象的两个属性:dropEffect 和 effectAllowed。
其中,通过 dropEffect 属性可以知道被拖动的元素能够执行哪种放置行为。这个属性有下列 4 个可能的值。
"none":不能把拖动的元素放在这里。这是除文本框之外所有元素的默认值。
"move":应该把拖动的元素移动到放置目标。
"copy":应该把拖动的元素复制到放置目标。
"link":表示放置目标会打开拖动的元素(但拖动的元素必须是一个链接,有 URL)。
在把元素拖动到放置目标上时,以上每一个值都会导致光标显示为不同的符号。然而,要怎样实现 光标所指示的动作完全取决于你。换句话说,如果你不介入,没有什么会自动地移动、复制,也不会打 开链接。总之,浏览器只能帮你改变光标的样式,而其他的都要靠你自己来实现。要使用 dropEffect 属性,必须在 ondragenter 事件处理程序中针对放置目标来设置它。
dropEffect 属性只有搭配 effectAllowed 属性才有用。effectAllowed 属性表示允许拖动元 素的哪种 dropEffect,effectAllowed 属性可能的值如下。
"uninitialized":没有给被拖动的元素设置任何放置行为。
"none":被拖动的元素不能有任何行为。
"copy":只允许值为"copy"的 dropEffect。
"link":只允许值为"link"的 dropEffect。
"move":只允许值为"move"的 dropEffect。
"copyLink":允许值为"copy"和"link"的 dropEffect。
"copyMove":允许值为"copy"和"move"的 dropEffect。
"linkMove":允许值为"link"和"move"的 dropEffect。
"all":允许任意 dropEffect。
必须在 ondragstart 事件处理程序中设置 effectAllowed 属性。
假设你想允许用户把文本框中的文本拖放到一个
2.5 可拖动
默认情况下,图像、链接和文本是可以拖动的,也就是说,不用额外编写代码,用户就可以拖动它 们。文本只有在被选中的情况下才能拖动,而图像和链接在任何时候都可以拖动。
让其他元素可以拖动也是可能的。HTML5为所有 HTML元素规定了一个 draggable 属性,表 示元素是否可以拖动。图像和链接的 draggable 属性自动被设置成了 true,而其他元素这个属性 的默认值都是 false。要想让其他元素可拖动,或者让图像或链接不能拖动,都可以设置这个属性。
2.6 其他成员
HTML5规范规定 dataTransfer 对象还应该包含下列方法和属性。
addElement(element):为拖动操作添加一个元素。添加这个元素只影响数据(即增加作为拖 动源而响应回调的对象),不会影响拖动操作时页面元素的外观。在写作本书时,只有 Firefox 3.5+ 实现了这个方法。
clearData(format):清除以特定格式保存的数据。实现这个方法的浏览器有 IE、Fireforx 3.5+、 Chrome和 Safari 4+。
setDragImage(element, x, y):指定一幅图像,当拖动发生时,显示在光标下方。这个方法接收的三个参数分别是要显示的 HTML元素和光标在图像中的 x、y坐标。其中,HTML元素 可以是一幅图像,也可以是其他元素。是图像则显示图像,是其他元素则显示渲染后的元素。 实现这个方法的浏览器有 Firefox 3.5+、Safari 4+和 Chrome。
types:当前保存的数据类型。这是一个类似数组的集合,以"text"这样的字符串形式保存着 数据类型。实现这个属性的浏览器有 IE10+、Firefox 3.5+和 Chrome。
3 媒体元素
随着音频和视频在 Web 上的迅速流行,大多数提供富媒体内容的站点为了保证跨浏览器兼容性, 不得不选择使用 Flash。HTML5新增了两个与媒体相关的标签,让开发人员不必依赖任何插件就能在网 页中嵌入跨浏览器的音频和视频内容。
这两个标签就是
使用这两个元素时,至少要在标签中包含 src 属性,指向要加载的媒体文件。还可以设置 width 和 height 属性以指定视频播放器的大小,而为 poster 属性指定图像的 URI可以在加载视频内容期间 显示一幅图像。另外,如果标签中有 controls 属性,则意味着浏览器应该显示 UI控件,以便用户直 接操作媒体。位于开始和结束标签之间的任何内容都将作为后备内容,在浏览器不支持这两个媒体元素 的情况下显示。
3.1 属性
元素都提供了完善的 JavaScript 接口。下表列出了这两个元素共有的属性,通 过这些属性可以知道媒体的当前状态。
3.2 事件
除了大量属性之外,这两个媒体元素还可以触发很多事件。这些事件监控着不同的属性的变化,这 些变化可能是媒体播放的结果,也可能是用户操作播放器的结果。下表列出了媒体元素相关的事件。
3.3 自定义媒体播放器
使用
3.4 检测编解码器的支持情况
如前所述,并非所有浏览器都支持
如果给 canPlayType()传入了一种 MIME类型,则返回值很可能是"maybe"或空字符串。这是因 为媒体文件本身只不过是音频或视频的一个容器,而真正决定文件能否播放的还是编码的格式。在同时 传入 MIME类型和编解码器的情况下,可能性就会增加,返回的字符串会变成"probably"。
3.5 Audio类型
audio元素还有一个原生的 JavaScript构造函数 Audio,可以在任何时候播放音频。从同为 DOM 元素的角度看,Audio 与 Image 很相似,但 Audio 不用像 Image 那样必须插入到文档中。只要创建一个新实例,并传入音频源文件即可。
创建新的 Audio 实例即可开始下载指定的文件。下载完成后,调用 play()就可以播放音频。 在 iOS中,调用 play()时会弹出一个对话框,得到用户的许可后才能播放声音。如果想在一段音 频播放后再播放另一段音频,必须在 onfinish 事件处理程序中调用 play()方法。
4 历史状态管理
历史状态管理是现代 Web 应用开发中的一个难点。在现代 Web 应用中,用户的每次操作不一定会 打开一个全新的页面,因此“后退”和“前进”按钮也就失去了作用,导致用户很难在不同状态间切换。 要解决这个问题,首选使用 hashchange 事件(第 13章曾讨论过)。HTML5通过更新 history 对象为 管理历史状态提供了方便。
通过 hashchange 事件,可以知道 URL的参数什么时候发生了变化,即什么时候该有所反应。而 通过状态管理 API,能够在不加载新页面的情况下改变浏览器的 URL。为此,需要使用 history.pushState()方法,该方法可以接收三个参数:状态对象、新状态的标题和可选的相对 URL
例如:
history.pushState({name:"Nicholas"}, "Nicholas' page", "nicholas.html");
执行 pushState()方法后,新的状态信息就会被加入历史状态栈,而浏览器地址栏也会变成新的 相对 URL。但是,浏览器并不会真的向服务器发送请求,即使状态改变之后查询 location.href 也会 返回与地址栏中相同的地址。另外,第二个参数目前还没有浏览器实现,因此完全可以只传入一个空字 符串,或者一个短标题也可以。而第一个参数则应该尽可能提供初始化页面状态所需的各种信息。
因为 pushState()会创建新的历史状态,所以你会发现“后退”按钮也能使用了。按下“后退” 按钮,会触发 window 对象的 popstate 事件①。popstate 事件的事件对象有一个 state 属性,这个 属性就包含着当初以第一个参数传递给 pushState()的状态对象。
得到这个状态对象后,必须把页面重置为状态对象中的数据表示的状态(因为浏览器不会自动为你 做这些)。记住,浏览器加载的第一个页面没有状态,因此单击“后退”按钮返回浏览器加载的第一个 页面时,event.state 值为 null。
要更新当前状态,可以调用 replaceState(),传入的参数与 pushState()的前两个参数相同。 调用这个方法不会在历史状态栈中创建新状态,只会重写当前状态。