Skip to main content

Class: UiSetValueTouchButton<S>

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:147

A G3X Touch UI version of SetValueTouchButton. 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.

Extends

Type Parameters

Type Parameter
S extends MutableSubscribable<any>

Implements

Constructors

Constructor

new UiSetValueTouchButton<S>(props): UiSetValueTouchButton<S>

Defined in: src/sdk/components/FSComponent.ts:73

Creates an instance of a DisplayComponent.

Parameters

ParameterTypeDescription
propsUiSetValueTouchButtonPropsThe propertis of the component.

Returns

UiSetValueTouchButton<S>

Inherited from

DisplayComponent<UiSetValueTouchButtonProps<S>>.constructor

Properties

buttonRef

protected readonly buttonRef: NodeReference<SetValueTouchButton<S>>

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:153


canBeFocused

readonly canBeFocused: Subscribable<boolean>

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:165

Whether this component can be focused.

Implementation of

UiFocusableComponent.canBeFocused


context?

optional context: [] = undefined

Defined in: src/sdk/components/FSComponent.ts:64

The context on this component, if any.

Inherited from

DisplayComponent.context


contextType?

readonly optional contextType: readonly [] = undefined

Defined in: src/sdk/components/FSComponent.ts:67

The type of context for this component, if any.

Inherited from

DisplayComponent.contextType


focusModule

protected readonly focusModule: UiTouchButtonFocusModule

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:155


isUiFocusableComponent

readonly isUiFocusableComponent: true = true

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:151

Flags this component as a UiFocusableComponent.

Implementation of

UiFocusableComponent.isUiFocusableComponent


props

props: UiSetValueTouchButtonProps<S> & ComponentProps

Defined in: src/sdk/components/FSComponent.ts:61

The properties of the component.

Inherited from

DisplayComponent.props

Methods

destroy()

destroy(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:340

Returns

void

Inherit Doc

Overrides

DisplayComponent.destroy


focusSelf()

focusSelf(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:193

Attempts to set focus on this button.

Returns

void


getContext()

protected getContext(context): never

Defined in: src/sdk/components/FSComponent.ts:106

Gets a context data subscription from the context collection.

Parameters

ParameterTypeDescription
contextneverThe 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


getRootElement()

getRootElement(): HTMLElement

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:177

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.


onAfterRender()

onAfterRender(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:168

Returns

void

Inherit Doc

Overrides

DisplayComponent.onAfterRender


onBeforeRender()

onBeforeRender(): void

Defined in: src/sdk/components/FSComponent.ts:80

A callback that is called before the component is rendered.

Returns

void

Inherited from

DisplayComponent.onBeforeRender


onDeregistered()

onDeregistered(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:203

Responds to when this component is deregistered with a controller.

Returns

void

Implementation of

UiFocusableComponent.onDeregistered


onFocusGained()

onFocusGained(direction): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:208

Responds to when this component gains focus.

Parameters

ParameterTypeDescription
directionUiFocusDirectionThe direction from which focus was gained.

Returns

void

Implementation of

UiFocusableComponent.onFocusGained


onFocusLost()

onFocusLost(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:214

Responds to when this component loses focus.

Returns

void

Implementation of

UiFocusableComponent.onFocusLost


onHoldEnded()

protected onHoldEnded(button, state, setValue, totalHoldDuration, endReason): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:300

Responds to when this button exits the held state.

Parameters

ParameterTypeDescription
buttonSetValueTouchButton<S>The button that was held.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.
totalHoldDurationnumberThe total amount of time, in milliseconds, that this button was held.
endReasonTouchButtonHoldEndReasonThe reason that this button exited the held state.

Returns

void


onHoldStarted()

protected onHoldStarted(button, state, setValue): TouchButtonHoldAction

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:262

Responds to when this button enters the held state.

Parameters

ParameterTypeDescription
buttonSetValueTouchButton<S>The button that is held.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.

Returns

TouchButtonHoldAction

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


onHoldTick()

protected onHoldTick(button, state, setValue, dt, totalTime, timeSinceLastPress): TouchButtonHoldAction

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:279

A callback which is called every frame when this button is held.

Parameters

ParameterTypeDescription
buttonSetValueTouchButton<S>The button that is held.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.
dtnumberThe elapsed time, in milliseconds, since the previous frame.
totalTimenumberThe total amount of time, in milliseconds, that this button has been held.
timeSinceLastPressnumberThe 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.


onPressed()

protected onPressed(button, state, setValue, isHeld): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:247

Responds to when this button is pressed.

Parameters

ParameterTypeDescription
buttonSetValueTouchButton<S>The button that was pressed.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.
isHeldbooleanWhether the button was held when it was pressed.

Returns

void


onRegistered()

onRegistered(controller): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:198

Responds to when this component is registered with a controller.

Parameters

ParameterTypeDescription
controllerUiFocusControllerThe controller with which this component was registered.

Returns

void

Implementation of

UiFocusableComponent.onRegistered


onTouched()

protected onTouched(button, state, setValue): TouchButtonOnTouchedAction

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:231

Responds to when this button is touched.

Parameters

ParameterTypeDescription
buttonSetValueTouchButton<S>The button that was touched.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.

Returns

TouchButtonOnTouchedAction

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


onUiInteractionEvent()

onUiInteractionEvent(event): boolean

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:220

Handles a UiInteractionEvent.

Parameters

ParameterTypeDescription
eventUiInteractionEventThe event to handle.

Returns

boolean

Whether the event was handled.

Implementation of

UiFocusableComponent.onUiInteractionEvent


render()

render(): VNode

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:311

Returns

VNode

Inherit Doc

Overrides

DisplayComponent.render


simulatePressed()

simulatePressed(ignoreDisabled): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/TouchButton/UiSetValueTouchButton.tsx:186

Simulates this button being pressed. This will execute the onPressed() callback if one is defined.

Parameters

ParameterTypeDefault valueDescription
ignoreDisabledbooleanfalseWhether to simulate the button being pressed regardless of whether the button is disabled. Defaults to false.

Returns

void