Text

The Text element is used to allow users to input or type content within an application. It provides a basic interface for collecting textual data from users, such as names, addresses, or comments. It can be customized to include various features such as icons or pre-filled values, enhancing both functionality and user experience.

Common Use Cases:

  • Form Inputs: Collecting user information (e.g., names, emails).
  • Displaying Static Information: Present fixed information.
  • Currency Entry: Enable precise input of monetary values.

Its Configuration

The configuration of the element in vFlow 2.0 allows you to customize its behavior, appearance, and interaction across various devices. Through simple settings, you can control everything from its visibility and functionality to how it adapts to different screen sizes, making it flexible and user-friendly for both developers and end-users. Let’s have a look at each of its configurations:

Basic

Basic ConfigurationDescription
TypeThe Type indicates the type of you are adding. In this case, it defaults to “Text” and cannot be changed here. This selection is made initially when you create element first-up.
Reference NameThe Reference Name is a unique identifier assigned to the element for internal use. This name is visible only to vFlow users, and is not displayed to end-users. The Reference Name is intended for your convenience, helping you easily identify and manage the element throughout.
LabelThe Label is the name or text displayed on the element, making it easily recognizable to end-users.
DescriptionThe Description field is intended for use by application designers or administrators (vFlow users) to provide additional context or details about the element. This description is not visible to end-users and is used solely for internal reference to assist with element management.

Properties

PropertiesDescription
MandatoryTo make this mandatory, select this checkbox.
Default ValueTo show a default value in the text field, enter the value here.
Custom Label
Leading Icon & TypeIt’s an option to add an icon or image before the element to indicate its purpose. You can select among None, IMAGE, and MATICON. You can also choose its Background and Text Colors.
Trailing Icon & TypeYou can add an icon or image after the element, enhancing the field’s visual guidance. You can select among None, IMAGE, and MATICON. You can also choose its Background and Text Colors.
TooltipAfter choosing the Leading or Trailing Icon, you can enter a text that is visible while hovering the mouse over the icon without cluttering the interface.
Count / Path of CountCount: This property allows you to display a numerical indicator next to the icon. It is useful for showing notifications, such as the number of unread messages or alerts.

Path of Count: You can specify a data path from which the count will be dynamically retrieved. This ensures that the displayed count reflects the current state of the data, making the interface more responsive and informative. You might set the Path of Count to something like getVal("user.unreadMessages"), which retrieves the current count of unread messages from the user object.
Read OnlySelecting this will display content without allowing user edits.
ParentChecking Parent will make this element a parent element, meaning it will take up the entire screen assigned to it until an event is performed. Once an event occurs, the screen will split to display both the parent element and the result of the action, providing a dynamic interface that adjusts based on user interaction.
Run As Invalid
Convert Currency to WordsSelect this checkbox to automatically convert numerical currency input into its word format.
PlaceholderEnabling this will display a hint or example text inside the field until the user enters their input.

After assigning all the properties, you can the changes.

Style

The Style option allows you to personalize the appearance of the element. This includes adjusting various visual aspects to ensure it complements your application’s overall design. Here’s a breakdown of different settings that you can make adjustments to:

  • Laptop/Desktop width: The button automatically expands to take up 100% of the available width on desktop and laptop screens, ensuring it spans the entire container. However, this width can be adjusted according to the specific design or layout requirements.
  • Tab width: On tablet devices, the button will also span 100% of the container’s width. This ensures that it adapts well to medium-sized screens, making it easier for users to interact with on touch devices. You can adjust this width as needed based on design preferences.
  • Mobile width: For mobile devices, the button remains at 100% width to ensure full visibility and easy tap interaction, even on smaller screens. Like the other devices, this width can be adjusted as per requirement.

Data Style

  • Background Color: To choose the background color for the element, you can use a color picker or enter a hexadecimal or RGB color code. The default opacity is set to 100%.

Font

  • Family: You can select the font family for text in the element. If no specific font is chosen, “None” will use the default font.
  • Size: You can specify the font size in pixels (px).
  • Color: You can set the font color using the color picker or a hexadecimal or RGB color code. The default opacity is 100%.
  • Alphabet Case: You can choose the text case (e.g., uppercase, lowercase) or select “None” to keep the original case.
  • Text Alignment: You can set the text alignment (e.g., left, center, right) or select “None” for default alignment.

Dimension

  • Height: You can define the height of the element in pixels (px) or percentage (%).
  • Maximum Height: You can set the maximum height to prevent the element from exceeding this limit.
  • Width: You can specify the width of the element in pixels (px) or percentage (%).
  • Maximum Width: You can define the maximum width to prevent the element from expanding beyond this size.

Spacing

  • Margin: To adjust the space around the element, enter values for top, right, bottom, and left margins in pixels (px). Default is 0px for all sides.
  • Padding: To set the internal space within the element, enter values for top, right, bottom, and left padding in pixels (px). Default is 0px for all sides.
  • Border Radius: To define the curvature of the corners of the element, enter values for top-left, top-right, bottom-right, and bottom-left in pixels (px). Default is 0px for all corners.
  • Custom CSS Class Name
    • Users can enter custom CSS class names in the provided input field to apply additional styles.
    • Multiple Classes Names can be provided, If needed. They can be applied by separating them with commas, as indicated by the example (classA, classB).

Note: You can provide the styling of both the label and data on the same style option.

Events

The Events option of the element allows you to assign task groups that will execute when specific actions occur on the element. These tasks can be created separately in the configurator or inventory and grouped to perform various actions when certain events are triggered.

Here’s a breakdown of the Events section:

  1. On Load:
    • This option lets you assign a task group that will execute automatically when the element is loaded.
    • This could be useful for initializing data or triggering other actions as soon as the element is displayed.
  2. Custom Load:
    • The Custom Load event enables you to trigger a specific task group during a customized loading scenario.
    • Similar to the previous options, you can choose the task group to be executed from the Select Task Group dropdown list or go back to the inventory or configurator to make a task or task group if needed.
  3. On Input:
    • This event allows you to assign a task group that is triggered whenever the user changes the input within the Text element.
    • It is helpful for performing real-time validation or triggering dependent actions based on user input.
  4. On Blur:
    • The On Blur event activates when the user moves focus away from the Text element.
    • This can be used for post-input validation or initiating actions after the user finishes interacting with the field.

After assigning the appropriate task groups to these events, click the button to apply your configuration to the element.

Animation

This option allows you to apply several animations to enhance the element’s loading appeal. The following are the available animations:

  • Bounce
  • Flash
  • Pulse
  • Rubber Band
  • Handshake

Their Configuration:
Click the TYPE list, and then select an animation to apply an effect when the element loads.

After you select one of the animations (for example, Bounce), you will see the following configuration options:

  • Speed: In this field, you can select one of the following options to adjust the speed of the animation:
    • Faster
    • Fast
    • Slower
    • Slow
  • Delay: Click this list to select a value (for example, 3 seconds). This value specifies a time period. The application will load the animation after this time period (e.g., 3 seconds).
  • Repeat: In this list, select a value (for example, 2). This value specifies the total number of times the application will play the animation.

After you configure the element’s animation properties, click to apply them to the element.

Data

The Data section of the Text element is crucial for defining how user inputs are validated and how data is sourced within the application. This section ensures that user inputs meet specific requirements, enhancing data integrity and improving user experience. It allows developers to set validation criteria, error messages, and data retrieval paths, thus enabling more robust and user-friendly applications.

Regex:

  • This field allows you to define a regular expression to validate the input.
  • If the input does not match the regex pattern, an error message can be triggered, ensuring the data conforms to specified formats.
  • Message on Regex Failure:
    • This option lets you specify a custom error message that will be displayed when the input fails the regex validation.
    • This helps inform users about the specific requirements for their input.

Max Length:

  • This field sets a maximum character limit for the input.
  • It prevents users from entering more characters than allowed, which can be crucial for data integrity.
  • Message on Max Length Failure:
    • Here, you can define a message that will appear if the user exceeds the maximum length specified.
    • This guidance helps users understand the input limitations.

Min Length:

  • This property establishes a minimum character requirement for the input.
  • It ensures that users provide sufficiently detailed information.
  • Message on Min Length Failure:
    • You can set a message that will show if the input does not meet the minimum length requirement.
    • This aids users in providing the necessary amount of information.

Minimum Value:

  • This field sets a lower boundary for numerical inputs, ensuring that users cannot enter values below a specified amount.
  • Message on Min Value Failure:
    • Specify an error message that will display if the user inputs a value lower than the minimum requirement.
    • This clarifies the expectations for numerical entries.

Maximum Value:

  • Similar to Minimum Value, this property defines an upper limit for numerical inputs.
  • Message on Max Value Failure:
    • This allows you to create an error message that appears if the input exceeds the maximum limit.
    • This reinforces proper data entry practices.

Data Source:

  • If you want to fetch and show some data in this element, select one of the data types that fits best for the business requirements:
  • Note: To learn more about Data, click here or check the post under configurator.

In the end, save it to apply the changes.

Was this article helpful?
YesNo