API 版本: 0.6.2
显示:

PreloadJS 模块

定义: PreloadJS:6

PreloadJS提供了一个一致的方式预先加载在HTML应用的内容,以及预加载可以使用HTML标签作为XHR完成。

默认, PreloadJS 将尝试使用XHR加载内容,因为它提供了进度和完成事件方面的更好支持, 然而由于跨域的问题,它可能仍然是优选使用基于标签的负载代替。 请注意,某些内容要求XHR工作(纯文本,网页音频)和一些需要的标签(HTML音频)。请注意,这是自动处理在可能的情况。

PreloadJS目前支持所有现代浏览器,我们已竭尽所能,以包括最老的浏览器的支持。 如果你发现一个问题与任何特定的操作系统/浏览器的组合, 请访问 http://community.createjs.com/ 和报告BUG。

入门

要开始使用,请查看 LoadQueue 类, 其中包括如何加载文件和处理结果的简要概述。

实例

 var queue = new createjs.LoadQueue();
 queue.installPlugin(createjs.Sound);
 queue.on("complete", handleComplete, this);
 queue.loadFile({id:"sound", src:"http://path/to/sound.mp3"});
 queue.loadManifest([
     {id: "myImage", src:"path/to/myImage.jpg"}
 ]);
 function handleComplete() {
     createjs.Sound.play("sound");
     var image = queue.getResult("myImage");
     document.body.appendChild(image);
 }

在插件重要提示: 必须安装插件项目添加到队列前,否则他们将不会被处理,即使负载实际上并没有拉开序幕呢。当项目被添加到LoadQueue插件功能的处理。

浏览器兼容性

PreloadJS兼容所有部分浏览器,并完全兼容所有现代浏览器。已知的例外:

  • 任何内容XHR加载都不支持在很多老的浏览器上运行(在这里看到一个矩阵: http://caniuse.com/xhr2). 在许多情况下,您可以依靠标签加载(图像、音频、CSS、脚本和SVG)。文本和WebAudio只会使用XHR;
  • 一些格式支持完整的不良事件在IE 6,7,8(SVG标记加载脚本,XML / JSON);
  • Opera 和 XHR 支持 SVG 加载不太好;
  • CSS加载Android和Safari不会使用标签(目前,解决方案正在进行中)
  • 与XHR本地加载是不允许的,这需要一些文件格式。测试本地内容时使用一个本地服务器, 或启用加载标记,这是大多数格式支持。请看 setUseXHR 了解更多信息。

跨域加载

大多数内容类型可以加载跨域,只要服务器支持CORS。 PreloadJS也有图像内部支持从启用CORS服务器提供服务,通过对在crossOrigin参数 LoadQueue 构造函数。如果设置为一个字符串值(如“匿名”),由PreloadJS生成的图像的“crossOrigin”属性设置为该值。请注意, 从未经CORS一个服务器提供的图像上设置crossOrigin值将导致其他错误。有关CORS更多信息,请访问: https://en.wikipedia.org/wiki/Cross-origin_resource_sharing.