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 :

Chargement de polices avec l'API CSS Font Loading

A l'aide de l'API FontFace (en-US), 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

Spécification Statut Commentaire
HTML Living Standard
La définition de 'CanvasRenderingContext2D.font' dans cette spécification.		 Standard évolutif  

Compatibilité navigateurs

BCD tables only load in the browser

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