The WebGLRenderingContext.canvas
property is a read-only
reference to the HTMLCanvasElement
or OffscreenCanvas
object that is associated with the context. It might be null
if it is not
associated with a <canvas>
element or an OffscreenCanvas
object.
Syntax
gl.canvas;
Return value
Either a HTMLCanvasElement
or OffscreenCanvas
object or
null
.
Examples
Canvas element
Given this <canvas>
element:
<canvas id="canvas"></canvas>
You can get back a reference to it from the WebGLRenderingContext
using
the canvas
property:
var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
gl.canvas; // HTMLCanvasElement
Offscreen canvas
Example using the experimental OffscreenCanvas
object.
var offscreen = new OffscreenCanvas(256, 256);
var gl = offscreen.getContext('webgl');
gl.canvas; // OffscreenCanvas
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 1.0 The definition of 'WebGLRenderingContext.canvas' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.