BjTour — React

Composant React pour créer une visite guidée pas à pas de l'interface.

Utilisation

import { useState } from 'react'
import { BjTour } from '@flrxnt/dsbj/react'

const steps = [
  { target: '#step-1', title: 'Bienvenue', content: 'Première étape.', placement: 'bottom' },
  { target: '#step-2', title: 'Suite', content: 'Deuxième étape.', placement: 'right' },
]

function App() {
  const [open, setOpen] = useState(false)

  return (
    <>
      <button className="bj-btn" onClick={() => setOpen(true)}>
        Démarrer la visite
      </button>
      <BjTour
        steps={steps}
        open={open}
        onOpenChange={setOpen}
      />
    </>
  )
}

Aperçu interactif

Étape 1Étape 2Étape 3

Props

ClasseDescription
stepsTableau d'objets { target, title, content, placement? } décrivant les étapes.
openÉtat ouvert/fermé du tour.
onOpenChangeCallback déclenché à l'ouverture ou fermeture.
onChangeCallback déclenché au changement d'étape. Paramètre : { step, total }.
onStartCallback déclenché au démarrage de la visite.
onEndCallback déclenché à la fin de la visite.

Accessibilité

Le popover possède role="dialog". Le focus est piégé pendant la visite. Navigation au clavier : Flèche droite (suivant), Flèche gauche (précédent), Échap (fermer). Le focus est restauré après fermeture.