Interface: WT21UiControlListProps<T>

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:220

The properties for a WT21 UI control list component.

Extends

• UiControlPropEventHandlers<GuiUiControlEvents>.HardwareUiControlProps.HardwareControlListProps<T>

Type Parameters

Type Parameter
T

Properties

children?

optional children: DisplayChildren[]

Defined in: sdk/components/FSComponent.ts:122

The children of the display component.

Inherited from

HardwareControlListProps.children

---

class?

optional class: string

Defined in: sdk/components/controls/HardwareUiControlList.tsx:36

The CSS class to apply to this list container.

Inherited from

HardwareControlListProps.class

---

data

data: SubscribableArray<T>

Defined in: sdk/components/controls/HardwareUiControlList.tsx:12

The data associated with this list component.

Inherited from

HardwareControlListProps.data

---

disableContainerScroll?

optional disableContainerScroll: boolean

Defined in: sdk/components/controls/HardwareUiControlList.tsx:42

Disables automatically ensuring that the container scrolls to the focused item.

Inherited from

HardwareControlListProps.disableContainerScroll

---

getFocusPositionOnScroll()?

optional getFocusPositionOnScroll: (direction) => FocusPosition

Defined in: sdk/components/controls/HardwareUiControl.tsx:56

A function which returns how the control should focus its children when it is focused from a scroll.

Parameters

Parameter	Type
direction	ScrollDirection

Returns

FocusPosition

Inherited from

HardwareControlListProps.getFocusPositionOnScroll

---

hideScrollbar?

optional hideScrollbar: boolean

Defined in: sdk/components/controls/HardwareUiControlList.tsx:30

Whether or not to hide the list scrollbar.

Inherited from

HardwareControlListProps.hideScrollbar

---

innerKnobScroll?

optional innerKnobScroll: boolean

Defined in: sdk/components/controls/HardwareUiControl.tsx:32

Whether or not the inner FMS knob scrolls also by default.

Inherited from

HardwareControlListProps.innerKnobScroll

---

isolateScroll?

optional isolateScroll: boolean

Defined in: sdk/components/controls/HardwareUiControl.tsx:38

When enabled, scroll commands will not propagate from this control to its parent while the control is focused.

Inherited from

HardwareControlListProps.isolateScroll

---

itemSize?

optional itemSize: number

Defined in: sdk/components/controls/HardwareUiControlList.tsx:24

The size, in pixels, of each item in the list.

Inherited from

HardwareControlListProps.itemSize

---

numItems?

optional numItems: number

Defined in: sdk/components/controls/HardwareUiControlList.tsx:27

The max number of items to display in the list.

Inherited from

HardwareControlListProps.numItems

---

onAfterScroll()?

optional onAfterScroll: (control, index) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:62

An event called when the scroll operation has completed.

Parameters

Parameter	Type
control	HardwareUiControl
index	number

Returns

void

Inherited from

HardwareControlListProps.onAfterScroll

---

onBlurred()?

optional onBlurred: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:47

An event called when the control loses focus.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onBlurred

---

onDestroyed()?

optional onDestroyed: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:71

An event called when the control is destroyed.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onDestroyed

---

onDisabled()?

optional onDisabled: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:50

An event called when the control is disabled.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onDisabled

---

onEnabled()?

optional onEnabled: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:53

An event called when the control is enabled.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onEnabled

---

onFocused()?

optional onFocused: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:44

An event called when the control is focused.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onFocused

---

onItemSelected()?

optional onItemSelected: (data, node, index) => void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:18

A callback called when an item in the list is selected.

Parameters

Parameter	Type
data	null | T
node	null | HardwareUiControl<Record<string, any>, HardwareUiControlProps>
index	number

Returns

void

Inherited from

HardwareControlListProps.onItemSelected

---

onLowerKnobDec?

optional onLowerKnobDec: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onLowerKnobDec

---

onLowerKnobInc?

optional onLowerKnobInc: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onLowerKnobInc

---

onLowerMenuPush?

optional onLowerMenuPush: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onLowerMenuPush

---

onMfdEsc?

optional onMfdEsc: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onMfdEsc

---

onPfdEsc?

optional onPfdEsc: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onPfdEsc

---

onPfdMenuPush?

optional onPfdMenuPush: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onPfdMenuPush

---

onRefsMenuPush?

optional onRefsMenuPush: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onRefsMenuPush

---

onRegistered()?

optional onRegistered: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:65

An event called when a control is registered with this control.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onRegistered

---

onScroll()?

optional onScroll: (direction) => boolean

Defined in: sdk/components/controls/HardwareUiControl.tsx:59

An event called when the control is scrolled.

Parameters

Parameter	Type
direction	ScrollDirection

Returns

boolean

Inherited from

HardwareControlListProps.onScroll

---

onSoftkey1L?

optional onSoftkey1L: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey1L

---

onSoftkey1R?

optional onSoftkey1R: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey1R

---

onSoftkey2L?

optional onSoftkey2L: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey2L

---

onSoftkey2R?

optional onSoftkey2R: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey2R

---

onSoftkey3L?

optional onSoftkey3L: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey3L

---

onSoftkey3R?

optional onSoftkey3R: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey3R

---

onSoftkey4L?

optional onSoftkey4L: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey4L

---

onSoftkey4R?

optional onSoftkey4R: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onSoftkey4R

---

onUnregistered()?

optional onUnregistered: (source) => void

Defined in: sdk/components/controls/HardwareUiControl.tsx:68

An event called when a control is unregistered with this control.

Parameters

Parameter	Type
source	HardwareUiControl

Returns

void

Inherited from

HardwareControlListProps.onUnregistered

---

onUpperKnobDec?

optional onUpperKnobDec: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onUpperKnobDec

---

onUpperKnobInc?

optional onUpperKnobInc: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onUpperKnobInc

---

onUpperKnobPush?

optional onUpperKnobPush: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onUpperKnobPush

---

onUpperMenuPush?

optional onUpperMenuPush: UiControlEventHandler<WT21UiControl<WT21UiControlProps>>

Inherited from

UiControlPropEventHandlers.onUpperMenuPush

---

orderBy()?

optional orderBy: (a, b) => number

Defined in: sdk/components/controls/HardwareUiControlList.tsx:21

Indicates that the list should be ordered by a specified function.

Parameters

Parameter	Type
a	T
b	T

Returns

number

Inherited from

HardwareControlListProps.orderBy

---

reconcileChildBlur()?

optional reconcileChildBlur: (index, child) => number | BlurReconciliation

Defined in: sdk/components/controls/HardwareUiControl.tsx:80

A function which reconciles the focus state of the control's children when the control is focused with no focused children after a child has been blurred.

Parameters

Parameter	Type	Description
index	number	The index of the child control that was blurred.
child	HardwareUiControl	The child control that was blurred.

Returns

number | BlurReconciliation

The index of the child to focus, or a blur reconciliation strategy.

Inherited from

HardwareControlListProps.reconcileChildBlur

---

ref?

optional ref: NodeReference<any>

Defined in: sdk/components/FSComponent.ts:125

A reference to the display component.

Inherited from

HardwareControlListProps.ref

---

renderItem()

renderItem: (data, index) => VNode

Defined in: sdk/components/controls/HardwareUiControlList.tsx:15

A function that renders a single data item into the list.

Parameters

Parameter	Type
data	T
index	number

Returns

VNode

Inherited from

HardwareControlListProps.renderItem

---

requireChildFocus?

optional requireChildFocus: boolean

Defined in: sdk/components/controls/HardwareUiControl.tsx:41

Whether the control requires one of its child controls to be focused for itself to be focused.

Inherited from

HardwareControlListProps.requireChildFocus

---

scrollContainer?

optional scrollContainer: NodeReference<HTMLElement>

Defined in: sdk/components/controls/HardwareUiControlList.tsx:39

An alternate HTML element to scroll to ensure the selected element is in view.

Inherited from

HardwareControlListProps.scrollContainer

---

scrollToMostRecentlyAdded?

optional scrollToMostRecentlyAdded: boolean

Defined in: sdk/components/controls/HardwareUiControlList.tsx:33

Scroll to the index of the most recently added item.

Inherited from

HardwareControlListProps.scrollToMostRecentlyAdded