multiline-canvas-text
v2.0.1
Published
Render a string to canvas, breaking it up into multiple lines to fit the given width.
Downloads
6
Readme
multiline-canvas-text
Render a string to canvas, breaking it up into multiple lines to fit the given width.
install
npm install multiline-canvas-text
demo
Check out the interactive example.
usage
import { drawText } from "multiline-canvas-text";
const text = 'The quick brown fox jumps over the lazy dog';
const width = 40; // width in pixels to fit the text
const font = 'Arial'; // font should be available in the page
const fontSize = 20; // in pixels
const lineSpacing = 1; // vertical spacing between the lines
const color = 'white'; // can be any valid css color string: 'black', '#FFF', 'rgba(0,0,0,0.5)', etc
const strokeText = false; // true results in calling strokeText instead of fillText
const align = 'center'; // can be 'left', 'right' or 'center'
const result = drawText(text, width, font, fontSize, lineSpacing, color, strokeText, align);
element.appendChild(result.canvas);
The result object contains 3 properties:
canvas
: The generated canvas element with the rendered text. This canvas has the width that was given to thedrawText
method, but can obviously vary in height.lines
: An array that shows how the string was broken up into multiple lines, for example:["The quick brown", "fox jumps over", "the lazy dog"]
cursor
: if you are replicating an interactive textfield in canvas, you may want to add a blinking cursor to increase the user experience. Thecursor
property holdsx
andy
values for where to draw it. This value is not correct at the moment!