Class: UiImgTouchButton
A G3X Touch UI version of ImgTouchButton. Supports UI focus, enables focus on drag by default and provides convenience props for handling drag behavior while in a scrollable list.
The root element of the button conditionally contains the ui-button-focused
CSS class when the button has UI
focus.
Hierarchy
DisplayComponent
<UiImgTouchButtonProps
>↳
UiImgTouchButton
Implements
Constructors
constructor
• new UiImgTouchButton(props
): UiImgTouchButton
Creates an instance of a DisplayComponent.
Parameters
Name | Type | Description |
---|---|---|
props | UiImgTouchButtonProps | The propertis of the component. |
Returns
Inherited from
DisplayComponent<UiImgTouchButtonProps>.constructor
Defined in
src/sdk/components/FSComponent.ts:73
Properties
buttonRef
• Protected
Readonly
buttonRef: NodeReference
<ImgTouchButton
>
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:128
canBeFocused
• Readonly
canBeFocused: Subscribable
<boolean
>
Whether this component can be focused.
Implementation of
UiFocusableComponent.canBeFocused
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:140
context
• Optional
context: [] = undefined
The context on this component, if any.
Inherited from
DisplayComponent.context
Defined in
src/sdk/components/FSComponent.ts:64
contextType
• Optional
Readonly
contextType: readonly [] = undefined
The type of context for this component, if any.
Inherited from
DisplayComponent.contextType
Defined in
src/sdk/components/FSComponent.ts:67
focusModule
• Protected
Readonly
focusModule: UiTouchButtonFocusModule
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:130
isUiFocusableComponent
• Readonly
isUiFocusableComponent: true
Flags this component as a UiFocusableComponent.
Implementation of
UiFocusableComponent.isUiFocusableComponent
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:126
props
• props: UiImgTouchButtonProps
& ComponentProps
The properties of the component.
Inherited from
DisplayComponent.props
Defined in
src/sdk/components/FSComponent.ts:61
Methods
destroy
▸ destroy(): void
Returns
void
Inherit Doc
Overrides
DisplayComponent.destroy
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:286
focusSelf
▸ focusSelf(): void
Attempts to set focus on this button.
Returns
void
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:168
getContext
▸ getContext(context
): never
Gets a context data subscription from the context collection.
Parameters
Name | Type | Description |
---|---|---|
context | never | The context to get the subscription for. |
Returns
never
The requested context.
Throws
An error if no data for the specified context type could be found.
Inherited from
DisplayComponent.getContext
Defined in
src/sdk/components/FSComponent.ts:106
getRootElement
▸ getRootElement(): HTMLElement
Gets this button's root HTML element.
Returns
HTMLElement
This button's root HTML element.
Throws
Error if this button has not yet been rendered.
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:152
onAfterRender
▸ onAfterRender(): void
Returns
void
Inherit Doc
Overrides
DisplayComponent.onAfterRender
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:143
onBeforeRender
▸ onBeforeRender(): void
A callback that is called before the component is rendered.
Returns
void
Inherited from
DisplayComponent.onBeforeRender
Defined in
src/sdk/components/FSComponent.ts:80
onDeregistered
▸ onDeregistered(): void
Responds to when this component is deregistered with a controller.
Returns
void
Implementation of
UiFocusableComponent.onDeregistered
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:178
onFocusGained
▸ onFocusGained(direction
): void
Responds to when this component gains focus.
Parameters
Name | Type | Description |
---|---|---|
direction | UiFocusDirection | The direction from which focus was gained. |
Returns
void
Implementation of
UiFocusableComponent.onFocusGained
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:183
onFocusLost
▸ onFocusLost(): void
Responds to when this component loses focus.
Returns
void
Implementation of
UiFocusableComponent.onFocusLost
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:189
onHoldEnded
▸ onHoldEnded(button
, totalHoldDuration
, endReason
): void
Responds to when this button exits the held state.
Parameters
Name | Type | Description |
---|---|---|
button | TouchButton <TouchButtonProps > | The button that was held. |
totalHoldDuration | number | The total amount of time, in milliseconds, that this button was held. |
endReason | TouchButtonHoldEndReason | The reason that this button exited the held state. |
Returns
void
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:253
onHoldStarted
▸ onHoldStarted(): TouchButtonHoldAction
Responds to when this button enters the held state.
Returns
TouchButtonHoldAction
The action to take. Ignored if the value is equal to TouchButtonHoldAction.EndHold.
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:226
onHoldTick
▸ onHoldTick(button
, dt
, totalTime
, timeSinceLastPress
): TouchButtonHoldAction
A callback which is called every frame when this button is held.
Parameters
Name | Type | Description |
---|---|---|
button | TouchButton <TouchButtonProps > | The button that is held. |
dt | number | The elapsed time, in milliseconds, since the previous frame. |
totalTime | number | The total amount of time, in milliseconds, that this button has been held. |
timeSinceLastPress | number | The amount of time, in milliseconds, that this button has been held since the last time the button was pressed as a tick action. |
Returns
TouchButtonHoldAction
The action to take.
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:241
onPressed
▸ onPressed(button
, isHeld
): void
Responds to when this button is pressed.
Parameters
Name | Type | Description |
---|---|---|
button | TouchButton <TouchButtonProps > | The button that was pressed. |
isHeld | boolean | Whether the button was held when it was pressed. |
Returns
void
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:217
onRegistered
▸ onRegistered(controller
): void
Responds to when this component is registered with a controller.
Parameters
Name | Type | Description |
---|---|---|
controller | UiFocusController | The controller with which this component was registered. |
Returns
void
Implementation of
UiFocusableComponent.onRegistered
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:173
onTouched
▸ onTouched(): TouchButtonOnTouchedAction
Responds to when this button is touched.
Returns
TouchButtonOnTouchedAction
The action to take as a result of the button being touched.
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:203
onUiInteractionEvent
▸ onUiInteractionEvent(event
): boolean
Handles a UiInteractionEvent.
Parameters
Name | Type | Description |
---|---|---|
event | UiInteractionEvent | The event to handle. |
Returns
boolean
Whether the event was handled.
Implementation of
UiFocusableComponent.onUiInteractionEvent
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:195
render
▸ render(): VNode
Returns
VNode
Inherit Doc
Overrides
DisplayComponent.render
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:258
simulatePressed
▸ simulatePressed(ignoreDisabled?
): void
Simulates this button being pressed. This will execute the onPressed()
callback if one is defined.
Parameters
Name | Type | Default value | Description |
---|---|---|---|
ignoreDisabled | boolean | false | Whether to simulate the button being pressed regardless of whether the button is disabled. Defaults to false . |
Returns
void
Defined in
src/workingtitle-instruments-g3x-touch/html_ui/Pages/VCockpit/Instruments/NavSystems/G3XTouch/Shared/Components/TouchButton/UiImgTouchButton.tsx:161