JSPM

in-app-guide

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3
  • Score
    100M100P100Q6938F
  • License MIT

A walkthrough guide that allows users to interactively explore all the features within your application.

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

License: MIT

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

  1. Include the JavaScript code in your project.
  2. Set up the HTML elements for your tour steps.
  3. 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.