HTML Data Attributes
Understanding all the Datas
If you've already seen the HTML, you'll notice many "data" attributes in the elements; this are used by the engine so you may change the structure and using the right datas everything will just work.
This table will resume the general datas and what are they for.
Data | Function | |
data-action | All data-actions well... do something, they are handled by the $("[data-action]").click() function in the engine. | |
data-ui | The data-uis are part of the user interface, things that the user will see. | |
data-component | The data-uis are part of the user interface, however the user will not see them. | |
data-menu | The data-menus are the screens and menus of your game. | |
data-background | Put an image url on it and it will apply that image as a background to that element. | |
data-close | Closes another element by it's data-ui name. | |
data-target | This is mainly used for internal functions, just to target the specific media player. | |
data-string | Used for Multilanguage Games, will change the text of the element with the proper translation from the strings.js file. | |
data-jump | Used in choices, to state what a choice will do when it's clicked. |
Now, that gives you some idea of what everything is for, now you need to understand what every one of them is used for.
Data | Function | |
data-action="open-menu" | Opens the menu/screen from the data-open next to it and closes the others. | |
data-action="back" | While playing, it will go back to the previous statement, while on a menu, it will just go back to the main screen. | |
data-action="close" | Will trigger the close of an element, using the data-close next to it. | |
data-action="close-video" | Closes the Video element. | |
data-action="set-language" | Used for the language setting. | |
data-action="set-volume" | Changes the volume of the element given in the data-target next to it. | |
data-action="jump" | Declares an element that when clicked will make the game jump to the label declared inside it's data-jump. | |
data-jump="[label]" | Declares the label the game will jump to when this data-action="jump" element is clicked. | |
data-component="modal" | Defines a modal window like the one used for the messages. | |
data-ui="inner-menu" | Defines a menu inside another menu/screen. | |
data-ui="slots" | Defines the place where the save and load slots will be displayed. | |
data-ui="text" | Defines the place where the "Say" text and character's name is displayed. | |
data-ui="who" | Defines the place where the character's name is displayed. | |
data-ui="say" | Defines the place where the "Say" text is displayed. |
Last updated