GuidedTrack Docs

Maintaining Text on the Screen🔗

There may be instances when you want to keep some text on the screen and not allow it to clear when a new question is introduced. To do this, you can use the *maintain keyword to keep some text maintained on the screen and the *clear keyword when you are ready to clear the text that is being maintained.

*maintain: Make sure to answer honestly.
*question: How are you?
*question: Who do you love the most?
*question: What's a secret you've never told anyone?
*clear

In this example, the user will see "Make sure to answer honestly." Below that will be the first question, "How are you?" After the user answers the first question, "Make sure to answer honestly" will remain, but the first question will disappear and the second question will appear below, and so on. After the last question, the entire screen will be cleared due to the *clear keyword, so "Make sure to answer honestly" will then disappear.

In order to properly clear the maintained text, you must ensure both the *maintain keyword and the *clear keyword are immediately preceded by a question, a button, or a wait period. This means you purposefully time the maintained text and the clearing of that text to occur exactly when you intend them to, and neither will accidentally re-arrange or clear important information. Here's another example:

Your exercise will begin when you click the button
*button: Next

*maintain: Remember to breathe deeply during this guided meditation.

The weather is beautiful and warm
*button: Next

You are in a giant pool of jello
*button: Next

You feel peaceful and at ease
*button: Next

*clear
That's the end!

In the above example, the user sees the first line of text plus a button that says "Next." After clicking the button, the user sees the maintained text at the top of the screen for the three screens that contain meditative imagery. After reading "You feel peaceful and at ease" and pressing the "Next" button, the maintained text disappears and the user only sees "That's the end!"

It's important here that both the *maintain text and the *clear keyword occurred after a button. If we hadn't included a button after the text "Your exercise will begin when you click the button" the user would actually see the maintained text first with this text beneath it. If we hadn't included a button after the text "You feel peaceful and at ease" the user would not actually see this line because it would have been cleared immediately as soon as the user got to that screen. The buttons ensure that the *maintain and *clear keywords are timed appropriately.