sp-coach-indicator

Overview API

Overview

Section titled Overview

<sp-coach-indicator> shows the connection between an object and its explanation in a touring mode — for example, the source of a coachmark in an onboarding tour.

Usage

Section titled Usage

See it on NPM! How big is this package in your project?

yarn add @spectrum-web-components/coachmark

Import the side effectful registration of <sp-coach-indicator> via:

import '@spectrum-web-components/coachmark/sp-coach-indicator.js';

When looking to leverage the CoachIndicator base class as a type and/or for extension purposes, do so via:

import { CoachIndicator } from '@spectrum-web-components/coachmark';

Anatomy

Section titled Anatomy

A coach indicator consists of a single animated visual indicator.

<sp-coach-indicator></sp-coach-indicator>

Options

Section titled Options

Static Colors

Section titled Static Colors

Coach indicators support different static color options to ensure visibility against different backgrounds:

Standard
<sp-coach-indicator></sp-coach-indicator>
<sp-coach-indicator static-color="dark"></sp-coach-indicator>
<sp-coach-indicator static-color="light"></sp-coach-indicator>
Quiet

Accessibility

Section titled Accessibility

Coach indicators are typically paired with coachmarks to create accessible user onboarding experiences. When using coach indicators:

  • Ensure they are clearly visible against their background
  • Use appropriate static colors based on the background color
  • Pair them with descriptive coachmarks that explain the indicated UI element