Skip to content

★ Input

If you want to give players a possibility of choosing a value (from a specified list of values) which will be attributed to the variable, use the (cycling-link: ) macro.

With each click, players will be able to change the value of the $colour variable.

Example

=><=
choose your favourite colour:
(cycling-link: bind $colour, "blue", "red", "yellow", "green")

Result – you can test:

See more in documentation



The (dropdown: ) macro

If you want to give players a possibility of choosing the value of a variable taken from a dropdown list, use the (dropdown: ) macro.

The START slip

How many angels have you noticed in the picture?
(dropdown: bind $picture, "1", "2", "3", "5")

[[Check your answers]]

The CHECK YOUR ANSWERS slip

{     (if: $picture is "3")[You’re right! That’s the right answer.]     (else:)[Wrong! (link-undo: "retreat")] }

An editor view

dropdown - an editor view

Result – you can test:

How to solve problems with the CSS style? – use the code:

/* window of the list */
tw-expression[name="dropdown"] {
    background: white;
    color: black;
    padding: 10px;
}

/* window of the dropdown list */
tw-expression[name="dropdown"] option {
    background: white;
    color: black;
}

/* selected option */
tw-expression[name="dropdown"] option:checked {
    background: grey; 
}

tw-expression[name="dropdown"] select {
    border: none;
    padding: 10px;
}

tw-expression[name="dropdown"] select:focus {
    outline: none !important;
}

See more in documentation



Frequent error

Please, remember that 3 (type: number) is not "3" (type: string)

How to solve this problem?
Let’s assume that the player has selected "3" (type: string) from the list. If you want to check whether the player has chosen the right answer, you should use the IF instruction.

Way no. 1:
(if: $picture is "3")[You’re right! That’s the right answer.]

Way no. 2:
(set: $picture to (num: $picture))
(if: $picture is 3)[You’re right! That’s the right answer.]

Way no. 3:
(if: (num: $picture) is 3)[You’re right! That’s the right answer.]


Converting number into string: (text: $number)
Converting string into number: (num: $text)

Additionally:
Converting into lowercase text: (lowercase: $text)
Converting into uppercase text: (uppercase: $text)
The first letter must be lowercase:(lowerfirst: $text)
The first letter must be uppercase:(upperfirst: $text)



The (prompt:) macro

Example 1

A box to be completed without a default value.

(set: $name to (prompt: "Enter your name:", ""))
Hello $name. It’s time for an adventure!

Example 1 prompt


Example 2

A box to be completed with a default value "Player".

(set: $name to (prompt: "Enter your name:", "Player"))
Hello $name. It’s time for an adventure!

Example 2 prompt


Example 3

If players decide to enter their names, they must click the "enter" link. Then, their names entered previously will appear on the next slips.

If players do not decide to enter their names and they do not click the "enter" link ($name=""), then the value "Player" will be set for the $name variable on the next slips.

The START slip

{     Do you want to enter your name?     (click: "enter")     [(set: $name to (prompt: "Enter your name", ""))] }

[[Next]]

The NEXT slip

(if: $name is "")[(set: $name to "Player")]
Hello $name. It’s time for an adventure! 

An editor view

Example prompt

Result – you can test:



The (confirm: ) macro

If you just want players to enter the OK (true) answer or the CANCEL (false) answer, please, use the (confirm: ) macro.

Example

(set: $decision to (confirm: "Do you want to enter the building?"))

{     (if: $decision)[You notice a beautiful [[picture]].]     (else:)[Well – you have missed a lot. [[next]]] }

An editor view

Example confirm

Result – you can test:



The (alert: ) macro

If you just want to display a message to players, use the (alert: ) macro.

Example

(alert: "Remember, it’s a good idea to use a flashlight in the darkness.")

Result

Example alert



More information