EyeDropper: open() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Die EyeDropper.open()
Methode startet den Pipettenmodus und gibt ein Promise zurück, das erfüllt wird, sobald der Benutzer eine Farbe ausgewählt und den Pipettenmodus verlassen hat.
Syntax
open()
open(options)
Parameter
options
Optional-
Ein Optionsobjekt, um ein
AbortSignal
Signal zu übergeben:signal
Optional-
Ein
AbortSignal
. Der Pipettenmodus wird abgebrochen, wenn dieabort()
Methode desAbortSignal
s aufgerufen wird.
Rückgabewert
Ausnahmen
Ausnahmen werden nicht geworfen, sondern zurückgegeben, wenn das Promise
abgelehnt wird.
NotAllowedError
DOMException
-
Wird geworfen, wenn
open()
nicht über eine vorübergehende Benutzeraktivierung aufgerufen wird. InvalidStateError
DOMException
-
Wird geworfen, wenn bereits ein anderer Farbwähler geöffnet ist.
AbortError
DOMException
-
Wird geworfen, wenn der Benutzer die Auswahl durch Drücken der Esc-Taste abbricht oder wenn die Auswahl durch einen übergebenen
AbortController
zuopen()
abgebrochen wird. OperationError
DOMException
-
Wird geworfen, wenn die Auswahl aus anderen Gründen fehlschlägt.
Spezifikationen
Specification |
---|
EyeDropper API # dom-eyedropper-open |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Das
EyeDropper
Interface, zu dem es gehört.