Options
All
  • Public
  • Public/Protected
  • All
Menu

Class SidebarTour

A Tour subclass for the Sidebar Tour

Hierarchy

Index

Constructors

Methods

Properties

Accessors

Constructors

constructor

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

  • Parameters

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

    Returns SidebarTour

Methods

start

  • start(): Promise<void>
  • override

    Returns Promise<void>

_preStep

  • _preStep(): Promise<void>

_updateSidebarTab

  • _updateSidebarTab(): Promise<void>

  • Returns 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>

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>

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>

Properties

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

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

steps

  • The configuration of tour steps

    Returns TourStep[]

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

canStart

  • get canStart(): boolean

  • Return whether this Tour is currently eligible to be started? This is useful for tours which can only be used in certain circumstances, like if the canvas is active.

    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