Customize layout and positioning of error messages of an adaptive form
CREATED FOR:
- User
- Developer
You can customize the layout and positioning of the error messages of an adaptive form. You can perform the following customizations:
- Customize the location and layout of the caption of a field without changing the corresponding CSS properties
- Customize the position of inline error messages
- Customize content of dynamic help indicator
- Customize the position of the field components (caption, widget, short description, long description, and help indicator components) without changing the corresponding CSS properties
Customize layout of fields
You can customize the layout of a single field or of all the fields to change the position of caption and error messages.
To apply a custom layout to a field, do the following:
Customize layout of a single field
-
Open the form in Style mode. To open the form in style mode, in the page toolbar select > Style.
-
In the sidebar, under Form Objects, select the field and select the edit button .
-
Select the state of the field that you want to customize, and specify the styling for that state.
Customize layout of all the fields of a form
With AEM Forms, you can now create a theme and apply it to your form. Theme editor lets you specify the styling of form components in one place. When you create a theme, you specify styling at a component level. For more information on themes, see Themes in AEM Forms.
Create a theme using Theme Editor to customize the layout of all fields in your form. After you create a theme, perform the following steps to apply it to a form:
- Open your form in edit mode.
- In the edit mode, select a component, then select > Adaptive Form Container, and then select .
- In the sidebar, under Adaptive Form Theme, select the theme you have created using the Theme Editor.
Create a custom field layout
-
Open CRXDE Lite. The default URL is https://‘[server]:[port]’/crx/de.
-
Copy a field layout from the /libs/fd/af/layouts/field node (For example, defaultFieldLayout) to the /apps node (For example, /apps/af-field-layout).
-
Rename the copied node and the defaultFieldLayout.jsp file. For example, errorOnRight.jsp.
-
Change the value of the qtip and jcr:description properties of the copied node. For example, change the value of the properties to Error On Right
-
To add new styles and behavior, create a client library in the /etc node.
For example, at the location /etc/af-field-layout-clientlib, create the node client-library. Add the categories property with value af.field.errorOnRight and style.less file with the following code:
.widgetErrorWrapper { height: 38px; margin: 5px; .guideFieldWidget{ width: 60%; float: left; } .guideFieldError{ overflow:hidden; width:40%; } }
-
To enhance the appearance and behavior, include the client library created in the layout file (errorOnRight.jsp).
-
Open the edit dialog box of the field and select the Styling tab. In the Configure Field Layout drop-down box, select the newly created layout, and click OK.
The ErrorOnRight.zip package contains code to show error messages on the right side of fields.