Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member
One of the interesting things about canvas is that in addition to drawing shapes and curves and paths and so on, you can also draw text directly onto the canvas using a variety of text-drawing settings. In fact, drawing text is very similar to drawing any other paths. You can stroke them. You can fill them using the same fillStyle and strokeStyle as you would for other path operations and other shape operations. It's important to note that when you draw text on the canvas, it is not affected by any kind of CSS box model; it's just a path, and it's drawn using the canvas rules, not any CSS rules that you may have defined elsewhere in your document.
And it's also important to note that you shouldn't use text on the canvas as a replacement for regular document text, because that makes accessibility really, really hard. In fact, screen readers won't be able to read the text that you draw on the canvas. So if you have any grand ideas about using canvas to replace headings, like h1s or h2s and so on, it sounds like a great idea, but you probably should find another way to do that, because accessibility-wise, that's just not going to work for people who rely on assistive technologies.
So to draw a text on the canvas, we use some text-drawing properties and methods, and those are here. So we can set a couple of properties. First, you can set the font that you want to draw with, and anything that you would normally put into a font CSS rule can go in here. And then you can also set textAlign and textBaseline. textAlign can be either a start, which is the default, which is where the drawing point starts. There's end, and there's left, right, and center. For textBaseline, there's a couple of different settings. Some of these are pretty advanced, so I'm not going to go very deep into them. There's top.
There's middle or bottom, which you may be used to from regular HTML. But there's also things like ideographic and hanging, and those are mostly used for languages such as, for example, Chinese or Korean, where there's an ideographic baseline involved with particular characters and so on. The point is that the canvas does give you that kind of control over how text is drawn. Those three properties are available for setting how text is drawn. It's very similar to how you set fillStyle or strokeStyle for strokes and fills and so on.
Then the next few routines actually draw the text. So there's the fillText method, which renders the text string supplied by the txt argument-- that's the string that you want to draw-- at the point of x and y. And then this parameter here (maxW), that's optional, which is why it's in these brackets. If you specify a maxWidth, then the canvas will render that string no wider than this space right here. So it will compress the characters if it needs to, or do what it can do to make the string fit into that space.
And along with fillText, there's strokeText. Same idea here. You give it the text to stroke, you give it the point that you want the text to be drawn at, and an optional maximum width. And the last function, measureText, will return the dimension metrics of the string that you pass in using whatever the current font settings up here that you happen to pass in. So let's take a look at some text drawing examples in real code.
Okay, so here we are in the editor, and in my Text section of my ExampleSnippets, I'm going to open up the text_start example. And we're going to go back to the Snippets, and we'll copy some code over. So the first one is the string that we're actually going to draw, and we'll copy the first example and we'll paste that in, so we'll save. So this is a really simple example. I've got a string I want to render, and I'm just going to render it using whatever the default settings are for rendering text onto the canvas.
So let's save that, and let's go ahead and look at that in the browser. And you can see that it defaults to a pretty small text size, and it draws the text right at the point where I said to draw it about 10, 20, which is right up there. So let's go back to the code and do some more advanced stuff, and let's go back to the snippets. This time, let's draw the string with some font information. So we'll place that. So now on the drawing context, I've set the font to be 25pt Georgia, and now we're going to fill the text at a different point below the first one, and we'll see what effect that had. So we'll Refresh.
So you can see that now the text is being drawn in a much bigger font and a different font face. Let's keep on going. Go back to my Snippets, and this time we're going to fill it, but we're going to use a fillStyle color. So I'll copy these lines and paste them in there and save. So now we're using a blue fillStyle to fill the text, and let's see how that works. Okay, that was pretty cool. So this time same string, only different color now.
Let's go back to the code. Okay, now let's draw the string with both a stroke and a fill. We'll copy and we'll paste. So in this case, I have defined a font of 32pt Verdana. We've got a fillStyle, we've got a strokeStyle, and in this case, the strokeStyle is green at 80% opacity, and we're going to fill and stroke the text this time.
So let's do that. Okay, a little bit different effect there. Let's uncomment this line that sets the baseline, just to show you how setting the baseline works. So we'll save, and so here's the effect. When I Refresh, you can see that the text shifted down a little bit. So let's go ahead and put that back out again and refresh, get it back to what it was. And then finally, for the last example, let's use the measureText and let's put an exclamation point in here, just to show you how this works. And we'll go down here, and we'll copy the measureText, and I'll explain this.
Now, let's go down, and I'll paste it in. So in this case, we're going to call the measureText function, and when you call measureText on theString, which in this case has been set to the text string that we're using, it's going to take the current font settings and then measure how wide the text is. There's no built-in method to measure how tall the text is, but you can fake that up pretty easily by creating a fake span and putting the text inside the span and then using the CSS features available in your browser to see how high the span is, and that will tell you how high the text is. But there's no currently built-in way of doing that.
So this is a simple example. So we're just going to calculate the width. Now I'll come back here, and actually this comes back with an object that has a width property. So then we'll call beginPath, we'll set the strokeStyle to black, and then we're going to move to a point that's underneath the text string, and then we're going to create a line that is the width of the text at the same Y point. So I'm going to underline the text, and then we call stroke to fill that line in. So let's save, and let's refresh.
And you can see that in this case, now that I've modified the string with exclamation points, the text has changed. And we now have a black line going from the part where we started drawing the text down to where the character is. You can see that there's a little bit of space left over here, and the reason for that is because actually when you call the measureText function, the measureText result that comes back is not always exactly the same size as the text string. In fact, the specification that the W3C makes states that there is currently no way of finding out what the exact bounding box of the text currently is.
That might be added to a future version of the spec, but it's not there now. So the lesson to take away from this is there's currently not a way to measure exactly how wide a string is, in order to build something, say like a text editor using the canvas. They're looking at putting that in, but it's not there right now. Anyway, in this example we've seen how to draw text on the canvas using a variety of settings, strokes, colors, and fills. We've seen how to measure the width of the text, and we've seen how to draw text using both strokes and fills.
Get unlimited access to all courses for just $25/month.Become a member
82 Video lessons · 97381 Viewers
61 Video lessons · 84625 Viewers
71 Video lessons · 68826 Viewers
56 Video lessons · 101292 Viewers
Access exercise files from a button right under the course name.
Search within course videos and transcripts, and jump right to the results.
Remove icons showing you already watched videos if you want to start over.
Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.
Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.
Your file was successfully uploaded.