RCSS Text

Librocket RCSS references
Syntax and basic data types
Selectors
Box Model
Visual Model
Visual Effects
Colors and backgrounds
Fonts
Text
Cursors, Dragging, and Tabbing
Decorators
Font Effects
Scrollbars and Sliders
Property Index

Alignment: the ‘text-align’ property

• text-align

Value:	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:	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:	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.