HTMLCanvasElement

Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.

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 HTML moz-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 oggetto CanvasRenderingContext2D, mentre chiamarlo con "experimental-webgl" (o "webgl") restituisce un oggetto WebGLRenderingContext. 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.
Editor's Draft Aggiunge il metodo captureStream().
WHATWG 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().
HTML5.1
The definition of 'HTMLCanvasElement' in that specification.
Working Draft  
HTML5
The definition of 'HTMLCanvasElement' in that specification.
Recommendation Definizione iniziale.

Compatibilità coi Browsers

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>.

Tag del documento e collaboratori

 Hanno collaborato alla realizzazione di questa pagina: Mathkute
 Ultima modifica di: Mathkute,