The FieldInfoFormat
class is used with numerical or date fields to provide more detail
about how the value should be displayed in a popup. Use this class in place of the legacy
formatting functions: DateString
, DateFormat
, and/or NumberFormat
.
When formatting Number
fields, you must set both the digitSeparator
and places
properties for the formatting to take effect.
- See also:
let fieldInfo = new FieldInfo({
fieldName: "PROMINENCE_ft",
label: "Prominence (feet)",
//autocasts to FieldInfo.Format
format: {
places: 0,
digitSeparator: true
}
};
Constructors
-
new FieldInfoFormat(properties)
-
Parameter:properties Objectoptional
See the properties for a list of all the properties that may be passed into the constructor.
Property Overview
Name | Type | Summary | Class | |
---|---|---|---|---|
String | more details Used only with | more details | FieldInfoFormat | |
String | more details The name of the class. | more details | Accessor | |
Boolean | more details Used only with | more details | FieldInfoFormat | |
Number | more details Used only with | more details | FieldInfoFormat |
Property Details
-
dateFormat String
-
Used only with
Date
fields. Specifies how the date should appear in a popup.Possible Values
Format Date Formatting default 12/31/1969, 19:00 short-date 12/31/1969 short-date-short-time 12/31/1969, 7:00 PM short-date-short-time-24 12/31/1969, 19:00 short-date-long-time 12/31/1969, 7:00:00 PM short-date-long-time-24 12/31/1969, 19:00:00 long-month-day-year December 31, 1969 long-month-day-year-short-time December 31, 1969, 7:00 PM long-month-day-year-short-time-24 December 31, 1969, 19:00 long-month-day-year-long-time December 31, 1969, 7:00:00 PM long-month-day-year-long-time-24 December 31, 1969, 19:00:00 day-short-month-year Dec 31, 1969 day-short-month-year-short-time Dec 31, 1969, 7:00 PM day-short-month-year-short-time-24 Dec 31, 1969, 19:00 day-short-month-year-long-time Dec 31, 1969, 7:00:00 PM day-short-month-year-long-time-24 Dec 31, 1969, 19:00:00 long-date Wednesday, December 31, 1969 long-date-short-time Wednesday, December 31, 1969, 7:00 PM long-date-short-time-24 Wednesday, December 31, 1969, 19:00 long-date-long-time Wednesday, December 31, 1969, 7:00:00 PM long-date-long-time-24 Wednesday, December 31, 1969, 19:00:00 long-month-year December 1969 short-month-year Dec 1969 year 1969 Possible Values:"default"|"short-date"|"short-date-short-time"|"short-date-short-time-24"|"short-date-long-time"|"short-date-long-time-24"|"long-month-day-year"|"long-month-day-year-short-time"|"long-month-day-year-short-time-24"|"long-month-day-year-long-time"|"long-month-day-year-long-time-24"|"day-short-month-year"|"day-short-month-year-short-time"|"day-short-month-year-short-time-24"|"day-short-month-year-long-time"|"day-short-month-year-long-time-24"|"long-date"|"long-date-short-time"|"long-date-short-time-24"|"long-date-long-time"|"long-date-long-time-24"|"long-month-year"|"short-month-year"|"year"
- See also:
-
The name of the class. The declared class name is formatted as
esri.folder.className
.
-
digitSeparator Boolean
-
Used only with
Number
fields. A value oftrue
indicates the number should have a digit (or thousands) separator when the value appears in popups. A value offalse
means that no separator will be used.- Default Value:false
-
places Number
-
Used only with
Number
fields to specify the number of supported decimal places that should appear in popups. Any places beyond this value are rounded.
Method Overview
Name | Return Type | Summary | Class | |
---|---|---|---|---|
FieldInfoFormat | more details Creates a deep clone of the FieldInfoFormat class. | more details | FieldInfoFormat | |
* | more details Creates a new instance of this class and initializes it with values from a JSON object generated from an ArcGIS product. | more details | FieldInfoFormat | |
more details Adds one or more handles which are to be tied to the lifecycle of the object. | more details | Accessor | ||
Object | more details Converts an instance of this class to its ArcGIS portal JSON representation. | more details | FieldInfoFormat |
Method Details
-
clone(){FieldInfoFormat}
-
Creates a deep clone of the FieldInfoFormat class.
Returns:Type Description FieldInfoFormat A deep clone of the FieldInfoFormat instance.
-
fromJSON(json){*}static
-
Creates a new instance of this class and initializes it with values from a JSON object generated from an ArcGIS product. The object passed into the input
json
parameter often comes from a response to a query operation in the REST API or a toJSON() method from another ArcGIS product. See the Using fromJSON() topic in the Guide for details and examples of when and how to use this function.Parameter:json ObjectA JSON representation of the instance in the ArcGIS format. See the ArcGIS REST API documentation for examples of the structure of various input JSON objects.
Returns:Type Description * Returns a new instance of this class.
-
own(handleOrHandles)inheritedSince: ArcGIS API for JavaScript 4.24
-
Adds one or more handles which are to be tied to the lifecycle of the object. The handles will be removed when the object is destroyed.
// Manually manage handles const handle = reactiveUtils.whenOnce(() => !view.updating) .then(() => { wkidSelect.disabled = false; }); handle.remove(); // Assign a handle using own() this.own(reactiveUtils.whenOnce(() => !view.updating) .then(() => { wkidSelect.disabled = false; }));
Parameter:handleOrHandles WatchHandle|WatchHandle[]Handles marked for removal once the object is destroyed.
-
toJSON(){Object}
-
Converts an instance of this class to its ArcGIS portal JSON representation. See the Using fromJSON() guide topic for more information.
Returns:Type Description Object The ArcGIS portal JSON representation of an instance of this class.