Package Exports
- in-app-guide
- in-app-guide/src/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (in-app-guide) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
In-App Guide
A walkthrough guide that allows users to interactively explore all the features within your application.
Installation
To install the in-app-guide
package, you can use the following npm command:
npm install in-app-guide
Usage
- Include the JavaScript code in your project.
- Set up the HTML elements for your tour steps.
- Call the
initializeTour
function with the tour data to start the tour.
vanilla javascript
// Import the in-app-guide module
const inAppGuide = require('in-app-guide');
// Initialize tour data
const userTourData = [
// ... (user-provided tour data similar to the existing structure)
];
inAppGuide.initializeTourData(userTourData);
// Start the tour (assuming startOnLoad is true)
inAppGuide.showStep(inAppGuide.currentStep);
React
import React, { useEffect } from 'react';
import inAppGuide from 'in-app-guide';
// Initialize tour data
const userTourData = [
// ... (user-provided tour data similar to the existing structure)
];
inAppGuide.initializeTourData(userTourData);
const App = () => {
useEffect(() => {
// Start the tour when the component mounts
inAppGuide.showStep(inAppGuide.currentStep);
// Cleanup when the component unmounts
return () => {
// ... (any cleanup logic)
};
}, []);
return (
<div>
{/* Your React app content */}
</div>
);
};
export default App;
Tour Data
The tour data is an array of objects, each representing a step in the tour. Each object has the following properties:
target
: The HTML element ID to highlight during the step.title
: Title for the tour step.description
: Description for the tour step.position
: Position of the tooltip relative to the target element.
Example
// Example tour data
const userTourData = [
{
target: "element1",
title: "Step 1: Introduction",
description: "Welcome to our website! This is the first step of the tour.",
position: "bottom-center",
},
// ... (other tour steps)
];
// Call the initializeTour function with the user-provided data
initializeTour(userTourData);
LICENSE
This project is licensed under the MIT License - see the LICENSE file for details.