Aller au contenu
Aubui · Visite guidée (Waza)
Composants

Visite guidée (Waza)Nouveau

Pour montrer où cliquer plutôt que l’écrire : la page s’assombrit, un projecteur entoure l’élément et une bulle explique à quoi il sert. On avance pas à pas, au clavier ou à la souris.

Essayer

C’est le composant réel : la visite parcourt les titres de cette page.

Installer

Chargé à la demande (il ne pèse rien tant qu’on ne s’en sert pas). Sur le Hub et Share, un petit chargeur le récupère quand l’URL contient #waza-tour=… ou quand Kommand lance une visite :

HTML
<script src="https://ui.aubota.xyz/js/waza-tour.js" defer></script>

Écrire une visite (sans code)

Une visite = un fichier src.aubota.xyz/waza/tours/<id>.md. Elle est servie en JSON par https://hub.aubota.xyz/api/waza_tour.php?id=<id> et retrouvée par Kommand (/waza ta question) grâce au titre et aux mots.

Markdown
# Envoyer un fichier
page: https://share.aubota.xyz/holonet
mots: envoyer fichier transfert partager lien

## Dépose tes fichiers ici
cible: #drop-zone
Glisse un ou plusieurs fichiers dans cette zone.

## Règle la durée de vie du lien
cible: #share-ttl
ouvrir: oui
De 10 minutes à 7 jours.
LigneRôle
# TitreNom de la visite.
page:Page où elle se joue (https://*.aubota.xyz uniquement). Lancée d’ailleurs, la visite y emmène d’abord.
mots:Mots-clés pour la retrouver avec /waza.
## ÉtapeTitre de la bulle.
cible:Sélecteur CSS ; une liste a, b prend le premier trouvé (utile quand une page évolue).
ouvrir: ouiDéplie le <details> qui contient la cible.
texteExplication ; **gras** autorisé, tout le reste est échappé.

API window.WazaTour

AppelRôle
start(visite, depuis?)Lance une visite déjà chargée (objet {id, titre, page, etapes:[{titre, cible, ouvrir, texte}]}).
open(id)Charge la visite ; si elle se joue sur une autre page, y va (elle démarre à l’arrivée).
stop()Ferme la visite en cours.
xp()XP d’explorateur cumulée sur cet appareil (+10 par visite terminée la première fois).
Accessibilité
  • Bulle en role="dialog" + aria-modal, titre relié par aria-labelledby ; le focus va sur « Suivant » et reste dans la bulle (Tab / Maj+Tab).
  • Clavier : → ou Entrée = suivant, ← = précédent, Échap = quitter ; le focus revient où il était.
  • « Réduire les animations » respecté (pas de glissement ni de défilement doux).
  • Élément introuvable : la bulle se centre et le dit, au lieu de pointer dans le vide.