HTMLCanvasElement

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

Свойства

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

HTMLCanvasElement.height
Положительное целое число, отражающее HTML-атрибут height элемента <canvas> (воспринимается в пикселях CSS). Если атрибут не определён или имеет некорректное значение (например отрицательное), используется значение по умолчанию  — 150.
HTMLCanvasElement.mozOpaque (en-US)
Объект 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 (en-US) — поток видео, которое захватывается в реальном времени с поверхности холста.
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 (en-US), либо в main thread либо в worker.
HTMLCanvasElement.mozGetAsFile() (en-US)
Возвращает объект File представляющий картинку, которая содержится в холсте. This file is a memory-based file, with the specified name. Если тип не указан, используется image/png.

Specifications

Specification Status Comment
Media Capture from DOM Elements
Определение 'HTMLCanvasElement' в этой спецификации.
Рабочий черновик Adds the method captureStream().
HTML Living Standard
Определение 'HTMLCanvasElement' в этой спецификации.
Живой стандарт The method getContext() now returns a RenderingContext rather than an opaque object.
The methods probablySupportsContext(), setContext() and transferControlToProxy()have been added.
HTML 5.1
Определение 'HTMLCanvasElement' в этой спецификации.
Рекомендация  
HTML5
Определение 'HTMLCanvasElement' в этой спецификации.
Рекомендация Initial definition.

Browser compatibility

BCD tables only load in the browser

See also

  • HTML element implementing this interface: <canvas>.