Contents

fillText

Draws a line of text at the specified x,y coordinates, optionally scaled to a specified maximum width.

Declaration

void fillText(
    DOMString text, 
    unrestricted float x, 
    unrestricted float y, 
    optional unrestricted float maxWidth
);

Parameters

  • text:

    A string containing the text to draw.

  • x:

    The x-coordinate of the textAlign point (the left edge, right edge, or center of the text).

  • y:

    The y-coordinate of the textBaseline point.

  • maxWidth:

    The maximum width of the string, in pixels. This parameter is optional. If omitted, the current font size is used and text is clipped if it falls outside the canvas’s clipping region. If a maximum width is specified, the font size is scaled down if necessary to fit the text inside the specified width.

Discussion

Text is rendered in the current font, with the current textBaseline aligned with the y-coordinate and the current textAlign point (left, center, or right) aligned with the x-coordinate. The x, y, and maxWidth parameter values are in the canvas’s current coordinate system, subject to the current transformation matrix (rotation, scale, and so on).

See Also

Drawing Text