HTMLCanvasElement

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

Наследует свойства от родительского класса HTMLElement.

HTMLCanvasElement.height

Атрибут height элемента <canvas> — это неотрицательное integer число, отражающее количество логических пикселей (или значений RGBA) по вертикали в столбце холста. Если атрибут не указан или имеет недопустимое значение (например, отрицательное), используется значение по умолчанию 150. Если для элемента <canvas> не задана высота в CSS, это значение также используется как высота холста в единицах CSS Pixel.

HTMLCanvasElement.width

Атрибут width элемента <canvas> — это неотрицательное integer число, отражающее количество логических пикселей (или значений RGBA) по горизонтали в строке холста. Если атрибут не указан или имеет недопустимое значение (например, отрицательное), используется значение по умолчанию 300. Если для элемента <canvas> не задана ширина в CSS, это значение также используется как ширина холста в единицах CSS Pixel.

HTMLCanvasElement.mozOpaque Нестандартный Устаревший

Булево значение, отражающее атрибут moz-opaque элемента <canvas>. Он сообщает холсту, будет ли учитываться непрозрачность. Если холст знает, что непрозрачности нет, можно оптимизировать производительность рисования. Поддерживается только в браузерах Mozilla; используйте стандартный canvas.getContext('2d', { alpha: false }) вместо него.

HTMLCanvasElement.mozPrintCallback Нестандартный

Значение function, изначально равное null. Веб-контент может установить это значение на функцию JavaScript, которая будет вызвана при перерисовке холста во время печати страницы. При вызове обратная функция получает объект «printState», реализующий интерфейс MozCanvasPrintState. Обратная функция может получить контекст для рисования из объекта printState и должна вызвать done() на нём по завершении. Цель mozPrintCallback — получить более высокое разрешение рендеринга холста с разрешением используемого принтера. См. эту запись в блоге.

Наследует методы от родительского класса HTMLElement.

HTMLCanvasElement.captureStream()

Возвращает CanvasCaptureMediaStreamTrack, представляющий собой захват видео в реальном времени с поверхности холста.

HTMLCanvasElement.getContext()

Возвращает контекст рисования холста или null, если идентификатор контекста не поддерживается или холст уже настроен на другой режим контекста.

HTMLCanvasElement.toDataURL()

Возвращает данные-URL, содержащие представление изображения в формате, указанном параметром type (по умолчанию png). Возвращаемое изображение имеет разрешение 96 dpi.

HTMLCanvasElement.toBlob()

Создаёт объект Blob, представляющий изображение, содержащееся на холсте; этот файл может быть кэширован на диске или храниться в памяти по усмотрению пользователя.

HTMLCanvasElement.transferControlToOffscreen()

Переносит управление в объект OffscreenCanvas, как на основном потоке, так и на рабочем.

Наследует события от родительского класса HTMLElement.

Подпишитесь на эти события, используя addEventListener(), или назначив обработчик события к свойству oneventname этого интерфейса.

contextlost

Срабатывает, если браузер обнаруживает потерю контекста CanvasRenderingContext2D.

contextrestored

Срабатывает, если браузер успешно восстанавливает контекст CanvasRenderingContext2D.

webglcontextcreationerror

Срабатывает, если пользовательский агент не может создать контекст WebGLRenderingContext или WebGL2RenderingContext.

webglcontextlost

Срабатывает, если пользовательский агент обнаруживает потерю буфера рисования, связанного с объектом WebGLRenderingContext или WebGL2RenderingContext.

webglcontextrestored

Срабатывает, если пользовательский агент восстанавливает буфер рисования для объекта WebGLRenderingContext или WebGL2RenderingContext.

• HTML-элемент, реализующий этот интерфейс: <canvas>