HTMLCanvasElement

Интерфейс HTMLCanvasElement предоставляет свойства и методы для управления расположением и представлением элеметов canvas. Он также наследует свойства и методы интерфейса HTMLElement.

Свойства

Наследуются от родителя, HTMLElement.

HTMLCanvasElement.height

Положительное целое число, отражающее HTML-атрибут height элемента <canvas> (воспринимается в пикселях CSS). Если атрибут не определён или имеет некорректное значение (например отрицательное), используется зачение по умолчанию  — 150.

HTMLCanvasElement.mozOpaque

Объект Boolean, отражающий HTML-атрибут moz-opaque элемента <canvas>. Сообщает холсту, будет ли присутствовать прозрачность. Если холсту известно, что прозрачность не используется, отрисовка может быть оптимизирована.

HTMLCanvasElement.width

Положительное целое число, отражающее HTML-атрибут width элемента <canvas> (воспринимается в пикселях CSS). Если атрибут не определён или имеет некорректное значение (например отрицательное), используется зачение по умолчанию  — 300.

HTMLCanvasElement.mozPrintCallback

Is a function that is Initially null, Web content can set this to a JavaScript function that will be called if the page is printed. This function can then redraw the canvas at a higher resolution that is suitable for the printer being used. See this blog post.

Методы

Наследуются от родителя, HTMLElement.

HTMLCanvasElement.captureStream()

Возвращает CanvasCaptureMediaStream — поток видео, которое захватывается в реальном времени с поверхности холста.

HTMLCanvasElement.getContext()

Возвращает связный с холстом контекст, который позволяет рисовать на холсте. Если context ID не поддерживается, возвращает null. Вызов getContext с параметром "2d" возвращает объект CanvasRenderingContext2D, тогда так вызов с параметром "experimental-webgl" (или "webgl") возвращает объект WebGLRenderingContext. Этот контекст поддерживается толко в браузерах, в которых реализован WebGL.

HTMLCanvasElement.toDataURL()

Возвращает data-URL, который содержит представление картинки в формате. указанном в параметре type (по умолчанию png). Возвращаемая картинка имеет разрешение 96dpi.

HTMLCanvasElement.toBlob()

Создаёт объект Blob, представляющий картинку, которая содержится в холсте. Этот файл может быть кэширован на диске или сохранён в памяти наусмотрение user agent.

HTMLCanvasElement.transferControlToOffscreen()

Передаёт управление объекту OffscreenCanvas, либо в main thread либо в worker.

HTMLCanvasElement.mozGetAsFile()

Возвращает объект File представляющий картинку, которая содержится в холсте. This file is a memory-based file, with the specified name. Если тип не указан, используется image/png.

Specifications

Browser compatibility

[1] Opera Mini 5.0 and later has partial support.

[2] Support for the third parameter, has been added in Gecko 25 only: when used with the "image/jpeg" type, this argument specifies the image quality.

[3] This feature is behind a feature preference setting. In about:config, set gfx.offscreencanvas.enabled to true.

See also

• HTML element implementing this interface: <canvas>.