51、进度事件

简介: 进度事件用来描述资源加载的进度,主要由 AJAX 请求、<img>、<audio>、<video>、<style>、<link>等外部资源的加载触发,继承了ProgressEvent接口。它主要包含以下几种事件。

进度事件的种类

进度事件用来描述资源加载的进度,主要由 AJAX 请求、<img><audio><video><style><link>等外部资源的加载触发,继承了ProgressEvent接口。它主要包含以下几种事件。

  • abort:外部资源中止加载时(比如用户取消)触发。如果发生错误导致中止,不会触发该事件。
  • error:由于错误导致外部资源无法加载时触发。
  • load:外部资源加载成功时触发。
  • loadstart:外部资源开始加载时触发。
  • loadend:外部资源停止加载时触发,发生顺序排在errorabortload等事件的后面。
  • progress:外部资源加载过程中不断触发。
  • timeout:加载超时时触发。

注意,除了资源下载,文件上传也存在这些事件。

下面是一个例子。

image.addEventListener('load', function (event) {
  image.classList.add('finished');
});
image.addEventListener('error', function (event) {
  image.style.display = 'none';
});

上面代码在图片元素加载完成后,为图片元素添加一个finished的 Class。如果加载失败,就把图片元素的样式设置为不显示。

有时候,图片加载会在脚本运行之前就完成,尤其是当脚本放置在网页底部的时候,因此有可能loaderror事件的监听函数根本不会执行。所以,比较可靠的方式,是用complete属性先判断一下是否加载完成。

function loaded() {
  // ...
}
if (image.complete) {
  loaded();
} else {
  image.addEventListener('load', loaded);
}

由于 DOM 的元素节点没有提供是否加载错误的属性,所以error事件的监听函数最好放在<img>元素的 HTML 代码中,这样才能保证发生加载错误时百分之百会执行。

<img src="/wrong/url" onerror="this.style.display='none';" />

loadend事件的监听函数,可以用来取代abort事件、load事件、error事件的监听函数,因为它总是在这些事件之后发生。

req.addEventListener('loadend', loadEnd, false);
function loadEnd(e) {
  console.log('传输结束,成功失败未知');
}

loadend事件本身不提供关于进度结束的原因,但可以用它来做所有加载结束场景都需要做的一些操作。

另外,error事件有一个特殊的性质,就是不会冒泡。所以,子元素的error事件,不会触发父元素的error事件监听函数。

ProgressEvent 接口

ProgressEvent接口主要用来描述外部资源加载的进度,比如 AJAX 加载、<img><video><style><link>等外部资源加载。进度相关的事件都继承了这个接口。

浏览器原生提供了ProgressEvent()构造函数,用来生成事件实例。

new ProgressEvent(type, options)

ProgressEvent()构造函数接受两个参数。第一个参数是字符串,表示事件的类型,这个参数是必须的。第二个参数是一个配置对象,表示事件的属性,该参数可选。配置对象除了可以使用Event接口的配置属性,还可以使用下面的属性,所有这些属性都是可选的。

  • lengthComputable:布尔值,表示加载的总量是否可以计算,默认是false
  • loaded:整数,表示已经加载的量,默认是0
  • total:整数,表示需要加载的总量,默认是0

ProgressEvent具有对应的实例属性。

  • ProgressEvent.lengthComputable
  • ProgressEvent.loaded
  • ProgressEvent.total

如果ProgressEvent.lengthComputablefalseProgressEvent.total实际上是没有意义的。

下面是一个例子。

var p = new ProgressEvent('load', {
  lengthComputable: true,
  loaded: 30,
  total: 100,
});
document.body.addEventListener('load', function (e) {
  console.log('已经加载:' + (e.loaded / e.total) * 100 + '%');
});
document.body.dispatchEvent(p);
// 已经加载:30%

上面代码先构造一个load事件,抛出后被监听函数捕捉到。

下面是一个实际的例子。

var xhr = new XMLHttpRequest();
xhr.addEventListener('progress', updateProgress, false);
xhr.addEventListener('load', transferComplete, false);
xhr.addEventListener('error', transferFailed, false);
xhr.addEventListener('abort', transferCanceled, false);
xhr.open();
function updateProgress(e) {
  if (e.lengthComputable) {
    var percentComplete = e.loaded / e.total;
  } else {
    console.log('不能计算进度');
  }
}
function transferComplete(e) {
  console.log('传输结束');
}
function transferFailed(evt) {
  console.log('传输过程中发生错误');
}
function transferCanceled(evt) {
  console.log('用户取消了传输');
}

上面是下载过程的进度事件,还存在上传过程的进度事件。这时所有监听函数都要放在XMLHttpRequest.upload对象上面。

var xhr = new XMLHttpRequest();
xhr.upload.addEventListener('progress', updateProgress, false);
xhr.upload.addEventListener('load', transferComplete, false);
xhr.upload.addEventListener('error', transferFailed, false);
xhr.upload.addEventListener('abort', transferCanceled, false);
xhr.open();
目录
相关文章
|
Linux 数据处理
Linux中的mknod命令:深入解析与实用指南
**mknod命令详解:Linux下创建设备文件与FIFO** Linux中的mknod用于创建设备文件(块设备、字符设备)和命名管道。需root权限,语法:`mknod NAME TYPE MAJOR MINOR`。例如,创建块设备`/dev/sda`(b 8 0)和字符设备`/dev/null`(c 1 3)。命名管道示例:`mknod /tmp/myfifo p`。注意:现代系统多用udev管理设备文件,手动使用需谨慎。
|
安全 网络安全
定级备案是什么,通信网络单元定级备案怎么做
定级备案适用主体:定级备案对象是指持有“增值电信业务许可证”的企业。取得增值电信业务经营许可证的企业,例如持有ICP、EDI的企业都应开展增值电信网络单元定级备案工作,针对的是与电信业务服务相关的网络和信息系统,如果不按照管局的要求开展通信网络单元定级备案,轻则罚款,重则停业整顿,甚至列入失信名单。
|
SQL 前端开发 JavaScript
springboot+vue 前后端交互实现(mysql+springboot+vue)
springboot+vue 前后端交互实现(mysql+springboot+vue)
995 1
|
Java
提高代码质量的秘诀:类、方法、字段和包注释
提高代码质量的秘诀:类、方法、字段和包注释
124 0
|
JSON 编解码 文字识别
Flutter UI自动化测试技术方案选型与探索
Flutter页面无法直接使用Native测试工具定位元素,给自动化测试带来很多不便。虽然Google官方推出了Flutter driver 和 Integration test,但是在实际使用中存在以下问题:
763 0
Flutter UI自动化测试技术方案选型与探索
|
Java 区块链 开发工具
Hyperledger Fabric 2.x 自定义智能合约
本文分享如何使用 Java 语言开发智能合约,以及合约的安装与使用。
800 0
Hyperledger Fabric 2.x 自定义智能合约
|
Prometheus 监控 Cloud Native
极简教程 | 使用Actuator 实现Spring Boot 应用监控
我们知道Spring Boot 提供了Actuator组件,方便我们对应用程序进行监控和维护。接下来,就来介绍Actuator到底是什么? 如何在Spring Boot项目中快速集成Actuator?
极简教程 | 使用Actuator 实现Spring Boot 应用监控
|
分布式计算 关系型数据库 MySQL
sqoop 把 hdfs 和关系型数据库 (mysql等)互导
简介         Sqoop是一个用来将Hadoop和关系型数据库中的数据相互转移的工具,可以将一个关系型数据库(例如 : MySQL ,Oracle ,Postgres等)中的数据导入到Hadoop的HDFS中,也可以将HDFS的数据导入到关系型数据库中。 http://sqoop.apache.org/   导出导入的数据与字段的顺序进行匹配
2240 0
数据自定义格式化
如 这样时间格式就从 2000-01-01 00:00:00 变成了  2000年1月1日了 常用的格式化公式: {0:C}:货币 {0:D8}:用0补充的8个字符的字段中显示整数 {0:000.
796 0

热门文章

最新文章