Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Revision 931525 of <canvas>

  • Slug della versione: Web/HTML/Element/canvas
  • Titolo della versione: <canvas>
  • ID versione: 931525
  • Data di creazione
  • Autore: nicolo-ribaudo
  • Versione corrente?
  • Commento

Contenuto della versione

L'elemento HTML <canvas> viene usato per disegnare tramite JavaScript. Per esempio, può essere usato per disegnare, modificare foto o creare animazioni. Si può (e si dovrebbe) fornire un contenuto alternativo all'interno del tag <canvas>: questo contenuto verrà visualizzato sia nei browser che non supportano questo elemento, sia nei browser con JavaScript disabilitato.

Per altri articoli sull'utilizzo di questo elemento, vedi la pagina riguardo i canvas.

Attributi

Questo elemento accetta anche gli attributi globali.

{{htmlattrdef("height")}}
L'altezza dell'elemento in pixels. Il valore predefinito è 150.
{{htmlattrdef("moz-opaque")}} {{non-standard_inline}}
Permette al browser di sapere se questo elemento userà la trasparenza. Se non, il browser può ottimizzare le performace durante il disegno.
{{htmlattrdef("width")}}
La larghezza dell'elemento in pixels. Il valore predefinito è 300.

Descrizione

Richiede il tag di chiusura </canvas>

A differenza dell'elemento {{HTMLElement("img")}}, l'elemento {{HTMLElement("canvas")}} richiede il tag di chiusura (<canvas>).

Dimensioni del'area da disegno

Le dimensioni del'elemento possono essere cambiate usando i focli di stile. L'immagine viene ridimensionata durante il rendering per rientrare nella dimensione corretta. Se le dimensioni sembrano distorte, prova a specificare gli attributi width e height utilizzando gli attributi anziché il CSS.

Esempi

<canvas id="canvas" width="300" height="300">
  Mi dispiace, ma il tuo browser non supporta l'elemento &lt;canvas&gt;.
</canvas>

Se il tuo disegno non ha trasparenza, usa l'attributo moz-opaque. Questa informazione può essere utilizzata per ottimizzare il rendering.

Questo attributo non è standard e funziona solo nei motori di rendering basati su Mozilla.

<canvas id="mycanvas" moz-opaque></canvas>

Specifiche

Specifica Stato Commento
{{SpecName('HTML WHATWG', 'the-canvas-element.html#the-canvas-element', '<canvas>')}} {{Spec2('HTML WHATWG')}}  
{{SpecName('HTML5 W3C', 'the-canvas-element.html#the-canvas-element', '<canvas>')}} {{Spec2('HTML5 W3C')}} Definizione iniziale

Compatibilità con i browser

{{CompatibilityTable}}

Funzionalità Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 {{CompatGeckoDesktop("1.8")}}[1]
{{CompatGeckoDesktop("6.0")}}[2]
{{CompatGeckoDesktop("12.0")}}[3]
9.0 9.0[4] 2.0[5]
moz-opaque {{CompatNo}} {{CompatGeckoDesktop("1.9.1")}} {{CompatNo}} {{CompatNo}} {{CompatNo}}
Funzionalità Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Supporto di base {{CompatGeckoDesktop("1.8")}}[1]
{{CompatGeckoDesktop("6.0")}}[2]
{{CompatGeckoDesktop("12.0")}}[3]
{{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} 1.0
moz-opaque {{CompatGeckoMobile("1.9.1")}} {{CompatNo}} {{CompatNo}} {{CompatNo}} {{CompatNo}}

[1] Prima di Gecko 5.0 {{geckoRelease("5.0")}} le dimensioni di questo elemento erano specificate utilizzando anche numeri negativi.

[2] Prima di Gecko 6.0 {{geckoRelease("6.0")}}, un elemento {{HTMLElement("canvas")}} con altezza o larghezza pari a zero veniva mostrato con le dimensioni predefinite.

[3] Prima di Gecko 12.0 {{geckoRelease("12.0")}}, se JavaScript è disabilitato, viene mostrato l'elemento {{HTMLElement("canvas")}} anziché il contenuto alternativo.

[4] Guarda il changelog di Opera 9.0.

[5] Anche se alcune vecchie versioni di Safari (fino alla 2.0) non richiedono il tag di chiusura, la specifica indica che è richiesto; quindi andrebbe usato per garantire la compatibilità con altri browser. Inoltre queste versioni di Safari mostrano sia il disegno che il contenuto alternativo, a meno che non si usi qualche trucco CSS per nasconderlo. Fortunatamente adesso gli utenti che usano queste versioni del browser sono molto rari.

Vedi anche

{{HTMLRef}}

Sorgente della versione

<p>L'elemento HTML&nbsp;<strong><code>&lt;canvas&gt;</code></strong>&nbsp;viene&nbsp;usato per disegnare tramite&nbsp;<a href="/it/docs/Web/JavaScript">JavaScript</a>. Per esempio, può essere usato per disegnare, modificare foto o creare animazioni. Si può (e si dovrebbe) fornire un contenuto alternativo all'interno del tag <code>&lt;canvas&gt;</code>: questo contenuto verrà visualizzato sia nei browser che non supportano questo elemento, sia nei browser con JavaScript disabilitato.</p>

<p>Per altri articoli sull'utilizzo di questo elemento, vedi la <a href="/it/docs/Web/API/Canvas_API">pagina riguardo i canvas</a>.</p>

<ul class="htmlelt">
 <li><dfn><a href="/it/docs/HTML/Content_categories">Categorie del contenuto</a></dfn> <a href="/it/docs/HTML/Content_categories#Flow_content">Contenuto di flusso</a>, <a href="/it/docs/HTML/Content_categories#Phrasing_content">contenuto testuale</a>, <a href="https://developer.mozilla.org/it/docs/HTML/Content_categories#Embedded_content">contenuto incluso</a>, contenuto tangibile.</li>
 <li><dfn>Contenuto permesso</dfn>Elementi trasparenti senza&nbsp;<a href="/it/docs/HTML/Content_categories#Interactive_content">contenuto interattivo</a>&nbsp;diverso dall'elemento {{HTMLElement("a")}}. Elementi&nbsp;{{HTMLElement("input")}} il cui attributo {{htmlattrxref("type", "input")}} è <code>checkbox</code>, <code>radio</code>, o<code>button</code>.</li>
 <li><dfn>Omissione del tag</dfn> {{no_tag_omission}}</li>
 <li><dfn>Elementi genitori permessi</dfn>Qualsiasi elemento che accetti&nbsp;<a href="/it/docs/HTML/Content_categories#Phrasing_content">contenuto testuale</a></li>
 <li><dfn>Interfaccia DOM</dfn> {{domxref("HTMLCanvasElement")}}</li>
</ul>

<h2 id="Attributi">Attributi</h2>

<p>Questo elemento accetta anche gli&nbsp;<a href="https://developer.mozilla.org/it/docs/HTML/Global_attributes">attributi globali</a>.</p>

<dl>
 <dt>{{htmlattrdef("height")}}</dt>
 <dd>L'altezza dell'elemento in pixels. Il valore predefinito è 150.</dd>
 <dt>{{htmlattrdef("moz-opaque")}} {{non-standard_inline}}</dt>
 <dd>Permette al browser di sapere se questo elemento userà la trasparenza. Se non, il browser può ottimizzare le performace durante il disegno.</dd>
 <dt>{{htmlattrdef("width")}}</dt>
 <dd>La larghezza dell'elemento in pixels. Il valore predefinito è 300.</dd>
</dl>

<h2 id="Descrizione">Descrizione</h2>

<h3 id="Richiede_il_tag_di_chiusura_&lt;canvas&gt;">Richiede il tag di chiusura&nbsp;<code>&lt;/canvas&gt;</code></h3>

<p>A differenza dell'elemento {{HTMLElement("img")}}, l'elemento {{HTMLElement("canvas")}}&nbsp;<strong>richiede</strong>&nbsp;il tag di chiusura (<code>&lt;canvas&gt;).</code></p>

<h3 id="Dimensioni_del'area_da_disegno">Dimensioni del'area da disegno</h3>

<p>Le dimensioni del'elemento possono essere cambiate usando i focli di stile. L'immagine viene&nbsp;ridimensionata durante il rendering per rientrare nella dimensione corretta. Se le dimensioni sembrano distorte, prova a specificare gli attributi&nbsp;<code>width</code> e <code>height</code>&nbsp;utilizzando gli attributi anziché il CSS.</p>

<h2 id="Esempi">Esempi</h2>

<pre class="brush: html">
&lt;canvas id="canvas" width="300" height="300"&gt;
  Mi dispiace, ma il tuo browser non supporta l'elemento &amp;lt;canvas&amp;gt;.
&lt;/canvas&gt;
</pre>

<p>Se il tuo disegno non ha trasparenza, usa l'attributo <code>moz-opaque</code>. Questa informazione può essere utilizzata per ottimizzare il rendering.</p>

<div class="warning">
<p>Questo attributo non è standard e funziona solo nei motori di rendering basati su Mozilla.</p>
</div>

<pre class="brush: html">
&lt;canvas id="mycanvas" moz-opaque&gt;&lt;/canvas&gt;</pre>

<h2 id="Specifiche">Specifiche</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specifica</th>
   <th scope="col">Stato</th>
   <th scope="col">Commento</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'the-canvas-element.html#the-canvas-element', '&lt;canvas&gt;')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>&nbsp;</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', 'the-canvas-element.html#the-canvas-element', '&lt;canvas&gt;')}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>Definizione iniziale</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilità_con_i_browser">Compatibilità con i browser</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Funzionalità</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>1.0</td>
   <td>{{CompatGeckoDesktop("1.8")}}<sup>[1]</sup><br />
    {{CompatGeckoDesktop("6.0")}}<sup>[2]</sup><br />
    {{CompatGeckoDesktop("12.0")}}<sup>[3]</sup></td>
   <td>9.0</td>
   <td>9.0<sup>[4]</sup></td>
   <td>2.0<sup>[5]</sup></td>
  </tr>
  <tr>
   <td><code>moz-opaque</code></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Funzionalità</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Android</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Supporto di base</td>
   <td>{{CompatGeckoDesktop("1.8")}}<sup>[1]</sup><br />
    {{CompatGeckoDesktop("6.0")}}<sup>[2]</sup><br />
    {{CompatGeckoDesktop("12.0")}}<sup>[3]</sup></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>1.0</td>
  </tr>
  <tr>
   <td><code>moz-opaque</code></td>
   <td>{{CompatGeckoMobile("1.9.1")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Prima di Gecko 5.0 {{geckoRelease("5.0")}} le dimensioni di questo elemento erano specificate utilizzando anche numeri negativi.</p>

<p>[2] Prima di Gecko 6.0 {{geckoRelease("6.0")}}, un elemento {{HTMLElement("canvas")}} con altezza o larghezza pari a zero veniva mostrato con le dimensioni predefinite.</p>

<p>[3] Prima di Gecko 12.0 {{geckoRelease("12.0")}}, se JavaScript è disabilitato, viene mostrato l'elemento {{HTMLElement("canvas")}} anziché il contenuto alternativo.</p>

<p>[4] Guarda il&nbsp;<a href="https://www.opera.com/docs/changelogs/windows/900/">changelog di Opera 9.0</a>.</p>

<p>[5] Anche se alcune vecchie versioni di Safari (fino alla 2.0)&nbsp;non richiedono il tag di chiusura, la specifica indica che è richiesto; quindi andrebbe usato per garantire la compatibilità con altri browser. Inoltre queste versioni di Safari mostrano sia il disegno che il contenuto alternativo, a meno che non si usi qualche trucco CSS per nasconderlo. Fortunatamente adesso gli utenti che usano queste versioni del browser sono molto rari.</p>

<h2 id="Vedi_anche">Vedi anche</h2>

<ul>
 <li><a href="/it/docs/Web/API/Canvas_API">MDN canvas portal</a></li>
 <li><a href="/it/docs/Web/API/Canvas_API/Tutorial">Canvas tutorial</a></li>
 <li><a href="https://simon.html5.org/dump/html5-canvas-cheat-sheet.html">Canvas cheat sheet</a></li>
 <li><a href="/it/demos/tag/tech:canvas">Canvas-related demos</a></li>
 <li><a href="https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/HTML-canvas-guide/Introduction/Introduction.html">Canvas introduction by Apple</a></li>
</ul>

<div>{{HTMLRef}}</div>
Ripristina questa versione