Class OptionSelectUiHandler

Generic handler for a menu with several options to choose from with a cursor.

Given the proper OptionSelectModeConfig the handler will:

Measure the size of all elements in the menu, including the size of any icon.
Apply the required BBCode if an elements asks for a specific color.
Create the window of the appropriate size to hold all elements.
Handle scrolling through the menu items, resizing as needed.
Handle selecting the menu items, or cancelling out of the menu.

At initialization the size of the first NUM_PRE_COMPUTED_OPTIONS is measured.
Then the window's size is updated as needed when a non initialized option needs to be displayed.

Hierarchy (View Summary)

BaseOptionSelectUiHandler<OptionSelectItem>
- OptionSelectUiHandler

Constructors

constructor

new OptionSelectUiHandler(mode?: UiMode): OptionSelectUiHandler
Parameters
- mode: UiMode = UiMode.OPTION_SELECT
Returns OptionSelectUiHandler
Inherited from BaseOptionSelectUiHandler.constructor
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:69

Properties

active

active: boolean = false

`Protected`awaitingActionInput

awaitingActionInput: boolean

`Protected`blockInput

blockInput: boolean

`Protected`cursor

cursor: number = 0

`Protected`cursorObj

cursorObj: Image | null

`Protected`fullyInitialized

fullyInitialized: boolean

message

message: Text

`Protected` `Readonly`mode

mode: UiMode

Used to set the name of optionSelectContainer

`Protected`onActionInput

onActionInput: AnyFn<any> | null

`Protected`optionSelectBg

optionSelectBg: NineSlice

`Protected`optionSelectContainer

optionSelectContainer: Container

`Protected`optionSelectIcons

optionSelectIcons: Sprite[] = []

`Protected`optionSelectText

optionSelectText: BBCodeText

pendingPrompt

pendingPrompt: boolean = false

prompt

prompt: Sprite

`Protected`scale

scale: number = 0.1666666667

`Protected`scrollBar

scrollBar: ScrollBar | null

`Protected`scrollCursor

scrollCursor: number = 0

`Protected`textCallbackTimer

textCallbackTimer: TimerEvent | null

`Protected`textTimer

textTimer: TimerEvent | null

tutorialActive

tutorialActive: boolean = false

tutorialOverlay

tutorialOverlay: Rectangle

Accessors

`Protected`currentOption

get currentOption(): UIOptionSelectItem & T | undefined
Returns UIOptionSelectItem & T | undefined
Inherited from BaseOptionSelectUiHandler.currentOption
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:65

`Protected`windowHeight

get windowHeight(): number
Returns number
Inherited from BaseOptionSelectUiHandler.windowHeight
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:61

Methods

destroy

destroy(): void
To be implemented by individual handlers when necessary to free memory Called when BattleScene is reset

Returns void
Inherited from BaseOptionSelectUiHandler.destroy
- Defined in src/ui/handlers/ui-handler.ts:54

`Protected`displayCurrentOptions

displayCurrentOptions(skipResizing?: boolean): void
Display the current options based on the cursor and scroll cursor.
Parameters
- skipResizing: boolean = false
  (Default false) Whether to skip the automatic resizing step
Returns void

Remarks
Can handle automatic resizing of the menu window as needed.
Inherited from BaseOptionSelectUiHandler.displayCurrentOptions
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:332

getCursor

getCursor(): number
Returns number
Inherited from BaseOptionSelectUiHandler.getCursor
- Defined in src/ui/handlers/ui-handler.ts:25

getUi

getUi(): UI
Returns UI
Inherited from BaseOptionSelectUiHandler.getUi
- Defined in src/ui/handlers/ui-handler.ts:21

`Protected`initCursor

initCursor(): void
Initializes the cursor when opening the menu. MUST only be called after this.initOptions()!

Returns void
Inherited from BaseOptionSelectUiHandler.initCursor
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:476

`Protected`initializeOption

initializeOption(
    option: UIOptionSelectItem & OptionSelectItem,
    singleSpaceWidth: number,
    tempSprite: Sprite,
): void
Readies the given UIOptionSelectItem for display.
Parameters
- option: UIOptionSelectItem & OptionSelectItem
  The UIOptionSelectItem to consider
- singleSpaceWidth: number
  The width of a single space, used to offset the label if there is a icon to show
- tempSprite: Sprite
  A Sprite object that can be used to measure the needed space of the item's icon, if any
Returns void

Remarks
For options with icon(s), adds the appropriate number of space before the label to give the sprite the space it needs

For options with color, adds the appropriate BBCode to the label
Inherited from BaseOptionSelectUiHandler.initializeOption
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:289

initPromptSprite

initPromptSprite(container: Container): void
Add the sprite to be displayed at the end of messages with prompts
Parameters
- container: Container
  the container to add the sprite to
Returns void
Inherited from BaseOptionSelectUiHandler.initPromptSprite
- Defined in src/ui/handlers/message-ui-handler.ts:18

initTutorialOverlay

initTutorialOverlay(container: Container): void
Create a semi transparent overlay that will get shown during tutorials
Parameters
- container: Container
  the container to add the overlay to
Returns void
Inherited from BaseOptionSelectUiHandler.initTutorialOverlay
- Defined in src/ui/handlers/awaitable-ui-handler.ts:32

isTextAnimationInProgress

isTextAnimationInProgress(): boolean
Returns boolean
Inherited from BaseOptionSelectUiHandler.isTextAnimationInProgress
- Defined in src/ui/handlers/message-ui-handler.ts:253

processInput

processInput(button: Button): boolean
Parameters
- button: Button
Returns boolean
Inherited from BaseOptionSelectUiHandler.processInput
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:377

processTutorialInput

processTutorialInput(button: Button): boolean
Parameters
- button: Button
Returns boolean
Inherited from BaseOptionSelectUiHandler.processTutorialInput
- Defined in src/ui/handlers/awaitable-ui-handler.ts:15

setCursor

setCursor(cursor: number): boolean
Parameters
- cursor: number
Returns boolean
Inherited from BaseOptionSelectUiHandler.setCursor
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:499

`Protected`setMouseCursorStyle

setMouseCursorStyle(cursorStyle: "default" | "pointer"): void
Changes the style of the mouse cursor.
Parameters
- cursorStyle: "default" | "pointer"
  cursor style to apply
Returns void

See
https://developer.mozilla.org/en-US/docs/Web/CSS/cursor
Inherited from BaseOptionSelectUiHandler.setMouseCursorStyle
- Defined in src/ui/handlers/ui-handler.ts:43

`Protected`setScrollCursor

setScrollCursor(scrollCursor: number): boolean
Parameters
- scrollCursor: number
Returns boolean
Inherited from BaseOptionSelectUiHandler.setScrollCursor
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:522

setup

setup(): void
Returns void
Inherited from BaseOptionSelectUiHandler.setup
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:75

show

show(args: any[]): boolean
Parameters
- args: any[]
Returns boolean
Inherited from BaseOptionSelectUiHandler.show
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:99

showDialogue

showDialogue(
    text: string,
    _name?: string,
    delay?: number | null,
    callback?: (() => void) | null,
    callbackDelay?: number | null,
    prompt?: boolean | null,
    promptDelay?: number | null,
): void
Parameters
- text: string
- Optional_name: string
- Optionaldelay: number | null
- Optionalcallback: (() => void) | null
- OptionalcallbackDelay: number | null
- Optionalprompt: boolean | null
- OptionalpromptDelay: number | null
Returns void
Inherited from BaseOptionSelectUiHandler.showDialogue
- Defined in src/ui/handlers/message-ui-handler.ts:42

showPrompt

showPrompt(callback?: (() => void) | null, callbackDelay?: number | null): void
Parameters
- Optionalcallback: (() => void) | null
- OptionalcallbackDelay: number | null
Returns void
Inherited from BaseOptionSelectUiHandler.showPrompt
- Defined in src/ui/handlers/message-ui-handler.ts:216

showText

showText(
    text: string,
    delay?: number | null,
    callback?: (() => void) | null,
    callbackDelay?: number | null,
    prompt?: boolean | null,
    promptDelay?: number | null,
): void
Parameters
- text: string
- Optionaldelay: number | null
- Optionalcallback: (() => void) | null
- OptionalcallbackDelay: number | null
- Optionalprompt: boolean | null
- OptionalpromptDelay: number | null
Returns void
Inherited from BaseOptionSelectUiHandler.showText
- Defined in src/ui/handlers/message-ui-handler.ts:31

`Protected`unblockInput

unblockInput(): void
Returns void
Inherited from BaseOptionSelectUiHandler.unblockInput
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:465

`Protected`updateSizeForOptions

updateSizeForOptions(options: (UIOptionSelectItem & OptionSelectItem)[]): void
Automatically set the menu's size for the given options.
Parameters
- options: (UIOptionSelectItem & OptionSelectItem)[]
  Array of UIOptionSelectItems to consider
Returns void

Remarks
Preserves the current size if they are all smaller, otherwise expands as needed.
Inherited from BaseOptionSelectUiHandler.updateSizeForOptions
- Defined in src/ui/handlers/base-option-select-ui-handler.ts:176

Class OptionSelectUiHandler

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns OptionSelectUiHandler

Properties

active

ProtectedawaitingActionInput

ProtectedblockInput

Protectedcursor

ProtectedcursorObj

ProtectedfullyInitialized

message

Protected Readonlymode

ProtectedonActionInput

ProtectedoptionSelectBg

ProtectedoptionSelectContainer

ProtectedoptionSelectIcons

ProtectedoptionSelectText

pendingPrompt

prompt

Protectedscale

ProtectedscrollBar

ProtectedscrollCursor

ProtectedtextCallbackTimer

ProtectedtextTimer

tutorialActive

tutorialOverlay

Accessors

ProtectedcurrentOption

Returns UIOptionSelectItem & T | undefined

ProtectedwindowHeight

Returns number

Methods

clear

Returns void

ProtectedclearCursor

Returns void

ProtectedclearIconSprites

Returns void

ProtectedclearScrollBar

Returns void

clearText

Returns void

destroy

Returns void

ProtecteddisplayCurrentOptions

Parameters

Returns void

Remarks

getCursor

Returns number

getUi

Returns UI

ProtectedinitCursor

Returns void

ProtectedinitializeOption

Parameters

Returns void

Remarks

initPromptSprite

Parameters

Returns void

initTutorialOverlay

Parameters

Returns void

isTextAnimationInProgress

Returns boolean

processInput

Parameters

Returns boolean

processTutorialInput

Parameters

Returns boolean

`Protected`awaitingActionInput

`Protected`blockInput

`Protected`cursor

`Protected`cursorObj

`Protected`fullyInitialized

`Protected` `Readonly`mode

`Protected`onActionInput

`Protected`optionSelectBg

`Protected`optionSelectContainer

`Protected`optionSelectIcons

`Protected`optionSelectText

`Protected`scale

`Protected`scrollBar

`Protected`scrollCursor

`Protected`textCallbackTimer

`Protected`textTimer

`Protected`currentOption

`Protected`windowHeight

`Protected`clearCursor

`Protected`clearIconSprites

`Protected`clearScrollBar

`Protected`displayCurrentOptions

`Protected`initCursor

`Protected`initializeOption

`Protected`setMouseCursorStyle

`Protected`setScrollCursor

`Protected`unblockInput

`Protected`updateSizeForOptions