CKTIS / JavaScript
Canvas 2D: vulstijl, lijnstijl en lijndikte
`fillStyle` bepaalt de vulling, `strokeStyle` het uiterlijk van de omtrek en `lineWidth` de dikte ervan. Het zijn drie afzonderlijke eigenschappen van de Canvas 2D-tekenstatus.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space unitsfillStyle, strokeStyle en lineWidth zijn instantie-eigenschappen van een Canvas 2D-context, zoals ctx uit canvas.getContext("2d"). Ze horen bij een webplatform-API, niet bij ECMAScript, en zijn dus niet in elke JavaScript-omgeving beschikbaar. Een toewijzing op zichzelf tekent niets.
fillStyle bepaalt de vulling voor fill(), fillRect() en fillText(). strokeStyle bepaalt de lijnstijl voor stroke(), strokeRect() en strokeText(). Beide stijlen zijn aanvankelijk zwart en accepteren een CSS-kleur als tekenreeks, een CanvasGradient of een CanvasPattern. Bij een ongeldige kleurtekenreeks blijft de vorige waarde behouden. Bij het uitlezen krijg je de geserialiseerde kleur (niet per se de oorspronkelijke tekenreeks) of het toegewezen object. Wijzigingen aan dat object werken door in latere tekenbewerkingen.
lineWidth geeft de volledige lijndikte aan in eenheden van het coördinatenstelsel, niet noodzakelijk in schermpixels. De lijn ligt gecentreerd op het pad en schaling van de context kan de zichtbare dikte veranderen. De beginwaarde is 1. Gebruik een eindig getal groter dan nul: 0, negatieve getallen, Infinity, -Infinity en NaN worden genegeerd.
Deze eigenschappen gelden voor volgende tekenbewerkingen totdat ze veranderen of de toestand wordt hersteld of teruggezet. save() en restore() bewaren en herstellen de tekenstatus, niet het huidige pad of de pixels. Toewijzing van een patroon uit een afbeelding van een andere origin zonder CORS-toestemming kan het uitlezen van pixels blokkeren: getImageData() werpt dan SecurityError op.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
const canvas = document.createElement("canvas");
canvas.width = canvas.height = 32;
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
ctx.fillStyle = "#ff0000";
ctx.strokeStyle = "#0000ff";
ctx.lineWidth = 6;
ctx.lineWidth = 0;
ctx.fillRect(8, 8, 16, 16);
ctx.strokeRect(8, 8, 16, 16);
const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
console.log(`width: ${ctx.lineWidth}`);
console.log(`fill: ${rgba(16, 16)}`);
console.log(`stroke: ${rgba(6, 16)}`);
console.log(`outside: ${rgba(2, 16)}`);
})();
</script>Resultaat
width: 6 fill: 255, 0, 0, 255 stroke: 0, 0, 255, 255 outside: 0, 0, 0, 0
Sla het voorbeeld op als HTML-bestand en open het in een browser. Het canvas wordt niet aan de pagina toegevoegd: de code toont in de browserconsole de dikte en de RGBA-waarden in de vulling, op de omtrek en buiten de tekening. Toewijzing van `0` laat de dikte op `6` staan.
Gerelateerde lessen
- JavaScript · Les 12 · Gevorderd · Versie: 4