Aller au contenu

Célébrations

tilttek/quiz

La fin d'une partie est un moment à célébrer : des confettis pour un jeu-questionnaire terminé, des feux d'artifice pour un score parfait. La bibliothèque dit quand ; la page le joue, avec le composant de célébration du kit PHIL UX ou tout autre.

Les événements

ÉvénementQuandPorte
Event\QuizCompletedUne partie est terminée, ou une session en direct est terminée, pour chacun de ses joueursquiz, run, player, perfect, practice
Event\PerfectScoreAprès QuizCompleted, pour une partie où toutes les réponses sont bonnes et dans le temps ; à son rythme, une fois par jeu-questionnaire et par membre par défautquiz, run, player, practice
Event\LiveQuizFinishedUne session en direct est terminée, avant les événements de ses joueursquiz, session
Event\TeamWonUne session en direct jouée par équipes est terminée, pour chaque équipe au premier rang avec un score supérieur à 0quiz, session, team
Event\GuestInvitedUne session en direct est terminée, pour chaque invitésession, guest

run est la partie ou la session en direct. practice est vrai pour une partie à son rythme qui ne compte pas, le membre ayant déjà joué le jeu-questionnaire (voir Les parties qui comptent, et l'entraînement) ; il est toujours faux en direct. Un écouteur qui attribue des points ou un insigne laisse de côté l'entraînement. Chaque événement ne porte que des identifiants, jamais un pseudonyme : un écouteur qui envoie un message de Messenger, attribue des points ou pousse une mise à jour lit le reste dans les dépôts. Les gestes d'une session en direct — PlayerJoined, QuestionShown, QuestionClosed — sont décrits dans Jouer.

Le gabarit du résultat

templates/result.html.twig montre le résultat d'un joueur à partir d'un View\ResultView : le score sur le maximum que donne le jeu-questionnaire, le rang d'une partie en direct et, dans une session jouée par équipes, le rang de l'équipe du joueur. SelfPacedQuizzes::result() donne la vue de la partie d'un membre une fois qu'elle peut être montrée ; ResultView::ofPlay() montre une partie telle qu'elle est, quelle que soit la règle, et sert aux écrans propres à l'application. Enregistrez le dossier sous un espace de noms de l'application :

# config/packages/twig.yaml
twig:
    paths:
        '%kernel.project_dir%/vendor/tilttek/quiz/templates': TilttekQuiz
$view = $selfPaced->result('play-7', 'member:44');   // or ResultView::ofLive($session, $quiz, $player)

Le bloc summary contient le score, et le bloc celebration, vide par défaut, n'est dessiné que pour une partie terminée. Avec la célébration du kit :

{% embed '@TilttekQuiz/result.html.twig' with {result: view} %}
    {% block celebration %}
        <twig:Celebration message="{{ 'quiz.completed'|trans }}" :effect="result.perfect ? 'fireworks' : 'confetti'" :autoplay="true" />
    {% endblock %}
{% endembed %}

Le contrôleur Stimulus

Le gabarit porte le contrôleur tilttek--quiz--result, tiré du assets/package.json du paquet. Une fois la partie terminée, il envoie l'événement du DOM quiz:completed sur la fenêtre, puis quiz:perfect pour une partie parfaite, puis quiz:team-won quand l'équipe du joueur est parmi celles que nomme TeamWon ; leur détail contient quiz, run, perfect, team, vide sans équipes, et practice, vrai pour une partie d'entraînement. Il ne les envoie qu'une fois par partie dans un onglet du navigateur, pour que le retour sur la page ne les rejoue pas ; là où le navigateur refuse le stockage, il les envoie chaque fois. La recette du kit joue sur eux :

<twig:Celebration message="{{ 'quiz.perfect'|trans }}" effect="fireworks" data-action="quiz:perfect@window->celebration#play" />
<twig:Celebration message="{{ 'quiz.team_won'|trans }}" effect="confetti" data-action="quiz:team-won@window->celebration#play" />

La recette est celle du kit, employée telle quelle : la bibliothèque n'ajoute aucun composant à elle.

Accessibilité

La célébration du kit dit son message dans une région dynamique polie, ne dessine rien là où le mouvement est réduit, ne joue aucun son et dure quelques secondes au plus. Le score est du texte, dans des éléments data qu'un script peut lire ; les mots qui l'entourent sont ceux de l'application, dans sa langue.