CKTIS / JavaScript
HTMLCanvasElement: контекст за изчертаване и размери на растерното изображение
Избери контекст чрез `getContext()` и задай размерите на растерното изображение чрез `width` и `height`. За разлика от оразмеряването с CSS, присвояването в режим 2D изчиства изображението и възстановява началното състояние за рисуване.
Версия: Current web platform; runtime support varies
Синтаксис
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement е браузърен интерфейс, определен от стандарта HTML, а не от ECMAScript 2024. canvas.getContext(contextId, options) приема низов идентификатор и незадължителни настройки според режима. "2d" избира CanvasRenderingContext2D, "bitmaprenderer" избира ImageBitmapRenderingContext, "webgl" избира WebGLRenderingContext, "webgl2" избира WebGL2RenderingContext, а "webgpu" избира GPUCanvasContext. Наличността на режимите и настройките зависи от средата за изпълнение.
Първото успешно извикване определя режима на елемента. Повторно извикване със същия идентификатор връща същия обект, без да прилага нови настройки. Неподдържан или недостъпен режим, както и заявка за различен режим, връща null. След успешно извикване на transferControlToOffscreen() елементът служи като заместител: извикване на getContext() или присвояване на width или height предизвиква InvalidStateError.
canvas.width и canvas.height отразяват едноименните HTML атрибути. Те задават ширината и височината на растерното изображение като неотрицателни цели числа. При липсващ атрибут или грешка при разчитане се използва съответната стойност по подразбиране: 300 или 150. Промяна само на canvas.style.width или canvas.style.height променя размера на показване, а не разделителната способност на изображението; мащабирането може да го замъгли.
В режим 2D присвояването на който и да е размер, дори на текущата му стойност, изчиства растерното изображение и възстановява началното състояние за рисуване, включително текущия контур, трансформацията и стиловете, без да подменя обекта на контекста. Задавай размерите преди рисуване; след преоразмеряване възстанови нужното състояние и изчертай съдържанието отново. Не очаквай същото поведение в останалите режими.
Изчертаването на изображение от друг произход без подходящо разрешение чрез CORS може да доведе до загуба на статуса origin-clean. Тогава getImageData() предизвиква SecurityError; преоразмеряването на 2D растерното изображение изтрива съдържанието му, вместо да разкрие блокираните пиксели.
Примери
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
const canvas = document.createElement("canvas");
console.log(`${canvas.width}x${canvas.height}`);
canvas.width = 4;
canvas.height = 3;
console.log(`${canvas.width}x${canvas.height}`);
const ctx = canvas.getContext("2d");
if (ctx === null) throw new Error("2D canvas context unavailable");
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
console.log(canvas.getContext("2d") === ctx);
console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>Резултат
300x150 4x3 255 0.5 0 1 true true
Запази примера като HTML файл, отвори го в браузър и виж резултатите в конзолата за разработчици. Първите два реда показват размерите. Повторното присвояване на същата ширина променя алфа стойността на пиксела от `255` на `0` и връща `globalAlpha` от `0.5` на `1`. Двата резултата `true` показват, че контекстът остава същият и че различен режим се отхвърля.
Свързани уроци
- JavaScript · Урок 12 · Напреднало · Версия: 4
- JavaScript · Урок 33 · Напреднало · Версия: 4
- JavaScript · Урок 34 · Напреднало · Версия: 4