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

浏览器兼容性

BCD tables only load in the browser

参见