Error Display Details - This dropdown list is used to set how validation errors should be highlighted on this page.
There are three options to choose from:
None - Errors will not be highlighted.
Message Text - This option will show the error message as text either beside the field or at the top level (see below), as well as applying the style changes specified in the Error Highlighting Details page.
Message Tooltip - This option works in a similar way to the Message Text option above, but instead of always showing the error message, a
The Show Local Error Message? checkbox controls whether the error message will be shown beside each field or not. For example, this could be unchecked (in combination with the tooltipis used that will show the message when the mouse is hovered over the highlighted error field. For this option to work correctly, the skin must contain certain components as explained here.
Message Textoption above) if you want to highlight each field in error, but you don't want to provide the error message next to the field. The Show Popup Alert for Errors checkbox will cause a standard popup alert box to appear, listing down the error for erroneous fields. This can be done in conjunction with any of the error display methods mentioned above. This checkbox works in conjunction with the Validation Mode dropdown list right below it, in that users can set the popup alert to either show all errors (i.e. errors for all problematic fields), or for the first error only. Error Highlighting Styles - This section is used to control the appearance of the error message on the screen, using CSS. In each case, the first box (Class) should contain the name of the CSS class to use, which must be defined in the imported CSS file (see Page Details). Alternatively, the CSS Override option can be used to specify a CSS String (e.g.
background : red;) to apply. The Background styling will be applied to the container of the field element, whereas the Error Message styling is applied to the error message container element directly. For example, the background class could be used to provide a border around the field in error, whereas the error message class could set the colour or font of the displayed error message. Top-Level Message Details - These settings allow the error messages to be grouped together and displayed in one place. This can be used along with, or instead of a
Local Error Messagebased on the setting of the appropriate checkboxes. The Show Top Level Message? checkbox is used to turn this feature on or off. By default, this top-level message will be placed at the top of the screen, but it can be positioned and styled as required by specifying appropriate CSS classes or style overrides in the appropriate text boxes. The contents of the Message Override box, if entered, will be shown in this container instead of the default approach of showing a combined list of all the local error messages. Mark Mandatory Fields - This feature provides the option to automatically add an indicator against each field that is mandatory (as indicated by its constraints information).
The 'Apply Marker to Mandatory Fields? checkbox is used to turn this feature on, and then the following options are available:
Marker Location - This is used to indicate where the marker should be placed. There are four possible options available, before and after the label, and before and after the actual field control (eg the text box)
Marker Styling - The two styling fields can be used to apply specific styling to the marker, wherever it is placed. For example, you may want to make the text red. This can be done by specifying a particular CSS class to apply, or by entering the CSS settings directly.
Marker Text - This field is used to enter the actual content that will be used for the marker. A common approach is to use an asterisk (*) character, although if this is done, you need to ensure that it is explained somewhere on the page. It is also possible to leave this field empty if you are using CSS to insert an image as the marker.
Description Details - This allows users to add comments and any other details to the page.