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