Skip to content

Percent

Overview

The Percent control supports entering a number as a percentage while still storing the number internally as its mathematical value. For example:

  • Enter 50 to represent 50% (stored as 0.5 in the DataPortal)
  • Enter 72.6 to represent 72.6% (stored as 0.726 in the DataPortal)

After entering a number it is then displayed formatted using Intl.NumberFormat.

Post-Populated Field

Required Fields

  • Name: The name of the field saved to the database. See here for details and restrictions.

  • Type: Can be any of the following types:

    • System.Double
    • System.Single
    • System.Decimal

  • ControlType: Must be set to Percent.

Optional Fields

  • FormattingLocale: The "locale" describing what cultural norms to use when formatting the number. If not provided or blank, defaults to United States English (en-us).
  • FormattingOptions: Options describing what formatting to apply to the number. The style property will be overwritten if provided and be set to percent.
  • Min: This defines the minimum possible numeric input into the Percent field. All input values below will display an error box to the user.
  • Max: This defines the maximum possible numeric input into the Percent field. All input values above will display an error box to the user.
  • DefaultValue: This defines the default value that is displayed to the user and stored in number representation on the database upon initialization.

Note: Min, Max, and DefaultValue should be the numeric representation of the number. For example for a max of 50%, Max should be set to 0.5.