nextstepjs
Version:
Lightweight onboarding library for Next.js
39 lines (38 loc) • 2.75 kB
TypeScript
import React from 'react';
import { NextStepProps } from './types';
/**
* NextStepReact component for rendering the onboarding steps.
*
* This component handles the display of the onboarding steps, including the card and pointer.
* It manages the visibility of the onboarding overlay and handles navigation between steps.
*
* @param {React.ReactNode} children - The content to be displayed within the onboarding context.
* @param {Array} steps - An array of steps to be displayed, each containing information for the onboarding process.
* @param {string} [shadowRgb='0, 0, 0'] - The RGB value for the shadow effect surrounding the target area (default: '0, 0, 0').
* @param {string} [shadowOpacity='0.2'] - The opacity of the shadow effect (default: '0.2').
* @param {object} [cardTransition={ ease: 'anticipate', duration: 0.6 }] - Transition settings for the card animation, including easing and duration (default: { ease: 'anticipate', duration: 0.6 }).
* @param {React.ComponentType} [cardComponent] - Custom component for rendering the card, allowing for design flexibility.
* @param {function} [onStart] - Callback function triggered when the onboarding process starts (default: () => {}).
* @param {function} [onStepChange] - Callback function triggered when the step changes, providing the current step index (default: () => {}).
* @param {function} [onComplete] - Callback function triggered when the onboarding process is completed (default: () => {}).
* @param {function} [onSkip] - Callback function triggered when the user skips the onboarding process (default: () => {}).
* @param {boolean} [displayArrow=true] - Flag to display navigation arrows in the onboarding steps (default: true).
* @param {boolean} [clickThroughOverlay=false] - Flag to enable click-through on the overlay, allowing interaction with underlying elements (default: false).
* @param {function} [navigationAdapter=useWindowAdapter] - Custom navigation adapter function for routing (default: useWindowAdapter).
* @param {boolean} [disableConsoleLogs=false] - Flag to disable console logs for debugging purposes (default: false).
* @param {boolean} [scrollToTop=true] - Flag to scroll to the top of the page when the onboarding process ends (default: true).
* @param {boolean} [noInViewScroll=false] - Flag to disable scrolling to the target element when it comes into view (default: false).
*
* @returns {JSX.Element} The rendered NextStepReact component.
*
* @example
* <NextStepReact
* steps={steps}
* onStart={() => console.log('Tour started')}
* onComplete={() => console.log('Tour completed')}
* >
* <YourAppContent />
* </NextStepReact>
*/
declare const NextStepReact: React.FC<NextStepProps>;
export default NextStepReact;