Image Rendering Reference

Navigation:

IndexGeneral InformationElementsUtilsExamples

The <text> Element


Description:

The text element specifies the properties for the containing text. The field element can contain multiple text elements. The text element's font properties are inheritated from the root image tag. In order to automatically fit multiple text elements into a field, leave out the y position attribute. The text then gets positioned one underneath the other (Note: be cautious with the auto-spacing attribute. In case of dynamic positioning the first text element uses the whole space of the field then.).

Multiple Occurrences allowed: true


Attributes

Name Description Inheritated Possible Values Default Value Examples
class A identifier of a CSS class. This identifier can be referenced via a CSS file. The same class identifier is meant to be used in multiple tags false String No default value css1
id A identifier of the tag. This identifier can be referenced via a CSS file. This identifier has to be unique false String No default value css1
font-family The name of the font to be used true A font name (e.g. Arial, Tahoma, Times New Roman, etc.) arial -
align Specifies the horizontal alignment of the element/text true left | right | center | justify left -
padding-bottom Specifies the padding in pixels from the bottom true A positive or negative integer value 0 -
padding-left Specifies the padding in pixels from the left true A positive or negative integer value 0 -
padding-right Specifies the padding in pixels from the right true A positive or negative integer value 0 -
padding-top Specifies the padding in pixels from the top true A positive or negative integer value 0 -
background-color The background color of the element true black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 transparent -
text-decoration Specifies a decoration for the given text (underline, overline, linethrough or none) true underline | linethrough | none none span1
font-size Specifies a set of font sizes separated by colon. The text will be rendered with the biggest possible (and specified) font size true A positive integer describing the font size in pt or multiple integers separated by a colon as alternative font seizes 12 -
font-style Specifies whether the text should be printed normal or italic true normal | italic normal -
font-weight Specifies whether the text should be printed normal or bold true normal | bold normal -
color The color of the element or the contained text true black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 black -
condense Automatically condenses text if it is too long using the best matching condense factor specified true One or more float numbers separated by a colon. 1.0 span1
line-spacing Sets the spacing between text lines in pixel (negative values decrease the line spacing) true A positive or negative integer value 0 list1
wrap Changes the line wrap of a text field. Normal: line wraps at spaces and dashes. None: no wrapped lines. true normal | none normal -
letter-spacing The letter-spacing attribute increases or decreases the space between characters in a text. true A possitive or negative float number 0.0 multiline1
superscript Used to superscript or subscript a text true superscript | subscript | normal normal span1
outline Specifies whether the text should be outlined or not true true|false false -
outline-color Specifies the color of the text's outline true black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 black -
outline-thickness Specifies the thickness of the text's outline true An non-negative integer value (>0) 1 -
outline-inside This value determines, whether the outline should be drawn to the inside or outside of the corresponding text true true|false false -
shadow Enables or disables the shadow true true|false false -
shadow-alpha The alpha value (transparency) of the shadow true A positive float number >= 0 and <= 1 0.5 -
shadow-color Sets the color of the shadow true black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 black -
shadow-size The size of the shadow in pixels true An non-negative integer value (>0) 2 -
shadow-blur Whether the shadow should be rendered with or without blur effect true true|false false -


Child Elements

#text | br | span | ul | ol

Examples