EyeDropper: метод open()
Ограниченная доступность
Эта функция не является Baseline, поскольку она не работает в некоторых из наиболее широко используемых браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.
Экспериментальная функция: Это экспериментальная технология
Перед использованием в продакшене внимательно изучите таблицу совместимости с браузерами.
Метод EyeDropper.open() запускает режим пипетки, возвращая промис, который выполняется, когда пользователь выбрал цвет и вышел из режима пипетки.
Синтаксис
open() open(options)
Параметры
optionsНеобязательно-
Объект опций для передачи сигнала
AbortSignal:signalНеобязательно-
AbortSignal. Режим пипетки будет прерван, когда методabort()объектаAbortSignalбудет вызван.
Возвращаемое значение
Promise, который в конечном итоге разрешается, когда пользователь выбирает цвет пикселя на экране.
Промис разрешается до объекта со следующим свойством:
sRGBHex-
Строка, представляющая выбранный цвет в шестнадцатеричном формате sRGB (
#aabbcc).
Исключения
Исключения не выбрасываются, а возвращаются, когда Promise отклоняется.
-
NotAllowedErrorDOMException -
Выбрасывается, если
open()не вызывается через временное пользовательское активирование. -
InvalidStateErrorDOMException -
Выбрасывается, если другая пипетка уже открыта.
-
AbortErrorDOMException -
Выбрасывается, если пользователь прерывает выбор, нажав клавишу Esc, или если выбор прерывается с помощью
AbortController, переданного в качестве аргумента вopen(). -
OperationErrorDOMException -
Выбрасывается, если выбор не удается по другим причинам.
Спецификации
| Спецификация |
|---|
| 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