HTMLCanvasElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

* Some parts of this feature may have varying levels of support.

Интерфейс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 afunction 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 specifiedname. Если тип не указан, используетсяimage/png.