Skip to main content

Interface: UiListButtonProps

Component props for UiListButton.

Hierarchy

  • ComponentProps

  • Pick<UiTouchButtonProps, "isEnabled" | "isHighlighted" | "label" | "onTouched" | "onPressed" | "onHoldStarted" | "onHoldTick" | "onHoldEnded" | "onFocusGained" | "onFocusLost" | "gduFormat" | "canBeFocused">

    UiListButtonProps

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

Pick.canBeFocused

Defined in

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


children

Optional children: DisplayChildren[]

The children of the display component.

Inherited from

ComponentProps.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.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/List/UiListButton.tsx:36


fullSize

Optional fullSize: boolean

Whether to render the button as a full-size button. A full-size button takes up the entire space allotted to the the list item and is not surrounded by a visible border (besides the button's own border). Defaults to false.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/List/UiListButton.tsx:24


gduFormat

Optional gduFormat: GduFormat

The format of the button's parent GDU display. Used to set the button's inhibit on drag threshold unless otherwise specified by the dragThresholdPx prop. Defaults to '460'.

Inherited from

Pick.gduFormat

Defined in

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


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

Pick.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

Pick.isHighlighted

Defined in

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


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

Pick.label

Defined in

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


onDestroy

Optional onDestroy: () => void

A callback function to execute when the list item is destroyed.

Type declaration

▸ (): void

A callback function to execute when the list item is destroyed.

Returns

void

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/List/UiListButton.tsx:33


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 UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that gained UI focus.
directionUiFocusDirection-
Returns

void

Inherited from

Pick.onFocusGained

Defined in

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


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 UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that lost UI focus.
Returns

void

Inherited from

Pick.onFocusLost

Defined in

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


onHoldEnded

Optional onHoldEnded: <B>(button: B, 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 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, totalHoldDuration, endReason): void

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

Type parameters
NameType
Bextends UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that was held.
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

Pick.onHoldEnded

Defined in

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


onHoldStarted

Optional onHoldStarted: <B>(button: B) => 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.

Type declaration

▸ <B>(button): 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 UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that is held.
Returns

TouchButtonHoldAction

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

Inherited from

Pick.onHoldStarted

Defined in

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


onHoldTick

Optional onHoldTick: <B>(button: B, 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 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, 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 UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that is held.
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

Pick.onHoldTick

Defined in

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


onPressed

Optional onPressed: <B>(button: B, isHeld: boolean) => void

A callback function which will be called every time the button is pressed.

Param

The button that was pressed.

Param

Whether the button was held when it was pressed.

Type declaration

▸ <B>(button, isHeld): void

A callback function which will be called every time the button is pressed.

Type parameters
NameType
Bextends UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that was pressed.
isHeldbooleanWhether the button was held when it was pressed.
Returns

void

Inherited from

Pick.onPressed

Defined in

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


onTouched

Optional onTouched: <B>(button: B) => 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 attempting to set focus on its focus module and entering the primed state when touched.

Param

The button that was touched.

Type declaration

▸ <B>(button): 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 attempting to set focus on its focus module and entering the primed state when touched.

Type parameters
NameType
Bextends UiTouchButton = UiTouchButton
Parameters
NameTypeDescription
buttonBThe button that was touched.
Returns

TouchButtonOnTouchedAction

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

Inherited from

Pick.onTouched

Defined in

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


ref

Optional ref: NodeReference<any>

A reference to the display component.

Inherited from

ComponentProps.ref

Defined in

src/sdk/components/FSComponent.ts:125


useListItemStyle

Optional useListItemStyle: boolean

Whether to style the button to appear as a list item instead of a touchscreen button. Ignored if fullSize is false. Defaults to false.

Defined in

src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/List/UiListButton.tsx:30