---
title: CanvasGradient
slug: Web/API/CanvasGradient
tags:
  - API
  - Canvas
  - CanvasGradient
  - Градиенты
  - Интерфейс
  - Справка
translation_of: Web/API/CanvasGradient
---
<div>{{APIRef("Canvas API")}}</div>

<p>Интерфейс <code><strong>CanvasGradient</strong></code> <span id="result_box" lang="ru"><span>представляет собой</span> <span>непрозрачный</span> <span>объект, описывающий</span> <span>градиент</span><span>.</span> <span>Он возвращается</span> <span>методами</span></span> {{domxref("CanvasRenderingContext2D.createLinearGradient()")}} и {{domxref("CanvasRenderingContext2D.createRadialGradient()")}}.</p>

<h2 id="Свойства">Свойства</h2>

<p><em>Representing an opaque object, there is no exposed property.</em></p>

<h2 id="Методы">Методы</h2>

<p><em>Не имеет наследованных методов.</em></p>

<dl>
 <dt>{{domxref("CanvasGradient.addColorStop()")}}</dt>
 <dd>Добавляет в градиент новый маркер, определяемый смещенем и цветом. <code>Если смещение входдит за пределы 0</code> и <code>1</code>, генерируется <code>INDEX_SIZE_ERR</code>. Если не удааётся обработать цвет как CSS {{cssxref("&lt;color&gt;")}}, генерируется <code>SYNTAX_ERR</code>.</dd>
</dl>

<h2 id="Характеристики"><span class="short_text" id="result_box" lang="ru"><span>Характеристики</span></span></h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col"><span class="short_text" id="result_box" lang="ru"><span>Характеристика</span></span></th>
   <th scope="col">Состояние</th>
   <th scope="col">Комментарий</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', "the-canvas-element.html#canvasgradient", "CanvasGradient")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Совместимость_с_браузерами"><span class="short_text" id="result_box" lang="ru"><span>Совместимость с браузерами</span></span></h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Свойство</th>
   <th>Chrome</th>
   <th>Edge</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Базовая поддержка</td>
   <td>4.0</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop("1.9.2")}} [1]</td>
   <td>9.0</td>
   <td>9.0</td>
   <td>3.1</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Свойство</th>
   <th>Android</th>
   <th>Edge</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Базовая поддержка</td>
   <td>2.1</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile("1.9.2")}} [1]</td>
   <td>{{CompatUnknown}}</td>
   <td>10.0</td>
   <td>3.2</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] До Gecko 5.0, (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2), указание некорректных значений при добавлении цветовых маркеров при вызове <code>addColorStop()</code> генерирует <code>SYNTAX_ERR</code> вместо <code>INDEX_SIZE_ERR</code>.</p>

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

<ul>
 <li>Методы создания в {{domxref("CanvasRenderingContext2D")}}.</li>
 <li>Элемент {{HTMLElement("canvas")}} и сзвязанный с ним интерфейс {{domxref("HTMLCanvasElement")}}.</li>
</ul>