--- title: HTMLCanvasElement.height slug: Web/API/HTMLCanvasElement/height tags: - API - Canvas - HTMLCanvasElement - Propriedade - altura translation_of: Web/API/HTMLCanvasElement/height ---
{{APIRef("Canvas API")}}

A propriedade HTMLCanvasElement.height é um inteiro positivo que reflete o atributo {{htmlattrxref("height", "canvas")}} do elemento HTML {{HTMLElement("canvas")}} interpretado em pixels no CSS. Quando o atributo não é especificado, ou se for definido como um valor inválido, como um inteiro negativo, o valor padrão de 150 será usado.

Essa é uma de duas propriedades, que controla o tamanho do canvas, sendo a outra {{domxref("HTMLCanvasElement.width")}}.

Sintaxe

var pxl = canvas.height;
canvas.height = pxl;

Exemplos

Dado este elemento {{HTMLElement("canvas")}}:

<canvas id="canvas" width="300" height="300"></canvas>

Você pode capturar a altura do canvas com o seguinte código:

var canvas = document.getElementById('canvas');
console.log(canvas.height); // 300

Especificações

Specification Status Comment
{{SpecName('HTML WHATWG', "scripting.html#attr-canvas-height", "HTMLCanvasElement.height")}} {{Spec2('HTML WHATWG')}} No change since the latest snapshot, {{SpecName('HTML5 W3C')}}
{{SpecName('HTML5.1', "scripting-1.html#attr-canvas-height", "HTMLCanvasElement.height")}} {{Spec2('HTML5.1')}}  
{{SpecName('HTML5 W3C', "scripting-1.html#attr-canvas-height", "HTMLCanvasElement.height")}} {{Spec2('HTML5 W3C')}} Snapshot of the {{SpecName('HTML WHATWG')}} containing the initial definition.

Compatibilidade com navegadores

{{Compat("api.HTMLCanvasElement.height")}}

Veja também