Mobile Element Properties

Valid Mobile Element Properties

Mobile elements can be configured with the following properties in order to modify their behavior within the mobile app.

Not all properties are valid on all element types, please review the valid types for each property before attempting to apply it within config.

Property	Description	Valid Element Types	Valid Values
hidden	Causes the element to be hidden in the user interface.	any	true false
required	Enforces that the element has a value before the current form can be submitted. Note that this cannot currently be set using dynamic expressions.	any	true false
readonly	Causes the element to appear as a read-only field that the user cannot interact with.	any	true false
disabled	Causes the element to appear as a disabled field that the user cannot interact with. This results in similar behavior to the read-only property but is visually a little different.	any	true false
value	Sets a value set in the element by default. This property is only evaluated if the current record does not yet exist or if set to change as part of a dynamic expression.	any	Varies by element type.
label	Sets the label of an element.	any	string (any)
type	Sets the type of the element	any	string (valid element types listed here)
column	Controls the position of this element when viewed in a table. An empty or null value means that this element will not be visible in it’s table view.	any	number (any)
parent	Sets the parent element (usually a table type element).	any	string (id of another element on the same form)
placeholder	Displays a placeholder value in the field up until the user enters their own value. Useful for providing additional guidance to the user regarding how the field should be completed.	select (multiselect) html (inlinehtml, richtext) textarea (help, longtext) email password tel text url	string (any)
pattern	This property can be set with a Regular Expression that will then be used to validate any input. Input that does not match the Regular Expression will be rejected with a message.	date datetime (datetimetz) time (timeofday) email password tel text url	string (valid regular expression)
min	Sets the minimum value allowed in this field. Any values entered that are less than this setting will be met with an error message. Fields that don’t meet their "min" requirement will stop the current form from being submitted.	date datetime (datetimetz) time (timeofday) number (float, integer, percent, currency)	number (any)
max	Sets the maximum value allowed in this field. Any values entered that are greater than this setting will be met with an error message. Fields that don’t meet their "max" requirement will stop the current form from being submitted.	date datetime (datetimetz) time (timeofday) number (float, integer, percent, currency)	number (any)
step	Controls the minimum increment this numeric field can increase/decrease by. The current form cannot be submitted unless the value in this field is a multiple of the step.	date datetime (datetimetz) time (timeofday) number (float, integer, percent, currency)	number (any)
precision	Controls the number of decimal places displayed in a numeric field.	number (float, integer, percent, currency)	number (integer)
unit	Controls the units (prefix/suffix) displayed in a numeric field. Custom units can be defined on top of the following default units: "usd" "percent" "byte" "celcius" "farenheit"	number (float, integer, percent, currency)	string (valid unit types)
stepper	Controls whether plus and minus buttons are added to the input to allow the user to increment and decrement the value	number (float, integer, percent, currency)	true false
cols	Sets the number of columns of text (characters) initially visible within this element.	html (inlinehtml, richtext) textarea (help, longtext)	number (integer)
rows	Sets the number of rows of text initially visible within this element.	html (inlinehtml, richtext) textarea (help, longtext)	number (integer)
maxlength	Sets the maximum length (in characters) of the string accepted as a value for this element.	html (inlinehtml, richtext) textarea (help, longtext) text	number (integer)
barcode	Enables a barcode scanner for use selecting from the available options from within the select/multi-select field.	select (multiselect) text	true false
remote	Controls whether the current element has it’s options stored locally or obtained remotely. If obtained remotely the options are only loaded on-demand and do require a working internet connection. Can be used in conjunction with the "search" property to enable the element to search for up-to-date records dynamically in NetSuite.	select (multiselect)	true false
options	Controls which options are available in the select element.	select (multiselect)	array of options
multiple	Controls whether more than one option can be selected in the current field.	select (multiselect)	true false
search	Enables a free-text search box for use filtering down the available options within the select/multi-select field.	select (multiselect)	true false
width	Sets the width (in units of px) of the element within the user interface.	signature	number (integer)
height	Sets the height (in units of px) of the element within the user interface.	signature	number (integer)
camera	This property controls whether the image field forces the user to take a new photo or even to use a specific camera (front/back).	image	false (file upload or camera allowed) true (camera only, file upload not allowed) "user" (the selfie camera only) "environment" (the front facing camera only)
accept	Controls which file types are accepted as values in this element. Acceptable file types are provided as a list of unique filetype specifiers as outlined here.	file (document) image	string (representing a list of unique filetype specifiers)
maxsize	Sets the maximum file size in KB. If the provided file exceeds this size an error message is displayed and the current form cannot be submitted.	file (document) image	number (integer)
downsample	Sets the maximum height/width (whichever is larger) in pixels of the image/file being uploaded. Images who’s largest dimension (height or width) is larger than this value will be compressed to have their largest dimension match this value.	file (document) image	number (integer)

General Notices