Multi-line Text

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

Use Cases

1. Long Answers

2. Address

3. Comments

4. Remarks

5. Notes

Editing the 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 Address 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 registered address of the company’, is written as the label and is saved. 

Placeholder Text

This text appears inside the multi-line text block. This is used to give the end user an idea about what kind of details should be entered or how to input the specific data in the multi-line text block.

Example: Street, Road, Building Number, City - Pin code, State - Country

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

‍

‍

‍

‍

‍

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.

Voice to Text Conversion

The Multi-line Text block supports voice-to-text conversion, currently available only in the web app when using Google Chrome. This feature leverages Chrome's built-in microphone support to transcribe spoken words into text.

In ‘App Home’, click the microphone icon at the corner of the Multi-line Text box to start recording. To stop recording, click the icon again. The transcribed text will then appear in the text box. You can edit this text manually if needed.

Upon clicking the icon for the first time, your browser may prompt you to allow microphone access. Ensure you click "Allow" to enable this feature.

Microphone Access Issues: If the recording feature isn't working, verify that Chrome has permission to access your microphone.

The transcribed text is captured in the language set in the browser. For example, if the browser language is set to Arabic, spoken Arabic will be accurately transcribed, but any words spoken in, say English, might not be captured correctly and may be transcribed as similar-sounding Arabic words. Ensure your browser language matches the language you intend to speak for optimal accuracy.

Advanced Options

Use this option to show the advanced options to configure the multi-line text block.

Display this field if

Use this option to show or hide the field under specific conditions. It accepts the standard Clappia formulae, similar to conditional sections or in the ‘Calculations & Logic’ block.

1. Type @ to get a list of all the fields you have added in the app and select the relevant field or type @ followed by the field name.
2. Use these field variables to write spreadsheet-like formulae for conditional display of the field in the app.

Retain value if hidden

This option appears once a condition is set in the Display this field if option. Enable this setting if you want the field's value to be retained even when the field is hidden. This is useful for preserving user input in cases where the field may temporarily disappear based on conditions.

Example: If the field is hidden based on user selection but you still need to keep the entered value for future reference or calculations, enable this option to ensure the data is retained.

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 address should be editable if and only if the status of the submission is not equal to Confirmed or if the user is an admin. 

Width of the block

Desktop View: Set the width of the Multi-line text block in the desktop view. Options are 100%, 75%, 50%, or 25%.

Mobile View: Set the width of the Multi-line text block in the mobile view. Options are 100% or 50%.