Skin form — Components tab — Controls — Text inputs & Formatted text
Styles set here apply to the following types of text:
-
field text — text that a user types in a text input field (
pxTextInput) or a text area (pxTextArea) - placeholder text
- error text that displays on an input field
- character counter text
- read-only text
- purpose-specific fields
You can define the Standard style or create additional style formats.
A preview of the currently selected format displays to the right. You can also preview formats by clicking Run in the toolbar and selecting one of the following preview options: Run Process, Open Portal, Harness Preview, UI Gallery Preview, Skin Preview. In the Skin Preview, select the Controls tab.
| Same formatting for Field, Error, Remaining Counter, and Read-Only Text | Applies the same settings to Field, Error, Remaining Counter, and Read-Only Text. Clear this check box to define styles for each of these elements individually. Additional fields appear. |
At run time, Error Text displays above the input field only if the value of
Display Field-Level Errors
, on the
Display Options
tab of the harness rule, is set to
Displayed as Full Error Text. To see this in the Skin Preview, click in the
Input
field in the top panel, and then click a tab. If the value of
Display Field-Level Errors
in the harness rule is set to
Displayed as Image with Tooltip, then the error message displays as tooltip using styles set in
General>Errors. See
Skin form Components tab General Errors.
Define the appearance of the text for Field Text, Error, Remaining Counter (for text area controls only), and Read-Only Text.
Text
| Use mixin |
|
| Specify styles |
Select this check box to define a custom text format:
|
Placeholder Text Color
| Color | Enter a hexadecimal value (such as #3d3d3d) or click the box next to the field to Color Picker for the placeholder text. Use the Placeholder setting in the control parameters dialog to specify the text that appears. |
Border and Background
Define the border and background of Field and Error.
| Use browser styles for border and background |
To take advantage of styling features built into browsers (suggested), select this check box.
Clear this check box to override the browser styles and specify settings for field and error borders and backgrounds. Additional fields display. |
Field Border and Error Border
As a best practice, select the Use browser styles for border and background check box to take advantage of styling features built into browsers, rather than specifying border styles.
| Use mixin | If desired, you can specify the Top , Left , Right , or Bottom border as none, solid, dashed, or dotted, rather than inheriting the style from the selected mixin. |
| Specify styles | You can specify a custom border by selecting or clearing the Apply to all sides check box:
The following border styles are available:
|
Field Background and Error Background
As a best practice, select the Use browser styles for border and background check box to take advantage of styling features built into browsers, rather than specifying background styles.
| Use mixin | |
| Specify styles |
Select this check box to define a custom background:
Select the background Type:
|
Input states
Use the options in this section to style the control based on its state. You can style the control differently when it is in one of the following states:
- :hover – State of the control when a user points to the control or rests the pointer on the control.
- :focus – State of the control when the field is in focus, for example, the state of a text field when it is ready to accept inputs.
- :active – State of the control when the field is ready to be activated, for example, when a user has clicked the control but has not yet released the mouse button.
- Auto – Select this option to apply auto-generated styles for the control in this state. These styles are generated based on the applied control format and the mixins defined within the format.
- Default – Select this option to apply the default browser styles for the states instead of generating the styles based on a skin or defined CSS in the application.
- Custom – Select this option to define your own styles for the element in this state.
- Create a custom text input and formatted text format
You can create custom text input formats that you can apply within your application.
- Applying a custom text input and formatted text format
- Component styles (custom style formats)
Use the Component styles tab to define the presentation of components by creating custom style formats. After you define style formats, reference them on property panes for sections, harnesses, and controls.
Previous topic Skin form — Components tab — Controls — Split/menu button Next topic Creating a custom text input and formatted text format