---
title: HTMLCanvasElement.width
slug: Web/API/HTMLCanvasElement/width
translation_of: Web/API/HTMLCanvasElement/width
tags:
- API
- Canvas
- HTMLCanvasElement
- Свойство
---
<div>
    <div>
        <div>{{APIRef("Canvas API")}}</div>
    </div>
</div>

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

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

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

<pre class="brush: js"><var>var <em>pxl</em> = <em>canvas</em></var>.width;
<em>canvas</em>.width = <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.width); // 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-width",
            "HTMLCanvasElement.width")}}</td>
        <td>{{Spec2('HTML WHATWG')}}</td>
        <td>Нет изменений с последней версии {{SpecName('HTML5 W3C')}}</td>
    </tr>
    <tr>
        <td>{{SpecName('HTML5.1', "scripting-1.html#attr-canvas-width",
            "HTMLCanvasElement.width")}}</td>
        <td>{{Spec2('HTML5.1')}}</td>
        <td></td>
    </tr>
    <tr>
        <td>{{SpecName('HTML5 W3C', "scripting-1.html#attr-canvas-width",
            "HTMLCanvasElement.width")}}</td>
        <td>{{Spec2('HTML5 W3C')}}</td>
        <td>Версия {{SpecName('HTML WHATWG')}}, содержащая первоначальную реализацию.
        </td>
    </tr>
    </tbody>
</table>

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

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

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

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