ExpansionMode (Smart GWT EE API 13.1p (2026-01-20))

java.lang.Object
- java.lang.Enum<ExpansionMode>
- - com.smartgwt.client.types.ExpansionMode

All Implemented Interfaces:

ValueEnum, java.io.Serializable, java.lang.Comparable<ExpansionMode>
```
public enum ExpansionMode
extends java.lang.Enum<ExpansionMode>
implements ValueEnum
```
When canExpandRecords is true, ExpansionMode dictates the type of UI to be displayed in the expanded portion of the row.
There are a number of builtin ExpansionModes and you can override getExpansionComponent() to create your own expansion behaviors.

Enum Constant Summary

Enum Constants
Enum Constant and Description
`DETAIL_FIELD` Show a single field's value in an `HTMLFlow`.
`DETAIL_RELATED` Show a `DetailViewer` displaying those fields from the record not already displayed in the grid, together with a separate `ListGrid` containing related-records.
`DETAILS` Show a `DetailViewer` displaying those fields from the record which are not already displayed in the grid.
`EDITOR` Show a `DynamicForm` to edit those fields from the record which are not already present in the grid.
`RELATED` Show a separate `ListGrid` containing related-records.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.String`	`getValue()`
`static ExpansionMode`	`valueOf(java.lang.String name)` Returns the enum constant of this type with the specified name.
`static ExpansionMode[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - DETAIL_FIELD
```
public static final ExpansionMode DETAIL_FIELD
```
    Show a single field's value in an HTMLFlow. Field to use is ListGrid.detailField.
    If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "detailField".
  - DETAILS
```
public static final ExpansionMode DETAILS
```
    Show a DetailViewer displaying those fields from the record which are not already displayed in the grid.
    If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "details".
  - RELATED
```
public static final ExpansionMode RELATED
```
    Show a separate ListGrid containing related-records. See ListGridRecord.detailDS and ListGrid.recordDetailDSProperty for more information.
    If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "related".
  - EDITOR
```
public static final ExpansionMode EDITOR
```
    Show a DynamicForm to edit those fields from the record which are not already present in the grid. If the record is collapsed with unsaved changes and ListGrid.expansionEditorShowSaveDialog is not set, Edits will be saved automatically, or stored as editValues if ListGrid.autoSaveEdits is false. Otherwise, a confirmation dialog is displayed. Can optionally show a save button and auto-collapse when save is pressed. If a record fails validation on save and the field in question is not visible in the grid, the record is automatically expanded and validated to show the errors.
    If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "editor".
  - DETAIL_RELATED
```
public static final ExpansionMode DETAIL_RELATED
```
    Show a DetailViewer displaying those fields from the record not already displayed in the grid, together with a separate ListGrid containing related-records.
    If this enumerated value is used in a Component XML file or server-side DataSource descriptor (.ds.xml file), use the value "detailRelated".
- Method Detail
  - values
```
public static ExpansionMode[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (ExpansionMode c : ExpansionMode.values())
    System.out.println(c);
```
    Returns:
    
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static ExpansionMode valueOf(java.lang.String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    
    name - the name of the enum constant to be returned.
    
    Returns:
    
    the enum constant with the specified name
    
    Throws:
    
    java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
    
    java.lang.NullPointerException - if the argument is null
  - getValue
```
public java.lang.String getValue()
```
    Specified by:
    
    getValue in interface ValueEnum

Enum ExpansionMode

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

DETAIL_FIELD

DETAILS

RELATED

EDITOR

DETAIL_RELATED

Method Detail

values

valueOf

getValue