KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Canvas 2D: lijn, vulling, lettertype en basislijn

Stel de lijndikte en lijnstijl, de vulstijl, het lettertype en het verticale tekstanker in op een Canvas 2D-context.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const ctx = canvas.getContext("2d");
// After checking that ctx is not null:
ctx.lineWidth = 4;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
// Read any of these properties with ctx.propertyName.

lineWidth, strokeStyle, fillStyle, font en textBaseline zijn eigenschappen van de context die canvas.getContext("2d") teruggeeft, niet van het canvas-element zelf. Ze behoren tot de web-API’s, niet tot ECMAScript. Beschikbaarheid hangt af van de uitvoeromgeving en getContext() kan null teruggeven. Toewijzingen wijzigen de instellingen voor volgende tekenbewerkingen, niet de al getekende pixels. save() slaat de tekenstatus op en restore() zet die terug zonder de tekening of wijzigingen aan het huidige pad ongedaan te maken.

lineWidth bepaalt de lijndikte in eenheden van het canvascoördinatenstelsel; een schaaltransformatie kan de zichtbare dikte veranderen. De lijn ligt gecentreerd op het pad. De beginwaarde is 1. Nul, negatieve getallen, Infinity, -Infinity en NaN worden genegeerd.

strokeStyle bepaalt hoe contouren worden getekend, bijvoorbeeld door strokeRect() en strokeText(). fillStyle bepaalt hoe vlakken worden gevuld, bijvoorbeeld door fillRect() en fillText(). Beide accepteren een tekenreeks met een CSS-kleur, een CanvasGradient-object of een CanvasPattern-object. Beide beginnen met zwart. Een ongeldige kleurtekenreeks laat de vorige waarde staan.

font accepteert een tekenreeks in de verkorte CSS-syntaxis voor font, bijvoorbeeld "bold 20px sans-serif". De beginwaarde is "10px sans-serif". Ongeldige tekenreeksen worden genegeerd en line-height heeft hier geen effect. Als een lettertype niet beschikbaar is of nog niet is geladen, kiest de browser een vervangend lettertype. Het uiterlijk van de glyphs kan per omgeving verschillen.

textBaseline kiest het verticale referentiepunt dat fillText() en strokeText() op y plaatsen. "top", "middle" en "bottom" verwijzen naar de bovenkant, het midden en de onderkant van het em-vierkant van het lettertype, niet naar de randen van zichtbare glyphs. De overige opties zijn "hanging" (hangende basislijn), "alphabetic" (alfabetische basislijn, de standaard) en "ideographic" (onderste ideografische basislijn). Andere tekenreeksen worden genegeerd. Horizontale uitlijning stel je apart in met textAlign.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Canvas 2D drawing styles</title>
</head>
<body>
  <canvas id="demo" width="240" height="80"></canvas>
  <script>
    const canvas = document.getElementById("demo");
    const ctx = canvas.getContext("2d");
    if (!ctx) throw new Error("Canvas 2D is unavailable");

    const readStyles = () => [
      ctx.lineWidth, ctx.strokeStyle, ctx.fillStyle, ctx.font, ctx.textBaseline
    ].join(" | ");

    ctx.save();
    ctx.lineWidth = 4;
    ctx.lineWidth = 0;
    ctx.strokeStyle = "#1d4ed8";
    ctx.fillStyle = "#dbeafe";
    ctx.fillRect(10, 10, 220, 60);
    ctx.strokeRect(10, 10, 220, 60);

    ctx.fillStyle = "#172554";
    ctx.font = "20px sans-serif";
    ctx.textBaseline = "top";
    ctx.fillText("Canvas 2D", 22, 20);
    console.log(readStyles());

    ctx.restore();
    console.log(readStyles());
  </script>
</body>
</html>

Resultaat

4 | #1d4ed8 | #172554 | 20px sans-serif | top
1 | #000000 | #000000 | 10px sans-serif | alphabetic

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de ontwikkelaarsconsole. De eerste regel toont de waarden van vijf contexteigenschappen vóór `restore()`. De lijndikte blijft `4`, ondanks de toewijzing van `0`. Van de vijf getoonde eigenschappen gebruikt `strokeRect()` `lineWidth` en `strokeStyle` voor de contour van de rechthoek, terwijl `fillText()` `fillStyle`, `font` en `textBaseline` gebruikt. De tweede regel toont de teruggezette beginwaarden. De lichtblauwe rechthoek met blauwe contour en donkere tekst blijft zichtbaar.

Gerelateerde lessen

  • JavaScript · Les 26 · Gemiddeld · Versie: 3

Bronnen