HELP
 / 
Data Input Blocks
 / 
Single Line Text

Single Line Text

This is some text inside of a div block.

This article explains the features of the Single Line Text block and how it can be used to design your app.

Single Line Text Block is used for:

1. Short Answers

2. Numbers

3. Emails

4. Phone Numbers5. URL

Editing the Single Line Text block

Click on the block and configure it by editing on the right panel.

Label

The label is the name of the block that the end user sees in the app.

Example: Company Name is written as the label and is saved.

Description

The description is the additional information provided to the end user which will be displayed below the input area.

Example: Enter the company name as in legal docs is written as the label and is saved. 

This is how the Single line text block with the label and the description will look to the end user.

Default value

This is the default value that you want to add so that the end user will see the pre-filled data and doesn’t need to input any data in the single line text block.

Required

Enable this option if you want the user to compulsorily input the data. If enabled, the end user can submit if and only if the data is entered in this field.

Show Advanced Options

Enable this option to show the advanced options to configure the single line text block.

Display this field if

Use this if you want to show or hide a field under certain conditions. It accepts the standard Clappia Formulae, similar to conditional sections.

  1. You can type ‘@’ to get a list of all the variables in the app and select variables.
  2. Using these variables you can write Excel-like formulae.

Example: For a Yes or No question, you can show the remarks field when the answer is No.

Allow value to be changed after initial submission

This option is enabled by default. End users can edit the value entered in this field after creating a submission. Disable it if you do not want the end users to edit the submitted value.

Example: A new submission has been created in the Customer Visit app. You do not want the customer's name and other details to be edited by anyone after the submission has been created.

You can also write a formula here to conditionally allow editing of the data in the block after submission.

Example: In the customer visit app, the customer email field should be editable if and only if the status of the submission is not equal to Confirmed or if the user is an admin.

Validation

Select the proper validation for the single line text block to receive specific input from the end user.

Validations of the Single Line Text block:

  1. None - The end user can enter anything in the single line text block.
  2. Number - The end user can enter only numerical values in the single line text block.
  3. Email - The end user can enter only email addresses in the single line text block.
  4. URL - The end user can enter only URLs in the single line text block.
  5. Custom - Add advanced validation conditions.

Custom Validation

Example: A single line text block is used and labeled as Quantity. You want the end user to enter the quantity of not more than 5 kgs in one go.

Custom validation condition

Type ‘@’ and select the quantity block and enter the condition as {quantity}<5.

Custom error message

Error! Please enter less than 5 kgs.

Here is how the final app will look if the user enters a value less than 5 in the "Quantity" field.