HTMLCanvasElement

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

Свойства

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

HTMLCanvasElement.height

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

HTMLCanvasElement.mozOpaque (en-US) Non-standard

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

HTMLCanvasElement.width

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

HTMLCanvasElement.mozPrintCallback Non-standard

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) Non-standard Deprecated

Возвращает объект 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>.