本文演示了如何创建和分派 DOM 事件。这些事件通常称为合成事件，而不是浏览器本身触发的事件。
- -创建自定义事件
- -Events 可以使用 Event 构造函数创建如下：
var event = new Event('build');
-
-// Listen for the event.
-elem.addEventListener('build', function (e) { ... }, false);
-
-// Dispatch the event.
-elem.dispatchEvent(event);
-
-上述代码使用了 EventTarget.dispatchEvent() 方法。
- -绝大多数现代浏览器中都会支持这个构造函数（Internet Explorer 例外）。 要了解更为复杂的方法，可参考下面的 过时的方式 一节。
- -添加自定义数据 – CustomEvent()
- -要向事件对象添加更多数据，可以使用 CustomEvent 接口，detail 属性可用于传递自定义数据。
- 例如，event 可以创建如下：
var event = new CustomEvent('build', { 'detail': elem.dataset.time });
-
-下面的代码允许你在事件监听器中访问更多的数据：
- -function eventHandler(e) {
- log('The time is: ' + e.detail);
-}
-
-
-过时的方式
- -早期的创建事件的方法使用了受 Java 启发的 API。下面展示了一个示例：
- -// Create the event.
-var event = document.createEvent('Event');
-
-// Define that the event name is 'build'.
-event.initEvent('build', true, true);
-
-// Listen for the event.
-document.addEventListener('build', function (e) {
- // e.target matches document from above
-}, false);
-
-// target can be any Element or other EventTarget.
-document.dispatchEvent(event);
-
-
-事件冒泡
- -通常需要从子元素触发事件，并让祖先捕获它：
- -<form> - <textarea></textarea> -</form>- -
const form = document.querySelector('form');
-const textarea = document.querySelector('textarea');
-
-// Create a new event, allow bubbling, and provide any data you want to pass to the "details" property
-const eventAwesome = new CustomEvent('awesome', {
- bubbles: true,
- detail: { text: () => textarea.value }
-});
-
-// The form element listens for the custom "awesome" event and then consoles the output of the passed text() method
-form.addEventListener('awesome', e => console.log(e.detail.text()));
-
-// As the user types, the textarea inside the form dispatches/triggers the event to fire, and uses itself as the starting point
-textarea.addEventListener('input', e => e.target.dispatchEvent(eventAwesome));
-
-动态创建和派发事件
- -元素可以侦听尚未创建的事件：
- -<form>
- <textarea></textarea>
-</form>const form = document.querySelector('form');
-const textarea = document.querySelector('textarea');
-
-form.addEventListener('awesome', e => console.log(e.detail.text()));
-
-textarea.addEventListener('input', function() {
- // Create and dispatch/trigger an event on the fly
- // Note: Optionally, we've also leveraged the "function expression" (instead of the "arrow function expression") so "this" will represent the element
- this.dispatchEvent(new CustomEvent('awesome', { bubbles: true, detail: { text: () => textarea.value } }))
-});
-
-
-
-触发内置事件
- -下面的例子演示了一个在复选框上点击（click）的模拟（就是说在程序里生成一个 click 事件），这个模拟点击使用了 DOM 方法。参见这个动态示例
- -function simulateClick() {
- var event = new MouseEvent('click', {
- 'view': window,
- 'bubbles': true,
- 'cancelable': true
- });
- var cb = document.getElementById('checkbox');
- var cancelled = !cb.dispatchEvent(event);
- if (cancelled) {
- // A handler called preventDefault.
- alert("cancelled");
- } else {
- // None of the handlers called preventDefault.
- alert("not cancelled");
- }
-}
-
-
-参见
- --
-
- CustomEvent() -
- {{domxref("document.createEvent()")}} -
- {{domxref("Event.initEvent()")}} -
- {{domxref("EventTarget.dispatchEvent()")}} -
- {{domxref("EventTarget.addEventListener()")}} -
{{SeeCompatTable}}
- -有越来越多的基于 web 的设备能够确定它们的方向; 也就是说，它们可以报告数据以指示基于重力方向的方向改变。特别地，手持设备如手机可以利用这些信息以自动旋转屏幕，保持内容直立，当设备旋转至横屏时（宽度大于高度），提供网页内容的横屏视图。
- -有两种 Javascript 事件负责处理设备方向信息。第一种是{{domxref("DeviceOrientationEvent")}}，它会在加速度传感器检测到设备在方向上产生变化时触发。通过处理该事件传来的数据信息，让交互式地响应用户移动设备旋转和仰角变化成为可能。
- -第二种是{{domxref("DeviceMotionEvent")}}，它会在加速度发生改变时触发。跟{{domxref("DeviceOrientationEvent")}}不同，{{domxref("DeviceMotionEvent")}}监听的是相应方向上加速度的变化。传感器通常都具有监听{{domxref("DeviceMotionEvent")}}的能力，包括笔记本中用于保护移动中的存储设备的传感器。{{domxref("DeviceOrientationEvent")}}事件更多见于移动设备中。
- -处理方向（orientation）事件
- -要接收设备方向变化信息，只需要监听{{ event("deviceorientation") }}事件：
- -
-
-
-注意：gyronorm.js is a polyfill for normalizing the accelerometer and gyroscope data on mobile devices. This is useful for overcoming some of the differences in device support for device orientation.
-window.addEventListener("deviceorientation", handleOrientation, true);
-
-
-注册完事件监听处理函数后（对应这个例子中的 handleOrientation），监听函数会定期地接收到最新的设备方向数据。
- -方向事件对象中包含四个值：
- -{{ domxref("DeviceOrientationEvent.absolute") }}
- -{{ domxref("DeviceOrientationEvent.alpha") }}
- -{{ domxref("DeviceOrientationEvent.beta") }}
- -{{ domxref("DeviceOrientationEvent.gamma") }}
- -下面是一个事件处理函数的例子：
- -function handleOrientation(orientData) {
- var absolute = orientData.absolute;
- var alpha = orientData.alpha;
- var beta = orientData.beta;
- var gamma = orientData.gamma;
-
- // Do stuff with the new orientation data
-}
-
-
-相关值解释
- -关于每一个轴的记录值表示的是相对于标准的坐标系，设备在某一个给定轴上的旋转量。Orientation and motion data explained 这篇文章有更详细的描述，下面是对这篇文章的总结。
- --
-
- {{ domxref("DeviceOrientationEvent.alpha") }} 表示设备沿 z 轴上的旋转角度，范围为 0~360。 -
- {{ domxref("DeviceOrientationEvent.beta") }} 表示设备在 x 轴上的旋转角度，范围为-180~180。它描述的是设备由前向后旋转的情况。 -
- {{ domxref("DeviceOrientationEvent.gamma") }} 表示设备在 y 轴上的旋转角度，范围为-90~90。它描述的是设备由左向右旋转的情况。 -
例子
- -这个例子会成功运行在支持检测自己方向的设备中的支持{{event("deviceorientation")}} 事件的浏览器中。
- -让我们想象一下有一个球在花园中：
- -<div class="garden">
- <div class="ball"></div>
-</div>
-
-<pre class="output"></pre>花园只有 200px 宽（很小对吧），球在中央：
- -.garden {
- position: relative;
- width : 200px;
- height: 200px;
- border: 5px solid #CCC;
- border-radius: 10px;
-}
-
-.ball {
- position: absolute;
- top : 90px;
- left : 90px;
- width : 20px;
- height: 20px;
- background: green;
- border-radius: 100%;
-}现在，如果我们移动设备，球将随之移动：
- -var ball = document.querySelector('.ball');
-var garden = document.querySelector('.garden');
-var output = document.querySelector('.output');
-
-var maxX = garden.clientWidth - ball.clientWidth;
-var maxY = garden.clientHeight - ball.clientHeight;
-
-function handleOrientation(event) {
- var x = event.beta; // In degree in the range [-180,180]
- var y = event.gamma; // In degree in the range [-90,90]
-
- output.innerHTML = "beta : " + x + "\n";
- output.innerHTML += "gamma: " + y + "\n";
-
- // Because we don't want to have the device upside down
- // We constrain the x value to the range [-90,90]
- if (x > 90) { x = 90};
- if (x < -90) { x = -90};
-
- // To make computation easier we shift the range of
- // x and y to [0,180]
- x += 90;
- y += 90;
-
- // 10 is half the size of the ball
- // It center the positioning point to the center of the ball
- ball.style.top = (maxX*x/180 - 10) + "px";
- ball.style.left = (maxY*y/180 - 10) + "px";
-}
-
-window.addEventListener('deviceorientation', handleOrientation);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-输出结果：
- -在{{LiveSampleLink("Orientation_example", "这里")}}以新窗口打开此示例；因为有些浏览器中的 {{event("deviceorientation")}} 事件不支持跨域。
- -{{EmbedLiveSample('Orientation_example', '230', '260')}}
-
-
-
-
-警告： Chrome 和 Firefox 处理角度的机制不同，所以某些轴上的方向是相反的。
-处理移动（motion）事件
- -移动事件的处理跟方向事件是一样的，除了他们有自己的事件名：{{ event("devicemotion") }}
- -window.addEventListener("devicemotion", handleMotion, true);真正不同的是做为参数传递给HandleMotion 函数的{{ domxref("DeviceMotionEvent") }}对象所包含的信息。
- -这个对象包含四个属性：
- --
-
- {{ domxref("DeviceMotionEvent.acceleration") }} -
- {{ domxref("DeviceMotionEvent.accelerationIncludingGravity") }} -
- {{ domxref("DeviceMotionEvent.rotationRate") }} -
- {{ domxref("DeviceMotionEvent.interval") }} -
相关值解释
- -{{ domxref("DeviceMotionEvent") }}对象提供给 web 开发者设备在位置和方向上的改变速度的相关信息。这些变化信息是通过三个轴来体现的。（Orientation and motion data explained有更详细的说明。）
- -acceleration 和 accelerationIncludingGravity，都包含下面三个轴：
-
-
x: 西向东
- y: 南向北
- z: 垂直地面
-
对于 rotationRate ，情况有点不同；三个轴的信息对应着以下三种情况：
-
-
alpha: 设备沿着垂直于屏幕（对于桌面设备则是垂直于键盘）的轴的旋转速率
- beta: 设备沿着屏幕（对于桌面设备则是键盘）左至右方向的轴的旋转速率 (桌面设备相对于键盘)
- gamma: 设备沿着屏幕（对于桌面设备则是键盘）下至上方向的轴的旋转速率
-
最后，interval 表示的是从设备获取数据的间隔时间，单位是毫秒。
规范
- -{{Specifications}} - -浏览器兼容性
- -{{Compat}} - -参见
- --
-
- {{domxref("DeviceOrientationEvent")}} -
- {{domxref("DeviceMotionEvent")}} -
- The legacy
MozOrientationevent.
- - Orientation and motion data explained -
- Using deviceorientation in 3D Transforms -
+
+
+
+
+```
+
+花园只有 200px 宽（很小对吧），球在中央：
+
+```css
+.garden {
+ position: relative;
+ width : 200px;
+ height: 200px;
+ border: 5px solid #CCC;
+ border-radius: 10px;
+}
+
+.ball {
+ position: absolute;
+ top : 90px;
+ left : 90px;
+ width : 20px;
+ height: 20px;
+ background: green;
+ border-radius: 100%;
+}
+```
+
+现在，如果我们移动设备，球将随之移动：
+
+```js
+var ball = document.querySelector('.ball');
+var garden = document.querySelector('.garden');
+var output = document.querySelector('.output');
+
+var maxX = garden.clientWidth - ball.clientWidth;
+var maxY = garden.clientHeight - ball.clientHeight;
+
+function handleOrientation(event) {
+ var x = event.beta; // In degree in the range [-180,180]
+ var y = event.gamma; // In degree in the range [-90,90]
+
+ output.innerHTML = "beta : " + x + "\n";
+ output.innerHTML += "gamma: " + y + "\n";
+
+ // Because we don't want to have the device upside down
+ // We constrain the x value to the range [-90,90]
+ if (x > 90) { x = 90};
+ if (x < -90) { x = -90};
+
+ // To make computation easier we shift the range of
+ // x and y to [0,180]
+ x += 90;
+ y += 90;
+
+ // 10 is half the size of the ball
+ // It center the positioning point to the center of the ball
+ ball.style.top = (maxX*x/180 - 10) + "px";
+ ball.style.left = (maxY*y/180 - 10) + "px";
+}
+
+window.addEventListener('deviceorientation', handleOrientation);
+```
+
+输出结果：
+
+在{{LiveSampleLink("Orientation_example", "这里")}}以新窗口打开此示例；因为有些浏览器中的 {{event("deviceorientation")}} 事件不支持跨域。
+
+{{EmbedLiveSample('Orientation_example', '230', '260')}}
+
+> **警告：** Chrome 和 Firefox 处理角度的机制不同，所以某些轴上的方向是相反的。
+
+## 处理移动（motion）事件
+
+移动事件的处理跟方向事件是一样的，除了他们有自己的事件名：{{ event("devicemotion") }}
+
+```js
+window.addEventListener("devicemotion", handleMotion, true);
+```
+
+真正不同的是做为参数传递给*HandleMotion 函数的*{{ domxref("DeviceMotionEvent") }}对象所包含的信息。
+
+这个对象包含四个属性：
+
+- {{ domxref("DeviceMotionEvent.acceleration") }}
+- {{ domxref("DeviceMotionEvent.accelerationIncludingGravity") }}
+- {{ domxref("DeviceMotionEvent.rotationRate") }}
+- {{ domxref("DeviceMotionEvent.interval") }}
+
+### 相关值解释
+
+{{ domxref("DeviceMotionEvent") }}对象提供给 web 开发者设备在位置和方向上的改变速度的相关信息。这些变化信息是通过三个轴来体现的。（[Orientation and motion data explained](/en-US/docs/Web/Guide/DOM/Events/Orientation_and_motion_data_explained)有更详细的说明。）
+
+[`acceleration`](/en-US/docs/Web/API/DeviceMotionEvent.acceleration) 和 [`accelerationIncludingGravity`](/en-US/docs/Web/API/DeviceMotionEvent.accelerationIncludingGravity)，都包含下面三个轴：
+
+- `x`: 西向东
+- `y`: 南向北
+- `z`: 垂直地面
+
+对于 [`rotationRate`](/en-US/docs/Web/API/DeviceMotionEvent.rotationRate) ，情况有点不同；三个轴的信息对应着以下三种情况：
+
+- `alpha`: 设备沿着垂直于屏幕（对于桌面设备则是垂直于键盘）的轴的旋转速率
+- `beta`: 设备沿着屏幕（对于桌面设备则是键盘）左至右方向的轴的旋转速率 (桌面设备相对于键盘)
+- `gamma`: 设备沿着屏幕（对于桌面设备则是键盘）下至上方向的轴的旋转速率
+
+最后，[`interval`](/en-US/docs/Web/API/DeviceMotionEvent.interval) 表示的是从设备获取数据的间隔时间，单位是毫秒。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("DeviceOrientationEvent")}}
+- {{domxref("DeviceMotionEvent")}}
+- The legacy [`MozOrientation`](/en-US/DOM/MozOrientation) event.
+- [Orientation and motion data explained](/en-US/docs/Web/Guide/DOM/Events/Orientation_and_motion_data_explained)
+- [Using deviceorientation in 3D Transforms](/en-US/docs/Web/Guide/DOM/Events/Using_device_orientation_with_3D_transforms)
diff --git a/files/zh-cn/web/events/index.html b/files/zh-cn/web/events/index.html
deleted file mode 100644
index 0866cf9235450e..00000000000000
--- a/files/zh-cn/web/events/index.html
+++ /dev/null
@@ -1,2947 +0,0 @@
----
-title: 事件参考
-slug: Web/Events
-tags:
- - Event
- - Web
- - 事件
- - 参考
- - 总览
-translation_of: Web/Events
----
-发送 DOM 事件是为了将发生的相关事情通知代码。每个事件都是继承自{{DOMxRef("Event")}} 接口的对象，可以包括自定义的成员属性及函数用于获取事件发生时相关的更多信息。事件可以表示任何从基本的用户交互、到发生在渲染模型自动通知的任何事情。
- -本文提供了一个可以发送的事件的列表；一些是官方标准中的标准事件，另一些则是在特定浏览器内部使用的事件；例如，列出的 Mozilla 特定事件，使附加组件可以借助它们与浏览器进行交互。
- -最常见的类别
- -| 事件名称 | -何时触发 | -
|---|---|
| {{Event("error")}} | -资源加载失败时。 | -
| {{Event("abort")}} | -正在加载资源已经被中止时。 | -
| {{Event("load")}} | -资源及其相关资源已完成加载。 | -
| {{Event("beforeunload")}} | -window，document 及其资源即将被卸载。 | -
| {{Event("unload")}} | -文档或一个依赖资源正在被卸载。 | -
网络事件
- -| 事件名称 | -何时触发 | -
|---|---|
| {{Event("online")}} | -浏览器已获得网络访问。 | -
| {{Event("offline")}} | -浏览器已失去网络访问。 | -
| 事件名称 | -何时触发 | -
|---|---|
| {{Event("focus")}} | -元素获得焦点（不会冒泡）。 | -
| {{Event("blur")}} | -元素失去焦点（不会冒泡）。 | -
| 事件名称 | -何时触发 | -
|---|---|
open |
- WebSocket 连接已建立。 | -
message |
- 通过 WebSocket 接收到一条消息。 | -
| {{Event("error")}} | -WebSocket 连接异常被关闭（比如有些数据无法发送）。 | -
close |
- WebSocket 连接已关闭。 | -
| 事件名称 | -何时触发 | -
|---|---|
| {{Event("pagehide")}} | -A session history entry is being traversed from. | -
| {{Event("pageshow")}} | -A session history entry is being traversed to. | -
| {{Event("popstate")}} | -A session history entry is being navigated to (in certain cases). | -
| 事件名称 | -何时触发 | -
|---|---|
| {{Event("animationstart")}} | -某个 CSS 动画开始时触发。 | -
| {{Event("animationend")}} | -某个 CSS 动画完成时触发。 | -
| {{Event("animationiteration")}} | -某个 CSS 动画完成后重新开始时触发。 | -
| 事件名称 | -何时触发 | -
|---|---|
| {{Event("transitionstart")}} | -A CSS transition has actually started (fired after any delay). | -
| {{Event("transitioncancel")}} | -CSS 过渡被取消 | -
| {{Event("transitionend")}} | -CSS 过渡已经完成 | -
| {{Event("transitionrun")}} | -A CSS transition has begun running (fired before any delay starts). | -
| 事件名称 | -何时触发 | -
|---|---|
| {{Event("reset")}} | -点击重置按钮时 | -
| {{Event("submit")}} | -点击提交按钮 | -
| 时间名称 | -何时触发 | -
|---|---|
| {{Event("beforeprint")}} | -打印机已经就绪时触发 | -
| {{Event("afterprint")}} | -打印机关闭时触发 | -
| Event Name | -Fired When | -
|---|---|
| {{Event("compositionstart")}} | -The composition of a passage of text is prepared (similar to keydown for a keyboard input, but works with other inputs such as speech recognition). | -
| {{Event("compositionupdate")}} | -A character is added to a passage of text being composed. | -
| {{Event("compositionend")}} | -The composition of a passage of text has been completed or canceled. | -
| Event Name | -Fired When | -
|---|---|
| {{Event("fullscreenchange")}} | -An element was turned to fullscreen mode or back to normal mode. | -
| {{Event("fullscreenerror")}} | -It was impossible to switch to fullscreen mode for technical reasons or because the permission was denied. | -
| {{Event("resize")}} | -The document view has been resized. | -
| {{Event("scroll")}} | -The document view or an element has been scrolled. | -
| Event Name | -Fired When | -
|---|---|
| {{Event("cut")}} | -已经剪贴选中的文本内容并且复制到了剪贴板。 | -
| {{Event("copy")}} | -已经把选中的文本内容复制到了剪贴板。 | -
| {{Event("paste")}} | -从剪贴板复制的文本内容被粘贴。 | -
| Event Name | -Fired When | -
|---|---|
| {{Event("keydown")}} | -按下任意按键。 | -
| {{Event("keypress")}} | -除 Shift、Fn、CapsLock 外的任意键被按住。（连续触发。） | -
| {{Event("keyup")}} | -释放任意按键。 | -
| Event Name | -Fired When | -
|---|---|
| {{Event("auxclick")}} | -A pointing device button (ANY non-primary button) has been pressed and released on an element. | -
| {{Event("click")}} | -在元素上按下并释放任意鼠标按键。 | -
| {{Event("contextmenu")}} | -右键点击（在右键菜单显示前触发）。 | -
| {{Event("dblclick")}} | -在元素上双击鼠标按钮。 | -
| {{Event("mousedown")}} | -在元素上按下任意鼠标按钮。 | -
| {{Event("mouseenter")}} | -指针移到有事件监听的元素内。 | -
| {{Event("mouseleave")}} | -指针移出元素范围外（不冒泡）。 | -
| {{Event("mousemove")}} | -指针在元素内移动时持续触发。 | -
| {{Event("mouseover")}} | -指针移到有事件监听的元素或者它的子元素内。 | -
| {{Event("mouseout")}} | -指针移出元素，或者移到它的子元素上。 | -
| {{Event("mouseup")}} | -在元素上释放任意鼠标按键。 | -
| {{Event("pointerlockchange")}} | -鼠标被锁定或者解除锁定发生时。 | -
| {{Event("pointerlockerror")}} | -可能因为一些技术的原因鼠标锁定被禁止时。 | -
| {{Event("select")}} | -有文本被选中。 | -
| {{Event("wheel")}} | -滚轮向任意方向滚动。 | -
| Event Name | -Fired When | -
|---|---|
| {{Event("drag")}} | -正在拖动元素或文本选区（在此过程中持续触发，每 350ms 触发一次） | -
| {{Event("dragend")}} | -拖放操作结束。（松开鼠标按钮或按下 Esc 键） | -
| {{Event("dragenter")}} | -被拖动的元素或文本选区移入有效释放目标区 | -
| {{Event("dragstart")}} | -用户开始拖动 HTML 元素或选中的文本 | -
| {{Event("dragleave")}} | -被拖动的元素或文本选区移出有效释放目标区 | -
| {{Event("dragover")}} | -被拖动的元素或文本选区正在有效释放目标上被拖动（在此过程中持续触发，每 350ms 触发一次） | -
| {{Event("drop")}} | -元素在有效释放目标区上释放 | -
| Event Name | -Fired When | -
|---|---|
| {{Event("audioprocess")}} | -The input buffer of a {{DOMxRef("ScriptProcessorNode")}} is ready to be processed. | -
| {{Event("canplay")}} | -The browser can play the media, but estimates that not enough data has been loaded to play the media up to its end without having to stop for further buffering of content. | -
| {{Event("canplaythrough")}} | -The browser estimates it can play the media up to its end without stopping for content buffering. | -
| {{Event("complete")}} | -The rendering of an {{DOMxRef("OfflineAudioContext")}} is terminated. | -
| {{Event("durationchange")}} | -The duration attribute has been updated. |
-
| {{Event("emptied")}} | -The media has become empty; for example, this event is sent if the media has already been loaded (or partially loaded), and the load() method is called to reload it. |
-
| {{Event("ended")}} | -Playback has stopped because the end of the media was reached. | -
| {{Event("loadeddata")}} | -The first frame of the media has finished loading. | -
| {{Event("loadedmetadata")}} | -The metadata has been loaded. | -
| {{Event("pause")}} | -Playback has been paused. | -
| {{Event("play")}} | -Playback has begun. | -
| {{Event("playing")}} | -Playback is ready to start after having been paused or delayed due to lack of data. | -
| {{Event("ratechange")}} | -The playback rate has changed. | -
| {{Event("seeked")}} | -A seek operation completed. | -
| {{Event("seeking")}} | -A seek operation began. | -
| {{Event("stalled")}} | -The user agent is trying to fetch media data, but data is unexpectedly not forthcoming. | -
| {{Event("suspend")}} | -Media data loading has been suspended. | -
| {{Event("timeupdate")}} | -The time indicated by the currentTime attribute has been updated. |
-
| {{Event("volumechange")}} | -The volume has changed. | -
| {{Event("waiting")}} | -Playback has stopped because of a temporary lack of data. | -
| Event Name | -Fired When | -
|---|---|
abort |
- Progression has been terminated (not due to an error). | -
| {{Event("error")}} | -Progression has failed. | -
load |
- Progression has been successful. | -
| {{Event("loadend")}} | -Progress has stopped (after "error", "abort" or "load" have been dispatched). | -
| {{Event("loadstart")}} | -Progress has begun. | -
| {{Event("progress")}} | -In progress. | -
| {{Event("timeout")}} | -Progression is terminated due to preset time expiring. | -
存储事件
- -{{Event("change")}} (参见 非标准事件)
- {{Event("storage")}}
更新事件
- -{{Event("checking")}}
- {{Event("downloading")}}
- {{Event("error")}}
- {{Event("noupdate")}}
- {{Event("obsolete")}}
- {{Event("updateready")}}
值变化事件
- -{{Event("broadcast")}}
- {{Event("CheckboxStateChange")}}
- {{Event("hashchange")}}
- {{Event("input")}}
- {{Event("RadioStateChange")}}
- {{Event("readystatechange")}}
- {{Event("ValueChange")}}
未分类的事件
- -{{Event("invalid")}}
- message
- message
- open
- show
不常见和非标准事件
- -Abortable Fetch events
- -| Event name | -Fired when | -
|---|---|
abort |
- A DOM request is aborted, i.e. using {{DOMxRef("AbortController.abort()")}}. | -
WebVR events
- -| Event name | -Fired when | -
|---|---|
| {{Event("vrdisplayactivate")}} | -When a VR display is able to be presented to, for example if an HMD has been moved to bring it out of standby, or woken up by being put on. | -
| {{Event("vrdisplayblur")}} | -when presentation to a {{DOMxRef("VRDisplay")}} has been paused for some reason by the browser, OS, or VR hardware — for example, while the user is interacting with a system menu or browser, to prevent tracking or loss of experience. | -
| {{Event("vrdisplayconnect")}} | -when a compatible {{DOMxRef("VRDisplay")}} is connected to the computer. | -
| {{Event("vrdisplaydeactivate")}} | -When a {{DOMxRef("VRDisplay")}} can no longer be presented to, for example if an HMD has gone into standby or sleep mode due to a period of inactivity. | -
| {{Event("vrdisplaydisconnect")}} | -When a compatible {{DOMxRef("VRDisplay")}} is disconnected from the computer. | -
| {{Event("vrdisplayfocus")}} | -When presentation to a {{DOMxRef("VRDisplay")}} has resumed after being blurred. | -
| {{Event("vrdisplaypresentchange")}} | -The presenting state of a {{DOMxRef("VRDisplay")}} changes — i.e. goes from presenting to not presenting, or vice versa. | -
SVG 事件
- -{{Event("SVGAbort")}}
- {{Event("SVGError")}}
- {{Event("SVGLoad")}}
- {{Event("SVGResize")}}
- {{Event("SVGScroll")}}
- {{Event("SVGUnload")}}
- {{Event("SVGZoom")}}
数据库事件
- -abort
- blocked
- complete
- {{Event("error")}}
- success
- upgradeneeded
- versionchange
脚本事件
- -{{Event("afterscriptexecute")}}
- {{Event("beforescriptexecute")}}
菜单事件
- -{{Event("DOMMenuItemActive")}}
- {{Event("DOMMenuItemInactive")}}
窗口事件
- - - -弹出事件
- -{{Event("popuphidden")}}
- {{Event("popuphiding")}}
- {{Event("popupshowing")}}
- {{Event("popupshown")}}
Tab 事件
- -{{Event("visibilitychange")}}
- --
-
电池事件
- -{{Event("chargingchange")}}
- {{Event("chargingtimechange")}}
- {{Event("dischargingtimechange")}}
- {{Event("levelchange")}}
呼叫事件
- -{{Event("alerting")}}
- {{Event("busy")}}
- {{Event("callschanged")}}
- {{Event("cfstatechange")}}
- {{Event("connected")}}
- {{Event("connecting")}}
- {{Event("dialing")}}
- {{Event("disconnected")}}
- {{Event("disconnecting")}}
- {{Event("error_(Telephony)","error")}}
- {{Event("held")}}, {{Event("holding")}}
- {{Event("incoming")}}
- {{Event("resuming")}}
- {{Event("statechange")}}
- {{Event("voicechange")}}
传感器事件
- -{{Event("compassneedscalibration")}}
- {{Event("devicemotion")}}
- {{Event("deviceorientation")}}
- {{Event("orientationchange")}}
智能卡事件
- -{{Event("icccardlockerror")}}
- {{Event("iccinfochange")}}
- {{Event("smartcard-insert")}}
- {{Event("smartcard-remove")}}
- {{Event("stkcommand")}}
- {{Event("stksessionend")}}
- {{Event("cardstatechange")}}
短信和 USSD 事件
- -{{Event("delivered")}}
- {{Event("received")}}
- {{Event("sent")}}
- {{Event("ussdreceived")}}
帧事件
- -{{Event("mozbrowserclose")}}
- {{Event("mozbrowsercontextmenu")}}
- {{Event("mozbrowsererror")}}
- {{Event("mozbrowsericonchange")}}
- {{Event("mozbrowserlocationchange")}}
- {{Event("mozbrowserloadend")}}
- {{Event("mozbrowserloadstart")}}
- {{Event("mozbrowseropenwindow")}}
- {{Event("mozbrowsersecuritychange")}}
- {{Event("mozbrowsershowmodalprompt")}}
- {{Event("mozbrowsertitlechange")}}
DOM 变异事件
- -DOMAttributeNameChanged
- DOMAttrModified
- DOMCharacterDataModified
- {{Event("DOMContentLoaded")}}
- DOMElementNameChanged
- DOMNodeInserted
- DOMNodeInsertedIntoDocument
- DOMNodeRemoved
- DOMNodeRemovedFromDocument
- DOMSubtreeModified
触摸事件
- -{{Event("touchcancel")}}
- {{Event("touchend")}}
- {{Event("touchmove")}}
- {{Event("touchstart")}}
指针事件
- -{{Event("pointerover")}}
- {{Event("pointerenter")}}
- {{Event("pointerdown")}}
- {{Event("pointermove")}}
- {{Event("pointerup")}}
- {{Event("pointercancel")}}
- {{Event("pointerout")}}
- {{Event("pointerleave")}}
- {{Event("gotpointercapture")}}
- {{Event("lostpointercapture")}}
标准事件
- -这些事件在官方 Web 规范中定义，并且应在各个浏览器中通用。 每个事件都和代表事件接收方的对象（由此您可以查到每个事件提供的数据），定义这个事件的标准或标准链接会一起列出。
- -| 事件名称 | -事件类型 | -规范 | -触发时机... | -
|---|---|---|---|
| {{Event("abort")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -资源载入已被中止 | -
abort |
- {{DOMxRef("ProgressEvent")}} | -ProgressandXMLHttpRequest | -Progress 被终止 (不是 error 造成的) | -
abort |
- {{DOMxRef("Event")}} | -IndexedDB | -事务已被中止 | -
| {{Event("afterprint")}} | -{{DOMxRef("Event")}} | -HTML5 | -相关文档已开始打印或打印预览已被关闭 | -
| {{Event("animationcancel")}} | -{{DOMxRef("AnimationEvent")}} {{Experimental_Inline}} | -CSS Animations | -A CSS animation has aborted. | -
| {{Event("animationend")}} | -{{DOMxRef("AnimationEvent")}} {{Experimental_Inline}} | -CSS Animations | -完成一个CSS 动画 | -
| {{Event("animationiteration")}} | -{{DOMxRef("AnimationEvent")}} {{Experimental_Inline}} | -CSS Animations | -重复播放一个CSS 动画 | -
| {{Event("animationstart")}} | -{{DOMxRef("AnimationEvent")}} {{Experimental_Inline}} | -CSS Animations | -一个 CSS 动画已开始 | -
| {{Event("appinstalled")}} | -{{DOMxRef("Event")}} | -Web App Manifest | -A web application is successfully installed as a progressive web app. | -
| {{Event("audioprocess")}} | -{{DOMxRef("AudioProcessingEvent")}} {{Deprecated_Inline}} | -{{SpecName('Web Audio API', '#AudioProcessingEvent', 'audioprocess')}} | -一个{{DOMxRef("ScriptProcessorNode")}} 的输入缓冲区可处理 | -
| {{Event("audioend")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -用户代理捕捉到用以语音识别的音频 | -
| {{Event("audiostart")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -用户代理开始捕捉用以语音识别的音频 | -
| {{Event("beforeprint")}} | -{{DOMxRef("Event")}} | -HTML5 | -相关文档将要开始打印或准备打印预览 | -
| {{Event("beforeunload")}} | -{{DOMxRef("BeforeUnloadEvent")}} | -HTML5 | -即将卸载 window，document 及其资源 | -
| {{Event("beginEvent")}} | -{{DOMxRef("TimeEvent")}} | -SVG | -A SMIL animation element begins. | -
blocked |
- - | IndexedDB | -An open connection to a database is blocking a versionchange transaction on the same database. |
-
| {{Event("blur")}} | -{{DOMxRef("FocusEvent")}} {{Experimental_Inline}} | -DOM L3 | -An element has lost focus (does not bubble). | -
| {{Event("boundary")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechSynthesisEvent")}} | -{{SpecName('Web Speech API')}} | -The spoken utterance reaches a word or sentence boundary | -
| {{Event("canplay")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The user agent can play the media, but estimates that not enough data has been loaded to play the media up to its end without having to stop for further buffering of content. | -
| {{Event("canplaythrough")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The user agent can play the media up to its end without having to stop for further buffering of content. | -
| {{Event("change")}} | -{{DOMxRef("Event")}} | -DOM L2, HTML5 | -The change event is fired for {{HTMLElement("input")}}, {{HTMLElement("select")}}, and {{HTMLElement("textarea")}} elements when a change to the element's value is committed by the user. |
-
| {{Event("chargingchange")}} | -{{DOMxRef("Event")}} | -Battery status | -The battery begins or stops charging. | -
| {{Event("chargingtimechange")}} | -{{DOMxRef("Event")}} | -Battery status | -The chargingTime attribute has been updated. |
-
| {{Event("click")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device button has been pressed and released on an element. | -
close |
- {{DOMxRef("Event")}} | -WebSocket | -A WebSocket connection has been closed. | -
complete |
- - | IndexedDB | -A transaction successfully completed. | -
| {{Event("complete")}} | -{{DOMxRef("OfflineAudioCompletionEvent")}} {{Deprecated_Inline}} | -{{SpecName('Web Audio API', '#OfflineAudioCompletionEvent-section', 'OfflineAudioCompletionEvent')}} | -The rendering of an {{DOMxRef("OfflineAudioContext")}} is terminated. | -
| {{Event("compositionend")}} | -{{DOMxRef("CompositionEvent")}} | -DOM L3 | -The composition of a passage of text has been completed or canceled. | -
| {{Event("compositionstart")}} | -{{DOMxRef("CompositionEvent")}} | -DOM L3 | -The composition of a passage of text is prepared (similar to keydown for a keyboard input, but works with other inputs such as speech recognition). | -
| {{Event("compositionupdate")}} | -{{DOMxRef("CompositionEvent")}} | -DOM L3 | -A character is added to a passage of text being composed. | -
| {{Event("contextmenu")}} | -{{DOMxRef("MouseEvent")}} | -HTML5 | -The right button of the mouse is clicked (before the context menu is displayed). | -
| {{Event("copy")}} | -{{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}} | -Clipboard | -The text selection has been added to the clipboard. | -
| {{Event("cut")}} | -{{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}} | -Clipboard | -The text selection has been removed from the document and added to the clipboard. | -
| {{Event("dblclick")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device button is clicked twice on an element. | -
| {{Event("devicechange")}} | -{{DOMxRef("Event")}} | -{{SpecName("Media Capture")}} | -A media device such as a camera, microphone, or speaker is connected or removed from the system. | -
| {{Event("devicemotion")}} | -{{DOMxRef("DeviceMotionEvent")}} {{Experimental_Inline}} | -Device Orientation Events | -Fresh data is available from a motion sensor. | -
| {{Event("deviceorientation")}} | -{{DOMxRef("DeviceOrientationEvent")}} {{Experimental_Inline}} | -Device Orientation Events | -Fresh data is available from an orientation sensor. | -
| {{Event("dischargingtimechange")}} | -{{DOMxRef("Event")}} | -Battery status | -The dischargingTime attribute has been updated. |
-
DOMActivate {{Deprecated_Inline}} |
- {{DOMxRef("UIEvent")}} | -DOM L3 | -A button, link or state changing element is activated (use {{Event("click")}} instead). | -
DOMAttributeNameChanged {{Deprecated_Inline}} |
- {{DOMxRef("MutationNameEvent")}} | -DOM L3 Removed | -The name of an attribute changed (use mutation observers instead). | -
DOMAttrModified {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -The value of an attribute has been modified (use mutation observers instead). | -
DOMCharacterDataModified {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -A text or another CharacterData has changed (use mutation observers instead). | -
| {{Event("DOMContentLoaded")}} | -{{DOMxRef("Event")}} | -HTML5 | -The document has finished loading (but not its dependent resources). | -
DOMElementNameChanged {{Deprecated_Inline}} |
- {{DOMxRef("MutationNameEvent")}} | -DOM L3 Removed | -The name of an element changed (use mutation observers instead). | -
DOMFocusIn {{Deprecated_Inline}} |
- {{DOMxRef("FocusEvent")}} {{Experimental_Inline}} | -DOM L3 | -An element has received focus (use {{Event("focus")}} or {{Event("focusin")}} instead). | -
DOMFocusOut {{Deprecated_Inline}} |
- {{DOMxRef("FocusEvent")}} {{Experimental_Inline}} | -DOM L3 | -An element has lost focus (use {{Event("blur")}} or {{Event("focusout")}} instead). | -
DOMNodeInserted {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -A node has been added as a child of another node (use mutation observers instead). | -
DOMNodeInsertedIntoDocument {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -A node has been inserted into the document (use mutation observers instead). | -
DOMNodeRemoved {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -A node has been removed from its parent node (use mutation observers instead). | -
DOMNodeRemovedFromDocument {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -A node has been removed from the document (use mutation observers instead). | -
DOMSubtreeModified {{Deprecated_Inline}} |
- {{DOMxRef("MutationEvent")}} | -DOM L3 | -A change happened in the document (use mutation observers instead). | -
| {{Event("drag")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -An element or text selection is being dragged (every 350ms). | -
| {{Event("dragend")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -A drag operation is being ended (by releasing a mouse button or hitting the escape key). | -
| {{Event("dragenter")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -A dragged element or text selection enters a valid drop target. | -
| {{Event("dragleave")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -A dragged element or text selection leaves a valid drop target. | -
| {{Event("dragover")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -An element or text selection is being dragged over a valid drop target (every 350ms). | -
| {{Event("dragstart")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -The user starts dragging an element or text selection. | -
| {{Event("drop")}} | -{{DOMxRef("DragEvent")}} | -HTML5 | -An element is dropped on a valid drop target. | -
| {{Event("durationchange")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The duration attribute has been updated. |
-
| {{Event("emptied")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The media has become empty; for example, this event is sent if the media has already been loaded (or partially loaded), and the load() method is called to reload it. |
-
| {{Event("end_(SpeechRecognition)","end")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -The speech recognition service has disconnected. | -
| {{Event("end_(SpeechSynthesis)","end")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechSynthesisEvent")}} | -{{SpecName("Web Speech API")}} | -The utterance has finished being spoken. | -
| {{Event("ended")}} | -{{DOMxRef("Event")}} | -HTML5 media | -Playback has stopped because the end of the media was reached. | -
| {{Event("ended_(Web_Audio)", "ended")}} | -{{DOMxRef("Event")}} | -{{SpecName("Web Audio API")}} | -Playback has stopped because the end of the media was reached. | -
| {{Event("endEvent")}} | -{{DOMxRef("TimeEvent")}} | -SVG | -A SMIL animation element ends. | -
| {{Event("error")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -A resource failed to load. | -
| {{Event("error")}} | -{{DOMxRef("ProgressEvent")}} | -Progress and XMLHttpRequest | -Progression has failed. | -
| {{Event("error")}} | -{{DOMxRef("Event")}} | -WebSocket | -A WebSocket connection has been closed with prejudice (some data couldn't be sent for example). | -
| {{Event("error")}} | -{{DOMxRef("Event")}} | -Server Sent Events | -An event source connection has been failed. | -
| {{Event("error")}} | -{{DOMxRef("Event")}} | -IndexedDB | -A request caused an error and failed. | -
| {{Event("error_(SpeechRecognitionError)","error")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -A speech recognition error occurs. | -
| {{Event("error_(SpeechSynthesisError)","error")}} | -{{DOMxRef("SpeechSynthesisErrorEvent")}} | -{{SpecName('Web Speech API')}} | -An error occurs that prevents the utterance from being successfully spoken. | -
| {{Event("focus")}} | -{{DOMxRef("FocusEvent")}} {{Experimental_Inline}} | -DOM L3 | -An element has received focus (does not bubble). | -
| {{Event("focusin")}} | -{{DOMxRef("FocusEvent")}} {{Experimental_Inline}} | -DOM L3 | -An element is about to receive focus (bubbles). | -
| {{Event("focusout")}} | -{{DOMxRef("FocusEvent")}} {{Experimental_Inline}} | -DOM L3 | -An element is about to lose focus (bubbles). | -
| {{Event("fullscreenchange")}} | -{{DOMxRef("Event")}} | -Full Screen | -An element was turned to fullscreen mode or back to normal mode. | -
| {{Event("fullscreenerror")}} | -{{DOMxRef("Event")}} | -Full Screen | -It was impossible to switch to fullscreen mode for technical reasons or because the permission was denied. | -
| {{Event("gamepadconnected")}} | -{{DOMxRef("GamepadEvent")}} {{Experimental_Inline}} | -Gamepad | -A gamepad has been connected. | -
| {{Event("gamepaddisconnected")}} | -{{DOMxRef("GamepadEvent")}} {{Experimental_Inline}} | -Gamepad | -A gamepad has been disconnected. | -
| {{Event("gotpointercapture")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -Element receives pointer capture. | -
| {{Event("hashchange")}} | -{{DOMxRef("HashChangeEvent")}} | -HTML5 | -The fragment identifier of the URL has changed (the part of the URL after the #). | -
| {{Event("lostpointercapture")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -Element lost pointer capture. | -
| {{Event("input")}} | -{{DOMxRef("Event")}} | -HTML5 | -The value of an element changes or the content of an element with the attribute contenteditable is modified. | -
| {{Event("invalid")}} | -{{DOMxRef("Event")}} | -HTML5 | -A submittable element has been checked and doesn't satisfy its constraints. | -
| {{Event("keydown")}} | -{{DOMxRef("KeyboardEvent")}} | -DOM L3 | -A key is pressed down. | -
| {{Event("keypress")}} | -{{DOMxRef("KeyboardEvent")}} | -DOM L3 | -A key is pressed down and that key normally produces a character value (use input instead). | -
| {{Event("keyup")}} | -{{DOMxRef("KeyboardEvent")}} | -DOM L3 | -A key is released. | -
| {{Event("languagechange")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{ SpecName('HTML5.1', '#dom-navigator-languages', 'NavigatorLanguage.languages') }} | -The user's preferred languages have changed. | -
| {{Event("levelchange")}} | -{{DOMxRef("Event")}} | -Battery status | -The level attribute has been updated. |
-
| {{Event("load")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -A resource and its dependent resources have finished loading. | -
load |
- {{DOMxRef("ProgressEvent")}} | -Progress and XMLHttpRequest | -Progression has been successful. | -
| {{Event("loadeddata")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The first frame of the media has finished loading. | -
| {{Event("loadedmetadata")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The metadata has been loaded. | -
| {{Event("loadend")}} | -{{DOMxRef("ProgressEvent")}} | -Progress and XMLHttpRequest | -Progress has stopped (after "error", "abort" or "load" have been dispatched). | -
| {{Event("loadstart")}} | -{{DOMxRef("ProgressEvent")}} | -Progress and XMLHttpRequest | -Progress has begun. | -
| {{Event("mark")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechSynthesisEvent")}} | -{{SpecName('Web Speech API')}} | -The spoken utterance reaches a named SSML "mark" tag. | -
message |
- {{DOMxRef("MessageEvent")}} | -WebSocket | -A message is received through a WebSocket. | -
message |
- {{DOMxRef("MessageEvent")}} | -Web Workers | -A message is received from a Web Worker. | -
message |
- {{DOMxRef("MessageEvent")}} | -Web Messaging | -A message is received from a child (i)frame or a parent window. | -
message |
- {{DOMxRef("MessageEvent")}} | -Server Sent Events | -A message is received through an event source. | -
| {{Event("messageerror")}} | -{{DOMxRef("MessageEvent")}} | -{{DOMxRef("MessagePort")}}, Web Workers, Broadcast Channel, {{DOMxRef("Window")}} | -A message error is raised when a message is received by an object. | -
| {{Event("message_(ServiceWorker)","message")}} {{Experimental_Inline}} | -{{DOMxRef("ServiceWorkerMessageEvent")}} or {{DOMxRef("ExtendableMessageEvent")}}, depending on context. | -Service Workers | -A message is received from a service worker, or a message is received in a service worker from another context. | -
| {{Event("mousedown")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device button (usually a mouse) is pressed on an element. | -
| {{Event("mouseenter")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device is moved onto the element that has the listener attached. | -
| {{Event("mouseleave")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device is moved off the element that has the listener attached. | -
| {{Event("mousemove")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device is moved over an element. | -
| {{Event("mouseout")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device is moved off the element that has the listener attached or off one of its children. | -
| {{Event("mouseover")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device is moved onto the element that has the listener attached or onto one of its children. | -
| {{Event("mouseup")}} | -{{DOMxRef("MouseEvent")}} | -DOM L3 | -A pointing device button is released over an element. | -
| {{Event("nomatch")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechRecognitionEvent")}} | -{{SpecName('Web Speech API')}} | -The speech recognition service returns a final result with no significant recognition. | -
| {{Event("notificationclick")}} | -{{DOMxRef("NotificationEvent")}} {{Experimental_Inline}} | -{{SpecName('Web Notifications','#dom-serviceworkerglobalscope-onnotificationclick','onnotificationclick')}} | -A system notification spawned by {{DOMxRef("ServiceWorkerRegistration.showNotification()")}} has been clicked. | -
| {{Event("offline")}} | -{{DOMxRef("Event")}} | -HTML5 offline | -The browser has lost access to the network. | -
| {{Event("online")}} | -{{DOMxRef("Event")}} | -HTML5 offline | -The browser has gained access to the network (but particular websites might be unreachable). | -
open |
- {{DOMxRef("Event")}} | -WebSocket | -A WebSocket connection has been established. | -
open |
- {{DOMxRef("Event")}} | -Server Sent Events | -An event source connection has been established. | -
| {{Event("orientationchange")}} | -{{DOMxRef("Event")}} | -Screen Orientation | -The orientation of the device (portrait/landscape) has changed | -
| {{Event("pagehide")}} | -{{DOMxRef("PageTransitionEvent")}} | -HTML5 | -A session history entry is being traversed from. | -
| {{Event("pageshow")}} | -{{DOMxRef("PageTransitionEvent")}} | -HTML5 | -A session history entry is being traversed to. | -
| {{Event("paste")}} | -{{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}} | -Clipboard | -Data has been transferred from the system clipboard to the document. | -
| {{Event("pause")}} | -{{DOMxRef("Event")}} | -HTML5 media | -Playback has been paused. | -
| {{Event("pause_(SpeechSynthesis)", "pause")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechSynthesisEvent")}} | -{{SpecName('Web Speech API')}} | -The utterance is paused part way through. | -
| {{Event("pointercancel")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -The pointer is unlikely to produce any more events. | -
| {{Event("pointerdown")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -The pointer enters the active buttons state. | -
| {{Event("pointerenter")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -Pointing device is moved inside the hit-testing boundary. | -
| {{Event("pointerleave")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -Pointing device is moved out of the hit-testing boundary. | -
| {{Event("pointerlockchange")}} | -{{DOMxRef("Event")}} | -Pointer Lock | -The pointer was locked or released. | -
| {{Event("pointerlockerror")}} | -{{DOMxRef("Event")}} | -Pointer Lock | -It was impossible to lock the pointer for technical reasons or because the permission was denied. | -
| {{Event("pointermove")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -The pointer changed coordinates. | -
| {{Event("pointerout")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -The pointing device moved out of hit-testing boundary or leaves detectable hover range. | -
| {{Event("pointerover")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -The pointing device is moved into the hit-testing boundary. | -
| {{Event("pointerup")}} | -{{DOMxRef("PointerEvent")}} | -Pointer Events | -The pointer leaves the active buttons state. | -
| {{Event("play")}} | -{{DOMxRef("Event")}} | -HTML5 media | -Playback has begun. | -
| {{Event("playing")}} | -{{DOMxRef("Event")}} | -HTML5 media | -Playback is ready to start after having been paused or delayed due to lack of data. | -
| {{Event("popstate")}} | -{{DOMxRef("PopStateEvent")}} | -HTML5 | -A session history entry is being navigated to (in certain cases). | -
| {{Event("progress")}} | -{{DOMxRef("ProgressEvent")}} | -Progress and XMLHttpRequest | -In progress. | -
| {{Event("push")}} | -{{DOMxRef("PushEvent")}} {{Experimental_Inline}} | -{{SpecName("Push API")}} | -A Service Worker has received a push message. | -
| {{Event("pushsubscriptionchange")}} | -{{DOMxRef("PushEvent")}} {{Experimental_Inline}} | -{{SpecName("Push API")}} | -A PushSubscription has expired. | -
| {{Event("ratechange")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The playback rate has changed. | -
| {{Event("readystatechange")}} | -{{DOMxRef("Event")}} | -HTML5 and XMLHttpRequest | -The readyState attribute of a document has changed. | -
| {{Event("repeatEvent")}} | -{{DOMxRef("TimeEvent")}} | -SVG | -A SMIL animation element is repeated. | -
| {{Event("reset")}} | -{{DOMxRef("Event")}} | -DOM L2, HTML5 | -A form is reset. | -
| {{Event("resize")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -The document view has been resized. | -
| {{Event("resourcetimingbufferfull")}} | -{{DOMxRef("Performance")}} | -Resource Timing | -The browser's resource timing buffer is full. | -
| {{Event("result")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechRecognitionEvent")}} {{Experimental_Inline}} | -{{SpecName('Web Speech API')}} | -The speech recognition service returns a result — a word or phrase has been positively recognized and this has been communicated back to the app. | -
| {{Event("resume")}} {{Experimental_Inline}} | -{{DOMxRef("SpeechSynthesisEvent")}} {{Experimental_Inline}} | -{{SpecName('Web Speech API')}} | -A paused utterance is resumed. | -
| {{Event("scroll")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -The document view or an element has been scrolled. | -
| {{Event("seeked")}} | -{{DOMxRef("Event")}} | -HTML5 media | -A seek operation completed. | -
| {{Event("seeking")}} | -{{DOMxRef("Event")}} | -HTML5 media | -A seek operation began. | -
| {{Event("select")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -Some text is being selected. | -
| {{Event("selectstart")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{ SpecName('Selection API')}} | -A selection just started. | -
| {{Event("selectionchange")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{ SpecName('Selection API')}} | -The selection in the document has been changed. | -
| {{Event("show")}} | -{{DOMxRef("MouseEvent")}} | -HTML5 | -A contextmenu event was fired on/bubbled to an element that has a contextmenu attribute | -
| {{Event("slotchange")}} | -{{DOMxRef("Event")}} | -{{ SpecName('DOM WHATWG')}} | -The node contents of a {{DOMxRef("HTMLSlotElement")}} ({{htmlelement("slot")}}) have changed. | -
| {{Event("soundend")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -Any sound — recognisable speech or not — has stopped being detected. | -
| {{Event("soundstart")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -Any sound — recognisable speech or not — has been detected. | -
| {{Event("speechend")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -Speech recognised by the speech recognition service has stopped being detected. | -
| {{Event("speechstart")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -Sound that is recognised by the speech recognition service as speech has been detected. | -
| {{Event("stalled")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The user agent is trying to fetch media data, but data is unexpectedly not forthcoming. | -
| {{Event("start_(SpeechRecognition)","start")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -The speech recognition service has begun listening to incoming audio with intent to recognize grammars associated with the current SpeechRecognition. |
-
| {{Event("start_(SpeechSynthesis)","start")}} | -{{DOMxRef("SpeechSynthesisEvent")}} | -{{SpecName('Web Speech API')}} | -The utterance has begun to be spoken. | -
| {{Event("storage")}} | -{{DOMxRef("StorageEvent")}} | -Web Storage | -A storage area (localStorage or sessionStorage) has changed. | -
| {{Event("submit")}} | -{{DOMxRef("Event")}} | -DOM L2, HTML5 | -A form is submitted. | -
success |
- {{DOMxRef("Event")}} | -IndexedDB | -A request successfully completed. | -
| {{Event("suspend")}} | -{{DOMxRef("Event")}} | -HTML5 media | -Media data loading has been suspended. | -
| {{Event("SVGAbort")}} | -{{DOMxRef("SVGEvent")}} | -SVG | -Page loading has been stopped before the SVG was loaded. | -
| {{Event("SVGError")}} | -{{DOMxRef("SVGEvent")}} | -SVG | -An error has occurred before the SVG was loaded. | -
| {{Event("SVGLoad")}} | -{{DOMxRef("SVGEvent")}} | -SVG | -An SVG document has been loaded and parsed. | -
| {{Event("SVGResize")}} | -{{DOMxRef("SVGEvent")}} | -SVG | -An SVG document is being resized. | -
| {{Event("SVGScroll")}} | -{{DOMxRef("SVGEvent")}} | -SVG | -An SVG document is being scrolled. | -
| {{Event("SVGUnload")}} | -{{DOMxRef("SVGEvent")}} | -SVG | -An SVG document has been removed from a window or frame. | -
| {{Event("SVGZoom")}} | -{{DOMxRef("SVGZoomEvent")}} | -SVG | -An SVG document is being zoomed. | -
| {{Event("timeout")}} | -{{DOMxRef("ProgressEvent")}} | -XMLHttpRequest | -- |
| {{Event("timeupdate")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The time indicated by the currentTime attribute has been updated. |
-
| {{Event("touchcancel")}} | -{{DOMxRef("TouchEvent")}} | -Touch Events | -A touch point has been disrupted in an implementation-specific manners (too many touch points for example). | -
| {{Event("touchend")}} | -{{DOMxRef("TouchEvent")}} | -Touch Events | -A touch point is removed from the touch surface. | -
| {{Event("touchmove")}} | -{{DOMxRef("TouchEvent")}} | -Touch Events | -A touch point is moved along the touch surface. | -
| {{Event("touchstart")}} | -{{DOMxRef("TouchEvent")}} | -Touch Events | -A touch point is placed on the touch surface. | -
| {{Event("transitionend")}} | -{{DOMxRef("TransitionEvent")}} {{Experimental_Inline}} | -CSS Transitions | -A CSS transition has completed. | -
| {{Event("unload")}} | -{{DOMxRef("UIEvent")}} | -DOM L3 | -The document or a dependent resource is being unloaded. | -
upgradeneeded |
- - | IndexedDB | -An attempt was made to open a database with a version number higher than its current version. A versionchange transaction has been created. |
-
| {{Event("userproximity")}} | -{{DOMxRef("UserProximityEvent")}} {{Experimental_Inline}} | -{{SpecName("Proximity Events")}} | -Fresh data is available from a proximity sensor (indicates whether the nearby object is near the device or not). |
-
| {{Event("voiceschanged")}} {{Experimental_Inline}} | -{{DOMxRef("Event")}} | -{{SpecName('Web Speech API')}} | -The list of {{DOMxRef("SpeechSynthesisVoice")}} objects that would be returned by the {{DOMxRef("SpeechSynthesis.getVoices()")}} method has changed (when the {{Event("voiceschanged")}} event fires.) | -
versionchange |
- - | IndexedDB | -A versionchange transaction completed. |
-
| {{Event("visibilitychange")}} | -{{DOMxRef("Event")}} | -Page visibility | -The content of a tab has become visible or has been hidden. | -
| {{Event("volumechange")}} | -{{DOMxRef("Event")}} | -HTML5 media | -The volume has changed. | -
| {{Event("waiting")}} | -{{DOMxRef("Event")}} | -HTML5 media | -Playback has stopped because of a temporary lack of data. | -
| {{Event("wheel")}} | -{{DOMxRef("WheelEvent")}} | -DOM L3 | -A wheel button of a pointing device is rotated in any direction. | -
非标准事件
- -| Event Name | -Event Type | -Specification | -Fired when... | -
|---|---|---|---|
| {{Event("afterscriptexecute")}} | -{{DOMxRef("Event")}} | -Mozilla Specific | -A script has been executed. | -
| {{Event("beforescriptexecute")}} | -{{DOMxRef("Event")}} | -Mozilla Specific | -A script is about to be executed. | -
| {{Event("beforeinstallprompt")}} | -{{DOMxRef("Event")}} | -Chrome specific | -A user is prompted to save a web site to a home screen on mobile. | -
| {{Event("cardstatechange")}} | -- | Firefox OS specific | -The {{DOMxRef("MozMobileConnection.cardState")}} property changes value. | -
| {{Event("change")}} | -{{DOMxRef("DeviceStorageChangeEvent")}} | -Firefox OS specific | -This event is triggered each time a file is created, modified or deleted on a given storage area. | -
| {{Event("connectionInfoUpdate")}} | -- | Firefox OS specific | -The informations about the signal strength and the link speed have been updated. | -
| {{Event("cfstatechange")}} | -- | Firefox OS specific | -The call forwarding state changes. | -
| {{Event("datachange")}} | -- | Firefox OS specific | -The {{DOMxRef("MozMobileConnection.data")}} object changes values. | -
| {{Event("dataerror")}} | -- | Firefox OS specific | -The {{DOMxRef("MozMobileConnection.data")}} object receive an error from the RIL. | -
| {{Event("DOMMouseScroll")}}{{Deprecated_Inline}} | -- | Mozilla specific | -The wheel button of a pointing device is rotated (detail attribute is a number of lines). (use {{Event("wheel")}} instead) | -
dragdrop {{Deprecated_Inline}} |
- DragEvent |
- Mozilla specific | -An element is dropped (use {{Event("drop")}} instead). | -
dragexit {{Deprecated_Inline}} |
- DragEvent |
- Mozilla specific | -A drag operation is being ended(use {{Event("dragend")}} instead). | -
draggesture {{Deprecated_Inline}} |
- DragEvent |
- Mozilla specific | -The user starts dragging an element or text selection (use {{Event("dragstart")}} instead). | -
| {{Event("icccardlockerror")}} | -- | Firefox OS specific | -the {{DOMxRef("MozMobileConnection.unlockCardLock()")}} or {{DOMxRef("MozMobileConnection.setCardLock()")}} methods fails. | -
| {{Event("iccinfochange")}} | -- | Firefox OS specific | -The {{DOMxRef("MozMobileConnection.iccInfo")}} object changes. | -
| {{Event("localized")}} | -- | Mozilla Specific | -The page has been localized using data-l10n-* attributes. | -
| {{Event("mousewheel")}} {{Deprecated_Inline}} | -- | IE invented | -The wheel button of a pointing device is rotated. | -
| {{Event("MozAudioAvailable")}} | -{{DOMxRef("Event")}} | -Mozilla specific | -The audio buffer is full and the corresponding raw samples are available. | -
MozBeforeResize {{Deprecated_Inline}} |
- - | Mozilla specific | -A window is about to be resized. | -
| {{Event("mozbrowseractivitydone")}} | -- | Firefox OS Browser API-specific | -Sent when some activity has been completed (complete description TBD.) | -
| {{Event("mozbrowserasyncscroll")}} | -- | Firefox OS Browser API-specific | -Sent when the scroll position within a browser {{HTMLElement("iframe")}} changes. |
-
| {{Event("mozbrowseraudioplaybackchange")}} | -- | Firefox OS Browser API-specific | -Sent when audio starts or stops playing within the browser {{HTMLElement("iframe")}} content. | -
| {{Event("mozbrowsercaretstatechanged")}} | -- | Firefox OS Browser API-specific | -Sent when the text selected inside the browser {{HTMLElement("iframe")}} content changes. | -
| {{Event("mozbrowserclose")}} | -- | Firefox OS Browser API-specific | -Sent when window.close() is called within a browser {{HTMLElement("iframe")}}. | -
| {{Event("mozbrowsercontextmenu")}} | -- | Firefox OS Browser API-specific | -Sent when a browser {{HTMLElement("iframe")}} try to open a context menu. | -
| {{Event("mozbrowserdocumentfirstpaint")}} | -- | Firefox OS Browser API-specific | -Sent when a new paint occurs on any document in the browser {{HTMLElement("iframe")}}. | -
| {{Event("mozbrowsererror")}} | -- | Firefox OS Browser API-specific | -Sent when an error occured while trying to load a content within a browser iframe | -
| {{Event("mozbrowserfindchange")}} | -- | Firefox OS Browser API-specific | -Sent when a search operation is performed on the browser {{HTMLElement("iframe")}} content (see HTMLIFrameElement search methods.) | -
| {{Event("mozbrowserfirstpaint")}} | -- | Firefox OS Browser API-specific | -Sent when the {{HTMLElement("iframe")}} paints content for the first time (this doesn't include the initial paint from about:blank.) | -
| {{Event("mozbrowsericonchange")}} | -- | Firefox OS Browser API-specific | -Sent when the favicon of a browser iframe changes. | -
| {{Event("mozbrowserlocationchange")}} | -- | Firefox OS Browser API-specific | -Sent when an browser iframe's location changes. | -
| {{Event("mozbrowserloadend")}} | -- | Firefox OS Browser API-specific | -Sent when the browser iframe has finished loading all its assets. | -
| {{Event("mozbrowserloadstart")}} | -- | Firefox OS Browser API-specific | -Sent when the browser iframe starts to load a new page. | -
| {{Event("mozbrowsermanifestchange")}} | -- | Firefox OS Browser API-specific | -Sent when a the path to the app manifest changes, in the case of a browser {{HTMLElement("iframe")}} with an open web app embedded in it. | -
| {{Event("mozbrowsermetachange")}} | -- | Firefox OS Browser API-specific | -Sent when a {{htmlelement("meta")}} elelment is added to, removed from or changed in the browser {{HTMLElement("iframe")}}'s content. | -
| {{Event("mozbrowseropensearch")}} | -- | Firefox OS Browser API-specific | -Sent when a link to a search engine is found. | -
| {{Event("mozbrowseropentab")}} | -- | Firefox OS Browser API-specific | -Sent when a new tab is opened within a browser {{HTMLElement("iframe")}} as a result of the user issuing a command to open a link target in a new tab (for example ctrl/cmd + click.) | -
| {{Event("mozbrowseropenwindow")}} | -- | Firefox OS Browser API-specific | -Sent when {{DOMxRef("window.open()")}} is called within a browser iframe. | -
| {{Event("mozbrowserresize")}} | -- | Firefox OS Browser API-specific | -Sent when the browser {{HTMLElement("iframe")}}'s window size has changed. | -
| {{Event("mozbrowserscroll")}} | -- | Firefox OS Browser API-specific | -Sent when the browser {{HTMLElement("iframe")}} content scrolls. | -
| {{Event("mozbrowserscrollareachanged")}} | -- | Firefox OS Browser API-specific | -Sent when the available scrolling area in the browser {{HTMLElement("iframe")}} changes. This can occur on resize and when the page size changes (while loading for example.) | -
| {{Event("mozbrowserscrollviewchange")}} | -- | Firefox OS Browser API-specific | -Sent when asynchronous scrolling (i.e. APCZ) starts or stops. | -
| {{Event("mozbrowsersecuritychange")}} | -- | Firefox OS Browser API-specific | -Sent when the SSL state changes within a browser iframe. | -
| {{Event("mozbrowserselectionstatechanged")}} | -- | Firefox OS Browser API-specific | -Sent when the text selected inside the browser {{HTMLElement("iframe")}} content changes. Note that this is deprecated, and newer implementations use {{Event("mozbrowsercaretstatechanged")}} instead. | -
| {{Event("mozbrowsershowmodalprompt")}} | -- | Firefox OS Browser API-specific | -Sent when {{DOMxRef("window.alert","alert()")}}, {{DOMxRef("window.confirm","confirm()")}} or {{DOMxRef("window.prompt","prompt()")}} are called within a browser iframe | -
| {{Event("mozbrowsertitlechange")}} | -- | Firefox OS Browser API-specific | -Sent when the document.title changes within a browser iframe. | -
| {{Event("mozbrowserusernameandpasswordrequired")}} | -- | Firefox OS Browser API-specific | -Sent when an HTTP authentification is requested. | -
| {{Event("mozbrowservisibilitychange")}} | -- | Firefox OS Browser API-specific | -Sent when the visibility state of the current browser iframe {{HTMLElement("iframe")}} changes, for example due to a call to {{DOMxRef("HTMLIFrameElement.setVisible","setVisible()")}}. | -
| {{Event("MozGamepadButtonDown")}} | -- | To be specified | -A gamepad button is pressed down. | -
| {{Event("MozGamepadButtonUp")}} | -- | To be specified | -A gamepad button is released. | -
| {{Event("MozMousePixelScroll")}} {{Deprecated_Inline}} | -- | Mozilla specific | -The wheel button of a pointing device is rotated (detail attribute is a number of pixels). (use wheel instead) | -
| {{Event("MozOrientation")}} {{Deprecated_Inline}} | -- | Mozilla specific | -Fresh data is available from an orientation sensor (see deviceorientation). | -
| {{Event("MozScrolledAreaChanged")}} | -{{DOMxRef("UIEvent")}} | -Mozilla specific | -The document view has been scrolled or resized. | -
| {{Event("moztimechange")}} | -- | Mozilla specific | -The time of the device has been changed. | -
| MozTouchDown {{Deprecated_Inline}} | -- | Mozilla specific | -A touch point is placed on the touch surface (use touchstart instead). | -
| MozTouchMove {{Deprecated_Inline}} | -- | Mozilla specific | -A touch point is moved along the touch surface (use touchmove instead). | -
| MozTouchUp {{Deprecated_Inline}} | -- | Mozilla specific | -A touch point is removed from the touch surface (use touchend instead). | -
| {{Event("alerting")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -The correspondent is being alerted (his/her phone is ringing). | -
| {{Event("busy")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -The line of the correspondent is busy. | -
| {{Event("callschanged")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call has been added or removed from the list of current calls. | -
| onconnected {{Event("connected")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call has been connected. | -
| {{Event("connecting")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call is about to connect. | -
| {{Event("delivered")}} | -{{DOMxRef("SMSEvent")}} | -To be specified | -An SMS has been successfully delivered. | -
| {{Event("dialing")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -The number of a correspondent has been dialed. | -
| {{Event("disabled")}} | -- | Firefox OS specific | -Wifi has been disabled on the device. | -
| {{Event("disconnected")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call has been disconnected. | -
| {{Event("disconnecting")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call is about to disconnect. | -
| {{Event("enabled")}} | -- | Firefox OS specific | -Wifi has been enabled on the device. | -
| {{Event("error_(Telephony)","error")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -An error occurred. | -
| {{Event("held")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call has been held. | -
| {{Event("holding")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call is about to be held. | -
| {{Event("incoming")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call is being received. | -
| {{Event("received")}} | -{{DOMxRef("SMSEvent")}} | -To be specified | -An SMS has been received. | -
| {{Event("resuming")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -A call is about to resume. | -
| {{Event("sent")}} | -{{DOMxRef("SMSEvent")}} | -To be specified | -An SMS has been sent. | -
| {{Event("statechange")}} | -{{DOMxRef("CallEvent")}} | -To be specified | -The state of a call has changed. | -
| {{Event("statuschange")}} | -- | Firefox OS specific | -The status of the Wifi connection changed. | -
| {{Event("overflow")}} | -{{DOMxRef("UIEvent")}} | -Mozilla specific | -An element has been overflowed by its content or has been rendered for the first time in this state (only works for elements styled with overflow != visible). |
-
| {{Event("smartcard-insert")}} | -- | Mozilla specific | -A smartcard has been inserted. | -
| {{Event("smartcard-remove")}} | -- | Mozilla specific | -A smartcard has been removed. | -
| {{Event("stkcommand")}} | -- | Firefox OS specific | -The STK Proactive Command is issued from ICC. | -
| {{Event("stksessionend")}} | -- | Firefox OS specific | -The STK Session is terminated by ICC. | -
| {{Event("touchenter")}} | -{{DOMxRef("TouchEvent")}} | -Touch Events Removed | -- |
| {{Event("touchleave")}} | -{{DOMxRef("TouchEvent")}} | -Touch Events Removed | -- |
| {{Event("underflow")}} | -{{DOMxRef("UIEvent")}} | -Mozilla specific | -An element is no longer overflowed by its content (only works for elements styled with overflow != visible). |
-
uploadprogress {{Deprecated_Inline}} |
- {{DOMxRef("ProgressEvent")}} | -Mozilla Specific | -Upload is in progress (see {{Event("progress")}}). | -
|
- {{Event("ussdreceived")}} - |
- - | Firefox OS specific | -A new USSD message is received | -
| {{Event("voicechange")}} | -- | Firefox OS specific | -The {{DOMxRef("MozMobileConnection.voice")}} object changes values. | -
| {{Event("msContentZoom")}} | -- | Microsoft specific | -- |
| {{Event("MSManipulationStateChanged")}} | -- | Microsoft specific | -- |
| {{Event("MSPointerHover")}} {{Deprecated_Inline}} | -- | Microsoft specific | -- |
Mozilla 特定事件
- -
-
-
-备注： 这些事件不会暴露给 Web 内容使用，只能在 chrome 内容的上下文中使用。
-XUL 事件
- -| Event Name | -Event Type | -Specification | -Fired when... | -
|---|---|---|---|
| {{Event("broadcast")}} | -- | XUL | -An observer noticed a change to the attributes of a watched broadcaster. |
-
| {{Event("CheckboxStateChange")}} | -- | XUL | -The state of a checkbox has been changed either by a user action or by a script (useful for accessibility). |
-
| close | -- | XUL | -The close button of the window has been clicked. | -
| {{Event("command")}} | -- | XUL | -An element has been activated. | -
| {{Event("commandupdate")}} | -- | XUL | -A command update occurred on a commandset element. |
-
| {{Event("DOMMenuItemActive")}} | -- | XUL | -A menu or menuitem has been hovered or highlighted. | -
| {{Event("DOMMenuItemInactive")}} | -- | XUL | -A menu or menuitem is no longer hovered or highlighted. | -
| {{Event("popuphidden")}} | -PopupEvent |
- XUL | -A menupopup, panel or tooltip has been hidden. | -
| {{Event("popuphiding")}} | -PopupEvent |
- XUL | -A menupopup, panel or tooltip is about to be hidden. | -
| {{Event("popupshowing")}} | -PopupEvent |
- XUL | -A menupopup, panel or tooltip is about to become visible. | -
| {{Event("popupshown")}} | -PopupEvent |
- XUL | -A menupopup, panel or tooltip has become visible. | -
| {{Event("RadioStateChange")}} | -- | XUL | -The state of a radio has been changed either by a user action or by a script (useful for accessibility). |
-
| {{Event("ValueChange")}} | -- | XUL | -The value of an element has changed (a progress bar for example, useful for accessibility). | -
附加组件特定事件
- -| Event Name | -Event Type | -Specification | -Fired when... | -
|---|---|---|---|
| MozSwipeGesture | -- | Addons specific | -A touch point is swiped across the touch surface | -
| MozMagnifyGestureStart | -- | Addons specific | -Two touch points start to move away from each other. | -
| MozMagnifyGestureUpdate | -- | Addons specific | -Two touch points move away from each other (after a MozMagnifyGestureStart). | -
| MozMagnifyGesture | -- | Addons specific | -Two touch points moved away from each other (after a sequence of MozMagnifyGestureUpdate). | -
| MozRotateGestureStart | -- | Addons specific | -Two touch points start to rotate around a point. | -
| MozRotateGestureUpdate | -- | Addons specific | -Two touch points rotate around a point (after a MozRotateGestureStart). | -
| MozRotateGesture | -- | Addons specific | -Two touch points rotate around a point (after a sequence of MozRotateGestureUpdate). | -
| MozTapGesture | -- | Addons specific | -Two touch points are tapped on the touch surface. | -
| MozPressTapGesture | -- | Addons specific | -A "press-tap" gesture happened on the touch surface (first finger down, second finger down, second finger up, first finger up). | -
| MozEdgeUIGesture | -- | Addons specific | -A touch point is swiped across the touch surface to invoke the edge UI (Win8 only). | -
| MozAfterPaint | -- | Addons specific | -Content has been repainted. | -
| DOMPopupBlocked | -- | Addons specific | -A popup has been blocked | -
| DOMWindowCreated | -- | Addons specific | -A window has been created. | -
| DOMWindowClose | -- | Addons specific | -A window is about to be closed. | -
| DOMTitleChanged | -- | Addons specifc | -The title of a window has changed. | -
| DOMLinkAdded | -- | Addons specifc | -A link has been added a document. | -
| DOMLinkRemoved | -- | Addons specifc | -A link has been removed inside from a document. | -
| DOMMetaAdded | -- | Addons specific | -A meta element has been added to a document. |
-
| DOMMetaRemoved | -- | Addons specific | -A meta element has been removed from a document. |
-
| DOMWillOpenModalDialog | -- | Addons specific | -A modal dialog is about to open. | -
| DOMModalDialogClosed | -- | Addons specific | -A modal dialog has been closed. | -
| DOMAutoComplete | -- | Addons specific | -The content of an element has been auto-completed. | -
| DOMFrameContentLoaded | -- | Addons specific | -The frame has finished loading (but not its dependent resources). | -
| AlertActive | -- | Addons specific | -A notification element is shown. |
-
| AlertClose | -- | Addons specific | -A notification element is closed. |
-
| fullscreen | -- | Addons specific | -Browser fullscreen mode has been entered or left. | -
| sizemodechange | -- | Addons specific | -Window has entered/left fullscreen mode, or has been minimized/unminimized. | -
| MozEnteredDomFullscreen | -- | Addons specific | -DOM fullscreen mode has been entered. | -
| SSWindowClosing | -- | Addons specific | -The session store will stop tracking this window. | -
| SSTabClosing | -- | Addons specific | -The session store will stop tracking this tab. | -
| SSTabRestoring | -- | Addons specific | -A tab is about to be restored. | -
| SSTabRestored | -- | Addons specific | -A tab has been restored. | -
| SSWindowStateReady | -- | Addons specific | -A window state has switched to "ready". | -
| SSWindowStateBusy | -- | Addons specific | -A window state has switched to "busy". | -
| TabOpen | -- | Addons specific | -A tab has been opened. | -
| TabClose | -- | Addons specific | -A tab has been closed. | -
| TabSelect | -- | Addons specific | -A tab has been selected. | -
| TabShow | -- | Addons specific | -A tab has been shown. | -
| TabHide | -- | Addons specific | -A tab has been hidden. | -
| TabPinned | -- | Addons specific | -A tab has been pinned. | -
| TabUnpinned | -- | Addons specific | -A tab has been unpinned. | -
开发者工具特定事件
- -| Event Name | -Event Type | -Specification | -Fired when... | -
|---|---|---|---|
| CssRuleViewRefreshed | -- | devtools specific | -The "Rules" view of the style inspector has been updated. | -
| CssRuleViewChanged | -- | devtools specific | -The "Rules" view of the style inspector has been changed. | -
| CssRuleViewCSSLinkClicked | -- | devtools specific | -A link to a CSS file has been clicked in the "Rules" view of the style inspector. | -
规范
- -{{Specifications}} - -参见
- --
-
- {{DOMxRef("Event")}} -
- 事件开发者指南 -
| Event Name | +Event Type | +Specification | +Fired when... | +
|---|---|---|---|
| {{Event("afterscriptexecute")}} | +{{DOMxRef("Event")}} | +Mozilla Specific | +A script has been executed. | +
| {{Event("beforescriptexecute")}} | +{{DOMxRef("Event")}} | +Mozilla Specific | +A script is about to be executed. | +
| {{Event("beforeinstallprompt")}} | +{{DOMxRef("Event")}} | +Chrome specific | +A user is prompted to save a web site to a home screen on mobile. | +
| {{Event("cardstatechange")}} | ++ | Firefox OS specific | ++ The {{DOMxRef("MozMobileConnection.cardState")}} + property changes value. + | +
| {{Event("change")}} | +{{DOMxRef("DeviceStorageChangeEvent")}} | +Firefox OS specific | ++ This event is triggered each time a file is created, modified or deleted + on a given storage area. + | +
| {{Event("connectionInfoUpdate")}} | ++ | Firefox OS specific | ++ The informations about the signal strength and the link speed have been + updated. + | +
| {{Event("cfstatechange")}} | ++ | Firefox OS specific | +The call forwarding state changes. | +
| {{Event("datachange")}} | ++ | Firefox OS specific | ++ The {{DOMxRef("MozMobileConnection.data")}} object changes + values. + | +
| {{Event("dataerror")}} | ++ | Firefox OS specific | ++ The {{DOMxRef("MozMobileConnection.data")}} object receive + an error from the RIL. + | +
| {{Event("DOMMouseScroll")}}{{Deprecated_Inline}} | ++ | Mozilla specific | ++ The wheel button of a pointing device is rotated (detail attribute is a + number of lines). (use {{Event("wheel")}} instead) + | +
dragdrop {{Deprecated_Inline}} |
+ DragEvent |
+ Mozilla specific | +An element is dropped (use {{Event("drop")}} instead). | +
dragexit {{Deprecated_Inline}} |
+ DragEvent |
+ Mozilla specific | ++ A drag operation is being ended(use {{Event("dragend")}} + instead). + | +
draggesture {{Deprecated_Inline}} |
+ DragEvent |
+ Mozilla specific | ++ The user starts dragging an element or text selection (use + {{Event("dragstart")}} instead). + | +
| {{Event("icccardlockerror")}} | ++ | Firefox OS specific | ++ the {{DOMxRef("MozMobileConnection.unlockCardLock()")}} + or {{DOMxRef("MozMobileConnection.setCardLock()")}} + methods fails. + | +
| {{Event("iccinfochange")}} | ++ | Firefox OS specific | ++ The {{DOMxRef("MozMobileConnection.iccInfo")}} object + changes. + | +
| {{Event("localized")}} | ++ | + Mozilla Specific + | +The page has been localized using data-l10n-* attributes. | +
| {{Event("mousewheel")}} {{Deprecated_Inline}} | ++ | + IE invented + | +The wheel button of a pointing device is rotated. | +
| {{Event("MozAudioAvailable")}} | +{{DOMxRef("Event")}} | +Mozilla specific | ++ The audio buffer is full and the corresponding raw samples are + available. + | +
+ MozBeforeResize
+ {{Deprecated_Inline}}
+ |
+ + | Mozilla specific | +A window is about to be resized. | +
| {{Event("mozbrowseractivitydone")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when some activity has been completed (complete description TBD.) + | +
| {{Event("mozbrowserasyncscroll")}} | ++ | + Firefox OS + Browser API-specific + | +
+ Sent when the scroll position within a browser {{HTMLElement("iframe")}} changes.
+ |
+
| {{Event("mozbrowseraudioplaybackchange")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when audio starts or stops playing within the browser + {{HTMLElement("iframe")}} content. + | +
| {{Event("mozbrowsercaretstatechanged")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the text selected inside the browser + {{HTMLElement("iframe")}} content changes. + | +
| {{Event("mozbrowserclose")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when window.close() is called within a browser + {{HTMLElement("iframe")}}. + | +
| {{Event("mozbrowsercontextmenu")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when a browser {{HTMLElement("iframe")}} try to open a + context menu. + | +
| {{Event("mozbrowserdocumentfirstpaint")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when a new paint occurs on any document in the browser + {{HTMLElement("iframe")}}. + | +
| {{Event("mozbrowsererror")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when an error occured while trying to load a content within a + browser iframe + | +
| {{Event("mozbrowserfindchange")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when a search operation is performed on the browser + {{HTMLElement("iframe")}} content (see + HTMLIFrameElement search methods.) + | +
| {{Event("mozbrowserfirstpaint")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the {{HTMLElement("iframe")}} paints content for the + first time (this doesn't include the initial paint from + about:blank.) + | +
| {{Event("mozbrowsericonchange")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when the favicon of a browser iframe changes. | +
| {{Event("mozbrowserlocationchange")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when an browser iframe's location changes. | +
| {{Event("mozbrowserloadend")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when the browser iframe has finished loading all its assets. | +
| {{Event("mozbrowserloadstart")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when the browser iframe starts to load a new page. | +
| {{Event("mozbrowsermanifestchange")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when a the path to the app manifest changes, in the case of a + browser {{HTMLElement("iframe")}} with an open web app embedded + in it. + | +
| {{Event("mozbrowsermetachange")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when a {{htmlelement("meta")}} elelment is added to, + removed from or changed in the browser + {{HTMLElement("iframe")}}'s content. + | +
| {{Event("mozbrowseropensearch")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when a link to a search engine is found. | +
| {{Event("mozbrowseropentab")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when a new tab is opened within a browser + {{HTMLElement("iframe")}} as a result of the user issuing a + command to open a link target in a new tab (for example + ctrl/cmd + click.) + | +
| {{Event("mozbrowseropenwindow")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when {{DOMxRef("window.open()")}} is called within a + browser iframe. + | +
| {{Event("mozbrowserresize")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the browser {{HTMLElement("iframe")}}'s window size has + changed. + | +
| {{Event("mozbrowserscroll")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the browser {{HTMLElement("iframe")}} content scrolls. + | +
| {{Event("mozbrowserscrollareachanged")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the available scrolling area in the browser + {{HTMLElement("iframe")}} changes. This can occur on resize and + when the page size changes (while loading for example.) + | +
| {{Event("mozbrowserscrollviewchange")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when asynchronous scrolling (i.e. APCZ) starts or stops. | +
| {{Event("mozbrowsersecuritychange")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when the SSL state changes within a browser iframe. | +
| {{Event("mozbrowserselectionstatechanged")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the text selected inside the browser + {{HTMLElement("iframe")}} content changes. Note that this is + deprecated, and newer implementations use + {{Event("mozbrowsercaretstatechanged")}} instead. + | +
| {{Event("mozbrowsershowmodalprompt")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when {{DOMxRef("window.alert","alert()")}}, + {{DOMxRef("window.confirm","confirm()")}} or + {{DOMxRef("window.prompt","prompt()")}} are called within a + browser iframe + | +
| {{Event("mozbrowsertitlechange")}} | ++ | + Firefox OS + Browser API-specific + | +Sent when the document.title changes within a browser iframe. | +
| + {{Event("mozbrowserusernameandpasswordrequired")}} + | ++ | + Firefox OS + Browser API-specific + | +Sent when an HTTP authentification is requested. | +
| {{Event("mozbrowservisibilitychange")}} | ++ | + Firefox OS + Browser API-specific + | ++ Sent when the visibility state of the current browser iframe + {{HTMLElement("iframe")}} changes, for example due to a call to + {{DOMxRef("HTMLIFrameElement.setVisible","setVisible()")}}. + | +
| {{Event("MozGamepadButtonDown")}} | ++ | To be specified | +A gamepad button is pressed down. | +
| {{Event("MozGamepadButtonUp")}} | ++ | To be specified | +A gamepad button is released. | +
| + {{Event("MozMousePixelScroll")}} + {{Deprecated_Inline}} + | ++ | Mozilla specific | ++ The wheel button of a pointing device is rotated (detail attribute is a + number of pixels). (use wheel instead) + | +
| {{Event("MozOrientation")}} {{Deprecated_Inline}} | ++ | Mozilla specific | ++ Fresh data is available from an orientation sensor (see + deviceorientation). + | +
| {{Event("MozScrolledAreaChanged")}} | +{{DOMxRef("UIEvent")}} | +Mozilla specific | +The document view has been scrolled or resized. | +
| {{Event("moztimechange")}} | ++ | Mozilla specific | +The time of the device has been changed. | +
| + MozTouchDown + {{Deprecated_Inline}} + | ++ | Mozilla specific | ++ A touch point is placed on the touch surface (use touchstart instead). + | +
| + MozTouchMove + {{Deprecated_Inline}} + | ++ | Mozilla specific | ++ A touch point is moved along the touch surface (use touchmove instead). + | +
| + MozTouchUp + {{Deprecated_Inline}} + | ++ | Mozilla specific | ++ A touch point is removed from the touch surface (use touchend instead). + | +
| {{Event("alerting")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +The correspondent is being alerted (his/her phone is ringing). | +
| {{Event("busy")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +The line of the correspondent is busy. | +
| {{Event("callschanged")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call has been added or removed from the list of current calls. | +
| + onconnected + {{Event("connected")}} + | +{{DOMxRef("CallEvent")}} | +To be specified | +A call has been connected. | +
| {{Event("connecting")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call is about to connect. | +
| {{Event("delivered")}} | +{{DOMxRef("SMSEvent")}} | +To be specified | +An SMS has been successfully delivered. | +
| {{Event("dialing")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +The number of a correspondent has been dialed. | +
| {{Event("disabled")}} | ++ | Firefox OS specific | +Wifi has been disabled on the device. | +
| {{Event("disconnected")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call has been disconnected. | +
| {{Event("disconnecting")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call is about to disconnect. | +
| {{Event("enabled")}} | ++ | Firefox OS specific | +Wifi has been enabled on the device. | +
| {{Event("error_(Telephony)","error")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +An error occurred. | +
| {{Event("held")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call has been held. | +
| {{Event("holding")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call is about to be held. | +
| {{Event("incoming")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call is being received. | +
| {{Event("received")}} | +{{DOMxRef("SMSEvent")}} | +To be specified | +An SMS has been received. | +
| {{Event("resuming")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +A call is about to resume. | +
| {{Event("sent")}} | +{{DOMxRef("SMSEvent")}} | +To be specified | +An SMS has been sent. | +
| {{Event("statechange")}} | +{{DOMxRef("CallEvent")}} | +To be specified | +The state of a call has changed. | +
| {{Event("statuschange")}} | ++ | Firefox OS specific | +The status of the Wifi connection changed. | +
| {{Event("overflow")}} | +{{DOMxRef("UIEvent")}} | +Mozilla specific | +
+ An element has been overflowed by its content or has been rendered for
+ the first time in this state (only works for elements styled with
+ overflow != visible).
+ |
+
| {{Event("smartcard-insert")}} | ++ | Mozilla specific | ++ A smartcard has been + inserted. + | +
| {{Event("smartcard-remove")}} | ++ | Mozilla specific | ++ A smartcard has been + removed. + | +
| {{Event("stkcommand")}} | ++ | Firefox OS specific | ++ The STK Proactive Command + is issued from ICC. + | +
| {{Event("stksessionend")}} | ++ | Firefox OS specific | ++ The STK Session is + terminated by ICC. + | +
| {{Event("touchenter")}} | +{{DOMxRef("TouchEvent")}} | ++ Touch Events + Removed + | ++ |
| {{Event("touchleave")}} | +{{DOMxRef("TouchEvent")}} | ++ Touch Events + Removed + | ++ |
| {{Event("underflow")}} | +{{DOMxRef("UIEvent")}} | +Mozilla specific | +
+ An element is no longer overflowed by its content (only works for
+ elements styled with overflow != visible).
+ |
+
uploadprogress {{Deprecated_Inline}} |
+ {{DOMxRef("ProgressEvent")}} | +Mozilla Specific | +Upload is in progress (see {{Event("progress")}}). | +
{{Event("ussdreceived")}} |
+ + | Firefox OS specific | ++ A new + USSD + message is received + | +
| {{Event("voicechange")}} | ++ | Firefox OS specific | ++ The {{DOMxRef("MozMobileConnection.voice")}} object changes + values. + | +
| {{Event("msContentZoom")}} | ++ | Microsoft specific | ++ |
| {{Event("MSManipulationStateChanged")}} | ++ | Microsoft specific | ++ |
| {{Event("MSPointerHover")}} {{Deprecated_Inline}} | ++ | Microsoft specific | ++ |
总言
-当我们要使用 orientation 和 motion 事件时，理解浏览器给我们的相关值是什么意思就显的相当重要了。这篇文章会详细介绍在用的坐标系统并会教你如何全用它们。
-
-
-警告： 目前，Firefox 和 Chrome 处理坐标的方式不同。 在使用它们的时候要多加注意。
-坐标系
-坐标系是一种描述物体位置的系统，它包含三个轴 (X,Y,Z)，三个轴共同描述了物体相对于参照物的位置信息。当我们使用 orientation 和 motion 事件时会接触到两种坐标系统。
-地球坐标系
-地球坐标系是相对于地心的，也就是说，它的轴是基于重力方向和磁场北方向。我们使用大写的 X,Y,Z 来描述地球坐标系的轴。
--
-
- X 轴沿着地平面，垂直于 Y 轴，向东为正，向西为负。 -
- Y 轴沿着地平面，向北 (北极，不是磁场北) 为正，向南为负。 -
- Z 轴垂直于地平面，想象成一条线连接着设备跟地心。背对地心的方向为正，指向地心的方向为负。 -
设备坐标系
-设备坐标系是相对于设备中心的。我们使用小写的 x,y,z 来描述它的轴。
-,
-
-
- x 轴沿着屏幕表面，向右为正，向左为负。 -
- y 轴沿着屏幕表面，向上为正，向下为负。 -
- z 轴垂直屏幕表面或键盘，远离屏幕的方向为正。 -
- 注意：对于手机或平台而言，这里的设备方向总是相对于屏幕的标准方向，大部分是“竖屏”方向。而对于笔记本电脑来说，设备方向是相对于键盘的。如果你想检测设备方向变化来进行补偿调整，你可以使用 orientationchange 事件。
-旋转 (Rotation)
-旋转描述的是设备在设备坐标系跟地球坐标系中任意轴上的差异值，用角度表示。
-Alpha
-围绕 z 轴旋转设备将使 alpha 角度值发生变化：
-
alpha 为 0°时表示设备的顶部正指北极方向，当设备向左旋转时，alpha 将增加。
-Beta
-围绕 x 轴旋转，也就是前后旋转，将使 beta 值发生改变：
-
当 beta 为 0° 时表示设备顶部和底部与地表面的距离是一样的，当设备向前翻转时，beta 递增到 180°，向后翻转递减到-180°。
-Gamma
-当围绕 y 轴旋转，也就是左右倾斜设备时，将使 gamma 值发生改变：
-
gamma 等于 0°表示设备左右两边与地表面的距离相等，当设备向右翻转时，gamma 递增到 90° ，向左翻转时，递减到-90°。
diff --git a/files/zh-cn/web/events/orientation_and_motion_data_explained/index.md b/files/zh-cn/web/events/orientation_and_motion_data_explained/index.md new file mode 100644 index 00000000000000..b4b80f9a873030 --- /dev/null +++ b/files/zh-cn/web/events/orientation_and_motion_data_explained/index.md @@ -0,0 +1,70 @@ +--- +title: Orientation 和 motion 数据解释 +slug: Web/Events/Orientation_and_motion_data_explained +tags: + - Intermediate + - Mobile + - Motion + - NeedsContent + - Orientation + - páginas_a_traducir + - rotation +translation_of: Web/Events/Orientation_and_motion_data_explained +--- +## 总言 + +当我们要使用 orientation 和 motion 事件时，理解浏览器给我们的相关值是什么意思就显的相当重要了。这篇文章会详细介绍在用的坐标系统并会教你如何全用它们。 + +> **警告：** 目前，Firefox 和 Chrome 处理坐标的方式不同。 在使用它们的时候要多加注意。 + +## 坐标系 + +坐标系是一种描述物体位置的系统，它包含三个轴 (X,Y,Z)，三个轴共同描述了物体相对于参照物的位置信息。当我们使用 orientation 和 motion 事件时会接触到两种坐标系统。 + +### 地球坐标系 + +地球坐标系是相对于地心的，也就是说，它的轴是基于重力方向和磁场北方向。我们使用大写的 X,Y,Z 来描述地球坐标系的轴。 + +- X 轴沿着地平面，垂直于 Y 轴，向东为正，向西为负。 +- Y 轴沿着地平面，向北 (北极，不是磁场北) 为正，向南为负。 +- Z 轴垂直于地平面，想象成一条线连接着设备跟地心。背对地心的方向为正，指向地心的方向为负。 + +### 设备坐标系 + +设备坐标系是相对于设备中心的。我们使用小写的 x,y,z 来描述它的轴。 + + + +- x 轴沿着屏幕表面，向右为正，向左为负。 +- y 轴沿着屏幕表面，向上为正，向下为负。 +- z 轴垂直屏幕表面或键盘，远离屏幕的方向为正。 + +> **备注：** 注意：对于手机或平台而言，这里的设备方向总是相对于屏幕的标准方向，大部分是“竖屏”方向。而对于笔记本电脑来说，设备方向是相对于键盘的。如果你想检测设备方向变化来进行补偿调整，你可以使用 orientationchange 事件。 + +## 旋转 (Rotation) + +旋转描述的是设备在设备坐标系跟地球坐标系中任意轴上的差异值，用角度表示。 + +### Alpha + +围绕 z 轴旋转设备将使 alpha 角度值发生变化： + + + +alpha 为 0° 时表示设备的顶部正指北极方向，当设备向左旋转时，alpha 将增加。 + +### Beta + +围绕 x 轴旋转，也就是前后旋转，将使 beta 值发生改变： + + + +当 beta 为 0° 时表示设备顶部和底部与地表面的距离是一样的，当设备向前翻转时，beta 递增到 180°，向后翻转递减到-180°。 + +### Gamma + +当围绕 y 轴旋转，也就是左右倾斜设备时，将使 gamma 值发生改变： + + + +gamma 等于 0° 表示设备左右两边与地表面的距离相等，当设备向右翻转时，gamma 递增到 90° ，向左翻转时，递减到-90°。 diff --git a/files/zh-cn/web/exslt/index.html b/files/zh-cn/web/exslt/index.html deleted file mode 100644 index ceaf0b42b2d553..00000000000000 --- a/files/zh-cn/web/exslt/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: EXSLT -slug: Web/EXSLT -tags: - - EXSLT - - NeedsTranslation - - TopicStub - - XSLT - - XSLT_Reference -translation_of: Web/EXSLT ---- --{{ XsltRef() }} -EXSLT is a set of extensions to XSLT. There are a number of modules; those that are supported by Firefox are listed below: -
-- Common (
exsl) - - Provides basic extension elements and functions. -
- Math (
math) - - Provides routines for comparing nodes. -
- Regular expressions (
regexp) - - Provides facilities for using regular expressions in JavaScript syntax. -
- Sets (
set) - - Provides routines for manipulating sets. -
- Strings (
str) - - Provides functions for string manipulation. -
Using EXSLT
-To use an EXSLT function, you need to declare the namespace the function is in, and then use the appropriate prefix when calling the function. For example, to use the regular expressions package: -
-<xsl:stylesheet version="1.0" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - xmlns:regexp="http://exslt.org/regular-expressions"> - <xsl:template match="/"> - ... - <xsl:value-of select="regexp:replace(/root/@value, 'before', 'gi', 'AFTER')"/> - ... - </xsl:template> - -</xsl:stylesheet> --
Common
-The EXSLT Common package provides basic functions that expand upon the capabilities of XSLT. The namespace for the Common package is http://exslt.org/common.
-
Functions
- -Math
-The EXSLT Math package provides functions for working with numeric values and comparing nodes. The namespace for the Math package is http://exslt.org/math.
-
Functions
-- math:highest -
- math:lowest -
- math:max -
- math:min -
Regular expressions
-The EXSLT Regular Expressions package provides functions that allow testing, matching, and replacing text using JavaScript style regular expressions. -
The EXSLT Regular Expressions namespace is http://exslt.org/regular-expressions.
-
Functions
- -Sets
-The EXSLT Sets package offers functions that let you perform set manipulation. The namespace for these functions is http://exslt.org/sets.
-
Functions
- -Strings
-The EXSLT Strings package provides functions that allow the manipulation of strings. The namespace for the Strings package is http://exslt.org/strings.
-
Functions
-- str:concat -
- str:split -
- str:tokenize -
See also
- -
-
{{ XsltRef() }}
- -
- regexp:match() performs regular expression matching on a string, returning the submatches found as a result.
语法
- -regexp:match(targetString,regExpString[[,flagsString]]) -- -
参数
- --
-
targetString
- - The string to perform regular expression matching upon. -
regExpString
- - The JavaScript style regular expression to evaluate. -
flagsString
- - An optional string containing character flags. -
The character flags are:
- --
-
g
- - 全局匹配 -
- The submatches from every match in the string are returned. If this flag isn't specified, only the submatches from the first match are returned. -
i
- - Case insensitive match -
- If this flag is specified, the match is performed in a case insensitive fashion. -
Returns
- -A node set of match elements, each of which has the string value equal to a portion of the first parameter string as captured by the regular expression. If the match isn't a global one, the first match element has the value of the portion of the string matched by the entire regular expression.
例如：
- -<xsl:for-each select="regExp:match('http://developer.mozilla.org/en/docs/Firefox_3_for_developers',
- '(\w+):\/\/([^/:]+)(:\d*)?([^# ]*)')">
- Part <xsl:value-of select="position()" /> = <xsl:value-of select="." />
-</xsl:for-each>
-
-
-This code generates the following output:
- -Part 1 = http://developer.mozilla.org/en/docs/Firefox_3_for_developers -Part 2 = http -Part 3 = developer.mozilla.org -Part 4 = -Part 5 = /en/docs/Firefox_3_for_developers -- -
定义
- - - -Gecko support
- -Supported in Gecko 1.9 and later.
diff --git a/files/zh-cn/web/exslt/regexp/match/index.md b/files/zh-cn/web/exslt/regexp/match/index.md new file mode 100644 index 00000000000000..985f4e7f6045c4 --- /dev/null +++ b/files/zh-cn/web/exslt/regexp/match/index.md @@ -0,0 +1,61 @@ +--- +title: match +slug: Web/EXSLT/regexp/match +translation_of: Web/EXSLT/regexp/match +--- +{{ XsltRef() }} + +`regexp:match()` performs regular expression matching on a string, returning the submatches found as a result. + +### 语法 + +```js +regexp:match(targetString,regExpString[[,flagsString]]) +``` + +### 参数 + +- `targetString` + - : The string to perform regular expression matching upon. +- `regExpString` + - : The JavaScript style regular expression to evaluate. +- `flagsString` + - : An optional string containing character flags. + +The character flags are: + +- `g` + - : 全局匹配。The submatches from every match in the string are returned. If this flag isn't specified, only the submatches from the first match are returned. +- `i` + - : Case insensitive match. If this flag is specified, the match is performed in a case insensitive fashion. + +### Returns + +A node set of `match` elements, each of which has the string value equal to a portion of the first parameter string as captured by the regular expression. If the match isn't a global one, the first match element has the value of the portion of the string matched by the entire regular expression. + +例如： + +```xml +