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.