Superpositions & Dialogues
Les superpositions et les dialogues sont des cadres qui se trouvent au-dessus de votre expérience et restent à l'écran pendant que les cadres et essais en dessous changent. Un cadre normal vit dans la chronologie des essais : il apparaît lorsque l'essai l'atteint et disparaît lorsque l'essai se poursuit. Une superposition ou un dialogue vit en dehors de la chronologie. Il est monté tant que sa portée dure (un essai, une tâche ou toute la session), et des événements peuvent le montrer ou le cacher à tout moment.
Table des matières
Il y a deux types :
- Superposition : superposée au-dessus de l'expérience. Les participants continuent d'utiliser l'expérience en dessous, et seuls les objets sur la superposition capturent les clics. Utilisez-le pour un minuteur, un affichage de score ou de progrès, un bouton d'aide ou tout élément qui doit rester visible entre les essais.
- Dialogue : une fenêtre popup au-dessus de l'expérience. Par défaut, il bloque et assombrit l'expérience derrière lui jusqu'à ce qu'il soit fermé. Utilisez-le pour des textes d'aide, des instructions au milieu d'une tâche, des confirmations ou des messages conditionnels.
Créer des superpositions et des dialogues nécessite la fonction de licence Overlays & Dialogs, qui est incluse à partir du niveau de licence de base. Avec une licence gratuite, cliquer sur Canvas ou Page dans l'onglet Overlays & Dialogs ouvre le dialogue de mise à niveau de licence.
Ajouter une superposition ou un dialogue
- Ouvrez une tâche dans l'éditeur de tâches.
- Dans le panneau en dessous du cadre, cliquez sur l'onglet
Overlays & Dialogs(à côté deTrial Timeline). - Cliquez sur
CanvasouPage.
Les deux boutons commencent avec des paramètres par défaut différents. Vous pouvez les changer tous par la suite.
| Ajouté avec | Type | État initial | Autres paramètres par défaut | Nom par défaut |
|---|---|---|---|---|
Canvas | Superposition | Shown | Match task display mise à l'échelle, Transparent (see-through) remplissage | Overlay_1, Overlay_2, etc. |
Page | Dialogue | Hidden | Centered placement, bloque et assombrit l'expérience derrière lui, peut être déplacé, avec un bouton de fermeture | Dialog_1, Dialog_2, etc. |
Les deux commencent avec la portée This task. Le nouveau cadre est sélectionné et vous l'éditez comme n'importe quel cadre canvas ou cadre de page : ajoutez des objets depuis la barre d'outils, organisez-les et ajoutez des événements cadres. L'onglet offre Canvas et Page uniquement, donc un cadre de site web ne peut pas être ajouté en tant que superposition.
Pour supprimer une superposition ou un dialogue, utilisez l'icône Delete Frame sur son entrée dans le panneau Overlays & Dialogs.
Ouvrir les paramètres
Sélectionnez la superposition ou le dialogue dans le panneau Overlays & Dialogs. Le panneau Frame Settings (le panneau Page Settings pour une page) montre alors une barre de résumé, par exemple Overlay · task · match task, avec une icône d'engrenage. Cliquez dessus pour ouvrir le volet des paramètres. Fermez le volet avec le ✕ dans son en-tête ou en cliquant en dehors de celui-ci.
Les paramètres de cadre Duration, Color et Hide Mouse ne sont pas affichés pour les superpositions et dialogues. Ils ne progressent jamais d'eux-mêmes, leur couleur de fond est définie dans le volet, et le curseur de la souris est contrôlé par le cadre en dessous.
Type, Portée et État initial
Le groupe Type du volet :
| Paramètre | Options | Remarques |
|---|---|---|
Type | Overlay (layered on top), Dialog (popup window) | Peut être changé à tout moment. Le groupe Style change avec lui. |
Scope | This trial, This task, Whole session | Combien de temps le cadre reste monté. Voir Portée. Une superposition Whole session est listée dans le panneau Overlays & Dialogs de chaque tâche. |
Initial state | Shown, Hidden | Si le cadre est visible lorsqu'il est monté. Choisissez Hidden si un événement doit le montrer plus tard. |
Also run trial events on it | Case à cocher, désactivée par défaut | Laissez-la désactivée sauf si vous en avez besoin. Lorsqu'elle est activée, les événements d'essai de la tâche fonctionnent sur le cadre en dessous et sur la superposition, donc ils peuvent se produire deux fois. Un basculement reviendrait alors directement en arrière. |
Style de superposition
Ces paramètres apparaissent lorsque Type est Overlay (layered on top).
| Paramètre | Options | Remarques |
|---|---|---|
Sizing | Match task display (sits on the frames), Floating (place it yourself) | Match task display rend la superposition exactement comme un cadre de la tâche, donc les objets dessus s'alignent avec les objets sur les cadres en dessous lorsque les deux cadres ont la même taille. Floating place vous-même la boîte de superposition. |
Anchor (flottant uniquement) | Top left, Top center, Top right, Middle left, Center, Middle right, Bottom left, Bottom center, Bottom right | Le coin, le bord ou le centre de l'écran auquel la boîte est attachée. Par défaut Top left. |
Offset X / Y (flottant uniquement) | Deux nombres, en pixels | Distance par rapport à l'ancre. Par défaut 20 et 20. |
Fill | Transparent (see-through), Solid color, Semi-transparent | L'arrière-plan de la superposition. Par défaut Transparent (see-through). |
Color (solide et semi-transparent) | Sélecteur de couleur | La couleur de remplissage. |
Opacity (semi-transparent uniquement) | Curseur de 5 % à 100 % | Par défaut 50 %. |
Une superposition de canevas flottante prend sa taille des Width et Height du cadre dans les paramètres de cadre. Une superposition flottante faite d'une page utilise une boîte de 500 par 350 pixels.
Les superpositions ne bloquent jamais l'expérience. Les zones vides et transparentes laissent passer les clics vers le cadre en dessous, et seuls les objets sur la superposition les capturent.
Style et Interaction du Dialogue
Ces paramètres apparaissent lorsque Type est Dialog (popup window).
Style
| Paramètre | Options | Remarques |
|---|---|---|
Placement | Centered, Pinned to a spot | Centered place le dialogue au centre de l'écran. |
Anchor (épinglé uniquement) | Les mêmes neuf positions que pour les superpositions | Le dialogue maintient une distance de 20 pixels par rapport au coin ou au bord choisi. |
Size W / H (dialogues de page) | Deux nombres, en pixels | Par défaut 500 et 350. Les pages n'ont pas de taille définie, donc le dialogue en nécessite une. |
Size (dialogues de canevas) | Affiché comme "utilise la largeur et la hauteur du cadre" | Le dialogue utilise les Width et Height du cadre, réduits avec le même rapport d'aspect s'il ne rentre pas dans la fenêtre. |
Background | Sélecteur de couleur | L'arrière-plan du dialogue. |
Border | None, Solid | Par défaut Solid. |
Rounded corners | Case à cocher, activée par défaut | |
Drop shadow | Case à cocher, activée par défaut | |
Title bar | Case à cocher, désactivée par défaut | Ajoute une barre en haut du dialogue. |
Title (avec barre de titre) | Texte | Le texte dans la barre de titre. |
Close button | Case à cocher, activée par défaut | Un ✕ sur lequel le participant peut cliquer pour fermer le dialogue. Il se trouve dans la barre de titre, ou dans le coin supérieur droit du dialogue lorsqu'il n'y a pas de barre de titre. |
Interaction
| Paramètre | Par défaut | Remarques |
|---|---|---|
Block the experiment behind | Activé | Les participants ne peuvent pas cliquer sur l'expérience pendant que le dialogue est ouvert. |
Dim the experiment behind | Activé | Assombrit l'expérience derrière le dialogue. |
Participant can drag it | Activé | Permet au participant de déplacer le dialogue. |
Close when clicking outside | Désactivé | Ferme le dialogue lorsque le participant clique à côté. |
Close on Esc key | Désactivé | Ferme le dialogue lorsque le participant appuie sur Esc. |
Fermer un dialogue le cache et le garde monté, donc son état persiste pour la prochaine fois qu'il est montré.
Portée
Scope décide quand une superposition ou un dialogue est monté et quand il est retiré.
| Portée | Monté | Retiré | Utilisation pour |
|---|---|---|---|
This trial | Lorsque la tâche commence, puis monté à nouveau frais au début de chaque essai | Lorsque la tâche se termine | Retours ou aides par essai qui devraient recommencer à zéro à chaque essai |
This task | Lorsque la tâche commence | Lorsque la tâche se termine | Minuteries, affichages de score ou de progrès, et aide qui appartient à une seule tâche |
Whole session | Lorsque la première tâche commence | Lorsque la session se termine | Éléments qui devraient rester entre toutes les tâches, comme un bouton d'aide ou de pause |
Une superposition This trial est réinitialisée au début de chaque essai, donc ses objets et leur état repartent de zéro. Les superpositions This task et Whole session conservent leur état entre les essais et les tâches. Les variables sont partagées avec le reste de l'expérience dans chaque portée, donc une variable de score affichée sur une superposition conserve sa valeur.
Les superpositions et dialogues utilisent toujours les valeurs de l'essai par défaut. Ils ne changent pas par condition.
Événements sur les superpositions et dialogues
Une superposition ou un dialogue exécute ses propres événements de cadre, comme n'importe quel cadre. Ils commencent chaque fois qu'il est montré et s'arrêtent lorsqu'il est caché. Les déclencheurs de clavier sur une superposition fonctionnent également pendant que le cadre en dessous est en cours d'exécution.
Les événements d'essai de la tâche (Trial Event (on each frame)) ne fonctionnent pas sur les superpositions et ne sont pas listés dans leur panneau d'événements, à moins que Also run trial events on it ne soit coché.
Montrer et cacher avec Cadre de Contrôle
Utilisez l'action Control Frame pour montrer, cacher ou basculer une superposition ou un dialogue. Vous la trouvez dans le menu d'ajout d'action sous Control Actions.
- Ouvrez l'éditeur d'événements sur un cadre dans votre chronologie d'essai, ou sur la superposition elle-même.
- Ajoutez un événement avec n'importe quel déclencheur.
- Ajoutez l'action
Control Frame. - Dans
Frame:, choisissez la superposition ou le dialogue. La liste montre les superpositions et dialogues de toutes les tâches ainsi que ceux avec une portéeWhole session. - Dans
Command:, choisissezShow,HideouToggle.
Si aucune superposition ou dialogue n'existe encore, l'action montre un indice pour en ajouter une dans l'onglet Overlays & Dialogs. Une action qui cible une superposition This task ou This trial d'une autre tâche n'a aucun effet, car cette superposition n'est montée que pendant que sa propre tâche est en cours. Deux commandes Toggle dans un quart de seconde comptent comme une seule, donc un déclencheur qui se déclenche deux fois n'ouvre pas et ne ferme pas immédiatement le dialogue.
Exemple : montrer un dialogue d'aide caché lorsqu'un bouton est cliqué
Déclencheur :
Mouse→Set Target: votre bouton d'aide →Click
Action :Control Frame→Frame:votre dialogue d'aide →Command:Show
Exemple : fermer le dialogue depuis un bouton à l'intérieur
Sur le cadre du dialogue :
Déclencheur :Mouse→Set Target: son bouton Continuer →Click
Action :Control Frame→Frame:le même dialogue →Command:Hide
Cas d'utilisation courants
Minuteur entre les essais : Ajoutez une superposition Canvas avec la portée This task, définissez Sizing sur Floating (place it yourself) et Anchor sur Top right, et placez un Objet Minuteur dessus. Commencez le minuteur avec un événement On Frame Start sur la superposition. Il continue de fonctionner à travers les sauts de cadre et d'essai jusqu'à la fin de la tâche.
Affichage de score ou de progrès : Ajoutez une superposition Canvas avec Match task display et un objet Variable (groupe de barre d'outils Text & Code) qui affiche votre variable de score. Les variables sont partagées, donc l'affichage se met à jour chaque fois qu'un événement sur les cadres en dessous change le score.
Dialogue d'aide : Ajoutez un dialogue Page, caché par défaut, avec vos instructions, et un bouton d'aide sur une superposition This task ou sur les cadres eux-mêmes. Une action Control Frame avec la commande Show ouvre le dialogue, et le participant le ferme avec le bouton de fermeture.
Message de pause entre les tâches : Ajoutez un dialogue Page avec la portée Whole session et Initial state définie sur Hidden. Montrez-le avec Control Frame à la fin d'une tâche, et cachez-le avec un bouton Continuer à l'intérieur du dialogue. Pour une pause régulière entre les blocs, un cadre de page normal dans la chronologie des essais est souvent plus simple.
Lectures supplémentaires
Chronologie des essais
Comment les cadres sont ajoutés et ordonnés dans un essai, et comment fonctionnent les paramètres de cadre.
Système d'Événements
Déclencheurs et actions, y compris l'action Cadre de Contrôle qui montre et cache les superpositions et dialogues.
Travail avec les Variables
Les variables sont partagées entre les superpositions et les cadres en dessous, c'est ainsi qu'un score ou un état circule entre eux.