CKTIS / JavaScript
HTMLCanvasElement: контекст за рисуване и размери
HTMLCanvasElement предоставя повърхност за рисуване в браузъра. Научете как да използвате getContext(), width и height. При 2D контекст задаването на стойност на някое от двете свойства изчиства рисунката и връща контекста в началното му състояние, дори стойността да не се променя.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement представя елемент canvas в браузъра. Самият елемент съдържа повърхността за рисуване; контекстът предоставя операциите за рисуване. Това е Web API, а не част от ECMAScript. Наличието на Node 24 в хранилище не доказва, че този API е наличен.
Извикайте HTMLCanvasElement.getContext върху екземпляр като canvas.getContext("2d"), за да получите CanvasRenderingContext2D. Незадължителен втори аргумент задава настройките на контекста. Проверете резултата: методът връща null, ако типът не се поддържа, ако елементът вече има друг режим на контекста или ако създаването на контекста е неуспешно. Например дори при поддържан тип контекст на WebGL извикване с включена опция failIfMajorPerformanceCaveat може да върне null, а повторно извикване върху същия елемент с изключена опция може да успее. След успешно създаване на контекста следващите извиквания върху същия елемент със същия тип контекст връщат същия обект. След прехвърляне на управлението чрез transferControlToOffscreen() методът хвърля InvalidStateError.
HTMLCanvasElement.width и HTMLCanvasElement.height отразяват атрибутите за размери и определят размера на вътрешната повърхност за рисуване. Стойностите им по подразбиране са съответно 300 и 150. Размерът на показване, зададен чрез CSS, е отделен: той мащабира изображението и може да го направи размазано или изкривено.
При 2D контекст задаването на стойност на width или height изчиства повърхността, премахва текущия път и връща настройките на контекста, включително fillStyle, към стойностите им по подразбиране. Това важи дори когато се задава текущата стойност. Задайте размерите, преди да настроите 2D контекста и да започнете да рисувате. След преоразмеряване възстановете състоянието и нарисувайте съдържанието отново. Преоразмеряването на буфера за рисуване на WebGL не връща контекста на WebGL в началното му състояние. След прехвърляне на управлението към OffscreenCanvas чрез transferControlToOffscreen() задаването на стойност на width или height на първоначалния елемент води до изключение InvalidStateError. Основният API е широко достъпен в браузърите, но поддръжката на отделни типове контексти и опции варира.
Примери
(() => {
const canvas = document.createElement("canvas");
console.log(canvas.width, canvas.height);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext("2d");
if (ctx === null) {
throw new Error("2D context unavailable");
}
console.log(canvas.getContext("2d") === ctx);
ctx.fillStyle = "#ff0000";
ctx.fillRect(0, 0, canvas.width, canvas.height);
canvas.width = canvas.width;
console.log(canvas.width, canvas.height, ctx.fillStyle);
})();Резултат
300 150 true 4 2 #000000
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.