Spec-Zone.ru › Web APIs

EyeDropper: метод open()

Ограниченная доступность

Эта функция не является Baseline, поскольку она не работает в некоторых из наиболее широко используемых браузеров.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.

Экспериментальная функция: Это экспериментальная технология
Перед использованием в продакшене внимательно изучите таблицу совместимости с браузерами.

Метод EyeDropper.open() запускает режим пипетки, возвращая промис, который выполняется, когда пользователь выбрал цвет и вышел из режима пипетки.

Синтаксис

open()
open(options)

Параметры

options Необязательно

Объект опций для передачи сигнала AbortSignal:

signal Необязательно

AbortSignal. Режим пипетки будет прерван, когда метод abort() объекта AbortSignal будет вызван.

Возвращаемое значение

Promise, который в конечном итоге разрешается, когда пользователь выбирает цвет пикселя на экране.

Промис разрешается до объекта со следующим свойством:

sRGBHex

Строка, представляющая выбранный цвет в шестнадцатеричном формате sRGB (#aabbcc).

Исключения

Исключения не выбрасываются, а возвращаются, когда Promise отклоняется.

NotAllowedError DOMException

Выбрасывается, если open() не вызывается через временное пользовательское активирование.

InvalidStateError DOMException

Выбрасывается, если другая пипетка уже открыта.

AbortError DOMException

Выбрасывается, если пользователь прерывает выбор, нажав клавишу Esc, или если выбор прерывается с помощью AbortController, переданного в качестве аргумента в open().

OperationError DOMException

Выбрасывается, если выбор не удается по другим причинам.

Спецификации

Спецификация
API пипетки
# dom-eyedropper-open

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
open 95 95 Нет Нет Нет Нет Нет Нет Нет Нет Нет

См. также

  • Интерфейс EyeDropper, к которому он относится.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/EyeDropper/open

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API