The Articles in this section describes the basic functionality of RSForm Pro. We have included almost every component used in RS forms, so there shouldn't be any problem in finding the right one for you.Every component is defined with properties. A property describes a specific part of that components' behavior.
We can find general properties, found in all components (name and caption, for example) and some specific for every component (the possible values that should appear in a select list, for example).
Anatomy of a component
In this section, you'll learn about the parts that make a component. A component has four distinct parts:
- Caption: the text that describes shortly the component.
- Body: the actual component.
- Description: the components' extended description, as defined when creating the component.
- Validation: the validation message shown whenever the component doesn't comply with the desired validation rules or the required property. In RSForm! Pro 1.3.0(revision 32) the fields can be validated using AJAX validations. This way the fields will be verified in real-time, without re-loading the form. AJAX validations can be enabled from the Edit Form tab, when customizing your form.
Now that we know what a component looks like, let's see how you can insert these parts into your layout. We defined a simple placeholder system. The general rule used is:
{component_name:part_name}
Let's see a short example on how to integrate our components into the layout. Suppose you created a text box named "user_mail" and want it to be displayed in the layout. In order to do that, write this in the Form Layout section of RSForm!Pro
{user_mail:caption}
{user_mail:body}
{user_mail:description}
{user_mail:validation}
Note:
When adding components, you must always specify a unique, non-empty component name. The component name is essential, as almost every part in both front-end and back-end use the component name. In order to avoid problems, RSForm!Pro will not allow you to save a component that has no name (i.e. the Name property is empty) or if another component in the same form has the same name. Naturally, it will display an alert whenever you don't follow these rules.