| |
Vorple Tooltips by Juhana Leinonen
The Tooltips extension lets the story display small notifications above target elements. Tooltips can be activated when the mouse pointer is over them or at request.
Chapter: Tooltips on mouseover
Text with a tooltip can be created with:
place text "examine" with a tooltip reading "You can also use the short form X";
The tooltip is shown when the reader puts the mouse cursor over the text and hidden when the mouse cursor is moved away.
A tooltip can be added to existing elements (see the Vorple core extension for more on how to create elements):
place an inline element called "secret" reading "a mysterious box";
attach a tooltip "You found me!" on the element called "secret";
If there are many elements with the same name, the tooltip is attached to the last of them. The tooltip can also be attached to all elements with the same name.
attach a tooltip "You found me!" to all elements called "secret";
Chapter: Tooltips on request
Tooltips can also be triggered manually on existing elements.
display a tooltip "Take a look here" on the element called "important";
By default the tooltip appears immediately and is hidden in 7 seconds. The delay how long until the tooltip appears and the duration of the tooltip can be changed:
display a tooltip "Take a look here" on the element called "important" after 3 seconds for 10 seconds;
The duration can also be "indefinitely" which keeps the tooltip visible until it's manually hidden.
display a tooltip "Take a look here" on the element called "important" indefinitely;
The default duration can be changed globally. The following example makes all tooltips display for 4 seconds unless otherwise specified:
The default tooltip duration is 4.
As with tooltips that are activated on mouseover, if there are multiple elements with the same name the tooltip is shown only on the last one.
A tooltip can be placed on the prompt (handy for giving a hint on how to play to people who aren't familiar with interactive fiction):
When play begins:
display a tooltip "Type something here!" on the prompt.
Chapter: Hiding tooltips
The currently open tooltip can be closed immediately with:
hide the tooltip;
An optional duration can be provided:
hide the tooltip after 5 seconds;
Only one tooltip can be open at a time. Tooltips are automatically closed when a new tooltip is shown.
Example: * Medical Dictionary - Technical terms that have their definitions shown in a tooltip.
Include Vorple Tooltips by Juhana Leinonen.
Release along with the "Vorple" interpreter.
The Surgery is a room.
A craniotome, a tracheotome, a probang and some butterfly stitches are in the Surgery.
A thing has some text called the definition.
The definition of the craniotome is "A tool for drilling holes in the skull".
The definition of the tracheotome is "A blade used to cut an hole to the trachea for a breathing tube".
The definition of the probang is "A sponge attached to a long flexible rod, used to clear obstacles from the throat".
The definition of butterfly stitches is "Thin adhesive strips for bandaging small wounds".
Rule for printing the name of something (called the item) when the item provides the property definition and the definition of item is not empty:
place text "[printed name of the item]" with a tooltip reading "[definition of item]".
Example: ** How To II - More tips to new players who might not be familiar with standard IF conventions
We'll show a tooltip on the prompt to direct the player to use the keyboard, hint about what kind of commands to use if the first command they try is an error and direct their attention to parts of items.
Include Vorple Tooltips by Juhana Leinonen.
Release along with the "Vorple" interpreter.
Bedroom is a room.
The wardrobe is openable closed fixed in place container in the bedroom.
Instead of examining the wardrobe when the wardrobe is closed:
say "The wardrobe is ";
place an element called "wardrobe-closed" reading "closed";
display a tooltip "You can OPEN WARDROBE to see what's inside." on the element called "wardrobe-closed" in 2 seconds;
say ".";
The jacket is a wearable thing in the wardrobe.
Rule for printing the name of the jacket when the jacket is in the wardrobe:
place an element called "jacket-text" reading "jacket";
display a tooltip "The jacket is something you can TAKE or WEAR." on the element called "jacket-text" in 2 seconds.
When play begins (this is the show prompt hint rule):
display tooltip "Type a command to play" on the prompt.
Rule for printing a parser error (this is the show parser error hint rule):
display tooltip "Try to, for example, EXAMINE things you see or take INVENTORY." on the prompt;
make no decision.
Test me with "x wardrobe / open wardrobe".
Example: ** Ibid. (2) - Footnotes that can be read by placing the mouse cursor over them.
We're modifying example 300 (Ibid.) from Writing with Inform to show the footnotes when the mouse cursor is on top of the footnote reference numbers.
Include Vorple Tooltips by Juhana Leinonen.
Release along with the "Vorple" interpreter.
The Ship Inn is a room. "Here you are in a lovely pub which your guidebook assures you is extremely authentic. [1 as a footnote].
To your left sits a party of Italians, with their guidebook.
To your right is a silent, but not unappealing, young man.".
A party of Italians and a silent young man are people in the Ship Inn. The Italians and the young man are scenery.
The table is a supporter in the Ship Inn. On the table is a mysterious pie. The description of the pie is "Your waitress told you it was the specialty of the day, Steak and Owl Pie. [2 as a footnote]." The pie is edible.
Table of Footnotes
assignment note a number "Francis Drake ate here, if the sign on the door is to be believed" -- "this is unlikely, considering that owls are protected animals in England these days"
Footnotes mentioned is a number that varies.
To say (footnote - a number) as a footnote:
if footnote > number of filled rows in the Table of Footnotes:
say "Programming error: footnote assignment out of range.";
otherwise:
choose row footnote in the Table of Footnotes;
if there is an assignment entry:
place text "([assignment entry])" with a tooltip reading "[note entry]";
otherwise:
increment footnotes mentioned;
choose row footnote in the Table of Footnotes;
now assignment entry is footnotes mentioned;
place text "([assignment entry])" with a tooltip reading "[note entry]".
Understand "footnote [number]" as looking up a footnote.
Looking up a footnote is an action applying to one number.
Check looking up a footnote:
if the number understood > footnotes mentioned, say "You haven't seen any such footnote." instead;
if the number understood < 1, say "Footnotes are numbered from 1." instead.
Carry out looking up a footnote:
choose row with assignment of number understood in the Table of Footnotes;
say "([assignment entry]): [note entry]."
Test me with "footnote 1 / examine pie / footnote 2 / footnote 3".