BuildingComponentSublayer | API Reference | ArcGIS Maps SDK for JavaScript 4.31

BuildingComponentSublayers contain 3D Object features representing building components like doors, pipes or AC units. They are sublayers in a BuildingSceneLayer either directly or as part of a BuildingGroupSublayer. This sublayer is similar to a 3D Object SceneLayer, it can be visualized with a specific renderer, popups can be customized using popupTemplate and SQL filters can be applied by setting a definitionExpression.

Starting with version 4.17, BuildingComponentSublayers support attribute or spatial queries if the the BuildingSceneLayer has an associated feature layer.

See also

Property Overview

Any properties can be set, retrieved or listened to. See the Watch for changes topic.

Show inherited properties

Hide inherited properties

Type	Summary	Class
String	The name of the class.	Accessor
String	The SQL where clause used to filter features on the client.	BuildingComponentSublayer
Number	The sublayer's layer id as defined by the Scene Service.	BuildingSublayer
Boolean	Indicates if this sublayer is empty.	BuildingSublayer
String	Indicates how the layer should display in the LayerList widget.	BuildingComponentSublayer
Error	The Error object returned if an error occurred while loading.	BuildingComponentSublayer
String	Represents the status of a load operation.	BuildingComponentSublayer
Object []	A list of warnings which occurred while loading.	BuildingComponentSublayer
String	The modelName is a standard name for each sublayer.	BuildingSublayer
Number	Opacity of the sublayer.	BuildingSublayer
String []	An array of field names from the service to include with each feature.	BuildingComponentSublayer
Boolean	Indicates whether to display popups when features in the layer are clicked.	BuildingComponentSublayer
PopupTemplate	The popup template for the sublayer.	BuildingComponentSublayer
Renderer	The renderer assigned to the sublayer.	BuildingComponentSublayer
String	The title of the sublayer used to identify it in places such as the LayerList and Legend widgets.	BuildingSublayer
String	For BuildingComponentSublayer the type is always "building-component".	BuildingComponentSublayer
Boolean	Indicates if the sublayer is visible in the view.	BuildingSublayer

Property Details

declaredClass Inherited Property declaredClass Stringreadonly Inherited from Accessor

The name of the class. The declared class name is formatted as esri.folder.className.

definitionExpression Property definitionExpression String

The SQL where clause used to filter features on the client. Only the features that satisfy the definition expression are displayed in the View. Setting a definition expression is useful when only a subset of the data in the layer should be displayed.

Setting the definition expression of a layer automatically updates all layer views.

If the definition expression is set after the layer has been added to the map, the view will automatically refresh itself to display the features that satisfy the new definition expression.

Note that the initial loading time of the features remains unchanged, even if they are filtered. This happens because, as opposed to Feature Layers, feature filtering is done client-side. This means that all features need to be downloaded for filter evaluation.

This property is evaluated on the client using the cached attributes and it only supports standardized SQL.

id Inherited Property id Numberreadonly Inherited from BuildingSublayer

The sublayer's layer id as defined by the Scene Service.

isEmpty Inherited Property isEmpty Booleanreadonly Inherited from BuildingSublayer

Indicates if this sublayer is empty. This property is only read from the service. Empty sublayers are not loaded for rendering and applications can choose to hide them in their UI.

listMode Property listMode String Since: ArcGIS Maps SDK for JavaScript 4.11 BuildingComponentSublayer since 4.10, listMode added at 4.11.

Indicates how the layer should display in the LayerList widget. The possible values are listed below.

Value	Description
show	The layer is visible in the table of contents.
hide	The layer is hidden in the table of contents.

Possible Values:"show" |"hide"

Default Value:"show"

loadError Property loadError Errorreadonly

The Error object returned if an error occurred while loading.

Default Value:null

loadStatus Property loadStatus Stringreadonly

Represents the status of a load operation.

Value	Description
not-loaded	The object's resources have not loaded.
loading	The object's resources are currently loading.
loaded	The object's resources have loaded without errors.
failed	The object's resources failed to load. See loadError for more details.

Possible Values:"not-loaded" |"loading" |"failed" |"loaded"

Default Value:"not-loaded"

loadWarnings Property loadWarnings Object[]readonly

A list of warnings which occurred while loading.

modelName Inherited Property modelName Stringreadonly Inherited from BuildingSublayer

The modelName is a standard name for each sublayer. For example the sublayer containing the doors in a building has the modelName "Doors". Use this property to retrieve sublayers in a BuildingSceneLayer.

Example

// use modelName to identify a sublayer
const doorslayer = buildingSceneLayer.allSublayers.find(function(sublayer) {
  return sublayer.modelName === "Doors";
});

opacity Inherited Property opacity Number Inherited from BuildingSublayer

Opacity of the sublayer.

Default Value:1

outFields Property outFields String[] Since: ArcGIS Maps SDK for JavaScript 4.12 BuildingComponentSublayer since 4.10, outFields added at 4.12.

An array of field names from the service to include with each feature. To fetch the values from all fields in the layer, use ["*"]. Fields specified in outFields will be requested alongside with required fields for rendering.

To include fields in all sublayers, use the outFields property of the parent layer.

Default Value:null

popupEnabled Property popupEnabled Boolean

Indicates whether to display popups when features in the layer are clicked. The layer needs to have a popupTemplate to define what information should be displayed in the popup. Alternatively, a default popup template may be automatically used if Popup.defaultPopupTemplateEnabled is set to true.

Default Value:true

See also

createPopupTemplate
View

popupTemplate Property popupTemplate PopupTemplateautocast

The popup template for the sublayer. When set, the popupTemplate allows users to access attributes and display their values in the view's popup when a feature is selected using text and/or charts. See the PopupTemplate sample for an example of how PopupTemplate interacts with a FeatureLayer. Setting a PopupTemplate on this layer type is done in the same way as a FeatureLayer.

A default popup template is automatically used if no popupTemplate has been defined when Popup.defaultPopupTemplateEnabled is set to true.

See also

createPopupTemplate
View

renderer Property renderer Rendererautocast

The renderer assigned to the sublayer. The renderer defines how to visualize each feature in the sublayer. Depending on the renderer type, features may be visualized with the same symbol, or with varying symbols based on the values of provided attribute fields or functions.

Example

// all features in the layer will be visualized with
// a blue color
sublayer.renderer = {
  type: "simple",  // autocasts as new SimpleRenderer()
  symbol: {
    type: "mesh-3d",  // autocasts as new MeshSymbol3D()
    symbolLayers: [{
      type: "fill",  // autocasts as new FillSymbol3DLayer()
      material: { color: "blue" }
    }]
  }
};

title Inherited Property title String Inherited from BuildingSublayer

The title of the sublayer used to identify it in places such as the LayerList and Legend widgets.

type Property type Stringreadonly

For BuildingComponentSublayer the type is always "building-component".

visible Inherited Property visible Boolean Inherited from BuildingSublayer

Indicates if the sublayer is visible in the view.

Default Value:true

Method Overview

Show inherited methods

Hide inherited methods

Return Type	Summary	Class
	Adds one or more handles which are to be tied to the lifecycle of the object.	Accessor
	Cancels a load() operation if it is already in progress.	BuildingComponentSublayer
PopupTemplate	Creates a default popup template for the layer, populated with all the fields of the layer.	BuildingComponentSublayer
Query	Creates a query object that can be used to fetch features that satisfy the component sublayer's current definition expression.	BuildingComponentSublayer
Field	Returns the Field instance for a field name (case-insensitive).	BuildingComponentSublayer
Domain	Returns the Domain associated with the given field name.	BuildingComponentSublayer
Object	Gets field usage information.	BuildingComponentSublayer
Boolean	Returns true if a named group of handles exist.	Accessor
Boolean	`isFulfilled()` may be used to verify if creating an instance of the class is fulfilled (either resolved or rejected).	BuildingComponentSublayer
Boolean	`isRejected()` may be used to verify if creating an instance of the class is rejected.	BuildingComponentSublayer
Boolean	`isResolved()` may be used to verify if creating an instance of the class is resolved.	BuildingComponentSublayer
Promise	Loads the resources referenced by this class.	BuildingComponentSublayer
Promise<Object>	Executes a Query against the associated feature service and returns the 2D Extent of features that satisfy the query.	BuildingComponentSublayer
Promise<Number>	Executes a Query against the associated feature service and returns the number of features that satisfy the query.	BuildingComponentSublayer
Promise<FeatureSet>	Executes a Query against the associated feature service and returns a FeatureSet.	BuildingComponentSublayer
Promise<Number []>	Executes a Query against the associated feature service and returns an array of ObjectIDs of the features that satisfy the input query.	BuildingComponentSublayer
	Removes a group of handles owned by the object.	Accessor
Promise	`when()` may be leveraged once an instance of the class is created.	BuildingComponentSublayer

Method Details

addHandles Inherited Method addHandles(handleOrHandles, groupKey) Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, addHandles added at 4.25.

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.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

this.addHandles(handle);

// Destroy the object
this.destroy();

Parameters

handleOrHandles WatchHandle|WatchHandle []

Handles marked for removal once the object is destroyed.

groupKey *

optional

Key identifying the group to which the handles should be added. All the handles in the group can later be removed with Accessor.removeHandles(). If no key is provided the handles are added to a default group.

cancelLoad Method cancelLoad()

Cancels a load() operation if it is already in progress.

createPopupTemplate Method createPopupTemplate(options){PopupTemplate} Since: ArcGIS Maps SDK for JavaScript 4.11 BuildingComponentSublayer since 4.10, createPopupTemplate added at 4.11.

Creates a default popup template for the layer, populated with all the fields of the layer.

Starting with version 4.28, date fields are formatted using the short-date-short-time preset dateFormat rather than long-month-day-year in popup templates created with the createPopupTemplate() method. For example, previously a date that may have appeared as "December 30, 1997" will now appear as "12/30/1997 6:00 PM".

Parameter

options CreatePopupTemplateOptions

optional

Options for creating the popup template.

Returns

Type	Description
PopupTemplate	The popup template, or `null` if the layer does not have any fields.

createQuery Method createQuery(){Query} Since: ArcGIS Maps SDK for JavaScript 4.17 BuildingComponentSublayer since 4.10, createQuery added at 4.17.

Creates a query object that can be used to fetch features that satisfy the component sublayer's current definition expression. The query should only be used on the layer and not on the layer view.

Returns

Type	Description
Query	The query object representing the layer's definition expression.

getField Method getField(fieldName){Field} Since: ArcGIS Maps SDK for JavaScript 4.12 BuildingComponentSublayer since 4.10, getField added at 4.12.

Returns the Field instance for a field name (case-insensitive).

Parameter

fieldName String

Name of the field.

Returns

Type	Description
Field	the matching field or `undefined`

getFieldDomain Method getFieldDomain(fieldName, options){Domain} Since: ArcGIS Maps SDK for JavaScript 4.12 BuildingComponentSublayer since 4.10, getFieldDomain added at 4.12.

Returns the Domain associated with the given field name. The domain can be either a CodedValueDomain or RangeDomain.

Parameters

fieldName String

Name of the field.

options Object

optional

An object specifying additional options. See the object specification table below for the required properties of this object.

Specification

feature Graphic

The feature to which the Domain is assigned.

Returns

Type	Description
Domain	The Domain object associated with the given field name for the given feature.

getFieldUsageInfo Method getFieldUsageInfo(fieldName){Object} Since: ArcGIS Maps SDK for JavaScript 4.17. BuildingComponentSublayer since 4.10, getFieldUsageInfo added at 4.17..

Gets field usage information. On building component sub layers, fields can always be used for rendering and popups. Fields can only be used for querying if an associated feature service is available.

The returned object contains the following usage information:

Property	Type	Description
supportsRenderer	boolean	Indicates that a field can be used in a renderer (e.g. in visual variables), see renderer.
supportsLabelingInfo	boolean	This is always `false`, labeling is not supported on BuildingSceneLayer.
supportsPopupTemplate	boolean	Indicates that a field can be used in a popup template, see popupTemplate.
supportsLayerQuery	boolean	Indicates that a field can be used in layer queries, see queryFeatures().

Parameter

fieldName String

The name of the field to get usage info for.

Returns

Type	Description
Object	the field usage

hasHandles Inherited Method hasHandles(groupKey){Boolean} Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, hasHandles added at 4.25.

Returns true if a named group of handles exist.

Parameter

groupKey *

optional

A group key.

Returns

Type	Description
Boolean	Returns `true` if a named group of handles exist.

Example

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

isFulfilled Method isFulfilled(){Boolean}

isFulfilled() may be used to verify if creating an instance of the class is fulfilled (either resolved or rejected). If it is fulfilled, true will be returned.

Returns

Type	Description
Boolean	Indicates whether creating an instance of the class has been fulfilled (either resolved or rejected).

isRejected Method isRejected(){Boolean}

isRejected() may be used to verify if creating an instance of the class is rejected. If it is rejected, true will be returned.

Returns

Type	Description
Boolean	Indicates whether creating an instance of the class has been rejected.

isResolved Method isResolved(){Boolean}

isResolved() may be used to verify if creating an instance of the class is resolved. If it is resolved, true will be returned.

Returns

Type	Description
Boolean	Indicates whether creating an instance of the class has been resolved.

load Method load(signal){Promise}

Loads the resources referenced by this class. This method automatically executes for a View and all of the resources it references in Map if the view is constructed with a map instance.

This method must be called by the developer when accessing a resource that will not be loaded in a View.

The load() method only triggers the loading of the resource the first time it is called. The subsequent calls return the same promise.

It's possible to provide a signal to stop being interested into a Loadable instance load status. When the signal is aborted, the instance does not stop its loading process, only cancelLoad can abort it.

Parameter

signal AbortSignal

optional

Signal object that can be used to abort the asynchronous task. The returned promise will be rejected with an Error named AbortError when an abort is signaled. See also AbortController for more information on how to construct a controller that can be used to deliver abort signals.

Returns

Type	Description
Promise	Resolves when the resources have loaded.

queryExtent Method queryExtent(query, options){Promise<Object>} Since: ArcGIS Maps SDK for JavaScript 4.17 BuildingComponentSublayer since 4.10, queryExtent added at 4.17.

Executes a Query against the associated feature service and returns the 2D Extent of features that satisfy the query. At the moment the 3D Extent can be returned by using BuildingComponentSublayerView.queryExtent(), but this will return the 3D extent only for features currently in the view. The query succeeds only if the BuildingSceneLayer has an associated feature layer. If an associated feature layer is not available, then an error with the name buildingscenelayer:query-not-available is thrown. Read more about queries in the Querying section of the BuildingSceneLayer class description.

Parameters

query Query autocast

optional

Autocasts from Object

Specifies the query parameters.

options Object

optional

An object with the following properties.

Specification

signal AbortSignal

optional

Returns

Type

Description

Promise<Object>

When resolved, returns the extent and count of the features that satisfy the input query. See the object specification table below for details.

Property	Type	Description
count	Number	The number of features that satisfy the input query.
extent	Extent	The extent of the features that satisfy the query.

queryFeatureCount Method queryFeatureCount(query, options){Promise<Number>} Since: ArcGIS Maps SDK for JavaScript 4.17 BuildingComponentSublayer since 4.10, queryFeatureCount added at 4.17.

Executes a Query against the associated feature service and returns the number of features that satisfy the query. The query succeeds only if the layer's supportsLayerQuery capability is enabled. Use the getFieldUsageInfo() method to check if the layer supports queries. If querying is not enabled, then an error with the name buildingscenelayer:query-not-available is thrown. Read more about queries in the Querying section of the BuildingSceneLayer class description.

Parameters

query Query autocast

optional

Autocasts from Object

Specifies the query parameters.

options Object

optional

An object with the following properties.

Specification

signal AbortSignal

optional

Returns

Type	Description
Promise<Number>	Resolves to the count of the features satisfying the query.

queryFeatures Method queryFeatures(query, options){Promise<FeatureSet>} Since: ArcGIS Maps SDK for JavaScript 4.17 BuildingComponentSublayer since 4.10, queryFeatures added at 4.17.

Executes a Query against the associated feature service and returns a FeatureSet. The query succeeds only if the layer's supportsLayerQuery capability is enabled. Use the getFieldUsageInfo() method to check if the layer supports queries. If querying is not enabled, then an error with the name buildingscenelayer:query-not-available is thrown. Read more about queries in the Querying section of the BuildingSceneLayer class description.

Parameters

query Query autocast

optional

Autocasts from Object

Specifies the query parameters.

options Object

optional

An object with the following properties.

Specification

signal AbortSignal

optional

Returns

Type	Description
Promise<FeatureSet>	Resolves to a FeatureSet which contains the features satisfying the query.

queryObjectIds Method queryObjectIds(query, options){Promise<Number[]>} Since: ArcGIS Maps SDK for JavaScript 4.17 BuildingComponentSublayer since 4.10, queryObjectIds added at 4.17.

Executes a Query against the associated feature service and returns an array of ObjectIDs of the features that satisfy the input query. The query succeeds only if the layer's supportsLayerQuery capability is enabled. Use the getFieldUsageInfo() method to check if the layer supports queries. If querying is not enabled, then an error with the name buildingscenelayer:query-not-available is thrown. Read more about queries in the Querying section of the SceneLayer class description.

Parameters

query Query autocast

optional

Autocasts from Object

Specifies the query parameters.

options Object

optional

An object with the following properties.

Specification

signal AbortSignal

optional

Returns

Type	Description
Promise<Number []>	Resolves to an array of numbers representing the object IDs of the features satisfying the query.

See also

FeatureLayer.queryObjectIds

removeHandles Inherited Method removeHandles(groupKey) Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, removeHandles added at 4.25.

Removes a group of handles owned by the object.

Parameter

groupKey *

optional

A group key or an array or collection of group keys to remove.

Example

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

when Method when(callback, errback){Promise}

when() may be leveraged once an instance of the class is created. This method takes two input parameters: a callback function and an errback function. The callback executes when the instance of the class loads. The errback executes if the instance of the class fails to load.

Parameters

callback Function

optional

The function to call when the promise resolves.

errback Function

optional

The function to execute when the promise fails.

Returns

Type	Description
Promise	Returns a new promise for the result of `callback` that may be used to chain additional functions.

Example

// Although this example uses MapView, any class instance that is a promise may use when() in the same way
let view = new MapView();
view.when(function(){
  // This function will execute once the promise is resolved
}, function(error){
  // This function will execute if the promise is rejected due to an error
});