Files
fvtt-hamalron/TAROT_HAND_TAB.md
2025-12-25 23:08:06 +01:00

105 lines
3.3 KiB
Markdown

# Onglet Main de Tarot - Fiche de Personnage
## Description
Un nouvel onglet a été ajouté à la fiche de personnage permettant d'afficher de manière graphique et élégante les cartes de tarot possédées par le joueur.
## Caractéristiques
### Affichage Graphique
- **Grille de Cartes** : Les cartes sont affichées dans une grille responsive (auto-fill avec minimum 250px par carte)
- **Cartes Détaillées** : Chaque carte affiche :
- Image de la carte
- Nom de la carte
- Symbole (Coupe, Épée, Denier, Bâton) avec code couleur
- Valeur
- Type (Atout, Figure, Numéro)
- Description enrichie (HTML)
### Interactions
- **Drag & Drop** : Les cartes peuvent être glissées depuis l'inventaire ou le compendium
- **Vue Détaillée** : Clic sur l'icône "œil" pour voir les détails de la carte
- **Suppression** : En mode édition, possibilité de supprimer une carte avec l'icône "poubelle"
- **Effet de Survol** : Les cartes se soulèvent légèrement au survol
### État Vide
Lorsqu'aucune carte n'est présente, un message d'accueil invite le joueur à glisser des cartes depuis le répertoire d'items.
## Styles et Thème
### Code Couleur des Symboles
- **Coupe** : Bleu (#3498db)
- **Épée** : Rouge (#e74c3c)
- **Denier** : Or (#f39c12)
- **Bâton** : Vert (#2ecc71)
### Design
- Cartes avec fond dégradé sombre et bordures arrondies
- Ombres portées pour effet de profondeur
- Animation au survol (translation verticale)
- Scrollbar personnalisée pour les descriptions longues
- Icônes Font Awesome pour une meilleure lisibilité
## Structure Technique
### Fichiers Créés
1. **templates/personnage-tarot.hbs**
- Template Handlebars pour l'onglet Tarot
- Affichage en grille des cartes
- Gestion de l'état vide
2. **styles/personnage-tarot.less**
- Styles LESS pour l'onglet
- Design responsive
- Animations et transitions
### Fichiers Modifiés
1. **module/applications/sheets/personnage-sheet.mjs**
- Ajout du PART "tarot"
- Ajout de l'onglet dans #getTabs()
- Préparation des données dans _preparePartContext()
- Enrichissement des descriptions HTML
2. **lang/en.json**
- Ajout des traductions :
- `HAMALRON.Label.tarotHand` : "Tarot Hand"
- `HAMALRON.Label.cards` : "Cards"
- `HAMALRON.Label.noTarotCards` : "No Tarot Cards"
- `HAMALRON.Label.dragTarotHere` : "Drag tarot cards here..."
- `HAMALRON.ViewDetails` : "View Details"
3. **styles/fvtt-hamalron.less**
- Import de personnage-tarot.less
## Utilisation
### Pour les Joueurs
1. Ouvrir la fiche de personnage
2. Cliquer sur l'onglet "Tarot Hand" (icône de cartes)
3. Glisser des cartes de tarot depuis :
- Le répertoire d'items
- Un compendium de tarots
- L'inventaire
### Pour les MJs
Les MJs peuvent utiliser le Gestionnaire de Deck de Tarot pour tirer des cartes et les distribuer aux joueurs via drag & drop.
## Intégration
L'onglet s'intègre parfaitement avec :
- Le système de drag & drop existant de Foundry VTT
- La gestion d'items du personnage
- Le mode édition/lecture de la fiche
- Les autres onglets du personnage
## Notes Techniques
- Les descriptions sont enrichies avec `TextEditor.enrichHTML()` pour supporter le formatage HTML
- Les cartes sont triées alphabétiquement par nom
- Le design est responsive et s'adapte aux différentes tailles d'écran
- Gestion propre de l'état vide avec message d'invitation