Aller au contenu

Écrans

tilttek/table-safety-bundle

Les routes

RouteMéthode et cheminQui
tilttek_table_safety_tableGET /table-safety/{table}un participant
tilttek_table_safety_raisePOST /table-safety/{table}/signalsun participant
tilttek_table_safety_signalsGET /table-safety/{table}/signals?after=…un participant
tilttek_table_safety_acknowledgePOST /table-safety/{table}/signals/{id}/acknowledgele meneur de jeu
tilttek_table_safety_answersGET et POST /table-safety/{table}/answersun participant
tilttek_table_safety_session_zeroGET et POST /table-safety/{table}/session-zeroun participant
tilttek_table_safety_feedbackGET et POST /table-safety/{table}/feedback/{session}un participant
tilttek_table_safety_cardsGET /table-safety/{table}/cardsun participant
tilttek_table_safety_cards_pdfGET /table-safety/{table}/cards.pdfun participant, avec phil/paged-media
tilttek_table_safety_game_masterGET et POST /table-safety/{table}/game-masterle meneur de jeu

{table} est une référence de ressource comme table:7. Un lecteur que le TableAccess de l'application ne place pas à la table est refusé avec 403 ; chaque réponse est privée et jamais mise en cache. Les envois portent un jeton CSRF ; un formulaire refusé par la bibliothèque est montré de nouveau avec sa raison et le statut 422.

La table pendant la partie

table.html.twig montre un bouton par signal que le lecteur peut lever — le point d'étape pour le meneur de jeu seul, ses réponses tant qu'un point d'étape est ouvert —, chacun avec une phrase qui dit ce qu'il fait ; les signaux que voit toute la table ; et ce que la table a convenu. Un signal levé depuis la page y revient avec 303 ; depuis un script qui demande du JSON, il répond 201 et le signal.

Ce que la table a convenu, dans _agreement.html.twig, ne dit jamais qui a donné quelle réponse, et dépend du lecteur. Le meneur de jeu voit la liste protectrice : chaque ligne, chaque voile et chaque niveau de la liste dès la première réponse, pour qu'il les garde hors de la partie tout de suite. Les joueurs voient le sommaire montré aux gens, TableAgreement::shown(), par groupes entiers du seuil de réponses de la bibliothèque, 3 participants par défaut : en dessous, ils lisent seulement qu'il n'y a pas encore assez de réponses, et que le meneur voit déjà chaque ligne et chaque voile.

Les réponses d'un participant

answers.html.twig contient les lignes et voiles et la liste de consentement, un groupe de boutons radio par thème, groupés par catégorie, puis les thèmes propres à la table. session_zero.html.twig montre les questions de la table, avec une phrase et un lien qui renvoient un besoin de sécurité vers les lignes et voiles et la liste de consentement, que le meneur voit dès la première réponse, alors que les réponses de la séance zéro attendent un groupe de participants ; feedback.html.twig, deux zones de texte, une étoile ou un souhait par ligne. Chaque page dit qui voit les réponses.

L'écran du meneur de jeu

game_master.html.twig montre chaque signal — les discrets marqués comme tels —, chacun avec un bouton pour le marquer comme vu ; les réponses au dernier point d'étape, avec un avertissement quand quelqu'un a demandé de ralentir ou d'arrêter ; ce que la table a convenu ; le pacte ; les étoiles et souhaits d'une séance ; et le formulaire des réglages — outils, signaux nominatifs, qui voit les signaux, thèmes de la table, gabarit de la séance zéro et questions propres au meneur de jeu.

Les cartes imprimables

Une table jouée en personne préfère parfois des cartes sur papier. cards.html.twig montre, pour les outils que la table utilise, la carte X — un grand X avec une phrase qui dit ce qu'elle fait —, la feuille des lignes et voiles — une case pour une ligne et une pour un voile à côté de chaque thème — et la feuille de la liste de consentement — une case verte, une jaune et une rouge à côté de chaque thème. Les thèmes sont ceux de la table : ceux du catalogue par catégorie, puis ceux que la table a ajoutés. Les feuilles sont vierges, pour qu'un participant les remplisse à la main ; rien des réponses de personne n'est imprimé. La page n'a pas besoin de JavaScript ; chaque carte est une section de classe tilttek-table-safety__card, de sorte que la feuille de style d'impression de l'application commence chacune sur une nouvelle page :

@media print {
    .tilttek-table-safety--cards .tilttek-table-safety__card { break-after: page; }
    .tilttek-table-safety--cards nav, .tilttek-table-safety__print-help { display: none; }
}

Avec phil/paged-media installé, cards.pdf donne les mêmes cartes en PDF, sur des pages Letter, en Helvetica, avec les libellés dans la langue du lecteur ; la page y renvoie. Une table qui n'utilise aucun des trois outils n'a aucune carte, et son PDF est introuvable.

Les formulaires

Type de formulaireDonnées
ThemeAnswersTypela réponse de chaque thème, par catégorie ; ThemeAnswers la convertit en LinesAndVeils ou en ConsentChecklist
SessionZeroTypeles réponses par clé de question, pour Template::answer()
StarsAndWishesTypedeux textes, un élément par ligne
SafetyToolsTypeune liste de SafetyTool, jamais obligatoire : pour l'annonce d'une table
TableSettingsTypeles réglages ; TableSettingsType::settings() les convertit en TableSettings

Une application utilise SafetyToolsType dans son propre formulaire d'annonce d'une table : nommer les outils y est recommandé, jamais obligatoire.

Les recettes du kit

Les gabarits dessinent avec Card, Badge, Button et Alert ; table_safety_kit('Card:Title') nomme une recette telle que l'application l'a installée. table_safety_tools() énumère les outils pour une légende ou une annonce.

Le contrôleur Stimulus

tilttek--table-safety--signals se pose sur la liste des signaux. Il envoie en arrière-plan les formulaires marqués data-tilttek-table-safety-signal, de sorte que lever un signal ne recharge pas la page et ne fait pas perdre sa place ; s'abonne au hub quand il y en a un ; lit dans le fil les signaux manqués pendant que la connexion était perdue ; ajoute chaque nouveau signal une seule fois, et met à jour celui qui est marqué comme vu. Sans lui, chaque formulaire fonctionne comme un simple formulaire.

Accessibilité

  • Chaque signal est un bouton natif, atteint et activé au clavier, avec une phrase qui dit ce qu'il fait.
  • Chaque nouveau signal est annoncé dans une région vivante polie, par son genre et jamais par qui l'a levé.
  • Chaque section a un titre ; les réponses sont des boutons radio et des cases à cocher avec leurs étiquettes.
  • Sur les cartes imprimables, chaque feuille est un tableau avec une légende par catégorie et des en-têtes pour ses thèmes et ses cases ; chaque case est nommée par sa réponse.
  • La confirmation d'un formulaire enregistré est annoncée comme un statut.

Traductions

Les textes sont dans le domaine tilttek_table_safety, en anglais et en français, comme messages ICU ; les questions intégrées de la séance zéro sont session_zero.questions.<key> et leurs options session_zero.options.<question>.<option>.