Game interface logic: yourgamename.js - Гісторыя версій

Victoria La: /* Other useful stuff */

2020-10-18T19:11:55Z

Other useful stuff

← Папярэдн. версія		Версія ад 21:11, 18 кастрычніка 2020
Радок 1 017:		Радок 1 017:
	In the example above, using dojo.hitch, we ensure that the "this" object will be set when the callback is called.		In the example above, using dojo.hitch, we ensure that the "this" object will be set when the callback is called.

			NOTE: In modern JS there are lambdas that eliminate need for that, the example above will look like this
			<pre>
			this.confirmationDialog( _('Are you sure you want to make this?'), () => {
			this.ajaxcall( '/mygame/mygame/makeThis.html', { lock:true }, this, (result) => {} );
			} );
			</pre>

	; updateCounters(counters)		; updateCounters(counters)

Victoria La: /* Players input */

2020-10-17T14:31:25Z

Players input

← Папярэдн. версія		Версія ад 16:31, 17 кастрычніка 2020
Радок 502:		Радок 502:
	'''this.isInterfaceLocked()'''		'''this.isInterfaceLocked()'''

	When using "lock: true" in ajax call you can use this function to check if interface is in lock state (it will locked during server call and notification processing).		When using "lock: true" in ajax call you can use this function to check if interface is in lock state (it will be locked during server call and notification processing).
	This check can be used to block some other interactions which do not result in ajaxcall.		This check can be used to block some other interactions which do not result in ajaxcall or if you want to suppress errors.

Victoria La: /* Players input */

2020-10-17T14:29:04Z

Players input

← Папярэдн. версія		Версія ад 16:29, 17 кастрычніка 2020
Радок 483:		Радок 483:

	* url: the url of the action to perform. For a game, it must be: "/<mygame>/<mygame>/myAction.html"		* url: the url of the action to perform. For a game, it must be: "/<mygame>/<mygame>/myAction.html"
	* parameters: an array of parameter to send to the game server. Note that "lock:true" must always be specified in this list of parameter in order the interface can be locked during the server call.		* parameters: an array of parameter to send to the game server.
			** Note that "lock:true" must always be specified in this list of parameter in order the interface can be locked during the server call.
	* obj_callback: must be set to "this".		* obj_callback: must be set to "this".
	* callback: a function to trigger when the server returns and everything went fine.		* callback: a function to trigger when the server returns and everything went fine.
Радок 498:		Радок 499:
	} );		} );
	</pre>		</pre>

			'''this.isInterfaceLocked()'''

			When using "lock: true" in ajax call you can use this function to check if interface is in lock state (it will locked during server call and notification processing).
			This check can be used to block some other interactions which do not result in ajaxcall.


	'''this.confirmationDialog()'''		'''this.confirmationDialog()'''

Salty-horse: /* Javascript minimization (after July 2020) */ Fix typo

2020-10-15T05:45:42Z

Javascript minimization (after July 2020): Fix typo

← Папярэдн. версія		Версія ад 07:45, 15 кастрычніка 2020
Радок 114:		Радок 114:
	== Javascript minimization (after July 2020) ==		== Javascript minimization (after July 2020) ==

	For performance reasons, when deploying a game the javascript code is minimized using '''terser''' (https://github.com/terser/terser). This minifier works with modern javascript syntax. From your project "Manage game" page, you can now test a minified version of ~~jour~~ javascript on the studio (and revert to the original).		For performance reasons, when deploying a game the javascript code is minimized using '''terser''' (https://github.com/terser/terser). This minifier works with modern javascript syntax. From your project "Manage game" page, you can now test a minified version of your javascript on the studio (and revert to the original).

	== Accessing and manipulating the DOM ==		== Accessing and manipulating the DOM ==

ExtraPaul: /* Accessing and manipulating the DOM */

2020-10-11T08:51:58Z

Accessing and manipulating the DOM

← Папярэдн. версія		Версія ад 10:51, 11 кастрычніка 2020
Радок 191:		Радок 191:

	Conclusion: We encourage you to use '''dojo.addClass''', '''dojo.removeClass''' and '''dojo.hasClass''' to make your life easier :)		Conclusion: We encourage you to use '''dojo.addClass''', '''dojo.removeClass''' and '''dojo.hasClass''' to make your life easier :)

			'''dojo.attr'''

			With dojo.attr you can access or change the value of an attribute or property of any HTML element in your interface.

			Exemple:
			<pre>
			// Get the title of a node
			var title = dojo.attr( id, 'title' );
			// Change the height of a node
			dojo.attr( 'img_growing_tree', 'height', 100 );
			</pre>

	'''dojo.query'''		'''dojo.query'''

Salty-horse: /* File structure */ Fix typos

2020-10-10T14:31:00Z

File structure: Fix typos

← Папярэдн. версія		Версія ад 16:31, 10 кастрычніка 2020
Радок 48:		Радок 48:
	To access state arguments passed via calling arg* method use args parameter. Note: args can be null! For game states and when you don't supply state args function it is null.		To access state arguments passed via calling arg* method use args parameter. Note: args can be null! For game states and when you don't supply state args function it is null.
	This method is called when active or multiactive player changes. In classic "activePlayer" state this method is called before the onEnteringState state.		This method is called when active or multiactive player changes. In classic "activePlayer" state this method is called before the onEnteringState state.
	In multipleactiveplayer state it is a mess. The sequencing of call would depends on either you get into that from transition from ~~realoding~~ the ~~hole~~ game (i.e. F5).		In multipleactiveplayer state it is a mess. The sequencing of call would depends on either you get into that from transition from reloading the whole game (i.e. F5).

	See more details in [[Your_game_state_machine:_states.inc.php#Diffrence_between_Single_active_and_Multi_active_states]]		See more details in [[Your_game_state_machine:_states.inc.php#Diffrence_between_Single_active_and_Multi_active_states]]

Een: /* Sounds */ filname convention

2020-10-06T13:22:01Z

Sounds: filname convention

← Папярэдн. версія		Версія ад 15:22, 6 кастрычніка 2020
Радок 1 073:		Радок 1 073:
	Add this in your template (.tpl) file:		Add this in your template (.tpl) file:
	<pre>		<pre>
	<audio id="audiosrc_<gamename>_<yoursoundname>" src="{GAMETHEMEURL}img/<~~filename~~>.mp3" preload="none" autobuffer></audio>		<audio id="audiosrc_<gamename>_<yoursoundname>" src="{GAMETHEMEURL}img/<gamename>_<yoursoundname>.mp3" preload="none" autobuffer></audio>
	<audio id="audiosrc_o_<gamename>_<yoursoundname>" src="{GAMETHEMEURL}img/<~~filename~~>.ogg" preload="none" autobuffer></audio>		<audio id="audiosrc_o_<gamename>_<yoursoundname>" src="{GAMETHEMEURL}img/<gamename>_<yoursoundname>.ogg" preload="none" autobuffer></audio>
	</pre>		</pre>

Victoria La: /* File structure */

2020-10-04T03:05:33Z

File structure

← Папярэдн. версія		Версія ад 05:05, 4 кастрычніка 2020
Радок 31:		Радок 31:
	To access state arguments passed via calling arg* method use args.args.		To access state arguments passed via calling arg* method use args.args.
	Typically you would do something only for active player, using this.isCurrentPlayerActive() check.		Typically you would do something only for active player, using this.isCurrentPlayerActive() check.
	Warning: for multipleactiveplayer states:
			'''Warning''': for multipleactiveplayer states:
	the active players are NOT actives yet so you must use onUpdateActionButtons to perform the client side operation which depends on a player active/unactive status.		the active players are NOT actives yet so you must use onUpdateActionButtons to perform the client side operation which depends on a player active/unactive status.
			If you are doing initialization of some structure which do not depend on active player, you can just replace
			if (this.isCurrentPlayerActive()) {
			into
			if (!this.isSpectator) {
			for the main switch in that method.

	;onLeavingState(stateName)		;onLeavingState(stateName)
Радок 42:		Радок 48:
	To access state arguments passed via calling arg* method use args parameter. Note: args can be null! For game states and when you don't supply state args function it is null.		To access state arguments passed via calling arg* method use args parameter. Note: args can be null! For game states and when you don't supply state args function it is null.
	This method is called when active or multiactive player changes. In classic "activePlayer" state this method is called before the onEnteringState state.		This method is called when active or multiactive player changes. In classic "activePlayer" state this method is called before the onEnteringState state.
	In multipleactiveplayer state it is a mess. See more details in [[Your_game_state_machine:_states.inc.php#Diffrence_between_Single_active_and_Multi_active_states]]		In multipleactiveplayer state it is a mess. The sequencing of call would depends on either you get into that from transition from realoding the hole game (i.e. F5).

			See more details in [[Your_game_state_machine:_states.inc.php#Diffrence_between_Single_active_and_Multi_active_states]]

	== General tips ==		== General tips ==

Victoria La: /* Speech bubble */

2020-10-02T21:28:16Z

Speech bubble

← Папярэдн. версія		Версія ад 23:28, 2 кастрычніка 2020
Радок 841:		Радок 841:

	<pre>		<pre>
	this.showBubble( anchor_id, text, delay, duration, custom_class )		this.showBubble(anchor_id, text, delay, duration, custom_class)
	</pre>		</pre>

	~~delay~~ in ~~milliseconds is optional (default 0)~~		text - what to put in bubble, can be html actually not just text

	~~duration~~ in milliseconds is optional (default ~~3000~~)		delay - in milliseconds is optional (default 0)

	custom_class is optional, if you need to override the default bubble style		duration - in milliseconds is optional (default 3000)

			custom_class - extra class to add to bubble is optional, if you need to override the default bubble style

	'''Warning''': if your bubble could overlap other active elements of the interface (buttons in particular), as it stays in place even after disappearing, you should use a custom class to give it the style "pointer-events: none;" in order to intercept click events.		'''Warning''': if your bubble could overlap other active elements of the interface (buttons in particular), as it stays in place even after disappearing, you should use a custom class to give it the style "pointer-events: none;" in order to intercept click events.

			Note: If you want this visually, but want to take complete control over this bubble and its animation (for example to make it permanent) you can just use div with 'discussion_bubble' class on it, and content of div is what will be shown.

	== Update players score ==		== Update players score ==

Victoria La: /* File structure */

2020-10-01T02:26:14Z

File structure

← Папярэдн. версія		Версія ад 04:26, 1 кастрычніка 2020
Радок 40:		Радок 40:
	;onUpdateActionButtons(stateName, args)		;onUpdateActionButtons(stateName, args)
	In this method you can manage "action buttons" that are displayed in the action status bar.		In this method you can manage "action buttons" that are displayed in the action status bar.
	To access state arguments passed via calling arg* method use args parameter.		To access state arguments passed via calling arg* method use args parameter. Note: args can be null! For game states and when you don't supply state args function it is null.
	This method is called when active or multiactive player changes. In classic "activePlayer" state this method is called before the onEnteringState state.		This method is called when active or multiactive player changes. In classic "activePlayer" state this method is called before the onEnteringState state.
	In multipleactiveplayer state it is a mess. See more details in [[Your_game_state_machine:_states.inc.php#Diffrence_between_Single_active_and_Multi_active_states]]		In multipleactiveplayer state it is a mess. See more details in [[Your_game_state_machine:_states.inc.php#Diffrence_between_Single_active_and_Multi_active_states]]