大网数据广告活动
Web 标准与前端开发

EyeDropper

· 52CE 我爱测

`EyeDropper`** 接口表示一个拾色器工具的实例,用户可以打开并使用它从屏幕上选择颜色。

EyeDropper API

EyeDropper 接口表示一个拾色器工具的实例,用户可以打开并使用它从屏幕上选择颜色。

构造函数

  • EyeDropper.EyeDropper
    • : 返回一个新的 EyeDropper 实例。

实例方法

EyeDropper 接口不继承任何方法。

  • EyeDropper.open()
    • : 返回一个 Promise,该 Promise 会兑现一个可以访问所选颜色的对象。

示例

打开拾色器工具并进行颜色采样

以下示例演示如何打开拾色器工具,并等待用户选择屏幕上的像素,或按下 <kbd>Escape</kbd> 键取消拾色器模式。

HTML

<button id="start-button">打开拾色器</button> <span id="result"></span>

JavaScript

document.getElementById("start-button").addEventListener("click", () => {
  const resultElement = document.getElementById("result");

  if (!window.EyeDropper) {
    resultElement.textContent = "你的浏览器不支持 EyeDropper API";
    return;
  }

  const eyeDropper = new EyeDropper();

  eyeDropper
    .open()
    .then((result) => {
      resultElement.textContent = result.sRGBHex;
      resultElement.style.backgroundColor = result.sRGBHex;
    })
    .catch((e) => {
      resultElement.textContent = e;
    });
});

结果

打开拾色器工具并进行颜色采样

中止拾色器模式

以下示例演示如何打开拾色器工具,并等待用户选择屏幕上的像素或按下 <kbd>Escape</kbd> 键来取消拾色器模式。

HTML

<button id="start-button">打开拾色器</button> <span id="result"></span>

JavaScript

document.getElementById("start-button").addEventListener("click", () => {
  const resultElement = document.getElementById("result");

  if (!window.EyeDropper) {
    resultElement.textContent = "你的浏览器不支持 EyeDropper API";
    return;
  }

  const eyeDropper = new EyeDropper();
  const abortController = new AbortController();

  eyeDropper
    .open({ signal: abortController.signal })
    .then((result) => {
      resultElement.textContent = result.sRGBHex;
      resultElement.style.backgroundColor = result.sRGBHex;
    })
    .catch((e) => {
      resultElement.textContent = e;
    });

  setTimeout(() => {
    abortController.abort();
  }, 2000);
});

结果

中止拾色器模式

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。