NOTE! You are browsing legacy documentation. For latest visit docs.nativescript.org.

NativeScript Core

RadDataForm Overview

RadDataForm for NativeScript helps you edit the properties of a business object during runtime and build a mobile form fast and easy. All you have to do is set a business object as a value for the source property and RadDataForm will automatically generate editors for each property of the source object. RadDataForm offers built-in editors for each primitive type and also has various features to help you create your desired form.

Figure 1: How RadDataForm can look on Android (left) and iOS (right)

NativeScriptUI-DataForm-Overview-Android NativeScriptUI-DataForm-Overview-iOS

Getting Started

The following articles contains everything you need to know to start using RadDataForm. First, you need to provide the source object. Then you can describe the properties of the source in order to use the desired editors. Finally, you need to get the result from the user's input.

Editors

RadDataForm for NativeScript allows you to select a proper editor for each property of your source object and optionally customize it according to your preferences. You can start with the overview page of the editors which demonstrates their common usage. Then you can have a look at the complete list with available editors and if none of them fulfils your requirements, you can create your custom editors.

Groups

You can easily combine the editors in groups and optionally allow them to be collapsed. More information is available here. Once the editors are grouped, you can easily change the layout that is used for each group. More information is available here.

Validation

If you need to validate the user's input before it's committed, you can use some of the predefined validators. Here's more information about the validation in RadDataForm for NativeScript. This article contains the full list of available validators and if they are not enough you can create you custom validators. To control when the validation is performed you can change the validation mode. Here's more about the events that you can use to get notified when validation occurs.

Image Labels

You can easily add an image to each editor that hints for its purpose instead of the default text that is displayed for each editor. You can read more about the image labels here.

ReadOnly

If you need to use the form to simply show the content of the source object without allowing the user to edit the content you can make the form read only or just disable specific editors that shouldn't allow editing. You can read more here.

Styling

You can change the style of each of the editors of RadDataForm and also the style of the group headers if grouping is enabled. You can read more about the customization options here.