Class ThreeVirtualKeyboardRoot

A VirtualKeyboardRoot but it extends ThreeRoot instead of Root, so it can be used for three.js.

Hierarchy

Constructors

constructor

Properties

_currentPointerStyle _enabled _foci _fociCapturers _mobileTextInUse drivers keyboardDriver mesh object pointerStyle pointerStyleHandler textInputHandler transformAlgorithm viewport

Accessors

canvas canvasDimensions child constraints dimensions effectiveScale enabled hasMobileTextInput maxCanvasHeight maxCanvasWidth preventBleeding resolution usingMobileTextInput

Methods

clearDrivers clearFocus destroy dispatchEvent dropFoci dropFocus getFocus getFocusCapturer getTextInput paint postLayoutUpdate preLayoutUpdate registerDriver requestFocus resolveLayout unregisterDriver updatePointerStyle updateVisibility

Constructors

constructor

Properties

Protected _currentPointerStyle

_currentPointerStyle: string

The actual current pointer style.

For internal use only.

See Root#pointerStyle

Protected _enabled

_enabled: boolean

Is the Root enabled? For internal use only.

See Root#enabled

Protected _foci

_foci: Map<FocusType, null | Widget>

Current component foci (event targets for each focus type).

For internal use only.

See Root#requestFocus, Root#dropFocus, Root#clearFocus and Root#getFocus

Protected _fociCapturers

_fociCapturers: Map<FocusType, null | Widget>

Last capturer of each component focus (event targets for each focus type).

For internal use only.

See Root#getFocusCapturer

Protected _mobileTextInUse

_mobileTextInUse: boolean

Is the mobile-friendly text input in use?

For internal use only.

See Root#hasMobileTextInput, Root#usingMobileTextInput and Root#getTextInput

Protected drivers

drivers: Set<Driver>

The list of drivers registered to this root

Private Readonly keyboardDriver

keyboardDriver: KeyboardDriver

The KeyboardDriver used by this root's virtual keyboard.

Readonly mesh

mesh: Mesh<BufferGeometry, Material | Material[]>

The mesh used for rendering the canvas. Saved so that its scale can be changed later.

Readonly object

object: Object3D<Event>

An object that contains the canvas' mesh which can be added to a scene. Not actually a Mesh, but an Object3D which contains a mesh, so that the mesh can be resized without interfering with the transformAlgorithm.

pointerStyle

pointerStyle: string

The pointer style this root wants. Will be set on Root#postLayoutUpdate by Root#pointerStyleHandler

pointerStyleHandler

pointerStyleHandler: null | PointerStyleHandler

Pointer style handler, decides how to show the given pointer style. Normally a function which sets the CSS cursor style of the Root's canvas

textInputHandler

textInputHandler: null | TextInputHandler

Handler for mobile-friendly text input. If not null, widgets that need text may call this to get a string.

See Root#hasMobileTextInput, Root#usingMobileTextInput and Root#getTextInput

transformAlgorithm

transformAlgorithm: null | TransformAlgorithm

Transform algorithm; decides how to position the canvas' mesh in the world. Can be changed later and is called on update.

Protected viewport

viewport: CanvasViewport

The internal viewport. Manages drawing

Accessors

canvas

  • get canvas(): HTMLCanvasElement

  • The Root#viewport's CanvasViewport#canvas | canvas

    Returns HTMLCanvasElement

canvasDimensions

  • get canvasDimensions(): [number, number]

  • The Root#viewport's CanvasViewport#canvasDimensions | canvasDimensions

    Returns [number, number]

child

  • get child(): Widget

  • The root widget of this UI tree. Equivalent to getting Root#viewport.Viewport#child.

    Returns Widget

constraints

  • get constraints(): LayoutConstraints

  • The Root#viewport's Viewport#constraints | constraints

    Returns LayoutConstraints

  • set constraints(constraints: LayoutConstraints): void

  • Parameters

    Returns void

dimensions

  • get dimensions(): [number, number]

  • The Root#child's Widget#dimensions | dimensions

    Returns [number, number]

effectiveScale

  • get effectiveScale(): [scaleX: number, scaleY: number]

  • Get the scale used for the Root#viewport. The horizontal and/or vertical scale may not be 1 if Root#maxCanvasWidth or Root#maxCanvasHeight are exceeded.

    Note that this is only valid after resolving Root#child's layout.

    Equivalent to getting Viewport#effectiveScale on Root#viewport.

    Returns [scaleX: number, scaleY: number]

enabled

  • get enabled(): boolean

  • Returns boolean

  • set enabled(enabled: boolean): void

  • Parameters

    • enabled: boolean

    Returns void

hasMobileTextInput

  • get hasMobileTextInput(): boolean

  • Can Root#getTextInput be called? True if Root#textInputHandler is not null and Root#usingMobileTextInput is false.

    Returns boolean

maxCanvasHeight

  • get maxCanvasHeight(): number

  • Shortcut for Root#viewport's CanvasViewport#maxCanvasHeight property

    Returns number

  • set maxCanvasHeight(maxCanvasHeight: number): void

  • Parameters

    • maxCanvasHeight: number

    Returns void

maxCanvasWidth

  • get maxCanvasWidth(): number

  • Shortcut for Root#viewport's CanvasViewport#maxCanvasWidth property

    Returns number

  • set maxCanvasWidth(maxCanvasWidth: number): void

  • Parameters

    • maxCanvasWidth: number

    Returns void

preventBleeding

  • get preventBleeding(): boolean

  • Shortcut for Root#viewport's CanvasViewport#preventBleeding property.

    Returns boolean

  • set preventBleeding(preventBleeding: boolean): void

  • Parameters

    • preventBleeding: boolean

    Returns void

resolution

  • get resolution(): number

  • Shortcut for Root#viewport's CanvasViewport#resolution property.

    Note that, although the resolution is part of the CanvasViewport API, widgets will treat the resolution property as being per-Root, not per-Viewport (hence the lack of a Viewport.resolution property). The resolution property is part of the CanvasViewport class so that CanvasViewport is not circularly dependent on the Root class.

    Returns number

  • set resolution(resolution: number): void

  • Parameters

    • resolution: number

    Returns void

usingMobileTextInput

  • get usingMobileTextInput(): boolean

  • Is Root#getTextInput in use?

    See Root#_mobileTextInUse.

    Returns boolean

Methods

clearDrivers

  • Unregisters all Root#drivers from the root, by calling Root#unregisterDriver.

    Returns void

clearFocus

  • Clears the current Root#_foci | focus of a given type. If there was a focus set, Root#drivers are notified by calling Driver#onFocusChanged.

    Parameters

    Returns void

destroy

  • Cleans up resources used by the Root.

    It's the user's responsibility that the object is removed from all scenes. canvas-ui-three has no knowledge about the available scenes.

    See

    the Root#destroy documentation for more details

    Returns void

dispatchEvent

  • Dispatches an Event to this root's Root#child by calling Widget#dispatchEvent. Updates Root#_fociCapturers | foci capturers and notifies Root#drivers by calling Driver#onFocusCapturerChanged if the capturer changes. Does nothing if root is disabled.

    Note that if an event with a focus is dispatched and no widget captures the event due to the widget not existing anymore or being disabled, the focus type of the event will be cleared in the root with Root#clearFocus.

    Returns

    Returns true if the event was captured

    Parameters

    Returns boolean

dropFoci

  • Clears all the Root#_foci | foci that are set to a given Widget. Achieved by calling Root#dropFocus

    Parameters

    Returns void

dropFocus

  • Clears the current Root#_foci | focus of a given type if it is currently set to a given widget. Achieved by calling Root#clearFocus.

    Parameters

    Returns void

getFocus

  • Gets the current Root#_foci | focus of a given type.

    Parameters

    Returns null | Widget

getFocusCapturer

  • Gets the last Root#_fociCapturers | focus capturer of a given type.

    Parameters

    Returns null | Widget

getTextInput

  • Get text input from the user. Used for mobile where keyboard events are hard to get.

    Returns

    If this is already in use (Root#usingMobileTextInput), returns null, else, returns a string typed by the user.

    Parameters

    • Optional initialInput: string

    Returns Promise<null | string>

paint

postLayoutUpdate

  • Do a post-layout update; calls Root#child's Widget#postLayoutUpdate and Root#updatePointerStyle. Does nothing if root is disabled.

    Call this before calling Root#paint and after calling Root#resolveLayout

    Returns void

preLayoutUpdate

  • Do a pre-layout update; calls Root#drivers' Driver#update and Root#child's Widget#preLayoutUpdate. Does nothing if root is disabled.

    Call this before calling Root#resolveLayout

    Returns void

registerDriver

  • Registers a Driver to the root, adding it to the Root#drivers list and calling Driver#onEnable. If the driver was already registered, nothing happens.

    Parameters

    Returns void

requestFocus

  • Sets the current Root#_foci | focus of a given type to a given widget. If the focus changes, Root#clearFocus is called and Root#drivers are notified by calling Driver#onFocusChanged.

    Parameters

    Returns void

resolveLayout

unregisterDriver

  • Unregisters a Driver from the root, removing it from the Root#drivers list and calling Driver#onDisable. If the driver was not registered, nothing happens.

    Parameters

    Returns void

updatePointerStyle

  • Calls Root#pointerStyleHandler if the Root#pointerStyle has changed (checked by comparing with Root#_currentPointerStyle). Also updates Root#_currentPointerStyle. Can also be optionally supplied a new pointer style.

    Parameters

    • Optional newStyle: null | string

    Returns void

updateVisibility

  • Update the visibility of this root; if the keyboard driver has no focused root, then the root is disabled, else, it is enabled. Call this method on every frame to automatically enable/disable the root if needed

    Returns void

Settings

Member Visibility

Theme

Generated using TypeDoc