HTML5 <canvas>Справочное руководство


Описание

Тег <canvas> HTML5 используется для рисования изображений (с помощью скриптов, обычно JavaScript).

Однако сам элемент <canvas> не обладает возможностью рисования (он всего лишь контейнер для графики) - для выполнения фактического рисования необходимо использовать сценарии.

Метод getContext() возвращает объект, который предоставляет методы и свойства для рисования на холсте.

В этом руководстве представлен полный набор свойств и методов объекта getContext("2d"), с помощью которых можно рисовать текст, линии, прямоугольники, окружности и многое другое на canvas.


Поддержка браузеров

Internet Explorer Firefox Opera Google Chrome Safari

Internet Explorer 9, Firefox, Opera, Chrome и Safari поддерживают атрибуты и методы тега <canvas>.

Примечание:Internet Explorer 8 и более ранние версии IE не поддерживают элемент <canvas>.


Цвета, стили и тени

Свойства Описание
fillStyle Задает или возвращает цвет, градиент или шаблон, используемый для заливки рисунков.
strokeStyle Задает или возвращает цвет, градиент или шаблон, используемый для обводки.
shadowColor Задает или возвращает цвет, используемый для теней.
shadowBlur Задает или возвращает уровень размытия, используемый для теней.
shadowOffsetX Задает или возвращает горизонтальное расстояние между тенью и фигурой.
shadowOffsetY Задает или возвращает вертикальное расстояние между тенью и фигурой.

Методы Описание
createLinearGradient() Создает линейный градиент (применяется к содержимому canvas).
createPattern() Повторяет указанный элемент в указанном направлении.
createRadialGradient() Создает радиальный/круговой градиент (применяется к содержимому canvas).
addColorStop() Задает цвета и позиции остановок в объекте градиента.

Стили линий

Свойства Описание
lineCap Задает или возвращает стиль концевых точек линии.
lineJoin Задает или возвращает тип угла, создаваемого при пересечении двух линий.
lineWidth Устанавливает или возвращает текущую ширину линии.
miterLimit Устанавливает или возвращает максимальную длину скоса.

Прямоугольники

Методы Описание
rect() Создаёт прямоугольник.
fillRect() Рисует "заполненный" прямоугольник.
strokeRect() Рисует прямоугольник (без заливки).
clearRect() Очищает указанные пиксели внутри заданного прямоугольника.

Контуры

Методы Описание
fill() Заполняет текущий рисунок (контур).
stroke() Рисует заданный контур.
beginPath() Начинает путь или сбрасывает текущий путь.
moveTo() Перемещает путь к указанной точке на холсте, не создавая линию.
closePath() Создаёт путь от текущей точки обратно к начальной точке.
lineTo() Добавляет новую точку, затем создает линию на холсте от этой точки до последней указанной точки.
clip() Обрезает область любой формы и размера из исходного холста.
quadraticCurveTo() Создает квадратичную кривую Безье.
bezierCurveTo() Создаёт кубическую кривую Безье.
arc() Создаёт дугу/кривую (используется для создания окружностей или их частей).
arcTo() Создаёт дугу/кривую между двумя касательными.
isPointInPath() Возвращает true, если указанная точка находится в текущем пути, в противном случае возвращает false.

Преобразует

Методы Описание
scale() Масштабирует текущий рисунок, делая его больше или меньше.
rotate() Поворачивает текущий рисунок.
translate() Переназначает позицию (0,0) на холсте.
transform() Заменяет текущую матрицу преобразования рисунка.
setTransform() Сбрасывает текущее преобразование до единичной матрицы. Затем выполняет transform().

Текст

Свойства Описание
font Устанавливает или возвращает текущее свойство шрифта текстового содержимого.
textAlign Устанавливает или возвращает текущее выравнивание текстового содержимого.
textBaseline Устанавливает или возвращает текущую базовую линию текста, используемую при рисовании текста.

Методы Описание
fillText() Рисует "залитый" текст на холсте.
strokeText() Рисует текст на холсте (без заливки).
measureText() Возвращает объект, содержащий ширину указанного текста.

Рисование изображений

Методы Описание
drawImage() Рисует изображение, canvas или видео на canvas.

Пиксельные операции

Свойства Описание
width Возвращает ширину объекта ImageData.
height Возвращает высоту объекта ImageData.
data Возвращает объект, содержащий данные изображения указанного объекта ImageData.

Методы Описание
createImageData() Создает новый пустой объект ImageData.
getImageData() Возвращает объект ImageData, который копирует данные пикселей из указанного прямоугольника на холсте.
putImageData() Помещает данные изображения (из указанного объекта ImageData) обратно на холст.

Композиция

Свойства Описание
globalAlpha Устанавливает или возвращает текущее значение альфа-канала или прозрачности рисунка.
globalCompositeOperation Устанавливает или возвращает, как новые изображения рисуются поверх существующих изображений.

Другое

Методы Описание
save() Сохраняет состояние текущего контекста.
restore() Возвращает ранее сохранённое состояние пути и свойства.
createEvent()  
getContext()  
toDataURL()  
Другие расширения