Documentation technique — Datasheets Visualisator
Référence pour l’outil Datasheets Visualisator.
Résumé de l’application
- Interface mono-page dédiée à l’exploration des datasheets, organisée par rôles et factions.
- Recherche plein texte, filtres dédiés (fortifications, legends, forge world) et filtres par sources.
Sources de données
- Racine de données configurée via
data/datasheets. - Chargement des factions via
data/datasheets/factions.jsonet des sources viadata/datasheets/sources.json. - Les appels JSON sont exécutés avec
fetchetcache: "no-store"pour éviter les caches navigateur.
Organisation des rôles et filtrage
- Ordre des rôles imposé : Characters, Battleline, Dedicated Transport, Others, Fortifications, Legends, Forge World.
- Filtres optionnels pour afficher/masquer fortifications, legends et forge world.
- Recherche normalisée (minuscules et diacritiques) pour la correspondance texte.
Gestion des sources
- Catalogue de sources indexé par identifiant pour filtrer les datasheets par provenance.
- Détection des sources Legends ou Forge World via la chaîne de caractères du libellé de source.
- Support des formats hétérogènes (
source_id,sources, objets ou chaînes simples).
Sécurité et rendu HTML
- Nettoyage HTML strict via une whitelist de balises (ex:
strong,em,ul,a). - Suppression des attributs dangereux (
on*) et des liens JavaScript.
Points d’extension
- Ajouter des factions ou sources en complétant les fichiers JSON sous
data/datasheets. - Étendre l’ordre des rôles en ajustant la constante dédiée.
- Personnaliser l’affichage en modifiant les styles intégrés dans le fichier HTML.