@atlaskit/progress-indicator
Version:
A progress indicator shows the user where they are along the steps of a journey.
52 lines (51 loc) • 1.5 kB
TypeScript
import type UIAnalyticsEvent from '@atlaskit/analytics-next/UIAnalyticsEvent';
import type { DotsAppearance, Size, Spacing } from './components/types';
export interface ProgressDotsProps {
/**
* Sets the color of the indicators.
*/
appearance?: DotsAppearance;
/**
* If interaction is enabled, use `ariaControls` to tell assistive technology what elements are controlled by the progress indicator.
*
* @default 'panel'
*/
ariaControls?: string;
/**
* Describes what the indicator represents to assistive technology. The selected index number will be appended to the label.
*
* @default 'tab'
*/
ariaLabel?: string;
/**
* Returns the accessible label for each selectable indicator.
*/
getAriaLabel?: (index: number) => string;
/**
* Function called when an indicator is selected.
*/
onSelect?: (eventData: {
event: React.MouseEvent<HTMLButtonElement>;
index: number;
}, analyticsEvent: UIAnalyticsEvent) => void;
/**
* Which indicator is currently selected.
*/
selectedIndex: number;
/**
* Sets the width and height of each indicator.
*/
size?: Size;
/**
* Specifies how much of a gutter there is between indicators.
*/
spacing?: Spacing;
/**
* A hook for automated tests.
*/
testId?: string;
/**
* An array of values mapped over to create the indicators.
*/
values: any[];
}