User Guide
744 Chapter 6: Components Dictionary
Using styles with the TextInput component
The TextInput component has its
backgroundColor and borderStyle style properties defined
on a class style declaration. Class styles override global styles; therefore, if you want to set the
backgroundColor and borderStyle style properties, you must create a different custom style
declaration or define it on the instance.
A TextInput component supports the following styles:
Style Theme Description
backgroundColor
The background color. The default color is white.
border styles Both The TextArea component uses a RectBorder instance as its
border and responds to the styles defined on that class. See
“RectBorder class” on page 647.
The default border style is
"inset".
marginLeft
Both A number indicating the left margin for text. The default value
is 0.
marginRight
Both A number indicating the right margin for text. The default value
is 0.
color
Both The text color. The default value is 0x0B333C for the Halo
theme and blank for the Sample theme.
disabledColor
Both The color for text when the component is disabled. The default
color is 0x848384 (dark gray).
embedFonts
Both A Boolean value that indicates whether the font specified in
fontFamily is an embedded font. This style must be set to
true if fontFamily refers to an embedded font. Otherwise, the
embedded font will not be used. If this style is set to
true and
fontFamily does not refer to an embedded font, no text will be
displayed. The default value is
false.
fontFamily
Both The font name for text. The default value is "_sans".
fontSize
Both The point size for the font. The default value is 10.
fontStyle
Both The font style: either "normal" or "italic". The default value
is
"normal".
fontWeight
Both The font weight: either "none" or "bold". The default value
is
"none". All components can also accept the value "normal"
in place of "none" during a setStyle() call, but subsequent
calls to
getStyle() will return "none".
textAlign
Both The text alignment: either "left", "right", or "center". The
default value is
"left".
textIndent
Both A number indicating the text indent. The default value is 0.
textDecoration
Both The text decoration: either "none" or "underline". The default
value is
"none".