CanvasRenderingContext2D.font

La propriété CanvasRenderingContext2D.font de l'API Canvas 2D API spécifie le style de texte à utiliser pour dessiner du texte. Cette chaîne utilise la même syntaxe que le spécificateur de police CSS. La police par défaut est 10px sans-serif.

Syntaxe

ctx.font = value;

Options

valeur

Une valeur DOMString analysée comme une valeur de font CSS. La police par défaut est 10px sans-serif.

Exemples

Utilisation de la propriété font

Ceci est seulement un fragment de code simple utilisant la propriéte font pour indiquer une taille de police et une famille de police différentes.

HTML

<canvas id="canvas"></canvas>

JavaScript

var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');

ctx.font = '48px serif';
ctx.strokeText('Hello world', 50, 100);

Modifiez le code ci-dessous et voyez vos changements mis à jour en temps réel dans le canevas :

<canvas id="canvas" width="400" height="200" class="playable-canvas"></canvas>
<div class="playable-buttons">
  <input id="edit" type="button" value="Edit" />
  <input id="reset" type="button" value="Reset" />
</div>
<textarea id="code" class="playable-code">
ctx.font = '48px serif';
ctx.strokeText('Hello world', 50, 100);</textarea>

var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');
var textarea = document.getElementById('code');
var reset = document.getElementById('reset');
var edit = document.getElementById('edit');
var code = textarea.value;

function drawCanvas() {
  ctx.clearRect(0, 0, canvas.width, canvas.height);
  eval(textarea.value);
}

reset.addEventListener('click', function() {
  textarea.value = code;
  drawCanvas();
});

edit.addEventListener('click', function() {
  textarea.focus();
})

textarea.addEventListener('input', drawCanvas);
window.addEventListener('load', drawCanvas);

Chargement de polices avec l'API CSS Font Loading

A l'aide de l'API FontFace, vous pouvez explicitement charger des polices avant de les utiliser dans un canevas.

var f = new FontFace('test', 'url(x)');

f.load().then(function() {
  // Prêt à utiliser la police dans un contexte de canevas
});

Spécifications

Compatibilité navigateurs

Notes spécifiques à Gecko

• Dans les navigateurs basés sur Gecko, tels que Firefox, une propriété non standard et désapprouvée ctx.mozTextStyle est implémentée en plus de cette propriété. Ne l'utilisez pas.

Notes relatives à Quantum

• Un bug (bug 1374885) a été corrigé avec Quantum et qui empêchait de récupérer la police d'un contexte lorsqu'une police système était utilisée. Cela a été corrigée avec Stylo qui a été publié avec Firefox 57.

Voir aussi

• L'interface la définissant, CanvasRenderingContext2D