RCSS Text - Gambini/libRocket GitHub Wiki

Text

Alignment: the 'text-align' property

text-align | Value: | left | right | center | | Initial: | left | | Applies to: | block-level elements | | Inherited: | yes | | Percentages: | N/A |

This property affects how inline boxes within a line box are aligned. Values have the following meanings:

left:: The row of inline boxes are aligned against the left edge of the line box. right:: The row of inline boxes are aligned against the right edge of the line box. center:: The row of inline boxes are aligned in the centre of the line box.

Note that the 'justify' value is not yet supported in RCSS.

Decoration

Underlining: the 'text-decoration' property

text-decoration | Value: || none | underline | | Initial: | none | | Applies to: | all elements | | Inherited: | yes | | Percentages: | N/A ||

Values have the following meaning:

none:: Any text generated by this element has no additional decoration. underline:: Any text generated by this element has an underline, with a thickness and position specified by the font.

The colour of any decoration is the same as the font colour. Note that 'overline' and 'line-through' is not yet supported in RCSS.

Text shadows: the 'shadow' font effect

Instead of using the CSS-standard 'text-shadow' property, text-shadowing is implemented in libRocket using the more generic font effect system. Below is an example of how to specify a shadow for an element of text.

/* Specify a grey text shadow on primary headings. */
h1
{
    darken-font-effect: shadow;
    darken-offset: 2px 2px;
    darken-color: grey;
}

Whitespace: the 'white-space' property

white-space | Value: | normal | pre | nowrap | pre-wrap | pre-line | | Initial: | normal | | Applies to: | block-level elements | | Inherited: | yes | | Percentages: | N/A ||

This property defines how whitespace (any spaces, end-lines, carriage-returns and tabs) are processed in sections of text. Values have the following meanings:

normal:: Sequences of whitespace are collapsed down to single spaces. Lines are broken as necessary to fit line boxes. Line breaks in the source are ignored. pre:: Sequences of whitespace are preserved. Lines are only broken where line breaks are present in the source. nowrap:: Sequences of whitespace are collapsed. Lines are not broken. pre-wrap:: Sequences of whitespace are not collapsed. Lines are broken to fit line boxes or where line breaks are present in the source. pre-line:: Sequences of whitespace are collapsed. Lines are broken to fit line boxes or where line breaks are present in the source.