Answer (Panel): Difference between revisions
No edit summary |
|||
| (6 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
A [[Panel]] can be given Answers. These are buttons that are added to a [[Panel]] and allow the end-user to close the [[Panel]], and at the same time trigger one or more [[Event]]s in the [[Session]]. | A [[Panel]] can be given Answers. These are buttons that are added to a [[Panel]] and allow the end-user to close the [[Panel]], and at the same time trigger one or more [[Event]]s in the [[Session]]. | ||
| Line 9: | Line 7: | ||
===Answers as part of Template Panels=== | ===Answers as part of Template Panels=== | ||
When an Answer is attached to a [[Template Panel]], it is part of the properties that are carried over to its instances. The name is kept verbatim. The [[Event]]s are copied over intelligently. Specifically, if the [[Event]] has as one of its parameters an [[Item]] of the type which the [[Template Panel]] is applied to, then the [[Event]] of the instance created will have that parameter refer to the item the instance belongs to. For example, if the Answer has a NEIGHBORHOOD_SET_ATTRIBUTE [[Event]], and the [[Template Panel]] is applied to [[Neighborhood]]s, then each instanced [[Panel]] will relate to a specific [[Neighborhood], and the NEIGHBORHOOD_SET_ATTRIBUTE [[Event]] of that [[Panel]] will be configured to change an [[Attribute]] of that specific [[Neighborhood]]. | When an Answer is attached to a [[Template Panel]], it is part of the properties that are carried over to its instances. The name is kept verbatim. The [[Event]]s are copied over intelligently. Specifically, if the [[Event]] has as one of its parameters an [[Item]] of the type which the [[Template Panel]] is applied to, then the [[Event]] of the instance created will have that parameter refer to the item the instance belongs to. For example, if the Answer has a NEIGHBORHOOD_SET_ATTRIBUTE [[Event]], and the [[Template Panel]] is applied to [[Neighborhood]]s, then each instanced [[Panel]] will relate to a specific [[Neighborhood]], and the NEIGHBORHOOD_SET_ATTRIBUTE [[Event]] of that [[Panel]] will be configured to change an [[Attribute]] of that specific [[Neighborhood]]. | ||
==Properties== | ==Properties== | ||
| Line 20: | Line 18: | ||
: These are the [[Event]]s fired when this Answer is chosen. | : These are the [[Event]]s fired when this Answer is chosen. | ||
= | {{article end | ||
|notes= | |||
* A [[Panel]] can have at most 10 Answers. | |||
* Answers provide a simple way to add interactivity to a [[Panel]]. However, users who are well-versed in [[HTML]], [[CSS]], and [[Javascript]] may find more flexibility in creating their own [[HTML]] elements to facilitate interaction. | |||
|howtos= | |||
* [[How to add an Answer to a Panel]] | * [[How to add an Answer to a Panel]] | ||
* [[How to add an Event to an Answer of a Panel]] | * [[How to add an Event to an Answer of a Panel]] | ||
|seealso= | |||
* [[Panel]] | |||
}} | |||
Latest revision as of 10:25, 2 March 2023
A Panel can be given Answers. These are buttons that are added to a Panel and allow the end-user to close the Panel, and at the same time trigger one or more Events in the Session.
When to use
Answers can be used to provide an additional way to interact with the Session. They are always used as an additional function of Panels. A Panel provides information and if Answers are added to a Panel the end-user can act on the provided information by selecting one of the Answers.
Panels can always be closed by clicking on their "X" on the top right of their window. For this reason, Answers should not be used for restrictive control-flow of a user's actions.
Answers as part of Template Panels
When an Answer is attached to a Template Panel, it is part of the properties that are carried over to its instances. The name is kept verbatim. The Events are copied over intelligently. Specifically, if the Event has as one of its parameters an Item of the type which the Template Panel is applied to, then the Event of the instance created will have that parameter refer to the item the instance belongs to. For example, if the Answer has a NEIGHBORHOOD_SET_ATTRIBUTE Event, and the Template Panel is applied to Neighborhoods, then each instanced Panel will relate to a specific Neighborhood, and the NEIGHBORHOOD_SET_ATTRIBUTE Event of that Panel will be configured to change an Attribute of that specific Neighborhood.
Properties
Answers have a number of properties, which can be configured in the Editor. They define the Answer's text and its effects.
- Name
- When the Answer is displayed, this is the text on the button. Note that Answers can have the same name as other Answers.
- Events
- These are the Events fired when this Answer is chosen.