---
title: <canvas>
slug: Web/HTML/Element/canvas
tags:
  - Canvas
  - Element
  - HTML
  - HTML scripting
  - HTML5
  - Referencia
  - Web
translation_of: Web/HTML/Element/canvas
---
<p>L'<strong>element HTML &lt;canvas&gt;</strong> es pot utilitzar per dibuixar gràfics a través de seqüències d'ordres (normalment <a href="/en-US/docs/Web/JavaScript">JavaScript</a>). Per exemple, es pot utilitzar per dibuixar gràfics, fer composicions de fotos o fins i tot realitzar animacions. Pots (i has de) proporcionar contingut alternatiu dins del bloc <code>&lt;canvas&gt;</code>. Aquest contingut es representarà tant en navegadors antics que no suporten canvas com en navegadors amb  JavaScript desactivat.</p>

<p>Per a més articles sobre canvas, vegeu la <a href="/en-US/docs/Web/API/Canvas_API">pàgina del tema canvas</a>.</p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row"><a href="/en-US/docs/HTML/Content_categories">Categories de contingut</a></th>
   <td><a href="/en-US/docs/HTML/Content_categories#Flow_content">Contingut de Flux</a>, <a href="/en-US/docs/HTML/Content_categories#Phrasing_content">phrasing content</a>, <a href="https://developer.mozilla.org/en-US/docs/HTML/Content_categories#Embedded_content">Contingut incrustat</a>, contingut palpable.</td>
  </tr>
  <tr>
   <th scope="row">Contingut permès</th>
   <td>Transparent, però sense descendents de <a href="/en-US/docs/HTML/Content_categories#Interactive_content">continguts interactius</a> excepte per elements {{HTMLElement("a")}},  elements {{HTMLElement("button")}}, elements {{HTMLElement("input")}} que el seu atribut {{htmlattrxref("type", "input")}}  sigui checkbox, radio, o button.</td>
  </tr>
  <tr>
   <th scope="row">Omissió de l'etiqueta</th>
   <td>{{no_tag_omission}}</td>
  </tr>
  <tr>
   <th scope="row">Elements pares permesos</th>
   <td>Qualsevol element que accepti <a href="/en-US/docs/HTML/Content_categories#Phrasing_content">phrasing_content</a>.</td>
  </tr>
  <tr>
   <th scope="row">Interfície DOM</th>
   <td>{{domxref("HTMLCanvasElement")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Atributs">Atributs</h2>

<p>Aquest element inclou els <a href="https://developer.mozilla.org/en-US/docs/HTML/Global_attributes">atributs globals</a>.</p>

<dl>
 <dt>{{htmlattrdef("height")}}</dt>
 <dd><span id="result_box" lang="ca"><span>L'alçada</span> <span>de l'espai</span> <span>de coordenades en</span> <span>píxels</span> <span>de CSS.</span> <span>El</span> <span>valor per omissió</span> <span>és</span> <span>150</span><span>.</span></span></dd>
 <dt>{{htmlattrdef("moz-opaque")}} {{non-standard_inline}}</dt>
 <dd>Permet el llenç saber si la transparència serà un factor. Si el llenç sap que no hi ha transparència, el rendiment de la pintura pot ser optimitzat.</dd>
 <dt>{{htmlattrdef("width")}}</dt>
 <dd>L'amplada de l'espai de coordenades en píxels de CSS. El valor per omissió és 300.</dd>
</dl>

<h2 id="Descripció">Descripció</h2>

<h3 id="Etiqueta_&lt;canvas>_Requerida">Etiqueta <code>&lt;/canvas&gt;</code> Requerida</h3>

<p><span id="result_box" lang="ca"><span>A diferència</span> <span>de l'element</span> </span>{{HTMLElement("img")}}<span lang="ca"><span>, l'element</span> </span>{{HTMLElement("canvas")}}<span lang="ca"> <span>requereix</span> <span>l'etiqueta</span> <span>de tancament</span> <span>(</span><code><span>&lt;</span><span>/</span> <span>canvas</span><span>&gt;</span></code><span>)</span><span>.</span></span></p>

<h3 id="Dimensionament_del_llenç">Dimensionament del llenç</h3>

<p>La mida que es mostra del llenç es pot canviar fent servir un full d'estil. La imatge ha estat reduïda durant la representació per adaptar-se a la mida de l'estil. Si les seves representacions semblen distorsionades, intenta especificar els atributsdt <code>width</code> i <code>height</code>  de manera explícita en <code>&lt;canvas&gt;</code>, i no l'ús de CSS.</p>

<h2 id="Exemples">Exemples</h2>

<p>Aquest fragment de codi afegeix un element el llenç del teu document HTML. Un text alternatiu es proporcionat si un navegador és incapaç de representar el lleç, o si no pot llegir un llenç. És útil proporcionar un text alternatiu o sub DOM ajuda a que <a href="/en-US/docs/Web/API/Canvas_API/Tutorial/Hit_regions_and_accessibility">el llenç sigui més accessible</a>.</p>

<pre class="brush: html">&lt;canvas id="canvas" width="300" height="300"&gt;
  An alternative text describing what your canvas displays.
&lt;/canvas&gt; </pre>

<p>Si el llenç no utilitza la transparència estableix l'atribut moz-opaque a l'etiqueta canvas. Aquesta informació es pot utilitzar internament per optimitzar la representació. Tanmateix, aquest atribut no s'ha estandarditzat i només funciona en motors de renderitzat basats en Mozilla.</p>

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

<h2 id="Especificacions">Especificacions</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificació</th>
   <th scope="col">Estat</th>
   <th scope="col">Comentari</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> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', 'the-canvas-element.html#the-canvas-element', '&lt;canvas&gt;')}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>definició inicial</td>
  </tr>
 </tbody>
</table>

<h2 id="Navegadors_compatibles">Navegadors compatibles</h2>

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

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Suport bàsic</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>Característica</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Android</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suport bàsic</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] Abans de Gecko 5.0 {{geckoRelease("5.0")}} , l'amplada i l'alçada del llenç eran enters amb signe en lloc d'enters sense signe</p>

<p>[2] Abans de Gecko 6.0 {{geckoRelease("6.0")}} , un element , amb una amplada o l'alçada zero es representava com si tingués dimensions predeterminades.</p>

<p>[3] Abans de Gecko 12.0 {{geckoRelease("6.0")}}, si Javascript estava desactivat, l'element &lt;canvas&gt; es representava en lloc de mostrar el contingut de reserva segons<a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/the-canvas-element.html"> l'especificació</a>. Ara el contingut de reserva es representa en el seu lloc.</p>

<p>[4] Veura <a href="http://www.opera.com/docs/changelogs/windows/900/">la llista de canvis en Opera 9.0</a>.</p>

<p>[5] Tot i que les primeres versions del navegador Safari d'Apple no requerien l'etiqueta de tancament, l'especificació indica que s'exigeix, pel que ha de assegurar-se incloure-la per raons de compatibilitat més àmplia. Les versions de Safari (anteriors a la versió 2.0) podrán representar el contingut del recurs a més de la del pròpi llenç, a menys que utilitzi trucs CSS per emmascarar. Afortunadament, els usuaris d'aquestes versions de Safari són rars avui dia.</p>

<h2 id="Veure">Veure</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/Canvas_API">Portal MDN canvas</a></li>
 <li><a href="/en-US/docs/Web/API/Canvas_API/Tutorial">Tutorial Canvas</a></li>
 <li><a href="https://simon.html5.org/dump/html5-canvas-cheat-sheet.html">Full resum de Canvas</a></li>
 <li><a href="/en-US/demos/tag/tech:canvas">Demostracions relacionades amb Canvas</a></li>
 <li><a href="https://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/HTML-canvas-guide/Introduction/Introduction.html">Introducció de Canvas per Apple</a></li>
</ul>

<div>{{HTMLRef}}</div>