Options
All
  • Public
  • Public/Protected
  • All
Menu

Class SetupTour

A Tour subclass that handles controlling the UI state of the Setup screen

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

  • new SetupTour(config: any, __namedParameters?: { id: any; namespace: any }): SetupTour

  • Parameters

    • config: any
    • __namedParameters: { id: any; namespace: any } = {}
      • id: any
      • namespace: any

    Returns SetupTour

Properties

focusedApp

focusedApp: Application

Stores a currently open Application for future steps

config

config: TourConfig

targetElement

targetElement: HTMLElement

The HTMLElement which is the focus of the current tour step.

fadeElement

fadeElement: HTMLElement

The HTMLElement that fades out the rest of the screen

overlayElement

overlayElement: any

The HTMLElement that blocks input while a Tour is active

Private #id

#id: any

Private #namespace

#namespace: any

Static STATUS

STATUS: { UNSTARTED: string; IN_PROGRESS: string; COMPLETED: string } = ...

Type declaration

  • UNSTARTED: string
  • IN_PROGRESS: string
  • COMPLETED: string

Static HIGHLIGHT_PADDING

HIGHLIGHT_PADDING: number = 10

Padding around a Highlighted Element

Accessors

canStart

  • get canStart(): boolean
  • override

    Returns boolean

steps

  • override

    Returns TourStep[]

id

  • get id(): string
  • set id(value: string): void

  • The unique identifier of the tour.

    Returns string

  • The unique identifier of the tour.

    Parameters

    • value: string

    Returns void

title

  • get title(): string

  • The human-readable title for the tour.

    Returns string

description

  • get description(): string

  • The human-readable description of the tour.

    Returns string

namespace

  • get namespace(): string
  • set namespace(value: string): void

  • The package namespace for the tour.

    Returns string

  • The package namespace for the tour.

    Parameters

    • value: string

    Returns void

key

  • get key(): string

  • The key the Tour is stored under in game.tours, of the form ${namespace}.${id}

    Returns string

currentStep

  • Return the current Step, or null if the tour has not yet started.

    Returns TourStep

stepIndex

  • get stepIndex(): number

  • The index of the current step; -1 if the tour has not yet started, or null if the tour is finished.

    Returns number

hasNext

  • get hasNext(): boolean

  • Returns True if there is a next TourStep

    Returns boolean

hasPrevious

  • get hasPrevious(): boolean

  • Returns True if there is a previous TourStep

    Returns boolean

status

  • get status(): string

  • The current status of the Tour

    Returns string

Static tourInProgress

  • get tourInProgress(): boolean

  • Indicates if a Tour is currently in progress.

    Returns boolean

Static activeTour

  • get activeTour(): Tour

  • Returns the active Tour, if any

    Returns Tour

Methods

_preStep

  • _preStep(): Promise<void>

complete

  • complete(): Promise<any>

  • Advance the tour to a completed state.

    Returns Promise<any>

exit

  • exit(): void

  • Exit the tour at the current step.

    Returns void

reset

  • reset(): Promise<any>

  • Reset the Tour to an un-started state.

    Returns Promise<any>

start

  • start(): Promise<any>

  • Start the Tour at its current step, or at the beginning if the tour has not yet been started.

    Returns Promise<any>

next

  • next(): Promise<any>

  • Progress the Tour to the next step.

    Returns Promise<any>

previous

  • previous(): Promise<any>

  • Rewind the Tour to the previous step.

    Returns Promise<any>

progress

  • progress(stepIndex: number): Promise<any>

  • Progresses to a given Step

    Parameters

    • stepIndex: number

      The step to progress to

    Returns Promise<any>

_reloadProgress

  • _reloadProgress(): void

  • Reloads the Tour's current step from the saved progress

    internal

    Returns void

Protected _getTargetElement

  • _getTargetElement(selector: string): Element

  • Query the DOM for the target element using the provided selector

    Parameters

    • selector: string

      A CSS selector

    Returns Element

    The target element, or null if not found

Protected _postStep

  • _postStep(): Promise<void>

  • Clean-up operations performed after a step is completed.

    abstract

    Returns Promise<void>

Protected _renderStep

  • _renderStep(): Promise<void>

  • Renders the current Step of the Tour

    Returns Promise<void>

Private _installingASystem

  • _installingASystem(): Promise<void>

  • Handle Step setup for the Installing a System Tour

    Returns Promise<void>

Private _creatingAWorld

  • _creatingAWorld(): Promise<void>

  • Handle Step setup for the Creating a World Tour

    Returns Promise<void>

Static onMovementAction

  • onMovementAction(movementDirections: string[]): boolean

  • Handle a movement action to either progress or regress the Tour.

    Parameters

    • movementDirections: string[]

    Returns boolean

Static fromJSON

  • fromJSON(filepath: string): Promise<Tour>

  • Creates and returns a Tour by loading a JSON file

    Parameters

    • filepath: string

      The path to the JSON file

    Returns Promise<Tour>