База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLCanvasElement: ширина и височина на растерното изображение

`canvas.width` и `canvas.height` задават размера на растерното изображение, а не размера за показване в CSS. В 2D контекст дори присвояването на същата стойност изчиства рисунката и възстановява началното състояние.

Версия: Current web platform; runtime support varies

Синтаксис

canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;

canvas.width и canvas.height са свойства на елемента canvas, които могат да се четат и променят. Те отразяват едноименните HTML атрибути и задават ширината и височината на растерното изображение в пиксели. В HTML атрибутите посочвай неотрицателни цели числа. Ако атрибут липсва или не може да се прочете като такова число, се използва стойността по подразбиране 300 за ширина или 150 за височина. Тези свойства са част от уеб платформата, а не от ECMAScript.

canvas.style.width и canvas.style.height задават размера на елемента в оформлението на страницата, а не размерите на растерното изображение. Промяната само на CSS не засяга пикселите и рисунката. При уголемяване показаното изображение може да се замъгли, а при разтягане до други пропорции — да се изкриви.

При контекст 2d присвояването на който и да е от двата размера изчиства рисунката и връща същия контекст в състоянието му по подразбиране, дори стойността да е същата. Това включва текущия контур, трансформацията и стиловете. Задай размерите преди рисуване. Ако ги промениш по-късно, настрой отново необходимото състояние и прерисувай изображението.

Не приемай, че WebGL или WebGPU се държат като 2d. След transferControlToOffscreen() елементът служи само за показване на резултата. Присвояване на неговото свойство width или height предизвиква InvalidStateError. Задай размерите на обекта OffscreenCanvas.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
  const canvas = document.createElement('canvas');
  console.log(`Default: ${canvas.width} × ${canvas.height}`);

  canvas.width = 4;
  canvas.height = 2;
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable.');

  ctx.fillRect(0, 0, 1, 1);
  ctx.globalAlpha = 0.5;
  const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];

  canvas.style.width = '40px';
  canvas.style.height = '20px';
  console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);

  canvas.width = canvas.width;
  console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>

Резултат

Default: 300 × 150
After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5
After assignment: 4 × 2; pixel alpha 0; globalAlpha 1

Отвори HTML файла в браузъра и виж изхода в конзолата му. Елементът canvas не се добавя към страницата. След промяната в CSS пикселът остава непрозрачен (`255`); присвояването на същата ширина го изчиства (`0`) и връща `globalAlpha` на `1`.

Свързани уроци

  • JavaScript · Урок 26 · Средно · Версия: 3
  • JavaScript · Урок 27 · Средно · Версия: 3

Източници