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

Устарело

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

Спецификации
------------

| Specification |
| --- |
| HTML Standard # htmlcanvaselement |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* HTML element implementing this interface: `<canvas>`.