EyeDropper:open() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

EyeDropper.open() 方法启动拾色器模式,返回一个 Promise,在用户选择颜色而退出拾色器模式后兑现。

语法

js
open()
open(options)

参数

options 可选

一个用于传递 AbortSignal 信号的对象:

signal

一个 AbortSignal 对象。当调用 AbortSignalabort() 方法时,拾色器模式将被中止。

返回值

一个 Promise,最终在用户从屏幕上选择一个像素颜色时解决。

该 Promise 会兑现一个带有以下属性的对象:

sRGBHex

代表所选颜色的字符串,采用十六进制 sRGB 格式(#aabbcc)。

异常

Promise 被拒绝(rejected)时,不会抛出异常,而是返回一个错误对象。Promise 在以下两种情况下被拒绝:

  • 当用户通过按下 Escape 键来取消拾色器模式时。
  • 当通过作为参数传递给 open() 方法的 AbortController 来中止拾色器模式时。

规范

Specification
EyeDropper API
# dom-eyedropper-open

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
open
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

参见