# Class FormList

- [TopLevel.Object](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md)
  - [dw.web.FormElement](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md)
    - [dw.web.FormGroup](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md)
      - [dw.web.FormList](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormList.md)

Represents a list of forms.

## Property Summary

| Property                                                                                                                                    | Description                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [selectManyItems](#selectmanyitems): [List](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.List.md) `(read-only)`            | returns the selected list items if the list is  configured to support selection of items.            |
| [selectManyObjects](#selectmanyobjects): [List](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.List.md) `(read-only)`        | Returns a list of all selected objects if the list is configured  to support the selection of items. |
| [selectOneItem](#selectoneitem): [FormListItem](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormListItem.md) `(read-only)` | Returns the default list item if the list is configured to  support the selection of a default item. |
| [selectOneObject](#selectoneobject): [Object](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md) `(read-only)`       | Returns the selected object if the list is configured to  support the selection of a default item.   |

## Constructor Summary

This class does not have a constructor, so you cannot create it directly.

## Method Summary

| Method                                                                                                                  | Description                                                                                          |
| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [getSelectManyItems](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormList.md#getselectmanyitems)()     | returns the selected list items if the list is  configured to support selection of items.            |
| [getSelectManyObjects](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormList.md#getselectmanyobjects)() | Returns a list of all selected objects if the list is configured  to support the selection of items. |
| [getSelectOneItem](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormList.md#getselectoneitem)()         | Returns the default list item if the list is configured to  support the selection of a default item. |
| [getSelectOneObject](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormList.md#getselectoneobject)()     | Returns the selected object if the list is configured to  support the selection of a default item.   |

### Methods inherited from class FormGroup

[accept](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#accept), [copyFrom](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#copyfromobject), [copyTo](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#copytoobject), [getChildCount](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#getchildcount), [getError](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#geterror), [getObject](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#getobject), [getSubmittedAction](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#getsubmittedaction), [getTriggeredAction](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormGroup.md#gettriggeredaction)

### Methods inherited from class FormElement

[clearFormElement](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#clearformelement), [getDynamicHtmlName](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#getdynamichtmlname), [getFormId](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#getformid), [getHtmlName](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#gethtmlname), [getParent](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#getparent), [getValidationResult](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#getvalidationresult), [invalidateFormElement](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#invalidateformelement), [invalidateFormElement](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#invalidateformelementstring), [isValid](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormElement.md#isvalid)

### Methods inherited from class Object

[assign](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#assignobject-object), [create](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#createobject), [create](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#createobject-object), [defineProperties](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#definepropertiesobject-object), [defineProperty](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#definepropertyobject-object-object), [entries](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#entriesobject), [freeze](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#freezeobject), [fromEntries](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#hasownpropertystring), [is](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isobject-object), [isExtensible](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isextensibleobject), [isFrozen](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isfrozenobject), [isPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isprototypeofobject), [isSealed](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#issealedobject), [keys](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#keysobject), [preventExtensions](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#propertyisenumerablestring), [seal](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#sealobject), [setPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#tolocalestring), [toString](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#tostring), [valueOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#valueof), [values](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#valuesobject)

## Property Details

### selectManyItems

- selectManyItems: [List](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.List.md) `(read-only)`
  - : returns the selected list items if the list is
    configured to support selection of items.

***

### selectManyObjects

- selectManyObjects: [List](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.List.md) `(read-only)`
  - : Returns a list of all selected objects if the list is configured
    to support the selection of items. The objects are the objects that were
    bound to each row.

***

### selectOneItem

- selectOneItem: [FormListItem](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormListItem.md) `(read-only)`
  - : Returns the default list item if the list is configured to
    support the selection of a default item.

***

### selectOneObject

- selectOneObject: [Object](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md) `(read-only)`
  - : Returns the selected object if the list is configured to
    support the selection of a default item. The object is the object
    bound to the item.

***

## Method Details

### getSelectManyItems()

- getSelectManyItems(): [List](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.List.md)
  - : returns the selected list items if the list is
    configured to support selection of items.

    **Returns:**

    - a List of FormListItem elements or null if no selection was configured for the form.

***

### getSelectManyObjects()

- getSelectManyObjects(): [List](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.List.md)
  - : Returns a list of all selected objects if the list is configured
    to support the selection of items. The objects are the objects that were
    bound to each row.

    **Returns:**

    - a List of objects or null if no selection was configured for the form.

***

### getSelectOneItem()

- getSelectOneItem(): [FormListItem](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.web.FormListItem.md)
  - : Returns the default list item if the list is configured to
    support the selection of a default item.

    **Returns:**

    - the default FormListItem elements or null if no selection was configured

***

### getSelectOneObject()

- getSelectOneObject(): [Object](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md)
  - : Returns the selected object if the list is configured to
    support the selection of a default item. The object is the object
    bound to the item.

    **Returns:**

    - the selected object.

***