Aller au contenu

La surcouche

tilttek/dice-tower
{{ dice_tower('table:7', {'member:42': 'Aelis', 'member:43': 'Brom'}) }}
{{ dice_tower(table, names, title: 'The tower', announce: false) }}

dice_tower(table, names, title, announce) dessine la tour d'une table pour un spectateur que le TableAccess de l'application autorise, et rien pour un autre. La table est une ResourceReference ou sa chaîne. Les noms sont ceux des lanceurs que la page peut montrer, par référence : ils n'atteignent que la page du spectateur. Le titre remplace celui qui est traduit. Avec announce à faux, la liste n'est pas une région dynamique : une interface de dés accessible sur la même page annonce plutôt les jets.

Dessiner la surcouche donne au spectateur l'abonnement au sujet de la table, dans le témoin d'autorisation de la réponse.

Ce qu'elle dessine

Une carte du kit UX, son titre, et les dernières entrées de la tour sous forme de liste ordonnée — une région log que les lecteurs d'écran lisent à mesure qu'elle grandit, sauf si announce est faux. Chaque entrée donne le nom du lanceur quand la page le connaît, l'expression de chaque instruction avec son total ou ce qu'elle a donné, et chaque dé : la face d'un dé personnalisé par son libellé, les mots que dit un lecteur d'écran, et un dé qui n'a pas compté suivi de « not counted » dans la langue de la page, pas seulement d'un style. Une tour vide le dit, et une ligne d'état dit quand la connexion est perdue.

Les classes sont des crochets pour la feuille de style de l'application :

ClasseÉlément
tilttek-dice-towerLa carte
tilttek-dice-tower__entriesLa liste
tilttek-dice-tower__entryUne entrée, avec son data-position
tilttek-dice-tower__rollerLe nom du lanceur
tilttek-dice-tower__resultUne instruction
tilttek-dice-tower__dice, tilttek-dice-tower__die, is-droppedLes dés, un dé, un dé qui n'a pas compté
tilttek-dice-tower__empty, tilttek-dice-tower__statusLa tour vide, l'état de la connexion

Le contrôleur Stimulus

Le contrôleur tilttek--dice-tower--tower s'abonne au sujet de la table, avec le témoin du spectateur, et ajoute chaque nouvelle entrée une seule fois et dans l'ordre. Quand l'abonnement s'ouvre — la première fois, et chaque fois qu'il revient — il lit les entrées qui suivent la dernière position qu'il montre depuis la route des entrées manquées, en retenant les entrées en direct jusqu'à ce qu'elles soient lues ; puis il les ajoute toutes, sans doublons. Il garde les 200 dernières entrées sur la page.

ValeurCe qu'elle contient
hubL'URL où s'abonner ; aucune sans hub
entries-urlLa route des entrées manquées ; aucune sans la route
lastLa dernière position que la page montre
facesLes libellés des faces des dés personnalisés, par dé et par face
namesLes noms des lanceurs, par référence
dropped, offlineLes mots d'un dé qui n'a pas compté, et d'une connexion perdue
limitCombien d'entrées la page garde, 200 par défaut

Son événement

Chaque nouvelle entrée est émise sur l'élément sous le nom tilttek--dice-tower--tower:drop, qui remonte jusqu'à la fenêtre, avec :

DétailCe qu'il contient
entryL'entrée, telle que le hub l'a poussée
viewCe que la surcouche en montre : le nom, et chaque instruction avec ses dés par libellé
textL'entrée en une phrase : Aelis: 2d6+1 = 8 (4, 3)

Une interface de dés accessible l'annonce, une table de sons joue un son, un compteur compte :

<div data-action="tilttek--dice-tower--tower:drop@window->my-listener#handle"></div>