Skip to main content

Interface: UiListSelectTouchButtonProps<S>

Component props for UiListSelectTouchButton.

Type parameters

NameType
Sextends MutableSubscribable<any, any>

Hierarchy

Properties

canBeFocused

Optional canBeFocused: boolean | Subscribable<boolean>

Whether the button can be focused. Irrespective of this value, the button cannot be focused while it is disabled or not visible. Defaults to true.

Inherited from

Omit.canBeFocused

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:123


children

Optional children: DisplayChildren[]

The children of the display component.

Inherited from

Omit.children

Defined in

src/sdk/components/FSComponent.ts:122


class

Optional class: string | ToggleableClassNameRecord | SubscribableSet<string>

CSS class(es) to apply to the button's root element.

Inherited from

Omit.class

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:129


containerRef

Optional containerRef: NodeReference<HTMLElement>

A reference to the UI view container that contains the button. Required in order to open the button's UI list dialog as a positioned popup.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:41


dialogBackgroundOcclusion

Optional dialogBackgroundOcclusion: UiViewOcclusionType

The occlusion type to apply to views beneath the UI list dialog popup. Defaults to 'darken'.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:68


dialogPositionAlign

Optional dialogPositionAlign: "top-right" | "bottom-left" | "bottom-right" | "top-left"

The edges of the button to which to align the reference corner of the button's UI list dialog. Ignored if openDialogAsPositioned is false. Defaults to top-left.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:53


dialogPositionReference

Optional dialogPositionReference: "top-right" | "bottom-left" | "bottom-right" | "top-left"

The reference corner of the button's UI list dialog, which will be aligned to the button if openDialogAsPositioned is true. Defaults to top-left.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:47


dialogPositionXOffset

Optional dialogPositionXOffset: number

The horizontal offset to apply to the button's UI list dialog positioning after alignment with the button, in pixels. Ignored if openDialogAsPositioned is false. Defaults to 0.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:59


dialogPositionYOffset

Optional dialogPositionYOffset: number

The vertical offset to apply to the button's UI list dialog positioning after alignment with the button, in pixels. Ignored if openDialogAsPositioned is false. Defaults to 0.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:65


dragThresholdPx

Optional dragThresholdPx: number

The distance, in pixels, the mouse can click and drag before the pad begins to ignore mouse events. Ignored if inhibitOnDrag is false. Defaults to 40 pixels.

Inherited from

Omit.dragThresholdPx

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:156


focusController

Optional focusController: UiFocusController

A UI focus controller with which to automatically register the button after it is rendered. If not defined, then the button will not be automatically registered with any controller, but it may still be registered manually.

Inherited from

Omit.focusController

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:117


focusOnDrag

Optional focusOnDrag: boolean

Whether the pad should focus all mouse events when dragging, preventing them from bubbling up to any ancestors in the DOM tree. Defaults to true.

Inherited from

Omit.focusOnDrag

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:93


focusOptions

Optional focusOptions: Readonly<UiTouchButtonFocusModuleOptions>

Options to configure the button's behavior related to UI focus.

Inherited from

Omit.focusOptions

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:126


hideDropdownArrow

Optional hideDropdownArrow: boolean

Whether to hide the button's dropdown arrow. Defaults to false.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:71


highlightButtonWhileListIsOpen

Optional highlightButtonWhileListIsOpen: boolean

When true, the button will be highlighted while the list is open, and the isHighlighted prop will be ignored. Defaults to false.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:80


inhibitOnDrag

Optional inhibitOnDrag: boolean

Whether the button should stop responding to mouse events and instead forward them to its parent after clicking and dragging for a certain distance defined by dragThresholdPx along the axis defined by inhibitOnDragAxis. When mouse events are inhibited, the button cannot be primed or held. Defaults to false.

Inherited from

Omit.inhibitOnDrag

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:150


inhibitOnDragAxis

Optional inhibitOnDragAxis: "both" | "x" | "y"

The axis along which dragging will trigger the inhibit function. Ignored if inhibitOnDrag is false. Defaults to 'both'.

Inherited from

Omit.inhibitOnDragAxis

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:162


isEnabled

Optional isEnabled: boolean | Subscribable<boolean>

Whether the button is enabled, or a subscribable which provides it. Disabled buttons cannot be touched, primed, pressed, or held. Defaults to true.

Inherited from

Omit.isEnabled

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:79


isHighlighted

Optional isHighlighted: boolean | Subscribable<boolean>

Whether the button is highlighted, or a subscribable which provides it. Defaults to false.

Inherited from

Omit.isHighlighted

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:82


isInList

Optional isInList: boolean

Whether the button is in a scrollable list. If true, will enable the inhibit on drag function unless otherwise specified by the inhibitOnDrag prop. Defaults to false.

Inherited from

Omit.isInList

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:99


isVisible

Optional isVisible: boolean | Subscribable<boolean>

Whether the button is visible. Defaults to true.

Inherited from

Omit.isVisible

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:85


label

Optional label: string | VNode | Subscribable<string>

The label for the button. Can be defined as either a static string, a subscribable which provides the label string, or a VNode. If not defined, the button will not have a label.

If the label is defined as a VNode, all first-level DisplayComponents in the VNode tree will be destroyed when the button is destroyed.

Inherited from

Omit.label

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:94


listDialogKey

listDialogKey: string

The key of the UI list dialog the button will open as a selection list.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:29


listDialogLayer

listDialogLayer: UiViewStackLayer

The view stack layer in which to open the button's UI list dialog.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:26


listParams

listParams: (state: S) => UiListDialogParams<MutableSubscribableInputType<S>> | UiListDialogParams<MutableSubscribableInputType<S>>

Parameters to pass to the selection list dialog, or a function which will return the parameters when called each time the list is opened.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:86


listScrollAxis

Optional listScrollAxis: "x" | "y"

The scroll axis of the button's parent list. Ignored if isInList is false. Sets the button's inhibit on drag axis unless otherwise specified by the inhibitOnDragAxis prop. Defaults to y.

Inherited from

Omit.listScrollAxis

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:105


onCancelled

Optional onCancelled: <B>(state: S, button: B) => void

A callback function which will be called each time a list dialog opened by the button is closed before a value is selected.

Type declaration

▸ <B>(state, button): void

A callback function which will be called each time a list dialog opened by the button is closed before a value is selected.

Type parameters
NameType
Bextends UiListSelectTouchButton<S> = UiListSelectTouchButton<S>
Parameters
NameType
stateS
buttonB
Returns

void

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:98


onDestroy

Optional onDestroy: () => void

A callback function which will be called when the button is destroyed.

Type declaration

▸ (): void

A callback function which will be called when the button is destroyed.

Returns

void

Inherited from

Omit.onDestroy

Defined in

src/garminsdk/components/touchbutton/TouchButton.tsx:165


onFocusGained

Optional onFocusGained: <B>(button: B, direction: UiFocusDirection) => void

A function which is called when the button gains UI focus.

Param

The button that gained UI focus.

Type declaration

▸ <B>(button, direction): void

A function which is called when the button gains UI focus.

Type parameters
NameType
Bextends UiValueTouchButton<S> = UiValueTouchButton<S>
Parameters
NameTypeDescription
buttonBThe button that gained UI focus.
directionUiFocusDirection-
Returns

void

Inherited from

Omit.onFocusGained

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:81


onFocusLost

Optional onFocusLost: <B>(button: B) => void

A function which is called when the button loses UI focus.

Param

The button that lost UI focus.

Type declaration

▸ <B>(button): void

A function which is called when the button loses UI focus.

Type parameters
NameType
Bextends UiValueTouchButton<S> = UiValueTouchButton<S>
Parameters
NameTypeDescription
buttonBThe button that lost UI focus.
Returns

void

Inherited from

Omit.onFocusLost

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:87


onHoldEnded

Optional onHoldEnded: <B>(button: B, state: S, totalHoldDuration: number, endReason: TouchButtonHoldEndReason) => void

A function which is called when the button exits the held state.

Param

The button that was held.

Param

The state that is bound to the button.

Param

The total amount of time, in milliseconds, that the button was held.

Param

The reason that the button exited the held state.

Type declaration

▸ <B>(button, state, totalHoldDuration, endReason): void

A function which is called when the button exits the held state.

Type parameters
NameType
Bextends UiValueTouchButton<S> = UiValueTouchButton<S>
Parameters
NameTypeDescription
buttonBThe button that was held.
stateSThe state that is bound to the button.
totalHoldDurationnumberThe total amount of time, in milliseconds, that the button was held.
endReasonTouchButtonHoldEndReasonThe reason that the button exited the held state.
Returns

void

Inherited from

Omit.onHoldEnded

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:70


onHoldStarted

Optional onHoldStarted: <B>(button: B, state: S) => TouchButtonHoldAction

A function which is called when the button enters the held state. If not defined, then the button will default to taking no specific action when it enters the held state.

Param

The button that is held.

Param

The state that is bound to the button.

Type declaration

▸ <B>(button, state): TouchButtonHoldAction

A function which is called when the button enters the held state. If not defined, then the button will default to taking no specific action when it enters the held state.

Type parameters
NameType
Bextends UiValueTouchButton<S> = UiValueTouchButton<S>
Parameters
NameTypeDescription
buttonBThe button that is held.
stateSThe state that is bound to the button.
Returns

TouchButtonHoldAction

The action to take. Ignored if the value is equal to TouchButtonHoldAction.EndHold.

Inherited from

Omit.onHoldStarted

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:42


onHoldTick

Optional onHoldTick: <B>(button: B, state: S, dt: number, totalTime: number, timeSinceLastPress: number) => TouchButtonHoldAction

A function which is called every frame when the button is held. If not defined, then the button will default to taking no specific action with each frame tick.

Param

The button that is held.

Param

The state that is bound to the button.

Param

The elapsed time, in milliseconds, since the previous frame.

Param

The total amount of time, in milliseconds, that the button has been held.

Param

The amount of time, in milliseconds, that the button has been held since the last time the button was pressed as a tick action.

Type declaration

▸ <B>(button, state, dt, totalTime, timeSinceLastPress): TouchButtonHoldAction

A function which is called every frame when the button is held. If not defined, then the button will default to taking no specific action with each frame tick.

Type parameters
NameType
Bextends UiValueTouchButton<S> = UiValueTouchButton<S>
Parameters
NameTypeDescription
buttonBThe button that is held.
stateSThe state that is bound to the button.
dtnumberThe elapsed time, in milliseconds, since the previous frame.
totalTimenumberThe total amount of time, in milliseconds, that the button has been held.
timeSinceLastPressnumberThe amount of time, in milliseconds, that the button has been held since the last time the button was pressed as a tick action.
Returns

TouchButtonHoldAction

The action to take.

Inherited from

Omit.onHoldTick

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:55


onSelected

Optional onSelected: <B>(value: MutableSubscribableInputType<S>, state: S, button: B) => void

A callback function which will be called each time a value is selected from a list dialog opened by the button. If not defined, then selecting a value from the list will automatically set the button's bound state.

Type declaration

▸ <B>(value, state, button): void

A callback function which will be called each time a value is selected from a list dialog opened by the button. If not defined, then selecting a value from the list will automatically set the button's bound state.

Type parameters
NameType
Bextends UiListSelectTouchButton<S> = UiListSelectTouchButton<S>
Parameters
NameType
valueMutableSubscribableInputType<S>
stateS
buttonB
Returns

void

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:92


onTouched

Optional onTouched: <B>(button: B, state: S) => TouchButtonOnTouchedAction

A callback function which will be called every time the button is touched (i.e. a mouse down event on the button is detected). If not defined, then the button will default to entering the primed state when touched.

Param

The button that was touched.

Param

The state that is bound to the button.

Type declaration

▸ <B>(button, state): TouchButtonOnTouchedAction

A callback function which will be called every time the button is touched (i.e. a mouse down event on the button is detected). If not defined, then the button will default to entering the primed state when touched.

Type parameters
NameType
Bextends UiValueTouchButton<S> = UiValueTouchButton<S>
Parameters
NameTypeDescription
buttonBThe button that was touched.
stateSThe state that is bound to the button.
Returns

TouchButtonOnTouchedAction

The action to take as a result of the button being touched.

Inherited from

Omit.onTouched

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiValueTouchButton.tsx:25


openDialogAsPositioned

Optional openDialogAsPositioned: boolean

Whether to open the button's UI list dialog as a positioned popup. If false, then the dialog will be opened as a normal popup. Defaults to false.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:35


ref

Optional ref: NodeReference<any>

A reference to the display component.

Inherited from

Omit.ref

Defined in

src/sdk/components/FSComponent.ts:125


renderValue

Optional renderValue: VNode | (stateValue: SubscribableType<S>) => string | VNode

A function which renders the value of the button's bound state, or a VNode which renders the value. If not defined, values are rendered into strings via default toString() behavior.

If the rendered value is a VNode, all first-level DisplayComponents in the VNode tree will be destroyed when a new value is rendered or when the button is destroyed.

Inherited from

Omit.renderValue

Defined in

src/garminsdk/components/touchbutton/ValueTouchButton.tsx:21


state

state: S

A mutable subscribable whose state will be bound to the button.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:74


uiService

uiService: UiService

The UI service.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/MFD/Components/TouchButton/UiListSelectTouchButton.tsx:23