在此页

• Input device capabilities concepts and usage
• 接口
• 规范
• 浏览器兼容性
• 相关话题

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

The InputDeviceCapabilities API provides details about the underlying sources of input events. The API attempts to describe how the device behaves rather than what it is. For example, the first version of the API indicates whether a device fires touch events rather than whether it is a touch screen.

Input device capabilities concepts and usage

Because DOM events abstract device input, they provide no way to learn what device or type of device fired an event. This can lead to instances where the same action triggers multiple event handlers.  To deal with this, developers make assumptions and use heuristics to normalize behavior on web pages.

The InputDeviceCapabilities API addresses this problem by abstracting the capabilities of input devices. For example, let's say we have a web page that implements both a touchstart 和 mousedown event. We can assume that if the touchstart event is triggered that the user's device has a touch interface.  What about when the mousedown event is triggered? It would be useful to know if a touchstart event were also triggered so that we don't take the same action twice. We can do this by checking the sourceCapabilities property of the UIEvent .

myButton.addEventListener('mousedown', function(e) {
  // Touch event case handled above, don't change the style again on tap.
  if (!e.sourceCapabilities.firesTouchEvents)
    myButton.classList.add("pressed");
});
					

接口

InputDeviceCapabilities

Provides logical information about an input device.

规范

规范	状态	注释
InputDeviceCapabilities	草案	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
InputDeviceCapabilities 非标	Chrome 47	Edge ≤79	Firefox ?	IE ?	Opera Yes	Safari ?	WebView Android 47	Chrome Android 47	Firefox Android ?	Opera Android Yes	Safari iOS ?	Samsung Internet Android 5.0
InputDeviceCapabilities() 构造函数 非标	Chrome 47	Edge ≤79	Firefox ?	IE ?	Opera ?	Safari ?	WebView Android 47	Chrome Android 47	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android 5.0
firesTouchEvents 非标	Chrome 47	Edge ≤79	Firefox ?	IE ?	Opera Yes	Safari ?	WebView Android 47	Chrome Android 47	Firefox Android ?	Opera Android Yes	Safari iOS ?	Samsung Internet Android 5.0

图例

完整支持

完整支持

兼容性未知 ?

兼容性未知

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

元数据

• 最后修改： 2019 年 3 月 23 日