EyeDropper API
EyeDropper.open() 方法启动拾色器模式,返回一个 Promise,在用户选择颜色而退出拾色器模式后兑现。
语法
open()
open(options)
参数
options- : 一个用于传递 AbortSignal 信号的对象:
signal- : 一个 AbortSignal 对象。当调用
AbortSignal的 AbortController/abort() 方法时,拾色器模式将被中止。
- : 一个 AbortSignal 对象。当调用
- : 一个用于传递 AbortSignal 信号的对象:
返回值
一个 Promise,最终在用户从屏幕上选择一个像素颜色时解决。
该 Promise 会兑现一个带有以下属性的对象:
sRGBHex- : 代表所选颜色的字符串,采用十六进制 sRGB 格式(
#aabbcc)。
- : 代表所选颜色的字符串,采用十六进制 sRGB 格式(
异常
在 Promise 被拒绝(rejected)时,不会抛出异常,而是返回一个错误对象。Promise 在以下两种情况下被拒绝:
- 当用户通过按下 <kbd>Escape</kbd> 键来取消拾色器模式时。
- 当通过作为参数传递给
open()方法的 AbortController 来中止拾色器模式时。
规范
浏览器兼容性
参见
- 它属于 EyeDropper 接口。
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
