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

浏览器兼容性

BCD tables only load in the browser

参见