website logo
👥 Community🎯 Samples on GitHub🚦 System Status
💡 Guides
🚀 Examples
🍕 Developer Reference
⚡️ Changelog
🎥 Video Library
Navigate through spaces
⌘K
Overview
Reference
Actions
Data
UI
Widgets
Docs powered by
Archbee
Reference
UI

jc-number-field

31min

The schema defines the following properties:

Property

Type

Required

Description

type

component.number-field

true



instanceId

string

true



when

Expression | boolean

false



options

Number Field Options

true



instanceId (string, required)

when (Expression | boolean)

options (Number Field Options, required)

Properties of the options object:

Property

Type

Required

Description

isTextClearedOnFocus

boolean

false

If true, clears the text field automatically when editing begins.

isReturnKeyEnabledAutomatically

boolean

false

If true, the keyboard disables the return key when there is no text and automatically enables it when there is text. The default value is false.

keyboardType

enum<string>

false

Determines which keyboard to open. Default is numeric.

isSensitive

boolean

false

If true, the text input obscures the text entered so that sensitive text like passwords stay secure.

label

string | Expression | TextWithFormat | TextLocale

true

Label is displayed as placeholder when no value.

icon

icon-name | string

false

Trailing icon.

helperText

string | Expression | TextWithFormat | TextLocale

false

Helper text is displayed only when there is no errorText.

errorText

string | Expression | TextWithFormat | TextLocale

false

Text displayed when field's value is not valid. When not empty it displays isNegative style as well.

style

Date Picker Style

false

More of them can be true. It will be evaluated based on priority.

isAutoFocused

boolean

false

If true it will get focus immediately after it is displayed to user.

isRequired

boolean | string

false

True when the field is required. Useful when you use it in form submission.

isOptionalLabelHidden

boolean | string

false

If the field is optional you can turn off the "(optional)" label if you want.

isIgnored

boolean | string

false

When true, the field will be ignored when submitting the form.

isHidden

boolean | string

false

If true it will be hidden to user.

initialValue

string | number

false

Initial value of the relevant field. You can use this to preset value, so user doesn't need to add anything and use this "default".

value

string | number

false

The value to show for the field. Text field is a controlled component, which means the internal value will be forced to match this value prop if provided. In most cases, you don't need to use this.

onChange

keg-action-in-background

false

Action Keg component that will be triggered when value is changed

nextProperty

string

false

Name of the property you want to focus next in form when you use "submit" on virtual keyboard.

color

object[]

false

Changing color of field based on conditions. First evaluated to true will be used.

format

Number Format

false

Text Format of the value. Format is enabled only if field is configured to disabled. `style.isDisabled: true`

minimum

number | string

false

Limits the minimum number.

maximum

number | string

false

Limits the maximum number.

stepper

object

false



keyboardType (enum<string>)

Determines which keyboard to open. Default is numeric.

This element must be one of the following enum values:

  • numeric
  • number-pad
  • decimal-pad

label (string | Expression | TextWithFormat | TextLocale, required)

Label is displayed as placeholder when no value.

icon (icon-name | string)

Trailing icon.

The object must be any of the following types:

icon (icon-name)

icon (string)

helperText (string | Expression | TextWithFormat | TextLocale)

Helper text is displayed only when there is no errorText.

errorText (string | Expression | TextWithFormat | TextLocale)

Text displayed when field's value is not valid. When not empty it displays isNegative style as well.

style (Date Picker Style)

More of them can be true. It will be evaluated based on priority.

Properties of the style object:

Property

Type

Required

Description

isDisabled

boolean | string

false

Change style to disabled. User can't do anything with field when disabled.

isBusy

boolean | string

false

Displays spinner on right side of text field. It removes icon if any.

isPositive

boolean | string

false

Displays success icon on right side of text field.

flex

number

false

Flex property if rendered inside row

isDisabled (boolean | string)

Change style to disabled. User can't do anything with field when disabled.

The object must be any of the following types:

isDisabled (string)

isBusy (boolean | string)

Displays spinner on right side of text field. It removes icon if any.

The object must be any of the following types:

isBusy (string)

isPositive (boolean | string)

Displays success icon on right side of text field.

The object must be any of the following types:

isPositive (string)

isRequired (boolean | string)

True when the field is required. Useful when you use it in form submission.

The object must be any of the following types:

isRequired (string)

isOptionalLabelHidden (boolean | string)

If the field is optional you can turn off the "(optional)" label if you want.

The object must be any of the following types:

isOptionalLabelHidden (string)

isIgnored (boolean | string)

When true, the field will be ignored when submitting the form.

The object must be any of the following types:

isIgnored (string)

isHidden (boolean | string)

If true it will be hidden to user.

The object must be any of the following types:

isHidden (string)

initialValue (string | number)

Initial value of the relevant field. You can use this to preset value, so user doesn't need to add anything and use this "default".

The object must be any of the following types:

initialValue (string)

value (string | number)

The value to show for the field. Text field is a controlled component, which means the internal value will be forced to match this value prop if provided. In most cases, you don't need to use this.

The object must be any of the following types:

value (string)

onChange (keg-action-in-background)

Action Keg component that will be triggered when value is changed

color (object[])

Changing color of field based on conditions. First evaluated to true will be used.

The object is an array with all elements of the type object.

The array object has the following properties:

format (Number Format)

Text Format of the value. Format is enabled only if field is configured to disabled. style.isDisabled: true

minimum (number | string)

Limits the minimum number.

The object must be any of the following types:

minimum (string)

maximum (number | string)

Limits the maximum number.

The object must be any of the following types:

maximum (string)

stepper (object)

Properties of the stepper object:

Property

Type

Required

Description

isEnabled

boolean

true



value

number

true





Updated 25 Sep 2023
Did this page help you?
PREVIOUS
jc-media-field
NEXT
jc-pie-chart
Docs powered by
Archbee
TABLE OF CONTENTS
instanceId (string, required)
when (Expression | boolean)
options (Number Field Options, required)
keyboardType (enum<string>)
label (string | Expression | TextWithFormat | TextLocale, required)
icon (icon-name | string)
icon (icon-name)
icon (string)
helperText (string | Expression | TextWithFormat | TextLocale)
errorText (string | Expression | TextWithFormat | TextLocale)
style (Date Picker Style)
isDisabled (boolean | string)
isDisabled (string)
isBusy (boolean | string)
isBusy (string)
isPositive (boolean | string)
isPositive (string)
isRequired (boolean | string)
isRequired (string)
isOptionalLabelHidden (boolean | string)
isOptionalLabelHidden (string)
isIgnored (boolean | string)
isIgnored (string)
isHidden (boolean | string)
isHidden (string)
initialValue (string | number)
initialValue (string)
value (string | number)
value (string)
onChange (keg-action-in-background)
color (object[])
format (Number Format)
minimum (number | string)
minimum (string)
maximum (number | string)
maximum (string)
stepper (object)
Docs powered by
Archbee
Copyright © 2023 Jigx, Inc. All rights reserved. Terms of Service