Overview
Sources
Libraries
Images API

Text Break text-break

Specify if text should be split into multiple lines when text-width and text-height are used.

Values

  • true or 1: text will be split into multiple lines.
  • false or false: text will not be split into multiple lines.

The default value for this parameter is true.

Examples

When text width and height are limited with text-width and text-height default behavior will be to split lines into multiple lines to accommodate them to the defined dimensions:

GET
https://assets.imglab-cdn.net/particles.jpeg?text-width=800&text-height=300&text-padding=20
Rendering text over image limiting it to 800 pixels wide with text-width using 800 as value, 300 pixels high with text-height using 300 as value and assigning a text-padding of 20.
x px

It is possible to disable multilines splitting using text-break=false:

GET
https://assets.imglab-cdn.net/particles.jpeg?text-width=800&text-height=300&text-break=false&text-padding=20
Rendering text over image limiting it to 800 pixels wide with text-width using 800 as value, 300 pixels high with text-height using 300 as value, assigning a text-padding of 20, and disabling multiline text with text-break parameter having false as value.
x px