EyeDropper: phương thức open()

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Phương thức EyeDropper.open() bắt đầu chế độ eyedropper, trả về một promise được hoàn thành khi người dùng đã chọn một màu và thoát chế độ eyedropper.

Cú pháp

js
open()
open(options)

Tham số

options Optional

Một đối tượng tùy chọn để truyền tín hiệu AbortSignal:

signal Optional

Một AbortSignal. Chế độ eyedropper sẽ bị hủy khi phương thức abort() của AbortSignal được gọi.

Giá trị trả về

Một Promise cuối cùng giải quyết khi người dùng chọn màu pixel từ màn hình.

Promise giải quyết thành một đối tượng với thuộc tính sau:

sRGBHex

Một chuỗi đại diện cho màu được chọn, ở định dạng hex sRGB (#aabbcc).

Ngoại lệ

Các ngoại lệ không được ném ra mà được trả về khi Promise bị từ chối.

NotAllowedError DOMException

Được ném ra nếu open() không được gọi thông qua transient user activation.

InvalidStateError DOMException

Được ném ra nếu một eyedropper khác đã được mở.

AbortError DOMException

Được ném ra nếu người dùng hủy việc chọn bằng cách nhấn phím Esc hoặc nếu việc chọn bị hủy bởi một AbortController được truyền làm đối số cho open().

OperationError DOMException

Được ném ra nếu việc chọn thất bại vì các lý do khác.

Thông số kỹ thuật

Thông số kỹ thuật
EyeDropper API
# dom-eyedropper-open

Tương thích trình duyệt

Xem thêm