PropertyGrid

The PropertyGrid category in the @bentley/ui-components package includes classes and components for working with a PropertyGrid control.

Components

The following React components comprise the PropertyGrid control.

• PropertyGrid - renders property categories
• PropertyList - renders multiple properties within a category as a list
• PropertyRenderer - renders a property
• PrimitivePropertyRenderer - renders a primitive property
• NonPrimitivePropertyRenderer - renders struct and array properties
• PropertyView - renders a property as a label/value pair
• PropertyCategoryBlock - Expandable block for a category; uses ExpandableBlock for rendering

There are a number of value renderer components for different types that can be found in the Properties category. Those components are managed by the PropertyValueRendererManager.

Data Provider

The PropertyGrid data provider is defined by the IPropertyDataProvider interface. The getData method provides data to the PropertyGrid component via the PropertyData interface. The onDataChanged event should be emitted when property data changes.

In the PropertyData interface, the categories member provides an array of PropertyCategory and the records member provides a map of PropertyRecord associated with each category.

The SimplePropertyDataProvider class is an implementation of IPropertyDataProvider that uses an associative array. The PresentationPropertyDataProvider class is a Presentation Rules-driven implementation. Developers may develop their own implementation of IPropertyDataProvider.

Properties

The PropertyGrid component properties are defined by the PropertyGridProps interface.

The dataProvider prop, which is the only mandatory prop, specifies the property data provider.

The orientation prop specifies the grid orientation. When the width is less than 300 (or another width specified by thehorizontalOrientationMinWidth prop) the orientation will automatically switch to vertical.

To support property selection, set the isPropertySelectionEnabled prop to true and provide a onPropertySelectionChanged callback function.

To support property editing, set the isPropertyEditingEnabled prop to true and provide a onPropertyUpdated callback function.

To support a link in a property, set the links member in a PropertyRecord and provide a onPropertyLinkClick callback function.

Sample using Presentation Rules

The following sample is from simple-viewer-app. It uses Presentation Rules and Unified Selection.

Defining the SimplePropertiesComponent component

This React component utilizes the PropertyGrid component and propertyGridWithUnifiedSelection HOC to create a HOC property grid component that supports unified selection.

import * as React from "react";
import { IModelConnection } from "@bentley/imodeljs-frontend";
import { Orientation } from "@bentley/ui-core";
import { PropertyGrid } from "@bentley/ui-components";
import { PresentationPropertyDataProvider, propertyGridWithUnifiedSelection } from "@bentley/presentation-components";

// create a HOC property grid component that supports unified selection
// eslint-disable-next-line @typescript-eslint/naming-convention
const SimplePropertyGrid = propertyGridWithUnifiedSelection(PropertyGrid);

/** React properties for the property grid component */
export interface Props {
  /** iModel whose contents should be displayed in the property grid */
  imodel: IModelConnection;
  /** ID of the presentation rule set to use for creating the content displayed in the property grid */
  rulesetId: string;
}

/** Property grid component for the viewer app */
export default class SimplePropertiesComponent extends React.Component<Props> {
  public render() {
    const orientation = Orientation.Vertical;
    return (
      <SimplePropertyGrid
        orientation={orientation}
        dataProvider={new PresentationPropertyDataProvider(this.props.imodel, this.props.rulesetId)}
      />
    );
  }
}

Using the SimplePropertiesComponent component

const rulesetId = "Default";
. . .
<SimplePropertiesComponent imodel={this.props.imodel} rulesetId={rulesetId} />

API Reference

• PropertyGrid
• Properties in @bentley/ui-components
• Properties in @bentley/ui-abstract

Last Updated: 12 June, 2024