EyeDropper:open() 方法
语法
js
open()
open(options)
参数
options
可选-
一个用于传递
AbortSignal
信号的对象:signal
-
一个
AbortSignal
对象。当调用AbortSignal
的abort()
方法时,拾色器模式将被中止。
返回值
一个 Promise
,最终在用户从屏幕上选择一个像素颜色时解决。
该 Promise 会兑现一个带有以下属性的对象:
sRGBHex
-
代表所选颜色的字符串,采用十六进制 sRGB 格式(
#aabbcc
)。
异常
在 Promise
被拒绝(rejected)时,不会抛出异常,而是返回一个错误对象。Promise 在以下两种情况下被拒绝:
- 当用户通过按下 Escape 键来取消拾色器模式时。
- 当通过作为参数传递给
open()
方法的AbortController
来中止拾色器模式时。
规范
Specification |
---|
EyeDropper API # dom-eyedropper-open |
浏览器兼容性
BCD tables only load in the browser
参见
- 它属于
EyeDropper
接口。