Skip to main content

Class: ValueTouchButton<S>

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:92

A touchscreen button which displays the value of a bound state.

The root element of the button contains the touch-button-value CSS class by default, in addition to all root-element classes used by TouchButton.

The value of the button's bound state is rendered into a child div element containing the CSS class touch-button-value-value.

Extends

Type Parameters

Type Parameter
S extends Subscribable<any>

Constructors

Constructor

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

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

Creates an instance of a DisplayComponent.

Parameters

ParameterTypeDescription
propsValueTouchButtonPropsThe propertis of the component.

Returns

ValueTouchButton<S>

Inherited from

DisplayComponent<ValueTouchButtonProps<S>>.constructor

Properties

buttonRef

protected readonly buttonRef: NodeReference<TouchButton<TouchButtonProps>>

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:95


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


cssClassSet

protected readonly cssClassSet: SetSubject<string>

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:98


props

props: ValueTouchButtonProps<S> & ComponentProps

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

The properties of the component.

Inherited from

DisplayComponent.props


renderedValue?

protected optional renderedValue: string | VNode

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:100


valueRef

protected readonly valueRef: NodeReference<HTMLDivElement>

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:96


RESERVED_CSS_CLASSES

protected readonly static RESERVED_CSS_CLASSES: Set<string>

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:93

Methods

cleanUpRenderedValue()

protected cleanUpRenderedValue(): void

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:154

Cleans up this button's rendered value.

Returns

void


destroy()

destroy(): void

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:298

Returns

void

Inherit Doc

Overrides

DisplayComponent.destroy


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


getReservedCssClasses()

protected getReservedCssClasses(): ReadonlySet<string>

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:293

Gets the CSS classes that are reserved for this button's root element.

Returns

ReadonlySet<string>

The CSS classes that are reserved for this button's root element.


getRootElement()

getRootElement(): HTMLElement

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:121

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/garminsdk/components/touchbutton/ValueTouchButton.tsx:106

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


onHoldEnded()

protected onHoldEnded(button, totalHoldDuration, endReason): void

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:235

Responds to when this button exits the held state.

Parameters

ParameterTypeDescription
buttonTouchButtonThe button that was held.
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): TouchButtonHoldAction

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:208

Responds to when this button enters the held state.

Parameters

ParameterTypeDescription
buttonTouchButtonThe button that is held.

Returns

TouchButtonHoldAction

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


onHoldTick()

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

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:223

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

Parameters

ParameterTypeDescription
buttonTouchButtonThe button that is held.
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, isHeld): void

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:198

Responds to when this button is pressed.

Parameters

ParameterTypeDescription
buttonTouchButtonThe button that was pressed.
isHeldbooleanWhether the button was held when it was pressed.

Returns

void


onTouched()

protected onTouched(button): TouchButtonOnTouchedAction

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:187

Responds to when this button is touched.

Parameters

ParameterTypeDescription
buttonTouchButtonThe button that was touched.

Returns

TouchButtonOnTouchedAction

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


processRenderedValue()

protected processRenderedValue(rendered): void

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:139

Processes a newly rendered value. The new rendered value will rendered into this button's value container, replacing any existing rendered value.

Parameters

ParameterTypeDescription
renderedstring | VNodeThe newly rendered value.

Returns

void


render()

render(): VNode

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:240

Returns

VNode

Inherit Doc

Overrides

DisplayComponent.render


renderValueContainer()

protected renderValueContainer(): VNode

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:279

Renders this button's value container.

Returns

VNode

This button's rendered value container.


simulatePressed()

simulatePressed(ignoreDisabled): void

Defined in: src/garminsdk/components/touchbutton/ValueTouchButton.tsx:130

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