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.mozPrintCallbackNon-standard-
Is a
functionthat 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 specifiedname. Если тип не указан, используется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>.