---
title: HTMLCanvasElement.height
slug: Web/API/HTMLCanvasElement/height
translation_of: Web/API/HTMLCanvasElement/height
tags:
- API
- Canvas
- HTMLCanvasElement
- Property
---
<div>
    <div>
        <div>{{APIRef("Canvas API")}}</div>
    </div>
</div>

<p>Свойство <strong><code>HTMLCanvasElement.height</code></strong> — это положительное
    <code>целое число</code>, отображающее значение HTML атрибута {{htmlattrxref("height", "canvas")}} элемента {{HTMLElement("canvas")}} в CSS пикселях. Если атрибут не указан или
    для него задано недопустимое значение, например отрицательное, то используется значение по умолчанию <code>150</code></p>

<p>Одно из двух свойств (другое — {{domxref("HTMLCanvasElement.width")}}), контролирующих размер холста.</p>

<h2 id="Syntax">Синтаксис</h2>

<pre class="brush: js"><var>var <em>pxl</em> = <em>canvas</em></var>.height;
<em>canvas</em>.height = <em>pxl</em>;
</pre>

<h2 id="Examples">Примеры</h2>

<p>Возьмём следующий {{HTMLElement("canvas")}} элемент:</p>

<pre class="brush: html">&lt;canvas id="canvas" width="300" height="300"&gt;&lt;/canvas&gt;
</pre>

<p>Вы можете получить высоту холста следующим образом:</p>

<pre class="brush: js">var canvas = document.getElementById('canvas');
console.log(canvas.height); // 300
</pre>

<h2 id="Specifications">Спецификации</h2>

<table class="standard-table">
    <tbody>
    <tr>
        <th scope="col">Спецификация</th>
        <th scope="col">Статус</th>
        <th scope="col">Комментарий</th>
    </tr>
    <tr>
        <td>{{SpecName('HTML WHATWG', "scripting.html#attr-canvas-height",
            "HTMLCanvasElement.height")}}</td>
        <td>{{Spec2('HTML WHATWG')}}</td>
        <td>Нет изменений с последней версии {{SpecName('HTML5 W3C')}}</td>
    </tr>
    <tr>
        <td>{{SpecName('HTML5.1', "scripting-1.html#attr-canvas-height",
            "HTMLCanvasElement.height")}}</td>
        <td>{{Spec2('HTML5.1')}}</td>
        <td></td>
    </tr>
    <tr>
        <td>{{SpecName('HTML5 W3C', "scripting-1.html#attr-canvas-height",
            "HTMLCanvasElement.height")}}</td>
        <td>{{Spec2('HTML5 W3C')}}</td>
        <td>Версия {{SpecName('HTML WHATWG')}} содержит исходное определение.
        </td>
    </tr>
    </tbody>
</table>

<h2 id="Browser_compatibility">Поддержка браузерами</h2>

<p>{{Compat("api.HTMLCanvasElement.height")}}</p>

<h2 id="See_also">Смотрите также</h2>

<ul>
    <li>Интерфейс {{domxref("HTMLCanvasElement")}}.</li>
    <li>Другое свойство, контролирующее размер холста
        {{domxref("HTMLCanvasElement.width")}}.</li>
</ul>