Number

Edit numeric value

Specs

Label	Value
Version	2.0.0 (updated on 2021-09-15)
Developer	Labii Inc.
Type	Column
Support Configuration	Yes
Support Readonly view	Yes
Support Edit view	Yes
Support Form view	Yes
Support Default value	Yes
Support Import	Yes
Allow multiple	Yes

Overview

The Number widget is designed to handle both the input and display of numerical values with precision and customization. It allows users to input any number while offering advanced formatting options, including decimal precision, separator marks, thousand separators, and the ability to add prefixes and suffixes. Additionally, it supports constraints to limit input within predefined ranges, providing warnings when a value falls outside these bounds. This widget ensures an enhanced user experience by enabling the manipulation and presentation of numbers with tailored formatting and validation, making it invaluable for applications where precise numerical data is critical.

Use case

1. Use this widget to collect age information and reject any value less than 0.

2. Use this widget to collect temperature information and add °C automatically.

Configuration

The widget functions seamlessly without any required configuration, but you can utilize the configuration options to apply additional constraints or custom formatting to the numbers as needed.

• Constraints - Sets constraints on the values that can be entered in a numeric field. The purpose of this feature is to prevent users from entering incorrect values.

  • Constraints (minimum) - Provides constraints on the minimum values that can be entered in a field.

  • Constraints (maximum) - Provides constraints on the maximum values that can be entered in a field.

• Warnings - A warning message will be displayed or the number will be flagged when the conditions below are met. The value entered here will be checked against the standards.

  • Warnings (greater than or equal to) - When the field value is greater than or equal to the provided value, a warning message will be raised.

  • Warnings (less than or equal to) - When the field value is less than or equal to the provided value, a warning message will be raised.

• Format - You can format the provided number, learn more here https://refreshless.com/wnumb/

  • Format (decimals) - The number of decimals to include in the result. Limited to 7.

  • Format (mark) - The decimal separator. Defaults to '.' if thousand isn't already set to '.'.

  • Format (thousand) - Separator for large numbers. For example: ' ' would result in a formatted number of 1 000 000.

  • Format (prefix) - A string to prepend to the number. Use cases include prefixing with money symbols such as '$' or '€'.

  • Format (suffix) - A string to append to a number. For example: 'mL'.

Example

Here's an illustration of concentration fields where the minimum value must be 0, and "ug/ul" is added to the end of the number.

{
    "constraints": {
        "min": 0
    },
    "format": {
        "suffix": " ug/ul"
    }
}

Views

See the interface of the widget in the following views.

Readonly view

Readonly view display the values of the column.

Edit view

The Edit view is the interface that allows you to modify the value.

Form view

The Form view is the field integrated into the add form for collecting values when creating a new record.

The Form view is same as the Edit view.

Data

Each widget in Labii stores data in a unique manner; refer below to understand how data from this widget is stored.

Data format

Number

Default value

The Default Value field within the column allows you to specify the default value when a record is created.

Default value can be any number.

Import value

The Import Value is the value you need to include in your Excel table for it to be imported into Labii.

Import value can be any number.