L'interfaccia HTMLCanvasElement fornisce proprietà e metodi per manipolare il layout e la presentazione degli elementi del canvas. L'interfaccia HTMLCanvasElement eredita anche le proprietà ed i metodi della interfaccia
HTMLElement
.
Proprietà
Eredita proprietà dalla interfaccia genitore, HTMLElement
.
HTMLCanvasElement.height
- Intero positivo che rispecchia l'attributo dell'elemento HTML
height
interpretato in unità pixel CSS. Quando l'attributo non è specificato, o se è impostato ad un valore non valido, come un numero negativo, è usato il valore di default 150. HTMLCanvasElement.mozOpaque
- Un
Boolean
che rispecchia l'attributo HTMLmoz-opaque
dell'elemento<canvas>
. Permette al canvas di sapere se la traslucenza sarà un fattore. Se il canvas sa che non ci sarà traslucenza, la prestazione del dipingere puo' essere ottimizzata. HTMLCanvasElement.width
- Intero positivo che rispecchia l'attributo HTML
width
dell'elemento<canvas>
interpretato in unità pixel CSS. Quando l'attributo non è specificato, o se è impostato ad un valore non valido, ad esempio negativo, è usato il valore di default 300.
Metodi
Eredita dal proprio genitore, HTMLElement
.
HTMLCanvasElement.captureStream()
- Restituisce un oggetto
CanvasCaptureMediaStream
che è una capture video in tempo reale della superficie del canvas. HTMLCanvasElement.getContext()
- Restituisce un contesto di disegno sul canvas, oppure
null
se l'identificativo del contesto non ha supporto. Un contesto di disegno permette di disegnare sul canvas. Chiamare getContext con "2d
" come parametro restituisce un oggettoCanvasRenderingContext2D
, mentre chiamarlo con "experimental-webgl
" (o "webgl
") restituisce un oggettoWebGLRenderingContext
. Questo contesto è disponibile solo su browsers che implementano WebGL. HTMLCanvasElement.toDataURL()
- Restituisce un URL dati contentente una rappresentazione della immagine nel formato specificato dal parametro tipo (il valore di default è
png
). L'immagine restituita ha una risoluzione di 96dpi. HTMLCanvasElement.toBlob()
- Crea un oggetto
Blob
che rappresenta l'immagine contenuta nel canvas; questo file puo' essere immagazzinato temporaneamente su disco oppure nella memoria a discrezione dell'agente per l'utente (user agent). HTMLCanvasElement.transferControlToOffscreen()
- Trasferisce il controllo ad un oggetto
OffscreenCanvas
, o nella thread principale oppure in una worker. HTMLCanvasElement.mozGetAsFile()
- Restituisce un oggetto
File
che rappresenta l'immagine contenuta nel canvas; questo è un file immagazzinato nella memoria, col nome indicato. Se il tipo del file non è specificato, il tipo di default per l'immagineè
image/png
.
Specifiche
Specifica | Status | Commento |
---|---|---|
Media Capture from DOM Elements The definition of 'HTMLCanvasElement' in that specification. |
Working Draft | Aggiunge il metodo captureStream() . |
HTML Living Standard The definition of 'HTMLCanvasElement' in that specification. |
Living Standard | Il metodo getContext() ora restituisce RenderingContext invece di un oggetto opaco.Sono stati aggiunti i metodi probablySupportsContext() , setContext() etransferControlToProxy() . |
HTML 5.1 The definition of 'HTMLCanvasElement' in that specification. |
Recommendation | |
HTML5 The definition of 'HTMLCanvasElement' in that specification. |
Recommendation | Definizione iniziale. |
Compatibilità coi Browsers
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
Funzionalità | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support (2D context) |
4.0 | 3.6 (1.9.2) | 9.0 | 9.0 [1] | 3.1 |
toBlob() |
50 | 19 (19) [2] | ? | ? | No support (bug 71270) |
probablySupportsContext() ,setContext() ,transferControlToProxy() |
No support | No support | No support | No support | No support |
mozGetAsFile() |
No support | 4.0 (2) | No support | No support | No support |
captureStream() |
No support | 41 (41) | No support | No support | No support |
transferControlToOffscreen() |
No support | 44 (44) [3] | No support | No support | No support |
Funzionalità | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support (2D context) |
2.1 | (Yes) | (Yes) | ? | 10.0 [1] | 3.2 |
webgl context |
? | ? | (Yes) as experimental-webgl |
? | ? | ? |
toBlob() |
No support (bug 67587) | 50 | 18.0 (18) [2] | ? | ? | No support (bug 71270) |
probablySupportsContext() ,setContext() ,transferControlToProxy() |
No support | No support | No support | No support | No support | No support |
mozGetAsFile() |
No support | No support | 4.0 (2) | No support | No support | No support |
captureStream() |
No support | No support | 41.0 (41) | No support | No support | No support |
transferControlToOffscreen() |
No support | No support | 44.0 (44) [3] | No support | No support | No support |
[1] Supporto parziale in Opera Mini 5.0 e successivi.
[2] Il supporto per il terzo parametro, è stato aggiunto solo con Gecko 25: quando viene usato col tipo "image/jpeg," questo argomento specifica la qualità dell'immagine.
[3] Da questa funzionalità dipende una impostazione di preferenza di funzionalità. Imposta come true gfx.offscreencanvas.enabled
in about:config .
Vedi anche:
- elemento HTML che implementa questa interfaccia:
<canvas>
.